On a SummitStack use:
install image fname {partition} {slot slot number} {reboot}Installs a new version of the ExtremeXOS software image.
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.
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. |
N/A.
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.
You can issue this command only from a Master node. The slot parameter is available only on a stack.
To display the software image version running on the switch, use the show version or show switch commands.
To display a software image version that has been downloaded but not installed, use the install image ? command.
This section provides information about the characters supported by the switch for local filenames.
When naming a local, remember the requirements listed above.
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.
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.
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"
This command was first available in ExtremeXOS 10.1.
The slot parameter was added to support SummitStack in ExtremeXOS 12.0.