MANUAL DE CONFIGURAÇÃO DO SERVIDORTOMCAT Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 1 de 20 1. Objetivo Este documento visa definir e explicar o processo de configuração do servidor Apache Tomcat, para que essa configuração permita o uso da aplicação Web da empresa. 2. Softwares Necessários 2.1 Apache Tomcat Baixar e instalar o Apache Tomcat 6 pelo link http://tomcat.apache.org/download-60.cgi. OBS.: Não usar versões 7 e 8 do Tomcat. 2.1.1 Requisitos obrigatórios Para que a aplicação funcione corretamente, preste atenção às observações: a) Use Apache Tomcar versão 6, e não versões inferiores ou superiores. Recomendamos a versão 6.0.41 b) No caso de ambientes GNU/LINUX, use versões compactadas (tar.gz). Não use aplicações de instalações via administradores (yum, yast, aptget etc), nem pacotes compactados para versões específicas, como pacotes deb ou rpm. Este é o link para baixar a versão compacta: http://ftp.unicamp.br/pub/apache/tomcat/tomcat6/v6.0.41/bin/apache-tomcat-6.0.41.tar.gz. c) Distribuições GNU/LINUX usadas devem ser Oracle Linux ou CentOS. Não use distribuições diretas ou as baseadas na família Debian. Nesse caso, ambientes em Debian, Ubuntu e derivados devem ser removidos da validação. 2.2 Java 2.2.1 Servidor Tomcat para Integrações Para servidor Tomcat que vai usar a aplicação web Integrações (WhebServidorIntegracao), Java 6 deve ser usado, com atualização superior a 31 até 45. Recomendamos a versão 6u45. Não use Java nas versões 7 ou 8. Baixa o Java 6, atualização 31 or superior, pelo http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archivedownloads-javase6-419409.html. link: Não use Java 7 ou 8 com a aplicação web WhebServidorIntegracao. Caso contrário, a aplicação não vai inicializar. OBS.: Pode-se usar essa configuração Java para outras aplicações web. 2.2.1.2 Restrições quanto ao uso do projeto WhebServidorIntegracao Use apenas um servidor de integração (RESOURCE_TASY em Context.xml) para esquema de instance ORACLE. Exemplo: instância dbprod para Tasy deve ter apenas WhebServidorIntegracao do servidor Tomcat, de IP 10.1.1.1 (hipoteticamente) apontando para ele. Não distribua dois servidores de aplicação Tomcat com o projeto WhebServidorIntegracao (10.1.1.1 e 10.1.1.2), separando a integração NFE e seu cadastro apontando para um desses IPS, e uma integração HL7 apontando para outro IP. O servidor de integração deve ser único para a base (produção, desenvolvimento, validação), e cada um deve ter o seu Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 2 de 20 para que <nome_usuario> represente o usuário que será usado (dono da base) para se conectar a esta base. Antes de tratar. Nele. Para garantir a segurança. Três alias de conexão com o banco devem ser configurados: jdbc/Tasy jdbc/WTASY jdbc/TASY_INTEGRACAO 3. Esse tratamento é nas aplicações cujas versões são superiores a 1625. localizado em $CATALINA\CONF. versões subsequentes à data de revisão deste manual não estão validadas.com/technetwork/java/javase/downloads/index. 3.oracle.2.2 Servidor Tomcat para Outras Aplicações Nos servidores Tomcat que não usarão a aplicação WhebServidorIntegracao. Isso também é usado em Tasy para desktop.: existe um tratamento para o uso de aplicações Java Swing in versões superiores ao Java 7u21.: a versão 7 é validada até atualização 21. Version 7 is validated until update 21. otimizando a performance.com/technetwork/java/archive-139210.html OBS.jnlp e tasy-acesso-externo. 3. versions subsequent to this guide review date are not validated. 2. quando recebe uma solicitação. A senha deve ser “aloiskve”. configure “tasy_versao/<nome_usuario>”. configure os arquivos files tasy-acesso-interno. e só pode ser descriptografada por aplicações Web. Se o objetivo é integrar.jnlp. altere o arquivo CONTEXT. Assim não é preciso fazer uma nova conexão com o banco de dados a cada solicitação recebida. é possível configurar o usuário TASY_VERSAO nesses arquivos. é possível usar o Java atualizado (versões 7 e 8) para obter mais performance. OBS. de acordo com o Manual de Configuração do JavaLoader.2 Configuração do arquivo context. use a URL: http://www. senha e url de conexão à base serão armazenados.1 Configurar conexão com banco de dados Apache Tomcat trabalha com o conceito de “connections pool”.html Se desejar usar a versão mais recente do Java. Essa personalização se aplica aos servidores cuja função é usar o Tasy Swing ou WebAplicativos.em seus cadastros. Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 3 de 20 . usa conexões já abertas.xml No campo username. Para configurar o acceso ao banco de dados. use Java 6.oracle. A configuração com o banco de dados será feito pelo arquivo de configuração Tomcat. Então a senha do usuário principal é criptografada numa tabela do usuário TASY_VERSAO.XML. informações como usuário. Pversões anteriores do Java podem ser baixadas por: http://www. Isso mantém algumas conexões abertar e. Configurações Gerais Tomcat é instalado no diretório $CATALINA. 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. Há duas formas de configurar o arquivo context.apache.sql.BasicDataSourceFactory" type="javax.jdbc.xml: Oracle Individual ou Oracle RAC.2 Oracle RAC <Context> <Resource name="jdbc/TASY" auth="Container" factory="org. Há uma explicação sobre como proceder nos dois casos: 3.driver.jdbc.tomcat.DataSource" password="aloiskve" driverClassName="oracle.2.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.DataSource" driverClassName="oracle. atente para a criação da tabela TASY_SEG no usuário TASY_VERSAO.jdbc.1 Oracle Individual <Context> <Resource name="jdbc/TASY" auth="Container" type="javax.dbcp. de acordo com o item 4 – Usuário de Acesso ao Sistema.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.jdbc.DataSource" driverClassName="oracle.sql.dbcp.2.É preciso que o banco de dados esteja de acordo com o Manual de Configuração do Banco de Dados para que o Tomcat funcione corretamente.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))))" Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 4 de 20 . No caso de autentificação usando o usuário TASY_VERSAO. do manual citado.DataSource" driverClassName="oracle.sql.sql. 2. mude a configuração para Oracle Individual.jdbc.apache.sql.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”.dbcp.apache.apache.tomcat.dbcp. como: org.jdbc.dbcp.DataSource" password="aloiskve" driverClassName="oracle.dbcp.1 – Tratando erros de conexão com ORACLE RAC 10g em datasource: Ao usar ORACLE RAC 10g e muitas mensagens de erro aparecerem.BasicDataSourceFactory" type="javax.driver. 3.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 Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 5 de 20 .maxActive="-1" removeAbandoneded="true" removeAbandonedTimeout="300" logAbandoned="true" /> <Resource name="jdbc/WTASY" auth="Container" factory="org.tomcat.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.dbcp.driver.sql.BasicDataSourceFactory" type="javax.2.tomcat.DataSource" password="aloiskve" driverClassName="oracle.dbcp. Permanent Memory: adicionar às Opções Java a seguinte linha: XX:MaxPermSize=512m Memory – Garbage Collector execution format: -XX:+UseG1GC – garantir resposta mais rápida do Garbage Collector em ambientes multiprocessados. apenas mudadndo a quantidade de memória usada: Initial memory pool: normalmente ¼ da memória disponível no servidor. siga os passos: Acesse a pasta $CATALINA\bin Crie o arquivo setenv. melhorando o tempo de resposta de telas e functões depoid de invocar o Garbage Collector. como mostrado na figura a seguir.1 Servidores Windows Pode-se configurar o uso da memória pela tela de inicialização do Tomcat (tomcat6w. Maximum memory pool: normalmente ½ da memória disponível no servidor.3.sh e edite-o para que tenha a seguinte forma: Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 6 de 20 . Servidores Linux Nos ambientes Linux.=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.: manter os valores de memória de acordo com a disponibilidade/necessidade do servidor.3 Configuração do Uso da Memória 3. OBS. 3.4.exe). exe). para normatização dos dados. datas e geração de relatórios com caracteres especiais. como apresentação das casas decimais de valores numéricos.5.language=pt -Duser. deve ser adicionado na aba “Java”.1 Servidores Windows O idioma deve ser configurado para que situações em que as informações na tela não fiquem de forma desconfigurada. É obrigatório que o ambiente (sistema operacional. OBS. 3.region=BR Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 7 de 20 . para que não haja nenhum erro com valores monetários. -XmxXXXm normalmente equivale a½ da memória disponível no servidor OBS.5 Configuração de Idioma É importante para evitar que caracteres estranhos apareçam onde deveria haver caracteres especiais. na tela de inicialização do Tomcat (tomcat6w. será necessário realizar um update manual de cada registros. como palavras acentuadas. Para isto. Windows ou Linux) de suport esteja configurado com Português Brasileiro com CHARSET ISO-8859-1. no campo “Java Options”. Esta alteração deve ser realizada pelo DBA responsável para ambiente do cliente.: K manter os valores de memória de acordo com a disponibilidade/necessidade do servidor 3.JAVA_OPTS="-Xms128m -Xmx1024m -XX:MaxPermSize=512m -XX:+UseG1GC $JAVA_OPTS" export JAVA_OPTS -XmsXXXm normalmente equivale a ¼ da memória disponível no servidor.: Caso seja salvo algum registro no Banco de Dados com caracteres “estranhos”. as seguintes linhas: -Duser. sem welcome screen para usuario de privilégios que não oferecem risco ao ambiente. Para configurar este item. devem-se seguir com atenção e por completo os passos abaixo: a. Adicionar/modificar as seguintes linhas ao arquivo em: /etc/gdm/custom. b.6 Configuração de Recursos Gráficos (Xserver) em Linux A configuração deste recurso torna-se imprescindível para exibição correta de vários relatórios do sistema TASY. nas distribuições homologadas(Oracle Linux e CentOS).language=pt -Xms128m Xmx1024m -XX:MaxPermSize=512m -XX:+UseG1GC $JAVA_OPTS" 3. [daemon] RemoteGreeter=/usr/libexec/gdmgreeter AutomaticLoginEnable=true AutomaticLogin=tomcat [security] DisallowTCP=false AllowRemoteRoot=false [xdmcp] Enable=true [gui] AllowGtkThemeChange=false [greeter] Include=tomcat Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 8 de 20 . Habilitar initdefault (/etc/inittab) do Linux para level 5 (possuir servidor X com GNOME é pré-requisito para a solução da Philips Clinical Informatics rodar corretamente.region=BR -Duser.5.2 Servidores Linux Acessar a pasta $CATALINA\bin Editar o arquivo setenv.conf (para permitir logon automático.3. que é o usuário comum tomcat na sessão GNOME).sh Procurar pela linha JAVA_OPTS="-Xms128m -Xmx512m -XX:MaxPermSize=512m XX:+UseG1GC $JAVA_OPTS" Alterar por JAVA_OPTS="-Duser. normalmente. j. Adicionar no /etc/profile a seguinte linha. usar o seguinte comando: passwd tomcat (definir uma senha de sua preferência por segurança). Após validar que o autologin com usuário básico funcionou e o servidor gráfico foi manifestado.: Existem situações em que o DISPLAY:0 pode estar sendo usado por outro programa. Efetuar o seguinte comando para conferir: echo $DISPLAY (o resultado deve ser localhost:0) i.7 Configuração do Usuário Administrador do Tomcat Para atualizações de aplicativos pela Interface Web de Administração do Tomcat e também para testes de conexão com o Banco de Dados usando o aplicativo WhebServidor. ao final do arquivo: export DISPLAY=localhost:0 Também deve-se adicionar esta linha no início do arquivo $CATALINA/bin/startup. o seu servidor de aplicação terá um servidor gráfico para usar em caso de necessidade de manifestar bibliotecas que envolvem desenho.[chooser] [debug] [servers] c. não seja reconhecido como um comando válido. pois o Tasy possui um Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 9 de 20 . Exemplo do caminho completo deste arquivo: /home/tomcat/. é necessária a configuração do usuário Administrador do Tomcat. d. Neste caso recomendamos a realização de testes. Após este processo. Esta configuração não expõe o servidor a vulnerabilidades) h. Comando: useradd tomcat Após este comando. Criar o usuário tomcat e definir um password. e utilize os projetos que antes possuíam problemas de funcionamento. de um ctrl+c para abortar o xclock e inicie normalmente seu servidor tomcat com root como de costume. Faça um teste usando via SSH com root o comando: xclock Verifique em seu console (monitor do servidor) se foi manifestado um relógio gráfico na sua sessão do servidor X OBS. É necessário reiniciar o ambiente. Para isso rode o comando “yum install xclock” para instalação do pacote.bash_profile Adicionar a seguinte linha ao final do arquivo mencionado acima: xhost +localhost f. Adicionar na home do usuário tomcat. é provável que o mesmo não esteja instalado no sistema.sh OBS. conferir na console (monitor do servidor) se uma sessão GNOME mínima (podem ocorrer pequenos alertas sobre ferramentas e preferências do perfil que podem ser tranquilamente ignorados (clicar em OK) e que não comprometem o ambiente e a funcionalidade dos projetos que usam as bibliotecas do servidor X.: Caso o comando xclock. Com isso garantido. alterando o display de “0” para “1” ou “2”. confirmar com echo $DISPLAY em uma sessão SSH root. e. que somente são corretamente executadas quando o servidor gráfico X do Linux está executando com um desktop e uma sessão de usuário já estabelecida. permissão para usar a sessão no servidor X por ele estabelecida apenas para a máquina local (este servidor) que deixa o ambiente com bom nível de segurança. 3. g. outras configurações deve ser realizadas para garantir a comunicação e a resiliência da aplicação Tomcat.8 Configurações Adicionais em Servidores Windows Em Servidores Windows. para garantir que o acesso a interface do WhebServidor seja realizado apenas por usuários autorizados. algumas vezes dependendo das soluções de Firewall e Anti-virus utilizadas. Já em Servidores GNU/Linux. deve-se adicionar a seguinte linha: <user username="USUARIO" password="SENHA" roles="manager-gui" /> O usuário deverá ser diferente do usuário de acesso ao WhebServidor. para ter o mesmo usuário e senha. Para configurar o acesso ao WhebServidor. Exemplo de arquivo tomcat-users. Pode-se configurar os dois acessos na mesma linha. deve-se adicionar a seguinte linha ao arquivo: <user username="USUARIO" password="SENHA" roles="philips-manager" /> Para acesso a Interface Web de Administração do Tomcat. Version 2.xml: <?xml version='1. via usuário e senha. Para isso duas ações não necessárias: Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 10 de 20 . See the NOTICE file distributed with this work for additional information regarding copyright ownership. há a necessidade de realizar algumas configurações extras.philips-manager"/> </tomcat-users> 3.mecanismo de segurança. da seguinte forma (desta forma as linhas acima demonstradas não deverão ser usadas): <user username="USUARIO" password="SENHA" roles="manager-gui. you may not use this file except in compliance with the License.philips-manager" /> É importante que estas linhas sejam adicionadas fora da região de comentários do arquivo (não deve estar entre as TAG's “<!--” e “-->” e antes da TAG de fechamento do arquivo (“</tomcat-users>”). The ASF licenses this file to You under the Apache License.0' encoding='utf-8'?> <!-Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements.xml. You may obtain a copy of the License at --> <tomcat-users> <user username="administrador" password="P4$$w0rd" roles="manager-gui. Esta configuração é realizada no arquivo $CATALINA_HOME\conf\tomcat-users.0 (the "License"). Validar a necessidade da utilização do SELinux.2 Configurações de Log On do Tomcat quando utilizada Firewall/Proxy Microsoft ISA Server.exe: Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 11 de 20 . Caso não hajam tratativas para sua utilização. botão de Configurações de Desempenho. 3. Bionexo. recomendamos que o mesmo seja desabilitado. entre outros). para autenticação do Proxy: Solução de O Serviço do Tomcat deverá ser inicializado com um usuário que possua permissão de acesso à Internet. Configuração realizada no Tomcat6w. Será necessário reiniciar o computador após realizar esta configuração. Aba Avançado. 3. Esta configuração é realizada nas Propriedades Avançadas do Sistema (Painel de Controle > Sistema > Configurações Avançadas do Sistema). Validar a necessidade de utilização do Firewall nativo do sistema. principalmente sites onde haverão integrações (por exemplo: Nota Fiscal Eletrônica.8. caso o mesmo não possua uma finalidade específica sugerimos que o mesmo também seja desabilitado.8.1 Configurações da Prevenção de Execução de Dados (DEP): É necessário que a DEP esteja habilitada somente para programas e serviços essenciais do Windows. acessar o endereço http://localhost:8080/WhebServidor e verificar se o serviço aparece com o status ATIVO.8. Sendo assim.10 Instalando o Módulo Servidor Baixar da extranet a o arquivo WhebServidor. e também podem interferir fortemente no desempenho de leitura/gravação dos arquivos dos aplicativos Philips.exe no Windows.sh no Linux) Acessar através do navegador o seguinte endereço (http://localhost:8080 ou http://<IP_DO_SERVIDOR>:8080/ onde <IP_DO_SERVIDOR> é o endereço IP do servidor onde está instalado o Tomcat) Verificar se a tela inicial do Tomcat foi inicializada e se no console/log não ocorreu nenhum erro. entre outros).3.war da mesma versão da Base de Dados do Tasy onde o Tomcat se conectará Colar o arquivo WhebServidor. é possível que seja necessário excluir das verificações de Antivírus o diretório onde encontra-se instalado o Tomcat.war no diretório $CATALINA\webapps Iniciar o Tomcat. verificações de conectividades de Rede do Serviço do Tomcat e também verificações de arquivos com a extensão “. $CATALINA/bin/.9 Testando a Configuração do Tomcat e do Java SE Iniciar o Tomcat ($CATALINA\bin\tomcat6w. Bionexo.3 Configurações de Antivírus: Algumas soluções Antivírus podem interferir na comunicação correta do serviço do Tomcat com Integrações Externas (por exemplo: Nota Fiscal Eletrônica. conforme tela abaixo. Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 12 de 20 . 3.WAR”.exe ou tomcat6. 3./startup. 5.zip Parar o tomcat caso o mesmo esteja ativo Extrair os arquivos e colar na seguinte pasta $CATALINA\endorsed (será necessário criar esta pasta “endorsed”) Iniciar novamente o Tomcat. Alterar o arquivo $CATALINA\webapps\Wheb_Config\wheb_rodape. Configurações para Projetos Web 4.3. que consiste em adicionar bibliotecas diretamente no Tomcat. (NomeDoModulo. ' ENDERECO_DO_HOSPITAL ' ' EMAIL_PARA_CONTATO'.jpg. 4.jpg em $CATALINA\webapps\Wheb_Config\figuras pelo logo desejado. Para utilizar este recurso é necessário: Baixar da extranet o arquivo BibliotecasEndorsed. no qual o logo deve ser renomeado para logo_relatorio.jsp conforme o quadro a seguir: String String String String String link titulo endereco email tituloEmail = = = = = 'ENDERECO_SITE_HOSPITAL'.11 Utilização do recurso Endorsed Para utilizar recursos como o TISS e Assinatura Digital do Tasy é necessário utilizar o recurso nativo do Java chamado Endorsed.jpg em $CATALINA\webapps\Wheb_Config\figuras pelo logo desejado. Alterações Visuais no Módulo Cliente Alterar o logo da página inicial: substituir o logo. Tamanho do logo ideal 300 (largura) X 60 (altura). no qual o logo deve ser renomeado para logo.2 Projetos Necessários para o Servidor Tomcat Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 13 de 20 . Baixar da extranet a versão atualizada do módulo cliente.war) Colar o arquivo NomeDoModulo.jpg.war no diretório $CATALINA\webapps Iniciar o Tomcat e acessar o endereço http://localhost:8080/NomeDoModulo 5. Tamanho do logo ideal 300 (largura) X 60 (altura).1 Instalando o Módulo Cliente Foi definido como NomeDoModulo a aplicação correspondente a ser utilizada. ' TITULO_SITE '.1 Configurações para Tasy em Java 5. Alterar o logo do do relatório: substituir o logo_relatorio. ' TITULO_EMAIL '. war. alguns arquivos devem ser configurados em $CATALINA/webapps/Tasy. O projeto WhebServidor é responsável por realizar as conexões com o banco e deve ser atualizado a cada troca de versão. As partes mais claras.jnlp.War e WhebRepositorio.3. O projeto Tasy é responsável por armazenar as configurações do Tasy em Java. Solicitar este arquivo ao Departamento de Suporte da Philips Clinical Informatics.2 Atualização do WhebServidor. são as que podem e devem ser configuradas. Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 14 de 20 . WhebRepositorio. proceder conforme o Manual de Atualização de Versão e Servidores de Aplicação Java nos Clientes. Existem dois arquivos: um para configurar acessos externos ao Tasy em Java.war.4 Configuração dos Acessos ao Tasy em Java Para que o Tasy em Java seja utilizado. WhebServidor.war. os seguintes projetos são necessários para o seu funcionamento: Tasy. que serão realizados pela Internet e outro para configurar acessos internos ao Tasy.war Este arquivo deve ser descompactado somente uma vez. não sendo necessário atualizar o mesmo a cada atualização de versão.1 Atualização do Tasy.jnlp. Os arquivos possuem uma estrutura igual a da imagem abaixo. 5. Os arquivos são: tasy-acesso-externo. O projeto WhebRepositorio é responsável por armazenar todos os arquivos do Tasy em Java.war Para atualizar o WhebServidor.3 Atualização dos Arquivos do Tomcat 5. realizados na rede interna do estabelecimento.3. 5.Para rodar o Tasy em Java. 5. tasy-acesso-interno. xml (vide item 3. Verificar item 8.Nas linhas números 2 e 16. As bases são configuradas de acordo com os Resources do arquivo Context. o IP externo ao servidor. podem ser configurados os parâmetros do Tasy em Java. Caso contrário.base podem ser configuradas as bases que aparecerão ao usuário. configura-se o IP do servidor onde está localizado servidor Tomcat. Abaixo do argumento . deve ser informado o IP (Internet Protocol) da rede. Estes valores devem ser passados caso possua mais de uma base. igual nas linhas 2 e 16. Nas linhas 22 a 32. podem ser removidos. Abaixo do argumento deve ser informado o IP do servidor.2 deste manual) Exemplo: <argument>-base</argument> <argument>TASY</argument> OBS. Relação de parâmetros que pode ser configurados no arquivo .jnlp: Parâmetro Valor Descrição -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 necessários Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 15 de 20 .: A Philips recomenda que cada servidor instalado tenha apenas uma base configurada. Caso seja acesso interno. Caso contrário. podem ser configuradas informações a respeito do estabelecimento. Nas linhas 4 a 7. Copiar os novos arquivos “. Excluir todos os arquivos “. Excluir as pastas completas dos aplicativos que serão atualizados.5 Localização dos Arquivos de Logo de Relatórios e Tela Inicial do Sistema Os arquivos de Logo para Relatórios ficam localizados no Web Aplicativo Tasy. Iniciar novamente o serviço do Tomcat. Porém apenas os aplicativos que serão atualizados.-useTempFolder Nenhum valor deve ser informado Indica que a pasta “. Limpar (excluir) o conteúdo da pasta $CATALINA\temp.xml $CATALINA\conf\tomcat-users.WAR” existentes na pasta $CATALINA\webapps. Sendo assim atenção para não excluir os seguintes diretórios: . na pasta $CATALINA\webapps. Limpar (excluir) o conteúdo da pasta $CATALINA\conf\Catalina. OBS. 7. Atualização dos Web Aplicativos Para realizar a atualização dos web aplicativos. em $CATALINA\webapps.1 Atualização Off-line Para este tipo de atualização dos aplicativos. Limpar (excluir) o conteúdo da pasta $CATALINA\work.sh (apenas Linux) Os demais arquivos serão recuperados com a instalação padrão do Tomcat e com os Web Aplicativos da versão correta. Aguardar fim da inicialização do Serviço e dos Web Aplicativos.: Deve-se ter muito cuidado para não excluir diretórios importantes de configuração ou manutenção do Tomcat. devem ser salvaguardados os seguintes arquivos/caminhos: $CATALINA\conf\context. será necessário seguir os seguintes passos nesta ordem: Parar o serviço do Tomcat. 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. baixados da Extranet Philips. Limpar (excluir) o conteúdo da pasta $CATALINA\logs. Estes arquivos precisam ser configurados somente uma vez.xml $CATALINA\webapps\Tasy (a pasta inteira) $CATALINA\webapps\Wheb_Config (a pasta inteira) $CATALINA/bin/setenv.jpg 6. Backup das Configurações do Tomcat Caso desejar-se realizar Backup dos arquivos de configuração do Tomcat.Wheb_Config (Contém customizações dos clientes) . 5.tasy” deve ser criada na pasta '%TEMP%' do usuário atual Estas configurações devem ser feitas para os dois arquivos.Tasy (Não é necessário atualizar) Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 16 de 20 . pode-se proceder de duas formas: 7. dos aplicativos a serem atualizados.WAR”. Realizar testes após atualização. 7 deste manual. será necessário ter configurado corretamente o Usuário Administrador do Tomcat.0.ROOT (Manager do Tomcat) . via browser. a Administração do Tomcat: (http://127.1:8080/manager/html) Realizar o Undeploy de todos os Web Aplicativos a serem atualizados. Acessar.MultiMED (Não é necessário atualizar).. conforme tela de exemplo a seguir: Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 17 de 20 . 7.2 Atualização On-line Para este tipo de atualização dos aplicativos. conforme item 3.0. Todas estas ações interferem diretamente nas outras bases que estão configuradas no Tomcat. pois são apresentados os ajustes dos problemas encontrados. conforme tela de exemplo a seguir: O processo de Deploy deve ser realizado para todos os aplicativos a serem atualizados. identificando possíveis riscos e impactos de cada versão e/ou ação realizada. Quando se tem uma base de produção separada das demais. OBS. assim como prever alguns itens que possam ocorrer ao trocar um Build ou realizar uma atualização.: Não realizar deploy dos seguintes aplicativos: - “/” “Tasy” “MultiMED” “host-manager” “manager” “wheb_config” Lembrando também que não deve ser parado o serviço do Tomcat para realizar este processo. conforme este manual. Somente é possível realizar o Deploy de 1 aplicativo por vez. Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 18 de 20 . é possível agilizar o atendimento ao cliente. atualização de parâmetros ou objetos e testes de atualização do sistema. Com isso. lembrando de sempre realizar o Undeploy do aplicativo antes do deploy. é necessário realizar uma nova configuração. Tomcat para Bases Diferentes da Produção A Philips recomenda que para cada base exista um Tomcat.Selecionar o arquivo a ser realizado Deploy e usar o botão Deploy. para cada servidor novo. 8. é possível que sejam realizados testes separadamente em builds diferentes. Essa prática também aumenta a segurança e a estabilidade do sistema sendo possível testar as versões. trazendo mais comodidade ao cliente. Entretanto. 2 Travamento do Tomcat Se estiver ocorrendo travamento do servidor de aplicação. não pode ultrapassar 1536m.localdomain localhost 9. significa que recursos gráficos do sistema operacional Linux não estão instanciados.Com esta prática podemos ter o seguinte cenário: Servidor 1 é onde a base de produção está instalada. é necessário configurar no arquivo startup. a soma dos parâmetros de memória máxima (-Xmx no Linux) com Memória Permanente (XX:MaxPermSize). Ex. 9. 9.4 Defeito de java. permitindo testes diferentes e montagem do cenário desejado pelo cliente. verificar a existência do módulo WhebServidorIntegracao. Para que estes recursos sejam ativados. Caso seja necessário configurar mais que 1536m de memória total para o Tomcat. 9. deve-se verificar se foi configurado o acesso o banco de dados jdbc/TASY_INTEGRACAO conforme item Configurar a Conexão com o Banco de Dados.1 linux01. este não é alterado. 9.lang. menor que o valor de memória máxima.localdomain No arquivo /etc/hosts deve conter: 127. 9.0. Caso existir o mesmo.1 Recurso De Paginação Em Relatórios Não Funciona Em Tomcat Linux Caso o cliente visualize o erro “java.0. Caso esteja utilizando o Java SE de 32 bits. é necessário verificar as configurações de memória. Normalmente de 512m a 2G atendem as necessidades de nossos aplicativos. o mesmo permaneça inicializando. O valor de memória inicial deve ser obrigatoriamente.NoClassDefFoundError: sun/awt/X11GraphicsEnvironment” nos arquivos de saída padrão do Tomcat no diretório logs.3 Tomcat Simplesmente não Inicializa Caso ao tentar inicializar o Tomcat. problemas.5 Problema ao Enviar E-mail (erro 500 SMTP) O hostname da máquina deve ser o mesmo contido nos arquivos /etc/hosts no caso de sistemas operacionais Linux. faz-se necessário manter o seu Linux em modo runlevel 5.5 Apache Tomcat não Gera Logs Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 19 de 20 . com o servidor gráfico X devidamente configurado. não foi configurado ou precisa ser ampliado.: $HOSTNAME=linux01.OutOfMemoryError: PermGen space no Log do Tomcat O parâmetro de Memória Permanente (-XX:MaxPermSize). Servidor 2 onde existe um novo Tomcat instalado para uma base que possa receber testes e poderá ser alterada da forma que for necessária para elencar melhorias.lang. Caso seja necessário configurar mais de uma base (recomendado pela Philips): Servidor 3 onde será configurado uma base de teste diferente da base do servidor 2. Junto com este procedimento. Possíveis Erros 9. deve-se utilizar Tomcat e Java SE de 64 Bits.sh do Tomcat em Linux a variável Para correção deve-se proceder conforme item: Configuração de recursos gráficos (Xserver) em Linux. 6 Demais Situações Abrir uma OS para a Philips Clinical Informatics.exe) 9.0.0. recomendamos a desinstalação do Tomcat e a reinstalação do mesmo. podemos encontrar situação em que o Tomcat não gera logs. 9. Isso pode ser resultado de um download corrompido ou de alguma versão não compatível.5 WhebServidorIntegracao não inicia Verificar se a versão do Java instalado no ambiente esta na versão 6. utilizando o executável do link abaixo: (http://ftp. Context. não atendem as requisitos do aplicativo.Em ambientes Windows.xml Setenv.41. Para solução do embase. enviando uma imagem da tela onde apresenta o erro.41/bin/apache-tomcat6. Uma vez que as versões 7 e 8 do Java.unicamp.sh(Caso servidor Linux) Saida do comando “rpm-qa” Versão do Apache Tomcat e Java Versão do Sistema Operacional e arquitetura Revisão: 011 Data Alteração: 11/03/2015 CÓPIAS NÃO SÃO CONTROLADAS 20 de 20 . Logs do Tomcat. o arquivo de erro gerado no diretório em $CATALINA\webapps\<modulo>\temp. Anexar à Ordem de Serviço.br/pub/apache/tomcat/tomcat-6/v6.
Report "Manual de Configuração Do Servidor Tomcat"