NWUIの仕組み
NetWorker Webユーザー インターフェイス(NWUI)は、次のテクノロジーを使用します。HTML5、Apache Tomcat、Spring Framework、Framework、Representational State Transfer(REST)アプリケーション プログラミング インターフェイス(API)。NWUIアプリケーションは、LinuxまたはWindowsオペレーティング システムにインストールできます。NetWorkerサーバーに直接インストールすることも、NetWorkerサーバーではないホストにインストールすることもできます。
次の4つの重要なコンポーネントがあります。
これらのコンポーネントは、同じホストまたは別のホストに配置できます。
- Webフロントエンド: これは、Html5およびSanger 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 Server RabbitMQメッセージ バスは、nsrjobdとの対話にも使用されます。
- AuthC: NetWorkerのauthcコンポーネントは、すべての認証ニーズに使用されます。要求プロセスはAuthCに連絡して認証情報を確認します。検証時に、AuthCは、一度に一度に、ベース、署名済み、暗号化されたトークンを発行します。NetWorkerコンポーネントは、このトークンを使用してユーザーを検証し、リクエストされた操作を承認または許可しません。これは通常、NetWorkerサーバー上に存在しますが、別のホストにインストールできます。
ほとんどの通信はREST APIを使用
しており、URI(統一リソース識別子)アドレスで識別されたリソースとやり取りできます。HTTP動詞(HEAD、GET、PUT、POST、DELETE)を使用して、ステートレスな方法で統一リソース識別子(URI)とやり取りします。これらのREST APIコールは、NetWorkerおよびNWUI操作の内部です。NetWorker REST API開発者ガイド で説明されているカスタムビルド操作をプログラミングするためにNetWorkerへのプログラム アクセスを提供するNetWorker REST APIインターフェイスと混同しないでください。
トラブルシューティング
問題の定義
問題の詳細
完全な問題の説明を生成するには、次の質問を考慮してください。
- 動作していない操作は何ですか?
- この操作は、NWUIの外部から開始された場合に機能しますか(例: NetWorker管理コンソール(NMC)から?
- 問題は一貫していますか、または断続的ですか?
- 断続的な場合、既知のトリガーはありますか?
- 問題が発生する前と後に、既知の変更が適用される前と後に、この機能は改善されましたか?
- 問題が最初に発生した時期(および問題が発生してから何が変更されましたか)?
- この問題は、バックアップ環境に大きな負荷がかかる場合にのみ発生しますか?
- 問題の範囲は何ですか(すべてのリカバリー操作/一部のリカバリー操作、一部のタブは機能しない、他のタブは影響を受けません)?
- これまでに解決するために試みられた内容と、そこから得られた結論は何ですか。
環境の詳細
- NetWorkerサーバーのバージョンとオペレーティング システム プラットフォームは何ですか?
- NWUIはNetWorkerサーバーまたは別のホストにインストールされていますか?
- NetWorkerサーバーとは別のホストにインストールされている場合、NWUIのバージョンは何ですか?
- NWUIサーバにインストールされるJavaパッケージは、NetWorker Runtime Environment(NRE)がインストールされているか、Oracle Java Runtime Environment(JRE)です。
認証
認証では、NetWorker管理コンソールおよび
nsrlogin コマンドと同じ方法でAuthCを使用します。認証の問題については、まず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
インストールの問題:
ブラウザー側の問題
複数のブラウザがインストールされている場合は、異なるブラウザで観察された問題をテストして、問題が1つのブラウザに固有であるかどうかを確認します。
ブラウザで、右クリックして「inspect」を使用して、ブラウザから行われたREST APIコールと、ログ ステートメントとネットワーク接続情報を確認します。
- ブラウザ ウィンドウ内の任意の場所を右クリックし、[inspect]を選択します。
- 新しいウィンドウが開き、いくつかのタブが表示されます。 [Console]タブと[Network]タブが最も便利です。
- これらのタブを使用すると、NetWorkerサーバーに対して行われている正確なREST APIコールを確認できます。
- [Network]タブでは、NetWorkerサーバーからのリクエスト方法とREST API応答も確認できます。このようにして、NetWorkerサーバーの要求内容と、NetWorkerサーバーがこのリクエストにどのように応答しているかを正確にトレースできます。
UIバックエンドの問題
重要なUIバックエンド ログは次のとおりです。
catalina.log :Tomcatサーバーのログとアプリケーション導入ログ。
nwui.log:NWUIアプリケーション サーバーのログ。
restapi.log:NetWorker REST APIログ。 NWUIは、NetWorker REST APIを使用してNetWorkerサーバーと通信します。
daemon.raw:NetWorkerサーバーログ。
これらのログ ファイルの場所は、使用されているオペレーティング システムに加え、NWUIのインストールがNetWorkerサーバーに対してローカルであるかリモートであるかによって異なります。 NWUIがNetWorkerサーバー自体にある場合は、NetWorkerと同じtomcatインスタンスを共有します。
サポートする.raw ログ ファイルを提供する場合は、ログ ファイルを生成元のシステムに表示することをお勧めします。これにより、サーバーのローカル時間にタイムスタンプが表示されます。
NetWorker:nsr_render_log
の使用方法
ログ ファイル
Linuxの場合
UIバックエンドで実行されるプロセスは次のとおりです。 /opt/nwui/bin/nwuictldおよびjsvc.exec psコマンドで実行されているかどうかを確認できます。
ログは次のとおりです。
NetWorkerサーバーへのローカル:
- /opt/nwui/logs
- /nsr/authc/logs/
- /nsr/logs/restapi/restapi.log
- /nsr/logs/daemon.raw
リモート:
- /opt/nwui/logs
- /nsr/nwui/logs
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\logs
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[TIMESTAMP].log
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[TIMESTAMP]_0_MCUI.log
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
APIコール ログを処理する行のコメントを解除します。これにより、REST APIのリクエストとレスポンスのログ レベルが「trace」に設定されます。