Open the menu

    Apache Tomcat 9.0

    Este tópico descreve como o LumisXP deve ser instalado no servidor Apache Tomcat 9.0.

    Inicialmente, deve-se editar o arquivo server.xml, localizado na pasta “%CATALINA_HOME%/conf”, incluindo ou alterando as seguintes configurações nos elementos Connector que forem utilizados para acesso a aplicação:

    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.
    2. bindOnInit: Por padrão, o Tomcat começa a escutar novas conexões quando está iniciando, bloqueando-as até completar o boot da aplicação. Isto cria um enfileramento de conexões desnecessário nele, e é especialmente prejudicial em ambientes com múltiplos servidores, onde outro Tomcat poderia estar servindo a conexão que foi enfilerada caso o Tomcat não aceitasse a conexão e com isso o Load Balancer direcionasse a conexão para outro Tomcat. Para evitar que o Tomcat aceite conexões enquanto a aplicação ainda está iniciando, inclua este atributo com valor false.

    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:

      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 LumisXP. 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:

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

    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.