Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.8.0 you must be at version v1.0.7.0 ..

You should consider full backup.

Appliance Mode Users Only - Upgrade Should be Applied in 2 Steps

The upgrade will upgrade your DPOD installation to an advanced level of Operating System (CentOS 7.47). Therefore the upgrade command will be required to be executed twice: 1) For Operating System upgrade 2) For Application upgrade. This procedure will document this to steps upgrade

Obtain the software update

DPOD software updates are available through IBM fix central.

The download consists of two types of files :

  1. The update file in the format of : DPOD-fixpack-<version number>.sfs (for example: DPOD-fixpack-1_0_10_0.sfs)
  2. 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 :

Code Block
themeRDark
/installs/update/fix/TODO

If the directory is missing for some reason, please re create it :

Code Block
themeRDark
mkdir -p /installs/update/fix/TODO

Install the software update

Run the following command from the location you downloaded the update files to.

Code Block
themeRDark
MonTierUpdateInstaller.sh -u DPOD-update-<version number>.sfs -s DPOD-update-<version number>.md5

For example:

Code Block
themeRDark
MonTierUpdateInstaller.sh -u DPOD-update-1_0_10.sfs -s DPOD-update-1_0_10.md5

...

Code Block
themeRDark
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 : 

Code Block
themeRDark
error, software update can NOT be applied to this system version. aborting update...
Note

Do Not interrupt the software update process after it has begun

...

Code Block
themeRDark
Starting software update. log file is /installs/update/fix/logs/montier-update-2017-08-01_16-13-35.log
stopping application ...
application stopped successfully.
starting software update.....
updated complete successfully
starting application ...
application started successfully.
update DPOD-update-1_5_0.sfs was installed successfully. log file /installs/update/fix/logs/montier-update-2017-08-01_16-13-35.log

Please review the upgrade log file if the console displays any error messages.

  1. For operating system upgrade
  2. For application software upgrade

Issue in Upgrading Cell Environment from 1.0.9.0 to 1.0.10.0

Warning

DPOD 1.0.10.0 has an issue that causes upgrades to fail in a cell environment. Follow the instructions below to avoid this issue.

  1. Before running the upgrade, execute the following commands on each of the cell members:

    Code Block
    languagebash
    themeRDark
    # Cell MEMBERS only!
    mv /app/agentnode /app/agentnode-old
    mv /etc/init.d/MonTier-AgentNode /etc/init.d/Disabled-MonTier-AgentNode


  2. Before running the upgrade, execute the following commands on the cell manager:

    Code Block
    languagebash
    themeRDark
    # Cell MANAGER only!
    mv /app/agentnode /app/agentnode-old


Issue in Executing the Data Migration Tool

Warning

DPOD 1.0.10.0 sometimes fail to execute the Data Migration Tool. This has been fixed in DPOD 1.0.10.1, so you may upgrade directly to 1.0.10.1 in order to avoid this issue.

In case the following message is displayed, please use the steps below to execute the Data Migration Tool during an upgrade to 1.0.10.0:

Code Block
languagetext
themeRDark
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

Steps to execute the Data Migration Tool:

Code Block
languagebash
themeRDark
# Make sure the sfs file name matches the downloaded file name and modify it if required
# Mount the fix pack file and copy java directory to migration tool.
cd /installs/update/fix/TODO
mount DPOD-fixpack-1.0.10.0.sfs /mnt/update/
cp -r /mnt/update/java /installs/data-migration-tool/.
umount /mnt/update

# Set migration tool java runtime to copied jvm
cp /installs/data-migration-tool/data-migration-tool.sh /installs/data-migration-tool/data-migration-tool.sh-orig
sed -i 's/java\ -cp/\/installs\/data-migration-tool\/java\/bin\/java\ -cp/i' /installs/data-migration-tool/data-migration-tool.sh

# Run the tools
/installs/data-migration-tool/data-migration-tool.sh