A.3 Configure Apache Tomcat Server for Application Deployment

This section describes how to configure Apache Tomcat Server for Application Deployment.

This section is applicable only when the Web application server type is Tomcat.

Tomcat User Administration

The Tomcat administration and manager application does not provide a default login. You are required to edit $CATALINA_HOME/conf/tomcat-users.xml as follows:

Note:

This file contains an XML <user> for each user that will display the username and password used by the admin to log in to Tomcat and the role names to which the admin user is associated with.

For example: <user name="admin" password="admin" roles="standard,manager" />

  1. Add the manager role to any one of the existing username/password combinations as shown in the preceding example.
  2. Use the same username/password to which the manager role is assigned to access the Tomcat Application Manager.

    If the Tomcat server is already running, it requires a re-start after the preceding configuration is done.

Configuring Tomcat to use JAVA 64 bit Executables

To configure Tomcat to use JAVA 64 bit, follow these steps:

  1. Navigate to the $CATALINA_HOME/bin folder.
  2. Edit the setclasspath.sh file as follows:

    Replace the following block of text

# Set standard commands for invoking Java.
_RUNJAVA="$JRE_HOME"/bin/java if [ "$os400" != "true" ]; then
_RUNJDB="$JAVA_HOME"/bin/jdb

With:

# Set standard commands for invoking Java.
_RUNJAVA="$JAVA_BIN"/java
if [ "$os400" != "true" ]; then
_RUNJDB="$JAVA_BIN"/jdb
If the Tomcat server is already running, it requires a re-start after the above configuration is done.

Note:

In case tomcat is installed under different Unix profile, set JAVA_ BIN environment variable in .profile to include the Java Runtime Environment absolute path.

Note:

For example: 
export JAVA_BIN /usr/java6_64/jre/bin
export JAVA_BIN = /usr/java6_64/jre/bin//sparcv9 for Solaris Sparc

Configure Servlet Port

The default servlet port configured for the Tomcat installation is 8080. Ignore this section if you must use the default port.

If you must use a different port number, you must first configure the port in the server.xml file in the conf directory of the Tomcat Installation directory.

To configure the Servlet Port, follow these steps:

  1. Navigate to $CATALINA_HOME/conf.
  2. Open server.xml and locate the tag: "Define a non-SSL HTTP/1.1 Connector on port 8080".

    Against this tag, a parameter is specified 'Connector port = "8080"'. Edit this value to the new port number that was used during the Infrastructure installation process.

  3. Save your changes in the server.xml file.

    Note:

    Make a note of the servlet port configured. This information is required during the installation of the OFSAA Application Pack.

Configure SSL Port

If you must configure and access your OFSAA setup for HTTPS access, ensure that the following connect tag under Define a SSL HTTP/1/1 Connector on port 8443 in the <Tomcat_installation_directory>/conf/server.xml file is uncommented for SSL Configuration. (By default, it is commented).
<Connectorport="8443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS"

Note:

  • Make a note of the servlet port configured. This information is required during the installation of the OFSAA Application Pack.
  • To enable https configuration on Infrastructure, assign value 1 to "HTTPS_ENABLE" in the OFSAAI_InstallConfig.xml file for SILENT mode OFSAAI installation.

For more information related to SSL Configuration on Tomcat, see Apache Tomcat.

Configure Apache Tomcat Memory Settings

To configure the Apache Tomcat Memory Settings, follow these steps:

  1. Locate the catalina.sh file that resides in the <CATALINA_HOME>/bin directory.
  2. Edit this file for customizing the memory settings and garbage collector settings depending on the available hardware configuration.
  3. Add the memory setting for Java Heap to -Xms512m -Xmx1024m.
    For example: 
    if [ -z "$LOGGING_MANAGER" ]; then JAVA_OPTS="$JAVA_OPTS -Xms512m -
Xmx1024m
-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager" else JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx1024m $LOGGING_MANAGER"

Configuring Axis API

To configure the Axis API, follow these steps:
  1. Copy the jaxrpc.jarfrom the <OFSAAInstallation Directory>/axis-1_ 4/webapps/axis/WEB-INF/ lib folder.
  2. Place the copied file in the <Tomcat Installation Directory>/lib folder.
  3. Restart the Tomcat Server.

Configure Tomcat for User Group Authorization and Data Mapping

Users with system authorization roles can access User Group Authorization. However, to make it available on the Tomcat web server, you must follow these configuration steps:

  1. Navigate to the $CATALINA_HOME/conf directory and open the web.xml file.
  2. Enter the following in the web.xml file.
    <init-param>
<param-name>mappedfile</param-name>
<param-value>false</param-value>
</init-param>
  3. Save and close the file.

Uninstall WAR Files in Tomcat

To uninstall WAR files in Tomcat, see the Uninstalling WAR Files in Tomcat section in Removing OFSAA.