Installs a new version of the ExtremeXOS software image.
| 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. |
N/A.
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.
Note
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.
You can issue this command only from a master node.
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.
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.
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-11.5.1.2.xos on a switch:
# install image summitX440-11.5.1.2.xos
The following example shows software images that have been downloaded, but not installed:
install image ? # 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.
The local-file option was added in ExtremeXOS 30.7.
This command is available on all Universal switches supported in this document.