Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Create and access a list of your products

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.

Instructions

NWUI 的運作方式

NetWorker Web 使用者介面 (NWUI) 使用下列技術:HTML5、Apache Tomcat、Spring Framework、Angular Framework,以及代表狀態傳輸 (REST) 應用程式設計介面 (API)。NWUI 應用程式可安裝在Linux或 Windows 作業系統上。它可以直接安裝在 NetWorker 伺服器或非 NetWorker 伺服器的主機上

                  kA5f10000004LFmCAM_1_0

有四個重要元件:
這些元件可位於同一主機上或個別主機上。
  • Web 前端:  這是以 HTML5 和 Angular Framework 寫入的簡報層,透過網頁瀏覽器向使用者呈現 NetWorker 作業。網頁瀏覽器已連接至UI後端程式。
  • UI 後端  後端應用程式會以 Spring Framework 寫入。  它使用 Java 和 Apache Tomcat。前端和後端之間,以及後端和 NetWorker 伺服器之間的通訊,是使用內部 REST 應用程式發展介面呼叫完成。NWUI 程式會使用 NetWorker 伺服器上的現有 Apache Tomcat 實例,或是從 NetWorker 伺服器遠端安裝自己的 Apache Tomcat 實例。
  • NetWorker 伺服器NetWorker Server 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 應用程式發展介面呼叫是 NetWorker 和 NWUI 作業的內部。對於 NetWorker REST API 開發人員 指南中所述的 NetWorker REST API 介面,其提供 NetWorker 程式化存取權以進行程式化的自定義作業,這些介面並不會混淆。
 

故障診斷

定義問題

問題詳細數據
若要產生完整的問題說明,請考慮下列問題:
  • 正在嘗試執行哪些無法運作的作業?
  • 從外部 NWUI 起始時,此作業是否正常運作 (例如:從 NetWorker 管理控制台 (NMC))?
  • 問題是否一致或間歇性?
  • 如果有間歇性,是否有已知的觸發?
  • 此功能是否在問題出現前後效果更好?如果有套用任何已知的變更?
  • 問題第一次發生的時間 (以及問題出現后的變更)?
  • 問題是否只有在備份環境負載沉重時才會發生?
  • 問題的範圍為何 (所有復原作業/部分復原作業、某些標籤在其他未受影響的情況下無法運作)?
  • 到目前為止,我們已嘗試進行哪些修正,並從中得出了哪些結論?

環境詳細數據
  • 什麼是 NetWorker 伺服器版本和作業系統平臺?
  • NWUI 是安裝在 NetWorker 伺服器或個別主機上?
    • 如果安裝在與 NetWorker 伺服器分開的主機上,那麼 NWUI 版本為何?
  • 在 NWUI 伺服器上安裝的 Java 套裝;是已安裝 NetWorker Runtime Environment (NRE) 或 Oracle Java Runtime Environment (JRE)。
認證
驗證使用 AuthC 的方式與 NetWorker 管理控制台和 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):如何安裝
 
瀏覽器端問題
如果安裝了多個瀏覽器,請在不同的瀏覽器中測試觀察到的問題,以查看該問題是否適用於一個瀏覽器。

在瀏覽器中,使用滑鼠右鍵和「檢查」來查看瀏覽器發出的 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 應用程式發展介面記錄。  NWUI 是使用 NetWorker REST 應用程式發展介面與 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 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

                   kA5f10000004LFmCAM_1_7
取消批注處理 API 呼叫記錄的行。這會導致記錄層級設為「trace」以取得 REST API 要求和回應。
                   kA5f10000004LFmCAM_1_8

Additional Information

Affected Products

NetWorker

Products

NetWorker, NetWorker Series
Article Properties
Article Number: 000010592
Article Type: How To
Last Modified: 19 Jan 2024
Version:  3
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.