Ce document décrit le dépannage du SWIM, avec des vérifications pratiques, des étapes de récupération claires et les informations requises pour la vérification avant l'escalade.
Dans ce document, CatC signifie Cisco Catalyst Center (CatC) et SWIM signifie Software Image Management (SWIM).
Avant d'effectuer une modification, assurez-vous que l'accès à la console ou à la gestion est disponible, que l'image cible est correcte, qu'un chemin de désinstallation existe, que le périphérique n'exécute pas déjà une autre opération d'installation et que la modification est approuvée.
L'interface utilisateur graphique fournit un contexte utile avant de passer à l'interface CLI ou aux vérifications de base de données.
Cette révision doit être l'une des premières vérifications avant le dépannage de la distribution ou de l'activation des images.

Flux d'examen TAC recommandé :

Ce que le TAC vérifie :
Pourquoi cette étape est-elle importante : Cette étape vous aide à détecter les erreurs de sélection d'image plus tôt. Elle vous permet également d'expliquer si la mise à niveau a été motivée par la conformité, l'alignement du cycle de vie ou un avis de sécurité.
Si le mode FIPS est activé, l'importation d'image basée sur URL doit être limitée par les contrôles de sécurité de la plate-forme. Dans ce cas, utilisez une méthode d'importation prise en charge, telle que Cisco.com ou un téléchargement de fichier local, puis vérifiez que les métadonnées d'image et la somme de contrôle sont correctement renseignées après l'importation.
![]() |
![]() |

Si un serveur de distribution distant est configuré sous System > Settings > Device Settings > Image Distribution Servers, incluez-le dans votre analyse depuis le début du cas. Elle peut affecter la méthode de transfert, la synchronisation du transfert, le comportement de la zone de transit et le point de défaillance réel pendant la distribution de l'image.

Ce que le TAC vérifie :
Pourquoi cela est important :
Lorsqu'un serveur de distribution distant est en cours d'utilisation, le chemin de l'image n'est plus un simple transfert de contrôleur à périphérique. Une panne est causée par le serveur externe, la préférence de protocole, l'accessibilité, le transfert d'image ou la disponibilité côté serveur plutôt que par le périphérique lui-même.
Flux de validation TAC recommandé :
Problèmes courants du TAC à surveiller :
Avant le dépannage approfondi, collectez :
Ordre de collecte TAC recommandé :
Pourquoi cela est important : La collecte précoce de ces informations réduit les allers-retours lors de la transmission des problèmes et aide le TAC à déterminer si le problème est lié à la sélection d'images, à l'orchestration des tâches, à la compatibilité de la plate-forme ou à l'état du périphérique.
Vérifiez ces éléments dans l'interface utilisateur graphique :
Ordre de validation TAC recommandé :
Pourquoi cela est important : Ces vérifications aident le TAC à déterminer si le problème est causé par la sélection d'image, l'affectation, la gestion des tâches du contrôleur, la synchronisation de l'inventaire ou le périphérique lui-même.
Exécutez uniquement les commandes adaptées au mode plate-forme et logiciel.
Ces commandes d'installation sont particulièrement utiles lors de l'analyse de la mise à niveau de SWIM. La commande show tech installcommand offre un aperçu technique général du processus d'installation et est généralement utilisée pour recueillir des preuves globales liées à l'installation à des fins de révision ou de remontée. La commande show platform software install-manager switch X R0 operation history detail affiche l'historique détaillé des opérations du gestionnaire d'installation pour un membre spécifique de la pile et permet de confirmer les étapes terminées et l'emplacement de l'échec du processus. La commande show platform software install-manager switch X R0 operation current detail affiche l'état d'installation en direct pour ce commutateur et est utile lorsque la mise à niveau semble bloquée ou est toujours en cours d'exécution. La commande archive de suivi du logiciel de la plate-forme de requête collecte les données de suivi du logiciel de la plate-forme pour une analyse plus approfondie, tandis que la commande d'archivage du commutateur d'emplacement de suivi du logiciel de la plate-forme de requête X collecte les mêmes données de suivi pour un membre de pile spécifique. Ensemble, ces commandes aident les équipes à comprendre ce qui s'est passé pendant l'installation, ce qui se passe actuellement et quelles preuves doivent être collectées pour une analyse plus approfondie.
show tech install
show platform software install-manager switch X R0 operation history detail(stack)
show platform software install-manager switch X R0 operation current detail(stack)
request platform software trace archive
request platform software trace slot switch X archive(stack)
show version
afficher l'inventaire
show platform
show boot
show running-config | inclure le système de démarrage
show startup-config | inclure le système de démarrage
show file systems
dir flash :
dir bootflash:
Utilisez ces commandes pour confirmer la version actuelle, les paramètres de démarrage et le stockage disponible.
show install summary
show install active
show install validé
show install log detail
show install request
Ces commandes vous aident à vérifier si une installation précédente est toujours en cours d'exécution, incomplète ou non validée.
show logging
show logging | include INSTALL|install|BOOT|boot|ERROR|FAIL|ROMMON
show archive log config all
show reload
show tech-support
show switch
show switch detail
show redundancy
show platform software status control-processor brief
show platform software package status
ping <gateway-or-management-peer>
Show ip interface brief (afficher un aperçu de l’interface IP)
show interfaces status
show processes cpu sorted | exclure 0,00
show processes memory sorted
show file systems
dir flash :
dir bootflash:
show logging | inclure SCP|SFTP|HTTP|TFTP|copy|transfer|flash
show processes cpu sorted | exclure 0,00
Vérifiez qu'il y a suffisamment d'espace libre, vérifiez si le chemin de gestion est stable et supprimez les anciens fichiers uniquement après avoir vérifié qu'ils ne sont pas utilisés.
Actions de GUI : Ouvrez la tâche qui a échoué, vérifiez que le périphérique est toujours géré, confirmez que l'image est toujours présente dans le référentiel, vérifiez si un serveur de distribution distant est en cours d'utilisation, puis réessayez uniquement lorsque le stockage, les informations d'identification et le chemin de transfert semblent corrects.
show version
show boot
show running-config | inclure le système de démarrage
show startup-config | inclure le système de démarrage
show install summary
Vérifiez si les variables de démarrage pointent toujours vers l'ancienne image. Corrigez le chemin d'amorçage si nécessaire, puis enregistrez la configuration avant de redémarrer.
configuration de terminalno boot systembroot system flash:<target-image.bin>endwrite memoryshow boot
Actions de GUI : Passez en revue le calendrier des tâches, vérifiez si le périphérique est revenu après le rechargement, exécutez la synchronisation d'inventaire si la version de l'interface graphique utilisateur est périmée, et vérifiez les vérifications d'activation et les paramètres de nettoyage avant de réessayer.
show install summary
show install active
show install validé
show install log detail
show logging | include install|INSTALL
Vérifiez si le package est déjà actif mais pas validé. Ne démarrez pas une autre installation avant d'avoir compris l'état actuel.
install commit
Vérifiez d'abord si une image, dont le fonctionnement a été vérifié, est toujours disponible localement et utilisez la méthode de récupération ROMMON approuvée pour cette plate-forme.
dir flash :
boot flash:<image-correcte-connue.bin>
show version
show boot
configurer le terminal
pas de système de démarrage
boot system flash:<image-correcte-connue.bin>
tranche
mémoire d'écriture
show switch
show switch detail
show version
dir flash :
show install summary
show logging | inclure le commutateur|version|installer
Vérifiez que tous les membres sont présents, vérifiez la disponibilité de l'image sur tous les membres et réessayez uniquement lorsque la pile complète est saine.
show version
afficher l'inventaire
show running-config | inclure le système de démarrage
Si la version du périphérique est correcte, suspectez des données d'inventaire ou de conformité périmées avant de les considérer comme une mise à niveau ayant échoué.
Actions de GUI : Actualisez l'enregistrement du périphérique, réexécutez la conformité, confirmez que le mappage de l'image dorée est toujours correct et consultez l'historique des tâches pour confirmer la version cible attendue.
dir flash :
dir bootflash:
delete /force flash:<image-inutilisée.bin>
delete /force /recursive flash:<répertoire-package-inutilisé>
show boot
configurer le terminal
pas de système de démarrage
boot system flash:<image-cible.bin>
tranche
mémoire d'écriture
show boot
recharger
show install summary
install commit
show install validé
show version
show boot
show install summary
show logging | queue
Show ip interface brief (afficher un aperçu de l’interface IP)
13. Workflow TAC
Utilisez ce workflow après les vérifications principales de l'interface utilisateur graphique et de la CLI. Considérez-le comme la séquence de travail d'un cas TAC en direct.
Objectif: Déterminez si le problème a commencé dans Catalyst Center, dans le chemin de transfert ou sur le périphérique.
Contrôles en cours : Vérifiez les détails des tâches, les horodatages, l'état de l'inventaire et l'accessibilité des périphériques. Séparez dès que possible les pannes du contrôleur des pannes de transfert et des pannes du périphérique.
Décision : Si la tâche a échoué avant que l'image n'atteigne le périphérique, restez concentré sur l'inventaire, les informations d'identification, l'état du référentiel et le chemin de transfert. Si la copie de l'image a réussi mais que l'activation a échoué, passez aux variables de démarrage, à l'état d'installation et aux journaux des périphériques.
Objectif: Créez un calendrier d'échec propre.
Saisir: Notez le texte exact de l'erreur GUI, l'ID de la tâche, l'horodatage de l'échec et les détails de la tâche enfant, le cas échéant.
Pourquoi cela est important : les données doivent correspondre à l'événement GUI avec les journaux des périphériques, les journaux SWIM et les enregistrements de base de données.
Objectif: Déterminez s'il s'agit d'un problème lié à un périphérique unique ou à une plate-forme plus large.
Vérifier : Déterminez si le problème affecte un périphérique, une pile, un site, une famille de plates-formes ou plusieurs périphériques dans l'environnement.
Décision : Si la même panne apparaît sur plusieurs périphériques, suspectez la qualité de l'image, la compatibilité de la plate-forme, l'état du référentiel, les informations d'identification ou le traitement des tâches côté contrôleur avant de blâmer un périphérique.
Objectif: Recherchez la dernière étape qui s'est terminée correctement.
Piste : Parcourez le workflow à travers l'importation d'images, l'affectation, la distribution, l'activation, le rechargement et la synchronisation post-mise à niveau.
Pourquoi cela est important : Cela vous évite de répéter des étapes qui ont déjà fonctionné et vous aide à rester concentré sur le point de défaillance réel.
Objectif: Vérifiez si l'étape de transfert est réellement terminée.
Vérifications : Vérifiez si l'image est présente sur la mémoire flash : ou bootflash : , vérifiez qu'il y a suffisamment d'espace libre, que le fichier est complet et que l'image correspond à la plate-forme voulue.
Décision : Si l'image est manquante, poursuivez le dépannage du transfert. Si l'image est présente, passez à l'activation, à la sélection du démarrage, à l'état du package ou à la validation post-mise à niveau.
Objectif: Placez l'échec au bon endroit dans la chronologie.
Classer : Divisez le problème en l'un des points suivants : avant rechargement, pendant rechargement ou après rechargement.
Décision : Si la défaillance s'est produite avant le rechargement, concentrez-vous sur la logique d'installation, les paramètres de démarrage et l'orchestration des tâches. Si cela s'est produit pendant le rechargement, vérifiez le résultat de la console, la raison du rechargement et le comportement de démarrage. Si cela s'est produit après le rechargement, concentrez-vous sur la redécouverte, la synchronisation de conformité, l'intégrité de la pile et la récupération du service.
Objectif: Assurez-vous que le périphérique est stable avant de réexécuter quoi que ce soit.
Confirmer : Vérifiez que le mode logiciel est compris, que les variables de démarrage sont correctes, que le stockage est sain, que l'état d'installation n'est pas incomplet, que l'état de pile ou de haute disponibilité est normal et qu'aucune opération d'installation précédente n'est toujours active.
Critères de sortie : Ne recommencez pas tant que toutes ces vérifications ne sont pas terminées ou que vous n'avez pas de raison documentée de continuer.
Objectif: Réduisez les risques tout en continuant à faire avancer le dossier.
Commencez par : Actualisation de l'inventaire, réexécution de la conformité, examen des journaux, correction des variables de démarrage ou validation d'un package si l'activation a déjà réussi.
Conseils : Ne passez pas aux mises à jour de base de données ou au nettoyage forcé à moins que les vérifications normales n'indiquent déjà que la tâche est périmée et que le périphérique n'est plus actif dans le workflow.
Objectif: Définissez un point de décision clair avant la prochaine tentative.
Réessayer uniquement lorsque : Le problème actuel est bien compris, le périphérique est sain, aucune tâche conflictuelle n'est encore ouverte, l'image et l'affectation sont correctes et les modifications de récupération ont été enregistrées et validées.
Décision : Si ces conditions ne sont pas remplies, arrêtez le chemin de nouvelle tentative et passez à l'escalade avec les preuves que vous avez déjà collectées.
show version
show boot
show install summary
show install log detail
show logging
show switch
show redundancy
dir flash:
dir bootflash:
| Révision | Date de publication | Commentaires |
|---|---|---|
1.0 |
17-Jun-2026
|
Première publication |