Reference Guide

338 Brocade Fabric OS Command Reference

53-1004112-02

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:

• 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.

Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric

OS Commands" and "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