Troubleshooting de Falhas de Atualização de ISSU em Catalyst 9000 Series Switches

Introdução

Este documento descreve como identificar e resolver problemas comuns durante as atualizações do ISSU nos Cisco Catalyst 9000 Series Switches.

Pré-requisitos

Requisitos

A Cisco recomenda que você tenha conhecimento destes tópicos:

• Arquitetura e modelos de implantação do Cisco Catalyst 9000 Series

• Atualizações de manutenção de software (SMU) e processo ISSU

• Tecnologias StackWise Virtual e StackWise

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

• Cisco Catalyst 9400, 9500, and 9600 Series Switches

• Cisco IOS® XE 

• Implantações duplas de supervisor e StackWise Virtual

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Informações de Apoio

O In-Service Software Upgrade (ISSU) permite a atualização do software do switch enquanto a rede permanece operacional. Várias condições devem existir para que o ISSU tenha êxito: o caminho do software deve ser suportado, os membros da pilha devem executar versões correspondentes e o firmware deve ser alinhado. Se essas condições não forem atendidas, a atualização poderá ser interrompida ou a rede poderá ficar instável.

Executar verificações iniciais antes da atualização do ISSU

Antes do upgrade do ISSU começar, certifique-se de que estas verificações:

• Confirme se as versões atual e desejada do Cisco IOS XE suportam ISSU.

• Verifique se o caminho de atualização está listado como suportado na Matriz de compatibilidade do Cisco ISSU.

• Verifique se todos os membros da pilha ou supervisores executam a mesma imagem de software.

• Certifique-se de que os supervisores ativo e standby usem as mesmas versões do ROMMON.

• Confirme se o switch opera no modo de instalação (a variável de inicialização deve ser packages.conf).

• Revise a disponibilidade de memória e espaço flash para a nova imagem.

• Verifique se o switch não está em um estado degradado ou não redundante.

• Valide se não existem falhas ativas, alarmes de hardware ou registros críticos.

• Confirme se nenhuma operação ISSU anterior está em andamento usando o comandoshow issu state detail. A saída deve indicar:

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

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

Caution: Se o ISSU já estiver em andamento, não inicie outro upgrade.

Execute estes comandos para auxiliar na validação:

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

Solucionar falhas comuns de atualização de ISSU

Estado ISSU travado em andamento

Sintoma: O comandoshow issu state detailmostra que o ISSU está em andamento mesmo que a atualização não tenha sido concluída ou tenha falhado explicitamente. Essa condição pode bloquear novas tentativas de ISSU e interromper os fluxos de trabalho normais de atualização.

A mensagem de erro ISSU in progress pode ser exibida:

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

Verificação: Executar show issu state detail e procurar:

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

Se o status permanecer em andamento sem alteração durante um período prolongado, o processo provavelmente será interrompido.

Causa raiz: interrupção inesperada durante uma tentativa anterior de ISSU ou falha de incompatibilidade.

Solução: Execute oinstall abort issucomando.

Se o ISSU ainda estiver em andamento, execute as próximas etapas:

Executarinstall remove inactivecomando.

Switch#install remove inactive 

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

install_remove: Removing IMG

Cleaning up unnecessary package files

Habilitar serviço interno:

switch(config)# service internal

Limpar o estado de instalação atual:

switch#clear install state

Caution: Esse comando pode acionar uma recarga de todo o switch ou da pilha.

aviso: Nunca inicie outro ISSU enquanto um estiver ativo. Isso pode levar à corrupção do software ou instabilidade do dispositivo.

Compatibilidade de configuração entre versões

Sintoma:Determinadas configurações não são compatíveis com a nova versão do software e podem causar problemas durante a atualização. A mensagem de erro "MCL-Terminando a operação atual do ISSU" pode ser exibida:

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

Solução: Execute oshow redundancy config-sync failures historic mclcomando e remova os comandos incompatíveis, se possível. Se os comandos não puderem ser removidos, execute uma atualização padrão. 

Note: Verifique se não há atualização de ISSU em andamento para iniciar uma nova atualização. Consulte a seção Estado ISSU travado em andamento.

Incompatibilidade Devido a Incompatibilidade de Versão de Software ou ROMMON

Sintoma: O ISSU falha ao continuar ou reverte para o recarregamento não ISSU. Este erro pode ser exibido:

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

• Verificação: Compare as versões do Cisco ROMMON e do Cisco IOS usando oshow versioncomando. Em sistemas com SUP duplo, confirme se ambos os SUPs usam as mesmas versões de firmware e software.

• Solução: Atualize o Cisco ROMMON ou o Cisco IOS para a mesma versão antes de iniciar o ISSU.

Note: Consulte as notas de versão específicas da plataforma para obter as etapas de upgrade do ROMMON.

Recuperação a partir do upgrade parcial do ISSU ou modo ROMMON

Atualização parcial

• Verificação: Para uma atualização parcial, verifique se nenhuma atualização de ISSU ainda está em andamento. Se o ISSU ainda estiver em andamento, aguarde alguns minutos até que ele seja concluído ou revertido.

• Solução: Consulte a seção Estado ISSU travado em andamento se a atualização não for concluída. Em seguida, execute uma atualização padrão. 

O switch ou o supervisor entra no modo ROMMON

• Verificação: Use o console para se conectar à unidade afetada e verifique o status.
• Solução: Procure o arquivo Cisco IOS.bin ou o arquivo packages.conf para recuperar o switch ou o supervisor; consulte o Guia ROMMON para obter etapas detalhadas para recuperar a unidade. 

Informações Relacionadas

• Matriz de compatibilidade do ISSU
• Guia de atualização do ISSU
• Guia de atualização para switches Catalyst 9000
• Solução de problemas do Rommon no Catalyst 9000
• Suporte técnico e downloads da Cisco