Avamar：クライアントID (CID)とGoav修復の不整合
Summary: クライアント アカウンティング情報を保存するときにグローバル ストレージ エリア ネットワーク(GSAN)と管理コンソール サービス データベース(MCDB)が異なる場合、AvamarサーバーでクライアントID (CID)とパスの不一致が発生します。
Symptoms
Avamar User Interface (AUI)またはAvamar Administratorでクライアントを参照すると、次のエラー メッセージが表示されます。 Internal Administrator Client Error.
クライアントがAUIに表示されない。
AUIの[browse subdomain]チェック ボックスは結果を返さず、エラーを表示する可能性があります。
次のエラーが報告されます。 0 ERROR! Exit code 74: Account not found in the Avamar database.
Cause
概要
クライアント アカウンティング情報の格納時にグローバル ストレージ エリア ネットワーク(GSAN)と管理コンソール サービス データベース(MCDB)が異なる場合、Avamar ServerでクライアントID (CID)とパスの不一致が発生します
クライアント アカウンティング情報は、次の 2 か所に格納されます。GSANおよびMCDB.
クライアントのために保存しておくべき重要なものが 2 つあります。
- クライアントのフル パス:
-
/clients/w11ofsd.lab.com
-
- ユニーク クライアントID(CID):
-
c7d083d712377955d84a52d2d618b47e33fa1ef
-
GSANとMCDBの間で正常と一致しているとは、クライアント パスとCIDが一致することです
レプリケーション環境では、ターゲットAvamar Serverに「/REPLICATE」というドメインがあります
これはGSANのみのドメインです。MCDBは、そのドメイン内のレプリケートされたクライアントに関する情報を格納しません。
クライアント アカウンティング情報の格納時にGSANとMCDBが異なるシナリオがいくつかあります。
- 一方のストアにクライアント パスが存在し、もう一方のストアには存在せず、CIDが一致しません。
- クライアント パスは一方のストアには存在するが他方のストアには存在せず、CIDはもう一方のストア内のパスが異なるクライアントと一致します。
- クライアント パスは両方のストアに存在しますが、クライアントIDが一致しません。
クライアント アカウンティング情報の手動検証は、GSANとMCDBで実行できます
GSANの
avmgr getl --path=<domain_of_client_path> | grep -i <client_name>
Example:
admin@avamar:~/>: avmgr getl --path=/clients | grep -i w11ofsd.lab.com 1 w11ofsd.lab.com location: c7d083d712377955d84a52d2d618b47e33fa1ef1 pswd: 89e28a1932a8d1b4a4f9e2883e03a9f33f5082d1
例から、 c7d083d712377955d84a52d2d618b47e33fa1ef1 は CID で、フルパスは /clients/w11ofsd.lab.com.
GSANでは、同様のルックアップを実行して、CIDからクライアントのフル パスを解決できます。
admin@avamar:~/>: avmgr resf --acnt=ref{c7d083d712377955d84a52d2d618b47e33fa1ef1}
1 Request succeeded
/clients/w11ofsd.lab.com c7d083d712377955d84a52d2d618b47e33fa1ef1
MCDBの
psql -p 5555 mcdb -U admin -c "select cid,descr from clients where cid='<CID>'"
Example:
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)
例から、 c7d083d712377955d84a52d2d618b47e33fa1ef1 は CID で、フルパスは /clients/w11ofsd.lab.com.
GSANとMCDBの間に正常な一致がない場合、これはCIDの不一致です。
Resolution
GoAVツールは、CIDの不一致を自動的に修正するために使用されます。
Goavツールをダウンロードしてインストールします
000192151 |Avamar: Goavツール
次のコマンドを実行して、CIDの不整合をチェックし、2つのレポート ファイルを生成します。
./goav client cid-mismatch check
安全なレポート ファイルと安全でないレポート ファイルがあります。説明については、両方を確認してください
例：
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
この例の出力の下部には、レポート ファイルの場所に関する情報があります
安全に削除できると指定されたCIDの不一致は、SMEによるレビューと承認を必要とせず、Dellサポートの介入なしで解決できます。
安全でないと指定されたCIDの不整合には、SMEのレビューと承認が必要です。
お客様またはサポート エンジニアは、レポート ファイルとGoavセキュア アクセス キー リクエストをSMEに提供し、安全でない不一致を修正します
安全でない例:
./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 <--- >
上記の安全でない不一致の例では、SME は要求に基づいて安全なアクセス キーを付与します 1709325232,1724098448.
CIDの不整合を安全に、または安全に取り外せない理由は何ですか
安全なCIDの不一致は、クライアント パスが一方のストアに存在し、他方のストアには存在しない場合です。CIDが、他のストア内のパスが異なるクライアントのCIDと一致しておらず、GSANにバックアップがありません。
安全でないCIDの不整合は、次のシナリオで考慮されます。
- 削除するGSANのバックアップがまだクライアントにあります。
- クライアント パスは他のストアには存在しませんが、別のパスと一致するCIDがあります。
- クライアント パスは両方のストアで一致しており、CIDは異なっています。