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

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の内部操作です。これらを、カスタム操作を可能にするNetWorker REST APIと混同しないようにしてください。このAPIについては、『NetWorker REST API Developer Guide』に記載されています。


トラブルシューティング

問題の定義

  • 問題の詳細:問題の完全な説明を生成するには、次の質問を検討してください。
    • どの操作が試行され、正常に機能していませんか?
    • この操作は、NWUIの外部から実行した場合には機能しますか?(例:NetWorker Management Console (NMC)から開始した場合)
    • 問題は常に発生するのか、それとも断続的ですか?
    • 断続的な場合、既知のトリガーはありますか?
    • 以前は正常に機能していましたか?その場合、問題発生前後で変更がありましたか?
    • この問題が最初に発生したのはいつですか(問題発生以降に何か変更されたか)?
    • この問題は、バックアップ環境に負荷が高いときにのみ発生しますか?
    • 問題の範囲はどの程度ですか(すべてのリカバリー操作か、一部のリカバリー操作のみか、一部のタブが機能せず他は影響なしか)?
    • これまでに試した処理内容と、そこから得られた結論は何ですか?
  • 環境の詳細: 
  • 一般的な問題:
    • 認証の問題: 認証は、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 Management 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 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サーバー自体にある場合は、同じtomcatインスタンスをNetWorkerと共有します。

お客様が .raw ログ ファイルをサポートに提供する場合は、ログ ファイルを生成元のシステム上でレンダリングすることをお勧めします。これにより、タイムスタンプがサーバーの現地時間で正しく表示されます。NetWorker:nsr_render_logの使用方法(英語)」を参照してください。


ログ ファイル:

Linuxの場合

UIバックエンドで実行されるプロセスは、code>/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)でバンドルを自動的に作成します。「NetWorker (Linux):Linux NetWorkerサーバーとの間でファイルをコピーする方法」


Windows

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

nwuiサービスを表示しているタスク リスト

これは、次の場所から管理できます: services.mscファイルに置き換えます。

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サーバー

次のコマンド: NSRGET ツールを使用して、関連するログを収集します。NetWorker:NSRGet NetWorkerデータ コレクション ツールの使用方法 

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


デバッグ

NWUIのログ レベルは、次のファイルで定義されます。

  • Windows(デフォルト): C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwui\WEB-INF\classes\logback.xml
  • Linuxの場合 /nsr/authc/webapps/nwui/WEB-INF/classes/logback.xml
  1. [ maxFileSize from 20MB の出力を 100MB
  2. [Change]を root level from INFO の出力を DEBUG
NWUIデバッグ設定
  1. NWUIサービスを再起動します。
  • Linuxの場合 systemctl restart nwui
  • Windows (PowerShell)の場合: net stop nwui ; net start nwui

 

注:一部のシナリオでは、REST APIデバッグも有効にする必要があります。詳細については、NetWorker:REST APIデバッグを有効にする方法」を参照してください。

Webブラウザー検査コンソール。

NWUIはAPI関数とNetWorker応答を使用しますが、この情報はブラウザーで直接確認することもできます。この方法は、UIとNetWorker CLI間の不一致を見つける場合や、UIが期待される結果を返さない場合に有用です。 

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

Web ブラウザーの検査

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

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

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

 

「backup」のヘッダーの詳細

「バックアップ」のヘッダーの詳細(続き)

これにより、リクエスト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 يونيو 2026
Version:  8
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.