NetWorker Management Web UI (NWUI):分級與故障診斷指南
摘要: NetWorker Management Web UI (NWUI):分級與故障診斷指南
說明
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 伺服器上,但也可以安裝在獨立的主機上。
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)。
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
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
如果需要進一步的驗證診斷,請參閱: NetWorker:如何啟用 AUTHC DEBUG 以進行故障診斷
安裝問題
NetWorker Management Web UI (NWUI):如何安裝
重要的 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
NetWorker 伺服器本機:
/opt/nwui/logs/nsr/authc/logs//nsr/logs/restapi/restapi.log/nsr/logs/daemon.raw/nsr/nwui/monitoring/app/logs/
/opt/nwui/logs/nsr/nwui/logs
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 NWUI 後端程序稱為 nwuictld.exe:
services.msc管理:
NetWorker 伺服器本機
C:\Program Files\EMC NetWorker\nwui\logs\C:\Program Files\EMC NetWorker\nsr\authc-server\logsC:\Program Files\EMC NetWorker\nsr\restapi\restapi.logC:\Program Files\EMC NetWorker\nsr\logs\daemon.rawC:\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:如何使用 NSRGet NetWorker 資料收集工具
最相關的記錄取決於從 NWUI 嘗試進行的操作。如需更多有關 NetWorker 記錄的資訊,請參閱:
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
請參閱:NetWorker:如何啟用 REST API 偵錯
REST API
NWUI 使用 REST API 與 NetWorker 介接。NWUI 和 REST API 記錄會顯示 API 功能和 NetWorker 回應,不過也可以直接在瀏覽器中檢查此資訊。在尋找 UI 和 NetWorker CLI 之間的差異,或是當 UI 無法傳回預期結果時,這個方法十分實用。
- 存取 NWUI 時,在瀏覽器視窗中按一下滑鼠右鍵,然後選取檢查。

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

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


您可以在此識別要求 URL、要求方法和狀態代碼。
- 若要查看回應裝載,請按一下回應標籤。
此範例展示在瀏覽 Azure 備份並選取要還原的儲存集後,填入還原與儲存集標籤內的 REST API 回應。
其他資訊
NWUI 資源
NetWorker Management Web UI (NWUI): 如何使用
NetWorker Management Web UI (NWUI): 如何安裝
NetWorker Management Web UI (NWUI):分級與故障診斷指南