Symantec NetBackup™ コマンドリファレンスガイド
- 概要
- 付録 A. NetBackup コマンド
名前
importtrace — インポートジョブのデバッグログのトレース
概要
importtrace [-master_server name] -job_id number [-start_time hh:mm:ss] [-end_time hh:mm:ss] mmddyy [mmddyy]
importtrace [-master_server name] -backup_id id [-start_time hh:mm:ss] [-end_time hh:mm:ss] mmddyy [mmddyy]
importtrace [-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\
です。
説明
importtrace を実行すると、指定したインポートジョブのデバッグログメッセージが統合され、標準出力に書き込まれます。メッセージは時間順にソートされます。importtrace では、リモートサーバーとクライアント間のタイムゾーンの違いおよびクロックのずれに対する補正が試行されます。
少なくとも、メディアサーバー上の bpbrm、bptm、nbtar およびマスターサーバー上の次のディレクトリのデバッグログを有効にします。
UNIX システムの場合:
/usr/openv/netbackup/admin
Windows システムの場合:
install_path\NetBackup\admin
最大の出力結果を得るには、ログの詳細度を 5 に設定します。前述のプロセスに加えて、マスターサーバー上の bpdbm およびすべてのサーバーとクライアント上の bpcd のデバッグログを有効にします。
importtrace では、トレースするインポートジョブを選択するための唯一の条件として -job_id または -backup_id オプションが使用されます。-policy_name オプションまたは -client_name オプションは、-job_id または -backup_id と組み合わせて使用することはできません。いずれのオプションも指定しない場合、選択条件と一致するすべてのインポートジョブが選択されます。-job_id、-backup_id、-policy_name または -client_name のいずれのオプションも指定しない場合、日付スタンプ (mmddyy) で指定した日付に実行されたすべての複製ジョブがトレースされます。-start_time および -end_time オプションを使用すると、指定した時間内に生成されたデバッグログが importtrace によって検証されます。
-backup_id id を指定して importtrace を起動すると、bpimport で同じバックアップ ID (id) を -backup_id id に指定して開始されたインポートジョブが importtrace によって検索されます。
-policy_name policy を指定して importtrace を起動すると、bpimport で同じポリシー名 (policy) を -policy policy に指定して開始されたインポートジョブが importtrace によって検索されます。
-client_name client を指定して importtrace を起動すると、bpimport で同じクライアント名 (client) を -client client に指定して開始されたインポートジョブが importtrace によって検索されます。
importtrace では、エラーメッセージが標準エラーに書き込まれます。
このコマンドを実行するには、管理者権限が必要です。
オプション
- -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.sequencemachinelog_line
- daystamp
yyyymmdd 形式で表示されるログの日付。
- millisecs
ローカルコンピュータで午前 0 時から経過したミリ秒数。
- program
ログが記録されるプログラム名 (ADMIN、BPBRM、BPCD など)。
- sequence
デバッグログファイル内の行番号。
- machine
NetBackup サーバーまたはクライアントの名前。
- log_line
デバッグログファイルに表示される行。
例
例 1 - 2009 年 8 月 6 日に実行された、ジョブ ID が 4 のインポートジョブのログを分析します。
# importtrace -job_id 4 080609
例 2 - 2009 年 8 月 20 日に実行された、バックアップ ID が pride_1028666945 のバックアップイメージをインポートしたインポートジョブのログを分析します。このコマンドを実行すると、-backup_id オプションに pride_1028666945 を指定して実行されたインポートジョブだけが分析されます。
# importtrace -backup_id pride_1028666945 082009
例 3 - 2009 年 8 月 16 日および 2009 年 8 月 23 日にポリシー Pride-Standard を使用してクライアント pride で実行されたインポートジョブのログを分析します。このコマンドを実行すると、-policy_name オプションに Pride-Standard、および -client_name オプションに pride を指定して実行されたインポートジョブだけが分析されます。
# importtrace -policy_name Pride-Standard -client_name pride 081609 082309
例 4 - 2015 年 8 月 5 日および 2015 年 8 月 17 日に実行されたすべてのインポートジョブのログを分析します。
# importtrace 080515 081715