NVP-vProxy:vCenter 附掛程式和使用者介面 (VCUI) 故障診斷
Summary: 本文為備份系統管理員和 NetWorker 支援提供一般概觀,以對 vSphere 附掛程式和 VCUI 問題進行故障診斷。
Instructions
vCenter 使用者介面 (VCUI) 是內建於 NetWorker 伺服器的 Web 介面。VCUI 和 vSphere 附掛程式是選配的 NetWorker VMware Protection (NVP) 管理介面。這些並非必要項目,可成功排程或執行 VMware 備份或還原作業。這些介面可讓 VMware 系統管理員存取 NVP 作業,而不需要存取其他 NetWorker 管理介面,例如 NetWorker Management Console (NMC) 和 NetWorker Web 使用者介面 (NWUI)。
您可以使用下列方法存取 VCUI:
- 直接從網頁瀏覽器:
https://<NETWORKER_SERVER_ADDRESS>:9090/vcui - VCUI 可作為附掛程式直接安裝至 VMware vSphere。
獨立網頁和 vSphere 附掛程式皆在 NetWorker 伺服器上使用相同的端點。如需有關安裝和使用 vSphere 附掛程式或 VCUI 的詳細資訊,請參閱 NetWorker VMware 整合指南。NetWorker 文件可透過以下方式取得:NetWorker 支援 |手冊與文件 (您必須使用 Dell 支援帳戶登入)。
初始故障診斷步驟:
- 識別 NetWorker 伺服器版本和作業系統:NetWorker:識別 NetWorker 軟體版本的方法
- 識別 vCenter 版本。
- 從 VMware vSphere 中,選取清查中的 vCenter (最頂層物件),然後按一下摘要標籤:
- 從 VMware vSphere 中,選取清查中的 vCenter (最頂層物件),然後按一下摘要標籤:
- 檢閱 NetWorker 相容性說明文件,以確保 NetWorker 版本支援 VMware 版本:E-Lab 互用性導覽 2.0-HOME (您必須使用 Dell 支援帳戶登入)。
- 對於 vSphere 附掛程式的特定問題,是否在 vSphere 外也觀察到同樣的問題?例如,存取時
https://<NETWORKER_SERVER_ADDRESS>:9090/vcui直接。如果問題僅特定於 vSphere 外掛程式,則可能需要檢閱 vCenter 記錄以進一步評估問題。這也可能需要 VMware 系統管理員或 VMware 支援人員的參與。 - 此問題是否在超過一個網頁瀏覽器上觀察到?NetWorker 之外發生一個網頁瀏覽器特定的問題。
- 記下在網頁瀏覽器中觀察到的任何特定錯誤。
vSphere 附掛程式安裝問題:
- NVP vProxy:vSphere Web Client 附掛程式回報安裝成功,但未顯示
- NVP-vProxy:無法安裝 vCenter 附掛程式「找不到連接至要求目標的有效憑證路徑」
- NVP:無法在多重主目錄環境中安裝 vCenter 附掛程式
- NetWorker:vCenter 附掛程式和 VCUI 登入失敗,並顯示「vCenter 未向 NetWorker 伺服器註冊」
記錄:
VCUI 和 vSphere 附掛程式會將資訊記錄到 NetWorker 伺服器上的下列檔案:
- Linux:
/nsr/authc/logs/vcui.log - Windows (預設安裝路徑):
C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\vcui.log
標準紀錄層級為 INFO,在某些情況下這可能還不夠,若要啟用除錯,請執行下列步驟:
- 編輯 VCUI
logback.xml文字編輯器中的檔案:
- Linux:
/nsr/authc/webapps/vcui/WEB-INF/classes/logback.xml - Windows (預設安裝路徑):
C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\vcui\WEB-INF\classes\logback.xml
- 變更
root levelfromINFO的輸出傳送至DEBUG,並儲存變更:
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{55} - %msg%n</pattern>
</encoder>
</appender>
<appender name="FILE" class="ch.qos.logback.core.FileAppender">
<file>${catalina.base}/logs/vcui.log</file>
<append>true</append>
<encoder>
<pattern>%d{yyyy-MM-ddTHH:mm:ss.SSS} [%thread] %-5level %logger{25}.%M %L - %msg%n</pattern>
</encoder>
</appender>
<root level="DEBUG">
<appender-ref ref="FILE"/>
<appender-ref ref="STDOUT"/>
</root>
</configuration>
- 重新啟動 NetWorker 伺服器服務:
Linux:
systemctl restart networker or nsr_shutdown systemctl start networker
net stop nsrd net start nsrd
在 VCUI 或 vSphere 附掛程式中重現問題, vcui.log 包含調試消息。不再需要調試時,重複上述步驟,返回 root level 返回 INFO。
驗證問題:
針對驗證問題,您必須檢閱 NetWorker 驗證伺服器 (AUTHC) 記錄:
| 記錄路徑 | 用途 |
|
包含 NetWorker 驗證服務的安全性稽核訊息。通常需要調試才能啟用此檔中的日誌記錄。 |
|
包含 NetWorker 驗證服務的安全性稽核訊息。 |
|
包含嵌入式 Apache 的存取資訊 httpd Web 伺服器。 |
也可以啟用 AUTHC 調試:NetWorker:如何啟用 AUTHC DEBUG 以進行故障診斷
功能問題:
除了 vcui.log、瀏覽器檢查主控台和 NetWorker REST API 記錄,可檢閱以判斷操作問題:
- 在 Web 瀏覽器中,在視窗內單擊滑鼠右鍵,然後按兩下 「檢查」;或按下
CTRL+SHIFT+I。(確切的選項可能因瀏覽器而異。 - 在「檢查」主控台中,按一下 網路 標籤:
- 在產生問題的 vSphere 附掛程式或 VCUI 中執行作業。檢查主控台 的「名稱 」欄會列出執行的操作。
- 按兩下問題期間顯示的操作,然後查看標題 選項卡。常規信息顯示執行的 API 操作和結果。
- 此外,查看“ 有效負載 ”和 “回應 ”選項卡,瞭解有關操作的其他資訊。
其他 NetWorker 記錄:
NetWorker 伺服器 REST API 記錄也應包含與在 vSphere 附掛程式或 VCUI 中所執行之作業一致的記錄。REST API 記錄位於下列 NetWorker 伺服器位置:
- Linux:
/nsr/logs/restapi/restapi.log - Windows (預設安裝路徑):
C:\Program Files\EMC NetWorker\nsr\logs\restapi\restapi.log
還可以啟用 REST API 調試:NetWorker:如何啟用 REST API 偵錯
一般 NetWorker 記錄:NetWorker:記錄檔和位置
vCenter 記錄:
可從 vCenter Server 支援套裝檢閱下列記錄:
| 記錄路徑 | 用途 |
/var/log/vmware/vsphere-ui/logs/vsphere_client_virgo.log |
HTML5 用戶端的主要紀錄(外掛程式 UI 載入、延伸錯誤) |
/var/log/vmware/vsphere-ui/logs/vsphere-ui-runtime.log |
UI 服務的執行時問題 |
/var/log/vmware/vpxd/vpxd.log |
主要 vCenter 伺服器精靈。擴展註冊問題、API 故障、許可權問題、 |
/var/log/vmware/lookupsvc/lookupserver-default.log |
註冊失敗、憑證信任問題、端點查詢失敗。 |
|
|
REST API 故障、驗證或權杖錯誤、附掛程式後端通訊問題。 |