download image

Using TFTP: download [url url {vr vrname} | image [active | inactive] [[hostname | ipaddress] filename {{vr} vrname} {block-size block_size}] {partition}
To download an image to a stack: download image [[hostname | ipaddress] filename {{vr} vrname} {block-size block_size}] {partition}

Description

Downloads a new version of the ExtremeXOS software image.

The image file can be downloaded using TFTP (which is not a secure method), or SFTP and SCP2 (which are secure methods). The procedure using TFTP begins above and using SFTP/SCP2.

Syntax Description

url Uniform Resource Locator (URL) of image, xmod or flat-text list of files with suffix '.lst'.
url Image, xmod, or file list. e.g. http://ipaddress/path.xos or ftp://ipaddress:port/ path.xmod or ftp://ipaddress/some_list.lst.
active Specifies automatic determination for active (primary) partition.
inactive Specifies automatic determination for inactive (secondary) partition.
hostname Specifies the hostname of the TFTP server from which the image should be obtained.
ipaddress Specifies the IP address of TFTP server from which the image should be obtained.
filename Specifies the file name of the new image.
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 30.7 Feature License Requirements document.
block_size Specifies the maximum block size, not including the TFTP header. The range is 24–65000 bytes.
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.

Default

Stores the downloaded image in the alternate (inactive) partition.

SFTP and SCP2 provide secure methods of downloading the ExtremeXOS software image files, *.xos or *.xmod. You can use one of three procedures:

If you do not specify block size, the default value is 1,400 bytes.

Usage Guidelines

Prior to downloading an image on the switch, you must download the image you received from Extreme Networks to a TFTP server on your network. If your switch has a removable storage device, you can also download the image to that device.

Note

Note

The download image command causes the switch to use the newly downloaded software image during the next switch reboot. To modify or reset the software image used during a switch reboot, use the use image command. Use this command after downloading and installing the image for it to be effective.

Specify the IP address or host name parameters to download an image from a TFTP server on the network. Use of the host name parameter requires that DNS be enabled.

Core Software Images

A switch can store up to two core images: an active and inactive. When downloading a new image, you must select on which partition to install the new image. You must install the software image to the inactive partition, and must specify that partition while downloading the image to the switch.

Image Filenames

The software image file can be an .xos file, which contains an ExtremeXOS core image, or an .xmod file, which contains an ExtremeXOS modular software package.

As of ExtremeXOS 16.1, the download command now accepts a URL as the name of the file to download. URL protocols can be tftp, http, ftp. The format of a URL is:
  • http://10.10.10.1/filename.xos
  • tftp://10.10.10.1/filename.xos
  • ftp://10.10.10.1/filename.xmod
In addition to accepting a URL that ends in .xos or .xmod, the URL file name can end in .lst. A .lst file contains file names at the same location as the .lst file URL and is downloaded/installed one after the other. The .lst file method defines bundles of downloads for:
  • aspen, summit480 –image file size issues
  • SSH installs with ExtremeXOS
  • Customer files ending in '.cfg', '.xsf', '.pol', '.xlic', '.py', '.ssh'
  • Other bundling that makes it easier to download with a single command

For additional installation requirements, see the sections Installing a Core Image and Installing a Modular Software Package in the . ExtremeXOS 30.7 User Guide .

Displaying the Software Image Versions

To display the software image version running on the switch, use the show version or show switch commands.

Host Name and Remote IP Address Character Restrictions

This section provides information about the characters supported by the switch for host names and remote IP addresses.

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 ( : )

When naming or configuring an IP address for your network server, remember the requirements listed above.

Local and Remote Filename Character Restrictions

This section provides information about the characters supported by the switch for local and remote filenames.

When specifying a local or remote filename, 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

When naming a local or remote file, remember the requirements listed above.

Messages Displayed by the Switch

When you download a new image, you will see the following message:

 Do you want to install image after downloading? (y - yes, n - no, <cr> - cancel)
Do one of the following:
  • Enter y if you want to install the image after download.
  • Enter n if you want to install the image at a later time.
  • Press [Enter] if you want to cancel the download.

The Image Integrity Check feature was added in ExtremeXOS 16.1. The CLI output of this command is modified:

  1. If the signature is verified and there is no error, there is no change to the output.
  2. If the downloaded image does not have a signature, the following messages are added. This is considered as a warning, since it could be simply a downgrading. The user is given the choice to continue or quit the installation.
    Warning: Signature Validation - Image is not digitally signed. Do you want to continue? (y/N)

    If the user decides to continue, then it follows the normal installation path; if the user decides to stop here, the following message is printed and then the installation is canceled. 

    Installation canceled
  3. If the certificate (keys) to verify the image is missing, the following messages are added. This is considered as a non-fatal and rare error, digital signature verification is bypassed. The user is given the choice to continue or quit the installation. 
    Warning: Signature Validation - Certificates missing; Image signature validation will be bypassed. Do you want to continue? (y/N)

    If the user decides to continue, then it follows the normal installation path; if the user decides to stop here, the following message is printed and then the installation is canceled.

    Installation canceled
  4. If the certificate (keys) itself cannot be verified, the following messages are added. This is STILL considered as a non-fatal and rare error, digital signature verification is bypassed. You have the choice to continue or quit the installation. 
    Warning: Signature Validation - Certificates verification failed; Image signature validation will be bypassed. Do you want to continue? (y/N)

    If you decide to continue, the normal installation continues. If you decide to stop here, the following message appears and the installation is canceled.

    Installation canceled
  5. If the image digital signature validation fails, the following message is added as a new reason why download fails. This is considered a fatal error like a CRC check failure, installation is terminated immediately. 
    Error: Failed to download image - Error: Image signature cannot be validated.

SummitStack Only

You can issue this command only from the master node.

If a slot is not specified, the image is downloaded to every node in the active topology. If a slot is specified, the image is downloaded to that slot only.

If all nodes to be downloaded are not running the same partition, the command is not executed and following message is displayed:

Error: all nodes do not have the same image partition selected.

If all nodes to be downloaded have the same partition selected but the ExtremeXOS is currently running from the selected partition, the command is not executed and the following message appears:

Error: the image partition selected must not be the active partition.

Downloading a New Image

For information about upgrading .xos and .xmod images, see the Software Upgrade and Boot Options section in the ExtremeXOS 30.7 User Guide .

Example

Example

The following example shows how the .lst file can contain filenames ending in .lst to get a list of lists (of lists etc…) from an HTTP server on 10.68.9.7 port 8080 for directory 16.1/cougar/cougar/release:

cat big.lst – big.lst contains other list file names:
cat xos.lst – xos.lst contains an ExtremeXOS image:
cat xmod.lst – xmod.lst :contains a number of .xmod filenames:
cat script.lst – script.lst contains a number of Python scripts the user wants to download to a switch:

A single download command downloads all of the above files.

(pacman debug) X460G2-24t-10G4.1 # download url 
http://10.68.9.7/big.lst
http://10.68.9.7/xos.lst                                    
Downloading http://10.68.9.7/summitX-16.1.0.18.xos

Downloading to Switch.............................................
Installing to primary partition!

Installing to Switch.............................................
Image installed successfully
This image will be used only after rebooting the switch!

Image installed successfully
http://10.68.9.7:8080/xmod.lst
Downloading http://10.68.9.7/summitX-16.1.0.18-debug.xmod

Downloading to Switch.....
Installing to primary partition!

Installing to Switch..............................................
Image installed successfully
Downloading http://10.68.9.7/summitX-16.1.0.18-LegacyCLI.xmod

Downloading to Switch.. 
Installing to primary partition!

Installing to Switch........................
Legacy CLI framework was Successfully Installed !!!

Image installed successfully

Downloading http://10.68.9.7/summitX-16.1.0.18-reachnxt-1.8.1.8.xmod

Downloading to Switch...
Installing to primary partition!

Installing to Switch....
Image installed successfully
Downloading http://10.68.9.7/summitX-16.1.0.18-techSupport.xmod

Downloading to Switch..
Installing to primary partition!

Installing to Switch..
Image installed successfully
http://10.68.9.7/script.lst
http://10.68.9.7/jsonrpc.py
http://10.68.9.7/jsontest.py
http://10.68.9.7/otst.py
http://10.68.9.7/ping.py
http://10.68.9.7/readvr.py
(pacman debug) X460G2-24t-10G4.2 #

History

This command was first available in ExtremeXOS 10.1.

The memorycard option was added in ExtremeXOS 11.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 keyword was removed in ExtremeXOS 30.7.

Platform Availability

9036637-00 Rev AA