configure firmware

configure firmware [auto-install | install-on-demand]


Configures the way a BlackDiamond 8800 series switch performs a system firmware upgrade.

Syntax Description


Specifies ExtremeXOS to automatically upgrade the firmware if the software detects a newer firmware image is available. The switch does not prompt you to confirm the firmware upgrade.


Specifies the switch to prompt you to upgrade the firmware when ExtremeXOS determines that a newer firmware image is available. This is the default behavior.


The default is install-on-demand.

Usage Guidelines

Use the configure firmware [auto-install | install-on-demand] and install firmware {force} commands to upgrade the BootROM images on the MSM and I/O modules and the firmware on the PSU controllers installed in BlackDiamond X8 and BlackDiamond 8800 series switches.

Firmware images are bundled with ExtremeXOS software images. ExtremeXOS automatically compares the existing firmware image flashed into the hardware with the firmware image bundled with the ExtremeXOS image when you:
  • Download a new version of ExtremeXOS to the alternate (inactive) partition.

  • Install a new module into an active chassis.

After a firmware image upgrade, messages are sent to the log.

In addition, if you insert an I/O module that has older firmware present into a chassis that is configured for auto-install then the following behaviors occur:

On the BlackDiamond 8800, newer firmware is installed automatically upon insertion and the following log message is generated:
<Info:HAL.Card.Info> MSM-A: Slot 2 bootrom updated to 

There is also a log message that states that the newer firmware will not be used until after the next reboot of the I/O module.

On the BlackDiamond X8, newer firmware will not be installed automatically. A log message is generated informing the user that newer firmware is available and the command to use to install it. This behavior applies to MM, IO, FM, and FanTray only.

If you select the auto-install parameter, you are not prompted to confirm the firmware upgrade. Whenever ExtremeXOS determines a newer firmware image is available, the firmware is automatically upgraded.

If you use the default configuration install-on-demand, you have the opportunity to cancel the firmware upgrade. If you install a new software image, and a new firmware image is available, the switch prompts you to upgrade the firmware. Enter y to upgrade the firmware image. Enter n to cancel the firmware upgrade for the specified hardware and continue scanning for other hardware that needs to be upgraded.

The following command downloads the switch software image. The secondary partition must be the alternate partition.

download image bd8800- secondary

If you download a new image and new firmware images are available, you see messages similar to the following:

Do you want to install image after downloading? (y - yes, n - no, <cr> - cancel) Yes 
Downloading to MSM-A
Saving configuration on secondary MSM ............. done! 
Installing to secondary partition! 
Installing to MSM-A...
Image installed successfully 
Installing version of the MSM bootrom(s). Do you want to continue? (y/n) Yes 
Installing version of the IO module bootrom(s). Do you want to continue? (y/n) Yes
Installing version 2.4 of the PSU control module firmware. Do you want to continue? (y/n) Yes
Installing bootrom...
MSM bootrom(s) installed successfully
Installing bootrom...
IO module bootrom(s) installed successfully
Installing firmware...
PSU controller firmware installed successfully

Displaying BootROM and Firmware Versions

To display the BootROM (firmware) version for all modules and PSU controllers installed in the switch, use the show version command.

Recovering From a Corrupted BootROM

If your default BootROM image becomes corrupted, you can force the MSM to boot from an alternate BootROM image by inserting a pen into the Alternate (A) and Reset (R) holes on the BlackDiamond 8800 MSM and applying pressure. For more information, please refer to the hardware documentation.


The following command automatically upgrades the firmware when a newer firmware image is present without prompting you to confirm the upgrade:

configure firmware auto-install


This command was first available in ExtremeXOS 11.1.

Platform Availability

This command is available only on the BlackDiamond X8 and BlackDiamond 8800 series switches.