Guia de Instalacao Datasul Ems 2.06b-Oe10

Guia d e Instalação DATASUL EMS 2.06B –

OpenEdge 10

Programas Banco de Dados Datasul Interactive WEB

Servidor de Aplicação Demonstração

Guia de Instalação DATASUL-EMS 2.06B – OpenEdge 10 2

Índice

1. Prefácio ....................................................................................................................................................... 4

1.1. Finalidade ..................................................................................................................... 4

1.2. Público Alvo ................................................................................................................. 4

1.3. Organização deste Guia................................................................................................. 4

1.4. Outras Documentações Importantes .............................................................................. 5

2. Introdução ................................................................................................................................................... 6

2.1. Arquitetura Distribuída do produto ................................................................................ 6

2.2. Tipos de Instalação ...................................................................................................... 7

2.3. Alertas Durante a Instalação ......................................................................................... 7

3. Requisitos ................................................................................................................................................... 9

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

3.1.1. Requisitos para instalação da Área de Trabalho (Cliente) .......................................... 9

3.1.2. Requisitos para outros Tipos de Instalação ............................................................. 11

3.1.3. Rede ....................................................................................................................... 11

3.1.4. Recomendações Gerais .......................................................................................... 12

3.2. Requisitos de Software ............................................................................................... 12

3.2.1. Progress ................................................................................................................. 12

3.2.2. Conversão .............................................................................................................. 14

3.3. Requisitos de Usuário (Servidor) ................................................................................ 14

3.4. Requisitos Datasul Interactive ..................................................................................... 15

3.4.1. Requisito para Instalação PROGRESS ................................................................... 15

3.5.2. Requisito para Instalação ORACLE ......................................................................... 16

3.5.2.2. Requisito para Área de Trabalho (Cliente) ........................................................... 16

3.5.3. Requisito para Instalação SQL ................................................................................ 18

3.5.3.2. Requisito para Área de Trabalho (Cliente) ........................................................... 18

3.5.3.3. Requisito para Servidor WEB............................................................................... 18

4. Detalhes das Mídias de Instalação ............................................................................................................ 20

4.1. Disco 1 ....................................................................................................................... 20

4.2. Disco 2 e 3 ................................................................................................................. 20

5. Instalação .................................................................................................................................................. 21

5.1. Planejando a Instalação.............................................................................................. 21

5.2. Instalação de Programas Datasul-EMS ....................................................................... 22

5.3. Bancos de Dados ....................................................................................................... 28

5.3.1 Criação de bancos de dados e schema holders ............................................................ 28

5.3.1.1 Criando um banco de dados Progress ....................................................................... 28

5.3.1.2 Criando um Schema Holder ....................................................................................... 30

5.3.2. Importando definições ................................................................................................. 30

5.3.2.1. Importando definições em Progress .......................................................................... 30


5.3.2.2. Importando definições em Oracle ............................................................................. 31

5.3.2.3. Importando definições em SQL Server ..................................................................... 32

5.3.3. Servindo e conectando os bancos de dados ................................................................ 32

5.3.3.1. Ambientes com bancos de dados Progress .............................................................. 32

5.3.3.2. Ambientes com bancos de dados Oracle .................................................................. 33

5.3.3.3. Ambiente com bancos de dados SQL Server ............................................................ 34

5.4. Instalação Datasul Interactive ..................................................................................... 34

5.4.1. Instalação Banco de Dados Datasul Interactive ....................................................... 38

5.4.2. Instalação Programas Datasul Interactive ................................................................ 46

5.4.3. Configurando Serviço do Apache Tomcat ................................................................ 57

5.4.4. Deploy Automático .................................................................................................. 58

5.4.5. Adicionando Novo Produto ao Datasul Interactive ................................................... 58

5.4.6. Instalando Java Plug-In ........................................................................................... 79

5.4.7. Executando o Datasul Interactive ............................................................................ 83

5.4.8. Procedimentos ........................................................................................................ 84

5.5. Instalação Demonstração do Datasul EMS 2.06B ....................................................... 93

5.6. Instalação Servidor de Aplicação ...............................................................................102

5.7. Instalando o Integrator ...............................................................................................140

5.8.1 Licenciando o Integrator ..............................................................................................143

5.9. Inicializando o Aplicativo Datasul-EMS ......................................................................145

5.10. Reinstalando .............................................................................................................146

6. Remover a Instalação ............................................................................................................................. 147

6.9. Removendo a Instalação Multiusuário .......................................................................149

7. Atualização de Programas ...................................................................................................................... 149

8. Instalando o Produto em WEB ............................................................................................................... 150

8.9. Requisitos .................................................................................................................150

8.9.1. Produto EMS 2 Instalado........................................................................................150

8.9.2. WebServer Instalado ..............................................................................................150

8.9.3. WebSpeed Instalado ..............................................................................................150

8.9.4. Browser Instalado ..................................................................................................151

8.9.4.1. Conhecimento em arquitetura Web .....................................................................151

8.10. Etapas de instalação do produto em Web ..................................................................151

8.10.1. Instalação do Datasul EMS2 client-server ...........................................................151

8.10.2. Instalação do WebServer ....................................................................................151

8.10.3. Instalação do WebSpeed ....................................................................................151

8.10.4. Diretório de programas do EMSWEB ..................................................................151

8.10.5. Criação do alias “ems20web” no servidor WEB ...................................................152

8.10.6. Serviço AdminService .........................................................................................152

8.10.7. NameServer .......................................................................................................152

8.10.8. Criação do broker “emsweb” no WEBSpeed .......................................................152

8.10.10. Acesso ao EMSWEB através do navegador........................................................156

8.2.11. Acesso aos Manuais de referência para o produto EMSWEB ...................................156


1. Prefácio

1.1. Finalidade

Este guia tem como finalidade, descrever de forma objetiva, passo a passo, todos os procedimentos necessários para a instalação do produto Datasul-EMS 2.06B, bem como configurar o produto nas plataformas suportadas. A mídia de instalação também poderá ser utilizada para atualização de programas.

1.2. Público Alvo

Como o processo de instalação do produto não é complexo, a instalação monousuário e demonstração podem ser feitas por pessoas com pouca experiência em informática. Já a instalação multiusuário, requer pessoas que tenham conhecimentos de ambiente de rede. 1.3. Organização deste Guia Capítulo 2, “Introdução”

Este capítulo apresenta uma visão geral da arquitetura distribuída, tipos de instalação e exemplos de topologias no uso do produto.

Capítulo 3, “Requisitos”

Este capítulo apresenta a lista de requisitos de hardware e software exigidos na instalação do produto.

Capítulo 4, “Detalhes das Mídias de Instalação”

Este capitulo descreve os detalhes de todos os discos de instalação do produto DATASUL.

Capítulo 5, “Instalação”

Este capítulo descreve os procedimentos que deverão ser executados para a instalação do produto. Abrange desde o planejamento da instalação, ou seja, escolher o tipo de instalação adequado, até a reinstalação do produto.

Capítulo 6, “Remover a Instalação”

Este capítulo apresenta os procedimentos para remover a instalação do produto.

Capítulo 7, “Atualização de Programas”

Este capítulo mostra como a mídia de instalação poderá ser utilizada para atualização de programas.

Capítulo 8, “Instalando o Produto em WEB”

Este capítulo apresenta a instalação do produto DATASUL EMS 2.06B em Web.


1.4. Outras Documentações Importantes Informações adicionais podem ser obtidas em:

Manuais do Progress - Database Administration Guide and Reference, Database Design Guide, Startup Command and Parameters Reference, Progress Installation and Configuration Guide, WebSpeed Installation and Configuration Guide. Estas e outras documentações poderão ser encontradas em http://www.progress.com/products/documentation


2. Introdução

2.1. Arquitetura Distribuída do produto

Arquitetura distribuída consiste em separar os processos em plataformas independentes que interagem entre si, permitindo que os recursos sejam compartilhados enquanto se obtém ao máximo, os benefícios de cada dispositivo diferente. Basicamente, funciona da seguinte maneira: através da rede, as máquinas dos usuários estarão conectadas aos servidores. Cada servidor, fornecerá recursos diferentes para que os programas possam ser executados da máquina do usuário. A figura abaixo mostra os quatros componentes básicos utilizados no produto.

Ambiente do Cliente

Servidor de Aplicação Servidor de Arquivos

Rede TCP/IP

Usuários Servidor de Banco de Dados


2.2. Tipos de Instalação

Existe um tipo básico de instalação: Multiusuário. Multiusuário - Uma instalação multiusuário deve ser escolhida quando o produto for utilizado em ambientes corporativos no qual o produto poderá ser acessado através de várias máquinas e usuários. Para que o produto seja utilizado em ambiente multiusuário, são necessários quatro componentes que são: Servidor de Banco de Dados, Servidor de Arquivos, Servidor de Aplicação e Datasul Interactive..

• Servidor de Banco de Dados - Na máquina onde reside o servidor de banco de dados, estarão os bancos de dados e as scripts para carga e descarga destes bancos de dados.

• Servidor de Arquivos - Na máquina onde reside o servidor de arquivos, estarão os programas criptografados, compilados e outros arquivos necessários para execução do produto.

• Servidor de Aplicação - Este componente é opcional e visa basicamente melhorar a performance. Na máquina onde reside o servidor de aplicação, estarão os programas criptografados e compilados que poderão ser executados remotamente. Geralmente programas de relatórios e cálculos.

• Datasul Interactive - Interface Web de onde os programas serão executados.

• Demonstração – Bancos de dados demonstração do Produto

Para a comunicação entre todos estes componentes, é necessário que os serviços adequados de rede TCP/IP estejam funcionando corretamente.

2.3. Alertas Durante a Instalação Durante a instalação dos produtos Datasul podem ser apresentados alertas para clientes que usam determinados anti-vírus (Ex: Avast, BitDefender e Antivir Guard), acusando a identificação de vírus nos arquivos dos diretórios "OCX" e "Interfac".

Isso ocorre em função dos arquivos executarem rotinas que alguns anti-vírus identificam como vírus. No entanto, não se caracterizam instruções deste tipo. Desta forma, a mensagem apresentada pode ser desconsiderada.

Arquivos que são desconsiderados como vírus:

interfac\ActiveX\SoftButton\setup.exe interfac\ActiveX\TreeView\setup.exe interfac\barra\setup.exe interfac\BCportaserial\setup.exe interfac\Cellsvwr\setup.exe interfac\chartviewer\j2re-1_4_0_01-windows-i586-i.exe interfac\Estruct\setup.exe interfac\gdocs\gdglobal.exe interfac\graf-col\setup.exe interfac\grafico\datgraph.exe


interfac\grafico\gsw16.exe interfac\grafico\gsw32.exe interfac\grafico\setup.exe interfac\GRAPH\Gsw\datgraph.exe interfac\GRAPH\Gsw\gsw.exe interfac\GRAPH\gswnovo\datgraph.exe interfac\GRAPH\gswnovo\gsw16.exe interfac\GRAPH\gswnovo\DATGRAP5\datgraph.exe interfac\GRAPH\gswnovo\DATGRAP5\gsw16.exe interfac\imagem\setup.exe interfac\mail\blat.exe interfac\mail\regsvr32.exe interfac\mail\wsendmaik.exe interfac\mail\wsendmail.exe interfac\MAIL_FAX\datmail.exe interfac\seginteg\global.exe interfac\seginteg\grep.exe interfac\sfa\bmp2txt.exe interfac\sfa\dat2txt.exe interfac\sfa\palm.exe interfac\sfa\pdb.exe interfac\sfa\setup.exe interfac\sfa\txttoems.exe interfac\som\setup.exe interfac\VBBarGraf\setup.exe interfac\VBGantt\setup.exe interfac\VBTreeList\setup.exe interfac\video\setup.exe interfac\Zip\zip.exe ocx\@windir@\@sh@\datgraph.exe ocx\@windir@\@winsys@\@sh@\blat.exe ocx\@windir@\@winsys@\@sh@\gsw32.exe


3. Requisitos Este capítulo tem por objetivo divulgar recomendações sobre o uso de hardware e software relacionados ao Datasul-EMS Framework (2, 5 e HR), e algumas informações sobre configuração dos mesmos. Estas recomendações têm por intenção ajudar nossos clientes na configuração do seu ambiente utilizando-o ao máximo, obtendo uma melhor relação custo/benefício. Porém não representam compromissos com tecnologias ou algum fornecedor em especial por parte da DATASUL. A decisão sobre a tecnologia e fornecedor é de competência do cliente, bem como o nível de serviço, segurança e confiabilidade que deseja do seu ambiente. As posições deste relatório também podem ser alteradas, isto devido à evolução das tecnologias e dos nossos produtos. É importante lembrar que o ambiente cliente/servidor utilizado pelo Datasul-EMS é de complexidade maior que um ambiente host-based. A correta configuração e tuning de todas partes do ambiente (servidores, redes, clientes, banco de dados, etc.) é importante para o funcionamento do Datasul-EMS, pois caso uma das partes esteja mal configurada toda a performance do ambiente poderá ser afetada. As recomendações e exemplos citados abaixo levam em consideração somente o uso do Datasul-EMS e outros softwares de uso genérico (Office e E-mail). No caso de instalação de outros softwares no mesmo ambiente (que não sejam ligados ao Datasul-EMS) é importante levar isto em consideração, pois as recomendações e exemplos abaixo podem não ser suficientes. Se o objetivo desta instalação é conversão do produto, existe a necessidade de criar uma área de trabalho para acesso ao EMS Destino, pois, não é possível utilizar o Datasul Interactive para realizar a migração dos dados. Para tanto, é preciso realizar uma cópia dos arquivos do EMS Origem (Multiusuário): atalho, arquivo de inicialização (.ini) e arquivos de parâmetros (.pf). O arquivo de inicialização (.ini) deve ser configurado com as propriedades (Exemplo: PROPATH) do EMS Destino e do Progress a ser utilizado. O arquivo de parâmetros (.pf) precisa ser configurado com os parâmetros de acordo com a carga dos bancos do EMS Destino. Por fim, nas propriedades do atalho, informe o novo arquivo de parâmetros e o de inicialização juntamente com o parâmetro -p _admin.p ao final da linha de comando. Observação: Para este tipo de procedimento (migração), o EMS Destino não pode ser inicializado.

3.1. Requisitos de Hardware

3.1.1. Requisitos para instalação da Área de Trabal ho (Cliente) É necessário que a estação de trabalho possua o sistema operacional Windows instalado, devido ao Datasul-EMS Framework utilizar a Linguagem PROGRESS que possui arquitetura 32 bits (Win32). Segue as versões do Windows que estão homologadas para o OpenEdge 10.1A:

� Windows XP Professional � Windows Service Pack 2 WinXP SP2


� Windows 2000 Professional SP4 � Windows 2000 Server SP4 � Windows Server 2003 Standard (SP1) � Windows Server 2003 Enterprise (SP1) � Windows Server 2003 R2

Maiores informações podem ser obtidas do site da Progress: http://www.progress.com/openedge/products/lifecycle/index.ssp 1. Recomenda-se a seguinte configuração para uma boa performance, no caso de

instalação de PCs como estação de trabalho (Fat Client):

Recomendada

Processador Pentium III 500 Mhz

Cache Interno 512 Kb

Memória 128 Mb

Disco 10 Gb

Placa Rede 10/100 Mbits

Vídeo SVGA (800 x 600)

Obs.: Essas recomendações se aplicam a ambiente e t ecnologias atuais, não considerando, portanto, o número de meses estipulad o no dimensionamento. 2. Datasul-EMS até pode ser executado em estações com menos memória (16 Mb), ou

uma CPU menos potente, entretanto a performance estaria muito abaixo do aceitável. Não recomendamos o uso de estações menores que o mínimo pois a performance não atenderá as necessidades dos usuários em nenhum caso. Caso a sua empresa possua muitas estações com configurações inferiores a mínima recomendada, sugerimos utilizar o recurso de Servidores de Terminais Gráficos que irá utilizar este hardware já existente.

3. A configuração recomendada atende a maioria dos usuários, contudo para usuários

mais exigentes talvez exista a necessidade de uma configuração melhor. Compreende-se por usuário mais exigente aquele que utilize processos mais pesados (necessidade de uma CPU melhor e uma placa de rede mais rápida e/ou ligada em uma porta de switcher dedicada para ele) ou de um usuário que use várias aplicações simultâneas (necessidade de mais memória para executar processos como Office, E-mail, CAD, EIS, etc. ao mesmo tempo).

4. Recomendamos a última configuração para novos equipamentos, caso a empresa

venha adquirir novas estações e queira utilizá-las por um longo tempo sem necessidade de upgrade e sem ficarem obsoletos. Também foram levadas em consideração quais as configurações que os fornecedores de hardware estão oferecendo atualmente, e que tenham uma boa relação custo/benefício.

5. No caso das placas de rede recomenda-se comprar placas de fornecedores de

primeira linha (Ex.: 3COM, Cabletron, outros). Isto porque estas placas são mais


performáticas, tem drivers suportados pela Microsoft, e tem muitos menos problemas de compatibilidade. Ou seja, a confiabilidade, performance e qualidade são muito mais altas, com um acréscimo muito pequeno de custo.

3.1.2. Requisitos para outros Tipos de Instalação

Para outros tipos de instalação como Servidor de Aplicação, Banco de Dados e Programas sugerimos fazer um serviço de SIZING. Para maiores informações sobre esse serviço entre em contato com o suporte Tecnologia pelo telefone (47) 2101-7400 ou pelo e-mail [email protected] .

3.1.3. Rede 1. Não recomendamos mais de 12 estações no mesmo segmento de rede (HUB), devido

aos problemas de colisão. Recomenda-se o uso de switchers para segmentar a rede. No caso de usuários mais exigentes recomenda-se dedicar uma porta do switcher para o mesmo (Na estação deste usuário também deverá ser utilizada uma placa de rede de melhor qualidade e performance, não sendo assim um gargalo).

2. Recomenda-se que os servidores utilizem placas de alta velocidade (100 Mbits ou

mais), conforme tecnologias existentes abaixo:

Tecnologia

Custo

Velocidade (Mbits)

Confiabilidade

Padronização

Utilização Nomin

al Real

Fast Ethernet Baixo 100 60 Normal OK Servidores

100 VG Médio 100 100 Normal OK/Não adotado Servidores

FDDI Médio 100 100 Alta OK Servidores/Backbones

ATM Alto 155/622

155/622 Alta

OK/Não utilizado

Servidores/Backbones

Gigabit Ethernet

Alto 1000 600 Alta OK Backbones

3. A tecnologia Fast Ethernet é padrão e foi adotada por vários fornecedores, contudo

tem uma perda de 40% de eficiência devido a sua arquitetura possuir colisão de pacotes. A tecnologia 100VG foi desenvolvida e padronizada sob liderança da HP, contudo poucos fornecedores adotaram este padrão, ele tem como vantagem não ter problema de colisão de pacotes, mas tem um custo mais elevado. A tecnologia FDDI é relativamente antiga, tem um padrão que é utilizado por quase todos fornecedores, contudo tem um custo ainda alto. A tecnologia ATM é relativamente nova, recentemente foi homologado um padrão, mas neste momento nem todos os fornecedores adotam este padrão (pode assim haver problemas de compatibilidade entre fornecedores diferentes). Gigabit Ethernet é a tecnologia mais nova, contudo ainda é cara e somente recomendável para ligar dois ou mais backbones diferentes.


4. Entre todas, a tecnologia FDDI é a que tem um preço razoável, é fácil de instalar, confiável, pode ser instalada em servidores e para ligação de backbones e tem um padrão de fato (o que é muito útil, caso se deseje trabalhar com fornecedores diferentes). Isto serve como regra geral, porém no caso de altíssimos volumes e grandes redes pode-se utilizar outras tecnologias (como ATM ou Gigabit Ethernet). No caso de redes menores, ou em parceria com FDDI/ATM/Gigabit Ethernet, pode-se utilizar outras tecnologias também (Fast Ethernet/100 VG).

5. Não recomendamos o uso de placas de 10 Mbits em servidores em nenhum caso.

Devido à demanda de um ambiente client/server (Office, E-mail, ERP, etc.), isto seria um gargalo que não utilizaria os outros recursos da rede adequadamente e afetaria a performance.

6. Para instalações de médio e grande porte (acima de 100 estações na mesma área

física) recomendamos a utilização de chassis. Na compra deste chassis deve ser levado em consideração a velocidade do backplane (maior do que 5 Gbits/seg.) e do número de pacotes que ele pode processar por segundo (> 750.000).

3.1.4. Recomendações Gerais

1. Pode-se utilizar o ambiente Novell para servidor de arquivos e impressão, porém

ocorrerão problemas quando forem utilizados arquivos com mais de 8 (oito) caracteres. Como servidor de banco de dados é necessário utilizar plataforma Windows Server ou Unix, e para o Terminal Server somente o Windows Server.

2. Adquira modelos de servidores com a configuração recomendada e que permitam

ampliação futura. Mesmo existindo uma pequena margem de erro, deve haver a possibilidade de ampliação futura de disco, memória e processamento.

3. Procurar adquirir servidores e equipamentos de rede de fornecedores de primeira

linha e que tenham assistência técnica na sua região. Confiabilidade e uma boa assistência técnica são mais importantes do que preço, devido ao grau de dependência em relação a estes equipamentos.

3.2. Requisitos de Software

3.2.1. Progress

1. Na compra do PROGRESS verifique se você adquiriu no mínimo os seguintes

produtos: Produto SO Observação OpenEdge Enterprise RDBMS

Plataforma Windows Server / Unix

Para cada servidor onde exista algum banco de dados PROGRESS de teste ou produção instalado, ou então a licença de dataserver em cada usuário que se conecta a algum banco de dados através de Dataserver Oracle ou Dataserver SQL Server

Client Networking Windows XP/2000 ou superior

Licenças correspondentes ao número de usuários concorrentes dos aplicativos Datasul


Query/Results Windows XP/2000 ou superior

Utilizado para a compilação de relatórios desenvolvidos pelo Dataviewer ou Results

OpenEdge Application Server Enterprise Edition

Plataforma Windows Server / Unix

Para o SO onde está o servidor de transações WEB

2. No caso de ter adquirido o Progress embutido em algum produto Datasul, verifique se

as licenças foram recebidas e instaladas adequadamente. 3. O uso do Application Server é imprescindível para uma boa performance do ambiente.

Este software tem por objetivo rodar processos remotos (RPC) disparados nas estações clientes pelos usuários. Caso ele não esteja instalado o Datasul-EMS funciona, contudo não com a mesma performance pois os processos vão rodar na estação, usando uma máquina menor que o servidor e com grande tráfego de rede.

4. Clientes que queiram utilizar outros gerenciadores de bancos de dados (Oracle ou

SQL Server), recebem o Dataserver relativo ao SGDB que se deseja utilizar. 5. PROGRESS, tanto no servidor quanto no cliente, vem com parâmetros padrão. Existe

necessidade de ser feito um ajuste para o seu ambiente (em função dos volumes previstos e recursos disponíveis) para uma boa performance. Depois de alguns meses é necessário fazer novos ajustes para os volumes reais, bem como uma reorganização dos dados.


3.2.2. Conversão

Segue abaixo tabela com relação à conversão de releases dos produtos DATASUL. Esta tabela contempla as releases dos produtos DATASUL com suas respectivas conversões. Antes de iniciar o processo de conversão é necessário adicionar o parâmetro –E na sessão dos produtos Datasul para o país Brasil. Este parâmetro já existe nos arquivos de configuração criados durante a instalação, mas caso tenha sido excluído deverá ser novamente adicionado antes da conversão. Destino

Origem

Dat

asul

-EM

S 2

.02

Dat

asul

-EM

S 2

.04

Dat

asul

-EM

S 2

.06

Dat

asul

-EM

S 5

.01

Dat

asul

-EM

S 5

.02

Dat

asul

-EM

S 5

.03

Dat

asul

-EM

S 5

.04

Dat

asul

-EM

S 5

.05

Dat

asul

-EM

S 5

.06

Dat

asul

-HC

M2.

06

Dat

asul

-HC

M 2

.08

Dat

asul

-HC

M 2

.09

Dat

asul

-HC

M 2

.10

Datasul -EMS 2.00 X

Datasul -EMS 2.01 X

Datasul -EMS 2.02 X

Datasul -EMS 2.04 X

Datasul -EMS 5.00 X

Datasul -EMS 5.01 X X

Datasul -EMS 5.02 X

Datasul -EMS 5.03 X

Datasul -EMS 5.04 X

Datasul -EMS 5.05 X

Datasul -HCM 2.05 X

Datasul -HCM 2.06 X

Datasul -HCM 2.08 X

Datasul -HCM 2.09 X

3.3. Requisitos de Usuário (Servidor) Recomendamos que a instalação dos produtos Datasul seja efetuada com o usuário ADMINISTRADOR, ou com algum usuário que esteja incluso no grupo de administradores do servidor.


3.4. Requisitos Datasul Interactive

Este capítulo tem por objetivo indicar os requisitos de softwares relacionados ao Datasul Interactive. Estes requisitos são complementares aos requisitos e recomendações dos produtos Datasul já existentes.

3.4.1. Requisito para Instalação PROGRESS

3.4.1.1. Requisito de Produto Datasul

Os produtos Datasul que integram-se com o Datasul Interactive são:

Produto Datasul EMS 2 * Datasul HR* Datasul EMS 5* DataViewer* WebDesk (release inicial 2.01) Datasul Business Intelligence Neogrid C-Commecer On-Demand

* com Progress release inicial 9.1D

É requisito que ao utilizar algum dos produtos acima listados, o ambiente destes encontrem-se atualizados.

3.4.1.2. Requisito para Área de Trabalho (Cliente)

• Adobe Flash Player 9. Baixe a instalação gratuitamente em:

http://www.adobe.com/shockwave/download/download.cgi?P1_Prod_Version=ShockwaveFlash&promoid=BIOW

• Microsoft Internet Explorer 5.5 ou release superior; • Java Runtime Environment versão 1.4 ou superior. Esta versão de Java já é

instalada com o Progress10. Também disponível na mídia dos produtos Datasul.

• Progress 10.0B ou release superior (Licença Mínima: Client Networking). • Acesso à internet (HTTP) para a visualização do conteúdo Datasul Interactive.

Observação: algumas empresas possuem controles de acesso dos usuários a Internet, uma sugestão para permitir o acesso ao Datasul Interactive, é liberar o acesso ao endereço eip.datasul.com.br.

• Acesso aos produtos Datasul a serem integrados ao Datasul Interactive.

3.4.1.3. Requisito para Servidor WEB

• Apache Tomcat 5.5.23. A instalação do Datasul Interactive irá executar a instalação do Apache Tomcat caso o seu sistema não possua este software;

• Windows 2000 Server ou superior, Linux, HP-UX ou AIX; • IIS 5.0 ou superior; • Progress 10.0B ou superior, OE Application Server;


Certifique-se que o ambiente esteja homologado conforme PAVAIL (Platform & Product Availability Guide) em http://www.progress.com/products/lifecycle

3.4.1.4. Requisito para Servidor de Banco de Dados

• Windows 2000 Server ou superior, Linux, HP-UX ou AIX; • Progress 10.0B ou superior (Licença mínima: OE Workgroup RDBMS ou OE

Enterprise RDBMS).


3.5.2. Requisito para Instalação ORACLE



Produto Datasul EMS 2 * Datasul HR* Datasul EMS 5* DataViewer* WebDesk (release inicial 2.01) Datasul Business Intelligence Neogrid C-Commecer On-Demand






• Oracle Client (estar na mesma versão do Oracle server); • Progress 10.0B ou superior (Licença mínima: Client Network); • Microsoft Internet Explorer 5.5 ou release superior; • Java Runtime Environment versão 1.4 ou superior. Esta versão de Java já é

instalada com o Progress10. Também disponível na mídia dos produtos Datasul; • Acesso à internet (HTTP) para a visualização do conteúdo Datasul Interactive.

Observação: algumas empresas possuem controles de acesso dos usuários a Internet, uma sugestão para permitir o acesso ao Datasul Interactive, é liberar o acesso ao endereço eip.datasul.com.br;

• Acesso aos produtos Datasul a serem integrados ao Datasul Interactive;


• Também se faz necessário configurar o produto Oracle SQL Net nas estações dos usuários. A única restrição a esta configuração é que o idioma de instalação das estações seja inglês . O nome do serviço deve ser único para todas as estações.



• Windows 2000 Server ou superior, Linux, HP-UX ou AIX; • IIS 5.0 ou release superior; • Progress 10.0B ou superior, OE Application Server;

Certifique-se que o ambiente esteja homologado conforme PAVAIL (Platform & Product Availability Guide) em http://www.progress.com/products/lifecycle e junto ao suporte Oracle em http://metalink.oracle.com/


• Windows 2000 Server ou supeior, Linux, HP-UX ou AIX; • Progress 10.0B ou superior, OE DataServer for Oracle; • Oracle Enterprise 9i Release 2 (9.2) ou superior; • Na máquina servidora de banco o Listener para o SQL Net deve estar instalado e

configurado; • DB_BLOCK_SIZE. É necessário que o tamanho do bloco da instância Oracle seja

no mínimo de 4k (4096 bytes). Caso a instância esteja configurada com valores menores que este tamanho, a mesma deverá ser recriada. Para verificar este valor execute o seguinte comando SQL no SQLPlus:

select name,value from v$parameter where name = 'db _block_size' • Parâmetro OPEN_CURSORS. Deve possuir um valor maior que 2000. Para

verificar o valor do parâmetro, execute a seguinte consulta conectado ao banco Oracle:

select name, value from v$parameter wher e name = 'open_cursors'

Caso seja necessário, altere o arquivo init.ora e reestarte o banco. • Código de página do banco. Obrigatoriamente o código de página do banco deve

possuir o valor WE8ISO8859P1 . Para verificar o valor deste parâmetro proceda com a seguinte consulta :

select parameter, value from nls_database_parameter s where parameter = 'NLS_CHARACTERSET'

Caso o valor deste parâmetro não seja este, a instância deverá ser recriada. Este parâmetro somente é informado durante a criação do banco, desta forma não existe maneira de alterá-lo sem recriar.

Certifique-se que o ambiente esteja homologado conforme PAVAIL (Platform & Product Availability Guide) em http://www.progress.com/products/lifecycle e junto ao suporte Oracle em http://metalink.oracle.com/


3.5.3. Requisito para Instalação SQL



Produto

Datasul EMS 2 * Datasul HR* Datasul EMS 5* DataViewer* WebDesk (release inicial 2.01) Datasul Business Intelligence Neogrid C-Commecer On-Demand






• Microsoft Internet Explorer 5.5 ou release superior; • Java Runtime Environment versão 1.4 ou superior. Esta versão de Java já é

instalada com o Progress10. Também disponível na mídia dos produtos Datasul.

• Progress 10.0B ou release superior (Licença Mínima: Client Networking). • Acesso à internet (HTTP) para a visualização do conteúdo Datasul Interactive.

Observação: algumas empresas possuem controles de acesso dos usuários a Internet, uma sugestão para permitir o acesso ao Datasul Interactive, é liberar o acesso ao endereço eip.datasul.com.br.

• Acesso aos produtos Datasul a serem integrados ao Datasul Interactive.



• Windows 2000 Server ou superior, Linux, HP-UX ou AIX; • IIS 5.0 ou superior; • Progress 10.0B ou superior, OE Application Server;



• Windows 2000 Server ou superior, Linux, HP-UX ou AIX;


• Progress 10.0B ou superior (Licença mínima: OE Workgroup RDBMS ou OE Enterprise RDBMS).

• SQL Server 2000 Enterprise/Standard ou superior. O SQL Server deverá utilizar o código de página padrão da instalação do mesmo.



4. Detalhes das Mídias de Instalação Neste capitulo detalharemos as mídias de instalação do produto DATASUL EMS 2.06B.

4.1. Disco 1 No disco 1 localizam-se os manuais do produto, o setup para instalação e os arquivos que irão instalar o produto em sua máquina.

4.2. Disco 2 e 3 No disco 2 localizam-se os arquivos de baixa do Instalador. No disco 3 estão os pacotes de atualização do produto, arquivos de baixa do produto e também a instalação do Descompactador de pacotes. Quando o config precisar do disco 2 ou disco 3 para continuar a instalação, deverá ser informado o diretório Disk2 ou Disk3 do cdrom (<Drive de CDROM>\Disk2 ou Disk3, ex: D:\Disk2 ), conforme figura abaixo:


5. Instalação

5.1. Planejando a Instalação Mostraremos agora as etapas que devem ser seguidas para que a instalação seja realizada para Multiusuário que contempla Programas, Banco de dados, Servidor de Aplicação. E também na instalação Demonstração.

a) Defina a topologia do ambiente. Nesta etapa, deve ser definido onde cada componente irá residir. Escolha o hardware que suportará o componente banco de dados, aquele que suportará o servidor de arquivos e também as máquinas que estarão disponíveis aos usuários. Como o componente “Servidor de Aplicação” é opcional decida se vai utilizá-lo no momento. Para cada um destes componentes, verifique se os requisitos de hardware e software são atendidos;

b) Inicie a instalação instalando os bancos de dados no servidor de banco de dados;

c) Instale os programas no servidor de arquivos;

d) Instale o servidor de aplicação se este componente for utilizado;

e) Carregue os servidores de bancos de dados através das scripts criadas no Unix ou pelo aplicativo ProControl em Windows NT;

f) Para servir os bancos de dados utilize as scripts criadas no Unix ou a ferramenta Progress Explorer Tool no Windows;

g) Inicialize os bancos de dados através do atalho criado em Iniciar\Programas\Datasul EMS\Release\Programa Inicializador; Caso a instalação seja destinada à conversão do produto, por exemplo do EMS-504 para o EMS-505, os bancos não poderão ser inicializados. Informações adicionais podem ser consultadas no Guia de Conversão Datasul-EMS que está na mídia do produto.

Após a conclusão destas etapas, o produto estará pronto para ser usado por todos os usuários.


5.2. Instalação de Programas Datasul-EMS Essa instalação irá configurar em um servidor, todos os objetos utilizados pelo produto Datasul-EMS. Abaixo são demonstradas as telas de instalação.

Seleção do Idioma

Selecione o idioma de sua preferência e clique em avançar.

Tela de Boas Vindas

Clique em Avançar para continuar.


Tela Informações do Usuário

Nessa tela deverá ser digitados o seu nome e a empresa em que você trabalha. Para continuar, clique em Avançar.

Tela de seleção de País

Nessa tela deverá ser selecionado o País de Instalação do Produto. A configuração do produto varia de acordo com a seleção do país. Para continuar, clique em Avançar.


Tela Tipo de Instalação

Para instalar os programas deverá ser selecionado o tipo de Instalação “Programa”. Esse tipo de instalação irá configurar todos os objetos (Programas e utilitários) que serão utilizados para execução do produto. Esse tipo de instalação também pode ser utilizado para atualização dos programas do Datasul EMS 2.06B. Para continuar, clique em Avançar.

Tela Tipo de Instalação de Programas

Nesta tela deverá ser informado o tipo de instalação para a área de programas. Escolha a opção “Nova Instalação” caso você esteja fazendo a instalação de programas pela 1ª vez ou fazendo uma instalação em uma área diferente da sua área de programas. A opção “Atualização da área de programa” deverá ser utilizada por clientes que estão atualizando sua área de programas com a mídia de instalação. Esta opção faz uma verificação do pacote que o cliente está e o último pacote expedido pela Datasul, emitindo uma mensagem de alerta com os pacotes de atualização que contêm atualização de dicionário.


� Nova Instalação

Tela Pasta de Instalação

Na tela Pasta de instalação deverá ser informado o diretório de destino do Produto, ou seja, onde serão baixados os programas do produto Datasul EMS 2.06B. Antes de instalar, verifique se possui espaço em disco suficiente. Para continuar, clique em Avançar.

Tela Cópia de Arquivos

Nesta tela contém as informações digitadas nas telas anteriores. Caso alguma informação esteja incorreta, utilize o botão Voltar e retorne até a mesma para correção. Para iniciar a instalação dos arquivos clique em Avançar.


� Atualização da área de Programas

Tela Pasta de Origem de Programas

Nesta tela deverá ser informada a localização dos programas do Produto ou seja a área em que o produto Datasul está instalado. Informe o diretório corretamente, pois o mesmo será validado pela instalação. Para continuar, clique em Avançar.


Na tela Pasta de instalação deverá ser informado o diretório de destino do Produto, ou seja, onde serão baixados os programas do Produto. Antes de instalar, verifique se possui espaço em disco suficiente. Para continuar, clique em Avançar.



Nesta tela contém as informações digitadas nas telas anteriores. Caso alguma informação esteja incorreta, utilize o botão Voltar e retorne até a mesma para correção. Para iniciar a instalação dos arquivos clique em Avançar.

Ao final da atualização de programas, caso exista alterações de dicionário entre a versão atual do cliente e a ultima versão liberada pela Datasul, será apresentada uma mensagem de alerta informando os pacotes que contêm atualização de dicionário. A seguir mostraremos uma mensagem exemplo:


Programas da Localização Chile Ao final da instalação de programas devem ser atualizados dois objetos que estão publicados nos arquivos de apoio do portal de clientes para o produto EMS 2.06B referente aos programas da Localização Chile. Estes arquivos devem ser descompactados diretamente no diretório de instalação dos programas. Estes podem ser encontrados no portal na estrutura <Central de Downloads � Arquivos de Apoio � Multi � EMS2 � 206B � Localização>.

5.3. Bancos de Dados

5.3.1 Criação de bancos de dados e schema holders

Independente do sistema gerenciador de banco de dados escolhido para executar

o sistema Datasul, o ambiente necessitará de um banco de dados Progress, seja para armazenar os dados do sistema ou para mapear a comunicação com outros bancos de dados não-Progress.

Quando o cliente optar por um banco de dados não-Progress (Oracle ou SQL Server), deverá criar um banco de dados Progress que atuará como um Schema Holder.

Se o cliente optar pela utilização de um banco de dados Progress, o espaço demandado pelo banco de dados deverá ser previsto em sua criação.

A lista com os bancos de dados necessários para o sistema a ser instalado encontra-se na planilha Mapa de Bancos.xls (localizado no mesmo diretório deste guia). Alguns desses bancos podem ser unificados. Essa lista está disponível no documento Unificação de banco de dados.doc (localizado no mesmo diretório deste guia). Esse documento também contempla a configuração necessária caso o ambiente seja multi-empresa, sendo necessário duplicar alguns bancos.

Os comandos Progress são iguais para ambientes Unix/Linux e ambientes Windows. Porém é necessário definir as variáveis de ambiente para sua utilização.

Dentro do diretório bin do Progress, está disponível o script proenv que configura a sessão com as variáveis de ambiente necessárias para proceder com a criação dos bancos.

Lembramos que a mídia de programas a ser utilizada foi compilada para um banco de dados em específico, e a opção pelo banco de dados a ser utilizado deve ter sido feito no momento da solicitação da mídia.

Os arquivos de definições dos bancos de dados encontram-se abaixo do diretório de instalação do aplicativo, no sub-diretório database\dffiles (para scripts de bancos progress), database\sholder (para scripts de schema holders Oracle ou MSSQL) e database\sql (para scripts de bancos Oracle ou MSSQL).

5.3.1.1 Criando um banco de dados Progress

Deverão ser criados os bancos de dados conforme o documento Mapa de

Bancos.xls . Opcionalmente as definições poderão ser unificadas em um ou mais bancos. Consulte o guia: Unificação de bancos de dados.doc , para informações de unificação de ambientes.


Para cada banco de dados a ser criado, crie um arquivo texto com o mesmo nome do banco de dados, extensão .st. Esse arquivo conterá as áreas do banco de dados, com seu respectivo tamanho. A seguir apresentamos um exemplo do banco ems2fnd com a configuração mínima desse arquivo:

b .\ems2fnd.b1 d "Schema Area":6,32;1 .\ems2fnd.d1 Esse arquivo criará em ambiente Windows, uma extensão para o before-image e

uma extensão de dados no diretório corrente. Essas extensão são obrigatórias para cada banco. Para ambiente Unix/Linux, inverta a barra separadora de diretório.

Caso tenha previsto que o banco de dados necessitará de um espaço maior, mais extensões de dados poderão ser criadas, especificando um tamanho em kbytes para cada uma delas. Lembramos que para o Progress apenas a última extensão de dados de uma área pode ter tamanho variável:

b .\ems2fnd.b1 d "Schema Area":6,32;1 .\ems2fnd.d1 f 1500032 d "Schema Area":6,32;1 .\ems2fnd.d2 f 1500032 d "Schema Area":6,32;1 .\ems2fnd.d3 Com o arquivo de estrutura criado, execute o seguinte comando para montar a

estrutura do banco. Lembre-se que se no arquivo de estrutura for utilizado caminho relativo, as extensões do banco serão criadas a partir do diretório onde foi executado o comando. O exemplo que segue também é para o banco ems2fnd:

prostrct create ems2fnd ems2fnd.st Caso deseje usar um tamanho de bloco diferente do padrão disponibilizado pela

Progress para o sistema operacional utilizado, adicione ao final desse comando o parâmetro –blocksize valor, onde valor corresponde ao tamanho em bytes do bloco (1024, 2048, 4096 ou 8192).

A estrutura criada é chamada de void. Uma estrutura void contém apenas o espaço alocado, sem qualquer informação. Para esse banco ser usado, deverá ser criado um Metaschema.

Um Metaschema contém as definições necessárias para o banco ser utilizando, começando a receber informações de usuários. A criação do Metaschema é feito através da cópia de um banco vazio disponibilizado pela Progress. Faça a cópia como o comando de exemplo a seguir em Windows:

procopy %DLC%\empty ems2fnd Para Unix: procopy $DLC/empty ems2fnd Da mesma forma que o banco pode ter sido criado com blocagem diferente no

comando prostrct create , o tamanho do bloco também deverá ser contemplado nesse comando. Para copiar o Metaschema para um banco de dados com tamanho de bloco diferente do padrão disponibilizado para o sistema operacional, referencie os bancos


empty1, empty2, empty4 ou empty8, conforme a necessidade, no lugar do padrão empty.

5.3.1.2 Criando um Schema Holder Um Schema Holder consiste em um banco de dados Progress com definições que

mapeiam os objetos dos bancos de dados não-Progress. Ele não armazena dados e poderá ser conectado em modo somente-leitura ou servido em modo multi-usuário quando em produção, e mono-usuário para importação de definições.

Para cada Schema Holder a ser criado, execute o comando prodb . O exemplo a seguir cria o banco de dados para o Schema Holder do banco ems2fnd:

prodb ems2fnd empty Para bancos de dados Progress que terão a função de Schema Holders, não é

necessário prever tamanho de banco de dados ou de bloco. 5.3.2. Importando definições As definições são expedidas através de arquivos com a extensão .df. Para

ambientes que utilizarão bancos de dados não-Progress, também estão disponíveis os arquivos .sql para importação no banco de dados Oracle ou SQL Server.

Os arquivos .df deverão ser importados tanto para bancos de dados Progress quanto para Schema Holders Oracle e SQL Server, conforme os bancos de dados utilizados.

5.3.2.1. Importando definições em Progress Em uma sessão do proenv (verifique procedimento no ítem 5.3.1), execute o

comando a seguir em ambiente Windows, dentro do diretório do banco de dados. O banco ems2fnd foi usado como exemplo:

prowin32 ems2fnd -1 –cpstream ibm850 –d dmy –numsep 46 –numdec 44 –p

_admin.p –rx Em ambiente Linux/Unix, o comando é alterado para o exemplo a seguir: _progres ems2fnd -1 –cpstream ibm850 –d dmy –numsep 46 –numdec 44 –p

_dict.p –rx Em ambiente Windows, a tela do Data Administration do Progress é exibida. Em

ambiente Linux/Unix, a tela do Data Dictionary é exibida. Para Linux/Unix, as funções do Data Administration são incorporadas no Data Dictionary.

Nessa tela, selecione o menu Admin, Load Data and Definitions, Data Definitions(.df file). Na tela que abrir, selecione o arquivo de definições correspondente ao banco que está conectado. Pressione OK para começar a importação.

O arquivo de definições (.df) está em formato texto. Caso esteja importando em ambiente Linux/Unix, o .df deverá ser transferido para o servidor através de FTP ASCII. Qualquer outra forma de transferência que não converta quebras de linhas danificará o arquivo.


Durante a importação poderão ocorrer alertas (warnings) referentes ao formato dos campos em uma conexão ODBC/JDBC. Esses alertas podem ser ignorados.

5.3.2.2. Importando definições em Oracle No Oracle não criamos um banco de dados para cada arquivo de definições (.sql)

mas sim um usuário (schema) para cada um desses arquivos. Esses usuários podem ser criados em um mesmo banco de dados (instância).

Na instalação do Oracle é possível optar pela criação de um banco de dados automaticamente. Caso esta opção não fora selecionada ou deseja-se criar um banco de dados diferente, proceda conforme a documentação do Oracle específica para o ambiente que está utilizando. Por exemplo, para Windows poderá ser utilizado o utilitário dbca e seguir as orientações apresentadas em tela.

Para a criação destes esquemas, bem como para as demais tarefas administrativas do banco, este deverá ser conectado com um usuário que possua as permissões necessárias ou então o próprio usuário sys, que é o usuário com maior autoridade no banco de dados Oracle. A seguir um exemplo de conexão ao banco com usuário de administração, utilizando a ferramenta SQL Plus, que é instalada junto com o Oracle:

CONN SYS/<senha>@<instância> AS SYSDBA; � <senha>: senha do usuário sys � <instancia>: nome da instância ou banco de dados que será utilizada. Este

nome é atribuído durante a criação do banco de dados e posteriormente pode ser consultada no arquivo tnsnames.ora , localizado no diretório de instalação do Oracle.

Os usuários que armazenarão os objetos deverão possuir um conjunto de

permissões, as quais podem ser administradas individualmente ou em grupos. A seguir a sintaxe utilizada para criar uma role chamada usuario_datasul, que agrupará as devidas permissões:

CREATE ROLE usuario_datasul; GRANT CONNECT TO usuario_datasul; GRANT CREATE TABLE TO usuario_datasul; GRANT CREATE SEQUENCE TO usuario_datasul; A seguir um exemplo de comando utilizado para criar o esquema ems2fnd

atribuindo a ele as permissões da role usuario_datasul: CREATE USER ems2fnd IDENTIFIED BY <senha> DEFAULT TABLESPACE <tablespace> TEMPORARY TABLESPACE <temp> QUOTA UNLIMITED ON <tablespace>; GRANT usuario_datasul TO ems2fnd; � <senha>: senha que será utilizada na conexão, podendo utilizar o mesmo

nome do usuário ou, preferencialmente, uma senha mais segura. � <tablespace>: local aonde serão armazenados os objetos, podendo utilizar

a tablespace users ou, preferencialmente, uma tablespace específica para o produto.


� <temp>: nome da tablespace temporária que está definida no banco, geralmente chamada temp.

Após criados os esquemas, conectar a instância com cada um deles para importar

os arquivos que contém as definições dos seus objetos. A seguir um exemplo de como conectar com o usuário ems2fnd, utilizando a senha

pw_ems2fnd no banco de dados ORCL e importar o arquivo ems2fnd.sql localizado no diretório database\sql dentro da instalação do produto:

CONN ems2fnd/pw_ems2fnd@ORCL; @C:\Datasul\ByYou\Database\sql\ems2fnd.sql 5.3.2.3. Importando definições em SQL Server O primeiro passo é criar os bancos de dados necessários. Para cada arquivo de

definição (.sql) existente no diretório database\sql, deverá ser criado um banco de dados. O comando a seguir exemplifica a criação do banco de dados ems2fnd.

USE master GO CREATE DATABASE e207amultmssfnd GO Após a criação do banco, crie uma nova query utilizando o SQL Server

Management Studio. Abra o .sql correspondente ao banco de dados criado e execute-o. Após a conclusão do comando o banco estará pronto para ser conectado.

5.3.3. Servindo e conectando os bancos de dados O serviço de um banco de dados existe para que vários usuários possam

conectar-se simultaneamente. Na conexão, os produtos Datasul que são executados sobre Progress utilizam-se de um atalho e alguns arquivos de configuração.

Quando o ambiente possui bancos de dados unificados, um programa que cria alias também deverá ser configurado para executar antes dos programas do sistema. Para essa configuração, consulte o documento Unificação de banco de dados.doc .

A seguir está exemplificado um comando padrão para utilizar em um atalho de conexão:

<dir progress>\bin\prowin32.exe –basekey INI –ininame arquivo.ini –pf arquivo.pf O arquivo .ini com as configurações padrão do sistema encontra-se disponível no

diretório scripts da instalação do produto. Da mesma forma, um arquivo .pf foi criado no mesmo diretório para as configurações de sessão do produto.

5.3.3.1. Ambientes com bancos de dados Progress O primeiro passo para estabelecer uma conexão ao banco de dados é

disponibilizar esse banco para um acesso cliente-servidor. Isso pode ser feito através


de scripts, executando os comandos Progress que efetuam essa tarefa, ou através da ferramenta Progress Explorer Tool.

Independente de como o banco é servido, algumas características devem estar definidas para o perfeito funcionamento do ambiente:

� Porta de comunicação: A porta de comunicação é o canal para estabelecer o contato de uma sessão cliente com o banco de dados. Essa porta TCP deverá ser única no servidor. Recomenda-se definí-la entre 20000 e 65535.

� Firewall: Caso exista algum firewall entre os clientes e o banco de dados, a porta indicada no parâmetro –S de cada broker de login, deverá estar liberada. Também deverá liberar as portas que processos servers utilizarão. Essas portas são definidas em intervalos, através dos parâmetros –minport e –maxport.

� Número de usuários que se conectam ao sistema: Os bancos de dados deverão permitir a conexão de todos os usuários contratados para o sistema. A conexão cliente-servidor ao banco de dados Progress ocorre através de processos chamados Servers. Cada processo pode receber um ou mais usuários. A relação de usuários por server deve ser definida na inicialização do banco de dados.

� Conexões ODBC/JDBC: Alguns bancos de dados precisam receber conexões ODBC ou JDBC, o que em bancos de dados Progress são chamadas de conexões SQL. Um novo broker de login deve ser iniciado para receber esse tipo de conexão, com a quantidade de servers necessários para atender a necessidade de logins SQL.

Com esses dados definidos, carregue cada um dos bancos de dados conforme o

exemplo abaixo para ambientes Windows: call proserve ems2fnd <parâmetros do banco> Para ambientes Linux/Unix: proserve ems2fnd <parâmetros do banco> Caso seja necessário criar um broker para conexões SQL, utilize o exemplo abaixo

para ambientes Windows: call proserve ems2fnd –m3 <parâmetros do broker de login> Para ambientes Linux/Unix: proserve ems2fnd –m3 <parâmetros do broker de login> Adicione no arquivo .pf as conexões aos bancos de dados que serão utilizados

pelo sistema. Nesse mesmo arquivo, estão disponíveis exemplos da conexão ao banco Progress.

5.3.3.2. Ambientes com bancos de dados Oracle A forma como carregar uma base de dados Oracle pode variar dependendo da

plataforma utilizada. Em linhas gerais, o usuário administrador do banco poderá carregar e derrubar uma instância Oracle, conectando com o usuário sys na ferramenta SQL Plus e executar os comandos startup para iniciar a base de dados e shutdown


para pará-la. Em alguns ambientes como no Windows, basta iniciar o serviço com o nome do banco de dados criado para que a base esteja disponível para conexões.

Altere o arquivo .pf instalado no diretório scripts para conectar o banco de dados. Nesse mesmo arquivo, estão disponíveis exemplos da conexão ao banco Oracle e Schema Holder.

5.3.3.3. Ambiente com bancos de dados SQL Server Na maior parte dos casos o SQL Server executa como um serviço do sistema

operacional e as instâncias são iniciadas automaticamente quando o gerenciador de serviços inicia. Em caso de dúvidas sobre a inicialização dos serviços do SQL Server consulte a documentação do produto.

Altere o arquivo .pf instalado no diretório scripts para conectar o banco de dados. Essa conexão deve ser feita utilizando o método DSN-less, informando a linha de conexão com o SQL Server. Nesse mesmo arquivo, estão disponíveis exemplos da conexão ao banco SQL Server e Schema Holder.

5.4. Instalação Datasul Interactive

A interface padrão de todos os produtos Datasul é o Datasul Interactive. Sua instalação acompanha a instalação de nossos produtos. O DI reúne em um menu unificado todos os módulos Datasul e oferece informações contextualizadas sobre nossos produtos. Este capítulo tem por objetivo apresentar as etapas de instalação do Datasul Interactive utilizando-se da mídia disponibilizada pela Datasul. Antes de começar a instalação é essencial ter um conjunto de informações (solicitadas durante a instalação), as quais estão listadas abaixo:

• Identifique o diretório onde o Progress foi instalado nas máquinas clientes (exemplo: c:\dlc91, c:\dlc10).

• Identifique qual produto/sistema será utilizado para a autenticação dos usuários no

Datasul Interactive:

Produto/Sistema Datasul EMS 2 Datasul EMS 5 Datasul HR Domínio Windows

* Quando solicitado na instalação, somente poderá informar um único produto/sistema. A instalação consiste em configurar inicialmente a base dados, após a instalação de todos os objetos(programas e scripts) utilizados pelo produto Datasul Interactive e finalmente algumas parametrizações finais para o uso do produto pelos usuários.

Existem três tipos de mídias de instalação do Datasul Interactive: para base de dados Progress, para base de dados em Oracle e para base de dados SQL. Certifique-se que esteja utilizando a mídia correta conforme o seu ambiente disponível.


Observação 01: Considere ao realizar a instalação do Datasul Interactive, os produtos que serão integrados já estejam instalados e configurados antecipadamente. Observação 02: Caso selecionado a instalação simultânea de Banco de Dados e Programas, serão apresentadas mensagens de alertas orientativos sobre em qual etapa estará sendo executada:

Observação 03: Caso selecionado a instalação simultânea de Banco de Dados e Programas, o diretório de instalação dos programas e banco de dados será único como também será único o diretório padrão do produto Progress. Desta forma, estas informações serão solicitadas uma única vez.

A seguir são demonstradas as telas de instalação.

Seleção do Idioma



Tela de Boas Vindas









Para instalar o Datasul Interactive deverá ser selecionado o tipo de Instalação “Datasul Interactive”. Este tipo de instalação irá baixar os programas e bancos de dados do Datasul Interactive. Para continuar, clique em Avançar.

5.4.1. Instalação Banco de Dados Datasul Interactiv e Este tipo de instalação irá instalar e configurar os bancos de dados do Datasul Interactive e também criar os scripts de conexão dos bancos de dados do Produto Datasul-EMS e Datasul Interactive.

Tela Tipo de Instalação Datasul Interactive


Nesta tela é selecionado o conteúdo a ser instalado pela mídia. Observação: - Para a instalação de programas, é pré-requisito a instalação da opção banco de dados. - Para a instalação adicionando um novo produto ao Datasul Interactive, é pré-requisito a instalação da opção de banco de dados e de programas. Para continuar, clique em Avançar.

Tela Sistema Operacional

Nesta tela deverá ser selecionado o sistema operacional do servidor de banco de dados que será instalado a base de dados do Datasul Interactive. Observação: Para instalação em Windows NT/2000 será necessário executar a instalação no próprio servidor. Para continuar, clique em Avançar.

Tela Informe a pasta destino do aplicativo


Nesta tela deverá ser informado o diretório de destino dos Bancos de Dados, ou seja, onde serão baixados os bancos e scripts do Datasul Interactive. Observação: Evite utilizar diretórios com espaço em branco. Para continuar, clique em Avançar.

Tela Pasta Destino Aplicativo Progress

Nesta tela deverá ser informado o diretório onde o aplicativo Progress encontra-se instalado. Observação: Caso o Progress ainda não esteja instalado, cancele a instalação do produto Datasul Interactive e providencie a sua instalação. Para continuar, clique em Avançar

Tela Número Base de Serviços


Nesta tela deverá ser informado um número inicial para configuração da porta TCP/IP que será utilizada na carga do banco do Datasul Interactive. Observação: Verifique se o número sugerido não esteja sendo utilizado, caso afirmativo, informe um outro número. Para continuar, clique em Avançar.

Tela Servidor de bancos de dados

Nesta tela deverá ser informado o servidor em que os bancos de dados do produto EMS 2.06B foram instalados no tipo de instalação “Bancos de Dados” Para continuar, clique em avançar.

Tela Configuração Progress Explorer Tool


Nesta tela pode-se selecionar a opção de alterar automaticamente ou não, o arquivo “conmgr.properties” de acordo com a faixa informada na tela anterior. Observação: É recomendada a utilização da opção modificar o arquivo cmmgr.propeties, se você deseja administrar o banco de dados via o Progress Explorer Tool. Para continuar, clique em avançar.

Tela Confirmação das informações parametrizadas

Nesta tela o usuário confirma as informações parametrizadas anteriormente. Observação: Caso alguma informação esteja incorreta, deve-se utilizar a opção Voltar. Para continuar, clique em Avançar.

Tela Instalação Concluída


Nesta tela é informado ao usuário o término da instalação a nível de base de dados do produto Datasul Interactive. Observação: O serviço do Progress AdminService deve ser re-iniciado. Para finalizar, clique em Terminar.

Configuração do Aplicativo Progress Explorer Tool


Durante a instalação do banco de dados do produto Datasul Interactive o aplicativo “Progress Explorer Tool” é configurado com uma parametrização básica para carga do banco de dados, caso você tenha setado para alterar a configuração do arquivo “conmgr.properties”. Essa configuração deve ser alterada de acordo sua necessidade para que o Sistema responda com uma melhor performance. Para o levantamento de sua real necessidade sugerimos um Tunning dos Bancos de Dados. Para mais informações sobre esse serviço, entrem em contato com o Suporte Tecnologia através do telefone (47) 21017400. O aplicativo “Progress Explorer Tool” somente é disponibilizado para Progress versão 9 ou superior. Abaixo tela de demonstração do Progress Explorer Tool:

Objetos criados na instalação Banco de dados:


Abaixo estão detalhados os objetos criados durante a instalação dos Bancos de Dados em Windows NT/2000.

Localização Objeto Descrição <Dir Instalação>\scripts Ems2.ini Arquivo contendo

informações do ambiente para utilização do produto Datasul EMS 2.06B

<Dir Instalação>\scripts Ems2.pf Arquivo contendo os parâmetros de sessão para acesso ao produto Datasul EMS 2.06B

<Dir Instalação>\scripts Ems2mult.pf Arquivo contendo os parâmetros de conexão dos bancos de dados do produto Datasul-EMS 2.06B

<Dir Instalação>\scripts eip.pf Arquivo contendo os parâmetros de sessão para acesso ao produto Datasul Interactive

<Dir Instalação>\scripts eipmult.pf Arquivo contendo os parâmetros de conexão do banco de dados do produto Datasul Interactive.

<Dir Instalação>\scripts eiphost.pf Arquivo contendo os parâmetros de conexão do banco de dados do produto Datasul Interactive.

<Dir Instalação>\scripts Ems2rpr.bat Script para reparar os bancos

de dados do produto Datasul Interactive

<Dir Instalação>\scripts Ems2trun.bat Script para truncar os bancos de dados do produto Datasul Interactive

<Dir Instalação>\database eip.st Arquivo contendo a estrutura do banco de dados. Esse arquivo é utilizado no processo de reparação dos banco de dados do produto Datasul Interactive.

Parâmetros de conexão dos bancos do Chile

Ao final da instalação do banco de dados do Datasul Interactive deve ser atualizado o arquivo que contém os parâmetros de conexão dos bancos de dados do EMS 2.06B (ems2mult.pf). Este arquivo está localizado no diretório de instalação conforme estrutura da tabela acima. Ao final do arquivo deve ser acrescentado os parâmetros de carga dos bancos da localização Chile, lcchl e mov2chl .


-db lcchl -ld lcchl -S <número_serviço> -H <servidor_bancos> -N tcp -db mov2chl -ld mov2chl -S <número_serviço> -H <servidor_bancos> -N tcp

5.4.2. Instalação Programas Datasul Interactive

Este tipo de instalação irá instalar os programas do Datasul Interactive, criar o Serviço WebSpeed no Progress Explorer Tools, criar o diretório virtual no Internet information service ou Apache e fazer a configuração necessária para acesso ao Datasul-EMS pelo Datasul Interactive.

Tela Tipo de Instalação: Programas

Nesta tela é selecionado o conteúdo a ser instalado pela mídia. Observação: - Para a instalação de programas, é pré-requisito a instalação da opção banco de dados. - Para a instalação adicionando um novo produto ao Datasul Interactive, é pré-requisito a instalação da opção de banco de dados e de programas. Para continuar, clique em Avançar.

Pergunta

Informe se o aplicativo Apache Tomcat está instalado em seu Sistema. Caso não esteja instalado, o wizard do Datasul Interactive irá efetuar a execução da instalação do Tomcat.


Tela Diretório de Instalação Apache Tomcat

Nesta tela deverá ser informado o diretório de instalação do aplicativo Apache Tomcat. Para continuar, clique em Avançar.

Tela Servidor de Arquivos Datasul Interactive

Nesta tela deverá ser selecionado o sistema operacional do servidor de aplicativo que será instalado os programas do Datasul Interactive. Para continuar, clique em Avançar.


Tela Estrutura dos bancos de dados

Selecione o tipo de estrutura de bancos de dados que foi definida na opção “Banco de Dados” da instalação do Datasul EMS 2.06B. Para continuar, clique em Avançar.

Tela Informe a pasta destino do aplicativo

Nesta tela deverá ser informado o diretório de destino dos programas, ou seja, onde serão baixados os programas e outros objetos do Datasul Interactive. Observação: Evite utilizar diretórios com espaço em branco. Para continuar, clique em Avançar.


Tela Informe a pasta onde o aplicativo Progress est á instalado

Nesta tela deverá ser informado o diretório onde o aplicativo Progress encontra-se instalado. Observação: Caso o Progress ainda não esteja instalado, cancele a instalação do produto Datasul Interactive e providencie a sua instalação. Para continuar, clique em Avançar

Tela Serviço WebSpeed

Nesta tela deverá ser informado o nome do servido Webspeed a ser criado para o Datasul Interactive. Para continuar, clique em Avançar.


Tela Seleção de Autenticação de Produto

O autenticador fornece a lista dos usuários que podem fazer acesso ao Datasul Interactive. Caso a escolha seja pelo domínio do Windows NT / 2000 serão considerados os nomes de usuário cadastrados na sua rede, já no caso de autenticação pelo produto será utilizada a lista de usuários cadastrados no sistema. Observação: Somente poderá ser selecionado um único produto como autenticador. Para continuar, clique em Avançar.

Tela Product ID Datasul-EMS 2

O campo informado será o identificador do produto para o DI e para o serviço WEB. Para continuar, clique em Avançar.


Tela Pasta Origem de Programas

Nesta tela deverá ser informado o diretório em que encontram-se os programas do Datasul EMS 2.06B. Para continuar, clique em Avançar.

Tela Executável Messenger

Nesta tela deverá ser selecionado o executável messenger a ser utilizado pelo webspeed. Para continuar, clique em Avançar.


Tela Servidor WEB

Nesta tela deverá ser informado o Host da máquina servidora WEB. Para continuar, clique em Avançar.

Tela Identificação Datasul

Nesta tela deverá ser o usuário utilizado no login da página de Suporte da Datasul. Para continuar, clique em Avançar.


Pasta de origem do arquivo de conexão Datasul EMS 2.06B

Nesta tela deverá ser informada a pasta onde se localiza o arquivo de conexão (ems2mult.pf ) do produto EMS 2.06B instalado no tipo de instalação banco de dados. Para continuar, clique em Avançar.

Tela WEB

Nesta tela pode-se selecionar a opção de alterar automaticamente ou não, o arquivo “ubroker.properties” de acordo com a faixa informada na tela anterior. Observação: É recomendada a utilização da opção modificar o arquivo ubroker.propeties, se você deseja administrar o serviço Webspped via o Progress Explorer Tool. Para continuar, clique em avançar.


Tela Servidor WEB

Nesta tela deverá ser selecionado o software WEB utilizado. Internet Information Service ou Apache. Após retorne para esta sequência de explicações.

• Internet Information Services

Tela Diretório Virtual IIS

Nesta tela deverá ser informado o diretório virtual a ser criado para o Datasul Interactive. Observação: Evite utilizar diretórios com espaço em branco. Para continuar, clique em Avançar.


• Apache

Tela Alias Apache

Nesta tela deverá ser informado o diretório virtual a ser criado para o Datasul Interactive. Observação: Evite utilizar diretórios com espaço em branco. Para continuar, clique em Avançar.

Tela Configuração Apache

Nesta tela deverá ser informado a localização do arquivo de configurações do Apache: httpd.conf. Para continuar, clique em Avançar.





5.4.3. Configurando Serviço do Apache Tomcat

Após a instalação dos programas e do aplicativo Apache Tomcat, será necessário alterar o usuário de start do serviço do Tomcat para o usuário administrador do servidor Web. Para isso siga os passos abaixo: 1 – Vá até a tela de serviços do Windows, clique propriedades, conforme a tela abaixo:


2 – Vá até a aba Log On e altere de “Conta do Sistema Local” para “Esta Conta”, informe o usuário e senha do administrador do servidor e clique em OK, conforme abaixo:

3 – Reinicie o serviço Apache Tomcat.

5.4.4. Deploy Automático

A instalação do Datasul Interactive efetuará a baixa do arquivo di.war no diretório weapps do Tomcat. Caso o serviço do Tomcat esteja iniciado, este arquivo será descompactado automaticamente criando a pasta di com os componentes necessários para a execução do Datasul Interactive.

5.4.5. Adicionando Novo Produto ao Datasul Interact ive

Observação 1: Quando adicionado novo produto, sendo WebDesk ou Datasul BI, deve-se selecionar algum produto autenticador (Datasul EMS 2, Datasul EMS 5 ou Datasul HR) em conjunto ou que tenha sido configurado anteriormente. Observação 2: Para a instalação do Datasul Interactive é necessário conhecer os parâmetros utilizados na execução destes produtos, conforme planilha abaixo:


Produto Exemplos de Arquivos Datasul EMS 2

Arquivo .PF de conexão das bases de dados do cliente. *

X:\Atalhos\EMS 2.04\EMS204 Suporte v9\scritps\ems2.pf

Arquivo INI utilizado na sessão do cliente.

X:\Atalhos\EMS 2.04\EMS204 Suporte v9\scritps\progresc.ini

Datasul EMS 5

Arquivo .PF de conexão das bases de dados do cliente. *

X:\Atalhos\EMS 5\EMS505 Beta Por-psc9\scripts\connect.pf


X:\Atalhos\EMS 5\EMS505 Beta Por-psc9\scripts\progress.ini

Datasul HR Arquivo .PF de conexão das bases de dados do cliente. *

X:\Atalhos\HR 2.08\HR208 Audit POR v9\scripts\hr208.pf


X:\Atalhos\HR 2.08\HR208 Audit POR v9\scripts\progresc.ini

DataViewer Arquivo .PF de conexão das bases de dados do cliente. *

X:\Atalhos\Dataviewer\DataViewer 2.3\scripts\grd.pf


X:\Atalhos\Dataviewer\DataViewer 2.3 \scripts\ progresc.ini

WebDesk URL http://<Nome_do_Servidor>/scripts/cgiip.exe/WService=<Nome_do_S

erviço_WebSpeed>/wgp/wgp0006.p Datasul Business Intelligence

URL http://<nome do servidor>/<diretório virtual>


Neogrid C -Commerce On-Demand

URL http://200.180.73.66:82/servlet/com.neogrid.arch.web.util.AuthServlet * Neste arquivo não poderá constar os parâmetros -T (diretório temporário da sessão) e -p (programa a ser executado inicialmente na sessão).

A seguir detalharemos as telas deste tipo de instalação:

Tela Tipo de Instalação: Adicionar novo produto ao Datasul Interactive

Nesta tela é selecionado o conteúdo a ser instalado pela mídia. Observação: - Para a instalação adicionando um novo produto ao Datasul Interactive, é pré-requisito a instalação da opção de banco de dados e de programas. Para continuar, clique em Avançar.

Tela diretório origem do Datasul Interactive

Nesta tela informe o diretório dos programas instalados do Datasul Interactive. Para continuar, clique em Avançar.


Tela Informe a posta onde o aplicativo Progress est á instalado

Nesta tela deverá ser informado o diretório onde o aplicativo Progress encontra-se instalado. Observação: Caso o Progress ainda não esteja instalado, cancele a instalação do produto Datasul Interactive e providencie a sua instalação. Para continuar, clique em Avançar.


Tela Produto Instalado

Nesta tela deverá ser selecionado o produto já instalado e configurado anteriormente e que deseja-se integrar ao Datasul Interactive (verifique quais produtos já integram-se com o Datasul Interactive para selecionar corretamente). Observação: Pode-se selecionar um produto ou mais de um produto.Caso seja selecionado: - Datasul EMS 2: continue no tópico 5.4.3.1. Adicionando Produto Datasul EMS 2. - Datasul EMS 5: continue no tópico 5.4.3.2.. Adicionando Produto Datasul EMS 5. - Datasul HR: continue no tópico 5.4.3.3. Adicionando Produto Datasul HR. - Datasul Webdesk: continue no tópico 5.4.3.4. Adicionando Produto Datasul Webdesk. - Datasul BI: continue no tópico 5.4.3.5. Adicionando Produto Datasul BI. Após retorne para esta sequência de explicações. Para continuar, clique em Avançar.


5.4.5.1. Adicionando Produto Datasul EMS 2

Tela Release do produto Datasul EMS 2

Nesta tela deverá ser selecionado a release do produto Datasul EMS 2 que encontra-se instalado. Para continuar, clique em Avançar.

Tela Product ID Datasul-EMS 2




Nesta tela deverá ser informado o diretório em que encontram-se os programas do Datasul EMS 2. Para continuar, clique em Avançar.

Tela Arquivo de Parâmetros para conexão com os banc os

Nesta tela deverá ser informado a localização do arquivo de parâmetros (.pf) das bases de dados do Datasul EMS 2. Observação: O arquivo .pf não deverá possuir os parâmetros -T, -param e -basekey. Caso existam, ocorrerão erros nos serviços webspped do Datasul Interactive. Para continuar, clique em Avançar.


Tela Arquivo de configurações (.ini)

Nesta tela deverá ser informado a localização do arquivo de inicialização e configurações da sessão (.ini) utilizado nos atalhos do Datasul EMS 2. Para continuar, clique em Avançar.

Tela WEB



Tela Servidor WEB







5.4.5.2. Adicionando Produto Datasul EMS 5

Tela Release do produto Datasul EMS 5

Nesta tela deverá ser selecionado a release do produto Datasul EMS 5 que encontra-se instalado. Para continuar, clique em Avançar.


Tela Product ID Dat asul -EMS 5



Nesta tela deverá ser informado o diretório em que encontram-se os programas do Datasul EMS 5. Para continuar, clique em Avançar.



Nesta tela deverá ser informado a localização do arquivo de parâmetros (.pf) das bases de dados do Datasul EMS 5. Observação: O arquivo .pf não deverá possuir os parâmetros -T, -param e -basekey. Caso existam, ocorrerão erros nos serviços webspped do Datasul Interactive. Para continuar, clique em Avançar.


Nesta tela deverá ser informado a localização do arquivo de inicialização e configurações da sessão (.ini) utilizado nos atalhos do Datasul EMS 5. Para continuar, clique em Avançar.


Tela WEB


Tela Servidor WEB








5.4.5.3. Adicionando Produto Datasul-HR

Tela Release do produto Datasul -HR

Nesta tela deverá ser selecionado a release do produto Datasul HR que encontra-se instalado. Para continuar, clique em Avançar.

Tela Product ID Datasul-HR




Nesta tela deverá ser informado o diretório em que encontram-se os programas do Datasul HR. Para continuar, clique em Avançar.


Nesta tela deverá ser informado a localização do arquivo de parâmetros (.pf) das bases de dados do Datasul HR. Observação: O arquivo .pf não deverá possuir os parâmetros -T, -param e -basekey. Caso existam, ocorrerão erros nos serviços webspped do Datasul Interactive. Para continuar, clique em Avançar.



Nesta tela deverá ser informado a localização do arquivo de inicialização e configurações da sessão (.ini) utilizado nos atalhos do Datasul HR. Para continuar, clique em Avançar.

Tela WEB



Tela Servidor WEB







5.4.5.4. Adicionando Produto Datasul Webdesk

Tela Informações sobre Datasul Webdesk

Nesta tela deverá ser informado o servidor Web do produto Webdesk e o serviço webspeed utilizado. Para continuar, clique em Avançar.







5.4.5.5. Adicionando Produto Datasul BI

Tela URL para o Datasul BI

Nesta tela deverá ser informado a URL correspondente ao acesso ao Datasul BI. Para continuar, clique em Avançar.






5.4.6. Instalando Java Plug-In No diretório interfac da instalação do Datasul Interactive está o instalador do Java Plug-in (arquivo j2re-1_4_0_01-windows-i586-i.exe) necessário para executar o Applet no browser dos usuários. Esta instalação deverá ser executada manualmente, visto que a mídia de instalação não executará automaticamente.

Observação: É recomendável fazer esta instalação antes de utilizar o Datasul Interactive, para evitar que seja feita a instalação do Java Plug-in via Internet. Uma opção é colocar a instalação do plug-in no LogonScript da rede.


Tela Java R unTime Enviroment - InstallShield Wizard

Nesta tela é informado ao usuário o início da instalação. Aguarde o término da verificação do ambiente para que sejam solicitadas as informações.

Tela InstallShield Wizard

Nesta tela é informado ao usuário as boas-vindas ao instalador do Java Plug-In. Pressione o botão Next para continuar a instalação.



Nesta tela é informado os termos sobre a licença e questionado ao usuário se aceita os termos apresentados Pressione o botão YES para aceitar e continuar a instalação.


Nesta tela o usuário deverá informar o diretório de instalação do Java Plug-In. Pressione o botão Next para continuar a instalação.



Nesta tela o usuário deverá informar o browser que será utilizado. Pressione o botão Next para continuar a instalação.


Nesta tela o usuário deverá aguardar o término da instalação dos arquivos.


5.4.7. Executando o Datasul Interactive

Este capítulo tem por objetivo apresentar como o usuário final estará acessando o Datasul Interactive.

5.4.7.1. Executando o Datasul Interactive Os usuários para executarem o Datasul Interactive, deverão abrir uma sessão do browser (Internet Explorer) e informar o seguinte caminho: http://<nome_do_servidor>:<porta de conexão do Tomcat>/di.

(exemplo: http://pedrasaltas:8080/di)

Após a digitação, será apresentada a tela inicial abaixo:

Maiores informações sobre as opções disponíveis no produto Datasul Interactive, consulte o manual de Referência.


5.4.8. Procedimentos

Este capítulo tem por objetivo explicar alguns procedimentos complementares, caso exista necessidade de alguma intervenção manual ou na ocorrência de problemas, como proceder para solucioná-los.

5.4.8.1. Carregando banco de dados Progress Se você selecionou alterar a configuração do arquivo “conmgr.properties” então o banco de dados já está configurado no Progress Explorer como EIP.

Abra o Progress Explorer e carregue o banco de dados clicando no botão :

5.4.8.2. Configurando o Diretório Virtual O Datasul Interactive requer que seja configurado um diretório virtual no WebServer. Veja abaixo como criar o diretório virtual “eip” no IIS 5.0 (Windows 2000)


Tela Inicial

Abra o gerenciador do IIS e clique com o botão direito do mouse em “Site Padrão” / “Default Web Site” e selecione novo “Pasta Virtual” / “Virtual Directory” Clique em Avançar.

Tela Diretório Virtual

Nesta tela informe o nome do diretório virtual para o Datasul Interactive.


Tela Diretório Físico

Informe o diretório raiz onde foi instalado o Datasul Interactive.

Tela Página Padrão

Nas propriedades do diretório virtual informa a página padrão do site: eip/index.htm


5.4.8.3. Carregando serviço WebSpeed

Se você selecionou alterar a configuração do arquivo “ubroker.properties” então os serviços já estão configurados no Progress Explorer como EIP e EIPxxxx, onde xxxx representa o código dos produtos instalados.

Abra o Progress Explorer e carregue o banco de dados clicando no botão :

Observações: a) No serviço EIP verifique se o banco de dados do produto de autenticação está

sendo conectado na linha do agente. b) Se o banco de dados do Datasul Interactive estiver na mesma máquina do

servidor WEB, utilize a conexão via shared-memory usando o arquivo eiphost.pf.

c) Se o banco de dados do Datasul Interactive estiver em máquina diferente do servidor WebSpeed utilize o arquivo eipmult.pf. Segue os passos para alterar o arquivo eiphost.pf para eipmult.pf:

o Copie o arquivo eipmult.pf para o servidor WebSpeed; o Altere o arquivo de service do servidor WebSpeed para contemplar o

serviço do banco de dados do Datasul Interactive. No Progress Explorer Tools:

• edite o serviço WebSpeed EIP; • vá em: Agente – Geral – Parâmetros de inicialização do age nte; • Altere o arquivo eiphost.pf por eipmult.pf • Reinicie o serviço WebSpeed EIP.

a seguir detalharemos as telas para essa alteração:


Altere o arquivo eiphost.pf para eipmult.pf e reinicie o serviço WebSpeed EIP


5.4.8.4. Compreendendo a estrutura do arquivo confi g.xml

As configurações do Datasul Interactive tem como base um arquivo xml localizado no <Diretório de instalação do Produto Datasul Interactive>config\config.xml.

Exemplo:

<EIP> <Product ID="EMS2" Type="EMS2"> <Name>Datasul EMS 2.06B</Name> <Menu>

http://tech- karla/scripts/cgiip.exe/WService=eip_karla/men/men907za.p?USER=%USER%&PASS=%PASS%&PR ODUCT=DT_EMS2&DEPTH=1

</Menu> <Company ID="*">

<Shortcut Description="Local" Path=""c:\dlc91\bin\prowin32.exe" -pf "C:\EMS204_Suporte_v9\ems2.pf" -ininame "C:\EMS204_Suporte_v9\progresc.ini" -p "Men\men906za.w"" />

</Company> </Product> <VirtualDir>eip_karla</VirtualDir> <Host>tech-karla</Host> <ContextURL>

http://eip.datasul.com.br/scripts/cgiip.exe/WService=webdeskeip/wdk/we00011.p?User=datasul </ContextURL> <Program>men/men910za.p</Program> <Language>pt</Language> </EIP>

5.4.8.5. Adicionando um produto manualmente ao Data sul interactive

É possível acrescentar uma nova instalação de produto ao Datasul Interactive manualmente, a seguir são apresentados os procedimentos necessários. As configurações do produto encontram-se no elemento Product ID do arquivo config.xml:

<Product ID="EMS2" Type="EMS2"> <Name>Datasul EMS 2.06B</Name> <Menu>

http://tech- karla/scripts/cgiip.exe/WService=eip_karla/men/men907za.p?USER=%USER%&PASS=%PASS%&PR ODUCT=DT_EMS2&DEPTH=1

</Menu> <Company ID="*">

<Shortcut Description="Local" Path=""c:\dlc91\bin\prowin32.exe" -pf "C:\EMS204_Suporte_v9\ems2.pf" -ininame "C:\EMS204_Suporte_v9\progresc.ini" -p "Men\men906za.w"" />

</Company> </Product>

Descrição dos Elementos referente ao Produto Elementos Valores Product ID Valor de Identificação do Produto

Observação: o conteúdo deverá ser único no arquivo Ex: Ems2-Oficial, Ems5-Teste, Hr

Type Tipo do produto.


Descrição dos Elementos referente ao Produto Elementos Valores

Valores possíveis: EMS2, EMS5, HR, Webdesk, BI, ECS, Dataviewer. Name Nome do produto. Este é o valor que será exibido no menu do

Datasul Interactive. Menu URL utilizado para busca de Menu dos produtos através de um

serviço WebSpeed. Ex: http://[Nome do Host] /scripts/cgiip.exe/WService=[Nome do Servico] /men/men907za.p? – EMS2/HR [Nome do Servico]/prgtec/men/men907za.p? – EMS5 USER=%USER%&PASS=%PASS%&PRODUCT=[Produto Cadastrado] &DEPTH=1 OBS: Substituir os valores entre [] pelos valores correspondentes.

Shortcut Description

Utilizado para a configuração dos atalhos do produto. Dividido em dois atributos:

• Description: Valor exibido na Caixa de escolha de atalho do Datasul Interactive.

• Path: Neste, colocar o caminho do atalho atual do produto. OBS: É necessário que a opção –p seja alterada para:

� EMS2 - [local]\men\men906za.p � Hr - [local]\men\men906za.p � EMS 5 – [local]\prgtec\men\men906za.p

• OBS: Não colocar a opção –param, pois o Datasul Interactive o coloca automaticamente.

Descrição dos Elementos complementares do Arquivo config.xm l Elementos Valores VirtualDir Nome do Diretório Virtual no WebServer utilizado pelo Datasul

Interactive. Host Nome do Servidor onde o Datasul Interactive está instalado. NTLogon Este valor deve ser True caso seja escolhida a opção Autenticação

Integrada com o Windows e False para não. Program Programa utilizado para autenticação do usuário do Datasul

Interactive. Valores: Datasul EMS 2 – men/men910za.p

Datasul EMS5 – prgtec/men/men910za.p Datasul HR - men/men910za.p

Language

Idioma utilizado na sessão do Datasul Interactive. Valores possíveis: PT, EN.

Exemplo de adição do produto Webdesk ao Datasul Interactive (arquivo

config.xml):

... <Product ID="WebDesk" Type="Webdesk" LoginIntegrated="true" Path="http://embau/scripts/cgiip.exe/WService=webdeskeip/wgp/wgp0006.p"> <Name>Webdesk</Name>

</Product>


...

5.4.8.6. Roteiro de verificação de funcionamento Da tasul Interactive

Este roteiro visa apresentar os principais pontos a serem verificados na ocorrência dos erros freqüentes na utilização do Datasul Interactive:

Roteiro de Verificação de funcionamento Datasul Int eractive

Tópico Item analisado Como proceder Resultado (OK/NOK)

01 IIS - Versão Instalada Para identificar a versão IIS utilizada, verifique através do operacional utilizado, opção de painel de controle, opção de Gerenciador de Serviços de Internet, selecione a opção de Ajuda. Na página inicial da documentação do IIS é apresentada a versão instalada. Também é possível executar a documentação do IIS através do browser informando o seguinte caminho: http://localhost/iisHelp/ A versão mínima deverá ser 4.0, caso seja inferior, entre em contado com seu Suporte ao Sistema Operacional para providenciar atualização necessária para o Datasul Interactive.

02 IIS - Funcionamento Para verificar o funcionamento do IIS, via browser Internet Explorer, acesse o seguinte caminho: http://localhost/iisHelp/. Deverá ser apresentado a documentação do IIS, caso contrário, entre em contato com seu Suporte ao Sistema Operacional reportando esta situação.

03 IIS- Pasta Virtual Interactive Execute o IIS, e verifique a existência da pasta virtual informada na instalação (opção de Web Sites). Não identificando a causa, entre e em contato com Suporte Telefônico Datasul, opção


Roteiro de Verificação de funcionamento Datasul Int eractive Tópico Item analisado Como proceder Resultado

(OK/NOK) Aplicativo Tecnologia.

04 Progress Tools - Conexão Base de dados IEP

Execute o programa Progress Explorer Tools (gerenciamento de ferramentas Progress), e verifique na opção de Base de Dados, selecione a base de dados do Datasul Interactive e clique na opção de carregar. Caso não carregue a base de dados, verifique os parâmetros de configuração da base. Dica: Outra sugestão de verificação, é conectar a base de dados não utilizando-se o Progress Explorer Tools. Não identificando a causa, entre e em contato com Suporte Telefônico Datasul, opção Ferramenta Progress.

05 Não apresentação do menu, após login inicial do Datasul Interactive.

Verifique as configurações do arquivo menu.html localizado: 1. Idioma Português: ../pt/html/menu.htm 2. Idioma Inglês: ./en/html/menu.htm. Dica: verifique os diretórios utilizados na execução dos executáveis Java (*.jar). Não identificando a causa, entre e em contato com Suporte Telefônico Datasul, opção Aplicativo Tecnologia.

06 Verificação da criação do driver ODBC da base de dados do Datasul Interactive em SQL utilizando-se da mídia.

Via sistema operacional gráfico, selecione a opção Painel de Controle, opção Ferramentas Administrativas, opção Fontes de Dados (ODBC), folder System DSN. Deverá existir um item para a base de dados do Datasul Interactive.


Roteiro de Verificação de funcionamento Datasul Int eractive Tópico Item analisado Como proceder Resultado

(OK/NOK)

5.5. Instalação Demonstração do Datasul EMS 2.06B


Esta instalação tem por finalidade instalar os bancos de dados demonstração do produto Datasul EMS 2.06B. Esses bancos têm uma licença temporária e utilizados somente para demonstração das funcionalidades do produto. Como pré-requisito para a instalação Demonstração, as instalações “Programas” e “Datasul Interactive” deverão estar instaladas, veja os procedimentos abaixo:

5.5.1. Procedimentos a serem executados antes da In stalação Demonstração:

1) Verificar os requisitos de Software (Progress), capitulo 3. Requisitos; 2) Instalar os programas do Produto Datasul EMS, conforme tipo de instalação

“Programas”; 3) Instalar os programas e bancos de dados do Datasul Interactive (Antes da

instalação verificar os requisitos, capitulo 3. Requisitos, tópico 3.5 Requisitos Datasul Interactive);

5.5.2. Instalação Demonstração A seguir detalharemos as telas da instalação Demonstração:

Tela de Boas Vindas

Essa tela contém informações de copyright e recomendações para execução da instalação. Para continuar, clique em Avançar.



Nessa tela deverá ser digitado o seu nome e a empresa em que você trabalha. Para continuar, clique em Avançar.





Para instalar a demonstração do produto deverá ser selecionado o tipo de Instalação “Demonstração”. Esse tipo de instalação irá configurar o produto Datasul EMS 2.06B para demonstração de suas funcionalidades. Para continuar, clique em Avançar.

Tela Destino do Aplicativo

Na tela Destino do Aplicativo deverá ser informado o diretório de destino do Produto EMS 2.06B, ou seja, onde será baixada a demonstração do produto Datasul EMS 2.06B. Antes de instalar, verifique se possui espaço em disco suficiente. Para continuar, clique em Avançar.

Tela Diretório Progress


Nessa tela deverá ser informado o diretório onde o aplicativo Progress encontra-se instalado. Caso esse aplicativo ainda não esteja instalado, cancele a instalação e providencie a instalação do Progress. Para continuar, clique em Avançar

Tela Alteração dos Serviços

Nesta tela deverá ser informado um número inicial para configuração das portas TCP/IP que serão utilizados na carga dos bancos de dados demonstração do produto Datasul EMS 2.06B. Deve ser verificado se as 30 portas subseqüentes à informada estão livres na tabela de Serviços. Este numero inicial deverá ser o mesmo informado na instalação “Datasul Interactive” Para continuar, clique em Avançar.

Tela Configuração Progress Explorer Tool


A seguir você possui a opção de alterar automaticamente o arquivo “conmgr.properties”. É recomendada a utilização dessa opção, por que essa opção irá configurar automaticamente o aplicativo “Progress Explorer Tool “ para os bancos de dados do EMS. Caso não deseje alterar o arquivo “conmgr.properties”, selecione a opção “Não fazer qualquer modificação”. Caso deseje salvar em outro arquivo, selecione a opção “Salvar as modificações no conmgr.properties.new”, este arquivo será criado no diretório “scripts” da instalação do produto. Para continuar, clique em avançar.


Nesta tela contém as informações digitadas nas telas anteriores. Caso alguma informação esteja incorreta, utilize o botão Voltar e retorne até a mesma para correção. Para iniciar a instalação do produto clique em Avançar.

5.5.3. Procedimentos após a instalação Demonstração :


1) Os bancos de dados devem ser carregados, devido a utilização do Datasul Interactive. Carregue os bancos do datasul EMS com o script ems2startdb.bat criado no <diretório de instalação demonstração>\scripts ou via Progress Explorer Tool (caso tenha selecionado para alterar o arquivo conmgr.properties do Progress na Tela “Progress Explorer Tool” da instalação Demonstração). Não esqueça de carregar o banco eip do “Datasul Interactive”, criado na instalação “Datasul Interactive”. Para isso, existe um script chamado DIstartDB.bat criado na mesma instalação ou utilize o Progress Explorer Tool (caso tenha selecionado para alterar o arquivo conmgr.properties do Progress na Tela “Progress Explorer Tool” da instalação Datasul Interactive).

2) Verifique se os services (Parâmetro -S) criados para os bancos demonstração são

os mesmos que estão no arquivo ems2mult.pf (<diretório de instalalção demonstração>\scripts)e no script de carga dos bancos, ems2startdb.bat (<diretório de instalação demonstração>\scripts) ou no Progress Explorer Tool, atente para a tela “Alteração dos Services” desta instalação.

3) Idem ao item 4 para a instalação do “Datasul Interactive”, os arquivos a serem

verificados são: eipmult.pf (<diretório de instalação Datasul Interactive>\scripts)e DIstartDB.bat (<diretório de instalação Datasul Interactive>\scripts)

4) Após a instalação demonstração, caso tenha solicitado para carregar os bancos

de dados pelo Progress Explorer Tool, é necessário que o Serviço Adimin service do progress seja reiniciado. Para isso utilize a tela de serviços do Windows:

5) Altere o numero inicial de agentes, mínimo de agentes e máximo de agentes nas

propriedades do serviço WebSpeed criado na instalação Datasul Interactive para 1. Siga os procedimentos a seguir:

• Abra o Progress Explorer Tool, em Webspeed clique com o botão direito

do mouse + propriedades do serviço WebSpeed Datasul Interactive. • Em Agente + Intervalo de pooling , altere o Numero inicial de agentes,

Mínimo de agentes e Máximo de agentes para 1 conforme tela a seguir:


• Clique em OK. • Reinicie o serviço WebSpeed Datasul Interactive, para isso clique no botão

“Parar” e após “Iniciar”, veja a tela:


6) Para acessar o Datasul EMS demonstração informe a seguinte URL no Browser “Internet Explorer”, http://<nome-maquina>/diretório-virtual, onde:

� nome-maquina: Nome da maquina local, normalmente pode ser utilizado “localhost”;

� diretório-virtual: Diretório virtual criado na instalação “Datasul Interactive” 7) Usuário e senha para acesso aos bancos demonstração:

� Usuário : demo � senha : demo

8) Segue tela de exemplificando o Datasul EMS demo:


5.6. Instalação Servidor de Aplicação

Esta instalação tem por finalidade baixar os componentes necessários para executar os programas RPC/RPW. Permite você instalar os programas do produto caso não tenha instalado, alterar o arquivo “host” e “sevice” da maquina. A seguir detalharemos a instalação do servidor de aplicação.

Seleção do Idioma


Tela de Boas Vindas









Para instalar o Servidor de Aplicação deverá ser selecionado o tipo de Instalação “Servidor de Aplicação”. Esse tipo de instalação irá baixar os componentes necessários para a execução do programas RPC/RPW do produto Datasul EMS 2.06B. Para continuar, clique em Avançar.

Tela Sistema Operacional

Na tela Sistema Operacional deverá ser selecionado o Sistema Operacional que será instalado o servidor de aplicação. Para instalação em Windows NT/2000 será necessário executar a instalação no próprio servidor. Para instalação em UNIX, poderá ser executado em qualquer estação Windows 9x. Para continuar, clique em Avançar.


� Sistema Operacional Windows NT/2000

Tela Servidor de Aplicação

Nesta tela deverá ser informado o tipo de servidor de aplicação a ser instalado, RPC ou RPW. Clique em avançar para continuar.

RPC

Pergunta

Nesta tela deverá ser informado se os programas do produto já foram baixados ou não.


� Caso os programas já foram instalados:


Nesta tela deverá ser informada a localização dos programas do produto Datasul-EMS 2.06B. Para continuar, clique em Avançar.


Na tela Pasta de Instalação deverá ser informado o diretório de destino dos programas do Servidor de Aplicação, ou seja, onde serão baixados os programas do Servidor de Aplicação. Antes de instalar, verifique se possui espaço em disco suficiente. Para continuar, clique em Avançar.


Tela Diretório do Progress

Deverá ser informado o diretório onde o aplicativo Progress está instalado. Caso esse aplicativo ainda não esteja instalado, cancele a instalação do produto Datasul-EMS 2.06B e providencie a instalação do Progress. Clique em avançar para continuar.

Tela Arquivo de conexão com os bancos(PF)

Nesta tela deverá ser informado o arquivo de conexão com os bancos de dados do produto, ex: ems2mult.pf. Este arquivo não deverá ter os parâmetros -T, -p, -param e -basekey. Para continuar, clique em Avançar.


Tela Appserver

Esta tela serve para a informação de um nome para o serviço Appserver que será criado no Progress Explorer Tool. Para continuar, clique em Avançar.

Tela Modificação de Arquivos

Nesta tela você possui a opção de alterar automaticamente o arquivo “ubroher.properties” de acordo com o nome do serviço appserver informado na tela anterior. Caso não deseje alterar o arquivo “ubroquer.properties”, selecione a opção “Não fazer qualquer modificação”. Caso deseje salvar em outro arquivo, selecione a opção “Salvar as modificações no ubroquer.properties.new”. Para continuar, clique em avançar.



Esta tela contem informações das telas anteriores, caso alguma informação nesta tela esteja incorreta clique em voltar e faça as alterações necessárias. Para continuar clique em avançar.

� Caso os programas do Datasul-EMS 2.06B não foram in stalados:


Nesta tela deverá ser informado o local em que serão instalados os programas do produto Datasul-EMS 2.06B e também os programas do Servidor de Aplicação. Para continuar clique em avançar.



Neta tela deverá ser informada a localização do aplicativo Progress. Caso este aplicativo não tenha sido instalado, providencie a instalação do mesmo. Clique em avançar para continuar.

Tela Arquivo de conexão com os bancos(PF)

Nesta tela deverá ser informado o arquivo de conexão com os bancos de dados do produto. Este arquivo não deverá ter os parâmetros -T, -p, -param e -basekey. Para continuar, clique em Avançar.


Tela Appserver

Esta tela serve para a informação de um nome para o serviço Appserver que será criado no Progress Explorer Tool. Para continuar, clique em Avançar.


Nesta tela você possui a opção de alterar automaticamente o arquivo “ubroher.properties” de acordo com o nome do serviço appserver informado na tela anterior. Caso não deseje alterar o arquivo “ubroquer.properties”, selecione a opção “Não fazer qualquer modificação”. Caso deseje salvar em outro arquivo, selecione a opção “Salvar as modificações no ubroquer.properties.new”. Para continuar, clique em avançar.




RPW

Pergunta

Nesta tela deverá ser informado se os programas do produto já foram baixados ou não.


� Caso os programas já foram instalados:


Nesta tela deverá ser informada a localização dos programas do produto Datasul EMS 2.06B. Para continuar, clique em Avançar.


Na tela Pasta de Instalação deverá ser informado o diretório de destino dos programas do Servidor de Aplicação, ou seja, onde serão baixados os programas do Servidor de Aplicação. Antes de instalar, verifique se possui espaço em disco suficiente. Para continuar, clique em Avançar.



Deverá ser informado o diretório onde o aplicativo Progress está instalado. Caso esse aplicativo ainda não esteja instalado, cancele a instalação do produto Datasul EMS 2.06B e providencie a instalação do Progress. Clique em avançar para continuar.

Tela Servidor de Bancos de Dados

Nesta tela deverá ser informado o nome e endereço IP do servidor onde estão instalados os banco de dados do produto Datasul EMS 2.06B. Clique em avançar para continuar.



Nesta tela você possui a opção de alterar automaticamente o arquivo “hosts” de acordo com as informações da Tela Servidor Banco de Dados. É recomendada a utilização dessa opção. Caso não deseje alterar o arquivo “hosts”, selecione a opção “Não fazer qualquer modificação”. Caso deseje salvar em outro arquivo, selecione a opção “Salvar as modificações no host.new”. Para continuar, clique em avançar.

Tela Alteração de Serviços

Nesta tela deverá ser informado um número inicial para configuração das portas TCP que serão utilizados na carga dos bancos de dados do produto Datasul EMS 2.06B. Deve ser verificado se as 30 portas subseqüentes à informada estão livres na tabela de Serviços. Para continuar, clique em Avançar.




� Caso os programas do Produto Datasul-EMS 2.06B não foram instalados


Nesta tela deverá ser informado o local em que serão instalados os programas do produto Datasul EMS e também os programas do Servidor de Aplicação. Para continuar clique em avançar.



Neta tela deverá ser informada a localização do aplicativo Progress. Caso este aplicativo não tenha sido instalado, providencie a instalação do mesmo. Clique em avançar para continuar.

Tela Servidor de Bancos de Dados




Nesta tela você possui a opção de alterar automaticamente o arquivo “hosts” de acordo com as informações da Tela Servidor Banco de Dados. Caso não deseje alterar o arquivo “hosts”, selecione a opção “Não fazer qualquer modificação”. Caso deseje salvar em outro arquivo, selecione a opção “Salvar as modificações no host.new”. Para continuar, clique em avançar.

Tela Alteração de Serviços




Esta tela contem informações de outras telas, caso possua algum item incorreto nesta tela clique em voltar e faça as devidas alterações. Clique em avançar para continuar.

� Sistema Operacional HPUX

Pergunta

Deverá ser informado se os programas do produto Datasul EMS 2.06B foram instalados ou não.


� Caso os programas do produto Datasul já foram insta lados:

Tela Pasta de Origem dos Programas

Nesta tela deverá ser informada a localização dos programas do produto Datasul EMS 2.06B. Isso é necessário para que seja ajustada a variável “PROPATH”. Clique em avançar para continuar.


Na tela Pasta de instalação deverá ser informado o diretório de destino dos programas do servidor de aplicação. Para esse tipo de instalação, será criado um diretório chamado ftptemp no diretório escolhido. Isso se faz necessário para a transferência dos arquivos via protocolo FTP. Antes de instalar, verifique se possui espaço em disco suficiente no servidor de bancos. Para continuar, clique em Avançar.


Tela diretório do Progress no Unix

Deverá ser informado o diretório de instalação do aplicativo Progress no UNIX.

Tela de Instalação no UNIX

Deverá ser informado o diretório no UNIX onde serão instalados os programas do Servidor de Aplicação no UNIX. Essa instalação é feita através de FTP. Clique em avançar para continuar.


Tela Máquina UNIX

Nesta tela deverá ser informado o nome da maquina(UNIX) e endereço IP da mesma.

Tela Alteração de Serviços no UNIX



Tela Servidor de Banco de Dados





Tela Usuário do Servidor UNIX

Nesta tela deverão ser informados o nome do usuário e sua senha no servidor aplicação. É aconselhável que o usuário seja administrador(root) do servidor. Para continuar, clique em Avançar.


Nesta tela existem informações que correspondem a outras telas, caso encontre alguma irregularidade nesta tela, clique em voltar e faça as alterações necessárias. Clique em avançar para continuar.


� Caso os programas do produto Datasul não foram inst alados:








Tela Máquina UNIX















� Sistema Operacional UNIX-Outros(Sun, Linux, etc)

Pergunta

Deverá ser informado se os programas do produto Datasul EMS 2.06B foram instalados ou não.


� Caso os programas do produto Datasul já foram insta lados:

Tela Pasta de Origem dos Programas

Nesta tela deverá ser informada a localização dos programas do produto Datasul EMS 2.06B. Isso é necessário para que seja ajustada a variável “PROPATH”. Clique em avançar para continuar.









Tela Máquina UNIX















� Caso os programas do produto Datasul não foram inst alados








Tela Máquina UNIX
















5.7. Instalando o Integrator Dentro do diretório onde o EMS foi instalado, na pasta “interfac\integrator”, você deve executar o arquivo executável do produto. O assistente de Instalação do Integrator abrirá, clique em “Avançar” para iniciar a instalação.


Selecione o local onde o Integrator será instalado e clique em “Próximo”.

Os arquivos de instalação serão extraídos para o diretório escolhido.

Selecione os pacotes a serem instalados


Aguarde o Término da progressão do processo de instalação.


Verifique o relatório da instalação apresentado na tela acima.

5.8.1 Licenciando o Integrator


Caso você ainda não tenha solicitado a licença de uso do Integrator, os seguintes passos deverão ser adotados:

• Acesso ao Portal de Clientes Datasul (http://www.datasul.com.br/portal) • No menu escolha a opção Suporte > Solicitação de mídias >

Solicitação de validação • No campo “Produto”, selecionar a opção “Integrator Cliente 1.00 Multi-

idioma” • No campo “IP”, inserir o número IP da máquina que está instalado o

Integrator • Submeter o formulário

Será encaminhada para o cliente após o envio do formulário a chave necessária

para funcionamento do Integrator, que é o arquivo integrator.certs gerado por servidor com base no endereço IP de onde o produto estará instalado. Este arquivo deve ser copiado para a pasta raiz onde o Integrator foi instalado.

Para maiores informações sobre instalação, configuração e utilização do

Integrator, consulte o Integrator HTML Documentation, que está disponível no menu principal do Integrator.


5.9. Inicializando o Aplicativo Datasul-EMS

Nas instalações em modo “Datasul Interactive (Programas)”, é criado um atalho de Inicialização do produto na pasta administrativa localizada no Menu Iniciar. Ao executar esse atalho, será apresentada a seguinte tela:

Este procedimento basicamente importa os menus, mensagens e literais, necessários para o início da operação do aplicativo. Além disso, executa o Otimizador de Performance (maiores detalhes desta função, consultar o manual de referência do produto, função Otimizador de Performance), efetua o registro do produto no arquivo correspondente e cadastra o usuário “super” para acesso ao sistema.


É importante salientar que clientes que não tenham PROGRESS “Full” (com licença de desenvolvimento), devem atentar para os .DFs gerados pelo Otimizador de Performance, abaixo da pasta OP do diretório temporário da sessão, pois será necessário aplicá-los (seguindo o mesmo procedimento de atualização dos pacotes de atualização do produto) no final desta inicialização. Após executar a inicialização, deverá ser adicionada a validação do produto através da execução do programa btb\btb932za.r, conforme tela abaixo:

5.10. Reinstalando É possível reinstalar qualquer um dos componentes básicos (banco de dados, programas,Datasul Interactive, aplicação e demonstração), basta executar novamente o setup localizado no CD-ROM. Levar em consideração algumas recomendações: a) Se o produto já estiver operando, é importante que o diretório de localização da reinstalação do componente banco de dados não seja o mesmo que o utilizado na primeira instalação. Este procedimento evita que dados já incluídos sejam eliminados. Somente sobreponha os arquivos quando tiver certeza do que realmente necessita. b) Se necessita de uma nova instalação, primeiramente remova a instalação do aplicativo (veja capítulo 5) e concluída esta etapa, já será possível a nova instalação. O procedimento de reinstalação que será usado com mais freqüência será a reinstalação de novos programas do aplicativo que foram alterados e corrigidos. Neste caso, basta utilizar o mesmo o setup, para baixar no mesmo diretório dos programas atuais.


6. Remover a Instalação O procedimento para remover a instalação do produto é simples e automático e deve ser utilizado quando não se necessita mais de algum componente em alguma(s) determinada(s) máquina(s). Existem vários exemplos onde esta situação pode ocorrer: eliminar os programas de determinado servidor, eliminar todo o aplicativo de todas as máquinas, etc. Este procedimento sempre deve ser executado na(s) mesma(s) CPU onde foi feita a instalação do aplicativo, por exemplo, para remover o componente banco de dados, use a máquina onde foi instalado este componente. Todos os objetos criados durante a instalação (criação de arquivos, diretórios, atalhos e entradas no registro) são armazenados num arquivo de log de instalação que pode ser utilizado para remover a instalação do produto. Este arquivo encontra-se no diretório de instalação e o nome do arquivo é Uninst xx.isu , onde xx depende do tipo de instalação. Se este arquivo não existir, o procedimento para a remoção da instalação deverá ser manual, eliminando os objetos criados durante a instalação. Para eliminar qualquer componente da instalação proceda da seguinte forma, lembrando que deve ser feito na mesma CPU onde o produto foi instalado:

a) No Windows, clique no botão Iniciar / Configurações / Painel de Controle / Adicionar ou Remover Programas. Será apresentada ao usuário uma tela conforme abaixo:


b) Selecione o componente que deseja eliminar e clique no botão Adicionar/Remover . Logo após, confirme a eliminação do aplicativo.

c) A seguir, será apresentada a tela Desinstalarão concluída informando os objetos que estão sendo eliminados.


Este procedimento não elimina os arquivos criados após a instalação, tais como: arquivos temporários, before-image dos bancos, etc. Verifique o destino destes arquivos e, se for o caso, elimine-os.

6.9. Removendo a Instalação Multiusuário Os componentes da instalação Multiusuário possuem diversos arquivos compartilhados. Quando a instalação desses componentes é feita em uma mesma máquina, a remoção de qualquer um deles eliminará os arquivos compartilhados, o que prejudicará os componentes restantes. Para evitar problemas, uma das opções abaixo deve ser utilizada:

a) Eliminar todos os componentes instalados na máquina.

b) Após a remoção de um ou mais componentes, os restantes devem ser reinstalados.

7. Atualização de Programas Depois que o produto já estiver em operação a Datasul disponibilizará pacotes de atualização do produto englobando alteração para correção de erros, correções legais e


novas implementações. Estes pacotes de atualização periodicamente são incorporados a mídia de instalação. Enquanto não são incorporados à mídia, os pacotes são copiados para o diretório “patches” em formato .zip. A mídia de instalação também pode ser utilizada para atualização de programas, primeiramente você deverá executar o setup.exe e fazer uma instalação Multiusuário / Programas informando o diretório destino como sendo o diretório onde os programas residem atualmente no servidor de arquivos, com isso os pacotes de atualização são baixados automaticamente com versões mais recentes de programas. Finalmente você deverá buscar no site ECS da Datasul os novos pacotes disponibilizados (www.datasul.com.br/expedicao). As atualizações automáticas de pacotes estão disponíveis para as instalações Programa e também conversão.

8. Instalando o Produto em WEB Este capítulo descreve os procedimentos para instalação do produto EMS2 para WEB. Somente o EMS2, a partir da release 2.02 está disponível para WEB, portanto os produtos EMS5 e HCM não estão disponíveis. Vale ressaltar que nem todas as transações do ambiente client-server estão disponíveis para WEB.

8.9. Requisitos Para este tipo de instalação são necessários os seguintes requisitos de software, hardware e de conhecimento:

8.9.1. Produto EMS 2 Instalado

É necessário que o produto EMS2 esteja instalado e funcional na versão client-server. Os primeiros capítulos deste documento tratam deste procedimento. 8.9.2. WebServer Instalado É necessário que o servidor WEB esteja operacional. O software de servidor WEB pode ser o IIS (Internet Information Services) da Microsoft ou o Apache (http://apache.org, que pode ser obtido gratuitamente).

8.9.3. WebSpeed Instalado

É necessário que a licença WEBSpeed esteja instalada. A versão do WEBServer deve ser compatível com a versão do WEBSpeed, consulte a documentação de instalação do WEBSpeed para verificar as compatibilidades. É recomendado que os servidores WEBSpeed e WEBServer estejam instalados separadamente dos servidores de banco de dados, de aplicação e de arquivos.


8.9.4. Browser Instalado

Cada estação de usuário requer um browser WEB instalado para acessar o produto. Verifique o item de requisitos do produto.

8.9.4.1. Conhecimento em arquitetura Web

A instalação do produto em ambiente WEB requer conhecimentos em instalação, configuração e arquitetura dos serviços WEB. Também requer conhecimento em administração dos serviços WEBSpeed, por exemplo, o utilitário “Progress Explorer Tool”, e os componentes da arquitetura WEBSpeed (agentes, broker, nameserver, adminserver, messenger). Caso tenha dúvidas, consulte o manual de instalação do WEBSpeed.

8.10. Etapas de instalação do produto em Web Alguns dos procedimentos abaixo estão sendo repetidos a fim de ressaltá-los, pois já foram descritos no item de requisitos deste documento.

8.10.1. Instalação do Datasul EMS2 client-server

Realize a instalação do produto EMS2 de acordo com os procedimentos descritos nos primeiros capítulos deste documento. Os componentes: Banco de dados , Programa e Datasul Interactive são obrigatórios. Caso seja uma instalação nova, isto é, as bases não sofreram processo de conversão, é preciso que estas sejam inicializadas. Caso tenha dúvidas, verifique o item 5.8. Inicializando o Aplicativo Datasul-EMS .

8.10.2. Instalação do WebServer

Realize a instalação e configuração do servidor WEB de acordo com o item 3.5.3.3 Requisito para Servidor WEB . Após a instalação, verifique se o serviço WEB está funcionando corretamente informando no browser WEB a URL http://localhost. Deverá aparecer uma página WEB de bem-vindo ao IIS.

8.10.3. Instalação do WebSpeed Realize a instalação e configuração do servidor WEBSpeed de acordo com o item 3.5.3.3 Requisito para Servidor WEB .

8.10.4. Diretório de programas do EMSWEB

Os objetos que são necessários para o componente WEB do EMS são os mesmos do diretório de programas baixados durante a instalação da área de programas na instalação client-server. Se houver necessidade os arquivos desta área podem ser copiados para uma área no servidor WEB. Em conseqüência, todas as atualizações de programas do produto devem ser aplicadas para esta área também.


8.10.5. Criação do alias “ems20web” no servidor WEB

No servidor WEB, seja o IIS (Internet Information Services) ou o Apache, crie um alias chamado “ems20web”. O alias é um nome que os browsers WEB utilizam para acesso facilitado a um determinado diretório. Na criação do alias deve ser informado o subdiretório “web” da área de programas do produto. No IIS o alias é criado pelo aplicativo “Gerenciador do Internet Services” e no Apache é criado no arquivo httpd.conf. Caso tenha dúvidas, acesse a documentação do software para realizar esta configuração. Verifique se o alias foi criado corretamente informando no browser WEB a URL http://meuservidor/ems20web/wimages/doc.gif, onde deve aparecer a figura wimages/doc.gif. Caso apareça uma mensagem de arquivo não encontrado (erro 404) a configuração do alias não foi bem sucedida.

8.10.6. Serviço AdminService

Após realizar o procedimento do item 8.2.3. Instalação do software WEBSpeed , o serviço AdminService é criado automaticamente. Acesse o gerenciador de serviços do Windows, selecione o serviço AdminService e clique nos botões Iniciar Serviço ou Interromper Serviço . Em ambiente Unix o serviço é carregado pelo script proadsv localizado no subdiretório bin do Progress. Utilize o parâmetro –start para iniciar e –stop para interromper o serviço. Digitando apenas proadsv , é possível visualizar as opções de parâmetros para este comando. Configure para que este serviço seja iniciado automaticamente com o sistema operacional. OBS: Caso os programas do produto não estejam no mesmo servidor onde está configurado o WEBSpeed, é recomendável configurar o AdminService com um usuário e senha que possua permissão de acesso à área de programas da rede.

8.10.7. NameServer

Com o serviço AdminService carregado é possível administrar o servidor através de uma estação (ou pelo próprio servidor, se este for Windows) usando a ferramenta Progress Explorer Tool . Esta ferramenta é disponibilizada durante a instalação de qualquer produto Progress em ambiente Windows e este produto deve ter a mesma versão que o Progress no servidor. Acesse a ferramenta, adicione o servidor a ser administrado e verifique se existe ao menos um NameServer (NS1) criado, iniciado e configurado para que a inicialização seja automática. O NameServer controla um conjunto de Brokers WEBspeed registrados.

8.10.8. Criação do broker “emsweb” no WEBSpeed

A configuração do broker é feita no Progress Explorer Tool. Verifique se já existe um servidor “localhost” abaixo de “Console Root → Progress Explorer”. Caso contrário, clique com o botão direito no ícone “Progress Explorer” e selecione “Adicionar Servidor Progress...”.


Informe o nome ou IP do servidor local ou remoto e o usuário. A senha pode ser salva para que a conexão ao servidor seja feita de forma automática quando acessado o Proexp. Clique com o botão direito sobre o ícone do servidor e selecione “Conectar...”. O ícone indicador deverá mudar, apontando que o servidor está conectado. Expanda a pasta do servidor e a pasta WEBSpeed. O broker wsbroker1 já deve estar criado e pré-configurado. Crie um novo broker chamado emsweb , lembrando que este nome será utilizado na URL do aplicativo, portanto, será case-sensitive (diferenciação entre maiúsculo e minúsculo).

Acesse as propriedades do broker criado e expanda os dois níveis (Broker e Agente) para visualizar as opções de configuração do broker. Realize a configuração do Broker e do Agente de acordo com as informações abaixo:

• Broker / Geral / Modo Operacional: Stateless


• Broker / Geral / Inicialização Automática: Sim

• Broker / Geral / Diretório de trabalho: Diretório de programas do EMS2

• Inicialização automática

• Agente / Geral / Parâmetros de Inicialização do Agente: -p web/objects/web-disp.p -weblogerror -cpterm iso8859-1 -cpstream ibm850 –pf <Nome_pf_conexão_bancos>.pf

• Agente / Geral / PROPATH: Diretório de programas do EMS2

• Modo de aplicação do agente: Produção


8.10.9. Configuração de broker com bancos unificado s

Para o EMSWeb com bancos unificados é necessário criar um novo programa de alias diferente do utilizado para acesso ao produto. O programa de alias deve ser configurado para chamar o programa "web\objects\web-disp.p" conforme exemplo abaixo: /* * * * * * * * * * * * * * * A l i a s * * * * * * * * * * * * * * * * */ / * * * * * * * * * * * Bancos de cadastro * * * * * * * * * * * */ CREATE ALIAS mgadm FOR DATABASE mgcad. CREATE ALIAS ... / * * * * * * * * * * * Bancos de movimento * * * * * * * * * * / CREATE ALIAS movadm FOR DATABASE mgmov. CREATE ALIAS ... run web\objects\web-disp.p. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ Acesse as propriedades do broker criado e expanda o nível "Agente" para visualizar suas opções de configuração. No campo "Parâmetros de inicialização do agente", altere o valor do parâmetro (-p) para o caminho e nome do arquivo de alias. Veja a figura abaixo:


8.10.10. Acesso ao EMSWEB através do navegador

No navegador digite a URL de acesso ao produto. Seguem alguns exemplos: Caso esteja usando Messenger WSISA a URL é: http://servidor/scripts/wsisa.dll/WService=emsweb/web/btb/wbtb910.w Caso esteja usando Messenger CGIIP em servidor Unix a URL é: http://servidor/cgi-bin/wspd_cgi.sh/WService=emsweb/web/btb/wbtb910.w E caso esteja usando Messenger CGIIP em servidor Windows a URL é: http://servidor/scripts/cgiip.exe/WService=emsweb/web/btb/wbtb910.w Estas URLs podem ser diferentes pois depende da instalação do Messenger. Verifique a documentação da instalação do WebSpeed. Utilize o recurso do browser “Adicionar a Favoritos” e inclua a URL nos seus favoritos para facilitar o acesso ao produto.

8.2.11. Acesso aos Manuais de referência para o produto EMS WEB Para que os manuais de referência do produto (“Ajuda”) sejam acessados com sucesso, é necessário a criação do diretório virtual “help20”, onde o caminho físico informado deve ser a estrutura de arquivos (física) até o subdiretório "dochtm" (subdiretório onde foram baixados os arquivos de "Ajuda" do produto)


Documents

Guia de Instalacao Datasul Ems 2.06b-Oe10