Apache com Tomcat

Para configurar o Apache HTTPD como servidor web e o Tomcat como servidor de aplicação é necessário utilizar os módulos mod_proxy, mod_proxy_ajp, mod_proxy_wstunnel, mod_headers, mod_include e mod_rewrite incluídos com o Apache.

Devido à funcionalidade de cache do LumisXP, o apache deverá ser configurado para verificar se existe localmente um arquivo estático a ser servido. Caso esse arquivo não exista, a requisição deverá ser delegada para o servidor de aplicação, mesmo se a requisição tenha sido realizada para um arquivo estático, pois esse arquivo pode ser um arquivo de cache que ainda não foi gerado ou que foi expirado.

Outras configurações avançadas para fins de otimização também são recomendadas para ambientes de produção. Não será abordado como realizar a otimização da comunicação entre o servidor de web e o servidor de aplicação.

Para mais informações sobre os módulos mod_filter, mod_headers, mod_include, mod_proxy, mod_proxy_ajp, mod_proxy_wstunnel e mod_rewrite, consulte a documentação correspondente do Apache.

Segue o passo a passo necessário para realizar a configuração:

1. Editar o arquivo APACHE_HOME/conf/httpd.conf habilitando os módulos mod_filter, mod_headers, mod_include, mod_proxy, mod_proxy_ajp, mod_proxy_wstunnel e mod_rewrite, caso ainda não estejam habilitados:

   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. Configurar o virtual host, por exemplo, no arquivo 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=SUA_SENHA_AJP </VirtualHost>

   Caso o contexto de sua aplicação não esteja na raiz, por exemplo, em /portal, será necessário configurar o virtual host da seguinte forma:

   <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=SUA_SENHA_AJP </VirtualHost>

3. Configurar o connector AJP no arquivo TOMCAT_HOME\conf\server.xml;

   Localizar o connector com o protocolo AJP/1.3 e adicionar as configuraçõesURIEncoding, maxPostSize, emptySessionPath, secretRequired e secret:

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

   O conector AJP por padrão faz bind no endereço de loopback. Se o Apache HTTPD não estiver rodando na mesma máquina, é necessário acrescentar no Connector o atributo address com o endereço de bind desejado, como por exemplo: address="0.0.0.0".