Symantec NetBackup™ コマンドリファレンスガイド
- 概要
- 付録 A. NetBackup コマンド
名前
vlteject — 以前に実行したセッションに対するメディアの取り出しおよびレポートの生成
概要
vlteject
vlteject -eject [-profile profile_name] [-robot robot_name] [-vault vault_name [-sessionid id]] [-auto y|n] [-eject_delay seconds]
vlteject -report [-profile profile_name] [-robot robot_name] [-vault vault_name [-sessionid id]] [-legacy]
vlteject -eject -report [-profile profile_name] [-robot robot_name] [-vault vault_name [-sessionid id]] [-auto y|n] [-eject_delay seconds] [-version] [-legacy]
vlteject -preview [-vault vault_name [-profile profile_name]] [-profile robot_no / vault_name / profile_name] [-robot robot_name][-sessionid id]
UNIX システムでは、このコマンドへのディレクトリパスは /usr/openv/netbackup/bin/ です。
Windows システムでは、このコマンドへのディレクトリパスは install_path\NetBackup\bin\ です。
説明
vlteject を実行すると、メディアがまだ取り出されていない Vault セッションに対して、メディアの取り出しおよび (プロファイルで構成されている) 対応するレポートの生成が行われます。vlteject によって、すべてのセッション、特定のロボット、特定の Vault または特定のプロファイルに関する保留中の取り出しおよびレポートが処理されます。保留中のすべての取り出しおよびレポートを処理する場合、-profile、-robot または -vault オプションを指定しないでください。
vlteject は、セッションディレクトリが存在しているセッションに対してだけ動作します。ディレクトリが NetBackup によって削除されると、そのセッションに対しては、vlteject によるメディアの取り出しまたはレポートの生成は実行できません。
vlteject は、呼び出しの方法に応じて、対話形式または非対話形式で実行されます。メディアアクセスポートに配置できない数のメディアを取り出す場合は、対話形式で実行してください。
vlteject の実行中は、Vault の構成を変更しないでください。
vlteject は、次のいずれかの方法で実行できます。
コマンドラインから直接実行する。
NetBackup ポリシースケジュールを使用する。この場合、ポリシー形式が Vault で、ポリシーのファイルリストに vlteject コマンドが含まれている必要があります。
vltopmenu を使用して、取り出し操作、取り出しの統合操作またはレポートの統合操作として実行する。
次のディレクトリが存在し、そのディレクトリにすべてのユーザーによる書き込みが許可されている場合は、vlteject を実行すると日次デバッグログファイルの書き込みが行われます。
UNIX システムの場合: usr/openv/netbackup/logs/vault
Windows システムの場合: install_path\netbackup\logs\vault
日次デバッグログファイルの名前は log.DDMMYY (DDMMYY は現在の日付) です。
このファイルに書き込みを行うすべての実行可能ファイルが管理者 (Administrator) または root ユーザーによって実行されるわけではないため、すべてのユーザーによる書き込みを許可する必要があります。ホストプロパティの[Vault ログの保持 (Keep vault logs)]で、Vault セッションディレクトリの保持期間が決定されます。
このコマンドは、すべての認可済みユーザーが実行できます。
NetBackup による認可について詳しくは、『NetBackup セキュリティおよび暗号化ガイド』を参照してください。
オプション
- -auto y|n
このオプションでは、自動モード (y) または対話モード (n) を指定します。自動モード (y) では、vlteject はユーザーによる入力なしで実行され、出力は表示されません。対話モード (デフォルト) では、vlteject は対話形式で実行されます。このモードでは、入力が可能で、出力が表示されます。
- -eject
指定したセッションからメディアを取り出します。取り出しがすでに完了しており、レポートの生成だけを行う場合、-eject を指定する必要はありません。
- -eject_delay seconds
このオプションでは、メディアの取り出しまでの遅延を秒数で指定します。このオプションは、目的のメディアにバックアップや複製などの操作が行われてからあまり時間が経過していない場合に有効です。デフォルトは 0 (ゼロ) です。最大値は 3600 (1 時間) です。
- -legacy
古い形式で統合レポートを生成します。このオプションは、-report オプションを指定した場合だけ有効です。
- -preview
このオプションを指定すると、セッションとそのセッションで取り出されるメディアが一覧表示されます。メディアの取り出しは行われません。
- -profile robot _no / vault_name / profile_name
メディアの取り出しおよびレポートの生成を行うロボット番号、Vault 名、プロファイル名を指定します。3 つのオプションはすべて -profile とともに指定する必要があります。保留中のすべての取り出しおよびレポートを処理するには、-profile は profile_name のみと指定します。
- -report
指定したセッションのレポートを生成します。対応する取り出し処理が完了している場合、選択したセッションの保留中のレポートが生成され、配布されます。vlteject コマンドを再実行しても、これらのレポートは再生成されません。取り出しが完了していない場合には、取り出しの完了に依存しないレポートのサブセットを生成します。これらのレポートは、取り出しの完了後に vlteject -report を再実行すると再生成されます。
- -robot robot_no
メディアを取り出してレポートを生成するロボットを識別するロボット番号を指定します。ロボット内のすべての Vault では、同じオフサイトボリュームグループが使用される必要があります。保留中のすべての取り出しおよびレポートを処理する場合、-profile、-robot または -vault オプションを指定しないでください。
- -sessionid id
このオプションでは、セッション ID を数字で指定します。-profile、-robotまたは -vault 指定して -session id を指定しない場合、vlteject は、指定したプロファイル、ロボットまたは Vault のすべてのセッションに対して動作します。
- -vault vault_name
このオプションでは、メディアの取り出しおよびレポートの生成の対象となる Vault を指定します。保留中のすべての取り出しおよびレポートを処理する場合、-profile、-robot または -vault オプションを指定しないでください。
- -version
このオプションを指定すると、vlteject のバージョンが表示されます。
例
例 1 - メディアが取り出されていないセッションが存在するすべてのロボットでメディアを取り出し、レポートを生成します。
# vlteject -eject -report
例 2 - CustomerDB 用 Vault のすべてのセッションで、取り出されていないすべてのメディアを取り出し、該当するレポートを生成します。
# vlteject -vault CustomerDB -eject -report
戻り値
Vault は、255 より大きい状態コードで終了する場合があります。このような状態コードは、拡張終了状態コードと呼ばれます。この場合、システムに戻される終了状態は 252 です。実際の終了状態は標準エラー出力 (stderr) に[EXIT status = exit status]という形式で書き込まれます。
拡張終了状態の値については、『NetBackup トラブルシューティングガイド』および『NetBackup トラブルシューティングウィザード』を参照してください。
ファイル
UNIX システムの場合:
/usr/openv/netbackup/db/vault/vault.xml /usr/openv/netbackup/logs/vault/log.mmddyy /usr/openv/netbackup/vault/sessions/vlt_name/sidxxx/detail.log /usr/openv/netbackup/vault/sessions/vlt_name/sidxxx/summary.log /usr/openv/netbackup/vault/sessions/vlt_name/sidxxx/vlteject_status /usr/openv/netbackup/vault/sessions/vlteject.mstr /usr/openv/netbackup/bp.conf
Windows システムの場合:
install_path\NetBackup\db\vault\vault.xml install_path\NetBackup\logs\bpbrmvlt\mmddyy.log install_path\NetBackup\logs\vault\mmddyy.log install_path\NetBackup\vault\sessions\vlt_name\sidxxx\detail.log install_path\NetBackup\vault\sessions\vlt_name\sidxxx\summary.log install_path\NetBackup\vault\sessions\vlt_name\sidxxx\vlteject.status install_path\NetBackup\vault\sessions\vlteject.mstr install_path\NetBackup\bp.conf