boot switch

This command switches between primary and secondary installations.

Syntax

boot switch

Availability

All platforms except Docker.

Guidelines

The boot switch command switches between primary and secondary installations, when the firmware is installed with the boot image command.

The newly installed firmware image and associated configuration data is the primary installation.
The previous firmware image and associated configuration data is the secondary installation.

When you switch between firmware images that contain different versions of component firmware, the switch can take approximately 20 minutes. During this operation, do not power off or restart the DataPower® Gateway. Examples of component firmware includes, but is not limited to, the BIO, BMC or RAID controller.

Attention: Switching to an earlier firmware version can prevent all B2B gateways from becoming operational. If the B2B gateways do not become operational, you must reinitialize the B2B persistence store.

Configuration edits that are made to a selected image are local and are not included during the rollback operation. It is possible to issue the boot switch command twice, which returns the DataPower Gateway to the newly installed version.

While you can use the boot delete command to delete the secondary installation, keep in mind that its deletion prevents firmware rollback as provided by the boot switch command.

Examples

The rollback operation was successful.

# boot switch
Warning: You are about to switch firmware versions. Switching to an earlier 
firmware version might prevent all B2B gateways from becoming operational 
and will require an administrator to initialize the persistence store again.
Do you want to continue with the upgrade? Yes/No [y/n]: y
Firmware roll-back successful

Device is rebooting now.

The rollback operation failed. The secondary installation was deleted with the boot delete command.

# boot switch
% Firmware roll-back failed: Switch active firmware failed:
Secondary install not available