Search <book_title>...

NetBackup™ トラブルシューティングガイド

Last Published: 2024-05-14

Product(s): NetBackup (10.4)

NetBackup デバッグログの分析ユーティリティについて

デバッグログの分析ユーティリティを使用すると、NetBackup の既存のデバッグ機能が拡張され、ジョブのデバッグログが 1 つに統合された形式で提供されます。

NetBackup ジョブは、複数のサーバーに分散された複数のプロセスにまたがって実行されます。

NetBackup ジョブをトレースするには、複数のホスト上の複数のログファイルのメッセージを参照し、それらを関連付ける必要があります。ログの分析ユーティリティを使用すると、ジョブのデバッグログが 1 つに統合された形式で提供されます。このユーティリティによって、ジョブの実行時にサーバー間にわたって実行されたすべてのプロセスのログがスキャンされます。ユーティリティでは、クライアント、ジョブ ID、ジョブの開始時刻およびジョブに関連付けられているポリシーごとにジョブの情報を統合できます。

表: NetBackup デバッグログの分析ユーティリティでは、ログの分析ユーティリティについて説明します。各ユーティリティのパラメータ、制限事項および使用例を表示するは、-help オプションを使用してコマンドを実行します。すべてのコマンドは管理者権限を必要とします。ログの分析ユーティリティは、NetBackup サーバーがサポートされているすべてのプラットフォームで利用できます。

メモ:

ユーティリティはサポート対象のプラットフォームで起動する必要があります。ただし、このユーティリティは UNIX と Windows のほとんどの NetBackup クライアントプラットフォームとサーバープラットフォームのデバッグログファイルを分析できます。

表: NetBackup デバッグログの分析ユーティリティ

ユーティリティ	説明
backupdbtrace	指定した NetBackup データベースバックアップジョブのデバッグログメッセージが統合され、標準出力に書き込まれます。メッセージは時間順にソートされます。backupdbtrace では、リモートサーバーとクライアント間のタイムゾーンの相違およびクロックのずれに対する補正が試行されます。少なくとも、プライマリサーバー上の admin およびメディアサーバー上の bptm と bpbkar のデバッグログを有効にする必要があります。最良の結果を得るには、ログ記録レベルを 5 に設定し、前述のプロセスに加えて、プライマリサーバー上の bpdbm およびすべてのサーバー上の bpcd のデバッグログを有効にします。 backupdbtrace の詳しい説明については、『NetBackup コマンドリファレンスガイド』を参照してください。
backuptrace	指定したバックアップジョブ (オンラインホットカタログバックアップを含む) に関連するデバッグログの行が標準出力にコピーされます。 backuptrace ユーティリティは、通常のファイルシステム、データベース拡張機能および代替バックアップ方式のバックアップジョブに対して使用できます。このユーティリティを使用すると、指定した NetBackup ジョブのデバッグログが統合されます。ユーティリティによって、関連するデバッグログのメッセージが標準出力に書き込まれ、時間順にソートされます。backuptrace では、リモートサーバーとクライアント間のタイムゾーンの相違およびクロックのずれに対する補正が試行されます。出力は、タイムスタンプ、プログラム名、サーバー名またはクライアント名による sort や grep の実行が比較的容易な形式で生成されます。 backuptrace ユーティリティを使用するには、プライマリサーバー上の nbpem、nbjm および nbrb のログが必要です。また、メディアサーバー上の bpbrm と bptm または bpdm、およびクライアント上の bpbkar のデバッグログを有効にする必要があります。最良の結果を得るには、ログ記録レベルを 5 に設定します。前述のプロセスに加えて、プライマリサーバー上の bpdbm と bprd およびすべてのサーバーとクライアント上の bpcd のデバッグログを有効にします。 backuptrace の詳しい説明については、『NetBackup コマンドリファレンスガイド』を参照してください。
bpgetdebuglog	backuptrace と restoretrace.このプログラムは単独で使うこともでき、すべての NetBackup サーバープラットフォームで利用できます。 bpgetdebuglog を実行すると、指定したデバッグログファイルの内容が標準出力に表示されます。リモートマシンのパラメータだけを指定した場合、bpgetdebuglog ではローカルコンピュータとリモートコンピュータ間のクロックのずれの秒数が標準出力に表示されます。 bpgetdebuglog の詳しい説明については、『NetBackup コマンドリファレンスガイド』を参照してください。
duplicatetrace	指定した NetBackup 複製ジョブのデバッグログが統合され、標準出力に書き込まれます。メッセージは時間順にソートされます。duplicatetrace では、リモートサーバーとクライアント間のタイムゾーンの相違およびクロックのずれに対する補正が試行されます。少なくとも、プライマリサーバー上の admin およびメディアサーバー上の bptm または bpdm のデバッグログを有効にする必要があります。最良の結果を得るには、ログ記録レベルを 5 に設定し、前述のプロセスに加えて、プライマリサーバー上の bpdbm およびすべてのサーバーとクライアント上の bpcd のデバッグログを有効にします。 duplicatetrace の詳しい説明については、『NetBackup コマンドリファレンスガイド』を参照してください。
importtrace	指定した NetBackup インポートジョブのデバッグログメッセージが統合され、標準出力に書き込まれます。メッセージは時間順にソートされます。importtrace では、リモートサーバーとクライアント間のタイムゾーンの相違およびクロックのずれに対する補正が試行されます。少なくとも、プライマリサーバー上の admin のデバッグログを有効にする必要があります。bpbrm については、メディアサーバー上の you must enable debug logging for bptm と tar のデバッグログを有効にする必要があります。最良の結果を得るには、ログ記録レベルを 5 に設定し、前述のプロセスに加えて、プライマリサーバー上の bpdbm およびすべてのサーバーとクライアント上の bpcd のデバッグログを有効にします。 importtrace の詳しい説明については、『NetBackup コマンドリファレンスガイド』を参照してください。
restoretrace	指定したリストアジョブに関連するデバッグログの行が標準出力にコピーされます。 restoretrace ユーティリティを実行すると、指定した NetBackup リストアジョブのデバッグログが統合されます。ユーティリティによって、指定したジョブに関連するデバッグログのメッセージが標準出力に書き込まれ、時間順にソートされます。restoretrace では、リモートサーバーとクライアント間のタイムゾーンの相違およびクロックのずれに対する補正が試行されます。出力は、タイムスタンプ、プログラム名、サーバー名またはクライアント名による sort や grep の実行が比較的容易な形式で生成されます。少なくとも、プライマリサーバー上の bprd のデバッグログを有効にする必要があります。また、メディアサーバー上の bpbrm と bptm または bpdm、およびクライアント上の tar のデバッグログを有効にします。最良の結果を得るには、ログ記録レベルを 5 に設定し、プライマリサーバー上の bpdbm およびすべてのサーバーとクライアント上の bpcd のデバッグログを有効にします。 restoretrace の詳しい説明については、『NetBackup コマンドリファレンスガイド』を参照してください。
verifytrace	指定した検証ジョブのデバッグログメッセージが統合され、標準出力に書き込まれます。時間順にメッセージをソートします。verifytrace コマンドは、リモートサーバーとクライアント間のタイムゾーンの違いとクロックのずれに対する補正を試行します。少なくとも、プライマリサーバー上の admin およびメディアサーバー上の bpbrm、bptm (または bpdm) と tar のデバッグログを有効にする必要があります。最良の結果を得るには、ログ記録レベルを 5 に設定し、前述のプロセスに加えて、プライマリサーバー上の bpdbm およびすべてのサーバーとクライアント上の bpcd のデバッグログを有効にします。 verifytrace の詳しい説明については、『NetBackup コマンドリファレンスガイド』を参照してください。

分析ユーティリティに次の制限事項があります。

メディアおよびデバイスの管理ログは分析されません。

レガシーデバッグログファイルは、サーバーおよびクライアント上の標準の場所に存在する必要があります。

UNIX の場合	*/usr/openv/netbackup/logs/<PROGRAM_NAME>/log.mmddyy*
Windows の場合	install_path\NetBackup\Logs\<PROGRAM_NAME>\mmddyy.log

今後、分析されたログファイルを代替パスに配置できるオプションが追加される可能性があります。

メモ:

統合ログ機能を使用するプロセスの場合、ログディレクトリは自動的に作成されます。

統合されたデバッグログには、関連のないプロセスからのメッセージが表示される場合があります。ジョブの実行時間外のタイムスタンプを持つ bprd、nbpem、nbjm、nbrb、bpdbm、bpbrm、bptm、bpdm および bpcd からのメッセージは無視できます。

ログの分析ユーティリティからの出力行は次の形式を使います。

    daystamp.millisecs.program.sequence machine log_line

*daystamp*	yyyymmdd 形式のログの日付。
*millisecs*	ローカルコンピュータで午前 0 時から経過したミリ秒数。
*program*	ログが記録されるプログラム名 (BPCD、BPRD など)。
*sequence*	デバッグログファイル内の行番号。
*machine*	NetBackup サーバーまたはクライアントの名前。
*log_line*	デバッグログファイルに表示される行。

詳しくは、『NetBackup コマンドリファレンスガイド』を参照してください。