Setting environment variables

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

About this task

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

For the Interact design time environment, the file is in the Interact_Design_Environment_Install_Directory/interactDT/tools/upgrade directory under the Interact design time environment installation. For the Interact runtime environment, the file is in the Interact_Runtime_Environment_Install_Directory/tools/upgrade directory under the 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 Interact design time upgrade tools in the setenv file:

Table 1. Environment variables for the 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 Campaign installation. For example, `<CAMPAIGN_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 Marketing 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 Interact runtime upgrade tools in the setenv file:

Table 2. Environment variables for the 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 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 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 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.