Brocade Fabric OS Command Reference Manual Supporting Fabric OS v6.3.0 (53-1001337-01, July 2009)

Fabric OS Command Reference 305
53-1001337-01
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 auto commit option when
running firmwareDownload, you must execute one of the following two commands after the CP is
rebooted:
• 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
auto commit was disabled during the firmware download. Auto commit can be disabled only
when you run firmwareDownload in single mode.
Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may
be in place. Refer to chapter 1, "Using Fabric OS commands" 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