Case Tomcat

Manual_Instalacao_ERP

O Tomcat é um servidor WEB utilizado para instalar como serviços aplicativos da Touch Comp. Nele são instalados aplicativos como:

• Mentor WEB e webservices: Aplicativo WEB mais antigo, que atualmente possui o Touch Comp Access WEB e webservices. Está sendo migrado para o Touch Comp WEB abaixo.
• Touch Comp WEB (API/Front) e webservices: Aplicativo WEB relativo ao produto Touch Comp ERP, que está em desenvolvimento. Nele são disponibilizados também todos os serviços, integrações e webservices.

O Tomcat é instalado como serviço, e automaticamente é iniciado toda vez que o próprio computador é reiniciado. Tente instalar o Tomcat sempre no servidor para melhor proteção dos dados.

Para acesso externo, você deve configurar seu roteador para tal, consulte Manual_Instalacao_ERP seção Acesso Externo - WEB.

Instalação Windows

Para instalar no Windows, baixe o instalador em http://touchcomp.ddns.me:81/arquivos/programas/tomcat/.

Instale normalmente o Tomcat. Este instalador irá pré configurar o Tomcat, como serviço e alguns ajustes, já prontos para uso. As seções abaixo trazem detalhes das configurações caso deseje alterar.

Porta

O instalador irá instalar o Tomcat na porta 8081. Caso precise alterá-la, acesse o arquivo tomcat\conf\server.xml. Procure os dados abaixo, e altere a porta 8081 para a porta desejada:

<Connector port="8081" protocol="HTTP/1.1"
              connectionTimeout="20000"
              redirectPort="8443"
              maxParameterCount="1000"
              />
              

Memória

O Tomcat possui dois lugares para configurar o uso de memória. Verifique o tipo de excecução que está utilizando, e altere.

Serviço

Na maioria dos casos, o Tomcat será instalado como serviço. No caso do Windows, você poderá verificar e alterar as configurações de uso de memória, executando o arquivo \tomcat\bin\Tomcat9w.exe como administrador. Na aba "Java", ao final, haverá: "Initial Memory Pool" e "Maximum Memory Pool". Altere principalmente o parâmetro "Maximum...". Informe em megabytes, onde 4Gb de memória serão 4094MB. Posteriormente, reinicie o serviço para que as alterações tenham efeito.

Aplicação

Para alterar limites de memória, acesse o arquivo bin/catalina.bat e altere aproximadamente na linha 216:

set "JAVA_OPTS=%JAVA_OPTS% %JSSE_OPTS% -Xmx4g por exe -XX:MetaspaceSize=256M -XX:MaxMetaspaceSize=512m"

Para aumentar a memória, altere -Xmx4g por exemplo para -Xmx8g.

Usuários

Para alterar/adicionar usuários, altere o arquivo tomcat-users.xml.

Execução manual e Depurar

Para iniciar o Tomcat manualmente, abra o cmd/powershell, acesse a pasta bin do Tomcat e execute:

cd C:\touchcomp\tomcat\bin\
.\startup.bat

Se clicar 2 vezes neste arquivo, ele abrirá em modo de execução. Caso abra e feche rapidamente, será necessário executar conforme passo anterior.

Deploy de aplicações

Diferente do Wildfly, o Tomcat irá iniciar as aplicações conforme o nome dos arquivos WAR dentro da pasta webapps. Portanto, tenha certeza que os arquivos deverão ser colocados com os nomes:

touch-erp.war
touch-web.war

Desta forma, serão instalados os aplicativos WEB conforme o nome do arquivo:

http://localhost:8081/touch-erp
http://localhost:8081/touch-web

Problemas e Soluções

Tomcat não inicia

Caso apresente alguma mensagem de erro ao iniciar o Tomcat pelo serviço, deve verificar a seguinte configuração:

Abrir as configurações do arquivo Tomcat9w, o mesmo se encontra dentro da pasta bin. Na aba Java, marque a opção de Use Default e na aba Startup, opção Mode coloque JAVA. Posteriormente a inicialização pelo Serviço será realizada com sucesso. O arquivo Tomcat9w está dentro da pasta do Tomcat.