<book_title> を検索 ...

NetBackup™ 管理者ガイド Vol. 2

Last Published: 2024-05-14

Product(s): NetBackup & Alta Data Protection (10.4)

bpstart_notify.bat スクリプト (Windows クライアント)

すべての Windows クライアントでは、クライアントがバックアップまたはアーカイブを開始するたびに通知するバッチスクリプトを作成できます。

このスクリプトを使用するには、サーバーの次のファイルをコピーします。

Windows の場合:

Install_path\NetBackup\bin\goodies\bpstart_notify.bat

次に、このファイルをクライアント上の、NetBackup クライアントのバイナリと同じ次のディレクトリに配置します。

Install_path\NetBackup\bin\

ここで、Install_path は、NetBackup がインストールされているディレクトリです。

すべてのバックアップ、または特定のポリシーまたはスケジュールのバックアップを通知する bpstart_notify スクリプトを作成することもできます。

すべてのバックアップに適用するスクリプトを作成するには、スクリプトに bpstart_notify.bat という名前を付けます。

特定のポリシーまたはポリシーとスケジュールの組み合わせのみに適用する bpstart_notify スクリプトは、スクリプト名に接尾辞 .policyname または .policyname.schedulename を追加して作成します。

次は bpstart_notify スクリプト名の例です。

次のスクリプトは、days という名前のポリシーだけに適用されます。
```
install_path\netbackup\bin\bpstart_notify.days.bat
```
次のスクリプトは、ポリシー名が days である fulls という名前のスケジュールにだけ適用されます。
```
install_path\netbackup\bin\bpstart_notify.days.fulls.bat
```
.policyname[.schedule] が指定されていない場合、bpstart_notify は NetBackup カタログバックアップに対しても実行されます。

1 番目のスクリプトは、days というポリシー内のすべてのスケジュールバックアップに影響します。2 つ目のスクリプトは、days という名前のポリシーに含まれる、スケジュール名が fulls であるスケジュールバックアップだけに影響します。

該当するバックアップに対して、NetBackup では、bpstart_notify スクリプトが 1 つだけ呼び出され、次の順序で確認されます。

bpstart_notify.policy.schedule.bat
bpstart_notify.policy.bat
bpstart_notify.bat

たとえば、bpstart_notify.policy.bat スクリプトと bpstart_notify.policy.schedule.bat スクリプトの両方が存在する場合、NetBackup では、bpstart_notify.policy.schedule.bat だけが使用されます。

メモ:

bpend_notify スクリプトでは、bpstart_notify スクリプトとは異なるレベルの通知が行われます。たとえば、それぞれのスクリプトを 1 つずつ使用する場合、スクリプト名は bpstart_notify.policy.bat および bpend_notify.policy.schedule.bat. になります。

NetBackup からスクリプトに通知されるパラメータは、次のとおりです。

%1	NetBackup カタログのクライアント名を指定します。
%2	NetBackup カタログのポリシー名を指定します。
%3	NetBackup カタログのスケジュール名を指定します。
%4	FULL, INCR, CINC, UBAK, UARC のいずれかを指定します。
%5	bpstart_notify に対する操作の状態は常に 0 (ゼロ) であることを指定します。
%6	NetBackup で、スクリプトからの戻りコードを確認する結果ファイルを指定します。NetBackup は、%6 を使用してファイル名を渡し、その後、スクリプトによってスクリプトと同じディレクトリにファイルが作成されると想定します。スクリプトを特定のポリシーとスケジュールに適用する場合、結果ファイルに次の名前を付ける必要があります。 install_path\netbackup\bin\BPSTART_RES.policy.schedule スクリプトを特定のポリシーに適用する場合、結果ファイルに次の名前を付ける必要があります。 install_path\netbackup\bin\BPSTART_RES.policy スクリプトをすべてのバックアップに適用する場合、結果ファイルに次の名前を付ける必要があります。 install_path\netbackup\bin\BPSTART_RES echo 0> %6 文を使用して、スクリプトでファイルを作成することもできます。 NetBackup では、スクリプトを呼び出す前に既存の結果ファイルが削除されます。スクリプトが実行された後、NetBackup では新しい結果ファイルで状態が確認されます。スクリプトが正常終了したと見なされるには、状態が 0 (ゼロ) である必要があります。結果ファイルが存在しない場合、NetBackup によってスクリプトが正常終了したと見なされます。

サーバーは、サーバーの continue オプションで指定された期間内にクライアントから BPSTART_TIMEOUT メッセージが返されると想定します。デフォルトの BPSTART_TIMEOUT は 300 秒です。スクリプトで 300 秒を超える時間が必要な場合は、この値を大きくして待機時間を長くします。(BPSTART_TIMEOUT オプションはタイムアウトのホストプロパティの［バックアップ開始の通知タイムアウト (Backup start notify timeout)］に対応します)。

メモ:

［クライアントの読み込みタイムアウト (Client read timeout)］ (CLIENT_READ_TIMEOUT オプション) は、［バックアップ開始の通知タイムアウト (Backup start notify timeout)］ (BPSTART_TIMEOUT オプション) 以上である必要があります。［クライアントの読み込みタイムアウト (Client read timeout)］が［バックアップ開始の通知タイムアウト (Backup start notify timeout)］より小さいなら、ジョブはスクリプトが動作している間タイムアウトできます。bpstart_notify