download bootrom

download bootrom [[ipaddress | hostname] filename {{vr} vrname} {block-size block_size}] {slot slotid} {install} {reboot}}

Description

Downloads a BootROM image after the switch has booted.

The downloaded image replaces the BootROM in the onboard FLASH memory.

Syntax Description

ipaddress

Specifies the IP address of the TFTP server.

hostname

Specifies the host name of the TFTP server.

Use of the hostname option requires that DNS be enabled.

filename The name of the bootROM file (.xtr extension).

vrname

Specifies the name of the virtual router.

Note: User-created VRs are supported only on the platforms listed for this feature in the ExtremeXOS 32.2 Feature License Requirements document.
block_size Specifies the data block size, excluding TFTP header. Data block size ranges from 24-65,000 bytes.

slotid

This parameter is available only on the SummitStacks.

On a SummitStack, the slotid specifies the slot number of the node on which the image should be downloaded.

install Specifies installing the system image after download.
reboot Specifies rebooting after installation.

Default

The default block size is 1,400 bytes.

Usage Guidelines

Upgrade the BootROM image only when asked to do so by an Extreme Networks technical representative.

The BootROM image file is designated with a .xtr file extension.

Prior to downloading the BootROM image on the switch, you must download the image you received from Extreme Networks to a TFTP server on your network. You can also download the image to a USB 2.0 storage device.

When you download a BootROM image, you are prompted to install the image immediately after the download is finished. You can also use the install option to choose in advance to install the bootROM image. If you choose to install the image at a later time, use the install bootrom [from-image | fname | local-file] {slot slot-number} {reboot} command to install the software on the switch.

If this command does not complete successfully it could prevent the switch from booting. If the switch does not boot properly, some boot option functions can be accessed through a special Bootloader menu.

Displaying the BootROM Versions

To display the BootROM version for the switch, use the show version command.

Host Name and Remote IP Address Character Restrictions

When specifying a host name or remote IP address, the switch permits only the following characters:
  • Alphabetical letters, upper case and lower case (A-Z, a-z)
  • Numerals (0-9)
  • Period ( . )
  • Dash ( - ) Permitted only for host names
  • Underscore ( _ ) Permitted only for host names
  • Colon ( : )

Local and Remote File Name Character Restrictions

When specifying a local or remote file name, the switch permits only the following characters:
  • Alphabetical letters, upper case and lower case (A-Z, a-z)
  • Numerals (0-9)
  • Period ( . )
  • Dash ( - )
  • Underscore ( _ )
  • Slash ( / ) Permitted only for remote files

SummitStack Only

You can run this command only from the master node. The file to be downloaded has to be compatible with the type of switch in the specified slot.

If you do not specify a slot number and you elect to install the image after downloading, an attempt is made to install the BootROM image on all active nodes. The BootROM image is not installed on any node if the BootROM image specified is not compatible with all active nodes.

Example

The following example downloads a BootROM image from the TFTP server "tftphost" with the file name "bootimage":

# download bootrom tftphost bootimage

History

This command was first available in ExtremeXOS 11.0.

The slot parameter was added to support SummitStack in ExtremeXOS 12.0.

Support for USB 2.0 storage devices was added in ExtremeXOS 12.5.3.

Block size support was added in ExtremeXOS 15.7.1.

The memorycard option was removed in ExtremeXOS 30.7.

The install and reboot options were added in ExtremeXOS 31.1.

Platform Availability