IIS com JBoss

Para configurar o IIS como servidor web e o Tomcat como servidor de aplicação é necessário utilizar o conector de integração do Apache Tomcat Connector (JK). Esse conector deverá ser instalado no IIS e configurado para se comunicar com o servidor de aplicação utilizando o protocoloAJP.

Devido ao mecanismo de cache no Lumis Portal, o IIS deverá ser configurado para redirecionar o erro "404" para a URL /lumis/portal/error/404error.jsp pois esse arquivo pode ser um arquivo de cache que ainda não foi gerado ou que foi expirado.

Outras configurações de tuning também são necessárias para ambientes de produção. Não será abordado como realizar o tuning de comunicação entre o servidor web e o servidor de aplicação.

Para mais informações sobre o projeto JK consultar http://tomcat.apache.org/connectors-doc/index.html.

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

1. Download do arquivo isapi_redirect.dll de http://tomcat.apache.org/download-connectors.cgi;

2. Copiar o arquivo o isapi_redirect.dll para o diretório TOMCAT_HOME/Bin;

3. Criar o arquivo "workers.properties" na pasta TOMCAT_HOME/conf com o conteúdo:

4. Criar o arquivo "uriworkermap.properties" na pasta TOMCAT_HOME/conf com o conteúdo:

Qualquer outro servlet existente da solução deve ser mapeado no arquivo com extensão .properties.

Se a aplicação estiver em um contexto diferente da da raiz, configurar o arquivo da seguinte forma:

5. No registro do Windows, crie uma nova chave:

"HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0";

6. Adicionar uma nova entrada do tipo string com nome extension_uri e valor /jakarta/isapi_redirect.dll;

7. Adicionar uma nova entrada com nome worker_file e, como valor, o caminho "TOMCAT_HOME\conf\workers.properties" para o arquivo workers.properties;

8. Adicionar uma nova entrada com nome worker_mount_file e valor, o caminho "TOMCAT_HOME\conf\uriworkermap.properties" para o arquivo uriworkermap.properties;
 

9. No IIS, adicione um novo diretório virtual em seu website com nome jakarta com diretório onde se encontra o arquivo isapi_redirect.dll, por exemplo TOMCAT_HOME/Bin. O usuário do IIS necessita de direitos de permissão de execução nesse diretório;

10. No IIS, adicionar um novo filtro em seu website para o arquivo isapi_redirect.dll. O nome do filtro pode ser, por exemplo, Jakarta;
 

11. No IIS, configurar o error 404 para a URL /lumis/portal/error/404error.jsp. No caso da aplicação estiver em contexto diferente da raiz, configurar o error 404 para a URL /CONTEXTO/lumis/portal/error/404error.jsp;
 

12. Para IIS 6.0, é necessário configurar o filtro Jakarta Isapi Redirector como web Service Extensions:

a. Right-click on Web Service Extensions and choose Add a new Web Service Extension;

b. Enter tomcat for the Extension Name;

c. Add the isapi_redirect.dll to the required files;

d. Check the Set extension status to Allowed;

e. Click on OK;

13. Configurar o connector AJP no arquivo JBOSS_HOME\server\default\deploy\tomcat\server.xml;

Localizar o connector com o protocolo AJP/1.3 e adicionar as configurações:

URIEncoding="UTF-8", maxPostSize="2097152" e emptySessionPath="true"

As configurações acima são apenas exemplos, sendo necessário adequá-las as particularidades do ambiente.