Upgrading on-premise applications to Docker

You can upgrade an on-premise version of Unica to the Docker version. The Docker will be deployed on the application server.

Before you begin

The prerequisites for the upgrade are as follows:

  • Take a backup of your existing database.
  • Copy the file system of the previous version to the mount location.
  • Provide appropriate values the database parameters of all Unica components.
  • For Interact fast upgrade, the schema name in the target setup should be the same as the one in the base setup.
  • Manually map the tables and restart the Campaign Pod.
In the common-configMap.yaml file, provide values for the following fields.
Table 1. Configurable Parameters to perform an Upgrade
Parameter Name Example Value
BASE_FOLDER "OLDINSTALL/HCLUnica_86"
FROM "8.6.0"
TO "12.0.0"
SOURCE_SCHEMA "CAMP86"
TARGET_SCHEMA "DBO"
DB_DRIVER_CLASS com.microsoft.sqlserver.jdbc.SQLServerDriver
AC_VERSION "12.1.x"
ACI_UNICODE "No"
CONFIGURE_ON_ERROR_PROMPT "Yes"
LOCALE "en_US"
TYPE UPGRADE
DATABASE_EXPORT_DIR /DBBACKUP/
ISEXTERNALDB false
DB_IMPORT_WAIT_TIME 1050
DB_PRE_IMPORT_WAIT_TIME 1050
IS_UNICODE false
UPGRADE_FROM_TO 11.1+To12.1
LISTENER_HOST_NAME {{ .Release.Name }}-omnix-unica-listener
SOURCE_SCHEMA_RT camp86
TARGET_SCHEMA_RT camp86
DB_DRIVER_CLASS_RT com.ibm.db2.jcc.DB2Driver
SOURCE_SCHEMA_PROD intpr86
TARGET_SCHEMA_PROD intpr86
DB_DRIVER_CLASS_PROD com.ibm.db2.jcc.DB2Driver
SOURCE_SCHEMA_LRN intlr86
TARGET_SCHEMA_LRN intlr86
DB_DRIVER_CLASS_LRN com.ibm.db2.jcc.DB2Driver
SOURCE_SCHEMA_RUN intrt86
TARGET_SCHEMA_RUN intrt86
DB_DRIVER_CLASS_RUN com.ibm.db2.jcc.DB2Driver

Add the JVM Option -DFAST_UPGRADE_VERSION=<BASE_VERSION>. For example: JAVA_OPTIONS="${JAVA_OPTIONS} -DFAST_UPGRADE_VERSION=8.6.x.

Supported versions in the fast upgrade are as follows:

8.6.x -DFAST_UPGRADE_VERSION=8.6.x
9.0.x -DFAST_UPGRADE_VERSION=9.0.x
9.1.x.x (9.1.x, 9.1.1.x and 9.1.2.x) -DFAST_UPGRADE_VERSION=9.1.x
10.0.x -DFAST_UPGRADE_VERSION=10.0.x
10.1.x -DFAST_UPGRADE_VERSION=10.1.x
11.0.x -DFAST_UPGRADE_VERSION=11.0.x
11.0.1 -DFAST_UPGRADE_VERSION=11.0.1.x

About this task

The mount location should contain the old version of the Unica file system. Unica Docker containers will manage the database upgrade and the file system updates.

Procedure

  1. To perform the upgrade, run the following command.
    helm install --name unica omnix-unica --set service.hostname=<kubernetes.nonprod.hclpnp.com --set service.applicationDomain='nonprod.hclpnp.com' --set ingress.enabled=true
  2. Access the upgrade logs from the mount location.