Replication Manager Software Application Agent CLI リファレンスガイド

[目次][索引][前へ][次へ]


1.3.1 EX_DRM_FS_BACKUP(ファイルシステムをバックアップする)

書式

オンラインバックアップする場合

EX_DRM_FS_BACKUP オペレーションID 
                 [ -mode online ] [ -comment バックアップコメント ] 
                 [ -rc [ 世代識別名 ]]
                 [ -pf コピーパラメーター定義ファイル ]
                 [ -script ユーザースクリプトファイル名 ]
                 [ -s バックアップサーバ名
                   [ -auto_import
                     [ -auto_mount [ マウントポイントディレクトリ名 ]]
                   ]
                   [ -svol_check ]
                 ]

コールドバックアップする場合

EX_DRM_FS_BACKUP オペレーションID 
                 -mode cold [ -comment バックアップコメント ] 
                 [ -rc [ 世代識別名 ]]
                 [ -pf コピーパラメーター定義ファイル ]
                 [ -script ユーザースクリプトファイル名 ]
                 [ -s バックアップサーバ名
                  [ -auto_import
                    [ -auto_mount [ マウントポイントディレクトリ名 ]]
                  ]
                  [ -svol_check ]
                 ]

VSSバックアップする場合

EX_DRM_FS_BACKUP オペレーションID 
                 -mode vss [ -comment バックアップコメント ] 
                 [ -rc [ 世代識別名 ]]
                 [ -pf コピーパラメーター定義ファイル ]
                 [ -vf VSS定義ファイル名 ]
                 [ -script ユーザースクリプトファイル名 ]
                 [ -s バックアップサーバ名
                  [ -auto_import
                    [ -auto_mount [ マウントポイントディレクトリ名 ]]
                  ]
                  [ -svol_check ]
                 ]

説明

drmfsbackupコマンドを実行し,オペレーションIDで指定されたファイルシステムを正ボリュームから副ボリュームにバックアップします。このとき,バックアップIDを生成します。

前提条件

次の前提条件があります。

引数

オペレーションID

処理の対象となるリソースを表す固有の文字列を指定します。指定したオペレーションIDに対応したオペレーション定義ファイルの情報が,拡張コマンドの実行に使用されます。

-mode online

オンラインバックアップをする場合に指定します。オンラインバックアップでは,ファイルシステムをアンマウントしないで,バックアップを実行します。

ファイルシステムでオンラインバックアップを指定した場合,オンラインバックアップの前にファイルシステムの同期処理だけを実行します。バックアップしたデータの整合性を保つには,バックアップ処理の前にデータの更新を抑止する必要があります。

このオプションを省略しても,オンラインバックアップを指定したことになります。

-mode cold

コールドバックアップする場合に指定します。

コールドバックアップは,マウント状態のファイルシステムに対して実行します。コマンドを実行すると,ファイルシステムをアンマウントして,オフラインの状態でボリュームをバックアップします。バックアップが終了すると,再びファイルシステムをマウントします。アンマウントに失敗した場合は,エラーメッセージが表示され,バックアップ処理が中止されます。バックアップ対象のボリュームがアンマウントされていた場合,バックアップ処理は中止されます。

また,クラスタ構成のサーバでコマンドを実行すると,ファイルシステムをアンマウントする代わりにバックアップ対象のディスクリソースをオフラインにして,ボリュームをバックアップします。バックアップが終了すると,再びバックアップ対象のディスクリソースをオンラインにします。

次の場合,コマンドを実行してもバックアップ処理は中止されます。

-mode vss

VSSを使用してファイルシステムをバックアップするときに指定します。

このオプションを指定する場合は,バックアップサーバでProtection Managerサービスが稼働している必要があります。

-comment バックアップコメント

バックアップカタログにバックアップコメントを登録する場合に指定します。

バックアップコメントには,64バイトまでの任意の文字列(英数字,記号,半角スペースおよびマルチバイト文字)が指定できます。バックアップコメントは大文字と小文字を区別します。記号,半角スペースを指定する場合は,バックアップコメントを引用符(")で囲みます。記号を引用符(")で囲まない場合は,特殊記号と認識しバックアップコメントの文字列として正しく解釈できません。

バックアップコメントに使用できない記号は次のとおりです。

「\」,「/」,「`」,「|」,「<」,「>」,「"」,「*」,「?」,「&」,「;」,「(」,「)」,「$」

先頭文字には「-」は指定できません。-commentオプションに「""」(引用符だけ)が指定された場合は,バックアップカタログにバックアップコメントは登録しません。

-rc 世代識別名

バックアップするコピーグループの世代識別名を指定します。drmfsdisplayコマンドに-cfオプションを付けて実行し,表示された「GEN-NAME」の値を指定してください。単体ボリュームの場合は,「-」が表示されます。この場合,-rcオプションは指定できません。

リモート側の副ボリュームへバックアップする場合,このオプションを必ず指定してください。このオプションを省略すると,ローカル側の副ボリュームにバックアップされます。

世代識別名を省略した場合は,リモート側の世代番号の中で,最小の値を持つ副ボリュームがバックアップ先となります。この場合,世代番号はremote_nnは最小の世代番号)となります。

-pf コピーパラメーター定義ファイル

コピーパラメーター定義ファイルに定義したリトライ回数とリトライ間隔を使用する場合に指定します。指定する場合は,パスではなくファイル名だけを指定してください。

このオプションを省略した場合は,RAID Manager用連携定義ファイル(DEFAULT.dat)の値が使用されます。コピーパラメーター定義ファイルに記述がされていないパラメーターについても,DEFAULT.datの値が使用されます。

コピーパラメーター定義ファイルは,次の場所に任意の名前で作成します。ファイル名は,64バイト以内の半角英数字で指定してください。

<Application Agentのインストール先>\DRM\conf\raid

-vf VSS定義ファイル名

VSSバックアップで使用する設定をバックアップごとに切り替える場合に指定します。このオプションは,VSSを使用してバックアップをするときにだけ使用できます。VSS定義ファイル名には,ファイル名だけを指定します。フォルダ名は指定しないでください。このオプションで指定するVSS定義ファイルは,下記のフォルダに格納しておく必要があります。

<Application Agentのインストール先>\DRM\conf\vss

このオプションを省略した場合,次のファイルがVSS定義ファイルとして使用されます。

<Application Agentのインストール先>\DRM\conf\vsscom.conf

VSS定義ファイルの詳細については,マニュアル「Hitachi Command Suite Replication Manager Software Application Agent CLI ユーザーズガイド」を参照してください。

-script ユーザースクリプトファイル名

ユーザースクリプトを実行する場合に指定します。ユーザースクリプトファイル名は絶対パスで指定します。ユーザースクリプトファイル名を指定するときの条件は次のとおりです。

ユーザースクリプトファイルの記述内容については,マニュアル「Hitachi Command Suite Replication Manager Software 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オプションと同時に指定する必要があります。

マウントポイントディレクトリ名は,64バイト以内の文字列で指定してください。

マウントポイントディレクトリ名を省略した場合は,副ボリュームのマウント先が自動的に設定されます。設定規則は,drmmountコマンドでマウントポイントを明示的に指定しなかった場合と同じです。

マウントした副ボリュームは,drmumountコマンドを使用してアンマウントしてください。

-svol_check

バックアップサーバでの副ボリュームの状態をチェックしたい場合に指定します。このオプションは,-sオプションと同時に指定する必要があります。副ボリュームの状態をチェックすることで,バックアップの失敗,またはリストアの失敗を防ぐことができます。チェック内容(項目,対象,条件)は次のとおりです。

表1-7 副ボリュームの状態チェック

チェック項目 チェック対象のボリューム チェックの条件
副ボリュームがバックアップサーバから隠ぺいされていること バックアップ対象の正ボリュームに対して定義されたすべての副ボリューム 正ボリュームが複数世代の副ボリュームとペア定義されている場合で,かつ,次のどれかに該当する場合にチェックされる。
  • 正ボリュームがクラスタリソースである。
  • 正ボリュームがダイナミックディスクである。
  • VSSでのバックアップが実行される。
副ボリュームがバックアップサーバにマウントされていないこと 今回,バックアップ先となる副ボリューム 常にチェックされる。

注意事項

バックアップカタログの個々のバックアップ情報は,コピーグループをキーに管理されています。バックアップの取り方によっては,副ボリュームにバックアップデータがあっても,リストアできなくなる場合があります。

Application Agentを実行するための注意事項については,マニュアル「Hitachi Command Suite Replication Manager Software Application Agent CLI ユーザーズガイド」を参照してください。

戻り値

0:正常終了した場合

0以外:エラーが発生した場合

エラーの発生条件

次の場合には,この拡張コマンドはエラーとなります。

使用例

[目次] [前へ] [次へ]


All Rights Reserved. Copyright© 2010, 2014, Hitachi, Ltd.