Академический Документы
Профессиональный Документы
Культура Документы
3
Roteiro de Instalao e Configurao
Fevereiro 2014
Ttulo do documento
ndice
1.
2.
Introduo.................................................................................................................................................. 5
3.
Pr-Requisitos ........................................................................................................................................... 6
3.1.
3.2.
3.3.
4.
4.1.
4.2.
4.3.
5.
5.1.
5.2.
6.
6.1.
7.
7.1.
8.
Configuraes de Memria...................................................................................................................... 41
Verso 1.0
Ateno:
Copyright 2014 TOTVS. Todos os direitos reservados.
Nenhuma parte deste documento pode ser copiada, reproduzida, traduzida ou transmitida por qualquer meio
eletrnico ou mecnico, na sua totalidade ou em parte, sem a prvia autorizao escrita da TOTVS, que se reserva
o direito de efetuar alteraes sem aviso prvio. A TOTVS no assume qualquer responsabilidade pelas
consequncias de quaisquer erros ou inexatides que possam aparecer neste documento.
TOTVS S.A.
Av. Braz Leme, 1717 So Paulo-SP
Brasil www.totvs.com
Verso 1.0
Ttulo do documento
1. Histrico de Alteraes
Data
Verso
Descrio
14/12/2011
1.0
11/07/2013
1.1
27/05/2014
1.2
30/09/2014
1.3
Reviso do Documento
03/12/2014
1.4
11/02/14
1.5
Criao do documento
Incluso do Instalador
Reviso do Documento
Verso 1.0
2. Introduo
A finalidade deste documento descrever um Roteiro para Instalao e Configurao do Autorizador Web para a
utilizao em uma nova instalao.
Ateno: Nesta mdia disponibilizado o instalador do JBOSS para sua convenincia, no entanto dvidas sobre sua
instalao e configuraes de componentes nativos devem ser direcionadas ao suporte do fornecedor do JBOSS.
Depois que o produto j estiver em operao a TOTVS disponibilizar no Portal de Clientes atualizaes do produto
englobando alteraes para correes de erros, correes legais e novas implementaes.
Para efetuar a atualizao de seu ambiente devero ser seguidos os procedimentos indicados neste guia; sendo
necessrio algum auxlio adicional favor entrar em contato com o servio de consultoria.
Verso 1.0
Ttulo do documento
3. Pr-Requisitos
Segue abaixo os requisitos mnimos e recomendveis para o funcionamento do sistema Autorizador Web.
Banco de dados suportados: Oracle 10g ou superior, SQL Server 2005/2008 e Progress 10.2B ou superior.
Acesso ao AppServer Progress para comunicao com Gesto de Planos Progress (Datasul12).
Google Chrome.
Verso 1.0
Verso 1.0
Ttulo do documento
3. Selecione a Unidade de Disco em que ser realizada a instalao. Ser criada uma pasta TOTVS na unidade
de destino. Clique em Avanar.
Verso 1.0
4. Selecione qual tipo de banco de dados o Autorizador Web ir utilizar e clique em Avanar. Caso tipo
selecionado for Progress, na prxima tela ser necessrio informar o diretrio de instalao do progress.
Verso 1.0
Ttulo do documento
10
Verso 1.0
8. Informe os dados de acesso ao banco de dados. Esta informao ser utilizada para configurar o acesso ao
banco de dados do Autorizador configurado na pasta deploy do Jboss. Clique em Avanar.
Verso 1.0
11
Ttulo do documento
9. Informe o nome do usurio 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 Avanar.
12
Verso 1.0
Verso 1.0
13
Ttulo do documento
14
Verso 1.0
Verso 1.0
15
Ttulo do documento
4.2. Instalao do Java para Windows
1. Aps ter finalizado o download, execute o instalador.
2. Na prxima tela aparecero s opes de instalaes do JAVA. Deixe as opes padro e clique em Next.
16
Verso 1.0
3. Aps a finalizao da barra de progresso, ser exibida a tela abaixo indicando que a instalao do JRE. Clique
em Next para continuar.
Verso 1.0
17
Ttulo do documento
18
Verso 1.0
Para a configurao da varivel de ambiente no Windows ME/2000/XP, voc deve fazer da seguinte maneira:
Clique com o boto direito em Meu computador\Propriedades\Avanado\Variveis de ambiente.
Verso 1.0
19
Ttulo do documento
6. Clique em Variveis de ambiente e logo aps clique em Novo e crie varivel JAVA_HOME com o valor C:\Program
Files\Java\jdk1.8.0_05 conforme a imagem abaixo:
20
Verso 1.0
Verso 1.0
21
Ttulo do documento
4.3. Instalao do Java para Linux
1. Acesse com o usurio Root.
2. Coloque na pasta opt o arquivo jdk-6u18-linux-i586-rpm-bin baixado.
3. Conceda permisso de execuo 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 instalao.
5. Pressione a barra de espao (teclado) e digitando yes para concluir instalao:
#./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
No mais necessrio fazer as configuraes do profile da ltima verso do Java, como outros software fazem
referncia
variveis
de
ambiente
do
Linux,
configure:
1. Abra o arquivo /etc/profile com o editor de texto de sua preferncia (faa isso com ROOT):
# vi /etc/profile
2. Antes do PATH e EXPORT acrescente as seguintes linhas:
# Variaveis ambiente adicionadas para configurao 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, usurio e execute o comando abaixo para carregar as novas modificaes.
# exit
$ source /etc/profile
Abra um terminal e digite:
22
Verso 1.0
$ java -version
$ javac -version
Verso 1.0
23
Ttulo do documento
5. Banco de Dados
Neste captulo sero centralizadas todas as configuraes referentes a banco de dados. Nas sees a seguir
descrevemos os passos necessrios para fazer a criao do banco de dados do sistema para as verses Oracle.
sqlplus atr_saude_web/atr_saude_web@ora10g
7. Aps
conexo,
execute
script
do
banco
que
se
encontra
no
diretrio
(C:\totvs\autorizador\database\definicoes).
8. Execute o script de criao das tabelas: schema_oficial.sql.
9. Execute o script de carga de dados: carga_dados.sql.
24
Verso 1.0
2. Clique no menu Database /Create. Ser exibida a janela conforme a imagem abaixo:
Verso 1.0
25
Ttulo do documento
3. Clique em Files e selecione o local C:\totvs\autorizador\database(Criar os diretrios caso no exista) para criar
os arquivos do banco. Ex.: .db do Progress. O nome padro para o arquivo do banco de dados ser atrsaude
conforme a imagem abaixo:
Observaes: Os arquivos .db so 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
Verso 1.0
4. Clique em OK.
5. Na tela seguinte clique novamente em OK.
6. Para conexo ao banco de dados necessrio criar o usurio sysprogress. No Database Administration, acesse:
Admin/Security/Edit User List.
Verso 1.0
27
Ttulo do documento
7. Ser exibida a tela para edio de usurios para o banco de dados recm criado.
8. Clique em Add.
9. Na prxima tela preencha os campos da seguinte forma:
a.
28
Verso 1.0
15. Aps a criao dos arquivos, inicie a base de dados e a acesse para executar os scripts SQL.
Ateno: 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
necessrio.
17. Como o broker iniciado do tipo SQL, no podemos usar o Editor do Progress para criar as tabelas. A ferramenta
utilizada o sqlexp encontrado na pasta bin da instalao do Progress.
18. Para se autenticar no banco de dados, ser necessrio 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:
Verso 1.0
29
Ttulo do documento
21. Aps executar os comandos acima, saia do SQLExplorer(comando quit;) e conecte novamente com o usurio
'atrsaudeweb'.
%DLC%\bin\sqlexp -db C:\totvs\autorizador\database\atrsaude -S 10000 -user atrsaudeweb -password
atrsaudeweb
30
Verso 1.0
Verso 1.0
31
Ttulo do documento
5.2. Configurao do Banco de Dados
A configurao do Banco de Dados realizada no DataSource Descriptor que se encontra no diretrio
C:\totvs\autorizador\jboss-4.2.3-WAC.GA\server\default\deploy. O padro 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 diretrio docs\examples\jca h modelos para vrios 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>
Observao: O instalador j solicita as informaes necessrias para a configurao deste arquivo. Somente altere
este arquivo em caso de mudana na configurao aps a instalao.
32
Verso 1.0
6. Criao do AppServer
O AppServer ser utilizado para fazer a comunicao entre o Autorizador e Gesto de Planos/Datasul11. Segue abaixo
os dados para criao do AppServer.
1. Criao do novo AppServer (AutorizadorWEB).
2. Configuraes do AppServer:
Verso 1.0
33
Ttulo do documento
3. Para acessar as configuraes clique com o boto direito do mouse no AppServer criado e clique em propriedades.
4. Na Opo Broker altere o diretrio de trabalho, para o qual for utilizado, se necessrio altere a porta de
comunicao, lembrando que dois AppServers no funcionam na mesma porta.
5. Na opo Agente\Geral pode ser alterada as configuraes de parmetros de inicializao do servidor, Propath e
o caminho para gerao do log.
Observao: Para clientes que utilizam banco de dados unificado, necessrio a criao do arquivo de alias e a
configurao no AppServer.
Exemplo:
34
Verso 1.0
Observao: Nas verses mais atuais do Progress, essa configurao no feita no Progress Explorer Tools e ocorre
atravs de do web console conforme a imagem abaixo:
Verso 1.0
35
Ttulo do documento
36
Verso 1.0
Propriedade: progress.server.name
Propriedade: progress.server.port
Propriedade: progress.server.application
Propriedade: progress.server.maxconnections
Descrio: nmero Mximo de conexes com a AppServer Progress. o mesmo nmero de agentes configurados
no AppServer (Obrigatrio).
#+-----------------------------------------------+
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 aplicaes, dever ser configurado no arquivo: C:\totvs\jboss4.2.3.GA\bin\run.bat ou C:\totvs\jboss-4.2.3.GA\bin\run.sh.
A varivel denominada: datasul.framework.properties
Configurao para Windows: arquivo run.bat
Verso 1.0
37
Ttulo 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
38
Verso 1.0
7. Inicializao e Acesso
Est seo tem o objetivo de auxiliar nas configuraes de acesso externo, inicializao e acesso ao sistema Autorizador.
Verso 1.0
39
Ttulo do documento
Onde:
porta: O padro 8081, se foi reconfigurado pode-se verificar no arquivo C:\totvs\autorizador\jboss-4.2.3WAC.GA\server\default\deploy\jboss-web.deployer\server.xml, procurar a tag correta usando como critrio os
atributos address e protocol:
<Server>
<!-- ... -->
<Service name="jboss.web">
<!-- ... -->
<Connector port="8081" address="${jboss.bind.address}" ...
protocol="HTTP/1.1" ... />
<!-- ... -->
</Service>
<!-- ... -->
</Server>
40
Verso 1.0
8. Configuraes de Memria
Atualmente o Jboss vem configurado com 1024mb de memria. Segue abaixo os passos para aumentar a configurao
de memria 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 parmetros
Linux
1. Editar o arquivo /totvs/jboss-4.2.3.GA/bin/run.sh com um editor de textos e procurar pelos parmetros -Xms, Xmx e -XX:MaxPermSize conforme o exemplo abaixo:
Verso 1.0
41
Ttulo do documento
A aplicao parte de uma configurao mnima de 1g nos parmetros Xms e Xmx. A proporo de memoria mxima
para cada usurio ativo na aplicao, equivale a 13mb. Ento pode-se aumentar os parmetros Xms e Xmx com 13mb para
cada usurio conectado na aplicao.
Ex: para 700 usuarios (sesses ativas na aplicao). 700 * 13 + 1024 = 10124
Xms12g Xmx12g XX:MaxPermSize=1g
Obs: Deve-se deixar uma margem de segurana para que no haja problemas na aplicao e tambm para outros recursos
do servidor de aplicaes.
42
Verso 1.0