A.2.3 バックアップ用業務ボリュームロック動作指定ファイル

業務ボリュームのバックアップ前処理では、他アプリケーションとの一時的なアクセス競合を回避するため、ロックに失敗した場合にロック処理をリトライします。標準のリトライ動作は以下のとおりです。

ロックに失敗した場合、1秒間待ったあと、ロック処理をリトライします。
20回(初回と合わせて計21回)リトライしてもロックできない場合、処理を中断してコマンドを異常終了させます。

リトライの回数と間隔は、「バックアップ用業務ボリュームロック動作指定ファイル」で変更できます。
このファイルでは、業務ボリュームのバックアップ前処理に対して、以下の動作も指示できます。

ロック処理をリトライする前に、そのボリューム内のすべてのファイルハンドルを無効にする(強制ロック機能)。
ロック／ロック解除の代わりに、ファイルシステムバッファーをフラッシュする(-Xflushオプションと同等の機能)。

注意

バックアップ用業務ボリュームロック動作指定ファイルは、「12.2.3.2 swstresback(資源バックアップコマンド)」でバックアップされません。このファイルを使用して運用する場合は、copyコマンドなどでバックアップする必要があります。

ファイル名と格納場所

バックアップ用業務ボリュームロック動作指定ファイルは、以下の名前で作成してください。

クラスタ運用でない場合

<環境設定ディレクトリ>\etc\backup\data\BTRANLOCK.INI

クラスタ運用の場合

<共用ディスク>:\etc\opt\swstorage\etc\backup\data\BTRANLOCK.INI

ファイルの記述例と記述規約

ファイルの記述例は、以下のとおりです。

[g1d1p1]
BufferFlushOnly=off
LockForceMode=on
LockRetryNumber=10
LockRetryInterval=5000
[g1d1p2]
BufferFlushOnly=on
[ANY]
BufferFlushOnly=off
LockForceMode=off
LockRetryNumber=20
LockRetryInterval=2000

ファイルの記述規約は、以下のとおりです。

ロック動作を変更するボリュームのセクションを作成し、パラメーターを記述します。上記の例では、g1d1p1およびg1d1p2のセクションが作成されています。変更できるパラメーターは、「表A.4 BTRANLOCK.INIファイルに指定できるパラメーター」の4つです。変更したいパラメーターだけを記述してください。記述のないパラメーターは、デフォルト値が使用されます。
デフォルトのロック動作は、「ANY」セクションを作成して、そのセクション内にパラメーターを記述することで変更できます。このファイルに記述されているボリューム以外のすべてのボリュームのロック動作を変更できます。上記の例では、g1d1p1およびg1d1p2以外のすべてのボリュームのロック動作が「ANY」セクションの値に従います。

表A.4 BTRANLOCK.INIファイルに指定できるパラメーター
パラメーター	説明
BufferFlushOnly	業務ボリュームをロックする代わりに、業務ボリュームのファイルシステムバッファーをフラッシュすることを指定します。 on(デフォルト値): バッファーをフラッシュする(ロックしない) off: バッファーをフラッシュしない(ロックする) swstbackupコマンドに-Xflushオプションが指定され、かつ、BufferFlushOnly=offの場合は、-Xflushオプションが優先されます。 BufferFlushOnlyがoffに指定されていない場合は、ほかのパラメーター(LockForceMode、LockRetryNumber、LockRetryInterval)は、すべて無効となります。本パラメーターをonにする場合、業務ボリュームへのすべての書込み処理を事前に停止する必要があります。書込み処理を停止しない状態でバックアップした場合、業務ボリュームのデータ内容は保証されません。 NoPrePostがonの場合、本パラメーターは無効となります。
LockForceMode	ロック処理をリトライする前に、ボリュームのマウントを解除するかを指定します。 off(デフォルト値): マウントを解除しない on: マウントを解除するボリュームのマウントが解除されると、そのボリュームに対して開いているすべてのハンドルが無効となります。 ※マウント解除後にボリュームがすぐに使用中になる場合は、ロックできないことがあります。 BufferFlushOnly=onまたはNoPrePost=onの場合、本パラメーターは無効となります。
LockRetryNumber	ロック処理のリトライ回数を指定します。指定できる値は、1～10000です。デフォルト値は20(回)です。指定回数分リトライしてもロックできない場合は、処理を中断してコマンドを異常終了させます。 BufferFlushOnly=onまたはNoPrePost=onの場合、本パラメーターは無効となります。
LockRetryInterval	ロック処理のリトライ間隔(ミリ秒単位)を指定します。指定できる値は、1～600000(10分)です。デフォルト値は1000(1秒)です。 BufferFlushOnly=onまたはNoPrePost=onの場合、本パラメーターは無効となります。
NoPrePost	バックアップ前後処理を実施するかを指定します。 off(デフォルト値): 実施する on: 実施しない NoPrePost=onの場合、ほかのパラメーター(BufferFlushOnly、LockForceMode、LockRetryNumber、LockRetryInterval)は無効となります。