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 伺服器的主機上。


                  kA5f10000004LFmCAM_1_0


有四個重要元件:
這些元件可以位於同一主機上,也可以位於不同的主機上。
  • 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 互動。
  • 認證C:NetWorker 的 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 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 偵錯以進行故障診斷

安裝問題
如需有關如何安裝 NWUI 的詳細資訊,以及在安裝發生問題時要參考哪些記錄,請參閱下列文章:
NetWorker Management Web UI (NWUI):如何安裝
 
瀏覽器端問題
如果安裝了多個瀏覽器,請在不同的瀏覽器中測試觀察到的問題,查看問題是否特定於一個瀏覽器。

在瀏覽器中,使用滑鼠右鍵並「檢查」以查看從瀏覽器進行的 REST API 呼叫以及日誌語句和網路連接資訊。
  • 在瀏覽器視窗的任意位置按一下滑鼠右鍵,然後選取「檢查」
  • 隨即會開啟包含數個標籤的新視窗。  “控制台”和“網络”選項卡可能是最有用的。
  • 使用這些標籤,我們可以看到對 NetWorker 伺服器進行的確切 REST API 呼叫。 
  • 在網路標籤中,我們也可以看到要求方法和來自 NetWorker 伺服器的 REST API 回應。如此一來,我們就能準確追蹤 NetWorker 伺服器的要求,以及 NetWorker 伺服器如何回應此要求。
                  kA5f10000004LFmCAM_1_1
                  kA5f10000004LFmCAM_1_2

 

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 命令檢查它們是否正在執行:
ps -ef | grep nwui
                  kA5f10000004LFmCAM_1_3
記錄在此處:

NetWorker 伺服器本機:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
遠端:
  • /opt/nwui/logs
  • /nsr/nwui/logs                  
視窗

必須執行的 Windows NWUI 後端程序稱為 nwuictld.exe:


                  kA5f10000004LFmCAM_1_5

您可以從 services.msc 管理此服務:

                  kA5f10000004LFmCAM_1_6
 

記錄在此處:

NetWorker 伺服器本機:
  • C:Program FilesEMC NetWorker wuilogs
  • C:Program FilesEMC NetWorker srauthc-serverlogs
  • C:Program FilesEMC NetWorker sr estapi estapi.log
  • C:Program FilesEMC NetWorker srlogsdaemon.raw
遠端: 
  • C:Program FilesEMC NetWorker wuilogs
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[TIMESTAMP].log
  • %LOCALAPPDATA%TempNetWorker_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 FilesEMC NetWorker srauthc-server omcatwebapps wrestapiWEB-INFclasses
Linux:/nsr/authc/webapps/nwrestapi/WEB-INF/classes


                  kA5f10000004LFmCAM_1_7

取消註釋處理 API 調用日誌記錄的行。這會導致 REST API 請求和回應的日誌記錄級別設置為“trace”。

                  kA5f10000004LFmCAM_1_8

其他資訊

受影響的產品

NetWorker

產品

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