Changing the firmware version
docker, the DataPower Gateway has only a single installation.
You cannot upgrade, rollback, or downgrade. The FROM declaration in your
Dockerfile controls the version in use.Before you begin
Before you apply the firmware image to change the version, review the release details and fix documentation for the target firmware version and all intervening versions.
The authority for installation operations is equal to that of the admin account.
The activities to change the firmware version is only in the default domain. To use
the CLI, most of the commands for installation operations are in flash mode.
Procedure
Upgrading to a later firmware version
An upgrade operation is the installation of a firmware image that is later than the currently installed version.
About this task
You can upgrade the firmware on the DataPower Gateway from the GUI or CLI.
The firmware image can contain new versions of component firmware. Component firmware includes, but is not limited to, the DataPower BIOS, BMC, and RAID controller. When the firmware image contains new versions of component firmware, the upgrade can take approximately 20 minutes. During this upgrade process, do not power off or restart the DataPower Gateway.
main task runs in FIPS 140-3 level 1 mode, you cannot
upgrade the firmware until you change the crypto mode to permissive. After you upgrade, remember to
change the crypto mode back to FIPS 140-3 level 1 mode.- To view the current mode, see Viewing cryptographic mode status.
- To change the mode, see Changing cryptographic modes.
If you encounter problems during an upgrade, see the Knowledge Collection: How to upgrade the firmware on an IBM® WebSphere® DataPower Appliance.
Procedure
Rolling back to the previously installed firmware version
A rollback operation switches between the current firmware installation (primary) and the previously installed version (secondary).
About this task
You can switch between the current firmware installation and the previously installed version from the GUI or CLI.
When you switch between firmware images that contain different versions of component firmware, the switch can take approximately 20 minutes. During this switch operation, do not power off or restart the DataPower Gateway. Component firmware includes, but is not limited to, the DataPower BIO, BMC, and RAID controller.
Procedure
Downgrading to an earlier firmware version
A downgrade operation is the installation of a firmware image that is earlier than the currently installed version.
About this task
You can downgrade the firmware on an DataPower Gateway from the GUI or CLI.
The firmware image can contain older versions of component firmware. Component firmware includes, but is not limited to, the DataPower BIOS, BMC, and RAID controller. When the firmware image contains older versions of component firmware, the downgrade can take approximately 20 minutes. During this downgrade process, do not power off or restart the DataPower Gateway.
- Firmware images within a major release differ in only the last digit of the image name. For example, 10.5.0.1 and 10.5.0.0 are in the same major release.
- Firmware images across major releases differ in the first 3 digits of the image name. For example, 10.5.0.1 and 10.0.1.2 are across major releases.
If you encounter problems during a downgrade, see the Knowledge Collection: How to upgrade the firmware on an IBM WebSphere DataPower Gateway Appliance.