Firmwarecommit - Brocade Communications Systems SN3000B Command Reference Manual

22

firmwareCommit

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, you must execute one of the following two commands after the CP is rebooted:
•
•
NOTES
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:
SEE ALSO
firmwareDownload,
358
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.
switch:admin> firmwarecommit
Validating primary partition...
Doing firmwarecommit now.
Please wait ...
Replicating kernel image
...............
FirmwareCommit completes successfully.
firmwareRestore
Fabric OS Command Reference
53-1001764-01