Open topic with navigation

TIBCO® Product and Service Catalog powered by TIBCO EBX® 1.2.0

# 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

ResultTomcat is configured. User accounts used to launch EBX™ must have create/update/delete rights on EBX_HOME & PSC_HOME directories.

Copyright © 2021-2022. Cloud Software Group, Inc. All Rights Reserved.