「NetWorker Management Web UI (NWUI):トリアージおよびトラブルシューティング ガイド(英語)」
Summary: 「NetWorker Management Web UI (NWUI):トリアージおよびトラブルシューティング ガイド(英語)」
Instructions
NWUIの仕組み
4つの重要なコンポーネントがあります:
これらのコンポーネントは、同じホスト上に置くことも、別々のホスト上に置くこともできます。
- Webフロントエンド: HTML5およびAngularフレームワークで構築されたプレゼンテーション層です。ユーザーは Webブラウザーを介してNetWorker操作を利用できます。WebブラウザーはUIバックエンド プロセスに接続されています。
- UIバックエンド: バックエンド アプリケーションはSpring Frameworkで記述されています。 JavaとApache Tomcatを使用します。フロントエンドとバックエンド間、およびバックエンドとNetWorkerサーバー間の通信は、内部REST APIコールを使用して行われます。NWUIプロセスは、NetWorkerサーバー上の既存のApache Tomcatインスタンスを使用するか、NetWorkerサーバーとは別のホストにインストールされている場合は独自のApache Tomcatインスタンスをインストールします。
- NetWorkerサーバー:NetWorkerサーバーRESTフレームワークは、UIバックエンドからREST APIコールを受信し、NetWorkerサーバーのコア コンポーネントに接続します。NetWorkerサーバーのRabbitMQメッセージ バスは、nsrjobdとのやり取りにも使用されます。
- AUTHC:NetWorkerのAUTHCコンポーネントは、すべての認証ニーズに使用されます。リクエストを行うプロセスは、認証情報を検証するためにAuthCに問い合わせます。検証が成功すると、AuthCは時間ベースの署名済み暗号化トークンを発行します。NetWorkerの各コンポーネントは、このトークンを使用してユーザーを検証し、要求された操作を許可するかどうかを決定します。これは通常NetWorkerサーバー上にありますが、別のホストにインストールすることもできます。
a { text-decoration: none; color: #464feb; } tr th, tr td { border: 1px solid #e6e6e6; } tr th { background-color: #f5f5f5; } これらの内部REST APIと、NetWorker REST APIを混同しないでください。NetWorker REST APIはカスタム操作を可能にするものであり、NetWorker REST API開発者ガイドに記載されています。
トラブルシューティング
問題の定義
問題の完全な説明を生成するには、以下の質問を考慮してください。
- どの操作が試行され、正常に機能していませんか?
- この操作は、NWUIの外部から実行した場合には機能しますか?(例:NetWorker Management Console (NMC)から開始した場合)
- 問題は常に発生するのか、それとも断続的ですか?
- 断続的な場合、既知のトリガーはありますか?
- 以前は正常に機能していましたか?その場合、問題発生前後で変更がありましたか?
- この問題が最初に発生したのはいつですか(問題発生以降に何か変更されたか)?
- この問題は、バックアップ環境に負荷が高いときにのみ発生しますか?
- 問題の範囲はどの程度ですか(すべてのリカバリー操作か、一部のリカバリー操作のみか、一部のタブが機能せず他は影響なしか)?
- これまでに試した処理内容と、そこから得られた結論は何ですか?
環境の詳細
- NetWorkerサーバーのバージョンとオペレーティング システム プラットフォームは何ですか?
- NWUIはNetWorkerサーバーまたは別のホストにインストールされていますか?
- NetWorkerサーバーとは別のホストにインストールされている場合、NWUIのバージョンは何ですか?
- NWUIサーバーにインストールされているJavaパッケージは何ですか?NetWorkerランタイム環境(NRE)がインストールされていますか、またはOracle Javaランタイム環境(JRE)がインストールされていますか?
nsrlogin に指定します。と同様にAUTHCを使用して行われます。認証の問題が発生した場合は、まずNetWorkerサーバー上で認証をテストし、問題がNWUIに関するものか、サーバー自体に関連するものかを判断します。認証にADまたはLDAPを使用する場合は、まずローカルのNetWorkerアカウントでテストし、問題が外部認証にのみ影響するかどうかを確認します。
NetWorkerサーバーで認証プロセスが正常に動作しているかをテストするために一般に使用されるコマンドは次のとおりです。
authc_mgmt -u [user name] -p [password] -e find-all-users.
または
ローカル ネットワーク アカウント:
nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
さらに認証診断が必要な場合は、次を参照してください。 「NetWorker:トラブルシューティングのためにAUTHC DEBUGを有効にする方法」
インストールの問題:
「NetWorker管理Web UI:インストール方法」
重要なUIバックエンド ログは次のとおりです。
| Linuxパス | Windowsパス(デフォルト) | 機能 |
/nsr/authc/logs/catalina.log |
C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\catalina.log |
Tomcatサーバーのログおよびアプリケーション展開のログ |
/nsr/authc/logs/nwui.log |
C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\nwui.log |
NWUIアプリケーション サーバーのログ |
| /nsr/logs/restapi/restapi.log | C:\Program Files\EMC NetWorker\nsr\restapi\restapi.log |
NetWorker REST APIのログ。NWUIは、NetWorker REST APIを使用してNetWorkerサーバーと通信します。どのREST API関数が使用され、対応する応答がどのようなものかを診断する方法は、この記事の「REST API」セクションを参照してください。 |
/nsr/logs/daemon.raw |
C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw |
NetWorkerサーバーのログ |
NWUIサーバーがNetWorkerサーバー上にある場合は、NetWorkerと同一のtomcatインスタンスを共有します。
.raw ログ ファイルをサポートに提供する場合は、ログ ファイルを生成元のシステム上でレンダリングすることをお勧めします。これにより、タイムスタンプがサーバーの現地時間で正しく表示されます。NetWorker:nsr_render_logを使用して.rawログ ファイルをレンダリングする方法」
ログ ファイル
Linuxの場合
UIバックエンドで実行されるプロセスは次のとおりです。
/opt/nwui/bin/nwuictld と jsvc.exec これらのプロセスが実行されているかどうかは、 ps コマンドを使用して実行できます。
ps -ef | grep nwui
NetWorkerサーバー上(ローカル):
/opt/nwui/logs/nsr/authc/logs//nsr/logs/restapi/restapi.log/nsr/logs/daemon.raw/nsr/nwui/monitoring/app/logs/
/opt/nwui/logs/nsr/nwui/logs
tar cvzfP /tmp/$(hostname)_$(date -I).tgz /opt/nwui/logs /nsr/nwui/logs /nsr/authc/logs /nsr/logs/daemon.raw /nsr/logs/restapi /nsr/nwui/monitoring/app/logs/ ; chmod 777 /tmp/$(hostname)_$(date -I).tgz ; ls -lth /tmp/$(hostname)_$(date -I).tgz
実行する必要があるWindows NWUIバックエンド プロセスは、nwuictld.exeと呼ばれます。
services.mscが使用するJava Runtime Environmentへのパスを定義します。
NetWorkerサーバー上(ローカル)
C:\Program Files\EMC NetWorker\nwui\logs\C:\Program Files\EMC NetWorker\nsr\authc-server\logsC:\Program Files\EMC NetWorker\nsr\restapi\restapi.logC:\Program Files\EMC NetWorker\nsr\logs\daemon.rawC:\Program Files\EMC NetWorker\nwui\monitoring\app\logs\
C:\Program Files\EMC NetWorker\nwui\logs%LOCALAPPDATA%\TempNetWorker_Management_Web_UI_Server_[TIMESTAMP].log%LOCALAPPDATA%\TempNetWorker_Management_Web_UI_Server_[TIMESTAMP]_0_MCUI.log
NetWorkerサーバーでnsrgetツールを実行して、関連するログを収集します。
「NetWorker:NSRGet NetWorkerデータ コレクション ツールの使用方法」
最も関連性の高いログは、NWUIから試行される操作によって異なります。NetWorkerログの詳細については、次を参照してください。
「NetWorker:ログ ファイルと場所
デバッグ
logback.xml ファイルでデバッグ レベルを変更します。
Windows(デフォルト):
C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linuxの場合
/nsr/authc/webapps/nwrestapi/WEB-INF/classes
詳細については、NetWorker:REST APIデバッグを有効にする方法」を参照してください。
REST API
NWUIは、REST APIを使用してNetWorkerとインターフェイスします。NWUIおよびREST APIのログには、API関数やNetWorkerのレスポンスが示されますが、この情報はブラウザーで直接確認することもできます。この方法は、UIとNetWorker CLI間の不一致を見つける場合や、UIが期待される結果を返さない場合に有用です。
- NWUIにアクセスしている間に、ブラウザーのウィンドウを右クリックし、[Inspect]を選択します。
![[Inspect]](https://supportkb.dell.com/img/ka0Do000000iYINIA2/ka0Do000000iYINIA2_ja_7.jpeg)
- ブラウザーの[Inspect]ウィンドウで、[ Network]タブをクリックします。

- NWUIで操作を実行すると、操作内容は[Name]欄に表示されます。[Status]列には、REST API完了ステータスが表示されます。APIリクエストとレスポンス
- さらに調査したい操作をクリックします。たとえば、上記の[backups]操作をクリックすると、[Headers]タブに以下の詳細が表示されます。


これにより、リクエストURL、リクエスト方法、ステータス コードがすべて識別可能になります。
- レスポンスのペイロードを確認するには、[Responses]タブをクリックします。
この例は、Azureバックアップを参照し、リストア用のセーブ セットを選択した後に、[Recover and Savesets]タブにデータを入力するために使用されるREST APIレスポンスを示しています。
Additional Information
NWUIリソース
「NetWorker Management Web UI (NWUI): 使用方法」
「NetWorker管理Web UI: インストール方法」
「NetWorker Management Web UI (NWUI):トリアージおよびトラブルシューティング ガイド(英語)」