Guia de Configuração - Datasul 11.5.3.pdf

Guia de Configurao Datasul 11.5.3

10/2012


2 Guia de Configurao Datasul 11.5.3

Verso 1.0

Sumrio

Sumrio ......................................................................................................................................................... 2

1 Prefcio ....................................................................................................................................... 3

1.1 Finalidade .................................................................................................................................... 3

1.2 Pblico Alvo ................................................................................................................................. 3

1.3 Documentaes Importantes ...................................................................................................... 3

1.4 Como utilizar este guia ................................................................................................................ 3

1.5 Atualizao do Guia ..................................................................................................................... 3

2 Arquivos de Configurao ........................................................................................................... 4

2.1 Bancos de Dados ......................................................................................................................... 4

2.2 AppServer .................................................................................................................................... 4

2.3 Log ............................................................................................................................................... 4

2.4 License Server .............................................................................................................................. 6

2.5 Configuraes do Servio Jboss................................................................................................... 6 2.5.1 Linux................................................................................................................................................................ 6

2.6 Parmetros de Memria ............................................................................................................. 7

2.7 Metadados .................................................................................................................................. 7

2.8 Time Out Flex .............................................................................................................................. 8

2.9 Josso ............................................................................................................................................ 8

2.10 Portas .......................................................................................................................................... 8

2.11 Sesso Progress ........................................................................................................................... 9

2.12 Localizao dos Arquivos............................................................................................................. 9



Verso 1.0

1 Prefcio

1.1 Finalidade

Este guia tem como finalidade descrever as configuraes do produto Datasul 11, demonstrando o arquivo onde

cada configurao feita, sem entrar em detalhes sobre a configurao do Jboss. Informaes adicionais podem ser

localizadas no captulo Documentaes Importantes.

1.2 Pblico Alvo

A complexidade do processo requer profissionais com conhecimento da arquitetura do produto Datasul 11,

Progress, Java, Flex, Jboss e ambiente de rede.

1.3 Documentaes Importantes

Manuais Jboss

Installation Guide;

Getting Started Guide;

Server Configuration Guide.

Estas e outras documentaes podem ser obtidas em Jboss AS Documentation e Jboss Wiki.

Manuais Totvs

Guia de Instalao Datasul 11.5.3 (link);

1.4 Como utilizar este guia

As configuraes neste guia esto capituladas por funcionalidade. No decorrer do guia citaremos apenas o nome do

arquivo onde a configurao feita. No captulo Localizao dos Arquivos esto listados os caminhos completos para a

localizao dos arquivos.

1.5 Atualizao do Guia

A verso atualizada deste guia encontra-se disponvel atravs do EConsultor, em formato de Kbase. Sempre que for

utiliz-lo recomendamos verificar este Kbase para garantir estar com a verso atualizada.

http://www.jboss.org/jbossas/docshttp://www.jboss.org/community/community/wikihttp://ingleses.datasul.com.br/scripts/econsultor.sbd/main.htm?kbid=47507http://ingleses.datasul.com.br/scripts/econsultor.sbd/main.htm?kbid=47520



Verso 1.0

2 Arquivos de Configurao

2.1 Bancos de Dados

Os bancos de dados emsdev, emsfnd, mdmerge, mdtfrw, finance, payroll, ems2sor e ems2cad so

acessados diretamente pelo Jboss. Para este acesso so criados datasources, atravs do arquivo progress-ds.xml (ambiente

Progress) ou oracle-ds.xml (ambiente Oracle).

Listaremos os atributos mais importantes e suas devidas funes:

jndi-name: Nome do Datasource (No pode ser alterado);

username: Usurio para conexo ao banco;

password: Senha para conexo ao banco;

connection-url: String de conexo JDBC ao banco de dados. Ex:

jdbc:datadirect:openedge://JAGUARIBE:23618;databaseName=emsdev

min-pool-size: Nmero mnimo de conexes ativas ao banco de dados;

max-pool-size: Nmero mximo de conexes ativas ao banco de dados;

Pode existir mais de uma conexo para o mesmo banco de dados, porm, com o JNDI diferente. Se for necessrio

fazer alguma alterao no arquivo, tome o cuidado de faz-la no local certo e para todos os datasources necessrios.

Para ambiente Progress o username deve ser PUB, pois as tabelas esto criadas abaixo deste usurio.

2.2 AppServer

A configurao do AppServer feita no arquivo datasul_framework.properties.

progress.server.name=JAGUARIBE progress.server.port=5162 progress.server.application=datasul-1151-progress-8080 progress.server.maxconnections=5

Onde:

progress.server.name: Servidor onde est configurado o broker AppServer; progress.server.port: Porta do NameServer; progress.server.application: Nome do broker AppServer; progress.server.maxconnections: Quantidade mxima de agentes que o Jboss poder utilizar.

Caso seja exibida a mensagem Erro ao obter conexo durante a execuo de um programa Flex, verifique se o

broker AppServer configurado neste arquivo est ativo e configurado corretamente.

2.3 Log



Verso 1.0

No JBoss a gerao de logs controlada pelo arquivo jboss-log4j.xml. Este arquivo define um conjunto de

"appenders", que so basicamente as sadas de log. Por padro, o JBoss est configurado com sadas para o console e para

um arquivo de log (server.log).

O nvel de log a ser configurado depende do tipo de informao que se quer obter. O produto Datasul 11 est

configurado com o log para "ERROR", o que significa que somente as mensagens de erro sero exibidas no arquivo. Esta a

configurao adequada para um ambiente de produo, para que mensagens informativas no sejam gravadas em log, o

que pode tornar o arquivo muito grande e difcil de ler.

Existem seis nveis de log: TRACE, DEBUG, INFO, WARN, ERROR e FATAL. Quando um desses nveis definido no

arquivo, todas as mensagens acima do nvel escolhido tambm sero registradas. Quer dizer, se for escolhido o nvel

"INFO", todas as mensagens iguais e superiores a este nvel sero escritas em log (INFO, WARN, ERROR e FATAL).

O exemplo abaixo de um appender com sada para arquivo, configurado para "INFO":

Para alterar o nvel de log, basta alterar o Threshold de "INFO" para o valor desejado. Aps a alterao no

necessrio reiniciar a instncia. O jboss-log4j.xml o nico arquivo de configurao do JBoss que no exige restart da

instncia. A alterao entra em vigor no mximo em 60 segundos aps salvar o arquivo.

Na configurao padro do produto o log rotate ser feito a cada hora. Ao incio de cada hora, o arquivo corrente de

log ser renomeado e o log ser gerado em outro arquivo, com o mesmo nome. Configure o log conforme sua necessidade,

visando no gerar arquivos com tamanho exagerado. Pode-se configurar o log rotate por: ms, semana, dia, metade do dia,

hora e minuto. Para fazer esta alterao, mudar o valor da opo DatePattern, conforme a tabela abaixo:

DatePattern Perodo

'.'yyyy-MM Rotaciona o log a cada ms

'.'yyyy-ww Rotaciona o log a cada semana

'.'yyyy-MM-dd Rotaciona o log a cada dia

'.'yyyy-MM-dd-a Rotaciona o log a meia noite e meio dia a cada dia

'.'yyyy-MM-dd-HH Rotaciona o log a cada hora

'.'yyyy-MM-dd-HH-mm Rotaciona o log a cada minuto

Alm dos Appenders podem ser criadas categorias. As categorias possuem configuraes especficas para

determinadas aplicaes. Por exemplo, voc pode manter o nvel de log como INFO, e configurar uma categoria para as

mensagens de determinada aplicao como WARN. O exemplo abaixo de uma categoria do componente org.jgroups

(cluster) configurado como WARN:



Verso 1.0

Dessa forma, para todas as aplicaes sero exibidas apenas as mensagens com o nvel ERROR, exceto as

mensagens da aplicao org.jgroups, que possui o nvel de log WARN.

Informaes sobre os nveis de log podem ser obtidas aqui.

2.4 License Server

A configurao do License Server (LS) feita no arquivo datasul_framework.properties, nos parmetros abaixo:

license.server=calixto

license.port=7777

license.timeout=20

license.showlog=none

Onde:

license.server: Endereo IP ou nome do LS;

license.port: Porta configurada para o LS (default 5555);

license.timeout: Tempo (segundos) para conexo com o LS. Se este tempo for atingido sem receber uma resposta do LS, ser solicitada

a chave de emergncia;

license.showlog: Nvel de log para as mensagens do LS. Os tipos permitidos so: none, all, error, debug, info (default: none).

Se no houver comunicao com o LS ou a licena estiver expirada, ser solicitada a chave de emergncia.

2.5 Configuraes do Servio Jboss

Na instalao padro do produto (ambiente Windows) criado pela mdia o servio TOTVS Datasul - - 8x80,

que responsvel pela carga do Jboss. Ao iniciar o servio executado o script service-8x80.bat, o qual gerencia o

servio, alm de efetuar a chamada da linha de execuo do Jboss.

No arquivo run.bat est configurada a varivel JAVA_OPTS. Esta a varivel de ambiente padro para a

configurao de parmetros do Java. Observando os arquivos service-8x80.bat e run.bat podemos verificar que esta

varivel definida vrias vezes, geralmente concatenando o valor antigo e incluindo outros parmetros e valores. Caso

exista a necessidade de incluir um novo parmetro, pode-se incluir em qualquer um destes dois arquivos. A diferena bsica

que o arquivo run.bat utilizado para todas as instncias, sendo que os parmetros definidos neste arquivo sero os

mesmos para todas as instncias. J o arquivo service-8x80.bat utilizado por instncia, nos dando a possibilidade de

definir valores diferenciados para cada uma das instncias.

2.5.1 Linux

O Jboss instalado atravs da mdia somente para ambiente Windows. Para ambientes onde o Jboss est

configurado em um servidor Linux, a carga do Jboss feita atravs do script run.sh, sendo que as configuraes da

varivel JAVA_OPTS devem ser feitas no arquivo run.conf.

http://docs.jboss.org/process-guide/en/html/logging.html



Verso 1.0

Para a configurao do Jboss em servidor Linux recomenda-se a leitura deste kbase.

2.6 Parmetros de Memria

Para obter a performance ideal na utilizao do produto, necessrio configurar corretamente os parmetros de

memria da JVM. Estas configuraes esto definidas na varivel JAVA_OPTS, citada anteriormente. No padro instalado

pela mdia os parmetros de memria esto definidos no run.bat, indicando que os valores ali alterados sero para todas

as instncias. Recomendamos remover esta configurao deste arquivo e coloc-la no service-8x80.bat (de acordo com a

instncia), para que a configurao de memria seja diferente para cada instncia.

Segue abaixo exemplo da linha com os parmetros de memria do Java (padro da mdia de instalao):

set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx768m -Xss128k -XX:MaxPermSize=512m -XX:+UseParallelGC -

XX:ParallelGCThreads=10

Abaixo uma breve descrio de cada um desses parmetros:

Xms: Parmetro de memria que define o mnimo de memria para a aplicao;

Xmx: Parmetro de memria que define o mximo de memria para a aplicao;

Xss: Tamanho da pilha reservada para cada thread;

XX:MaxPermSize: Tamanho mximo da rea de objetos permanentes em memria;

-XX:+UseParallelGC: Habilita o Garbage Collector para abrir vrias thread e atuar paralelamente;

-XX:ParallelGCThreads: Nmero de thread que sero abertas para GC. Por default aberto uma Thread para cada

processador.

Em um ambiente de produo o ideal que o valor do Xms e Xmx estejam iguais. Configurando dessa forma o

Garbage Collector ser executado com menor freqncia. Para obter o valor ideal de memria necessrio um

monitoramento da JVM.

2.7 Metadados

As informaes para a carga do Metadadados esto localizadas no arquivo startup-state.xml. Os atributos esto

listados abaixo:

metadatapath: Diretrio onde encontram-se as informaes para a carga do Metadados.

: Esse atributo indica ao servidor de aplicao (JBOSS) que ele deve iniciar gerando a base de dados do

metadados. Lembrando que o servidor gerar os dados na base de acordo com os xmls contidos no atributo metadataPath

que se encontra no mesmo arquivo. Pode receber os valores true (realiza a gerao) ou false (ignora a gerao).

: Esse atributo indica ao servidor de aplicao (JBOSS) que ele deve iniciar gerando todos os

formulrios do produto padro. Pode receber os valores true (realiza a gerao) ou false (ignora a gerao).

Ao instalar ou atualizar o produto Datasul 11, na primeira carga do Jboss estes atributos estaro com o valor true,

o que realizar a gerao das informaes. Se esta carga for efetuada sem erros, o valor ser automaticamente alterado

para false. Esse arquivo de extrema importncia, pois alm de gerar o start do produto ele pode ser usado para

restaurar os padres de fbrica.

http://ingleses.datasul.com.br/scripts/econsultor.sbd/main.htm?kbid=43783



Verso 1.0

2.8 Time Out Flex

A configurao do Time Out do Flex feita atravs do arquivo datasul_framework.properties:

session.timeout=30

session.timeout.message=2

Onde:

session.timeout: Tempo (minutos) que a sesso Web fica ativa sem nenhuma interao do usurio com o sistema;

session.timeout.message: Indica quanto tempo (minutos) antes do session.timeout ser exibida a mensagem ao usurio de

que a sesso est prestes a expirar.

2.9 Josso

Josso, ou Java Open Single Sign-On, uma infra-estrutura opensource que prov uma soluo centralizada de

autenticao e autorizao de usurios. o componente utilizado para o login dos usurios no produto Datasul 11.

As informaes de conexo ao Josso encontram-se no arquivo josso-agent-config.xml. Neste arquivo sero

encontradas trs entradas com o nome do servidor e a porta. Caso seja necessrio alterar o nome do servidor, essas

entradas devero ser alteradas.

No arquivo josso-gateway-config.xml esto as configuraes de autenticao no Ldap. Ao editar o arquivo voc

encontrar o usurio utilizado para localizar as informaes no Ldap, bem como a senha em clear text. Caso a senha seja

alterada pode-se editar o arquivo e fazer a alterao manualmente. Outra alternativa executar o script Dominio.vbs,

que solicita em tela as informaes e gera um arquivo (LogDominio.txt) com as informaes necessrias para inserir no

arquivo.

2.10 Portas

No arquivo Jboss-service.xml definido o conjunto de portas a ser utilizado pela instncia. No exemplo abaixo, o

atributo ServerName est apontando para o conjunto de portas ports-8080:

ports-8080 ${jboss.home.url}/binding/ports-bindings.xml org.jboss.services.binding.XMLServicesStoreFactory

O atributo StoreURL aponta para o arquivo ports-bindings.xml, que o arquivo onde se encontram os conjuntos

de portas a serem utilizados. Pelo padro instalado pela mdia existem seis conjuntos de portas definidos no arquivo: ports-

8080, ports-8180, ports-8280, ports-8380, ports-8480 e ports-8580. A recomendao alterar estas configuraes somente

para ambiente Linux (visto que a mdia no configura a instncia para Linux) e quando necessitar de mais instncias do que

as portas configuradas no ports-bindings.xml permitem.



Verso 1.0

Se for necessrio alterar alguma das portas, verifique nos arquivos datasul_framework.properties e jboss-service.xml se

existe tambm alguma referncia a esta mesma porta, pois que nestes arquivos tambm existem algumas portas

configuradas. A lgica somar 100 portas para a instncia 8180, 200 para a instncia 8280, etc.

2.11 Sesso Progress

Na primeira execuo de um programa Progress no Datasul 11 em cada estao, a tela Configurao de Acesso

ser apresentada. No campo Atalho de Execuo possvel selecionar o atalho para a execuo dos programas Progress.

As informaes desta tela so armazenadas no arquivo config.xml. Neste arquivo, voc pode alterar o atalho padro ou

ainda criar outros atalhos (para execuo do clientlog, por exemplo).

Para criar um novo atalho duplique a tag , localizada dentro da tag . Altere as

informaes desejadas na nova linha criada (Description, Ini, Pf e Alias) e salve o arquivo. Aps a alterao necessrio

reiniciar o Jboss para que a alterao efetuada tenha efeito.

Neste mesmo arquivo esto localizadas as informaes para o acesso remoto ao produto (Citrix, GoGlobal ou

Terminal Server). Para mais informaes sobre esta configurao consulte o Guia de Instalao, captulo Acesso Remoto.

A referncia para a localizao do arquivo config.xml encontra-se no arquivo di.properties. Ao abrir este arquivo

localizado o atributo config.path, que possui como valor o caminho completo para a localizao do arquivo config.xml.

2.12 Localizao dos Arquivos

Ports-bindings.xml Jboss_home\binding\ports-bindings.xml

Service-8x80.bat Jboss_home\bin\service-8x80.bat

Run.bat Jboss_home\bin\run.bat

Run.sh Jboss_home\bin\run.sh

Run.conf Jboss_home\bin\run.conf

Jboss-log4j.xml Jboss_home\server\instance-8x80\conf\datasul\jboss-log4j.xml

Jboss-service.xml Jboss_home\server\instance-8x80\conf\jboss-service.xml

Josso-agent-config.xml Jboss_home\server\instance-8x80\conf\josso-agent-config.xml

Josso-gateway-config.xml Jboss_home\server\instance-8x80\conf\josso-gateway-config.xml

Datasul_framework.properties Jboss_home\server\instance-8x80\conf\datasul\datasul_framework.properties

Di.properties Jboss_home\server\instance-8x80\conf\datasul\di.properties

Startup-state.xml Jboss_home\server\instance-8x80\conf\datasul\startup-state.xml

Progress-ds.xml Jboss_home\server\instance-8x80\deploy\progress-ds.xml

Oracle-ds.xml Jboss_home\server\instance-8x80\deploy\oracle-ds.xml

Mail-service.xml Jboss_home\server\instance-8x80\deploy\mail-service.xml

Config.xml \ERP\scripts-8x80\config.xml

Documents

Guia de Configuração - Datasul 11.5.3.pdf