You can upgrade the IBM® WebSphere® DataPower® XC10 Appliance software by using firmware updates. Download new firmware versions
from the Fix Central website and update your appliance software.
Before you begin
You must be assigned the Appliance administration permission.
Check to ensure that all active jobs are complete before you start
the firmware update process. The firmware update process interrupts
any jobs that are actively running, which can cause the data to become
inconsistent. Ensure that you planned for this behavior before you
begin the update process.
About this task
You can update the firmware of the appliance by downloading
a new firmware update from IBM and updating your appliance with the new firmware. You can run the
firmware update in the user interface or on the command line.
![[Version 2.1 and later]](../images/21plus.gif)
CAUTION:
When you are upgrading to Version 2.1 from Version 2.0 or lower,
you cannot run a firmware upgrade on a collective that is currently
servicing workload. When you upgrade a collective, all of the data
that was loaded into the data grids is lost. When you are running
firmware upgrades on the appliances in a collective, the appliance
that you upgrade does not fully restart until all of the appliances
in the collective are upgraded. The remaining appliances that are
not yet upgraded service the requests. You must complete the firmware
upgrade process on one appliance before you start the process on another
appliance within the collective. Do not make any configuration changes
until all of the appliances are on the same firmware level.
Important: After you upgrade either
9235-92X or 7199-92X appliance types with Version 2.1 firmware, you
cannot roll back to any previous firmware version. You must operate
at the Version 2.1 or higher firmware level.
Procedure
- Download the firmware upgrade:
Go
to
IBM Fix Central and download a firmware update to your local file system. From the
Fix Central page, select
WebSphere as the
Product Group and
WebSphere DataPower XC10 Appliance from the list of products. Download the firmware upgrade that
is appropriate for your appliance hardware type:
Appliance firmware updates for Appliance
type 9235-92X are a single file with .scrypt2 extension.
- Appliance firmware updates for Appliance type 7199-92X are a single
file with .scrypt3 extension.
These
scrypt files are signed to ensure
the integrity of update that is being run. If you are using the
user interface to run the firmware upgrade, save this file on the computer that
you use to access the
user interface. If you are using the command-line interface to run the firmware
upgrade, save this file on a server that you can access from the appliance.
- To run the firmware update in the user interface:
- Log on to the user interface.
- Navigate to the Settings panel.
- In the WebSphere DataPower XC10 Appliance user interface, click .
- From the Home panel, click the Customize settings link in the Step 1: Set
up the appliance section.
- Expand Firmware. The
level of firmware that is installed on the appliance is displayed.
- Install a new firmware update.
- Click Browse... to select the new firmware
update file.
- Select the new firmware update file and click OK.
- Click Upgrade. The amount of time the firmware
update takes to upload is dependent on your connection speed. A message
is displayed when the upload completes and the firmware update is
starting. When the update begins the appliance is restarted, your
screen does not indicate any progress or display any changes on the user interface. The changes are not displayed because your session ended when the
appliance restarted and the user interface is not available during the upgrade process.
Important: The appliance restarts several times during the firmware upgrade
process. Do not interrupt the process or manually restart the appliance
during the firmware upgrade.
To confirm the firmware update
is complete, you must log in again when you expect the update is complete.
The actual firmware update takes an average of about 10 minutes to
15 minutes after it starts but can possibly take longer. If you want
to monitor the progress of the firmware upgrade, use the start-progress command in the command-line
interface.
- To run the firmware update in the command-line interface:
- Connect to the appliance with the command line or through
the serial console. For more information,
see Running operations on the appliance with the command-line interface.
- Put the .scrypt file on the appliance. From the command-line interface, run the following command:
file get <url_to_scrypt_file> <firmware_file>
Where url_to_scrypt_file is the local server where you saved the .scrypt file from Fix Central, and firmware_file is the
name of the .scrypt file that you want to use
on the appliance.
- Install the firmware update. Run the following
command:
firmware upgrade <firmware_file>
Important: During the firmware upgrade process,
the appliance restarts several times. Do not interrupt the process
or manually restart the appliance during the firmware upgrade.
- Monitor the progress of the appliance startup.
- Run the start-progress command to monitor
the progress. When this command returns STARTED, the appliance is ready for use.
Results
The appliance has the updated firmware version. To confirm
the firmware upgrade was successful, you can view the current firmware
level in the Firmware section of the panel.
This panel also displays the appliance model type
and appliance serial number. Repeat these steps for the other
appliances in your collective.
What to do next
If you are installing the firmware for the first time on
a new appliance, you must run the
clear-all command
on the appliance after the firmware update completes. For more information,
see
Initializing and configuring IBM WebSphere DataPower XC10 Appliance.