Veritas NetBackup 並列ストリームフレームワーク SDK 開発者ガイド

Last Published:
Product(s): NetBackup & Alta Data Protection (8.1.2)
  1. NetBackup Parallel Streaming Framework を使用したワークロードの保護
    1.  
      NetBackup Parallel Streaming Framework について
    2.  
      Parallel Streaming Framework SDK について
    3.  
      Parallel Streaming Framework を使用したバックアップ処理
    4.  
      Parallel Streaming Framework を使用したリストア処理
    5.  
      NetBackup Parallel Streaming Framework の用語
  2. NetBackup Parallel Streaming Framework プラグインアーキテクチャ
    1.  
      プラグインの操作
    2.  
      NetBackup Parallel Streaming Framework API アーキテクチャ
    3.  
      サポート対象の NetBackup 機能
  3. NetBackup Parallel Streaming Framework SDK の配備
    1.  
      オペレーティングシステムとプラットフォームの互換性
    2.  
      NetBackup Parallel Streaming Framework SDK のライセンス
    3.  
      NetBackup Parallel Streaming Framework SDK のダウンロード
    4.  
      NetBackup Parallel Streaming Framework SDK のインストール
  4. プラグイン開発の準備
    1.  
      NetBackup 環境の準備
    2. バックアップホストの管理
      1.  
        NetBackup マスターサーバー上の NetBackup クライアントのホワイトリスト
    3.  
      BigData バックアップポリシーの作成
    4.  
      認証機構の処理
    5.  
      NetBackup での作業負荷クレデンシャルの追加
    6.  
      セキュリティの考慮事項
    7.  
      プラグインを利用できるようにするために必要な認証
  5. サンプルプラグインの使用
    1.  
      サンプルプラグインについて
    2.  
      サンプルプラグインの開発
  6. 作業負荷プラグインの開発
    1.  
      プラグインの開発フェーズについて
    2.  
      プラグインの初期化フェーズについて
    3.  
      プラグインの要求フェーズについて
    4.  
      プラグインのアンロードフェーズについて
    5. 作業負荷検出フェーズについて
      1.  
        作業負荷ファイルについて
    6.  
      データバックアップフェーズについて
    7.  
      リストアフェーズについて
    8.  
      リカバリフェーズについて
    9.  
      API の実行時間の管理
    10.  
      開発中のプラグインの検証およびテスト
    11.  
      作業負荷プラグインのパッケージ化
  7. ワークロードプラグインの配備
    1.  
      NetBackup File Checksum Validator ツールを使用したプラグインの検証
    2.  
      バックアップホストへの作業負荷プラグインのインストール
    3.  
      作業負荷向けの NetBackup の構成
    4.  
      作業負荷のバックアップとリストアの実行
  8. NetBackup Parallel Streaming Framework API リファレンス
    1.  
      aapi_close_object
    2.  
      aapi_close_server
    3.  
      aapi_create_object
    4.  
      aapi_delete_object
    5.  
      aapi_discovery
    6.  
      aapi_flush
    7.  
      aapi_get_object_prop
    8.  
      aapi_get_object_prop_byname
    9.  
      aapi_get_server_prop
    10.  
      aapi_get_snappath_from_realpath
    11.  
      aapi_open_object
    12.  
      aapi_open_server
    13.  
      aapi_pgn_claim
    14.  
      aapi_pgn_init
    15.  
      aapi_postprocess
    16.  
      aapi_read_object
    17.  
      aapi_set_object_utimes
    18.  
      aapi_terminate
    19.  
      aapi_write_object
    20.  
      aapi_restore_preprocess
    21.  
      aapi_restore_postprocess
    22.  
      NetBackup Parallel Streaming Framework API の戻り値
  9. ログとトラブルシューティング
    1.  
      プラグインのログの有効化

データバックアップフェーズについて

検出ジョブが正常に完了したら、メディアサーバー上の bpbrm プロセスが対応するバックアップホストに作業負荷ファイルを配布し、バックアップホスト上でバックアップタスクを開始します。バックアップジョブは、検出ジョブとは異なり、BigData ポリシーに構成されているすべてのバックアップホストで実行されます。Parallel Streaming Framework を使用したバックアップ処理を参照してください。

バックアップ処理が開始されると、メディアサーバー上で bpbrm プロセスが実行されて、すべてのバックアップホストでバックアップフェーズ (bpbkar) がアクティブ化されます。

バックアップフェーズのプロセス

次の図に、バックアップフェーズのプロセスを示します。

図: バックアップフェーズのプロセス

バックアップフェーズのプロセス
  1. bpbkar プロセスは、作業負荷検出フェーズ中に作成された作業負荷ファイルを読み込みます。作業負荷ファイルには、スナップショットの識別子 (スナップショットが有効なバックアップの場合) とアプリケーションオブジェクト階層が含まれています。作業負荷ファイルについてを参照してください。

  2. 作業負荷によっては、次の手順のいずれかを実行します。

    • スナップショットが有効なバックアップの場合:

      • 作業負荷ファイルでは、アプリケーションオブジェクト階層の前に、スナップショット ID が示されています。

      • バックアップ処理は、有効なオブジェクトパスを参照するために、スナップショット ID (snapname) を使用してオブジェクトパス (realpath) を実際のパス (snappath) に解決します。このために、バックアップ処理はオブジェクトごとに aapi_get_snappath_from_realpath API を呼び出します。

      • 次に、バックアップ処理は実際のパスを使用して、aapi_get_object_prop_byname API によるオブジェクトプロパティ情報のクエリーを実行します。バックアップ処理では、マスターサーバー上の NetBackup カタログにオブジェクトのプロパティ情報が格納されます。カタログに格納されている情報は、リストア時に使用されます。

    • スナップショットが有効なバックアップの場合、作業負荷ファイルにはスナップショット識別子が含まれます。これは、アプリケーションオブジェクト階層の前に示されます。

      バックアップ処理は、有効なオブジェクトパスを参照するために、スナップショット識別子 (snapname) を使用してオブジェクトパス (realpath) を実際のパス (snappath) に解決します。このために、バックアップ処理はオブジェクトごとに aapi_get_snappath_from_realpath API を呼び出します。次に、バックアップ処理は実際のパスを使用して、プラグインが実装する aapi_get_object_prop_byname API によるオブジェクトプロパティ情報のクエリーを実行します。バックアップ処理では、さまざまな目的で、マスターサーバー上の NetBackup カタログにオブジェクトのプロパティ情報が格納されます。

  3. バックアップ処理は aapi_open_object API を呼び出して、実際のパスを使用してオブジェクトを開きます。

  4. 成功すると、aapi_read_object API が繰り返し呼び出されて、オブジェクトが表すデータが読み込まれます。

  5. 読み込まれたデータは、データ移動用にメディアサーバーに送信されます。

  6. 読み込みが完了すると、aapi_close_object API が呼び出されてオブジェクトが閉じられます。

関連するプロセスと API

バックアップフェーズでは、次の NetBackup プロセスが順番に実行されます。

  1. bpbrm プロセスは、メディアサーバー上で実行されます。

  2. bpbkar は、すべてのバックアップホストでバックアップを実行します。

バックアップフェーズでは、次の API が順番に呼び出されます。

表: バックアップフェーズの API 呼び出しの順番

フェーズ

API 呼び出し

サンプル API リファレンス

プラグインの初期化

aapi_pgn_init

aapi_pgn_init

PSF によるプラグインの要求

aapi_pgn_claim

samplepgn_claim_v1

接続の設定

aapi_open_server

samplepgn_open_server_v1

バックアップフェーズ

  1. samplepgn_get_snappath_from_realpath_v1

  2. samplepgn_get_object_prop_byname_v1

  3. samplepgn_open_object_v1

  4. samplepgn_read_object_v1

  5. samplepgn_close_object_v1

プラグインのアンロード

  1. samplepgn_close_server_v1

  2. samplepgn_terminate_v1

NetBackup のプラグインの初期化フェーズでのログ情報の追加

既存のエラーとは別に、関連するデバッグログファイルにカスタムログを作成します。

プラグインのログの有効化を参照してください。

開発中のプラグインの検証およびテスト

開発中のプラグインをテストする際に、それぞれの開発フェーズのログを確認します。プラグイン全体を構築するまでは、ジョブが失敗する可能性があります。特定のフェーズの成功ログを確認する必要があります。

たとえば、検出フェーズの開発を完了した場合、バックアップは失敗する可能性がありますが、検出は成功するはずです。

開発中のプラグインの検証およびテストを参照してください。

関連項目

???を参照してください。

Parallel Streaming Framework を使用したバックアップ処理を参照してください。

サンプルプラグインについてを参照してください。