Apache Tomcat 8.0 e 8.5

Este t�pico descreve como o Lumis Portal deve ser instalado no servidor Apache Tomcat 8.0 e 8.5.

Inicialmente, deve-se editar o arquivo server.xml, localizado na pasta �%CATALINA_HOME%/conf�, incluindo ou alterando as seguintes configura��es no elemento Connector:

1. maxPostSize: Por padr�o, o Tomcat aceita apenas 2MB de POST em formul�rios. Para aumentar esse limite deve-se incluir este atributo com o limite desejado em bytes.

   <Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443" maxThreads="60" enableLookups="false" maxPostSize="2097152" > </Connector>

Bibliotecas Compartilhadas

� preciso instalar algumas bibliotecas (arquivos . JAR) na �rea de bibliotecas compartilhadas no servidor de aplica��o.

No Tomcat, basta copiar os arquivos JAR, que est�o na pasta %LUMIS_HOME%/lib/shared, para a pasta %CATALINA_HOME%/lib.

Deployment

1. Alterar o arquivo "setup/Tomcat/portal.xml" para indicar o caminho correto da instala��o do produto: <Context path="/portal" docBase="C:/LumisPortal/www" crossContext="true">

   Onde:

   • Path: nome do contexto. O nome do arquivo tamb�m define o nome do contexto (portal.xml);
   • docBase: caminho onde est� instalada a pasta �www�;
   • crossContext: permite a utiliza��o de portlets padr�o JSR-168 no Lumis Portal. Estes s�o instalados no servidor de aplica��o em contextos separados.
2. Coloc�-lo no diret�rio de configura��o do Tomcat: �conf/Catalina/localhost�.

Configura��o do DataSource

� poss�vel configurar o Data Source, para delegar ao servidor de aplica��o, a ger�ncia do pool de conex�es com o banco de dados.

No server.xml ou no portal.xml a seguinte configura��o deve ser realizada:

<!-- For enabling the datasource in the Tomcat, add a tag similar to the example below inside the application's Context tag and put the jdbc driver JAR file inside tomcat/common/lib. If your JDBC driver does not support Connection.isValid method, must also be included in Resource the attribute validationQuery with a value that is a query that may be used to validate the connection. For example, for MS SQL Server could be used: validationQuery="select 1" More details and examples in http://tomcat.apache.org/tomcat-8.0-doc/jndi-datasource-examples-howto.html --> <Resource name="jdbc/portal" type="javax.sql.DataSource" maxTotal="100" maxIdle="30" maxWaitMillis="10000" auth="Container" driverClassName="my.database.Driver" url="jdbc:my:database:url" username="username" password="password" ></Resource>

J� no arquivo web.xml deve ser adicionado o seguinte fragmento:

<resource-ref> <description>Portal DataSource</description> <res-ref-name>jdbc/portal</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref>

Configura��o do Remote IP Valve

Esse valve do Apache Tomcat serve para possibilitar a correta integra��o do mesmo com servidores proxies (sejam os webservers, sejam outros proxies).
O valve � configurado dentro da defina��o do Host no server.xml.
Abaixo um exemplo de como um Remote IP Valve pode ser configurado.