install firmware

install firmware {force}

Description

Installs the firmware bundled with the ExtremeXOS image on the BlackDiamond X8 and BlackDiamond 8800 series switches.

Syntax Description

force Specifies that a new image is installed without a version check.

Default

N/A.

Usage Guidelines

On BlackDiamond X8 switches, use the install firmware command to upgrade the BootROM images on the MM, I/O, and Fabric modules and the firmware on the fan bars installed on the switch. On BlackDiamond 8800 series switches, use the install firmware command to upgrade the BootROM images on the MSM and I/O modules and the firmware on the PSU controllers installed in the switch.

Firmware images are bundled with ExtremeXOS software images.

On BlackDiamond X8 and BlackDiamond 8800 series switches, the ExtremeXOS software automatically compares the existing firmware image flashed into the hardware with the firmware image bundled with the ExtremeXOS image. You can also use the install firmware command to compare the firmware images.

Before using the install firmware command, wait until the show slot command indicates the MSMs and I/O modules are operational. When the modules are operational, use the install firmware command.

BlackDiamond X8 Switches.

The switch scans MM, I/O, Fabric modules and the Fanbar controllers for a possible firmware upgrade. If the bundled firmware image is newer than the existing firmware image, the switch prompts you to confirm the upgrade.
  • Enter y to upgrade the firmware.
  • Enter n to cancel the firmware upgrade for the specified hardware and continue scanning for other hardware that needs to be upgraded.
  • Enter cr to cancel the upgrade. After a firmware image upgrade, messages are sent to the log.
The Fanbar controller firmware is used immediately after it is installed without rebooting the switch. The new BootROM and firmware overwrite the older versions flashed into the hardware. Use the reboot command to reboot the switch and activate the new BootROM and firmware.

During the firmware upgrade, do not cycle down or disrupt the power to the switch. If a power interruption occurs, the firmware may be corrupted and need to be recovered. ExtremeXOS automatically recovers corrupted firmware; however, the time it takes for the switch to boot-up may increase.

The switch displays status messages after you use the install firmware command. The output varies depending upon your platform and the software version running on your system.

BlackDiamond 8800 Series Switches

The switch scans the I/O and MSM modules and the PSU controllers for a possible firmware upgrade. If the bundled firmware image is newer than the existing firmware image, the switch prompts you to confirm the upgrade.

  • Enter y to upgrade the firmware.
  • Enter n to cancel the firmware upgrade for the specified hardware and continue scanning for other hardware that needs to be upgraded.
  • Enter cr to cancel the upgrade. After a firmware image upgrade, messages are sent to the log.

The PSU controller firmware is used immediately after it is installed without rebooting the switch. The new BootROM and firmware overwrite the older versions flashed into the hardware. Use the reboot command to reboot the switch and activate the new BootROM and firmware.

During the firmware upgrade, do not cycle down or disrupt the power to the switch. If a power interruption occurs, the firmware may be corrupted and need to be recovered. ExtremeXOS automatically recovers corrupted firmware; however, the time it takes for the switch to boot-up may increase.

The switch displays status messages after you use the install firmware command. The output varies depending upon your platform and the software version running on your system.

Note

Note

If the information in the most current version of the ExtremeXOS Installation and Release Notes differs from the information in this section, follow the release notes.

Sample Output--BlackDiamond X8 Series Switch

The following is sample output from a BlackDiamond X8 switch:

Installing version 1.0.0.4 of the BIOS for MMs. Do you want to continue?
(y - yes, n - no, <cr> - cancel) Yes
Installing version 1.0.0.8 of the bootrom for BD-X series
I/O and Fabric modules. Do you want to continue?
(y - yes, n - no, <cr> - cancel) Yes
Installing version 1.0.2.9 of fanbar firmware on all fanbars. Do you want to continue?
(y - yes, n - no, <cr> - cancel) Yes
Installing MM FPGA image version 0.1.22. Do you want to continue?
(y - yes, n - no, <cr> - cancel) Yes
Installing IO/FM FPGA image version 0.0.36. Do you want to continue?
(y - yes, n - no, <cr> - cancel) Yes
Installing firmware...
Updating fanbar firmware
Fan Bar(5)/SlotId(21) - The secondary partition is active, will now boot to opposite.
Fan Bar(5)/SlotId(21) - Programming secondary partition with /tmp/fanbar_secondary.bin...
Fan Bar(5)/SlotId(21) - Validating  secondary partition with /tmp/fanbar_secondary.bin...
Fan Bar(5)/SlotId(21) - Images are identical.
Fan Bar(5)/SlotId(21) - Booting updated secondary partition...
Fan Bar(5)/SlotId(21) - Unconditional success!
Fan Bar(4)/SlotId(20) - The secondary partition is active, will now boot to opposite.
Fan Bar(4)/SlotId(20) - Programming secondary partition with /tmp/fanbar_secondary.bin...
Fan Bar(4)/SlotId(20) - Validating  secondary partition with /tmp/fanbar_secondary.bin...
Fan Bar(4)/SlotId(20) - Images are identical.
Fan Bar(4)/SlotId(20) - Booting updated secondary partition...
Fan Bar(4)/SlotId(20) - Unconditional success!
Fan Bar(1)/SlotId(17) - The secondary partition is active, will now boot to opposite.
Fan Bar(1)/SlotId(17) - Programming secondary partition with /tmp/fanbar_secondary.bin...
Fan Bar(1)/SlotId(17) - Validating  secondary partition with /tmp/fanbar_secondary.bin...
Fan Bar(1)/SlotId(17) - Images are identical.
Fan Bar(1)/SlotId(17) - Booting updated secondary partition...
Fan Bar(1)/SlotId(17) - Unconditional success!
Fan Bar(3)/SlotId(19) - The secondary partition is active, will now boot to opposite.
Fan Bar(3)/SlotId(19) - Programming secondary partition with /tmp/fanbar_secondary.bin...
Fan Bar(3)/SlotId(19) - Validating  secondary partition with /tmp/fanbar_secondary.bin...
Fan Bar(3)/SlotId(19) - Images are identical.
Fan Bar(3)/SlotId(19) - Booting updated secondary partition...
Fan Bar(3)/SlotId(19) - Unconditional success!
Fan Bar(2)/SlotId(18) - The secondary partition is active, will now boot to opposite.
Fan Bar(2)/SlotId(18) - Programming secondary partition with /tmp/fanbar_secondary.bin...
Fan Bar(2)/SlotId(18) - Validating  secondary partition with /tmp/fanbar_secondary.bin...
Fan Bar(2)/SlotId(18) - Images are identical.
Fan Bar(2)/SlotId(18) - Booting updated secondary partition...
Fan Bar(2)/SlotId(18) - Unconditional success!
Fan Bar(1)/SlotId(17) - Successfully programmed.
Fan Bar(2)/SlotId(18) - Successfully programmed.
Fan Bar(3)/SlotId(19) - Successfully programmed.
Fan Bar(4)/SlotId(20) - Successfully programmed.
Fan Bar(5)/SlotId(21) - Successfully programmed.
Completed updating fanbar firmware
Firmware for fanbars have been updated successfully.
Installing firmware...
Updating MM FPGA image
MM-A - Programming.
Reading input file image - 255061 bytes.
Writing file image to flash - 255061 bytes.
New FPGA image has been programmed
MM-B - Programming.
Reading input file image - 255061 bytes.
Writing file image to flash - 255061 bytes.
9301 bytes remaining at 12288.0 bytes per second leaves    0 seconds left.
New FPGA image has been programmed
MM FPGA image has been updated successfully.
Installing firmware...
Updating IO/FM FPGA image
Slot-1 - No Module Present.
Slot-2 - Programming.
Reading input file image - 158453 bytes.
Writing file image to flash - 158453 bytes.
35573 bytes remaining at 12288.0 bytes per second leaves    2 seconds left.
New FPGA image has been programmed
Slot-3 - No Module Present.
Slot-4 - No Module Present.
Slot-5 - Programming.
Reading input file image - 158453 bytes.
Writing file image to flash - 158453 bytes.
39669 bytes remaining at 12288.0 bytes per second leaves    3 seconds left.
New FPGA image has been programmed
Slot-6 - No Module Present.
Slot-7 - Programming.
Reading input file image - 158453 bytes.
Writing file image to flash - 158453 bytes.
43765 bytes remaining at 11468.8 bytes per second leaves    3 seconds left.
New FPGA image has been programmed
Slot-8 - No Module Present.
FM-1 - Programming.
Reading input file image - 158453 bytes.
Writing file image to flash - 158453 bytes.
31477 bytes remaining at 13107.2 bytes per second leaves    2 seconds left.
New FPGA image has been programmed
FM-2 - Programming.
Reading input file image - 158453 bytes.
Writing file image to flash - 158453 bytes.
43765 bytes remaining at 12288.0 bytes per second leaves    3 seconds left.
New FPGA image has been programmed
FM-3 - Programming.
Reading input file image - 158453 bytes.
Writing file image to flash - 158453 bytes.
39669 bytes remaining at 11468.8 bytes per second leaves    3 seconds left.
New FPGA image has been programmed
FM-4 - No Module Present.
IO/FM FPGA image has been updated successfully.
Installing Bootrom for MM(s) may take several minutes, please do not reboot system during this time
Installing bootrom...
Bootrom for MMs installed successfully and will be activated upon next MM reboot
Installing bootrom...
Bootrom for BD-X I/O and Fabric modules installed successfully and will be activated upon next module reboot
This image will be used only after rebooting the switch!

Sample Output--BlackDiamond 8800 Series Switch

The following is sample output from a BlackDiamond 8800 series switch:

Installing version 1.0.4.2 of the bootrom for MSMs. Do you want to continue?
(y - yes, n - no, <cr> - cancel) Yes
Do you want to save configuration changes to primary.cfg? (y or n) Yes
Saving configuration on primary MSM ....... done!
Installing version 1.0.4.0 of the bootrom for I/O modules.
Do you want to continue?
(y - yes, n - no, <cr> - cancel) Yes
Installing version 1.0.1.0 of the bootrom for newer (e.g. 8900-series)
I/O modules. Do you want to continue?
(y - yes, n - no, <cr> - cancel) Yes
Installing version 2.13 of the firmware for PSU control modules.
Do you want to continue?
(y - yes, n - no, <cr> - cancel) Yes
Installing bootrom...
MSM bootrom(s) installed successfully
MSM bootrom(s) will be activated upon next MSM reboot
Installing bootrom...
IO module bootrom(s) installed successfully
IO module bootrom(s) will be activated upon next IO module reboot
Installing firmware...
PSU controller firmware installed successfully

Additional Behavior--BlackDiamond X8 and BlackDiamond 8800 Series Switches Only

During a firmware upgrade, the switch prompts you to save your configuration changes to the current, active configuration. Enter y to save your configuration changes to the current, active configuration. Enter n if you do not want to save your changes.

In earlier versions of ExtremeXOS, you are required to immediately reboot the system after a firmware upgrade. In ExtremeXOS 11.3.3 and later, the system displays a message informing you that the new firmware image will be activated the next time you reboot the system.

Use the configure firmware [auto-install | install-on-demand] command to configure how the switch performs a system firmware upgrade. If you select the auto-install parameter, you are not prompted to confirm the firmware upgrade. If you use the default configuration install-on-demand, you can cancel the firmware upgrade.

Power over Ethernet (PoE) firmware is always automatically upgraded or downgraded to match the operational code image. This configuration is not applicable to PoE firmware.

Recovering From a Corrupted BootROM--BlackDiamond 8800 Series Switches Only

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.

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.

Example

The following example installs the newer firmware image(s):

install firmware

History

This command was first available in ExtremeXOS 11.1.

Platform Availability

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