IBM DataPower Operations Dashboard v1.0.11.0
A newer version of this product documentation is available.
You are viewing an older version. View latest at IBM DPOD Documentation.
Upgrade
DPOD software updates are available from time to time and include enhancements, security updates, component upgrade, bug fixes etc.
The following sections describe the process of upgrading an existing installation.
Cumulative Upgrade
Up to version 1.0.8.6, each DPOD fix pack file does not include previous fix packs. For example, in order to upgrade from 1.0.7.0 to 1.0.8.6:
- First upgrade to 1.0.8.0 with the 1.0.8.0 fix pack file.
- Then upgrade to 1.0.8.6 with the 1.0.8.6 fix pack file.
From version 1.0.8.6 and above, the latest fix pack in Fix Central includes all previous fix packs above 1.0.8.6. For example, in order to upgrade from 1.0.8.0 to 1.0.10.0:
- First upgrade to 1.0.8.6 with the 1.0.8.6 fix pack file.
- Then upgrade to 1.0.10.0 with the 1.0.10.0 fix pack file, which includes both 1.0.9.0 and 1.0.10.0.
Upgrading Cell Environment
To upgrade a Cell environment - first stop DPOD on the Cell Manager and on all Cell Members, then upgrade the Cell Members, and only after all Cell Members have been upgraded, upgrade the Cell Manager.
Copy the Software Update to DPOD Server
DPOD software updates are available through IBM Fix Central. The download consists of two files:
- The update file: DPOD-fixpack-<version number>.sfs (for example: DPOD-fixpack-1_0_11_0.sfs)
- The md5 hash calculation of the update file: DPOD-fixpack-<version number>.md5 (for example: DPOD-fixpack-1_0_11_0.md5)
Copy the update files to the following directory on DPOD server:/installs/update/fix/TODO
In case the directory does not exist, execute the following command:
mkdir -p /installs/update/fix/TODO
Make Sure there is Enough Disk Space
Root ("/") Mount Point Free Space
The root ("/") mount point requires at least 100MB free space.
Installs ("/installs") Mount Point Free Space
The "/installs" mount point free space can be displayed using the following command:
df -h /installs Output example: Filesystem Size Used Avail Use% Mounted on /dev/mapper/vg_inst-lv_inst 7.0G 5.5G 1.6G 79% /installs
During the software update installation, the internal configuration database is being backed-up. The backup requires additional available disk space on the "/installs" mount point.
To calculate the needed available disk space for the internal configuration database backup please use the following command (in this example DB size is 43MB):
du -ksh /app/derby/ Output example: 43M /app/derby/
See the following table for required available disk space on "/installs" for the software update:
Version | Needed Available Disk Space |
---|---|
1.0.3.X | 700MB + DB SIZE |
1.0.4.X | 700MB + DB SIZE |
1.0.5.X | 2500MB + DB SIZE |
1.0.6.X | 700MB + DB SIZE |
1.0.7.X | 3000MB + DB SIZE |
1.0.8.X | 2000MB + DB SIZE |
1.0.9.X | 3000MB + DB SIZE |
1.0.10.X | 4000MB + DB SIZE |
1.0.11.X | 4000MB + DB SIZE |
If there is not enough free disk space on the "/installs" mount point you may free some by deleting files from the following directories:
Directory | Description |
---|---|
/installs/update/fix/TODO | Remove old DPOD update files (.sfs) |
/installs/update/fix/backups | Remove old DPOD backup directories |
/installs/APPL-setup | Remove DPOD installation file |
/installs/MonTierInstaller | Remove the content of this directory |
/installs/rpms | Remove the content of this directory |
Follow Special Steps
Some versions require special steps. Make sure to follow them:
- Upgrade to 1.0.11.0 - Special Steps
- Upgrade to 1.0.10.1 - Special Steps
- Upgrade to 1.0.10.0 - Special Steps
- Upgrade to 1.0.9.0 - Special Steps
- Upgrade to 1.0.8.0 - Special Steps
- Upgrade to 1.0.5.0 - Special Steps
- Data Migration Procedure
Install the Software Update
Execute the following command from the location where you downloaded the update files to:
MonTierUpdateInstaller.sh -u DPOD-fixpack-<version number>.sfs -s DPOD-fixpack-<version number>.md5 For example: MonTierUpdateInstaller.sh -u DPOD-fixpack-1_0_11_0.sfs -s DPOD-fixpack-1_0_11_0.md5
Note: Some updates make changes to the MonTierUpdateInstaller.sh file itself. In that case, the following message will be displayed, and the command above should be rerun:
INFO file MonTierUpdateInstaller.sh was updated successfully. INFO important !!! Please run MonTierUpdateInstaller.sh again.
Do not interrupt the software update process after it has started.
Please review the upgrade log file if the console displays any error messages.