Modifica delle modalità di installazione sul controller wireless Catalyst 9800

Introduzione

In questo documento viene descritto come passare da una modalità di installazione all'altra su un controller wireless Catalyst 9800 (WLC).

Prerequisiti

Requisiti

Cisco raccomanda la conoscenza dei seguenti argomenti:

• Piattaforme Catalyst 9800 Wireless LAN Controller e Access Point

• Software Catalyst 9800 Wireless LAN Controller: set di funzionalità

Componenti usati

Le informazioni di questo documento si basano sulla seguente versione software e hardware:

• C9800-L versione 17.15.5

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.

Premesse 

Utilizzare questo documento per informazioni su come convertire i diversi tipi di modalità di installazione su un Catalyst 9800 Wireless Controller (WLC) tramite l'interfaccia della riga di comando (CLI). 

Questa procedura può essere utilizzata anche per aggiornare il WLC 9800.

È possibile eseguire Cisco IOS® XE su un Catalyst 9800 WLC, in bundle e in modalità di installazione in due modi.

Modalità di installazione

La modalità di installazione utilizza i file .pkg preestratti dal file binario in loro flash per avviare il controller sbloccando diverse caratteristiche architetturali critiche che non sono disponibili in modalità Bundle. Il controller utilizza il packages.conf file creato dall'estrazione come variabile di avvio. Utilizzando questa modalità, il controller sperimenta tempi di avvio più rapidi e consuma meno RAM rispetto alla modalità Bundle. 

Suggerimento: La modalità di installazione è la modalità consigliata per l'esecuzione del WLC. Questa modalità è necessaria per le patch di Software Maintenance Upgrade (SMU), Access Point Service Pack (APSP), AP Device Pack (APDP) e per gli aggiornamenti software in servizio (ISSU).

Modalità bundle

Il sistema funziona in modalità Bundle se il controller viene avviato con l'immagine binaria (.bin) come variabile di avvio. In questa modalità, il controller estrae il file .bin nella RAM ed esegue da lì.

Questa modalità utilizza più memoria della modalità di installazione perché i pacchetti estratti dall'avvio vengono copiati nella RAM.

Nota: Prima di configurare High Availability (HA SSO) sul WLC 9800, verificare che entrambi i dispositivi abbiano la stessa modalità di installazione. In caso contrario, è possibile che si verifichi un errore di mancata corrispondenza V: %BOOT-3-BOOTTIME_INCOMPATIBLE_SW_DETECTED: R0/0: issu_stack: Incompatible software detected.

Operazioni preliminari

Verificare la modalità operativa del WLC 9800 per determinare la procedura da eseguire per convertire le modalità.

Eseguire il comando per show version | include Installation mode visualizzare la modalità di installazione corrente.

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

Configurazione

Dall'installazione alla modalità bundle

Procedura CLI

Passaggio 1. Assicurarsi di disporre di spazio sufficiente nella memoria flash per espandere una nuova immagine.

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)

Passaggio 2. Pulire i vecchi file di installazione in caso di spazio insufficiente e per eliminare i vecchi pacchetti aggiunti.

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)

Passaggio 3. Copiare la nuova immagine nella memoria 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): !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Passaggio 4. Confermare che l'immagine sia stata copiata correttamente nella memoria flash e verificare l'integrità dell'immagine.

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

Confrontare il risultato con il checksum MD5 fornito nei dettagli della versione per l'immagine di destinazione sul sito di download del software Cisco, i valori devono corrispondere esattamente.

Passaggio 5. Controllare la variabile di avvio corrente. Se la variabile è impostata su packages.conf, il WLC è attualmente in esecuzione in modalità di installazione. Per passare alla modalità Bundle, eliminare la variabile di avvio esistente e impostare l'immagine .bin come nuova variabile di avvio. Dopo aver apportato le modifiche, salvare la configurazione; in caso contrario, la nuova variabile di avvio non viene mantenuta dopo un ricaricamento.

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

Passaggio 6. Eseguire questo comando per verificare che la variabile di avvio sia impostata su bootflash:.

Viene visualizzato l'output 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

Passaggio 7. Ricaricare il controller per avviare in modalità Bundle.

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

Passaggio 8. Monitorare il processo di inizializzazione del WLC per confermarne l'avvio in modalità Bundle.

...
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

Procedura GUI

Passaggio 1. Verificare la modalità corrente. Selezionare Amministrazione > Gestione software > Aggiornamento software, verificare che la modalità di aggiornamento indichi che il sistema è in modalità di installazione.

Passaggio 2. Fare clic sull'elenco a discesa disponibile in Modalità aggiornamento e selezionare Pacchetto. Scegliere quindi il Tipo di trasporto e selezionare il Percorso del file bin, quindi Scarica.

Passaggio 3. Confermare il consenso per il ricaricamento del sistema. In questo momento si avvia la conversione in modalità bundle. 

Passaggio 4. Controllare l'aggiornamento nella sezione Status sul lato destro e nella finestra popup Show Logs.

Passaggio 5. Verificare l'immagine.

Passaggio 6. Salvare la configurazione e confermare il ricaricamento. 

Passaggio 7. Monitorare il caricamento del WLC, una volta che la GUI è diventata disponibile, selezionare Amministrazione > Gestione software > Aggiornamento software. La modalità di aggiornamento indica che il sistema sta operando in modalità Bundle.

Dal bundle alla modalità di installazione

Procedura CLI

Passaggio 1. Assicurarsi di disporre di spazio sufficiente nella memoria flash per espandere una nuova immagine.

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

Passaggio 2. Pulire i vecchi file di installazione in caso di spazio insufficiente e per eliminare i vecchi pacchetti aggiunti.

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)

Passaggio 3. Copiare la nuova immagine su 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): !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Passaggio 4. Confermare che l'immagine sia stata copiata correttamente nella memoria flash e verificare l'integrità dell'immagine.

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

Confrontare il risultato con il checksum MD5 fornito nei dettagli della versione per l'immagine di destinazione sul sito di download del software Cisco, i valori devono corrispondere esattamente.

Passaggio 5. Controllare la variabile di avvio corrente. Se la variabile punta a un file con estensione bin, il sistema è attualmente in esecuzione in modalità Bundle. In questo passaggio non è necessaria la configurazione manuale della variabile di avvio; durante l'aggiornamento, il processo di installazione lo aggiorna automaticamente in  bootflash:packages.conf.

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

   

Passaggio 6. Immagine di installazione del software da aggiornare. Per la conversione dalla modalità Bundle a quella Install, usare il 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

Passaggio 7. Digitare y (yes) il consenso per il ricaricamento del sistema.  Una volta completata l'installazione, il controller procede al ricaricamento.

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 ...

Passaggio 8. Monitorare il processo di inizializzazione del WLC per confermarne l'avvio in modalità di installazione.

...
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

Procedura GUI

Passaggio 1. Verificare la modalità corrente. Selezionare Amministrazione > Gestione software > Aggiornamento software, verificare che la modalità di aggiornamento indichi che il sistema è attualmente in modalità Bundle.

Passaggio 2. Fare clic sull'elenco a discesa disponibile in Modalità aggiornamento e selezionare Installa. Scegliere quindi il Tipo di trasporto e selezionare il Percorso del file con estensione bin, quindi Scarica e installa.

Passaggio 3. Confermare il consenso per il ricaricamento del sistema. In questo momento si avvia la conversione in modalità di installazione. 

Passaggio 4. Controllare l'aggiornamento nella sezione Status sul lato destro e nella finestra popup Show Logs.

Il sistema viene ricaricato durante il commit delle modifiche.

Passaggio 5. Monitorare il caricamento del WLC, una volta che la GUI è diventata disponibile, selezionare Amministrazione > Gestione software > Aggiornamento software. La modalità di aggiornamento indica che il sistema è attualmente in funzione in modalità di installazione.

Verifica 

Per verificare che la configurazione funzioni correttamente, consultare questa sezione. 

Dopo il riavvio del controller, è possibile verificare la modalità di installazione corrente del controller. Per verificare che la conversione sia stata eseguita correttamente, show version eseguire il comando.

Modalità di installazione

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

Modalità bundle

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 

Risoluzione dei problemi

Al momento non sono disponibili informazioni specifiche per la risoluzione dei problemi di questa configurazione.

Informazioni correlate

• Guida all'installazione di Cisco Catalyst 9800-CL Cloud Wireless Controller
• Compilazioni IOS XE consigliate TAC per controller LAN wireless
• Guida per l'utente finale
• Supporto tecnico Cisco e download

Cronologia delle revisioni

Revisione	Data di pubblicazione	Commenti
3.0	11-Jun-2026	Testo alternativo aggiunto. Requisiti di stile e formattazione aggiornati.
2.0	30-Nov-2023	Certificazione
1.0	15-Apr-2021	Versione iniziale