ZeXtras Suite Installation Guide/pt

From ZeXtras Suite Wiki

< ZeXtras Suite Installation Guide
Jump to: navigation, search
Língua: English  • español • português
Warning.png Warning!

This wiki is outdated and not maintained anymore, please refer to the new Zextras Documentation Hub at https://docs.zextras.com

Zextras logo box.png
This documentation is outdated.
Please refer to https://docs.zextras.com

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://download.zextras.com/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.


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.

Guia rápido de 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)..


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).


Remoção de Zimbra Chat

A partir da versão 2.6.1 o instalador Zextras remove o componente Zimbra Chat para quem esteja utilizando ou queira utilizar Zextras Chat em seu lugar. Para que isto aconteça, os serviços LDAP e Mailbox deven estar ativos pois o instalador requer do 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

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 com o 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.

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-latest.tgz
$ ls 
zextras_suite-latest.tgz zextras_suite/

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

$ cd zextras_suite
$ ./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.


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 utilizando a opção all o próprio script pedirá ele mesmo para iniciar esse serviço)


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 para uma micro-versão diferente (Ex. 2.16.1 para 2.16.2)
    • 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 maior (Ex. 2.14.x para 2.16.x)
    • Todos os servidores deverão ser atualizados ao mesmo tempo, já que em este 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 na mesma versão.

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
Personal tools