목차

소개

배경 정보

문제 해결 프로세스 개요

모범 사례 개요

문제 해결 시나리오

시나리오 1. 웹 클라이언트에 VSUM 아이콘 없음

네트워크 연결

일반적인 설치 문제

일반적인 설치 오류

기타 설치 로그

시나리오 2. 현재 펌웨어 버전만 나열됨

시나리오 3. 호스트가 '업그레이드 필요 호스트 없음' 아래에 표시됨

시나리오 4. VSM을 업그레이드할 수 없습니다.

시나리오 5. 오류 "fault.com.cisco.n1kv.internalerror.summary"

소개

이 문서에서는 VSUM(Virtual Switch Update Manager)을 사용하는 Nexus(N1kv)의 문제 해결 시나리오에 대해 설명합니다.

배경 정보

Cisco VSUM은 VMware vCenter Server에 플러그인으로 등록된 가상 어플라이언스입니다.Cisco VSUM GUI는 VMware vSphere Web Client의 필수 구성 요소입니다.VMware vSphere Web Client에 로그인할 때만 액세스할 수 있습니다.Cisco VSUM은 Cisco Nexus 1000V 및 Cisco AVI(Application Virtual Switch)의 설치와 구성을 간소화합니다.

Cisco VSUM에서 다음과 같은 작업을 수행할 수 있습니다.

- VMware vSphere용 Cisco Nexus 1000V

- Cisco Nexus 1000V 스위치 설치

- VMware vSwitch 및 VMware vSphere VDS(Distributed Switch)를 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 릴리스의 릴리스 노트를 참조하십시오.

- 시스템 메시지 로그인 사용

- 변경 사항을 구현한 후 새 구성 변경 사항을 확인하고 문제를 해결합니다.

문제 해결 시나리오

이 기사가 작성될 당시 Cisco Technical Assistance Center(TAC)에서 발생한 가장 일반적인 문제 중 몇 가지에 해당합니다.

시나리오 1. 웹 클라이언트에 VSUM 아이콘 없음

OVA(Open Virtual Appliance)를 통해 VSUM VM을 구축하고 초기화에 성공한 후에는 이미지에 표시된 대로 vCenter 인벤토리에 VSUM 아이콘이 표시되지 않습니다.

네트워크 연결

- 먼저 구성 요소 간에 네트워크 연결이 존재하는지 확인합니다.

- 다음으로, VSUM OVA에 제공된 초기 정보가 올바른지 확인합니다.여기에는 vCenter IP 및 포트 번호가 포함됩니다.

- 마지막으로 내부 통신에 포트 8443을 허용합니다.

- 설치 가이드가 다음 정보로 업데이트되었습니다. 버그 추적:CSCux34597)

일반적인 설치 문제

1. OVA 손상

- OVA를 배포하기 전에 MD5 체크섬 확인

2. vCenter 웹 클라이언트에 N1kv Manager/VSUM 아이콘이 표시되지 않습니다.

- IP를 통해 어플라이언스에 연결할 수 없는 경우가 많음

- SSH(Secure Shell)를 통해 연결을 확인하고 VM의 포트 그룹 및 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에 있습니다.

- 이전 N1kv 플러그인이 vCenter에 있는지 확인합니다(Web Client > Distributed Virtual Switches > [any N1kv switch] > Monitor로 이동).

- https://<vcenter IP>/mob로 이동합니다.

- content(콘텐츠) > 확장 관리자로 이동합니다.

- 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를 사용하여 웹 클라이언트 서비스를 다시 시작합니다.

- 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 웹 클라이언트> 중지 및 시작

- VM을 성공적으로 등록하기 위해 VM 재구축

일반적인 설치 오류

- "사용 중인 IP 주소"

IP가 이미 사용 중인 경우 설치가 롤백됩니다.

- "적합한 호스트를 찾을 수 없음"

이 오류는 하나의 호스트 및 관리에서 ctl port-group을 생성할 때 표시됩니다.다른 호스트의 port-group이 사용됩니다.ctrl 및 mgmt를 확인합니다.vlan 포트 그룹은 동일한 호스트에서 사용할 수 있습니다.

- "VSM 전원 켜기 실패"

설치 화면에서 선택한 호스트에 VSM의 전원을 켜기에 충분한 리소스(CPU, 메모리)가 없습니다.

- "중복 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단계

Cisco VSUM에 연결하려면 SSH를 사용합니다.기본 사용자 이름은 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# 시스템 VEM 기능 수준 표시

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

VSM-01# 시스템 업데이트 버전 기능 수준

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 # 시스템 업데이트 버전 기능 레벨입니까?

<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(Virtual Ethernet Module)에서 기능 레벨을 업그레이드할 경우 다운타임이 필요하지 않습니다.

VSM-01# vmware vem 업그레이드 상태 표시

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 업그레이드 알림(이미지 참조)

VEM 업그레이드 프로세스에 대해 서버 관리자와 공동 조정 및 알립니다.

VSM-01# vmware vem 업그레이드 진행

참고:vCenter 환경에서 VUM이 활성화된 경우 새 VIB가 모든 호스트에 푸시되지 않도록 vmware vem upgrade proceed 명령을 실행하기 전에 비활성화합니다.

참고:vCenter 서버의 Cisco Nexus 1000V 번들 ID가 업데이트되도록 vmware vem upgrade proceed 명령을 실행합니다.VUM이 활성화되어 있고 번들 ID를 업데이트하지 않으면 다음에 VSM에 ESXi를 추가하면 잘못된 VIB 버전이 VEM에 푸시됩니다.

참고:VUM이 설치되어 있지 않으면 vCenter Server 작업 표시줄에 "참조된 개체 또는 항목을 찾을 수 없음" 오류가 나타납니다.이 오류 메시지를 무시할 수 있습니다.

VSM-01# vmware vem 업그레이드 완료

이제 이미지에 표시된 대로 vCenter 웹 클라이언트에서 다른 N1kv 릴리스를 볼 수 있어야 합니다.

시나리오 3. 호스트가 '업그레이드 필요 호스트 없음' 아래에 표시됨

모든 호스트(VEM)는 이미지에 표시된 대로 No Upgrade Needed Hosts 섹션 아래에 표시됩니다.

VSUM 로그 수집:

1단계

Cisco VSUM에 연결하려면 SSH를 사용합니다.기본 사용자 이름은 root이고 비밀번호는 cisco입니다.

2단계

/etc/cisco/app_install로 이동하고 ./bundleLogs.sh 명령을 실행합니다.

3단계

루트 디렉토리에서 ajaxLogs 폴더를 검색하고 폴더를 압축한 다음 Cisco TAC에 전송합니다.

확인:

- 브라우저 기록 및 캐시된 메모리 지우기

- vCenter 웹 클라이언트에서 로그아웃한 후 다시 로그인

- 호스트가 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단계

VSUM에 연결하려면 SSH를 사용합니다.기본 사용자 이름은 root이고 비밀번호는 cisco입니다.

2단계.

/etc/cisco/app_install으로 이동하고 ./bundleLogs.sh 명령을 실행합니다.

3단계

루트 디렉토리에서 ajaxLogs 폴더를 검색하고 폴더를 압축한 다음 Cisco TAC에 전송합니다.

PNSC(Prime Network Services Controller) 및 VSG(Voice Source-Group)는 설정에 포함됩니다.

이 문제는 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로 업그레이드하려고 하면 "fault.com.cisco.n1kv.internalerror.summary" 상태를 반환하는 vCenter 작업에서 오류 메시지가 표시됩니다.

그러나 이 결함은 기존 GUI에만 표시되며 이미지에 표시된 것처럼 vCenter 웹 클라이언트에 이 오류를 표시하지 않습니다.

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.