Guia de Instalao

TOTVS Datasul 11

Programas Banco de Dados Servidor de Aplicao Documentao Converso

Instalao de Mltiplas Instncias

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

1.

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

1.1. 1.2. 1.3. 1.4.

2.

Finalidade .......................................................................................................... 4 Pblico Alvo ....................................................................................................... 4 Organizao deste Guia .................................................................................... 4 Documentaes Importantes ............................................................................. 5

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

2.1. Arquitetura Distribuda do produto ..................................................................... 6 2.2. Tipos de Instalao............................................................................................ 7 2.2.1. Alertas durante a instalao ........................................................................... 8
3. Requisitos Mnimos ...................................................................................................................... 8

3.1. Viso Geral dos Requisitos ................................................................................ 8 3.2. Requisitos de Hardware..................................................................................... 9 3.2.1. Requisitos para estao client ........................................................................ 9 3.2.2. Requisitos para servidor ............................................................................... 10 3.3. Requisitos de Software .................................................................................... 10 3.3.1. Progress ....................................................................................................... 10 3.3.2. Java.............................................................................................................. 11 3.3.3. Flash Player e Navegador ............................................................................ 11 3.3.4. Ferramentas de Acesso Remoto .................................................................. 11 3.3.5. Requisitos para bancos Oracle ..................................................................... 11 3.3.6. Requisitos para Client Linux ......................................................................... 12 3.3.6.1. Requisitos para Instalao do Citrix Receiver ........................................ 12 3.3.6.2. Download do Citrix Receiver .................................................................. 13 3.3.6.3. Instalao do Citrix Receiver .................................................................. 13 3.3.6.4. Executando Telas Progress ................................................................... 13 3.4. Requisitos de Usurio (Servidor) ..................................................................... 13
4. Instalao ................................................................................................................................... 14

4.1. Detalhes da Mdia de Instalao ...................................................................... 14 4.2. Planejando a Instalao................................................................................... 14 4.3. Etapas comuns para qualquer tipo de instalao ............................................. 15 4.4. Instalao de Programas ................................................................................. 16 4.5. Instalao de Banco de Dados ........................................................................ 16 4.5.1. Bancos Progress .......................................................................................... 16 4.5.1.1. Configurao do Progress Explorer Tool ................................................ 18 4.5.1.2. Objetos criados na instalao Banco de dados Progress ....................... 18 4.5.1.3. Sistemas Operacionais Unix .................................................................. 19 4.5.1.4. Criao dos bancos com acesso SQL.................................................... 19 4.5.2. Bancos Oracle .............................................................................................. 20 4.5.2.1. Objetos criados na instalao Banco de dados Oracle........................... 21 4.5.2.2. Criao dos Objetos no banco Oracle .................................................... 21

TOTVS S.A.

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

TOTVS S.A.

1. 1.1.

Prefcio Finalidade

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

1.2.

Pblico Alvo

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

1.3.

Organizao deste Guia

Captulo 2, Introduo

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

Captulo 3, Requisitos

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

Captulo 4, Instalao

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

Captulo 5, Atualizao

Este captulo descreve o procedimento de atualizao do produto.

TOTVS S.A.

Captulo 6, Reinstalao

Este captulo descreve os procedimentos a serem executados para a reinstalao de cada componente do Datasul 11, bem como os cuidados necessrios para a execuo dessa rotina.

Captulo 7, Desinstalao

Este captulo descreve os procedimentos necessrios para a desinstalao do Datasul 11.

1.4.

Documentaes Importantes
Manuais Progress Getting Started Installation and Configuration; Getting Started Preinstallation Checklist for Windows; Getting Started Preinstallation Checklist for Unix; Getting Started Database Essentials; Data Management Database Administration; Application Server Administration.

Estas e outras documentaes podem ser obtidas no site da Progress.

Manuais Jboss Installation Guide; Getting Started Guide; Server Configuration Guide.

Estas e outras documentaes podem ser obtidas em Jboss AS Documentation e Jboss Wiki.

Manuais Datasul Connection for Web (GoGlobal) Administrator Guide; License Agreement; Quick Start Guide.

Estas e outras documentaes podem ser obtidas no site da Graphon e GoGlobal. Manuais Datasul Guia de Converso.

TOTVS S.A.

2. 2.1.

Introduo Arquitetura Distribuda do produto

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

Ambiente do Cliente Servidor de Aplicao Servidor de Arquivos

Rede TCP/IP

Usurios

Servidor de Banco de Dados

TOTVS S.A.

2.2.

Tipos de Instalao

Para o funcionamento do produto, necessrio executar a instalao de Programas, Bancos de Dados e Servidor de Aplicao: Programas Instala os programas para utilizao do produto, assim como outros arquivos necessrios para execuo do mesmo.

Banco de Dados Instala e configura os bancos de dados utilizados pelo produto, assim como os scripts para carregar e derrubar esses bancos.

Servidor de Aplicao Instala e configura o Jboss, assim como o Datasul Interactive, sendo esses componentes essenciais para o funcionamento do produto.

Documentao Instala os manuais e documentao do produto.

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

Importante: Esta mdia preparada para instalar vrias instncias do produto Datasul 11 no mesmo servidor. Este procedimento consiste em instalar mltiplas cpias das opes de Banco de Dados, Servidor de Aplicao e Documentao, respeitando o limite mximo de seis instncias. Cada instncia instalada ser nomeada com base na porta principal utilizada pelo Jboss, seguindo a seqncia 8080, 8180, 8280, 8380, 8480 e 8580. As pastas, scripts e servios utilizados na primeira instalao das opes citadas, sero nomeados com o identificador 8080. Para instalar uma segunda instncia destas opes, basta abrir o instalador da mdia e executar novamente estas mesmas opes. A cada execuo ser instalada uma nova cpia e nomeada com base na seqncia descrita

TOTVS S.A.

acima. A rea de programas ser a mesma no ambiente e ser compartilhada por todas as instncias.

2.2.1.

Alertas durante a instalao

Durante a instalao dos produtos Datasul pode ser apresentado alerta para clientes que usam determinados antivrus, acusando a identificao de vrus nos arquivos dos diretrios OCX e Interfac. Isso ocorre em funo dos arquivos executarem rotinas que alguns antivrus identificam como vrus. No entanto, no se caracterizam instrues deste tipo. Desta forma, a mensagem apresentada pode ser desconsiderada.

3.

Requisitos Mnimos

Este captulo tem por objetivo divulgar recomendaes sobre o uso de hardware e software relacionados ao Datasul 11 e algumas informaes sobre a configurao dos mesmos. Estas recomendaes tm por inteno ajudar os clientes na configurao do ambiente, utilizando-o ao mximo, obtendo uma melhor relao custo/benefcio. Porm, no representam compromissos com tecnologias ou algum fornecedor em especial por parte da Totvs. A deciso sobre a tecnologia e fornecedor de competncia do cliente, bem como o nvel de servio, segurana e confiabilidade que deseja do seu ambiente. As posies deste guia tambm podem ser alteradas, isto devido evoluo das tecnologias e dos nossos produtos. importante lembrar que o ambiente Web utilizado pelo Datasul 11 possui maior complexidade que um ambiente client/server padro, como por exemplo, EMS 2, EMS 5, etc. A correta configurao e tuning do ambiente (servidores, redes, clients, banco de dados, etc.) so importantes para o funcionamento do Datasul 11, pois caso parte do ambiente esteja mal configurado, o desempenho do produto como um todo ser afetado. As recomendaes e exemplos citados adiante levam em considerao somente os softwares relacionados ao Datasul 11 e softwares de uso genrico, como Office e e-mail. Caso sejam instalados outros softwares no mesmo ambiente, os mesmos devem ser levados em considerao, sendo que os requisitos descritos podem no ser o suficiente para a execuo de todas as rotinas.

3.1.

Viso Geral dos Requisitos

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

TOTVS S.A.

Disco Memria Processador Software Java OpenEdge

120 GB 4 GB Intel Xeon Dual 2.00 GHz JRE 1.6 10.2B05 Fix 01

Estao Client
Windows Memria (Arquitetura 32-bit) Memria (Arquitetura 64-bit) Processador Resoluo de Tela Flash Navegadores Hardware 1 GB Mnimo (2GB Recomendado) 2 GB Mnimo Intel Pentium IV 2.80 GHz (Pentium DualCore Recomendado) 1024 x 768 ou superior Software Flash Player 10 Internet Explorer 7 Internet Explorer 8 Internet Explorer 9 Firefox 3.5 e 7 JRE 1.6

Java

3.2.
3.2.1.

Requisitos de Hardware
Requisitos para estao client

necessrio que a estao client possua o sistema operacional Windows instalado, devido ao Datasul 11 utilizar a linguagem Progress que possui arquitetura 32-bit (Win32). Informaes adicionais quanto s plataformas e sistemas operacionais homologados podem ser obtidas no site da Progress (Product Availability Guide). No recomendamos o uso de estaes menores que o mnimo acima citado, pois o desempenho no atender s necessidades dos usurios. Caso a empresa possua muitas estaes com configuraes inferiores a mnima recomendada, sugerimos utilizar o recurso de Servidores de Terminais Grficos que utilizar o hardware j existente. A configurao recomendada atende a maioria dos usurios, contudo, para usurios mais exigentes talvez exista a necessidade de uma configurao melhor. Compreenda-se usurio mais exigente por aquele que utilize processos mais pesados (necessidade de uma CPU melhor e uma placa de rede mais rpida e/ou ligada em uma porta de switch 9

TOTVS S.A.

dedicada para ele) ou de um usurio que use vrias aplicaes simultneas (necessidade de mais memria para executar processos como Office, e-mail, CAD, EIS, etc., ao mesmo tempo). Recomendamos a configurao acima citada para novos equipamentos, caso a empresa venha adquirir novas estaes e queira utiliz-las por um longo tempo sem necessidade de upgrade e sem ficarem obsoletos. Tambm foram levadas em considerao s configuraes que os fornecedores de hardware esto oferecendo atualmente e que tenham uma boa relao custo/benefcio. Para todos os casos recomendamos a utilizao de placas de rede de fornecedores de primeira linha.

3.2.2.

Requisitos para servidor

Para os demais tipos de instalao, como Servidor de Aplicao, Banco de Dados e Programas, recomendamos a utilizao do servio de Dimensionamento que pode ser acessado pelo Portal do Cliente.

3.3.
3.3.1.

Requisitos de Software
Progress

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

As licenas Progress embutidas no produto Datasul 11 so:

Licena
Openedge Enterprise RDBMS Openedge DataServer for Oracle OpenEdge DataServer for Microsoft SQL Openedge

Sistema Operacional
Windows Server Unix Windows Server Unix Windows Server Windows

Observao
Instalada no servidor de banco de dados para execuo de rotinas de administrao dos bancos Progress. Somente utilizada com banco de dados Oracle. Pode ser instalada nos clients (DataServer Local) ou no servidor (DataServer Remoto) Somente utilizada com banco de dados SQL Server. Pode ser instalada nos clients (DataServer Local) ou no servidor (DataServer Remoto) Instalada no servidor de aplicao para

TOTVS S.A.

10

Application Server Client Networking

Unix Windows Unix Windows Server

Query / Results Unix

configurao de servios como AppServer, Webspeed, WebServices, etc. Instalada nas estaes client ou no servidor de arquivos (Progress compartilhado). Necessrio tambm no servidor de banco de dados para execuo de rotinas via RPW. Instalada nas estaes client ou no servidor de arquivos (Progress compartilhado) para execuo e compilao de relatrios.

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

3.3.2.

Java

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

3.3.3.

Flash Player e Navegador

Para executar o Datasul 11 nas estaes client, necessrio o Flash Player. Caso no possua instalado, o Flash Player pode ser baixado diretamente do site da Adobe (verso mnima: 9r124)

3.3.4.

Ferramentas de Acesso Remoto

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

3.3.5.

Requisitos para bancos Oracle

Caso voc utilize uma instncia existente, as recomendaes que seguem devem prevalecer perante outros produtos no TOTVS. Para verificar valores de parmetros de base existente, proceda as seguintes consultas e analise os resultados:

TOTVS S.A.

11

select parameter, value from nls_database_parameters where parameter = 'NLS_CHARACTERSET' NLS_LANGUAGE NLS_TERRITORY NLS_CHARACTERSET NLS_NCHAR_CHARACTERSET

AMERICAN AMERICA WE8ISO8859P1 AL16UTF16

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

3.3.6.

Requisitos para Client Linux

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

3.3.6.1.

Requisitos para Instalao do Citrix Receiver

TOTVS S.A.

12

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

3.3.6.2.

Download do Citrix Receiver

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

3.3.6.3.

Instalao do Citrix Receiver

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

3.3.6.4.

Executando Telas Progress

No menu do produto ao selecionar um tem que execute uma tela Progress, ser apresentado uma janela para login no Datasul Connection for Web. Aps informar usurio/senha e domnio, o sistema executar via o Citrix Receiver a tela Progress correspondente.

3.4.

Requisitos de Usurio (Servidor)

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

TOTVS S.A.

13

4. 4.1.

Instalao Detalhes da Mdia de Instalao

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

4.2.

Planejando a Instalao

Mostraremos agora as etapas que devem ser seguidas para a instalao e configurao do Datasul 11, de acordo com os tipos de instalao disponveis na mdia (Programas, Banco de dados e Servidor de Aplicao). Defina a topologia do ambiente. Nesta etapa, deve ser definido onde cada componente ser instalado. Escolha o hardware que ser utilizado como servidor de banco de dados, servidor de arquivos, servidor de aplicao e tambm as mquinas que estaro disponveis aos usurios. Para cada um destes componentes, verifique se os requisitos de hardware e software so atendidos; Instale os programas no servidor de arquivos; Instale os bancos de dados; Instale o servidor de aplicao; Carregue os bancos de dados utilizando os scripts pelo aplicativo Openedge Explorer; Inicialize o produto utilizando o atalho criado em Iniciar > Programas > TOTVS Datasul > Administrao > Inicializador do Produto durante a instalao do servidor de aplicao; Inicie o Jboss atravs do servio TOTVS Datasul - <ID> criado no Services do Windows.

Aps a concluso destas etapas, o produto estar pronto para utilizao. TOTVS S.A. 14

4.3.

Etapas comuns para qualquer tipo de instalao

ALERTA: Antes de iniciar a instalao, necessrio copiar todo o contedo do DVD2 para o DVD1. Caso isto no seja feito, a instalao ser interrompida no meio do processo.

As etapas abaixo so comuns para todos os tipos de instalao do Datasul 11:

Tela Informe o ID para esta instalao

Dever ser informado um identificador (ID) para esta instalao. Como o diretrio de instalao do produto padro, este ID necessrio para evitar sobreposio de arquivos quando existir mais de uma instalao do produto no mesmo servidor. Tela de Registro do usurio

Informe o Nome do Usurio e o Nome da Empresa que utilizar o Datasul 11. Selecione Avanar para continuar. No so permitidos caracteres especiais neste campo, pois podem ocorrer erros no acesso ao produto. Tela de Drives disponveis

Nesta tela sero exibidos os drives disponveis para a instalao do produto. Selecione um drive e clique em avanar. Lembrando que somente aparecero os drives locais (unidades mapeadas no so exibidas). Aps clicar em avanar ser exibida uma tela informando se o espao em disco suficiente para a instalao da mdia. Se houver espao, ser exibida somente uma tela informativa, mostrando que o espao suficiente. Se no houver espao, a instalao questionar se deseja selecionar outro drive. Caso informe que no, a instalao no ir prosseguir. Neste caso, libere espao em disco e inicie novamente o instalador. Tela do tipo de instalao

Selecione o tipo de instalao que ser executado neste momento. Lembrando que deve ser seguida a ordem apresentada: Programas Banco de dados Servidor de Aplicao Documentao Console de Converso

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

TOTVS S.A.

15

4.4.

Instalao de Programas

Ao selecionar a opo Programas sero instalados os objetos Progress utilizados pelo Datasul 11. A rea de programas ser instalada na estrutura <Drive>:\Totvs\Datasul\<ID>\ERP. O diretrio ERP dever estar acessvel a todos os usurios que utilizaro o Datasul 11, devido execuo dos programas Progress. ALERTA: A instalao da rea de programas pr-requisito para a instalao dos demais componentes da mdia de instalao. O instalador contm binrios compilados para 32-bit e 64-bit. Defina atravs das opes do menu quais binrios sero instalados. Se selecionada qualquer opo para Caracter 32 ou Caracter 64, ser criado um diretrio chamado char32 ou char64, respectivamente dentro dos diretrios do produto. Para dar continuidade ao processo, selecione Avanar. Neste momento ter incio a instalao dos programas. Ao final deste processo, o instalador retornar a tela de seleo do Tipo de Instalao.

4.5.

Instalao de Banco de Dados

Ao selecionar a opo Banco de Dados sero instalados e configurados os bancos utilizados pelo Datasul 11.

4.5.1.

Bancos Progress

Tela Seleo de ID

Se a instalao de Bancos de Dados for feita no mesmo servidor onde foi feita a instalao da rea de programas, esta tela ser apresentada. Neste caso, informe Sim para utilizar o ID que foi previamente criado. Se existir mais de 1 ID registrado, ser solicitado qual ID deseja utilizar. Tela de alterao dos servios

Informe o nmero inicial da porta TCP/IP a ser configurada para carga dos bancos. As portas TCP/IP sero configuradas de forma seqencial. Nesse caso, antes de informar o nmero inicial da porta, recomendamos verificar se as prximas 60 portas TCP/IP subseqentes tambm esto livres. Selecione Avanar para continuar. Tela de configurao do Progress Explorer Tool

TOTVS S.A.

16

Essa tela definir de que forma ser configurado o arquivo conmgr.properties do Progress. Esse o arquivo responsvel pela configurao dos bancos que sero administrados pelo Progress Explorer Tool. Permitir que o InstallShield modifique o arquivo conmgr.properties Ao selecionar essa opo, o arquivo conmgr.properties localizado abaixo do diretrio properties de instalao do Progress, ser alterado. Nesse caso, aps iniciar o servio do AdminService possvel visualizar os bancos pelo Progress Explorer Tool. Com essa instalao, tambm criado um arquivo conmgr.properties abaixo do diretrio scripts de instalao dos bancos de dados, contendo a configurao dos bancos utilizados pelo Datasul 11. Salvar as alteraes necessrias para o arquivo conmgr.properties.new Ao selecionar essa opo, ser criado o arquivo conmgr.properties.new abaixo diretrio properties de instalao do Progress e o arquivo conmgr.properties original do Progress no ser alterado. Nesse caso, antes de iniciar o servio do AdminService necessrio renomear o arquivo conmgr.properties.new para conmgr.properties e assim ser possvel visualizar os bancos pelo Progress Explorer Tool. Com essa instalao, tambm criado um arquivo conmgr.properties abaixo do diretrio scripts de instalao dos bancos de dados, contendo a configurao dos bancos utilizados pelo Datasul 11. No fazer nenhuma alterao Ao selecionar essa opo, ser criado o arquivo conmgr.properties abaixo do diretrio scripts de instalao dos bancos de dados, contendo a configurao dos bancos utilizados pelo Datasul 11 e o arquivo conmgr.properties localizado abaixo do diretrio properties de instalao do Progress no ser alterado. Nesse caso, antes de iniciar o servio do AdminService necessrio copiar o arquivo conmgr.properties localizado abaixo do diretrio scripts para o diretrio properties do Progress e assim ser possvel visualizar os bancos pelo Progress Explorer Tool. Selecione Avanar para continuar.

Tela para Informaes da Instalao

Esta tela contm um resumo das informaes digitadas nas telas anteriores. Caso alguma informao esteja incorreta, selecione a opo Voltar para efetuar as devidas correes. Ao selecionar a opo Avanar, os bancos sero instalados e configurados.

TOTVS S.A.

17

4.5.1.1.

Configurao do Progress Explorer Tool

Os bancos utilizados pelo produto so configurados para serem iniciados pelo Progress Explorer Tool (proexp). Esse aplicativo Progress uma ferramenta grfica que possibilita criar, configurar, iniciar e parar os servios administrados pelo AdminService local ou remoto, como por exemplo banco de dados, Webspeed, AppServer, entre outros. A administrao dos bancos e servios configurados no Progress Explorer Tool tambm pode ser executada via linha de comando. ALERTA: Os bancos emsfnd, emsdev, finance, payroll, ems2sor e mdtfrw, mdmerge e mdtcrm, possuem uma configurao diferenciada. Para cada banco acima referenciado, existe um broker especfico para conexes do tipo SQL. A configurao feita no Progress Explorer Tool durante a instalao de banco de dados bsica, ou seja, suficiente para iniciar os bancos e executar o teste de acesso ao produto. Aps finalizar a instalao e configurao do Datasul 11, a parametrizao dos bancos e sesso (.pf) deve ser revista, adequando-os de acordo com os recursos disponveis no servidor de banco dados e volume de conexes/processos, tendo como objetivo atender as requisies com um melhor desempenho. A anlise do ambiente e acerto das parametrizaes pode ser feito junto consultoria de Banco de Dados, pelo telefone 4003-0015, opes "02" Software > "03" Consultoria Tcnica > "04" Datasul > "08" Tecnologia > "03" Banco de Dados. Informaes adicionais sobre esse servio podem ser obtidas no suporte telefnico, pelo nmero 4003-0015, opes "02" Software > "02" Suporte Tcnico > "04" Datasul > "08" Tecnologia > "03" Banco de Dados.

4.5.1.2.

Objetos criados na instalao Banco de dados Progress

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

Localizao
<Dir Instal Bancos>\scripts

Objeto
ReparaBancos.bat

Descrio
Script para reparar a estrutura dos bancos. Script para derrubar os bancos iniciados de forma manual (proserve ou _mprosrv) ou iniciados pelo script datasulCargaBancos.bat. Script para iniciar os bancos. Ao iniciar os bancos por esse script, os

<Dir Instal Bancos>\scripts

datasulDescargaBancos.bat

<Dir Instal Bancos>\scripts

datasulCargaBancos.bat

TOTVS S.A.

18

<Dir Instal Bancos>\scripts

conmgr.properties

bancos no sero gerenciados pelo Progress Explorer Tool. Arquivo responsvel pela configurao dos bancos que sero administrados pelo Progress Explorer Tool.

4.5.1.3.

Sistemas Operacionais Unix

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

4.5.1.4.

Criao dos bancos com acesso SQL

Os bancos emsdev, emsfnd, payroll, finance, ems2sor, mdtfrw, mdmerge e mdtcrm possuem acesso SQL e devem ser criados de acordo com os procedimentos descritos abaixo (para sistema operacional que no seja Windows ou para bancos criados manualmente): Acessar o console do servidor de banco de dados; Definir as variveis do Progress

export DLC=<Dir Instal Progress> export PATH=<Dir Instal Progress>/Bin:$PATH Criar o banco de dados

prodb <nome banco> <Dir Instal Progress>/empty8 Acessar o Data Administration do Progress, conectando o banco de dados em modo mono usurio

pro -Mm 4096 -cpstream ibm850 -d dmy -E -rx -db <banco> -1 -p _admin.p Executar o load de definies (.df) pelo Admin > Load Data and Definitions > Data Definitions (.df file), para os bancos emsfnd e ems2uni; DICA: As definies (.df e .dfsql) podem ser obtidas abaixo da estrutura <Dir Instal Bancos>\database\definicoes.

TOTVS S.A.

19

Criar o usurio sysprogress, senha sysprogress e o usurio pub, senha pub pelo Admin > Security > Edit User List; Fechar a sesso Progress e carregar o banco com um broker SQL

proserve <banco> -S <porta> -N TCP -H <nome servidor banco> <parmetros> proserve <banco> -S <porta> -N TCP -H <nome servidor banco> -m3 ServerType SQL <parmetros>

Acessar um client Windows com Progress instalado; Acessar o proenv do Progress em Iniciar > Programas > Progress > Proenv; Executar o load das definies (.dfsql) para os bancos emsdev, finance e payroll;

sqlexp user sysprogress password sysprogress -url jdbc:datadirect:openedge://<nome servidor banco>:<porta do broker SQL>;databaseName=<banco> -infile <arquivo.dfsql> DICA: A porta do broker a porta definida para o parmetro -S ao carregar o banco com o parmetro -ServerType SQL. Conectar via SQL Explorer o banco mdtfrw e dar permisses de DBA para o usurio pub, atravs dos comandos abaixo: password sysprogress servidor banco>:<porta do -url broker

sqlexp user sysprogress jdbc:datadirect:openedge://<nome SQL>;databaseName=<banco> Grant dba to pub; Commit;

ALERTA: O banco mdtfrw no possui definio. Ele deve ser criado vazio e conectado ao produto desta forma, pois as tabelas so criadas dinamicamente na carga do Jboss. Aps a execuo desses procedimentos, os bancos utilizados pelo Datasul 11 estaro instalados e configurados.

4.5.2.

Bancos Oracle ALERTA: Para a utilizao do produto, o valor da NLS_LANG dever estar configurado para AMERICAN_AMERICA.WE8ISO8859P1, tanto no servidor quanto nas estaes cliente.

TOTVS S.A.

20

Tela Instncia Oracle

Informar o nome da instncia do Oracle que ser utilizada para armazenar os objetos desta instalao. Tela Configurao do Servidor Oracle

Informe nesta tela o nome do servidor e a porta do Listener para esta instncia. Estas informaes sero utilizadas para criar os objetos no banco Oracle. Tela Localizao dos Datafiles

Informar o diretrio onde deseja armazenar os Datafiles dos tablespaces que sero utilizados para o produto Datasul 11. Tela para Informaes da Instalao

Esta tela contm um resumo das informaes digitadas nas telas anteriores. Caso alguma informao esteja incorreta, selecione a opo Voltar para efetuar as devidas correes. Ao selecionar a opo Avanar, sero criados os scripts para criao dos objetos nos bancos Oracle, bem como sero copiados os Schema Holder.

4.5.2.1.

Objetos criados na instalao Banco de dados Oracle

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

Localizao
<Dir Instal Bancos>\scripts <Dir Instal Bancos>\scripts <Dir Instal Bancos>\scripts

Objeto
criaObjetoOracle.sql criaTablespaceOracle.sql criaUsuarioOracle.sql

Descrio
Script para criar os objetos (tabelas, ndices, etc.) no banco Oracle. Script para criar os tablespaces para o produto Datasul 11 no banco Oracle. Script para criar os usurios do produto Datasul 11 no banco Oracle. Script que gerencia a chamada dos demais scripts Oracle. Este arquivo dever ser executado para que os objetos sejam criados no banco Oracle. Script para reparar a estrutura dos bancos Schema Holder.

<Dir Instal Bancos>\scripts

gerenciadorScripts.sql

<Dir Instal Bancos>\scripts

ReparaBancos.bat

4.5.2.2.

Criao dos Objetos no banco Oracle

TOTVS S.A.

21

A mdia de instalao no cria automaticamente os objetos no banco Oracle. Para criar estes objetos o script gerenciadorScripts.sql dever ser executado manualmente, conforme procedimentos abaixo: Acessar o Sql Plus com o usurio System na instncia onde sero criados os objetos; Executar o comando @<Dir Instal Bancos>\scripts\gerenciadorScripts.sql; Verificar ao final do processo se foram gerados erros nos arquivos de log, localizados no diretrio <Dir Instal Bancos>\spool.

4.6.

Instalao do Servidor de Aplicao

Ao selecionar a opo Servidor de Aplicao sero instalados e configurados servios do Jboss e Datasul Interactive para execuo do Datasul 11. Seguem as etapas para a execuo desse processo: Tela Local de destino

Informar o diretrio onde ser instalado o Servidor de Aplicao no servidor. Recomendamos o diretrio default sugerido pela mdia de instalao. Tela de execuo remota

Caso sejam efetuadas conexes remotas para acesso ao Datasul 11 via Datasul Connection for Web (GoGlobal), Citrix ou Terminal Server deve ser selecionada a opo Sim. Do contrrio, deve ser selecionada a opo No para dar continuidade instalao. Ao selecionar a opo Sim, ser apresentada a tela de seleo do tipo de acesso remoto. Selecione o tipo de instalao e preencha conforme solicitado: Datasul Connection for Web URL: URL que contm as libs do Datasul Connection for Web (GoGlobal); Servidor: Informar o servidor onde se encontra instalado o Datasul Connection for Web; Porta: Informe uma porta disponvel no servidor para comunicao entre o Jboss e Datasul Connection for Web. Terminal Server Porta: Informe uma porta disponvel no servidor para comunicao entre o Jboss e o Terminal Server; Servidor: Informe o servidor onde est publicada a aplicao no Terminal Server; Porta Metaframe: Informe a porta utilizada pelo Terminal Server.

TOTVS S.A.

22

Citrix URL: URL em que a pasta DatasulCtxWI ser publicada (ver configurao do Citrix neste mesmo Guia); Servidor: Informar o servidor onde est publicada a aplicao no Citrix; Porta: Informe uma porta disponvel no servidor para comunicao entre o Jboss e Citrix.

Selecione Avanar para continuar. Tela Nome da mquina

Informe o nome do servidor onde esto instalados os bancos de dados do produto Datasul 11. Selecione Avanar para continuar. Tela do Single Sign On

O Single Sign On (Josso) instalado e configurado junto com o Jboss. Dessa forma, informe o hostname do servidor de aplicao onde est sendo instalado o Jboss e a porta de comunicao com o Jboss. ALERTA: Caso seja informado localhost no campo servidor, o acesso ao Datasul 11 somente ser feito onde est sendo instalado o servidor de aplicao. A porta padro de comunicao com o Jboss 8080. Selecione Avanar para continuar. Tela Nameserver

Informe o nome da mquina e nmero de porta do Nameserver do Progress. Caso no tenha alterado, a porta padro 5162. Estas informaes so utilizadas para conexo com o AppServer criado durante a instalao. Selecione Avanar para continuar. DICA: Essa informao pode ser obtida no arquivo ubroker.properties, localizado abaixo do diretrio properties do Progress. O parmetro que define a porta de comunicao com o Nameserver o portNumber, abaixo da estrutura [Nameserver] ou [Nameserver.XXX]. Por padro o Nameserver utilizado o NS1 com a porta UDP 5162.

Tela de Configuraes do Jboss

Informe o nmero da porta de acesso ao Jboss. Recomendamos utilizar a porta padro (8080). Tela de configurao do Progress Explorer Tool

Essa tela definir de que forma ser configurado o arquivo ubroker.properties do Progress. Esse o arquivo responsvel pela configurao do servio AppServer Datasul que ser administrado pelo Progress Explorer Tool. TOTVS S.A. 23

 Permitir que o InstallShield modifique o arquivo ubroker.properties Ao selecionar essa opo, o arquivo ubroker.properties localizado abaixo do diretrio properties de instalao do Progress ser alterado. Nesse caso, aps iniciar o servio do AdminService possvel visualizar os servios pelo Progress Explorer Tool. Salvar as alteraes necessrias para o arquivo ubroker.properties.new Ao selecionar essa opo, ser criado o arquivo ubroker.properties.new abaixo diretrio properties de instalao do Progress e o arquivo ubroker.properties original do Progress no ser alterado. Nesse caso, antes de iniciar o servio do AdminService necessrio renomear o arquivo ubroker.properties.new para ubroker.properties e assim ser possvel visualizar o servio AppServer Datasul pelo Progress Explorer Tool. No fazer nenhuma alterao Ao selecionar essa opo, ser criado o arquivo ubroker.properties abaixo do diretrio scripts da instalao do servidor de aplicao, contendo a configurao do servio AppServer utilizado pelo produto e o arquivo ubroker.properties localizado abaixo do diretrio properties de instalao do Progress no ser alterado. Nesse caso, antes de iniciar o servio do AdminService necessrio copiar o arquivo ubroker.properties localizado abaixo do diretrio scripts para o diretrio properties do Progress e assim ser possvel visualizar o servio AppServer pelo Progress Explorer Tool.

Tela de configurao do License Server

Informe o servidor do License Server e a porta. Tela informaes da instalao

Esta tela contm um resumo das informaes digitadas nas telas anteriores. Caso alguma informao esteja incorreta, selecione a opo Voltar para efetuar as devidas correes. Ao selecionar a opo Avanar, os servios sero instalados e configurados. Ao finalizar as configuraes ser solicitado um usurio e senha de rede para configurao com o Active Directory (AD). ALERTA: A senha do usurio informado no pode ter o caractere &, sendo que isso ocasionar falha na inicializao do Jboss. necessrio neste processo informar um usurio e senha vlidos no AD, caso contrrio no ser possvel configurar o arquivo de autenticao utilizado pelo Josso. Posteriormente ser apresentada uma mensagem informando que a configurao com o Active Directory foi concluda corretamente. Aps a configurao com o Active Directory ser apresentada a tela de concluso da instalao do Servidor de Aplicao. TOTVS S.A. 24

ALERTA: Caso o servidor de Bancos de dados seja diferente de Windows, as portas de conexo devero ser alteradas no arquivo progress-ds.xml, localizado no diretrio deploy da instncia do Jboss.

4.6.1.

Objetos criados na instalao do Servidor de Aplicao

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

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

Objeto
config.xml

Descrio
Arquivo responsvel pela configurao dos atalhos para acesso ao produto. Arquivo de inicializao da sesso que contem configuraes de ambiente, como por exemplo, fontes, cores, PROPATH, outros. Script de alias utilizado para acesso ao produto. Script de alias utilizado pelo servio AppServer datasul. Programa utilizado para inicializao do produto. Arquivo que contem os parmetros de sesso e parmetros de conexo com os bancos. Arquivo responsvel pela configurao do servio AppServer datasul que ser administrado pelo Progress Explorer Tool.

datasul-progress.ini

datasul-configxml-alias.p

datasul-appserver-alias.p

datasul-aliasIni.p

datasul.pf

ubroker.properties

4.7.

Instalao da Documentao

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

4.8.

Instalao do Console de Converso

TOTVS S.A.

25

Ao selecionar a opo "Console de Converso", sero instalados os objetos necessrios para realizar a converso dos produtos legados para o Datasul 11. Seguem as etapas para execuo desse processo: Tela com o Tipo de Instalao

Nesta tela deve ser selecionado o produto origem para a converso. Pode-se selecionar somente um produto por vez. Tela de seleo da Release

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

Informe o diretrio onde sero instalados os programas de converso. Caso o diretrio no exista, ele ser criado. Os programas de converso devem ser instalados no mesmo diretrio, sendo que o Console de Converso ser nico para todos os produtos. Tela de seleo do diretrio de instalao do Progress

Caso o diretrio do Progress no seja detectado, esta tela ser apresentada. Neste caso, informe o diretrio onde o Progress 10.2B est instalado. Tela de resumo da instalao

Nesta tela ser informado um resumo das opes escolhidas nas telas anteriores. Confira as informaes e modifique-as, caso necessrio. Ao clicar no boto Avanar a cpia dos arquivos se iniciar. Tela fim da instalao

Esta tela informar o fim do processo de cpia dos arquivos. Pressione o boto Concluir para concluir a etapa. ALERTA: O atalho de acesso ao Console de Converso e O Guia de Converso sero instalados no desktop da mquina onde o console foi instalado.

4.9.

Inicializando o Datasul 11

TOTVS S.A.

26

Durante a instalao do Servidor de Aplicao criado um atalho para inicializao do produto em Iniciar > Programas > TOTVS Datasul > Administrador. Nesta etapa, os bancos de dados devem estar carregados. Seguem as etapas para a execuo dessa rotina: Tela para configurao da empresa, pas e idioma

Informe o nome da empresa que utilizar o Datasul 11, o CNPJ (somente nmeros), o pas e o estado de localizao da empresa, bem como o idioma para utilizao. Selecione

para continuar.
Tela de configurao dos produtos

Informe o produto que deve ser inicializado para utilizao no Datasul 11. Por padro, todos os produtos esto definidos para inicializao (Sim). Para alterar essa informao, d um clique duplo na linha do produto. Selecione para continuar. Tela de strings, mensagens e literais

Informe a localizao dos arquivos de strings externas (<Dir Instal Programas>\univdata\pt.d), mensagens (<Dir Instal Programas>\univdata\msg.d) e literais (<Dir Instal Programas>\univdata\liter.d). Selecione para continuar. Tela de inicializao do banco de dados emsdev

Nesta tela informe a localizao do arquivo de parmetros (<Dir Instal Programas>\fnd\men\importador\parametros-[instncia].properties), de acordo com a instncia que est sendo inicializada. Informar tambm o diretrio de localizao dos arquivos .jar (<Dir Instal Programas>\fnd\men). Selecione para continuar. Tela de configurao Bancos X Empresa

Os bancos apresentados nessa tela so os mesmos configurados para conexo no arquivo .pf, localizado abaixo da estrutura <Dir Instal Programas>\scripts. Selecione Iniciar para continuar. Nesse momento ser executada a inicializao do produto. A ltima etapa do processo de inicializao a importao de dados para o banco de dados emsdev. Durante esta etapa, a tela do Inicializador ficar travada. Ao final ser apresentado em tela o arquivo btb907za.txt, gerado abaixo do diretrio raiz de instalao dos programas. Esse arquivo um log dos procedimentos executados. Depois de verificar o log gerado, feche o arquivo e selecione concluindo o processo.

ALERTA: Deve ser verificada a existncia de registros na tabela StringTable. Caso a mesma esteja vazia, execute via Prompt de Comando o script importacaoByYou.bat, localizado abaixo do diretrio raiz de instalao dos 27

TOTVS S.A.

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

4.10. Acesso ao Datasul 11

Durante a instalao do Servidor de Aplicao criado um atalho em Iniciar > Programas > TOTVS Datasul. Porm, antes de acessar o produto, devem ser executados os seguintes procedimentos: Carregar os bancos de dados; DICA: Os bancos Progress podem ser carregados via Progress Explorer Tool ou pelos scripts datasulCargaBancos.bat.

Iniciar o servio AppServer datasul-[ID]-[instncia]; DICA: O servio AppServer pode ser iniciado via Progress Explorer Tool ou via linha de comando pelo asbman.

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

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

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

4.11. Acesso Remoto

TOTVS S.A.

28

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

4.11.1.

Datasul Connection for Web (GoGlobal)

Para que o Datasul Connection for Web (GoGlobal) funcione corretamente ser necessrio apontar o caminho dos arquivos .jar e .cab, e scripts Java disponibilizados na instalao. Seguem os procedimentos a serem executados para que o acesso remoto seja executado corretamente: Instalar a licena Progress Client Networking no servidor do Datasul Connection for Web (GoGlobal). Instalar o Java 1.6. Criar uma aplicao no GoGlobal Cluster Manager > Applications > Add. Display Name o nome da aplicao que ser executada (para que esta configurao funcione corretamente, o valor deste campo dever ser DI); Executable Path Deve apontar para o java.exe, localizado abaixo da estrutura <Dir Instal Java>\ bin\java.exe; Start Directory Diretrio temporrio para a sesso; Startup State Normal.

Configurar o log do GoGlobal em Tools > Server Options > Log. Recomendamos o nvel 6 de log para que sejam mostrados todos os eventos.

ALERTA: Todos os usurios do sistema operacional devem ter acesso e permisso nos diretrios e programas definidos no PROPATH da sesso, assim como aos arquivos .ini, .pf, datasul-framework-citrixproxy-java-1.0.2.jar e Progress. Caso os usurios no possuam permisso, ser registrado o erro abaixo no log do GoGlobal. Corp40743 on Costao, pw (7512) Failed to assess if launch request for "DI," process handle 0x000002b4, is pending (code 3/WLE288).
175 2009-04-07 14:07:29.811

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

TOTVS S.A.

29

Informar o tipo de conexo remota (GOGLOBAL). Ex: <RemoteConnectionType>GOGLOBAL</RemoteConnectionType> RemoteServerPort Informe uma porta de comunicao com o Datasul Connection for Web (GoGlobal). Ex: <RemoteServerPort>8085</RemoteServerPort> RemoteShortcut Description Informe os parmetros para execuo da sesso Progress. Ex: <RemoteShortcut Description="GOGLOBAL"
\\f16\erp\scripts\proxy-1.0.0.jar &quot;c:\dlc102b\bin\prowin32.exe&quot; &quot;\\f16\ERP\scripts\emsmult.pf&quot; &quot;\\f16\ERP\scripts\ems.ini&quot; &quot;men\men906za.p&quot;" />

Path="-jar

MetaframeServer Informe nome ou IP do servidor GoGlobal. Ex: <MetaframeServer>legacy2</MetaframeServer> MetaframeServerLibURL Informe a URL onde se encontram os componentes do GoGlobal (este diretrio virtual dever estar publicado em servidor Web). Ex:<MetaframeServerLibUrl>http://legacy2/goglobal</MetaframeServerLibUrl> ALERTA: Se algum dos parmetros acima descritos no estiver configurado corretamente, os programas no sero executados. Caso haja alguma tag vazia, recomendamos remov-la do arquivo (realizar um backup prvio do arquivo).

DICA: Com a configurao padro do GoGlobal, a cada solicitao de abertura de um programa do produto, ser solicitado autenticao do sistema operacional. Para que esta solicitao de autenticao ocorra apenas uma vez, habilitar no GoGlobal a opo Cache passwords on the client, localizada em Tools > Server Options> Security.

4.11.2.

Citrix Meta Frame

necessrio a instalao da Web Interface do Citrix para o funcionamento do acesso remoto pelo produto.

TOTVS S.A.

30

Seguem os procedimentos a serem executados para que o acesso remoto seja executado corretamente: Instalar a licena Progress Client Networking no servidor do Citrix. Instalar o Java 1.6. Copiar os arquivos citrix.properties, citrix.bat e datasul-framework-citrixproxy-java1.0.2.jar, localizados na pasta scripts abaixo do diretrio onde foi instalado o servidor de aplicao, para uma pasta no servidor Citrix. Criar uma aplicao no Citrix Management Console em Presentation Server > NomeFarm > Applications > New > Publish application (esta aplicao dever estar visvel aos usurios via Web Interface). Display Name o nome da aplicao que ser executada (no exemplo, Datasul11); Type Installed application; Command line Deve apontar para o arquivo citrix.bat, seguido dos caracteres %* Ex: C:\AtalhosDatasul11\citrix.bat" %* ALERTA: Aps a aplicao do Hotfix Rollup Pack 2 ou superior do Presentation Server, o servidor Citrix bloqueia os parmetros vindos do client. Nesse caso, no local de %* deve ser utilizado %**. Working Directory Apontar para um diretrio temporrio para a sesso; Servers Informe o servidor onde ser executada a sesso Progress; Users Allow only configured Users Informe os usurios que devem ter acesso a aplicao via Citrix;

ALERTA: Todos os usurios do sistema operacional devem ter acesso e permisso nos diretrios e programas definidos no PROPATH da sesso, assim como, aos arquivos .ini, .pf, datasul-framework-citrixproxy-java-1.0.2.jar, citrix.bat, citrix.properties e Progress. Publicar na intranet um diretrio virtual (IIS) onde estaro localizados os arquivos de configurao do acesso remoto. O Caminho fsico dever apontar para o diretrio jboss_home\DatasulCtxWI. Este diretrio virtual precisa ter permisso para executar arquivos .aspx (do .NET); Os arquivos da pasta DatasulCtxWI publicada so 32-bits. Caso o servidor onde o diretrio virtual foi publicado seja 64-bits, necessrio configurar o IIS para executar em modo 32-bits. A partir do IIS 7, possvel criar um novo pool de aplicativos e configurar somente este pool para executar em modo 32-bits, relacionando a pasta criada a este. Aps criar o diretrio virtual, configurar o arquivo web.config abaixo da pasta DatasulCtxWI, conforme orientaes abaixo:

TOTVS S.A.

31

 <add key=" CtxWIConfigFile"

value="C:\caminhoWebinterface\WebInterface.conf"/>

Deve ser informado o caminho completo do arquivo WebInterface.conf do Citrix. Caso o diretrio virtual esteja em um servidor IIS diferente do WebInterface, o arquivo WebInterface.conf pode ser copiado para um diretrio local, como a prpria pasta DatasulCtxWI. <add key=" CtxFarmName" value="SUPORTE"/> Informar o nome da Farm do citrix onde o atalho para o arquivo citrix.bat foi publicado. ALERTA: No servidor IIS onde o diretrio virtual foi publicado, requisito possuir o .NET Framework 3.5 instalado, bem como o visual J# 2.0 (Redistributable Package). Ambos podem ser localizados no Download Center da Microsoft. Editar o arquivo citrix.properties e configurar conforme orientaes: path=C:/dlc102b/bin/prowin32.exe Informar o caminho do executvel progress no servidor citrix. pf=C:/totvs/datasul/11.5.0/ERP/scripts/datasul.pf Informar caminho ao arquivo .pf do ambiente utilizado. ini=C:/totvs/datasul/11.5.0/ERP/scripts/datasul-progress.ini Informar caminho ao arquivo .ini do ambiente utilizado. p=C:/totvs/datasul/11.5.0/ERP/scripts/datasul-configxml-alias.p Informar caminho ao arquivo de alias do ambiente utilizado. Editar o arquivo config.xml localizado abaixo da estrutura <Dir Instal Programas>\scripts. Segue os itens a serem configurados nesse arquivo, sendo que as tags no citadas no devero ser alteradas: RemoteConnectionType Informar o tipo de conexo remota (CITRIX). Ex: <RemoteConnectionType>Citrix</RemoteConnectionType> RemoteServerPort Informe uma porta que servir de comunicao entre o Jboss e o Citrix. Ex: <RemoteServerPort>8085</RemoteServerPort> RemoteShortcut Description Informe uma descrio para a conexo. A valor do item Path pode ficar em branco, Ex: <RemoteShortcut Description="Citrix" Path="" />

TOTVS S.A.

32

 MetaframeServer Informe o nome ou endereo IP do servidor Citrix. Ex: <MetaframeServer>citrixserver</MetaframeServer> ASPHttpServer Informe a URL para o diretrio virtula publicado anteriormente: Ex: <ASPHttpServer>http://citrixserver/DatasulCtxWI</ASPHttpServer> MetaframeServerId Informe o nome da aplicao criada no servidor Citrix. Ex: <MetaframeServerId>Datasul11</MetaframeServerId> ALERTA: Se algum dos parmetros acima descritos no estiver configurado corretamente, os programas no sero executados. Caso haja alguma tag vazia, recomendamos remov-la do arquivo (realizar um backup prvio do arquivo).

4.11.3.

Terminal Server

necessrio que o Terminal Server esteja instalado no servidor onde ser feito o acesso remoto. Seguem os procedimentos a serem realizados para o acesso remoto via Terminal Server: Instalar a licena Progress Client Networking no servidor do Terminal Server. Instalar o Java 1.6. Configurar o Terminal Server para Permitir que os usurios iniciem programas listados e no listados na conexo inicial. Esta configurao necessria pois no haver nenhuma aplicao publicada no Terminal Server. A linha de comando e os parmetros para abertura da sesso Progress no servidor remoto sero enviadas pelo Datasul 11. Configurar o arquivo config.xml localizado abaixo da estrutura <Dir Instal Programas>\scripts. Segue os itens a serem configurados nesse arquivo, sendo que as tags no citadas no devero ser alteradas: RemoteConnectionType Informar o tipo de conexo remota (Terminal Server). Ex: <RemoteConnectionType>TerminalServer</RemoteConnectionType> RemoteServerPort Informe uma porta que servir de comunicao entre o Jboss e o Terminal Server. Ex: <RemoteServerPort>8085</RemoteServerPort> MetaframeServer

TOTVS S.A.

33

Informe o nome ou endereo IP do servidor Terminal Server. Ex: <MetaframeServer>serverts</MetaframeServer> MetaframeServerPort Informe a porta de acesso ao Terminal Server. Ex: <MetaframeServerPort>3389</MetaframeServerPort> RemoteShortcut Description Informe os parmetros para execuo da sesso Progress. Ex: <RemoteShortcut Description="TS"
Path="&quot;c:\dlc102b\bin\prowin32.exe&quot; -pf &quot;\\serverts\ERP\scripts\emsmult.pf&quot; -ininame &quot;\\serverts\ERP\scripts\ems.ini&quot; -p &quot;\\serverts\erp\scripts\alias.p&quot;" />

ALERTA: O contedo da Tag "RemoteShortcut" no pode conter path maior que 80 caracteres, por restries da passagem de parmetros ao Terminal Server. Caso este valor for ultrapassado, poder ser apresentado o erro 560 do Progress.

4.12. Ajustes aps instalao

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

4.12.1.

Permisso de sequences

Quando no forem utilizados os bancos de dados criados automaticamente pela mdia de instalao, necessrio dar permisso de select e update para o usurio pub nas sequences seq_configur e seq_propried. Esta permisso impacta diretamente na persistncia das configuraes do usurio. Caso no sejam dadas as permisses para as Sequences, nenhuma configurao de usurio ser salva, ocasionando vrios erros em tela. Acessar o SQL Explorer atravs do Proenv, conectando o banco emsfnd; Sqlexp db emsfnd H <hostname> -S <servio> -user sysprogress password sysprogress Utilizar os comandos abaixo para dar as permisses na sequence: Grant select, update on sequence pub.seq_configur to pub; Grant select, update on sequence pub.seq_propried to pub; Commit;

TOTVS S.A.

34

4.12.2.

Atalho Gesto de Planos

Caso seja utilizado o Gesto de Planos, dever ser criado um atalho especificamente para acesso a ele no produto. Neste caso, devero ser seguidos os passos abaixo: Criar um atalho no config.xml, apontando para um arquivo .INI onde o valor do v6Keys seja = Yes. Os programas do Gesto de Planos devero ser executados com este atalho; Criar um atalho no config.xml, apontando para um arquivo .INI onde o valor do v6Keys seja = No. Este atalho ser utilizado para executar os programas do EMS 2/ EMS 5/ HCM.

4.12.3.

Configurao de envio de e-mail com autenticao

Quando o servidor de e-mail do cliente exigir autenticao para o envio de e-mail, ser necessrio criar uma conta especfica de e-mail para o produto Datasul e configur-la no arquivo mail-service.xml no Jboss. Verificar se no arquivo mail-service.xml (localizado no <Jboss>\server\<instncia>\deploy) existe a configurao abaixo para permitir que sejam enviadas mensagens de e-mails para e-mails externos com autenticao de usurio: <property name="mail.smtp.auth" value="true"/> Se existir, est configurado para utilizar autenticao de usurio, ento sempre que for enviado um e-mail o destinatrio ser o que est definido no arquivo mail-service.xml. O e-mail informado utilizado no "replyTo", ou seja, para resposta do e-mail, tambm ser o configurado no mail-service.xml. Retirando essa configurao do mail.smtp.auth, ao tentar enviar um e-mail para destinatrio externo isso no ser possvel se o servidor de e-mail estiver configurado para exigir autenticao para o envio de e-mail. Se enviado para e-mail interno o remetente que aparecer no e-mail dever ser o que foi informado, e no o que est configurado no mail-service.xml. Tambm ser necessrio a criao do usurio "fornecedor" que ser utilizado para a autenticao do RFI. O usurio dever ser criado no ambiente datasul e ter permisso de acesso aos programas.

4.12.4.

Matriz de Traduo EMS 5

TOTVS S.A.

35

Aps uma nova instalao do produto Datasul 11, ser necessrio criar uma Matriz de Traduo para Organizao Externa no EMS 5 (prgint/utb/utb118aa), caso ela no exista. A matriz ser usada para identificar a unidade organizacional do EMS 5 correspondente unidade organizacional do EMS 2, relacionada ao usurio. Tambm ser utilizada quando o usurio trocar de empresa dentro do sistema Datasul (procedimento Troca Empresa Usurio). Dever existir ao menos um registro de relao entre a empresa do EMS 2 com a empresa do EMS 5. A Matriz de Traduo Organizao Externa dever ter o nome EMS2 e a Origem Organizao dever ser EMS. Se j existir uma matriz chamada EMS2, ela dever ser a oficial utilizada na integrao entre o EMS 2 e o EMS 5. Na matriz devero ser cadastradas todas as empresas e estabelecimentos usados no EMS 2, conforme abaixo: Tipo Unidade Organizacional: empresa/estabelecimento usado no EMS2. Unidade Organizacional Externa: Unidade Organizacional do EMS2. Unidade Organizacional: Unidade Organizacional do EMS5.

As demais informaes (matriz contas, matriz centro de custo e outras) no precisaro ser identificadas neste momento.

4.13. Verificao do ambiente aps instalao

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

TOTVS S.A.

36

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

5.

Atualizao

A atualizao do produto feita atravs da ferramenta Updater, disponvel no endereo http://tools.totvs.com.br/updater .

6.

Reinstalao

A reinstalao pode ser executada para qualquer um dos componentes do produto (programas, banco de dados e servidor de aplicao), executando o setup da mdia de instalao novamente. Porm, antes de executar esse processo, devem ser feitas algumas verificaes: ALERTA: extremamente importante a execuo de um backup do ambiente atual antes da reinstalao de qualquer componente.

Programas

Se o produto estiver operacional, selecionar uma rea de programas diferente da utilizada pelo ambiente de produo. Caso a reinstalao seja executada para atualizao dos programas, sugerimos a criao de um diretrio de quarentena e a execuo de um 37

TOTVS S.A.

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

Banco de Dados

Se o produto estiver operacional, selecionar uma rea ou servidor de banco de dados diferente do utilizado no ambiente de produo. Caso seja informada a mesma rea para a reinstalao, todos os dados inseridos at o presente momento sero eliminados. Somente sobreponha os arquivos quando tiver certeza do que realmente necessita. Alm disso, ao reinstalar os bancos, ser necessria a execuo da inicializao do produto novamente. Em ambiente Oracle, recomendvel realizar um backup dos Schema Holder antes da reinstalao para evitar problemas de sincronismo.

Servidor de Aplicao

Na reinstalao do Servidor de Aplicao, os objetos que no existem sero criados e objetos existentes sero substitudos. Todas as configuraes sero efetuadas novamente pela mdia de instalao.

7.

Desinstalao

O procedimento de desinstalao deve ser executado somente quando no so mais necessrios os componentes instalados em cada servidor, sendo que essa rotina deve ser executada a partir do servidor onde foi instalado cada componente. Para desinstalar o produto em ambiente Windows deve ser selecionada a opo remover do Datasul 11 em Iniciar > Configuraes > Painel de Controle > Adicionar ou Remover Programas. Durante esse processo ser solicitada a confirmao de excluso e posteriormente ser apresentada uma tela de concluso do processo. Esse procedimento no elimina todos os arquivos criados no processo de instalao, como logs e arquivos temporrios. Nesse caso verifique os diretrios utilizados para instalao dos componentes e remova os objetos restantes conforme necessrio.

TOTVS S.A.

38