Brocade Fabric OS Command Reference Manual - Supporting Fabric OS v5.3.0 (53-1000436-01, June 2007)

236 Fabric OS Command Reference Manual
53-1000436-01
firmwareDownload
2
firmwareDownload
Downloads switch firmware from a remote host or a local directory.
Synopsis firmwaredownload [[-s [-b -n]] [ [-a <sas|dmm>] [-t <slot number>] [-p <ftp|scp>][-c] [-e][host, user,
pfile, passwd]
Description Use this command to download switch firmware from an FTP server or from a local SSH server to
the switch’s non-volatile memory.
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.
In single and dual-domain systems, this command by default downloads the firmware image to
both CPs in rollover mode, to prevent disruption to application services. This operation depends on
HA support. If HA is not available, you can still upgrade the CPs one at a time, using the -s option.
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.
By default, it then reboots the system and activates the new image. Finally, it performs the
firmwareCommit automatically, to copy the new image to the other partition. In systems with blade
processor (BP), after the new CP firmware is downloaded to the system and activated, the BP
firmware is downloaded to the BP processors if there is a mismatch between the BP and CP
firmware.
For each non-director-class platform in your fabric, complete all firmware download changes before
issuing the firmwaredownload command on the next switch to ensure a nondisruptive download.
If firmwaredownload is interrupted due to an unexpected reboot, for example software error or
power failure, the command will automatically recover the corrupted secondary partition. You must
wait for the recovery to complete before starting another firmwaredownload command.
The command supports both non-interactive 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, in which you are prompted for input.
NOTE
Ipv6 and DNS are supported by firmwaredownload in v5.3.0. If DNS is enabled and a server name
instead of a server IP address is specified in the command line, firmwaredownload determines
whether IPv4 or IPv6 should be used.
To be able to mention the FTP server by name, you must enter a couple of DNS servers using the
dnsconfig command.
The execution of this command is subject to Admin Domain restrictions that may be in place.
Operands By default, firmwaredownload performs full install, autoreboot, and autocommit. These modes are
selectable only in single -CP (-s) mode, in which case autoreboot is OFF by default.