Veritas NetBackup 並列ストリームフレームワーク SDK 開発者ガイド
- NetBackup Parallel Streaming Framework を使用したワークロードの保護
- NetBackup Parallel Streaming Framework プラグインアーキテクチャ
- NetBackup Parallel Streaming Framework SDK の配備
- プラグイン開発の準備
- サンプルプラグインの使用
- 作業負荷プラグインの開発
- ワークロードプラグインの配備
- NetBackup Parallel Streaming Framework API リファレンス
- ログとトラブルシューティング
リストアフェーズについて
リストアジョブに対して、ユーザーは、オブジェクトのリストア元となる NetBackup サーバーと、バックアップデータをリストアする必要があるクライアントを選択します。これにより、メディアサーバー上で bpbrm プロセスが実行されて、オブジェクトのリストア元の NetBackup サーバーでリストア操作が開始されます。オブジェクトは、同じ場所または代替の場所にリストアできます。リストアに使用されるのは、1 つのバックアップホストのみです。Parallel Streaming Framework を使用したリストア処理を参照してください。
リストアタスクは、次の図に示すように nbtar プロセス主導で進められます。
代替リストアの場合、オブジェクトのリストアパスは、バックアップされたオブジェクトパスから代替リストアパスに変更されます。
たとえば、バックアップオブジェクトパスが
/obj-container1/obj-container2/file.txt
の場合、これは/mnt/vol-1/obj-container1/obj-container2/file.txt
に変わります (代替の場所はmnt/vol-1
)。aapi_get_object_prop_byname API は、オブジェクトプロパティを取得するために、オブジェクトリストアパスを使用して呼び出されます。
たとえば、aapi_get_object_prop_byname API は、
/mnt/vol-1/obj-container1/obj-container2/file.txt
のメタプロパティを提供します。4. オブジェクトリストアパスがすでに存在し、次の条件が該当する場合。
上書きオプションが false に設定されている場合、オブジェクトのリストアはスキップされます。
上書きオプションが true に設定されている場合、既存のオブジェクトを削除するために aapi_delete_object API が呼び出されます。
aapi_create_object API の実装を使用して、新しいオブジェクトが作成されます。
名前、サイズ、アクセス権、u/mtime、所有者などのオブジェクト情報は、オブジェクトプロパティの設定に使用する aapi_create_object の呼び出しに渡されます。
aapi_create_object API は、リストアパスのすべてのオブジェクト (最初のオブジェクトからリーフオブジェクトまで) に対して呼び出されます。したがって、オブジェクトコンテナが存在しない場合は、これらも作成されます。
たとえば、
/mnt/vol-1/obj-container1/obj-container2/file.txt
をリストアする場合、aapi_create_object API は階層ごとに 1 回ずつで合計 5 回呼び出されます。/mnt - オブジェクトコンテナ
/mnt/vol-1 - オブジェクトコンテナ
/mnt/vol-1/obj-container1 - オブジェクトコンテナ
/mnt/vol-1/obj-container1/obj-container2 - オブジェクトコンテナ
/mnt/vol-1/obj-container1/obj-container2/file.txt - データコンテナ
オブジェクトは、バックアップイメージからバックアップ済みコンテンツを読み込み、aapi_write_object API を呼び出すことでリストアされます。
このプロセスは、オブジェクト全体が読み込まれるまで、順番に繰り返し実行されます。
aapi_set_object_utimes API が呼び出されて、オブジェクトのアクセス時刻と修正時刻がリストアされます。
すべてのオブジェクトがリストアされた後、aapi_set_object_utimes API が再び呼び出されて、オブジェクトコンテナのアクセス時刻と修正時刻がリストアされます。
aapi_close_object API を呼び出してオブジェクト関連のクリーンアップを実行して、データオブジェクトが閉じられます。
リストアフェーズでは、次の NetBackup プロセスが順番に実行されます。
bpbrm プロセスは、メディアサーバー上で実行されます。
nbtar は、すべてのバックアップホストでバックアップを実行します。
リストアフェーズでは、次の API が順番に呼び出されます。
表: リストアフェーズの API 呼び出しの順番
フェーズ |
API 呼び出し |
サンプルのプラグインの参照 |
---|---|---|
プラグインの初期化 |
| |
PSF によるプラグインの要求 |
| |
接続の設定 |
| |
リストアフェーズ |
| |
プラグインのアンロード |
|
既存のエラーとは別に、関連するデバッグログファイルにカスタムログを作成します。
プラグインのログの有効化を参照してください。
開発中のプラグインをテストする際に、それぞれの開発フェーズのログを確認します。プラグイン全体を構築するまでは、ジョブが失敗する可能性があります。特定のフェーズの成功ログを確認する必要があります。
たとえば、検出フェーズの開発を完了した場合、バックアップは失敗する可能性がありますが、検出は成功するはずです。
開発中のプラグインの検証およびテストを参照してください。
???を参照してください。
Parallel Streaming Framework を使用したリストア処理を参照してください。
サンプルプラグインについてを参照してください。