Dépannage des échecs de mise à niveau ISSU sur les commutateurs de la gamme Catalyst 9000

Introduction

Ce document décrit comment identifier et résoudre les problèmes courants lors des mises à niveau ISSU sur les commutateurs de la gamme Cisco Catalyst 9000.

Conditions préalables

Exigences

Cisco vous recommande de prendre connaissance des rubriques suivantes :

• Architecture et modèles de déploiement de la gamme Cisco Catalyst 9000

• Mises à niveau de maintenance logicielle (SMU) et processus ISSU

• Technologies StackWise Virtual et StackWise

Composants utilisés

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

• Commutateurs Cisco Catalyst 9400, 9500 et 9600

• Cisco IOS® XE 

• Déploiements virtuels StackWise et double superviseur

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Informations générales

La mise à niveau logicielle en service (ISSU) permet de mettre à niveau le logiciel du commutateur tout en maintenant le réseau opérationnel. Plusieurs conditions doivent être réunies pour que ISSU réussisse : le chemin d'accès du logiciel doit être pris en charge, les membres de la pile doivent exécuter les versions correspondantes et le micrologiciel doit être aligné. Le non-respect de ces conditions peut interrompre la mise à niveau ou provoquer une instabilité du réseau.

Effectuer les vérifications initiales avant la mise à niveau ISSU

Avant de commencer la mise à niveau ISSU, vérifiez les points suivants :

• Vérifiez que les versions actuelles et cibles de Cisco IOS XE prennent en charge ISSU.

• Vérifiez que le chemin de mise à niveau est indiqué comme étant pris en charge dans la matrice de compatibilité ISSU de Cisco.

• Vérifiez que tous les membres ou superviseurs de la pile exécutent la même image logicielle.

• Assurez-vous que les superviseurs actifs et en veille utilisent les mêmes versions ROMMON.

• Vérifiez que le commutateur fonctionne en mode d'installation (la variable de démarrage doit être packages.conf).

• Vérifiez la mémoire et la disponibilité de l'espace flash pour la nouvelle image.

• Vérifiez que le commutateur n'est pas dans un état dégradé ou non redondant.

• Vérifiez qu'il n'existe aucune défaillance active, alarme matérielle ou journal critique.

• Vérifiez qu'aucune opération ISSU précédente n'est en cours à l'aide de la commandeshow issu state detail. Le résultat doit indiquer :

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

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

Mise en garde : Si l'ISSU est déjà en cours, ne lancez pas une autre mise à niveau.

Exécutez ces commandes pour faciliter la validation :

• show boot system
• show issu state detail
• show redundancy
• show module

Dépannage des échecs de mise à niveau ISSU courants

État ISSU bloqué en cours

Symptôme : La commandeshow issu state detailmontre que l'ISSU est en cours même si la mise à niveau n'est pas terminée ou a échoué explicitement. Cette condition peut bloquer d'autres tentatives ISSU et perturber les workflows de mise à niveau normaux.

Le message d'erreur ISSU en cours peut s'afficher :

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

Vérification : Exécutez show issu state detail et recherchez :

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

Si l'état reste en cours sans modification sur une période prolongée, le processus est probablement bloqué.

Cause première : interruption inattendue lors d'une précédente tentative ISSU ou échec d'incompatibilité.

Solution : Exécutez la commande .install abort issu

Si l'ISSU est toujours en cours, procédez comme suit :

Exécutez la commandeinstall remove inactive.

Switch#install remove inactive 

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

install_remove: Removing IMG

Cleaning up unnecessary package files

Activer le service interne :

switch(config)# service internal

Effacer l'état d'installation actuel :

switch#clear install state

Mise en garde : Cette commande peut déclencher un rechargement de l'ensemble du commutateur ou de la pile.

Avertissement : Ne démarrez jamais un autre ISSU tant qu'il est actif. Cela peut entraîner une corruption du logiciel ou une instabilité du périphérique.

Compatibilité de la configuration entre les versions

Symptôme : certaines configurations ne sont pas compatibles avec la nouvelle version du logiciel et peuvent entraîner des problèmes lors de la mise à niveau. Le message d'erreur « MCL-Terminating the current ISSU Operation » peut s'afficher :

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

Solution : Exécutez lashow redundancy config-sync failures historic mclcommande et supprimez les commandes incompatibles si possible. Si les commandes ne peuvent pas être supprimées, effectuez une mise à niveau standard. 

Remarque : Vérifiez qu'aucune mise à niveau ISSU n'est en cours pour lancer une nouvelle mise à niveau. Reportez-vous à la section État ISSU bloqué en cours.

Incompatibilité due à ROMMON ou incompatibilité de version logicielle

Symptôme : ISSU ne poursuit pas ou revient à un rechargement non ISSU. Cette erreur peut apparaître :

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

• Vérification :show versionComparez les versions de Cisco ROMMON et de Cisco IOS à l’aide de la commande. Dans les systèmes à double SUP, vérifiez que les deux SUP utilisent les mêmes versions de microprogramme et de logiciel. Dans les systèmes à double SUP, vérifiez que les deux SUP utilisent les mêmes versions de microprogramme et de logiciel.

• Solution : Mettez à niveau Cisco ROMMON ou Cisco IOS vers la même version avant de lancer ISSU.

Remarque : Reportez-vous aux notes de version spécifiques à la plate-forme pour connaître les étapes de mise à niveau ROMMON.

Récupération à partir de la mise à niveau partielle ISSU ou du mode ROMMON

Mise à niveau partielle

• Vérification : pour une mise à niveau partielle, vérifiez qu'aucune mise à niveau ISSU n'est toujours en cours. Si l'ISSU est toujours en cours, attendez quelques minutes qu'il se termine ou qu'il revienne en arrière.

• Solution : Reportez-vous à la section État ISSU bloqué en cours si la mise à niveau ne se termine pas. Effectuez ensuite une mise à niveau standard. 

Le commutateur ou le superviseur passe en mode ROMMON

• Vérification : Accédez à l'unité concernée par la console et vérifiez son état.
• Solution : Recherchez le fichier Cisco IOS.bin ou le fichier packages.conf pour récupérer le commutateur ou le superviseur. Reportez-vous au Guide ROMMON pour connaître les étapes détaillées de récupération de l'unité. 

Informations connexes

• Matrice de compatibilité ISSU
• Guide de mise à niveau ISSU
• Guide de mise à jour pour les commutateurs Catalyst 9000
• Dépannage de Rommon sur Catalyst 9000
• Assistance technique de Cisco et téléchargements