Fehlerbehebung bei fehlgeschlagenen ISSU-Upgrades auf Catalyst Switches der Serie 9000

Einleitung

In diesem Dokument wird beschrieben, wie häufige Probleme bei ISSU-Upgrades auf Cisco Catalyst Switches der Serie 9000 erkannt und behoben werden.

Voraussetzungen

Anforderungen

Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:

• Architektur und Bereitstellungsmodelle der Cisco Catalyst Serie 9000

• Softwarewartungs-Upgrades (SMU) und ISSU-Prozess

• StackWise Virtual- und StackWise-Technologien

Verwendete Komponenten

Die Informationen in diesem Dokument basierend auf folgenden Software- und Hardware-Versionen:

• Cisco Catalyst Switches der Serien 9400, 9500 und 9600

• Cisco IOS® XE 

• Dualer Supervisor und virtuelle StackWise-Bereitstellungen

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netzwerk in Betrieb ist, stellen Sie sicher, dass Sie die möglichen Auswirkungen aller Befehle kennen.

Hintergrundinformationen

In-Service-Software-Upgrades (ISSU) ermöglichen Upgrades der Switch-Software, während das Netzwerk betriebsbereit bleibt. Für den Erfolg von ISSU müssen mehrere Bedingungen vorliegen: Der Softwarepfad muss unterstützt werden, die Stack-Elemente müssen übereinstimmende Versionen ausführen, und die Firmware muss sich ausrichten. Wenn diese Bedingungen nicht erfüllt werden, kann das Upgrade unterbrochen oder die Netzwerkinstabilität erhöht werden.

Durchführung erster Prüfungen vor dem ISSU-Upgrade

Stellen Sie vor Beginn des ISSU-Upgrades Folgendes sicher:

1. Vergewissern Sie sich, dass die aktuelle und die Zielversion von Cisco IOS XE ISSU unterstützen.

2. Stellen Sie sicher, dass der Upgrade-Pfad in der Cisco ISSU-Kompatibilitätsmatrix als unterstützt aufgeführt ist.

3. Stellen Sie sicher, dass auf allen Stack-Elementen oder -Supervisoren dasselbe Software-Image ausgeführt wird.

4. Stellen Sie sicher, dass der aktive und der Standby-Supervisor die gleichen ROMMON-Versionen verwenden.

5. Vergewissern Sie sich, dass der Switch im Installationsmodus betrieben wird (die Boot-Variable muss packages.conf lauten).

6. Überprüfen Sie die Verfügbarkeit von Speicher und Flash-Speicher für das neue Image.

7. Stellen Sie sicher, dass sich der Switch nicht in einem heruntergestuften oder nicht redundanten Zustand befindet.

8. Überprüfen Sie, ob keine aktiven Fehler, Hardware-Alarme oder kritischen Protokolle vorhanden sind.

9. Vergewissern Sie sich, dass die Ausgabe von show issu state detail anzeigt, dass kein ISSU-Vorgang ausgeführt wird.

Beispiele:

switch# show issu state detail
Current ISSU Status: Enabled       
Previous ISSU Operation: N/A
<snip>
No ISSU operation is in progress <<<<<<<<<

Führen Sie die folgenden Befehle aus, um die Validierung zu unterstützen:

• Show Boot System
• Details zum Problemstatus anzeigen
• Redundanz zeigen
• show module

Fehlerbehebung bei häufigen ISSU-Upgrade-Fehlern

Der ISSU-Status befindet sich noch in Bearbeitung

Symptom: Der Befehl show issu state detail zeigt an, dass ISSU ausgeführt wird, obwohl das Upgrade nicht explizit abgeschlossen oder fehlgeschlagen ist. Diese Bedingung kann weitere ISSU-Versuche blockieren und normale Upgrade-Workflows stören.

Die Fehlermeldung ISSU in progress kann angezeigt werden:

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

Überprüfen: Führen Sie show issu state detail aus, und suchen Sie nach:

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

Wenn der Status über einen längeren Zeitraum unverändert bleibt, ist der Prozess wahrscheinlich zum Stillstand gekommen.

Ursache: Unerwartete Unterbrechung während eines früheren ISSU-Versuchs oder Inkompatibilitätsfehlers.

Lösung: Führen Sie den Befehl install abort issu aus.

Wenn ISSU nach dem Abbruch des ISSU-Vorgangs noch läuft, führen Sie die folgenden Schritte aus:

Führen Sie den Befehl install remove inactive aus:

Switch#install remove inactive 

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

install_remove: Removing IMG

Cleaning up unnecessary package files

Service intern aktivieren:

switch(config)# service internal

Löschen Sie den aktuellen Installationsstatus:

switch#clear install state

Konfigurationskompatibilität zwischen Versionen

Symptom: Einige Konfigurationen sind nicht mit der neuen Softwareversion kompatibel und können während des Upgrades Probleme verursachen. Der Fehler "MCL-Terminating the current ISSU Operation" (MCL-Terminating the current ISSU Operation) in der nicht übereinstimmenden Befehlsliste kann angezeigt werden:

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

Lösung: Führen Sie den Befehl show redundancy config-sync failure history history mcl aus, und entfernen Sie nach Möglichkeit die nicht übereinstimmenden Befehle. Wenn die Befehle nicht entfernt werden können, führen Sie ein Standard-Upgrade durch. 

Inkompatibilität aufgrund von ROMMON- oder Softwareversionskonflikt

• Symptom: ISSU kann nicht fortgesetzt werden oder das erneute Laden eines nicht-ISSU-fähigen Geräts wird wiederhergestellt.

Dieser Fehler kann auftreten:

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

Überprüfen:  Vergleichen Sie die Cisco ROMMON- und Cisco IOS-Versionen mit dem Befehl show version. Stellen Sie bei dualen SUP-Systemen sicher, dass beide SUPs die gleiche Firmware- und Softwareversion verwenden.

Lösung: Aktualisieren Sie Cisco ROMMON oder Cisco IOS auf die gleiche Version, bevor Sie ISSU initiieren.

Wiederherstellung vom ISSU Partial Upgrade- oder ROMMON-Modus

Teilweise Aktualisierung

• Verifizierung: Bei einem teilweisen Upgrade stellen Sie sicher, dass noch kein ISSU-Upgrade durchgeführt wird. Wenn ISSU noch läuft, überwachen Sie den ISSU-Vorgang, bis er abgeschlossen ist, oder führen Sie innerhalb des für die Plattform und Version angegebenen Zeitraums einen Rollback durch.

• Lösung: Wenn der Vorgang nicht innerhalb dieses Zeitraums fortgesetzt wird, verwenden Sie die Wiederherstellungsprozedur im Abschnitt ISSU State Stuck in Progress. Stellen Sie sicher, dass kein ISSU- oder Installationsvorgang aktiv bleibt und dass auf allen redundanten Einheiten eine konsistente Softwareversion ausgeführt wird. Verwenden Sie dann das Standard-Upgrade-Verfahren.

Switch oder Supervisor geht in ROMMON-Modus

• Überprüfen: Konsolen Sie das betroffene Gerät, und prüfen Sie den Status.
• Lösung: Suchen Sie nach der .bin-Image-Datei für Cisco IOS XE oder der Datei packages.conf, um den Switch oder Supervisor wiederherzustellen. Im ROMMON-Handbuch finden Sie detaillierte Schritte zum Wiederherstellen des Geräts. 

Zugehörige Informationen

• ISSU-Kompatibilitätsmatrix 
• ISSU-Upgrade-Leitfaden 
• Upgrade-Handbuch für Catalyst 9000-Switches
• Fehlerbehebung häufig bei Catalyst 9000
• Upgrade von Catalyst Switches der Serie 9500
• Upgrade von Catalyst Switches der Serie 9400   
• Technischer Support und Downloads von Cisco

Revisionsverlauf

Überarbeitung	Veröffentlichungsdatum	Kommentare
2.0	09-Sep-2026	Formatierung, sequenzielle Schritte, Header.
1.0	11-Jul-2025	Erstveröffentlichung