Veritas NetBackup™ コマンドリファレンスガイド
- 概要
- 付録 A. NetBackup コマンド
名前
verifytrace — 検証ジョブのデバッグログのトレース
概要
verifytrace [-master_server name] -job_id number [-start_time hh:mm:ss] [-end_time hh:mm:ss] mmddyy [mmddyy _]
verifytrace [-master_server name] -backup_id id [-start_time hh:mm:ss] [-end_time hh:mm:ss] mmddyy [mmddyy _]
verifytrace [-master_server name] [-policy_name name] [-client_name name] [-start_time hh:mm:ss] [-end_time hh:mm:ss] mmddyy [mmddyy _]
UNIX システムでは、このコマンドへのディレクトリパスは /usr/openv/netbackup/bin/admincmd/ です。
Windows システムでは、このコマンドへのディレクトリパスは install_path\NetBackup\bin\admincmd\
です。
説明
verifytrace コマンドを実行すると、指定した検証ジョブのデバッグログメッセージが統合され、標準出力に書き込まれます。メッセージは時間順にソートされます。verifytrace では、リモートサーバーとクライアント間のタイムゾーンの違いおよびクロックのずれに対する補正が試行されます。
少なくとも、次のデバッグログを有効にする必要があります。
UNIX システムの場合: マスターサーバー上の
/usr/openv/netbackup/admin
ディレクトリWindows システムの場合: マスターサーバー上の
install_path\NetBackup\bin\admin
ディレクトリメディアサーバー上の bpbrm、bptm/bpdm、および tar コマンド
最大の出力結果を得るには、ログの詳細度を 5 に設定します。また、前述のプロセスに加えて、マスターサーバー上の bpdbm およびすべてのサーバーとクライアント上の bpcd のデバッグログを有効にします。
-job_id または -backup_id のいずれかを指定した場合には、verifytrace はトレースする検証ジョブを選択するための唯一の条件としてこのオプションを使います。-policy_name または -client_name オプションは、-job_id または -backup_id と組み合わせて使用することはできません。-job_id または -backup_id を指定しない場合、指定した選択条件を満たすすべての検証ジョブが verifytrace によって選択されます。 -job_id、-backup_id、-policy_name 、-client_name のどのオプションも指定しない場合には、verifytrace は日付スタンプ (mmddyy) で指定した日付に実行したすべての検証ジョブをトレースします。-start_time および -end_time オプションを使用すると、指定した時間内のデバッグログが検証されます。
-backup_id id オプションを指定して verifytrace を起動すると、bpverify で同じバックアップ ID (id) を -backup_id id オプションに指定して開始された検証ジョブが検索されます。
-policy_name name オプションを指定して verifytrace を起動すると、bpverify で同じポリシー名 (name) を -policy_name name オプションに指定して開始された検証ジョブが検索されます。
-client_name name オプションを指定して verifytrace を起動すると、bpverify で同じクライアント名 (name) を -client_name name オプションに指定して開始された検証ジョブが検索されます。
verifytrace では、エラーメッセージが標準エラーに書き込まれます。
このコマンドを実行するには、管理者権限が必要です。
オプション
- -master_server
このオプションでは、マスターサーバー名を指定します。デフォルトは、ローカルのホスト名です。
- -job_id
このオプションでは、分析する検証ジョブのジョブ ID 番号を指定します。デフォルトは、すべてのジョブ ID です。
- -backup_id
このオプションでは、分析する検証ジョブによって検証されたバックアップイメージのバックアップ ID 番号を指定します。デフォルトは、すべてのバックアップ ID です。
- -policy_name
このオプションでは、分析する検証ジョブのポリシー名を指定します。デフォルトは、すべてのポリシーです。
- -client_name
このオプションでは、分析する検証ジョブのクライアント名を指定します。デフォルトは、すべてのクライアントです。
- -start_time
このオプションでは、ログの分析を開始する最初のタイムスタンプを指定します。 デフォルトは、00:00:00 です。
- -end_time
このオプションでは、ログの分析を終了する最後のタイムスタンプを指定します。 デフォルトは、23:59:59 です。
- mmddyy
このオプションでは、1 つ以上の日付スタンプを指定します。このオプションによって、分析されるログファイル名 (UNIX の場合は log.mmddyy、Windows の場合は mmddyy.log) が識別されます。
出力形式
出力行の形式は daystamp.millisecs.program.sequence machine log_line です。
- daystamp
yyyymmdd 形式で作成されるログの日付。
- millisecs
ローカルコンピュータで午前 0 時から経過したミリ秒数。
- program
ログが記録されるプログラム名 (ADMIN、BPBRM、BPCD など)。
- sequence
デバッグログファイル内の行番号。
- machine
NetBackup サーバーまたはクライアントの名前。
- log_line
デバッグログファイルに表示される行。
例
例 1 - 2011 年 8 月 6 日に実行された、ジョブ ID が 2 の検証ジョブのログを分析します。
# verifytrace -job_id 2 080611
例 2 - 2011 年 8 月 20 日に実行された、バックアップ ID が pride_1028666945 のバックアップイメージを検証した検証ジョブのログを分析します。このコマンドを実行すると、-backupid オプションに pride_1028666945 を指定して実行した検証ジョブのみを分析します。
# verifytrace -backup_id pride_1028666945 082011
例 3 - ポリシー Pride-Std、クライアント pride で 2011 年 8 月 16 日および 2011 年 8 月 23 日に実行した検証ジョブのログを分析します。 このコマンドを実行すると、-policy オプション Pride-Std、-client オプション pride で実行した検証ジョブのみを分析します。
# verifytrace -policy_name Pride-Std -client_name pride 081611 082311
例 4 - 2011 年 8 月 5 日および 2011 年 8 月 17 日に実行された検証ジョブのログを分析します。
# verifytrace 080511 081711