HP StorageWorks XPath OS 7.4.X Command Reference Guide (AA-RVHCC-TE, September 2005)

XPath OS 7.4.x command reference guide 113
Downloads MP Router software from an FTP server.
Synopsis
firmwaredownload -b -n hostIpAddr userName pfile password
Availability
admin
Description
Use this command to download and install the MP Router software from a remote FTP server to the
platform’s nonvolatile storage banks in a single step.
The new firmware is in the form of RPM packages with names defined in pfile, a binary file that contains
specific firmware information (time stamp, platform code, version, and so forth) and the names of
packages of the firmware to be downloaded. These packages are made available periodically to add
features or to remedy defects. Contact customer support to obtain information about available firmware
versions.
All systems supported by this firmware have two partitions of nonvolatile storage areas, a primary and a
secondary, to store two firmware images. firmwareDownload always loads the new image into the
secondary partition and swaps the secondary partition to be the primary. When -b is specified, the
command reboots the system and activates the new image. Finally, it performs the firmwareCommit
procedure automatically, to copy the new image to the other partition, unless -n is used.
The command supports both noninteractive and interactive modes. If it is invoked without any command
line parameters, or if there is any syntax error in the parameters, the command goes into interactive mode
for downloading the main Fabric OS firmware.
The firmwareDownload command might fail for any of the following reasons:
• The host is not known to the MP Router.
• The host cannot be reached by the MP Router.
• The FTP user name or password is incorrect.
• pfile does not have the correct file permissions.
• pfile does not exist on the host.
• pfile is not in the correct format.
• The package specified in pfile does not exist.
• The FTP server is not running on the host.
• Another firmwareDownload session is running.
Operands
This command has the following required operands:
firmwareDownload
hostIpAddr A valid FTP server IP address from which pfile is downloaded,
for example, citadel or 192.168.166.30. The pfile
downloads from this host.
userName A valid user name for FTP access to the host, for example,
jdoe. Uses the user name to access the host.