Avamar : Échec de la restauration de la base de données Exchange avec l’erreur avtar indiquant que la base de données est introuvable dans la sauvegarde

Scénario :

• L’exigence consiste à restaurer une base de données Exchange, que nous appelons « Database4 » dans cet exemple.
• Le processus de restauration de la base de données échoue avec un message dans le journal indiquant que le chemin Database4 est introuvable dans la sauvegarde, mais que la base de données est disponible pour la restauration dans l’interface utilisateur Avamar (GUI et AUI).
•  Voici le type de message d’erreur affiché dans le log de restauration :

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) 

• La restauration d’une autre base de données (par exemple Database2) à partir du même élément de sauvegarde et du même serveur Exchange Server fonctionne comme prévu. 

L’environnement Exchange présente une configuration de base de données non standard prise en charge par Microsoft, mais elle est connue pour provoquer ce problème sur le produit Avamar.

Dans ce scénario, la base de données concernée (Database4) présente une majuscule incohérente dans le chemin du fichier de base de données.
Il existe une incompatibilité entre le « chemin de stockage de la base de données » du système d’exploitation et le « chemin d’accès à l’emplacement de la base de données » de l’application Exchange.

Exemple d’une base de données affectée (Database4) :
Non-correspondance des chemins : 

• Le chemin d’accès au système d’exploitation pour les bases de données a été créé avec le dossier « Mount Point » en majuscules (lettres M et P)

H:\MountPoints\Database4\Database4.edb

• Le chemin d’accès Database4 dans l’application Exchange a été configuré avec toutes les lettres en minuscules :

H:\mountpoints\Database4\Database4.edb

Exemple de base de données non affectée (Database2) :
Le chemin d’accès de la base de données du système d’exploitation et son chemin correspondant dans la configuration Exchange ont la même majuscule :

• Chemin de stockage de la base de données

H:\MountPoints\Database2\Database2.edb

• Chemin d’accès à l’emplacement de la base de données

H:\MountPoints\Database2\Database2.edb

 
Pour vérifier ces chemins :

• Utilisez l’Explorateur Windows pour vérifier le chemin du système d’exploitation
• Utilisez le Centre d’administration Exchange (CAE) pour vérifier la configuration de la base de données
  • >= serveurs/bases de données/<modifier les propriétés de la base de données concernée>
    • Vous pouvez également utiliser la commande Exchange Powershell :

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

En raison de cette incompatibilité, le processus Avamar (avtar) consigne les informations de base de données incorrectes dans les métadonnées de sauvegarde au cours du processus de sauvegarde.

Au moment de la restauration, le processus avtar n’identifie pas le chemin d’accès correct de la base de données. Par conséquent, il ne parvient pas à restaurer la base de données en affichant le message « database not found in backup »

Pour résoudre le problème d’incompatibilité des cas de cette base de données, le produit Avamar est doté d’une balise appelée « --use-case-sensitive-paths », qui gère ces types de scénarios.

• La balise doit être ajoutée dans le fichier « avexvss.cmd » sous le dossier var du client Avamar (chemin par défaut « C :\Program Files\avs\var\ ») dans tous les nœuds DAG Exchange participant au processus de sauvegarde.
• En outre, pour les sauvegardes fédérées DAG, la balise doit être ajoutée dans le fichier « avexvss.cmd » sous le répertoire var du client de cluster
  • Il s’agit du chemin UNC partagé entre les nœuds DAG. Il est nécessaire pour coordonner les sauvegardes et stocker la configuration du client DAG et les fichiers
    log. Exemple de chemin UNC « \\share-server\share-folder\DAGname\var\ »)
• La valeur de la balise doit être définie sur « false » (sa valeur par défaut est « true ») :
  • --use-case-sensitive-paths=false

• Si la balise n’est ajoutée qu’au nœud proxy (dans une configuration DAG sans IP) ou au client de cluster (dans une configuration fédérée), la sauvegarde réussit, mais la restauration peut échouer avec le même problème.
• Par conséquent, il est important d’ajouter la balise mentionnée dans chaque nœud Exchange (du cluster DAG) participant au processus de sauvegarde.

 
La définition de cette balise sur « false » garantit que toutes les sauvegardes futures ne sont pas affectées et que la restauration réussit pour ces nouvelles sauvegardes.

Les anciennes sauvegardes ne sont pas corrigées à l’aide de cette balise et nécessitent une procédure spécialisée pour être restaurées.

Cette procédure spéciale est décrite dans Avamar : Restauration d’une base de données Exchange à partir d’une sauvegarde affectée par le problème d’incompatibilité de cas du chemin d’accès à la base de données.

• Si la balise mentionnée n’est pas utilisée dans un environnement Exchange qui présente une incompatibilité de majuscules et minuscules, la sauvegarde peut échouer avec cette erreur :

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').

• Cette procédure est décrite dans le Guide de l’utilisateur d’Avamar for Exchange VSS dans le chapitre « Dépannage » section « Échec de la sauvegarde en raison de la sensibilité à la casse »
• Elle est également documentée dans Avamar : Échec de la sauvegarde VSS Exchange avec l’erreur avtar « Impossible de créer SnapView, car l’un des éléments requis pour le chemin « XXXXX.edb » est introuvable »