NetWorker Management Web UI (NWUI):分級與故障診斷指南

摘要: NetWorker Management Web UI (NWUI):分級與故障診斷指南

本文章適用於 本文章不適用於 本文無關於任何特定產品。 本文未識別所有產品版本。

說明

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 編寫的展示層,透過網頁瀏覽器向使用者呈現 NetWorker 的操作。網頁瀏覽器連線至 UI 後端程序。
  • UI 後端  後端應用程式使用 Spring 架構編寫。  使用 java 和 Apache Tomcat。前端與後端之間的通訊,以及後端和 NetWorker 伺服器之間的通訊皆是使用內部 REST API 呼叫完成。NWUI 程序會使用 NetWorker 伺服器上現有的 Apache Tomcat 執行個體,若是從 NetWorker 伺服器遠端安裝,則會安裝其專屬的 Apache Tomcat 執行個體。
  • NetWorker 伺服器NetWorker 伺服器的 REST 架構負責接收來自 UI 後端的 REST API 呼叫,並將其連接至 NetWorker Server 的核心元件。NetWorker 伺服器的 RabbitMQ 訊息匯流排也用於與 nsrjobd 互動。
  • AUTHC:NetWorker 的 AUTHC 元件用於滿足所有驗證需求。請求程序會聯繫 AuthC 以驗證憑證,驗證後,AuthC 會發出一個具有時效性、經過簽署的加密權杖。NetWorker 元件會使用此權杖來驗證使用者,並決定是否授權所要求的操作。這通常位於 NetWorker 伺服器上,但也可以安裝在獨立的主機上。 
大部分通訊使用 REST API ,以允許與由統一資源識別項 (URI) 位址識別的資源互動。這個功能使用 HTTP 的動詞 (HEAD、GET、PUT、POST、DELETE),以無狀態的方式與統一資源識別項 (URI) 互動。這些 REST API 呼叫是 NetWorker 和 NWUI 的內部作業。

a { text-decoration: none; color: #464feb; } tr th, tr td { border: 1px solid #e6e6e6; } tr th { background-color: #f5f5f5; } 請勿將此與 NetWorker REST API 混淆,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 命令相同。針對驗證問題,請先在 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 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 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 可以透過 ps 命令檢查其是否在運作中:
ps -ef | grep nwui
                  ps 輸出結果顯示 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
注意:視 NWUI 是在 NetWorker 伺服器的本機或遠端位置,上述命令可能會將某些目錄回報為遺失。這與期望相符。不需要變更主機名稱和日期,上述命令會自動建立包含伺服器主機名稱和目前日期 (YYYY-MM-DD) 的套裝。
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 伺服器

在 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 時,在瀏覽器視窗中按一下滑鼠右鍵,然後選取檢查

檢查

  1. 在瀏覽器的「檢查」視窗中,按一下網路標籤:

瀏覽器檢查網路

  1. 在 NWUI 中執行功能時,操作會顯示在名稱下。「狀態」欄包含 REST API 的完成狀態:API 要求與回應 
  2. 按一下要進一步調查的作業。例如,按一下上方顯示的備份功能,標題標籤中將會顯示以下詳細資料:

您可以在此識別要求 URL、要求方法和狀態代碼。

  1. 若要查看回應裝載,請按一下回應標籤。

 

此範例展示在瀏覽 Azure 備份並選取要還原的儲存集後,填入還原與儲存集標籤內的 REST API 回應。

其他資訊

受影響的產品

NetWorker

產品

NetWorker, NetWorker Series
文章屬性
文章編號: 000010592
文章類型: How To
上次修改時間: 19 12月 2025
版本:  5
向其他 Dell 使用者尋求您問題的答案
支援服務
檢查您的裝置是否在支援服務的涵蓋範圍內。