install image

install image [inactive |filename | local-file] {partition} {slot slotid}{reboot}


Installs a new version of the ExtremeXOS software image.

Syntax Description

filename Specifies the file name of a previously downloaded image.
local-file Specifies using an image file on a local file path (USB is /usr/local/ext, internal memory is /usr/local/tmp, and home directory is /usr/local/cfg).
partition Specifies primary or secondary partition, or specifies active or inactive for automatic determination: "active" "inactive" "primary" "secondary".
inactive Copies an image from the active partition to the inactive partition. This includes the .xos image and all .xmod and .lst files.
slot For SummitStacks, specifies installing the image on a particular node (slot).
slotid On a SummitStack, selects which node the image should be installed on.
reboot Reboots the switch after the image is installed.



Usage Guidelines

When you download a software image (download [url url {vr vrname} | image [active | inactive] [[hostname | ipaddress] filename {{vr} vrname} {block-size block_size}] {partition} {install {reboot}}, you are asked if you want to install the image immediately after the download is finished. If you choose to install the image at a later time, use this command to install the software on the switch.

The software image file can be an .xos file, which contains an ExtremeXOS core image, or an .xmod file, which contains additional functionality to supplement a core image.



Beginning with ExtremeXOS 12.1, an ExtremeXOS core image must be installed on the alternate (non-active) partition. If you try to install on an active partition, the following error message appears: Error: Image can only be installed to the non-active partition.

When you install a new version of an ExtremeXOS image, the system automatically compares the currently installed bootROM image against the bootROM image contained in the new ExtremeXOS image. If the installed version is older, the system automatically upgrades to the bootROM version contained in the new ExtremeXOS image.

SummitStack Only

You can issue this command only from a master node.

Displaying the Software Image Version

To display the software image version running on the switch, use the show version or show switch commands.

Displaying the Downloaded Software Image Version.

To display a software image version that has been downloaded but not installed, use the install image ? command.

Local File Name Character Restrictions

When specifying a local file name, the switch permits only the following characters:
  • Alphabetical letters, upper case and lower case (A-Z, a-z)
  • Numerals (0-9)
  • Period ( . )
  • Dash ( - )
  • Underscore ( _ )

Installing an ExtremeXOS Core Image

Install the software image on the alternate partition. You can continue to run the currently booted image, but to run the newly installed image, you need to set the boot partition with the use image {partition} partition command and reboot the switch.

Installing an ExtremeXOS module image

An ExtremeXOS module (.xmod) image has functionality that supplements a core image. You need to install a module onto an already installed core image. The version number of the core image and the module must match.

For more detailed information about a hitless upgrade, see the download [url url {vr vrname} | image [active | inactive] [[hostname | ipaddress] filename {{vr} vrname} {block-size block_size}] {partition} {install {reboot}} command.


The following example installs the software image file summitX440- on a switch:

# install image summitX440-

The following example shows software images that have been downloaded, but not installed:

install image ?

# install image ?
<fname>         Image file name


This command was first available in ExtremeXOS 10.1.

The slot parameter was added to support SummitStack in ExtremeXOS 12.0.

The local-file option was added in ExtremeXOS 30.7.

Platform Availability

This command is available on ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, X670-G2, X690, X695, X870, 5320, 5420, and 5520 series switches.