Guia de Instalao Datasul 11.5.

9
12/2013

Verso Atualizada

Guia de Instalao Datasul 11.5.9

Sumrio
1

Prefcio ....................................................................................................................................... 4

1.1

Finalidade .................................................................................................................................... 4

1.2

Pblico Alvo ................................................................................................................................. 4

1.3

Organizao deste Guia............................................................................................................... 4

1.4

Documentaes Importantes ...................................................................................................... 5

Introduo ................................................................................................................................... 6

2.1

Arquitetura Distribuda do Produto ............................................................................................ 6

2.2

Tipos de Instalao ...................................................................................................................... 6

2.2.1

Requisitos Mnimos ..................................................................................................................... 7

3.1

Viso Geral dos Requisitos .......................................................................................................... 8

3.2

Requisitos de Hardware .............................................................................................................. 9

3.2.1
3.2.2

3.3

Requisitos para estao client ........................................................................................................................ 9

Requisitos para servidor ................................................................................................................................. 10

Requisitos de Software................................................................................................................ 10
3.3.1
3.3.2
3.3.3
3.3.4
3.3.5
3.3.6
3.3.7

Sistema Operacional ....................................................................................................................................... 10

Progress .......................................................................................................................................................... 10
Java ................................................................................................................................................................. 11
Flash Player e Navegador ............................................................................................................................... 11
Ferramentas de Acesso Remoto ..................................................................................................................... 11
Requisitos para bancos Oracle ........................................................................................................................ 11
Requisitos para bancos SQL Server ................................................................................................................. 12

3.4

Requisitos de Usurio (Servidor) ................................................................................................. 13

3.5

Virtualizao/Load Balance/Https .............................................................................................. 13

Instalao .................................................................................................................................... 13

4.1

Detalhes da Mdia de Instalao ................................................................................................. 13

4.2

Planejando a Instalao .............................................................................................................. 14

4.2.1

Multi-Empresa Industrial / Segurana por Estabelecimento .......................................................................... 14

4.3

Instalao .................................................................................................................................... 14

4.4

Instalao de Programas ............................................................................................................. 15

4.5

Instalao de Banco de Dados .................................................................................................... 15

4.5.1
4.5.2
4.5.3

4.6
2

Alertas durante a instalao ........................................................................................................................... 7

Bancos Progress .............................................................................................................................................. 16

Bancos Oracle ................................................................................................................................................. 19
Bancos SQL Server........................................................................................................................................... 20

Instalao do Servidor de Aplicao ........................................................................................... 21

Guia de Instalao Datasul 11.5.9
Verso 1.1

Guia de Instalao Datasul 11.5.9

4.6.1

Objetos criados na instalao do Servidor de Aplicao ................................................................................. 24

4.7

Instalao da Documentao ...................................................................................................... 24

4.8

Inicializando o Datasul 11............................................................................................................ 25

4.9

Acesso ao Datasul 11................................................................................................................... 26

4.10 Acesso Remoto ............................................................................................................................ 26

4.10.1 Datasul Connection for Web (GoGlobal) ......................................................................................................... 26
4.10.2 Citrix Metaframe ............................................................................................................................................ 27
4.10.3 Terminal Server ............................................................................................................................................... 30

4.11 Ajustes aps instalao ............................................................................................................... 31

4.11.1
4.11.2
4.11.3
4.11.4
4.11.5
4.11.6
4.11.7

Permisso de Sequences ................................................................................................................................. 31

Configurao para acesso aos programas Progress ....................................................................................... 31
Configurao para acesso ao Gesto de Planos ............................................................................................. 31
Configurao de envio de e-mail com autenticao ....................................................................................... 32
Matriz de Traduo no EMS 5 ......................................................................................................................... 32
Instalao do Plug-in CRM Outlook ................................................................................................................ 33
Verificao do ambiente aps instalao ....................................................................................................... 33

Atualizao .................................................................................................................................. 33

Reinstalao ................................................................................................................................ 34

Desinstalao .............................................................................................................................. 34

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

1.1

Prefcio

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.

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.

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

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.

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

2.1

Introduo

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.

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.

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

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.

ATENO: Esta mdia preparada para instalao de 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 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.

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,

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

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.
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 o Service Desk (Telefone 4003-0015 - Opes 3 4 3).

3.1

Viso Geral dos Requisitos

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

Disco
Memria
Processador

120 GB
4 GB
Intel Xeon Dual 2.00 GHz
Software

Sistema Operacional *
Java
OpenEdge

Windows Server
Linux
JRE 1.6
10.2B07

* 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.

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

Estao Client
Windows
Hardware

Memria (Arquitetura 32-bit)

Memria (Arquitetura 64-bit)
Processador
Resoluo de Tela

1 GB Mnimo (2GB Recomendado)

2 GB Mnimo
Intel Pentium IV 2.80 GHz (Pentium DualCore Recomendado)
1024 x 768 ou superior
Software

Flash
Navegadores

Java
3.2

3.2.1

Flash Player 10
Internet Explorer 7
Internet Explorer 8
Internet Explorer 9
Firefox 3.5 e 7
JRE 1.7 mais recente

Requisitos de Hardware

Requisitos para estao client

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, e-mail, 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.

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

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 solicitada atravs do e-mail siquini@totvs.com.br.

3.3

3.3.1

Requisitos de Software

Sistema Operacional

A estao client deve possuir o sistema operacional Windows instalado, pois o Datasul 11 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).

3.3.2

Progress
ATENO: obrigatrio o uso do Progress 10.2B com Service Pack 07 ou superior.

As licenas Progress embutidas no produto Datasul 11 so:

Licena

Sistema Operacional

Observao

Openedge
Enterprise
RDBMS
Openedge
DataServer for
Oracle
OpenEdge
DataServer for
Microsoft SQL
Openedge
Application
Server Enterprise

Windows Server

Instalada no servidor de banco de dados para execuo

de rotinas de administrao dos bancos Progress.

Client
Networking

Unix
Windows Server
Unix
Windows Server
Windows
Unix
Windows
Unix
Windows Server

Query / Results
Unix

10

Somente utilizada com banco de dados Oracle. Pode ser

instalada nos clients (DataServer Local) ou no servidor
(DataServer Remoto)
Somente utilizada com banco de dados SQL Server. Pode
ser instalada nos clients (DataServer Local) ou no
servidor (DataServer Remoto)
Instalada no servidor de aplicao para configurao de
servios como AppServer, Webspeed, WebServices, etc.

Guia de Instalao Datasul 11.5.9

Verso 1.1

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.
Instalada nas estaes client ou no servidor de arquivos
(Progress compartilhado) para execuo e compilao de
relatrios.

Guia de Instalao Datasul 11.5.9

ATENO: 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.3

Java

Para Sistema Operacional 64-bit, instalar preferencialmente o Java 64-bit (JRE) na mesma verso disponibilizada na
mdia de instalao do produto.

3.3.4

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.5

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 GoGlobal verso 4, Citrix
(Citrix Presentation Server Verso 4.5) e Terminal Server. Para o uso do Terminal Server, necessrio que o servidor possua
o sistema operacional Windows 2008 ou superior, com o servio RemoteAPP habilitado.

3.3.6

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:
select parameter, value
from nls_database_parameters
where parameter = 'NLS_CHARACTERSET'
NLS_LANGUAGE
AMERICAN
NLS_TERRITORY
NLS_CHARACTERSET

AMERICA
WE8ISO8859P1 OU WE8MSWIN1252

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 ou
WE8MSWIN1252. 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 instncia.

Guia de Instalao Datasul 11.5.9

Verso 1.1

11

Guia de Instalao Datasul 11.5.9

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 32000 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. O NLS_LANG dever possuir o valor conforme o CharacterSet do banco (
AMERICAN_AMERICA.WE8ISO8859P1 ou AMERICAN_AMERICA.WE8MSWIN1252) 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.7

Requisitos para bancos SQL Server

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 11 configurado no servidor.

Requisitos para Instalao do Citrix Receiver

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.

Download do Citrix Receiver

12

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).

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

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

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.

3.5

Virtualizao/Load Balance/Https

Informaes para homologao de ambientes dentro de uma estrutura de virtualizao/Load Balance/Https podem
ser encontradas neste artigo.

4.1

Instalao

Detalhes da Mdia de Instalao

A mdia de instalao do Datasul 11 disponibilizada em DVD e pelo Portal de Suporte Totvs, na rea de Downloads.
Nesta mdia esto disponveis:

Guia de Instalao do produto;

Guia de Suporte ao Cliente;

Guia de Unificao de Conceitos;

Java;

Setup e arquivos necessrios para instalao do produto.

Guia de Instalao Datasul 11.5.9

Verso 1.1

13

Guia de Instalao Datasul 11.5.9

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.

4.2.1

Multi-Empresa Industrial / Segurana por Estabelecimento

O Datasul 11 conta com a funcionalidade de Segurana por Estabelecimento, com o objetivo de definir se cada
usurio pode ou no visualizar informaes de um determinado estabelecimento.
Essa caracterstica permite que os bancos do Industrial possam ser utilizados como Multi-Empresa, com as
informaes sendo separadas pelos Estabelecimentos. A Segurana por Estabelecimento pode ser aplicada tanto em Bases
de dados Unificadas (Multi-Empresa) como separadas.
Essa funcionalidade possui algumas caractersticas e regras que devem ser bem esclarecidas e avaliadas antes de sua
aplicao. Para maiores detalhes sobre as regras e programas contemplados clique aqui.

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.
As etapas abaixo so comuns para todos os tipos de instalao do Datasul 11:

14

Tela Informe o ID para esta instalao

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

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

Selecione Avanar para continuar.

Os prximos captulos descrevero os procedimentos que devem ser executados para cada tipo de instalao.

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. A instalao da rea de programas prrequisito 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.

Guia de Instalao Datasul 11.5.9

Verso 1.1

15

Guia de Instalao Datasul 11.5.9

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

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.
16

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

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

Objetos criados na instalao de Banco de Dados Progress

Seguem os objetos importantes para administrao do ambiente, criados na instalao de banco de dados em
ambiente Windows.

Localizao

Objeto

<Dir Instal Bancos>\scripts

ReparaBancos.bat

<Dir Instal Bancos>\scripts

datasulDescargaBancos.bat

<Dir Instal Bancos>\scripts

datasulCargaBancos.bat

<Dir Instal Bancos>\scripts

conmgr.properties

Descrio
Script para reparar a estrutura dos
bancos.
Script para derrubar os bancos
iniciados de forma manual (proserve
ou _mprosrv) ou iniciados pelo script
datasulCargaBancos.bat.
Script para iniciar os bancos. Ao iniciar
os bancos por esse script, os bancos
no sero gerenciados pelo Progress
Explorer Tool.
Arquivo responsvel pela configurao
dos bancos que sero administrados
pelo Progress Explorer Tool.

Sistemas Operacionais Unix / Linux

Guia de Instalao Datasul 11.5.9

Verso 1.1

17

Guia de Instalao Datasul 11.5.9

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.

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). As definies (.df e .dfsql) podem ser obtidas abaixo da estrutura <Dir
Instal Bancos>\database\definicoes.

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;
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>
DICA: A porta do broker a porta definida para o parmetro -S ao carregar o banco com o parmetro
-ServerType SQL.

18

Conectar via SQL Explorer o banco mdtfrw e dar permisses de DBA para o usurio pub, atravs dos comandos
abaixo:

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

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 11 estaro instalados e configurados.

4.5.2

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).

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.

Objetos criados na instalao dos Bancos de Dados Oracle

Seguem os arquivos para a criao dos objetos e administrao do ambiente, criados na instalao de banco de
dados Oracle.

Localizao

Objeto

<Dir Instal Bancos>\scripts

criaObjetoOracle.sql

<Dir Instal Bancos>\scripts

criaTablespaceOracle.sql

<Dir Instal Bancos>\scripts

criaUsuarioOracle.sql

Descrio
Script para criar os objetos (tabelas,
ndices, etc.) no banco Oracle.
Script para criar os tablespaces para o
produto Datasul 11 no banco Oracle.
Script para criar os usurios do produto
Datasul 11 no banco Oracle.
Guia de Instalao Datasul 11.5.9
Verso 1.1

19

Guia de Instalao Datasul 11.5.9

<Dir Instal Bancos>\scripts

gerenciadorScripts.sql

<Dir Instal Bancos>\scripts

ReparaBancos.bat

Script que gerencia a chamada dos demais

scripts Oracle. Este arquivo dever ser
executado para que os objetos sejam
criados no banco Oracle.
Script para reparar a estrutura dos bancos
Schema Holder.

Criao de Objetos no Banco Oracle

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.5.3

Bancos SQL Server

Tela Configuraes SQL Server

Informe o usurio dos bancos SQL Serverdatas.

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.

Objetos criados na instalao dos Bancos de Dados SQL Server

Seguem os arquivos para a criao dos objetos e administrao do ambiente, criados na instalao de banco de
dados SQL Server.

20

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

Localizao

Objeto

<Dir Instal Bancos>\scripts

criaObjetoSQLServer.bat

<Dir Instal Bancos>\scripts

criaDatabaseSQLServer.sql

<Dir Instal Bancos>\scripts

criaUsuarioSQLServer.sql

<Dir Instal Bancos>\scripts

gerenciadorScripts.bat

<Dir Instal Bancos>\scripts

ReparaBancos.bat

Descrio
Script para criar os objetos (tabelas,
ndices, etc.) no banco SQL Server.
Script para criar os bancos para o produto
Datasul 11 no servidor SQL Server.
Script para criar o usurio e associar aos
bancos no SQL Server.
Script que gerencia a chamada dos demais
scripts SQL Server. Este arquivo dever ser
executado para que os objetos sejam
criados no banco SQL Server.
Script para reparar a estrutura dos bancos
Schema Holder.

Criao de Objetos no Banco SQL Server

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 <Dir Instal
Bancos>\spool.

Conexo SQL Server

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>;

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:
Guia de Instalao Datasul 11.5.9
Verso 1.1

21

Guia de Instalao Datasul 11.5.9

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 Integrao com ECM

Informar se o produto ser integrado com o ECM. Em caso de dvidas, selecione a opo No, pois esta
informao pode ser alterada a qualquer momento atravs de arquivo de configurao.

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.

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.
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.
22

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

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.

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.

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

Guia de Instalao Datasul 11.5.9

Verso 1.1

23

Guia de Instalao Datasul 11.5.9

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.

4.6.1

Objetos criados na instalao do Servidor de Aplicao

Estes so os objetos importantes para administrao do ambiente, criados na instalao do servidor de aplicao.

Localizao
<Dir Instal
Programas>\scripts[instncia]
<Dir Instal
Programas>\scripts[instncia]
<Dir Instal
Programas>\scripts[instncia]
<Dir Instal
Programas>\scripts[instncia]
<Dir Instal
Programas>\scripts[instncia]
<Dir Instal
Programas>\scripts[instncia]
<Dir Instal
Programas>\scripts[instncia]

4.7

Objeto

Descrio

config.xml

Arquivo responsvel pela configurao dos

atalhos para acesso ao produto.

datasul-configxml-alias.p

Arquivo de inicializao da sesso que contem

configuraes de ambiente, como por
exemplo, fontes, cores, PROPATH, outros.
Script de alias utilizado para acesso ao
produto.

datasul-appserver-alias.p

Script de alias utilizado pelo servio AppServer

datasul.

datasul-aliasIni.p

Programa utilizado para inicializao do

produto.

datasul.pf

Arquivo que contem os parmetros de sesso

e parmetros de conexo com os bancos.

datasul-progress.ini

ubroker.properties

Arquivo responsvel pela configurao do

servio AppServer datasul que ser
administrado pelo Progress Explorer Tool.

Instalao da Documentao

Ao selecionar a opo Documentao, sero instalados os manuais tcnicos, manuais de diferenas funcionais e
Release Notes. Ao selecionar esta opo, ser questionado se o diretrio de instalao do servidor de aplicao o
informado em tela. Se o diretrio estiver correto selecione SIM. Se no estiver correto, selecione NO e altere este
diretrio.

24

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

4.8

Inicializando o Datasul 11

Durante a instalao do Servidor de Aplicao criado um atalho para inicializao do produto em Iniciar >
Programas > TOTVS Datasul > Administrao > Inicializador do Produto. 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 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. Esta tela somente informativa, no sendo
possvel alterar os dados de conexo atravs dela.

Otimizador de Performance

Essa funo melhora a performance do ambiente no que se refere ao uso de gatilhos de dicionrio. Com a execuo
desse programa, so habilitados os gatilhos que possuem cdigos e desabilitados os gatilhos que no estejam sendo
utilizados. Recomenda-se a execuo do otimizador de performance na inicializao (opo Sim).
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. A tela do inicializador ser
liberada aps fechar o arquivo de log.
Depois de verificar o log gerado, feche o arquivo e selecione

concluindo o processo.

ATENO: Verifique a existncia de registros na tabela StringTable. Se a tabela estiver vazia, execute
atravs do Prompt de Comando o script importacaoByYou.bat, localizado abaixo do diretrio raiz de
instalao dos programas. Aps a execuo desse script verifique novamente a quantidade de registros
na tabela.
Aps a inicializao do produto necessrio fazer a configurao de negcio para que as informaes sejam
apresentadas conforme desejado no desktop do Datasul 11.

Guia de Instalao Datasul 11.5.9

Verso 1.1

25

Guia de Instalao Datasul 11.5.9

4.9

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:

Iniciar os bancos de dados;

Os bancos Progress podem ser iniciados via OpenEdge Explorer ou atravs do script datasulCargaBancos.bat.

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

O servio AppServer pode ser iniciado via OpenEdge Explorer ou atravs de linha de comando pelo asbman.

Iniciar o servio do Jboss TOTVS Datasul em Painel de Controle > Ferramentas Administrativas > Services;

Iniciar o servio TOTVS License Server;

4.10 Acesso Remoto

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.10.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.

Criar uma aplicao no GoGlobal Cluster Manager > Applications > Add.

26

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.

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

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-frameworkcitrixproxy-java-1.0.2.jar e Progress. Caso os usurios no possuam permisso, sero registrados erros
de acesso no log do GoGlobal.

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
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\ServidorAplicao\scripts-8080\datasulframework-citrixproxy-java-1.0.2.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>
ATENO: Se algum dos parmetros acima descritos no estiver configurado corretamente, os
programas no sero executados. Caso exista alguma tag vazia, recomendamos remov-la do arquivo
(realizar um backup prvio do arquivo).

4.10.2

Citrix Metaframe
necessrio a instalao da Web Interface do Citrix para o funcionamento do acesso remoto pelo produto.
Seguem os procedimentos a serem executados para que o acesso remoto seja executado corretamente:

Instalar a licena Progress Client Networking no servidor do Citrix.

Guia de Instalao Datasul 11.5.9

Verso 1.1

27

Guia de Instalao Datasul 11.5.9

Instalar o Java.

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" %*
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;

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-frameworkcitrixproxy-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). No IIS7 converter este diretrio virtual para uma aplicao;

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:

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

28

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

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.9/ERP/scripts/datasul.pf
Informar caminho ao arquivo .pf do ambiente utilizado.

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

p=C:/totvs/datasul/11.5.9/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="" />

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>

Guia de Instalao Datasul 11.5.9

Verso 1.1

29

Guia de Instalao Datasul 11.5.9

ATENO: Se algum dos parmetros acima descritos no estiver configurado corretamente, os

programas no sero executados. Caso exista alguma tag vazia, recomendamos remov-la do arquivo
(realizar um backup prvio do arquivo).

4.10.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.

No servidor de Terminal Server, criar uma aplicao no TS Remote App Manager, com a seguinte configurao:

RemoteApp program name Informe o nome da aplicao (sugesto: Datasul11);

Location Informe o caminho completo do prowin32.exe (localizado abaixo do diretrio Bin do Progress);

Alias Informe prowin32. Este nome no deve ser alterado;

Command-line arguments Selecionar a opo para permitir qualquer tipo de argument na linha de comando.

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
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>

MetaframeServerId
Informe o nome da aplicao criada no servidor TS.
Ex: <MetaframeServerId>Datasul11</MetaframeServerId>

RemoteShortcut Description
Informe os parmetros para execuo da sesso Progress.

30

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

Ex: <RemoteShortcut Description="TS" Path="-pf &quot;\\serverts\ERP\scripts\emsmult.pf&quot;

&quot;\\serverts\ERP\scripts\ems.ini&quot; -p &quot;\\serverts\erp\scripts\alias.p&quot;" />

-ininame

4.11 Ajustes aps instalao

Os ajustes citados neste captulo sero necessrios aps a instalao do Datasul 11.

4.11.1

Permisso de Sequences

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

4.11.2

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;

Configurao para acesso aos programas Progress

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.

4.11.3

Configurao para acesso ao Gesto de Planos

Guia de Instalao Datasul 11.5.9

Verso 1.1

31

Guia de Instalao Datasul 11.5.9

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;

4.11.4

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.

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 mailservice.xml.

4.11.5

Matriz de Traduo no EMS 5

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.

32

Guia de Instalao Datasul 11.5.9

Verso 1.1

Guia de Instalao Datasul 11.5.9

4.11.6

Instalao do Plug-in CRM Outlook

Para instalar o plugin, copie os 2 arquivos localizados na pasta 'crm-outlook' da mdia de instalao do produto
Datasul 11, para uma pasta temporria na estao do usurio.
Execute o arquivo 'setup.exe' e siga os passos da instalao. Para a utilizao do plugin, necessrio ter o Microsoft
Outlook 2010 instalado na estao.

4.11.7

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 pelos atalhos para execuo dos programas Progress. Caso
exista alguma tag vazia, ela deve ser comentada ou removida;

Verificar se o arquivo de datasources (progress-ds.xml ou oracle-ds.xml ou mssql-ds.xml) localizado no diretrio

deploy da instncia do Jboss, est configurado corretamente, sendo ele o responsvel pela comunicao com os
bancos de dados. Para ambientes Progress, este arquivo dever apontar para as portas correspondentes aos brokers
SQL;

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\instance8080\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\ datasulbyyou-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;

Atualizao

Guia de Instalao Datasul 11.5.9

Verso 1.1

33

Guia de Instalao Datasul 11.5.9

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 by You.

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.

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.
34

Guia de Instalao Datasul 11.5.9

Verso 1.1