ZeXtras Migration Tool Installation Guide/pt

From ZeXtras Suite Wiki

Jump to: navigation, search
Língua: English  • español • português

Guia de instalação de ZeXtras Migration Tool

Pré-requisitos

Não é requerido nenhum software adicional além do necessario para instalar Zimbra, para ZeXtras Migration Tool.

Onde baixar os arquivos de instalação de ZeXtras Migration Tool

Diretamente do site de download da ZeXtras.

Instalação e configuração

Componentes

ZeXtras Migration Tool se compõe de dois elementos principais:

  • O core, que é um pacote .jar para expandir Zimbra.
  • O zimlet que gerencia e acessa o core.

O script de instalação segue a estrutura mencionada acima permitindo-lhe três 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.

Instalación de ZeXtras Suite em ambientes multistore

Tenha em conta as seguientes regras para instalar ZeXtras Migration Tool quando trabalha em ambientes multistore:

REGRA 1: ZeXtras Suite deve ser instalado em todos os servidores que executem o serviço 'mailboxd'.

REGRA 2: Instalar ZeXtras Suite em cada servidor um a um. Fazê-lo em todos os servidores ao mesmo tempo pode saturar os logs com erros.

REGRA 3: se seu Master Server LDAP é também um servidor de e-mail, a REGRA 2 se faz imprescindível. Se falha vai causar problemas maiores, destruição e parada do servidor.

REGRA 4: Como sempre, tome-se seu tempo :)


Instruções gerais

Antes de instalar ZeXtras Migration Tool terá de baixar o pacote como foi explicado na seção apropriada acima, e descomprimir o arquivo em uma pasta da sua escolha.

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

Dentro da pasta <codeZzextras_migration_tool-XXX</code> encontrará um shell script executável chamado install.sh.

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

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

-h         Esta mesma mensagem
-u         Desinstala a opção

As opções disponíveis são:
core   -- O core ZeXtras Migration Tool
zimlet -- O zimlet ZeXtras Migration Tool
all    -- O core seguido do zimlet ZeXtras Migration Tool core

* Para poder usar ZeXtras Migration Tool tem de serem 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 uma instalação bem sucedida se requer 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 sistema determinando a sua versão Zimbra e qualquer instalação preexistente de ZeXtras Migration Tool ou ZeXtras Suite.

Warning.png Atenção!

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

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.


Instalação completa de ZeXtras Migration Tool

--- RECOMENDADO ---
Para instalar ZeXtras Migration Tool, 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!

Cuidado! devem corresponder ás versões do core e do zimlet de ZeXtras Migration Tool, mesmo quando sejam instalados separadamente.

Video tutorial de instalação de ZeXtras Migration Tool


Instalação completa:

./install.sh all

Instalação do core de ZeXtras Migration Tool

Para instalar o core de ZeXtras Migration Tool 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 de ZeXtras Migration Tool 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 precisará ser reiniciado para verificar se a operação anterior foi feita corretamente.
(Se estiver usando a opção all o próprio script pedirá ele mesmo para iniciar o Zimbra.)
Logo depois que Zimbra esteja totalmente inicializado, a presença de linhas como as abaixo descritas em /opt/zimbra/log/mailbox.log marcará uma instalação 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 de ZeXtras Migration Tool

A fim de instalar ZeXtras zimlet Migration Tool é necessario que os serviços Zimbra estejam funcionando.
Como acima, você pode proceder manualmente ou deixar que o script os inicialize quando solicitado.
Uma vez o Zimbra esteja ativo o zimlet será instalado; se o core foi instalado previamente, ambas as versões devem coincidir.

Instalação do zimlet por separado:

./install.sh zimlet

Atualização completa de ZeXtras Migration Tool

Em caso de uma instância preexistente de ZeXtras Migration Tool no seu sistema, a instalação de uma nova versão irá atualizar automaticamente a versão pré-existente.
Veja as instruções acima para o procedimento de instalação.

Warning.png Atenção!

As versões do core e do zimlet devem sempre coincidir para que ZeXtras Migration Tool funcione corretamente. Tenha em conta isso se atualizar os componentes separadamente.

Reversão total de ZeXtras Migration Tool

Para revertir qualquer componente de ZeXtras Migration Tool, precisa desinstalá-lo usando um script de instalação de um pacote da versão idêntica ou superior, e em seguida, instalar as versões mais antigas.

Warning.png Atenção!

Uma reversão pode ter como resultado que as licenças ou os backups existentes não sejam reconhecidos corretamente por uma versão anterior do ZeXtras Migration Tool. Portanto, não é recomendado nem suportado.


Desinstalação completa de ZeXtras Migration Tool

O procedimento de remoção é mais semelhante à uma instalação. O único que precisa é colocar a opção -u antes da execução.
O script irá verificar a presença de todos os componentes de ZeXtras Migration Tool e solicitará a sua remoção.
Com a opção all, remove o core logo o zimlet.

Por exemplo:

./install.sh -u all

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!

Agora que a ferramenta de migração está instalada e funcionando, com certeza vai querer fazer uso dela. Siga este link para ver como!

Personal tools