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:

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

2. Verifique se o caminho de upgrade está listado como suportado na Matriz de Compatibilidade do Cisco ISSU.

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

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

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

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

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

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

9. Confirme se a saída do comando show issu state detail indica que nenhuma operação do ISSU está em andamento.

Por exemplo:

switch# show issu state detail
Current ISSU Status: Enabled       
Previous ISSU Operation: N/A
<snip>
No ISSU operation is in progress <<<<<<<<<

Execute estes comandos para ajudar 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 comando show issu state detail mostra 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: Execute show issue state detail e procure:

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 o comando install abort issu.

Se o ISSU ainda estiver em andamento após a tentativa de abortar a operação do ISSU, execute as próximas etapas:

Execute o comando install remove inative:

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

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. Este erro de lista de comandos (MCL) incompatível "MCL-Terminando a operação atual do ISSU" pode aparecer:

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 o comando show redundancy config-sync failures historical mcl e remova os comandos incompatíveis, se possível. Se os comandos não puderem ser removidos, execute uma atualização padrão. 

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

• Sintoma: ISSU não prossegue ou é revertido para 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 o comando show version. 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.

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, monitore a operação do ISSU até que ele seja concluído ou revertido na duração documentada para a plataforma e a versão.

• Solução: Se a operação não avançar dentro desse período, use o procedimento de recuperação na seção Estado de ISSU travado em andamento. Verifique se nenhuma operação de ISSU ou instalação permanece ativa e se todas as unidades redundantes executam uma versão de software consistente. Em seguida, use o procedimento de atualização padrão.

Switch ou Supervisor entra no modo ROMMON

• Verificação: Use o console para se conectar à unidade afetada e verifique o status.
• Solução: Procure o arquivo de imagem .bin do Cisco IOS XE 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
• Atualizando os Switches Catalyst 9500
• Atualizando os Switches Catalyst 9400   
• Suporte técnico e downloads da Cisco

Histórico de revisões

Revisão	Data de publicação	Comentários
2.0	09-Sep-2026	Formatação, etapas sequenciais, cabeçalhos.
1.0	11-Jul-2025	Versão inicial