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

NWUIの仕組み

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

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サーバーのバージョンとオペレーティング システム プラットフォームは何ですか？NetWorker：NetWorkerソフトウェアのバージョンを識別する方法
  • NWUIはNetWorkerサーバーまたは別のホストにインストールされていますか？
    • NetWorkerサーバーとは別のホストにインストールされている場合、NWUIサーバーのバージョンは何ですか?
  • NWUIサーバーは認証(AUTHC)にローカルNetWorkerサーバーを使用していますか?それとも別のAUTHCサーバーを使用していますか? NetWorker：NMCおよびNWUIで使用されている認証サーバーを特定する方法
  • NWUIサーバーにインストールされているJavaパッケージは何ですか？NetWorkerランタイム環境(NRE)がインストールされていますか、またはOracle Javaランタイム環境(JRE)がインストールされていますか？
    • NRE 8.x: Javaキャッシュをクリアし、Javaコンソールとデバッグを有効にする方法。
    • NRE 17.x: Javaキャッシュをクリアし、Javaコンソールを有効にし、デバッグする方法
• 一般的な問題:
  • 認証の問題: 認証は、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

nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout

• • インストールの問題：NWUIのインストール方法と、インストールで問題が発生した場合に参照するログの詳細については、次の記事を参照してください。「NetWorker Management Web UI (NWUI)：インストール方法」
  • UIバックエンドの問題: 重要なUIバックエンド ログは次のとおりです。

NWUIサーバーがNetWorkerサーバー自体にある場合は、同じtomcatインスタンスをNetWorkerと共有します。

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

ログ ファイル：

Linuxの場合

UIバックエンドで実行されるプロセスは、code>/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/
• リモート (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

Windows

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

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

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

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

次のコマンド： 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

3. NWUIサービスを再起動します。

• Linuxの場合 systemctl restart nwui
• Windows (PowerShell)の場合： net stop nwui ; net start nwui

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

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

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

2. ブラウザーの［Inspect］ウィンドウで、［ Network］タブをクリックします。

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

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

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

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

NWUIリソース

• 「NetWorker Management Web UI (NWUI)：使用方法             
• 「NetWorker Management Web UI (NWUI)：インストール方法」          
• 「NetWorker Management Web UI (NWUI)：トリアージおよびトラブルシューティング ガイド（英語）」