Upgrade the Software

Important

Important

Upgrades from some releases require release-specific steps. For more information, see Fabric Engine 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.

You can store up to six software releases on some switches. 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.

On the 5320 Series and 5420 Series, you can store a maximum of two software releases. If you attempt to add a third software release, the software displays a confirmation to overwrite the non-primary release. You can also use the software add <filename> -y to bypass the confirmation question and automatically overwrite the non-primary release.

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

Before you begin

  • To obtain the new software, go to the Extreme Networks Support portal. 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]

    After you enter this command, the switch verifies it has sufficient space to install the new image. If space is not insufficient, the switch checks the total space of the log files. If the total log file space is sufficient for the new image, the switch prompts you to remove log files.

    Note

    Note

    The image file is removed after the software add command runs.

  6. Optional: Respond if you see the following prompt:

    Log files need to be removed to have enough space to install the new image.

    Do you want to remove all log files except the current one?

    If your response is affirmative, the switch removes all log files except the currently active file and displays the following message for each file removed: Log file %s was removed

  7. Install the image:

    software activate WORD<1-99>

  8. 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.

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

    enable

  10. Confirm the software is upgraded:

    show software

  11. 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.

Example

Note

Note

The image file name is switch dependent. See Fabric Engine Release Notes for information about file names.

Switch:1>enable
Switch:1#configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
Switch:1(config)#boot config flags ftpd
Switch:1(config)#end
Switch:1#copy /usb/5520.9.0.0.0.voss /intflash/5520.9.0.0.0.voss
Switch:1#software add 5520.9.0.0.0.voss -y
Switch:1#software activate 5520.9.0.0.0.GA
Switch:1#reset -y
Switch:1>show software
===================================================================================
                    software releases in /intflash/release/
===================================================================================
8.10.0.0.GA                 (Backup Release)             (Signed Release)
9.0.0.0.GA                  (Primary Release)            (Signed 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/
===================================================================================
9.0.0.0.GA        (Primary Release) (Signed Release)
  SSIO
    UBOOT                            2.2.1.4
    APP_FS                           9.0.0.0.GA
  AVAILABLE ENCRYPTION MODULES
    No Modules Added

8.10.0.0.GA       (Backup Release) (Signed Release)
  SSIO
    UBOOT                            2.2.1.14
    APP_FS                           8.10.0.0.GA
  AVAILABLE ENCRYPTION MODULES
    No Modules Added

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>.

After you enter this command, the switch verifies it has sufficient space to install the new image. If space is not insufficient, the switch checks the total space of the log files. If the total log file space is sufficient for the new image, the switch prompts you to remove all log files except the currently active file. If your response is affirmative, the switch displays the following message for each file removed: Log file %s was removed

-y
Note:

Exception: not supported on 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.