Problemen met ISSU-upgradefouten oplossen op Switches uit de Catalyst 9000-reeks

Inleiding

In dit document wordt beschreven hoe veelvoorkomende problemen tijdens ISSU-upgrades op Switches uit de Cisco Catalyst 9000-reeks kunnen worden geïdentificeerd en opgelost.

Voorwaarden

Vereisten

Cisco raadt kennis van de volgende onderwerpen aan:

• Architectuur- en implementatiemodellen van de Cisco Catalyst 9000-reeks

• Software-onderhoudsupgrades (SMU) en ISSU-proces

• StackWise Virtual en StackWise technologieën

Gebruikte componenten

De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:

• Cisco Catalyst-Switches uit de 9400-, 9500- en 9600-reeks

• Cisco IOS® XE 

• Dubbele supervisor en StackWise Virtual-implementaties

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Achtergrondinformatie

In-Service Software Upgrade (ISSU) maakt een upgrade van de switch-software mogelijk terwijl het netwerk in bedrijf blijft. Er moeten verschillende voorwaarden bestaan om ISSU te laten slagen: het softwarepad moet worden ondersteund, stackleden moeten overeenkomende versies uitvoeren en de firmware moet worden uitgelijnd. Het niet voldoen aan deze voorwaarden kan de upgrade onderbreken of netwerkinstabiliteit veroorzaken.

Eerste controles uitvoeren voordat ISSU wordt bijgewerkt

Voordat de ISSU-upgrade begint, controleert u het volgende:

• Bevestig dat de huidige en beoogde Cisco IOS XE-versies ISSU ondersteunen.

• Controleer of het upgradepad wordt vermeld als ondersteund in de Cisco ISSU Compatibility Matrix.

• Controleer of alle stapelleden of supervisors hetzelfde software-image uitvoeren.

• Zorg ervoor dat zowel actieve als standby-supervisors dezelfde ROMMON-versies gebruiken.

• Controleer of de switch in de installatiemodus werkt (de opstartvariabele moet packages.conf zijn).

• Beschikbaarheid van geheugen en flashruimte voor de nieuwe afbeelding controleren.

• Controleer of de switch niet gedegradeerd of niet-redundant is.

• Valideren dat er geen actieve fouten, hardwarewaarschuwingen of kritieke logs bestaan.

• Bevestig dat er geen eerdere ISSU-bewerking wordt uitgevoerd met de opdrachtshow issu state detail. De output moet het volgende aangeven:

switch# show issu state detail
Current ISSU Status: Enabled       
Previous ISSU Operation: N/A

No ISSU operation is in progress <<<<<<<<<

Let op: als ISSU al wordt uitgevoerd, moet u geen nieuwe upgrade starten.

Voer deze opdrachten uit om te helpen bij de validatie:

• Opstartsysteem weergeven
• Probleemstatusdetails weergeven
• redundantie tonen
• show module

Problemen met veelvoorkomende problemen oplossen bij upgradefouten

ISSU-staat vast in uitvoering

Symptoom: De opdrachtshow issu state detailtoont dat ISSU bezig is, ook al is de upgrade niet voltooid of is deze expliciet mislukt. Deze voorwaarde kan verdere ISSU-pogingen blokkeren en normale upgradeworkflows verstoren.

De foutmelding ISSU in uitvoering kan verschijnen:

FAILED: ISSU in progress; please use install abort issu to abort ISSU operation OR install commit to complete the current ISSU operation.

Verificatie: uitvoeren show issu state detail en zoeken naar:

Current ISSU Status: In Progress
Previous ISSU Operation: N/A

Als de status gedurende een langere periode ongewijzigd blijft, is het proces waarschijnlijk vastgelopen.

Oorzaak: onverwachte onderbreking tijdens een eerdere ISSU-poging of incompatibiliteitsfout.

Oplossing: Voer hetinstall abort issucommando uit.

Als ISSU nog wordt uitgevoerd, voert u de volgende stappen uit:

Uitvoeren,install remove inactiveopdracht.

Switch#install remove inactive 

install_remove: START Thu Jun 12 04:31:54 UTC 2025

install_remove: Removing IMG

Cleaning up unnecessary package files

Interne service inschakelen:

switch(config)# service internal

De huidige installatiestatus wissen:

switch#clear install state

Waarschuwing: met deze opdracht kan de hele switch of stapel opnieuw worden geladen.

Waarschuwing: start nooit een nieuwe ISSU terwijl u actief blijft. Dit kan leiden tot softwarecorruptie of instabiliteit van het apparaat.

Configuratiecompatibiliteit tussen releases

Symptoom: Bepaalde configuraties zijn niet compatibel met de nieuwe softwareversie en kunnen problemen veroorzaken tijdens de upgrade. De foutmelding "MCL-Terminating the current ISSU Operation" kan verschijnen:

ERROR: MCL-Terminating the current ISSU Operation. ISSU Abort operation is initiated
ERROR: Once ISSU abort is done please check full list of mismatched commands via:
ERROR: show redundancy config-sync failures historic mcl

Oplossing: Voer deshow redundancy config-sync failures historic mclopdracht uit en verwijder de niet-overeenkomende opdrachten indien mogelijk. Als de opdrachten niet kunnen worden verwijderd, voert u een standaardupgrade uit. 

Opmerking: controleer of er geen ISSU-upgrade wordt uitgevoerd om een nieuwe upgrade te starten. Raadpleeg de sectie ISSU State Stuck in Progress.

Incompatibiliteit als gevolg van Rommon- of softwareversie-mismatch

Symptoom: ISSU kan niet doorgaan of teruggaan naar herladen zonder ISSU. Deze fout kan worden weergegeven:

%REDUNDANCY-2-IPC: IOS versions do not match.

• Verificatie: Vergelijk Cisco ROMMON- en Cisco IOS-versies met behulp van de opdrachtshow version. In dual-SUP-systemen moet worden bevestigd dat beide SUP's dezelfde firmware- en softwareversies gebruiken.

• Oplossing: upgrade Cisco ROMMON of Cisco IOS naar dezelfde versie voordat u ISSU start.

Opmerking: raadpleeg de platformspecifieke release-notities voor de upgradestappen van ROMMON.

Herstellen van ISSU Partiële upgrade of ROMMON-modus

Gedeeltelijke upgrade

• Verificatie: controleer of er voor een gedeeltelijke upgrade nog geen ISSU-upgrade wordt uitgevoerd. Als ISSU nog steeds wordt uitgevoerd, wacht u enkele minuten totdat ISSU is voltooid of wordt teruggedraaid.

• Oplossing: raadpleeg het gedeelte ISSU State Stuck in Progress als de upgrade niet is voltooid. Voer vervolgens een standaard upgrade uit. 

Switch of supervisor komt in de ROMMON-modus

• Verificatie: Console naar het betreffende apparaat en controleer de status.
• Oplossing: Zoek naar het bestand Cisco IOS.bin of packages.conf om de switch of supervisor te herstellen, raadpleeg de ROMMON-gids voor uitgebreide stappen om het apparaat te herstellen. 

Gerelateerde informatie

• ISSU-compatibiliteitsmatrix
• ISSU-upgradehandleiding
• Upgrade-handleiding voor Catalyst 9000 switches
• Problemen oplossen met Rommon op Catalyst 9000
• Cisco Technical Support en downloads