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編寫的表示層,它通過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 回應。

其他資訊

受影響的產品

NetWorker

產品

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