In questo documento viene descritto come risolvere i problemi relativi a SWIM, con controlli pratici, operazioni di ripristino non crittografate e informazioni da verificare prima dell'escalation.
In questo documento, CatC significa Cisco Catalyst Center (CatC) e SWIM significa Software Image Management (SWIM).
Prima di apportare qualsiasi modifica, verificare che l'accesso alla console o alla gestione sia disponibile, che l'immagine di destinazione sia corretta, che esista un percorso di backout, che il dispositivo non stia già eseguendo un'altra operazione di installazione e che la modifica sia approvata.
La GUI fornisce un contesto utile prima di passare alla CLI o ai controlli del database.
Questa revisione deve essere una delle prime verifiche prima della distribuzione dell'immagine o della risoluzione dei problemi di attivazione.

Flusso di revisione TAC consigliato:

Verifica TAC:
Perché questo passaggio è importante: Questo passaggio consente di individuare in anticipo gli errori di selezione delle immagini. Consente inoltre di spiegare se l'aggiornamento è stato guidato da conformità, allineamento del ciclo di vita o consulenza sulla sicurezza.
Se la modalità FIPS è attivata, l'importazione delle immagini basate su URL deve essere limitata dai controlli di sicurezza della piattaforma. In questi casi, utilizzare un metodo di importazione supportato, ad esempio Cisco.com o il caricamento di un file locale, quindi verificare che i metadati e il checksum dell'immagine siano stati popolati correttamente dopo l'importazione.
![]() |
![]() |

Se un server di distribuzione remoto è configurato in Sistema > Impostazioni > Impostazioni dispositivo > Server di distribuzione immagini, includetelo nell'analisi dall'inizio della richiesta. Può influire sul metodo di trasferimento, sulla durata del trasferimento, sul comportamento della gestione temporanea e sul punto effettivo di errore durante la distribuzione dell'immagine.

Controlli TAC:
Perché è importante:
Quando si utilizza un server di distribuzione remoto, il percorso dell'immagine non è più un semplice trasferimento da controller a dispositivo. L'errore è causato dal server esterno, dalle preferenze del protocollo, dalla raggiungibilità, dalla gestione temporanea delle immagini o dalla disponibilità sul lato server anziché dal dispositivo stesso.
Flusso di convalida TAC consigliato:
Problemi TAC comuni da tenere presenti:
Prima di procedere alla risoluzione dei problemi, raccogliere:
Ordine di raccolta TAC consigliato:
Perché è importante: La raccolta anticipata di queste informazioni riduce l'attività in avanti e indietro durante l'escalation e consente a TAC di determinare se il problema è correlato alla selezione delle immagini, all'orchestrazione delle attività, alla compatibilità della piattaforma o allo stato del dispositivo.
Controllare questi elementi nella GUI:
Ordine di convalida TAC consigliato:
Perché è importante: Questi controlli consentono a TAC di stabilire se il problema è causato dalla selezione dell'immagine, dall'assegnazione, dalla gestione delle attività del controller, dalla sincronizzazione dell'inventario o dal dispositivo stesso.
Eseguire solo i comandi adatti alla piattaforma e alla modalità software.
Questi comandi relativi all'installazione sono particolarmente utili durante l'analisi dell'aggiornamento di SWIM. Il comando show tech install fornisce un'ampia istantanea tecnica del processo di installazione ed è comunemente utilizzato per acquisire prove generali relative all'installazione per la revisione o l'escalation. Il comando show platform software install-manager switch X R0 operation history detail mostra la cronologia dettagliata delle operazioni di install-manager per un membro specifico dello stack e permette di verificare quali passaggi sono stati completati e dove si sono verificati degli errori. Il comando show platform software install-manager switch X R0 operation current detail mostra lo stato di installazione dello switch ed è utile quando l'aggiornamento è bloccato o è ancora in esecuzione. Request platform software trace archivecommand raccoglie i dati di traccia del software della piattaforma per un'analisi più approfondita, mentre request platform software trace slot switch X archivecommand raccoglie gli stessi dati di traccia per un membro specifico dello stack. Insieme, questi comandi aiutano i team a comprendere cosa è successo durante l'installazione, cosa sta succedendo ora e quali prove devono essere raccolte per un'ulteriore analisi.
show tech install
show platform software install-manager switch X R0 cronologia operazioni (stack)
show platform software install-manager switch X R0 dettaglio operazione corrente (stack)
richiedi archivio di traccia software piattaforma
richiesta piattaforma software trace slot switch X archive(stack)
show version
mostra inventario
show platform
mostra avvio
show running-config | includi sistema di avvio
show startup-config | includi sistema di avvio
mostrare i file system
dir flash:
dir bootflash:
Utilizzare questi comandi per verificare la versione corrente, le impostazioni di avvio e lo spazio di archiviazione disponibile.
mostra riepilogo installazione
mostra installazione attiva
show install eseguito
mostra dettagli log di installazione
show install request
Questi comandi consentono di verificare se un'installazione precedente è ancora in esecuzione, incompleta o non eseguita.
show logging (visualizza registri)
show logging (visualizza registri) | includere INSTALL|install|BOOT|boot|ERROR|FAIL|ROMMON
show archive log config all
show reload
show tech-support
show switch
show switch detail
mostra ridondanza
show platform software status control-processor brief
show platform software package status
ping <gateway-or-management-peer>
show ip interface brief
mostra stato interfacce
mostra processi in base a cpu | non 0,00
mostra processi ordinati in base alla memoria
mostrare i file system
dir flash:
dir bootflash:
show logging (visualizza registri) | include SCP|SFTP|HTTP|TFTP|copy|transfer|flash
mostra processi in base a cpu | non 0,00
Verificare che lo spazio disponibile sia sufficiente, controllare che il percorso di gestione sia stabile e rimuovere i vecchi file solo dopo aver confermato che non sono in uso.
Azioni GUI: Aprire l'operazione non riuscita, verificare che il dispositivo sia ancora gestito, che l'immagine sia ancora presente nel repository, controllare se un server di distribuzione remoto è in uso e riprovare solo dopo che l'archiviazione, le credenziali e il percorso di trasferimento sono stati visualizzati correttamente.
show version
mostra avvio
show running-config | includi sistema di avvio
show startup-config | includi sistema di avvio
mostra riepilogo installazione
Verificare se le variabili di avvio puntano ancora all'immagine precedente. Correggere il percorso di avvio, se necessario, quindi salvare la configurazione prima di ricaricarla.
configurare terminalno boot systemavviare il sistema flash:<target-image.bin>endwrite memoryshow boot
Azioni GUI: Verificare la cronologia dell'attività, controllare se il dispositivo è tornato dopo il riavvio, eseguire la sincronizzazione dell'inventario se la versione GUI non è aggiornata e verificare i controlli di attivazione e le impostazioni di pulizia prima di riprovare.
mostra riepilogo installazione
mostra installazione attiva
show install eseguito
mostra dettagli log di installazione
show logging (visualizza registri) | include installazione|INSTALLA
Verificare se il pacchetto è già attivo ma non è stato eseguito il commit. Non avviare un'altra installazione prima di aver compreso lo stato corrente.
comando install commit
Verificare innanzitutto se un'immagine riconosciuta valida è ancora disponibile in locale e utilizzare il metodo di ripristino ROMMON approvato per tale piattaforma.
dir flash:
boot flash:<immagine riconosciuta valida.bin>
show version
mostra avvio
configurare il terminale
nessun sistema di avvio
flash del sistema di avvio:<known-good-image.bin>
end
memoria di scrittura
show switch
show switch detail
show version
dir flash:
mostra riepilogo installazione
show logging (visualizza registri) | include switch|versione|install
Verificare che tutti i membri siano presenti, verificare la disponibilità dell'immagine in tutti i membri e riprovare solo quando lo stack completo è integro.
show version
mostra inventario
show running-config | includi sistema di avvio
Se la versione del dispositivo è corretta, sospetta che i dati di inventario o di conformità non siano aggiornati prima di considerarli come aggiornamenti non riusciti.
Azioni GUI: Aggiornare il record del dispositivo, rieseguire la conformità, verificare che il mapping dell'immagine finale sia ancora corretto ed esaminare la cronologia delle attività per confermare la versione di destinazione prevista.
dir flash:
dir bootflash:
delete /force flash:<immagine-inutilizzata.bin>
delete /force /recursive flash:<directory-pacchetti-inutilizzati>
mostra avvio
configurare il terminale
nessun sistema di avvio
boot system flash:<immagine-destinazione.bin>
end
memoria di scrittura
mostra avvio
ricaricare
mostra riepilogo installazione
comando install commit
show install eseguito
show version
mostra avvio
mostra riepilogo installazione
show logging (visualizza registri) | coda
show ip interface brief
13. Flusso di lavoro TAC
Utilizzare questo workflow dopo i controlli principali della GUI e della CLI. Trattarla come sequenza di lavoro per un caso TAC vivo.
Obiettivo: Decidere se il problema si è verificato in Catalyst Center, nel percorso di trasferimento o nel dispositivo.
Assegni in esecuzione: Verificare i dettagli dell'attività, i timestamp, lo stato dell'inventario e la raggiungibilità del dispositivo. Separare il più presto possibile gli errori sul lato controller dagli errori di trasferimento e dagli errori sul lato dispositivo.
Decisione: Se l'operazione non è riuscita prima che l'immagine raggiungesse il dispositivo, rimanere concentrati su inventario, credenziali, stato del repository e percorso di trasferimento. Se l'immagine è stata copiata correttamente ma l'attivazione non è riuscita, passare alle variabili di avvio, allo stato di installazione e ai registri del dispositivo.
Obiettivo: Creare una linea temporale di errore pulita.
Acquisisci: Registrare il testo esatto dell'errore GUI, l'ID dell'attività, il timestamp dell'errore e i dettagli dell'attività secondaria, se disponibili.
Perché è importante: i dati devono corrispondere all'evento GUI con i registri dei dispositivi, i registri SWIM e i record del database.
Obiettivo: Decidere se si tratta di un problema relativo a un singolo dispositivo o a una piattaforma più ampia.
Verifica: Determinare se il problema riguarda un dispositivo, uno stack, un sito, una famiglia di piattaforme o più dispositivi nell'ambiente.
Decisione: Se lo stesso errore si verifica su più dispositivi, prima di incolpare un dispositivo è consigliabile verificare la qualità dell'immagine, la compatibilità della piattaforma, lo stato del repository, le credenziali o la gestione delle attività sul lato controller.
Obiettivo: Trovare l'ultima fase completata correttamente.
Brano: Sincronizzazione di importazione, assegnazione, distribuzione, attivazione, ricaricamento e post-aggiornamento delle immagini.
Perché è importante: In questo modo è possibile evitare di ripetere passaggi già eseguiti e concentrarsi sul punto di errore reale.
Obiettivo: Verificare che la fase di trasferimento sia stata effettivamente completata.
Controlli: Verificare se l'immagine è presente sul flash: o bootflash:, verificare che lo spazio disponibile sia sufficiente, che il file sia completo e che l'immagine corrisponda alla piattaforma desiderata.
Decisione: Se l'immagine è mancante, continuare con la risoluzione dei problemi di trasferimento. Se l'immagine è presente, passare all'attivazione, alla selezione di avvio, allo stato del pacchetto o alla convalida successiva all'aggiornamento.
Obiettivo: Posizionate l'errore nel punto corretto della timeline.
Classificazione: Scomporre il problema in uno dei seguenti punti: prima del riavvio, durante il riavvio o dopo il riavvio.
Decisione: Se l'errore si è verificato prima del ricaricamento, attivare la logica di installazione, le impostazioni di avvio e l'orchestrazione delle attività. Se il problema si è verificato durante il riavvio, controllare l'output della console, il motivo del riavvio e il comportamento di avvio. Se l'errore si è verificato dopo il ricaricamento, è necessario concentrarsi sul rediscovery, la sincronizzazione della conformità, l'integrità dello stack e il ripristino dei servizi.
Obiettivo: Verificare che il dispositivo sia stabile prima di eseguire di nuovo qualsiasi operazione.
Conferma: Verificare che la modalità software sia compresa, che le variabili di avvio siano corrette, che lo storage sia integro, che lo stato di installazione non sia incompleto, che lo stato di stack o HA sia normale e che nessuna operazione di installazione precedente sia ancora attiva.
Criteri di uscita: Non riprovare fino a quando tutti questi controlli non saranno stati risolti o non si dispone di un motivo documentato per procedere.
Obiettivo: Riduzione dei rischi senza compromettere lo sviluppo del caso.
Inizia con: Aggiornare l'inventario, rieseguire la conformità, esaminare i log, correggere le variabili di avvio o eseguire il commit di un pacchetto se l'attivazione è già riuscita.
Guida: Non passare agli aggiornamenti del database o alla pulizia forzata a meno che i normali controlli non mostrino già che l'attività è obsoleta e che il dispositivo non sia più attivo nel flusso di lavoro.
Obiettivo: Impostare un punto di decisione chiaro prima del prossimo tentativo.
Riprova solo quando: Il problema corrente è noto, il dispositivo è integro, nessuna attività in conflitto è ancora aperta, l'immagine e l'assegnazione sono corrette e le modifiche di ripristino sono state salvate e convalidate.
Decisione: Se queste condizioni non vengono soddisfatte, interrompere il percorso dei tentativi e passare all'escalation con le prove già raccolte.
show version
show boot
show install summary
show install log detail
show logging
show switch
show redundancy
dir flash:
dir bootflash:
| Revisione | Data di pubblicazione | Commenti |
|---|---|---|
1.0 |
17-Jun-2026
|
Versione iniziale |