「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) Application Programming Interface (API)。NWUIアプリケーションは、LinuxまたはWindowsオペレーティング システムにインストールできます。これは、NetWorkerサーバーに直接インストールすることも、NetWorkerサーバー以外のホストにインストールすることもできます。


                  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サーバー上にありますが、別のホストにインストールすることもできます。 
ほとんどの通信では、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 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)がインストールされていますか?
認証
認証は、NetWorker Management Consoleや 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
外部(AD/LDAP)アカウント:
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
 
NetWorkerセキュリティ構成ガイド』には、NetWorker認証の仕組み、テスト方法、および必要に応じてパスワードをリセットする方法の詳細が記載されています。

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

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

 

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
                  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通信をデバッグするには、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


                  logbackファイル 

APIコール ログに関する行のコメントを解除します。これにより、REST APIのリクエストとレスポンスのログ レベルが「trace」に設定されます。

                  デバッグ設定 

詳細については、NetWorker:REST APIデバッグを有効にする方法」を参照してください。

 

REST API

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

 

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

[Inspect]

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

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

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

これにより、リクエストURL、リクエスト方法、ステータス コードがすべて識別可能になります。

  1. レスポンスのペイロードを確認するには、[Responses]タブをクリックします。

 

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

Additional Information

Affected Products

NetWorker

Products

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