Upgrades to the IBM® WebSphere® DataPower® XC10 Appliance software
are installed using firmware updates. New firmware versions can be
downloaded from the Web site and used to update your appliance software.
Before you begin
You must be assigned the Appliance administration permission
to perform these steps.
Check to ensure that all active jobs
have completed before starting 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 have planned
for this behavior before beginning the update process.
CAUTION:
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.
Important: If your appliances
are in a collective, you must complete the firmware upgrade process
on one appliance before starting the process on another appliance
within the collective. If you attempt to update the firmware on multiple
appliances in the collective simultaneously, data loss might occur.
Procedure
- To run the firmware update in the user interface:
- Navigate 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. The firmware update is a single file with .scrypt2 extension.
This file has been signed to ensure the integrity of update being
run. Save this file on the computer that you use to access the user interface.
- Log on to the user interface.
- Navigate to the Settings panel.
- From the menu bar at the top of the WebSphere DataPower XC10 Appliance user
interface, navigate to .
- From the Home panel, click the Customize
settings link in the Step 1: Set up the appliance section.
- Expand Firmware. This
section displays the level of firmware that is currently installed
on the appliance.
- Install a new firmware update.
- Click Browse... to navigate the file system
for 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 has completed 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. To confirm the firmware
update has completed, you need to log in again when you expect the
update has completed. The actual firmware update takes an average
of about 10 minutes to 15 minutes after it has begun but can possibly
take longer.
- To run the firmware update in the command line interface:
- Navigate 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. The firmware update is a single file with .scrypt2 extension.
This file has been signed to ensure the integrity of update being
run. Save this file on a server that you can access from the appliance.
- Connect to the appliance with the command line or through
the serial console. See Using the command line interface to run operations on your appliance for
more information.
- Put the .scrypt2 file on the appliance. From the command line interface, run the following command:
file get <url_to_scrypt2_file> <firmware_file>
Where url_to_scrypt2_file is
the local server where you saved the .scrypt2 file
from Fix Central, and firmware_file is the name
of the .scrypt2 file that you want to use on
the appliance.
- Install the firmware update. Run the following
command:
firmware upgrade <firmware_file>
After
the firmware upgrade has completed, the appliance restarts.
Results
The appliance has the updated firmware version. To can confirm
the firmware upgrade was successful, you can view the current firmware
level in the Firmware section of the
Settings panel.
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. See
Initializing and configuring IBM WebSphere DataPower XC10 Appliance for more information about running
this command after the firmware update.