Setting environment variables

Set environment variables in the setenv file to upgrade the Unica Interact design time and runtime environment.

About this task

Edit the setenv file to set the environment variables that are required by the Unica Interact upgrade tools.

For the Unica Interact design time environment, the file is in the Interact_Design_Environment_Install_Directory/interactDT/tools/upgrade directory under the Unica Interact design time environment installation. For the Unica Interact runtime environment, the file is in the Interact_Runtime_Environment_Install_Directory/tools/upgrade directory under the Unica Interact runtime environment installation.

For more information, read the comments in the setenv file.

The following table describes the environment variables that you must set for the Unica Interact design time upgrade tools in the setenv file:

Table 1. Environment variables for the Unica Interact design time environment

This two-columned table provides information about the names of the environment variables in one column, and the description of the environment variables in the second column.

Variable Description
JAVA_HOME

The root directory of the JDK used by your new Unica Campaign installation.

For example, <Installation_HOME>/jre

JDBCDRIVER_CP

The path to the directory that contains the JDBC driver. JDBCDRIVER_CP is the default path to the JDBC driver; you can override the path when you run the upgrade tool.

Specify the same JDBC driver that was used while installing Unica Platform.

JDBCDRIVER_CLASS

The class for the JDBC driver. JDBCDRIVER_CLASS is the default class to the JDBC driver; you can override the class when you run the upgrade tool.

JDBCDRIVER_URL

The URL for the JDBC driver. JDBCDRIVER_URL is the default URL for the JDBC driver; you can override the URL when you run the upgrade tool.

ERROR_MSG_LEVEL

The desired logging level that has the following valid values, which are listed from most to least verbose:

  • DEBUG
  • INFO
  • ERROR
  • FATAL
LOG_TEMP_DIR

The directory where you want the migration tool to create the log files.

LOG_FILE_NAME

The name of the log file for the upgrade tool.

The following table describes the environment variables that you must set for the Unica Interact runtime upgrade tools in the setenv file:

Table 2. Environment variables for the Unica Interact runtime environment

This two-columned table provides information about the names of the environment variables in one column, and the description of the environment variables in the second column.

Variable Description
JAVA_HOME

The root directory of the JDK used by your new Unica Interact installation.

JDBCDRIVER_CP

The path to the directory that contains the JDBC driver. JDBCDRIVER_CP is the default path to the JDBC driver; you can override the path when you run the upgrade tool.

JDBCDRIVER_CLASS

The class for the JDBC driver. JDBCDRIVER_CLASS is the default class to the JDBC driver; you can override the class when you run the upgrade tool.

JDBCDRIVER_URL

The URL for the JDBC driver. JDBCDRIVER_URL is the default URL for the JDBC driver; you can override the URL when you run the upgrade tool.

ERROR_MSG_LEVEL

The desired logging level that has the following valid values, which are listed from most to least verbose:

  • DEBUG
  • INFO
  • ERROR
  • FATAL
LOG_TEMP_DIR

The directory where you want the migration tool to create the log files.

LOG_FILE_NAME

The name of the log file for the upgrade tool.

The environment variables for SSL upgrade are required for both the Unica Interact design time and runtime environments.

The following table describes the environment variables that you must set to support SSL upgrade for the design time and runtime environment:

Table 3. Environment variables to support SSL upgrade (runtime and design time environments)

This two-columned table provides information about the names of the environment variables in one column, and the description of the environment variables in the second column.

Variable Description
IS_WEBLOGIC_SSL

Should the connection to the server of the target system be through SSL? The valid values are YES and NO. If the value is set to NO, you do not need to set the remaining SSL properties.

BEA_HOME_PATH

The path to the location where the WebLogic server of the target system is installed. You must point to the license.bea file in this path. If you install Unica Interact in a distributed environment where the WebLogic server of the target system is not available locally to the script, copy the license.bea file locally to some folder, and specify the path to that folder by using this environment variable.

SSL_TRUST_KEYSTORE_FILE_PATH

The path of the trust store that is used to configure SSL in the WebLogic server of the target system. The trusted certificates are saved at this location. The SSL_TRUST_KEYSTORE_FILE_PATH variable is used for SSL handshake.

SSL_TRUST_KEYSTORE_PASSWORD

The password of the trust store that is used to configure SSL in the WebLogic server of the target system. If there is no password, set it to "" or nothing. The SSL_TRUST_KEYSTORE_PASSWORD variable is used for SSL handshake.