「NetWorker Management Web UI (NWUI):トリアージおよびトラブルシューティング ガイド(英語)」

Summary: 「NetWorker Management Web UI (NWUI):トリアージおよびトラブルシューティング ガイド(英語)」

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

NWUIの仕組み

NetWorker Webユーザー インターフェイス(NWUI)は、次のテクノロジーを使用します。HTML5、Apache Tomcat、Spring Framework、Angular Framework、Representational State Transfer (REST) アプリケーション プログラミング インターフェイス (API)。NWUIアプリケーションは、LinuxまたはWindowsオペレーティング システムにインストールできます。これは、NetWorkerサーバーに直接インストールすることも、NetWorkerサーバーではないホストにインストールすることもできます


                  NWUIのコンポーネント 


次の4つの重要な要素があります
これらのコンポーネントは、同じホスト上に置くことも、別々のホスト上に置くこともできます。
  • Web フロントエンド:  これは、HTML5およびAngular Frameworkで記述されたプレゼンテーション層であり、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サーバー上にありますが、別のホストにインストールすることもできます。 
ほとんどの通信ではREST APIを使用しており、これにより、Uniform Resource Identifier(URI)アドレスで識別されるリソースとのやり取りが可能になります。HTTP 動詞 (HEAD、GET、PUT、POST、DELETE) を使用して、ステートレスな方法で Uniform Resource Identifiers (URI) と対話します。これらのREST APIコールは、NetWorkerおよびNWUIの内部操作です。

a { text-decoration: none; color: #464feb;} tr th, tr td { border: 1pxソリッド #e6e6e6;} tr th {背景色: #f5f5f5;} これらを、カスタム操作を可能にするNetWorker REST APIと混同しないようにしてください。このAPIについては、『NetWorker REST API開発者ガイド』に記載されています。

トラブルシューティング

問題の定義

問題の詳細
問題の完全な説明を生成するには、次の質問を検討してください。
  • 試行されていて、正常に機能していない操作は何ですか?
  • この操作は、NWUIの外部から開始された場合に機能しますか(例: NetWorker Management Console (NMC)からですか?
  • 問題は一貫性がありますか、それとも断続的ですか?
  • 断続的な場合、既知のトリガーはありますか?
  • 以前は問題の方が問題ありませんでしたか?改善した場合は、問題が発生する前後に既知の変更が適用されていますか?
  • 問題が最初に発生したのはいつですか (また、問題が発生してから何が変わりましたか)
  • この問題は、バックアップ環境の負荷が高い場合にのみ発生しますか?
  • 問題の範囲(すべてのリカバリー操作または一部のリカバリー操作、一部のタブが機能しないが、他のタブは影響を受けない)は何ですか?
  • これまで何を修正しようと試みられ、そこからどのような結論が導き出されたのでしょうか?

環境の詳細
  • NetWorkerサーバーのバージョンとオペレーティング システム プラットフォームは何ですか?
  • NWUIはNetWorkerサーバーまたは別のホストにインストールされていますか?
    • NetWorkerサーバーとは別のホストにインストールされている場合、NWUIのバージョンは何ですか?
  • NWUIサーバーにインストールされているJavaパッケージ。インストールされているNetWorkerランタイム環境(NRE)またはOracle Java Runtime Environment (JRE)です。
認証
認証では、NetWorker Management Consoleと同様にAUTHCを使用し、 nsrlogin に指定します。認証の問題については、まずNetWorkerサーバーで認証をテストして、問題がNWUIまたはサーバー自体に関連しているかどうかを判断します。認証にADまたはLDAPを使用している場合は、まずローカルのNetWorkerアカウントを使用してテストし、問題が外部認証にのみ影響するかどうかを確認します。

NetWorkerサーバーで認証プロセスが正常に機能しているかどうかをテストするために使用される一般的なコマンドは次のとおりです。  
authc_mgmt -u [user name] -p [password] -e find-all-users.

または

ローカルNetWorkerアカウント:

nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
外部(AD/LDAP)アカウント:
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
 
NetWorkerセキュリティ構成ガイドには、NetWorker認証の仕組み、テスト方法、および必要に応じてパスワードをリセットする方法の詳細が記載されています。

さらに認証診断が必要な場合は、次を参照してください。  NetWorker:トラブルシューティングのためにAUTHC DEBUGを有効にする方法

インストールの問題:
NWUIのインストール方法と、インストールで問題が発生した場合に参照するログの詳細については、次の記事を参照してください。
NetWorker管理Web UI (NWUI): インストール方法                   

 

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の使い方

ログ ファイル

Linuxの場合

UIバックエンドで実行されるプロセスは次のとおりです。  /opt/nwui/bin/nwuictld と jsvc.exec が実行されているかどうかは、 ps コマンドを使用して実行できます。
ps -ef | grep nwui
                  NWUIバックエンドを示すps出力 
ログは次の場所にあります。

NetWorkerサーバーのローカル:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
  • /nsr/nwui/monitoring/app/logs/
リモート(NWUIサーバーがNetWorkerサーバーとは別のホスト上にある):
  • /opt/nwui/logs
  • /nsr/nwui/logs   
次のコマンドを使用して、これらのログのzipを作成できます
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
メモ: NWUIがNetWorkerサーバーに対してローカルであるかリモートであるかに応じて、上記のコマンドで一部のディレクトリーが見つからないと報告される場合があります。これは予期されることです。ホスト名と日付を変更する必要はありません。上記のコマンドは、サーバーのホスト名と現在の日付(YYYY-MM-DD)を使用してバンドルを自動的に作成します。
Windows

実行する必要があるWindows NWUIバックエンド プロセスは、nwuictld.exeと呼ばれます。


                  NWUIサービスを示すタスクリスト 

これは、次の場所から管理できます。 services.mscが使用するJava Runtime Environmentへのパスを定義します。

                  NWUIが表示されたサービス コンソール 
 

ログは次の場所にあります。

NetWorkerサーバーのローカル
  • C:\Program Files\EMC NetWorker\nwui\logs\
  • C:\Program Files\EMC NetWorker\nsr\authc-server\logs
  • C:\Program Files\EMC NetWorker\nsr\restapi\restapi.log
  • C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw
  • C:\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インストール パスです。NetWorkerが別のドライブにインストールされていたり、別のパスを使用してインストールされていた場合は、それに応じて調整します。
 
NetWorkerサーバー

NetWorkerサーバーでnsrgetツールを実行して、関連するログを収集します
Networker:NSRGet NetWorkerデータ コレクション ツールの使用方法

最も関連性の高いログは、NWUIから試行される操作によって異なります。NetWorkerログの詳細については、次を参照してください
Networker:ログ ファイルと場所

デバッグ

REST API通信をデバッグするには、でデバッグ レベルを変更します logback.xml NetWorkerサーバー上のファイル:

Windows(デフォルト):
C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linuxの場合 /nsr/authc/webapps/nwrestapi/WEB-INF/classes


                  ログバック・ファイル (logback file) 

APIコール ログを扱う行のコメントを解除します。これにより、REST API要求と応答のログ レベルが「trace」に設定されます。

                  デバッグ設定 

詳細については、NetWorker:REST APIデバッグを有効にする方法

 

REST API

NWUIは、REST APIを使用してNetWorkerとインターフェイスします。NWUIおよびREST APIログには、API関数とNetWorkerの応答が表示されますが、この情報はブラウザーで直接確認することもできます。この方法は、UIとNetWorker CLI間の不一致を見つけた場合や、UIが予期した結果を返さない場合に便利です。 

 

  1. NWUIにアクセスしているときに、ブラウザー ウィンドウで右クリックし、[ 検査]を選択します。

検査

  1. ブラウザーの[Inspect]ウィンドウで、[ Network ]タブをクリックします。

ブラウザのネットワーク検査

  1. NWUIで機能を実行する場合、操作は 名前の下に表示されます。[Status]列には、REST APIの完了ステータスが表示されます。API要求と応答 
  2. さらに調査する操作をクリックします。たとえば、上記の バックアップ 機能をクリックすると、[ Headers ]タブに次の詳細が表示されます。

このことから、要求 URL、要求方法、および状態コードがすべて識別できます。

  1. 応答ペイロードを表示するには、[ 応答 ] タブをクリックします。

 

この例は、Azureバックアップを参照し、リストア用のセーブセットを選択した後に、[ リカバリーとセーブセット ]タブにデータを入力するために使用されるREST API応答を示しています。

Additional Information

Affected Products

NetWorker

Products

NetWorker, NetWorker Series
Article Properties
Article Number: 000010592
Article Type: How To
Last Modified: 19 Dec 2025
Version:  5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.