Inleiding
In dit document worden de stappen beschreven voor het identificeren en beperken van het probleem met de software-upgrade op de Cisco IR1101-router via Cisco IOS® XE SD-WAN Manager.
Probleem beschrijving
Dit artikel vormt een aanvulling op de Field Notice FN74237 die is gepubliceerd voor de IR1101-upgradeproblemen.
Cisco IR1101-routers kunnen niet succesvol upgraden van Cisco IOS® 10 .10/10 .11 naar latere softwarereleases vanwege onvoldoende flashgeheugenruimte. Het probleem wordt gezien op de apparaten tijdens het uitvoeren van de upgrade via Catalyst SD-WAN Manager in de installatiemodus.
Scenario
Routers met Cisco IOS XE 17.10.x/17.11.x-versies kunnen niet upgraden naar hogere versies met Catalyst SD-WAN-beheer als de beschikbare ruimte kleiner is dan 1400MB.
In de IR1101 mislukt de software-upgrade bij het updaten van versies 17.10.x of 17.11.x naar hogere versies. Dit gebeurt omdat het upgradeproces vereist dat de vrije opslagruimte tweemaal zo groot moet zijn als de afbeelding in de opstartflitser. Als de beschikbare ruimte in de opstartflitser minder dan het dubbele van de afbeeldingsgrootte is, kan de upgrade mislukken. Zie het defect hieronder.
Cisco bug ID CSCwf84896
Foutbericht uit de SD-WAN Manager-logs
Deze berichten zijn te zien in de taaklogboeken voor upgrades.
[25-sep-2024 13:11:03 AEST] Apparaat: Alle geïnstalleerde versies: 17.10.01.0.1479;
[25-sep-2024 13:11:06 AEST] Apparaat: ontvangen installatieverzoek voor softwareversie (5-tuple): 17.12.04.0.4826
[25-sep-2024 13:11:19 AEST] Apparaat: /flash vereist 703602 KB vrije ruimte, maar er is slechts 536416 KB beschikbaar
[25-sep-2024 13:11:19 AEST] De software is niet geïnstalleerd
Tijdelijke oplossing
Upgrade eerst het image van Cisco IOS XE versie 17.10.x/ 17.11.x naar 17.12.05 als tussenstap en ga daarna door naar de gewenste release. Om deze upgrade succesvol te laten zijn, moet de Catalyst SD-WAN Manager versie 10 .12 of hoger uitvoeren.
Voorbereidende stappen voor de upgrade
Back-upconfiguratie
Zorg ervoor dat u een back-up maakt van de huidige actieve configuratie van het IR1101-apparaat om gegevensverlies te voorkomen.
Compatibiliteit controleren
Bevestig dat de IR1101-hardware en de huidige SD-WAN-installatie compatibel zijn met de doelsoftwareversie.
Als de upgrade van 17.10.1a / 17.11.1a naar 17.12.05 gaat, gebruikt u SD-WAN Manager versie 17 .12 of hoger.
Als de upgrade van 17.12.05 naar 17.15.1a is, gebruikt u versie 20.15
Afbeelding verkrijgen
Download de tussenliggende versie van het image 17.12.05 en de uiteindelijke versie van de doelsoftware van software.cisco.com
Apparaatruimte controleren en opruimen
1.Controleer de beschikbare ruimte in het apparaat door het uitvoeren van opdracht
Router#dir bootflash: | i bytes
2648363008 bytes total (1304428544 bytes free)
2. Zorg ervoor dat er 1.225 tot 1.244 MB vrije ruimte in de bootflash is voordat we doorgaan met het upgradeproces.
3.Als het apparaat minder dan 1225 MB ruimte in Flash heeft, voert u een opruimactie uit door de verwijderingsopdracht via SSH uit te voeren naar het apparaat via de vManage GUI. Voer deze opdrachten één voor één uit.
delete /force /recursive bootflash:/.EXPAND*
delete /force /recursive bootflash:/admintech_trace
delete /force /recursive bootflash:/admintech
delete /force /recursive bootflash:/collated_log*
delete /force /recursive bootflash:/license_evlog/*.log
delete /force /recursive bootflash:/sdavc/*
delete /force /recursive bootflash:/vmanage-admin/*.tar.gz
delete /force /recursive bootflash:/core/*.tar.gz
delete /force /recursive bootflash:/core/*.core.gz
delete /force /recursive bootflash:/core/*core.flat.gz
delete /force /recursive bootflash:/syslog/*
delete /force /recursive bootflash:/crashinfo_*
delete /force /recursive bootflash:/tracelogs/*

Als alternatief kan deze reinigingspraktijk worden geïntegreerd als onderdeel van de SD-WAN-configuratie. Het kan worden geautomatiseerd door gebruik te maken van een EEM-script dat het proces activeert wanneer een upgrade op het punt staat te worden uitgevoerd door SD-WAN Manager. Voeg de EEM-applet toe aan een CLI-invoegtoepassing in uw SD-WAN-configuratiegroep:
Event Manager-applet eem_clear_bootflash-autorisatie omzeilen
gebeurtenissyslog-patroon "Controle vóór upgrade gestart"
actie 0005 syslog msg "Opschonen bootflash: gestart ..."
Action 0010 CLI, opdracht "Inschakelen"
actie 0020 cli, opdracht "delete /force /recursive bootflash:/.EXPAND*"
Action 0030 CLI-opdracht "Delete /Force /Recursive Bootflash:/admintech_trace"
Action 0040 CLI-opdracht "Delete /Force /Recursive Bootflash:/AdminTech"
Action 0050 CLI, opdracht "Delete /Force /Recursive Bootflash:/Collated_Log*"
Action 0060 CLI-opdracht "Delete /Force /Recursive Bootflash:/license_evlog/*.log"
Action 0070 CLI-opdracht "Delete /Force /Recursive Bootflash:/SDAVC/*"
Action 0080 CLI-opdracht "Delete /Force /Recursive Bootflash:/vmanage-admin/*.tar.gz"
Action 0090 CLI-opdracht "Delete /Force /Recursive Bootflash:/Core/*.tar.gz"
Action 0100 CLI-opdracht "Delete /Force /Recursive Bootflash:/core/*.core.gz"
Action 0110 CLI-opdracht "Delete /Force /Recursive Bootflash:/core/*core.flat.gz"
Action 0120 CLI-opdracht "Delete /Force /Recursive Bootflash:/SYSLOG/*"
Action 0130 CLI-opdracht "Delete /Force /Recursive Bootflash:/Crashinfo_*"
Action 0140 CLI-opdracht "Delete /Force /Recursive Bootflash:/Tracelogs/*"
actie 0900 syslog msg "Opschonen bootflash: voltooid."
uitgang
Voordat een upgrade wordt uitgevoerd, kan het script worden geactiveerd om alle ongewenste bestanden uit bootflash te verwijderen.

- Zorg er ook voor dat er geen IOX-app in het apparaat is geïnstalleerd, zodat de vereiste ruimte beschikbaar kan zijn in opstartflitser.
Upgradestappen met Cisco Catalyst SD-WAN Manager.
- Toegang tot SD-WAN Manager:
- Meld u aan bij Cisco SD-WAN Manager met de beheerdersaccount en bevestig dat versie 10 .12 of hoger wordt uitgevoerd.
- Software uploaden (17.12.05):
- Navigeer naar de sectie Onderhoud – software repository.
- Selecteer de optie om een nieuwe afbeelding te uploaden.
- Upload de afbeelding versie 17.12.05.
- Software installeren:
- Start het upgradeproces om het 17.12.05-image te installeren.
- Controleer het upgradeproces en zorg ervoor dat het apparaat opnieuw wordt opgestart in de tussenliggende softwareversie.
[30-Oct-2024 16:31:08 UTC] De installatie van de software actie ingediend voor uitvoering
[30-Oct-2024 16:31:10 UTC] Uitvoerend apparaat actie Software Installeren
[30-Oct-2024 16:31:10 UTC] Installeren en activeren van software-image
[30-okt-2024 16:31:11 UTC]Huidige actieve partitie: 17.10.01.0.1479
[30-Oct-2024 16:31:11 UTC] Upgrade aangevraagd voor SW versie: 17.12.05
[30-Oct-2024 16:31:14 UTC] Het configureren van upgrade bevestigen timer tot 15 minuten
[30-okt-2024 16:31:14 UTC] Software Image ir1101-universalk9.17.12.05.bin
[30-Oct-2024 16:31:14 UTC] Verzenden van gevraagde upgrade actie naar het apparaat
[30-okt-2024 16:31:14 UTC] Het downloaden van een softwareafbeelding kan na het starten maximaal 60 minuten duren
[30-okt-2024 16:31:18 GMT] [in_progress] Gestart Pre-Upgrade Check: Pre-Upgrade Controles voor 'Downloaden en Upgraden' workflow
[30-Oct-2024 16:32:35 GMT] [succes] Geldigheidscontrole van afbeelding: afbeelding is compatibel met het platform
[30-Oct-2024 16:32:35 UTC] [succes] Compatibiliteit met controller: Image controller-versie 16 .12 is compatibel met vManage versie 10 .12
[30-Oct-2024 16:32:35 UTC] [succes] Schijfruimte controleren: Schijf heeft voldoende ruimte om het nieuwe image te installeren
[30-Oct-2024 16:32:35 UTC] [succes] SD-WAN Installer Space Check: SD-WAN installer heeft voldoende ruimte
[30-Oct-2024 16:32:35 GMT] [succes] Systeembelasting controleren: Systeem heeft gezonde CPU-niveaus
[30-Oct-2024 16:32:35 GMT] [succes] Geheugengebruik Check: Systeem heeft gezonde Geheugenniveaus
[30-Oct-2024 16:32:35 UTC] [succes] Config-register Check: Autoboot is ingeschakeld
[30-okt-2024 16:32:35 UTC] [succes] Controle-verbindingsstatus Controle: Controle-verbinding met vManage is UP
[30-okt-2024 16:32:35 GMT] [succes] Voltooide controle vóór upgrade: doorgaan met de gevraagde workflow
[30-Oct-2024 16:32:38 UTC] Apparaat: Downloaden <</software/package/ir1101-universalk9.17.12.05.SPA.bin>>gestart
[30-okt-2024 16:39:57 UTC] Apparaat: Alle geïnstalleerde versies: 17.10.01.0.1479;
[30-Oct-2024 16:40:00 UTC] Apparaat: Ontvangen installatieverzoek voor softwareversie (5-tuple): 17.12.05
[30-okt-2024 16:44:59 UTC] Apparaat: geïnstalleerd 17.12.05
[30-Oct-2024 16:45:01 UTC] Apparaat: Het apparaat opnieuw laden om 17.12.05 te activeren
[30-Oct-2024 16:57:07 UTC] Apparaat: Controle na upgrade geslaagd. Huidige actieve partitie is 17.12.05
[30-okt-2024 16:57:32 UTC] Apparaat: met succes toegepast upgrade-bevestigen
[30-okt-2024 16:57:48 UTC] Software installeren voltooid
Opmerking: de term vManage in het bericht verwijst naar SD-WAN Manager.
- Stel de standaardinstelling in op 17.12.05 en verwijder 17.10.04 van het apparaat in SD-WAN Manager.
5. Upgrade controleren:
- Meld u na het opnieuw opstarten weer aan bij SD-WAN Manager.
- Controleer of op het apparaat de 17.12.05-afbeelding wordt uitgevoerd.
Opmerking: als de doelupgrade 17.12.05 is, eindigt het upgradeproces hier, als de doelupgrade naar 17.15.01a is, gaat u verder met de volgende stap.
6. 17.12.05 TO 17.15.01a upgrade van vereiste SD-WAN Manager versie 20.15:
Upload 17.15.01a Afbeelding:
- Navigeer nogmaals naar het gedeelte Software-upgrade.
- Selecteer de optie om een nieuwe afbeelding te uploaden.
- Upload de software versie 17.15.01
Installeer 17.15.01a Image:
- Start het upgradeproces om de software te installeren
- Controleer het proces en zorg ervoor dat het apparaat opnieuw wordt opgestart in de uiteindelijke softwareversie.
[3-Nov-2024 6:57:40 UTC] Actie voor software-installatie ingediend voor uitvoering
[3-Nov-2024 6:57:42 UTC] Uitvoerend apparaat actie Software installeren
[3-Nov-2024 6:57:42 UTC] Installeren en activeren van software-image
[3-Nov-2024 6:57:46 UTC] Huidige actieve partitie: 17.12.05
[3-Nov-2024 6:57:46 UTC] Upgrade aangevraagd voor SW versie: 17.15.01a.0.193
[3-Nov-2024 6:57:53 UTC] Geconfigureerde upgrade bevestigen timer is 15 minuten
[3-Nov-2024 6:57:53 UTC] Software Image ir1101-universalk9.17.15.01a.SPA.bin
[3-Nov-2024 6:57:53 UTC] Verzenden van gevraagde upgrade actie naar het apparaat
[3-Nov-2024 6:57:53 UTC] Het downloaden van software-afbeeldingen kan na het starten tot 60 minuten duren
[3-Nov-2024 6:57:56 UTC] [in_progress] Gestart Pre-Upgrade Check: Pre-Upgrade Controles voor 'Download en Upgrade' workflow
[3-Nov-2024 6:58:14 UTC] [succes] Geldigheidscontrole van afbeelding: afbeelding is compatibel met het platform
[3-Nov-2024 6:58:14 UTC] [succes]Compatibiliteit met beeldcontroller: Image controller-versie 20.15 is compatibel met vManage versie 20.15
[3-Nov-2024 6:58:14 UTC] [succes] Schijfruimte controleren: Schijf heeft voldoende ruimte om het nieuwe image te installeren
[3-Nov-2024 6:58:14 UTC] [succes] SD-WAN Installer Space Check: SD-WAN installer heeft voldoende ruimte
[3-Nov-2024 6:58:14 UTC] [succes] Systeembelasting controleren: Systeem heeft gezonde CPU-niveaus
[3-Nov-2024 6:58:14 UTC] [succes] Geheugengebruik Check: Systeem heeft gezonde Geheugenniveaus
[3-Nov-2024 6:58:14 UTC] [succes] Config-register Check: Autoboot is ingeschakeld
[3-Nov-2024 6:58:14 UTC] [succes] Controle-verbindingsstatus Controle: Controle-verbinding met vManage is UP
[3-Nov-2024 6:58:14 UTC] [succes] Voltooide Pre-Upgrade Check: Doorgaan met de gevraagde workflow
[3-Nov-2024 6:58:16 UTC] Apparaat: Downloaden</software/package/ir1101-universalk9.17.12.05.SPA.bin>>gestart
[3-Nov-2024 7:05:33 UTC] Apparaat: Alle geïnstalleerde versies: 17.12.04.0.4826;
[3-Nov-2024 7:05:37 UTC] Apparaat: Ontvangen installatieverzoek voor softwareversie (5-tuple): 17.15.01a.0.193
[3-nov-2024 7:11:22 UTC] Apparaat: geïnstalleerd 17.15.01a.0.193
[3-Nov-2024 7:11:24 UTC] Apparaat: Het apparaat opnieuw laden om 17.15.01a.0.193 te activeren
[3-Nov-2024 7:22:56 UTC] Apparaat: Controle na upgrade geslaagd. Huidige actieve partitie is 17.15.01a.0.193
[3-Nov-2024 7:23:42 UTC] Apparaat: met succes toegepast upgrade-bevestigen
[3-Nov-2024 7:24:00 UTC] Software installeren voltooid
Stappen na de upgrade
Verwijder de tussenliggende afbeelding van 17.12.05 die niet langer nodig is om ruimte vrij te maken voor andere doeleinden.
- Standaardversie instellen op 17.15.01a via Onderhoud -> Apparaat selecteren -> Acties voor software-images -> Standaardversies instellen

- Tussenliggende 17.12.05-build verwijderen uit de vManage GUI door naar Onderhoud te navigeren -> Apparaat selecteren -> Acties voor software-images -> Beschikbare software verwijderen
Selecteer in de vervolgkeuzelijst 17.12.05

Kernpunten
- Softwareversies: Zorg ervoor dat u de exacte versie van het image gebruikt (17.12.05 als tussenversie en 17.15.01a als definitieve versie) voor een upgrade van 17.10.x naar 17.15.x.
- Dit is alleen van toepassing op IR1101's die zich in de controllermodus bevinden en die SD-WAN Manager gebruiken om het upgradeproces uit te voeren.
- Aangezien dit een upgradeproces in twee stappen is, kan het onderhoudsvenster dienovereenkomstig worden gepland.
- Zorg ervoor dat u het 17.12.05-image verwijdert uit SD-WAN Manager nadat de upgrade met succes is voltooid.