Replication Manager Application Agent CLI リファレンスガイド
VSSバックアップする場合(Exchange Server 2007)
drmexgbackup -mode vss [ -target ストレージグループ名 | -f 一括定義ファイル名 ] [ -rc [ 世代識別名 ]] [ -pf コピーパラメーター定義ファイル ] [ -transact_log_del | -noverify | -noverify_log_del ] [ -event_check ] [ -comment バックアップコメント] [ -vf VSS定義ファイル名 ] [ -script ユーザースクリプトファイル名 ] [ -s バックアップサーバ名 [ -auto_import [ -auto_mount [ マウントポイントディレクトリ名 ]] ] [ -svol_check ] ]VSSバックアップする場合(Exchange Server 2010,Exchange Server 2013,またはExchange Server 2016)
drmexgbackup -mode vss [ -target インフォメーションストア名 | -f 一括定義ファイル名 ] [ -rc [ 世代識別名 ]] [ -pf コピーパラメーター定義ファイル ] [ -transact_log_del | -noverify | -noverify_log_del ] [ -event_check ] [ -comment バックアップコメント] [ -vf VSS定義ファイル名 ] [ -script ユーザースクリプトファイル名 ] [ -s バックアップサーバ名 [ -auto_import [ -auto_mount [ マウントポイントディレクトリ名 ]] ] [ -svol_check ] ]正ボリュームのExchangeデータベースを副ボリュームにバックアップします。
Exchange Serverでバックアップする単位を,次に示します。
- Exchange Server 2007の場合
- データベース全体またはストレージグループ単位
- Exchange Server 2010,Exchange Server 2013,またはExchange Server 2016の場合
- データベース全体またはインフォメーションストア単位
drmexgbackupコマンドを実行するには,データベースファイルとログファイルは別のコピーグループに格納する必要があります。
コマンドを実行する直前には,副ボリュームのシステムキャッシュをクリアしておく必要があります。システムキャッシュをクリアするには,バックアップサーバで副ボリュームをマウントしてから,アンマウントしてください。
ローカルサイトでdrmexgbackupコマンドを実行する場合,ペア状態が「SMPL」のときは自動ペア生成を実行しません。この場合,RAID Manager用連携定義ファイル(DEFAULT.dat)のPAIR_CREATEパラメーターにENABLEを設定したときには自動ペア生成を実行します。
インストール後,drmexgdisplayに-refreshオプションを指定して実行しないで,ディクショナリマップファイルが作成していない状態でdrmexgbackupコマンドを実行した場合,drmexgbackupコマンドでディクショナリマップファイルが作成されます。この場合,ディクショナリマップファイルの作成する処理時間の分,バックアップコマンド実行時間が長くなります。
バックアップの対象となるのは,次の表に示すファイルです。
表2-26 Exchange Serverのバックアップの対象となるファイル
オプション 対象データベース 対象ファイル 対象ファイル種別は固定 Exchange Serverストレージグループ データファイル *.edb トランザクションログファイル *.log チェックポイントファイル *.chk 対象ファイル種別は固定 Exchange Serverインフォメーションストア データファイル *.edb トランザクションログファイル *.log チェックポイントファイル *.chk -mode vss
VSSを使用してバックアップするときに指定します。
このオプションを指定する場合は,バックアップサーバでProtection Managerサービスが稼働している必要があります。
-target ストレージグループ名
このオプションは,特定のストレージグループを含むデータベースリソース単位でバックアップする場合に指定します。ただし,バックアップは物理ボリューム単位で実行します。1つの物理ボリュームに複数のストレージグループがある場合,すべてのストレージグループを指定してください。一部のストレージグループだけ指定した場合は,コマンドの実行時にエラーになります。
複数のストレージグループをバックアップする場合は,ストレージグループ名をコンマで区切って指定します。ストレージグループ名に空白を含む場合は,引用符で囲んで指定します。
このオプションを省略した場合,コマンドを実行したサーバにあるすべてのストレージグループがバックアップ対象になります。
-target インフォメーションストア名
このオプションは,特定のインフォメーションストアを含むデータベースリソース単位でバックアップする場合に指定します。ただし,バックアップは物理ボリューム単位で実行します。1つの物理ボリュームに複数のインフォメーションストアがある場合,すべてのインフォメーションストアを指定してください。一部のインフォメーションストアだけ指定した場合は,コマンドの実行時にエラーになります。
複数のインフォメーションストアをバックアップする場合は,インフォメーションストア名をコンマで区切って指定します。インフォメーションストア名に空白を含む場合は,引用符で囲んで指定します。
このオプションを省略した場合,コマンドを実行したサーバにあるすべてのインフォメーションストアがバックアップ対象になります。
-f 一括定義ファイル名
このオプションは,-targetオプションと同様に,特定のストレージグループまたはインフォメーションストアだけに関してバックアップする場合に指定します。このオプションは,1つの物理ボリュームに複数のストレージグループまたはインフォメーションストアのデータファイルがある場合は必ず指定してください。
-targetオプションと異なり,-fオプションではストレージグループ名またはインフォメーションストア名の一覧を記述した定義ファイルをあらかじめ作成しておき,そのファイルの名称を指定することで,ストレージグループ名またはインフォメーションストア名を一度に指定できます。一括定義ファイル名は,絶対パスで指定します。
-rc 世代識別名
バックアップするコピーグループの世代識別名を指定します。drmexgdisplayコマンドに-cfオプションを付けて実行し,表示された「GEN-NAME」の値を指定してください。単体ボリュームの場合は,「-」が表示されます。この場合,-rcオプションは指定できません。
リモート側の副ボリュームへバックアップする場合,このオプションを必ず指定してください。このオプションを省略すると,ローカル側の副ボリュームにバックアップされます。
世代識別名を省略した場合は,リモート側の世代番号の中で,最小の値を持つ副ボリュームがバックアップ先となります。この場合,世代番号はremote_n(nは最小の世代番号)となります。
-pf コピーパラメーター定義ファイル
コピーパラメーター定義ファイルに定義したリトライ回数とリトライ間隔を使用する場合に指定します。指定する場合は,パスではなくファイル名だけを指定してください。
このオプションを省略した場合は,RAID Manager用連携定義ファイル(DEFAULT.dat)の値が使用されます。コピーパラメーター定義ファイルに記述がされていないパラメーターについても,DEFAULT.datの値が使用されます。
コピーパラメーター定義ファイルは,次の場所に作成します。ファイル名は,64バイト以内の半角英数字で指定してください。
<Application Agentのインストール先>\DRM\conf\raid-transact_log_del
コミット済みのトランザクションログファイルを削除する場合に指定します。
このオプションを指定してコマンドを実行すると,トランザクションログファイルが削除されるので,以前に取得したバックアップを基に,-recoveryオプションを指定してリストアできなくなります。
-noverify
VSSを使用したバックアップで,データベースの整合性を検証しない場合に指定します。
-noverify_log_del
VSSを使用したバックアップで,データベースの整合性を検証しないでバックアップしたあと,トランザクションログファイルを削除する場合に指定します。
-event_check
データベースの破損を示すイベントが記録されていないかをチェックしたい場合に指定します。検索の対象となるのは,Exchangeデータベースの直前のバックアップの時間以後に記録されたWindowsイベントログです。ただし,前回のバックアップの結果がなければ,記録されているすべてのWindowsイベントログが検索の対象となります。
Windowsイベントログの検索は,ペアの再同期をする前に実行されます。データベースの破損を示すイベントが検出されたときは,コマンドがエラーメッセージを出力し,エラー終了します。
データベースが破損しているとApplication Agentが判断するのは,次のイベントです。
- イベントカテゴリー: アプリケーション
- 種類: エラー
- ソース: ESE
- イベントID: 限定なし
- 含まれる文字列: "-1018","-1019",または"-1022"
-comment バックアップコメント
バックアップカタログにバックアップコメントを登録する場合に指定します。
バックアップコメントには,64バイトまでの任意の文字列(英数字,記号,半角スペースおよびマルチバイト文字)が指定できます。バックアップコメントは大文字と小文字を区別します。記号,半角スペースを指定する場合は,バックアップコメントを引用符(")で囲みます。記号を引用符(")で囲まない場合は,特殊記号と認識しバックアップコメントの文字列として正しく解釈できません。
バックアップコメントに使用できない記号は次のとおりです。
「\」,「/」,「`」,「|」,「<」,「>」,「"」,「*」,「?」,「&」,「;」,「(」,「)」,「$」
先頭文字には「-」は指定できません。-commentオプションに「""」(引用符だけ)が指定された場合は,バックアップカタログにバックアップコメントは登録しません。
-vf VSS定義ファイル名
VSSバックアップで使用する設定をバックアップごとに切り替える場合に指定します。このオプションは,VSSを使用してバックアップをするときにだけ使用できます。
VSS定義ファイル名には,ファイル名だけを指定します。フォルダ名は指定しないでください。このオプションで指定するVSS定義ファイルは,下記のフォルダに格納しておく必要があります。
<Application Agentのインストール先>\DRM\conf\vssこのオプションを省略する場合,下記のファイルがVSS定義ファイルとして使用されます。
<Application Agentのインストール先>\DRM\conf\vsscom.confVSS定義ファイルの詳細については,マニュアル「Hitachi Command Suite Replication Manager Application Agent CLI ユーザーズガイド」を参照してください。
-script ユーザースクリプトファイル名
ユーザースクリプトを実行する場合に指定します。ユーザースクリプトファイル名は絶対パスで指定します。ユーザースクリプトファイル名を指定するときの条件は次のとおりです。
- 最大バイト数:255
- 使用できる文字:Windowsでファイル名として使用できる文字。空白を含む場合は「""」で囲んで指定します。
ユーザースクリプトファイルの記述内容については,マニュアル「Hitachi Command Suite Replication Manager Application Agent CLI ユーザーズガイド」の,ユーザースクリプトを作成する方法についての記述を参照してください。
ユーザースクリプトファイルに「LOCATION=REMOTE」を指定した場合は,-sオプションをあわせて指定する必要があります。
-s バックアップサーバ名
リモートのバックアップサーバに接続してバックアップを実行する場合に指定します。バックアップサーバのホスト名またはIPアドレスを,255バイト以内の文字列で指定してください。IPアドレスはIPv4またはIPv6形式で指定できます。
-sオプションでバックアップサーバを指定した場合,VSS定義ファイル(vsscom.conf),および-vfオプションで指定したVSS定義ファイルのバックアップサーバ名は無効となり,-sオプションで指定したバックアップサーバ名が使用されます。
-auto_import
ボリュームのバックアップが完了したあと,バックアップカタログをバックアップサーバに自動転送する場合に指定します。このオプションは,-sオプションと同時に指定する必要があります。
-auto_mount マウントポイントディレクトリ名
ボリュームのバックアップが完了したあと,バックアップサーバで副ボリュームを自動マウントする場合に指定します。このオプションは,-sオプションおよび-auto_importオプションと同時に指定する必要があります。このオプションを指定すると,バックアップ対象となる副ボリュームをすべてマウントします。
マウントポイントディレクトリ名は,ドライブ文字またはドライブ文字から始まる絶対パスで指定します。ディレクトリ名は,Windowsのディレクトリ名に指定できる文字で,パスの末尾の「\」を含めて64バイト以内で指定してください。ただし,半角スペース,マルチバイト文字,および半角カタカナは使用できません。
ドライブ文字から始まる絶対パスを指定する場合,空のディレクトリを指定してください。
パスの末尾に「\」がない場合でも,「\」が指定されているものと見なされます。例えば,「D:」と「D:\」は同じドライブと見なされます。また,「D:\MOUNTDIR」と「D:\MOUNTDIR\」は同じディレクトリと見なされます。
マウント先は次のようになります。
- マウントポイントディレクトリ名としてドライブ文字だけを指定した場合
- マウントポイントディレクトリ名に指定したドライブ,および指定したドライブからアルファベット順に検索した未使用のドライブ
- マウントポイントディレクトリ名として絶対パスを指定した場合
- <マウントポイントディレクトリ名に指定した絶対パス>\<正ボリュームのドライブ文字>\<正ボリュームでのマウントポイント>
- 例えば,正ボリュームが「C:\p_mnt\」にマウントされていて,-auto_mountオプションに指定したマウントポイントディレクトリ名が「D:\s_mnt\」の場合,副ボリュームでのマウント先は「D:\s_mnt\C\p_mnt\」となります。
マウントポイントディレクトリ名を省略した場合は,使用されていないドライブにマウントします。
マウントした副ボリュームは,drmumountコマンドを使用してアンマウントしてください。drmumountコマンドの引数には,バックアップIDを指定してください。
-svol_check
バックアップサーバでの副ボリュームの状態をチェックしたい場合に指定します。このオプションは,-sオプションと同時に指定する必要があります。副ボリュームの状態をチェックすることで,バックアップの失敗,またはリストアの失敗を防ぐことができます。チェック内容(項目,対象,条件)は次のとおりです。
チェック項目 チェック対象のボリューム チェックの条件 副ボリュームがバックアップサーバから隠ぺいされていること バックアップ対象の正ボリュームに対して定義されたすべての副ボリューム 正ボリュームが複数世代の副ボリュームとペア定義されている場合で,かつ,次のどちらかに該当する場合にチェックされる。
- 正ボリュームがクラスタリソースである。
- VSSでのバックアップが実行される。
副ボリュームがバックアップサーバにマウントされていないこと 今回,バックアップ先となる副ボリューム 常にチェックされる。
- バックアップカタログの個々のバックアップ情報は,コピーグループをキーに管理されています。バックアップの取り方によっては,副ボリュームにバックアップデータがあっても,リストアできなくなる場合があります。詳細については,マニュアル「Hitachi Command Suite Replication Manager Application Agent CLI ユーザーズガイド」の,Application Agentを実行するための注意事項についての記述を参照してください。
- -targetオプション,または-fオプションによって空白を含んだファイル名またはディレクトリ名をコマンドラインのオプションとして指定する場合,指定されるパス名は,引用符(")で囲む必要があります。
ただし,一括定義ファイル内で対象のファイル名またはディレクトリ名を記述する場合は,指定するパス名を引用符(")で囲む必要はありません。0:正常終了した場合
0以外:エラーが発生した場合
- 一括定義ファイル「C:\temp\BACKUP_DB.txt」で指定したストレージグループをバックアップする。
PROMPT> drmexgbackup -mode vss -f C:\temp\BACKUP_DB.txt KAVX0001-I drmexgbackupコマンドを開始します。 KAVX1805-I インフォメーションストアをディスマウントしています。 ストレージグループ名 = STR1 KAVX1805-I インフォメーションストアをディスマウントしています。 ストレージグループ名 = STR2 KAVX1805-I インフォメーションストアをディスマウントしています。 ストレージグループ名 = STR3 KAVX1600-I バックアップを開始します。 KAVX0040-I バックアップは以下の内容で取得されています。 バックアップID = 0000000001 KAVX1601-I バックアップを完了しました。 KAVX1806-I インフォメーションストアをマウントしています。 ストレージグループ名 = STR1 KAVX1806-I インフォメーションストアをマウントしています。 ストレージグループ名 = STR2 KAVX1806-I インフォメーションストアをマウントしています。 ストレージグループ名 = STR3 KAVX0002-I drmexgbackupコマンドを終了します。- VSSを使用してバックアップする。
PROMPT> drmexgbackup -mode vss KAVX0001-I drmexgbackupコマンドを開始します。 KAVX0256-I Protection Managerサービスに接続します。 ホスト名 = BackupServer KAVX1600-I バックアップを開始します。 KAVX1610-I バックアップサーバでデータベースの検証を行います。 ストレージグループ名 = STR1 ファイル容量 = 6532[MB] KAVX1611-I ベリファイ処理が成功しました。 KAVX0040-I バックアップは以下の内容で取得されています。 バックアップID = 0000000001 KAVX1601-I バックアップを完了しました。 KAVX0002-I drmexgbackupコマンドを終了します。- Exchange Server 2010の構成でVSSを使用してオンラインバックアップする。
PROMPT> drmexgbackup -mode vss KAVX0001-I drmexgbackupコマンドを開始します。 KAVX0256-I Protection Managerサービスに接続します。 ホスト名 =バックアップサーバ1 KAVX1600-I バックアップを開始します。 KAVX5108-I コピーグループの再同期を実行します。 コピーグループ名 = EXG001,B001 KAVX5108-I コピーグループの再同期を実行します。 コピーグループ名 = EXG001,B002 KAVX5108-I コピーグループの再同期を実行します。 コピーグループ名 = EXG001,B003 KAVX5108-I コピーグループの再同期を実行します。 コピーグループ名 = EXG001,B004 KAVX1625-I バックアップサーバでデータベースを検証します。 インフォメーションストア名 = Mail01 ファイル容量 = 1000[MB] KAVX1625-I バックアップサーバでデータベースを検証します。 インフォメーションストア名 = Mail02 ファイル容量 = 1000[MB] KAVX1611-I ベリファイ処理が成功しました。 KAVX0040-I バックアップは以下の内容で取得されています。 バックアップID = 0000000001 KAVX1601-I バックアップを完了しました。 KAVX0002-I drmexgbackupコマンドを終了します。
All Rights Reserved. Copyright© 2014, 2020, Hitachi, Ltd.