目录

简介

背景信息

故障排除过程概述

最佳实践概述

故障排除情况

场景1. Web客户端中缺少VSUM图标

网络连接

常见安装问题

常见安装错误

其他安装日志

场景2.仅列出当前固件版本

场景3.主机显示在“无升级所需主机”下

场景4.无法升级VSM

场景5.错误“fault.com.cisco.n1kv.internalerror.summary”

简介

本文档介绍带有虚拟交换机更新管理器(VSUM)的Nexus(N1kv)的故障排除方案。

背景信息

Cisco VSUM是注册为VMware vCenter服务器插件的虚拟设备。Cisco VSUM GUI是VMware vSphere Web客户端不可或缺的一部分；只有登录VMware vSphere Web客户端时，才能访问它。Cisco VSUM简化了Cisco Nexus 1000V和思科应用虚拟交换机(AVI)的安装和配置。

Cisco VSUM让您执行以下操作：

- 适用于VMware vSphere的Cisco Nexus 1000V

- 安装Cisco Nexus 1000V交换机

- 将VMware vSwitch和VMware vSphere分布式交换机(VDS)迁移到Cisco Nexus 1000V

- 监控Cisco Nexus 1000V

- 升级Cisco Nexus 1000V，将主机从早期版本添加到最新版本

- 安装Cisco Nexus 1000V许可证

- 使用控制面板 — Cisco Nexus 1000V查看数据中心中虚拟机的运行状况

- 从早期版本升级到Cisco VSUM 2.0

故障排除过程概述

按照以下步骤排除网络故障：

1. 收集定义特定症状的信息

2. 找出所有可能导致症状的潜在问题

3. 系统地消除每个潜在问题（从最可能到最不可能），直到症状消失

最佳实践概述

最佳实践是为确保网络正常运行而必须采取的建议步骤。建议大多数网络采用以下最佳实践：

- 在所有网络设备上保持一致的Cisco VSUM版本

- 有关最新功能、限制和警告，请参阅Cisco VSUM版本的版本说明

- 启用系统消息登录

- 在实施更改后，验证并排除任何新配置更改的故障

故障排除情况

这些是撰写本文时思科技术支持中心(TAC)遇到的一些最常见问题。

场景1. Web客户端中缺少VSUM图标

通过开放式虚拟设备(OVA)部署VSUM VM并成功初始化后，VSUM图标不会显示在vCenter资产中，如图所示。

网络连接

- 首先，确认组件之间存在网络连接。

- 接下来，确保VSUM OVA中提供的初始信息正确。这包括vCenter IP和端口号。

- 最后，允许端口8443进行内部通信。

- 安装指南已使用以下信息更新，跟踪漏洞：CSCux34597)

常见安装问题

1. OVA损坏

- 在部署OVA之前，确认MD5校验和

2. vCenter Web客户端中不显示N1kv Manager/VSUM图标

- 很可能，无法通过IP访问设备

- 通过安全外壳(SSH)确认连接，并确保虚拟机的端口组和IP地址正确

- 从设备控制台Ping默认网关

- 登录设备并检查安装日志（有关文件路径，请参阅）以了解故障原因。您必须看到NoRouteToHostException

要更改IP地址，请导航至/etc/cisco/app_install

运行cp app.cfg.template app.cfg

运行vi app.cfg并更新信息。以下是一个示例：

IpV4Address="10.28.28.121"

IpV4Netmask="255.255.255.0"

IpV4Gateway="10.28.28.1"

DnsServer1="10.28.28.115"

DnsServer2=""

VcenterIPV4Address="10.28.28.120”

VcenterUsernameFormat="hex"

VcenterUsername="726f6f74"

VcenterPasswordFormat="hex"

VcenterPassword="<Password Encoded As Stated>"

VcenterHttpPort="80"

VcenterHttpsPort="443"

保存此文件并运行：

./config_apps.sh –n in order to update network information

./config_apps.sh –r in order to register the VM to vCenter web client

- 确认您可以导航至vc mob [https://<vcenter-IP>/mob] > Content > ExtensionManager

- 访问VSUM的分机列表(示例：extensionList["com.cisco.n1kv"])

- 导航至客户端

- 在此，您可以看到URL(例如：https://<vCenter-IP>:8443/n1kv/static/client/cisco-n1kv-mgr.zip)

- 确认您可以下载此文件；这还确保端口8443处于打开状态

3. vCenter IP/凭证不正确

登录设备并检查安装日志（有关文件路径，请参阅）以了解故障原因。您必须看到InvalidLogin。

执行与前面所述步骤相同（对于没有到主机的路由），并在文件中输入正确的vCenter用户名和密码。

4. .com.cisco.n1kv已在vCenter上

- 检查vCenter中是否存在旧的N1kv插件(导航到Web客户端>分布式虚拟交换机> [任何N1kv交换机] >监控)

- 浏览到https://<vcenter IP>/mob

- 导航至content >extension manager

- 查找带n1kv的扩展密钥

- 注销扩展

- 执行如下操作：

- 在vCA上：

- 运行rm -rf /var/lib/vmware/vsphere-client/vc-packages/vsphere-client-serenity/com.cisco.n1kv-0.9.1

- 通过/etc/init.d/vsphere-client重新启动Web客户端服务

- 在Windows vCenter Server上：

- 从C:\ProgramData\VMware\vSphere Web Client\vc-packages\vsphere-client-serenity删除cisco.n1kv-0.9.1。

- 导航至：开始>运行> services.msc。右键单击： VMware vsphere Web客户端>停止并启动

- 重新部署VM以成功注册

常见安装错误

- "IP地址正在使用"

如果IP已在使用，安装将回滚。

- "找不到合适的主机"

当从一台主机和mgmt的ctl port-group时，会出现此错误。使用来自另一台主机的端口组。确保按ctrl和mgmt。vlan端口组在同一台主机上可用。

- "VSM通电失败"

在安装屏幕上选择的主机没有足够的资源（CPU、内存），无法让VSM通电。

- "重复的VM名称"

输入的交换机名称已存在于主机上。此阶段部署将回滚。

- "无磁盘空间"

主机上没有足够的磁盘空间来部署VSM。

其他安装日志

在VSUM和vCenter之间可以看到的一些其他错误记录为ajax Java异常。可在/etc/cisco/app_install/logs/n1kv-manager_install.log下找到。示例：

1784 [main] ERROR com.cisco.vcenter.extension.register.ExtensionRegister - An extension with this key is already registered. Will not attempt to register. It must be unregistered manually first, before attempting to register again.

Exception in thread "main" java.lang.IllegalArgumentException

at com.cisco.vcenter.extension.register.ExtensionRegister.unregisterPrevExt(ExtensionRegister.java:590)

at com.cisco.vcenter.extension.register.ExtensionRegister.register(ExtensionRegister.java:629)

at com.cisco.vcenter.extension.register.ExtensionRegister.doWork(ExtensionRegister.java:679)

at com.cisco.vcenter.extension.register.PluginUtil.dispatchWork(PluginUtil.java:72)

at com.cisco.vcenter.extension.register.PluginUtil.main(PluginUtil.java:116)

一种好的做法是查看访问日志，以查看命令失败时的最新操作。您可以在/usr/local/tomcat/logs/ciscoExt日志中搜索它，以查找详细的调试信息。您可以查看/usr/local/tomcat/logs/下的其他实时记录信息。

场景2.仅列出当前固件版本

无法将VSM从版本x升级到版本y，因为您没有看到除当前运行的映像之外列出的任何映像，如映像所示。

收集VSUM日志：

第 1 步

使用SSH连接到Cisco VSUM。默认用户名为root，密码为cisco。

步骤 2

导航至/etc/cisco/app_install并运行./bundleLogs.sh命令。

步骤 3

在根目录中，检索ajaxLogs文件夹，压缩该文件夹，然后将其发送到Cisco TAC。

执行的操作:

TAC检查了VSUM日志(ajaxLogs\tomcatAllLogs\usr\local\tomcat\logs\ciscoExt.log)。

发现VSM和DVS捆绑包ID之间有差异。

<vsm-bundle-id>VEM500-201411171101-BG</vsm-bundle-id>

<dvs-bundle-id>VEM410-201301152101-BG</dvs-bundle-id>

此问题已通过以下步骤得到纠正：

VSM-01# show module

1  5.2(1)SV3(1.2) 0.0

2  5.2(1)SV3(1.2) 0.0

3  5.2(1)SV3(1.2) VMware ESXi 5.5.0 Releasebuild-2456374 (3.2)

4  5.2(1)SV3(1.2) VMware ESXi 5.5.0 Releasebuild-2456374 (3.2)

5  5.2(1)SV3(1.2) VMware ESXi 5.5.0 Releasebuild-2456374 (3.2)

VSM-01# show system vem功能级别

Current feature level: 4.2(1)SV2(1.1)

VSM-01#系统更新vem功能级别

Feature Version

Level String

--------------------

1 4.2(1)SV2(2.1)

2 4.2(1)SV2(2.2)

3 4.2(1)SV2(2.3)

4 5.2(1)SV3(1.1)

5 5.2(1)SV3(1.2)

VSM-01 #系统更新vem功能级别?

<CR>

<1-50> Version number index from the list above

VSM-01# 系统更新vem功能级别5 <<< 5仅适用于此方案，因为版本N1k当前为SV3(1.2)

VSM-01 # show system vem feature level

Current feature level: 5.2(1)SV3(1.2)

注意：升级虚拟以太网模块(VEM)的功能级别时，无需停机。

VSM-01# show vmware vem upgrade status

Upgrade VIBs: System VEM Image

Upgrade Status:

Upgrade Notification Sent Time:

Upgrade Status Time(vCenter):

Upgrade Start Time:

Upgrade End Time(vCenter):

Upgrade Error:

Upgrade Bundle ID:

VSM: VEM500-201411171101-BG

DVS: VEM410-201301152101-BG    <<< same info as we noted in VSUM logs

VSM-01# vmware vem upgrade notify，如图所示。

与服务器管理员协调并通知VEM升级过程。

VSM-01# vmware vem升级继续

注意：如果在vCenter环境中启用了VUM，请在运行vmware vem upgrade proceed命令之前将其禁用，以防止将新VIB推送到所有主机。

注意：运行vmware vem upgrade proceed命令，以便更新vCenter服务器上的Cisco Nexus 1000V捆绑包ID。如果VUM已启用且您未更新捆绑包ID，则下次将ESXi添加到VSM时，会将不正确的VIB版本推送到VEM。

注意：如果未安装VUM，则vCenter Server任务栏中会出现“找不到引用的对象或项目”错误。您可以忽略此错误消息。

VSM-01# vmware vem升级完成

您现在必须能够查看vCenter Web客户端中的其他N1kv版本，如图所示。

场景3.主机显示在“无升级所需主机”下

所有主机(VEM)显示在“无升级需要的主机”部分下，如图所示。

收集VSUM日志：

第 1 步

使用SSH连接到Cisco VSUM。默认用户名为root，密码为cisco。

步骤 2

导航至/etc/cisco/app_install并运行./bundleLogs.sh命令。

步骤 3

在根目录中，检索ajaxLogs文件夹，压缩该文件夹，然后将其发送到Cisco TAC。

验证：

- 清除浏览器历史记录和缓存内存

- 注销vCenter Web客户端，然后重新登录

- 验证主机是否出现在Eligible Hosts下拉列表中

- 选择主机并继续升级

这些步骤可在指南中找到：

升级Cisco N1000v时，要升级的主机应显示在Eligible Hosts下拉列表中

如果这些步骤没有帮助，您可能遇到了CSCuz11671缺陷，如图所示。

此行为在VSUM 1.5.3中已发现，并将在VSUM 2.1中修复（因此任何低于2.1的版本都可能受到影响）。

场景4.无法升级VSM

无法将VSM从SV3(1.10)升级到SV3(1.15)。

在升级前设置中，您尝试使用VSUM升级VSM，如图所示。

输入配置和凭证后，此错误显示如图所示。

收集VSUM日志：

第 1 步

使用SSH连接到VSUM。默认用户名为root，密码为cisco。

第二步：

导航至/etc/cisco/app_install并运行./bundleLogs.sh命令。

步骤 3

在根目录中，检索ajaxLogs文件夹，压缩该文件夹，然后将其发送到Cisco TAC。

Prime网络服务控制器(PNSC)和语音源组(VSG)是您设置的一部分。

此问题是因为VSUM收到的PSNC和VSG版本的不正确信息导致其停止升级。

您可以使用以下命令进行确认：

N1kv # show vmware vem upgrade status | xml

<show>

<vmware>

<vem>

<upgrade>

<status>

….

<vsm-bundle-id>VEM500-201512250101-BG</vsm-bundle-id>

<dvs-bundle-id>VEM500-201510210101-BG</dvs-bundle-id> <-- these two IDs do not match

…..

</status>

</upgrade>

</vem>

</vmware>

</show>

内部错误是指VSUM代码中出现异常的错误。

这两个值必须匹配才能允许升级继续。

以下是纠正此行为的步骤：

运行以下命令，确保Nexus 1000v交换机上的两个捆绑ID相等：

vmware vem upgrade proceed

上述命令使捆绑ID相同，如果这不起作用，请运行以下命令：

vmware vem upgrade notify

vmware vem upgrade proceed

vCenter管理员需要接受vCenter中的“应用升级”提示。执行此操作后，请运行vmware vem升级继续。

文档：

http://www.cisco.com/c/en/us/td/docs/switches/datacenter/nexus1000/sw/5_2_1_s_v_3_1_5a/install_upgrade/guide/b_Cisco_N1KV_VMware_Install_and_Upgrade_Guide_521SV315a/b_Cisco_N1KV_VMware_Install_and_Upgrade_Guide_521SV314a_chapter_010.html#d8382e2398a1635

在部分中：版本4.2(1)SV2(1.1x)的VMware Update Manager

为跟踪此问题而创建了缺陷：

场景5.错误“fault.com.cisco.n1kv.internalerror.summary”

当您尝试将VSM从版本X升级到版本Y时，您会在vCenter任务中收到一条错误消息，返回状态“fault.com.cisco.n1kv.internalerror.summary”。

但是，此故障仅在传统GUI中显示，不会在vCenter Web客户端中显示此错误，如图所示。

收集VSUM日志：

步骤1:

使用SSH连接到Cisco VSUM。默认用户名为root，密码为cisco。

步骤 2

导航至/etc/cisco/app_install并运行./bundleLogs.sh命令。

第 3 步：

在根目录中，检索ajaxLogs文件夹，压缩该文件夹，然后将其发送到Cisco TAC。

执行的操作:

查看usr/tomcat/logs/ciscoEXT.log。搜索scp

您可以找到类似以下的条目：

257266658 DEBUG 2016-07-15 06:26:18,855 [pool-2-thread-5] com.cisco.n1kv.vsm.SSHAgent - Raw output is copy scp://scpuser@10.10.100.10///etc/cisco/data/n1kvbins/VSM-v-j3-n1-u15-l-b-v/upgrade/vsm/n1000v-dk9-kickstart.5.2.1.SV3.1.15.bin bootflash:

From the VSM execute: scp://scpuser@10.10.100.10///etc/cisco/data/n1kvbins/VSM-v-j3-n1-u15-l-b-v/upgrade/vsm/n1000v-dk9-kickstart.5.2.1.SV3.1.15.bin bootflash:

If the connection is successful, you will receive a prompt for credentials.

If the command fails, this indicates that there is a communication problem between VSUM and the VSM.

The likely cause is a firewall between VSUM and the VSM.

Verify that there is a bi-direction firewall rule in place for port 22 between VSUM and VSM.

If there is no rule in place, please create the rule and attempt the upgrade process again.