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
-
Set the required environment variables. For more information, see Environment Variables.
-
Copy all the .war files from
$PSC_HOME/wars
to$CATALINA_HOME/webapps
directory. -
Copy TIBCO EBX® and the third-party libraries from the
$PSC_HOME/lib/external
to Tomcat lib directory. -
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 thepsc-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. -
Update the
$CATALINA_HOME/conf/catalina.properties
file:tomcat.util.scan.DefaultJarScanner.jarsToSkip=\ ebx.jar,\ ebx-addons.jar,\
-
Update the
$CATALINA_HOME/conf/server.xml
file:<Context path="/ebx" crossContext="true" docBase="ebx.war"/>
-
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