issu primary
-
- Last UpdatedAug 13, 2021
- 2 minutes read
Initiates an in-service software upgrade (ISSU) using the image on the primary partition and configures the system to reload from either the primary image or the secondary image if the upgrade fails.
If an error occurs ths default behavior is to abort the ISSU.
on-error
| Specifies the action to take if there is an upgrade failure from the primary image.
|
reload-primary
| Causes the system to reload from the primary partition if an upgrade from the primary partition fails.
|
reload-secondary
| Causes the system to reload from the secondary partition if an upgrade from the primary partition fails.
|
Privileged EXEC mode
Before you use this command, back up the running image to the secondary partition, use the existing image upgrade framework to copy the new image to the primary or secondary partition, and check the sequence of the upgrade with the show issu sequence command.
The issu primary command without any keywords initiates an ISSU.
If a manual abort is done or ISSU detects an abort condition (with ISSU started with no on-error option), the stack is left as is and a manual recovery is required.
If a manual recovery is required, you run either the reload-primary or reload-secondary command.
The following example shows how to start an ISSU, using an image that has been copied to the primary partition.
device# issu primary
Topology is Ring Yes
Standby Present Yes
Standby ready for upgrade Yes
Flash use in progress No
Secure Setup in progress No
ISSU in progress or aborted No
Election pending No
Election in progress No
Reload pending No
CPU utilization high No
All units in ready state Yes
Primary Image is upgrade compatible Yes
Startup config and Running Config Same Yes
User in Config mode No
Proceed with upgrade? (enter 'y' or 'n'):
If the system is not ready for an ISSU, the error condition is highlighted.
device# issu primary
Topology is Ring Yes
Standby Present No ***
Standby ready for upgrade No ***
Flash use in progress No
Secure Setup in progress No
ISSU in progress or aborted No
Election pending No
Election in progress No
Reload pending No
CPU utilization high No
All units in ready state Yes
Primary Image is upgrade compatible Yes
Secondary Image is upgrade compatible Yes
Startup config and Running Config Same Yes
User in Config mode No
System not ready for issu. Check error condition highlighted by "***" and rectify.
ISSU not in progress
The behavior in case ISSU fails can be specified. In the following example the specified behavior is to reload the image on the secondary partition.
device# issu primary on-error reload-secondary
Release version | Command history |
---|---|
08.0.50 | This command was introduced. |
08.0.70 | Added Campus Fabric (SPX) system support. |