In questo documento vengono descritte e spiegate le procedure generali e i requisiti per aggiornare il software sui dispositivi Wireless LAN Controller (WLC).
Oltre a conoscenze di rete di base e a familiarità con la configurazione e l'installazione semplici dei WLC Cisco, accertarsi di aver letto le Linee guida e i Consigli presenti nelle note sulla versione.
Ad esempio, fare riferimento alla versione 8.10.190.0.
Percorso di aggiornamento supportato a Cisco Wireless release 8.10.x:
| Versione software corrente | Percorso di aggiornamento alla release 8.10.x |
| 8.5.x | È possibile eseguire l'aggiornamento direttamente alla release 8.10.x. |
| 8.8 x | È possibile eseguire l'aggiornamento direttamente alla release 8.10.x |
| 8.10.x | È possibile eseguire l'aggiornamento direttamente alla release 8.10.x |
Si consiglia di mantenere aggiornato il WLC con la versione consigliata corrente. È possibile controllare le versioni consigliate correnti: Versioni consigliate di AireOS per i Wireless LAN Controller.
Ad esempio, se si esegue la migrazione alla release 8.10.190.0, vedere la sezione Aggiornamento delle note sulla release di Cisco Wireless per i Cisco Wireless Controller e i Lightweight Access Point, Cisco Wireless release 8.10.171.0.
Non spegnere il controller o qualsiasi punto di accesso durante questa procedura; in caso contrario, è possibile danneggiare l'immagine del software. L'aggiornamento di un controller con un numero elevato di punti di accesso può richiedere fino a 30 minuti (dipende dalle dimensioni della rete). Tuttavia, con l'aumento del numero di aggiornamenti simultanei dei punti di accesso supportati nella versione software del controller, i tempi di aggiornamento sono notevolmente ridotti. I punti di accesso devono rimanere accesi e il controller non deve essere reimpostato in questo momento.
È possibile ridurre i tempi di inattività della rete mediante le seguenti opzioni:
L'immagine dell'access point può essere scaricata in anticipo. Questa funzione permette di scaricare l'immagine di aggiornamento sul controller e quindi di scaricarla sugli access point mentre la rete rimane attiva. Una nuova CLI permette di specificare l'immagine di avvio su entrambi i dispositivi e di reimpostare gli access point insieme al controller.
Per informazioni su come configurare i WLC e i LAP per questa funzione, consultare la sezione Predownload di un'immagine su un punto di accesso della guida alla configurazione di Cisco Wireless LAN Controller, versione 8.10.
Per gli access point FlexConnect, usare la funzione di aggiornamento FlexConnect Efficient AP per ridurre il traffico tra il controller e l'access point (sede principale e filiale).
Per ulteriori informazioni sulla configurazione degli aggiornamenti dei punti di accesso FlexConnect, vedere il capitolo Configurazione degli aggiornamenti dei punti di accesso FlexConnect per i punti di accesso FlexConnect nella guida alla configurazione dei controller LAN wireless Cisco, versione 8.10.Verificare che i punti di accesso supportino la nuova versione durante l'aggiornamento. Fare riferimento alla matrice di compatibilità dei software delle soluzioni Cisco Wireless.
Le informazioni fornite in questo documento si basano sulle seguenti versioni software e hardware:
Server FTP su cui sono memorizzati i file di aggiornamento.
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.
Questo documento è valido anche per le seguenti piattaforme hardware:
Cisco serie 3504 Wireless LAN Controller
Nota: Verificare che i punti di accesso siano compatibili con il software a cui si intende effettuare l'aggiornamento, in modo da evitare la perdita dei punti di accesso durante l'aggiornamento. Fare riferimento alla matrice di compatibilità dei software delle soluzioni Cisco Wireless.
È possibile usare la CLI o la GUI per aggiornare il WLC di Cisco.
Nota: Cisco consiglia di eseguire un backup della configurazione sul WLC prima di eseguire l'aggiornamento.
In questa sezione vengono fornite le informazioni per aggiornare il WLC dall'interfaccia grafica del controller.
Quando si aggiorna il WLC con l'uso della GUI, si perde la connettività di layer 3 (IP) entro un periodo di tempo in cui il controller viene riavviato.
Per questo motivo, si consiglia di utilizzare una connessione alla porta console per controllare lo stato del controller durante il processo di aggiornamento e accelerare le procedure di ripristino, se necessario.
Eseguire questa procedura:
Nota: Per le reti occupate, i controller con un utilizzo elevato e le piattaforme con controller di piccole dimensioni, si consiglia di disabilitare le reti 802.11 a scopo precauzionale.
Scarica controller file
Impostazioni trasferimento FTP
In questa sezione vengono presentate le informazioni necessarie per aggiornare il WLC con l'uso della CLI sul controller con i file in un server FTP.
Attenersi alla seguente procedura:
Accertarsi che il server FTP sia raggiungibile dal controller e che il file di aggiornamento risieda in una directory sul server FTP.
È meglio completare questa procedura tramite la porta console, ma è possibile usare il protocollo SSH o Telnet (se abilitato) sull'indirizzo IP di gestione del WLC per completare la procedura. L'uso di SSH o Telnet comporta la perdita di connettività con il controller nel processo di riavvio dopo il download dell'immagine. Pertanto, l'accesso alla console è disponibile per accelerare la risoluzione dei problemi e il ripristino del controller se l'aggiornamento non riesce. Accedere al controller e usare il comando show sysinfo per verificare il software in esecuzione sul controller.
Di seguito viene riportato un esempio di output del comando show sysinfo, che mostra il controller in esecuzione nella versione 8.5.182.0:
(c3504-01) >show sysinfo
Manufacturer's Name.............................. Cisco Systems Inc.
Product Name..................................... Cisco Controller
Product Version.................................. 8.5.182.0
RTOS Version..................................... 8.5.182.0
Bootloader Version............................... 8.5.103.0
Emergency Image Version.......................... 8.5.103.0
Completare la procedura seguente per definire i parametri di download:
Eseguire il comando transfer download mode ftp per definire la modalità di trasferimento dei file.
Eseguire il comando transfer download serverip FTP_server_IP_address per definire l'indirizzo IP del server FTP.
Eseguire il comando transfer download path 'FTP_server_path' per definire il percorso della directory FTP predefinita in cui si trova il software del sistema operativo del controller.
Eseguire il comando transfer download filename per specificare il nome dell'immagine.
Vedere questo esempio:
(c3504-01) >transfer download datatype code
(c3504-01) >transfer download mode ftp
(c3504-01) >transfer download username admin
(c3504-01) >transfer download password ********
(c3504-01) >transfer download serverip 192.168.1.2
(c3504-01) >transfer download path /Shared/AIR-CT3504/
(c3504-01) >transfer download filename AIR-CT3504-K9-8-10-190-0.aes
Eseguire il comando transfer download start per avviare il processo di aggiornamento. Vedere l'esempio del processo di aggiornamento:
(c3504-01) >show boot
Primary Boot Image............................... 8.5.182.0 (default) (active)
Backup Boot Image................................ 8.10.190.0
(c3504-01) >transfer download start
Mode............................................. FTP
Data Type........................................ Code
FTP Server IP.................................... 192.168.1.2
FTP Server Port.................................. 21
FTP Path......................................... /Shared/Images/3504/
FTP Filename..................................... AIR-CT3504-K9-8-10-190-0.aes
FTP Username..................................... admin
FTP Password..................................... *********
This may take some time.
Are you sure you want to start? (y/N) y
FTP Code transfer starting.
FTP receive complete... extracting components.
Checking Version Built.
Image version check passed.
Executing Product Check TLV.
Executing init script.
Executing backup script.
Writing new RTOS to flash disk.
Executing install_rtos script.
Writing new Kernel-args to flash disk.
Writing new FP to flash disk.
Writing new AP Image Bundle to flash disk.
Writing AVC Files to flash disk.
Executing fini script.
Reading AP IMAGE version info.
File transfer is successful.
Reboot the controller for update to complete.
Optionally, pre-download the image to APs before rebooting to reduce network downtime.
(c3504-01) >show boot
Primary Boot Image............................... 8.10.190.0 (default)
Backup Boot Image................................ 8.5.182.0 (active)
Riavviare il controller al termine del processo di aggiornamento per rendere effettivo il nuovo codice. Eseguire il comando reset system e immettere y o yes in risposta alla domanda "Salvarli ora?"
(Cisco Controller) >reset system
The system has unsaved changes.
Would you like to save them now? (y/N) y
Read from Flash Completed ...
Updating HBL license statistics file
Done.
Configuration Saved!
System will now restart!
Updating license storage ... Done.
Exiting SL process !
There was change in the boot image, System will go for a reboot
Cannot Cancel the WDT. Not petting the WDT.
Collect the core using oct utility
Rebooting the system..
[74411.034881] reboot: Restarting system
Cisco bootloader . . .
Cisco BootLoader Version : 8.5.103.0 (Cisco build) (Build time: Jul 25 2017 - 07:47:10)
Octeon unique ID: 03c000610221f31e0057
OCTEON CN7240-AAP pass 1.3, Core clock: 1500 MHz, IO clock: 800 MHz, DDR clock: 1067 MHz (2134 Mhz DDR)
DRAM: 8 GiB
Clearing DRAM...... done
CPLD Revision : a5
Reset Reason : Soft reset due to RST_SOFT_RST write
SF: Detected S25FL064A with page size 256 Bytes, erase size 64 KiB, total 8 MiB
MMC: Octeon MMC/SD0: 0 (Type: MMC, Version: MMC v5.1, Manufacturer ID: 0x15, Vendor: Man 150100 Snr 0707a546, Product: BJNB4R, Revision: 0.7)
Net: octmgmt0, octmgmt1, octeth0, octeth1, octeth2, octeth3, octeth4, octeth5, octeth6
SF: Detected S25FL064A with page size 256 Bytes, erase size 64 KiB, total 8 MiB
Press <ESC> now to access the Boot Menu...
Loading backup image (8.10.190.0)
94767283 bytes read in 2229 ms (40.5 MiB/s)
Launching...
Verifying images... OK
Launching images...
[...]
XML config selected
Validating XML configuration
octeon_device_init: found 1 DPs
Cisco is a trademark of Cisco Systems, Inc.
Software Copyright Cisco Systems, Inc. All rights reserved.
Cisco AireOS Version 8.10.190.0
Initializing OS Services: ok
Initializing Serial Services: ok
Initializing Network Services: ok
[...]
La configurazione non viene salvata quando si esegue il downgrade della versione del codice del controller. È possibile aggiornare i controller alla versione successiva (upgrade). Se è necessario effettuare il downgrade da una release a un'altra, non è possibile (probabilmente) utilizzare la configurazione della release più recente. Per risolvere il problema, ricaricare i file di configurazione del controller precedenti salvati sul server di backup o riconfigurare il controller.
L'aggiornamento manuale dei dispositivi all'ultima versione del software può causare errori e richiedere molto tempo. Cisco Prime Infrastructure (PI) semplifica la gestione delle versioni e l'installazione di routine degli aggiornamenti software ai dispositivi con l'aiuto della pianificazione, della pianificazione, del download e del monitoraggio degli aggiornamenti delle immagini software. Inoltre, permette di visualizzare i dettagli delle immagini software o le immagini consigliate e di eliminarle. La pagina di gestione delle immagini software fornisce una visualizzazione consolidata dei vari aspetti della gestione delle immagini, ad esempio il widget del ciclo di vita di gestione delle immagini software, il riepilogo delle immagini software e i dettagli del processo.
Prime Infrastructure memorizza tutte le immagini software dei dispositivi presenti nella rete. Le immagini vengono memorizzate in base al tipo e alla versione dell'immagine.
Per informazioni dettagliate e linee guida, vedere il capitolo Manage Device Software Images della Guida per l'utente di Cisco IP.
In questa sezione è disponibile un elenco di alcuni scenari di aggiornamento software:
L'aggiornamento software del controller attivo garantisce l'aggiornamento del controller di standby a caldo.
Poiché l'aggiornamento in servizio non è supportato, si consiglia di pianificare il tempo di inattività della rete prima di aggiornare i controller in un ambiente HA.
Se si riavvia il controller attivo dopo un aggiornamento del software, viene riavviato anche il controller hot in standby.
Prima di eseguire il comando config boot backup, è consigliabile che i controller attivi e quelli in standby abbiano la stessa immagine software nel backup. Se i controller attivi e quelli in standby hanno immagini software diverse nel backup e si esegue il comando config boot backup nel controller attivo, entrambi i controller si riavviano con le rispettive immagini di backup. rompe la coppia HA a causa di una mancata corrispondenza software.
Un reset programmato viene applicato a entrambi i controller in un ambiente HA. Il controller peer si riavvia un minuto prima che l'ora programmata scada sul controller attivo.
È possibile riavviare il controller hot in standby dal controller attivo con il comando set peer-systemse il ripristino pianificato non è pianificato. Se si ripristina solo il controller hot di standby con questo comando, tutte le configurazioni non salvate sul controller hot di standby andranno perse. Pertanto, accertarsi di salvare le configurazioni sul controller attivo prima di ripristinare il controller in standby.
Il download di una preimmagine viene reinizializzato se viene attivata una connessione SSO al momento del trasferimento dell'immagine.
Sul controller host di standby sono consentiti solo i comandi debug e show.
Per istruzioni dettagliate sull'aggiornamento del WLC nell'installazione di HA AP-SSO, eseguire i passaggi descritti nel documento High Availability (SSO) Deployment Guide (Guida alla distribuzione di High Availability, SSO).
Quando si aggiorna il WLC con una nuova immagine, il WLC sovrascrive automaticamente anche l'immagine di backup.
Per visualizzare l'immagine attiva attualmente in esecuzione sul controller (l'immagine primaria), fare clic su Monitor dall'interfaccia utente del WLC e controllare il campo Versione software in Riepilogo controller sull'interfaccia utente del WLC. Dalla CLI, è possibile usare il comando show boot per visualizzare il dispositivo primario e eseguire il backup dell'immagine presente sul WLC. Vedere questo esempio:
(c3504-01) >show boot
Primary Boot Image............................... 8.5.182.0 (default) (active)
Backup Boot Image................................ 8.10.190.0
Per rimuovere o sovrascrivere un'immagine sul WLC, avviare il WLC con l'immagine che si desidera mantenere ed eseguire un aggiornamento. In questo modo, la nuova immagine sostituirà l'immagine di backup.
È possibile anche modificare manualmente l'immagine di avvio attiva del WLC eseguendo il comando config boot<primary/backup>
(Cisco Controller) >config boot ? primary Sets the primary image as active. backup Sets the backup image as active.
L'immagine config boot può essere configurata anche dall'interfaccia grafica del WLC. Per ulteriori informazioni sulla procedura dettagliata, fare riferimento a Uso dell'immagine di backup sui Wireless LAN Controller (WLC).
Nota: È necessario salvare e riavviare la configurazione WLC in modo che il WLC utilizzi la nuova immagine attiva.
Per verificare la versione del software WLC installata, accedere al controller dopo il riavvio del sistema.
Dall'interfaccia grafica:
Verifica versione WLC
Dopo l'aggiornamento, dalla CLI:
(c3504-01) >show sysinfo
Manufacturer's Name.............................. Cisco Systems Inc.
Product Name..................................... Cisco Controller
Product Version.................................. 8.10.190.0
RTOS Version..................................... 8.10.190.0
Bootloader Version............................... 8.5.103.0
Emergency Image Version.......................... 8.5.103.0
È possibile eseguire il comando debug transfer all enable per visualizzare gli eventi verificatisi nel processo di aggiornamento del software del controller. Di seguito è riportato un esempio che mostra l'output del comando debug utilizzato per completare correttamente l'aggiornamento del software:
(Cisco Controller) >debug transfer all enable
(Cisco Controller) >transfer download start
Mode............................................. FTP
Data Type........................................ Code
FTP Server IP.................................... 192.168.1.2
FTP Server Port.................................. 21
FTP Path......................................... /Shared/AIR-CT3504/
FTP Filename..................................... AIR-CT3504-K9-8-10-190-0.aes
FTP Username..................................... admin
FTP Password..................................... *********
This may take some time.
Are you sure you want to start? (y/N) y
*TransferTask: Mar 06 14:56:49.928: Memory overcommit policy changed from 0 to 1
*TransferTask: Mar 06 14:56:49.928: Delete ramdisk for ap bundle
*TransferTask: Mar 06 14:56:49.939: RESULT_STRING: FTP Code transfer starting.
*TransferTask: Mar 06 14:56:49.939: RESULT_CODE:1
FTP Code transfer starting.
*TransferTask: Mar 06 14:58:52.024: ftp operation returns error code:0 error:Transfer Successful
*TransferTask: Mar 06 14:58:52.034: tftp = 6, file_name=/Shared/AIR-CT3504/AIR-CT3504-K9-8-10-190-0.aes, ip_address=192.168.1.2, msg=Transfer Successful
*TransferTask: Mar 06 14:58:52.034: upd_get_code = 6 (target=268435457 msg=Transfer Successful)
*TransferTask: Mar 06 14:58:52.034: RESULT_STRING: FTP receive complete... extracting components.
*TransferTask: Mar 06 14:58:52.034: RESULT_CODE:6
FTP receive complete... extracting components.
*TransferTask: Mar 06 14:59:07.442: RESULT_STRING: Checking Version Built.
Checking Version Built.
*TransferTask: Mar 06 14:59:09.442: RESULT_STRING: Image version check passed.
Image version check passed.
*TransferTask: Mar 06 14:59:12.443: RESULT_STRING: Executing Product Check TLV.
*TransferTask: Mar 06 14:59:12.444: RESULT_STRING: Executing Version Built TLV.
*TransferTask: Mar 06 14:59:12.444: RESULT_STRING: Executing init script.
*TransferTask: Mar 06 14:59:12.457: RESULT_STRING: Executing backup script.
*TransferTask: Mar 06 14:59:13.508: RESULT_STRING: Writing new RTOS to flash disk.
Writing new RTOS to flash disk.
*TransferTask: Mar 06 14:59:20.810: RESULT_STRING: Executing install_rtos script.
Executing install_rtos script.
*TransferTask: Mar 06 14:59:24.878: RESULT_STRING: Writing new Kernel-args to flash disk.
*TransferTask: Mar 06 14:59:24.892: RESULT_STRING: Writing new FP to flash disk.
*TransferTask: Mar 06 14:59:25.451: RESULT_STRING: Writing new AP Image Bundle to flash disk.
Writing new AP Image Bundle to flash disk.
*TransferTask: Mar 06 14:59:44.044: RESULT_STRING: Writing AVC Files to flash disk.
Writing AVC Files to flash disk.
*TransferTask: Mar 06 14:59:44.703: RESULT_STRING: Executing fini script.
Executing fini script.
*TransferTask: Mar 06 14:59:52.860: RESULT_STRING: Reading AP IMAGE version info.
*TransferTask: Mar 06 14:59:52.865: RESULT_CODE:11
*TransferTask: Mar 06 14:59:52.865: RESULT_STRING: File transfer is successful.
Reboot the controller for update to complete.
Optionally, pre-download the image to APs before rebooting to reduce network downtime.
File transfer is successful.
Reboot the controller for update to complete.
Optionally, pre-download the image to APs before rebooting to reduce network downtime.
*TransferTask: Mar 06 14:59:58.871: Create ramdisk for ap bundle
*TransferTask: Mar 06 14:59:58.884: Memory overcommit policy restored from 1 to 0
(Cisco Controller) >
Consultare questa sezione per risolvere i problemi relativi all'aggiornamento del software.
Durante il processo di aggiornamento possono verificarsi degli errori. In questa sezione vengono illustrati alcuni errori comuni, accompagnati dalle cause più probabili e dalle azioni correttive che è possibile intraprendere per completare l'aggiornamento del software WLC:
| Revisione | Data di pubblicazione | Commenti |
|---|---|---|
6.0 |
22-Jun-2026
|
Controllo ortografico, grammaticale, struttura della frase, spaziatura e didascalie CCW aggiornati. |
5.0 |
15-May-2025
|
SEO, titolo e formattazione aggiornati. |
4.0 |
20-Mar-2024
|
Versioni e testo WLC aggiornati.
Traduzione automatica, didascalie delle immagini e formattazione aggiornate. |
3.0 |
07-Jul-2022
|
Versioni e testo WLC aggiornati. |
1.0 |
24-Jan-2006
|
Versione iniziale |