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.  
      プラグインのログの有効化

作業負荷検出フェーズについて

次の図は、検出フェーズ中に行われるさまざまなタスクを示しています。

図: 作業負荷の検出フェーズ

作業負荷の検出フェーズ

検出フェーズは、次のタスクで構成されます。

  • (すべての作業負荷向け) アプリケーション固有の検出を実行し、各バックアップホストについて、バックアップする必要があるデータの詳細を確認します。

  • (オプション) アプリケーションのバックアップに一貫性を保つために、アプリケーションデータを静止します。

  • (作業負荷の種類に応じて) クラッシュ整合性のあるスナップショットをバックアップ中に作成します。

作業負荷の検出フェーズのプロセス

次の図に検出フェーズのプロセスを示します。

図: 作業負荷の検出フェーズのプロセス

作業負荷の検出フェーズのプロセス
  1. nbaapidiscv は、機能しているバックアップホストでプラグイン定義の検出 API を呼び出し、作業負荷アプリケーションの検出を実行します。

    検出 API は、作業負荷ファイルの検出情報を、各バックアップホストに事前定義済みの形式で配置します。

  2. プラグインは、複数のバックアップホストを使用してバックアップできるように、バックアップデータをどのように分割するかを決定します。

    複数のバックアップホストをポリシーに構成すると、検出 API は、スナップショットとバックアップの関連情報を含めて、各バックアップホスト用に複数の作業負荷ファイルを作成します。この場合、複数のジョブが各バックアップホストで独立して実行され、各ジョブは、作業負荷ファイルで指定されたデータのみをバックアップします。

プラグインに送信される情報

NetBackup Parallel Streaming Framework は、次の情報をプラグインに送信します。

バックアップ対象

構成済みポリシーのバックアップ対象です。

バックアップホスト

構成済みポリシーの利用可能なバックアップホストで、並列バックアップの操作を実行するために使用されます。

作業負荷出力ディレクトリ

プラグインが作業負荷ファイルを作成する、作業負荷出力ディレクトリです。出力ディレクトリには、各バックアップホストの作業負荷ファイルが、backuphost.workloadfilesuffix の形式で含まれています。

ワークロードファイル名のサフィックス

作業負荷ファイル名に付加するサフィックスです。ファイルを一意に識別できるようにするために、バックアップホスト用に作成される各作業負荷ファイル名に、このサフィックスを付加する必要があります。

バックアップスケジュール形式

バックアップスケジュールの種類で、完全、差分増分、累積増分があります。

スナップショット ID

作業負荷データ用に作成されるスナップショットを識別するための、一意のスナップショット ID です。

NetBackup Parallel Streaming Framework では、バックアップジョブがトリガされたときのタイムスタンプをスナップショット ID として使用します。同じスナップショット ID は、作業負荷ファイル内と、後処理中に使用されます。

必要に応じて、プラグイン開発者は、スナップショット ID をカスタマイズできます。作業負荷ファイルについてを参照してください。

関連するプロセスと API

作業負荷検出フェーズでは、次の NetBackup プロセスが順番に実行されます。

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

  2. bpcd プロセスは、機能しているバックアップホスト上で実行されます。

  3. nbaapidiscv は、機能しているバックアップホストを使用して検出を実行します。

検出フェーズでは、次の API が順番に呼び出されます。

表: 検出フェーズと API 呼び出しの順番

フェーズ

API 呼び出し

サンプルのプラグインの参照

プラグインの初期化

aapi_pgn_init

aapi_pgn_init

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

aapi_pgn_claim

samplepgn_claim_v1

接続の設定

aapi_open_server

samplepgn_open_server_v1

検出フェーズ

aapi_discovery

samplepgn_discovery_v1

プラグインのアンロード

  1. samplepgn_close_server_v1

  2. samplepgn_terminate_v1

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

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

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

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

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

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

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

関連項目

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

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

作業負荷ファイルについてを参照してください。