Você está na página 1de 20

MANUAL DE CONFIGURAO DO SERVIDOR

TOMCAT

Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

1 de 20

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/tomcat6/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
http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archivedownloads-javase6-419409.html.

link:

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
Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

2 de 20

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/<nome_usuario>, para que
<nome_usuario> represente o usurio que ser usado (dono da base) para se conectar a
esta base. A senha deve ser aloiskve.
Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

3 de 20

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
<Context>
<Resource name="jdbc/TASY" auth="Container"
type="javax.sql.DataSource"
driverClassName="oracle.jdbc.OracleDriver"
url="jdbc:oracle:thin:@<IP_BANCO>:<PORTA_BANCO>:<ALIAS_BANCO>"
username="tasy_versao/<NOME_USUARIO>"
password="aloiskve"
maxActive="-1"
maxIdle="-1"
maxWait="-1"/>

<Resource name="jdbc/WTASY" auth="Container"


type="javax.sql.DataSource"
driverClassName="oracle.jdbc.OracleDriver"
url="jdbc:oracle:thin:@<IP_BANCO>:<PORTA_BANCO>:<ALIAS_BANCO>"
username="tasy_versao/<NOME_USUARIO>"
password="aloiskve"
maxActive="-1"
maxIdle="-1"
maxWait="-1"/>
<Resource name="jdbc/TASY_INTEGRACAO" auth="Container"
type="javax.sql.DataSource"
driverClassName="oracle.jdbc.OracleDriver"
url="jdbc:oracle:thin:@<IP_BANCO>:<PORTA_BANCO>:<ALIAS_BANCO>"
username="tasy_versao/<NOME_USUARIO>"
password="aloiskve"
maxActive="-1"
maxIdle="-1"
maxWait="-1"/>
</Context>

3.2.2 Oracle RAC


<Context>
<Resource
name="jdbc/TASY"
auth="Container"
factory="org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory"
type="javax.sql.DataSource"
password="aloiskve"
driverClassName="oracle.jdbc.driver.OracleDriver"
maxIdle="-1"
maxWait="-1"
username="tasy_versao/<NOME_USUARIO>"
url="jdbc:oracle:thin:@(DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST =
<IP_BANCO_1>)(PORT = <PORTA_BANCO>))(ADDRESS = (PROTOCOL = TCP)(HOST =
<IP_BANCO_2>)(PORT = <PORTA_BANCO>))(LOAD_BALANCE = yes)(CONNECT_DATA
=(SERVER = DEDICATED) (SERVICE_NAME = <ALIAS_BANCO>)(FAILOVER_MODE =(TYPE =
SELECT)(METHOD = BASIC)(RETRIES = 180)(DELAY = 5))))"
Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

4 de 20

maxActive="-1"
removeAbandoneded="true"
removeAbandonedTimeout="300"
logAbandoned="true"
/>

<Resource
name="jdbc/WTASY"
auth="Container"
factory="org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory"
type="javax.sql.DataSource"
password="aloiskve"
driverClassName="oracle.jdbc.driver.OracleDriver"
maxIdle="-1"
maxWait="-1"
username="tasy_versao/<NOME_USUARIO>"
url="jdbc:oracle:thin:@(DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST =
<IP_BANCO_1>)(PORT = <PORTA_BANCO>))(ADDRESS = (PROTOCOL = TCP)(HOST =
<IP_BANCO_2>)(PORT = <PORTA_BANCO>))(LOAD_BALANCE = yes)(CONNECT_DATA
=(SERVER = DEDICATED) (SERVICE_NAME = <ALIAS_BANCO>)(FAILOVER_MODE =(TYPE
= SELECT)(METHOD = BASIC)(RETRIES = 180)(DELAY = 5))))"
maxActive="-1"
removeAbandoneded="true"
removeAbandonedTimeout="300"
logAbandoned="true"
/>
<Resource
name="jdbc/TASY_INTEGRACAO"
auth="Container"
factory="org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory"
type="javax.sql.DataSource"
password="aloiskve"
driverClassName="oracle.jdbc.driver.OracleDriver"
maxIdle="-1"
maxWait="-1"
username="tasy_versao/<NOME_USUARIO>"
url="jdbc:oracle:thin:@(DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST =
<IP_BANCO_1>)(PORT = <PORTA_BANCO>))(ADDRESS = (PROTOCOL = TCP)(HOST =
<IP_BANCO_2>)(PORT = <PORTA_BANCO>))(LOAD_BALANCE = yes)(CONNECT_DATA
=(SERVER = DEDICATED) (SERVICE_NAME = <ALIAS_BANCO>)(FAILOVER_MODE =(TYPE =
SELECT)(METHOD = BASIC)(RETRIES = 180)(DELAY = 5))))"
maxActive="-1"
removeAbandoneded="true"
removeAbandonedTimeout="300"
logAbandoned="true"
/>
</Context>

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
Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

5 de 20

=TCP)(HOST=<IP_BANCO_1>)(PORT=1521))(ADDRESS=(PROTOCOL=TCP)(HOST=<IP_BA
NCO_2>)(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:

Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

6 de 20

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

Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

7 de 20

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
Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

8 de 20

[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
Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

9 de 20

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:
<user username="USUARIO" password="SENHA" roles="philips-manager" />

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


linha:
<user username="USUARIO" password="SENHA" roles="manager-gui" />

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):
<user username="USUARIO" password="SENHA" roles="manager-gui,philips-manager" />

importante que estas linhas sejam adicionadas fora da regio de comentrios do arquivo
(no deve estar entre as TAG's <!-- e --> e antes da TAG de fechamento do arquivo
(</tomcat-users>).
Exemplo de arquivo tomcat-users.xml:
<?xml version='1.0' encoding='utf-8'?>
<!-Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at

-->
<tomcat-users>

<user username="administrador" password="P4$$w0rd" roles="manager-gui,philips-manager"/>

</tomcat-users>

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:
Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

10 de 20

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


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

Soluo

de

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:

Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

11 de 20

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://<IP_DO_SERVIDOR>:8080/ onde <IP_DO_SERVIDOR> 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.

Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

12 de 20

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:

String
String
String
String
String

link
titulo
endereco
email
tituloEmail

=
=
=
=
=

'ENDERECO_SITE_HOSPITAL';
' TITULO_SITE ';
' ENDERECO_DO_HOSPITAL '
' EMAIL_PARA_CONTATO';
' TITULO_EMAIL ';

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
Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

13 de 20

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.

Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

14 de 20

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:
<argument>-base</argument>
<argument>TASY</argument>
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

Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

15 de 20

-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)
Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

16 de 20

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

Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

17 de 20

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.
Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

18 de 20

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
Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

19 de 20

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-tomcat6.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\<modulo>\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

Reviso: 011

Data Alterao: 11/03/2015

CPIAS NO SO CONTROLADAS

20 de 20