Replication Manager Application Agent CLI リファレンスガイド
EX_DRM_FS_RESTORE オペレーションID -resync [ -force ] [ -target ディレクトリ名 | -f 一括定義ファイル名 ] [ -pf コピーパラメーター定義ファイル]drmfsrestoreコマンドを実行し,指定したファイルシステムのバックアップデータを副ボリュームから正ボリュームにリストアします。
次の前提条件があります。
- 指定したオペレーションIDに対応するオペレーション定義ファイルが用意されていること
- この拡張コマンドの実行前に,EX_DRM_BACKUPID_SETまたはEX_DRM_DB_IMPORTが実行され,バックアップIDがバックアップID記録ファイルに格納されていること
オペレーションID
処理の対象となるリソースを表す固有の文字列を指定します。指定したオペレーションIDに対応したオペレーション定義ファイルの情報が,拡張コマンドの実行に使用されます。
-resync
正ボリュームと副ボリュームを再同期することで,リストアします。正ボリュームの内容は,副ボリュームのバックアップデータと同じになります。
-force
正ボリュームと副ボリュームを強制的に再同期することで,リストアする場合に指定します。このオプションを指定すると,ファイルサーバでバックアップを実行したときに取得した正ボリュームのコピーグループ名がファイルサーバの情報と一致していれば,LDEV番号またはSERIAL番号がバックアップ時の番号と一致していない場合にも強制的に再同期します。このオプションは,ボリュームを入れ替えてLDEV番号が変わった場合など,-resyncオプションを指定しても再同期でリストアできないときにだけ指定してください。通常のリストアでこのオプションを指定した場合,データが破壊されるおそれがあります。
-target ディレクトリ名
特定のディレクトリを含むファイルシステムをリストアする場合に指定します。ディレクトリ名は,マウントポイントディレクトリ名,ドライブ文字,またはボリュームマウントポイント名を表します。コンマで区切って複数指定できます。ディレクトリ名は,絶対パスで指定してください。
ディレクトリ名は,バックアップカタログに登録されている必要があります。ただし,バックアップ済みのディレクトリ名を指定した場合は,バックアップカタログに登録されていなくてもリストアできます。
このオプションおよび-fオプションの両方を省略した場合は,ファイルシステム全体がリストアされます。
-f 一括定義ファイル名
複数のファイルまたはディレクトリを含むファイルシステムをリストアする場合に,ファイルまたはディレクトリの絶対パスの一覧を記述したファイル名を指定します。一括定義ファイル名は絶対パスで指定します。
このオプションおよび-targetオプションの両方を省略した場合は,ファイルシステム全体がリストアされます。
-pf コピーパラメーター定義ファイル
コピーパラメーター定義ファイルに定義したリトライ回数とリトライ間隔を使用する場合に指定します。指定する場合は,パスではなくファイル名だけを指定してください。
このオプションを省略した場合は,RAID Manager用連携定義ファイル(DEFAULT.dat)の値が使用されます。コピーパラメーター定義ファイルに記述がされていないパラメーターについても,DEFAULT.datの値が使用されます。
コピーパラメーター定義ファイルは,次の場所に任意の名前で作成します。ファイル名は,64バイト以内の半角英数字で指定してください。
<Application Agentのインストール先>\DRM\conf\raid
- バックアップカタログの個々のバックアップ情報は,コピーグループをキーに管理されています。バックアップの取り方によっては,副ボリュームにバックアップデータがあっても,リストアできなくなる場合があります。詳細については,マニュアル「Hitachi Command Suite Replication Manager Application Agent CLI ユーザーズガイド」の,Application Agentを実行するための注意事項についての記述を参照してください。
- Application Agentの構成定義ファイル(init.conf)でCLU_MSCS_RESTOREにONLINEが設定されている場合,Windows Server Failover Clustering環境のクラスタグループ内のボリュームに対して,クラスタリソースがオンライン状態でリストアできます。
0:正常終了した場合
0以外:エラーが発生した場合
次の場合には,この拡張コマンドはエラーとなります。
- 不正なオプションが指定された場合
- オペレーションIDに対応する定義ファイルの情報取得に失敗した場合
- この拡張コマンドのオプションとして指定できないApplication Agentのコマンドオプションが指定された場合
- バックアップID記録ファイルからの情報取得に失敗した場合
- 内部で実行するコマンドにエラーが発生した場合
- 内部で実行するコマンドの実行結果の取得に失敗した場合
- ホスト環境設定ファイルからの情報取得に失敗した場合
- オペレーション定義ファイルで指定された拡張コマンド用一時ファイル格納ディレクトリが存在しない場合
- ディクショナリマップファイル格納ディレクトリ名の取得に失敗した場合
オペレーション定義ファイル「operation01」で特定されるファイルシステムを再同期することでリストアする。
EX_DRM_FS_RESTORE operation01 -resync
All Rights Reserved. Copyright© 2014, 2020, Hitachi, Ltd.