Autorizador WEB 12.1.3 Roteiro de Instalação e Configuração Fevereiro 2014
Índice Título do documento 1. Histórico de Alterações... 4 2. Introdução... 5 3. Pré-Requisitos... 6 3.1. Hardware Servidor... 6 3.2. Software Servidor... 6 3.3. Software Cliente... 6 4. Passos para Instalação e Configuração do sistema Autorizador WEB... 7 4.1. Instalação e Configuração do Java... 15 4.2. Instalação do Java para Windows... 16 4.3. Instalação do Java para Linux... 22 5. Banco de Dados... 24 5.1. Criando o banco de dados do sistema... 24 5.1.1. Criando uma Base de Dados Oracle... 24 5.1.2. Criando uma Base de Progress... 25 5.2. Configuração do Banco de Dados... 32 6. Criação do AppServer... 33 6.1. Configuração de acesso ao AppServer... 37 7. Inicialização e Acesso... 39 7.1. Inicialização do Servidor... 39 8. Configurações de Memória... 41 2 Versão 1.0
Atenção: Copyright 2014 TOTVS. Todos os direitos reservados. Nenhuma parte deste documento pode ser copiada, reproduzida, traduzida ou transmitida por qualquer meio eletrônico ou mecânico, na sua totalidade ou em parte, sem a prévia autorização escrita da TOTVS, que se reserva o direito de efetuar alterações sem aviso prévio. A TOTVS não assume qualquer responsabilidade pelas consequências de quaisquer erros ou inexatidões que possam aparecer neste documento. TOTVS S.A. Av. Braz Leme, 1717 São Paulo-SP Brasil www.totvs.com Versão 1.0 3
1. Histórico de Alterações Título do documento Data Versão Descrição 14/12/2011 1.0 Criação do documento 11/07/2013 1.1 Inclusão do Instalador Revisão do Documento 27/05/2014 1.2 Suporte a base de dados Progress SQL 30/09/2014 1.3 Revisão do Documento 03/12/2014 1.4 Atualização da Versão do Documento 11/02/14 1.5 Atualização da Versão do Documento 4 Versão 1.0
2. Introdução A finalidade deste documento é descrever um Roteiro para Instalação e Configuração do Autorizador Web para a utilização em uma nova instalação. Atenção: Nesta mídia é disponibilizado o instalador do JBOSS para sua conveniência, no entanto dúvidas sobre sua instalação e configurações de componentes nativos devem ser direcionadas ao suporte do fornecedor do JBOSS. Depois que o produto já estiver em operação a TOTVS disponibilizará no Portal de Clientes atualizações do produto englobando alterações para correções de erros, correções legais e novas implementações. Para efetuar a atualização de seu ambiente deverão ser seguidos os procedimentos indicados neste guia; sendo necessário algum auxílio adicional favor entrar em contato com o serviço de consultoria. Versão 1.0 5
3. Pré-Requisitos Título do documento Segue abaixo os requisitos mínimos e recomendáveis para o funcionamento do sistema Autorizador Web. 3.1. Hardware Servidor Processador 2.4GHZ ou superior. Memória mínima 2GB. Recomendável 4GB. Rede 100 Mbs ou superior. Espaço em disco: 2GB para instalação do Jboss. Recomendável 8GB livres. *Configuração minima para 10 usuários. 3.2. Software Servidor A versão atual do Autorizador Web requer a pré-instalação do Java JDK 1.7. Banco de dados suportados: Oracle 10g ou superior, SQL Server 2005/2008 e Progress 10.2B ou superior. Acesso ao AppServer Progress para comunicação com Gestão de Planos Progress (Datasul12). Sistemas operacionais suportados: Windows 7 ou superior e Linux. 3.3. Software Cliente Navegadores Web homologados: o Microsoft Internet Explorer 8 ou superior. o Google Chrome. Adobe Reader 9 ou superior Java JRE 7 (para leitor biométrico) Resolução do monitor mínima igual a 1024 x 768. Recomendável 1280 x 800 6 Versão 1.0
4. Passos para Instalação e Configuração do sistema Autorizador WEB 1º. Baixe a versão mais recente do pacote de instalação no portal de clientes e descompacte em um diretório local da máquina. Segue abaixo o exemplo de como buscar os pacotes: 1. Selecione o pacote compatível com seu ambiente. 2º. Siga os passos do processo de instalação: 1. Entre na pasta Disk1 e execute o setup.exe e clique em Avançar. 2. Informe o Nome do Usuário e Empresa. Clique em Avançar. Versão 1.0 7
Título do documento 3. Selecione a Unidade de Disco em que será realizada a instalação. Será criada uma pasta TOTVS na unidade de destino. Clique em Avançar. 8 Versão 1.0
4. Selecione qual tipo de banco de dados o Autorizador Web irá utilizar e clique em Avançar. Caso tipo selecionado for Progress, na próxima tela será necessário informar o diretório de instalação do progress. 5. Selecione o tipo de banco de dados utilizado pelo TOTVS11. Versão 1.0 9
Título do documento 6. Informe os dados de acesso ao bando de dados do TOTVS11. 10 Versão 1.0
7. Informe os dados da instancia do Banco de Dados do TOTVS11. 8. Informe os dados de acesso ao banco de dados. Esta informação será utilizada para configurar o acesso ao banco de dados do Autorizador configurado na pasta deploy do Jboss. Clique em Avançar. Versão 1.0 11
Título do documento 9. Informe o nome do usuário e senha do banco de dados a ser criado. Caso o banco de dados seja Oracle, informe a instancia. Caso for SQL Server, informe o Database Name. Clique em Avançar. 10. Informe os dados de conexão com o AppServer progress. Clique em Avançar. 12 Versão 1.0
11. Aguarde a instalação finalizar e criar o serviço do Windows. Clique em Concluir. Versão 1.0 13
Título do documento Será criado um serviço do Windows, denominado TOTVS-AUTORIZADOR-12.1 com o Tipo de inicialização Manual. Caso deseje deixar o serviço em Automático, basta alterar o tipo de inicialização. Caso a instalação utilize o banco de dados progress para o Autorizador, certifique-se que o banco de dados esteja iniciado. 3º. Para o funcionamento do sistema Autorizador. É necessária a instalação do pacote do JDK(Java Development Kit) atualizado conforme o capítulo Instalação e Configuração do Java. 4º. Configure o banco de dados conforme as instruções na seção Configuração do banco de dados deste documento. 5º. Configurar o AppServer conforme a seção Criação do AppServer. 6º. Após a realização destes passos já podemos iniciar o servidor de aplicação conforme a seção Inicialização e Acesso. 7º. Faça as configurações mencionadas na seção Configuração de Memória caso haja a necessidade de aumentar as configurações de memória utilizadas pelo JBOSS. 14 Versão 1.0
4.1. Instalação e Configuração do Java Conforme os pré-requisitos do sistema, a versão do Java a ser instalada deve ser o JDK 1.7 ou superior. Esta versão pode ser encontrada no site da Oracle (http://www.oracle.com/technetwork/pt/java/javase/downloads/index.html). Ao acessar o link irá aparecer à tela abaixo, selecione a versão conforme o seu sistema operacional e faça o download. Versão 1.0 15
Título do documento 4.2. Instalação do Java para Windows 1. Após ter finalizado o download, execute o instalador. 2. Na próxima tela aparecerão às opções de instalações do JAVA. Deixe as opções padrão e clique em Next. 16 Versão 1.0
3. Após a finalização da barra de progresso, será exibida a tela abaixo indicando que a instalação do JRE. Clique em Next para continuar. Versão 1.0 17
Título do documento 4. Clique em Finish para finalizar a instalação. 18 Versão 1.0
Para a configuração da variável de ambiente no Windows ME/2000/XP, você deve fazer da seguinte maneira: Clique com o botão direito em Meu computador\propriedades\avançado\variáveis de ambiente. Para o Windows Vista/Seven você deve fazer da seguinte maneira: Clique com o botão direito em Meu computador\propriedades\configurações avançadas do sistema\variáveis de ambiente. 5. Na tela que irá se abrir clique em "Variáveis de Sistema", conforme a imagem abaixo: Versão 1.0 19
Título do documento 6. Clique em Variáveis de ambiente e logo após clique em Novo e crie à variável JAVA_HOME com o valor C:\Program Files\Java\jdk1.8.0_05 conforme a imagem abaixo: 20 Versão 1.0
7. Clique em OK para finalizar a configuração da variável JAVA_HOME. 8. Procure na lista Variáveis do sistema e a variável Path, clique em Editar e no campo Valor da variável, acrescente no final do campo o valor ;%JAVA_HOME%\bin conforme a imagem abaixo: Versão 1.0 21
4.3. Instalação do Java para Linux Título do documento 1. Acesse com o usuário Root. 2. Coloque na pasta opt o arquivo jdk-6u18-linux-i586-rpm-bin baixado. 3. Conceda permissão de execução para o arquivo da seguinte maneira: #chmod 777 jdk-6u18-linux-i586-rpm.bin 4. Execute o comando abaixo e execute os passos exibidos na instalação. 5. Pressione a barra de espaço (teclado) e digitando yes para concluir à instalação: #./jdk-6u18-linux-i586-rpm.bin 6. O java criará uma pasta no /usr/java e outra dentro /opt/sun, para maiores detalhes: http://java.sun.com/javase/6/webnotes/install/jdk/install-linux.html Não é mais necessário fazer as configurações do profile da última versão do Java, como outros software fazem referência às variáveis de ambiente do Linux, configure: 1. Abra o arquivo /etc/profile com o editor de texto de sua preferência (faça isso com ROOT): # vi /etc/profile 2. Antes do PATH e EXPORT acrescente as seguintes linhas: # Variaveis ambiente adicionadas para configuração do J2SE 6.0_18 JAVA_HOME=/usr/java/jdk1.6.0_18 PATH=$PATH:$JAVA_HOME/bin CLASSPATH=.:$JAVA_HOME/lib/tools.jar MANPATH=$MANPATH:$JAVA_HOME/man export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE INPUTRC JAVA_HOME CLASSPATH MANPATH 3. Salve e clique para sair do arquivo, usuário e execute o comando abaixo para carregar as novas modificações. # exit $ source /etc/profile Abra um terminal e digite: 22 Versão 1.0
$ java -version $ javac -version Versão 1.0 23
Título do documento 5. Banco de Dados Neste capítulo serão centralizadas todas as configurações referentes a banco de dados. Nas seções a seguir descrevemos os passos necessários para fazer a criação do banco de dados do sistema para as versões Oracle. 5.1. Criando o banco de dados do sistema 5.1.1. Criando uma Base de Dados Oracle Para criação da base de dados Oracle será necessário o usuário e senha de DBA do banco para a criação do usuário do sistema. Caso tenha dúvidas quanto a esse usuário entre em contato com o DBA da empresa. 1. Acesse a máquina de banco de dados onde está instalado o Oracle e digite no console (Windows) ou Shell (Linux) da máquina: sqlplus / AS SYSDBA Observação: Ao executar o comando acima será necessário a senha de DBA. 2. Crie o usuário do banco Autorizador WEB: CREATE USER atr_saude_web IDENTIFIED BY " atr_saude_web"; 3. Inclua as permissões necessárias para a criação das tabelas. 4. Insira os registros e execute o sistema Autorizador WEB. GRANT CONNECT, RESOURCE TO atr_saude_web; 5. Feche a sessão do DBA. 6. Execute o console ou o Shell da máquina e conecte com o novo usuário para a criação dos objetos do banco conforme o comando abaixo. sqlplus atr_saude_web/atr_saude_web@ora10g 7. Após a conexão, execute o script do banco que se encontra no diretório (C:\totvs\autorizador\database\definicoes). 8. Execute o script de criação das tabelas: schema_oficial.sql. 9. Execute o script de carga de dados: carga_dados.sql. 24 Versão 1.0
5.1.2. Criando uma Base de Progress Os passos abaixo explicam como criar uma base de dados vazia. O instalador já irá criar a base de dados progress e popular os registros básicos. 1. No menu de programas do Progress, clique em Database Administration. 2. Clique no menu Database /Create. Será exibida a janela conforme a imagem abaixo: Versão 1.0 25
Título do documento 3. Clique em Files e selecione o local C:\totvs\autorizador\database (Criar os diretórios caso não exista) para criar os arquivos do banco. Ex.:.db do Progress. O nome padrão para o arquivo do banco de dados será atrsaude conforme a imagem abaixo: Observações: Os arquivos.db são o banco de dados do Progress, sempre manter um backup deste arquivo pois se o mesmo for corrompido, toda a estrutura de base do Autorizador Web terá que ser recriada. 26 Versão 1.0
4. Clique em OK. 5. Na tela seguinte clique novamente em OK. 6. Para conexão ao banco de dados é necessário criar o usuário sysprogress. No Database Administration, acesse: Admin/Security/Edit User List. Versão 1.0 27
Título do documento 7. Será exibida a tela para edição de usuários para o banco de dados recém criado. 8. Clique em Add. 9. Na próxima tela preencha os campos da seguinte forma: a. User ID: sysprogress. b. User Name: sysprogress. c. Senha: sysprogress. 10. No diretório onde foi criado os arquivos do banco de dados(.db,.lg, etc...) crie o arquivo start.bat e shutdown.bat. O primeiro arquivo será utilizado para iniciar o banco com o broker SQL e o segundo será utilizado para derrubar o banco quando necessário. 11. Edite o arquivo start.bat com um editor de textos qualquer, copie o conteúdo abaixo e cole no arquivo. @echo off echo Iniciando o banco de dados do sistema Autorizador Web echo. echo. :: Setar as variaveis Progress set DLC=C:\DIRETORIO_INSTALACAO_PROGRESS set PROMSGS=%DLC%\promsgs set PATH=%DLC%\bin;%PATH% :: Carregar o Banco %DLC%\bin\_mprosrv atrsaude -S 10000 -numsep 46 -numsep 44 -L 20000 -B 200 -bithold 1800 -n 200 -Mn 200 -Mpb 2 -Ma 200 -Mm 4096 -ServerType SQL -basetable 1 -tablerangesize 3500 -Mxs 32 pause 12. Altere a linha set DLC=C:\... e informe o diretório de instalação do Progress(C:\dlc102b). 13. Edite o arquivo stop.bat com um editor de textos qualquer, copie o conteúdo abaixo e cole no arquivo. @echo off echo Derrubando o banco de dados do sistema Autorizador WEB echo. echo. :: Setar as variaveis Progress set DLC=C:\DIRETORIO_INSTALACAO_PROGRESS set PROMSGS=%DLC%\promsgs set PATH=%DLC%\bin;%PATH% :: Derrubando o Banco %DLC%\bin\proshut atrsaude -by pause 14. No diretório onde foi criado o banco de dados deve ficar semelhante a imagem abaixo: 28 Versão 1.0
15. Após a criação dos arquivos, inicie a base de dados e a acesse para executar os script s SQL. Atenção: desconecte a base de dados do Data Administrator antes de realizar o processo abaixo 16. De um duplo clique no arquivo start.bat para carregar o banco de dados e stop.bat para derrubá-lo se necessário. 17. Como o broker iniciado é do tipo SQL, não podemos usar o Editor do Progress para criar as tabelas. A ferramenta utilizada é o sqlexp encontrado na pasta bin da instalação do Progress. 18. Para se autenticar no banco de dados, será necessário utilizar a linha de comando do Windows conforme os passos a seguir. a. De um clique em Iniciar/Executar. b. Digite cmd e pressione Enter. c. Será exibida a tela do console do Windows semelhante a imagem abaixo: Versão 1.0 29
Título do documento 19. Digite o comando conforme o exemplo abaixo: %DLC%\bin\sqlexp -db C:\totvs\autorizador\database\atrsaude -S 10000 -user sysprogress -password sysprogress 20. %DLC% é o diretorio de instalação do progress. Ex.: C:\dlc102b create user atrsaudeweb, 'atrsaudeweb'; grant dba to atrsaudeweb; commit; 21. Após executar os comandos acima, saia do SQLExplorer(comando quit; ) e conecte novamente com o usuário 'atrsaudeweb'. atrsaudeweb %DLC%\bin\sqlexp -db C:\totvs\autorizador\database\atrsaude -S 10000 -user atrsaudeweb -password 30 Versão 1.0
22. Execute o arquivo progress_ddl.sql que é disponibilizado na instalação. 23. Execute o arquivo progress_insert.sql. 24. Após cada execução de arquivo, execute o comando commit; 25. Após executar todas as linhas, pode-se fechar o SQLExplorer. Exemplo de execução: @run c:\temp\schema_oficial.sql; commit; @run c:\temp\carga_dados.sql; commit; Versão 1.0 31
Título do documento 5.2. Configuração do Banco de Dados A configuração do Banco de Dados é realizada no DataSource Descriptor que se encontra no diretório C:\totvs\autorizador\jboss-4.2.3-WAC.GA\server\default\deploy. O padrão de nome para esse arquivo é o nome do Tipo de Banco concatenado com -ds.xml. Para Oracle(1) o nome do descriptor é oracle-ds.xml ou oracle-xads.xml. 1. Configure o descriptor conforme a base em uso no seu sistema. 2. No diretório docs\examples\jca há modelos para vários tipos de bancos. 3. O valor da tag jndi-name deve ser mantida conforme Tabela 1 abaixo, no modelo Oracle: <?xml version="1.0" encoding="utf-8"?> <!-- ===================================================================== --> <!-- JBoss Server Configuration --> <!-- ===================================================================== --> <!-- $Id: oracle-ds.xml 71535 2008-04-01 07:05:03Z adrian@jboss.org $ --> <!-- ==================================================================== --> <!-- Datasource config for Oracle originally from Steven Coy --> <!-- ===================================================================== --> <datasources> <local-tx-datasource> <jndi-name>wac2ds</jndi-name> <connection-url>jdbc:oracle:thin:@server1:1521:gps</connection-url> <driver-class>oracle.jdbc.driver.oracledriver</driver-class> <user-name>atr_saude_web</user-name> <password>aaaa</password> <exception-sorter-class-name> org.jboss.resource.adapter.jdbc.vendor.oracleexceptionsorter </exception-sorter-class-name> <type-mapping>oracle9i</type-mapping> </local-tx-datasource> </datasources> Observação: O instalador já solicita as informações necessárias para a configuração deste arquivo. Somente altere este arquivo em caso de mudança na configuração após a instalação. 1 - A Oracle mantém sua documentação para drivers no endereço: http://www.oracle.com/technology/documentation/index.html. 32 Versão 1.0
6. Criação do AppServer O AppServer será utilizado para fazer a comunicação entre o Autorizador e Gestão de Planos/Datasul11. Segue abaixo os dados para criação do AppServer. 1. Criação do novo AppServer (AutorizadorWEB). 2. Configurações do AppServer: Versão 1.0 33
Título do documento 3. Para acessar as configurações clique com o botão direito do mouse no AppServer criado e clique em propriedades. 4. Na Opção Broker altere o diretório de trabalho, para o qual for utilizado, se necessário altere a porta de comunicação, lembrando que dois AppServers não funcionam na mesma porta. 5. Na opção Agente\Geral pode ser alterada as configurações de parâmetros de inicialização do servidor, Propath e o caminho para geração do log. Observação: Para clientes que utilizam banco de dados unificado, é necessário a criação do arquivo de alias e a configuração no AppServer. Exemplo: 34 Versão 1.0
6. Exemplo de arquivo alias.p: Observação: Nas versões mais atuais do Progress, essa configuração não é feita no Progress Explorer Tools e ocorre através de do web console conforme a imagem abaixo: Versão 1.0 35
Título do documento 36 Versão 1.0
6.1. Configuração de acesso ao AppServer A configuração de acesso é através do arquivo datasul_framework.properties que ficará localizado no diretório C:\totvs\jboss-4.2.3.GA\server\default\conf O arquivo datasul_framework.properties configura IP e a porta onde está o serviço disponível no AppServer, conforme descrito abaixo: Propriedade: progress.server.name Descrição: Nome ou IP do servidor AppServer Progress (Obrigatório). Propriedade: progress.server.port Descrição: porta IP do servidor AppServer Progress (Obrigatório). Propriedade: progress.server.application Descrição: nome do serviço AppServer Progress (Obrigatório). Propriedade: progress.server.maxconnections Descrição: número Máximo de conexões com a AppServer Progress. É o mesmo número de agentes configurados no AppServer (Obrigatório). Abaixo um exemplo de configuração: #+-----------------------------------------------+ # CONFIGURACOES APPServer #+-----------------------------------------------+ progress.server.name = localhost progress.server.port = 5162 progress.server.application = Autorizador progress.server.maxconnections = 2 Para que o arquivo seja localizado pelo servidor de aplicações, deverá ser configurado no arquivo: C:\totvs\jboss- 4.2.3.GA\bin\run.bat ou C:\totvs\jboss-4.2.3.GA\bin\run.sh. A variável denominada: datasul.framework.properties Configuração para Windows: arquivo run.bat Versão 1.0 37
Título do documento Incluir a linha: set JAVA_OPTS=%JAVA_OPTS% -Ddatasul.framework.properties.dir= C:\totvs\autorizador\jboss-4.2.3-WAC.GA\server\default\conf Observação: as configurações acima já são realizadas no momento da instalação. 38 Versão 1.0
7. Inicialização e Acesso Está seção tem o objetivo de auxiliar nas configurações de acesso externo, inicialização e acesso ao sistema Autorizador. 7.1. Inicialização do Servidor Para iniciar o sistema, basta iniciar o serviço configurado pelo instalador. Localize o serviço denominado TOTVS- AUTORIZADOR-12.1 e inicie. Após o serviço iniciado, aguarde cerca de 2 minutos e realize o acesso pelo browser. Página Web do Autorizador para teste no servidor em que foi instalado: http://localhost:8081/autorizador Dados de acesso para usuário Administrador Usuário: medical Senha: medical01 Versão 1.0 39
Onde: Título do documento porta: O padrão é 8081, se foi reconfigurado pode-se verificar no arquivo C:\totvs\autorizador\jboss-4.2.3- WAC.GA\server\default\deploy\jboss-web.deployer\server.xml, procurar a tag correta usando como critério os atributos address e protocol: <Server> <!--... --> <Service name="jboss.web"> <!--... --> <Connector port="8081" address="${jboss.bind.address}"... protocol="http/1.1"... /> <!--... --> </Service> <!--... --> </Server> 40 Versão 1.0
8. Configurações de Memória Atualmente o Jboss vem configurado com 1024mb de memória. Segue abaixo os passos para aumentar a configuração de memória no sistema: Windows 1. Editar o arquivo C:\totvs\autorizador\jboss-4.2.3-WAC.GA\bin\run.bat com um editor de textos e procurar pelos parâmetros -Xms, -Xmx e -XX:MaxPermSize conforme o exemplo abaixo: 2. Os valores em vermelho representam a quantidade de memória configurada para o servidor de aplicações e devem ser alterados para o valor desejado. Xms1g Xmx1g XX:MaxPermSize=512m Linux 1. Editar o arquivo /totvs/jboss-4.2.3.ga/bin/run.sh com um editor de textos e procurar pelos parâmetros -Xms, - Xmx e -XX:MaxPermSize conforme o exemplo abaixo: Versão 1.0 41
Título do documento 2. Os valores em vermelho representam a quantidade de memória configurada para o servidor de aplicações e devem ser alterados para o valor desejado. Xms1g Xmx1g XX:MaxPermSize=512m Quantidade de Memória x Número de Sessões WEB A aplicação parte de uma configuração mínima de 1g nos parâmetros Xms e Xmx. A proporção de memoria máxima para cada usuário ativo na aplicação, equivale a 13mb. Então pode-se aumentar os parâmetros Xms e Xmx com 13mb para cada usuário conectado na aplicação. Ex: para 700 usuarios (sessões ativas na aplicação). 700 * 13 + 1024 = 10124 Xms12g Xmx12g XX:MaxPermSize=1g Obs: Deve-se deixar uma margem de segurança para que não haja problemas na aplicação e também para outros recursos do servidor de aplicações. 42 Versão 1.0