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.

issu primary [ on-error { reload-primary | reload-secondary } ]

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.