Image download using USB

Beginning with FastIron 08.0.90, the system can be upgraded by downloading the manifest file in the USB drive.
Note: The USB storage format must be FAT32. The USB drive can be formatted from a host computer or from an ICX device. Copying the firmware or configuration files from a host computer to USB is straightforward, like copying any other file from a computer to USB.

When TFTP server access is not available, you can use the manifest file in the USB to download the images of a system. Manifest image download using USB is not supported for 08.0.80 and earlier releases. In earlier releases, USB image download was supported for standalone systems only. USB image download is supported on all ICX 7K hardware platforms.

The following actions must be performed to initiate the upgrade using the USB drive.

  1. Plug in a valid USB drive (USB2 drives and backward-compatible USB3 drives) with the appropriate pre-loaded manifest files to the system.
  2. Reload the unit with the USB drive plugged in.
Note: USB image download is not supported in FIPS mode.

Software upgrade using USB is not triggered in the following scenarios:

  • If the USB drive is not detected during the bootup.
  • When the USB drive is corrupted, not accessible, unmountable, or if there is no valid file system in the USB drive.
  • If there is an existing configuration file in the system.

Note: The configuration file must be deleted from the system using the erase startup-configuration command. Image download using USB is not triggered if there is a configuration file in the system.

When the image is successfully copied and upgraded, the system automatically reloads. On boot up, the system copies the configuration file from the USB drive. Then the system reloads with the updated image and the new configuration. If there are multiple configuration files in the USB drive, the configuration files are copied in the following order (in descending priority):

  • model.cfg for example "ICX7650.cfg,"ICX7150.cfg"
  • “default.cfg”

Upgrade using manifest file in the USB

Beginning with FastIron 08.0.90, the copy disk0 system-manifest command can be used to copy the manifest file from USB. The images stored in the USB disk are copied to the primary or secondary partition based on the choice of partition. This image can be an application image or a Unified FastIron Image (UFI).

Note: The USB storage format must be FAT32. The USB drive can be formatted from a host computer or from an ICX device. Copying the firmware or configuration files from a host computer to USB is straightforward, like copying any other file from a computer to USB.

If you are upgrading the system to 08.0.80 or later releases, the system will upgrade the images using UFI.

If you are downgrading the system to 08.0.70 or an earlier release, only the application image is supported.

Note: RUCKUS does not recommend non-UFI downgrades.

copy disk0 system-manifest file-name primary/secondary router/switch

The parameter file-name is the name of the manifest file.

The primary/secondary parameter specifies the upgrade location. This option will download the boot image and application image for any manifest download.

The router/switch option downloads the specified images. If neither option is specified, images corresponding to the running version are downloaded. For example, if a switch build is running, switch images are downloaded from the manifest folder.

Note: After the USB image download, use the unmount disk0 command before removing the disk.

After the manifest file is successfully downloaded, the manifest.txt file in the flash is retained for any future reverse manifest.

If the image is not successfully downloaded from the manifest file, the following warning message is displayed on the console.

WARNING: Possible failure on one of the member units while downloading the image. Images may not be in sync after reloading.

The user can upgrade the failed member unit at this point. If the user reloads the system, an image mismatch occurs, and the auto-copy feature upgrades the unit.

Note: The all-images-primary and all-images-secondary options for manifest download is deprecated beginning in release 08.0.90.

Auto-download using USB

When the system boots up, it checks for a valid manifest file, and if the manifest file is available, the system begins copying the files from the USB drive to the system flash memory. The system copies the images only through manifest file download and picks only the image listed in the manifest file. The system also copies the signature file and boot image files listed by the manifest file. It is recommended that the USB drive contain only one manifest file set. If there are multiple manifest files in the USB drive, the system selects the first available manifest file (the order of the manifest files is not defined). The image and boot image in the USB drive must be a different version than in the system flash memory.

Image auto-copy feature

In case of an image mismatch between control bridge and port extender images, the mismatched port extender images can be upgraded using a configured TFTP server.

Beginning with 08.0.90, the correct image stored in the USB is used to upgrade and reload the mismatched port extender images.

First, we will look for the correct image in the TFTP server. If the TFTP server does not have the correct image, the image in the USB is used. The correct image stored in the USB is used for port extender. If the USB does not have the correct image, the port extender will remain in a mismatched state.

The USB status mode LED indicates the status of boot from USB and is present only for ICX 7650 and ICX 7850 devices. Refer to the platform-specific hardware installation guide for more information.