Configuring the Tomcat Application Server

For configuring an existing Tomcat server, see TIBCO EBX® documentation. Perform the following steps to configure the application server:

Procedure

1. Set the required environment variables. For more information, see Environment Variables.

2. Copy all the .war files from $PSC_HOME/wars to $CATALINA_HOME/webapps directory.

3. Copy EBX™ and the third-party libraries from $PSC_HOME/lib/external to Tomcat lib directory.

4. Update the following properties in $PSC_HOME/dev-artifacts.properties.

   •

   artifactsFolder - The value of artifactsFolder can be absolute or relative. It must point to the $PSC_HOME/data/artifacts directory.

   •

   copyEnvironmentFolder - The value of copyEnvironmentFolder must be relative to the Tomcat bin directory. This must point to the copyEnv directory which is present in psc-mdm.war file. So the absolute path is /webapps/psc-mdm/copyEnv.copyEnvironmentFolder.

   •

   addonDamaDrivePathPrefix - This property indicates where dama related artifacts are stored. You can specify the absolute path or a relative path. The TIBCO PSC related artifacts are stored at $PSC_HOME/common directory. You can use $PSC_HOME/common/images directory for dama related artifacts.

   Note: This property file does not resolve environment variables so specify absolute or relative path.

5. Update the $CATALINA_HOME/conf/catalina.properties file:

   tomcat.util.scan.DefaultJarScanner.jarsToSkip=\
   ebx.jar,\
   ebx-addons.jar,\

6. Update the $CATALINA_HOME/conf/server.xml file:

   <Context path="/ebx" crossContext="true" docBase="ebx.war"/>

7. Configure the launch properties. If Tomcat is launched by a command in Windows' Command Prompt or Unix shell then create another launcher file.

   For Windows, edit the launcher file %CATALINA_HOME%\bin\startup.bat and set the following environment variables:

   export PSC_HOME={PATH TO INSTALLED PRODUCT}
   export TOMCAT_HOME={PATH TO TOMCAT HOME}
   export EBX_HOME={PATH TO EBX HOME}
   export PSC_COMMON_DIR={PATH TO PSC COMMON DIR}
   JAVA_OPTS="$JAVA_OPTS -Debx.home=${EBX_HOME}"
   JAVA_OPTS="$JAVA_OPTS -Debx.properties=${EBX_HOME}/ebx.properties"
   JAVA_OPTS="$JAVA_OPTS -DPSC_HOME=${PSC_HOME}"
   JAVA_OPTS="$JAVA_OPTS -DPSC_COMMON_DIR=${PSC_COMMON_DIR}"
   

   Set the below jvm parameter if using JAVA 11

   set "JAVA_OPTS=%JAVA_OPTS% --add-opens jdk.management/com.sun.management.internal=ALL-UNNAMED"

   For Linux, edit the launcher file $CATALINA_HOME/bin/startup.sh and set the following environment variables:

   export PSC_HOME={PATH TO INSTALLED PRODUCT}
   export EBX_HOME={PATH TO EBX HOME}
   export PSC_COMMON_DIR={PATH TO PSC COMMON DIR}
   JAVA_OPTS="$JAVA_OPTS -Debx.home=${EBX_HOME}"
   JAVA_OPTS="$JAVA_OPTS -Debx.properties=${EBX_HOME}/ebx.properties"
   JAVA_OPTS="$JAVA_OPTS -DPSC_HOME=${PSC_HOME}"
   JAVA_OPTS="$JAVA_OPTS -DPSC_COMMON_DIR=${PSC_COMMON_DIR}"

   Set the below jvm parameter if using JAVA 11

   JAVA_OPTS="$JAVA_OPTS --add-opens jdk.management/com.sun.management.internal=ALL-UNNAMED"
   export JAVA_OPTS