DPOD software updates are available from time to time and include enhancements, security updates, component upgrade, bug fixes etc.
Each DPOD fixpack file is not including any previous fixpack. For example: to upgrade from v1.0.5 to v1.0.7 you will need to first upgrade to v1.0.6 with the downloaded fix of v106 and after a successful upgrade to v106 you may apply the fix to v107.
The following sections describe the process of upgrading an existing installation.
Obtain the software update
DPOD software updates are available through IBM fix central.
The download consists of two types of files :
- The update file in the format of : DPOD-fixpack-<version number>.sfs (for example: DPOD-fixpack-1_0_5.sfs)
- The md5 hash calculation of the update file : DPOD-update-<version number>.md5
Copy the software update to the DPOD server
Copy the update files to the following directory on the DPOD server :
/installs/update/fix/TODO
If the directory is missing for some reason, please re create it :
mkdir -p /installs/update/fix/TODO
Make sure there is enough disk space
The software update requirements for available disk space may change from version to version. See version table below.
The disk space is needed at the "/install" mount point and 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 needed available disk space on "/installs" for the software update:
| Version | Needed Available Disk Space |
|---|---|
| 1.0.3 | 700MB + DB SIZE |
| 1.0.4 | 700MB + DB SIZE |
| 1.0.5 | 2500MB + DB SIZE |
| 1.0.6 | 700MB + DB SIZE |
| 1.0.7 | 3000MB + DB SIZE |
| 1.0.8 | 2000MB + DB SIZE |
If there is not enough free disk space on the "/installs" mount point the user 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 |
Install the software update
Manual Pre Update Installation
DPOD's Store service cannot run under root and requires a dedicated user to run.
For "Non Appliance " installation only - During the software update installation user will be asked to provide the Store service dedicated user.
Example for creating Store service dedicated user : groupadd storeadms && useradd -g storeadms -md /home/storeadm -s /bin/bash storeadm
Software installation
Run the following command from the location you downloaded the update files to.
MonTierUpdateInstaller.sh -u DPOD-update-<version number>.sfs -s DPOD-update-<version number>.md5
For example:
MonTierUpdateInstaller.sh -u DPOD-update-1_8_0.sfs -s DPOD-update-1_8_0.md5
You may encounter the following message:
INFO file MonTierUpdateInstaller.sh was updated successfully. INFO important !!! Please run MonTierUpdateInstaller.sh again.
This message means that the MonTierUpdateInstaller.sh was updated and you should rerun the command.
After running the command again you will be prompted to confirm the software update process. press "Y" to confirm or "N" to abort.
Software update : Please DO NOT interrupt during the process ! Are you sure you want to continue ? [y/n]
When the software update level is not compatible with the current system version you will receive the following message on the console output :
error, software update can NOT be applied to this system version. aborting update...
Do Not interrupt the software update process after it has begun
When the software update completes, the system will display the following messages on the console output.
For Appliance Installation :
Starting software update. log file is /installs/update/fix/logs/montier-update-2018-10-01_15-31-58.log 2018-10-01_15-32-01 INFO Starting software update (JRE). log file is /installs/update/fix/logs/montier-update-2018-10-01_15-31-58.log 2018-10-01_15-32-06 INFO Stopping application ... 2018-10-01_15-32-54 INFO Application stopped successfully. 2018-10-01_15-33-25 INFO Starting software update (JRE). 2018-10-01_15-34-07 INFO Starting software update (1.0.8.5). log file is /installs/update/fix/logs/montier-update-2018-10-01_15-31-58.log 2018-10-01_15-34-09 INFO Stopping application ... 2018-10-01_15-34-53 INFO Application stopped successfully. 2018-10-01_15-34-53 INFO Starting software update (1.0.8.5). 2018-10-01_15-36-30 INFO Updated complete successfully (1.0.8.5). log file /installs/update/fix/logs/montier-update-2018-10-01_15-31-58.log. 2018-10-01_15-36-33 INFO Starting application ... 2018-10-01_15-36-33 INFO Starting application ... 2018-10-01_15-39-01 INFO Application started successfully. update DPOD-update-1_8_5.sfs was installed successfully. log file /installs/update/fix/logs/montier-update-2018-10-01_15-31-58.l
For Non Appliance Installation :
Starting software update. log file is /installs/update/fix/logs/montier-update-2018-10-01_15-50-12.log 2018-10-01_15-50-50 INFO Starting software update (JRE). log file is /installs/update/fix/logs/montier-update-2018-10-01_15-50-12.log 2018-10-01_15-50-54 INFO Store service cannot run under root and requires a dedicated user to run. 2018-10-01_15-50-54 INFO Please provide the user name for the Store service followed by [ENTER]: storeadm 2018-10-01_15-51-13 INFO Stopping application ... 2018-10-01_15-52-14 INFO Application stopped successfully. 2018-10-01_15-52-52 INFO Starting software update (JRE). 2018-10-01_15-53-47 INFO Starting software update (1.0.8.5). log file is /installs/update/fix/logs/montier-update-2018-10-01_15-50-12.log 2018-10-01_15-53-52 INFO Stopping application ... 2018-10-01_15-54-44 INFO Application stopped successfully. 2018-10-01_15-54-45 INFO Starting software update (1.0.8.5). 2018-10-01_15-57-46 INFO Updated complete successfully (1.0.8.5). log file /installs/update/fix/logs/montier-update-2018-10-01_15-50-12.log. 2018-10-01_15-57-54 INFO Starting application ... 2018-10-01_16-02-06 INFO Application started successfully.
Please review the upgrade log file if the console displays any error messages.
Manual Post Update Installation
Important: After the upgrade is complete user must complete following steps :
- Run the following command for DPOD's ssh session :/app/scripts/app_logical_tran.sh -e
Expected output :
INFO : Logical transaction enable finished successfully.
INFO : The agents services must be restarted for the change to take effect.
INFO : For more information see log file /logs/syslogAgents/app_logical_tran-2018-10-01_16-41-24.log .
- Restart the Syslog agent services using the CLI Main Admin Menu