In-Service Software Upgrade (ISSU)

Information About In-Service Software Upgrade (ISSU)

ISSU is a process that upgrades an image to another image on a device while the network continues to forward packets. ISSU helps network administrators avoid a network outage when performing a software upgrade. ISSU is supported in install mode.

Note

Refer to the release notes and check the list of unsupported commands across releases before initiating an ISSU upgrade, as the upgrade may fail when unsupported commands are present.

ISSU Process Recommendations for Cisco IOS XE 17.15.x and 17.18.1

Due to a collateral introduced in 17.15 and later versions, avoid the ISSU process until a fix is available in IOS-XE. Use the normal upgrade process. This notice does not affect any other feature or code evaluation at this time.

The defects tracked are CSCws35670 and CSCwr15775. Both the fixes are required for ISSU to work.

Symptoms:

The symptoms may vary, and they may include:

controller crash
NETCONF is broken after upgrade
missing 802.11be profiles that cause WLANs not to be broadcast
WLANs are not pushed to the APs
the GUI is unresponsive

Recovery:

Delete the persistent database configuration. Reload both the controllers without saving the configuration (configuration is recreated from startup-config).

delete /force /recursive bootflash:.dbpersist/persistent-config.tar.gz
delete /force /recursive bootflash:.dbpersist/persistent-config.meta
delete /force /recursive stby-bootflash:.dbpersist/persistent-config.tar.gz
delete /force /recursive stby-bootflash:.dbpersist/persistent-config.meta

Detection:

The 802.11be profile issue has been included in WCAE 1.3. Additional symptoms are currently under evaluation for automated detection.

If you have performed ISSU from older releases, such as 17.9 or 17.12 to 17.15 or 17.18, you may be impacted. In this case, perform the recommended recovery process.

ISSU Support between Releases

EM: extended maintenance

SM: standard maintenance

For information on IOS XE Software Lifecycle, see the following link: https://www.cisco.com/c/en/us/products/collateral/ios-nx-os-software/ios-xe-16/bulletin-c25-2378701.html

Supported Scenarios

Unsupported Scenarios

Within a major release train (17.x or 18.x ), ISSU is supported between any two EMs that are released not more than 3 years apart.
Within a major release train, ISSU is supported from:
- Any EM (EM1, EM2, EM3) to another EM (EM1, EM2, EM3)
  
  Example: 17.3.x to 17.6.x, 17.6.x to 17.9.x
- Any release within the same EM
  
  Example: 17.3.1 to 17.3.2 or 17.3.3 or 17.3.x

Between major release trains, ISSU is not supported from:
- An EM of a major release train to an EM of another major release train
  
  Example: 16.x.x to 17.x.x or 17.x.x to 18.x.x is not supported
- An SM to EM or EM to SM
  
  Example: 17.3.x or 17.4.x to 17.5.x is not supported
ISSU is not supported on engineering special releases and .s (or similar) images.
ISSU is not supported between Licensed Data Payload Encryption (LDPE) and No Payload Encryption (NPE) Cisco IOS XE software images.
ISSU downgrades are not supported.

Note

No configuration changes should be performed while ISSU is being performed.

Release Support Matrix

The following tables show ISSU support within the same EM.

For Cisco Catalyst 9800 Series Wireless Controllers, ISSU support starts from Cisco IOS XE Amsterdam 17.3.1.

For a comprehensive list of supported ISSU upgrade matrices across multiple releases for the Cisco Catalyst 9800 Series Wireless Controllers, see the following link: https://www.cisco.com/c/dam/td-xml/en_us/wireless/vewlc/issu/ISSU-Matrix_Updated.xlsx.

Cisco Catalyst 9800 Series Wireless Controllers

Table 1. **Cisco Catalyst 9800 Series Wireless Controllers - 17.3.x Release**
From/To	17.3.1	17.3.2a	17.3.3	17.3.4	17.3.4c	17.3.5	17.3.5a	17.3.5b	17.3.6	17.3.7	17.3.8	17.3.8a	17.6.1	17.6.2	17.6.3	17.6.4	17.6.5	17.6.6	17.6.6a	17.6.7	17.6.8	17.9.1	17.9.2	17.9.3	17.9.4	17.9.4a	17.9.5	17.9.6	17.9.7
17.3.1	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.3.2a	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.3.3	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.3.4	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.3.4c	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.3.5	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.3.5a	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.3.5b	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.3.6	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.3.7	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.3.8	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.3.8a	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.1	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.2	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.3	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.4	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.5	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.6	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.6a	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.7	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.8	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓
17.9.1	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓
17.9.2	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓
17.9.3	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓
17.9.4	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓
17.9.4a	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓
17.9.5	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓
17.9.6	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓
17.9.7	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—

Table 2. **Cisco Catalyst 9800 Series Wireless Controllers - 17.6.x Release**
From/To	17.6.1	17.6.2	17.6.3	17.6.4	17.6.5	17.6.6	17.6.6a	17.6.7	17.6.8	17.9.1	17.9.2	17.9.3	17.9.4	17.9.4a	17.9.5	17.9.6	17.9.7	17.12.1	17.12.2	17.12.3	17.12.4	17.12.5	17.12.6a
17.6.1	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.2	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.3	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.4	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.5	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.6	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.6a	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.7	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.6.8	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.9.1	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.9.2	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.9.3	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.9.4	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.9.4a	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.9.5	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓
17.9.6	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓
17.9.7	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓
17.12.1	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓
17.12.2	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓
17.12.3	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓
17.12.4	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓
17.12.5	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓
17.12.6a	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—

Table 3. **Cisco Catalyst 9800 Series Wireless Controllers - 17.9.x Release**
From/To	17.9.1	17.9.2	17.9.3	17.9.4	17.9.4a	17.9.5	17.9.6	17.9.7	17.12.1	17.12.2	17.12.3	17.12.4	17.12.5	17.12.6a	17.15.1	17.15.2	17.15.2b	17.15.3	17.15.4b
17.9.1	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.9.2	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.9.3	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.9.4	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.9.4a	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.9.5	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.9.6	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.9.7	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.12.1	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.12.2	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.12.3	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓
17.12.4	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓	✓
17.12.5	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓	✓
17.12.6a	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓	✓
17.15.1	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓	✓
17.15.2	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓	✓
17.15.2b	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓	✓
17.15.3	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—	✓
17.15.4b	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	—

Table 4. **Cisco Catalyst 9800 Series Wireless Controllers - 17.12.x Release**
From/To	17.12.1	17.12.2	17.12.3	17.12.4	17.12.5	17.12.6a	17.15.1	17.15.2	17.15.2b	17.15.3	17.15.4b
17.12.1	—	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.12.2	x	—	✓	✓	✓	✓	✓	✓	✓	✓	✓
17.12.3	x	x	—	✓	✓	✓	✓	✓	✓	✓	✓
17.12.4	x	x	x	—	✓	✓	✓	✓	✓	✓	✓
17.12.5	x	x	x	x	—	✓	✓	✓	✓	✓	✓
17.12.6a	x	x	x	x	x	—	✓	✓	✓	✓	✓
17.15.1	x	x	x	x	x	x	—	✓	✓	✓	✓
17.15.2	x	x	x	x	x	x	x	—	✓	✓	✓
17.15.2b	x	x	x	x	x	x	x	x	—	✓	✓
17.15.3	x	x	x	x	x	x	x	x	x	—	✓
17.15.4b	x	x	x	x	x	x	x	x	x	x	—

How to Configure ISSU

To configure ISSU, see the In-Service Software Upgrade chapter of the configuration guide:

Cisco Catalyst 9800 Series Wireless Controller Software Configuration Guide

Additional References for ISSU


Related Topic	Document Title
Software Configuration Guides	Cisco Catalyst 9800 Series Wireless Controller Software Configuration Guide
Release Notes	Release Notes for Cisco Catalyst 9800 Series Wireless Controller
Command References	Cisco Catalyst 9800 Series Wireless Controller Command Reference
Troubleshooting TechNotes

In-Service Software Upgrade (ISSU)

Available Languages

Download Options

Bias-Free Language

In-Service Software Upgrade (ISSU)

Information About In-Service Software Upgrade (ISSU)

ISSU Process Recommendations for Cisco IOS XE 17.15.x and 17.18.1

ISSU Process Recommendations for Cisco IOS XE 17.15.x and 17.18.1

ISSU Support between Releases

Release Support Matrix

Cisco Catalyst 9800 Series Wireless Controllers

How to Configure ISSU

Additional References for ISSU

Was this Document Helpful?

Contact Cisco

This Document Applies to These Products