Avamar : Restauration d’une base de données Exchange à partir d’une sauvegarde affectée par le problème de non-correspondance de casse du chemin de la base de données.

Objectif :

• Restauration d’une base de données Exchange à partir d’une sauvegarde Avamar affectée par le problème de non-correspondance de casse du chemin de la base de données décrit dans Avamar : échec de la restauration de la base de données Exchange avec une erreur avtar indiquant que la base de données est introuvable dans la sauvegarde
• Cette solution est utilisée pour restaurer une base de données Exchange à partir d’une sauvegarde créée avant l’application de l’option « --use-case-sensitive-paths »
• Elle utilise le fichier binaire avtar.exe dans une invite de commande avec élévation de privilèges

• Si la sauvegarde destinée à être restaurée a été effectuée au cours des sept derniers jours (en de rares occasions), accédez à la section « Informations supplémentaires » et suivez les instructions.

Conditions préalables à la solution de contournement :

1. Sur le système à partir duquel le fichier avtar.exe est exécuté, le client Avamar Windows doit être inscrit sur le même serveur Avamar que la sauvegarde. Le plug-in Exchange n’est pas requis pour cette solution de contournement.
2. L’invite de commande Windows doit être ouverte en tant qu’administrateur (invite de commande avec élévation de privilèges), le compte d’utilisateur doit disposer des privilèges d’administrateur local du système.
3. Les informations d’identification de l’utilisateur MCUser Avamar (ou de tout autre utilisateur Avamar disposant de privilèges de restauration) sont requises.
4. Le chemin complet du client de sauvegarde Avamar, le numéro de libellé de sauvegarde et le chemin complet de la base de données sont requis.
5. Le disque de destination doit disposer d’un espace libre suffisant pour contenir les bases de données et les fichiers journaux liés à la restauration (un exemple de calcul de l’espace est fourni ci-dessous).

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> 

• Le chemin complet du client pour l’option « ---acnt » est sensible à la casse. Il se trouve dans le journal de sauvegarde (fichier journal avtar ou .alg). Par exemple :

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

• Le numéro de libellé de sauvegarde est directement visible dans la section « restore » de l’interface utilisateur Avamar (GUI ou AUI).
• Pour le dernier élément de la commande <item path to restore>, ouvrez le journal de sauvegarde (s’il est toujours disponible dans le dossier /var) et recherchez la section « targetlist ». Identifiez le chemin d’accès complet de la base de données requise pour la restauration. Par exemple, pour « datasase4 » :

  <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>

• Si le journal de sauvegarde n’est plus disponible dans le répertoire /var, suivez les instructions de la section « Récupération d’un journal de sauvegarde Avamar à partir du serveur » sous « Informations supplémentaires » de l’article Avamar : Comment collecter les journaux pour résoudre les problèmes de sauvegarde et de restauration
• Dans cet exemple, le chemin ressemble à ceci :

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

• Cependant, étant donné que le problème de « non-correspondance de la casse » se situe au niveau des « points de montage », l’utilisation de ce chemin complet entraînerait l’échec de restauration connu : « Database not found in backup »
• Pour contourner ce problème de restauration, le chemin est coupé juste avant les « points de montage » qui rencontrent le problème de correspondance. Dans cet exemple, le chemin utilisé dans la commande est le suivant :

  • EX-Node3_00000000\H:\

• Cette solution de contournement entraîne la restauration de toute base de données Exchange, y compris les journaux de transaction (s’ils se trouvent dans le même chemin sur le lecteur H: ) qui ont été hébergés sur le nœud Exchange « EX-Node3 » au moment de la sauvegarde.
  • Cela nécessite suffisamment d’espace disque libre sur le système où la commande est exécutée pour accueillir toutes les bases de données et tous les journaux de transaction présents sur « EX-Node3 » au moment de la sauvegarde.
  • Par exemple : Si la taille totale de la sauvegarde était de 3 To, elle ne nécessiterait pas obligatoirement 3 To d’espace libre pour la restauration : 
    • L’espace libre nécessaire est uniquement équivalent à la taille de toutes les bases de données et de tous les journaux restaurés à partir du nœud « EX-Node3 »
    • Par exemple, il doit être de 400 Go au lieu de 3 To, ce qui correspond à la taille des bases de données 4 et 5, ainsi que des journaux correspondants
    • L’espace disque doit être calculé au cas par cas

Étapes de la solution :

1. Préparez la commande dans un bloc-notes en y insérant les bonnes informations (si les valeurs logfile ou target comportent des espaces, elles doivent être placées entre guillemets)
2. Ouvrez l’invite de commande Windows en mode d’élévation de privilèges
3. Accédez au dossier dans lequel se trouve le fichier binaire « avtar.exe ». L’emplacement par défaut est « C:\Program Files\avs\bin\ »
4. Exécutez la commande préremplie (voir l’exemple ci-dessous)

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. Attendez que la commande se termine (l’invite est renvoyée). En fonction du volume des données à restaurer, cela peut prendre quelques minutes ou plusieurs heures
6. Une fois la commande terminée, vérifiez que les bases de données Exchange sont correctement restaurées avec leurs journaux de transaction respectifs
7. Si un problème est détecté au cours du processus, consultez les fichiers journaux de restauration, par exemple sous « D:/Restore_logs/Restore_163_Database4_30-08-2024.log ».
   • Si vous avez besoin d’une aide supplémentaire, contactez l’équipe de support Avamar à l’aide du processus de demande de service

Tâche post-restauration :

• Si la restauration réussit, la base de données restaurée devrait être à l’état « Dirty Shutdown ».
• En effet, les fichiers journaux de transaction n’ont pas encore été réexécutés dans la base de données.
• Pour revoir les journaux, suivez cet article Avamar : Restauration d’une base de données Exchange à partir de l’état « Dirty Shutdown »

• Si la sauvegarde destinée à être restaurée a été effectuée au cours des sept derniers jours, contactez immédiatement l’équipe de support Avamar en suivant le processus de demande de service. (Rares occasions)
• Indiquez que cet article a été lu et fournissez sa référence à l’équipe de support.
• L’équipe de support Avamar aide à la restauration selon une procédure de restauration légèrement différente, mais plus efficace.