Risoluzione dei problemi relativi all'aggiornamento di IOS XE SD-WAN: Spazio insufficiente

Introduzione

Questo documento descrive il processo di diagnosi e risoluzione del problema quando un aggiornamento Cisco IOS® XE SD-WAN non riesce a causa di una capacità di storage insufficiente.

Prerequisiti

WAN Edge Router

Requisiti

Cisco raccomanda la conoscenza dei seguenti argomenti:

• Software Cisco Defined Wide Area Network (SD-WAN)
• Cisco IOS® XE Command Line Interface (CLI)

Per informazioni sull'aggiornamento di Cisco IOS XE SD-WAN Aggiornare il router Cisco IOS XE SD-WAN con CLI o vManage

Componenti usati

Questo documento si basa sulle seguenti versioni software e hardware:

• Router c111-8P
• Software versione 17.3.2
• Software versione 17.3.4
• Router in modalità controller

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.

Condizioni

1. Impossibile aggiornare il router modello c111-8p alla versione 17.3 e altre versioni prima della versione 17.5.

2. Considerare i seguenti errori:

Not enough space under bootflash for image download and package expansion on image installation. Required space: 1207202432 Available space: 659275776. Image installation failed.
Not enough space in SD-WAN installer filesystem. Please remove one of the installed images and try again. SD-WAN installer filesystem size - 396672 Kilobytes, Available space - 196986 Kilobytes, Required space - 243602 Kilobytes.

3. L'aggiornamento non riesce come mostrato nelle immagini seguenti:

Immagine1

Immagine2

4. È installata una sola versione. Utilizzare il comando show sdwan software per la verifica.

Esempio

edge#show sdwan software 
VERSION           ACTIVE  DEFAULT  PREVIOUS  CONFIRMED  TIMESTAMP                  
-----------------------------------------------------------------------------------
17.03.04a.0.5574  true    true     false     user       2021-10-22T23:00:30-00:00  

Total Space:387M Used Space:191M Available Space:192M

Risoluzione dei problemi

1. Eliminare i file non necessari con questo comando:

delete /force /recursive bootflash://

È possibile eliminare il successivo elenco di file. Si tratta di registri interni creati a scopo di risoluzione dei problemi.

Attenzione: Eliminarli se si è certi che non sia in corso alcuna altra indagine.

bootflash:/vmanage-admin/*.tar.gz
bootflash:/core/*.core.gz
bootflash:/core/*.tar.gz
bootflash:/syslog/*
bootflash:/tracelogs/*
bootflash:/crashinfo_*

Esempio

delete /force /recursive bootflash:/tracelog/*
delete /force /recursive bootflash:/ vmanage-admin/*.tar.gz

Avviso: Non eliminare questi file. Sono file essenziali per la funzionalità del router.

bootflash:/.sdwaninstaller
bootflash:/.sdwaninstallerfs
bootflash:/.cdb_backup folder
bootflash:/sdwan folder
bootflash:/*pkg
bootflash:/*.conf.

2. Il riavvio consente di rilasciare la memoria bootflash, come mostrato nell'esempio.

Attenzione: Il control plane e il data plane flap durante il riavvio. 

*** Before Reboot ***

edge#show sdwan software 
VERSION           ACTIVE  DEFAULT  PREVIOUS  CONFIRMED  TIMESTAMP                  
-----------------------------------------------------------------------------------
17.03.04a.0.5574  true    true     false     user       2021-10-22T23:00:30-00:00  
Total Space:387M Used Space:191M Available Space:192M  >>> Here
edge#

*** Rebooting edge
edge#reload
Proceed with reload? [confirm]Connection to 192.168.1.6 closed by remote host.

*** After Reboot ***
edge#show sdwan software
VERSION           ACTIVE  DEFAULT  PREVIOUS  CONFIRMED  TIMESTAMP                  
-----------------------------------------------------------------------------------
17.03.04a.0.5574  true    true     false     user       2021-10-22T23:00:30-00:00  

Total Space:387M Used Space:190M Available Space:193M >>>> Here

Lavora in giro

Eseguire la procedura seguente se le azioni precedenti non sono riuscite a aggiornare il router c111-8p. 

Numero 1

Se il problema dell'aggiornamento è dovuto a questo errore Spazio insufficiente in bootflash, consultare le istruzioni successive.

Passaggio 1. Abilitare IOx.

Config-transaction
iox
commit
end

Passaggio 2. Eseguire il comando successivo per spostare il registro IOx da bootflash a flash.

app-hosting move system techsupport to flash:

Passaggio 3. Disabilitare IOx.

Config-transaction
no iox
commit
end

Esempio

Before IOx enabling
edge#dir
Directory of bootflash:/
<snipped>
2908606464 bytes total (646643712 bytes free)
edge#                

After IOx disabling
edge#dir
Directory of bootflash:/
<snipped>
2908606464 bytes total (1671614464 bytes free)
edge#

Passaggio 4. Procedere con l'aggiornamento.

request platform software sdwan software install bootflash:<version.bin>
request platform software sdwan software activate <IOS version>
request platform software sdwan software upgrade-confirm
request platform software sdwan software set-default 

Suggerimento: Per l'aggiornamento tramite vManage Aggiornare SD-WAN cEdge Router con CLI o vManage

Numero 2

Se il problema di aggiornamento è dovuto a questo errore 'Spazio insufficiente nel file system del programma di installazione SD-WAN', fare riferimento a queste istruzioni.

Passaggio 1. Accedere alla shell. 

Per ulteriori informazioni, fare riferimento a .

Passaggio 2. Accedere alla directory .sdwaninstaller/images. Utilizzare i comandi di Linux per trovare e rimuovere i vecchi file.

cd /bootflash/.sdwaninstaller/images
ls -l
rm -rf 

Passaggio 3. Uscire dalla shell con il comando Linux.

exit

passaggio 4. Procedere con l'aggiornamento.

request platform software sdwan software install bootflash:
request platform software sdwan software activate 
request platform software sdwan software upgrade-confirm
request platform software sdwan software set-default 

Suggerimento: Per l'aggiornamento tramite vManage Aggiornare SD-WAN cEdge Router con CLI o vManage

Esempio

**** Before to Clean Up ****

[23-Sep-2022 18:08:05 UTC] Installing software image
[23-Sep-2022 18:08:09 UTC] Current active partition: 17.03.04a.0.5574
[23-Sep-2022 18:08:10 UTC] Configuring upgrade confirm timer to 15 minutes
[23-Sep-2022 18:08:11 UTC] Software image: c1100-universalk9.17.03.05.SPA.bin
[23-Sep-2022 18:08:11 UTC] Software image download may take upto 180 minutes
[23-Sep-2022 18:08:17 UTC] Not enough space in SDWAN installer filesystem. Please remove one of the installed images and try again. SDWAN installer filesystem size - 396672 Kilobytes, Available space - 196986 Kilobytes, Required space - 243602 Kilobytes.
[23-Sep-2022 18:08:17 UTC] Failed to process device request -  
Error type : application 
Error tag : operation-failed 
Error info : 
  install


edge#show sdwan software
VERSION           ACTIVE  DEFAULT  PREVIOUS  CONFIRMED  TIMESTAMP                  
-----------------------------------------------------------------------------------
17.03.04a.0.5574  true    true     false     user       2021-10-22T23:00:30-00:00  

Total Space:387M Used Space:190M Available Space:193M  >>> Here
edge#

**** Clean old files from sdwaninstaller ****
[edge:/]$ cd /bootflash/.sdwaninstaller/images
[edge:/bootflash/.sdwaninstaller/images]$ ls -l
total 2
drwxr-xr-x. 3 root root 1024 Oct  3  2019 SR_BOOT=usb0:c1100-ucmk9.16.9.3.SPA.bin
drwxr-xr-x. 3 root root 1024 Sep 23 13:33 c1100-universalk9.17.03.04a.SPA.bin
[edge:/bootflash/.sdwaninstaller/images]$ rm -rf SR_BOOT=usb0:c1100-ucmk9.16.9.3.SPA.bin
[edge:/bootflash/.sdwaninstaller/images]$ ls -l
total 1
drwxr-xr-x. 3 root root 1024 Sep 23 13:33 c1100-universalk9.17.03.04a.SPA.bin
[edge:/bootflash/.sdwaninstaller/images]$ exit
exit
Session log harddisk:tracelogs/system_shell_R0-0.18547_0.20220923134926.bin closed.
edge#
edge#show sdwan software 
VERSION           ACTIVE  DEFAULT  PREVIOUS  CONFIRMED  TIMESTAMP                  
-----------------------------------------------------------------------------------
17.03.04a.0.5574  true    true     false     user       2021-10-22T23:00:30-00:00  

Total Space:387M Used Space:120M Available Space:262M				>>>> Space increased


**** Upgrade Successful:
[23-Sep-2022 18:53:38 UTC] Installing software image
[23-Sep-2022 18:53:43 UTC] Current active partition: 17.03.04a.0.5574
[23-Sep-2022 18:53:44 UTC] Configuring upgrade confirm timer to 15 minutes
[23-Sep-2022 18:53:44 UTC] Software image: c1100-universalk9.17.03.05.SPA.bin
[23-Sep-2022 18:53:44 UTC] Software image download may take upto 180 minutes
[23-Sep-2022 18:53:54 UTC] Connection Instance: 2, Color: private1
[23-Sep-2022 18:53:54 UTC] Downloading http://192.168.16.17:8080/software/package/c1100-universalk9.17.03.05.SPA.bin?deviceId=10.10.10.10
[23-Sep-2022 19:06:04 UTC] Downloaded http://192.168.16.17:8080/software/package/c1100-universalk9.17.03.05.SPA.bin?deviceId=10.10.10.10
[23-Sep-2022 19:09:31 UTC] install_add: START Fri Sep 23 14:06:10 COT 2022
Sep 23 14:06:12.207 %INSTALL-5-INSTALL_START_INFO: R0/0: install_engine: Started install add bootflash:c1100-universalk9.17.03.05.SPA.bin
[23-Sep-2022 19:09:31 UTC] Installed 17.03.05.0.6600

Caveat

Possibili problemi durante l'aggiornamento tramite GUI vManage:

• Spazio insufficiente

Risolto: verificare la configurazione bootflash ed eliminare tutte le immagini che non si stanno utilizzando. È possibile eliminare tutti i pacchetti tramite il file CLI con il comando # delete bootflash:*17.03.01*.

Con questo comando vengono eliminati tutti i file denominati 17.03.01.

Edge#delete bootflash:*17.03.01*
Delete filename [*17.03.01*]?
Delete bootflash:/isr4300-firmware_dreamliner.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-firmware_dsp_analogbri.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-firmware_dsp_sp2700.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-firmware_dsp_tilegx.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-firmware_ngwic_t1e1.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-firmware_nim_async.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-firmware_nim_bri_st_fw.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-firmware_nim_cwan.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-firmware_nim_ge.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-firmware_nim_shdsl.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-firmware_nim_ssd.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-firmware_nim_xdsl.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-firmware_prince.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-rpboot.17.03.01a.SPA.pkg? [confirm]
Delete bootflash:/isr4300-firmware_sm_10g.17.03.01a.SPA.pkg? [confirm]

È inoltre possibile eseguire l'avvio da un'unità USB, eliminare tutte le immagini da bootflash, copiare il file bin in bootflash e riavviare il sistema.

Nota: Se il router è in modalità controller, tutti i comandi da IOS-XE relativi ai pacchetti non funzionano.

Nota: La modifica della variabile di avvio tramite CLI è disabilitata anche in modalità controller. È possibile spostare il dispositivo in modalità autonoma, aggiornarlo e quindi riportarlo in modalità controller.

• L'immagine è già presente nel router

È possibile verificare se la versione è già presente tramite la GUI o la CLI di vManage con il comandoshow sdwan software.

Risolto: Rimuovere le immagini inutilizzate tramite l'interfaccia grafica di vManage o con il comandorequest platform software sdwan software remove .

• Nel router sono presenti più di tre immagini

È possibile verificare se la versione è già presente tramite la GUI o la CLI di vManage con il comandoshow sdwan software.

Risolto: Rimuovere le immagini inutilizzate tramite l'interfaccia grafica di vManage o con il comando request platform software sdwan software remove .

Informazioni correlate

• Aggiornamento di SD-WAN cEdge Router con l'uso di CLI o vManage
• Supporto tecnico Cisco e download