Troubleshooting
Problem
You want to upgrade component firmware on your DataPower Integration Blade XI50B without sending it to IBM. This component firmware includes the Unified Extensible Firmware Interface (UEFI), Integrated Management Module (IMM), and Dynamic System Analysis (DSA).
Symptom
Firmware that is not at the latest level can cause several problems:
- Some Integration Blade XI50B appliances cannot maintain the correct power on or off state.
- Some appliances cannot boot into Dynamic System Analysis (DSA).
- When you press function key 2 (F2) at boot splash, the appliance hangs.
Environment
The following table shows the current versions of the Integration Blade XI50B component firmware and the upgrade versions.
| Component | Current firmware version | Upgrade firmware version |
| UEFI | FSE147AUS-1.00 | P9E158A-1.19 |
| IMM | YUOO72F (1.13) | YUOOE9E-1.37 |
| DSA | DSYT55B | DSYTA7I-9.27 |
These instructions use the existing DataPower firmware upgrade infrastructure.
The following files are required for this upgrade:
- reltool_eswUpdater_dsa_dsyta7i-9.27_backup_xi.scrypt2
- reltool_eswUpdater_dsa_dsyta7i-9.27_primary_xi.scrypt2
- reltool_eswUpdater_imm_yuooe9e-1.37_backup_xi.scrypt2
- reltool_eswUpdater_imm_yuooe9e-1.37_primary_xi.scrypt2
- reltool_eswUpdater_uefi_p9e158a-1.19_both_xi.scrypt2
These files contain IMM, UEFI, and DSA upgrade packages only. You can use the boot image command or the WebGUI to start the upgrade for the component firmware. All messages are written to the system log.
The DataPower appliance uses the scrypt2 file format to distribute both firmware upgrades and tools. For tools, always use the boot image command. If you use other commands (such as reinitialize or boot reflash), the appliance might log confusing error messages or not restart automatically as required.
The tool for component upgrades can run only in appliance firmware versions 5.0.0 and 6.0.0.
In addition to enabling local upgrades, these tools correct the issues in the Symptoms section:
- Corrects a problem that can occur at boot time when you press the function key 2 <PF2> to load the diagnostics (DSA).
- Prevents some blades from issuing incorrect reports of "voltage under threshold" errors on the expansion module.
- Prevents some blades from failing to stay powered-down when you request a power-down.
Resolving The Problem
Prepare the system
- Download the tools for Fix Central.
- To download directly, click Tools-XI50B-June-2013-Component-Firmware
- To download manually, go to the Fix Central. The identifier is Tools-XI50B-June-2013-Component-Firmware. If you are new to Fix Central, see Fix download method for WebSphere DataPower SOA Appliances.
- In the WebGUI, specify the following Network Settings properties:
- In the search field, enter Network.
- From the search results, click Network Settings.
- Set Relaxed Interface Isolation and Never Enforce Interface Isolation to On.
- Click Apply.
- Confirm that the Integration Blade XI50B is running.
- Check for any administrative preconditions for an upgrade; such as, disabling certain network settings for time outs.
For more information about upgrades, see the installation tasks in the DataPower Information Center.
Upgrade procedure
- You can use either the command line or the WebGUI to install this upgrade. Open an SSH session or access the Control Panel in the WebGUI.
- Using the command line, issue the service show component-firmware command. Observe that the IMM and BMC firmware version values correspond to the correct component values for the upgrade.
- Using the BladeCenter Advanced Management Module (AMM), select the firmware Vital Product Data (VPD) monitor. Check that the firmware BIOS, Blade System Management Processor IMM values, and the Diagnostics pDSA have the correct component values for the upgrade. The Diagnostics version is provided only by the AMM firmware VPD monitor.
Follow the steps to perform the firmware upgrade in the following order: IMM, UEFI, and DSA. Each step in the process can take 20 - 25 minutes to complete. It takes an extra 10 - 15 minutes for the firmware to activate after the upgrade is complete.
Step 1: Upgrade IMM to the primary partition with the reltool_eswUpdater_imm_yuooe9e-1.37_primary_xi.scrypt2 file.
Step 2: Upgrade IMM to the backup partition with the reltool_eswUpdater_imm_yuooe9e-1.37_backup_xi.scrypt2 file.
Step 3: Upgrade UEFI both the primary and backup partitions with the reltool_eswUpdater_uefi_p9e158a-1.19_both_xi.scrypt2 file.
The UEFI upgrade handles both the primary and the backup partitions. It is important to synchronize these partitions.
ATTENTION: There is a potential security exposure when the UEFI upgrade begins. An attacker might modify key components on the Integration Blade XI50B. When you perform the upgrade, ensure that the blade is sufficiently isolated from potential attack. Restart the blade as soon as possible after each upgrade. The security exposure ends when the blade restarts.
Step 4: Upgrade DSA to the primary partition with the reltool_eswUpdater_dsa_dsyta7i-9.27_primary_xi.scrypt2 file.
Step 5: Upgrade DSA to the backup partition with the reltool_eswUpdater_dsa_dsyta7i-9.27_backup_xi.scrypt2 file.
Step 6: Verify the component firmware levels with the upgrade firmware versions:
- Limitations exist when you display firmware versions with the service show component-firmware command:
- The IMM version might not be show the upgrade until the requisite 15-minute wait period is over and the appliance is restarted.
- The UEFI version does not show the upgrade until the appliance is restarted.
- No DataPower commands display the DSA information. DSA information can be accessed with the BladeCenter AMM on the Firmware VPD page (the Diagnostics VPD).
- For the IMM and the DSA, you can perform the upgrade to the primary and backup flash partitions separately.
- For the UEFI, there is no flash partition choice because the two flash partitions are kept in sync for this firmware.
IMM and UEFI have a strong dependency relationship. The process verifies that they can work together. Discrepancies do not prevent the upgrade.
The process can apply the upgrade to a backup flash, if such a flash exists. A backup flash is used during the boot sequence of the Integration Blade XI50B in the rare event that booting the primary flash fails. If the Integration Blade XI50B does not have a backup flash, performing the upgrade for it has no effect.
[{"Product":{"code":"SSFGB5","label":"WebSphere DataPower Integration Blade XI50B"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"--","Platform":[{"code":"PF009","label":"Firmware"}],"Version":"6.0.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Was this topic helpful?
Document Information
Modified date:
15 June 2018
UID
swg21633587