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.
To upgrade for v.1.0.9.0 you must be at version v1.0.8.5.
You should consider full backup.
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_9.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
Install the software update
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_0_9.sfs -s DPOD-update-1_0_9.md5
After running the command 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
On it's first run , the command will complete with the following message :
Starting software update. log file is /installs/update/fix/logs/montier-update-2019-05-20_15-06-06.log Found new version of the software update installer... updating Software update installer was updated successfully. Important !!! Please run the software update installer again.
Rerun the upgrade command :
MonTierUpdateInstaller.sh -u DPOD-update-1_0_9.sfs -s DPOD-update-1_0_9.md5
The upgrade process checks the existence of ElasticSearch indices that were created in early versions of the product.
In case that early version indices do exist, the upgrade process will stop and notify you of a manual step that you will need to run :
Some of the stored application data cannot be migrated to the latest version of the Store service. A data migration tool has been deployed in /installs/data-migration-tool. You may run it using the following command: /installs/data-migration-tool/data-migration-tool.sh Further information can be found in the documentation at: Admin Guide -> Installation and Upgrade -> Upgrade -> Upgrade to 1.0.10.0 - Special Steps
Run the data-migration-tool manually , as described :
/installs/data-migration-tool/data-migration-tool.sh
The Data-Migration process may run a few minutes, or depending on the amount of data to migrate, up to a few days.
An estimation of the time left to run will be calculated and presented on the console output during the process run. These estimations will also be written to the log file.
Make sure not to interrupt SSH session during the Data-Migration operation.
Alternatively, you can run the Data-Migration in a "no hang-up" mode, which will cause the process to continue running even after the SSH session is closed. In this mode, the console output will be written to the nohup.log file in the local directory.
nohup /installs/data-migration-tool/data-migration-tool.sh &
Please review the Data-Migration log file if the console displays any error messages.
When the Data-Migration completes, check the log file for the following line :
Data migration tool finished successfully
To proceed with the software update, you can rerun the software update command :
MonTierUpdateInstaller.sh -u DPOD-update-1_0_9.sfs -s DPOD-update-1_0_9.md5
When the software update completes, the system will display the following messages on the console output.
Starting software update. log file is /installs/update/fix/logs/montier-update-2019-05-20_15-07-06.log 2019-05-20_15-07-17: INFO Starting software update (JRE). log file is /installs/update/fix/logs/montier-update-2019-05-20_15-07-06.log 2019-05-20_15-07-51: INFO Stopping application ... 2019-05-20_15-08-47: INFO Application stopped successfully. 2019-05-20_15-09-29: INFO Starting software update (JRE). 2019-05-20_15-10-33: INFO Starting software update (1.0.9.0). log file is /installs/update/fix/logs/montier-update-2019-05-20_15-07-06.log 2019-05-20_15-10-37: INFO Stopping application ... 2019-05-20_15-11-27: INFO Application stopped successfully. 2019-05-20_15-11-28: INFO Starting software update (1.0.9.0). 2019-05-20_15-17-18: INFO Updated complete successfully (1.0.9.0). log file /installs/update/fix/logs/montier-update-2019-05-20_15-07-06.log. 2019-05-20_15-17-24: INFO Starting application ... 2019-05-20_15-19-55: INFO Application started successfully. 2019-05-20_15-20-00: INFO Please update store allocation now 2019-05-20_15-20-00: INFO Using the admin console in https://<your server name>/admin 2019-05-20_15-20-00: INFO Admin Console -> Utilities -> Store -> Store Allocation update DPOD-update-1_0_9.sfs was installed successfully. log file /installs/update/fix/logs/montier-update-2019-05-20_15-07-06.log
Please review the upgrade log file if the console displays any error messages.
Update Store Allocation
Open the DPOD admin console on your favorite browser :
https://<your server name>/admin
Go to :
Admin Console -> Utilities -> Store -> Store Allocation
Run the update_store_allocation process :
Confirm the operation :
The execution output window will appear. Wait for the "Command executed successfully" indication, and check that the line "Configuration ended successfully" in the output.
