NVP-vProxy:vCenter 附掛程式和使用者介面 (VCUI) 故障診斷

Summary: 本文為備份系統管理員和 NetWorker 支援提供一般概觀,以對 vSphere 附掛程式和 VCUI 問題進行故障診斷。

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

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 (最頂層物件),然後按一下摘要標籤:
      vCenter 版本 
  • 檢閱 NetWorker 相容性說明文件,以確保 NetWorker 版本支援 VMware 版本:E-Lab 互用性導覽 2.0-HOME (您必須使用 Dell 支援帳戶登入)。
  • 對於 vSphere 附掛程式的特定問題,是否在 vSphere 外也觀察到同樣的問題?例如,存取時 https://<NETWORKER_SERVER_ADDRESS>:9090/vcui 直接。如果問題僅特定於 vSphere 外掛程式,則可能需要檢閱 vCenter 記錄以進一步評估問題。這也可能需要 VMware 系統管理員或 VMware 支援人員的參與。
  • 此問題是否在超過一個網頁瀏覽器上觀察到?NetWorker 之外發生一個網頁瀏覽器特定的問題。
  • 記下在網頁瀏覽器中觀察到的任何特定錯誤。

vSphere 附掛程式安裝問題:

記錄:

VCUI 和 vSphere 附掛程式會將資訊記錄到 NetWorker 伺服器上的下列檔案:

  • Linux: /nsr/authc/logs/vcui.log
  • Windows (預設安裝路徑): C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\vcui.log

標準紀錄層級為 INFO,在某些情況下這可能還不夠,若要啟用除錯,請執行下列步驟:

  1. 編輯 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
  1. 變更 root level from INFO 的輸出傳送至 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>
  1. 重新啟動 NetWorker 伺服器服務:

Linux:

systemctl restart networker

or 

nsr_shutdown
systemctl start networker
Windows:
net stop nsrd
net start nsrd

在 VCUI 或 vSphere 附掛程式中重現問題, vcui.log 包含調試消息。不再需要調試時,重複上述步驟,返回 root level 返回 INFO。 

驗證問題:

針對驗證問題,您必須檢閱 NetWorker 驗證伺服器 (AUTHC) 記錄:

記錄路徑 用途
  • Linux: /nsr/authc/logs/authc-server.log
  • Windows: C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\authc-server.log
包含 NetWorker 驗證服務的安全性稽核訊息。通常需要調試才能啟用此檔中的日誌記錄。
  • Linux: /nsr/authc/logs/authc-server-audit.log
  • Windows: C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\authc-server-audit.log
包含 NetWorker 驗證服務的安全性稽核訊息。
  • Linux: /nsr/authc/logs/localhost_access_log.date.txt
  • Windows: C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\localhost_access_log.date.txt
包含嵌入式 Apache 的存取資訊 httpd Web 伺服器。

也可以啟用 AUTHC 調試:NetWorker:如何啟用 AUTHC DEBUG 以進行故障診斷

功能問題:

除了 vcui.log、瀏覽器檢查主控台和 NetWorker REST API 記錄,可檢閱以判斷操作問題:

  1. 在 Web 瀏覽器中,在視窗內單擊滑鼠右鍵,然後按兩下 「檢查」;或按下 CTRL+SHIFT+I。(確切的選項可能因瀏覽器而異。
  2. 在「檢查」主控台中,按一下 網路 標籤:
    網頁瀏覽器檢查主控台網路標籤 
  3. 在產生問題的 vSphere 附掛程式或 VCUI 中執行作業。檢查主控台 的「名稱 」欄會列出執行的操作。
  4. 按兩下問題期間顯示的操作,然後查看標題 選項卡。常規信息顯示執行的 API 操作和結果。
    網頁瀏覽器檢查主控台 API 結果 
  5. 此外,查看“ 有效負載 ”和 “回應 ”選項卡,瞭解有關操作的其他資訊。 

其他 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 註冊失敗、憑證信任問題、端點查詢失敗。

/var/log/vmware/vapi/endpoint/endpoint.log
/var/log/vmware/vapi/endpoint/endpoint-access.log

REST API 故障、驗證或權杖錯誤、附掛程式後端通訊問題。

 

Affected Products

NetWorker

Products

NetWorker Family
Article Properties
Article Number: 000462192
Article Type: How To
Last Modified: 08 مايو 2026
Version:  3
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.