Restaurando com base em um backup

Você pode restaurar uma instância do Enterprise Server com base em um backup usando a linha de comando. O serviço de backup dá suporte à restauração da instância completa, incluindo a configuração e os dados do usuário.

Você só poderá restaurar um instantâneo se ele for de no máximo duas versões de recurso anteriores à versão da instância de destino.

Por exemplo:

• Um instantâneo da versão 3.17 pode ser restaurado para um destino executando a 3.17.x, 3.18.x ou 3.19.x.
• Não é possível restaurar um instantâneo 3.17 para a 3.20 — que está mais de duas versões à frente.

Você também não pode restaurar de uma versão mais recente para uma mais antiga. Por exemplo, tentar restaurar um instantâneo 3.18 para uma instância 3.17 falhará com: Error: Snapshot can not be restored to an older release of Enterprise Server.

Antes de restaurar um backup:

1. Habilite o modo de manutenção na instância de destino. Confira Habilitar e programar o modo de manutenção.
2. Verifique o acesso ao armazenamento de backup que contém o instantâneo.
3. Pause os serviços que causam interferência — se estiver usando alta disponibilidade (HA), verifique se a replicação foi interrompida.
4. Prepare-se para o Actions — se habilitado, verifique se a instância de destino está configurada com o armazenamento externo correto. Confira Como restaurar com o Actions habilitado para obter detalhes.

Para restaurar de um instantâneo:

1. Acesse a instância de destino poe SSH como o usuário admin.

2. Execute um dos seguintes comandos:

   • Restaure o instantâneo mais recente:

     ghe-restore
     

   • Restaure um instantâneo específico. Substitua <SNAPSHOT_TIMESTAMP> pelo carimbo de data/hora do instantâneo que você deseja restaurar (por exemplo, YYYYMMDDTHHMMSS).

     ghe-restore -s <SNAPSHOT_TIMESTAMP>
     

   • (Opcional) Force a substituição de dados de configuração, certificados e licença:

     ghe-restore -c          # Latest snapshot
     ghe-restore -s <SNAPSHOT_TIMESTAMP> -c  # Specific snapshot
     

3. Finalize no Console de Gerenciamento:

   • Revise todas as configurações (rede, autenticação, TLS etc.).
   • Clique em Save settings para aplicá-las e iniciar os serviços.
   • A instância não estará totalmente operacional até que esta etapa seja concluída.

4. Valide a instância restaurada para garantir que tudo funciona conforme o esperado.

5. Se estiver usando HA, conclua a restauração em uma instância autônoma primeiro. Em seguida, reconfigure a HA.

   • Se encontrar problemas de sincronização (por exemplo, UUIDs obsoletos no ghe-repl-status), execute ghe-repl-teardown.
   • Para obter ajuda, entre em contato com o Suporte do .

6. Registre novamente os executores auto-hospedados do Actions, pois a restauração invalida os tokens anteriores.

Os instantâneos são removidos automaticamente com base nas configurações de retenção:

• Somente os n instantâneos mais recentes são mantidos (conforme configurado).
• Instantâneos mais antigos são excluídos após cada backup bem-sucedido.
• Instantâneos são nomeados usando carimbos de data/hora (YYYYMMDDTHHMMSS) para facilitar a referência.
• Links rígidos são usados para armazenar arquivos inalterados com eficiência, preservando a capacidade de restauração completa.

Se uma operação de restauração falhar, verifique:

• Integridade do backup – verifique se o instantâneo não foi interrompido ou corrompido.
• Acesso ao armazenamento – verifique se a instância pode montar e ler o volume de backup.
• Incompatibilidade de versão – confirme se a versão do instantâneo é compatível com a instância de destino.
• Logs – revise /var/log/-backup/restore-verbose-[timestamp].log para detectar obter erros.

Se o Console de Gerenciamento mostrar uma falha genérica, acesse a instância por SSH para acessar logs detalhados.