install image

install image fname {partition} [ active | inactive] {reboot}

On a SummitStack use:

install image fname {partition} {slot slot number} {reboot}

Description

Installs a new version of the ExtremeXOS software image.

Note

Note

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

Syntax Description

fname Specifies the software image file.
partition Specifies which partition the image should be saved to: primary or secondary. Select primary to save the image to the primary partition and secondary to save the image to the secondary partition.
active Specifies automatic determination for active (primary) partition.
inactive Specifies automatic determination for inactive (secondary) partition.
slotid

On a SummitStack, the slotid specifies the node to which the BootROM image should be installed.

reboot Reboots the switch after the image is installed.

Default

N/A.

Usage Guidelines

When you download a software image, 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.

SummitStack Only

You can issue this command only from a Master node. The slot parameter is available only on a stack.

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 Filename Character Restrictions

This section provides information about the characters supported by the switch for local filenames.

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

When naming a local, remember the requirements listed above.

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 will 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 image has functionality that supplements a core image. You will install a module onto an already installed core image. The version number of the core image and the module must match.

To install a module to the alternate partition, use the install firmware command to install the module. Remember, the core image on the alternate partition must be of the same version as the module. When you make the alternate partition active, by issuing the use image command and rebooting the switch, the module is also activated at boot time.

To install a module to the active partition, use the install firmware command to install the module. Remember, the core image on the active partition must be of the same version as the module. If you reboot the switch, the module will also be activated, but you can activate the module without rebooting the switch by issuing the run update command. After issuing that command, all the functionality, and CLI commands, of the module will be available.

For more detailed information about hitless upgrade, see the download image command.

Example

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

install image summitX440-11.5.1.2.xos

The following example shows a software image version that has been downloaded, but not installed:

install image ?

A message similar to the following appears:

# install image ?
<fname>         Image file name
"summitX-12.1.0.52.xos"

History

This command was first available in ExtremeXOS 10.1.

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

Platform Availability