NetWorker Management Web UI：分級與故障診斷指南

NWUI 的運作方式

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

有四個重要組成部分。這些元件可以位於同一主機上，也可以位於不同的主機上。

• 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 的內部作業。請勿將這些與 NetWorker REST API 混淆，後者可啟用自訂作業，並記錄在 NetWorker REST API 開發人員指南中。

故障診斷

定義問題

• 問題詳細資料：為了生成完整的問題描述，請考慮以下問題：
  • 您正在嘗試哪一項無法運作的操作？
  • 從 NWUI 外部啟動時，此作業是否可運作 (例如：從 NetWorker Management Console (NMC) 啟動時)？
  • 此問題是持續發生或間歇性的？
  • 如果是間歇性的，是否有已知的觸發原因？
  • 之前的運作是否比較順暢？如果是，在問題出現之前和之後是否套用了任何已知的變更？
  • 第一次發生問題是什麼時候，以及問題出現後進行了什麼變更？
  • 此問題是否僅會在備份環境負載過重時才會發生？
  • 問題的範圍為何 (發生在所有復原作業或某些復原作業上？某些標籤無法運作，而其他的不受影響)？
  • 目前為止嘗試過哪些修復方法，並從中得出了什麼結論？

• 環境詳細資料： 
  • NetWorker 伺服器的版本與作業系統平台為何？NetWorker：識別 NetWorker 軟體版本的方法
  • NWUI 是安裝在 NetWorker 伺服器上，還是獨立的主機上？
    • 如果安裝在與 NetWorker 伺服器分開的主機上，NWUI 伺服器版本是什麼？
  • NWUI 伺服器是使用本機 NetWorker 伺服器進行驗證 （AUTHC），還是使用個別的 AUTHC 伺服器：NetWorker：如何識別哪個伺服器是 NMC 和 NWUI 使用的認證伺服器
  • NWUI 伺服器上安裝了哪些 Java 套件，是否已安裝 NetWorker Runtime Environment (NRE) 或 Oracle Java Runtime Environment (JRE)。
    • NRE 8.x：如何清除 Java 快取、啟用 Java 主控台和除錯。
    • NRE 17.x：如何清除 Java 快取、啟用 Java 主控台和除錯
• 常見問題：
  • 驗證問題：驗證使用 AUTHC，的方式與 NetWorker Management Console 和 nsrlogin 命令為貴組織設定主要和次要 IT 連絡人。
    針對驗證問題，請先在 NetWorker 伺服器上測試驗證，以判斷問題與 NWUI 或伺服器本身相關。如果使用 AD 或 LDAP 進行認證，請先使用本機 NetWorker 帳戶進行測試，確認問題是否只會影響外部認證。
    用來測試驗證程序是否如預期在 NetWorker 伺服器上運作的一般命令如下： 

authc_mgmt -u [user name] -p [password] -e find-all-users.

nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout

nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout

• • 安裝問題：如需有關如何安裝 NWUI 的詳細資訊，以及在安裝發生問題時要參考哪些記錄，請參閱下列文章：NetWorker Management Web UI (NWUI)：如何安裝
  • UI 後端問題：重要的 UI 後端記錄包括：

如果 NWUI 伺服器位於 NetWorker 伺服器本身上，則會與 NetWorker 共用相同的 tomcat 例項。

如果您要提供 .raw 記錄檔作為支援，建議您在來源系統上生成記錄檔。這可確保時間戳記能以伺服器的當地時間呈現：NetWorker：如何使用 nsr_render_log

記錄檔：

Linux：

為 UI 後端執行的程序包括：code>/opt/nwui/bin/nwuictld 和 jsvc.exec。您可以檢查 TPM 是否正在使用 ps 命令：

ps -ef | grep 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

Windows

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

若要管理此項目，請從 services.msc：

記錄在這裡：

• 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 伺服器

執行 NSRGET 工具以收集 NetWorker 伺服器的相關記錄：NetWorker：如何使用 NSRGet NetWorker 資料收集工具 

最相關的記錄取決於從 NWUI 嘗試的操作。如需更多有關 NetWorker 記錄的資訊，請參閱：NetWorker：記錄檔和位置

偵錯

NWUI 紀錄層級在以下檔案中定義：

• Windows (預設)： C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwui\WEB-INF\classes\logback.xml
• Linux： /nsr/authc/webapps/nwui/WEB-INF/classes/logback.xml

1. 增加 maxFileSize from 20MB 的輸出傳送至 100MB
2. 變更 root level from INFO 的輸出傳送至 DEBUG

3. 重新啟動 NWUI 服務：

• Linux： systemctl restart nwui
• Windows (PowerShell)： net stop nwui ; net start nwui

網頁瀏覽器檢查主控台。

NWUI 使用 API 功能和 NetWorker 回應，但此資訊也可以直接在瀏覽器中檢查。在尋找 UI 和 NetWorker CLI 之間的差異，或是當 UI 無法傳回預期結果時，這個方法十分實用。 

1. 存取 NWUI 時，在瀏覽器視窗中按一下滑鼠右鍵，然後選取檢查。

2. 在瀏覽器的「檢查」視窗中，按一下網路標籤：

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

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

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

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

NWUI 資源

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