NetWorker VMware Protection-vProxy: デバッグ ログを有効にする方法
Summary: vProxyアプライアンス ソリューション(NVP-vProxy)を使用したNetWorker VMware Protection (NVP)の問題をトラブルシューティングするには、ログ レベルを「debug」に変更する必要がある場合があります。この記事では、ログ レベルを変更する方法について説明します。
Instructions
このビデオをご覧ください。vProxyデバッグ ログを有効にする方法。
vProxyエンジンのデバッグを適用する方法:
通常は、NetWorkerサーバーのポリシー ログを /nsr/logs/policy/[policy name]ただし、場合によっては、vProxyアプライアンス自体からのログを分析し、さらに、失敗の理由をより明確に把握するために デバッグするログ レベルを上げる必要があります。これは通常、NetWorkerサポートが関与し、サポート エンジニアが特定のプロセスとしてトラブルシューティングするようにデバッグ設定を要求した場合にのみ必要です。
vProxyアプライアンス上のNVP-vProxyログ ファイルは、次のディレクトリーにあります。 /opt/emc/vproxy/runtime/logs.
vProxyアプライアンスでのNetWorker操作に使用される各主要プロセスには、サブディレクトリーがあります。
vbackupd vflrd vrapid vrecoverd
たとえば、 vbackupd サブディレクトリーには、次のログが含まれています。
[session-uuid].log Processing details for a session vbackupd-engine.log Requests and problem events including error and panic messages from the session log. vbackupd-boost.log DD Boost logging. vbackupd-snapmgr.log Snapshot logging vbackupd-vddk.log VDDK logging - VMware Virtual Disk Development Kit
vProxyのログと収集の詳細については、「 NVP-vProxyトリアージ ガイド: NetWorker VMware Protection vProxyのトリアージとログの概要
サービス デバッグ方法1の適用:
この方法は、vProxyバージョン4.3.x以降に適用されます。これを使用して、vProxyサービス(vrapid, vrecoverd, vbackupd, vflrd)を提供する必要があります。DD Boostトラフィック、仮想ディスク開発キット(VDDK)、スナップショット メッセージング(該当する場合)に対して、より多くのデバッグを有効にすることができます。
- vProxy 管理者 アカウントを使用して、SSH経由でvProxyに接続します。
- rootに切り替えます。
sudo su -
- vProxyエージェントのbinディレクトリーに変更します。
cd /opt/emc/vproxy/bin
- デバッグが必要なサービスの場合は、次のコマンドを実行します。
バックアップ エンジン: vbackupd
| デーモン | ログ記録エンティティ | コマンドの使用例 | ログの場所 |
|---|---|---|---|
vbackupd |
プログラム(メイン エンジン) |
./vProxy_debug.sh -s -d vbackupd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-engine.log 個々のバックアップ セッション ログ: /opt/emc/vrproxy/runtime/logs/vbackupd/BackupVmSession-<session-id>.log /opt/emc/vrproxy/runtime/logs/recycle/vbackupd/<DATE>/BackupVmSession-<session-id>.log |
| DD Boost |
./vProxy_debug.sh -s -d vbackupd -p ddboost -l all |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-boost.log |
|
| VDDKの |
./vProxy_debug.sh -s -d vbackupd -p vddk -l 4 |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-vddk.logVDDKは、ディレクトリー内にプライベート ログも保持します /tmp/vmware-root
|
|
| スナップショット マネージャー |
./vProxy_debug.sh -s -d vbackupd -p snapshotmgr -l debug |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-snapmgr.log |
リカバリー エンジン: vrecoverd
| デーモン | ログ記録エンティティ | コマンドの使用例 | ログの場所 |
|---|---|---|---|
vrecoverd |
プログラム(メインエンティティ) |
./vProxy_debug.sh -s -d vrecoverd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-engine.log 個々のリカバリー セッション ログ: /opt/emc/vrproxy/runtime/logs/vrecoverd/RecoverVmSession-<session-id>.log /opt/emc/vrproxy/runtime/logs/recycle/vrecoverd/<DATE>/RecoverVmSession-<session-id>.log |
| DD Boost |
./vProxy_debug.sh -s -d vrecoverd -p ddboost -l all |
/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-boost.log |
|
| VDDKの |
./vProxy_debug.sh -s -d vrecoverd -p vddk -l 4 |
/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-vddk.logまた、VDDKはプライベート ログをディレクトリーに保持します /tmp/vmware-root
|
FLRエンジン: vflrd
| デーモン | ログ記録エンティティ | コマンドの使用例 | ログの場所 |
|---|---|---|---|
vflrd |
プログラム(メイン エンジン) |
./vProxy_debug.sh -s -d vflrd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-engine.log個々のFLRマウント セッション ログ: /opt/emc/vrproxy/runtime/logs/vflr/FlrMountSession-<session-id>.log Individual FLR Browse Session Logs: /opt/emc/vrproxy/runtime/logs/vflr/FlrBrowseSession-<session-id>.log Individual FLR Recover Session Logs: /opt/emc/vrproxy/runtime/logs/vflr/FlrRecoverSession-<session-id>.log完了したログは次の場所に移動されます: /opt/emc/vrproxy/runtime/logs/recycle/vflrd |
| DD Boost |
./vProxy_debug.sh -s -d vflrd -p ddboost -l all |
/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-boost.log |
RESTサーバー: vrapid
| デーモン | ログ記録エンティティ | コマンドの使用例 | ログの場所 |
|---|---|---|---|
vrapid |
プログラム(メイン エンジン) |
./vProxy_debug.sh -s -d vrapid -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vrapid/vrapid-engine.log |
上記のコマンドは、デバッグの有効化を示しています。これらのコマンドは、 -l デフォルトにリセットするオプション:
オプション:
- プログラムログの場合:
warn | info | trace (既定値) | debug
- DD Boostログの場合:
none | error | warn | info | debug | trace (既定値) | all
- VDDKログの場合:
0 = ログなし
1 = エラーのみ
2 = 警告とエラー
3 = 重要な情報メッセージ、エラー、警告(デフォルト)
4 = デバッグ データとその他すべて
- スナップショット マネージャー ログの場合:
warn | info | trace (既定値) | debug
サービス デバッグ方法2の適用(手動):
設定するには
vbackupd ロギングレベルの デバッグに処理します。
- SSHまたはコンソールを介して管理者としてvProxyアプライアンスにログインし、rootに切り替えます。
sudo su -
- 次の場所にアクセスします。
systemdディレクトリ:
cd /usr/lib/systemd/system/
vbackupd.service, vfrld.service, vrapid.service, vrecoverd.service, など...
- デバッグ設定を必要とするサービス ファイルを開きます。例:
vi vbackupd.service
- で行を見つけます
ExecStart=そして、必要なデバッグパラメータを付加します。
vbackupd, vrecoverd, vflrd, and vrapid engine debug options: { debug | trace | info | warn } (default "trace")
--program-log-level=option
vbackupd, vrecoverd, and vflrd ddboost debug options: { none | error | warn | info | debug | all } (default "trace")
--boost-log-level=option
vbackupd snapshot manager debug options: { warn | info | trace | debug } (default "trace")
--snapmgr-log-level=option
Display version
--version
Multiple options could be used at once, for example if you needed to debug the vbackupd service, ddboost communication, and snapshot manager logging, the vbackupd.service file would include:
ExecStart=/opt/emc/vproxy/bin/vbackupd --program-log-level=debug --boost-log-level=all --snapmgr-log-level=debug
- ファイルへの変更を保存します。
- 次のコマンドを入力して、ユニット構成ファイルを再ロードします。
systemctl daemon-reload
- NetWorker Management Consoleでバックアップが実行されていないことを確認してから、
vbackupdサービスを起動します。
systemctl restart vbackupd.service
上記のプロセスは、次のサービスに適用されます。 vrapid、 vrecoverd、 vbackupd、 vflrdの詳細を確認してください。
VDDKデバッグの適用(手動):
VMware Disk Development Kit (VDDK)のデバッグは、 VixDiskLib.config ファイルで定義)を使用することが重要です。このデバッグは、以下にのみ適用されます。 vbackupd と vrecoverd のトラブルシューティングに従います。これは、以下には適用されません。 vflrdの詳細を確認してください。
- SSHまたはコンソールを使用して管理者としてvProxyアプライアンスにログインし、rootに切り替えます。
sudu su -
- 編集
VixDiskLib.configファイルには次の行が含まれます。
vi /opt/emc/vproxy/conf/VixDiskLib.config vixDiskLib.transport.LogLevel=4 0 = No logging 1 = Errors only 2 = Warnings, and Errors 3 = Important information messages, errors, and warnings 4 = Debug data plus everything else
- 関連サービスを再開します。
systemctl restart [service-name].service
systemctl restart vrecoverd.service
デバッグ ログが設定されると、サービスに関連付けられたログ ファイルにDEBUG行が含まれるようになります
デバッグ プロセスが完了したら、同じ手順を使用してログ レベルをリセットし、等号の後に「debug」ではなく「trace」という単語を使用します。この変更をすぐに適用するには、前述のようにデーモンの再ロードと再起動が必要です。
DD Boost事前証明書のデバッグ:
このプロセスは、上記で説明した他のデバッグ方法で行われます。デフォルトでは、DD Boostライブラリーは詳細なAPI(アプリケーション プログラミング インターフェイス)アクティビティーをログに記録しません。DD Boost事前認証ログの有効化は、他のDD Boost関連エラーが vbackupd-boost.log、 vrecovered-boost.log、 vflrd-boost.log ファイルと追加のデバッグが必要です。これは通常、Data Domainのコラボレーションまたはエンジニアリング契約のためにNetWorkerサポートから直接要求された場合にのみ必要です。
- SSHまたはコンソールを使用して管理者としてvProxyアプライアンスにログインし、rootに切り替えます。
sudu su -
- という空のファイルを作成します。
ddboost_precert.ini(DPMアプリケーションの/ファイルに置き換えます。
touch /ddboost_precert.ini
- を作成します。
DDLogディレクトリ:
mkdir /DDLog
- デバッグを必要とするサービスのDD Boostデバッグを有効にします。
vbackupd: /opt/emc/vproxy/bin/vProxy_debug.sh -s -d vbackupd -p ddboost -l debug vflrd: /opt/emc/vproxy/bin/vProxy_debug.sh -s -d vflrd -p ddboost -l debug vrecoverd: /opt/emc/vproxy/bin/vProxy_debug.sh -s -d vrecoverd -p ddboost -l debug
- が
ddboost_precert.logが生成されたら、問題を再現し、ddboost_precert.logファイルに置き換えます。
ls -l /DDLog
- デバッグ操作が不要になった場合:
- ddboostデバッグを有効にしたサービスに対して、次のコマンドを再実行します。
/opt/emc/vproxy/bin/vProxy_debug.sh -s -d service_name -p ddboost -l trace
-
- 次を削除します:
/ddboost_precert.iniファイルで定義)を使用することが重要です。
- 次を削除します:
rm -rf /ddboost_precert.ini
vProxy選択のログ:
このデバッグは、仮想マシン(VM)のバックアップ ワークフローでVMが 実行待ち状態のままスタックした場合に使用できます。このシナリオでは、バックアップ ジョブは開始されていますが、バックアップ セッションを開始するためのvProxyが選択されていません。標準ログでは、vProxy選択プロセスのログは記録されません。当社は vmbackup_logging NetWorkerサーバー上にあります。VMware保護ポリシーの開始時にvProxy選択プロセスがログに記録されます。これは、NetWorkerサーバとvProxy(ポート9090)の間に通信の問題がなく、NMCまたはでvProxyが使用できないというエラーがない場合に便利です。 daemon.rawの詳細を確認してください。
- NetWorkerサーバーで、管理者用PowerShellプロンプト(Windows)またはroot SSHセッション(Linux)を開きます。
- という拡張子のないファイルを作成します。
vmbackup_loggingNetWorkerの下/nsr/tmpディレクトリ:
Linux: touch /nsr/tmp/vmbackup_logging Windows: New-Item -Path "C:\Program Files\EMC NetWorker\nsr\tmp\vmbackup_logging" -ItemType File
/nsr/tmp したがって。
- VMバックアップ ジョブを開始します。
- レンダリングされたdaemon.logを監視します
Vmproxy Queueとselect_vproxyメッセージ。
Linux: /nsr/logs/daemon.log Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log
- このデバッグを無効にするには、
vmbackup_loggingファイルを/nsr/tmpDir。
Additional Information
関連文書: