Avamar：データベース パスの大文字と小文字の不一致の問題の影響を受けるバックアップからExchangeデータベースをリストアする方法

目的：

• データベースのパスの大文字と小文字の不一致の問題の影響を受けるAvamarバックアップからExchangeデータベースをリストアする方法については、次の記事で説明されています。「Avamar：Exchangeデータベースのリストアが、バックアップでデータベースが見つからないことを示すavtarエラーで失敗する」
• この回避策は、フラグ「--use-case-sensitive-paths」が適用される前に作成されたバックアップからExchangeデータベースをリストアするために使用されます
• 管理者特権のコマンド プロンプトで、avtar.exeバイナリーが使用されます

• リストアするバックアップが7日以内に作成されたものである場合（まれなケース）、「追加情報」セクションに移動し、指示に従います。

回避策の前提条件：

1. avtar.exeが起動されるシステムでは、バックアップが配置されているのと同じAvamar Serverに対してAvamar Windowsクライアントが登録されている必要があります。この回避策では、Exchangeプラグインは必要ありません。
2. Windowsコマンド プロンプトを管理者（管理者特権でのコマンド プロンプト）として開く必要があり、ユーザー アカウントにはシステムのローカル管理者権限が必要です。
3. Avamar MCUser（またはリストア権限を持つその他のAvamarユーザー）の認証情報が必要です。
4. Avamarバックアップ クライアントのフル パス、バックアップ ラベル番号、データベースのフル パスが必要です。
5. 宛先ドライブには、リストアに関連するデータベースとログ ファイルを保持するための十分な空きディスク領域が必要です（容量計算の例を以下に示します）。

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> 

• オプション「---acnt」のクライアントのフル パスは大文字と小文字を区別し、バックアップ ログ（avtarまたは.algログ ファイル）で見つけることができます。次の例を参照してください。

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

• バックアップ ラベル番号は、Avamarユーザー インターフェイス（GUIまたはAUI）のリストア セクションから直接確認できます。
• コマンドの最後のアイテム<item path to restore>で、バックアップ ログを開き（/varフォルダーにまだ存在する場合）、「targetlist」セクションを検索します。そこで、リストアに必要なデータベースのフル パスを特定します。「database4」の例を参照してください。

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

• バックアップ ログが/varディレクトリーで使用できなくなった場合は、次の記事の「追加情報」の「サーバーからAvamarバックアップを取得する」の手順を参照してください。「Avamar：Avamar クライアントのバックアップおよびリストアの問題のトラブルシューティングのためにログファイルを収集する方法」
• この例では、パスは次のようになります。

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

• しかし、「大文字と小文字の不一致」の問題が「mountpoints」レベルにあるため、このフル パスを使用すると、「バックアップにデータベースが見つかりません」という既知のリストア失敗が発生します。
• このリストアの問題を回避するため、不一致の「mountpoints」領域のすぐ左のレベルからパスを切り取ります。この例では、コマンドで使用したパスは次のとおりです。

  • EX-Node3_00000000\H:\

• この回避策の結果、トランザクション ログを含むすべてのExchangeデータベースがリストアされます（H:ドライブ下の同じパスにある場合）。このトランザクション ログは、バックアップ時にExchangeノード「EX-Node3」でホストされていたものです。
  • この回避策を実行するには、バックアップ時に「EX-Node3」に存在するすべてのデータベース/トランザクション ログを格納するために、コマンドが実行されるシステムに十分な空きディスク領域が必要になります。
  • 例：全体のバックアップ サイズが3 TBの場合、リストアに3 TBの空き領域が必要になるとは限りません。 
    • ノード「EX-Node3」からリストアされるすべてのDBとログを合計したサイズのみが必要です。
    • たとえば、3TBではなく、データベース4と5のサイズとそれに対応するログを合わせた400 GBが必要になります。
    • ディスク領域は、ケース バイ ケースで計算する必要があります。

回避手順：

1. 正しい情報を使用して、メモ帳にコマンドを準備します（ログファイルまたはターゲット値にスペースが含まれている場合は、二重引用符で囲む必要があります）。
2. 管理者特権モードでWindowsコマンド プロンプトを開きます。
3. バイナリー「avtar.exe」が配置されているフォルダーに移動します。デフォルトの場所は「C:\Program Files\avs\bin\」です。
4. 事前入力されたコマンドを実行します。次の例を参照してください。

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. コマンドが完了するまで待ちます（プロンプトが返されます）。リストアするデータ サイズによっては、数分または数時間かかる場合があります。
6. コマンドが完了したら、Exchange DBがそれぞれのトランザクション ログとともに正しくリストアされていることを確認します。
7. プロセス中に問題が見つかった場合は、「D:/Restore_logs/Restore_163_Database4_30-08-2024.log」のようにリストア ログ ファイルを確認します。
   • さらにサポートが必要な場合は、サービス リクエスト プロセスを使用してAvamarサポート チームに連絡してください。

リストア後のタスク：

• リストアが成功した場合は、リストアされたデータベースが「ダーティー シャットダウン」状態になることが予想されます。
• これは、トランザクション ログ ファイルがまだデータベースに再生されていないためです。
• ログを再生するには、次の記事に従ってください。「Avamar：Exchangeデータベースを「ダーティー シャットダウン」状態から回復する方法」

• リストアするバックアップが7日以内に作成されたものである場合は、サービス リクエスト プロセスを使用して直ちにAvamarサポート チームに連絡してください（まれなケース）。
• この記事を確認したことと、その参照先をサポート チームに伝えます。
• Avamarサポート チームは、少し異なるリストア手順を使用してリカバリーを支援しますが、より効率的な手順を使用します。