Setting environment variables
Set environment variables in the setenv file to upgrade the Interact design time and runtime environment.
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:
Environment variables for the Interact design time environment
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:
Environment variables for the Interact runtime environment
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:
Environment variables to support SSL upgrade (runtime and design time environments)
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.
Copyright IBM Corporation 2014. All Rights Reserved.