Вы находитесь на странице: 1из 157

Guia de Instalao DATASUL EMS 2.

06B OpenEdge 10

Programas Banco de Dados Datasul Interactive WEB Servidor de Aplicao Demonstrao

ndice
1. Prefcio....................................................................................................................................................... 4 1.1. 1.2. 1.3. 1.4. 2. Finalidade..................................................................................................................... 4 Pblico Alvo ................................................................................................................. 4 Organizao deste Guia................................................................................................. 4 Outras Documentaes Importantes .............................................................................. 5

Introduo................................................................................................................................................... 6 2.1. 2.2. 2.3. Arquitetura Distribuda do produto ................................................................................ 6 Tipos de Instalao ...................................................................................................... 7 Alertas Durante a Instalao ......................................................................................... 7

3.

Requisitos ................................................................................................................................................... 9 3.1. Requisitos de Hardware................................................................................................ 9 3.1.1. Requisitos para instalao da rea de Trabalho (Cliente) .......................................... 9 3.1.2. Requisitos para outros Tipos de Instalao ............................................................. 11 3.1.3. Rede ....................................................................................................................... 11 3.1.4. Recomendaes Gerais .......................................................................................... 12 3.2. Requisitos de Software ............................................................................................... 12 3.2.1. Progress ................................................................................................................. 12 3.2.2. Converso .............................................................................................................. 14 3.3. Requisitos de Usurio (Servidor) ................................................................................ 14

3.4. Requisitos Datasul Interactive ..................................................................................... 15 3.4.1. Requisito para Instalao PROGRESS ................................................................... 15 3.5.2. Requisito para Instalao ORACLE ......................................................................... 16 3.5.2.2. Requisito para rea de Trabalho (Cliente) ........................................................... 16 3.5.3. Requisito para Instalao 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 Mdias de Instalao ............................................................................................................ 20 4.1. 4.2. 5. Disco 1 ....................................................................................................................... 20 Disco 2 e 3 ................................................................................................................. 20

Instalao .................................................................................................................................................. 21 5.1. 5.2. Planejando a Instalao.............................................................................................. 21 Instalao de Programas Datasul-EMS....................................................................... 22

5.3. Bancos de Dados ....................................................................................................... 28 5.3.1 Criao 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 definies ................................................................................................. 30 5.3.2.1. Importando definies em Progress .......................................................................... 30

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

5.3.2.2. Importando definies em Oracle ............................................................................. 31 5.3.2.3. Importando definies 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. Instalao Datasul Interactive ..................................................................................... 34 5.4.1. Instalao Banco de Dados Datasul Interactive ....................................................... 38 5.4.2. Instalao Programas Datasul Interactive................................................................ 46 5.4.3. Configurando Servio do Apache Tomcat ................................................................ 57 5.4.4. Deploy Automtico .................................................................................................. 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. 5.6. Instalao Demonstrao do Datasul EMS 2.06B ....................................................... 93 Instalao Servidor de Aplicao ...............................................................................102

5.7. Instalando o Integrator ...............................................................................................140 5.8.1 Licenciando o Integrator ..............................................................................................143 5.9. 5.10. 6. Inicializando o Aplicativo Datasul-EMS ......................................................................145 Reinstalando .............................................................................................................146

Remover a Instalao ............................................................................................................................. 147 6.9. Removendo a Instalao Multiusurio .......................................................................149

7. 8.

Atualizao de Programas ...................................................................................................................... 149 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 instalao do produto em Web ..................................................................151 8.10.1. Instalao do Datasul EMS2 client-server ...........................................................151 8.10.2. Instalao do WebServer ....................................................................................151 8.10.3. Instalao do WebSpeed ....................................................................................151 8.10.4. Diretrio de programas do EMSWEB ..................................................................151 8.10.5. Criao do alias ems20web no servidor WEB ...................................................152 8.10.6. Servio AdminService .........................................................................................152 8.10.7. NameServer .......................................................................................................152 8.10.8. Criao do broker emsweb no WEBSpeed .......................................................152 8.10.10. Acesso ao EMSWEB atravs do navegador........................................................156 8.2.11. Acesso aos Manuais de referncia para o produto EMSWEB ...................................156

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

1. Prefcio
1.1. Finalidade

Este guia tem como finalidade, descrever de forma objetiva, passo a passo, todos os procedimentos necessrios para a instalao do produto Datasul-EMS 2.06B, bem como configurar o produto nas plataformas suportadas. A mdia de instalao tambm poder ser utilizada para atualizao de programas.

1.2.

Pblico Alvo

Como o processo de instalao do produto no complexo, a instalao monousurio e demonstrao podem ser feitas por pessoas com pouca experincia em informtica. J a instalao multiusurio, requer pessoas que tenham conhecimentos de ambiente de rede.

1.3.

Organizao deste Guia

Captulo 2, Introduo Este captulo apresenta uma viso geral da arquitetura distribuda, tipos de instalao e exemplos de topologias no uso do produto. Captulo 3, Requisitos Este captulo apresenta a lista de requisitos de hardware e software exigidos na instalao do produto. Captulo 4, Detalhes das Mdias de Instalao Este capitulo descreve os detalhes de todos os discos de instalao do produto DATASUL. Captulo 5, Instalao Este captulo descreve os procedimentos que devero ser executados para a instalao do produto. Abrange desde o planejamento da instalao, ou seja, escolher o tipo de instalao adequado, at a reinstalao do produto. Captulo 6, Remover a Instalao Este captulo apresenta os procedimentos para remover a instalao do produto. Captulo 7, Atualizao de Programas Este captulo mostra como a mdia de instalao poder ser utilizada para atualizao de programas. Captulo 8, Instalando o Produto em WEB Este captulo apresenta a instalao do produto DATASUL EMS 2.06B em Web.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

1.4.

Outras Documentaes Importantes

Informaes 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 documentaes podero ser encontradas em http://www.progress.com/products/documentation

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

2. Introduo
2.1. Arquitetura Distribuda do produto

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

Ambiente do Cliente Servidor de Aplicao Servidor de Arquivos

Rede TCP/IP

Usurios

Servidor de Banco de Dados

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

2.2.

Tipos de Instalao

Existe um tipo bsico de instalao: Multiusurio. Multiusurio - Uma instalao multiusurio deve ser escolhida quando o produto for utilizado em ambientes corporativos no qual o produto poder ser acessado atravs de vrias mquinas e usurios. Para que o produto seja utilizado em ambiente multiusurio, so necessrios quatro componentes que so: Servidor de Banco de Dados, Servidor de Arquivos, Servidor de Aplicao e Datasul Interactive.. Servidor de Banco de Dados - Na mquina onde reside o servidor de banco de dados, estaro os bancos de dados e as scripts para carga e descarga destes bancos de dados. Servidor de Arquivos - Na mquina onde reside o servidor de arquivos, estaro os programas criptografados, compilados e outros arquivos necessrios para execuo do produto. Servidor de Aplicao - Este componente opcional e visa basicamente melhorar a performance. Na mquina onde reside o servidor de aplicao, estaro os programas criptografados e compilados que podero ser executados remotamente. Geralmente programas de relatrios e clculos. Datasul Interactive - Interface Web de onde os programas sero executados. Demonstrao Bancos de dados demonstrao do Produto

Para a comunicao entre todos estes componentes, necessrio que os servios adequados de rede TCP/IP estejam funcionando corretamente.

2.3.

Alertas Durante a Instalao

Durante a instalao dos produtos Datasul podem ser apresentados alertas para clientes que usam determinados anti-vrus (Ex: Avast, BitDefender e Antivir Guard), acusando a identificao de vrus nos arquivos dos diretrios "OCX" e "Interfac". Isso ocorre em funo dos arquivos executarem rotinas que alguns anti-vrus identificam como vrus. No entanto, no se caracterizam instrues deste tipo. Desta forma, a mensagem apresentada pode ser desconsiderada. Arquivos que so desconsiderados como vrus: 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 Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10
7

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

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

3. Requisitos
Este captulo tem por objetivo divulgar recomendaes sobre o uso de hardware e software relacionados ao Datasul-EMS Framework (2, 5 e HR), e algumas informaes sobre configurao dos mesmos. Estas recomendaes tm por inteno ajudar nossos clientes na configurao do seu ambiente utilizando-o ao mximo, obtendo uma melhor relao custo/benefcio. Porm no representam compromissos com tecnologias ou algum fornecedor em especial por parte da DATASUL. A deciso sobre a tecnologia e fornecedor de competncia do cliente, bem como o nvel de servio, segurana e confiabilidade que deseja do seu ambiente. As posies deste relatrio tambm podem ser alteradas, isto devido evoluo 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 configurao 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 recomendaes e exemplos citados abaixo levam em considerao somente o uso do Datasul-EMS e outros softwares de uso genrico (Office e E-mail). No caso de instalao de outros softwares no mesmo ambiente (que no sejam ligados ao Datasul-EMS) importante levar isto em considerao, pois as recomendaes e exemplos abaixo podem no ser suficientes. Se o objetivo desta instalao converso do produto, existe a necessidade de criar uma rea de trabalho para acesso ao EMS Destino, pois, no possvel utilizar o Datasul Interactive para realizar a migrao dos dados. Para tanto, preciso realizar uma cpia dos arquivos do EMS Origem (Multiusurio): atalho, arquivo de inicializao (.ini) e arquivos de parmetros (.pf). O arquivo de inicializao (.ini) deve ser configurado com as propriedades (Exemplo: PROPATH) do EMS Destino e do Progress a ser utilizado. O arquivo de parmetros (.pf) precisa ser configurado com os parmetros de acordo com a carga dos bancos do EMS Destino. Por fim, nas propriedades do atalho, informe o novo arquivo de parmetros e o de inicializao juntamente com o parmetro -p _admin.p ao final da linha de comando. Observao: Para este tipo de procedimento (migrao), o EMS Destino no pode ser inicializado.

3.1.

Requisitos de Hardware

3.1.1. Requisitos para instalao da rea de Trabalho (Cliente) necessrio que a estao 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 verses do Windows que esto homologadas para o OpenEdge 10.1A: Windows XP Professional Windows Service Pack 2 WinXP SP2

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

Windows 2000 Professional SP4 Windows 2000 Server SP4 Windows Server 2003 Standard (SP1) Windows Server 2003 Enterprise (SP1) Windows Server 2003 R2 Maiores informaes podem ser obtidas do site da Progress:
http://www.progress.com/openedge/products/lifecycle/index.ssp

1. Recomenda-se a seguinte configurao para uma boa performance, no caso de instalao de PCs como estao de trabalho (Fat Client):

Recomendada Processador Cache Interno Memria Disco Placa Rede Vdeo Pentium III 500 Mhz 512 Kb 128 Mb 10 Gb 10/100 Mbits SVGA (800 x 600)

Obs.: Essas recomendaes se aplicam a ambiente e tecnologias atuais, no considerando, portanto, o nmero de meses estipulado no dimensionamento. 2. Datasul-EMS at pode ser executado em estaes com menos memria (16 Mb), ou uma CPU menos potente, entretanto a performance estaria muito abaixo do aceitvel. No recomendamos o uso de estaes menores que o mnimo pois a performance no atender as necessidades dos usurios em nenhum caso. Caso a sua empresa possua muitas estaes com configuraes inferiores a mnima recomendada, sugerimos utilizar o recurso de Servidores de Terminais Grficos que ir utilizar este hardware j existente. 3. A configurao recomendada atende a maioria dos usurios, contudo para usurios mais exigentes talvez exista a necessidade de uma configurao melhor. Compreende-se por usurio mais exigente aquele que utilize processos mais pesados (necessidade de uma CPU melhor e uma placa de rede mais rpida e/ou ligada em uma porta de switcher dedicada para ele) ou de um usurio que use vrias aplicaes simultneas (necessidade de mais memria para executar processos como Office, Email, CAD, EIS, etc. ao mesmo tempo). 4. Recomendamos a ltima configurao para novos equipamentos, caso a empresa venha adquirir novas estaes e queira utiliz-las por um longo tempo sem necessidade de upgrade e sem ficarem obsoletos. Tambm foram levadas em considerao quais as configuraes que os fornecedores de hardware esto oferecendo atualmente, e que tenham uma boa relao custo/benefcio. 5. No caso das placas de rede recomenda-se comprar placas de fornecedores de primeira linha (Ex.: 3COM, Cabletron, outros). Isto porque estas placas so mais

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

10

performticas, tem drivers suportados pela Microsoft, e tem muitos menos problemas de compatibilidade. Ou seja, a confiabilidade, performance e qualidade so muito mais altas, com um acrscimo muito pequeno de custo. 3.1.2. Requisitos para outros Tipos de Instalao Para outros tipos de instalao como Servidor de Aplicao, Banco de Dados e Programas sugerimos fazer um servio de SIZING. Para maiores informaes sobre esse servio entre em contato com o suporte Tecnologia pelo telefone (47) 2101-7400 ou pelo e-mail servicos_tecnologia@datasul.com.br . 3.1.3. Rede 1. No recomendamos mais de 12 estaes no mesmo segmento de rede (HUB), devido aos problemas de coliso. Recomenda-se o uso de switchers para segmentar a rede. No caso de usurios mais exigentes recomenda-se dedicar uma porta do switcher para o mesmo (Na estao deste usurio tambm dever ser utilizada uma placa de rede de melhor qualidade e performance, no sendo assim um gargalo). 2. Recomenda-se que os servidores utilizem placas de alta velocidade (100 Mbits ou mais), conforme tecnologias existentes abaixo: Velocidade (Mbits) Nomin Real al 100 60 100 100 155/62 2 1000 100 100 155/62 2 600

Tecnologia Fast Ethernet 100 VG FDDI ATM Gigabit Ethernet

Custo Baixo Mdio Mdio Alto Alto

Confiabilida Padronizao de Normal Normal Alta Alta Alta OK OK/No adotado OK OK/No utilizado OK

Utilizao Servidores Servidores Servidores/Backbo nes Servidores/Backbo nes Backbones

3. A tecnologia Fast Ethernet padro e foi adotada por vrios fornecedores, contudo tem uma perda de 40% de eficincia devido a sua arquitetura possuir coliso de pacotes. A tecnologia 100VG foi desenvolvida e padronizada sob liderana da HP, contudo poucos fornecedores adotaram este padro, ele tem como vantagem no ter problema de coliso de pacotes, mas tem um custo mais elevado. A tecnologia FDDI relativamente antiga, tem um padro que utilizado por quase todos fornecedores, contudo tem um custo ainda alto. A tecnologia ATM relativamente nova, recentemente foi homologado um padro, mas neste momento nem todos os fornecedores adotam este padro (pode assim haver problemas de compatibilidade entre fornecedores diferentes). Gigabit Ethernet a tecnologia mais nova, contudo ainda cara e somente recomendvel para ligar dois ou mais backbones diferentes.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

11

4. Entre todas, a tecnologia FDDI a que tem um preo razovel, fcil de instalar, confivel, pode ser instalada em servidores e para ligao de backbones e tem um padro de fato (o que muito til, caso se deseje trabalhar com fornecedores diferentes). Isto serve como regra geral, porm no caso de altssimos 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 tambm (Fast Ethernet/100 VG). 5. No 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 no utilizaria os outros recursos da rede adequadamente e afetaria a performance. 6. Para instalaes de mdio e grande porte (acima de 100 estaes na mesma rea fsica) recomendamos a utilizao de chassis. Na compra deste chassis deve ser levado em considerao a velocidade do backplane (maior do que 5 Gbits/seg.) e do nmero de pacotes que ele pode processar por segundo (> 750.000). 3.1.4. Recomendaes Gerais 1. Pode-se utilizar o ambiente Novell para servidor de arquivos e impresso, porm ocorrero problemas quando forem utilizados arquivos com mais de 8 (oito) caracteres. Como servidor de banco de dados necessrio utilizar plataforma Windows Server ou Unix, e para o Terminal Server somente o Windows Server. 2. Adquira modelos de servidores com a configurao recomendada e que permitam ampliao futura. Mesmo existindo uma pequena margem de erro, deve haver a possibilidade de ampliao futura de disco, memria e processamento. 3. Procurar adquirir servidores e equipamentos de rede de fornecedores de primeira linha e que tenham assistncia tcnica na sua regio. Confiabilidade e uma boa assistncia tcnica so mais importantes do que preo, devido ao grau de dependncia em relao a estes equipamentos.

3.2.

Requisitos de Software

3.2.1. Progress 1. Na compra do PROGRESS verifique se voc produtos: Produto SO OpenEdge Enterprise Plataforma Windows RDBMS Server / Unix adquiriu no mnimo os seguintes Observao Para cada servidor onde exista algum banco de dados PROGRESS de teste ou produo instalado, ou ento a licena de dataserver em cada usurio que se conecta a algum banco de dados atravs de Dataserver Oracle ou Dataserver SQL Server Licenas correspondentes ao nmero de usurios concorrentes dos aplicativos Datasul

Client Networking

Windows XP/2000 ou superior

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

12

Query/Results OpenEdge Application Server Enterprise Edition

Windows XP/2000 ou superior Plataforma Windows Server / Unix

Utilizado para a compilao de relatrios desenvolvidos pelo Dataviewer ou Results Para o SO onde est o servidor de transaes WEB

2. No caso de ter adquirido o Progress embutido em algum produto Datasul, verifique se as licenas foram recebidas e instaladas adequadamente. 3. O uso do Application Server imprescindvel para uma boa performance do ambiente. Este software tem por objetivo rodar processos remotos (RPC) disparados nas estaes clientes pelos usurios. Caso ele no esteja instalado o Datasul-EMS funciona, contudo no com a mesma performance pois os processos vo rodar na estao, usando uma mquina menor que o servidor e com grande trfego 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 parmetros padro. Existe necessidade de ser feito um ajuste para o seu ambiente (em funo dos volumes previstos e recursos disponveis) para uma boa performance. Depois de alguns meses necessrio fazer novos ajustes para os volumes reais, bem como uma reorganizao dos dados.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

13

3.2.2. Converso Segue abaixo tabela com relao converso de releases dos produtos DATASUL. Esta tabela contempla as releases dos produtos DATASUL com suas respectivas converses. Antes de iniciar o processo de converso necessrio adicionar o parmetro E na sesso dos produtos Datasul para o pas Brasil. Este parmetro j existe nos arquivos de configurao criados durante a instalao, mas caso tenha sido excludo dever ser novamente adicionado antes da converso.
Destino Datasul-HCM 2.08 Datasul-HCM 2.09 X X Datasul-HCM 2.10 14 Datasul-EMS 2.02 Datasul-EMS 2.04 Datasul-EMS 2.06 Datasul-EMS 5.01 Datasul-EMS 5.02 Datasul-EMS 5.03 Datasul-EMS 5.04 Datasul-EMS 5.05 Datasul-EMS 5.06 X X X Datasul-HCM2.06

Origem Datasul-EMS 2.00 Datasul-EMS 2.01 Datasul-EMS 2.02 Datasul-EMS 2.04 Datasul-EMS 5.00 Datasul-EMS 5.01 Datasul-EMS 5.02 Datasul-EMS 5.03 Datasul-EMS 5.04 Datasul-EMS 5.05 Datasul-HCM 2.05 Datasul-HCM 2.06 Datasul-HCM 2.08 Datasul-HCM 2.09

X X X X X X X X X X

3.3.

Requisitos de Usurio (Servidor)

Recomendamos que a instalao dos produtos Datasul seja efetuada com o usurio ADMINISTRADOR, ou com algum usurio que esteja incluso no grupo de administradores do servidor.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

3.4.

Requisitos Datasul Interactive

Este captulo tem por objetivo indicar os requisitos de softwares relacionados ao Datasul Interactive. Estes requisitos so complementares aos requisitos e recomendaes dos produtos Datasul j existentes.

3.4.1. Requisito para Instalao PROGRESS


3.4.1.1. Requisito de Produto Datasul

Os produtos Datasul que integram-se com o Datasul Interactive so: 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 instalao 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 verso 1.4 ou superior. Esta verso de Java j instalada com o Progress10. Tambm disponvel na mdia dos produtos Datasul. Progress 10.0B ou release superior (Licena Mnima: Client Networking). Acesso internet (HTTP) para a visualizao do contedo Datasul Interactive. Observao: algumas empresas possuem controles de acesso dos usurios a Internet, uma sugesto para permitir o acesso ao Datasul Interactive, liberar o acesso ao endereo 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 instalao do Datasul Interactive ir executar a instalao do Apache Tomcat caso o seu sistema no 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;

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

15

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 (Licena mnima: OE Workgroup RDBMS ou OE Enterprise RDBMS).

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

3.5.2. Requisito para Instalao ORACLE


3.5.2.1. Requisito de Produto Datasul

Os produtos Datasul que integram-se com o Datasul Interactive so: 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.5.2.2. Requisito para rea de Trabalho (Cliente)

Adobe Flash Player 9. Baixe a instalao gratuitamente em: http://www.adobe.com/shockwave/download/download.cgi?P1_Prod_Version=Sho ckwaveFlash&promoid=BIOW Oracle Client (estar na mesma verso do Oracle server); Progress 10.0B ou superior (Licena mnima: Client Network); Microsoft Internet Explorer 5.5 ou release superior; Java Runtime Environment verso 1.4 ou superior. Esta verso de Java j instalada com o Progress10. Tambm disponvel na mdia dos produtos Datasul; Acesso internet (HTTP) para a visualizao do contedo Datasul Interactive. Observao: algumas empresas possuem controles de acesso dos usurios a Internet, uma sugesto para permitir o acesso ao Datasul Interactive, liberar o acesso ao endereo eip.datasul.com.br; Acesso aos produtos Datasul a serem integrados ao Datasul Interactive;

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

16

Tambm se faz necessrio configurar o produto Oracle SQL Net nas estaes dos usurios. A nica restrio a esta configurao que o idioma de instalao das estaes seja ingls. O nome do servio deve ser nico para todas as estaes. 3.5.2.3. Requisito para Servidor WEB

Apache Tomcat 5.5.23. A instalao do Datasul Interactive ir executar a instalao do Apache Tomcat caso o seu sistema no possua este software; 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/ 3.5.2.4. Requisito para Servidor de Banco de Dados

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 mquina servidora de banco o Listener para o SQL Net deve estar instalado e configurado; DB_BLOCK_SIZE. necessrio que o tamanho do bloco da instncia Oracle seja no mnimo de 4k (4096 bytes). Caso a instncia 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' Parmetro OPEN_CURSORS. Deve possuir um valor maior que 2000. Para verificar o valor do parmetro, execute a seguinte consulta conectado ao banco Oracle: select name, value from v$parameter where name = 'open_cursors' Caso seja necessrio, altere o arquivo init.ora e reestarte o banco.

Cdigo de pgina do banco. Obrigatoriamente o cdigo de pgina do banco deve possuir o valor WE8ISO8859P1 . Para verificar o valor deste parmetro proceda com a seguinte consulta : select parameter, value from nls_database_parameters where parameter = 'NLS_CHARACTERSET' Caso o valor deste parmetro no seja este, a instncia dever ser recriada. Este parmetro somente informado durante a criao do banco, desta forma no existe maneira de alter-lo sem recriar.

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/

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

17

3.5.3. Requisito para Instalao SQL


3.5.3.1. Requisito de Produto Datasul

Os produtos Datasul que integram-se com o Datasul Interactive so: 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.5.3.2. Requisito para rea de Trabalho (Cliente)

Adobe Flash Player 9. Baixe a instalao 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 verso 1.4 ou superior. Esta verso de Java j instalada com o Progress10. Tambm disponvel na mdia dos produtos Datasul. Progress 10.0B ou release superior (Licena Mnima: Client Networking). Acesso internet (HTTP) para a visualizao do contedo Datasul Interactive. Observao: algumas empresas possuem controles de acesso dos usurios a Internet, uma sugesto para permitir o acesso ao Datasul Interactive, liberar o acesso ao endereo eip.datasul.com.br. Acesso aos produtos Datasul a serem integrados ao Datasul Interactive. 3.5.3.3. Requisito para Servidor WEB

Apache Tomcat 5.5.23. A instalao do Datasul Interactive ir executar a instalao do Apache Tomcat caso o seu sistema no 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.5.3.4. Requisito para Servidor de Banco de Dados

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

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

18

Progress 10.0B ou superior (Licena mnima: OE Workgroup RDBMS ou OE Enterprise RDBMS). SQL Server 2000 Enterprise/Standard ou superior. O SQL Server dever utilizar o cdigo de pgina padro da instalao do mesmo.

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

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

19

4. Detalhes das Mdias de Instalao


Neste capitulo detalharemos as mdias de instalao do produto DATASUL EMS 2.06B.

4.1.

Disco 1

No disco 1 localizam-se os manuais do produto, o setup para instalao e os arquivos que iro instalar o produto em sua mquina.

4.2.

Disco 2 e 3

No disco 2 localizam-se os arquivos de baixa do Instalador. No disco 3 esto os pacotes de atualizao do produto, arquivos de baixa do produto e tambm a instalao do Descompactador de pacotes. Quando o config precisar do disco 2 ou disco 3 para continuar a instalao, dever ser informado o diretrio Disk2 ou Disk3 do cdrom (<Drive de CDROM>\Disk2 ou Disk3, ex: D:\Disk2 ), conforme figura abaixo:

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

20

5. Instalao
5.1. Planejando a Instalao
Mostraremos agora as etapas que devem ser seguidas para que a instalao seja realizada para Multiusurio que contempla Programas, Banco de dados, Servidor de Aplicao. E tambm na instalao Demonstrao. 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 tambm as mquinas que estaro disponveis aos usurios. Como o componente Servidor de Aplicao opcional decida se vai utiliz-lo no momento. Para cada um destes componentes, verifique se os requisitos de hardware e software so atendidos; b) Inicie a instalao instalando os bancos de dados no servidor de banco de dados; c) Instale os programas no servidor de arquivos; d) Instale o servidor de aplicao se este componente for utilizado; e) Carregue os servidores de bancos de dados atravs 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 atravs do atalho criado em Iniciar\Programas\Datasul EMS\Release\Programa Inicializador; Caso a instalao seja destinada converso do produto, por exemplo do EMS-504 para o EMS-505, os bancos no podero ser inicializados. Informaes adicionais podem ser consultadas no Guia de Converso Datasul-EMS que est na mdia do produto. Aps a concluso destas etapas, o produto estar pronto para ser usado por todos os usurios.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

21

5.2.

Instalao de Programas Datasul-EMS

Essa instalao ir configurar em um servidor, todos os objetos utilizados pelo produto Datasul-EMS. Abaixo so demonstradas as telas de instalao.

Seleo do Idioma
Selecione o idioma de sua preferncia e clique em avanar.

Tela de Boas Vindas


Clique em Avanar para continuar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

22

Tela Informaes do Usurio


Nessa tela dever ser digitados o seu nome e a empresa em que voc trabalha. Para continuar, clique em Avanar.

Tela de seleo de Pas


Nessa tela dever ser selecionado o Pas de Instalao do Produto. A configurao do produto varia de acordo com a seleo do pas. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

23

Tela Tipo de Instalao


Para instalar os programas dever ser selecionado o tipo de Instalao Programa. Esse tipo de instalao ir configurar todos os objetos (Programas e utilitrios) que sero utilizados para execuo do produto. Esse tipo de instalao tambm pode ser utilizado para atualizao dos programas do Datasul EMS 2.06B. Para continuar, clique em Avanar.

Tela Tipo de Instalao de Programas


Nesta tela dever ser informado o tipo de instalao para a rea de programas. Escolha a opo Nova Instalao caso voc esteja fazendo a instalao de programas pela 1 vez ou fazendo uma instalao em uma rea diferente da sua rea de programas. A opo Atualizao da rea de programa dever ser utilizada por clientes que esto atualizando sua rea de programas com a mdia de instalao. Esta opo faz uma verificao do pacote que o cliente est e o ltimo pacote expedido pela Datasul, emitindo uma mensagem de alerta com os pacotes de atualizao que contm atualizao de dicionrio.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

24

Nova Instalao

Tela Pasta de Instalao


Na tela Pasta de instalao dever ser informado o diretrio de destino do Produto, ou seja, onde sero baixados os programas do produto Datasul EMS 2.06B. Antes de instalar, verifique se possui espao em disco suficiente. Para continuar, clique em Avanar.

Tela Cpia de Arquivos


Nesta tela contm as informaes digitadas nas telas anteriores. Caso alguma informao esteja incorreta, utilize o boto Voltar e retorne at a mesma para correo. Para iniciar a instalao dos arquivos clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

25

Atualizao da rea de Programas

Tela Pasta de Origem de Programas


Nesta tela dever ser informada a localizao dos programas do Produto ou seja a rea em que o produto Datasul est instalado. Informe o diretrio corretamente, pois o mesmo ser validado pela instalao. Para continuar, clique em Avanar.

Tela Pasta de Instalao


Na tela Pasta de instalao dever ser informado o diretrio de destino do Produto, ou seja, onde sero baixados os programas do Produto. Antes de instalar, verifique se possui espao em disco suficiente. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

26

Tela Cpia de Arquivos


Nesta tela contm as informaes digitadas nas telas anteriores. Caso alguma informao esteja incorreta, utilize o boto Voltar e retorne at a mesma para correo. Para iniciar a instalao dos arquivos clique em Avanar.

Ao final da atualizao de programas, caso exista alteraes de dicionrio entre a verso atual do cliente e a ultima verso liberada pela Datasul, ser apresentada uma mensagem de alerta informando os pacotes que contm atualizao de dicionrio. A seguir mostraremos uma mensagem exemplo:

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

27

Programas da Localizao Chile Ao final da instalao de programas devem ser atualizados dois objetos que esto publicados nos arquivos de apoio do portal de clientes para o produto EMS 2.06B referente aos programas da Localizao Chile. Estes arquivos devem ser descompactados diretamente no diretrio de instalao dos programas. Estes podem ser encontrados no portal na estrutura <Central de Downloads Arquivos de Apoio Multi EMS2 206B Localizao>.

5.3.

Bancos de Dados

5.3.1 Criao 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 comunicao com outros bancos de dados no-Progress. Quando o cliente optar por um banco de dados no-Progress (Oracle ou SQL Server), dever criar um banco de dados Progress que atuar como um Schema Holder. Se o cliente optar pela utilizao de um banco de dados Progress, o espao demandado pelo banco de dados dever ser previsto em sua criao. A lista com os bancos de dados necessrios para o sistema a ser instalado encontra-se na planilha Mapa de Bancos.xls (localizado no mesmo diretrio deste guia). Alguns desses bancos podem ser unificados. Essa lista est disponvel no documento Unificao de banco de dados.doc (localizado no mesmo diretrio deste guia). Esse documento tambm contempla a configurao necessria caso o ambiente seja multi-empresa, sendo necessrio duplicar alguns bancos. Os comandos Progress so iguais para ambientes Unix/Linux e ambientes Windows. Porm necessrio definir as variveis de ambiente para sua utilizao. Dentro do diretrio bin do Progress, est disponvel o script proenv que configura a sesso com as variveis de ambiente necessrias para proceder com a criao dos bancos. Lembramos que a mdia de programas a ser utilizada foi compilada para um banco de dados em especfico, e a opo pelo banco de dados a ser utilizado deve ter sido feito no momento da solicitao da mdia. Os arquivos de definies dos bancos de dados encontram-se abaixo do diretrio de instalao do aplicativo, no sub-diretrio 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 Devero ser criados os bancos de dados conforme o documento Mapa de Bancos.xls. Opcionalmente as definies podero ser unificadas em um ou mais bancos. Consulte o guia: Unificao de bancos de dados.doc, para informaes de unificao de ambientes.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

28

Para cada banco de dados a ser criado, crie um arquivo texto com o mesmo nome do banco de dados, extenso .st. Esse arquivo conter as reas do banco de dados, com seu respectivo tamanho. A seguir apresentamos um exemplo do banco ems2fnd com a configurao mnima desse arquivo: b .\ems2fnd.b1 d "Schema Area":6,32;1 .\ems2fnd.d1 Esse arquivo criar em ambiente Windows, uma extenso para o before-image e uma extenso de dados no diretrio corrente. Essas extenso so obrigatrias para cada banco. Para ambiente Unix/Linux, inverta a barra separadora de diretrio. Caso tenha previsto que o banco de dados necessitar de um espao maior, mais extenses de dados podero ser criadas, especificando um tamanho em kbytes para cada uma delas. Lembramos que para o Progress apenas a ltima extenso de dados de uma rea pode ter tamanho varivel: 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 extenses do banco sero criadas a partir do diretrio onde foi executado o comando. O exemplo que segue tambm para o banco ems2fnd: prostrct create ems2fnd ems2fnd.st Caso deseje usar um tamanho de bloco diferente do padro disponibilizado pela Progress para o sistema operacional utilizado, adicione ao final desse comando o parmetro 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 contm apenas o espao alocado, sem qualquer informao. Para esse banco ser usado, dever ser criado um Metaschema. Um Metaschema contm as definies necessrias para o banco ser utilizando, comeando a receber informaes de usurios. A criao do Metaschema feito atravs da cpia de um banco vazio disponibilizado pela Progress. Faa a cpia 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 tambm dever ser contemplado nesse comando. Para copiar o Metaschema para um banco de dados com tamanho de bloco diferente do padro disponibilizado para o sistema operacional, referencie os bancos Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10
29

empty1, empty2, empty4 ou empty8, conforme a necessidade, no lugar do padro empty. 5.3.1.2 Criando um Schema Holder Um Schema Holder consiste em um banco de dados Progress com definies que mapeiam os objetos dos bancos de dados no-Progress. Ele no armazena dados e poder ser conectado em modo somente-leitura ou servido em modo multi-usurio quando em produo, e mono-usurio para importao de definies. 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 tero a funo de Schema Holders, no necessrio prever tamanho de banco de dados ou de bloco. 5.3.2. Importando definies As definies so expedidas atravs de arquivos com a extenso .df. Para ambientes que utilizaro bancos de dados no-Progress, tambm esto disponveis os arquivos .sql para importao no banco de dados Oracle ou SQL Server. Os arquivos .df devero 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 definies em Progress Em uma sesso do proenv (verifique procedimento no tem 5.3.1), execute o comando a seguir em ambiente Windows, dentro do diretrio 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 funes do Data Administration so 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 definies correspondente ao banco que est conectado. Pressione OK para comear a importao. O arquivo de definies (.df) est em formato texto. Caso esteja importando em ambiente Linux/Unix, o .df dever ser transferido para o servidor atravs de FTP ASCII. Qualquer outra forma de transferncia que no converta quebras de linhas danificar o arquivo.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

30

Durante a importao podero ocorrer alertas (warnings) referentes ao formato dos campos em uma conexo ODBC/JDBC. Esses alertas podem ser ignorados. 5.3.2.2. Importando definies em Oracle No Oracle no criamos um banco de dados para cada arquivo de definies (.sql) mas sim um usurio (schema) para cada um desses arquivos. Esses usurios podem ser criados em um mesmo banco de dados (instncia). Na instalao do Oracle possvel optar pela criao de um banco de dados automaticamente. Caso esta opo no fora selecionada ou deseja-se criar um banco de dados diferente, proceda conforme a documentao do Oracle especfica para o ambiente que est utilizando. Por exemplo, para Windows poder ser utilizado o utilitrio dbca e seguir as orientaes apresentadas em tela. Para a criao destes esquemas, bem como para as demais tarefas administrativas do banco, este dever ser conectado com um usurio que possua as permisses necessrias ou ento o prprio usurio sys, que o usurio com maior autoridade no banco de dados Oracle. A seguir um exemplo de conexo ao banco com usurio de administrao, utilizando a ferramenta SQL Plus, que instalada junto com o Oracle: CONN SYS/<senha>@<instncia> AS SYSDBA; <senha>: senha do usurio sys <instancia>: nome da instncia ou banco de dados que ser utilizada. Este nome atribudo durante a criao do banco de dados e posteriormente pode ser consultada no arquivo tnsnames.ora, localizado no diretrio de instalao do Oracle. Os usurios que armazenaro os objetos devero possuir um conjunto de permisses, 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 permisses: 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 permisses 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 conexo, podendo utilizar o mesmo nome do usurio ou, preferencialmente, uma senha mais segura. <tablespace>: local aonde sero armazenados os objetos, podendo utilizar a tablespace users ou, preferencialmente, uma tablespace especfica para o produto.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

31

<temp>: nome da tablespace temporria que est definida no banco, geralmente chamada temp. Aps criados os esquemas, conectar a instncia com cada um deles para importar os arquivos que contm as definies dos seus objetos. A seguir um exemplo de como conectar com o usurio ems2fnd, utilizando a senha pw_ems2fnd no banco de dados ORCL e importar o arquivo ems2fnd.sql localizado no diretrio database\sql dentro da instalao do produto: CONN ems2fnd/pw_ems2fnd@ORCL; @C:\Datasul\ByYou\Database\sql\ems2fnd.sql

5.3.2.3. Importando definies em SQL Server O primeiro passo criar os bancos de dados necessrios. Para cada arquivo de definio (.sql) existente no diretrio database\sql, dever ser criado um banco de dados. O comando a seguir exemplifica a criao do banco de dados ems2fnd. USE master GO CREATE DATABASE e207amultmssfnd GO Aps a criao do banco, crie uma nova query utilizando o SQL Server Management Studio. Abra o .sql correspondente ao banco de dados criado e executeo. Aps a concluso do comando o banco estar pronto para ser conectado. 5.3.3. Servindo e conectando os bancos de dados O servio de um banco de dados existe para que vrios usurios possam conectar-se simultaneamente. Na conexo, os produtos Datasul que so executados sobre Progress utilizam-se de um atalho e alguns arquivos de configurao. Quando o ambiente possui bancos de dados unificados, um programa que cria alias tambm dever ser configurado para executar antes dos programas do sistema. Para essa configurao, consulte o documento Unificao de banco de dados.doc. A seguir est exemplificado um comando padro para utilizar em um atalho de conexo: <dir progress>\bin\prowin32.exe basekey INI ininame arquivo.ini pf arquivo.pf O arquivo .ini com as configuraes padro do sistema encontra-se disponvel no diretrio scripts da instalao do produto. Da mesma forma, um arquivo .pf foi criado no mesmo diretrio para as configuraes de sesso do produto. 5.3.3.1. Ambientes com bancos de dados Progress O primeiro passo para estabelecer uma conexo ao banco de dados disponibilizar esse banco para um acesso cliente-servidor. Isso pode ser feito atravs

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

32

de scripts, executando os comandos Progress que efetuam essa tarefa, ou atravs da ferramenta Progress Explorer Tool. Independente de como o banco servido, algumas caractersticas devem estar definidas para o perfeito funcionamento do ambiente: Porta de comunicao: A porta de comunicao o canal para estabelecer o contato de uma sesso 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 parmetro S de cada broker de login, dever estar liberada. Tambm dever liberar as portas que processos servers utilizaro. Essas portas so definidas em intervalos, atravs dos parmetros minport e maxport. Nmero de usurios que se conectam ao sistema: Os bancos de dados devero permitir a conexo de todos os usurios contratados para o sistema. A conexo cliente-servidor ao banco de dados Progress ocorre atravs de processos chamados Servers. Cada processo pode receber um ou mais usurios. A relao de usurios por server deve ser definida na inicializao do banco de dados. Conexes ODBC/JDBC: Alguns bancos de dados precisam receber conexes ODBC ou JDBC, o que em bancos de dados Progress so chamadas de conexes SQL. Um novo broker de login deve ser iniciado para receber esse tipo de conexo, com a quantidade de servers necessrios 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 <parmetros do banco> Para ambientes Linux/Unix: proserve ems2fnd <parmetros do banco> Caso seja necessrio criar um broker para conexes SQL, utilize o exemplo abaixo para ambientes Windows: call proserve ems2fnd m3 <parmetros do broker de login> Para ambientes Linux/Unix: proserve ems2fnd m3 <parmetros do broker de login> Adicione no arquivo .pf as conexes aos bancos de dados que sero utilizados pelo sistema. Nesse mesmo arquivo, esto disponveis exemplos da conexo 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 usurio administrador do banco poder carregar e derrubar uma instncia Oracle, conectando com o usurio sys na ferramenta SQL Plus e executar os comandos startup para iniciar a base de dados e shutdown

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

33

para par-la. Em alguns ambientes como no Windows, basta iniciar o servio com o nome do banco de dados criado para que a base esteja disponvel para conexes. Altere o arquivo .pf instalado no diretrio scripts para conectar o banco de dados. Nesse mesmo arquivo, esto disponveis exemplos da conexo 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 servio do sistema operacional e as instncias so iniciadas automaticamente quando o gerenciador de servios inicia. Em caso de dvidas sobre a inicializao dos servios do SQL Server consulte a documentao do produto. Altere o arquivo .pf instalado no diretrio scripts para conectar o banco de dados. Essa conexo deve ser feita utilizando o mtodo DSN-less, informando a linha de conexo com o SQL Server. Nesse mesmo arquivo, esto disponveis exemplos da conexo ao banco SQL Server e Schema Holder.

5.4.

Instalao Datasul Interactive

A interface padro de todos os produtos Datasul o Datasul Interactive. Sua instalao acompanha a instalao de nossos produtos. O DI rene em um menu unificado todos os mdulos Datasul e oferece informaes contextualizadas sobre nossos produtos. Este captulo tem por objetivo apresentar as etapas de instalao do Datasul Interactive utilizando-se da mdia disponibilizada pela Datasul. Antes de comear a instalao essencial ter um conjunto de informaes (solicitadas durante a instalao), as quais esto listadas abaixo: Identifique o diretrio onde o Progress foi instalado nas mquinas clientes (exemplo: c:\dlc91, c:\dlc10). Identifique qual produto/sistema ser utilizado para a autenticao dos usurios no Datasul Interactive: Produto/Sistema Datasul EMS 2 Datasul EMS 5 Datasul HR Domnio Windows
* Quando solicitado na instalao, somente poder informar um nico produto/sistema.

A instalao consiste em configurar inicialmente a base dados, aps a instalao de todos os objetos(programas e scripts) utilizados pelo produto Datasul Interactive e finalmente algumas parametrizaes finais para o uso do produto pelos usurios. Existem trs tipos de mdias de instalao 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 mdia correta conforme o seu ambiente disponvel. Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10
34

Observao 01: Considere ao realizar a instalao do Datasul Interactive, os produtos que sero integrados j estejam instalados e configurados antecipadamente. Observao 02: Caso selecionado a instalao simultnea de Banco de Dados e Programas, sero apresentadas mensagens de alertas orientativos sobre em qual etapa estar sendo executada:

Observao 03: Caso selecionado a instalao simultnea de Banco de Dados e Programas, o diretrio de instalao dos programas e banco de dados ser nico como tambm ser nico o diretrio padro do produto Progress. Desta forma, estas informaes sero solicitadas uma nica vez. A seguir so demonstradas as telas de instalao.

Seleo do Idioma
Selecione o idioma de sua preferncia e clique em avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

35

Tela de Boas Vindas


Clique em Avanar para continuar.

Tela Informaes do Usurio

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

36

Nessa tela dever ser digitados o seu nome e a empresa em que voc trabalha. Para continuar, clique em Avanar.

Tela de seleo de Pas


Nessa tela dever ser selecionado o Pas de Instalao do Produto. A configurao do produto varia de acordo com a seleo do pas. Para continuar, clique em Avanar.

Tela Tipo de Instalao


Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10
37

Para instalar o Datasul Interactive dever ser selecionado o tipo de Instalao Datasul Interactive. Este tipo de instalao ir baixar os programas e bancos de dados do Datasul Interactive. Para continuar, clique em Avanar.

5.4.1. Instalao Banco de Dados Datasul Interactive Este tipo de instalao ir instalar e configurar os bancos de dados do Datasul Interactive e tambm criar os scripts de conexo dos bancos de dados do Produto Datasul-EMS e Datasul Interactive.

Tela Tipo de Instalao Datasul Interactive

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

38

Nesta tela selecionado o contedo a ser instalado pela mdia. Observao: - Para a instalao de programas, pr-requisito a instalao da opo banco de dados. Para a instalao adicionando um novo produto ao Datasul Interactive, pr-requisito a instalao da opo de banco de dados e de programas. Para continuar, clique em Avanar.

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. Observao: Para instalao em Windows NT/2000 ser necessrio executar a instalao no prprio servidor. Para continuar, clique em Avanar.

Tela Informe a pasta destino do aplicativo

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

39

Nesta tela dever ser informado o diretrio de destino dos Bancos de Dados, ou seja, onde sero baixados os bancos e scripts do Datasul Interactive. Observao: Evite utilizar diretrios com espao em branco. Para continuar, clique em Avanar.

Tela Pasta Destino Aplicativo Progress


Nesta tela dever ser informado o diretrio onde o aplicativo Progress encontra-se instalado. Observao: Caso o Progress ainda no esteja instalado, cancele a instalao do produto Datasul Interactive e providencie a sua instalao. Para continuar, clique em Avanar

Tela Nmero Base de Servios


Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10
40

Nesta tela dever ser informado um nmero inicial para configurao da porta TCP/IP que ser utilizada na carga do banco do Datasul Interactive. Observao: Verifique se o nmero sugerido no esteja sendo utilizado, caso afirmativo, informe um outro nmero. Para continuar, clique em Avanar.

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 instalao Bancos de Dados Para continuar, clique em avanar.

Tela Configurao Progress Explorer Tool


Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10
41

Nesta tela pode-se selecionar a opo de alterar automaticamente ou no, o arquivo conmgr.properties de acordo com a faixa informada na tela anterior. Observao: recomendada a utilizao da opo modificar o arquivo cmmgr.propeties, se voc deseja administrar o banco de dados via o Progress Explorer Tool. Para continuar, clique em avanar.

Tela Confirmao das informaes parametrizadas


Nesta tela o usurio confirma as informaes parametrizadas anteriormente. Observao: Caso alguma informao esteja incorreta, deve-se utilizar a opo Voltar. Para continuar, clique em Avanar.

Tela Instalao Concluda


Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10
42

Nesta tela informado ao usurio o trmino da instalao a nvel de base de dados do produto Datasul Interactive. Observao: O servio do Progress AdminService deve ser re-iniciado. Para finalizar, clique em Terminar.

Configurao do Aplicativo Progress Explorer Tool

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

43

Durante a instalao do banco de dados do produto Datasul Interactive o aplicativo Progress Explorer Tool configurado com uma parametrizao bsica para carga do banco de dados, caso voc tenha setado para alterar a configurao do arquivo conmgr.properties. Essa configurao 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 informaes sobre esse servio, entrem em contato com o Suporte Tecnologia atravs do telefone (47) 21017400. O aplicativo Progress Explorer Tool somente disponibilizado para Progress verso 9 ou superior. Abaixo tela de demonstrao do Progress Explorer Tool:

Objetos criados na instalao Banco de dados:

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

44

Abaixo esto detalhados os objetos criados durante a instalao dos Bancos de Dados em Windows NT/2000. Localizao <Dir Instalao>\scripts Objeto Ems2.ini Descrio Arquivo contendo informaes do ambiente para utilizao do produto Datasul EMS 2.06B Arquivo contendo os parmetros de sesso para acesso ao produto Datasul EMS 2.06B Arquivo contendo os parmetros de conexo dos bancos de dados do produto Datasul-EMS 2.06B Arquivo contendo os parmetros de sesso para acesso ao produto Datasul Interactive Arquivo contendo os parmetros de conexo do banco de dados do produto Datasul Interactive. Arquivo contendo os parmetros de conexo do banco de dados do produto Datasul Interactive. Script para reparar os bancos de dados do produto Datasul Interactive Script para truncar os bancos de dados do produto Datasul Interactive Arquivo contendo a estrutura do banco de dados. Esse arquivo utilizado no processo de reparao dos banco de dados do produto Datasul Interactive.

<Dir Instalao>\scripts

Ems2.pf

<Dir Instalao>\scripts

Ems2mult.pf

<Dir Instalao>\scripts

eip.pf

<Dir Instalao>\scripts

eipmult.pf

<Dir Instalao>\scripts

eiphost.pf

<Dir Instalao>\scripts

Ems2rpr.bat

<Dir Instalao>\scripts

Ems2trun.bat

<Dir Instalao>\database eip.st

Parmetros de conexo dos bancos do Chile Ao final da instalao do banco de dados do Datasul Interactive deve ser atualizado o arquivo que contm os parmetros de conexo dos bancos de dados do EMS 2.06B (ems2mult.pf). Este arquivo est localizado no diretrio de instalao conforme estrutura da tabela acima. Ao final do arquivo deve ser acrescentado os parmetros de carga dos bancos da localizao Chile, lcchl e mov2chl.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

45

-db lcchl -ld lcchl -S <nmero_servio> -H <servidor_bancos> -N tcp -db mov2chl -ld mov2chl -S <nmero_servio> -H <servidor_bancos> -N tcp

5.4.2. Instalao Programas Datasul Interactive Este tipo de instalao ir instalar os programas do Datasul Interactive, criar o Servio WebSpeed no Progress Explorer Tools, criar o diretrio virtual no Internet information service ou Apache e fazer a configurao necessria para acesso ao Datasul-EMS pelo Datasul Interactive.

Tela Tipo de Instalao: Programas


Nesta tela selecionado o contedo a ser instalado pela mdia. Observao: - Para a instalao de programas, pr-requisito a instalao da opo banco de dados. Para a instalao adicionando um novo produto ao Datasul Interactive, pr-requisito a instalao da opo de banco de dados e de programas. Para continuar, clique em Avanar.

Pergunta
Informe se o aplicativo Apache Tomcat est instalado em seu Sistema. Caso no esteja instalado, o wizard do Datasul Interactive ir efetuar a execuo da instalao do Tomcat.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

46

Tela Diretrio de Instalao Apache Tomcat


Nesta tela dever ser informado o diretrio de instalao do aplicativo Apache Tomcat. Para continuar, Avanar. clique em

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

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

47

Tela Estrutura dos bancos de dados


Selecione o estrutura de dados que foi opo Banco da instalao EMS 2.06B. tipo de bancos de definida na de Dados do Datasul

Para continuar, clique em Avanar.

Tela Informe a pasta destino do aplicativo


Nesta tela dever ser informado o diretrio de destino dos programas, ou seja, onde sero baixados os programas e outros objetos do Datasul Interactive. Observao: Evite utilizar diretrios com espao em branco. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

48

Tela Informe a pasta onde o aplicativo Progress est instalado


Nesta tela dever ser informado o diretrio onde o aplicativo Progress encontra-se instalado. Observao: Caso o Progress ainda no esteja instalado, cancele a instalao do produto Datasul Interactive e providencie a sua instalao. Para continuar, clique em Avanar

Tela Servio WebSpeed


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

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

49

Tela Seleo de Autenticao de Produto


O autenticador fornece a lista dos usurios que podem fazer acesso ao Datasul Interactive. Caso a escolha seja pelo domnio do Windows NT / 2000 sero considerados os nomes de usurio cadastrados na sua rede, j no caso de autenticao pelo produto ser utilizada a lista de usurios cadastrados no sistema. Observao: Somente poder ser selecionado um nico produto como autenticador. Para continuar, clique em Avanar.

Tela Product ID Datasul-EMS 2


O campo informado ser o identificador do produto para o DI e para o servio WEB. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

50

Tela Pasta Origem de Programas


Nesta tela dever ser informado o diretrio em que encontram-se os programas do Datasul EMS 2.06B. Para continuar, clique em Avanar.

Tela Executvel Messenger


Nesta tela dever ser selecionado o executvel messenger a ser utilizado pelo webspeed. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

51

Tela Servidor WEB


Nesta tela dever ser informado o Host da mquina servidora WEB. Para continuar, clique em Avanar.

Tela Identificao Datasul


Nesta tela dever ser o usurio utilizado no login da pgina de Suporte da Datasul. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

52

Pasta de origem do arquivo de conexo Datasul EMS 2.06B


Nesta tela dever ser informada a pasta onde se localiza o arquivo de conexo (ems2mult.pf) do produto EMS 2.06B instalado no tipo de instalao banco de dados. Para continuar, clique em Avanar.

Tela WEB
Nesta tela pode-se selecionar a opo de alterar automaticamente ou no, o arquivo ubroker.properties de acordo com a faixa informada na tela anterior. Observao: recomendada a utilizao da opo modificar o arquivo ubroker.propeties, se voc deseja administrar o servio Webspped via o Progress Explorer Tool. Para continuar, clique em avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

53

Tela Servidor WEB


Nesta tela dever ser selecionado o software WEB utilizado. Internet Information Service ou Apache. Aps retorne para esta sequncia de explicaes.

Internet Information Services

Tela Diretrio Virtual IIS


Nesta tela dever ser informado o diretrio virtual a ser criado para o Datasul Interactive. Observao: Evite utilizar diretrios com espao em branco. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

54

Apache

Tela Alias Apache


Nesta tela dever ser informado o diretrio virtual a ser criado para o Datasul Interactive. Observao: Evite utilizar diretrios com espao em branco. Para continuar, clique em Avanar.

Tela Configurao Apache


Nesta tela dever ser informado a localizao do arquivo de configuraes do Apache: httpd.conf. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

55

Tela Cpia de Arquivos


Nesta tela o usurio confirma as informaes parametrizadas anteriormente. Observao: Caso alguma informao esteja incorreta, deve-se utilizar a opo Voltar. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

56

5.4.3. Configurando Servio do Apache Tomcat Aps a instalao dos programas e do aplicativo Apache Tomcat, ser necessrio alterar o usurio de start do servio do Tomcat para o usurio administrador do servidor Web. Para isso siga os passos abaixo: 1 V at a tela de servios do Windows, clique propriedades, conforme a tela abaixo:

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

57

2 V at a aba Log On e altere de Conta do Sistema Local para Esta Conta, informe o usurio e senha do administrador do servidor e clique em OK, conforme abaixo:

3 Reinicie o servio Apache Tomcat. 5.4.4. Deploy Automtico A instalao do Datasul Interactive efetuar a baixa do arquivo di.war no diretrio weapps do Tomcat. Caso o servio do Tomcat esteja iniciado, este arquivo ser descompactado automaticamente criando a pasta di com os componentes necessrios para a execuo do Datasul Interactive. 5.4.5. Adicionando Novo Produto ao Datasul Interactive Observao 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. Observao 2: Para a instalao do Datasul Interactive necessrio conhecer os parmetros utilizados na execuo destes produtos, conforme planilha abaixo:

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

58

Produto Datasul EMS 2 Arquivo .PF de conexo das bases de dados do cliente. * Arquivo INI utilizado na sesso do cliente. Datasul EMS 5 Arquivo .PF de conexo das bases de dados do cliente. * Arquivo INI utilizado na sesso do cliente. Datasul HR Arquivo .PF de conexo das bases de dados do cliente. * Arquivo INI utilizado na sesso do cliente. DataViewer Arquivo .PF de conexo das bases de dados do cliente. * Arquivo INI utilizado na sesso do cliente. WebDesk

Exemplos de Arquivos

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

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

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

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

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

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

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

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

URL

http://<Nome_do_Servidor>/scripts/cgiip.exe/WService=<Nome_do_S ervio_WebSpeed>/wgp/wgp0006.p

Datasul Business Intelligence URL http://<nome do servidor>/<diretrio virtual>

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

59

Neogrid CCommerce OnDemand http://200.180.73.66:82/servlet/com.neogrid.arch.web.util.AuthServlet URL


* Neste arquivo no poder constar os parmetros -T (diretrio temporrio da sesso) e -p (programa a ser executado inicialmente na sesso).

A seguir detalharemos as telas deste tipo de instalao:

Tela Tipo de Instalao: Adicionar novo produto ao Datasul Interactive


Nesta tela selecionado o contedo a ser instalado pela mdia. Observao: Para a instalao adicionando um novo produto ao Datasul Interactive, pr-requisito a instalao da opo de banco de dados e de programas. Para continuar, clique em Avanar.

Tela diretrio origem do Datasul Interactive


Nesta tela informe o diretrio dos programas instalados do Datasul Interactive. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

60

Tela Informe a posta onde o aplicativo Progress est instalado


Nesta tela dever ser informado o diretrio onde o aplicativo Progress encontra-se instalado. Observao: Caso o Progress ainda no esteja instalado, cancele a instalao do produto Datasul Interactive e providencie a sua instalao. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

61

Tela Produto Instalado


Nesta tela dever ser selecionado o produto j instalado e configurado anteriormente e que desejase integrar ao Datasul Interactive (verifique quais produtos j integram-se com o Datasul Interactive para selecionar corretamente). Observao: Pode-se selecionar um produto ou mais de um produto.Caso seja selecionado: - Datasul EMS 2: continue no tpico 5.4.3.1. Adicionando Produto Datasul EMS 2. - Datasul EMS 5: continue no tpico 5.4.3.2.. Adicionando Produto Datasul EMS 5. - Datasul HR: continue no tpico 5.4.3.3. Adicionando Produto Datasul HR. - Datasul Webdesk: continue no tpico 5.4.3.4. Adicionando Produto Datasul Webdesk. - Datasul BI: continue no tpico 5.4.3.5. Adicionando Produto Datasul BI. Aps retorne para esta sequncia de explicaes. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

62

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

Tela Product ID Datasul-EMS 2


O campo informado ser o identificador do produto para o DI e para o servio WEB. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

63

Tela Pasta Origem de Programas


Nesta tela dever ser informado o diretrio em que encontram-se os programas do Datasul EMS 2. Para continuar, clique em Avanar.

Tela Arquivo de Parmetros para conexo com os bancos


Nesta tela dever ser informado a localizao do arquivo de parmetros (.pf) das bases de dados do Datasul EMS 2. Observao: O arquivo .pf no dever possuir os parmetros -T, -param e basekey. Caso existam, ocorrero erros nos servios webspped do Datasul Interactive. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

64

Tela Arquivo de configuraes (.ini)


Nesta tela dever ser informado a localizao do arquivo de inicializao e configuraes da sesso (.ini) utilizado nos atalhos do Datasul EMS 2. Para continuar, clique em Avanar.

Tela WEB
Nesta tela pode-se selecionar a opo de alterar automaticamente ou no, o arquivo ubroker.properties de acordo com a faixa informada na tela anterior. Observao: recomendada a utilizao da opo modificar o arquivo ubroker.propeties, se voc deseja administrar o servio Webspped via o Progress Explorer Tool. Para continuar, clique em avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

65

Tela Servidor WEB


Nesta tela dever ser informado o Host da mquina servidora WEB. Para continuar, clique em Avanar.

Tela Executvel Messenger


Nesta tela dever ser selecionado o executvel messenger a ser utilizado pelo webspeed. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

66

Tela Cpia de Arquivos


Nesta tela o usurio confirma as informaes parametrizadas anteriormente. Observao: Caso alguma informao esteja incorreta, deve-se utilizar a opo Voltar. Para continuar, clique em Avanar.

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

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

67

Tela Product ID Datasul-EMS 5


O campo informado ser o identificador do produto para o DI e para o servio WEB. Para continuar, clique em Avanar.

Tela Pasta Origem de Programas


Nesta tela dever ser informado o diretrio em que encontram-se os programas do Datasul EMS 5. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

68

Tela Arquivo de Parmetros para conexo com os bancos


Nesta tela dever ser informado a localizao do arquivo de parmetros (.pf) das bases de dados do Datasul EMS 5. Observao: O arquivo .pf no dever possuir os parmetros -T, -param e basekey. Caso existam, ocorrero erros nos servios webspped do Datasul Interactive. Para continuar, clique em Avanar.

Tela Arquivo de configuraes (.ini)


Nesta tela dever ser informado a localizao do arquivo de inicializao e configuraes da sesso (.ini) utilizado nos atalhos do Datasul EMS 5. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

69

Tela WEB
Nesta tela pode-se selecionar a opo de alterar automaticamente ou no, o arquivo ubroker.properties de acordo com a faixa informada na tela anterior. Observao: recomendada a utilizao da opo modificar o arquivo ubroker.propeties, se voc deseja administrar o servio Webspped via o Progress Explorer Tool. Para continuar, clique em avanar.

Tela Servidor WEB


Nesta tela dever ser informado o Host da mquina servidora WEB. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

70

Tela Executvel Messenger


Nesta tela dever ser selecionado o executvel messenger a ser utilizado pelo webspeed. Para continuar, clique em Avanar.

Tela Cpia de Arquivos


Nesta tela o usurio confirma as informaes parametrizadas anteriormente. Observao: Caso alguma informao esteja incorreta, deve-se utilizar a opo Voltar. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

71

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

Tela Product ID Datasul-HR


O campo informado ser o identificador do produto para o DI e para o servio WEB. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

72

Tela Pasta Origem de Programas


Nesta tela dever ser informado o diretrio em que encontram-se os programas do Datasul HR. Para continuar, clique em Avanar.

Tela Arquivo de Parmetros para conexo com os bancos


Nesta tela dever ser informado a localizao do arquivo de parmetros (.pf) das bases de dados do Datasul HR. Observao: O arquivo .pf no dever possuir os parmetros -T, -param e basekey. Caso existam, ocorrero erros nos servios webspped do Datasul Interactive. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

73

Tela Arquivo de configuraes (.ini)


Nesta tela dever ser informado a localizao do arquivo de inicializao e configuraes da sesso (.ini) utilizado nos atalhos do Datasul HR. Para continuar, clique em Avanar.

Tela WEB
Nesta tela pode-se selecionar a opo de alterar automaticamente ou no, o arquivo ubroker.properties de acordo com a faixa informada na tela anterior. Observao: recomendada a utilizao da opo modificar o arquivo ubroker.propeties, se voc deseja administrar o servio Webspped via o Progress Explorer Tool. Para continuar, clique em avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

74

Tela Servidor WEB


Nesta tela dever ser informado o Host da mquina servidora WEB. Para continuar, clique em Avanar.

Tela Executvel Messenger


Nesta tela dever ser selecionado o executvel messenger a ser utilizado pelo webspeed. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

75

Tela Cpia de Arquivos


Nesta tela o usurio confirma as informaes parametrizadas anteriormente. Observao: Caso alguma informao esteja incorreta, deve-se utilizar a opo Voltar. Para continuar, clique em Avanar.

5.4.5.4.

Adicionando Produto Datasul Webdesk

Tela Informaes sobre Datasul Webdesk


Nesta tela dever ser informado o servidor Web do produto Webdesk e o servio webspeed utilizado. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

76

Tela Executvel Messenger


Nesta tela dever ser selecionado o executvel messenger a ser utilizado pelo webspeed. Para continuar, clique em Avanar.

Tela Cpia de Arquivos


Nesta tela o usurio confirma as informaes parametrizadas anteriormente. Observao: Caso alguma informao esteja incorreta, deve-se utilizar a opo Voltar. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

77

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

Tela Executvel Messenger


Nesta tela dever ser selecionado o executvel messenger a ser utilizado pelo webspeed. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

78

Tela Cpia de Arquivos


Nesta tela o usurio confirma as informaes parametrizadas anteriormente. Observao: Caso alguma informao esteja incorreta, deve-se utilizar a opo Voltar. Para continuar, clique em Avanar.

5.4.6. Instalando Java Plug-In No diretrio interfac da instalao do Datasul Interactive est o instalador do Java Plug-in (arquivo j2re-1_4_0_01-windows-i586-i.exe) necessrio para executar o Applet no browser dos usurios. Esta instalao dever ser executada manualmente, visto que a mdia de instalao no executar automaticamente. Observao: recomendvel fazer esta instalao antes de utilizar o Datasul Interactive, para evitar que seja feita a instalao do Java Plug-in via Internet. Uma opo colocar a instalao do plug-in no LogonScript da rede.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

79

Tela Java RunTime Enviroment - InstallShield Wizard


Nesta tela informado ao usurio o incio da instalao. Aguarde o trmino da verificao do ambiente para que sejam solicitadas as informaes.

Tela InstallShield Wizard


Nesta tela informado usurio as boas-vindas instalador do Java Plug-In. ao ao

Pressione o boto Next para continuar a instalao.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

80

Tela InstallShield Wizard


Nesta tela informado os termos sobre a licena e questionado ao usurio se aceita os termos apresentados Pressione o boto YES para aceitar e continuar a instalao.

Tela InstallShield Wizard


Nesta tela o usurio dever informar o diretrio de instalao do Java Plug-In. Pressione o boto Next para continuar a instalao.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

81

Tela InstallShield Wizard


Nesta tela o usurio dever informar o browser que ser utilizado. Pressione o boto Next para continuar a instalao.

Tela InstallShield Wizard


Nesta tela o usurio dever aguardar o trmino da instalao dos arquivos.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

82

5.4.7. Executando o Datasul Interactive Este captulo tem por objetivo apresentar como o usurio final estar acessando o Datasul Interactive. 5.4.7.1. Executando o Datasul Interactive

Os usurios para executarem o Datasul Interactive, devero abrir uma sesso do browser (Internet Explorer) e informar o seguinte caminho: http://<nome_do_servidor>:<porta de conexo do Tomcat>/di. (exemplo: http://pedrasaltas:8080/di) Aps a digitao, ser apresentada a tela inicial abaixo:

Maiores informaes sobre as opes disponveis no produto Datasul Interactive, consulte o manual de Referncia.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

83

5.4.8. Procedimentos Este captulo tem por objetivo explicar alguns procedimentos complementares, caso exista necessidade de alguma interveno manual ou na ocorrncia de problemas, como proceder para solucion-los. 5.4.8.1. Carregando banco de dados Progress

Se voc selecionou alterar a configurao do arquivo conmgr.properties ento o banco de dados j est configurado no Progress Explorer como EIP. Abra o Progress Explorer e carregue o banco de dados clicando no boto :

5.4.8.2.

Configurando o Diretrio Virtual

O Datasul Interactive requer que seja configurado um diretrio virtual no WebServer. Veja abaixo como criar o diretrio virtual eip no IIS 5.0 (Windows 2000)

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

84

Tela Inicial
Abra o gerenciador do IIS e clique com o boto direito do mouse em Site Padro / Default Web Site e selecione novo Pasta Virtual / Virtual Directory Clique em Avanar.

Tela Diretrio Virtual


Nesta tela informe o nome do diretrio virtual para o Datasul Interactive.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

85

Tela Diretrio Fsico


Informe o diretrio raiz onde foi instalado o Datasul Interactive.

Tela Pgina Padro


Nas propriedades do diretrio virtual informa a pgina padro do site: eip/index.htm

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

86

5.4.8.3.

Carregando servio WebSpeed

Se voc selecionou alterar a configurao do arquivo ubroker.properties ento os servios j esto configurados no Progress Explorer como EIP e EIPxxxx, onde xxxx representa o cdigo dos produtos instalados. Abra o Progress Explorer e carregue o banco de dados clicando no boto :

Observaes: a) No servio EIP verifique se o banco de dados do produto de autenticao est sendo conectado na linha do agente. b) Se o banco de dados do Datasul Interactive estiver na mesma mquina do servidor WEB, utilize a conexo via shared-memory usando o arquivo eiphost.pf. c) Se o banco de dados do Datasul Interactive estiver em mquina 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 servio do banco de dados do Datasul Interactive. No Progress Explorer Tools: edite o servio WebSpeed EIP; v em: Agente Geral Parmetros de inicializao do agente; Altere o arquivo eiphost.pf por eipmult.pf Reinicie o servio WebSpeed EIP. a seguir detalharemos as telas para essa alterao:

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

87

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

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

88

5.4.8.4.

Compreendendo a estrutura do arquivo config.xml

As configuraes do Datasul Interactive tem como base um arquivo xml localizado no <Diretrio de instalao do Produto Datasul Interactive>config\config.xml. Exemplo:
<EIP> <Product ID="EMS2" Type="EMS2"> <Name>Datasul EMS 2.06B</Name> <Menu> http://techkarla/scripts/cgiip.exe/WService=eip_karla/men/men907za.p?USER=%USER%&amp;PASS=%PASS%&amp;PR ODUCT=DT_EMS2&amp;DEPTH=1 </Menu> <Company ID="*"> <Shortcut Description="Local" Path="&quot;c:\dlc91\bin\prowin32.exe&quot; -pf &quot;C:\EMS204_Suporte_v9\ems2.pf&quot; -ininame &quot;C:\EMS204_Suporte_v9\progresc.ini&quot; -p &quot;Men\men906za.w&quot;" /> </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 Datasul interactive

possvel acrescentar uma nova instalao de produto ao Datasul Interactive manualmente, a seguir so apresentados os procedimentos necessrios. As configuraes 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://techkarla/scripts/cgiip.exe/WService=eip_karla/men/men907za.p?USER=%USER%&amp;PASS=%PASS%&amp;PR ODUCT=DT_EMS2&amp;DEPTH=1 </Menu> <Company ID="*"> <Shortcut Description="Local" Path="&quot;c:\dlc91\bin\prowin32.exe&quot; -pf &quot;C:\EMS204_Suporte_v9\ems2.pf&quot; -ininame &quot;C:\EMS204_Suporte_v9\progresc.ini&quot; -p &quot;Men\men906za.w&quot;" /> </Company> </Product>

Elementos Product ID

Type

Descrio dos Elementos referente ao Produto Valores Valor de Identificao do Produto Observao: o contedo dever ser nico no arquivo Ex: Ems2-Oficial, Ems5-Teste, Hr Tipo do produto.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

89

Elementos Name Menu

Shortcut Description

Descrio dos Elementos referente ao Produto Valores Valores possveis: EMS2, EMS5, HR, Webdesk, BI, ECS, Dataviewer. Nome do produto. Este o valor que ser exibido no menu do Datasul Interactive. URL utilizado para busca de Menu dos produtos atravs de um servio 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. Utilizado para a configurao 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: necessrio que a opo p seja alterada para: EMS2 - [local]\men\men906za.p Hr - [local]\men\men906za.p EMS 5 [local]\prgtec\men\men906za.p OBS: No colocar a opo param, pois o Datasul Interactive o coloca automaticamente.

Descrio dos Elementos complementares do Arquivo config.xml Elementos Valores VirtualDir Nome do Diretrio Virtual no WebServer utilizado pelo Datasul Interactive. Host Nome do Servidor onde o Datasul Interactive est instalado. Este valor deve ser True caso seja escolhida a opo Autenticao NTLogon Integrada com o Windows e False para no. Program Programa utilizado para autenticao do usurio do Datasul Interactive. Valores: Datasul EMS 2 men/men910za.p Datasul EMS5 prgtec/men/men910za.p Datasul HR - men/men910za.p Languag Idioma utilizado na sesso do Datasul Interactive. e Valores possveis: PT, EN. Exemplo de adio 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>

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

90

...

5.4.8.6.

Roteiro de verificao de funcionamento Datasul Interactive

Este roteiro visa apresentar os principais pontos a serem verificados na ocorrncia dos erros freqentes na utilizao do Datasul Interactive:

Tpico 01

Roteiro de Verificao de funcionamento Datasul Interactive Item analisado Como proceder Resultado (OK/NOK) IIS - Verso Instalada Para identificar a verso IIS utilizada, verifique atravs do operacional utilizado, opo de painel de controle, opo de Gerenciador de Servios de Internet, selecione a opo de Ajuda. Na pgina inicial da documentao do IIS apresentada a verso instalada. Tambm possvel executar a documentao do IIS atravs do browser informando o seguinte caminho: http://localhost/iisHelp/ A verso mnima dever ser 4.0, caso seja inferior, entre em contado com seu Suporte ao Sistema Operacional para providenciar atualizao necessria para o Datasul Interactive. Para verificar o funcionamento do IIS, via browser Internet Explorer, acesse o seguinte caminho: http://localhost/iisHelp/. Dever ser apresentado a documentao do IIS, caso contrrio, entre em contato com seu Suporte ao Sistema Operacional reportando esta situao. Execute o IIS, e verifique a existncia da pasta virtual informada na instalao (opo de Web Sites). No identificando a causa, entre e em contato com Suporte Telefnico Datasul, opo

02

IIS - Funcionamento

03

IIS- Pasta Virtual Interactive

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

91

Tpico

04

05

Roteiro de Verificao de funcionamento Datasul Interactive Item analisado Como proceder Resultado (OK/NOK) Aplicativo Tecnologia. Progress Tools - Conexo Base Execute o programa Progress de dados IEP Explorer Tools (gerenciamento de ferramentas Progress), e verifique na opo de Base de Dados, selecione a base de dados do Datasul Interactive e clique na opo de carregar. Caso no carregue a base de dados, verifique os parmetros de configurao da base. Dica: Outra sugesto de verificao, conectar a base de dados no utilizando-se o Progress Explorer Tools. No identificando a causa, entre e em contato com Suporte Telefnico Datasul, opo Ferramenta Progress. No apresentao do menu, Verifique as configuraes do aps login inicial do Datasul arquivo menu.html localizado: Interactive. 1. Idioma Portugus: ../pt/html/menu.htm 2. Idioma Ingls: ./en/html/menu.htm. Dica: verifique os diretrios utilizados na execuo dos executveis Java (*.jar). No identificando a causa, entre e em contato com Suporte Telefnico Datasul, opo Aplicativo Tecnologia. Via sistema operacional grfico, selecione a opo Painel de Controle, opo Ferramentas Administrativas, opo Fontes de Dados (ODBC), folder System DSN. Dever existir um item para a base de dados do Datasul Interactive.

06

Verificao da criao do driver ODBC da base de dados do Datasul Interactive em SQL utilizando-se da mdia.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

92

Tpico

Roteiro de Verificao de funcionamento Datasul Interactive Item analisado Como proceder Resultado (OK/NOK)

5.5.

Instalao Demonstrao do Datasul EMS 2.06B

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

93

Esta instalao tem por finalidade instalar os bancos de dados demonstrao do produto Datasul EMS 2.06B. Esses bancos tm uma licena temporria e utilizados somente para demonstrao das funcionalidades do produto. Como pr-requisito para a instalao Demonstrao, as instalaes Programas e Datasul Interactive devero estar instaladas, veja os procedimentos abaixo:
5.5.1. Procedimentos a serem executados antes da Instalao Demonstrao:

1) Verificar os requisitos de Software (Progress), capitulo 3. Requisitos; 2) Instalar os programas do Produto Datasul EMS, conforme tipo de instalao Programas; 3) Instalar os programas e bancos de dados do Datasul Interactive (Antes da instalao verificar os requisitos, capitulo 3. Requisitos, tpico 3.5 Requisitos Datasul Interactive);
5.5.2. Instalao Demonstrao A seguir detalharemos as telas da instalao Demonstrao:

Tela de Boas Vindas


Essa tela contm informaes de copyright e recomendaes para execuo da instalao. Para continuar, clique em Avanar.

Tela Informaes do Usurio


Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10
94

Nessa tela dever ser digitado o seu nome e a empresa em que voc trabalha. Para continuar, clique em Avanar.

Tela de seleo de Pas


Nessa tela dever ser selecionado o Pas de Instalao do Produto. A configurao do produto varia de acordo com a seleo do pas. Para continuar, clique em Avanar.

Tela Tipo de Instalao


Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10
95

Para instalar a demonstrao do produto dever ser selecionado o tipo de Instalao Demonstrao. Esse tipo de instalao ir configurar o produto Datasul EMS 2.06B para demonstrao de suas funcionalidades. Para continuar, clique em Avanar.

Tela Destino do Aplicativo


Na tela Destino do Aplicativo dever ser informado o diretrio de destino do Produto EMS 2.06B, ou seja, onde ser baixada a demonstrao do produto Datasul EMS 2.06B. Antes de instalar, verifique se possui espao em disco suficiente. Para continuar, clique em Avanar.

Tela Diretrio Progress


Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10
96

Nessa tela dever ser informado o diretrio onde o aplicativo Progress encontra-se instalado. Caso esse aplicativo ainda no esteja instalado, cancele a instalao e providencie a instalao do Progress. Para continuar, clique em Avanar

Tela Alterao dos Servios


Nesta tela dever ser informado um nmero inicial para configurao das portas TCP/IP que sero utilizados na carga dos bancos de dados demonstrao do produto Datasul EMS 2.06B. Deve ser verificado se as 30 portas subseqentes informada esto livres na tabela de Servios. Este numero inicial dever ser o mesmo informado na instalao Datasul Interactive Para continuar, clique em Avanar.

Tela Configurao Progress Explorer Tool


Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10
97

A seguir voc possui a opo de alterar automaticamente o arquivo conmgr.properties. recomendada a utilizao dessa opo, por que essa opo ir configurar automaticamente o aplicativo Progress Explorer Tool para os bancos de dados do EMS. Caso no deseje alterar o arquivo conmgr.properties, selecione a opo No fazer qualquer modificao. Caso deseje salvar em outro arquivo, selecione a opo Salvar as modificaes no conmgr.properties.new, este arquivo ser criado no diretrio scripts da instalao do produto. Para continuar, clique em avanar.

Tela Cpia de Arquivos


Nesta tela contm as informaes digitadas nas telas anteriores. Caso alguma informao esteja incorreta, utilize o boto Voltar e retorne at a mesma para correo. Para iniciar a instalao do produto clique em Avanar.

5.5.3. Procedimentos aps a instalao Demonstrao:

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

98

1) Os bancos de dados devem ser carregados, devido a utilizao do Datasul Interactive. Carregue os bancos do datasul EMS com o script ems2startdb.bat criado no <diretrio de instalao demonstrao>\scripts ou via Progress Explorer Tool (caso tenha selecionado para alterar o arquivo conmgr.properties do Progress na Tela Progress Explorer Tool da instalao Demonstrao). No esquea de carregar o banco eip do Datasul Interactive, criado na instalao Datasul Interactive. Para isso, existe um script chamado DIstartDB.bat criado na mesma instalao ou utilize o Progress Explorer Tool (caso tenha selecionado para alterar o arquivo conmgr.properties do Progress na Tela Progress Explorer Tool da instalao Datasul Interactive). 2) Verifique se os services (Parmetro -S) criados para os bancos demonstrao so os mesmos que esto no arquivo ems2mult.pf (<diretrio de instalalo demonstrao>\scripts)e no script de carga dos bancos, ems2startdb.bat (<diretrio de instalao demonstrao>\scripts) ou no Progress Explorer Tool, atente para a tela Alterao dos Services desta instalao. 3) Idem ao item 4 para a instalao do Datasul Interactive, os arquivos a serem verificados so: eipmult.pf (<diretrio de instalao Datasul Interactive>\scripts)e DIstartDB.bat (<diretrio de instalao Datasul Interactive>\scripts) 4) Aps a instalao demonstrao, caso tenha solicitado para carregar os bancos de dados pelo Progress Explorer Tool, necessrio que o Servio Adimin service do progress seja reiniciado. Para isso utilize a tela de servios do Windows:

5) Altere o numero inicial de agentes, mnimo de agentes e mximo de agentes nas propriedades do servio WebSpeed criado na instalao Datasul Interactive para 1. Siga os procedimentos a seguir: Abra o Progress Explorer Tool, em Webspeed clique com o boto direito do mouse + propriedades do servio WebSpeed Datasul Interactive. Em Agente + Intervalo de pooling, altere o Numero inicial de agentes, Mnimo de agentes e Mximo de agentes para 1 conforme tela a seguir:

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

99

Clique em OK.

Reinicie o servio WebSpeed Datasul Interactive, para isso clique no boto Parar e aps Iniciar, veja a tela:

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

100

6) Para acessar o Datasul EMS demonstrao informe a seguinte URL no Browser Internet Explorer, http://<nome-maquina>/diretrio-virtual, onde: nome-maquina: Nome da maquina local, normalmente pode ser utilizado localhost; diretrio-virtual: Diretrio virtual criado na instalao Datasul Interactive 7) Usurio e senha para acesso aos bancos demonstrao: Usurio: demo senha: demo 8) Segue tela de exemplificando o Datasul EMS demo:

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

101

5.6.

Instalao Servidor de Aplicao

Esta instalao tem por finalidade baixar os componentes necessrios para executar os programas RPC/RPW. Permite voc instalar os programas do produto caso no tenha instalado, alterar o arquivo host e sevice da maquina. A seguir detalharemos a instalao do servidor de aplicao.

Seleo do Idioma
Selecione o idioma de sua preferncia e clique em avanar.

Tela de Boas Vindas


Clique em Avanar para continuar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

102

Tela Informaes do Usurio


Nessa tela dever ser digitados o seu nome e a empresa em que voc trabalha. Para continuar, clique em Avanar.

Tela de seleo de Pas


Nessa tela dever ser selecionado o Pas de Instalao do Produto. A configurao do produto varia de acordo com a seleo do pas. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

103

Tela Tipo de Instalao


Para instalar o Servidor de Aplicao dever ser selecionado o tipo de Instalao Servidor de Aplicao. Esse tipo de instalao ir baixar os componentes necessrios para a execuo do programas RPC/RPW do produto Datasul EMS 2.06B. Para continuar, clique em Avanar.

Tela Sistema Operacional


Na tela Sistema Operacional dever ser selecionado o Sistema Operacional que ser instalado o servidor de aplicao. Para instalao em Windows NT/2000 ser necessrio executar a instalao no prprio servidor. Para instalao em UNIX, poder ser executado em qualquer estao Windows 9x. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

104

Sistema Operacional Windows NT/2000

Tela Servidor de Aplicao


Nesta tela dever ser informado o tipo de servidor de aplicao a ser instalado, RPC ou RPW. Clique em avanar para continuar.

RPC

Pergunta
Nesta tela dever ser informado se os programas do produto j foram baixados ou no.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

105

Caso os programas j foram instalados:

Tela Pasta de Origem de Programas


Nesta tela dever ser informada a localizao dos programas do produto Datasul-EMS 2.06B. Para continuar, clique em Avanar.

Tela Pasta de Instalao


Na tela Pasta de Instalao dever ser informado o diretrio de destino dos programas do Servidor de Aplicao, ou seja, onde sero baixados os programas do Servidor de Aplicao. Antes de instalar, verifique se possui espao em disco suficiente. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

106

Tela Diretrio do Progress


Dever ser informado o diretrio onde o aplicativo Progress est instalado. Caso esse aplicativo ainda no esteja instalado, cancele a instalao do produto Datasul-EMS 2.06B e providencie a instalao do Progress. Clique em avanar para continuar.

Tela Arquivo de conexo com os bancos(PF)


Nesta tela dever ser informado o arquivo de conexo com os bancos de dados do produto, ex: ems2mult.pf. Este arquivo no dever ter os parmetros -T, -p, -param e -basekey. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

107

Tela Appserver
Esta tela serve para a informao de um nome para o servio Appserver que ser criado no Progress Explorer Tool. Para continuar, clique em Avanar.

Tela Modificao de Arquivos


Nesta tela voc possui a opo de alterar automaticamente o arquivo ubroher.properties de acordo com o nome do servio appserver informado na tela anterior. Caso no deseje alterar o arquivo ubroquer.properties, selecione a opo No fazer qualquer modificao. Caso deseje salvar em outro arquivo, selecione a opo Salvar as modificaes no ubroquer.properties.new. Para continuar, clique em avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

108

Tela Cpia de Arquivos


Esta tela contem informaes das telas anteriores, caso alguma informao nesta tela esteja incorreta clique em voltar e faa as alteraes necessrias. Para continuar clique em avanar.

Caso os programas do Datasul-EMS 2.06B no foram instalados:

Tela Pasta de Instalao


Nesta tela dever ser informado o local em que sero instalados os programas do produto Datasul-EMS 2.06B e tambm os programas do Servidor de Aplicao. Para continuar clique em avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

109

Tela Diretrio do Progress


Neta tela dever ser informada a localizao do aplicativo Progress. Caso este aplicativo no tenha sido instalado, providencie a instalao do mesmo. Clique em avanar para continuar.

Tela Arquivo de conexo com os bancos(PF)


Nesta tela dever ser informado o arquivo de conexo com os bancos de dados do produto. Este arquivo no dever ter os parmetros -T, -p, -param e -basekey. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

110

Tela Appserver
Esta tela serve para a informao de um nome para o servio Appserver que ser criado no Progress Explorer Tool. Para continuar, clique em Avanar.

Tela Modificao de Arquivos


Nesta tela voc possui a opo de alterar automaticamente o arquivo ubroher.properties de acordo com o nome do servio appserver informado na tela anterior. Caso no deseje alterar o arquivo ubroquer.properties, selecione a opo No fazer qualquer modificao. Caso deseje salvar em outro arquivo, selecione a opo Salvar as modificaes no ubroquer.properties.new. Para continuar, clique em avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

111

Tela Cpia de Arquivos


Esta tela contem informaes das telas anteriores, caso alguma informao nesta tela esteja incorreta clique em voltar e faa as alteraes necessrias. Para continuar clique em avanar.

RPW

Pergunta
Nesta tela dever ser informado se os programas do produto j foram baixados ou no.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

112

Caso os programas j foram instalados:

Tela Pasta de Origem de Programas


Nesta tela dever ser informada a localizao dos programas do produto Datasul EMS 2.06B. Para continuar, clique em Avanar.

Tela Pasta de Instalao


Na tela Pasta de Instalao dever ser informado o diretrio de destino dos programas do Servidor de Aplicao, ou seja, onde sero baixados os programas do Servidor de Aplicao. Antes de instalar, verifique se possui espao em disco suficiente. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

113

Tela Diretrio do Progress


Dever ser informado o diretrio onde o aplicativo Progress est instalado. Caso esse aplicativo ainda no esteja instalado, cancele a instalao do produto Datasul EMS 2.06B e providencie a instalao do Progress. Clique em avanar para continuar.

Tela Servidor de Bancos de Dados


Nesta tela dever ser informado o nome e endereo IP do servidor onde esto instalados os banco de dados do produto Datasul EMS 2.06B. Clique em avanar para continuar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

114

Tela Modificao de Arquivos


Nesta tela voc possui a opo de alterar automaticamente o arquivo hosts de acordo com as informaes da Tela Servidor Banco de Dados. recomendada a utilizao dessa opo. Caso no deseje alterar o arquivo hosts, selecione a opo No fazer qualquer modificao. Caso deseje salvar em outro arquivo, selecione a opo Salvar as modificaes no host.new. Para continuar, clique em avanar.

Tela Alterao de Servios


Nesta tela dever ser informado um nmero inicial para configurao das portas TCP que sero utilizados na carga dos bancos de dados do produto Datasul EMS 2.06B. Deve ser verificado se as 30 portas subseqentes informada esto livres na tabela de Servios. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

115

Tela Cpia de Arquivos


Esta tela contem informaes das telas anteriores, caso alguma informao nesta tela esteja incorreta clique em voltar e faa as alteraes necessrias. Para continuar clique em avanar.

Caso os programas do Produto Datasul-EMS 2.06B no foram instalados

Tela Pasta de Instalao


Nesta tela dever ser informado o local em que sero instalados os programas do produto Datasul EMS e tambm os programas do Servidor de Aplicao. Para continuar clique em avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

116

Tela Diretrio do Progress


Neta tela dever ser informada a localizao do aplicativo Progress. Caso este aplicativo no tenha sido instalado, providencie a instalao do mesmo. Clique em avanar para continuar.

Tela Servidor de Bancos de Dados


Nesta tela dever ser informado o nome e endereo IP do servidor onde esto instalados os banco de dados do produto Datasul EMS 2.06B. Clique em avanar para continuar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

117

Tela Modificao de Arquivos


Nesta tela voc possui a opo de alterar automaticamente o arquivo hosts de acordo com as informaes da Tela Servidor Banco de Dados. Caso no deseje alterar o arquivo hosts, selecione a opo No fazer qualquer modificao. Caso deseje salvar em outro arquivo, selecione a opo Salvar as modificaes no host.new. Para continuar, clique em avanar.

Tela Alterao de Servios


Nesta tela dever ser informado um nmero inicial para configurao das portas TCP que sero utilizados na carga dos bancos de dados do produto Datasul EMS 2.06B. Deve ser verificado se as 30 portas subseqentes informada esto livres na tabela de Servios. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

118

Tela Cpia de Arquivos


Esta tela contem informaes de outras telas, caso possua algum item incorreto nesta tela clique em voltar e faa as devidas alteraes. Clique em avanar para continuar.

Sistema Operacional HPUX

Pergunta
Dever ser informado se os programas do produto Datasul EMS 2.06B foram instalados ou no.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

119

Caso os programas do produto Datasul j foram instalados:

Tela Pasta de Origem dos Programas


Nesta tela dever ser informada a localizao dos programas do produto Datasul EMS 2.06B. Isso necessrio para que seja ajustada a varivel PROPATH. Clique em avanar para continuar.

Tela Pasta de Instalao


Na tela Pasta de instalao dever ser informado o diretrio de destino dos programas do servidor de aplicao. Para esse tipo de instalao, ser criado um diretrio chamado ftptemp no diretrio escolhido. Isso se faz necessrio para a transferncia dos arquivos via protocolo FTP. Antes de instalar, verifique se possui espao em disco suficiente no servidor de bancos. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

120

Tela diretrio do Progress no Unix


Dever ser informado o diretrio de instalao do aplicativo Progress no UNIX.

Tela de Instalao no UNIX


Dever ser informado o diretrio no UNIX onde sero instalados os programas do Servidor de Aplicao no UNIX. Essa instalao feita atravs de FTP. Clique em avanar para continuar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

121

Tela Mquina UNIX


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

Tela Alterao de Servios no UNIX


Nesta tela dever ser informado um nmero inicial para configurao das portas TCP que sero utilizados na carga dos bancos de dados do produto Datasul EMS 2.06B. Deve ser verificado se as 30 portas subseqentes informada esto livres na tabela de Servios. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

122

Tela Servidor de Banco de Dados


Nesta tela dever ser informado o nome e endereo IP do servidor onde esto instalados os banco de dados do produto Datasul EMS 2.06B. Clique em avanar para continuar.

Tela Modificao de Arquivos


Nesta tela voc possui a opo de alterar automaticamente o arquivo hosts de acordo com as informaes da Tela Servidor Banco de Dados. Caso no deseje alterar o arquivo hosts, selecione a opo No fazer qualquer modificao. Caso deseje salvar em outro arquivo, selecione a opo Salvar as modificaes no host.new. Para continuar, clique em avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

123

Tela Usurio do Servidor UNIX


Nesta tela devero ser informados o nome do usurio e sua senha no servidor aplicao. aconselhvel que o usurio seja administrador(root) do servidor. Para continuar, clique em Avanar.

Tela Cpia de Arquivos


Nesta tela existem informaes que correspondem a outras telas, caso encontre alguma irregularidade nesta tela, clique em voltar e faa as alteraes necessrias. Clique em avanar para continuar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

124

Caso os programas do produto Datasul no foram instalados:

Tela Pasta de Instalao


Na tela Pasta de instalao dever ser informado o diretrio de destino dos programas do servidor de aplicao. Para esse tipo de instalao, ser criado um diretrio chamado ftptemp no diretrio escolhido. Isso se faz necessrio para a transferncia dos arquivos via protocolo FTP. Antes de instalar, verifique se possui espao em disco suficiente no servidor de bancos. Para continuar, clique em Avanar.

Tela diretrio do Progress no Unix


Dever ser informado o diretrio de instalao do aplicativo Progress no UNIX.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

125

Tela de Instalao no UNIX


Dever ser informado o diretrio no UNIX onde sero instalados os programas do Servidor de Aplicao no UNIX. Essa instalao feita atravs de FTP. Clique em avanar para continuar.

Tela Mquina UNIX


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

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

126

Tela Alterao de Servios no UNIX


Nesta tela dever ser informado um nmero inicial para configurao das portas TCP que sero utilizados na carga dos bancos de dados do produto Datasul EMS 2.06B. Deve ser verificado se as 30 portas subseqentes informada esto livres na tabela de Servios. Para continuar, clique em Avanar.

Tela Servidor de Banco de Dados


Nesta tela dever ser informado o nome e endereo IP do servidor onde esto instalados os banco de dados do produto Datasul EMS 2.06B. Clique em avanar para continuar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

127

Tela Modificao de Arquivos


Nesta tela voc possui a opo de alterar automaticamente o arquivo hosts de acordo com as informaes da Tela Servidor Banco de Dados. Caso no deseje alterar o arquivo hosts, selecione a opo No fazer qualquer modificao. Caso deseje salvar em outro arquivo, selecione a opo Salvar as modificaes no host.new. Para continuar, clique em avanar.

Tela Usurio do Servidor UNIX


Nesta tela devero ser informados o nome do usurio e sua senha no servidor aplicao. aconselhvel que o usurio seja administrador(root) do servidor. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

128

Tela Cpia de Arquivos


Nesta tela existem informaes que correspondem a outras telas, caso encontre alguma irregularidade nesta tela, clique em voltar e faa as alteraes necessrias. Clique em avanar para continuar.

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

Pergunta
Dever ser informado se os programas do produto Datasul EMS 2.06B foram instalados ou no.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

129

Caso os programas do produto Datasul j foram instalados:

Tela Pasta de Origem dos Programas


Nesta tela dever ser informada a localizao dos programas do produto Datasul EMS 2.06B. Isso necessrio para que seja ajustada a varivel PROPATH. Clique em avanar para continuar.

Tela Pasta de Instalao


Na tela Pasta de instalao dever ser informado o diretrio de destino dos programas do servidor de aplicao. Para esse tipo de instalao, ser criado um diretrio chamado ftptemp no diretrio escolhido. Isso se faz necessrio para a transferncia dos arquivos via protocolo FTP. Antes de instalar, verifique se possui espao em disco suficiente no servidor de bancos. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

130

Tela diretrio do Progress no Unix


Dever ser informado o diretrio de instalao do aplicativo Progress no UNIX.

Tela de Instalao no UNIX


Dever ser informado o diretrio no UNIX onde sero instalados os programas do Servidor de Aplicao no UNIX. Essa instalao feita atravs de FTP. Clique em avanar para continuar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

131

Tela Mquina UNIX


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

Tela Alterao de Servios no UNIX


Nesta tela dever ser informado um nmero inicial para configurao das portas TCP que sero utilizados na carga dos bancos de dados do produto Datasul EMS 2.06B. Deve ser verificado se as 30 portas subseqentes informada esto livres na tabela de Servios. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

132

Tela Servidor de Banco de Dados


Nesta tela dever ser informado o nome e endereo IP do servidor onde esto instalados os banco de dados do produto Datasul EMS 2.06B. Clique em avanar para continuar.

Tela Modificao de Arquivos


Nesta tela voc possui a opo de alterar automaticamente o arquivo hosts de acordo com as informaes da Tela Servidor Banco de Dados. Caso no deseje alterar o arquivo hosts, selecione a opo No fazer qualquer modificao. Caso deseje salvar em outro arquivo, selecione a opo Salvar as modificaes no host.new. Para continuar, clique em avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

133

Tela Usurio do Servidor UNIX


Nesta tela devero ser informados o nome do usurio e sua senha no servidor aplicao. aconselhvel que o usurio seja administrador(root) do servidor. Para continuar, clique em Avanar.

Tela Cpia de Arquivos


Nesta tela existem informaes que correspondem a outras telas, caso encontre alguma irregularidade nesta tela, clique em voltar e faa as alteraes necessrias. Clique em avanar para continuar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

134

Caso os programas do produto Datasul no foram instalados

Tela Pasta de Instalao


Na tela Pasta de instalao dever ser informado o diretrio de destino dos programas do servidor de aplicao. Para esse tipo de instalao, ser criado um diretrio chamado ftptemp no diretrio escolhido. Isso se faz necessrio para a transferncia dos arquivos via protocolo FTP. Antes de instalar, verifique se possui espao em disco suficiente no servidor de bancos. Para continuar, clique em Avanar.

Tela diretrio do Progress no Unix


Dever ser informado o diretrio de instalao do aplicativo Progress no UNIX.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

135

Tela de Instalao no UNIX


Dever ser informado o diretrio no UNIX onde sero instalados os programas do Servidor de Aplicao no UNIX. Essa instalao feita atravs de FTP. Clique em avanar para continuar.

Tela Mquina UNIX


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

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

136

Tela Alterao de Servios no UNIX


Nesta tela dever ser informado um nmero inicial para configurao das portas TCP que sero utilizados na carga dos bancos de dados do produto Datasul EMS 2.06B. Deve ser verificado se as 30 portas subseqentes informada esto livres na tabela de Servios. Para continuar, clique em Avanar.

Tela Servidor de Banco de Dados


Nesta tela dever ser informado o nome e endereo IP do servidor onde esto instalados os banco de dados do produto Datasul EMS 2.06B. Clique em avanar para continuar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

137

Tela Modificao de Arquivos


Nesta tela voc possui a opo de alterar automaticamente o arquivo hosts de acordo com as informaes da Tela Servidor Banco de Dados. Caso no deseje alterar o arquivo hosts, selecione a opo No fazer qualquer modificao. Caso deseje salvar em outro arquivo, selecione a opo Salvar as modificaes no host.new. Para continuar, clique em avanar.

Tela Usurio do Servidor UNIX


Nesta tela devero ser informados o nome do usurio e sua senha no servidor aplicao. aconselhvel que o usurio seja administrador(root) do servidor. Para continuar, clique em Avanar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

138

Tela Cpia de Arquivos


Nesta tela existem informaes que correspondem a outras telas, caso encontre alguma irregularidade nesta tela, clique em voltar e faa as alteraes necessrias. Clique em avanar para continuar.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

139

5.7.

Instalando o Integrator

Dentro do diretrio onde o EMS foi instalado, na pasta interfac\integrator, voc deve executar o arquivo executvel do produto. O assistente de Instalao do Integrator abrir, clique em Avanar para iniciar a instalao.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

140

Selecione o local onde o Integrator ser instalado e clique em Prximo.

Os arquivos de instalao sero extrados para o diretrio escolhido.

Selecione os pacotes a serem instalados

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

141

Aguarde o Trmino da progresso do processo de instalao.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

142

Verifique o relatrio da instalao apresentado na tela acima.

5.8.1 Licenciando o Integrator

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

143

Caso voc ainda no tenha solicitado a licena de uso do Integrator, os seguintes passos devero ser adotados: Acesso ao Portal de Clientes Datasul (http://www.datasul.com.br/portal) No menu escolha a opo Suporte > Solicitao de mdias > Solicitao de validao No campo Produto, selecionar a opo Integrator Cliente 1.00 Multiidioma No campo IP, inserir o nmero IP da mquina que est instalado o Integrator Submeter o formulrio Ser encaminhada para o cliente aps o envio do formulrio a chave necessria para funcionamento do Integrator, que o arquivo integrator.certs gerado por servidor com base no endereo IP de onde o produto estar instalado. Este arquivo deve ser copiado para a pasta raiz onde o Integrator foi instalado. Para maiores informaes sobre instalao, configurao e utilizao do Integrator, consulte o Integrator HTML Documentation, que est disponvel no menu principal do Integrator.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

144

5.9. Inicializando o Aplicativo Datasul-EMS


Nas instalaes em modo Datasul Interactive (Programas), criado um atalho de Inicializao 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, necessrios para o incio da operao do aplicativo. Alm disso, executa o Otimizador de Performance (maiores detalhes desta funo, consultar o manual de referncia do produto, funo Otimizador de Performance), efetua o registro do produto no arquivo correspondente e cadastra o usurio super para acesso ao sistema.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

145

importante salientar que clientes que no tenham PROGRESS Full (com licena de desenvolvimento), devem atentar para os .DFs gerados pelo Otimizador de Performance, abaixo da pasta OP do diretrio temporrio da sesso, pois ser necessrio aplic-los (seguindo o mesmo procedimento de atualizao dos pacotes de atualizao do produto) no final desta inicializao. Aps executar a inicializao, dever ser adicionada a validao do produto atravs da execuo do programa btb\btb932za.r, conforme tela abaixo:

5.10. Reinstalando
possvel reinstalar qualquer um dos componentes bsicos (banco de dados, programas,Datasul Interactive, aplicao e demonstrao), basta executar novamente o setup localizado no CD-ROM. Levar em considerao algumas recomendaes: a) Se o produto j estiver operando, importante que o diretrio de localizao da reinstalao do componente banco de dados no seja o mesmo que o utilizado na primeira instalao. Este procedimento evita que dados j includos sejam eliminados. Somente sobreponha os arquivos quando tiver certeza do que realmente necessita. b) Se necessita de uma nova instalao, primeiramente remova a instalao do aplicativo (veja captulo 5) e concluda esta etapa, j ser possvel a nova instalao. O procedimento de reinstalao que ser usado com mais freqncia ser a reinstalao de novos programas do aplicativo que foram alterados e corrigidos. Neste caso, basta utilizar o mesmo o setup, para baixar no mesmo diretrio dos programas atuais.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

146

6. Remover a Instalao
O procedimento para remover a instalao do produto simples e automtico e deve ser utilizado quando no se necessita mais de algum componente em alguma(s) determinada(s) mquina(s). Existem vrios exemplos onde esta situao pode ocorrer: eliminar os programas de determinado servidor, eliminar todo o aplicativo de todas as mquinas, etc. Este procedimento sempre deve ser executado na(s) mesma(s) CPU onde foi feita a instalao do aplicativo, por exemplo, para remover o componente banco de dados, use a mquina onde foi instalado este componente. Todos os objetos criados durante a instalao (criao de arquivos, diretrios, atalhos e entradas no registro) so armazenados num arquivo de log de instalao que pode ser utilizado para remover a instalao do produto. Este arquivo encontra-se no diretrio de instalao e o nome do arquivo Uninstxx.isu , onde xx depende do tipo de instalao. Se este arquivo no existir, o procedimento para a remoo da instalao dever ser manual, eliminando os objetos criados durante a instalao. Para eliminar qualquer componente da instalao proceda da seguinte forma, lembrando que deve ser feito na mesma CPU onde o produto foi instalado: a) No Windows, clique no boto Iniciar / Configuraes / Painel de Controle / Adicionar ou Remover Programas. Ser apresentada ao usurio uma tela conforme abaixo:

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

147

b) Selecione o componente que deseja eliminar e clique no boto Adicionar/Remover. Logo aps, confirme a eliminao do aplicativo. c) A seguir, ser apresentada a tela Desinstalaro concluda informando os objetos que esto sendo eliminados.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

148

Este procedimento no elimina os arquivos criados aps a instalao, tais como: arquivos temporrios, before-image dos bancos, etc. Verifique o destino destes arquivos e, se for o caso, elimine-os.

6.9. Removendo a Instalao Multiusurio


Os componentes da instalao Multiusurio possuem diversos arquivos compartilhados. Quando a instalao desses componentes feita em uma mesma mquina, a remoo de qualquer um deles eliminar os arquivos compartilhados, o que prejudicar os componentes restantes. Para evitar problemas, uma das opes abaixo deve ser utilizada: a) Eliminar todos os componentes instalados na mquina. b) Aps a remoo de um ou mais componentes, os restantes devem ser reinstalados.

7. Atualizao de Programas
Depois que o produto j estiver em operao a Datasul disponibilizar pacotes de atualizao do produto englobando alterao para correo de erros, correes legais e

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

149

novas implementaes. Estes pacotes de atualizao periodicamente so incorporados a mdia de instalao. Enquanto no so incorporados mdia, os pacotes so copiados para o diretrio patches em formato .zip. A mdia de instalao tambm pode ser utilizada para atualizao de programas, primeiramente voc dever executar o setup.exe e fazer uma instalao Multiusurio / Programas informando o diretrio destino como sendo o diretrio onde os programas residem atualmente no servidor de arquivos, com isso os pacotes de atualizao so baixados automaticamente com verses mais recentes de programas. Finalmente voc dever buscar no site ECS da Datasul os novos pacotes disponibilizados (www.datasul.com.br/expedicao). As atualizaes automticas de pacotes esto disponveis para as instalaes Programa e tambm converso.

8.

Instalando o Produto em WEB

Este captulo descreve os procedimentos para instalao do produto EMS2 para WEB. Somente o EMS2, a partir da release 2.02 est disponvel para WEB, portanto os produtos EMS5 e HCM no esto disponveis. Vale ressaltar que nem todas as transaes do ambiente client-server esto disponveis para WEB.

8.9. Requisitos
Para este tipo de instalao so necessrios os seguintes requisitos de software, hardware e de conhecimento: 8.9.1. Produto EMS 2 Instalado necessrio que o produto EMS2 esteja instalado e funcional na verso clientserver. Os primeiros captulos deste documento tratam deste procedimento. 8.9.2. WebServer Instalado necessrio 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 necessrio que a licena WEBSpeed esteja instalada. A verso do WEBServer deve ser compatvel com a verso do WEBSpeed, consulte a documentao de instalao do WEBSpeed para verificar as compatibilidades. recomendado que os servidores WEBSpeed e WEBServer estejam instalados separadamente dos servidores de banco de dados, de aplicao e de arquivos.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

150

8.9.4. Browser Instalado Cada estao de usurio 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 instalao do produto em ambiente WEB requer conhecimentos em instalao, configurao e arquitetura dos servios WEB. Tambm requer conhecimento em administrao dos servios WEBSpeed, por exemplo, o utilitrio Progress Explorer Tool, e os componentes da arquitetura WEBSpeed (agentes, broker, nameserver, adminserver, messenger). Caso tenha dvidas, consulte o manual de instalao do WEBSpeed.

8.10. Etapas de instalao do produto em Web


Alguns dos procedimentos abaixo esto sendo repetidos a fim de ressalt-los, pois j foram descritos no item de requisitos deste documento. 8.10.1. Instalao do Datasul EMS2 client-server Realize a instalao do produto EMS2 de acordo com os procedimentos descritos nos primeiros captulos deste documento. Os componentes: Banco de dados, Programa e Datasul Interactive so obrigatrios. Caso seja uma instalao nova, isto , as bases no sofreram processo de converso, preciso que estas sejam inicializadas. Caso tenha dvidas, verifique o item 5.8. Inicializando o Aplicativo Datasul-EMS. 8.10.2. Instalao do WebServer Realize a instalao e configurao do servidor WEB de acordo com o item 3.5.3.3 Requisito para Servidor WEB. Aps a instalao, verifique se o servio WEB est funcionando corretamente informando no browser WEB a URL http://localhost. Dever aparecer uma pgina WEB de bem-vindo ao IIS. 8.10.3. Instalao do WebSpeed Realize a instalao e configurao do servidor WEBSpeed de acordo com o item 3.5.3.3 Requisito para Servidor WEB. 8.10.4. Diretrio de programas do EMSWEB Os objetos que so necessrios para o componente WEB do EMS so os mesmos do diretrio de programas baixados durante a instalao da rea de programas na instalao client-server. Se houver necessidade os arquivos desta rea podem ser copiados para uma rea no servidor WEB. Em conseqncia, todas as atualizaes de programas do produto devem ser aplicadas para esta rea tambm.

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

151

8.10.5. Criao 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 diretrio. Na criao do alias deve ser informado o subdiretrio 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 dvidas, acesse a documentao do software para realizar esta configurao. 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 aparea uma mensagem de arquivo no encontrado (erro 404) a configurao do alias no foi bem sucedida.

8.10.6. Servio AdminService Aps realizar o procedimento do item 8.2.3. Instalao do software WEBSpeed, o servio AdminService criado automaticamente. Acesse o gerenciador de servios do Windows, selecione o servio AdminService e clique nos botes Iniciar Servio ou Interromper Servio. Em ambiente Unix o servio carregado pelo script proadsv localizado no subdiretrio bin do Progress. Utilize o parmetro start para iniciar e stop para interromper o servio. Digitando apenas proadsv, possvel visualizar as opes de parmetros para este comando. Configure para que este servio seja iniciado automaticamente com o sistema operacional. OBS: Caso os programas do produto no estejam no mesmo servidor onde est configurado o WEBSpeed, recomendvel configurar o AdminService com um usurio e senha que possua permisso de acesso rea de programas da rede.

8.10.7. NameServer Com o servio AdminService carregado possvel administrar o servidor atravs de uma estao (ou pelo prprio servidor, se este for Windows) usando a ferramenta Progress Explorer Tool. Esta ferramenta disponibilizada durante a instalao de qualquer produto Progress em ambiente Windows e este produto deve ter a mesma verso 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 inicializao seja automtica. O NameServer controla um conjunto de Brokers WEBspeed registrados. 8.10.8. Criao do broker emsweb no WEBSpeed A configurao do broker feita no Progress Explorer Tool. Verifique se j existe um servidor localhost abaixo de Console Root Progress Explorer. Caso contrrio, clique com o boto direito no cone Progress Explorer e selecione Adicionar Servidor Progress....

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

152

Informe o nome ou IP do servidor local ou remoto e o usurio. A senha pode ser salva para que a conexo ao servidor seja feita de forma automtica quando acessado o Proexp. Clique com o boto 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 (diferenciao entre maisculo e minsculo).

Acesse as propriedades do broker criado e expanda os dois nveis (Broker e Agente) para visualizar as opes de configurao do broker. Realize a configurao do Broker e do Agente de acordo com as informaes abaixo: Broker / Geral / Modo Operacional: Stateless

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

153

Broker / Geral / Inicializao Automtica: Sim Broker / Geral / Diretrio de trabalho: Diretrio de programas do EMS2 Inicializao automtica

Agente / Geral / Parmetros de Inicializao do Agente: -p web/objects/web-disp.p -weblogerror -cpterm iso8859-1 -cpstream ibm850 pf <Nome_pf_conexo_bancos>.pf Agente / Geral / PROPATH: Diretrio de programas do EMS2 Modo de aplicao do agente: Produo

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

154

8.10.9. Configurao de broker com bancos unificados

Para o EMSWeb com bancos unificados necessrio 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 nvel "Agente" para visualizar suas opes de configurao. No campo "Parmetros de inicializao do agente", altere o valor do parmetro (-p) para o caminho e nome do arquivo de alias. Veja a figura abaixo:

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

155

8.10.10.

Acesso ao EMSWEB atravs 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 instalao do Messenger. Verifique a documentao da instalao 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 referncia para o produto EMSWEB


Para que os manuais de referncia do produto (Ajuda) sejam acessados com sucesso, necessrio a criao do diretrio virtual help20, onde o caminho fsico informado deve ser a estrutura de arquivos (fsica) at o subdiretrio "dochtm" (subdiretrio onde foram baixados os arquivos de "Ajuda" do produto)

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

156

Guia de Instalao DATASUL-EMS 2.06B OpenEdge 10

157