manual de configuração do servidor tomcat

Reviso: 011 Data Alterao: 11/03/2015 1 de 20

CPIAS NO SO CONTROLADAS

MANUAL DE CONFIGURAO DO SERVIDOR TOMCAT



1. Objetivo Este documento visa definir e explicar o processo de configurao do servidor Apache

Tomcat, para que essa configurao permita o uso da aplicao Web da empresa.

2. Softwares Necessrios

2.1 Apache Tomcat Baixar e instalar o Apache Tomcat 6 pelo link http://tomcat.apache.org/download-60.cgi. OBS.: No usar verses 7 e 8 do Tomcat. 2.1.1 Requisitos obrigatrios

Para que a aplicao funcione corretamente, preste ateno s observaes:

a) Use Apache Tomcar verso 6, e no verses inferiores ou superiores. Recomendamos a

verso 6.0.41

b) No caso de ambientes GNU/LINUX, use verses compactadas (tar.gz). No use

aplicaes de instalaes via administradores (yum, yast, aptget etc), nem pacotes

compactados para verses especficas, como pacotes deb ou rpm. Este o link para baixar

a verso compacta: http://ftp.unicamp.br/pub/apache/tomcat/tomcat-

6/v6.0.41/bin/apache-tomcat-6.0.41.tar.gz.

c) Distribuies GNU/LINUX usadas devem ser Oracle Linux ou CentOS. No use

distribuies diretas ou as baseadas na famlia Debian. Nesse caso, ambientes em Debian,

Ubuntu e derivados devem ser removidos da validao.

2.2 Java 2.2.1 Servidor Tomcat para Integraes Para servidor Tomcat que vai usar a aplicao web Integraes (WhebServidorIntegracao),

Java 6 deve ser usado, com atualizao superior a 31 at 45. Recomendamos a verso

6u45. No use Java nas verses 7 ou 8.

Baixa o Java 6, atualizao 31 or superior, pelo link:

http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-

downloads-javase6-419409.html.

No use Java 7 ou 8 com a aplicao web WhebServidorIntegracao. Caso contrrio, a

aplicao no vai inicializar.

OBS.: Pode-se usar essa configurao Java para outras aplicaes web.

2.2.1.2 Restries quanto ao uso do projeto WhebServidorIntegracao

Use apenas um servidor de integrao (RESOURCE_TASY em Context.xml) para esquema

de instance ORACLE. Exemplo: instncia dbprod para Tasy deve ter apenas

WhebServidorIntegracao do servidor Tomcat, de IP 10.1.1.1 (hipoteticamente) apontando

para ele. No distribua dois servidores de aplicao Tomcat com o projeto

WhebServidorIntegracao

(10.1.1.1 e 10.1.1.2), separando a integrao NFE e seu cadastro apontando para um

desses IPS, e uma integrao HL7 apontando para outro IP. O servidor de integrao deve

ser nico para a base (produo, desenvolvimento, validao), e cada um deve ter o seu



em seus cadastros. 2.2.2 Servidor Tomcat para Outras Aplicaes

Nos servidores Tomcat que no usaro a aplicao WhebServidorIntegracao, possvel usar

o Java atualizado (verses 7 e 8) para obter mais performance. Essa personalizao se

aplica aos servidores cuja funo usar o Tasy Swing ou WebAplicativos. Se o objetivo

integrar, use Java 6.

OBS.: existe um tratamento para o uso de aplicaes Java Swing in verses superiores ao

Java 7u21. Esse tratamento nas aplicaes cujas verses so superiores a 1625. Antes de

tratar, configure os arquivos files tasy-acesso-interno.jnlp e tasy-acesso-externo.jnlp, de

acordo com o Manual de Configurao do JavaLoader.

Pverses anteriores do Java podem ser baixadas por: http://www.oracle.com/technetwork/java/archive-139210.html

Se desejar usar a verso mais recente do Java, use a URL:

http://www.oracle.com/technetwork/java/javase/downloads/index.html

OBS.: a verso 7 validada at atualizao 21; verses subsequentes data de reviso

deste manual no esto validadas.

Version 7 is validated until update 21; versions subsequent to this guide review date are not

validated. 3. Configuraes Gerais

Tomcat instalado no diretrio $CATALINA.

3.1 Configurar conexo com banco de dados

Apache Tomcat trabalha com o conceito de connections pool. Isso mantm algumas conexes abertar e, quando recebe uma solicitao, usa conexes j abertas, otimizando a

performance. Assim no preciso fazer uma nova conexo com o banco de dados a cada

solicitao recebida.

A configurao com o banco de dados ser feito pelo arquivo de configurao Tomcat. Nele,

informaes como usurio, senha e url de conexo base sero armazenados.

Para garantir a segurana, possvel configurar o usurio TASY_VERSAO nesses arquivos.

Ento a senha do usurio principal criptografada numa tabela do usurio TASY_VERSAO, e

s pode ser descriptografada por aplicaes Web. Isso tambm usado em Tasy para

desktop.

Para configurar o acceso ao banco de dados, altere o arquivo CONTEXT.XML, localizado em

$CATALINA\CONF.

Trs alias de conexo com o banco devem ser configurados:

jdbc/Tasy

jdbc/WTASY

jdbc/TASY_INTEGRACAO

3.2 Configurao do arquivo context.xml

No campo username, configure tasy_versao/, para que represente o usurio que ser usado (dono da base) para se conectar a

esta base. A senha deve ser aloiskve.



preciso que o banco de dados esteja de acordo com o Manual de Configurao do Banco

de Dados para que o Tomcat funcione corretamente. No caso de autentificao usando o

usurio TASY_VERSAO, atente para a criao da tabela TASY_SEG no usurio

TASY_VERSAO, de acordo com o item 4 Usurio de Acesso ao Sistema, do manual citado.

H duas formas de configurar o arquivo context.xml: Oracle Individual ou Oracle RAC. H

uma explicao sobre como proceder nos dois casos:

3.2.1 Oracle Individual

3.2.2 Oracle RAC



maxActive="-1" removeAbandoneded="true" removeAbandonedTimeout="300"

logAbandoned="true"

/>

OBS.: No ambiente RAC usando recursos de RAC SCAN, mude a configurao para Oracle Individual. 3.2.2.1 Tratando erros de conexo com ORACLE RAC 10g em datasource: Ao usar ORACLE RAC 10g e muitas mensagens de erro aparecerem, como:

org.apache.tomcat.dbcp.dbcp.SQLNestedException: Cannot create

PoolableConnectionFactory (Erro de ES: The Network Adapter could not establish the

connection)

Crie a URL do datasource no formato:

url="jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL



=TCP)(HOST=)(PORT=1521))(ADDRESS=(PROTOCOL=TCP)(HOST=)(PORT=1521))(FAILOVER=on)(LOAD_BALANCE=off)(CONNECT_DATA=(SERVICE_

NAME=serv_dbprod)))"

3.3 Configurao do Uso da Memria 3.3.1 Servidores Windows

Pode-se configurar o uso da memria pela tela de inicializao do Tomcat (tomcat6w.exe), como mostrado na figura a seguir, apenas mudadndo a quantidade de

memria usada:

Initial memory pool: normalmente da memria disponvel no servidor.

Maximum memory pool: normalmente da memria disponvel no servidor.

Permanent Memory: adicionar s Opes Java a seguinte linha: -

XX:MaxPermSize=512m

Memory Garbage Collector execution format: -XX:+UseG1GC garantir resposta mais rpida do Garbage Collector em ambientes multiprocessados, melhorando

o tempo de resposta de telas e functes depoid de invocar o Garbage Collector.

OBS.: manter os valores de memria de acordo com a disponibilidade/necessidade do

servidor.

3.4. Servidores Linux

Nos ambientes Linux, siga os passos:

Acesse a pasta $CATALINA\bin

Crie o arquivo setenv.sh e edite-o para que tenha a seguinte forma:



JAVA_OPTS="-Xms128m -Xmx1024m -XX:MaxPermSize=512m -XX:+UseG1GC $JAVA_OPTS" export JAVA_OPTS

-XmsXXXm normalmente equivale a da memria disponvel no servidor.

-XmxXXXm normalmente equivale a da memria disponvel no servidor

OBS.: K manter os valores de memria de acordo com a disponibilidade/necessidade do

servidor

3.5 Configurao de Idioma

importante para evitar que caracteres estranhos apaream onde deveria haver caracteres

especiais, como palavras acentuadas.

obrigatrio que o ambiente (sistema operacional, Windows ou Linux) de suport esteja

configurado com Portugus Brasileiro com CHARSET ISO-8859-1, para que no haja

nenhum erro com valores monetrios, datas e gerao de relatrios com caracteres

especiais.

OBS.: Caso seja salvo algum registro no Banco de Dados com caracteres estranhos, ser necessrio realizar um update manual de cada registros, para normatizao dos dados. Esta

alterao deve ser realizada pelo DBA responsvel para ambiente do cliente.

3.5.1 Servidores Windows

O idioma deve ser configurado para que situaes em que as informaes na tela no

fiquem de forma desconfigurada, como apresentao das casas decimais de valores

numricos. Para isto, na tela de inicializao do Tomcat (tomcat6w.exe), deve ser

adicionado na aba Java, no campo Java Options, as seguintes linhas:

-Duser.language=pt

-Duser.region=BR



3.5.2 Servidores Linux

Acessar a pasta $CATALINA\bin

Editar o arquivo setenv.sh

Procurar pela linha JAVA_OPTS="-Xms128m -Xmx512m -XX:MaxPermSize=512m -

XX:+UseG1GC $JAVA_OPTS"

Alterar por JAVA_OPTS="-Duser.region=BR -Duser.language=pt -Xms128m -

Xmx1024m -XX:MaxPermSize=512m -XX:+UseG1GC $JAVA_OPTS" 3.6 Configurao de Recursos Grficos (Xserver) em Linux

A configurao deste recurso torna-se imprescindvel para exibio correta de vrios

relatrios do sistema TASY. Para configurar este item, devem-se seguir com ateno e por

completo os passos abaixo:

a. Habilitar initdefault (/etc/inittab) do Linux para level 5 (possuir servidor X com

GNOME pr-requisito para a soluo da Philips Clinical Informatics rodar

corretamente, nas distribuies homologadas(Oracle Linux e CentOS);

b. Adicionar/modificar as seguintes linhas ao arquivo em: /etc/gdm/custom.conf (para

permitir logon automtico, sem welcome screen para usuario de privilgios que no

oferecem risco ao ambiente, que o usurio comum tomcat na sesso GNOME).

[daemon] RemoteGreeter=/usr/libexec/gdmgreeter AutomaticLoginEnable=true AutomaticLogin=tomcat

[security] DisallowTCP=false AllowRemoteRoot=false [xdmcp] Enable=true [gui] AllowGtkThemeChange=false

[greeter] Include=tomcat



[chooser] [debug] [servers]

c. Criar o usurio tomcat e definir um password.

Comando: useradd tomcat

Aps este comando, usar o seguinte comando:

passwd tomcat (definir uma senha de sua preferncia por segurana);

d. Adicionar no /etc/profile a seguinte linha, ao final do arquivo: export DISPLAY=localhost:0

Tambm deve-se adicionar esta linha no incio do arquivo $CATALINA/bin/startup.sh

OBS.: Existem situaes em que o DISPLAY:0 pode estar sendo usado por outro

programa. Neste caso recomendamos a realizao de testes, alterando o display

de 0 para 1 ou 2.

e. Adicionar na home do usurio tomcat, permisso para usar a sesso no servidor X

por ele estabelecida apenas para a mquina local (este servidor) que deixa o

ambiente com bom nvel de segurana. Exemplo do caminho completo deste

arquivo: /home/tomcat/.bash_profile

Adicionar a seguinte linha ao final do arquivo mencionado acima: xhost +localhost

f. Aps este processo, o seu servidor de aplicao ter um servidor grfico para usar

em caso de necessidade de manifestar bibliotecas que envolvem desenho, que

somente so corretamente executadas quando o servidor grfico X do Linux est

executando com um desktop e uma sesso de usurio j estabelecida.

g. necessrio reiniciar o ambiente, conferir na console (monitor do servidor) se uma

sesso GNOME mnima (podem ocorrer pequenos alertas sobre ferramentas e

preferncias do perfil que podem ser tranquilamente ignorados (clicar em OK) e que

no comprometem o ambiente e a funcionalidade dos projetos que usam as

bibliotecas do servidor X. Esta configurao no expe o servidor a vulnerabilidades)

h. Aps validar que o autologin com usurio bsico funcionou e o servidor grfico foi

manifestado, confirmar com echo $DISPLAY em uma sesso SSH root.

Efetuar o seguinte comando para conferir:

echo $DISPLAY (o resultado deve ser localhost:0)

i. Faa um teste usando via SSH com root o comando: xclock

Verifique em seu console (monitor do servidor) se foi manifestado um relgio

grfico na sua sesso do servidor X

OBS.: Caso o comando xclock, no seja reconhecido como um comando vlido,

provvel que o mesmo no esteja instalado no sistema. Para isso rode o comando yum install xclock para instalao do pacote.

j. Com isso garantido, de um ctrl+c para abortar o xclock e inicie normalmente seu

servidor tomcat com root como de costume, e utilize os projetos que antes possuam

problemas de funcionamento, normalmente.

3.7 Configurao do Usurio Administrador do Tomcat

Para atualizaes de aplicativos pela Interface Web de Administrao do Tomcat e tambm

para testes de conexo com o Banco de Dados usando o aplicativo WhebServidor,

necessria a configurao do usurio Administrador do Tomcat, pois o Tasy possui um



mecanismo de segurana, via usurio e senha, para garantir que o acesso a interface do

WhebServidor seja realizado apenas por usurios autorizados.

Esta configurao realizada no arquivo $CATALINA_HOME\conf\tomcat-users.xml.

Para configurar o acesso ao WhebServidor, deve-se adicionar a seguinte linha ao arquivo:

Para acesso a Interface Web de Administrao do Tomcat, deve-se adicionar a seguinte

linha:

O usurio dever ser diferente do usurio de acesso ao WhebServidor.

Pode-se configurar os dois acessos na mesma linha, para ter o mesmo usurio e senha, da

seguinte forma (desta forma as linhas acima demonstradas no devero ser usadas):

importante que estas linhas sejam adicionadas fora da regio de comentrios do arquivo

(no deve estar entre as TAG's e antes da TAG de fechamento do arquivo ().

Exemplo de arquivo tomcat-users.xml:

3.8 Configuraes Adicionais em Servidores Windows

Em Servidores Windows, h a necessidade de realizar algumas configuraes extras,

algumas vezes dependendo das solues de Firewall e Anti-virus utilizadas.

J em Servidores GNU/Linux, outras configuraes deve ser realizadas para garantir a

comunicao e a resilincia da aplicao Tomcat. Para isso duas aes no necessrias:



Validar a necessidade de utilizao do Firewall nativo do sistema. Caso no hajam

tratativas para sua utilizao, recomendamos que o mesmo seja desabilitado.

Validar a necessidade da utilizao do SELinux, caso o mesmo no possua uma

finalidade especfica sugerimos que o mesmo tambm seja desabilitado.

3.8.1 Configuraes da Preveno de Execuo de Dados (DEP):

necessrio que a DEP esteja habilitada somente para programas e servios essenciais do

Windows. Esta configurao realizada nas Propriedades Avanadas do Sistema (Painel de

Controle > Sistema > Configuraes Avanadas do Sistema), Aba Avanado, boto de

Configuraes de Desempenho. Ser necessrio reiniciar o computador aps realizar esta

configurao.

3.8.2 Configuraes de Log On do Tomcat quando utilizada Soluo de

Firewall/Proxy Microsoft ISA Server, para autenticao do Proxy:

O Servio do Tomcat dever ser inicializado com um usurio que possua permisso de

acesso Internet, principalmente sites onde havero integraes (por exemplo: Nota Fiscal

Eletrnica, Bionexo, entre outros). Configurao realizada no Tomcat6w.exe:



3.8.3 Configuraes de Antivrus:

Algumas solues Antivrus podem interferir na comunicao correta do servio do Tomcat

com Integraes Externas (por exemplo: Nota Fiscal Eletrnica, Bionexo, entre outros), e

tambm podem interferir fortemente no desempenho de leitura/gravao dos arquivos dos

aplicativos Philips.

Sendo assim, possvel que seja necessrio excluir das verificaes de Antivrus o diretrio

onde encontra-se instalado o Tomcat, verificaes de conectividades de Rede do Servio do

Tomcat e tambm verificaes de arquivos com a extenso .WAR.

3.9 Testando a Configurao do Tomcat e do Java SE

Iniciar o Tomcat ($CATALINA\bin\tomcat6w.exe ou tomcat6.exe no Windows;

$CATALINA/bin/./startup.sh no Linux)

Acessar atravs do navegador o seguinte endereo (http://localhost:8080 ou

http://:8080/ onde o endereo IP do

servidor onde est instalado o Tomcat)

Verificar se a tela inicial do Tomcat foi inicializada e se no console/log no ocorreu

nenhum erro.

3.10 Instalando o Mdulo Servidor

Baixar da extranet a o arquivo WhebServidor.war da mesma verso da Base de

Dados do Tasy onde o Tomcat se conectar

Colar o arquivo WhebServidor.war no diretrio $CATALINA\webapps

Iniciar o Tomcat, acessar o endereo http://localhost:8080/WhebServidor e verificar

se o servio aparece com o status ATIVO, conforme tela abaixo.



3.11 Utilizao do recurso Endorsed

Para utilizar recursos como o TISS e Assinatura Digital do Tasy necessrio utilizar o

recurso nativo do Java chamado Endorsed, que consiste em adicionar bibliotecas

diretamente no Tomcat. Para utilizar este recurso necessrio:

Baixar da extranet o arquivo BibliotecasEndorsed.zip

Parar o tomcat caso o mesmo esteja ativo

Extrair os arquivos e colar na seguinte pasta $CATALINA\endorsed (ser necessrio

criar esta pasta endorsed) Iniciar novamente o Tomcat.

4. Configuraes para Projetos Web

4.1 Instalando o Mdulo Cliente

Foi definido como NomeDoModulo a aplicao correspondente a ser utilizada.

Baixar da extranet a verso atualizada do mdulo cliente. (NomeDoModulo.war)

Colar o arquivo NomeDoModulo.war no diretrio $CATALINA\webapps

Iniciar o Tomcat e acessar o endereo http://localhost:8080/NomeDoModulo

5. Alteraes Visuais no Mdulo Cliente

Alterar o logo da pgina inicial: substituir o logo.jpg em

$CATALINA\webapps\Wheb_Config\figuras pelo logo desejado. Tamanho do logo

ideal 300 (largura) X 60 (altura), no qual o logo deve ser renomeado para logo.jpg.

Alterar o arquivo $CATALINA\webapps\Wheb_Config\wheb_rodape.jsp conforme o

quadro a seguir:

Alterar o logo do do relatrio: substituir o logo_relatorio.jpg em

$CATALINA\webapps\Wheb_Config\figuras pelo logo desejado. Tamanho do logo

ideal 300 (largura) X 60 (altura), no qual o logo deve ser renomeado para

logo_relatorio.jpg.

5.1 Configuraes para Tasy em Java

5.2 Projetos Necessrios para o Servidor Tomcat

String link = 'ENDERECO_SITE_HOSPITAL';

String titulo = ' TITULO_SITE ';

String endereco = ' ENDERECO_DO_HOSPITAL '

String email = ' EMAIL_PARA_CONTATO';

String tituloEmail = ' TITULO_EMAIL ';



Para rodar o Tasy em Java, os seguintes projetos so necessrios para o seu

funcionamento:

Tasy.war;

WhebRepositorio.war;

WhebServidor.war.

O projeto Tasy responsvel por armazenar as configuraes do Tasy em Java.

O projeto WhebServidor responsvel por realizar as conexes com o banco e deve ser

atualizado a cada troca de verso.

O projeto WhebRepositorio responsvel por armazenar todos os arquivos do Tasy em

Java.

5.3 Atualizao dos Arquivos do Tomcat 5.3.1 Atualizao do Tasy.war Este arquivo deve ser descompactado somente uma vez, no sendo necessrio atualizar o

mesmo a cada atualizao de verso.

5.3.2 Atualizao do WhebServidor.War e WhebRepositorio.war

Para atualizar o WhebServidor, proceder conforme o Manual de Atualizao de Verso e

Servidores de Aplicao Java nos Clientes. Solicitar este arquivo ao Departamento de

Suporte da Philips Clinical Informatics.

5.4 Configurao dos Acessos ao Tasy em Java

Para que o Tasy em Java seja utilizado, alguns arquivos devem ser configurados em

$CATALINA/webapps/Tasy.

Existem dois arquivos: um para configurar acessos externos ao Tasy em Java, que sero

realizados pela Internet e outro para configurar acessos internos ao Tasy, realizados na

rede interna do estabelecimento.

Os arquivos so:

tasy-acesso-externo.jnlp;

tasy-acesso-interno.jnlp.

Os arquivos possuem uma estrutura igual a da imagem abaixo. As partes mais claras, so

as que podem e devem ser configuradas.



Nas linhas nmeros 2 e 16, configura-se o IP do servidor onde est localizado servidor

Tomcat. Caso seja acesso interno, deve ser informado o IP (Internet Protocol) da rede. Caso

contrrio, o IP externo ao servidor.

Nas linhas 4 a 7, podem ser configuradas informaes a respeito do estabelecimento.

Nas linhas 22 a 32, podem ser configurados os parmetros do Tasy em Java. Abaixo do

argumento deve ser informado o IP do servidor, igual nas linhas 2 e 16. Abaixo do

argumento - base podem ser configuradas as bases que aparecero ao usurio.

Estes valores devem ser passados caso possua mais de uma base. Caso contrrio, podem

ser removidos. As bases so configuradas de acordo com os Resources do arquivo

Context.xml (vide item 3.2 deste manual) Exemplo:

-base

TASY

OBS.: A Philips recomenda que cada servidor instalado tenha apenas uma base configurada.

Verificar item 8.

Relao de parmetros que pode ser configurados no arquivo .jnlp:

Parmetro Valor Descrio

-ip IP_SERVIDOR[:PORTA] Informar o IP e Porta do

Servidor Tomcat

-base BASE1 BASE2 Nome dos resources configurados no Tomcat

-debug 0| 1 | 2 | 3 | 4 Deve ser configurado somente

em casos realmente

necessrios



-useTempFolder Nenhum valor deve ser

informado

Indica que a pasta .tasy deve ser criada na pasta

'%TEMP%' do usurio atual

Estas configuraes devem ser feitas para os dois arquivos.

Estes arquivos precisam ser configurados somente uma vez. 5.5 Localizao dos Arquivos de Logo de Relatrios e Tela Inicial do Sistema

Os arquivos de Logo para Relatrios ficam localizados no Web Aplicativo Tasy, subpasta

figuras:

$CATALINA\webapps\Tasy\figuras\

O arquivo de Logo para a Tela Inicial do Sistema o seguinte arquivo:

$CATALINA\webapps\Tasy\logo-tasy-swing.jpg 6. Backup das Configuraes do Tomcat

Caso desejar-se realizar Backup dos arquivos de configurao do Tomcat, devem ser

salvaguardados os seguintes arquivos/caminhos:

$CATALINA\conf\context.xml

$CATALINA\conf\tomcat-users.xml

$CATALINA\webapps\Tasy (a pasta inteira)

$CATALINA\webapps\Wheb_Config (a pasta inteira)

$CATALINA/bin/setenv.sh (apenas Linux)

Os demais arquivos sero recuperados com a instalao padro do Tomcat e com os Web

Aplicativos da verso correta, baixados da Extranet Philips. 7. Atualizao dos Web Aplicativos

Para realizar a atualizao dos web aplicativos, pode-se proceder de duas formas:

7.1 Atualizao Off-line

Para este tipo de atualizao dos aplicativos, ser necessrio seguir os seguintes passos

nesta ordem:

Parar o servio do Tomcat;

Limpar (excluir) o contedo da pasta $CATALINA\logs;

Limpar (excluir) o contedo da pasta $CATALINA\work;

Limpar (excluir) o contedo da pasta $CATALINA\temp;

Limpar (excluir) o contedo da pasta $CATALINA\conf\Catalina;

Excluir todos os arquivos .WAR existentes na pasta $CATALINA\webapps; Excluir as pastas completas dos aplicativos que sero atualizados, em

$CATALINA\webapps. Porm apenas os aplicativos que sero atualizados;

Copiar os novos arquivos .WAR, dos aplicativos a serem atualizados, na pasta $CATALINA\webapps;

Iniciar novamente o servio do Tomcat;

Aguardar fim da inicializao do Servio e dos Web Aplicativos;

Realizar testes aps atualizao.

OBS.: Deve-se ter muito cuidado para no excluir diretrios importantes de configurao ou

manuteno do Tomcat. Sendo assim ateno para no excluir os seguintes diretrios:

- Wheb_Config (Contm customizaes dos clientes)

- Tasy (No necessrio atualizar)



- ROOT (Manager do Tomcat)

- MultiMED (No necessrio atualizar).

7.2 Atualizao On-line

Para este tipo de atualizao dos aplicativos, ser necessrio ter configurado corretamente

o Usurio Administrador do Tomcat, conforme item 3.7 deste manual.

Acessar, via browser, a Administrao do Tomcat:

(http://127.0.0.1:8080/manager/html)

Realizar o Undeploy de todos os Web Aplicativos a serem atualizados, conforme tela de

exemplo a seguir:



Selecionar o arquivo a ser realizado Deploy e usar o boto Deploy, conforme tela de

exemplo a seguir:

O processo de Deploy deve ser realizado para todos os aplicativos a serem atualizados,

lembrando de sempre realizar o Undeploy do aplicativo antes do deploy. Somente possvel

realizar o Deploy de 1 aplicativo por vez.

OBS.: No realizar deploy dos seguintes aplicativos:

- / - Tasy - MultiMED - host-manager - manager - wheb_config

Lembrando tambm que no deve ser parado o servio do Tomcat para realizar este

processo. 8. Tomcat para Bases Diferentes da Produo

A Philips recomenda que para cada base exista um Tomcat. Com isso, possvel que sejam

realizados testes separadamente em builds diferentes, atualizao de parmetros ou

objetos e testes de atualizao do sistema. Todas estas aes interferem diretamente nas

outras bases que esto configuradas no Tomcat. Entretanto, para cada servidor novo,

necessrio realizar uma nova configurao, conforme este manual.

Quando se tem uma base de produo separada das demais, possvel agilizar o

atendimento ao cliente, pois so apresentados os ajustes dos problemas encontrados, assim

como prever alguns itens que possam ocorrer ao trocar um Build ou realizar uma

atualizao. Essa prtica tambm aumenta a segurana e a estabilidade do sistema sendo

possvel testar as verses, identificando possveis riscos e impactos de cada verso e/ou

ao realizada, trazendo mais comodidade ao cliente.



Com esta prtica podemos ter o seguinte cenrio:

Servidor 1 onde a base de produo est instalada, este no alterado.

Servidor 2 onde existe um novo Tomcat instalado para uma base que possa receber

testes e poder ser alterada da forma que for necessria para elencar melhorias,

problemas.

Caso seja necessrio configurar mais de uma base (recomendado pela Philips):

Servidor 3 onde ser configurado uma base de teste diferente da base do servidor 2,

permitindo testes diferentes e montagem do cenrio desejado pelo cliente.

9. Possveis Erros

9.1 Recurso De Paginao Em Relatrios No Funciona Em Tomcat Linux

Caso o cliente visualize o erro java.lang.NoClassDefFoundError: sun/awt/X11GraphicsEnvironment nos arquivos de sada padro do Tomcat no diretrio logs, significa que recursos grficos do sistema operacional Linux no esto instanciados.

Para que estes recursos sejam ativados, faz-se necessrio manter o seu Linux em modo

runlevel 5, com o servidor grfico X devidamente configurado. Junto com este

procedimento, necessrio configurar no arquivo startup.sh do Tomcat em Linux a varivel

Para correo deve-se proceder conforme item: Configurao de recursos grficos (Xserver)

em Linux.

9.2 Travamento do Tomcat

Se estiver ocorrendo travamento do servidor de aplicao, verificar a existncia do mdulo

WhebServidorIntegracao. Caso existir o mesmo, deve-se verificar se foi configurado o

acesso o banco de dados jdbc/TASY_INTEGRACAO conforme item Configurar a Conexo

com o Banco de Dados.

9.3 Tomcat Simplesmente no Inicializa

Caso ao tentar inicializar o Tomcat, o mesmo permanea inicializando, necessrio verificar

as configuraes de memria. O valor de memria inicial deve ser obrigatoriamente, menor

que o valor de memria mxima. Caso esteja utilizando o Java SE de 32 bits, a soma dos

parmetros de memria mxima (-Xmx no Linux) com Memria Permanente (-

XX:MaxPermSize), no pode ultrapassar 1536m. Caso seja necessrio configurar mais que

1536m de memria total para o Tomcat, deve-se utilizar Tomcat e Java SE de 64 Bits.

9.4 Defeito de java.lang.OutOfMemoryError: PermGen space no Log do Tomcat

O parmetro de Memria Permanente (-XX:MaxPermSize), no foi configurado ou precisa

ser ampliado. Normalmente de 512m a 2G atendem as necessidades de nossos aplicativos.

9.5 Problema ao Enviar E-mail (erro 500 SMTP)

O hostname da mquina deve ser o mesmo contido nos arquivos /etc/hosts no caso de

sistemas operacionais Linux.

Ex.: $HOSTNAME=linux01.localdomain

No arquivo /etc/hosts deve conter:

127.0.0.1 linux01.localdomain localhost

9.5 Apache Tomcat no Gera Logs



Em ambientes Windows, podemos encontrar situao em que o Tomcat no gera logs. Isso

pode ser resultado de um download corrompido ou de alguma verso no compatvel. Para

soluo do embase, recomendamos a desinstalao do Tomcat e a reinstalao do mesmo,

utilizando o executvel do link abaixo:

(http://ftp.unicamp.br/pub/apache/tomcat/tomcat-6/v6.0.41/bin/apache-tomcat-6.0.41.exe)

9.5 WhebServidorIntegracao no inicia

Verificar se a verso do Java instalado no ambiente esta na verso 6. Uma vez que as

verses 7 e 8 do Java, no atendem as requisitos do aplicativo.

9.6 Demais Situaes

Abrir uma OS para a Philips Clinical Informatics, enviando uma imagem da tela onde

apresenta o erro;

Anexar Ordem de Servio, o arquivo de erro gerado no diretrio em

$CATALINA\webapps\\temp.

Logs do Tomcat;

Context.xml

Setenv.sh(Caso servidor Linux)

Saida do comando rpm-qa Verso do Apache Tomcat e Java

Verso do Sistema Operacional e arquitetura

manual de configuração do servidor tomcat

Documents