Inleiding
Dit document beschrijft de stappen om het probleem van de software-upgrade op Cisco IR1101-router te identificeren en te verzachten via Cisco IOS® XE SD-WAN Manager.
Probleembeschrijving
Dit artikel is een aanvulling op de melding uit het veld FN74237 die is gepubliceerd voor de IR1101 upgrade-problemen.
Cisco IR1101-routers kunnen niet met succes upgraden van Cisco IOS® 17.10/17.11 naar latere softwarereleases, vanwege onvoldoende ruimte voor flitsgeheugen. Het probleem is te zien 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 kan niet upgraden in hogere versies gebruik Catalyst 6000 SD-WAN beheerder indien de beschikbare ruimte is minder dan 1400 MB.
In de IR1101, de software upgrade mislukt bij het updaten van versies 17.10.x of 17.11.x naar hogere releases. Dit gebeurt, omdat het upgradeproces vereist dat de vrije opslagruimte dubbel zo groot moet zijn als de afbeelding in de opstartflitser. Daarom, als de beschikbare ruimte in de laarsflits minder dan het dubbele van de beeldgrootte is, kan de verbetering ontbreken. Raadpleeg het onderstaande defect.
Cisco fout-id CSCwf84896
Foutmelding van SD-WAN Manager logboeken
Deze berichten zijn te zien in de logboeken van de verbeteringsbaan.
[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 installatieaanvraag voor softwareversie (5-tuple): 17.12.04.0.4826
[25-sep-2024 13:11:19 AEST] Apparaat: /flash vereist 703602 KB vrije ruimte, maar alleen 536416 KB is beschikbaar
[25-sep-2024:13:11:19 AEST] Software installatie is mislukt
Tijdelijke oplossing
Upgrade het beeld van Cisco IOS XE versie 17.10.x/ 17.11.x naar 17.12.05 als een tussenstap en ga vervolgens verder naar de gewenste release. Om deze upgrade te laten slagen, moet Catalyst SD-WAN Manager versie 20.12 of hoger uitvoeren.
Voorbereidende stappen voor de upgrade
Reserve-configuratie
Zorg ervoor dat u een back-up maakt van de huidige actieve configuratie van het IR1101 apparaat om gegevensverlies te voorkomen.
Controleer de compatibiliteit
Bevestig dat de IR1101 hardware en de huidige SD-WAN setup compatibel zijn met de doelsoftwareversie.
Als de upgrade van 17.10.1a/17.11.1a naar 17.12.05 is, gebruikt u SD-WAN Manager versie 20.12 of hoger.
Als de upgrade van 17.12.05 naar 17.15.1a loopt, gebruikt u dan versie 20.15
Afbeelding verkrijgen
Download de tussentijdse versie van het beeld 17.12.05 en de definitieve versie van de doelsoftware van software.cisco.com
Apparaatspatie controleren en opschonen
1. Controleer de beschikbare ruimte in apparaat door opdracht uit te voeren
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 verder gaan met het upgradeproces.
3. Als het apparaat minder dan 1225 MB ruimte in de flitser heeft, voert u een schoonmaakbeurt uit door de verwijderopdracht via SSH naar het apparaat uit te voeren via de vManager 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/*

Deze reinigingspraktijk kan ook 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-add-on profiel in uw SD-WAN Configuration Group:
event manager applet eem_clear_bootflash-autorisatieomzeiling
Syslog-patroon van gebeurtenis "Aangevangen pre-upgrade controle"
actie 0005 syslog msg "Schoonmaak bootflash: gestart ..."
action 0010 cli opdracht "activeren"
actie 0020 cli opdracht "delete /force /recursive bootflash:/.EXPAND*"
actie 0030 cli opdracht "delete /force /recursive bootflash:/admintech_trace"
actie 0040 cli opdracht "delete /force /recursive bootflash:/admintech"
actie 0050 cli opdracht "delete /force /recursive bootflash:/collated_log*"
actie 0060 cli opdracht "delete /force /recursive bootflash:/license_evlog/*.log"
actie 0070 cli opdracht "delete /force /recursive bootflash:/sdavc/*"
action 0080 cli opdracht "verwijderen /force /recursive bootflash:/vmanaged-admin/*.tar.gz"
action 0090 cli opdracht "wissen /force /recursive bootflash:/core/*.tar.gz"
action 0100 cli opdracht "wissen /force /recursive bootflash:/core/*.core.gz"
actie 0110 cli opdracht "wissen /force /recursive bootflash:/core/*core.flat.gz"
actie 0120 cli opdracht "delete /force /recursive bootflash:/syslog/*"
actie 0130 cli opdracht "delete /force /recursive bootflash:/crashinfo_*"
actie 0140 cli opdracht "wissen /force /recursive bootflash:/tracelogs/*"
actie 0900 syslog msg "Schoonmaak bootflash: voltooid."
uitgang
Alvorens 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 benodigde ruimte beschikbaar kan zijn in opstartflitser.
Upgradestappen met Cisco Catalyst SD-WAN Manager.
- Access SD-WAN Manager:
- Log in op Cisco SD-WAN Manager met de beheerderaccount en bevestig dat er versies 20.12 of hoger worden uitgevoerd.
- Uploadsoftware (17.12.05):
- Navigeer naar het gedeelte 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-beeld te installeren.
- Controleer het upgradeproces en zorg ervoor dat het apparaat met succes wordt opgestart naar de tussenliggende softwareversie.
[30-okt-2024 16:31:08 UTC] De actie Software Install is voor uitvoering ingediend
[30-okt-2024 16:31:10 UTC] Apparaatactie uitvoeren Software Installatie
[30-okt-2024 16:31:10 UTC] Installatie en activering software image
[30-okt-2024 16:31:11 UTC]Huidige actieve verdeling: 17.10.01.0.1479
[30-okt-2024 16:31:11 UTC] Upgradeaanvraag voor SW-versie : 17.12.05
[30-okt-2024 16:31:14 UTC] De upgrade configureren bevestig de timer tot 15 minuten
[30-okt-2024 16:31:14 UTC] Software Afbeelding ir1101-universalk9.17.12.05.bin
[30-okt-2024 16:31:14 UTC] Verzenden van de gevraagde upgrade actie naar het apparaat
[30-okt-2024 16:31:14 UTC] Software image downloaden vanaf het begin kan tot 60 minuten duren
[30-okt-2024 16:31:18 UTC] [in_progress] Voorafgaande upgrade-controle: Pre-upgrade controles voor 'Download en Upgrade' workflow
[30-okt-2024 16:32:35 UTC] [succes] Geldigheid van afbeelding: De afbeelding is compatibel met het platform
[30-okt-2024 16:32:35 UTC] [succes] Image Controller-versie 20.12 is compatibel met vManager versie 20.12
[30-okt-2024 16:32:35 UTC] [succes] Disc Space Check: De schijf heeft voldoende ruimte om het nieuwe image te installeren
[30-okt-2024 16:32:35 UTC] [succes] SD-WAN Installateurs Space Check: SD-WAN installateur heeft voldoende ruimte
[30-okt-2024 16:32:35 UTC] [succes] Systeem heeft gezonde CPU niveaus
[30-okt-2024 16:32:35 UTC] [succes] Gebruikscontrole geheugen: Systeem heeft gezonde geheugenniveaus
[30-okt-2024 16:32:35 UTC] [succes] Config-register controleren: Automatisch opstarten is ingeschakeld
[30-okt-2024 16:32:35 UTC] [succes] Status van verbinding met controle: Control-verbinding met vManager is UP
[30-okt-2024 16:32:35 UTC] [succes] Pre-upgrade controle voltooid: De gevraagde workflow doorlopen
[30-okt-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-okt-2024 16:40:00 UTC] Apparaat: Ontvangen installatieaanvraag voor softwareversie (5-tuple): 17.12.05
[30-okt-2024 16:44:59 UTC] Apparaat: Geïnstalleerd op 17.12.05
[30-okt-2024 16:45:01 UTC] Apparaat: Het apparaat herladen om 17.12.05 te activeren
[30-okt-2024 16:57:07 UTC] Apparaat: Na het upgraden is de controle voltooid. Huidige actieve verdeling is 17.12.05
[30-okt-2024 16:57:32 UTC] Apparaat: Succesvol toegepaste upgrade-bevestig
[30-okt-2024 16:57:48 UTC] Software installatie voltooid
Opmerking: De term vManager in het bericht verwijst naar SD-WAN Manager.
- Stel standaard in op 17.12.05 en verwijder 17.10.04 van apparaat in SD-WAN Manager.
5. Controleer de upgrade:
- Na het opnieuw opstarten, login terug naar SD-WAN Manager.
- Controleer of op het apparaat het 17.12.05-beeld wordt uitgevoerd.
Opmerking: Als de beoogde upgrade 17.12.05 is, dan eindigt het upgradeproces hier, als het doel upgrade naar 17.15.01a, dan ga naar de volgende stap.
6. 17.12.05 TO 17.15.01a upgrade van vereiste SD-WAN Manager versie 20.15:
Afbeelding 17.15.01a uploaden:
- Nogmaals, navigeer naar de software upgrade sectie.
- Selecteer de optie om een nieuwe afbeelding te uploaden.
- Upload de softwareversie 17.15.01
Installeer het 17.15.01a-beeld:
- Start het upgradeproces om de software-installatie uit te voeren
- Controleer het proces en zorg ervoor dat het apparaat met succes wordt opgestart naar de definitieve softwareversie.
[3-nov-2024-6:57:40 UTC] De actie Software Install is voor uitvoering ingediend
[3-nov-2024 6:57:42 UTC] Apparaatactie uitvoeren Software Installatie
[3-nov-2024 6:57:42 UTC] Installatie en activering software image
[3-nov-2024 6:57:46 UTC]Huidige actieve verdeling: 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 bevestig 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 de gevraagde upgrade actie naar het apparaat
[3-nov-2024 6:57:53 UTC] Het downloaden van de software-afbeelding kan tot 60 minuten duren
[3-nov-2024 6:57:56 UTC] [in_progress] Voorafgaande upgrade-controle: Pre-upgrade controles voor 'Download en Upgrade' workflow
[3-nov-2024 6:58:14 UTC] [succes] Geldigheidscontrole van het beeld: De afbeelding is compatibel met het platform
[3-nov-2024 6:58:14 UTC] [succes]Image compatibiliteit met controller: Image Controller-versie 20.15 is compatibel met vManager versie 20.15
[3-nov-2024 6:58:14 UTC] [succes] Disc Space Check: De schijf heeft voldoende ruimte om het nieuwe image te installeren
[3-nov-2024 6:58:14 UTC] [succes] SD-WAN Installateurs Space Check: SD-WAN installateur heeft voldoende ruimte
[3-nov-2024 6:58:14 UTC] [succes] Systeem heeft gezonde CPU niveaus
[3-nov-2024 6:58:14 UTC] [succes] Gebruikscontrole geheugen: Systeem heeft gezonde geheugenniveaus
[3-nov-2024 6:58:14 UTC] [succes] Config-register-controle: Automatisch opstarten is ingeschakeld
[3-nov-2024 6:58:14 UTC] [succes] Status van verbinding met controle: Control-verbinding met vManager is UP
[3-nov-2024 6:58:14 UTC] [succes] Pre-upgrade controle voltooid: De gevraagde workflow doorlopen
[3-nov-2024 6:58:16 UTC] Apparaat: Downloaden</software/pakket/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 installatieaanvraag voor softwareversie (5-tuple): 17.15.01a.0.193
[3-nov-2024 7:11:22 UTC] Apparaat: Geïnstalleerd op 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: Na het upgraden is de controle voltooid. Huidige actieve partitie is 17.15.01a.0.193
[3-nov-2024 7:23:42 UTC] Apparaat: Succesvol toegepaste upgrade-bevestig
[3-nov-2024 7:24:00 UTC] Software installatie voltooid
Stappen na de upgrade
Verwijder de 17.12.05 tussenafbeelding die niet langer nodig is om de ruimte vrij te maken voor andere doeleinden.
- Standaardversie instellen op 17.15.01a van Onderhoud -> Apparaat selecteren -> Acties voor softwareafbeeldingen -> Standaardversies instellen

- Verwijder de tussentijdse 17.12.05 build van vmanagement GUI door te navigeren naar Maintenance -> selecteer apparaat -> Software Image actions -> Verwijder de beschikbare software
Selecteer vanuit de vervolgkeuzelijst 17.12.05

Belangrijkste punten
- Software versies: Zorg ervoor dat u de exacte genoemde beeldversies (17.12.05 als tussenversie en 17.15.01a als definitieve versie) gebruikt voor een upgrade van 17.10.x naar 17.15.x.
- Dit is alleen van toepassing op IR1101’s die in controllermodus zijn die SD-WAN Manager gebruikt om het upgradeproces uit te voeren.
- Aangezien dit een upgradeproces in twee stappen is, kan het onderhoudsvenster op basis hiervan worden gepland.
- Zorg ervoor dat u 17.12.05 afbeelding uit SD-WAN Manager verwijdert nadat de upgrade met succes is voltooid.