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.
Check out other resources

Instructions

NWUI 的運作方式

NetWorker Web 使用者介面 （NWUI） 使用下列技術：HTML5、Apache Tomcat、Spring Framework、Angular Framework 和 Representational State Transfer （REST） 應用程式程式設計介面 （API）。NWUI 應用程式可安裝在 Linux 或 Windows 作業系統上。它可以直接安裝在 NetWorker 伺服器上，也可以安裝在非 NetWorker 伺服器的主機上。


                  NWUI 的元件 


有四個重要元件：
這些元件可以位於同一主機上，也可以位於不同的主機上。
  • Web 前端：  這是用HTML5和Angular Framework編寫的表示層，它通過Web瀏覽器向使用者提供NetWorker 操作。網頁瀏覽器已連接至 UI 後端程序。
  • UI 後端：  後端應用程式是用 Spring 框架編寫的。  它使用java和Apache Tomcat。前端和後端之間以及後端和 NetWorker 伺服器之間的通訊是使用內部 REST API 呼叫來完成。NWUI 程序會使用 NetWorker 伺服器上現有的 Apache Tomcat 例項，或者安裝其自己的 Apache Tomcat 例項 （若是從 NetWorker 伺服器遠端安裝）。
  • NetWorker 伺服器：NetWorker 伺服器 REST 框架負責從 UI 後端接收 REST API 呼叫，並將其連接至 NetWorker 伺服器的核心元件。NetWorker Server RabbitMQ 訊息匯流排也用於與 nsrjobd 互動。
  • AUTHC：NetWorker 的 AUTHC 元件用於滿足所有驗證需求。請求進程聯繫身份驗證以驗證憑據;驗證后，AuthC 會頒發基於、簽名和加密的時間令牌。NetWorker 元件使用此權杖來驗證使用者，並授權或不授權所要求的操作。這通常位於 NetWorker 伺服器上，但也可以安裝在單獨的主機上。 
大部分通訊使用 REST API，這允許與統一資源識別碼 （URI） 位址標識的資源互動。它使用 HTTP 謂詞（HEAD、GET、PUT、POST、DELETE）以無狀態方式與統一資源標識碼 （URI） 交互。這些 REST API 呼叫是 NetWorker 和 NWUI 作業的內部。

a { 文字修飾：無;顏色：#464feb;} tr th， tr td { border：1px 純 #e6e6e6;} tr th { background-color：#f5f5f5;} 請勿將這些與 NetWorker REST API 混淆，後者可啟用自訂作業，並記錄在 NetWorker REST API 開發人員指南中。

故障診斷

定義問題

問題詳細資料
為了生成完整的問題描述，請考慮以下問題：
  • 正在嘗試什麼操作但無效？
  • 從 NWUI 外部啟動時，此作業是否有效 （例如：是否為從 NetWorker Management Console （NMC）？
  • 問題是持續性的或間歇性的？
  • 如果是間歇性的，是否有已知的觸發因素？
  • 這在問題出現之前是否效果更好，如果有，在問題出現之前和之後是否有任何已知的更改應用？
  • 問題何時首次發生（以及自問題出現以來發生了什麼變化）？
  • 是否僅在備份環境負載過重時才會發生此問題？
  • 問題的範圍是什麼（所有恢復操作或某些恢復操作，某些選項卡不起作用，而其他選項卡不受影響）？
  • 到目前為止，試圖解決什麼問題，從中得出了什麼結論？

環境詳細資料
  • 什麼是 NetWorker 伺服器版本和作業系統平台？
  • NWUI 是安裝在 NetWorker 伺服器還是單獨的主機上？
    • 如果安裝在與 NetWorker 伺服器分開的主機上，NWUI 版本會是什麼？
  • NWUI 伺服器上安裝了哪些 Java 套件;是否已安裝 NetWorker Runtime Environment （NRE） 或 Oracle Java Runtime Environment （JRE）。
認證
驗證使用 AUTHC，的方式與 NetWorker Management Console 和 nsrlogin 命令為貴組織設定主要和次要 IT 連絡人。針對驗證問題，請先在 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 偵錯以進行故障診斷

安裝問題
如需有關如何安裝 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 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 您可以 檢查 TPM 是否正在使用 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 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 伺服器

在 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


                  登入檔案 

取消註釋處理 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. 在瀏覽器的「檢查」視窗中，按兩下 網路 選項卡：

瀏覽器檢查網路

  1. 在 NWUI 中執行功能時，操作會顯示在 「名稱」 下。「狀態」欄包含 REST API 完成狀態：API 要求與回應 
  2. 按兩下要進一步調查的操作。例如，單擊上面顯示 的備份 功能，「 標題 」選項卡中將顯示以下詳細資訊：

由此，請求 URL、請求方法和狀態代碼都是可識別的。

  1. 要查看回應有效負載，請按兩下 回應 選項卡。

 

此示例演示在流覽 Azure 備份並選擇要還原的存儲集後，用於填充 “恢復”和“存儲集 ”選項卡的 REST API 回應。

Additional Information

NWUI 資源

NetWorker Management Web UI (NWUI)：  如何使用             
NetWorker Management Web UI （NWUI）：  如何安裝          
NetWorker Management Web UI （NWUI）：分級與故障診斷指南

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.