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 |
Specifies the MSM/MM where the software image file should be installed. A specifies the MSM/MM installed in slot A.B specifies the MSM/MM installed in slot B. Note: This parameter is available only on modular switches and
SummitStack.
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 {msm slotid} 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. For example, the module bdx8-15.6.1.25-ssh.xmod can only be installed onto the core image bdx8-15.6.1.25.xos.
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.
If you specify the msm parameter on a BlackDiamond 8800 series switch, you can initiate hitless upgrade between the primary and backup MSMs installed in the switch.
Although any method of upgrading software can have an impact on network operation, including interrupting Layer 2 network operation, performing a hitless upgrade can decrease that impact.
When performing a hitless upgrade, you must:
For more detailed information about hitless upgrade, see the download image command.
The following example installs the software image file bd8800-11.3.0.10.xos on a BlackDiamond 8810 switch:
install image bd8800-11.3.0.10.xos
The following example installs the software image file summitX440-11.5.1.2.xos on a Summit family switch:
install image summitX440-11.5.1.2.xos
The following example displays a software image version that has been downloaded but not displayed:
install image ?
A message similar to the following is displayed:
# install image ? <fname> Image file name "summitX-12.1.0.52.xos"
This command was first available in ExtremeXOS 10.1.
The msm parameter was added in ExtremeXOS 11.1.
The slot parameter was added to support SummitStack in ExtremeXOS 12.0.
This command is available on all platforms.
Print
this page
Email this topic
Feedback
View PDF
Download EPUB