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