Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
06B OpenEdge 10
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
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
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
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
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.
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.
1.4.
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
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.
Rede TCP/IP
Usurios
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.
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
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
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
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
Confiabilida Padronizao de Normal Normal Alta Alta Alta OK OK/No adotado OK OK/No utilizado OK
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.
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
12
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.
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.
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.
3.4.
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.
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;
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.
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
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;
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/
17
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
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
19
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:
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.
21
5.2.
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.
22
23
24
Nova Instalao
25
26
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:
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
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.
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.
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.
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
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
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.
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.
35
36
Nessa tela dever ser digitados o seu nome e a empresa em que voc trabalha. Para continuar, clique em Avanar.
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.
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.
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.
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.
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.
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.
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:
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
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.
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.
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.
46
47
48
49
50
51
52
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.
53
54
Apache
55
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:
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:
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\Dataviewer\DataViewer 2.3\scripts\grd.pf
URL
http://<Nome_do_Servidor>/scripts/cgiip.exe/WService=<Nome_do_S ervio_WebSpeed>/wgp/wgp0006.p
59
60
61
62
5.4.5.1.
63
64
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.
65
66
5.4.5.2.
67
68
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.
70
71
5.4.5.3.
72
73
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.
74
75
5.4.5.4.
76
77
5.4.5.5.
78
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.
79
80
81
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.
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.
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)
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.
85
86
5.4.8.3.
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:
87
88
5.4.8.4.
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%&PASS=%PASS%&PR ODUCT=DT_EMS2&DEPTH=1 </Menu> <Company ID="*"> <Shortcut Description="Local" Path=""c:\dlc91\bin\prowin32.exe" -pf "C:\EMS204_Suporte_v9\ems2.pf" -ininame "C:\EMS204_Suporte_v9\progresc.ini" -p "Men\men906za.w"" /> </Company> </Product> <VirtualDir>eip_karla</VirtualDir> <Host>tech-karla</Host> <ContextURL> http://eip.datasul.com.br/scripts/cgiip.exe/WService=webdeskeip/wdk/we00011.p?User=datasul </ContextURL> <Program>men/men910za.p</Program> <Language>pt</Language> </EIP>
5.4.8.5.
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%&PASS=%PASS%&PR ODUCT=DT_EMS2&DEPTH=1 </Menu> <Company ID="*"> <Shortcut Description="Local" Path=""c:\dlc91\bin\prowin32.exe" -pf "C:\EMS204_Suporte_v9\ems2.pf" -ininame "C:\EMS204_Suporte_v9\progresc.ini" -p "Men\men906za.w"" /> </Company> </Product>
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.
89
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>
90
...
5.4.8.6.
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
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.
92
Tpico
Roteiro de Verificao de funcionamento Datasul Interactive Item analisado Como proceder Resultado (OK/NOK)
5.5.
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:
Nessa tela dever ser digitado o seu nome e a empresa em que voc trabalha. Para continuar, clique em Avanar.
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.
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
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.
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:
99
Clique em OK.
Reinicie o servio WebSpeed Datasul Interactive, para isso clique no boto Parar e aps Iniciar, veja a tela:
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:
101
5.6.
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.
102
103
104
RPC
Pergunta
Nesta tela dever ser informado se os programas do produto j foram baixados ou no.
105
106
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.
108
109
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.
111
RPW
Pergunta
Nesta tela dever ser informado se os programas do produto j foram baixados ou no.
112
113
114
115
116
117
118
Pergunta
Dever ser informado se os programas do produto Datasul EMS 2.06B foram instalados ou no.
119
120
121
122
123
124
125
126
127
128
Pergunta
Dever ser informado se os programas do produto Datasul EMS 2.06B foram instalados ou no.
129
130
131
132
133
134
135
136
137
138
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.
140
141
142
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.
144
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.
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.
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:
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.
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.
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
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.
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.
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.
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....
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
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
154
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:
155
8.10.10.
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.
156
157