Configuring and tuning Apache Tomcat

In general, Tomcat is well configured by default with a Jazz installation. There are very few things for you to consider for changes.

Location of Configuration Files

The main files for configuring Tomcat can be found in the server-install-dir/server/Tomcat/conf directory.

• server.xml is the main configuration file. You can configure the server ports and passwords in the file.
• tomcat-users.xml is the file containing the user registry, if Tomcat is not configured for using LDAP.

Some configuration can also be done in the server.startup.bat or server.startup.sh file in the folder server-install-dir/server.

Configuring the Server Ports

A Tomcat server uses several ports for communication. You should consider the ports that are configured for the following reasons:

* By default, Tomcat is configured to use the port 9443 for HTTPS communication. Since this is not the well known port for HTTPS, using this port requires that the port is always entered in the public URI.

* If you want to run several Tomcat servers on one machine, there will be conflicting ports because all servers try to reserve the same port for listening.

The server-install-dir /server/Tomcat/conf/server.xml file configures the ports that Tomcat uses for communication. Search in the file for port= to find the port configurations. Some entries might be commented out and you can ignore those entries. All other entries are active and you might want or need to change them if you want to run several Tomcat servers on one machine.

The SSL HTTP/1.1 Connector for Tomcat is configured to use port 9443. You can change this port. For example, to use the well known port 443, change the value from port="9443" to port="443". If you change the SSL port, make sure to also change all redirectPort entries to the new SSL port. For example the AJP 1.3 Connector and the non SSL HTTP/1.1 Connector redirect to the SSL port and need to be changed.

The non SSL HTTP/1.1 Connector for Tomcat is configured to use port 9080. You can change the port in the configuration file if so desired or to avoid conflicts.

The AJP 1.3 Connector can conflict with another Tomcat instance and needs to be changed for one of the instances.

The Server Shutdown port is configured to 9005 by default. Make sure to use different ports if you run several Tomcat servers on one machine.

Configuring the Server Certificate

The SSL HTTP/1.1 Connector configuration section also specifies the certificate keystoreFile and =keystorePass=word. Configure these entries to a self signed or an official company certificate. See the help topic Configuring security certificates for more information.

Configuring the Shutdown Password

Check the current documentation for Tomcat to learn how to set a secure server shutdown password.

Configuring the Server Locale

The Tomcat server locale is determined by the environment. The locale sets the language the server uses to communicate feeds and other events. You can force the server locale to English in the server-install-dir/server/server.shotdown script. It is either a .bat or a .sh file. To force a specific locale, add an entry at the end of the section setting the JAVA_OPTS options. For example, to set the locale to English, add the following line to the configuration file:

set JAVA_OPTS=%JAVA_OPTS% -Duser.language=en

Configuring the Java Virtual Machine (JVM) settings

These settings have a large impact on the performance of your Jazz Team Server applications. Track the settings as part of your solution architecture description. Often, it is best to start with the defaults suggested by the development team.

Special JVM flags for Oracle Java Runtime Environment 6.0, or JDK's at versions before 1.6 (CLM version 4.0.4 and later)

-XX:+UnlockDiagnosticVMOptions
-XX:+UnsyncloadClass

Related topics: Deployment Web Home, Deployment Web Home

External links:

• Infocenter: Configure Tomcat as a Windows Service

Additional contributors: None