目錄

簡介

背景資訊

故障排除過程概述

最佳實踐概述

疑難排解案例

方案1. Web客戶端中缺少VSUM圖示

網路連線

常見安裝問題

常見安裝錯誤

其他安裝日誌

場景2.僅列出當前韌體版本

案例3.主機會顯示在「無需升級的主機」下

案例4.無法升級VSM

案例5.錯誤「fault.com.cisco.n1kv.internalerror.summary」

簡介

本檔案介紹使用虛擬交換器更新管理員(VSUM)的Nexus(N1kv)的疑難排解案例。

背景資訊

Cisco VSUM是註冊為VMware vCenter Server外掛的虛擬裝置。Cisco VSUM GUI是VMware vSphere Web Client不可或缺的一部分；只有登入到VMware vSphere Web客戶端時才能訪問它。Cisco VSUM簡化了Cisco Nexus 1000V和Cisco Application Virtual Switch(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並成功初始化後，vCenter清單中不會顯示VSUM圖示，如圖所示。

網路連線

- 首先，確認元件之間是否存在網路連線。

- 下一步，確保VSUM OVA中提供的初始資訊正確。包括vCenter IP和埠號。

- 最後，允許埠8443用於內部通訊。

- 已使用以下資訊更新安裝指南：跟蹤錯誤：CSCux(34597)

常見安裝問題

1. OVA損壞

- 在部署OVA之前確認MD5校驗和

2. N1kv Manager/VSUM圖示未顯示在vCenter Web客戶端中

- 很可能無法通過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 Client > Distributed Virtual Switches > [any N1kv switch] > Monitor)

- 瀏覽至https://<vcenter IP>/mob

- 導航到內容>擴展管理器

- 查詢具有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 restart重新啟動Web客戶端服務

- 在Windows vCenter Server上：

- 從C:\ProgramData\VMware\vSphere Web Client\vc-packages\vsphere-client-serenity中刪除cisco.n1kv-0.9.1

- 導航到：start > run > services.msc。按一下右鍵：VMware vsphere web client >停止並啟動

- 重新部署虛擬機器以便成功註冊

常見安裝錯誤

- "IP地址正在使用中"

如果IP已在使用，安裝將回滾。

- "未找到合適的主機"

當一台主機和管理的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 feature level

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 continue命令，以便更新vCenter Server上的Cisco Nexus 1000V捆綁包ID。如果已啟用VUM且您未更新捆綁包ID，則下次將ESXi新增到VSM時，系統會向VEM推送錯誤的VIB版本。

附註：如果未安裝VUM，vCenter Server工作列中會出現「找不到引用的對象或專案」錯誤。您可以忽略此錯誤消息。

VSM-01# vmware vem升級完成

現在，您必須能夠在vCenter Web Client中檢視其他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時，要升級的主機應顯示在「符合條件的主機」下拉選單中

如果這些步驟沒有幫助，您可能遇到了缺陷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。

步驟2.

導覽至/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 upgrade continue。

說明文件:

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

在本節中：VMware更新管理器4.2(1)SV2(1.1x)版

建立缺陷是為了跟蹤此問題：

案例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.