Upgrade Catalyst 9800 WLC HA SSO met behulp van ISSU

Inleiding

In dit document wordt beschreven hoe u een paar 9800 draadloze controllers in HSSO kunt upgraden met de ISSU-methode (In-Service Software Upgrade).

Vereisten

Het document behandelt de procedure, de beperking, de te nemen voorzorgsmaatregelen en de upgradeinstructies.

Cisco raadt kennis van de volgende onderwerpen aan:

• Catalyst 9800 Wireless LAN Controller (WLC)
• Stateful Switchover (HSSO) met hoge beschikbaarheid

Gebruikte componenten

Dit document is niet beperkt tot specifieke software- en hardware-versies.

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden gebruikt, zijn gestart met een uitgeklaarde (standaard) configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Hoe werkt ISSU

ISSU is een functie waarmee u de 9800 draadloze controllers kunt upgraden met minimale downtime. Als u voldoende dekking hebt, is de upgrade naadloos en mogen de draadloze clients geen downtime waarnemen. Om dit mogelijk te maken, heeft ISSU een mechanisme dat één controller per keer upgrades uitvoert en AP's in staat stelt om gespreid te upgraden.

Hier is een kort overzicht van de verschillende stappen die optreden tijdens een ISSU-upgrade:

1. Het doelimage (V2) wordt gedownload naar de primaire controller waarop V1 wordt uitgevoerd en uitgebreid in pakketten. 
2. Het beeld wordt vervolgens gesynchroniseerd met de hot standby-controller via de RP-verbinding. Dit proces is hetzelfde voor elk type upgrade
3. Het bijbehorende AP-image (V2) is vooraf gedownload naar de AP's. Het vooraf downloaden van een image heeft geen invloed op de service.
4. De standby-controller wordt opnieuw geladen en geladen met het nieuwe image (V2). Op dit punt draait de actieve controller V1 en stand-by run V2 en vormen ze een SSO-paar. Dit is alleen mogelijk tijdens een ISSU-upgrade.
5. Zodra het HA-paar klaar is (actieve/stand-by-hot toestand), wordt een switchover uitgevoerd. De actieve controller draait nu V2 en de standby draait V1. De standby controller wordt opnieuw geladen en komt met V2. In dit stadium staan beide controllers op V2, maar AP's draaien nog steeds op V1.
6. AP's wordt gevraagd om afbeeldingen naar V2 te switches na de activeringsstap en worden op een rollende AP-upgrademanier geüpgraded om de downtime te minimaliseren. Dit betekent dat subgroepen van toegangspunten per cyclus opnieuw worden geladen en dat de clients verbinding kunnen maken met de naburige toegangspunten. Wanneer de AP's opnieuw aansluiten, worden ze weer aangesloten bij V2.
7. De laatste stap is committeren, waardoor de veranderingen blijvend zijn.

Beperkingen

Dit zijn de beperkingen waarvan u op de hoogte moet zijn voordat u overgaat tot een ISSU-upgrade:

• Het basisimage moet Cisco IOS XE 17.3 of hoger zijn
• ISSU is alleen beschikbaar tussen grote releases binnen dezelfde trein. 16.x.x tot 17.x.x of 17.x.x tot de volgende hoofdtrein wordt bijvoorbeeld niet ondersteund
• ISSU-downgrade wordt niet ondersteund voor draadloze controllerplatforms uit de Cisco Catalyst 9800-reeks
• ISSU-upgrade wordt alleen ondersteund voor de controller in de INSTALL-modus (BUNDLE-modus niet ondersteund)
• Een ISSU-upgrade kost meer tijd dan een standaard upgrade door het ontwerp, omdat één WLC zichzelf op een bepaald moment opwaardeert in het HA-paar en vervolgens AP-upgrade op een rollende upgrade om de downtime te minimaliseren. Als u toegangspunten achter een WAN-koppeling hebt met enige latentie, is het belangrijk om de downloadtijd van het toegangspunt tot een minimum te beperken, omdat dit de ISSU-upgradetijd drastisch kan verhogen door het trapsgewijze effect. Kijk naar efficiënte AP-upgrade- of HTTPS-out-of-band-upgrademethoden om de downloadtijd van de AP-afbeelding te versnellen en de totale ISSU-tijd tot een minimum te beperken.

Vereisten en verificaties

Voordat u overgaat tot de upgrade van de 9800 draadloze controllers met behulp van ISSU, zijn er een paar vereisten en verificaties die moeten worden uitgevoerd om een soepele upgrade van de controllers en de toegangspunten te garanderen.

Stap 1: Controleer of er geen actieve of niet-vastgelegde versie wordt uitgevoerd

CLI, opdracht: 

show install summary

Verwachte output: 

U ziet slechts één versie in "C" (voor geactiveerd en vastgelegd) staat: 

WLC#show install summary
[ Chassis 1/R0 2/R0 ] Installed Package(s) Information:
State (St): I - Inactive, U - Activated & Uncommitted,
            C - Activated & Committed, D - Deactivated & Uncommitted
--------------------------------------------------------------------------------
Type  St   Filename/Version
--------------------------------------------------------------------------------
IMG   C    17.09.04a.0.6

Stap 2: Controleer of de controller in de INSTALL-modus staat

Zorg ervoor dat zowel de Active- als de Standby-controllers zich in de installatiemodus bevinden en worden opgestart vanaf "bootflash: /packages.conf" (zie stap 3).

CLI, opdracht: 

show version | i Installation mode

Verwachte output: 

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

Stap 3: Controleer het bestand dat wordt gebruikt voor het opstarten ("packages.conf")

Als de controller zich in de INSTALL-modus bevindt, moet deze worden opgestart vanuit het bestand "packages.conf".

CLI, opdracht: 

show boot

Verwachte output: 

WLC#show boot
BOOT variable = bootflash:packages.conf,12;
CONFIG_FILE variable =
BOOTLDR variable does not exist
Configuration register is 0x102

Standby BOOT variable = bootflash:packages.conf,12;
Standby CONFIG_FILE variable =
Standby BOOTLDR variable does not exist
Standby Configuration register is 0x102

Stap 4: Controleer de redundantiestatus

De actieve controller moet in ACTIEVE toestand zijn en de standby-controller moet in STANDBY-HOT-toestand zijn, wat betekent dat de communicatie UP is en dat ze met elkaar communiceren.

CLI, opdracht: 

show chassis rmi
show redundancy

Verwachte output: 

WLC#show chassis rmi
Chassis/Stack Mac Address : 000c.29c4.caff - Local Mac Address
Mac persistency wait time: Indefinite
                                             H/W   Current
Chassis#   Role    Mac Address     Priority Version  State                 IP                RMI-IP
--------------------------------------------------------------------------------------------------------
*1       Active   000c.29c4.caff     2      V02     Ready                169.254.10.9       198.19.10.9
 2       Standby  000c.29d2.4018     1      V02     Ready                169.254.10.10      198.19.10.10

WLC#show redundancy
Redundant System Information :
------------------------------
...
                 Hardware Mode = Duplex
    Configured Redundancy Mode = sso
     Operating Redundancy Mode = sso
              Maintenance Mode = Disabled
                Communications = Up

Current Processor Information :
-------------------------------
               Active Location = slot 1
        Current Software state = ACTIVE
...

Peer Processor Information :
----------------------------
              Standby Location = slot 2
        Current Software state = STANDBY HOT
...

Stap 5: Controleer of er voldoende ruimte is in de bootflash om de nieuwe afbeelding op te slaan

Een *.bin afbeeldingsgrootte is ongeveer 1 GB. Zorg ervoor dat u meerdere GB vrije ruimte in de bootflash hebt voordat u doorgaat.

CLI, opdracht: 

dir bootflash:/ | in free

Verwachte output: 

WLC#dir bootflash:/ | in free
14785671168 bytes total (11446026240 bytes free)

Stap 6: Controleer of er geen andere upgrade wordt uitgevoerd

Dit is een cruciale stap, want als de controller vastzit in een vorige upgrade, mislukt de nieuwe upgrade.

CLI, opdracht:

show issu state detail

Verwachte output:

WLC#show issu state detail
Current ISSU Status: Enabled
Previous ISSU Operation: N/A
=======================================================
System Check                        Status
-------------------------------------------------------
Platform ISSU Support               Yes
Standby Online                      Yes
Autoboot Enabled                    Yes
SSO Mode                            Yes
Install Boot                        Yes
Valid Boot Media                    Yes
Operational Mode                    HA-REMOTE
=======================================================
No ISSU operation is in progress

Upgradeprocedure

Nadat alle controles zijn geslaagd, kunnen we nu overgaan tot de upgrade van de draadloze controllers. U kunt ervoor kiezen om de controllers te upgraden met behulp van de GUI of de CLI. Er zijn voor- en nadelen aan beide methoden. CLI geeft u meer controle omdat u elke stap afzonderlijk kunt starten, maar dit vereist wat meer werk dan het upgraden via de GUI. Het upgraden van de controller via de GUI kan worden gedaan met een enkele druk op de knop en alle stappen worden automatisch gedaan. Als er echter iets mislukt tijdens de upgrade, moet u naar de CLI gaan om de specifieke stap die is mislukt opnieuw te starten. Deze handleiding toont alleen de CLI-upgradeprocedure, omdat de GUI-procedure eenvoudig kan worden uitgevoerd door de GUI-instructies uit te voeren.

ISSU CLI-workflow

Dit gedeelte geeft een korte samenvatting van de opdrachten die zijn uitgevoerd om de controllers te upgraden. Een volledige uitleg van elke opdracht en alle stappen wordt gegeven:

Volledige procedure

Stap 1: AP-statistieken vóór downloaden wissen

Het is het beste als u deze statistieken wist voordat u een upgrade uitvoert, zodat u een nieuwe uitvoer kunt krijgen die alleen betrekking heeft op de huidige upgrade. Er mag geen pre-download worden uitgevoerd voordat de upgrade wordt gestart.

CLI, opdracht:

clear ap predownload statistics
show ap image

Verwachte output:

WLC#show ap image
Total number of APs  : 2
Number of APs
        Initiated                  : 0
        Downloading                : 0
        Predownloading             : 0
        ...
        Predownload in progress    : No

Stap 2: Verwijder de vorige software-image
In het geval van onvoldoende ruimte in bootflash, kunt u altijd overwegen om de oude installatiebestanden op te ruimen met de opdracht Inactief verwijderen.

CLI, opdracht:

install remove inactive

Stap 3: De waarde van het rolpercentage van het toegangspunt configureren

U kunt deze waarde instellen op maximaal 25% (max. waarde). Houd er rekening mee dat als u 5% (min. waarde) kiest, er minder toegangspunten per iteratie worden bijgewerkt en dat de upgrade langer duurt, maar dit helpt ook de wereldwijde downtime te verminderen. Kies deze waarde op basis van uw implementatie en uw AP-dekking.

CLI, opdracht:

conf t
ap upgrade staggered {5 | 15 | 25 | one-shot}
end
write memory

Stap 4: Download de .bin afbeelding op de controller

Yon kan deze afbeelding uploaden via CLI of via de GUI. Met de GUI wordt dit gedaan wanneer u het upgradeproces start. 

CLI, opdracht:

dir bootflash:*.bin
[OPTIONAL] copy ftp://:@/ bootflash:

Stap 5: Installeer het image

Met deze stap wordt de eerste fase van de upgrade gestart. De controller software image wordt toegevoegd aan de flash en uitgebreid in pakketten. Dit moet een paar minuten duren. Als het proces voor het toevoegen van de installatie is voltooid, controleert u of het nieuwe image wordt gezien als "Inactief" via de opdracht "Overzicht van installatie weergeven".

CLI, opdracht:

install add file bootflash:
show install summary

Verwachte output:

WLC#show install summary
[ Chassis 1/R0 2/R0 ] Installed Package(s) Information:
State (St): I - Inactive, U - Activated & Uncommitted,
            C - Activated & Committed, D - Deactivated & Uncommitted
--------------------------------------------------------------------------------
Type  St   Filename/Version
--------------------------------------------------------------------------------
IMG   C    17.09.04a.0.6
IMG   I    17.12.02.0.2739

Stap 6: Download de afbeelding vooraf naar de toegangspunten

Voordat we het image activeren, moeten we de toegangspunten instrueren om het image dat momenteel inactief is (V2) vooraf te downloaden. Als de pre-download niet wordt gestart, mislukt de ISSU-upgrade omdat dit een vereiste stap is om de downtime te minimaliseren. Deze bewerking kan enkele minuten duren, afhankelijk van het aantal toegangspunten dat is aangesloten op de controller en de latentie van de koppeling.

CLI, opdracht:

ap image predownload
show ap image

Verwachte output:

WLC#show ap image
Total number of APs  : 2

Number of APs
        Initiated                  : 0
        Downloading                : 0
        Predownloading             : 2
        Completed downloading      : 0
        Completed predownloading   : 0
        Not Supported              : 0
        Failed to Predownload      : 0
        Predownload in progress    : Yes

Stap 7: Activeer de nieuwe afbeelding

Zodra de pre-download is voltooid, kunt u de nieuwe afbeelding activeren. Dit is de langste stap van het upgradeproces. Het voert compatibiliteitscontroles uit, installeert het pakket en werkt de details van de pakketstatus bij. Optioneel kunt u de tijdslimiet configureren om de toevoeging van nieuwe software te annuleren zonder het image te verbinden. Geldige waarden zijn van 30 tot 1200 minuten. De standaardwaarde is 360 minuten (6 uur). Zodra u de upgrade start, vindt het hele ISSU-proces plaats: standby-upgrades, switchover, vervolgens nieuwe standby-upgrades en vervolgens de gespreide AP-upgrade.

CLI, opdracht:

install activate issu [auto-abort-timer <30-1200 mins>]

Verwachte output:

WLC#install activate issu
install_activate: START Sun Jan 14 08:29:36 EST 2024
install_activate: Activating ISSU

NOTE: Going to start Activate ISSU install process

STAGE 0: System Level Sanity Check
===================================================
--- Verifying install_issu supported ---
--- Verifying standby is in Standby Hot state ---
--- Verifying booted from the valid media ---
--- Verifying AutoBoot mode is enabled ---
--- Verifying Platform specific ISSU admission criteria ---
--- Verifying Image ISSU Compatibility ---
Finished Initial System Level Sanity Check

STAGE 1: Installing software on Standby
===================================================
--- Starting install_remote ---
[2] install_remote package(s) on chassis 2/R0
WARNING: Found 1545 disjoint TDL objects.
[2] Finished install_remote on chassis 2/R0
install_remote: Passed on [2/R0]
Finished install_remote

STAGE 2: Restarting Standby
===================================================
--- Starting standby reload ---
Finished standby reload

--- Starting wait for Standby to reach terminal redundancy state ---
Finished wait for Standby to reach terminal redundancy state

STAGE 3: Installing software on Active
===================================================
--- Starting install_active ---
WARNING: Found 2969 disjoint TDL objects.
[1] install_active package(s) on chassis 1/R0
[1] Finished install_active on chassis 1/R0 install_active: Passed on [1/R0]
Finished install_active

STAGE 4: Restarting Active (switchover to standby) 
=================================================== 
--- Starting active reload ---
New software will load after reboot process is completed

Het is een goed idee om de huidige status van de upgrade regelmatig te controleren met behulp van de opdrachten "Rmi van het chassis weergeven" en "Redundantie weergeven". Dit laat je zien zodra een controller uit het HA-paar is verwijderd en wanneer deze terugkomt, en op welke versie. Merk op dat het proces ongeveer 20 tot 30 minuten kan duren. 

Zodra de upgrade is voltooid, ziet u het image als actief maar "niet vastgelegd": 

WLC#show install summary
[ Chassis 1/R0 2/R0 ] Installed Package(s) Information:
State (St): I - Inactive, U - Activated & Uncommitted,
            C - Activated & Committed, D - Deactivated & Uncommitted
--------------------------------------------------------------------------------
Type  St   Filename/Version
--------------------------------------------------------------------------------
IMG   U    17.12.02.0.2739

--------------------------------------------------------------------------------
Auto abort timer: active , time before rollback - 05:23:37
--------------------------------------------------------------------------------

Zodra de installatie is voltooid, begint de WLC de toegangspunten gespreid opnieuw te laden. Om de gefaseerde upgrade van het toegangspunt te bewaken, kunt u de GUI (onder "Statistieken van toegangsupgrade" in de sectie "Software-upgrade") of de CLI-opdracht "uptime van het toegangspunt tonen" gebruiken, die de CAPWAP-uptime van het toegangspunt weergeeft. Dit geeft een indicatie van welke toegangspunten al opnieuw zijn geladen. U kunt ook controleren of de AP-upgrade is voltooid door de logboeken te controleren met de opdracht "logboekregistratie weergeven" op de controller:

Jan 20 14:23:22.478: %UPGRADE-6-STAGGERED_UPGRADE_COMPLETE: Chassis 2 R0/0: wncmgrd: Staggered AP Upgrade completed succesfully

Stap 8: [OPTIONEEL] Stop de timer voor automatisch afbreken

Als u meer tijd nodig hebt dan de standaard 6 uur voor de upgrade (als u veel toegangspunten hebt om te upgraden en ervoor wilt zorgen dat dit goed werkt voordat u het image vastlegt), kunt u deze timer stoppen. Op deze manier zal de automatische terugdraaiing niet plaatsvinden.

CLI, opdracht:

install auto-abort-timer stop

Stap 9: Maak de nieuwe software persistent

De activeringswijzigingen vastleggen voor alle herlaadbewerkingen met de opdracht Instellen vastleggen. Dit is de laatste stap in een normaal upgradeproces. Met de opdracht install commit wordt software permanent bij het opnieuw opstarten gemaakt.

CLI, opdracht:

install commit

Verwachte output:

WLC#show install summary
[ Chassis 1/R0 2/R0 ] Installed Package(s) Information:
State (St): I - Inactive, U - Activated & Uncommitted,
            C - Activated & Committed, D - Deactivated & Uncommitted
--------------------------------------------------------------------------------
Type  St   Filename/Version
--------------------------------------------------------------------------------
IMG   C    17.12.02.0.2739

Zodra de versie is vastgelegd en de toegangspunten opnieuw zijn geladen op de nieuwe versie, is de ISSU-upgrade voltooid.

Aanvullende bewerkingen

U kunt enkele andere bewerkingen vinden die u mogelijk tijdens of na de ISSU-upgrade moet uitvoeren, zoals het afbreken van de upgrade of terugdraaien naar een vorige versie:

ISSU afbreken 

Deze stap annuleert het upgradeproces dat tot nu toe is uitgevoerd en retourneert het apparaat naar de vorige installatiestatus (V1) op ISSU-wijze. Dit geldt voor zowel controllers als toegangspunten. Dit kan worden gedaan in het geval dat u een ernstige impact opmerkt als gevolg van de upgrade en als u het image nog niet hebt vastgelegd. Dit commando en proces werkt alleen als "install commit" nog niet is uitgegeven. Als het beeld eenmaal is vastgelegd, kunt u het niet meer terugdraaien op de ISSU-manier.

CLI, opdracht:

install abort issu

Verwachte output:

STAGE 1: Rolling Back software on Standby
===================================================
--Starting Deactivation at the standby --
--- Starting abort_standby ---
[1] abort_standby package(s) on chassis 1/R0
WARNING: Found 1545 disjoint TDL objects.

[1] Finished abort_standby on chassis 1/R0
abort_standby: Passed on [1/R0]
Finished abort_standby

STAGE 2: Restarting Standby
===================================================
--- Starting standby reload ---
Finished standby reload

--- Starting wait for Standby to reach terminal redundancy state ---
Finished wait for Standby to reach terminal redundancy state

STAGE 3: Rolling Back software on Active
===================================================
--Starting Deactivation at the active --
--- Starting abort_active ---
WARNING: Found 1545 disjoint TDL objects.
[2] abort_active package(s) on chassis 2/R0
[2] Finished abort_active on chassis 2/R0
abort_active: Passed on [2/R0]
Finished abort_active

STAGE 4: Restarting Active (switchover to standby)
===================================================
--- Starting active reload ---
New software will load after reboot process is completed
SUCCESS: install_abort  Wed Jan 17 21:58:52 CET 2024
client_loop: send disconnect: Broken pipe

Overschakelen naar de "primaire" controller

In een productieomgeving kan deze stap gewenst zijn als u de originele controller weer actief wilt hebben. Onthoud dat zodra de ISSU-upgrade is voltooid, de "secundaire" eenheid de actieve controller is. U kunt altijd terugkeren naar de oorspronkelijke staat door een handmatige omschakeling uit te voeren. U moet ervoor zorgen dat de peer-eenheid zich in de status "Standby Hot" bevindt voordat u doorgaat.

CLI, opdracht:

redundancy force-switchover

Terugdraaien naar vorige status zodra ISSU-upgrade is voltooid

Als de upgrade eenmaal is uitgevoerd, wordt ISSU-downgrade niet ondersteund voor Cisco Catalyst 9800 Series Wireless Controller-platforms. Op dit punt betekent een terugdraaiing dat zowel draadloze controllers als toegangspunten opnieuw worden geladen vanwege de codewijziging en dit zorgt voor downtime. U kunt beginnen met het controleren van de beschikbare rollback punten en vervolgens beslissen naar welke te rollback. 

CLI, opdracht:

show install rollback
show install rollback id  
install rollback to id 

Verwachte output:

WLC#sh install rollback
ID      Label                            Description
-------------------------------------------------------
3       No Label                         No Description
2       No Label                         No Description
1       No Label                         No Description

WLC#sh install rollback id 2
Rollback id - 2 (Created on 2024-04-22 10:31:57.000000000 +0000)
Label: No Label
Description: No Description
Reload required: NO
State (St): I - Inactive, U - Activated & Uncommitted,
            C - Activated & Committed, D - Deactivated & Uncommitted
--------------------------------------------------------------------------------
Type  St   Filename/Version
--------------------------------------------------------------------------------
IMG   C    17.09.04a.0.6

WLC#install rollback to id 2
install_rollback: START Thu May 30 09:44:38 UTC 2024
install_rollback: Rolling back to id 2

This operation may require a reload of the system. Do you want to proceed? [y/n]y

--- Starting Rollback ---
Performing Rollback on all members
 [2] Rollback package(s) on Chassis 2/R0
 [1] Rollback package(s) on Chassis 1/R0
 [2] Finished Rollback package(s) on Chassis 2/R0
Checking status of Rollback on [1/R0 2/R0]
Rollback: Passed on [1/R0 2/R0]
Finished Rollback operation

SUCCESS: install_rollback Thu May 30 09:45:40 UTC 2024

Problemen oplossen

Als u voor, tijdens of na de upgrade van de 9800 draadloze controllers met ISSU met een probleem wordt geconfronteerd, raden we u aan dit document door te nemen waarin de veelvoorkomende problemen en hun oplossingen worden uitgelegd.

Referenties

• Hoge beschikbaarheid met behulp van Patching en Rolling AP Upgrade op Cisco Catalyst 9800 draadloze controllers
• 17.12.X configuratiehandleiding