Guia de Instalao

TOTVS Datasul 11






Programas
Banco de Dados
Servidor de Aplicao
Documentao
Converso

Instalao de Mltiplas Instncias
Esta mdia est preparada para instalar mltiplas instncias do produto. Mais
informaes so fornecidas no decorrer do documento.

TOTVS S.A.
2

1. Prefcio ........................................................................................................................................ 4
1.1. Finalidade .......................................................................................................... 4
1.2. Pblico Alvo ....................................................................................................... 4
1.3. Organizao deste Guia .................................................................................... 4
1.4. Documentaes Importantes ............................................................................. 5
2. Introduo .................................................................................................................................... 6
2.1. Arquitetura Distribuda do produto ..................................................................... 6
2.2. Tipos de Instalao ............................................................................................ 7
2.2.1. Alertas durante a instalao ........................................................................... 8
3. Requisitos Mnimos ...................................................................................................................... 8
3.1. Viso Geral dos Requisitos ................................................................................ 8
3.2. Requisitos de Hardware ..................................................................................... 9
3.2.1. Requisitos para estao client ........................................................................ 9
3.2.2. Requisitos para servidor ............................................................................... 10
3.3. Requisitos de Software .................................................................................... 10
3.3.1. Progress ....................................................................................................... 10
3.3.2. Java .............................................................................................................. 11
3.3.3. Flash Player e Navegador ............................................................................ 11
3.3.4. Ferramentas de Acesso Remoto .................................................................. 11
3.3.5. Requisitos para bancos Oracle ..................................................................... 11
3.3.6. Requisitos para Client Linux ......................................................................... 12
3.3.6.1. Requisitos para Instalao do Citrix Receiver ........................................ 12
3.3.6.2. Download do Citrix Receiver .................................................................. 13
3.3.6.3. Instalao do Citrix Receiver .................................................................. 13
3.3.6.4. Executando Telas Progress ................................................................... 13
3.4. Requisitos de Usurio (Servidor) ..................................................................... 13
4. Instalao ................................................................................................................................... 14
4.1. Detalhes da Mdia de Instalao ...................................................................... 14
4.2. Planejando a Instalao ................................................................................... 14
4.3. Etapas comuns para qualquer tipo de instalao ............................................. 15
4.4. Instalao de Programas ................................................................................. 16
4.5. Instalao de Banco de Dados ........................................................................ 16
4.5.1. Bancos Progress .......................................................................................... 16
4.5.1.1. Configurao do Progress Explorer Tool ................................................ 18
4.5.1.2. Objetos criados na instalao Banco de dados Progress ....................... 18
4.5.1.3. Sistemas Operacionais Unix .................................................................. 19
4.5.1.4. Criao dos bancos com acesso SQL .................................................... 19
4.5.2. Bancos Oracle .............................................................................................. 20
4.5.2.1. Objetos criados na instalao Banco de dados Oracle........................... 21
4.5.2.2. Criao dos Objetos no banco Oracle .................................................... 21

TOTVS S.A.
3
4.6. Instalao do Servidor de Aplicao ................................................................ 22
4.6.1. Objetos criados na instalao do Servidor de Aplicao ............................... 25
4.7. Instalao da Documentao........................................................................... 25
4.8. Instalao do Console de Converso .............................................................. 25
4.9. Inicializando o Datasul 11 ................................................................................ 26
4.10. Acesso ao Datasul 11 ...................................................................................... 28
4.11. Acesso Remoto ............................................................................................... 28
4.11.1. Datasul Connection for Web (GoGlobal) ....................................................... 29
4.11.2. Citrix Meta Frame ......................................................................................... 30
4.11.3. Terminal Server ............................................................................................ 33
4.12. Ajustes aps instalao ................................................................................... 34
4.12.1. Permisso de sequences ............................................................................. 34
4.12.2. Atalho Gesto de Planos ............................................................................. 35
4.12.3. Configurao de envio de e-mail com autenticao ...................................... 35
4.12.4. Matriz de Traduo EMS 5 .......................................................................... 35
4.13. Verificao do ambiente aps instalao ......................................................... 36
5. Atualizao ................................................................................................................................. 37
6. Reinstalao .............................................................................................................................. 37
7. Desinstalao ............................................................................................................................. 38


TOTVS S.A.
4
1. Prefcio
1.1. Finalidade

Este guia tem como finalidade descrever de forma objetiva, os procedimentos necessrios
para a instalao do produto Datasul 11, bem como configurar o produto nas plataformas
suportadas. A mdia de instalao tambm poder ser utilizada para atualizao de
programas.
1.2. Pblico Alvo

Por este processo de instalao ser complexo, a instalao requer pessoas que tenham
conhecimentos da arquitetura do produto Datasul 10 ou Datasul 11, Progress, Java, Flex,
Jboss e ambiente de rede.
1.3. Organizao deste Guia

Captulo 2, Introduo
Este captulo apresenta uma viso geral da arquitetura distribuda, tipos de instalao e
exemplos de topologias no uso do produto.

Captulo 3, Requisitos
Este captulo apresenta a lista de requisitos mnimos de hardware e software exigidos na
instalao e configurao do produto.

Captulo 4, Instalao
Este captulo descreve os procedimentos que devero ser executados para a instalao
do produto. Abrange desde o planejamento da instalao, ou seja, escolher o tipo de
instalao adequado, at as configuraes necessrias para acesso remoto.

Captulo 5, Atualizao
Este captulo descreve o procedimento de atualizao do produto.


TOTVS S.A.
5
Captulo 6, Reinstalao
Este captulo descreve os procedimentos a serem executados para a reinstalao de
cada componente do Datasul 11, bem como os cuidados necessrios para a execuo
dessa rotina.

Captulo 7, Desinstalao
Este captulo descreve os procedimentos necessrios para a desinstalao do Datasul 11.
1.4. Documentaes 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.

Manuais Datasul Connection for Web (GoGlobal)
Administrator Guide;
License Agreement;
Quick Start Guide.
Estas e outras documentaes podem ser obtidas no site da Graphon e GoGlobal.
Manuais Datasul
Guia de Converso.

TOTVS S.A.
6
2. Introduo
2.1. Arquitetura Distribuda do produto

Arquitetura distribuda consiste em separar os componentes em plataformas
independentes que interagem entre si, permitindo que os recursos sejam compartilhados
enquanto se obtm ao mximo os benefcios de cada dispositivo. Basicamente, funciona
da seguinte forma: as mquinas dos usurios estaro conectadas aos servidores pela
rede; cada servidor fornecer recursos diferentes para que os programas possam ser
executados da mquina do usurio.
A figura abaixo mostra os quatro componentes bsicos utilizados pelo produto.




Rede TCP/IP


Usurios
Servidor de Banco de Dados
Ambiente do Cliente
Servidor de Aplicao Servidor de Arquivos

TOTVS S.A.
7
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.

Documentao
Instala os manuais e documentao do produto.

Console de Converso
Instala os objetos necessrios para a converso dos produtos legados para o
Datasul 11. Esta opo somente deve ser utilizada quando houver converso de
produtos Datasul para o Datasul 11.

Importante: Esta mdia preparada para instalar vrias instncias do produto
Datasul 11 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

TOTVS S.A.
8
acima. A rea de programas ser a mesma no ambiente e ser compartilhada por todas
as instncias.
2.2.1. Alertas durante a instalao

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.
3. Requisitos Mnimos

Este captulo tem por objetivo divulgar recomendaes sobre o uso de hardware e
software relacionados ao Datasul 11 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 11 possui maior
complexidade que um ambiente client/server padro, como por exemplo, EMS 2, EMS 5,
etc. A correta configurao e tuning do ambiente (servidores, redes, clients, banco de
dados, etc.) so importantes para o funcionamento do Datasul 11, 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 11 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.
3.1. Viso Geral dos Requisitos

Servidor
30 usurios (sem considerar DCFW, Citrix e outros)
Hardware

TOTVS S.A.
9
Disco 120 GB
Memria 4 GB
Processador Intel Xeon Dual 2.00 GHz

Software
Java JRE 1.6
OpenEdge 10.2B05 Fix 01

Estao Client
Windows
Hardware
Memria (Arquitetura 32-bit) 1 GB Mnimo (2GB Recomendado)
Memria (Arquitetura 64-bit) 2 GB Mnimo
Processador Intel Pentium IV 2.80 GHz (Pentium Dual-
Core Recomendado)
Resoluo de Tela 1024 x 768 ou superior

Software
Flash Flash Player 10
Navegadores Internet Explorer 7
Internet Explorer 8
Internet Explorer 9
Firefox 3.5 e 7
Java JRE 1.6
3.2. Requisitos de Hardware
3.2.1. Requisitos para estao client

necessrio que a estao client possua o sistema operacional Windows instalado,
devido ao Datasul 11 utilizar a linguagem Progress que possui arquitetura 32-bit (Win32).
Informaes adicionais quanto s plataformas e sistemas operacionais homologados
podem ser obtidas no site da Progress (Product Availability Guide).
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

TOTVS S.A.
10
dedicada para ele) ou de um usurio que use vrias aplicaes simultneas (necessidade
de mais memria para executar processos como Office, e-mail, CAD, EIS, etc., ao mesmo
tempo).
Recomendamos a configurao 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.
3.2.2. Requisitos para servidor

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
acessado pelo Portal do Cliente.
3.3. Requisitos de Software
3.3.1. Progress

ALERTA: obrigatrio o uso do Progress 10.2B com Service Pack 05 Fix 01 ou
superior.

As licenas Progress embutidas no produto Datasul 11 so:
Licena
Sistema
Operacional
Observao
Openedge
Enterprise
RDBMS
Windows Server

Unix
Instalada no servidor de banco de dados para
execuo de rotinas de administrao dos bancos
Progress.
Openedge
DataServer for
Oracle
Windows Server

Unix
Somente utilizada com banco de dados Oracle.
Pode ser instalada nos clients (DataServer Local) ou
no servidor (DataServer Remoto)
OpenEdge
DataServer for
Microsoft SQL
Windows Server
Somente utilizada com banco de dados SQL Server.
Pode ser instalada nos clients (DataServer Local) ou
no servidor (DataServer Remoto)
Openedge Windows Instalada no servidor de aplicao para

TOTVS S.A.
11
Application
Server

Unix
configurao de servios como AppServer,
Webspeed, WebServices, etc.
Client
Networking
Windows

Unix
Instalada nas estaes client ou no servidor de
arquivos (Progress compartilhado). Necessrio
tambm no servidor de banco de dados para
execuo de rotinas via RPW.
Query / Results
Windows Server

Unix
Instalada nas estaes client ou no servidor de
arquivos (Progress compartilhado) para execuo e
compilao de relatrios.

ALERTA: liberada somente um tipo de licena relacionada a banco de dados
(Openedge Enterprise RDBMS, Openedge DataServer for Oracle ou Openedge
DataServer for Microsoft SQL), de acordo com o sistema gerenciador de banco
de dados utilizado em sua empresa.
3.3.2. Java

Se o Sistema Operacional for 64-bit, instalar preferencialmente o Java 64-bit (JRE) na
mesma verso disponibilizada na mdia de instalao do produto.
3.3.3. Flash Player e Navegador

Para executar o Datasul 11 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)
3.3.4. Ferramentas de Acesso Remoto

Para a execuo de programas Progress via Internet, necessria a utilizao de
ferramentas de acesso remoto de terceiros. O produto Datasul 11 est homologado e
possui configuraes de acesso remoto para Datasul Connection for Web (GoGlobal),
Citrix (Citrix Presentation Server Verso 4.5) e Terminal Server.
3.3.5. Requisitos para bancos Oracle

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:

TOTVS S.A.
12
select parameter, value
from nls_database_parameters
where parameter = 'NLS_CHARACTERSET'
NLS_LANGUAGE AMERICAN
NLS_TERRITORY AMERICA
NLS_CHARACTERSET WE8ISO8859P1
NLS_NCHAR_CHARACTERSET AL16UTF16

Select name, value from v$parameter where name = 'db_block_size';
Select name, value from v$parameter where name = 'open_cursors';

CHARACTERSET: Obrigatoriamente o cdigo de pgina do banco deve possuir o valor
WE8ISO8859P1. Caso o valor deste parmetro no seja este, a instncia dever ser
recriada. Este parmetro somente informado durante a criao do banco, desta forma
no existe maneira de alter-lo sem recriar a instancia.
Tamanho do bloco da instncia Oracle: Caso o database tenha valor de bloco menor que
8k (8192 bytes) observado pelo parmetro de inicializao (db_block_size), a mesma
dever ser recriada. Caso no seja possvel, crie nova database para os produtos Datasul
Disponibilidade de Cursores: Recomendamos administrar no parmetro de inicializao
(open_cursors) um valor maior que o padro de instalao da instncia. Inicie com valor
de 50000 ou maior.
Estaes de trabalho: Em cada estao deve ser instalado o produto Net Service do
Oracle. Nunca instale este produto com idioma diferente de ingls. Neste caso, o
NLS_LANG ter o valor: AMERICAN_AMERICA.WE8ISO8859P1 nas chaves de registro
(regedit) da estao ou servidores de aplicao. Esta configurao retorna melhor
desempenho aos produtos que tem relacionamento Client/Server.
3.3.6. Requisitos para Client Linux

Devido a restries da GUI Progress, para acesso ao Datasul 11 atravs de estaes
Linux necessrio a utilizao de uma soluo do tipo Metaframe. Atualmente
suportamos o uso da soluo de Metaframe da Citrix. Para tanto necessrio instalar nas
estaes Linux o client do Citrix Receiver. Veja a seguir os requisitos necessrios e
passos para configurao das estaes Linux.
Suporte para outras solues de Metaframe (como GoGlobal) sero acrescentados em
Roadmap para futura homologao interna.
3.3.6.1. Requisitos para Instalao do Citrix Receiver


TOTVS S.A.
13
Linux kernel verso 2.6.29 ou superior, com glibc 2.7 ou superior, gtk 2.12.0 ou
superior, libcap1 ou libcap2 e suporte para udev.
OpenMotif 2.3.1 ou superior.
6M de espao em disco.
Video display com 256 cores ou superior
Firefox 3.6 ou superior
Esta configurao foi testada nas seguintes distribuies: Ubuntu 10.4, Mint 11.
3.3.6.2. Download do Citrix Receiver

Acesse o endereo http://www.citrix.com/English/ss/downloads
Clicar no link para Citrix Receiver e em seguida a opo Linux
Baixar a verso 12.0 ou superior de acordo com sua distribuio Linux (.deb ou
.rpm).
3.3.6.3. Instalao do Citrix Receiver

Abrir uma janela de terminal (shell)
Para executar a instalao com pacote RPM:
sudo rpm -i pakagename.rpm
Para executar a instalao com pacote DEB:
sudo dpkg -i packagename.deb
3.3.6.4. Executando Telas Progress

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.
3.4. Requisitos de Usurio (Servidor)

Recomenda-se que a instalao dos produtos Datasul seja efetuada com o usurio
administrador, ou com um usurio que esteja incluso no grupo de administradores do
servidor.

TOTVS S.A.
14
4. Instalao
4.1. Detalhes da Mdia de Instalao

A mdia de instalao do Datasul 11 disponibilizada em DVD e pelo Portal do Cliente.
Nesta mdia esto disponveis:
Guia de Instalao do produto;
Guia de Suporte ao Cliente;
Guia de Converso;
Guia de Unificao de Conceitos;
Java;
Setup e arquivos necessrios para instalao do produto.
4.2. Planejando a Instalao

Mostraremos agora as etapas que devem ser seguidas para a instalao e configurao
do Datasul 11, 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;
Instale os programas no servidor de arquivos;
Instale os bancos de dados;
Instale o servidor de aplicao;
Carregue os bancos de dados utilizando os scripts pelo aplicativo Openedge
Explorer;
Inicialize o produto utilizando o atalho criado em Iniciar > Programas > TOTVS
Datasul > Administrao > Inicializador do Produto durante a instalao do servidor
de aplicao;
Inicie o Jboss atravs do servio TOTVS Datasul - <ID> criado no Services do
Windows.
Aps a concluso destas etapas, o produto estar pronto para utilizao.

TOTVS S.A.
15
4.3. Etapas comuns para qualquer tipo de instalao

ALERTA: Antes de iniciar a instalao, necessrio copiar todo o contedo do
DVD2 para o DVD1. Caso isto no seja feito, a instalao ser interrompida no
meio do processo.
As etapas abaixo so comuns para todos os tipos de instalao do Datasul 11:

Tela Informe o ID para esta instalao
Dever ser informado um identificador (ID) para esta instalao. Como o diretrio de
instalao do produto padro, este ID necessrio para evitar sobreposio de arquivos
quando existir mais de uma instalao do produto no mesmo servidor.
Tela de Registro do usurio
Informe o Nome do Usurio e o Nome da Empresa que utilizar o Datasul 11.
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
Console de Converso
Selecione Avanar para continuar.
Os prximos captulos descrevero os procedimentos que devem ser executados para
cada tipo de instalao.

TOTVS S.A.
16
4.4. Instalao de Programas

Ao selecionar a opo Programas sero instalados os objetos Progress utilizados pelo
Datasul 11. 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 11, devido execuo dos programas Progress.
ALERTA: A instalao da rea de programas pr-requisito para a instalao
dos demais componentes da mdia de instalao.
O instalador 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 ou Caracter 64, ser criado um diretrio chamado char32 ou char64,
respectivamente dentro dos diretrios do produto.
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.
4.5. Instalao de Banco de Dados

Ao selecionar a opo Banco de Dados sero instalados e configurados os bancos
utilizados pelo Datasul 11.
4.5.1. Bancos 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.
Tela de configurao do Progress Explorer Tool

TOTVS S.A.
17
Essa tela definir de que forma ser configurado o arquivo conmgr.properties do
Progress. Esse o arquivo responsvel pela configurao dos bancos que sero
administrados pelo Progress Explorer Tool.
Permitir que o InstallShield modifique o arquivo conmgr.properties
Ao selecionar essa opo, o arquivo conmgr.properties localizado abaixo do
diretrio properties de instalao do Progress, ser alterado.
Nesse caso, aps iniciar o servio do AdminService possvel visualizar os bancos
pelo Progress Explorer Tool.
Com essa instalao, tambm criado um arquivo conmgr.properties abaixo do
diretrio scripts de instalao dos bancos de dados, contendo a configurao dos
bancos utilizados pelo Datasul 11.

Salvar as alteraes necessrias para o arquivo conmgr.properties.new
Ao selecionar essa opo, ser criado o arquivo conmgr.properties.new abaixo
diretrio properties de instalao do Progress e o arquivo conmgr.properties
original do Progress no ser alterado.
Nesse caso, antes de iniciar o servio do AdminService necessrio renomear o
arquivo conmgr.properties.new para conmgr.properties e assim ser possvel
visualizar os bancos pelo Progress Explorer Tool.
Com essa instalao, tambm criado um arquivo conmgr.properties abaixo do
diretrio scripts de instalao dos bancos de dados, contendo a configurao dos
bancos utilizados pelo Datasul 11.

No fazer nenhuma alterao
Ao selecionar essa opo, ser criado o arquivo conmgr.properties abaixo do
diretrio scripts de instalao dos bancos de dados, contendo a configurao dos
bancos utilizados pelo Datasul 11 e o arquivo conmgr.properties localizado abaixo
do diretrio properties de instalao do Progress no ser alterado.
Nesse caso, antes de iniciar o servio do AdminService necessrio copiar o
arquivo conmgr.properties localizado abaixo do diretrio scripts para o diretrio
properties do Progress e assim ser possvel visualizar os bancos pelo Progress
Explorer Tool.
Selecione Avanar para continuar.

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, os bancos sero instalados e configurados.

TOTVS S.A.
18
4.5.1.1. Configurao do Progress Explorer Tool

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.
ALERTA: Os bancos emsfnd, emsdev, finance, payroll, ems2sor e
mdtfrw, mdmerge e mdtcrm, possuem uma configurao diferenciada. Para
cada banco acima referenciado, existe um broker especfico para conexes do
tipo SQL.
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 11, 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.
4.5.1.2. Objetos criados na instalao Banco de dados Progress

Seguem os objetos importantes para administrao do ambiente, criados na instalao de
banco de dados em ambiente Windows.
Localizao Objeto Descrio
<Dir Instal Bancos>\scripts ReparaBancos.bat
Script para reparar a estrutura dos
bancos.
<Dir Instal Bancos>\scripts datasulDescargaBancos.bat
Script para derrubar os bancos
iniciados de forma manual
(proserve ou _mprosrv) ou
iniciados pelo script
datasulCargaBancos.bat.
<Dir Instal Bancos>\scripts datasulCargaBancos.bat
Script para iniciar os bancos. Ao
iniciar os bancos por esse script, os

TOTVS S.A.
19
bancos no sero gerenciados pelo
Progress Explorer Tool.
<Dir Instal Bancos>\scripts conmgr.properties
Arquivo responsvel pela
configurao dos bancos que sero
administrados pelo Progress
Explorer Tool.
4.5.1.3. Sistemas Operacionais Unix

A mdia de instalao no cria os bancos de dados automaticamente para estes sistemas
operacionais (Linux, AIX, HP-UX, HP-UX Itanium, Solaris, etc.). Desta forma, a mdia de
banco de dados dever ser instalada em ambiente Windows e os bancos de dados
devero ser criados manualmente.
4.5.1.4. Criao dos bancos com acesso SQL

Os bancos emsdev, emsfnd, payroll, finance, ems2sor, mdtfrw, mdmerge e
mdtcrm possuem acesso SQL e devem ser criados de acordo com os procedimentos
descritos abaixo (para sistema operacional que no seja Windows ou para bancos criados
manualmente):
Acessar o console do servidor de banco de dados;
Definir as variveis do Progress
export DLC=<Dir Instal Progress>
export PATH=<Dir Instal Progress>/Bin:$PATH
Criar o banco de dados
prodb <nome banco> <Dir Instal Progress>/empty8
Acessar o Data Administration do Progress, conectando o banco de dados em modo
mono usurio
pro -Mm 4096 -cpstream ibm850 -d dmy -E -rx -db <banco> -1 -p _admin.p
Executar o load de definies (.df) pelo Admin > Load Data and Definitions > Data
Definitions (.df file), para os bancos emsfnd e ems2uni;


DICA: As definies (.df e .dfsql) podem ser obtidas abaixo da estrutura <Dir
Instal Bancos>\database\definicoes.



TOTVS S.A.
20
Criar o usurio sysprogress, senha sysprogress e o usurio pub, senha pub pelo
Admin > Security > Edit User List;
Fechar a sesso Progress e carregar o banco com um broker SQL
proserve <banco> -S <porta> -N TCP -H <nome servidor banco> <parmetros>
proserve <banco> -S <porta> -N TCP -H <nome servidor banco> -m3
ServerType SQL <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
payroll;
sqlexp user sysprogress password sysprogress -url
jdbc:datadirect:openedge://<nome servidor banco>:<porta do broker
SQL>;databaseName=<banco> -infile <arquivo.dfsql>

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;
ALERTA: O banco mdtfrw no possui definio. Ele deve ser criado vazio e
conectado ao produto desta forma, pois as tabelas so criadas dinamicamente
na carga do Jboss.
Aps a execuo desses procedimentos, os bancos utilizados pelo Datasul 11 estaro
instalados e configurados.
4.5.2. Bancos Oracle

ALERTA: Para a utilizao do produto, o valor da NLS_LANG dever estar
configurado para AMERICAN_AMERICA.WE8ISO8859P1, tanto no servidor
quanto nas estaes cliente.
DICA: A porta do broker a porta definida para o parmetro -S ao carregar o
banco com o parmetro -ServerType SQL.





TOTVS S.A.
21

Tela Instncia Oracle
Informar o nome da instncia do Oracle que ser utilizada para armazenar os objetos
desta instalao.
Tela Configurao do Servidor Oracle
Informe nesta tela o nome do servidor e a porta do Listener para esta instncia. Estas
informaes sero utilizadas para criar os objetos no banco Oracle.
Tela Localizao dos Datafiles
Informar o diretrio onde deseja armazenar os Datafiles dos tablespaces que sero
utilizados para o produto Datasul 11.
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.
4.5.2.1. Objetos criados na instalao Banco de dados Oracle

Seguem os arquivos para a criao dos objetos e administrao do ambiente, criados na
instalao de banco de dados Progress.
Localizao Objeto Descrio
<Dir Instal Bancos>\scripts criaObjetoOracle.sql
Script para criar os objetos (tabelas,
ndices, etc.) no banco Oracle.
<Dir Instal Bancos>\scripts criaTablespaceOracle.sql
Script para criar os tablespaces para o
produto Datasul 11 no banco Oracle.
<Dir Instal Bancos>\scripts criaUsuarioOracle.sql
Script para criar os usurios do
produto Datasul 11 no banco Oracle.
<Dir Instal Bancos>\scripts gerenciadorScripts.sql
Script que gerencia a chamada dos
demais scripts Oracle. Este arquivo
dever ser executado para que os
objetos sejam criados no banco
Oracle.
<Dir Instal Bancos>\scripts ReparaBancos.bat
Script para reparar a estrutura dos
bancos Schema Holder.

4.5.2.2. Criao dos Objetos no banco Oracle


TOTVS S.A.
22
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.
4.6. Instalao do Servidor de Aplicao

Ao selecionar a opo Servidor de Aplicao sero instalados e configurados servios
do Jboss e Datasul Interactive para execuo do Datasul 11.
Seguem as etapas para a execuo desse processo:
Tela Local de destino
Informar o diretrio onde ser instalado o Servidor de Aplicao no servidor.
Recomendamos o diretrio default sugerido pela mdia de instalao.
Tela de execuo remota
Caso sejam efetuadas conexes remotas para acesso ao Datasul 11 via Datasul
Connection for Web (GoGlobal), Citrix ou Terminal Server deve ser selecionada a opo
Sim. Do contrrio, deve ser selecionada a opo No para dar continuidade
instalao. Ao selecionar a opo Sim, ser apresentada a tela de seleo do tipo de
acesso remoto. Selecione o tipo de instalao e preencha conforme solicitado:
Datasul Connection for Web
URL: URL que contm as libs do Datasul Connection for Web
(GoGlobal);
Servidor: Informar o servidor onde se encontra instalado o Datasul
Connection for 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.


TOTVS S.A.
23
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 11. 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.
ALERTA: Caso seja informado localhost no campo servidor, o acesso ao
Datasul 11 somente ser feito onde est sendo instalado o servidor de aplicao.
A porta padro de comunicao com o Jboss 8080.
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.


Tela de Configuraes do Jboss
Informe o nmero da porta de acesso ao Jboss. Recomendamos utilizar a porta padro
(8080).
Tela de configurao do Progress Explorer Tool
Essa tela definir de que forma ser configurado o arquivo ubroker.properties do
Progress. Esse o arquivo responsvel pela configurao do servio AppServer Datasul
que ser administrado pelo Progress Explorer Tool.
DICA: Essa informao pode ser obtida no arquivo ubroker.properties,
localizado abaixo do diretrio properties do Progress. O parmetro que define a
porta de comunicao com o Nameserver o portNumber, abaixo da estrutura
[Nameserver] ou [Nameserver.XXX]. Por padro o Nameserver utilizado o NS1
com a porta UDP 5162.

TOTVS S.A.
24
Permitir que o InstallShield modifique o arquivo ubroker.properties
Ao selecionar essa opo, o arquivo ubroker.properties localizado abaixo do
diretrio properties de instalao do Progress ser alterado.
Nesse caso, aps iniciar o servio do AdminService possvel visualizar os servios
pelo Progress Explorer Tool.

Salvar as alteraes necessrias para o arquivo ubroker.properties.new
Ao selecionar essa opo, ser criado o arquivo ubroker.properties.new abaixo
diretrio properties de instalao do Progress e o arquivo ubroker.properties
original do Progress no ser alterado.
Nesse caso, antes de iniciar o servio do AdminService necessrio renomear o
arquivo ubroker.properties.new para ubroker.properties e assim ser possvel
visualizar o servio AppServer Datasul pelo Progress Explorer Tool.

No fazer nenhuma alterao
Ao selecionar essa opo, ser criado o arquivo ubroker.properties abaixo do
diretrio scripts da instalao do servidor de aplicao, contendo a configurao
do servio AppServer utilizado pelo produto e o arquivo ubroker.properties
localizado abaixo do diretrio properties de instalao do Progress no ser
alterado.
Nesse caso, antes de iniciar o servio do AdminService necessrio copiar o
arquivo ubroker.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 solicitado um usurio e senha de rede para
configurao com o Active Directory (AD).
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, caso contrrio no ser possvel
configurar o arquivo de autenticao utilizado pelo Josso.
Posteriormente ser apresentada uma mensagem informando que a configurao com o
Active Directory foi concluda corretamente. Aps a configurao com o Active Directory
ser apresentada a tela de concluso da instalao do Servidor de Aplicao.

TOTVS S.A.
25
ALERTA: Caso o servidor de Bancos de dados seja diferente de Windows, as
portas de conexo devero ser alteradas no arquivo progress-ds.xml,
localizado no diretrio deploy da instncia do Jboss.
4.6.1. Objetos criados na instalao do Servidor de Aplicao

Seguem os objetos importantes para administrao do ambiente, criados na instalao do
servidor de aplicao.
Localizao Objeto Descrio
<Dir Instal
Programas>\scripts-
[instncia]
config.xml
Arquivo responsvel pela configurao
dos atalhos para acesso ao produto.
<Dir Instal
Programas>\scripts-
[instncia]
datasul-progress.ini
Arquivo de inicializao da sesso que
contem configuraes de ambiente, como
por exemplo, fontes, cores, PROPATH,
outros.
<Dir Instal
Programas>\scripts-
[instncia]
datasul-configxml-alias.p
Script de alias utilizado para acesso ao
produto.
<Dir Instal
Programas>\scripts-
[instncia]
datasul-appserver-alias.p
Script de alias utilizado pelo servio
AppServer datasul.
<Dir Instal
Programas>\scripts-
[instncia]
datasul-aliasIni.p
Programa utilizado para inicializao do
produto.
<Dir Instal
Programas>\scripts-
[instncia]
datasul.pf
Arquivo que contem os parmetros de
sesso e parmetros de conexo com os
bancos.
<Dir Instal
Programas>\scripts-
[instncia]
ubroker.properties
Arquivo responsvel pela configurao do
servio AppServer datasul que ser
administrado pelo Progress Explorer Tool.
4.7. Instalao da Documentao

Ao selecionar a opo Documentao, sero instalados os manuais tcnicos, manuais
de diferenas funcionais e Release Notes. Os arquivos sero instalados no diretrio
padro do produto e no possvel alterar o destino.
4.8. Instalao do Console de Converso


TOTVS S.A.
26
Ao selecionar a opo "Console de Converso", sero instalados os objetos necessrios
para realizar a converso dos produtos legados para o Datasul 11.
Seguem as etapas para execuo desse processo:
Tela com o Tipo de Instalao
Nesta tela deve ser selecionado o produto origem para a converso. Pode-se selecionar
somente um produto por vez.
Tela de seleo da Release
Escolha a release do produto origem para a converso.

Tela de seleo do local de instalao
Informe o diretrio onde sero instalados os programas de converso. Caso o diretrio
no exista, ele ser criado. Os programas de converso devem ser instalados no mesmo
diretrio, sendo que o Console de Converso ser nico para todos os produtos.
Tela de seleo do diretrio de instalao do Progress
Caso o diretrio do Progress no seja detectado, esta tela ser apresentada. Neste caso,
informe o diretrio onde o Progress 10.2B est instalado.
Tela de resumo da instalao
Nesta tela ser informado um resumo das opes escolhidas nas telas anteriores. Confira
as informaes e modifique-as, caso necessrio. Ao clicar no boto Avanar a cpia dos
arquivos se iniciar.
Tela fim da instalao
Esta tela informar o fim do processo de cpia dos arquivos. Pressione o boto Concluir
para concluir a etapa.
ALERTA: O atalho de acesso ao Console de Converso e O Guia de
Converso sero instalados no desktop da mquina onde o console foi
instalado.
4.9. Inicializando o Datasul 11

DICA: possvel a instalao de mais de um produto origem por vez. Para
isso, basta utilizar o boto Voltar aps a escolha da release e escolher o outro
produto que deseja converter.

TOTVS S.A.
27
Durante a instalao do Servidor de Aplicao criado um atalho para inicializao do
produto em Iniciar > Programas > TOTVS Datasul > Administrador. Nesta etapa, os
bancos de dados devem estar carregados.
Seguem as etapas para a execuo dessa rotina:
Tela para configurao da empresa, pas e idioma
Informe o nome da empresa que utilizar o Datasul 11, o CNPJ (somente nmeros), o
pas e o estado de localizao da empresa, bem como o idioma para utilizao. Selecione
para continuar.
Tela de configurao dos produtos
Informe o produto que deve ser inicializado para utilizao no Datasul 11. Por padro,
todos os produtos esto definidos para inicializao (Sim). Para alterar essa informao,
d um clique duplo na linha do produto. Selecione para continuar.
Tela de strings, mensagens e literais
Informe a localizao dos arquivos de strings externas (<Dir Instal
Programas>\univdata\pt.d), mensagens (<Dir Instal Programas>\univdata\msg.d) e literais
(<Dir Instal Programas>\univdata\liter.d). Selecione para continuar.
Tela de inicializao do banco de dados emsdev
Nesta tela informe a localizao do arquivo de parmetros (<Dir Instal
Programas>\fnd\men\importador\parametros-[instncia].properties), de acordo com a
instncia que est sendo inicializada. Informar tambm o diretrio de localizao dos
arquivos .jar (<Dir Instal Programas>\fnd\men). Selecione para continuar.
Tela de configurao Bancos X Empresa
Os bancos apresentados nessa tela so os mesmos configurados para conexo no
arquivo .pf, localizado abaixo da estrutura <Dir Instal Programas>\scripts. Selecione
Iniciar para continuar.
Nesse momento ser executada a inicializao do produto.
A ltima etapa do processo de inicializao a importao de dados para o banco de
dados emsdev. Durante esta etapa, a tela do Inicializador ficar travada. Ao final ser
apresentado em tela o arquivo btb907za.txt, gerado abaixo do diretrio raiz de instalao
dos programas. Esse arquivo um log dos procedimentos executados.
Depois de verificar o log gerado, feche o arquivo e selecione concluindo o processo.
ALERTA: Deve ser verificada a existncia de registros na tabela StringTable.
Caso a mesma esteja vazia, execute via Prompt de Comando o script
importacaoByYou.bat, localizado abaixo do diretrio raiz de instalao dos

TOTVS S.A.
28
programas. Aps a execuo desse script, deve ser feita a verificao da tabela
novamente.
Aps a inicializao do produto necessrio fazer a configurao de negcio para que as
informaes sejam apresentadas conforme desejado no desktop do Datasul 11.
4.10. Acesso ao Datasul 11

Durante a instalao do Servidor de Aplicao criado um atalho em Iniciar > Programas
> TOTVS Datasul.
Porm, antes de acessar o produto, devem ser executados os seguintes procedimentos:
Carregar os bancos de dados;


Iniciar o servio AppServer datasul-[ID]-[instncia];


Iniciar o servio do Jboss (TOTVS Datasul) criado Painel de Controle >
Ferramentas Administrativas > Services;

ALERTA: Durante a primeira carga do Jboss so criados os objetos do
Metadados. Por este motivo, esta carga inicial tende a ser mais demorada.

Iniciar o servio Totvs License Server;
ALERTA: A mdia de instalao do Totvs License Server separada da mdia de
instalao do Datasul 11. O Totvs License Server dever ser instalado e
configurado antes de utilizar o produto.
4.11. Acesso Remoto

DICA: O servio AppServer pode ser iniciado via Progress Explorer Tool ou via
linha de comando pelo asbman.
DICA: Os bancos Progress podem ser carregados via Progress Explorer Tool
ou pelos scripts datasulCargaBancos.bat.

TOTVS S.A.
29
O acesso ao Datasul 11 poder ser feito remotamente utilizando o Datasul Connection for
Web (GoGlobal), Citrix Metaframe ou Terminal Server (todos possuem mdia de
instalao separada do produto).
4.11.1. Datasul Connection for Web (GoGlobal)

Para que o Datasul Connection for Web (GoGlobal) funcione corretamente ser
necessrio apontar o caminho dos arquivos .jar e .cab, e scripts Java disponibilizados
na instalao.
Seguem os procedimentos a serem executados para que o acesso remoto seja executado
corretamente:
Instalar a licena Progress Client Networking no servidor do Datasul Connection for
Web (GoGlobal).
Instalar o Java 1.6.
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.
Configurar o log do GoGlobal em Tools > Server Options > Log. Recomendamos
o nvel 6 de log para que sejam mostrados todos os eventos.

ALERTA: 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, ser registrado o erro abaixo no log
do GoGlobal.
175 2009-04-07 14:07:29.811 Corp40743 on Costao, pw (7512) Failed to assess if
launch request for "DI," process handle 0x000002b4, is pending (code 3/WLE288).

Configurar o arquivo config.xml localizado abaixo da estrutura <Dir Instal
Programas>\scripts. Seguem os itens a serem configurados nesse arquivo, sendo
que as tags no citadas no devero ser alteradas:
RemoteConnectionType

TOTVS S.A.
30
Informar o tipo de conexo remota (GOGLOBAL).
Ex: <RemoteConnectionType>GOGLOBAL</RemoteConnectionType>

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
\\f16\erp\scripts\proxy-1.0.0.jar
&quot;c:\dlc102b\bin\prowin32.exe&quot;
&quot;\\f16\ERP\scripts\emsmult.pf&quot;
&quot;\\f16\ERP\scripts\ems.ini&quot;
&quot;men\men906za.p&quot;" />

MetaframeServer
Informe nome ou IP do servidor GoGlobal.
Ex: <MetaframeServer>legacy2</MetaframeServer>

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>
ALERTA: Se algum dos parmetros acima descritos no estiver configurado
corretamente, os programas no sero executados. Caso haja alguma tag vazia,
recomendamos remov-la do arquivo (realizar um backup prvio do arquivo).


4.11.2. Citrix Meta Frame

necessrio a instalao da Web Interface do Citrix para o funcionamento do acesso
remoto pelo produto.
DICA: Com a configurao padro do GoGlobal, a cada solicitao de abertura
de um programa do produto, ser solicitado autenticao do sistema operacional.
Para que esta solicitao de autenticao ocorra apenas uma vez, habilitar no
GoGlobal a opo Cache passwords on the client, localizada em Tools > Server
Options> Security.

TOTVS S.A.
31
Seguem os procedimentos a serem executados para que o acesso remoto seja executado
corretamente:
Instalar a licena Progress Client Networking no servidor do Citrix.
Instalar o Java 1.6.
Copiar os arquivos citrix.properties, citrix.bat e datasul-framework-citrixproxy-java-
1.0.2.jar, localizados na pasta scripts abaixo do diretrio onde foi instalado o
servidor de aplicao, para uma pasta no servidor Citrix.
Criar uma aplicao no Citrix Management Console em Presentation Server >
NomeFarm > Applications > New > Publish application (esta aplicao dever estar
visvel aos usurios via Web Interface).
Display Name o nome da aplicao que ser executada (no exemplo,
Datasul11);
Type Installed application;
Command line Deve apontar para o arquivo citrix.bat, seguido dos
caracteres %*
Ex: C:\AtalhosDatasul11\citrix.bat" %*
ALERTA: Aps a aplicao do Hotfix Rollup Pack 2 ou superior do Presentation
Server, o servidor Citrix bloqueia os parmetros vindos do client. Nesse caso, no
local de %* deve ser utilizado %**.
Working Directory Apontar para um diretrio temporrio para a sesso;
Servers Informe o servidor onde ser executada a sesso Progress;
Users Allow only configured Users Informe os usurios que devem ter
acesso a aplicao via Citrix;
ALERTA: 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.
Publicar na intranet um diretrio virtual (IIS) onde estaro localizados os arquivos de
configurao do acesso remoto. O Caminho fsico dever apontar para o diretrio
jboss_home\DatasulCtxWI. Este diretrio virtual precisa ter permisso para
executar arquivos .aspx (do .NET);
Os arquivos da pasta DatasulCtxWI publicada so 32-bits. Caso o servidor onde o
diretrio virtual foi publicado seja 64-bits, necessrio configurar o IIS para executar
em modo 32-bits. A partir do IIS 7, possvel criar um novo pool de aplicativos e
configurar somente este pool para executar em modo 32-bits, relacionando a pasta
criada a este.
Aps criar o diretrio virtual, configurar o arquivo web.config abaixo da pasta
DatasulCtxWI, conforme orientaes abaixo:

TOTVS S.A.
32
<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.
ALERTA: 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.
Editar o arquivo citrix.properties e configurar conforme orientaes:
path=C:/dlc102b/bin/prowin32.exe
Informar o caminho do executvel progress no servidor citrix.

pf=C:/totvs/datasul/11.5.0/ERP/scripts/datasul.pf
Informar caminho ao arquivo .pf do ambiente utilizado.

ini=C:/totvs/datasul/11.5.0/ERP/scripts/datasul-progress.ini
Informar caminho ao arquivo .ini do ambiente utilizado.

p=C:/totvs/datasul/11.5.0/ERP/scripts/datasul-configxml-alias.p
Informar caminho ao arquivo de alias do ambiente utilizado.

Editar 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
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="" />


TOTVS S.A.
33
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>
ALERTA: Se algum dos parmetros acima descritos no estiver configurado
corretamente, os programas no sero executados. Caso haja alguma tag vazia,
recomendamos remov-la do arquivo (realizar um backup prvio do arquivo).
4.11.3. Terminal Server

necessrio que o Terminal Server esteja instalado no servidor onde ser feito o acesso
remoto.
Seguem os procedimentos a serem realizados para o acesso remoto via Terminal Server:
Instalar a licena Progress Client Networking no servidor do Terminal Server.
Instalar o Java 1.6.
Configurar o Terminal Server para Permitir que os usurios iniciem programas
listados e no listados na conexo inicial. Esta configurao necessria pois no
haver nenhuma aplicao publicada no Terminal Server. A linha de comando e os
parmetros para abertura da sesso Progress no servidor remoto sero enviadas
pelo Datasul 11.
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
Informar o tipo de conexo remota (Terminal Server).
Ex: <RemoteConnectionType>TerminalServer</RemoteConnectionType>

RemoteServerPort
Informe uma porta que servir de comunicao entre o Jboss e o Terminal Server.
Ex: <RemoteServerPort>8085</RemoteServerPort>

MetaframeServer

TOTVS S.A.
34
Informe o nome ou endereo IP do servidor Terminal Server.
Ex: <MetaframeServer>serverts</MetaframeServer>

MetaframeServerPort
Informe a porta de acesso ao Terminal Server.
Ex: <MetaframeServerPort>3389</MetaframeServerPort>

RemoteShortcut Description
Informe os parmetros para execuo da sesso Progress.
Ex: <RemoteShortcut Description="TS"
Path="&quot;c:\dlc102b\bin\prowin32.exe&quot; -pf
&quot;\\serverts\ERP\scripts\emsmult.pf&quot; -ininame
&quot;\\serverts\ERP\scripts\ems.ini&quot; -p
&quot;\\serverts\erp\scripts\alias.p&quot;" />
ALERTA: O contedo da Tag "RemoteShortcut" no pode conter path maior que
80 caracteres, por restries da passagem de parmetros ao Terminal Server.
Caso este valor for ultrapassado, poder ser apresentado o erro 560 do
Progress.
4.12. Ajustes aps instalao

Os ajustes citados neste captulo sero necessrios aps a instalao do Datasul 11.
4.12.1. Permisso de sequences

Quando no forem 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;
Grant select, update on sequence pub.seq_propried to pub;
Commit;

TOTVS S.A.
35
4.12.2. Atalho 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.
4.12.3. 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"/>
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.
Tambm ser necessrio a criao do usurio "fornecedor" que ser utilizado para a
autenticao do RFI. O usurio dever ser criado no ambiente datasul e ter permisso de
acesso aos programas.
4.12.4. Matriz de Traduo EMS 5


TOTVS S.A.
36
Aps uma nova instalao do produto Datasul 11, 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.
4.13. Verificao do ambiente aps instalao

Disponibilizamos um check-list do ambiente que facilitar a instalao e deteco de
falhas na instalao.
Segue o check-list do ambiente:
Verificar se os itens apresentados no captulo de requisitos foram atendidos;
Verificar se o servio do AdminService est iniciado;
Verificar se os bancos de dados esto carregados;
Verificar se as portas utilizadas na carga dos bancos so as mesmas definidas para
conexo com os mesmos;
Verificar se o servio do AppServer est iniciado;
Verificar se o servio do Jboss foi iniciado sem erros no log;
Verifique se o arquivo config.xml localizado abaixo da estrutura <Dir Instal
Programas>\scripts-8080 est configurado corretamente, sendo ele o responsvel

TOTVS S.A.
37
pelos atalhos para execuo dos programas Progress. Caso exista alguma tag
vazia, ela deve ser comentada ou removida;
Verificar se o arquivo progress-ds.xml localizado no diretrio deploy da instncia
do Jboss est configurado corretamente, sendo ele o responsvel pela comunicao
com os brokers SQL dos bancos. Em ambiente Oracle, este arquivo chama-se
oracle-ds.xml;
Verificar a existncia do arquivo datasul_framework.properties localizado abaixo
da estrutura jboss_home\server\instance-8080\conf\datasul, sendo ele responsvel
pela execuo dos servios integrados com o Jboss como AppServer, Totvs License
Server, Flex, entre outros;
Verificar se o arquivo di.properties localizado abaixo da estrutura
jboss_home\server\instance-8080\conf\datasul est configurado corretamente,
sendo ele o responsvel pela localizao do arquivo config.xml;
Verificar se o arquivo hcm.properties localizado abaixo da estrutura
jboss_home\server\instance-8080\deploy\ datasul-byyou-XX.X.X-
SNAPSHOT.ear\payroll-config-X.X.X.jar est configurado corretamente, sendo que
o parmetro hcmpayroll.appserverconnection deve estar apontando para o servio
AppServer;
5. Atualizao

A atualizao do produto feita atravs da ferramenta Updater, disponvel no endereo
http://tools.totvs.com.br/updater .
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:
ALERTA: extremamente importante 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. Caso a reinstalao seja executada para atualizao dos
programas, sugerimos a criao de um diretrio de quarentena e a execuo de um

TOTVS S.A.
38
backup da rea de programas, se os mesmos forem reinstalados no mesmo ambiente de
produo.

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, 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.
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 11 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.