Guia de Configurao Datasul 11.5.

3
10/2012

Guia de Configurao Datasul 11.5.3

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

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

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

Guia de Configurao Datasul 11.5.3

Verso 1.0

Guia de Configurao Datasul 11.5.3

1.1

Prefcio

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

1.4

Guia de Instalao Datasul 11.5.3 (link);

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.

Guia de Configurao Datasul 11.5.3

Verso 1.0

Guia de Configurao Datasul 11.5.3

2.1

Arquivos de Configurao

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

Guia de Configurao Datasul 11.5.3

Verso 1.0

Guia de Configurao Datasul 11.5.3

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":
<appender name="FILE" class="org.jboss.logging.appender.DailyRollingFileAppender">
<errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>
<param name="File" value="${jboss.server.log.dir}/server.log"/>
<param name="Append" value="false"/>
<param name="Threshold" value="INFO"/>
<param name="DatePattern" value="'.'yyyy-MM-dd-HH"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%d %-5p [%c] %m%n"/>
</layout>
</appender>

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
'.'yyyy-MM
'.'yyyy-ww
'.'yyyy-MM-dd
'.'yyyy-MM-dd-a
'.'yyyy-MM-dd-HH
'.'yyyy-MM-dd-HH-mm

Perodo
Rotaciona o log a cada ms
Rotaciona o log a cada semana
Rotaciona o log a cada dia
Rotaciona o log a meia noite e meio dia a cada dia
Rotaciona o log a cada hora
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:

Guia de Configurao Datasul 11.5.3

Verso 1.0

Guia de Configurao Datasul 11.5.3

<category name="org.jgroups">
<priority value="WARN"/>
</category>
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 - <ID> - 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.

Guia de Configurao Datasul 11.5.3

Verso 1.0

Guia de Configurao Datasul 11.5.3

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.
<generate-database>: 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).
<deploy-applications>: 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.

Guia de Configurao Datasul 11.5.3

Verso 1.0

Guia de Configurao Datasul 11.5.3

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:
<mbean code="org.jboss.services.binding.ServiceBindingManager"
name="jboss.system:service=ServiceBindingManager">
<attribute name="ServerName">ports-8080</attribute>
<attribute name="StoreURL">${jboss.home.url}/binding/ports-bindings.xml</attribute>
<attribute name="StoreFactoryClassName">
org.jboss.services.binding.XMLServicesStoreFactory
</attribute>
</mbean>
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: ports8080, 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.

Guia de Configurao Datasul 11.5.3

Verso 1.0

Guia de Configurao Datasul 11.5.3

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 <Shortcut>, localizada dentro da tag <LocalShortcuts>. 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
Service-8x80.bat
Run.bat
Run.sh
Run.conf
Jboss-log4j.xml
Jboss-service.xml
Josso-agent-config.xml
Josso-gateway-config.xml
Datasul_framework.properties
Di.properties
Startup-state.xml
Progress-ds.xml
Oracle-ds.xml
Mail-service.xml
Config.xml

Jboss_home\binding\ports-bindings.xml
Jboss_home\bin\service-8x80.bat
Jboss_home\bin\run.bat
Jboss_home\bin\run.sh
Jboss_home\bin\run.conf
Jboss_home\server\instance-8x80\conf\datasul\jboss-log4j.xml
Jboss_home\server\instance-8x80\conf\jboss-service.xml
Jboss_home\server\instance-8x80\conf\josso-agent-config.xml
Jboss_home\server\instance-8x80\conf\josso-gateway-config.xml
Jboss_home\server\instance-8x80\conf\datasul\datasul_framework.properties
Jboss_home\server\instance-8x80\conf\datasul\di.properties
Jboss_home\server\instance-8x80\conf\datasul\startup-state.xml
Jboss_home\server\instance-8x80\deploy\progress-ds.xml
Jboss_home\server\instance-8x80\deploy\oracle-ds.xml
Jboss_home\server\instance-8x80\deploy\mail-service.xml
<Dir instalao>\ERP\scripts-8x80\config.xml

Guia de Configurao Datasul 11.5.3

Verso 1.0