Installs the firmware bundled with the ExtremeXOS image on the BlackDiamond X8 and BlackDiamond 8800 series switches.
| force | Specifies that a new image is installed without a version check. |
N/A.
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.
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.
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.
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
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.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!
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
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.
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.
To display the BootROM (firmware) version for all modules and PSU controllers installed in the switch, use the show version command.
The following example installs the newer firmware image(s):
install firmware
This command was first available in ExtremeXOS 11.1.
This command is available only on BlackDiamond X8 and BlackDiamond 8800 series switches.
Print
this page
Email this topic
Feedback
View PDF
Download EPUB