NWUI 的運作方式
NetWorker Web 使用者介面 (NWUI) 使用下列技術:HTML5、Apache Tomcat、Spring Framework、Angular Framework,以及代表狀態傳輸 (REST) 應用程式設計介面 (API)。NWUI 應用程式可安裝在Linux或 Windows 作業系統上。它可以直接安裝在 NetWorker 伺服器或非 NetWorker 伺服器的主機上。
有四個重要元件:
這些元件可位於同一主機上或個別主機上。
- 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
安裝問題
瀏覽器端問題
如果安裝了多個瀏覽器,請在不同的瀏覽器中測試觀察到的問題,以查看該問題是否適用於一個瀏覽器。
在瀏覽器中,使用滑鼠右鍵和「檢查」來查看瀏覽器發出的 REST API 呼叫,以及記錄陳述和網路連線資訊。
- 在瀏覽器視窗的任何地方右鍵按下,然後選取「檢查」
- 新的視窗會開啟數個標籤。 「主控台」和「網路」標籤可能是最實用的。
- 使用這些標籤,我們可以看到對 NetWorker 伺服器發出的確切 REST API 呼叫。
- 在網路標籤中,我們也可以看到 NetWorker 伺服器的要求方法和 REST API 回應。如此一來,我們就能準確追蹤 NetWorker 伺服器的要求內容,以及 NetWorker 伺服器回應此請求的確切方式。
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 命令檢查他們是否正在執行:
記錄如下:
本機至 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:
您可以從 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\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
取消批注處理 API 呼叫記錄的行。這會導致記錄層級設為「trace」以取得 REST API 要求和回應。
![kA5f10000004LFmCAM_1_8](https://supportkb.dell.com/img/ka06P000000kKqYQAU/ka06P000000kKqYQAU_zh_TW_8.jpeg)