对 NSX for vSphere 6.x 中 NSX Manager Web Client 插件进行故障排除
search cancel

对 NSX for vSphere 6.x 中 NSX Manager Web Client 插件进行故障排除

book

Article ID: 301266

calendar_today

Updated On:

Products

VMware NSX

Issue/Introduction

本文提供了解适用于 VMware NSX for vSphere 6.x 的 vSphere Web Client 插件并对其进行故障排除所需的信息。

NSX 插件概览

VMware NSX 插件包含若干在用户界面 (UI) 提供显示内容的插件。它还会对用户界面和 NSX Manager 进行桥接。各个插件会被打包并压缩到 NSX Manager 中的 /home/secureall/secureall/sem/vsmext.zip 文件。vsmext.zip 文件还包括 plugin-package.xml 文件,它用于定义插件的部署顺序。

插件软件包通过 vSphere Web Client 下载和解压缩。每个插件随后会根据 plugin-package.xml 中定义的顺序部署。



Symptoms:
免责声明:本文为 Troubleshooting the NSX Manager Web Client Plug-In in NSX for vSphere 6.x (2126701) 的翻译版本。尽管我们会不断努力为本文提供最佳翻译版本,但本地化的内容可能会过时。有关最新内容,请参见英文版本。

Environment

VMware NSX for vSphere 6.1.x
VMware NSX for vSphere 6.2.x

Resolution

收集诊断信息

如果出现问题的是 NSX Web Client 插件,则必须收集此信息。
  • 客户环境详细信息:
    • NSX 的版本
    • vCenter Server 的版本
    • 再现问题的步骤
    • 问题历史记录。在 NSX 和/或 vCenter Server 升级后,问题是否仍然存在?

  • 日志:
    • NSX Manager 日志

      注意:如果无法访问 NSX UI 来收集日志,请转到 CLI shell 并通过运行 export techsupport scp username@IP:path_to_upload 命令收集日志。

  • 一个或多个有关错误或 UI 行为的屏幕截图
  • UI 中出现错误堆栈跟踪

对 NSX Web Client 插件进行故障排除

此部分介绍 NSX Web Client 插件的已知问题。
 
UI 中找不到“Networking & Security”图标
  • 检查 NSX UI 中 vCenter Server 的配置是否正确。
    1. 登录到 NSX Manager 设备 UI (https://NSX-IP)。
    2. 选择管理 vCenter 注册
    3. 在 vCenter Server 部分下,查看 vCenter Server 的详细信息和状态。

  • 检查 vCenter Server 受管对象的 NSX 扩展名。
    1. 登录到 vCenter Server Managed Objects Browser (MOB) (https://<vc-ip>/mob/?moid=ExtensionManager)。
    2. 检查 extensionList com.vmware.vShieldManager 的扩展名。
    3. 如果扩展名存在,则单击扩展名>客户端链接。
    4. 验证 NSX 的 IP 地址和版本。

  • 检查 NSX 插件的下载位置是否存在 com.vmware.vShieldManager-NSX_version 文件夹,相关内容在“日志位置”部分介绍。
  • 如果 vCenter Server 之前注册到一个较旧版本的 NSX 或者 NSX Manager 已升级,请按照“解决办法”部分介绍的步骤进行操作。
 
UI 中出现运行时异常
 
Web Client UI 会话处于活动状态时,在 NSX Manager 升级期间出现的运行时异常可指示升级失败。要从此情况恢复,请使用解决办法部分中的步骤。如果问题仍然存在或在升级之外也出现了异常,请收集“收集诊断信息”中概述的信息。
 
 
UI 中出现无法与 NSX Manager 通信错误
  1. 确认 vCenter Server 和 NSX Manager 之间的网络连接性。
  2. 重启 Web Client UI,然后再次登录。
  3. 清除浏览器缓存。

如果以上步骤无法解决此状况,请收集“收集诊断信息”中概述的信息。

日志位置

VMware vCenter Server 5.5.x 和 6.0.x

文件/文件夹名 描述 位置
Linux(设备) Windows

vsphere_client_virgo.log

vSphere Web Client 日志

/var/log/vmware/vsphere-client/logs/ C:\ProgramData\VMware\vSphere Web Client\serviceability\logs

wrapper.log

Java Service Wrapper (Tanuki) 日志 /var/log/vmware/vsphere-client/Logs/ C:\ProgramData\VMware\vSphere Web Client\Logs

wrapper.conf

Java Service Wrapper (Tanuki) 配置 /usr/lib/vmware-vsphere-client/server/wrapper/conf/ C:\Program Files\Vmware\Infrastructure\vSphereWebClient\server\bin\service\conf

com.vmware.vShieldManager-NSX_version

NSX 插件下载位置 对于5.5.x: /var/lib/vmware/vsphere-client/vc-packages/vsphere-client-serenity
对于6.0.x: /etc/vmware/vsphere-client/vc-packages/vsphere-client-serenity
C:\ProgramData\VMware\vSphere Web Client\vc-packages\vsphere-client-serenity



Additional Information

临时解决办法

要临时解决此问题,请从下载位置删除 NSX 插件并在收集“收集诊断信息”中所述的信息后重新启动 Web Client UI。

vCenter Server 5.5.x (Windows)

  1. 使用正确的凭据登录到 vCenter Server。
  2. 导航到“日志记录位置”部分所述的 NSX 插件下载位置。
  3. 移除 com.vmware.vshield.*.
  4. 重新启动 Web Client UI 并登录。

vCenter Server 6.x (Windows)

  1. 使用正确的凭据登录到 vCenter Server。
  2. 导航到“日志记录位置”部分所述的 NSX 插件下载位置。
  3. 移除 com.vmware.vshield.*.
  4. 删除 C:\ProgramData\VMware\vCenterServer\cfg\vsphere-client\cmCatalog下的com.vmware.ciscom.vmware.vShieldManager.zip。
  5. 重新启动 Web Client UI 并登录。

vCenter Server 5.5.x (VCVA)

  1. root 身份登录到 VCVA。
  2. 导航到“日志记录位置”部分所述的 NSX 插件下载位置。
  3. 移除 com.vmware.vshield.*.
  4. 重新启动 Web Client UI 并登录。

vCenter Server 6.x。(VCVA)

  1. 以 root 身份登录到 VCVA。
  2. 导航到“日志记录位置”部分所述的 NSX 插件下载部分。
  3. 移除 com.vmware.vshield.*.
  4. 删除 /etc/vmware/vsphere-client/cmCatalog/ 下的com.vmware.ciscom.vmware.vShieldManager.zip。
  5. 重新启动 Web Client UI 并登录。

Troubleshooting the NSX Manager Web Client Plug-In in NSX for vSphere 6.x