Configuring the Tomcat Application Server

For configuring an existing Tomcat server, see the 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 TIBCO EBX® and the third-party libraries from the $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 the psc-mdm.war file. So the absolute path is /webapps/pscmdm/copyEnv.copyEnvironmentFolder.
    addonDamaDrivePathPrefix - This property indicates where data-related artifacts are stored. You can specify the absolute path or a relative path. The TIBCO PSC-related artifacts are stored at the $PSC_HOME/common directory. You can use the $PSC_HOME/common/images directory for data-related artifacts.
    Note: This property file does not resolve environment variables so specify the 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 following jvm parameter if using JAVA 17

    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 following jvm parameter if using JAVA 17

    JAVA_OPTS="$JAVA_OPTS --add-opens
    jdk.management/com.sun.management.internal=ALL-UNNAMED"
    export JAVA_OPTS
ResultResult of your procedure. Tomcat is configured. User accounts used to launch TIBCO EBX® must have create, update, or delete rights on the EBX_HOME and PSC_HOME directories.