Avamar : Échec du démontage de l’accès instantané avec une erreur de liste de clients non valide lors de la restauration IA

Échec du démontage de l’accès instantané

La tentative de démontage d’un datastore à accès instantané (IA) dans Avamar ne se termine pas et renvoie une erreur.

• L’interface utilisateur d’Avamar affiche le "Invalid client-list" Message d’erreur lors de l’opération de démontage.
• Le processus de démontage reste en attente et n’atteint jamais un état réussi.
• Le client NFS associé au chemin d’exportation IA n’est pas répertorié lors de l’interrogation du système Data Domain.

Cause première de l’échec du démontage IA.

L’opération de démontage IA échoue avec le Invalid client‑list erreur car le client NFS (hôte ESXi) utilisé pour la restauration IA n’est plus présent dans la configuration Data Domain.

• La liste des clients NFS Data Domain ne contient pas l’hôte ESXi qui a initié la restauration IA.
• Lorsque le client est manquant, Data Domain ne peut pas résoudre le chemin d’exportation, ce qui entraîne le Invalid client‑list Erreur lors du démontage.
• Si la demande /data La partition de l’appliance Data Domain n’est pas montée, le répertoire d’exportation IA devient inaccessible, ce qui peut déclencher la même erreur.

Exemple de client NFS manquant sur Data Domain :

# nfs show clients
No NFS clients found.

Exemple d’un client NFS actuel (à des fins de comparaison) :

# nfs show clients
Path                                            Client          Options
------------------------------------------------ ---------------- ------------------------------
/data/col1/avamar-XXXXXXXXXX/VMDS/Avamar-MOD-XXXXXXXXXXXXX  X.X.X.X  (sec=sys,rw,no_root_squash,no_all_squash,secure,version=3)

Étapes de résolution de l’erreur « Liste de clients non valide » lors du démontage de l’accès instantané.

Configuration requise

• Accès à l’interface utilisateur Avamar.
• Accès SSH au système Data Domain avec des privilèges d’administration.
• Connectivité réseau entre l’hôte ESXi et l’appliance Data Domain.

Procédure de résolution

1. Identifiez l’ID de tâche d’accès instantané (IA).
   Utilisez l’interface utilisateur d’Avamar : Banques de données NFS du serveur > Data Domain. Notez l’ID de tâche IA affiché.
2. Confirmez l’adresse IP de l’hôte ESXi.
   Exécutez une recherche DNS (Domain Name System) pour le nom de domaine complet (FQDN) de l’hôte ESXi et vérifiez que l’adresse IP renvoyée correspond à l’hôte.

   nslookup

3. Vérifiez les mappages client NFS existants sur Data Domain.

   nfs show clients

    Si l’hôte ESXi s’affiche dans la liste, tentez d’abord un démontage à partir de l’interface utilisateur Avamar. S’il n’apparaît pas, continuez.
4. Vérifiez l’ID du nœud de protection des données (DPN) du serveur Avamar.

   avmaint hfscreate

    La sortie affiche l’ID DPN (comme dans, XXXXXXXXXX). Enregistrez cette valeur pour les étapes ultérieures.
5. Assurez-vous que le /data La partition est montée sur Data Domain.

   df -h

    Si la demande /data n’est pas répertorié, montez-le :

   mount localhost:/data /data

    Réexécutez df -h pour confirmer le montage.
6. Localisez les métadonnées de restauration IA (create.xml).
   Remplacer XXXXXXXXXX avec l’ID DPN obtenu précédemment.

   cd /data/col1/avamar-XXXXXXXXXX/VMDS/
   ls -l Avamar-MOD-XXXXXXXXXXXXX.vmds.info
   cat Avamar-MOD-XXXXXXXXXXXXX.vmds.info/create.xml

    Si la demande create.xml existe, continuez. Si ce n’est pas le cas, il se peut que l’exportation IA soit déjà effacée.
7. Mappez l’hôte ESXi au chemin d’exportation IA obsolète.
   Utilisez le chemin d’exportation complet et l’adresse IP de l’hôte ESXi.

   nfs add /data/col1/avamar-XXXXXXXXXX/VMDS/Avamar-MOD-XXXXXXXXXXXXX

    Notez que la commande est obsolète. Le système suggère d’utiliser :

   nfs export

    Mais il crée toujours le mappage.

    

8. Vérifiez le nouveau mappage du client NFS.

   nfs show clients

    Vérifiez que l’adresse IP de l’hôte ESX s’affiche avec le chemin d’exportation et les options corrects.
9. Démontez le datastore NFS Data Domain à partir de l’interface utilisateur Avamar.
   Accédez à l’entrée du datastore et sélectionnez Unmount. Un démontage réussi affiche un écran de confirmation.
10. Confirmez la suppression du client NFS sur Data Domain.
11. Exécutez à nouveau la commande client-list :

nfs show clients

L’hôte ESXi ne doit plus être répertorié.

Vérification

• Tentez un autre démontage IA d’Avamar. L’opération doit se terminer sans "Invalid client‑list" d’erreur clavier.
• Vérifiez l’état propre de la tâche IA dans l’interface utilisateur d’Avamar.
• Vérifiez qu’il n’existe aucune entrée client NFS résiduelle sur Data Domain.