Brocade Fabric OS Command Reference Guide v6.1.0 (53-1000599-02, June 2008)

206 Fabric OS Command Reference
53-1000599-02
firmwareCommit
2
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.
Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer
to chapter 1, "Understanding Admin Domain Restrictions" and Appendix A, "Command Availability"
for details.
Operands none
Examples To commit a new version of the firmware:
switch:admin> firmwarecommit
Validating primary partition...
Doing firmwarecommit now.
Please wait ...
Replicating kernel image
...............
FirmwareCommit completes successfully.
See Also firmwareDownload, firmwareRestore