Apache with Tomcat

To configure Apache HTTPD as a web server and Tomcat as an application server, it is necessary to use the modules mod_proxy, mod_proxy_ajp, mod_proxy_wstunnel, mod_headers, mod_include, and mod_rewrite included with Apache.

Due to the cache functionality of LumisXP, apache must be configured to check if there is a static file to be served locally. If this file does not exist, the request should be delegated to the application server, even if the request was made for a static file, as this file may be a cache file that has not yet been generated or has expired.

Other advanced configurations for optimization purposes are also recommended for production environments. This guide will not cover how to optimize communication between the web server and the application server.

For more information on the mod_filter, mod_headers, mod_include, mod_proxy, mod_proxy_ajp, mod_proxy_wstunnel, and mod_rewrite modules, refer to the corresponding Apache documentation.

Here are the necessary steps to perform the configuration:

1. Edit the file APACHE_HOME/conf/httpd.conf enabling the modules mod_filter, mod_headers, mod_include, mod_proxy, mod_proxy_ajp, mod_proxy_wstunnel, and mod_rewrite if they are not already enabled:

   LoadModule filter_module modules/mod_filter.so LoadModule headers_module modules/mod_headers.so LoadModule include_module modules/mod_include.so LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_ajp_module modules/mod_proxy_ajp.so LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so LoadModule rewrite_module modules/mod_rewrite.so

2. Configure the virtual host, for example, in the file APACHE_HOME/conf/httpd.conf:

   <VirtualHost *> DocumentRoot "WEB_ROOT_PATH" DirectoryIndex index.htm <Directory WEB_ROOT_PATH> Require all granted </Directory> # enable SSI for text/html Options +IncludesNOEXEC AddType text/html .htm .html .shtm .shtml AddOutputFilterByType INCLUDES text/html RewriteEngine on # respond 404 to any request containing multiple / in the path RewriteCond %{THE_REQUEST} ^[^?]*// RewriteRule ^ - [L,R=404] RewriteCond %{REQUEST_FILENAME} !^.*\.wslumis$ RewriteCond %{HTTP:Connection} ^.*upgrade.* [NC] RewriteRule ^(.*) $1.wslumis [PT,env=X-lumWebServer:true] RewriteCond %{HTTP:Connection} !^.*upgrade.* [NC] RewriteCond %{REQUEST_FILENAME} !^.*\.jsp$ RewriteCond %{REQUEST_FILENAME} !^.*\.lumis$ RewriteCond %{REQUEST_FILENAME} ^/(.*) RewriteCond WEB_ROOT_PATH/%1 !-f RewriteCond WEB_ROOT_PATH/%1/index.htm !-f RewriteRule ^(.*) $1.lumis [PT,env=X-lumWebServer:true] RequestHeader set X-lumWebServer "apache" env=X-lumWebServer Header set X-UA-Compatible "IE=edge" env=!X-lumWebServer ProxyPreserveHost On ProxyPassMatch ^/(.*)\.wslumis$ ws://localhost:8080/$1 ProxyPassMatch ^/(.*\.(?:jsp|lumis))$ ajp://localhost:8009/$1 secret=YOUR_AJP_PASSWORD </VirtualHost>

   If your application context is not at the root, for example at /portal, you will need to configure the virtual host as follows:

   <VirtualHost *> Alias /portal "WEB_ROOT_PATH" DirectoryIndex index.htm RedirectMatch permanent ^/portal$ /portal/ <Directory WEB_ROOT_PATH> Require all granted </Directory> # enable SSI for text/html Options +IncludesNOEXEC AddType text/html .htm .html .shtm .shtml AddOutputFilterByType INCLUDES text/html RewriteEngine on # respond 404 to any request containing multiple / in the path RewriteCond %{THE_REQUEST} ^[^?]*// RewriteRule ^ - [L,R=404] RewriteCond %{REQUEST_FILENAME} !^.*\.wslumis$ RewriteCond %{HTTP:Connection} ^.*upgrade.* [NC] RewriteRule ^(.*) $1.wslumis [PT,env=X-lumWebServer:true] RewriteCond %{HTTP:Connection} !^.*upgrade.* [NC] RewriteCond %{REQUEST_FILENAME} !^.*\.jsp$ RewriteCond %{REQUEST_FILENAME} !^.*\.lumis$ RewriteCond %{REQUEST_FILENAME} ^/portal/(.*) RewriteCond WEB_ROOT_PATH/%1 !-f RewriteCond WEB_ROOT_PATH/%1/index.htm !-f RewriteRule ^(.*) $1.lumis [PT,env=X-lumWebServer:true] RequestHeader set X-lumWebServer "apache" env=X-lumWebServer Header set X-UA-Compatible "IE=edge" env=!X-lumWebServer ProxyPreserveHost On ProxyPassMatch ^/(.*)\.wslumis$ ws://localhost:8080/$1 ProxyPassMatch ^/portal/(.*\.(?:jsp|lumis))$ ajp://localhost:8009/portal/$1 secret=YOUR_AJP_PASSWORD </VirtualHost>

3. Configure the AJP connector in the file TOMCAT_HOME\conf\server.xml;

   Locate the connector with the AJP/1.3 protocol and add the configurations URIEncoding, maxPostSize, emptySessionPath, secretRequired, and secret:

   <Connector port="8009" enableLookups="false" redirectPort="8443" protocol="AJP/1.3" URIEncoding="UTF-8" maxPostSize="2097152" bindOnInit="false" emptySessionPath="true" secretRequired="true" secret="YOUR_AJP_PASSWORD" </Connector>

   The AJP connector by default binds to the loopback address. If the Apache HTTPD is not running on the same machine, it is necessary to add the address attribute to the Connector with the desired bind address, such as: address="0.0.0.0".