Upgrading a Stack with ISSU

The following examples for copying images represent typical use. Other options, such as manifest-based image copy, can also be used. Refer to Initial steps and The upgrade process for more information before performing the upgrade.

Complete the following steps to upgrade a stack using ISSU.

Note: By default, switches are booted from the primary partition.

  1. Copy the images.
    1. Back up the running image to the secondary partition. 
      device# copy flash flash secondary
    2. Copy the new image from its server location to the primary partition. 
      device# copy tftp flash 10.10.10.10 SWR08090aufi.bin primary
    The IP address in the example is for the TFTP server. The address can be an IPv4 or IPv6 address. The .bin file is the name of the image file.
  2. Check the sequence of the upgrade. 
    device# show issu sequence
Stack units will be upgraded in the following order
ID Type         Role
1 ICX7850-48F   standby
3 ICX7850-48F   member
4 ICX7850-48F   active
    The example shows the sequence for a three-unit stack.
  3. Initiate the upgrade.

    Use the issu primary command, preferably with an error recovery option, if you downloaded the image to the primary partition of the flash.

    Or use the issu secondary command, preferably with an error recovery option, if you downloaded the image to the secondary partition.

    Note: RUCKUS recommends using an error recovery option when upgrading.
    Note: The issu command option on-error reload-primary shown in the following example specifies an automatic reload from the primary partition if there is an upgrade error. You can also specify the option on-error reload-secondary to reload from the secondary partition to bring the stack back up with the original image.

    • Initiating the upgrade with error recovery. 

      device# issu primary on-error reload-primary 
Stacking Topology is Ring                Yes
Standby Present                          Yes
Standby ready for upgrade                Yes
Flash use in progress                    No
Stack interactive-setup in progress      No
Stack ZTP is configured                  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
Boot option present in running config    No
User in Config mode                      No
POE-Firmware Download is in Progress     No
Proceed with upgrade? (enter 'y' or 'n'):

    • Initiating the upgrade without error recovery (not recommended) 

      device# issu secondary
Stacking Topology is Ring                Yes
Standby Present                          Yes
Standby ready for upgrade                Yes
Flash use in progress                    No
Stack interactive-setup in progress      No
Stack ZTP is configured                  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
Boot option present in running config    No
User in Config mode                      No
POE-Firmware Download is in Progress     No
Proceed with upgrade? (enter 'y' or 'n'):
      If an error occurs when the upgrade was initiated without error recovery, the error condition is marked by three asterisks. 
      device# issu primary
Stacking Topology is Ring                Yes
Standby Present                          No   ***
Standby ready for upgrade                No   ***
Flash use in progress                    No
Stack interactive-setup in progress      No
Stack ZTP is configured                  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
Boot option present in running config    No
User in Config mode                      No
POE-Firmware Download is in Progress     No
System not ready for issu. Check error condition highlighted by "***" and rectify.
ISSU not in progress

  4. Enter y when prompted to start the upgrade, or n to stop the process.
  5. Wait for the upgrade to complete, and check the status. (You may check the status at any time.)
    The following show issu status command output indicates the successful completion of an ISSU upgrade. 
    device# show issu status
Last upgrade time 00:02:19.367 GMT+00 Tue Mar 20 2019
The older image before-ISSU SPR08090.bin
Stacking Topology is Ring                Yes
Standby Present                          Yes
Standby ready for upgrade                Yes
Flash use in progress                    No
Stack interactive-setup in progress      No
Stack ZTP is configured                  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
Boot option present in running config    No
User in Config mode                      No
POE-Firmware Download is in Progress     No
System ready for issu
ISSU not in progress

    The following example shows a status display for an upgrade that is in progress. 

    device# show issu status
ISSU Status: In Progress
Upgrade State: UNIT JOIN
Upgrade Option: issu primary
ID   Type          Role      State        
1    ICX7850-48F   member    UPGRADING           
3    ICX7850-48F   member    UPGRADE PENDING     
4    ICX7850-48F   active    UPGRADE PENDING
    If the upgrade has not been initiated, the show issu status command displays information about whether the system is ready for the upgrade.

    The following example shows a status display for an aborted upgrade. 

    device# show issu status
ISSU Status: Aborted
Upgrade State: UPGRADE ABORT
Upgrade Option: issu primary
Reason for Abort: UNABLE TO UPGRADE
ID   Type          Role      State        
1    ICX7850-48F   member    UPGRADE ABORT       
3    ICX7850-48F   standby   UPGRADE PENDING     
4    ICX7850-48F   active    UPGRADE PENDING
    The following example shows an unsuccessful ISSU that was aborted due to a hot swap error. 
    device# show issu status 
 Abort info before recovery upgrade:
         Reason for abort                 HOTSWAP ERROR
         Hotswap error with Unit 1
 Topology is Ring                         Yes
 Standby Present                          Yes
 Standby ready for upgrade                Yes
 Flash use in progress                    No
 Stack interactive-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
 Boot option present in running config    No
 User in Config mode                      No
 POE-Firmware Download is in Progress     No
 System ready for issu
 ISSU not in progress
    If the upgrade is aborted manually or if ISSU detects an abort condition (when the issu command is used without the on-error option), the stack is left as it is, and a manual recovery is required.

Summary ISSU Command Sequence for Upgrading a Stack

device# copy flash flash secondary
device# copy tftp flash 10.10.10.10 SWR0809a0ufi.bin primary
device# show issu sequence
device# issu primary on-error reload-primary 
device# show issu status
Parent topic: In-Service Software Upgrade