Avamar : L’ID client (CID) ne correspond pas à la mesure corrective Goav
Summary: Des incohérences d’ID client (CID) et de chemins se produisent sur les instances d’Avamar Server lorsque le réseau GSAN (Global Storage Area Network) et la base de données MCDB (Management Console Service Database) diffèrent lors du stockage des informations comptables des clients. ...
Symptoms
La navigation dans l’interface utilisateur Avamar (AUI) ou Avamar Administrator affiche le message d’erreur suivant : Internal Administrator Client Error.
Aucun client n’apparaît dans l’AUI.
La case à cocher browse subdomain dans l’AUI ne renvoie aucun résultat et peut éventuellement afficher une erreur.
L’erreur suivante est signalée : 0 ERROR! Exit code 74: Account not found in the Avamar database.
Cause
Aperçu
Des incohérences d’ID client (CID) et de chemins se produisent sur les instances d’Avamar Server lorsque le réseau GSAN (Global Storage Area Network) et la base de données MCDB (Management Console Service Database) diffèrent lors du stockage des informations comptables des clients.
Les informations comptables des clients sont stockées à deux endroits : GSAN et MCDB.
Il y a deux choses importantes à stocker pour un client.
- Chemin complet du client :
-
/clients/w11ofsd.lab.com
-
- ID client unique (CID) :
-
c7d083d712377955d84a52d2d618b47e33fa1ef
-
Une correspondance saine entre GSAN et MCDB serait que le chemin client et le CID correspondent.
Dans un environnement de réplication, le serveur Avamar de destination possède le domaine appelé « /REPLICATE ».
Il s’agit d’un domaine GSAN uniquement. MCDB ne stocke pas d’informations sur les clients répliqués dans ce domaine.
Il existe quelques scénarios dans lesquels GSAN et MCDB peuvent différer lors du stockage des informations comptables du client :
- Un chemin client existe dans un magasin, mais pas dans l’autre, et le CID ne correspond pas.
- Un chemin client existe dans un magasin, mais pas dans l’autre, et le CID associe un client avec un chemin différent dans l’autre magasin.
- Un chemin client existe dans les deux magasins, mais l’ID client ne correspond pas.
La vérification manuelle de l’information comptable du client peut être effectuée dans GSAN et MCDB.
Le GSAN (en anglais seulement)
avmgr getl --path=<domain_of_client_path> | grep -i <client_name>
Exemple :
admin@avamar:~/>: avmgr getl --path=/clients | grep -i w11ofsd.lab.com 1 w11ofsd.lab.com location: c7d083d712377955d84a52d2d618b47e33fa1ef1 pswd: 89e28a1932a8d1b4a4f9e2883e03a9f33f5082d1
À partir de l’exemple, c7d083d712377955d84a52d2d618b47e33fa1ef1 est le CID, et le chemin complet est /clients/w11ofsd.lab.com.
Dans GSAN, une recherche similaire peut être effectuée pour résoudre le chemin complet du client à partir d’un CID :
admin@avamar:~/>: avmgr resf --acnt=ref{c7d083d712377955d84a52d2d618b47e33fa1ef1}
1 Request succeeded
/clients/w11ofsd.lab.com c7d083d712377955d84a52d2d618b47e33fa1ef1
La base de données MCDB
psql -p 5555 mcdb -U admin -c "select cid,descr from clients where cid='<CID>'"
Exemple :
admin@avamar:~/>: psql -p 5555 mcdb -U admin -c "select cid,descr from clients where cid='c7d083d712377955d84a52d2d618b47e33fa1ef1'" cid | descr ------------------------------------------+--------------------------------------- c7d083d712377955d84a52d2d618b47e33fa1ef1 | /clients/w11ofsd.lab.com (1 row)
À partir de l’exemple, c7d083d712377955d84a52d2d618b47e33fa1ef1 est le CID, et le chemin complet est /clients/w11ofsd.lab.com.
S’il n’y a pas de correspondance saine entre le GSAN et MCDB, il s’agit d’une non-correspondance CID.
Resolution
L’outil GoAV est utilisé pour corriger automatiquement les incompatibilités CID.
Téléchargez et installez l’outil Goav.
000192151 | Avamar : Outil
GoavExécutez la commande suivante pour vérifier les incompatibilités CID et générer deux fichiers de rapport :
./goav client cid-mismatch check
Il existe un fichier de rapport sécurisé et dangereux. Examinez-les tous les deux pour obtenir une explication.
Exemple:
admin@avamar:~/>: ./goav client cid-mismatch check =========================================================== GoAv : 1.80 Avamar : 19.10 Date : 19 Aug 2024 16:20 -03 =========================================================== COMMAND : ./goav client cid-mismatch check NOTE: This is not an official tool =========================================================== Client CID & Path Mismatch Script --------------------------------- Load GSAN clients from avmgr cpdb Load MCS clients from mcdb Analyze GSAN mismatches GSAN path /MC_DELETED/DPADatastoreServer_bgVYLK0WONuiFagzVngqBQ2021.09.01.13.38.57 does not exist in MCDB, but the GSAN cid b8429c8a089567b7a1aa8cfa7608b735413630ab exists in MCDB at path /avamarVC/VirtualMachines/DPADatastoreServer_bgVYLK0WONuiFagzVngqBQ, and has 0 backups GSAN Mismatch Count: 1 Analyze MCDB mismatches MCDB path /avamarVC/VirtualMachines/DPADatastoreServer_bgVYLK0WONuiFagzVngqBQ does not exist in GSAN, but the MCDB cid b8429c8a089567b7a1aa8cfa7608b735413630ab exists in GSAN at path MCDB Mismatch Count: 1 Report Files Generated ---------------------- Safe Report: /home/admin/goav_clients/client_cid_mismatch_report_SAFE_delete_2024-08-19-1724095237 Unsafe Report: /home/admin/goav_clients/client_cid_mismatch_report_UNSAFE_delete_2024-08-19-1724095237
Au bas de la sortie de l’exemple, il y a des informations sur l’emplacement des fichiers de rapport.
Les incompatibilités CID qui ont été désignées comme pouvant être supprimées en toute sécurité ne nécessitent pas d’examen ni d’approbation du SME et peuvent être résolues sans l’intervention du support Dell.
Les incompatibilités CID qui ont été désignées comme dangereuses nécessitent un examen et une approbation de la part du SME.
Le client ou l’ingénieur du support fournit les fichiers de rapport et la demande de clé d’accès sécurisée Goav à un SME pour corriger les incompatibilités dangereuses.
Exemple dangereux :
./goav client cid-mismatch fix
Process CID Mismatch Reports ---------------------------- Parsing reports for mismatches to fix No safe mismatches found to fix Provide the following CID mismatch unsafe auto-fix key request to an SME --> 1709325232,1724098448 <--- >
Dans l’exemple de non-concordance non sécurisée ci-dessus, le SME accorde une clé d’accès sécurisée en fonction de la demande 1709325232,1724098448.
Qu’est-ce qui rend une non-correspondance de CID sûre ou dangereuse à supprimer ?
Les incompatibilités CID sécurisées se produisent lorsque le chemin client existe dans un magasin, mais pas dans l’autre. Le CID ne correspond pas au CID d’un client ayant un chemin différent dans l’autre magasin et n’a pas de sauvegardes dans GSAN.
Les incompatibilités CID dangereuses sont prises en compte dans les scénarios suivants :
- Le client a encore des sauvegardes à supprimer dans GSAN.
- Le chemin client n’existe pas dans l’autre magasin, mais il a un CID correspondant à un autre chemin.
- Les chemins client correspondent dans les deux magasins et ont un CID différent.