Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)

Fabric OS Command Reference Manual 2-227
Publication Number: 53-1000240-01
firmwareCommit
2
Note: Enter commands in lowercase only; mixed case is for readability.
firmwareCommit
Commits switch firmware.
Synopsis firmwarecommit
Description Use this command to commit a firmware download to a CP. This command copies an updated firmware
image to the secondary partition and commits both partitions of the CP to an updated version of the
firmware. This must be done after each firmware download and after the switch has been rebooted and a
sanity check is performed to make sure the new image is fine.
For switches that have nonvolatile memory set into two equal partitions, the primary partition is the
where the system boots from; the secondary partition is where a copy of the firmware is stored, in case
the primary partition is damaged.
To maintain the integrity of the firmware image in the nonvolatile memory, the firmwareDownload
command updates the secondary partition only. When firmwareDownload completes successfully and
the CP is rebooted, the system switches the primary partition (with the old firmware) to the secondary,
and the secondary partition (with the new firmware) to the primary.
The default behavior of the firmwareDownload command is to automatically run the firmwareCommit
command after the reboot. If you decide to disable the autocommit option when running
firmwareDownload, after the CP is rebooted, you must execute one of two commands:
• firmwareCommit copies the primary partition (with new firmware) to the secondary and commits
the new firmware to both partitions of the CP.
• firmwareRestore copies the secondary partition (with the old firmware) to the primary and backs
out of the new firmware download. The firmwareRestore command can be run only if autocommit
was disabled during the firmware download. Autocommit can be disabled only when you run
firmwareDownload in single mode.
N
ote
The execution of this command is subject to Admin Domain restrictions that may be in place.
Operands none
Examples To commit a new version of the firmware:
See Also firmwareDownload, firmwareRestore
switch:admin> firmwarecommit
Validating primary partition...
Doing firmwarecommit now.
Please wait ...
Replicating kernel image
...............
FirmwareCommit completes successfully.