Environment Variables
You must set the important environment variables before installing TIBCO MDM.
- It is recommended that you use ASCII characters for all file names. If these names include non-ASCII characters, copying the files from Windows to UNIX or Linux and vice versa may result in corruption of file names.
- While setting environment variables on all platforms, if the ‘\’ character is used as a path separator instead of ‘/’, it leads to errors as ‘\’ is treated as an escape character.
- For Simple install, set only JAVA_HOME environment variable.
- For Typical install, set all the environment variables mentioned in the Environment Variables table.
Variable | Description |
---|---|
MQ_HOME | Define
MQ_HOME to point to the installation directory. It is recommended that you allocate at least 8 GB to this directory. In a clustered environment, each application server should point to a separate location.
Example: /home/tibco/mdm/verion_number |
MQ_LOG | The location where log files will be generated (the recommended location is
$MQ_HOME/log). In a clustered environment, each server should point to a separate location. Define
MQ_LOG to point to this directory. A minimum of 1 GB should be allocated to this directory. The best practice is to change the default location such that the directory is not a sub-directory of
MQ_HOME.
Example: $MQ_HOME/log |
MQ_COMMON_DIR | All standard configurations files for workflow and data validation as well as all customizations are stored in this directory. This directory also holds all files generated during normal application processing. It is shared by all application servers in the cluster, and should be mounted to each server. All disk space indicated in the section
Hardware Configuration should be assigned to this directory, and the
MQ_COMMON_DIR variable should be set. The best practice is to change the default location such that the directory is not a sub-directory of
MQ_HOME.
Example: /home/tibco/mdm/version_number/common If you plan to create a copy of the TIBCO MDM instance across operating systems (for instance, Linux to Windows or Windows to Linux) and if the path contains any non English characters, such a copy may not be possible. For example, using Japanese characters in the path. |
MQ_CONFIG_FILE | Points to
$MQ_HOME/config/ConfigValues.xml. The values/parameters in this file can be set using the Configurator.
Example: /home/tibco/mdm/version_number/config/ConfigValues.xml |
JAVA_HOME | The directory where JRE/JDK is installed.
Example: /opt/jdk1.8 |
EMS_HOME | The directory where TIBCO EMS (or the messaging software) is installed.
Example: /home/tibco/ems |
ANT_HOME | The Directory path where ant is installed. For example /opt/ant1.5.4. |
Application Server Specific | |
WAS_HOME | The directory where WebSphere is installed (required
only if using WebSphere).
Example: /opt/WebSphere/AppServer |
JBOSS_HOME | For JBoss WildFly Application Server. Specify the path value until the root of the WildFly directory. For example, E:\JBoss\wildfly-10.1.0.Final. |
JBOSS_HOME (Simple Install) | The directory where JBOSS is installed (required only if using simple installation).Example: %MQ_HOME%\bin\wildfly-10.1.0.Final |
BEA_HOME | For WebLogic Application Server. Specify the path value of the WebLogic Application Server directory. Example: |
Database Specific | |
ORACLE_HOME | For Oracle database. The directory where Oracle is installed. Example: |
LD_LIBRARY_PATH | For Oracle database: $ORACLE_HOME/lib |
NLS_LANG | For Oracle database. Example: |
POSTGRESQL_HOME | For PostgreSQL database. The directory where PostgreSQL is installed. Example: $MQ_HOME/bin/pgsql |
AS_HOME | The directory where AS is located. By default AS is bundled with TIBCO MDM, if you have installed AS externally the specify the path of the location.
Example:$MQ_HOME/bin/as/version
|
OS | The Operating system. For example, Linux. |
DISPLAY | This environment variable is used by X-Windows based applications. It points to a device capable of displaying an X-Windows based UI. |
LD_ASSUME_KERNEL | Used on the Linux platform to make Linux use the old Linux threads library, particularly required for Oracle installation (required only if Oracle is used as the database). |
PATH | This is a list of directories separated by a separator. When any command or program is executed, the OS tries to locate the program in the directories listed in PATH. If the program is not found in any of the directories, the OS cannot load and execute the program. The Separator character is ‘:’ for Unix and Linux platforms, and ‘;’ for the Windows platform.
Ensure that there is no space with the commas and colons between the program in the directories listed which are separated by ':' for Unix and Linux platforms, and ';' for the Windows platform. |
SHLIB_PATH | List of directories separated by a separator (see PATH) where a dynamic linker tries to find the libraries. Used on UNIX platforms. |
LIBPATH | List of directories separated by a separator (see PATH) where the Operating system as well as the application library files reside. Used on UNIX platforms. |
NODE_ID | Points to the current cluster member. Example: NODE_ID=Member1 |