Professional Documents
Culture Documents
7
TOTVS S.A.
Sumrio
Captulo 1 - Instalao Datasul 12
1 Finalidade
................................................................................................................................... 5
Pblico Alvo
.......................................................................................................................................................... 5
Organizao
..........................................................................................................................................................
deste Guia
5
Docum entos
..........................................................................................................................................................
Im portantes
6
2 Introduo
................................................................................................................................... 6
Arquitetura
..........................................................................................................................................................
Distribuda do Produto
6
Tipos de Instalao
.......................................................................................................................................................... 7
Alertas.........................................................................................................................................................
durante a instalao
8
3 Requisitos
...................................................................................................................................
Mnimos
8
Viso Geral
..........................................................................................................................................................
dos Requisitos
9
Requisitos
..........................................................................................................................................................
de Hadw are
11
Requisitos
.........................................................................................................................................................
para estao client
11
Requisitos
.........................................................................................................................................................
para servidor
11
Requisitos
..........................................................................................................................................................
de Softw are
12
Sistema
.........................................................................................................................................................
Operacional
12
Progress
......................................................................................................................................................... 12
Java ......................................................................................................................................................... 13
Flash .........................................................................................................................................................
Player e Navegador
13
Ferramentas
.........................................................................................................................................................
de Acesso Remoto
13
Requisitos
.........................................................................................................................................................
para bancos Oracle
14
Requisitos
.........................................................................................................................................................
para bancos SQL Server
15
Requisitos
..........................................................................................................................................................
de Usurio (Servidor)
15
4 Instalao
................................................................................................................................... 15
Detalhes da
..........................................................................................................................................................
Mdia de Instalao
15
Planejando
..........................................................................................................................................................
a Instalao
15
Multi-Empresa
.........................................................................................................................................................
Industrial / Segurana por Estabelecimento
16
Instalao.......................................................................................................................................................... 16
Instalao..........................................................................................................................................................
de Program as
17
Instalao..........................................................................................................................................................
de Banco de Dados
19
Banco Progress
.......................................................................................................................................................... 19
Configurao
.........................................................................................................................................................
do Progress Explorer Tool
21
Objetos
.........................................................................................................................................................
criados na instalao de Banco de Dados Progress
21
Sistemas
.........................................................................................................................................................
Operacionais Unix / Linux
22
Criao
.........................................................................................................................................................
dos bancos com acesso SQL
22
Bancos Oracle
.......................................................................................................................................................... 23
Objetos
.........................................................................................................................................................
criados na instalao dos Bancos de Dados Oracle
24
Criao
.........................................................................................................................................................
de Objetos no Banco Oracle
24
Bancos SQL
..........................................................................................................................................................
Server
24
Objetos
.........................................................................................................................................................
criados na instalao dos Bancos de Dados SQL Server
25
Criao
.........................................................................................................................................................
de Objetos no Banco SQL Server
25
Conexo
.........................................................................................................................................................
SQL Server
26
Instalao..........................................................................................................................................................
do Servidor de Aplicao
26
Objetos
.........................................................................................................................................................
criados na instalao do Servidor de Aplicao
29
Instalao..........................................................................................................................................................
da Docum entao
30
Inicializando
..........................................................................................................................................................
o Datasul 12
30
Acesso ao
..........................................................................................................................................................
Datasul 12
32
Acesso Rem
..........................................................................................................................................................
oto
32
Ajustes aps
..........................................................................................................................................................
instalao
32
Permisso
.........................................................................................................................................................
de Sequences
32
TOTVS S.A.
Contents
Configurao
.........................................................................................................................................................
para acesso aos programas Progress
33
Configurao
.........................................................................................................................................................
para acesso ao Gesto de Planos
33
Configurao
.........................................................................................................................................................
de envio de e-mail com autenticao
33
Matriz.........................................................................................................................................................
de Traduo no EMS 5
34
Instalao
.........................................................................................................................................................
do Plug-in CRM Outlook
34
Verificao
.........................................................................................................................................................
do ambiente aps instalao
35
5 Atualizao
................................................................................................................................... 36
6 Reinstalao
................................................................................................................................... 36
7 Desinstalao
................................................................................................................................... 36
37
1 Finalidade
................................................................................................................................... 37
Pblico Alvo
.......................................................................................................................................................... 37
Docum entaes
..........................................................................................................................................................
Im portantes
37
Com o utilizar
..........................................................................................................................................................
este guia
38
2 Arquivos
...................................................................................................................................
de configurao
38
Bancos de..........................................................................................................................................................
Dados
38
AppServer
.......................................................................................................................................................... 39
Log
.......................................................................................................................................................... 40
License Server
.......................................................................................................................................................... 42
Acerto.........................................................................................................................................................
Arquivo de Licena
43
Configurao
..........................................................................................................................................................
do Servio Jboss
44
Linux ......................................................................................................................................................... 44
Segurana
.........................................................................................................................................................
JBOSS
44
Parm etros
..........................................................................................................................................................
de Mem ria
47
Tim e Out ..........................................................................................................................................................
Flex
48
Josso
.......................................................................................................................................................... 49
Configurao
.........................................................................................................................................................
de acesso externo
49
Portas .......................................................................................................................................................... 50
Sesso Progress
.......................................................................................................................................................... 50
Menu
.......................................................................................................................................................... 51
RFI Portal
..........................................................................................................................................................
de Cotaes
51
Mail Service
......................................................................................................................................................... 52
Localizao
..........................................................................................................................................................
dos Arquivos
52
3 Conexo
...................................................................................................................................
DataSource Progress
53
4 Configurao
...................................................................................................................................
do Datasul 12 com HTTPS
55
5 Listagem
...................................................................................................................................
de bancos de dados dos produtos Datasul
55
60
1 Introduo
................................................................................................................................... 60
2 Configurao
...................................................................................................................................
HTTPS com FrontEnd Apache Windows 32Bits
60
Apache HTTP
..........................................................................................................................................................
Server
60
Iniciar a instalao
..........................................................................................................................................................
do Apache.
61
Configurar
..........................................................................................................................................................
m od_jk para loadbalance
61
Configurar
..........................................................................................................................................................
SSL
69
3 Tunning
...................................................................................................................................
Apache
71
Sistem a Operacional
.......................................................................................................................................................... 71
Configuraes
.......................................................................................................................................................... 71
4 Acerto
...................................................................................................................................
Ambiente
73
73
1 Introduo
................................................................................................................................... 73
TOTVS S.A.
4 Acesso
...................................................................................................................................
remoto com GoGlobal
98
Acertos ..........................................................................................................................................................
GoGlobal 4
103
TOTVS S.A.
Instalao Datasul 12
Instalao Datasul 12
1.1
Finalidade
Este guia tem como finalidade descrever de forma objetiva, os procedimentos necessrios para a
instalao do produto Datasul 12, bem como configurar o produto nas plataformas suportadas. A mdia de
instalao tambm poder ser utilizada para atualizao de programas.
1.1.1
Pblico Alvo
Por este processo de instalao ser complexo, a instalao requer pessoas que tenham conhecimentos
da arquitetura do produto Datasul 12, banco de dados (Progress/Oracle/SQL Server), Java, Flex, Jboss e
ambiente de rede.
1.1.2
TOTVS S.A.
1.1.3
Documentos Importantes
Manuais Progress
Getting Started Installation and Configuration;
Getting Started Preinstallation Checklist for Windows;
Getting Started Preinstallation Checklist for Unix;
Getting Started Database Essentials;
Data Management Database Administration;
Application Server Administration.
Estas e outras documentaes podem ser obtidas no site da Progress.
Manuais Jboss
Installation Guide;
Getting Started Guide;
Server Configuration Guide.
Estas e outras documentaes podem ser obtidas em Jboss AS Documentation e Jboss Wiki.
1.2
Introduo
1.2.1
TOTVS S.A.
Instalao Datasul 12
1.2.2
Tipos de Instalao
Para o funcionamento do produto, necessrio executar a instalao de Programas, Bancos de
Dados e Servidor de Aplicao:
Programas
Instala os programas para utilizao do produto, assim como outros arquivos necessrios para
execuo do mesmo.
Banco de Dados
Instala e configura os bancos de dados utilizados pelo produto, assim como os scripts para
carregar e derrubar esses bancos.
Servidor de Aplicao
Instala e configura o Jboss, assim como o Datasul Interactive, sendo esses componentes
essenciais para o funcionamento do produto.
TOTVS S.A.
Documentao
Instala os manuais e documentao do produto.
ATENO: Esta mdia preparada para instalao de vrias instncias do produto Datasul
12 no mesmo servidor. Este procedimento consiste em instalar mltiplas cpias das opes
de Banco de Dados, Servidor de Aplicao e Documentao, respeitando o limite mximo de
seis instncias. Cada instncia instalada ser nomeada com base na porta principal utilizada
pelo Jboss, seguindo a seqncia 8080, 8180, 8280, 8380, 8480 e 8580. As pastas, scripts e
servios utilizados na primeira instalao das opes citadas, sero nomeados com o
identificador 8080. Para instalar uma segunda instncia destas opes, basta abrir o
instalador da mdia e executar novamente estas mesmas opes. A cada execuo ser
instalada uma nova cpia e nomeada com base na seqncia descrita acima. A rea de
programas ser a mesma no ambiente e ser compartilhada por todas as instncias.
1.2.2.1
Durante a instalao dos produtos Datasul pode ser apresentado alerta para clientes que usam
determinados antivrus, acusando a identificao de vrus nos arquivos dos diretrios OCX e Interfac.
Isso ocorre em funo dos arquivos executarem rotinas que alguns antivrus identificam como vrus. No
entanto, no se caracterizam instrues deste tipo. Desta forma, a mensagem apresentada pode ser
desconsiderada.
1.3
Requisitos Mnimos
Este captulo tem por objetivo divulgar recomendaes sobre o uso de hardware e software
relacionados ao Datasul 12 e algumas informaes sobre a configurao dos mesmos. Estas
recomendaes tm por inteno ajudar os clientes na configurao do ambiente, utilizando-o ao
mximo, obtendo uma melhor relao custo/benefcio. Porm, no representam compromissos com
tecnologias ou algum fornecedor em especial por parte da TOTVS. A deciso sobre a tecnologia e
fornecedor de competncia do cliente, bem como o nvel de servio, segurana e confiabilidade que
deseja do seu ambiente. As posies deste guia tambm podem ser alteradas, isto devido evoluo das
tecnologias e dos nossos produtos.
importante lembrar que o ambiente Web utilizado pelo Datasul 12 possui maior complexidade
que um ambiente client/server padro, como por exemplo, EMS 2, EMS 5, etc. A correta configurao e
TOTVS S.A.
Instalao Datasul 12
tuning do ambiente (servidores, redes, clients, banco de dados, etc.) so importantes para o
funcionamento do Datasul 12, pois caso parte do ambiente esteja mal configurado, o desempenho do
produto como um todo ser afetado.
As recomendaes e exemplos citados adiante levam em considerao somente os softwares
relacionados ao Datasul 12 e softwares de uso genrico, como Office e e-mail. Caso sejam instalados
outros softwares no mesmo ambiente, os mesmos devem ser levados em considerao, sendo que os
requisitos descritos podem no ser o suficiente para a execuo de todas as rotinas.
As configuraes de Infra Estrutura (DMZ, rede, etc) e softwares de terceiros (Sistemas
Operacionais, Java, etc) necessrias para o funcionamento do produto so de responsabilidade do
cliente. Caso necessite do apoio de uma equipe de Infra Estrutura, entre em contato com a TOTVS Infra
Services pelo email tis.comercial@totvs.com.br ou entrar em contato pelo nmero 4003-0015 nas
opes 3, 4, 2 - Central de Agendamento TIS.
1.3.1
Servidor
30 us u ri os (s em cons i dera r DCFW, Ci tri x e outros )
Hardware
Disco
120 GB
Memria
4 GB
Processador
Sistema Operacional
Windows Server
Linux
Java
JRE 1.7.75
OpenEdge
10.2B08
OpenEdge
Para os sistemas operacionais citados so enviados os scripts de carga e shutdown do Jboss para
comodidade do cliente. Para a configurao destes scripts em outros sistemas operacionais, entre em
contato com o suporte do Jboss em sua localidade ou acesse a consultoria telefnica da TOTVS para
acompanhamento.
TOTVS S.A.
10
A partir da verso 12.1.1 ser liberado a mdia para Progress 10.2B e uma mdia para Progress 11.3.3,
onde o cliente deve fazer o download conforme o planejamento de migrao do ambiente.
No Progress 11.3 foi liberado a execuo de programas com client 64-bits (prowin.exe), porm o Datasul
12 est homologado para ser executado somente com client 32-bits (prowin32.exe).
Para clientes que utilizam Progress 11.3 com Oracle devem aplicar o service pack 3 e o FIX 017
(11.3.3.017).
Para clientes que utilizam Progress 11.5 com Oracle devem aplicar o service pack 1 e o FIX 005
(11.5.1.005).
Estao Client
Wi ndows
Hardware
2 GB Mnimo
Processador
Resoluo de Tela
Flash
Flash Player 10
Navegadores
Internet Explorer 9
Internet Explorer 10
Internet Explorer 11
Firefox 3.5 e 7
Chrome
Java
Para a estao client mesmo que possuindo sistema operacional 64-bits recomenda-se que seja feita a
instalao JRE 32-bits, isso devido aos aplicativos utilizados pelo Datasul serem 32-bits.
TOTVS S.A.
Instalao Datasul 12
1.3.2
Requisitos de Hadware
1.3.2.1
11
No recomendamos o uso de estaes menores que o mnimo acima citado, pois o desempenho
no atender s necessidades dos usurios. Caso a empresa possua muitas estaes com
configuraes inferiores a mnima recomendada, sugerimos utilizar o recurso de Servidores de Terminais
Grficos que utilizar o hardware j existente.
A configurao recomendada atende a maioria dos usurios, contudo, para usurios mais
exigentes talvez exista a necessidade de uma configurao melhor. Compreenda-se usurio mais
exigente por aquele que utilize processos mais pesados (necessidade de uma CPU melhor e uma placa
de rede mais rpida e/ou ligada em uma porta de switch dedicada para ele) ou de um usurio que use
vrias aplicaes simultneas (necessidade de mais memria para executar processos como Office, email, CAD, EIS, etc., ao mesmo tempo).
Recomendamos a configurao mnima acima citada para novos equipamentos, caso a empresa
venha adquirir novas estaes e queira utiliz-las por um longo tempo sem necessidade de upgrade e
sem ficarem obsoletos. Tambm foram levadas em considerao s configuraes que os fornecedores
de hardware esto oferecendo atualmente e que tenham uma boa relao custo/benefcio.
Para todos os casos recomendamos a utilizao de placas de rede de fornecedores de primeira
linha.
1.3.2.2
Para os demais tipos de instalao, como Servidor de Aplicao, Banco de Dados e Programas,
recomendamos a utilizao do servio de Dimensionamento que pode ser solicitada atravs dos
contatos abaixo:
E-Mail
Fixo
TOTVS S.A.
Flvia
flavia.
polido@totvs.
com.br
11-2099-7520
Wiliam
wiliam.
abreu@totvs.
com.br
11-2099-7307
Victor
victor.
janusz@totvs.
com.br
11-2099-7188
Antonio
Alinne
antonio.
rodrigues@totvs. alinne.ciancio@totvs.
com.br
com.br
11-2099-7398
11-2099-7870
12
1.3.3
Requisitos de Software
1.3.3.1
Sistema Operacional
11-99953-8025
Braslia
11-99198-2681
Amap
Curitiba
Amazonas
Gois
Metropolitana
Bahia
Cear
Paulistana
Private
Triah
Maranho
Para
Paraba
Vale do Paraba
Paran Central
Piau
Rio Grande do Norte
Rio Grande do Sul
Santa Catarina
Sergipe
A estao client deve possuir o sistema operacional Windows instalado, pois o Datasul 12 utiliza a
linguagem Progress em arquitetura 32-bit (Win32). Informaes adicionais quanto s plataformas e
sistemas operacionais homologados podem ser obtidas no site da Progress (Product Availability Guide).
1.3.3.2
Progress
Sistema Operacional
Observao
Openedge
Enterprise
RDBMS
Windows Server
Openedge
DataServer for
Oracle
Windows Server
Unix
Unix
TOTVS S.A.
Instalao Datasul 12
OpenEdge
DataServer for
Microsoft SQL
Openedge
Application
Server Enterprise
Client
Networking
Windows Server
Windows
13
Unix
Windows
Unix
Windows Server
Query / Results
Unix
Java
1.3.3.4
Para executar o Datasul 12 nas estaes client, necessrio o Flash Player. Caso no possua
instalado, o Flash Player pode ser baixado diretamente do site da Adobe (verso mnima: 9r124).
1.3.3.5
TOTVS S.A.
14
1.3.3.6
Caso voc utilize uma instncia existente, as recomendaes que seguem devem prevalecer
perante outros produtos no TOTVS. Para verificar valores de parmetros de base existente, proceda as
seguintes consultas e analise os resultados:
select parameter, value
from nls_database_parameters
where parameter = 'NLS_CHARACTERSET'
NLS_LANGUAGE
AMERICAN
NLS_TERRITORY
AMERICA
NLS_CHARACTERSET
WE8ISO8859P1 OU WE8MSWIN1252
NLS_NCHAR_CHARACTERSET
AL16UTF16
do
banco
AMERICAN_AMERICA.WE8ISO8859P1
ou
AMERICAN_AMERICA.
TOTVS S.A.
Instalao Datasul 12
1.3.3.7
15
O produto foi homologado para ser executado com SQL Server 2012 e os requisitos de harware e
software podem ser consultados no site do fabricante Requisitos SQL Server 2012.
Confirme que o protocolo TCP/IP est habilitado para a instncia do SQL Server utilizada.
Instncias do SQL Server Express no possuem este protocolo habilitado por padro.
Para as estaes de trabalho se faz necessrio a instalao do SQL Server Native Client 10.0 para
que seja feito o acesso ao produto Datasul 12 configurado no servidor.
1.3.4
1.4
Instalao
1.4.1
1.4.2
Planejando a Instalao
Mostraremos agora as etapas que devem ser seguidas para a instalao e configurao do
Datasul 12, de acordo com os tipos de instalao disponveis na mdia (Programas, Banco de dados e
Servidor de Aplicao).
Defina a topologia do ambiente. Nesta etapa, deve ser definido onde cada componente ser
instalado. Escolha o hardware que ser utilizado como servidor de banco de dados, servidor de
arquivos, servidor de aplicao e tambm as mquinas que estaro disponveis aos usurios. Para
cada um destes componentes, verifique se os requisitos de hardware e software so atendidos;
TOTVS S.A.
16
1.4.3
Instalao
ATENO: Caso receba a mdia em DVD, antes de iniciar a instalao deve-se copiar todo o
contedo do DVD2 para o DVD1. Sem isto a instalao ser interrompida no meio do processo.
Quando o download da mdia realizado atravs do Portal de Suporte, todos os arquivos zip
devem ser descompactados no mesmo diretrio.
TOTVS S.A.
Instalao Datasul 12
17
Informe o Nome do Usurio e o Nome da Empresa que utilizar o Datasul 12. Selecione
Avanar para continuar. No so permitidos caracteres especiais neste campo, pois podem ocorrer
erros no acesso ao produto.
Tela de Drives disponveis
Nesta tela sero exibidos os drives disponveis para a instalao do produto. Selecione um drive e clique
em avanar. Lembrando que somente aparecero os drives locais (unidades mapeadas no so
exibidas).
Aps clicar em avanar ser exibida uma tela informando se o espao em disco suficiente para a
instalao da mdia. Se houver espao, ser exibida somente uma tela informativa, mostrando que o
espao suficiente. Se no houver espao, a instalao questionar se deseja selecionar outro drive.
Caso informe que no, a instalao no ir prosseguir. Neste caso, libere espao em disco e inicie
novamente o instalador.
Tela do tipo de instalao
Selecione o tipo de instalao que ser executado neste momento. Lembrando que deve ser seguida a
ordem apresentada:
Programas
Banco de dados
Servidor de Aplicao
Documentao
Selecione Avanar para continuar.
Os prximos captulos descrevero os procedimentos que devem ser executados para cada tipo
de instalao.
1.4.4
Instalao de Programas
Ao selecionar a opo Programas sero instalados os objetos Progress utilizados pelo Datasul
12. A rea de programas ser instalada na estrutura <Drive>:\Totvs\Datasul\<ID>\ERP. O diretrio ERP
dever estar acessvel a todos os usurios que utilizaro o Datasul 12, devido execuo dos programas
Progress. A instalao da rea de programas pr-requisito para a instalao dos demais componentes
da mdia de instalao.
O instalador OpenEdege 10.2B contm binrios compilados para 32-bit e 64-bit. Defina atravs
das opes do menu quais binrios sero instalados. Se selecionada qualquer opo para Caracter 32
TOTVS S.A.
18
ou Caracter 64, ser criado um diretrio chamado char32 ou char64, respectivamente dentro dos
diretrios do produto.
O instalador OpenEdege 11.3 contm binrios compilados que servem tanto para 32-bit e 64-bit.
Selecione a opo "Progress 11.3" para o ambiente que utiliza Windows ou Linux, 32-bit ou 64-bit. A
opo TTY serve para ambientes caracter e para aplicaes Web, 32-bit ou 64-bit.
TOTVS S.A.
Instalao Datasul 12
19
Para dar continuidade ao processo, selecione Avanar. Neste momento ter incio a instalao
dos programas. Ao final deste processo, o instalador retornar a tela de seleo do Tipo de Instalao.
1.4.5
1.4.6
Banco Progress
Tela Seleo de ID
Se a instalao de Bancos de Dados for feita no mesmo servidor onde foi feita a instalao da rea
de programas, esta tela ser apresentada. Neste caso, informe Sim para utilizar o ID que foi previamente
criado. Se existir mais de 1 ID registrado, ser solicitado qual ID deseja utilizar.
Tela de alterao dos servios
Informe o nmero inicial da porta TCP/IP a ser configurada para carga dos bancos. As portas TCP/
IP sero configuradas de forma seqencial. Nesse caso, antes de informar o nmero inicial da porta,
recomendamos verificar se as prximas 60 portas TCP/IP subseqentes tambm esto livres.
Selecione Avanar para continuar.
TOTVS S.A.
20
TOTVS S.A.
Instalao Datasul 12
21
Os bancos utilizados pelo produto so configurados para serem iniciados pelo Progress Explorer
Tool (proexp). Esse aplicativo Progress uma ferramenta grfica que possibilita criar, configurar, iniciar e
parar os servios administrados pelo AdminService local ou remoto, como por exemplo banco de dados,
Webspeed, AppServer, entre outros.
A administrao dos bancos e servios configurados no Progress Explorer Tool tambm pode
ser executada via linha de comando.
A configurao feita no Progress Explorer Tool durante a instalao de banco de dados bsica,
ou seja, suficiente para iniciar os bancos e executar o teste de acesso ao produto. Aps finalizar a
instalao e configurao do Datasul 12, a parametrizao dos bancos e sesso (.pf) deve ser revista,
adequando-os de acordo com os recursos disponveis no servidor de banco dados e volume de
conexes/processos, tendo como objetivo atender as requisies com um melhor desempenho.
A anlise do ambiente e acerto das parametrizaes pode ser feito junto consultoria de Banco
de Dados, pelo telefone 4003-0015, opes "02" Software > "03" Consultoria Tcnica > "04" Datasul >
"08" Tecnologia > "03" Banco de Dados. Informaes adicionais sobre esse servio podem ser obtidas no
suporte telefnico, pelo nmero 4003-0015, opes "02" Software > "02" Suporte Tcnico > "04" Datasul >
"08" Tecnologia > "03" Banco de Dados.
1.4.6.2
TOTVS S.A.
Localizao
Objeto
Descrio
ReparaBancos.bat
datasulDescargaBancos.
bat
22
datasulCargaBancos.bat.
1.4.6.3
datasulCargaBancos.bat
conmgr.properties
TOTVS S.A.
Instalao Datasul 12
23
<parmetros>
Acessar um client Windows com Progress instalado;
Acessar o proenv do Progress em Iniciar > Programas > Progress > Proenv;
Executar o load das definies (.dfsql) para os bancos emsdev, finance e payroll2;
sqlexp user sysprogress password sysprogress -url jdbc:datadirect:openedge://<nome servidor
banco>:<porta do broker SQL>;databaseName=<banco> -infile <arquivo.dfsql>
DICA: A porta do broker a porta definida para o parmetro -S ao carregar o banco com
o parmetro -ServerType SQL.
Conectar via SQL Explorer o banco mdtfrw e dar permisses de DBA para o usurio pub, atravs
dos comandos abaixo:
sqlexp user sysprogress password sysprogress -url jdbc:datadirect:openedge://<nome servidor banco>:
<porta do broker SQL>;databaseName=<banco>
Grant dba to pub;
Commit;
Aps a execuo desses procedimentos, os bancos utilizados pelo Datasul 12 estaro instalados e
configurados.
Importante verificar a documentao sobre configurao da conexo DataSource para banco de
dados Progress, que deve ser feito conforme a quantidade de usurios que utilizam o Datasul 12.
1.4.7
Bancos Oracle
ATENO: Para a utilizao do produto em Oracle, o valor da NLS_LANG dever estar
configurado de acordo com o CharacterSet utilizado no banco de dados (AMERICAN_AMERICA.
WE8ISO8859P1 ou AMERICAN_AMERICA.WE8MSWIN1252).
24
Informar o diretrio onde deseja armazenar os Datafiles dos tablespaces que sero utilizados para o
produto Datasul 12.
Tela para Informaes da Instalao
Esta tela contm um resumo das informaes digitadas nas telas anteriores. Caso alguma
informao esteja incorreta, selecione a opo Voltar para efetuar as devidas correes.
Ao selecionar a opo Avanar, sero criados os scripts para criao dos objetos nos bancos
Oracle, bem como sero copiados os Schema Holder.
1.4.7.1
1.4.7.2
Localizao
Objeto
Descrio
criaObjetoOracle.sql
criaTablespaceOracle.sql
criaUsuarioOracle.sql
gerenciadorScripts.sql
ReparaBancos.bat
A mdia de instalao no cria automaticamente os objetos no banco Oracle. Para criar estes
objetos o script gerenciadorScripts.sql dever ser executado manualmente, conforme procedimentos
abaixo:
Acessar o Sql Plus com o usurio System na instncia onde sero criados os objetos;
Executar o comando @<Dir Instal Bancos>\scripts\gerenciadorScripts.sql;
Verificar ao final do processo se foram gerados erros nos arquivos de log, localizados no diretrio
<Dir Instal Bancos>\spool.
1.4.8
TOTVS S.A.
Instalao Datasul 12
25
Tela Senha
Informe a senha do usurio.
Tela Configuraes SQL Server
Informe o nome do seridor e a instncia SQL Server e a localizao para os Database datafiles, diretrio
existente no servidor SQL Server.
Tela para Informaes da Instalao
Esta tela contm um resumo das informaes digitadas nas telas anteriores. Caso alguma
informao esteja incorreta, selecione a opo Voltar para efetuar as devidas correes.
Ao selecionar a opo Avanar, sero criados os scripts para criao dos objetos nos bancos
SQL Server, bem como sero copiados os Schema Holder.
1.4.8.1
1.4.8.2
Localizao
Objeto
Descrio
criaObjetoSQLServer.bat
criaDatabaseSQLServer.sql
criaUsuarioSQLServer.sql
gerenciadorScripts.bat
ReparaBancos.bat
A mdia de instalao no cria automaticamente os objetos no banco SQL Server. Para criar estes
objetos o script gerenciadorScripts.bat dever ser executado manualmente, conforme procedimentos
abaixo:
Entrar no diretrio <Dir Instal Bancos>\script;
Executar o script gerenciadorScripts.bat;
Verificar ao final do processo se foram gerados erros nos arquivos de log, localizados no diretrio
TOTVS S.A.
26
A nova conexo com o banco de dados SQL Server no precisa ser feita em cada estao,
garantindo assim que as informaes fiquem centralizadas no arquivo de configurao.
Nesse caso a melhor forma seria informar todos os parmetros de conexo na linha de comando
ou no arquivo de parmetros (arquivo .pf), mtodo tambm conhecido como DSN-less.
Uma conexo DSN-less (Data Source Name-less, ou conexo sem fonte de dados) permite que a
aplicao especifique todos os parmetros diretamente na linha de conexo ao banco, sem a
necessidade de configurar uma fonte de dados ODBC.
A linha para conexo DSN-less com o driver do SQL Server :
Driver={<driver>}; Server=<servidor>; DatabaseName=<banco>; Uid=<usurio>; Pwd=<senha>;
1.4.9
TOTVS S.A.
Instalao Datasul 12
27
Web;
Porta: Informe uma porta disponvel no servidor para comunicao entre o Jboss e
Datasul Connection for Web.
Terminal Server
Porta: Informe uma porta disponvel no servidor para comunicao entre o Jboss e
o Terminal Server;
Servidor: Informe o servidor onde est publicada a aplicao no Terminal Server;
Porta Metaframe: Informe a porta utilizada pelo Terminal Server.
Citrix
URL: URL em que a pasta DatasulCtxWI ser publicada (ver configurao do Citrix
neste mesmo Guia);
Servidor: Informar o servidor onde est publicada a aplicao no Citrix;
Porta: Informe uma porta disponvel no servidor para comunicao entre o Jboss e
Citrix.
Selecione Avanar para continuar.
Tela Nome da mquina
Informe o nome do servidor onde esto instalados os bancos de dados do produto Datasul 12.
Selecione Avanar para continuar.
Tela do Single Sign On
O Single Sign On (Josso) instalado e configurado junto com o Jboss. Dessa forma, informe o
hostname do servidor de aplicao onde est sendo instalado o Jboss e a porta de comunicao com o
Jboss.
Selecione Avanar para continuar.
Tela Nameserver
Informe o nome da mquina e nmero de porta do Nameserver do Progress. Caso no tenha
alterado, a porta padro 5162. Estas informaes so utilizadas para conexo com o AppServer criado
durante a instalao. Selecione Avanar para continuar.
DICA: Essa informao pode ser obtida no arquivo ubroker.properties, localizado abaixo do
TOTVS S.A.
28
TOTVS S.A.
Instalao Datasul 12
29
properties localizado abaixo do diretrio scripts para o diretrio properties do Progress e assim
ser possvel visualizar o servio AppServer pelo Progress Explorer Tool.
Tela de configurao do License Server
Informe o servidor do License Server e a porta.
Tela informaes da instalao
Esta tela contm um resumo das informaes digitadas nas telas anteriores. Caso alguma
informao esteja incorreta, selecione a opo Voltar para efetuar as devidas correes.
Ao selecionar a opo Avanar, os servios sero instalados e configurados.
Ao finalizar as configuraes ser questionado se deseja informar as configuraes do LDAP.
Estas informaes so utilizadas para o login integrado do produto. Sem esta configurao, mesmo que
tenha o usurio SO cadastrado corretamente com o tipo de acesso externo, no ser possvel acessar o
produto utilizando login integrado. Se for escolhida a opo sim, ser solicitado um usurio e senha de
rede para configurao com o Active Directory (AD). Aps a configurao com o Active Directory ser
apresentada a tela de concluso da instalao do Servidor de Aplicao.
ALERTA: A senha do usurio informado no pode ter o caractere &, sendo que isso
ocasionar falha na inicializao do Jboss. necessrio neste processo informar um
usurio e senha vlidos no AD sem domnio e sem extenso, caso contrrio no ser
possvel configurar o arquivo de autenticao utilizado pelo Josso.
1.4.9.1
TOTVS S.A.
Localizao
Objeto
Descrio
<Dir Instal
Programas>\scripts[instncia]
config.xml
<Dir Instal
Programas>\scripts[instncia]
datasul-progress.ini
<Dir Instal
Programas>\scripts-
datasul-configxml-alias.p
30
[instncia]
<Dir Instal
Programas>\scripts[instncia]
datasul-appserver-alias.p
<Dir Instal
Programas>\scripts[instncia]
datasul-aliasIni.p
<Dir Instal
Programas>\scripts[instncia]
datasul.pf
<Dir Instal
Programas>\scripts[instncia]
ubroker.properties
TOTVS S.A.
Instalao Datasul 12
31
Informe tambm se deve ignorar a importao das literais em Ingls e Espanhol. Selecione ">"
para continuar.
Tela de inicializao do banco de dados emsdev
Nesta
tela
informe
localizao
do
arquivo
de
parmetros
(<Dir
Instal
concluindo o processo.
TOTVS S.A.
32
Quando no for utilizados os bancos de dados criados automaticamente pela mdia de instalao,
necessrio dar permisso de select e update para o usurio pub nas sequences seq_configur e
seq_propried. Esta permisso impacta diretamente na persistncia das configuraes do usurio. Caso
no sejam dadas as permisses para as Sequences, nenhuma configurao de usurio ser salva,
ocasionando vrios erros em tela.
Acessar o SQL Explorer atravs do Proenv, conectando o banco emsfnd;
Sqlexp db emsfnd H <hostname> -S <servio> -user sysprogress password
sysprogress
Utilizar os comandos abaixo para dar as permisses na sequence:
Grant select, update on sequence pub.seq_configur to pub;
TOTVS S.A.
Instalao Datasul 12
33
Ao final da instalao os programas Progress estaro disponveis para acesso somente atravs do
servidor onde foi feita a instalao. Para que o acesso a estes programas esteja disponvel a todas as
estaes da rede, necessrio seguir os procedimentos listados abaixo:
Compartilhar o diretrio ERP, atribuindo permisso de leitura a todos os usurios que
acessaro o produto.
Ex: \\servidor\ERP
Editar o arquivo ERP\scripts-8x80\datasul-progress.ini, alterando todas as entradas do Propath
para o compartilhamento previamente criado;
Ex: PROPATH=\\servidor\ERP,\\servidor\ERP\ems2,\\servidor\ERP\ems5, etc
Editar o arquivo ERP\scripts-8x80\config.xml, alterando o endereo dos arquivos .ini, .pf e
alias para o compartilhamento previamente criado.
1.4.14.3 Configurao para acesso ao Gesto de Planos
Caso seja utilizado o Gesto de Planos, dever ser criado um atalho especificamente para acesso
a ele no produto. Neste caso, devero ser seguidos os passos abaixo:
Criar um atalho no config.xml, apontando para um arquivo .INI onde o valor do v6Keys seja = Yes.
Os programas do Gesto de Planos devero ser executados com este atalho;
Criar um atalho no config.xml, apontando para um arquivo .INI onde o valor do v6Keys seja = No.
Este atalho ser utilizado para executar os programas do EMS 2/ EMS 5/ HCM.
1.4.14.4 Configurao de envio de e-mail com autenticao
Quando o servidor de e-mail do cliente exigir autenticao para o envio de e-mail, ser necessrio
criar uma conta especfica de e-mail para o produto Datasul e configur-la no arquivo mail-service.xml no
Jboss.
Verificar se no arquivo mail-service.xml (localizado no <Jboss>\server\<instncia>\deploy) existe a
configurao abaixo para permitir que sejam enviadas mensagens de e-mails para e-mails externos com
autenticao de usurio:
<property name="mail.smtp.auth" value="true"/>
TOTVS S.A.
34
Se existir, est configurado para utilizar autenticao de usurio, ento sempre que for enviado um
e-mail o destinatrio ser o que est definido no arquivo mail-service.xml. O e-mail informado utilizado no
"replyTo", ou seja, para resposta do e-mail, tambm ser o configurado no mail-service.xml.
Retirando essa configurao do mail.smtp.auth, ao tentar enviar um e-mail para destinatrio
externo isso no ser possvel se o servidor de e-mail estiver configurado para exigir autenticao para o
envio de e-mail. Se enviado para e-mail interno o remetente que aparecer no e-mail dever ser o que foi
informado, e no o que est configurado no mail-service.xml.
1.4.14.5 Matriz de Traduo no EMS 5
Aps uma nova instalao do produto Datasul 12, ser necessrio criar uma Matriz de Traduo
para Organizao Externa no EMS 5 (prgint/utb/utb118aa), caso ela no exista.
A matriz ser usada para identificar a unidade organizacional do EMS 5 correspondente unidade
organizacional do EMS 2, relacionada ao usurio. Tambm ser utilizada quando o usurio trocar de
empresa dentro do sistema Datasul (procedimento Troca Empresa Usurio).
Dever existir ao menos um registro de relao entre a empresa do EMS 2 com a empresa do
EMS 5.
A Matriz de Traduo Organizao Externa dever ter o nome EMS2 e a Origem Organizao
dever ser EMS. Se j existir uma matriz chamada EMS2, ela dever ser a oficial utilizada na integrao
entre o EMS 2 e o EMS 5.
Na matriz devero ser cadastradas todas as empresas e estabelecimentos usados no EMS 2,
conforme abaixo:
Tipo Unidade Organizacional: empresa/estabelecimento usado no EMS2.
Unidade Organizacional Externa: Unidade Organizacional do EMS2.
Unidade Organizacional: Unidade Organizacional do EMS5.
As demais informaes (matriz contas, matriz centro de custo e outras) no precisaro ser
identificadas neste momento.
1.4.14.6 Instalao do Plug-in CRM Outlook
TOTVS S.A.
Instalao Datasul 12
35
TOTVS S.A.
36
1.5
Atualizao
O processo de atualizao do produto realizado atravs do Console de Atualizao. Os Guias e o
Console de Atualizao esto disponveis na rea de Documentos da Comunidade D@ - CAT, no Fluig.
1.6
Reinstalao
A reinstalao pode ser executada para qualquer um dos componentes do produto (programas,
banco de dados e servidor de aplicao), executando o setup da mdia de instalao novamente. Porm,
antes de executar esse processo, devem ser feitas algumas verificaes:
ATENO: de extrema importncia a execuo de um backup do ambiente atual antes
da reinstalao de qualquer componente.
Programas
Se o produto estiver operacional, selecionar uma rea de programas diferente da utilizada pelo
ambiente de produo. A reinstalao pode ser utilizada para instalar os programas compilados em
ambiente Caracter 32-bit ou Caracter 64-bit, por exemplo.
Banco de Dados
Se o produto estiver operacional, selecionar uma rea ou servidor de banco de dados diferente do
utilizado no ambiente de produo. Caso seja informada a mesma rea para a reinstalao, todos os
dados inseridos at o presente momento sero eliminados. Somente sobreponha os arquivos quando
tiver certeza do que realmente necessita. Alm disso, ao reinstalar os bancos, ser necessria a
execuo da inicializao do produto novamente. Em ambiente Oracle e SQL Server, recomendvel
realizar um backup dos Schema Holder antes da reinstalao para evitar problemas de sincronismo.
Servidor de Aplicao
Na reinstalao do Servidor de Aplicao, os objetos que no existem sero criados e objetos
existentes sero substitudos. Todas as configuraes sero efetuadas novamente pela mdia de
instalao.
1.7
Desinstalao
O procedimento de desinstalao deve ser executado somente quando no so mais
necessrios os componentes instalados em cada servidor, sendo que essa rotina deve ser executada a
partir do servidor onde foi instalado cada componente.
Para desinstalar o produto em ambiente Windows deve ser selecionada a opo remover do Datasul
TOTVS S.A.
Instalao Datasul 12
37
12 em Iniciar > Configuraes > Painel de Controle > Adicionar ou Remover Programas. Durante esse
processo ser solicitada a confirmao de excluso e posteriormente ser apresentada uma tela de
concluso do processo.
Esse procedimento no elimina todos os arquivos criados no processo de instalao, como logs
e arquivos temporrios. Nesse caso verifique os diretrios utilizados para instalao dos componentes e
remova os objetos restantes conforme necessrio.
Configurao Datasul 12
2.1
Finalidade
A finalidade deste Guia descrever as configuraes do produto Datasul 12 demonstrando o
arquivo onde cada configurao realizado. Informaes adicionais podem ser localizadas no captulo
Documentaes Importantes.
2.1.1
Pblico Alvo
A complexidade do processo requer profissionais com conhecimento da arquitetura do produto
Datasul 12, Progress, Java, Flex, Jboss e ambiente de rede.
2.1.2
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
Instalao Datasul 12.1.7;
Modelo de entidade e relacionamentos (M.E.R)
O arquivo Datasul_11-MER.zip contm os artefatos para consulta do M.E.R do produto Datasul 12.
O documento "Datasul 11 - MER.docx" explica como podem ser consultados toda a estrutura e
relacionamentos, desde os bancos, at cada um dos atrbutos e ndices.
TOTVS S.A.
38
Programas de APIs
No arquivo Datasul_11-APIs.zip tem os procedimentos para a utilizao dos programas de API
liberados junto com o produto Datasul 11 e procedimentos de como gerar Weberservices WSDL.
2.1.3
2.2
Arquivos de configurao
Neste captulo citaremos os arquivos e configuraes para o produto Datasul 12.
2.2.1
Bancos de Dados
Os bancos de dados "emsdev", "emsfnd", "mdmerge", "mdtfrw", "finance", "payroll2", "ems2sor",
"ems2cad" e "eai2" 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:
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.
TOTVS S.A.
Configurao Datasul 12
2.2.2
39
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
Descrio:
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. O
arquivo de log do broker AppServer tambm pode auxiliar na correo de problemas.
As propriedades descritas abaixo podem ser configuradas para o AppServer Progress. Verificar a
configurao que melhor se encaixa no seu cenrio de produo. Por padro todas as propriedades
esto desabilitadas e o sistema funciona como state-reset.
progress.server.mode=1
progress.server.statereset.controlpoolcompanyid=false
progress.server.statereset.numberreqconnsclear=-1
progress.server.statereset.evictionthreadrun=120000
progress.server.statereset.mintimeidleobjects=180000
Descrio:
TOTVS S.A.
Propriedade
Definio
Valor
Padro
Observao
progress.server.mode
Nmero Inteiro
{1,2}
1 (statereset/
stateaware)
progress.server.statereset.
Lgico {true,false}
false
Controla no pool da VM
40
controlpoolcompanyid
2.2.3
progress.server.statereset.
numberreqconnsclear
-1
progress.server.statereset.
evictionthreadrun
Milisegundos
120000ms
(2minutos)
Controla o tempo de
start de Thread para
limpeza de objetos Idle
dentro do Pool Java.
Aplicando -1 na
propriedade ignora o
funcionamento.
(Utilizado apenas com
state-reset e stateaware)
progress.server.statereset.
mintimeidleobjects
Milisegundos
180000ms
(3minutos)
Se a propriedade
evictionthreadrun > 0,
define o tempo em que
um objeto pode
permanecer em estado
de Idle dentro do Pool da
VM Java.
(Utilizado apenas com
state-reset e stateaware)
Log
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 12 est configurado com o log para "ERROR", o que significa que somente as mensagens de
TOTVS S.A.
Configurao Datasul 12
41
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. Podese configurar o log rotate por: ms, semana, dia, metade do dia, hora e minuto. Para fazer esta alterao,
TOTVS S.A.
42
DatePattern
Perodo
'.'yyyy-MM
'.'yyyy-ww
'.'yyyy-MM-dd
'.'yyyy-MM-dd-a
'.'yyyy-MM-dd-HH
'.'yyyy-MM-dd-HH-mm
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:
<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.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
TOTVS S.A.
Configurao Datasul 12
43
Descrio:
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.2.4.1
A partir do Datasul 12.1.1 a forma de validao das licenas do produto foi modificada, isso para
melhorar o controle e garantir a utilizao correta das licenas. Esta configurao vlida para uma
instalao ou atualizao (Update) do Datasul 12, onde basicamente consiste na cpia automtica do
arquivo para as estaes de trabalho.
Neste caso o Datasul 12 ao ser acessado por uma estao de trabalho copia
automaticamente a dll para o diretrio c:\windows\, se no conseguir por falta de permisso tenta
fazer a cpia para outro diretrio definido na varivel PATH do Windows.
Quando o usurio no tem permisso para cpia em nenhum dos diretrios definido na
varivel PATH do Windows, deve ser feita a cpia manual pelo administrador ou fazer o
mapeamento do diretrio do servidor para incluir no PATH do Windows.
1 sugesto:
Copiar o arquivo license_client.dll do diretrio ...\ERP\fnd\config\
Colar no diretrio c:\windows de cada estao de trabalho que ir fazer o acesso ao Datasul 12
2 sugesto:
Mapear o caminho \\servidor\dts12\ERP\fnd\ como t:\
Incluir o diretrio t:\config\ na varivel de ambiente PATH do Windows.
Importante:
Caso utilize acesso remoto (Citrix, GoGlobal, TS) o arquivo license_client.dll deve ser copiado para o
diretrio c:\windows do servidor da ferramenta.
TOTVS S.A.
44
2.2.5
2.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.
Para a configurao do Jboss em servidor Linux recomenda-se a leitura deste kbase.
2.2.5.2
Segurana JBOSS
Configurao Datasul 12
45
46
</jboss-web>
4) No arquivo ..\deploy\jmx-console.war\WEB-INF\web.xml habilitar uma restrio de segurana retirando
os comentrios da tag <security-constraint>, alterando a tag <real-name> para jmx-console,
alterando tambm as tags <role-name> para * conforme exemplo abaixo:
<security-constraint>
<web-resource-collection>
<web-resource-name>HtmlAdaptor</web-resource-name>
<description>An example security config that only allows users with the role JBossAdmin to access the
HTML JMX console web application</description>
<url-pattern>/*</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>*</role-name>
</auth-constraint>
</security-constraint>
<login-config>
<auth-method>BASIC</auth-method>
<realm-name>jmx-console</realm-name>
</login-config>
<security-role>
<role-name>*</role-name>
</security-role>
5) Criar os arquivos ..\deploy\management\console-mgr.sar\web-console.war\WEB-INF\context.xml e ..
\deploy\jmx-console.war\WEB-INF\context.xml conforme exemplo abaixo:
<Context>
<Realm className="org.apache.catalina.realm.JAASRealm"
appName="jmx-console"
allRolesMode="authOnly"
debug="1" />
</Context>
6) Alterar a senha do usurio admin no arquivo ..\conf\props\ jmx-console-users.properties, que vai valer
para os dois monitores, conforme exemplo abaixo:
TOTVS S.A.
Configurao Datasul 12
47
admin=novasenha
7)
No
arquivo
...\deploy\http-invoker.sar\invoker.war\WEB-INF\web.xml
inclua
JNDIFactory,
2.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
TOTVS S.A.
48
2.2.7
TOTVS S.A.
Configurao Datasul 12
49
exceda o perodo determinado no parmetro session.timeout. Para desabilitar o TimeOut, altere o valor
do parmetro session.timeout para 0 (zero).
Importante: Para bancos de dados Progress ser necessrio ajustar os parmetros de carga,
adicionando os seguintes parmetros: -basetable 1 tablerangesize 2500. O Time Out Flex est
disponvel para ambiente Progress e Oracle.
2.2.8
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 12.
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 ser encontrado 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.
Pode-se tambm 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.2.8.1
As configuraes abaixo podem ser utilizadas quando houver a necessidade de acesso ao produto
Datasul 12 atravs de um IP externo (fora da rede local).
Alterar no arquivo josso-agent-config.xml as tags gatewayLoginUrl e gatewayLogoutUrl, indicando o
endereo IP externo, conforme exemplo:
<gatewayLoginUrl>http://189.100.100.100:8080/josso/signon/login.do</gatewayLoginUrl>
<gatewayLogoutUrl>http://189.100.100.100:8080/josso/signon/logout.do</gatewayLogoutUrl>
Para que esta configurao funcione corretamente, necessrio que o parmetro -b (arquivo run.bat)
possua o valor 0.0.0.0, indicando que a instncia responder as requisies de todos os endereos IP
que estiverem configurados para o servidor.
TOTVS S.A.
50
2.2.9
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: 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.
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.
TOTVS S.A.
Configurao Datasul 12
51
# indica qual a "descrio" do atalho do progress que dever ser utilizado como default para
carregar o progress
# esta "descrio" est definida dentro do arquivo "config.xml" menu.default.shortcut=c:\\dlc102b
# indica o tipo de acesso ao progress sera utilizado, local=false ou remoto=true menu.default.
remoteaccess=false
2.2.11 Menu
Em caso de lentido na carga dos programas no menu do produto, pode-se utilizar a soluo de
consolidao do menu. Basta informar no datasul_framework.properties a propriedade "use.menu.
key=true". Esta propriedade no expedida no padro da mdia e no recomendada para os ambientes
em que a lentido no identificada, pois para refletir as alteraes realizadas na estrutura do menu
(programa, mdulo, grupo de segurana, novos usurios) necessrio que seja executado o programa
de atualizao do menu do usurio (mer010aa). Se a estrutura do menu for alterada mas este programa
no for executado os acessos permanecero os mesmos.
TOTVS S.A.
52
servidor e uma porta que permitem acesso externo. Este servidor e porta formaro o link que ser enviado
por e-mail ao Fornecedor quando o Comprador solicitar cotaes.
As configuraes do RFI - Request For Information - tambm podero ser utilizadas em outras
funcionalidade que necessitarem solicitar informaes a usurios externos.
rfi.server=moitas
rfi.port=8080
2.2.12.1 Mail Service
Necessrio informar conta de e-mail do servidor da empresa (Exchange, Lotus) para permitir
envio de e-mail atravs de funes como a Solicitao de Cotaes usada pelo Comprador. Esta conta
no ser usada para receber e-mails, apenas para envio.
Exemplo:
<attribute name="User">compras_empresa</attribute>
<attribute name="Password">s3nh4_3m4i1</attribute>
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\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
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*
<Dir instalao>\ERP\scripts-8x80\config.xml
Configurao Datasul 12
2.3
53
A primeira linha faz a carga do broker 4GL utilizando uma porta definida pelo parmetro -S e
outros parmetros iniciais, essa porta utilizada por programas Progress.
A segunda linha faz a carga do broker SQL utilizando uma outra porta definida pelo parmetro -S,
define o parmetro -ServerType SQL e outros parmetros iniciais, essa porta utilizada por programas
JAVA.
Abaixo a lista de bancos de dados Progress que por padro so configurados com acesso JDBC
no script progress-ds.xml:
emsdev
emsfnd
mdmerge
finance
ems2sor
payroll2
mdtfrw
ems2cad
eai2
TOTVS S.A.
54
pool de conexo, que para alguns bancos h mais de um pool, como o caso do EMSFND.
Se o JBoss tentar abrir uma conexo e receber um erro porque o banco rejeitou, devido aos
parmetros configurados, o usurio receber um erro e algo no funcionar corretamente no Datasul.
Logo, importante que todas as conexes dos pools do JBoss estejam dimensionadas na carga do
banco.
Como funciona, simplificadamente, este pool de conexes?
Quando algum programa precisa acessar algum banco de dados ele pede uma conexo
"emprestada" para o pool correspondente. Havendo alguma conexo j aberta e no sendo utilizada por
ningum, esta conexo emprestada ao programa. Se no houver conexo aberta e o pool no chegou
o tamanho limite (max-pool-size), o JBoss abrir uma nova conexo com o banco.
Se o pool j est no limite, o programa aguarda um tempo indicado pelo parmetro "blockingtimeout-millis" no arquivo progress-ds.xml. Se uma conexo for liberada, o programa pega esta
emprestada e continua, caso contrrio o programa recebe um erro.
Depois que o programa usou e liberou a conexo, ela devolvida ao pool para ser reutilizada.
Ento quantas conexes so necessrias?
Depende do nmero de usurios, da atividade dos usurios, dos programas que cada usurio
executa e em qual ordem e de quanto tempo cada programa fica com a conexo "emprestada" antes de
devolv-la ao pool.
Uma forma de acompanhar e dimensionar este nmero utilizar o /jmx-console, conforme artigo
Como definir o valor do campo <max-pool-size> no progress-ds.xml.
Qual a configurao mnima recomendada para funcionar o Datasul 12?
No arquivo progress-ds.xml o parmetro max-pool-size vem com o valor padro de 30, que est
mensurado para um ambiente com 300 usurios, isso porque utilizado o clculo de 1 conexo para 10
usurios. Esse nmero utilizado como clculo uma estimativa mdia, pode variar conforme o ambiente.
Esse parmetro pode ser ajustado definindo um valor corresponde ao nmero de usurios que
utilizam o Datasul 12. O banco de dados EMSFND precisa de no mnimo 6 conexes para iniciar o
TOTVS S.A.
Configurao Datasul 12
55
JBoss, abaixo os valores que devem ser utilizados para configurao do arquivo.
emsFnd
<min-pool-size>1</min-pool-size>
<max-pool-size>1</max-pool-size>
no_tx_emsFnd
<min-pool-size>1</min-pool-size>
<max-pool-size>1</max-pool-size>
ems_josso
<min-pool-size>4</min-pool-size>
<max-pool-size>4</max-pool-size>
Importante ressaltar que os parmetros acima dizem respeito ao mnimo de conexo a ser
configurado no EMSFND, onde para cada banco de dados configurado no arquivo progress-ds.xml deve
ser feito um monitoramento das conexes para identificar a configurao ideal do parmetro max-poolsize.
Maiores detalhes da configurao do parmetro max-pool-size podem ser visualizados no artigo
Como definir o valor do campo <max-pool-size> no progress-ds.xml.
2.4
2.5
TOTVS S.A.
56
do
sistema
melhora
TOTVS S.A.
Configurao Datasul 12
TOTVS S.A.
Banco
Descrio
Tipo
Produto
mgadt
Audit Trail
Mono-empresa
ERP
mgadm
Administrativo
Multi-empresa
ERP
mgaps
APS
Mono-empresa
ERP
mgcex
Comrcio Exterior
Mono-empresa
ERP
mgcld
Coletor de dados
Mono-empresa
ERP
mgdis
Distribuio
Mono-empresa
ERP
mgfis
Fiscal
Mono-empresa
ERP
mgind
Industrial
Mono-empresa
ERP
mginv
Investimentos
Multi-empresa
ERP
mgmfg
Manufatura
Mono-empresa
ERP
mgmnt
Manuteno Industrial
Mono-empresa
ERP
mgmp
Multi-planta
Mono-empresa
ERP
mgmrp
Planejamento
Mono-empresa
ERP
mgrac
Multi-empresa
ERP
mgscm
Fretes/WareHouse
Mono-empresa
ERP
mgsop
Screen Optimizer
Multi-empresa
ERP
mgsor
Screen Optimizer
Multi-empresa
ERP
mgtmp
Temporrio
Multi-empresa
ERP
mguni
Universal
Multi-empresa
ERP
mgven
Vendor
Multi-empresa
ERP
mgdbr
APS
Mono-empresa
APS
lcarg
Localizao Argentina
Mono-empresa
ERP
lcchl
Localizao Chile
Mono-empresa
ERP
lccol
Localizao Colmbia
Mono-empresa
ERP
57
58
Banco
Descrio
Tipo
Produto
lcmex
Localizao Mxico
Mono-empresa
ERP
movadm
Movimento Administrativo
Multi-empresa
ERP
movdis
Movimento Distribuio
Mono-empresa
ERP
movfis
Movimento Fiscal
Mono-empresa
ERP
movind
Movimento Industrial
Mono-empresa
ERP
movmfg
Movimento Manufatura
Mono-empresa
ERP
movmnt
Mono-empresa
ERP
movrac
Multi-empresa
ERP
movdbr
Movimento APS
Mono-empresa
APS
neogrid
Neogrid E-collaboration
Multi-empresa
ERP
wmovdis
Temporrio Distribuio
Mono-empresa
ERP
eai
Mono-empresa
ERP
emsinc
Business Analytics
Mono-empresa
Datasul BA
mgfro
Frotas
Mono-empresa
ERP
movfro
Movimento Frotas
Mono-empresa
ERP
mov2arg
Mono-empresa
ERP
mov2chl
Mono-empresa
ERP
mov2col
Mono-empresa
ERP
mov2mex
Mono-empresa
ERP
emsfnd
Foundation
Multi-empresa
ERP
emsbas
Tabelas Bsicas
Multi-empresa
ERP
emsfin
Cadastros Financeiros
Multi-empresa
ERP
emsuni
Tabelas Universais
Multi-empresa
ERP
emsedi
EDI
Multi-empresa
ERP
movfin
Movimentos Financeiros
Multi-empresa
ERP
TOTVS S.A.
Configurao Datasul 12
TOTVS S.A.
Banco
Descrio
Tipo
Produto
emsnam
Localizao EUA
Multi-empresa
ERP
emsmex
Multi-empresa
ERP
emschl
Multi-empresa
ERP
emscol
Multi-empresa
ERP
emsarg
Multi-empresa
ERP
mov5arg
Multi-empresa
ERP
dthrpmg
Desenvolvimento Organizacional
Multi-empresa
ERP
dthrpyc
Pagadoria
Multi-empresa
ERP
dthrcpj
Controle de Projetos
Multi-empresa
ERP
dthrtma
Controle Freqncia
Multi-empresa
ERP
dthrgst
Gesto de Pessoal
Multi-empresa
ERP
srcadger
Cadastros Gerais
Mono-empresa
Sade
srmovben
Movimentao de Beneficirios
Mono-empresa
Sade
srmovcon
Movimentao de Contas
Mono-empresa
Sade
srmovfi1
Movimentao Financeira I
Mono-empresa
Sade
srmovfin
Movimentao Financeira
Mono-empresa
Sade
srweb
Cadastros/Movimentaco WEB
Mono-empresa
Sade
emsdev
Framework
Multi-empresa
ERP
finance
Aplicaes e Emprstimos
Multi-empresa
ERP
payroll2
Portal HCM
Multi-empresa
ERP
emsdca
Mono-empresa
ERP
comtrp
TMS
Mono-empresa
TMS
mgtrp
TMS
Mono-empresa
TMS
movtrp
TMS
Mono-empresa
TMS
emsven
Vendor
Multi-empresa
ERP
59
60
Banco
Descrio
Tipo
Produto
emsgra
Gros
Multi-empresa
ERP
mdtcrm
CRM
Mono-empresa
CRM
mdtfrw
Metadados
Multi-empresa
Metadados
mdmerge
Metadados
Multi-empresa
Metadados
eai2
EAI2
Multi-empresa
ERP
totvsgen
TOTVS Genrico
Multi-empresa
ERP
Observaes:
Continua a restrio de no unificar os bancos do produto EMS2 junto com os bancos do EMS5
ou junto com os bancos do HCM, pois existem tabelas com a mesma nomenclatura.
Os Bancos EMSDEV, EMSFND, MDMERGE, FINANCE, EMS2SOR, PAYROLL2, MDTFRW: So
bancos de dados acessados via JDBC via porta SQL. A recomendao que no sejam
unificados.
Configurao HTTPS
3.1
Introduo
Este documento tem como objetivo documentar a instalao e configurao do apache em
HTTP sobre SSL para funcionamento com o jboss-4.2.3-GA do produto Datasul. Apesar das
configuraes serem semelhantes, seguiremos o escopo limitado ao Windows 32bits.
Para finalizar tem um tpico sobre as configuraes de Tuning do Apache para melhorar o
desempenho no tratamento das requisies. Esse artigo foi baseado na verso 2.2.xx para windows, no
entanto, as configuraes so semelhantes aos outros SOs em que o apache Server-pool est disponvel.
3.2
3.2.1
TOTVS S.A.
Configurao HTTPS
61
Apache
Documentao
Link
Instalador
Link
Arquivo
3.2.2
httpd-2.2.25-win32-x86-openssl-0.9.8y.msi
g. Abrir o navegador de sua preferncia e digitar http://<server> e o apache deve mostrar uma
pgina com a mensagem "It works!"
3.2.3
TOTVS S.A.
62
Instalador
Link
Configurao HTTPS
63
64
TOTVS S.A.
Configurao HTTPS
#
# As a general note, the characters $( and ) are used internally to define
# macros. Do not use them in your own configuration!!!
#
# Whenever you see a set of lines such as:
# x=value
# y=$(x)\something
#
# the final value for y will be value\something
# Define two status worker:
# - jk-status for read-only use
# - jk-manager for read/write use
#worker.list=jk-status
#worker.jk-status.type=status
#worker.jk-status.read_only=true
#worker.list=jk-manager
#worker.jk-manager.type=status
# We define a load balancer worker
# with name "balancer"
worker.list=balancer
worker.balancer.type=lb
# error_escalation_time: seconds, default = recover_time/2 (=30)
# Determines, how fast a detected error should switch from
# local error state to global error state
# Since: 1.2.28
worker.balancer.error_escalation_time=0
# - max_reply_timeouts: number, default=0
# If there are to many reply timeouts, a worker
# is put into the error state, i.e. it will become
# unavailable for all sessions residing on the respective
# Tomcat. The number of tolerated reply timeouts is
# configured with max_reply_timeouts. The number of
# timeouts occuring is divided by 2 once a minute and the
# resulting counter is compared against max_reply_timeouts.
# If you set max_reply_timeouts to N and the errors are
# occuring equally distributed over time, you will
# tolerate N/2 errors per minute. If they occur in a burst
# you will tolerate N errors.
# Since: 1.2.24
worker.balancer.max_reply_timeouts=10
# Now we add members to the load balancer
# First member is "node1", most
TOTVS S.A.
65
66
Configurao HTTPS
67
68
Configurao HTTPS
69
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# uriworkermap.properties - IIS
#
# This file provides sample mappings for example wlb
# worker defined in workermap.properties.minimal
# The general syntax for this file is:
# [URL]=[Worker name]
/datasul=balancer
/datasul/*=balancer
/josso=balancer
/josso/*=balancer
/docs=balancer
/docs/*=balancer
# Optionally filter out all .jpeg files inside that context
# For no mapping the url has to start with exclamation (!)
#!/servlets-examples/*.jpeg=lb
#
# Mount jkstatus to /jkmanager
# For production servers you will need to
# secure the access to the /jkmanager url
#
#/jk-manager=jk-status
g. Iniciar os nodes (JBOSS)
h. Iniciar o Apache
3.2.4
Configurar SSL
a. Abrir o arquivo APACHE_HOME/conf/httpd.conf
b. Localizar e tirar o comentrio da linha #Include conf/extra/httpd-ssl.conf e salvar.
c. Abrir o arquivo APACHE_HOME/conf/extra/httpd-ssl.conf e configurar como mostrado abaixo:
c1. Comentar as propriedades SSLSessionCache e SSLSessionCacheTimeout
TOTVS S.A.
70
Reiniciar o apache.
Com essas configuraes o sistema rodar normalmente, porm vale relembrar que o sistema
funcionar completamente em HTTP sobre SSL com a compilao do Flex com os endpoints em
TOTVS S.A.
Configurao HTTPS
71
HTTPS. Sendo assim, necessrio que seja feita a compilao dos fontes com os endpoints alterados.
3.3
Tunning Apache
3.3.1
Sistema Operacional
O servidor apache possui um compilado para cada sistema operacional e de acordo com a
compilao o modulo que atende as configuraes disponibilizada. Para saber o mdulo que atende
seu SO basta seguir a tabela abaixo:
Apache
BeOS
Link
Netware
Link
OS/2
Link
Unix
Link
Windows
Link
3.3.2
Configuraes
As configuraes descritas nesse artigo foram baseadas na verso 2.2.xx do apache server,
sendo assim, rara configurar o apache basta abrir o arquivo $APACHE_HOME\conf\httpd.conf e encontrar
o contedo abaixo e tirar o comentrio da segunda linha:
De:
# Server-pool management (MPM specific)
# Include conf/extra/httpd-mpm.conf
Para:
# Server-pool management (MPM specific)
Include conf/extra/httpd-mpm.conf
Salvar e fechar o arquivo mencionado acima e abrir o arquivo $APACHE_HOME\conf\extra\httpd-mpm.
conf. Dentro desse arquivo existem todas as parameterizaes por SO de acordo com a Tabela 1. Para o
TOTVS S.A.
72
TOTVS S.A.
Configurao HTTPS
73
#
# KeepAlive: Whether or not to allow persistent connections (more than
# one request per connection). Set to "Off" to deactivate.
#
KeepAlive On
#
# MaxKeepAliveRequests: The maximum number of requests to allow
# during a persistent connection. Set to 0 to allow an unlimited amount.
# We recommend you leave this number high, for maximum performance.
#
MaxKeepAliveRequests 10000
#
# KeepAliveTimeout: Number of seconds to wait for the next request from the
# same client on the same connection.
#
KeepAliveTimeout 15
Salvar o o arquivo e iniciar o apache. Desta forma o apache estar apto a executar dentro de um limite
considervel de performance, no entanto, caso seja necessrio, possvel aumentar as configuraes.
Observao: Deve-se ter cuidado com os recursos utilizados no server para no consumir o SO por
completo e deixar o sistema ainda mais lento.
3.4
Acerto Ambiente
Para utilizar o produto com HTTPS, o arquivo index-flex-https.swf (presente na raiz do WAR: [..]\datasulbyyou-12.1.x-SNAPSHOT.ear\datasul-framework-ui.war) deve ser renomeado para index-flex.swf, e o
arquivo index-flex.swf original (que corresponde ao index para http normal) deve ser renomeado com
outro nome, para que seja considerado o .swf para https.
4.1
Introduo
A finalidade deste Guia descrever as configuraes do produto Datasul 12, demonstrando o
arquivo onde cada configurao realizado.
Importante:
Conforme a verso das ferramentas algumas telas podem aparecer diferentes do que foi
TOTVS S.A.
74
exposto no guia.
A configurao e instalao do GoGlobal, TS e Citrix de responsabilidade do cliente que
em caso de dvida deve acionar o suporte do fabricante.
Para cada sesso utilizada no acesso remoto deve ter configurado uma banda de 20kbps
por usurio.
4.2
Em RemoteApp Programs clicar com o boto direito e adicionar o programa Add RemoteApp
Programs
TOTVS S.A.
Clicar em Next
TOTVS S.A.
75
76
TOTVS S.A.
77
Alterar o nome conforme o desejado (RemoteApp program name:), no exemplo foi utilizado
Datasul 11 mas pode ser qualquer nome que posteriormente ser usado na configurao do
arquivo config.xml.
TOTVS S.A.
78
Aps a criao deve ser configurado o arquivo config.xml do Datasul 11 para acessar o TS,
importante fazer um backup do arquivo antes de fazer as alteraes.
Configurar o arquivo config.xml localizado abaixo da estrutura <Dir Instal Programas>\scripts.
Segue os itens a serem configurados nesse arquivo, sendo que as tags no citadas no devero
ser alteradas:
RemoteConnectionType
TOTVS S.A.
79
RemoteServerPort
Informe uma porta que servir de comunicao entre o Jboss e o Terminal Server.
Ex: <RemoteServerPort>8085</RemoteServerPort>
MetaframeServer
Informe o nome ou endereo IP do servidor Terminal Server.
Ex: <MetaframeServer>jaguaribe</MetaframeServer>
MetaframeServerPort
Informe a porta de acesso ao Terminal Server.
Ex: <MetaframeServerPort>3389</MetaframeServerPort>
MetaframeServerId
Informe o nome da aplicao criada no servidor TS conforme os exemplos acima.
Ex: <MetaframeServerId>Datasul11</MetaframeServerId>
RemoteShortcut Description
Informe os parmetros para execuo da sesso Progress.
Observaes:
Procurar deixar os caminhos definidos em <RemoteShortcut Description o menor possvel, isso
para evitar estouro ao carrgerar as informaes para o JAVA.
Aps a alterao do arquivo o JBOSS tem que ser reiniciado.
No exemplo o servidor do TS est instalado no mesmo servidor do Datasul 11, mas pode estar
TOTVS S.A.
80
configurado em outro servidor disponvel na empresa. Porm deve ter Progress instalado e
atualizado com os services packs disponveis.
Abaixo um exemplo do arquivo alterado contendo as informaes para acesso com TS.
TOTVS S.A.
81
Feito isso tem que informar usurio e senha de rede para validar o acesso ao servidor para abrir
o Datasul Interactive.
TOTVS S.A.
82
4.3
Seguem os procedimentos a serem executados para que o acesso remoto seja executado
corretamente:
Criar uma aplicao no Citrix Management Console em Presentation Server Console, clicar
com boto direito em Applications > Publish application (esta aplicao dever estar visvel aos
usurios via Web Interface).
Display Name o nome da aplicao que ser executada (no exemplo, Datasul11);
TOTVS S.A.
83
TOTVS S.A.
84
TOTVS S.A.
Application Appearance
TOTVS S.A.
85
86
Clients Requirements
TOTVS S.A.
Application Limits
TOTVS S.A.
87
88
TOTVS S.A.
89
Users Allow only configured Users Informe os usurios que devem ter acesso a aplicao via
Citrix;
TOTVS S.A.
90
TOTVS S.A.
91
ATENO: Todos os usurios do sistema operacional devem ter acesso e permisso nos
diretrios e programas definidos no PROPATH da sesso, assim como, aos arquivos .ini, .pf,
datasul-framework-citrixproxy-java-1.0.2.jar, citrix.bat, citrix.properties e Progress.
TOTVS S.A.
92
TOTVS S.A.
93
Aps criar o diretrio virtual, configurar o arquivo web.config abaixo da pasta DatasulCtxWI,
conforme orientaes abaixo:
<add key=" CtxWIConfigFile" value="C:\caminhoWebinterface\WebInterface.conf"/>
Deve ser informado o caminho completo do arquivo WebInterface.conf do Citrix. Caso o diretrio
virtual esteja em um servidor IIS diferente do WebInterface, o arquivo WebInterface.conf pode ser
copiado para um diretrio local, como a prpria pasta DatasulCtxWI.
<add key=" CtxFarmName" value="SUPORTE"/>
Informar o nome da Farm do citrix onde o atalho para o arquivo citrix.bat foi publicado.
ATENO: No servidor IIS onde o diretrio virtual foi publicado, requisito possuir o .NET
Framework 3.5 instalado, bem como o visual J# 2.0 (Redistributable Package). Ambos podem ser
localizados no Download Center da Microsoft.
TOTVS S.A.
94
TOTVS S.A.
95
RemoteConnectionType
Informar o tipo de conexo remota (CITRIX).
Ex: <RemoteConnectionType>Citrix</RemoteConnectionType>
RemoteServerPort
Informe uma porta que servir de comunicao entre o Jboss e o Citrix.
Ex: <RemoteServerPort>8085</RemoteServerPort>
RemoteShortcut Description
Informe uma descrio para a conexo. A valor do item Path pode ficar em branco,
Ex: <RemoteShortcut Description="Citrix" Path="" />
MetaframeServer
Informe o nome ou endereo IP do servidor Citrix.
Ex: <MetaframeServer>citrixserver</MetaframeServer>
ASPHttpServer
Informe a URL para o diretrio virtula publicado anteriormente:
Ex: <ASPHttpServer>http://citrixserver/DatasulCtxWI</ASPHttpServer>
MetaframeServerId
Informe o nome da aplicao criada no servidor Citrix.
Ex: <MetaframeServerId>Datasul11</MetaframeServerId>
Abaixo um exemplo do arquivo alterado contendo as informaes para acesso com Citrix.
TOTVS S.A.
96
TOTVS S.A.
97
Feito isso tem que informar usurio e senha de rede para validar o acesso ao servidor para abrir
o Datasul Interactive.
TOTVS S.A.
98
4.3.1
4.3.1.1
No menu do produto ao selecionar um tem que execute uma tela Progress, ser apresentado uma
janela para login no Datasul Connection for Web. Aps informar usurio/senha e domnio, o sistema
executar via o Citrix Receiver a tela Progress correspondente.
4.4
TOTVS S.A.
99
Instalar o Java.
Criar uma aplicao no GoGlobal Cluster Manager > Applications > Add.
Display Name o nome da aplicao que ser executada (para que esta configurao
funcione corretamente, o valor deste campo dever ser DI);
Executable Path Deve apontar para o java.exe, localizado abaixo da estrutura <Dir Instal
Java>\ bin\java.exe;
Start Directory Diretrio temporrio para a sesso;
Startup State Normal.
TOTVS S.A.
100
Configurar o log do GoGlobal 3 em Tools > Server Options > Log. Recomendamos o nvel 6
de log para que sejam mostrados todos os eventos.
Configurar o log do GoGlobal 4 em Tools > Host Options > Log. Recomendamos o nvel 6 de
log para que sejam mostrados todos os eventos.
TOTVS S.A.
101
ATENO: Todos os usurios do sistema operacional devem ter acesso e permisso nos
diretrios e programas definidos no PROPATH da sesso, assim como aos arquivos .ini, .pf,
datasul-framework-citrixproxy-java-1.0.2.jar e Progress. Caso os usurios no possuam
permisso, sero registrados erros de acesso no log do GoGlobal.
RemoteServerPort
Informe uma porta de comunicao com o Datasul Connection for Web (GoGlobal).
Ex: <RemoteServerPort>8085</RemoteServerPort>
RemoteShortcut Description
Informe os parmetros para execuo da sesso Progress.
Ex: < RemoteShortcut Description=" GOGLOBAL" Path="-jar "C:\Datasul12\datasulframework-citrixproxy-java-1.0.2.jar" "c:\dlc102b\bin\prowin32.exe"
"C:\Datasul12\datasul.pf" "C:\Datasul12\datasul-progress.ini"
"C:\Datasul12\datasul-alias.p" " />
MetaframeServer
Informe nome ou IP do servidor GoGlobal.
Ex: <MetaframeServer>legacy2</MetaframeServer>
TOTVS S.A.
102
MetaframeServerLibURL
Informe a URL onde se encontram os componentes do GoGlobal (este diretrio virtual dever estar
publicado em servidor Web).
Ex:<MetaframeServerLibUrl>http://legacy2/goglobal</MetaframeServerLibUrl>
Abaixo um exemplo do arquivo alterado contendo as informaes para acesso com GoGlobal
TOTVS S.A.
103
Feito isso tem que informar usurio e senha de rede para validar o acesso ao servidor para abrir
o Datasul Interactive.
4.4.1
Acertos GoGlobal 4
O GoGlobal 4 passa a ser suportado a partir do Datasul 11.5.7. So necessrios os ajustes abaixo
para que a conexo com o GoGlobal funcione corretamente.
RemoteConnectionType
Informe o tipo de conexo remota e a verso full do GOGLOBAL. A version_full pode ser
localizada na release da instalao do GoGlobal:
Ex: <RemoteConnectionType>GOGLOBAL#4,7,0,17377</RemoteConnectionType>
RemoteServerPort
Informe uma porta de comunicao com o Datasul Connection for Web (GoGlobal). Insira uma
TOTVS S.A.
104
Para o correto funcionamento marcamos a opo Standard authentication em GoGlobal -> Host
Options -> Secury, para que o GoGLobal sempre solicite usuario e senha ao abrir uma sessao (o usurio
no vai precisar digitar, pois o datasul informa automaticamente para o GoGlobal).
Detalhes:
1. Ao ativar a opcao de cache, armazenada a senha do usuario em cache por algum tempo, no
entanto, quando o usurio muda a senha no domnio ocorrer demora para modificar o cache
no GoGlobal, podendo gerar erros (no recomendado).
2. Ao ativar a opo Integrated Windows Authentication, no solicitada autenticao para
abertura da sesso, autenticando-se automaticamente o usurio logado no Windows. Com essa
opo ativada o servidor no acessa recursos de rede, no executando mapeamentos ou scripts.
O GoGlobal (por enquanto) no transmite as credenciais do desktop para o servidor via rede.
Assim no possvel autenticar a sesso do usurio fora do servidor (rede ou outros servidores),
impossibilitando a execuo dos programas.
TOTVS S.A.
105
Feito isso tem que informar usurio e senha de rede para validar o acesso ao servidor
TOTVS S.A.
106
TOTVS S.A.