Apache com JBoss

Para configurar o Apache como servidor web e o JBoss 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 </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 </VirtualHost>

3. Configurar o conector AJP na configuração do perfil sendo usado (normalmente será em um dos arquivos standalone.xml, domain.xml ou host.xml - para maiores informações consultar a documentação do JBoss):

   No caso do JBoss EAP 7, adicionar um conector ajp no subsystem jboss:domain:undertow, como exemplo a seguir:

   <subsystem xmlns="urn:jboss:domain:undertow:3.1"> ... <server name="default-server"> <http-listener name="default" socket-binding="http" redirect-socket="https"/> <ajp-listener name="ajp" socket-binding="ajp" /> ... </server> ... </subsystem>