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 管理控制台 (NMC) 和 NetWorker Web 用户界面 (NWUI)。 

VCUI 可通过以下方式访问:

  • 直接从网页浏览器: https://<NETWORKER_SERVER_ADDRESS>:9090/vcui
  • VCUI 可以作为插件直接安装到 VMware vSphere 中。 

独立网页和 vSphere 插件程序在 NetWorker 服务器上使用相同的端点。有关安装和使用 vSphere 插件或 VCUI 的详细信息,请参阅 NetWorker VMware 集成指南。NetWorker 文档可通过以下方式获得:适用于NetWorker的支持 |手册和文档 (您必须使用戴尔支持帐户登录)。

初始故障处理步骤:

  • 识别 NetWorker 服务器版本和操作系统:NetWorker:识别 NetWorker 软件版本的方法
  • 确定 vCenter 版本。
    • 在 VMware vSphere 中,选择清单中的 vCenter(最顶层对象),然后单击摘要选项卡:
      vCenter 版本 
  • 查看 NetWorker 兼容性文档,以确保 NetWorker 版本支持 VMware 版本:E-Lab Interoperability Navigator 2.0-HOME (您必须使用戴尔支持帐户登录)。
  • 对于特定于 vSphere 插件程序的问题,是否在 vSphere 之外观察到相同的问题?例如,在访问 https://<NETWORKER_SERVER_ADDRESS>:9090/vcui 直接。如果问题仅特定于 vSphere 插件程序,则可能需要查看 vCenter 日志以进一步评估问题。这可能还需要 VMware 管理员或 VMware 支持的参与。
  • 是否在多个网页浏览器中观察到该问题?某个 Web 浏览器的特定问题发生在 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 包含 DEBUG 消息。当不再需要调试时,重复上述步骤,返回 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 浏览器中,右键单击窗口内,然后单击 Inspect;或按 CTRL+SHIFT+I。(具体选项可能因浏览器而异。)
  2. 在 Inspect 控制台中,单击 Network 选项卡:
    Web 浏览器检查控制台的“网络”选项卡 
  3. 在产生问题的 vSphere 插件或 VCUI 中执行操作。检查控制台 的名称 列中列出了已执行的操作。
  4. 单击问题期间显示的操作,并查看 Headers 选项卡。常规信息显示执行的 API 操作及其结果。
    Web 浏览器检查控制台 API 结果 
  5. 此外,请查看 Payload Response 选项卡,了解有关操作的其他信息。 

附加 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 Server 守护程序。扩展注册问题、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.