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

Situação:

• O requisito é restaurar um banco de dados do Exchange, que chamamos de "Database4" para este exemplo.
• O processo de restauração do banco de dados falha com uma mensagem no log informando que o caminho do Database4 não foi encontrado na parte de backup, no entanto, o banco de dados está disponível para restauração na interface do usuário do Avamar (GUI e AUI).
•  Esse é o tipo de mensagem de erro vista no log de restauração:

avtar Error <5195>: Path "EX-Node3_00000000\H:\mountpoints\Database4\Database4.edb" not found in backup. (Element 'Database4.edb' at position 3 in search path 'EX-Node3_00000000\H:\mountpoints\Database4\Database4.edb' not found) 

• A restauração de outro banco de dados (por exemplo, Database2) a partir da mesma parte de backup e do mesmo Exchange Server funciona conforme o esperado. 

O ambiente Exchange apresenta uma configuração de banco de dados não padrão compatível com a Microsoft, mas é conhecida por causar esse problema ao produto Avamar.

Nesse cenário, o banco de dados afetado (Database4) apresenta uma capitalização maiúscula inconsistente no caminho do arquivo de banco de dados.
Há uma disparidade entre o "caminho de armazenamento do banco de dados" do sistema operacional e o "caminho do local do banco de dados" do aplicativo Exchange.

Exemplo de um banco de dados afetado (Database4):
incompatibilidade de caminhos: 

• O caminho do SO para os DBs foi criado com a pasta "Mount Point" em maiúsculas (letras M e P)

H:\MountPoints\Database4\Database4.edb

• O caminho Database4 no aplicativo Exchange foi configurado com todas as letras em minúsculas:

H:\mountpoints\Database4\Database4.edb

Exemplo de um banco de dados não afetado (Banco de Dados 2):
O caminho do banco de dados do sistema operacional e seu caminho correspondente na configuração do Exchange têm a mesma capitalização maiúscula e minúscula:

• Caminho de armazenamento do banco de dados

H:\MountPoints\Database2\Database2.edb

• Caminho do local do banco de dados

H:\MountPoints\Database2\Database2.edb

 
Para verificar esses caminhos:

• Use o Windows Explorer para verificar o caminho do sistema operacional
• Use o Centro de administração do Exchange (EAC) para verificar a configuração do banco de dados
  • => servidores/bancos de dados/<editar propriedades do banco de dados afetado>
    • Como alternativa, use o comando do Exchange PowerShell:

Get-MailboxDatabase -Identity <affected DB name> | Select-Object edbfilepath, logfolderpath | fl

A condição de disparidade de maiúsculas e minúsculas faz com que o processo do Avamar (avtar) registre as informações incorretas do banco de dados nos metadados de backup durante o processo de backup.

No momento da restauração, o processo avtar não identifica o caminho correto do banco de dados. Portanto, ele falha ao restaurar o banco de dados imprimindo a mensagem "banco de dados não encontrado no backup"

Para resolver a situação de disparidade de maiúsculas e minúsculas desse banco de dados, o produto Avamar conta com um indicador chamado "--use-case-sensitive-paths", que cuida desses tipos de cenários.

• O indicador deve ser adicionado no arquivo "avexvss.cmd" na pasta var do Avamar Client (caminho padrão "C:\Program Files\avs\var\") em todos os nós da DAG do Exchange que participam do processo de backup.
• Além disso, para backups federados do DAG, o indicador deve ser adicionado no arquivo "avexvss.cmd" no diretório var do client do cluster
  • Esse é o caminho UNC compartilhado entre os nós do DAG e é necessário para coordenar backups e armazenar arquivos
    de log e configuração do client DAG Exemplo de caminho UNC "\\share-server\share-folder\DAGname\var\")
• O valor do indicador deve ser definido como "false" (seu valor padrão é "true"):
  • --use-case-sensitive-paths=false

• Se o indicador for adicionado apenas ao nó proxy (na configuração de DAG sem IP) ou client de cluster (na configuração federada), o backup será bem-sucedido, mas a restauração poderá falhar nesse mesmo problema.
• Portanto, é importante adicionar o indicador mencionado em cada nó do Exchange (do cluster do DAG) que participa do processo de backup.

 
Definir esse indicador como "false" garante que todos os backups futuros não sejam afetados e que a restauração seja bem-sucedida para esses novos backups.

Backups mais antigos não são corrigidos usando esse indicador e exigem um procedimento especializado para serem restaurados.

Esse procedimento especial é descrito no 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.

• Se o indicador mencionado não for usado em um ambiente Exchange que apresente a disparidade de capitalização de maiúsculas e minúsculas, o backup poderá falhar com este erro:

avtar Error <7042>: Failed to create snapview, as one of the elements required for path "XXXXXXXXX.edb" not found in backup account '/XXXXXX' lablenum 3 (only found 'XXXX\E:' of path 'XXXX.edb').

• Isso é descrito no Guia do usuário do Avamar for Exchange VSS, no capítulo "Solução de problemas", seção "Falha no backup devido à diferenciação de maiúsculas e minúsculas"
• Ele também está documentado no Avamar: Falha no backup de VSS do Exchange com o erro avtar "Falha ao criar o snapview, pois um dos elementos necessários para o caminho "XXXXX.edb" não foi encontrado"