Upgrading a Campus Fabric (SPX) System with ISSU

Complete the following steps to upgrade an SPX system using 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.

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

The IP address used in the following code examples (10.10.10.10) is for the TFTP server. The address may be an IPv4 or an IPv6 address. The .bin file names used in the examples are image file names.

  1. Copy the images.
    1. Back up the running image on the CB to the secondary partition. 
      device# copy flash flash secondary
    2. Back up the running image on the PE to the secondary partition. 
      device# copy tftp flash 10.10.10.10 SPR08090.bin secondary
    3. Copy the new image to the primary partition on the CB. 
      device# copy tftp flash 10.10.10.10 SWR08090aufi.bin primary
    4. Copy the new image to the primary partition on the PE. 
      device# copy tftp flash 10.10.10.10 SPR08090aufi.bin primary
  2. Check the sequence of the upgrade. 
    device# show issu sequence 

Stack units will be upgraded in the following order
ID     Type              Role   
 2      ICX7750-20QXG     standby
 3      ICX7750-48XGF     member 
20      ICX7150-48PF      spx-pe 
21      ICX7150-48P       spx-pe 
22      ICX7150-48P       spx-pe 
18      ICX7450-24G       spx-pe 
19      ICX7450-24G       spx-pe 
 1      ICX7750-20QXG     active 
17      ICX7450-24G       spx-pe
  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
Spx interactive-setup in progress        No
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
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
Spx interactive-setup in progress        No
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
Proceed with upgrade? (enter 'y' or 'n'):
      Note: If you initiate an upgrade without error recovery and an error occurs, the error condition is marked by three asterisks. 
      device# issu 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
Spx interactive-setup in progress        No
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.
  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 example displays show issu status command output for an ISSU in progress for an SPX system. 

    device# show issu status
ISSU Status: In Progress
Upgrade State: UNIT TO BE UPGRADED
Upgrade Option: issu primary on-error reload-primary

ID   Type          Role      State        
2    ICX7750-20QXG standby   UPGRADE PENDING     
3    ICX7750-48XGF member    UPGRADE PENDING     
20   ICX7150-48PF  spx-pe    UPGRADE PENDING     
21   ICX7150-48P   spx-pe    UPGRADE PENDING     
22   ICX7150-48P   spx-pe    UPGRADE PENDING     
18   ICX7450-24G   spx-pe    UPGRADE PENDING     
19   ICX7450-24G   spx-pe    UPGRADE PENDING     
1    ICX7750-20QXG active    UPGRADE PENDING     
17   ICX7450-24G   spx-pe    UPGRADE PENDING
    If the upgrade has not been initiated, the command displays information on whether the system is ready for upgrade.

    The following show issu status command example displays output for an aborted ISSU. 

    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        
2    ICX7750-20QXG standby   UPGRADE ABORT     
3    ICX7750-48XGF member    UPGRADE PENDING     
20   ICX7150-48PF  spx-pe    UPGRADE PENDING     
21   ICX7150-48P   spx-pe    UPGRADE PENDING     
22   ICX7150-48P   spx-pe    UPGRADE PENDING     
18   ICX7450-24G   spx-pe    UPGRADE PENDING     
19   ICX7450-24G   spx-pe    UPGRADE PENDING     
1    ICX7750-20QXG active    UPGRADE PENDING     
17   ICX7450-24G   spx-pe    UPGRADE PENDING
    Note: If the upgrade is aborted manually, or if the ISSU process 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 an SPX System

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