OpenCms Documentation

Tomcat configuration

 Show GitHub edit links  Hide GitHub edit links
Documented since: 9.5 Latest revision for: 9.5 Valid for OpenCms: 11.0.2

We describe how to configure an AJP connector in Tomcat that is used to communicate with the Apache HTTP web server.

Creating an AJP connector

To make the Apache web server able to "talk to" Tomcat, an AJP connector has to be created.

Therefore, edit the file conf/server.xml in Tomcat's home directory and, if not already there, add an AJP connector as shown in the line below:

<Connector port="8009" enableLookups="false" redirectPort="8443" protocol="AJP/1.3" />

The connectors that are predefined by default, e.g., the connector for port 8080, should be removed or at least commented out.

To make the changes work, restart Tomcat.

Adjusting permissions

Since Tomcat 8.5 files written by Tomcat are not readable by "the world":

Tighten up the default file permissions for the .tar.gz distribution so no files or directories are world readable by default. Configure Tomcat to run with a default umask of 0027 which may be overridden by setting UMASK in  (Tomcat 8.5 change log)

To remedy the situation, use the suggested override option.

You can improve this page

Please contribute your suggestions or comments regarding this topic on our wiki. For support questions, please use the OpenCms mailing list or go for professional support.