The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Cisco cBR-8 Routers support the In-Service Software Upgrades (ISSU) for redundant platforms.
Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the Feature Information Table at the end of this document.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to http://tools.cisco.com/ITDIT/CFN/. An account on http://www.cisco.com/ is not required.
Note | The hardware components introduced in a given Cisco IOS-XE Release are supported in all subsequent releases unless otherwise specified. |
Cisco cBR-8 Routers support the In-Service Software Upgrades (ISSU) for redundant platforms. The ISSU process allows software to be updated or otherwise modified while packet forwarding continues with the benefit of LCHA. ISSU supports two different software upgrade modes:
For the Cisco cBR Series Routers, ISSU-compatibility depends on the software subpackage being upgraded and the hardware configuration. Consolidated packages are ISSU-compatible in dual SUP configurations only and have other limitations described later in this document.
The specific procedures in this document represent supported and tested installation sequences. The Cisco IOS-XE system software allows other installation sequences for special purposes under the guidance of Cisco customer support representatives, but the steps in this document should be followed otherwise. These steps should be followed completely, as the Cisco cBR Series Routers are designed to run one version of Cisco IOS-XE for all consolidated packages and subpackages on an SUP, and running subpackages from different versions of Cisco IOS-XE can cause unexpected router behavior.
This section describes the configuration of the ISSU feature:
Consolidated packages can only be upgraded using ISSU in dual SUP configurations. ISSU is not supported for consolidated package upgrades in single SUP configurations.
In service one-shot software upgrade procedure enables you to upgrade or downgrade software using a single command. One-shot ISSU needs minimal user intervention or monitoring.
The one-shot upgrade procedure is divided into stages. When a failure occurs, the command execution is stalled and users have to perform the rollback tasks manually. Necessary switchovers are automatically taken care of in one of the upgrade stages. During a switchover, the console and its output are lost. Additional commands are used to connect back to the console.
Note | One-shot upgrade does not support multiple upgrades at the same time. |
Be sure to complete the following prerequisites before running the consolidated package upgrade process:
Use request platform software package install node abort command to abort the ISSU procedure.
When user abort the ISSU, the linecards will be in the different version with the SUP.
If the customer believes the new version is not stable, and wants to stop the upgrade, he can use this command to abort the current upgrade process. After this command is entered, the customer needs to check both SUP and LC's states to decide what to do in the next step, eg: rollback.
Command or Action | Purpose |
---|
If the customer is not satisfied with the new package after the upgrade, the system can go back to previous working state using rollback operation. The linecards that do not in the redundancy group will be reloaded.
Note | Rollback operation can only go back one step in the history. If the customer wants to go back to an earlier image, downgrade operation should be used. |
The following steps can be used to perform the consolidated package upgrade rollback.
1.
enable
2.
request
platform
software
package
install
node
rollback
Command or Action | Purpose |
---|
Subpackage upgrade allows a subset of the running software to be upgraded. It is intended for patching small and targeted fix instead of full image upgrade. Subpackage upgrade supports both single and dual SUP setup.
Be sure to complete the following prerequisites before running the ISSU process:
Be sure to complete the following prerequisites before running the ISSU process:
If the customer is not satisfied with the new package after the upgrade, the system can go back to previous working state using rollback operation. The linecards that do not in the redundancy group will be reloaded.
Note | Rollback operation can only go back one step in the history. If the customer wants to go back to an earlier image, downgrade operation should be used. |
The following steps can be used to perform the subpackage upgrade rollback.
1.
enable
2.
request
platform
software
package
install
rp 0
rollback
Command or Action | Purpose |
---|
If the upgrade fails or is manually aborted at linecard upgrade stage, user can initiate linecard only upgrade.
Use request platform software package install node linecard-only command to upgrade only the linecard to the same version as the one in the current active SUP, the customer can choose to upgrade one linecard or all the linecards in the chassis.
This command can be used together with request platform software package install node file file-path noreload linecard command to upgrade SUP first, and then upgrade linecard.
Command or Action | Purpose |
---|
The following sections provide references related to the ISSU feature.
Description |
Link |
---|---|
The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password. |
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note | The table below lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature. |
Feature Name |
Releases |
Feature Information |
---|---|---|
ISSU |
Cisco IOS-XE Release 16.5.1 |
This feature was integrated into Cisco IOS-XE Release 16.5.1 on the cisco cBR Series Converged Broadband Routers. |