Problemen oplossen scenario's voor Nexus 1000v (N1kv) met VSUM

Inleiding

In dit document worden de scenario's voor het oplossen van problemen voor Nexus (N1kv) beschreven met Virtual Switch Update Manager (VSUM).

Achtergrondinformatie

Cisco VSUM is een virtueel apparaat dat is geregistreerd als stekker voor de VMware vCenter Server. De Cisco VSUM GUI is een integraal onderdeel van de VMware vSphere Web Client; U kunt deze alleen gebruiken wanneer u zich inlogt in de VMware vSphere-webclient. Cisco VSUM vereenvoudigt de installatie en configuratie van Cisco Nexus 1000V en de Cisco Application Virtual Switch (AVI).

Cisco VSUM laat u dit doen:

• Cisco Nexus 1000V voor VMware vSphere
• Installeer de Cisco Nexus 1000V-switch
• Migreer de VMware vSwitch en VMware vSphere gedistribueerde switch (VDS) naar Cisco Nexus 1000V
• Cisco Nexus 1000V bewaken
• Upgradeer de Cisco Nexus 1000V en voeg hosts toe uit een eerdere versie naar de laatste versie
• Installeer de Cisco Nexus 1000V-licentie.
• Bekijk de status van de virtuele machines in uw datacenter met behulp van het Dashboard - Cisco Nexus 1000V
• upgrade van een eerdere release naar Cisco VSUM 2.0

Overzicht van het proces voor probleemoplossing

Volg de hier beschreven stappen om uw netwerk problemen op te lossen:

1. Verzamel informatie die de specifieke symptomen definieert
2. Alle potentiële problemen identificeren die de symptomen kunnen veroorzaken
3. Zorg ervoor dat alle mogelijke problemen (van de meest waarschijnlijk tot minst waarschijnlijk) systematisch verdwijnen tot de symptomen verdwijnen

Overzicht van beste praktijken

Beste praktijken zijn de aanbevolen stappen die u moet nemen om de juiste werking van uw netwerk te verzekeren. Deze optimale werkwijzen worden voor de meeste netwerken aanbevolen:

• Zorg voor een consistente Cisco VSUM-release op alle netwerkapparaten

• Raadpleeg de opmerkingen voor de release van Cisco VSUM voor de nieuwste functies, beperkingen en voorbehouden

• Inloggen van systeembericht inschakelen

• Controleer en stel eventuele nieuwe configuratiewijzigingen in nadat u de verandering hebt uitgevoerd

Scenario's voor probleemoplossing

Dit zijn een aantal van de meest voorkomende problemen die Cisco Technical Assistance Center (TAC) heeft gemeld op het moment dat dit artikel is geschreven.

Scenario 1. Misbruik van VSUM in webclient

Na VSUM VM-implementatie via Open Virtual Appliance (OVA) en succesvolle initialisatie, verschijnt het VSUM-pictogram niet in vCenter-inventaris zoals in de afbeelding wordt getoond.

Netwerkconnectiviteit

• Bevestig eerst dat de netwerkconnectiviteit onder componenten bestaat.
• Zorg er vervolgens voor dat de eerste informatie in de VSUM OVA juist is. Dit omvat de IP van vCenter en de poortnummers. 
• Tot slot, laat haven 8443 toe voor interne communicatie.
• Installeer de gids is bijgewerkt met deze informatie, het volgende bug: CSCux34597)

Gemeenschappelijke installatieproblemen

1. OVA-corruptie
   • Bevestig de MD5-checksum van de OVA voordat het wordt ingezet
2. Het pictogram N1kv Manager/VSUM is niet zichtbaar in de vCenter web client
   • Waarschijnlijk is het apparaat niet via IP bereikbaar
   • Bevestig connectiviteit via Secure Shell (SSH) en zorg ervoor dat het poortgroep en IP-adres van de VM juist zijn
   • Pingen de standaardgateway uit de toepassingsconsole
   • Sluit u aan op het apparaat en controleer het installatielogbestand (zie voor bestandsindeling) om de reden van de storing. U moet NoRouteToHostException zien

U kunt het IP-adres als volgt wijzigen via /etc/cisco/app_install
Start cp-app.cfg.sjabloon-app.cfg
Start vi app.cfg en update de informatie. Hier is een voorbeeld:

 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"

Dit bestand opslaan en uitvoeren:

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

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

• Bevestig dat u naar vc mob kunt navigeren [https://<vcenter-IP>/mob] > Content > ExtensionManager
• Ga naar de vervolgkeuzelijst voor VSUM (voorbeeld: extensionList["com.cisco.n1kv"])
• Navigeren naar client
• Hier kunt u een URL zien (voorbeeld: https://<vCenter-IP>:8443/n1kv/static/client/cisco-n1kv-mgr.zip)
• Bevestig dat u dit bestand kunt downloaden; dit waarborgt ook dat haven 8443 open is .

3. IP/referenties van vCenter zijn onjuist

Sluit u aan op het apparaat en controleer het installatielogbestand (zie voor bestandsindeling) om de reden van de storing. U moet Ongeldige aanmelding zien.
Voer de eerder genoemde stappen uit (voor geen route naar host) en voer de juiste gebruikersnaam en het juiste wachtwoord in het bestand in.

4. .com.cisco.n1kv is al op vCenter geïnstalleerd.

• Controleer of een oude N1kv-stekker in vCenter bestaat (navigeren naar webclient > Gedistribueerde virtuele switches > [een N1kv-schakelaar] > Monitor)
• Bladeren naar https://<com IP>/mob
• Navigeren naar inhoud > extensiemanager
• Vind de verlengsnoer met n1kv
• Registratie van de uitbreiding ongedaan maken
• Voer de volgende handelingen uit:
  • Aan vCA:
    • Start rm -rf /var/lib/vmware/vsphere-client/vc-packages/vsphere-client-serenity/com.cisco.n1kv-0.9.1
    • Start de webclientservice opnieuw met /etc/init.d/vSphere-client-start
  •  Op Windows vCenter Server:
    • Verwijder cisco.n1kv-0.9.1 van C:\ProgramData\VMware\vSphere Web Client\vc-packages\vsphere-client-serenity
    • Start de webclient opnieuw door te navigeren naar: start > run > diensten.msc. Rechtsklik: VMware vSphere web client > stop en start
• Herstel de VM om deze succesvol te registreren

Gemeenschappelijke installatiefouten

• "IP-ADRES IN GEBRUIK"

Als het IP al in gebruik is, zal de installatie terugdraaien.

• "GEEN GESCHIKTE HOST GEVONDEN"

Deze fout wordt gezien wanneer de ctl port-group van één host en gmt. port-group van een andere host wordt gebruikt. Zorgen voor het centrum en de gmmt. vlan poortgroepen zijn beschikbaar op dezelfde host.

• "VSM AAN/UIT GESCHIKT"

De host die op het installatiescherm is geselecteerd, heeft niet voldoende bronnen (CPU, geheugen) voor de VSM om aan te zetten.

• "DUPLICAAT VM NAME"

De opgegeven naam bestaat al op de host. De inzet rolt in dit stadium terug.

• "GEEN DISKRUIMTE"

Er is niet genoeg schijfruimte op de host om de VSM in te zetten.

Overige installatielijsten

Een aantal andere fouten die tussen VSUM en vCenter kunnen worden gezien, worden vastgelegd als ajax Java-uitzonderingen. Ze zijn te vinden onder /etc/cisco/app_install/logs/n1kv-manager_install.log. Voorbeeld: 

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)

Een goede praktijk is om het toegangslogboek te herzien, om te zien wat de laatste actie was toen het bevel faalde. U kunt er in het logbestand /usr/local/tomcat/logs/ciscoExt naar zoeken om gedetailleerde zuiveringsinformatie te vinden. U kunt andere live gelogde informatie bekijken onder /usr/local/tomcat/logs/.

Scenario 2. Alleen huidige versie van de firmware genoteerd

Kan de VSM's van release x niet upgraden om y op te geven, omdat u geen andere afbeeldingen ziet die zijn weergegeven dan de huidige die draaien zoals in de afbeelding.

Verzamel VSUM-kaarten:

Stap 1	Gebruik SSH om verbinding te maken met Cisco VSUM. De standaardgebruikersnaam is wortel en het wachtwoord is cisco.
Stap 2	Navigeer naar /etc/cisco/app_install en voer de ./bundleLogs.sh opdracht uit.
Stap 3	In de hoofdmap haalt u de map AjaxLogs op, comprimeer de map en verstuur deze naar Cisco TAC.

Handeling:

TAC controleerde de VSUM-logbestanden (ajaxLogs\tomcatAllLogs\usr\local\tomcat\logs\ciscoExt.log).

Vond een verschil tussen de VSM en DVS bundel ID's.

<vsm-bundle-id>VEM500-201411171101-BG</vsm-bundle-id>
<dvs-bundle-id>VEM410-201301152101-BG</dvs-bundle-id>

Dit werd gecorrigeerd volgens de hier genoemde procedure:

VSM-01# 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# hoogtepunten voor systeemvem

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

VSM-01# hoofdniveau voor systeemupdate

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 # systeemupdate vem-functieniveau?

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

VSM-01# systeemupdate vem functieniveau 5 <<< 5 alleen voor dit scherm aangezien de versie N1k op dit moment SV3(1.2) is

VSM-01 # systeemvem-functieniveau

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

Opmerking: Wanneer u het functieniveau op de Virtual Ethernet Module (VEM) verbetert, heeft dit geen downtime nodig.

VSM-01# tonen de status van VMware

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-upgrade dient u op de hoogte te stellen, zoals in de afbeeldingen wordt weergegeven.

Coördineren met en informeren de serverbeheerder over het VEM-upgradeproces.

VSM-01# VMware-upgrade uitvoeren

Opmerking: Als VUM in de vCenter-omgeving is ingeschakeld, schakelt u deze uit voordat u de VM-upgrade uitvoert en vervolgens opdracht uitvoert om te voorkomen dat de nieuwe VIBs naar alle hosts worden geduwd.

Opmerking: Start de upgrade van de VMware opdracht, zodat de Cisco Nexus 1000V bundel-ID op de vCenter Server wordt bijgewerkt. Als VUM is ingeschakeld en u de Bundle ID niet bijwerken, wordt een onjuiste VIB-versie naar de VEM geduwd wanneer u vervolgens ESXi aan de VSM toevoegt.

Opmerking: Als VUM niet is geïnstalleerd, verschijnt "Het object of de optie waarnaar wordt verwezen, is niet gevonden" fout in de taakbalk van vCenter Server. U kunt deze foutmelding negeren.

VSM-01# VMware-upgrade voltooid

U moet nu in staat zijn de andere N1kv-releases in vCenter Web Client te bekijken, zoals in de afbeelding te zien is.  

Scenario 3. Hosts verschijnen onder 'Geen upgrade nodig hosts'

Alle hosts (VEM's) worden getoond onder het gedeelte Geen upgrade nodig, zoals in het beeld wordt getoond.

Verzamel VSUM-kaarten:

Stap 1	Gebruik SSH om verbinding te maken met Cisco VSUM. De standaardgebruikersnaam is wortel en het wachtwoord is cisco.
Stap 2	Navigeer naar /etc/cisco/app_install en voer de ./bundleLogs.sh opdracht uit.
Stap 3	In de hoofdmap haalt u de map AjaxLogs op, comprimeer de map en verstuur deze naar Cisco TAC.

Verifiëren:

• Schakel de zoekgeschiedenis en het gecachede geheugen uit
• Uitloggen van de vCenter Web Client en vervolgens opnieuw inloggen
• Controleer dat de host in de vervolgkeuzelijst Subsidiabele hosts verschijnt
• Selecteer de host en ga verder met de upgrade

Deze stappen zijn te vinden in de handleiding:

Wanneer u Cisco N1000v opwaarderen, moeten de hosts die worden bijgewerkt, worden weergegeven in de vervolgkeuzelijst subsidiabele hosts

Als deze stappen niet hielpen, zou u CSCuz11671 defect hebben geraakt zoals in de afbeelding.

Dit gedrag werd waargenomen met VSUM 1.5.3 en zou worden vastgesteld in VSUM 2.1 (zodat elke versie onder 2.1 kan worden beïnvloed).

Scenario 4. Kan VSM niet upgrade

Kan VSM niet upgraden van SV3 (1.10) naar SV3 (1.15).

In de pre-upgrade-instellingen probeert u een upgrade van een VSM met VSUM uit te voeren zoals in de afbeelding.

Nadat u hun configuratie en aanmeldingsgegevens hebt ingevoerd, wordt deze fout weergegeven zoals in het beeld.

Verzamel VSUM-kaarten:

Stap 1	Gebruik SSH om verbinding te maken met VSUM. De standaardgebruikersnaam is wortel en het wachtwoord is cisco.
Stap 2.	Navigeer naar /etc/cisco/app_install en voer de ./bundleLogs.sh opdracht uit.
Stap 3	In de hoofdmap haalt u de map AjaxLogs op, comprimeer de map en verstuur deze naar Cisco TAC.

Prime Network Services Controller (NCS) en Voice Source-Group (VSG) zijn een deel van uw installatie.

Dit probleem kwam doordat VSUM onjuiste informatie voor de PSNC- en VSG-versies heeft ontvangen, waardoor de upgrade werd stopgezet.

U kunt met deze opdrachten bevestigen:

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>

 

Een interne fout heeft betrekking op een fout die een uitzondering is in de VSUM-code.

Deze twee waarden moeten overeenkomen om de upgrade mogelijk te maken.

Hier volgt de procedure om dit gedrag te corrigeren:

Start deze opdracht om ervoor te zorgen dat beide bundelid’s gelijk zijn aan de Nexus 1000v-schakelaar:

vmware vem upgrade proceed

De opdracht hierboven maakt beide gebundelde id hetzelfde, als dit niet werkt, voert deze opdrachten uit:

vmware vem upgrade notify

vmware vem upgrade proceed

De vCenter-beheerder moet de aanvraag voor upgrade in vCenter accepteren. Als u dat eenmaal hebt gedaan, gaat de upgrade van VMware verder.

Documentatie:

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

In de rubriek: VMware Update Manager uit release 4.2(1) SV2 (1.1x)

Defect werd gecreëerd om dit probleem te volgen: 

Scenario 5. Fout "fault.com.cisco.n1kv.internalerror.summary"

Wanneer u probeert de VSM van versie X naar Y te verbeteren, ontvangt u een foutmelding in vCenter-taken die de status van "fault.com.cisco.n1kv.internalerror.summary" teruggeven.

Deze fout wordt echter alleen weergegeven in de traditionele GUI en geeft deze fout niet weer in de vCenter web client zoals in de afbeelding.

Verzamel VSUM-kaarten:

Stap 1.	Gebruik SSH om verbinding te maken met Cisco VSUM. De standaardgebruikersnaam is wortel en het wachtwoord is cisco.
Stap 2.	Navigeer naar /etc/cisco/app_install en voer de ./bundleLogs.sh opdracht uit.
Stap 3.	In de hoofdmap haalt u de map AjaxLogs op, comprimeer de map en stuurt u deze naar de Cisco TAC.

Handeling:

Zie usr/tomcat/logs/ciscoEXT.log. SCP zoeken

U kunt soortgelijke items vinden:

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.