ZeXtras Suite Installation Guide/pt

From ZeXtras Suite Wiki

Jump to: navigation, search
Língua: English  • español • português
Zextras logo box.png
Latest Version: 2.16.0
Released on: April 4th, 2019
Compatibility List
Changelog
License Management

Informações básicas

Pré-requisitos

Não é necessario algum software adicional para instalar ZeXtras Suite, além do que é exigido para Zimbra.

Warning.png Atenção!

Todos os comandos se devem executar como usuario 'Zimbra' a menos que especificado o contrário

Onde baixar ZeXtras Suite

Veja o site de download ou simplesmente use wget desde o servidor:

wget http://www.zextras.com/download/zextras_suite-latest.tgz

(esse URL levará sempre para a última versão de ZeXtras Suite)

Componentes

ZeXtras Suite tem tres componentes principais:

  • O core, que é um pacote .jar para expandir Zimbra.
  • O zimlet que acessa e gerencia o core.
  • ZAL - A camada de abstração Open Source para Zimbra.

O script de instalação segue a estrutura mencionada acima permitindo-lhe tres opçoes de instalação: core, zimlet e all. A última é equivalente a instalar o core e em seguida o zimlet.


Abaixo as várias combinações são explicadas em detalhe.

Outros zimlets Zextras

O pacote Zextras Suite inclui o zimlet administrativo ZeXtras, o zimlet ZeXtras Chat e o zimlet cliente ZeXtras se devem instalar separadamente. Veja os guias correspondentes no Wiki para mais informação.

Passos para a instalação

  • Baixe Zextras Suite no servidor.
  • Como root, descompacte o arquivo dentro de uma pasta (sugerimos em /root/).
  • Entre na pasta criada pela descompactação do arquivo.
  • Execute o script install.sh com a opção "all" (/install.sh all)..

video tutorial de instalação de Zextras Suite

Instalação detalhada e informações de configuração

ZAL - a camada de abstração para Zimbra

O ZAL é uma camada de abstração Open Source criada para permitir que qualquer extensão se comunique facilmente com Zimbra Collaboration Suite sem importar a versão que se use.

Se oferece sob licença GPL e por isso não pode se incluir no pacote ZeXtras Suite, mas durante a instalação o instalador de Zextras detectará automáticamente a versão da livraría mais apropriada e a baixará e instalará autônomamente.

Se a descarga automática falhase se proverá um link direto: o arquivo baixado deve ser renomeado como "zal.jar" e copiado no subdiretório "packages/" do pacote ZeXtras Suite. Ao reiniciar o instalador se detectará o novo arquivo e o instalará junto com ZeXtras Suite.

Problema de logueio em Zimbra 8.x (AjxError)

Os usuários de Zimbra 8.x poderão experimentar lentidão e erros de AJAX quando acessarem no console Zimbra, a causa dos filtros DOS do Zimbra. Em esse caso sugere-se aumentar o número de pedidos máximos por segundo. (Ver ZeXtras Suite e Filtro DOS para mais informações).

Advertências PermGen e HeapSize

ZeXtras Suite inclui um controle que verifica que as propriedades java "PermGen" e "HeapSize" estejam estabelecidas em um valor correto:

  • PermGen: 196mb
  • MaxPermGen: 350mb
  • Heap: maior do que o 20% da memoria RAM instalada

A pesar que esses valores não estão estritamente relacionados com ZeXtras Suite, uma configuração inadequada pode levar a inestabilidade e colapso do serviço mailboxd. Se recebe uma notificação onde um ou ambos os valores são baixos, se pode solucionar com a utilidade Zimbra 'zmlocalconfig' para mudar as seguintes propriedades:

  • mailboxd_java_options (somente mude a parte "-XX:MaxPermSize=128m" mantendo tudo o demáis)
  • mailboxd_java_heap_size (em megabytes)

Exemplo:

  • Recebemos a advertência "Low PermGen size"
  • Para verificar o valor corrente execute
 root@test:~# su - zimbra
 zimbra@test:~$ zmlocalconfig mailboxd_java_options
 mailboxd_java_options = -server -Djava.awt.headless=true -Dsun.net.inetaddr.ttl=60 -XX:+UseConcMarkSweepGC -XX:PermSize=128m 
-XX:MaxPermSize=350m -XX:SoftRefLRUPolicyMSPerMB=1 -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCTimeStamps
-XX:+PrintGCApplicationStoppedTime -XX:-OmitStackTraceInFastThrow -Djava.net.preferIPv4Stack=true
-Dorg.apache.jasper.compiler.disablejsr199=true
  • Para mudar o tamanho de PermGen de 128mb para 196mb execute
 zimbra@test:~# zmlocalconfig -e mailboxd_java_options="-server -Djava.awt.headless=true -Dsun.net.inetaddr.ttl=60 
-XX:+UseConcMarkSweepGC -XX:PermSize=196m -XX:MaxPermSize=350m -XX:SoftRefLRUPolicyMSPerMB=1 -verbose:gc -XX:+PrintGCDetails
-XX:+PrintGCTimeStamps -XX:+PrintGCApplicationStoppedTime -XX:-OmitStackTraceInFastThrow
-Djava.net.preferIPv4Stack=true -Dorg.apache.jasper.compiler.disablejsr199=true"

Remoção de Zimbra Chat

A partir da versão 2.6.1 o instalador Zextras permite remover o componente Zimbra Chat para quem esteja usando ou queira usar Zextras Chat no seu lugar. Para que isto aconteça, os serviços LDAP e Mailbox deven estar ativos pois o instalador baseia-se no comando `zmzimletctl` para desinstalar o zimlet Zimbra Chat.

Atualização do Zimbra

Quando Zimbra se atualiza, se remove o Core do Zextras do servidor. Por isso em caso de atualização se deve reinstalar ZeXtras Suite. Todos os dados e configurações se manterão, e depois de reinstalar tudo será exatamente igual a como era antes.

Warning.png Atenção!

Antes de atualizar Zimbra certifique-se que existe uma versão compatível de ZeXtras Suite. Normalmente se emite uma versão compatível com a última versão Zimbra em 48 horas.


Patches para Zimbra

A informação anterior aplica somente para "atualizações de versão": a instalação de um patch não afectará ZeXtras Suite em modonenhum, pelo que não terá que reinstalá-lo.

Requerimentos mínimos e ajustes menores

Zimbra tem um requerimento mínimo de 2GB e 4GB recomendados. O impacto de ZeXtras Suite nos recursos do sistema é muito baixo; contudo, sugerimos um mínimo de 4GB inclusive para pequenas infraestruturas para melhorar assim sua experiência Zimbra. Se tem interesse em otimizar e fazer algumas mudanças sugerimos ler o seguinte artigo no wiki do Zimbra que, a pesar do título, aplica a infraestruturas grandes e pequenas: http://wiki.zimbra.com/wiki/Performance_Tuning_Guidelines_for_Large_Deployments (em inglês).

ZeXtras Suite em infraestruturas Multiserver

Dependendo da função do servidor se deverão tomar precauções durante a instalação.

Instalando ZeXtras Suite em uma infraestrutura Single-store

É muito fácil instalar ZeXtras Suite em uma infraestrutura formada de varios servidores, com um só de correio. O software se deve instalar em aquele que executa o serviço mailboxd.

Instalando ZeXtras Suite em uma infraestrutura Multistore

A instalação de ZeXtras Suite em uma infraestrutura multistore com vários servidores de correio requer algumas precauções:

  • Se deve instalar ZeXtras Suite em TODOS os servidores que executan o serviço mailboxd.


  • ZeXtras Suite usa as portas 8735 e 8736 para comunicações store-to-store. Certifique-se que os servidores possam comunicar-se entre si a través desta porta e que a mesma esteja fechada ao tráfego exterior.

Dica importante: tome seu tempo e não apresse as coisas.

Instruções gerais

Antes de instalar ZeXtras Suite deve ter baixado o pacote, como foi explicado na seção correspondente, e descomprimi-lo em uma pasta da sua escolha.

$ tar xfz zextras_suite-X.X.X.tgz
$ ls 
zextras_suite-X.X.X.tgz zextras_suite-X.X.X/

Na pasta zextras_suite-XXX deve encontrar um shell script executável chamado install.sh.

$ cd zextras_suite-X.X.X
$ ./install.sh -h

./install.sh -h | ./install.sh [ -u ] all|zimlet|core 

-h         This very message
-u         Uninstall the target

As opções disponíveis para (des)instalação são:
core   -- O core da ZeXtras
zimlet -- O zimlet da ZeXtras
all    -- O core seguido do zimlet ZeXtras

* Para usar ZeXtras devem estar instalados o core e o zimlet.

A opção ./Install.sh -h dá ao usuário uma explicação concisa sobre o uso do script de instalação.


Para ter sucesso na instalação requer-se ser usuário root ou executar o script com privilégios de root. Por exemplo:

$ su -
# ./install.sh all

ou

$ sudo ./install.sh all

Uma vez iniciado, o script irá executar uma verificação do seu sistema para determinar a versão Zimbra e qualquer instalação preexistente de ZeXtras Suite ou ZeXtras Migration Tool.

Warning.png Atenção!

Se foram detectados componentes de ZeXtras Suite, você será solicitado a desinstalá-los (como se detalha aqui) e terá de executar novamente o script de instalação de ZeXtras Suite.

Para prosseguir com a instalação deverá aceitar a Licença de Software de ZeXtras, após o qual a instalação propriamente dita terá lugar.
Para mais detalhes sobre a instalação do core ou do zimlet de ZeXtras Migration Tool, consulte as seções relacionadas mais abaixo.

Warning.png Atenção!

O Módulo ZxBackup DEVE ser inicializado para funcionar corretamente. A não inicialização significaria que as opções de Scanner em Tempo Real, Full Scan e exportação/importação não funcionem. Todas as operações serão ignoradas.


Instalação completa de ZeXtras Suite

--- RECOMENDADO ---
Para instalar o ZeXtras Suite precisa ter instalado corretamente e ter completamente funcional o core e o zimlet.
Selecionar all, instalará o core e o zimlet, em essa ordem, de uma só vez.
Alternativamente, pode invocar o script install.sh com o core ou o zimlet, instalando cada um separadamente.

Warning.png Atenção!

Devem corresponder as versões do core e do zimlet ZeXtras suite, especialmente quando sejam instalados separadamente.


Instalação completa

./install.sh all

Instalação do core separadamente

Para instalar o core precisa parar antes os serviços Zimbra.
Eles podem ser detidos antes de executar o script ou interrompê-los quando o script o solicite.
Uma vez esse passo se complete, o script irá executar uma série de verificações sobre uma eventual instalação anterior do core ZeXtras e, finalmente, instalar-se-á o arquivo .jar entre as extensões Zimbra.

Instalação do core por separado:

./install.sh core

Instalado o Core, Zimbra deverá ser reiniciado para verificar que a operação foi realizada corretamente.
(Se estiver usando a opção all o próprio script pedirá ele mesmo para iniciar esse serviço)
Logo depois que Zimbra for totalmente inicializado, a presença de linhas como as abaixo descritas em /opt/zimbra/log/mailbox.log indicará que a instalação foi bem-sucedida.

INFO  [main] [] extensions - Initialized extension ZExtrasExtension: 
com.zextras.extension.ZExtrasExtension@com.zimbra.cs.extension.ZimbraExtensionClassLoader@7543073a [...] INFO [main] [] extensions - registered handler at /zextras [...] INFO [main] [] extensions - ZExtrasExtension Started

Instalação do zimlet separadamente

A fim de instalar o zimlet separadamente é necessario que os serviços Zimbra estejam funcionando
Como no caso do ´core´, pode proceder manualmente antes ou deixar que o script o inicie quando solicitado.
Uma vez o Zimbra esteja ativo, o zimlet será instalado; se o core foi instalado previamente, a versão do zimlet deve coincidir com aquele.

Instalação do Zimlet somente:

./install.sh zimlet

Atualização de ZeXtras Suite

Em caso de uma instância preexistente de ZeXtras Suite no seu sistema, a instalação de uma nova versão fará automaticamente a atualização. Veja as instruções acima para o procedimento de instalação.

Se você acabou de atualizar Zimbra, veja a seção ZeXtras_Suite_Installation_Guide/pt#Atualiza.C3.A7.C3.A3o_de_Zimbra aqui acima.

Atualização de ZeXtras Suite en uma infraestrutura Multiserver

A partir de ZeXtras Suite 2.2.0 se permite a intercompatibilidade entre versões, pelo que segundo o tipo de atualizaçõ que esteja realizando, se deve seguir um dos caminho seguintes:

  • Atualizar ZeXtras Suite 2.2+ a uma micro-versão diferente (Ex. 2.2.3 para 2.2.4)
    • Cada servidor separado se pode atualizar independentemente, e ZeXtras Suite funcionará corretamente inclusive em um ambiente com versões diferentes.
  • Atualizar desde uma versão anterior a 2.2 ou para uma versão maior diferente (Ex. 2.0.4 para 2.2.4 o 2.2.4 para 2.4.0)
    • Todos os servidores debversão ser atualizados ao mesmo tempo, ja que neste caso a intercompatibilidade entre versões não está garantida e ZeXtras Suite não funcionará corretamente até que todos os nodos tenham sido atualizados à mesma versão.

Downgrade de ZeXtras Suite

A fim de voltar para uma versão anterior de qualquer componente de ZeXtras Suite, você precisa desinstalá-lo usando um script de instalação de um pacote da versão idêntica ou superior, e a seguir, instalar as versões mais antigas.

Warning.png Atenção!

Um Downgrade pode ter como resultado que a licença e os backups existentes não sejam reconhecidos corretamente por uma versão anterior de ZeXtras Suite. Por isso não esta ação não é recomendada nem suportada.

Desinstalação completa de ZeXtras Suite

O processo de desinstalação é igual que a instalação. Só precisa colocar -u no comando. < /br> O script irá verificar a presença de todos os componentes de ZeXtras Suite e solicitará a sua remoção. < /br> Com a opção 'all' é possível remover o core o zimlet.

Por exemplo:

Executando

./install.sh -u all

Desinstalará o core e o zimlet.

Executando

./install.sh -u core

Desinstalará somente o core.

Executando

./install.sh -u zimlet

Desinstalará somente o zimlet.

Pós-Instalação e Pós-Desinstalação

Após a instalação ou desinstalação de ZeXtras Suite se recomenda limpar o caché do servidor e do navegador. Para isso simplesmente execute como usuário 'zimbra':

 zmprov fc zimlet

Conclusão

Se não chegar a uma conclusão bem-sucedida, verifique passo a passo este guia, ou dê uma olhada na seção de Solução de problemas!

Personal tools