In diesem Dokument wird die Fehlerbehebung für SWIM beschrieben. Es enthält praktische Prüfungen, klare Wiederherstellungsschritte und Informationen, die vor der Eskalation überprüft werden müssen.
In diesem Dokument steht CatC für Cisco Catalyst Center (CatC) und SWIM für Software Image Management (SWIM).
Bevor Sie Änderungen vornehmen, stellen Sie sicher, dass der Zugriff auf die Konsole oder das Management verfügbar ist, dass das Ziel-Image korrekt ist, dass ein Backout-Pfad vorhanden ist, dass das Gerät nicht bereits einen weiteren Installationsvorgang ausführt und dass die Änderung genehmigt wurde.
Die GUI bietet nützlichen Kontext, bevor Sie zu CLI- oder Datenbankprüfungen wechseln.
Bei dieser Überprüfung muss es sich um eine der ersten Prüfungen vor der Image-Verteilung oder der Fehlerbehebung bei der Aktivierung handeln.

Empfohlener TAC-Überprüfungsablauf:

Was das TAC verifiziert:
Warum ist dieser Schritt wichtig? Dieser Schritt hilft Ihnen, Bildauswahlfehler frühzeitig zu erkennen. Außerdem erfahren Sie, ob das Upgrade auf Compliance, Lebenszyklusanpassung oder einer Sicherheitsempfehlung beruhte.
Wenn der FIPS-Modus aktiviert ist, muss der URL-basierte Image-Import durch die Sicherheitskontrollen der Plattform eingeschränkt werden. Verwenden Sie in diesem Fall eine unterstützte Importmethode wie Cisco.com oder einen lokalen Datei-Upload, und bestätigen Sie dann, dass die Bildmetadaten und die Prüfsumme nach dem Import korrekt ausgefüllt wurden.
![]() |
![]() |

Wenn ein Remote-Distribution-Server unter System > Settings > Device Settings > Image Distribution Servers konfiguriert ist, nehmen Sie ihn von Anfang des Falls an in die Analyse auf. Sie kann die Übertragungsmethode, den Übertragungszeitpunkt, das Stagingverhalten und den tatsächlichen Fehlerpunkt bei der Bildverteilung beeinflussen.

Was das TAC überprüft:
Warum ist das wichtig?
Wenn ein Remote-Distribution-Server im Einsatz ist, ist der Image-Pfad kein einfacher Controller-zu-Gerät-Transfer mehr. Ein Fehler wird durch den externen Server, die bevorzugten Protokolle, die Erreichbarkeit, das Image-Staging oder die serverseitige Verfügbarkeit und nicht durch das Gerät selbst verursacht.
Empfohlener TAC-Validierungsablauf:
Häufige TAC-Probleme:
Erfassen Sie vor einer tief greifenden Fehlerbehebung Folgendes:
Empfohlener TAC-Abholauftrag:
Warum ist das wichtig? Durch die frühzeitige Erfassung dieser Informationen wird das Hin- und Herschieben während der Eskalation reduziert, und das TAC kann ermitteln, ob das Problem mit der Image-Auswahl, der Aufgabenorchestrierung, der Plattformkompatibilität oder dem Gerätestatus zusammenhängt.
Überprüfen Sie die folgenden Elemente in der GUI:
Empfohlene TAC-Validierung:
Warum ist das wichtig? Anhand dieser Prüfungen kann das TAC entscheiden, ob das Problem durch die Image-Auswahl, die Zuweisung, die Bearbeitung von Controller-Aufgaben, die Bestandssynchronisierung oder das Gerät selbst verursacht wird.
Führen Sie nur die Befehle aus, die in den Plattform- und Softwaremodus passen.
Diese Befehle für die Installation sind insbesondere während der SWIM-Upgrade-Analyse nützlich. Der Befehl zur technischen Installation von Theshow bietet einen umfassenden technischen Überblick über den Installationsprozess und wird häufig verwendet, um allgemeine installationsbezogene Nachweise für eine Überprüfung oder Eskalation zu erfassen. Der Befehl show software install-manager switch X R0 operation history detail zeigt den detaillierten Verlauf der install-manager-Vorgänge für ein bestimmtes Stack-Element und hilft zu bestätigen, welche Schritte abgeschlossen wurden und wo der Prozess fehlgeschlagen ist. Der Befehl show software install-manager switch X R0 operation current detail zeigt den Live-Installationsstatus für diesen Switch und ist nützlich, wenn das Upgrade nicht funktioniert oder nicht funktioniert. Der Befehl equest platform software trace archivecommand sammelt die Ablaufverfolgungsdaten der Plattformsoftware für eine tiefere Analyse, während der Befehl request platform software trace slot switch X archivecommand die gleichen Ablaufverfolgungsdaten für ein bestimmtes Stapelelement sammelt. Zusammen helfen diese Befehle Teams zu verstehen, was während der Installation passiert ist, was jetzt passiert und welche Beweise für weitere Analysen gesammelt werden müssen.
technische Installation anzeigen
show platform software install-manager switch X R0 operation history detail (stack)
show platform software install-manager switch X R0 operation current detail (stack)
Anforderungsplattform Software-Ablaufverfolgungsarchiv
Anforderungsplattform-Software-Ablaufverfolgungssteckplatz-Switch X Archiv (Stapel)
show version
Inventar anzeigen
show platform
Showboot
show running-config | Boot-System einschließen
show startup-config | Boot-System einschließen
Dateisysteme anzeigen
Verzeichnis-Flash:
dir bootflash:
Verwenden Sie diese Befehle, um die aktuelle Version, die Boot-Einstellungen und den verfügbaren Speicher zu bestätigen.
Installationsübersicht anzeigen
show install active
show install Committed
Details zum Installationsprotokoll anzeigen
Installationsanfrage anzeigen
Mit diesen Befehlen können Sie überprüfen, ob eine vorherige Installation noch ausgeführt wird, unvollständig ist oder nicht bestätigt wurde.
show logging
show logging | include INSTALL|install|BOOT|boot|ERROR|FAIL|ROMMON
Archiv-Protokollkonfiguration alle anzeigen
Neuauflage anzeigen
show tech-support
Anzeigeschalter
Switch-Detail anzeigen
Redundanz zeigen
show platform software status control-prozessor brief
Status des Plattformsoftwarepakets anzeigen
ping <Gateway-oder-Management-Peer>
show ip interface brief
Schnittstellenstatus anzeigen
show prozesse cpu sortiert | ohne 0,00
show prozesse speichersortiert
Dateisysteme anzeigen
Verzeichnis-Flash:
dir bootflash:
show logging | SCP|SFTP|HTTP|TFTP|copy|transfer|flash einschließen
show prozesse cpu sortiert | ohne 0,00
Vergewissern Sie sich, dass genügend freier Speicherplatz vorhanden ist, überprüfen Sie, ob der Verwaltungspfad stabil ist, und entfernen Sie alte Dateien erst, nachdem Sie bestätigt haben, dass sie nicht verwendet werden.
GUI-Aktionen: Öffnen Sie die fehlgeschlagene Aufgabe, überprüfen Sie, ob das Gerät noch verwaltet wird, ob das Abbild im Repository vorhanden ist, überprüfen Sie, ob ein Remote-Verteilungsserver verwendet wird, und wiederholen Sie den Vorgang erst, wenn Speicher, Anmeldeinformationen und Übertragungspfad gut aussehen.
show version
Showboot
show running-config | Boot-System einschließen
show startup-config | Boot-System einschließen
Installationsübersicht anzeigen
Überprüfen Sie, ob die Boot-Variablen noch auf das alte Image verweisen. Korrigieren Sie ggf. den Bootpfad, und speichern Sie die Konfiguration vor dem erneuten Laden.
Konfiguration terminalno Boot-SystemSystemflash:<target-image.bin>endwrite memoryBoot anzeigen
GUI-Aktionen: Überprüfen Sie die Zeitleiste der Aufgabe, überprüfen Sie, ob das Gerät nach dem Neuladen wiederhergestellt wurde, führen Sie eine Bestandssynchronisierung durch, wenn die GUI-Version veraltet ist, und überprüfen Sie vor dem erneuten Versuch die Aktivierungs- und Bereinigungseinstellungen.
Installationsübersicht anzeigen
show install active
show install Committed
Details zum Installationsprotokoll anzeigen
show logging | Installation einschließen|INSTALL
Überprüfen Sie, ob das Paket bereits aktiv, aber noch nicht aktiviert ist. Starten Sie erst dann eine weitere Installation, wenn Sie den aktuellen Status verstanden haben.
installieren/übernehmen
Überprüfen Sie zunächst, ob ein zweifelsfrei funktionierendes Image lokal noch verfügbar ist, und verwenden Sie die genehmigte ROMMON-Wiederherstellungsmethode für diese Plattform.
Verzeichnis-Flash:
Boot-Flash:<zweifelsfrei funktionierendes Image.bin>
show version
Showboot
configure terminal
Kein Boot-System
Boot-System-Flash:<zweifelsfrei funktionierendes Image.bin>
end
Schreibspeicher
Anzeigeschalter
Switch-Detail anzeigen
show version
Verzeichnis-Flash:
Installationsübersicht anzeigen
show logging | Switch einschließen|Version|Installation
Bestätigen Sie, dass alle Elemente vorhanden sind, überprüfen Sie die Image-Verfügbarkeit auf allen Elementen, und wiederholen Sie den Vorgang nur, wenn der gesamte Stack fehlerfrei ist.
show version
Inventar anzeigen
show running-config | Boot-System einschließen
Wenn die Geräteversion korrekt ist, vermuten Sie veraltete Bestands- oder Compliance-Daten, bevor Sie sie als fehlgeschlagenes Upgrade behandeln.
GUI-Aktionen: Aktualisieren Sie den Gerätesatz, führen Sie eine erneute Compliance durch, überprüfen Sie, ob die Zuordnung des Golden Images noch korrekt ist, und überprüfen Sie den Aufgabenverlauf, um die erwartete Zielversion zu bestätigen.
Verzeichnis-Flash:
dir bootflash:
delete /force flash:<unused-image.bin>
delete /force /recursive flash:<Verzeichnis nicht verwendeter Pakete>
Showboot
configure terminal
Kein Boot-System
Boot-System-Flash:<target-image.bin>
end
Schreibspeicher
Showboot
nachladen
Installationsübersicht anzeigen
installieren/übernehmen
show install Committed
show version
Showboot
Installationsübersicht anzeigen
show logging | Schwanz
show ip interface brief
13. TAC-Workflow
Verwenden Sie diesen Workflow nach den Haupt-GUI- und CLI-Prüfungen. Behandeln Sie es als Arbeitssequenz für einen Live-TAC-Fall.
Ziel: Entscheiden Sie, ob das Problem im Catalyst Center, im Übertragungspfad oder auf dem Gerät aufgetreten ist.
Arbeitskontrollen: Überprüfen der Aufgabendetails, Zeitstempel, des Bestandsstatus und der Erreichbarkeit von Geräten So früh wie möglich Trennung der controllerseitigen von Übertragungsfehlern und geräteseitigen Ausfällen
Entscheidung: Wenn die Aufgabe fehlschlug, bevor das Image das Gerät erreicht hat, konzentrieren Sie sich auf Bestand, Anmeldeinformationen, Repository-Status und Übertragungspfad. Wenn das Image erfolgreich kopiert wurde, die Aktivierung jedoch fehlgeschlagen ist, verschieben Sie es in die Boot-Variablen, den Installationsstatus und die Geräteprotokolle.
Ziel: Erstellen Sie eine fehlerfreie Zeitleiste.
Erfassung: Notieren Sie den genauen Fehlertext der Benutzeroberfläche, die Task-ID, den Fehler-Zeitstempel und Details der untergeordneten Aufgabe, sofern verfügbar.
Warum dies wichtig ist: Daten müssen das GUI-Ereignis mit Geräteprotokollen, SWIM-Protokollen und Datenbankeinträgen abgleichen.
Ziel: Entscheiden Sie, ob es sich um ein Einzelgerät oder um eine breiter angelegte Plattform handelt.
Überprüfen: Bestimmen Sie, ob sich das Problem auf ein Gerät, einen Stack, einen Standort, eine Plattformfamilie oder mehrere Geräte in der Umgebung auswirkt.
Entscheidung: Wenn derselbe Fehler auf mehreren Geräten auftritt, wird die Bildqualität, die Plattformkompatibilität, der Repository-Status, die Anmeldedaten oder die Verarbeitung von Aufgaben auf Controller-Seite als falsch eingestuft, bevor ein Gerät als verantwortlich eingestuft wird.
Ziel: Finden Sie die letzte Phase, die erfolgreich abgeschlossen wurde.
Verfolgen: Führen Sie den Workflow durch Bildimport, Zuweisung, Verteilung, Aktivierung, Neuladen und Synchronisierung nach dem Upgrade.
Warum ist das wichtig? Dies verhindert, dass Sie Schritte wiederholen, die bereits funktioniert haben, und hilft Ihnen, sich auf den tatsächlichen Fehlerpunkt zu konzentrieren.
Ziel: Bestätigen Sie, ob die Übergabephase wirklich abgeschlossen ist.
Prüfungen: Überprüfen Sie, ob das Image im Flash-Speicher vorhanden ist: oder bootflash: auswählen, überprüfen, ob genügend freier Speicherplatz vorhanden ist, überprüfen, ob die Datei vollständig ist und ob das Image mit der vorgesehenen Plattform übereinstimmt.
Entscheidung: Wenn das Abbild fehlt, fahren Sie mit der Fehlerbehebung für die Übertragung fort. Wenn das Image vorhanden ist, wechseln Sie zur Aktivierung, zur Bootauswahl, zum Paketstatus oder zur Validierung nach dem Upgrade.
Ziel: Platzieren Sie den Fehler an der richtigen Stelle auf der Zeitachse.
Klassifizierung: Unterteilen Sie das Problem in einen der folgenden Zeitpunkte: vor dem erneuten Laden, während des erneuten Ladens oder nach dem erneuten Laden.
Entscheidung: Wenn der Fehler vor dem erneuten Laden auftritt, konzentrieren Sie sich auf die Installationslogik, die Boot-Einstellungen und die Aufgabenorchestrierung. Wenn dies beim Neuladen passiert ist, überprüfen Sie die Konsolenausgabe, den Grund für das Neuladen und das Bootverhalten. Konzentrieren Sie sich nach dem erneuten Laden auf die Neuerkennung, die Compliance-Synchronisierung, die Stack-Integrität und die Service-Wiederherstellung.
Ziel: Stellen Sie sicher, dass das Gerät stabil ist, bevor Sie es erneut ausführen.
Bestätigen: Überprüfen Sie, ob der Softwaremodus bekannt ist, die Bootvariablen korrekt sind, der Speicher fehlerfrei ist, der Installationsstatus nicht unvollständig ist, der Stack- oder HA-Status normal ist und kein vorheriger Installationsvorgang noch aktiv ist.
Ausstiegskriterien: Versuchen Sie es erst dann erneut, wenn alle diese Prüfungen klar sind oder Sie einen dokumentierten Grund zum Fortfahren haben.
Ziel: Reduzieren Sie Risiken und gehen Sie weiter.
Beginnen Sie mit Aktualisieren des Bestands, erneutes Ausführen der Compliance, Überprüfen von Protokollen, Korrigieren von Bootvariablen oder Übertragen eines Pakets, wenn die Aktivierung bereits erfolgreich war.
Orientierungshilfe: Wechseln Sie nicht zu Datenbankaktualisierungen oder erzwungenen Bereinigungen, es sei denn, die normalen Überprüfungen zeigen bereits, dass die Aufgabe veraltet ist und das Gerät im Workflow nicht mehr aktiv ist.
Ziel: Legen Sie vor dem nächsten Versuch einen klaren Entscheidungspunkt fest.
Wiederholen Sie den Vorgang nur, wenn: Das aktuelle Problem ist bekannt, das Gerät ist fehlerfrei, es ist keine konfliktbehaftete Aufgabe noch offen, das Image und die Zuweisung sind korrekt, und die Wiederherstellungsänderungen wurden gespeichert und validiert.
Entscheidung: Wenn diese Bedingungen nicht erfüllt sind, stoppen Sie den Wiederholungspfad, und eskalieren Sie mit den bereits gesammelten Beweisen.
show version
show boot
show install summary
show install log detail
show logging
show switch
show redundancy
dir flash:
dir bootflash:
| Überarbeitung | Veröffentlichungsdatum | Kommentare |
|---|---|---|
1.0 |
17-Jun-2026
|
Erstveröffentlichung |