Como migrar caixas de correio do Zimbra para um novo servidor com o Zextras Backup ou imapsync.

Para uma migração completa de Zimbra para Zimbra, utilize um fluxo de trabalho de migração compatível com o Zextras Backup quando precisar de dados de caixa de correio além de e-mails. Use o imapsync quando ambos os servidores expõem as contas via IMAP e seu escopo inclui mensagens, pastas e sinalizadores. A Zextras informa que sua antiga Ferramenta de Migração Zextras não está mais disponível. Seu guia de migração para Zimbra direciona os administradores para o Zextras Backup. O imapsync é uma opção de linha de comando separada para copiar caixas de correio IMAP; ele não substitui uma migração compatível com Zimbra para calendários, contatos, compartilhamentos ou configurações de conta.

Essa distinção determina o quanto você precisa provisionar e testar no novo servidor. Antes de alterar os registros MX ou permitir que os usuários trabalhem no destino, confirme as versões de origem e destino, o licenciamento, a autenticação, o armazenamento e os dados exatos que você deve manter.

Documentação verificada em 6 de outubro de 2026. O site oficial do imapsync lista a versão 2.314. O artigo de migração da Zextras informa que a Ferramenta de Migração legada não está disponível e descreve uma rota de backup do Zextras. As páginas e exemplos do Zextras dependem da versão; valide-os com as versões do Zextras e do Zimbra instaladas em sua instalação antes de executá-los em produção.

1. Escolha a rota que corresponda aos dados que você precisa.

O guia de migração do Zimbra publicado pela Zextras lista e-mails e pastas, contatos, calendários, tarefas, compartilhamentos, preferências, assinaturas, identidades e alguns dados de domínio ou classe de serviço entre os itens que seu fluxo de trabalho de backup pode migrar. Também afirma que o fluxo de trabalho não migra configuração de servidor, configuração LDAP, configuração de MTA ou proxy, nem personalização da marca. A abrangência exata depende das versões e configurações do produto, portanto, considere essa lista como um guia de escopo e verifique cada item necessário na documentação atual.

O Imapsync funciona através do IMAP. Ele copia pastas e mensagens de caixas de correio e pode sincronizar sinalizadores de mensagens que o destino suporte. Ele não transfere o diretório LDAP do servidor Zimbra, preferências de conta, calendários, catálogos de endereços, recursos compartilhados ou configuração do servidor. Se algum desses itens for importante para você, planeje outro método de exportação/importação compatível ou selecione a opção Zextras.

Não crie um novo plano com base na antiga Ferramenta de Migração Zextras: o guia de migração Zextras indica que ela não está mais disponível. Além disso, evite copiar orientações obsoletas sobre IMAP de páginas arquivadas do Zimbra sem compará-las com as Perguntas Frequentes (FAQ) atuais sobre imapsync do Zimbra ; essas FAQs alertam especificamente que um guia antigo sobre imapsync do Zimbra está obsoleto.

2. Prepare ambos os servidores antes de copiar os dados.

Antes de provisionar o destino, faça um inventário de: domínios, contas, aliases, quotas, tamanhos de caixas de correio, senhas de usuários ou planos de redefinição, pastas compartilhadas, calendários, contatos, listas de distribuição, necessidades de retenção e os recursos do servidor dos quais os usuários dependem. Identifique qual host recebe novos e-mails durante cada fase. Mantenha esse inventário como sua lista de verificação pós-migração.

• Confirme a compatibilidade com a plataforma. Verifique se o destino está instalado, em funcionamento e se utiliza uma combinação Zimbra/Zextras compatível com o seu processo de migração. Para o Zextras Backup, o fluxo de trabalho Zimbra do fornecedor exige um destino Zextras Backup e uma origem executando Zextras Backup ou Zimbra Suite Plus. Confirme a elegibilidade com o fornecedor antes de utilizar o recurso.
• Verifique a capacidade. Estime o espaço disponível para o servidor de e-mails ativo do destino, o backup de origem ou exportação em tempo real e o backup de destino. O guia de migração da Zextras alerta que o destino pode precisar de espaço para todos os três; não dimensione o espaço apenas com base no total de caixas de correio visíveis para os usuários.
• Faça backup e teste as restaurações. Mantenha um backup recuperável separado da origem. Para uma migração do Zextras, siga as verificações e o procedimento de backup da versão instalada. Para o imapsync, use primeiro uma caixa de correio de teste no destino; o tutorial do imapsync enfatiza que a origem é lida enquanto o destino é modificado.
• Teste a conectividade e a autenticação. Confirme se um administrador ou usuário de teste consegue acessar ambos os endpoints IMAP usando a conexão segura pretendida. Não habilite a autenticação em texto não criptografado apenas porque um guia antigo recomenda; use as configurações de TLS/SSL e autenticação compatíveis com a sua versão do Zimbra.
• Planeje o DNS e o fluxo de e-mails. Se o registro MX for alterado, reduza o TTL com antecedência, caso seu provedor de DNS permita, e mantenha o servidor antigo durante a transição para que a entrega atrasada ou em cache possa ser monitorada e corrigida.

3. Use o Zextras Backup para uma migração compatível com o Zimbra.

Este método foi desenvolvido para administradores que migram entre sistemas Zimbra e precisam de mais do que apenas e-mail IMAP. Não se trata de um comando único e universal: as versões dos produtos de origem e destino, o layout do caminho de backup, as permissões, o armazenamento e a ordem de migração são importantes. O guia da Zextras indica que seus comandos de linha de comando devem ser executados como o zimbrausuário root, a menos que seja explicitamente especificado o contrário.

Criar e transferir um backup de origem

Siga o guia atual do Zextras Backup para a versão instalada em seu dispositivo. O passo a passo do Zextras Zimbra começa com verificações de integridade da fonte e uma verificação completa com o SmartScan. O comando de exemplo é mostrado abaixo; verifique a sintaxe do comando e quaisquer etapas de manutenção necessárias em relação à sua versão antes de executá-lo:

zxsuite backup doSmartScan start deep true

Após a exportação dos dados de origem, transfira os dados de backup necessários para um diretório temporário no destino. O Zextras fornece rsyncuma opção de transporte e recomenda repetir a transferência enquanto a origem permanece ativa, para que as transferências subsequentes movam apenas os dados alterados. O caminho do diretório temporário de destino deve ser legível pelo usuário do Zimbra e não deve ser confundido com o caminho do backup ativo do Zextras no destino. Proteja o canal de transferência e mantenha um registro de cada transferência.

Provisionar e restaurar no destino.

A Zextras documenta uma importação somente para provisionamento que cria domínios, classes de serviço e contas, ignorando o conteúdo das caixas de correio. Trata-se de uma fase de configuração, não de uma restauração completa de e-mails.

zxsuite backup doExternalRestore /path/for/data/ provisioning_only TRUE

Após o provisionamento, execute a restauração externa completa com uma configuração de simultaneidade escolhida a partir de um teste realizado no seu servidor de destino. O Zextras fornece concurrent_accountsum parâmetro e recomenda testar o desempenho em vez de assumir que um único valor serve para todos os servidores. Repita a transferência do backup de origem e a restauração incremental apropriada, conforme necessário, para coletar as alterações feitas durante a janela de migração. Mantenha a origem disponível até que os usuários e o fluxo de e-mails sejam verificados.

O fornecedor descreve variantes de implantação em etapas e em uma única passagem, e a ordem delas pode depender do plano de migração. Use o procedimento correto para a versão instalada, em vez de misturar comandos de versões diferentes. Não edite nem exclua os dados de backup ou arquivos de mapeamento importados enquanto a restauração estiver em andamento.

4. Use o imapsync quando seu escopo for e-mail IMAP.

O Imapsync é útil quando as caixas de correio de origem e destino são acessíveis via IMAP e você deseja copiar mensagens e pastas sem instalar um produto de migração específico do Zimbra. Ele está disponível para Linux, Windows e macOS. Os exemplos abaixo usam marcadores, não nomes de servidor ou credenciais reais. Armazene senhas em um script protegido ou outro método aprovado de tratamento de segredos; nunca as publique em um ticket, histórico de shell compartilhado ou artigo.

Comece com uma caixa de correio de origem e uma caixa de correio de destino de teste. Use um teste simulado para verificar logins e inspecionar o mapeamento de pastas sem gravar no destino. O tutorial oficial do Imapsync mostra essas opções para uma verificação inicial somente de pastas:

imapsync \
  --host1 SOURCE_IMAP --user1 USER --password1 SOURCE_SECRET \
  --host2 DEST_IMAP   --user2 USER --password2 DEST_SECRET \
  --automap --justfolders --dry

Substitua os marcadores de posição usando o fluxo de trabalho de credenciais seguras da sua organização. Confirme se a origem e o destino são os hosts pretendidos, se ambos os logins foram bem-sucedidos e se pastas como Enviados, Rascunhos e Lixeira estão mapeadas para os nomes de destino corretos. Se o mapeamento estiver incorreto, corrija-o antes de copiar as mensagens.

Após o teste ser bem-sucedido, remova --justfolderse --dryexecute a cópia da caixa de correio. Mantenha --automapapenas se o mapeamento proposto estiver correto para os nomes das suas pastas:

imapsync \
  --host1 SOURCE_IMAP --user1 USER --password1 SOURCE_SECRET \
  --host2 DEST_IMAP   --user2 USER --password2 DEST_SECRET \
  --automap

Execute o comando testado para cada caixa de correio por meio de um script controlado, caso tenha muitos usuários. Consulte o tutorial oficial do imapsync e as boas práticas para obter informações sobre a sintaxe e as opções específicas da plataforma. Evite parâmetros destrutivos, como `--exclude` --delete1ou ` --delete2--exclude`, a menos que deseje excluir dados intencionalmente nesse lado e tenha testado o resultado em um destino descartável. Uma cópia de migração não deve apagar inesperadamente os e-mails de origem ou os dados exclusivos do destino.

5. Execute uma sincronização delta final e alterne o fluxo de e-mails.

Em ambos os casos, uma primeira passagem pode demorar enquanto os usuários continuam trabalhando. Agende uma sincronização final próxima à data de transição. Com o imapsync, execute novamente o mesmo comando testado: a ferramenta foi projetada para execuções incrementais e normalmente ignora mensagens já sincronizadas. Mantenha a caixa de correio de origem inalterada durante a passagem final, sempre que possível. Se os usuários já estiverem utilizando ambos os servidores, resolva essas alterações divergentes separadamente; o imapsync não é uma ferramenta de mesclagem bidirecional.

Para o Zextras Backup, siga o procedimento de importação em etapas específico da versão e repita a etapa necessária de transferência/restauração do backup para capturar as alterações desde a última passagem. Não presuma que o provisionamento importe apenas e-mails, calendários ou contatos; ele cria estruturas de conta, mas ignora o conteúdo das caixas de correio.

Quando o destinatário estiver pronto para receber e-mails, altere o registro MX e quaisquer registros de webmail relacionados de acordo com sua configuração de DNS e proxy. Mantenha o servidor antigo em execução e monitore ambos os sistemas enquanto os caches de DNS expiram e os e-mails atrasados ​​chegam. Utilize um cronograma de manutenção documentado e comunique aos usuários se eles devem acessar o servidor antigo ou o novo durante cada fase.

6. Verifique o novo servidor antes de desativar o antigo.

Teste um conjunto representativo de caixas de correio pequenas, grandes, recentes e antigas. Compare as listas de pastas e a contagem de mensagens, abra mensagens com anexos, verifique o status de lidas/não lidas e sinalizadas e confirme se as mensagens enviadas aparecem na pasta correta. Envie e receba e-mails do destino e confirme se a pesquisa MX pública e os logs do servidor mostram a entrega no host esperado.

Para uma migração do Zextras, teste separadamente calendários, contatos, tarefas, compartilhamentos, identidades, assinaturas, preferências do usuário e quaisquer configurações de domínio ou classe de serviço incluídas no seu escopo. O Zextras documenta uma verificação de consistência de compartilhamentos zxsuite backup doCheckShares; use o procedimento de reparo correspondente somente se necessário e compatível com a sua versão instalada. Verifique novamente o acesso do usuário e o comportamento da senha.

Mantenha o servidor de origem e um backup recuperável até que as partes interessadas aprovem o resultado e o período de retenção termine. Não cancele o host antigo simplesmente porque o destino aceita logins. Encerre o projeto somente após a confirmação do roteamento de e-mails, do acesso do usuário, dos dados não relacionados a e-mails e dos registros de reversão.

Fontes

• Zextras: Como migrar servidores Zimbra usando o Zextras Backup
• Documentação de backup do Zextras Suite
• Site oficial do imapsync e informações sobre a versão
• Tutorial oficial do imapsync
• FAQ oficial do imapsync Zimbra
• Boas práticas oficiais do imapsync