NVP-vProxy:vCenter 插件和用户界面 (VCUI) 故障处理
Summary: 本文概述了备份管理员和 NetWorker 支持,以便对 vSphere 插件程序和 VCUI 问题进行故障处理。
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(最顶层对象),然后单击摘要选项卡:
- 在 VMware vSphere 中,选择清单中的 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 插件程序安装问题:
- NVP vProxy:vSphere Web Client 插件报告安装成功,但不显示
- NVP-vProxy:无法安装 vCenter 插件程序“找不到所请求目标的有效认证路径”
- NVP:无法在多宿主环境中安装 vCenter 插件程序
- NetWorker:vCenter 插件和 VCUI 登录失败,并显示“vCenter not registered with NetWorker server”(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 包含 DEBUG 消息。当不再需要调试时,重复上述步骤,返回 root level 返回 INFO。
身份验证问题:
对于身份认证问题,必须查看 NetWorker 身份认证服务器 (AUTHC) 日志:
| 日志路径 | 目的 |
|
包含 NetWorker 身份验证服务的安全审核消息。通常需要调试才能启用此文件中的日志记录。 |
|
包含 NetWorker 身份验证服务的安全审核消息。 |
|
包含嵌入式 Apache 的访问信息 httpd Web 服务器。 |
还可以启用 AUTHC 调试:NetWorker:如何启用 AUTHC DEBUG 以进行故障处理
功能问题:
除了 vcui.log、浏览器检查控制台和 NetWorker REST API 日志可以进行检视以确定操作问题:
- 在 Web 浏览器中,右键单击窗口内,然后单击 Inspect;或按
CTRL+SHIFT+I。(具体选项可能因浏览器而异。) - 在 Inspect 控制台中,单击 Network 选项卡:
- 在产生问题的 vSphere 插件或 VCUI 中执行操作。检查控制台 的名称 列中列出了已执行的操作。
- 单击问题期间显示的操作,并查看 Headers 选项卡。常规信息显示执行的 API 操作及其结果。
- 此外,请查看 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 |
注册失败、证书信任问题、端点查找失败。 |
|
|
REST API 故障、身份验证或令牌错误、插件后端通信问题。 |