Alterar Modos de Instalação no Catalyst 9800 Wireless Controller

Introdução

Este documento descreve como alterar entre os diferentes tipos de modos de instalação em um Catalyst 9800 Wireless Controller (WLC).

Pré-requisitos

Requisitos

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

• Plataformas de Access Points (APs) e controladores de LAN sem fio Catalyst 9800

• Conjuntos de recursos de software dos controladores de LAN sem fio Catalyst 9800

Componentes Utilizados

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

• C9800-L Versão 17.15.5

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 

Use este documento para aprender como converter entre os diferentes tipos de modos de instalação em um Catalyst 9800 Wireless Controller (WLC) através da Interface de Linha de Comando (CLI). 

Esse procedimento também pode ser usado para fazer o upgrade do WLC 9800.

Há duas maneiras pelas quais você pode executar o Cisco IOS® XE em um Catalyst 9800 WLC, no modo de pacote e no modo de instalação.

Modo de instalação

O modo de instalação usa arquivos .pkg pré-extraídos do arquivo binário em flash para inicializar o controlador desbloqueando vários recursos arquiteturais críticos que não estão disponíveis no modo de pacote. O controlador usa o packages.conf arquivo que foi criado a partir da extração como variável de inicialização. Usando este modo, o controlador experimenta tempos de inicialização mais rápidos e consome menos RAM do que o modo de pacote. 

Tip: O modo de instalação é o modo recomendado para executar a WLC. Esse modo é necessário para a Atualização de Manutenção de Software (SMU), o Service Pack de Ponto de Acesso (APSP), a correção do Pacote de Dispositivo AP (APDP) e as Atualizações de Software em Serviço (ISSU).

Modo de pacote

O sistema funciona no modo de pacote se o controlador inicializar com a imagem binária (.bin) como variável de inicialização. Neste modo, o controlador extrai o arquivo .bin na RAM e executa a partir daí.

Esse modo usa mais memória do que o modo de instalação porque os pacotes extraídos da inicialização são copiados para a RAM.

Note: Antes da configuração de alta disponibilidade (HA SSO) na WLC 9800, verifique se ambos os dispositivos têm o mesmo modo de instalação. Caso contrário, você pode enfrentar um erro de incompatibilidade de V: %BOOT-3-BOOTTIME_INCOMPATIBLE_SW_DETECTED: R0/0: issu_stack: Incompatible software detected.

Antes de Começar

Verifique o modo de operação da WLC 9800 para determinar qual procedimento você deve executar para converter entre modos.

Execute o show version | include Installation mode comando para ver o modo de instalação atual.

WLC#show version | include Installation mode
Installation mode is INSTALL

Configurar

Do modo de instalação para o modo de pacote

Procedimento CLI

Etapa 1. Certifique-se de que haja espaço suficiente na memória flash para expandir uma nova imagem.

WLC#show bootflash:
...
277 42838080 Oct 08 2025 14:22:06.0000000000 +00:00 wlc9500C-rpboot.2025-10-05_08.14_prabhask.SSA.pkg
279 19921673 Dec 13 2025 19:27:45.0000000000 +00:00 system-report_20251213-192546-Pacific.tar.gz
235937792 bytes available (5746528256 bytes used)

Etapa 2. Limpar arquivos de instalação antigos em caso de espaço insuficiente e para descartar pacotes adicionados antigos.

WLC#install remove inactive 
install_remove: START Mon Jun 08 22:31:01 Central 2026
install_remove: Removing IMG
Cleaning up unnecessary package files
No path specified, will use booted path /tmp/sw/isos/packages.conf

Cleaning /bootflash
Scanning boot directory for packages ... done.
Preparing packages list to delete ...
[R0]: /bootflash/C9800-L-universalk9_wlc.17.15.05.SPA.bin File is in use, will not delete.
[R0]: /bootflash/C9800-L-universalk9_wlc.17.15.05.SPA.conf File is in use, will not delete.

The following files will be deleted:
[R0]: /bootflash/packages.conf
[R0]: /bootflash/C9800-L-universalk9_wlc.17.12.04.Cisco bug ID CSCwn02956 .SPA.apsp.bin
[R0]: /bootflash/C9800-L-rommon.1612-3r.pkg
[R0]: /bootflash/C9800-L-universalk9_wlc.17.15.03.SPA.bin
[R0]: /bootflash/C9800-L-mono-universalk9_wlc.17.15.03.SPA.pkg
[R0]: /bootflash/C9800-L-universalk9_wlc.17.15.03.SPA.conf
[R0]: /bootflash/C9800-L-rpboot.17.15.03.SPA.pkg
[R0]: /bootflash/C9800-L-universalk9_wlc.17.09.06.SPA.bin
[R0]: /bootflash/C9800-L-mono-universalk9_wlc.17.09.06.SPA.pkg
[R0]: /bootflash/C9800-L-rpboot.17.09.06.SPA.pkg
[R0]: /bootflash/C9800-L-universalk9_wlc.17.09.06.SPA.conf
[R0]: /bootflash/C9800-L-universalk9_wlc.17.15.03.Cisco bug ID CSCwp18505 .SPA.apsp.bin
[R0]: /bootflash/C9800-L-mono-universalk9_wlc.17.12.04.SPA.pkg
[R0]: /bootflash/C9800-L-rpboot.17.12.04.SPA.pkg
[R0]: /bootflash/C9800-L-mono-universalk9_wlc.17.15.05.SPA.pkg
[R0]: /bootflash/C9800-L-rpboot.17.15.05.SPA.pkg

Do you want to remove the above files? [y/n]y

Deleting file /bootflash/packages.conf ... done.
Deleting file /bootflash/C9800-L-universalk9_wlc.17.12.04.Cisco bug ID CSCwn02956 .SPA.apsp.bin ... done.
Deleting file /bootflash/C9800-L-rommon.1612-3r.pkg ... done.
Deleting file /bootflash/C9800-L-universalk9_wlc.17.15.03.SPA.bin ... done.
Deleting file /bootflash/C9800-L-mono-universalk9_wlc.17.15.03.SPA.pkg ... done.
Deleting file /bootflash/C9800-L-universalk9_wlc.17.15.03.SPA.conf ... done.
Deleting file /bootflash/C9800-L-rpboot.17.15.03.SPA.pkg ... done.
Deleting file /bootflash/C9800-L-universalk9_wlc.17.09.06.SPA.bin ... done.
Deleting file /bootflash/C9800-L-mono-universalk9_wlc.17.09.06.SPA.pkg ... done.
Deleting file /bootflash/C9800-L-rpboot.17.09.06.SPA.pkg ... done.
Deleting file /bootflash/C9800-L-universalk9_wlc.17.09.06.SPA.conf ... done.
Deleting file /bootflash/C9800-L-universalk9_wlc.17.15.03.Cisco bug ID CSCwp18505 .SPA.apsp.bin ... done.
Deleting file /bootflash/C9800-L-mono-universalk9_wlc.17.12.04.SPA.pkg ... done.
Deleting file /bootflash/C9800-L-rpboot.17.12.04.SPA.pkg ... done.
Deleting file /bootflash/C9800-L-mono-universalk9_wlc.17.15.05.SPA.pkg ... done.
Deleting file /bootflash/C9800-L-rpboot.17.15.05.SPA.pkg ... done.
Deleting /flash/.images/17.15.02.0.4538.1732779336 ... /flash/.images/17.15.05.0.8370.1771573356 done.
Deleting /flash/.images/17.12.04.0.31.1732211533 ... /flash/.images/17.15.05.0.8370.1771573356 done.
Deleting /flash/.images/17.15.03.0.5635.1742971301 ... /flash/.images/17.15.05.0.8370.1771573356 done.
SUCCESS: Files deleted.

--- Starting Post_Remove_Cleanup ---
Performing REMOVE_POSTCHECK on all members
Finished Post_Remove_Cleanup
SUCCESS: install_remove Mon Jun 08 22:31:17 Central 2026

WLC#dir bootflash: | i bytes 
26458804224 bytes total (18033250304 bytes free)

Etapa 3. Copie a nova imagem para a memória flash.

WLC#copy tftp: bootflash:
Address or name of remote host []? 10.152.200.238
Source filename []? C9800-L-universalk9_wlc.17.15.05.SPA.bin
Destination filename [C9800-L-universalk9_wlc.17.15.05.SPA.bin]?
Accessing tftp://10.152.200.238/C9800-L-universalk9_wlc.17.15.05.SPA.bin...
Loading C9800-L-universalk9_wlc.17.15.05.SPA.bin from 10.152.200.238 (via Vlan210): !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Etapa 4. Confirme se a imagem foi copiada com êxito para a memória flash e verifique a integridade da imagem.

WLC#dir bootflash:*.bin
Directory of bootflash:/*.bin
Directory of bootflash:/
 95 -rw- 1635303343 Jun 5 2026 23:24:36 +00:00 C9800-L-universalk9_wlc.17.15.05.SPA.bin.SPA.bin

WLC#verify /md5 bootflash:C9800-L-universalk9_wlc.17.15.05.SPA.bin
........................................................................
........................................................................
........................................................................
........................................................................Done!
verify /md5 (bootflash:C9800-L-universalk9_wlc.17.15.05.SPA.bin) = 9fb93d840278a5de2b454ade1016ddce

Compare o resultado com a soma de verificação MD5 fornecida nos Detalhes da versão para a imagem de destino no site de download de software da Cisco, os valores devem corresponder exatamente.

Etapa 5. Verifique a variável de inicialização atual. Se a variável estiver definida como packages.conf, a WLC está sendo executada no modo de instalação. Para converter para o modo Pacote, exclua a variável de inicialização existente e defina a imagem .bin como a nova variável de inicialização. Você deve salvar a configuração após essas alterações; caso contrário, a nova variável de inicialização não persistirá após um recarregamento.

WLC#show bootvar 
BOOT variable = bootflash:packages.conf,12;
CONFIG_FILE variable =
BOOTLDR variable does not exist
Configuration register is 0x2102
WLC#conf t
WLC(config)#no boot system 
WLC(config)#do write
WLC(config)#boot system bootflash:C9800-L-universalk9_wlc.17.15.05.SPA.bin
WLC(config)#do write
WLC(config)#end

Etapa 6. Execute este comando para verificar se a variável de inicialização está definida como bootflash:.

A saída agora é exibida BOOT variable = bootflash:.

WLC#show bootvar
BOOT variable = bootflash:C9800-L-universalk9_wlc.17.15.05.SPA.bin,12;
CONFIG_FILE variable does not exist
BOOTLDR variable does not exist
Configuration register is 0x102

Standby not ready to show bootvar

Etapa 7. Recarregue o controlador para inicializar no modo Bundle.

WLC#reload
Reload command is being issued on Active unit, this will reload the whole stack
Proceed with reload? [confirm]

Etapa 8. Monitorar o processo de inicialização da WLC para confirmar se ele inicializa no modo de pacote.

...
32768K bytes of non-volatile configuration memory.
16777216K bytes of physical memory.
26251263K bytes of eUSB flash at bootflash:.
0K bytes of Cloud S3 Storage at cloudfs:.

Base Ethernet MAC Address : FF:FF:FF:FF:FF:FF

Installation mode is BUNDLE

Procedimento de GUI

Etapa 1. Verificar o Modo atual. Navegue até Administration > Software Management > Software Upgrade, confirme se o Upgrade Mode indica que o sistema está atualmente no modo de instalação.

Etapa 2. Clique na lista suspensa disponível em Modo de atualização e selecione Pacote. Em seguida, escolha o Tipo de transporte e selecione o Caminho do arquivo para o arquivo .bin seguido de Download.

Etapa 3. Confirme o consentimento de recarregamento do sistema. Nesse momento, a conversão para o modo de pacote é iniciada. 

Etapa 4. Monitore a atualização na seção Status do lado direito e na janela pop-up Show Logs.

Etapa 5. Verificar a Imagem.

Etapa 6. Salve a configuração e confirme o recarregamento. 

Etapa 7. Monitore o recarregamento da WLC. Assim que a GUI estiver disponível, navegue para Administration > Software Management > Software Upgrade. Observe que o modo de atualização indica que o sistema está operando no modo de pacote.

Do modo de pacote para o modo de instalação

Procedimento CLI

Etapa 1. Certifique-se de que haja espaço suficiente na memória flash para expandir uma nova imagem.

WLC#dir bootflash: | i bytes free
26458804224 bytes total (9501368320 bytes free)

Etapa 2. Limpar arquivos de instalação antigos em caso de espaço insuficiente e para descartar pacotes adicionados antigos.

WLC#install remove inactive
install_remove: START Tue Jun 09 21:21:34 Central 2026
install_remove: Removing IMG
Cleaning up unnecessary package files
No path specified, will use booted path /tmp/sw/isos/packages.conf

Cleaning /bootflash
Scanning boot directory for packages ... done.
Preparing packages list to delete ...
[R0]: /bootflash/packages.conf File is in use, will not delete.
[R0]: /bootflash/C9800-L-universalk9_wlc.17.15.05.SPA.bin File is in use, will not delete.
[R0]: /bootflash/C9800-L-universalk9_wlc.17.15.05.SPA.conf File is in use, will not delete.

The following files will be deleted:
[R0]: /bootflash/C9800-L-mono-universalk9_wlc.17.15.05.SPA.pkg
[R0]: /bootflash/C9800-L-rpboot.17.15.05.SPA.pkg

Do you want to remove the above files? [y/n]y

Deleting file /bootflash/C9800-L-mono-universalk9_wlc.17.15.05.SPA.pkg ... done.
Deleting file /bootflash/C9800-L-rpboot.17.15.05.SPA.pkg ... done.
SUCCESS: Files deleted.

--- Starting Post_Remove_Cleanup ---
Performing REMOVE_POSTCHECK on all members
Finished Post_Remove_Cleanup
SUCCESS: install_remove Tue Jun 09 21:22:08 Central 2026

WLC#dir bootflash: | i bytes free
26458804224 bytes total (19666468864 bytes free)

Etapa 3. Copie a nova imagem para a memória flash.

WLC#copy tftp: flash:
Address or name of remote host []? 10.152.200.238
Source filename []? C9800-L-universalk9_wlc.17.15.05.SPA.bin
Destination filename [C9800-L-universalk9_wlc.17.15.05.SPA.bin]?
Accessing tftp://10.152.200.238/C9800-L-universalk9_wlc.17.15.05.SPA.bin...
Loading C9800-L-universalk9_wlc.17.15.05.SPA.bin from 10.152.200.238 (via Vlan210): !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Etapa 4. Confirme se a imagem foi copiada com êxito para a memória flash e verifique a integridade da imagem.

WLC#dir bootflash:*.bin
Directory of bootflash:/*.bin
Directory of bootflash:/
 95 -rw- 1635303343 Jun 5 2026 23:24:36 +00:00 C9800-L-universalk9_wlc.17.15.05.SPA.bin.SPA.bin

WLC#verify /md5 bootflash:C9800-L-universalk9_wlc.17.15.05.SPA.bin
........................................................................
........................................................................
........................................................................
........................................................................Done!
verify /md5 (bootflash:C9800-L-universalk9_wlc.17.15.05.SPA.bin) = 9fb93d840278a5de2b454ade1016ddce

Compare o resultado com a soma de verificação MD5 fornecida nos Detalhes da versão para a imagem de destino no site de download de software da Cisco, os valores devem corresponder exatamente.

Etapa 5. Verificar a variável de inicialização atual. Se a variável apontar para um arquivo .bin, o sistema está sendo executado no Modo de Pacote. A configuração manual da variável de inicialização não é necessária nesta etapa; o processo de instalação o atualiza automaticamente para  bootflash:packages.conf durante a atualização.

WLC#show bootvar
BOOT variable = bootflash:C9800-L-universalk9_wlc.17.15.05.SPA.bin,12;
CONFIG_FILE variable does not exist
BOOTLDR variable does not exist
Configuration register is 0x102
Standby not ready to show bootvar

   

Etapa 6. Imagem de instalação do software a ser flash. Para a conversão do modo Pacote para Instalação, use o comando one-shot CLI install add file bootflash: activate commit.

WLC#install add file bootflash:C9800-L-universalk9_wlc.17.15.05.SPA.bin activate commit

Etapa 7. Digite y (yes) o consentimento de recarregamento do sistema.  Quando a instalação estiver concluída, o controlador continuará a ser recarregado.

install_add_activate_commit: START Mon Jun 08 22:53:20 Central 2026
install_add: START Mon Jun 08 22:53:20 Central 2026
install_add: Adding IMG
--- Starting initial file syncing ---
Copying bootflash:C9800-L-universalk9_wlc.17.15.05.SPA.bin from Chassis 1/R0 to Chassis 1/R0
Info: Finished copying to the selected Chassis
Finished initial file syncing

--- Starting Add ---
Performing Add on all members
Checking status of Add on [1/R0]
Add: Passed on [1/R0]
Image added. Version: 17.15.05.0.8370

Finished Add

install_activate: START Mon Jun 08 22:53:59 Central 2026
install_activate: Activating IMG
Following packages shall be activated:
/bootflash/C9800-L-mono-universalk9_wlc.17.15.05.SPA.pkg
/bootflash/C9800-L-rpboot.17.15.05.SPA.pkg

This operation may require a reload of the system. Do you want to proceed? [y/n]y

--- Starting Activate ---
Performing Activate on all members
[1] Activate package(s) on Chassis 1/R0
[1] Finished Activate on Chassis 1/R0
Checking status of Activate on [1/R0]
Activate: Passed on [1/R0]
Finished Activate

--- Starting Commit ---
Performing Commit on all members
[1] Commit package(s) on Chassis 1/R0
[1] Finished Commit on Chassis 1/R0
Checking status of Commit on [1/R0]
Commit: Passed on [1/R0]
Finished Commit operation

SUCCESS: install_add_activate_commit Mon Jun 08 22:55:34 Central 2026

Initializing Hardware ...

Etapa 8. Monitorar o processo de inicialização da WLC para confirmar se ele inicializa no modo de instalação.

...
32768K bytes of non-volatile configuration memory.
16777216K bytes of physical memory.
26251263K bytes of eUSB flash at bootflash:.
0K bytes of Cloud S3 Storage at cloudfs:.

Base Ethernet MAC Address : FF:FF:FF:FF:FF:FF

Installation mode is INSTALL

Procedimento de GUI

Etapa 1. Verificar o Modo atual. Navegue até Administration > Software Management > Software Upgrade, confirme se o Upgrade Mode indica que o sistema está atualmente no modo de pacote.

Etapa 2. Clique na lista suspensa disponível em Modo de atualização e selecione Instalar. Em seguida, escolha o Tipo de transporte e selecione o Caminho do arquivo para o arquivo .bin seguido por Download e Instalação.

Etapa 3. Confirme o consentimento de recarregamento do sistema. Nesse momento, a conversão para o modo de instalação é iniciada. 

Etapa 4. Monitore a atualização na seção Status do lado direito e na janela pop-up Show Logs.

O sistema é recarregado como parte da confirmação de alteração.

Etapa 5. Monitore o recarregamento da WLC. Assim que a GUI estiver disponível, navegue para Administration > Software Management > Software Upgrade. Observe que o Modo de atualização indica que o sistema está operando no modo de instalação.

Verificar 

Use esta seção para confirmar se a sua configuração funciona corretamente. 

Após a reinicialização da controladora, você pode verificar o modo de instalação atual da controladora. Execute o show version comando para confirmar se a conversão foi bem-sucedida.

Modo de instalação

WLC#show version | include System image|Installation mode|IOS XE Software
Cisco IOS XE Software, Version 17.15.05
System image file is "bootflash:packages.conf"
Installation mode is INSTALL

Modo de pacote

WLC#show version | include System image|Installation mode|IOS XE Software
Cisco IOS XE Software, Version 17.15.05
System image file is "bootflash:/C9800-L-universalk9_wlc.17.15.05.SPA.bin"
Installation mode is BUNDLE 

Troubleshooting

No momento, não há informações específicas disponíveis para solucionar esse problema de configuração.

Informações Relacionadas

• Guia de instalação do Cisco Catalyst 9800-CL Cloud Wireless Controller
• Compilações IOS XE recomendadas pelo TAC para controladores de LAN sem fio
• Guia do usuário final
• Suporte técnico e downloads da Cisco

Histórico de revisões

Revisão	Data de publicação	Comentários
3.0	11-Jun-2026	Texto Alt adicionado. Formatação e requisitos de estilo atualizados.
2.0	30-Nov-2023	Recertificação
1.0	15-Apr-2021	Versão inicial