Avamar: Como restaurar um banco de dados do Exchange a partir de um backup afetado pelo problema de disparidade de maiúsculas e minúsculas do caminho do banco de dados.

Objetivo:

• Restaurar um banco de dados do Exchange a partir de um backup do Avamar afetado pelo problema de disparidade de maiúsculas e minúsculas do caminho do banco de dados descrito em Avamar: falha na restauração do banco de dados do Exchange com erro avtar informando que o banco de dados não foi encontrado no backup
• Essa solução temporária é usada para restaurar um banco de dados do Exchange a partir de um backup que foi criado antes da aplicação do indicador "--use-case-sensitive-paths"
• Ele usa o binário avtar.exe em um prompt de comando elevado

• Se o backup a ser restaurado tiver sido feito nos últimos sete dias (em raras ocasiões), vá para a seção "Informações adicionais" e siga as instruções.

Pré-requisitos da solução temporária:

1. O sistema a partir do qual o avtar.exe é iniciado deve ter o Avamar Windows Client registrado no mesmo Avamar Server onde o backup está localizado. O plug-in do Exchange não é necessário para essa solução alternativa.
2. O prompt de comando do Windows deve ser aberto como administrador (prompt de comando elevado), a conta de usuário deve ter o privilégio de administrador local do sistema.
3. As credenciais para o MCUser do Avamar (ou qualquer outro usuário do Avamar com privilégio de restauração) são obrigatórias.
4. O caminho completo do client de backup do Avamar, o número do rótulo de backup e o caminho completo do banco de dados são necessários.
5. A unidade de destino deve ter espaço livre em disco suficiente para armazenar os bancos de dados e os arquivos de log relacionados à restauração (um exemplo de cálculo de espaço é fornecido abaixo).

Command Syntax: 

avtar.exe -x --internal --incpartials --status=60 --nostdout --debug --server=<IP/FQDN> --id=MCuser --ap=<password> --path=<domain/client> --labelnum=<label> --logfile=<Log path> --target=<Destination Path> <DB path to be restored without the mismatched section of the path> 

• O caminho completo do client para a opção "---acnt" diferencia maiúsculas de minúsculas. Ele pode ser encontrado no log de backup (arquivo de log avtar ou .alg). Veja o exemplo:

    <flag type="string" value="/clients/Exchange/EX-Node1.Dell.com" name="path" />

• O número do rótulo de backup pode ser visto diretamente na seção de restauração na interface do usuário do Avamar (GUI ou AUI).
• No último item do comando <caminho do item a ser restaurado>, abra o log de backup (se ainda estiver disponível na pasta /var) e procure a seção "targetlist". Nela, identifique o caminho completo do banco de dados necessário para restauração. Veja o exemplo para "database4":

  <targetlist>
    <view>
      <dir internal="true" labelnum="158" fullname="EX-Node4_00000000/H:/MountPoint/Database6" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="159" fullname="EX-Node4_00000000/C:/Program Files/avs/var/backupMetadata" acnt="/clients/Exchange/EX-Node1.Dell.com" />      
      <dir internal="true" labelnum="155" fullname="EX-Node3_00000000/H:/MountPoint/database5" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="155" fullname="EX-Node3_00000000/H:/mountpoint/database4" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="156" fullname="EX-Node3_00000000/C:/program files/avs/var/backupmetadata" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="157" fullname="EX-Node2_00000000/H:/MountPoint//Database3" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="158" fullname="EX-Node2_00000000/H:/MountPoint/Database2" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="159" fullname="EX-Node2_00000000/C:/Program Files/avs/var/backupMetadata" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="158" fullname="EX-Node1_00000000/H:/MountPoint/Database1" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="159" fullname="EX-Node1_00000000/C:/Program Files/avs/var/backupMetadata" acnt="/clients/Exchange/EX-Node1.Dell.com" />
    </view>
  </targetlist>

• Se o log de backup não estiver mais disponível no diretório /var, use as instruções "Recuperando um log de backup do Avamar do servidor" em "Informações adicionais" do artigo Avamar: Como coletar registros para solucionar problemas de backup e restauração
• Neste exemplo, o caminho seria semelhante a este:

  • EX-Node3_00000000\H:\mountpoints\Database4\Database4.edb

• No entanto, como o problema de "disparidade de letras maiúsculas" está no nível de "pontos de montagem", usar esse caminho completo resultaria na falha de restauração conhecida "Banco de dados não encontrado no backup"
• Para contornar esse problema de restauração, o caminho é cortado do nível imediatamente à esquerda da área de "pontos de montagem" incompatíveis. Neste exemplo, o caminho usado no comando é:

  • EX-Node3_00000000\H:\

• O resultado dessa solução alternativa é a restauração de qualquer banco de dados do Exchange, incluindo logs de transações (se eles estiverem no mesmo caminho na unidade H: que estavam hospedados no nó do Exchange "EX-Node3" no momento do backup.
  • Isso exigiria espaço livre em disco suficiente no sistema em que o comando é executado para acomodar todos os bancos de dados e logs de transações presentes no "EX-Node3" no momento do backup.
  • Por exemplo: Se o tamanho total do backup for de 3 TBs, ele não exigirá necessariamente 3 TBs de espaço livre para a restauração: 
    • Ele requer apenas o tamanho de todos os bancos de dados + logs restaurados do nó "EX-Node3".
    • Por exemplo, ele deve ter 400 GB em vez de 3 TB, o tamanho dos bancos de dados 4 e 5 junto com seus logs correspondentes
    • O espaço em disco deve ser calculado caso a caso

Etapas da solução temporária:

1. Prepare o comando no Bloco de notas com as informações corretas (se o valor logfile ou target contiver espaços, ele deverá estar entre aspas duplas)
2. Abra o prompt de comando do Windows no modo elevado
3. Mova para a pasta onde o binário "avtar.exe" está localizado, local padrão "C:\Program Files\avs\bin\"
4. Execute o comando pré-preenchido, veja o exemplo abaixo

avtar.exe -x --internal --incpartials --status=60 --nostdout --debug --server=192.168.20.105 --id=MCUser --password=******** --account=/clients/Exchange/EX-Node1.Dell.com --labelnum=163 --logfile=D:/Restore_logs/Restore_163_Database4_30-08-2024.log --target=E:/Restore_Temp EX-Node3_00000000/H:/ 

5. Aguarde até que o comando seja concluído (o prompt é retornado). Dependendo do tamanho dos dados a serem restaurados, isso pode exigir alguns minutos ou várias horas
6. Depois que o comando for concluído, verifique se os bancos de dados do Exchange foram restaurados corretamente com seus respectivos logs de transações
7. Se algum problema for encontrado durante o processo, analise os arquivos de log de restauração, conforme o exemplo "D:/Restore_logs/Restore_163_Database4_30-08-2024.log".
   • Se precisar de mais assistência, entre em contato com a equipe de suporte do Avamar usando o processo de chamado

Tarefa pós-restauração:

• Se a restauração for bem-sucedida, o banco de dados restaurado entrará no estado de "desligamento anormal".
• Isso ocorre porque os arquivos de log de transações ainda não foram executados novamente no banco de dados.
• Para executar os logs novamente, siga este artigo Avamar: Como recuperar um banco de dados do Exchange do estado de "desligamento anormal"

• Se o backup a ser restaurado tiver sido feito nos últimos sete dias, entre em contato imediatamente com a equipe de suporte do Avamar usando o processo de chamado. (Raras ocasiões)
• Informe que você leu este artigo e forneça a referência dele à equipe de suporte.
• A equipe de suporte do Avamar ajuda na recuperação usando um procedimento de restauração um pouco diferente, porém mais eficiente.