Upgrade the Software

Important

Important

Upgrades from some releases require release-specific steps. For more information, see VSP 8600 Release Notes.

Perform this procedure to upgrade the software on the switch. This procedure shows how to upgrade the software using the internal flash memory as the file storage location.

Use one of the following options to upload the file with the new software to the switch:

  • Use FTP or SFTP to transfer the file.

  • Download the image file to your computer. Copy the file to a USB device and insert the USB device into the USB port on the switch.

You can store up to six software releases on 5520 Series, VSP 4450 Series, VSP 4900 Series, VSP 7200 Series, VSP 7400 Series, VSP 8200 Series, VSP 8400 Series, VSP 8600 Series, and XA1400 Series. If you have six releases already stored on the switch, you are prompted to remove one release before you can proceed to add and activate a new software release.

For information about how to remove a software release, see Remove a Software Build.

You can store only two software releases on 5420 Series switches. The software images can be VOSS only or a combination of VOSS and ExtremeXOS. If you attempt to add a third software release, you are prompted for a confirmation to overwrite the non-primary release. You can also use the software add <filename> -y command to bypass the confirmation question and automatically overwrite the non-primary release.

Before you begin

  • To obtain the new software, go to the Extreme Networks support site: http://www.extremenetworks.com/support. You need a valid user or site ID and password.

  • Back up the configuration files.

  • Use an FTP or SFTP application or USB device to transfer the file with the new software release to the switch.

  • Ensure that you have not configured a VLAN above 4059. If you have, you must port all configuration on this VLAN to another VLAN, before you begin the upgrade.

    Caution

    Caution

    Only VLAN range 2 to 4059 is supported. All configuration on a higher numbered VLAN from earlier releases will be lost after the upgrade.

Note

Note

Software upgrade configurations are case-sensitive.

Procedure

  1. Enter Global Configuration mode:

    enable

    configure terminal

  2. If you are using the USB port to transfer files, go to the next step. If you are using FTP or SFTP to download the files, start the FTP daemon on the switch and enable the ftpd flag for FTP or sshd flag for SFTP:
    Note

    Note

    Start an FTP session from your computer to the switch using the same username and password used to Telnet or SSH to the switch. Upload or copy the image to the switch.

    boot config flag <ftpd | sshd>

    end

  3. Download the files to the switch through FTP or SFTP, or transfer them to the switch through the USB port.
  4. Enter Privileged EXEC configuration mode by exiting the Global Configuration mode.

    exit

  5. Extract the release distribution files to the /intflash/release/ directory:

    software add WORD<1-99> -y

    Note

    Note

    The .voss file, which applies to 5420 Series and 5520 Series is removed after thesoftware add command runs.

  6. Install the image:

    software activate WORD<1-99>

  7. Restart the switch:

    reset

    Important

    Important

    After you restart the system, you have the amount of time configured for the commit timer to verify the upgrade and commit the software to gold. If you do not commit the software to gold and auto-commit is not enabled, the system restarts with the last known working version after the commit timer has expired. This feature ensures you can regain control of the system if an upgrade fails. By default, auto-commit is enabled.

  8. After you restart the switch, enter Privileged EXEC configuration mode:

    rwa

    enable

  9. Confirm the software is upgraded:

    show software

  10. Commit the software:

    software commit

    Important

    Important

    If you disable the auto-commit feature, you must run the software commit command manually before the commit timer expires to commit the new software version, otherwise the system restarts automatically to the previous (committed) version. By default, auto-commit is enabled.

Examples

Note

Note

The image file name is switch dependent. See VSP 8600 Release Notes for information about file names.

Switch:1>enable
Switch:1#configure terminal
Switch:1(config)#boot config flags ftpd
Switch:1(config)#end
Switch:1(config)#copy /usb/VOSS8K.5.0.0.0.tgz /intflash/VOSS8K.5.0.0.0.tgz
Switch:1(config)#exit
Switch:1#software add VOSS8K.5.0.0.0.tgz
Switch:1#software activate VOSS8K.5.0.0.0.GA
Switch:1#reset
Switch:1#show software
================================================================================
                    software releases in /intflash/release/
================================================================================
VOSS8K.5.0.0.0.GA (Primary Release)(Signed Release)
VOSS8K.4.2.1.0.GA (Backup Release) (Unsigned Release)

--------------------------------------------------------------------------------
Auto Commit     : enabled
Commit Timeout  : 10 minutes

Remaining time until software auto-commit is 8 minutes 59 seconds

Switch:1#show software detail
================================================================================
                    software releases in /intflash/release/
================================================================================

VOSS8K.5.0.0.0.GA(Primary Release) (Signed Release)
  SSIO
    UBOOT                            18081615
    KERNEL                           4.9
    ROOTFS                           4.9
    APP_FS                           VOSS8200.masterint407
  AVAILABLE ENCRYPTION MODULES
    3DES
    AES/DES

VOSS8K.4.2.1.0.GA (Backup Release) (Unsigned Release)
  SSIO
    UBOOT                            18081615
    KERNEL                           4.9
    ROOTFS                           4.9

    APP_FS                           VOSS8200.8.4.2.0int028
  AVAILABLE ENCRYPTION MODULES
    No Modules Added
----------------------------------------------------------------------------------
Auto Commit     : enabled
Commit Timeout  : 10 minutes

Remaining time until software auto-commit is 8 minutes 41 seconds

Switch:1#software commit
Executing software commit for version VOSS8K.5.0.0.0.GA.
Software commit successful
  

Variable Definitions

The following table defines parameters for the software command.

Variable Value
activate WORD<1-99>

Copies the software version to the boot flash file.

When you use the software activate command, the system checks for hardware dependencies and prevents a downgrade if it detects a dependency. For example, if a hardware component has a minimum software version dependency, you cannot downgrade to an incompatible software version or install the hardware component in a chassis that runs an incompatible software version.

add WORD<1-99>

Unpacks a software release <version>.

-y
Note: Exception: only supported on 5420 Series and 5520 Series.
Suppresses the confirmation message to automatically overwrite the non-primary image. If you omit this parameter, you must confirm the action to overwrite the non-primary image.