IBM DataPower Operations Dashboard v1.0.16.0

A newer version of this product documentation is available.

You are viewing an older version. View latest at IBM DPOD Documentation.

Upgrade to 1.0.10.0 - Special Steps

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.7). Therefore the upgrade command will be required to be executed twice:

  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

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:

    # 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:

    # Cell MANAGER only!
    mv /app/agentnode /app/agentnode-old

Issue in Executing the Data Migration Tool

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:

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:

# 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

IBM DataPower Operations Dashboard (DPOD) v1.0.16.0