Guia de Instalao Datasul 11.5.

3
10/2012

Guia de Instalao Datasul 11.5.3

Sumrio 1 1.1 1.2 1.3 1.4 2 2.1 2.2 3 3.1 3.2 Prefcio ....................................................................................................................................... 4 Finalidade .................................................................................................................................... 4 Pblico Alvo ................................................................................................................................. 4 Organizao deste Guia............................................................................................................... 4 Documentaes Importantes ...................................................................................................... 5 Introduo ................................................................................................................................... 5 Arquitetura Distribuda do Produto ............................................................................................ 5 Tipos de Instalao ...................................................................................................................... 6
2.2.1 Alertas durante a instalao ........................................................................................................................... 7

Requisitos Mnimos ..................................................................................................................... 7 Viso Geral dos Requisitos .......................................................................................................... 8 Requisitos de Hardware .............................................................................................................. 8
3.2.1 3.2.2 Requisitos para estao client ........................................................................................................................ 9 Requisitos para servidor ................................................................................................................................. 9

3.3

Requisitos de Software................................................................................................................ 9
3.3.1 3.3.2 3.3.3 3.3.4 3.3.5 3.3.6 Progress .......................................................................................................................................................... 9 Java ................................................................................................................................................................. 10 Flash Player e Navegador ............................................................................................................................... 10 Ferramentas de Acesso Remoto ..................................................................................................................... 10 Requisitos para bancos Oracle ........................................................................................................................ 10 Requisitos para Client Linux ............................................................................................................................ 11

3.4 3.5 4 4.1 4.2 4.3 4.4 4.5

Requisitos de Usurio (Servidor) ................................................................................................. 12 Virtualizao/Load Balance ........................................................................................................ 12 Instalao .................................................................................................................................... 13 Detalhes da Mdia de Instalao ................................................................................................. 13 Planejando a Instalao .............................................................................................................. 13 Planejando a Instalao .............................................................................................................. 14 Instalao de Programas ............................................................................................................. 15 Instalao de Banco de Dados .................................................................................................... 15
4.5.1 4.5.2 Bancos Progress .............................................................................................................................................. 15 Bancos Oracle ................................................................................................................................................. 19

4.6

Instalao do Servidor de Aplicao ........................................................................................... 20

4.6.1 Objetos criados na instalao do Servidor de Aplicao ................................................................................. 22

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

4.7 4.8 4.9

Instalao da Documentao ...................................................................................................... 23 Inicializando o Datasul 11............................................................................................................ 23 Acesso ao Datasul 11................................................................................................................... 24

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

4.10 Acesso Remoto ............................................................................................................................ 24

4.11 Ajustes aps instalao ............................................................................................................... 29

4.11.1 4.11.2 4.11.3 4.11.4 4.11.5 4.11.6 4.11.7 Permisso de Sequences ................................................................................................................................. 29 Configurao para acesso aos programas Progress ....................................................................................... 29 Configurao para acesso ao Gesto de Planos ............................................................................................. 30 Configurao de envio de e-mail com autenticao ....................................................................................... 30 Matriz de Traduo no EMS 5 ......................................................................................................................... 30 Instalao do Plug-in CRM Outlook ................................................................................................................ 31 Verificao do ambiente aps instalao ....................................................................................................... 31

5 6 7

Atualizao .................................................................................................................................. 32 Reinstalao ................................................................................................................................ 32 Reinstalao ................................................................................................................................ 33

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

Prefcio

1.1

Finalidade

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

1.2

Pblico Alvo

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

1.3

Organizao deste Guia

Captulo 2, Introduo

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

Captulo 3, Requisitos

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

Captulo 4, Instalao

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

Captulo 5, Atualizao Este captulo descreve o procedimento de atualizao do produto.

Captulo 6, Reinstalao

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

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

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.

Introduo

2.1

Arquitetura Distribuda do Produto

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

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

2.2

Tipos de Instalao

Para o funcionamento do produto, necessrio executar a instalao de Programas, Bancos de Dados e Servidor de Aplicao: Programas Instala os programas para utilizao do produto, assim como outros arquivos necessrios para execuo do mesmo. 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.
6 Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

Documentao Instala os manuais e documentao do produto.

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 acima. A rea de programas ser a mesma no ambiente e ser compartilhada por todas as instncias.

2.2.1

Alertas durante a instalao

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

Requisitos Mnimos

Este captulo tem por objetivo divulgar recomendaes sobre o uso de hardware e software relacionados ao Datasul 11 e algumas informaes sobre a configurao dos mesmos. Estas recomendaes tm por inteno ajudar os clientes na configurao do ambiente, utilizando-o ao mximo, obtendo uma melhor relao custo/benefcio. Porm, no representam compromissos com tecnologias ou algum fornecedor em especial por parte da Totvs. A deciso sobre a tecnologia e fornecedor de competncia do cliente, bem como o nvel de servio, segurana e confiabilidade que deseja do seu ambiente. As posies deste guia tambm podem ser alteradas, isto devido evoluo das tecnologias e dos nossos produtos. importante lembrar que o ambiente Web utilizado pelo Datasul 11 possui maior complexidade que um ambiente client/server padro, como por exemplo, EMS 2, EMS 5, etc. A correta configurao e tuning do ambiente (servidores, redes, 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.

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

As configuraes de Infra Estrutura (DMZ, rede, etc) e softwares de terceiros (Sistemas Operacionais, Java, etc) necessrias para o funcionamento do produto so de responsabilidade do cliente. Caso necessite do apoio de uma equipe de Infra Estrutura, entre em contato com o Service Desk (Telefone 4003-0015 - Opes 3 4 3).

3.1

Viso Geral dos Requisitos

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

Disco Memria Processador Java OpenEdge

120 GB 4 GB Intel Xeon Dual 2.00 GHz

Software

JRE 1.6 10.2B07

Estao Client
Windows Hardware

Memria (Arquitetura 32-bit) Memria (Arquitetura 64-bit) Processador Resoluo de Tela Flash Navegadores

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

Java

Flash Player 10 Internet Explorer 7 Internet Explorer 8 Internet Explorer 9 Firefox 3.5 e 7 JRE 1.6

3.2

Requisitos de Hardware

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

3.2.1

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

3.3

Requisitos de Software

3.3.1

Progress

ALERTA: obrigatrio o uso do Progress 10.2B com Service Pack 06 ou superior.

As licenas Progress embutidas no produto Datasul 11 so:

Licena
Openedge Enterprise RDBMS Openedge DataServer for Oracle

Sistema Operacional
Windows Server Unix Windows Server Unix

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)
Guia de Instalao Datasul 11.5.3 Verso 1.1 9

Guia de Instalao Datasul 11.5.3

OpenEdge DataServer for Microsoft SQL Openedge Application Server Enterprise Client Networking

Windows Server Windows Unix Windows Unix Windows Server

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

Query / Results Unix

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

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

3.3.5

Requisitos para bancos Oracle

10

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

Caso voc utilize uma instncia existente, as recomendaes que seguem devem prevalecer perante outros produtos no TOTVS. Para verificar valores de parmetros de base existente, proceda as seguintes consultas e analise os resultados: select parameter, value from nls_database_parameters where parameter = 'NLS_CHARACTERSET' NLS_LANGUAGE AMERICAN NLS_TERRITORY NLS_CHARACTERSET NLS_NCHAR_CHARACTERSET 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 instncia. 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

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

Guia de Instalao Datasul 11.5.3 Verso 1.1

11

Guia de Instalao Datasul 11.5.3

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.

3.5

Virtualizao/Load Balance

Os clientes que desejam homologar ambientes dentro de uma estrutura de virtualizao/Load Balance, devero solicitar uma proposta de servios para a TOTVS. No h um padro homologado ou recomendado pela TOTVS, pois cada cliente possui particularidades relacionadas infra-estrutura que necessitam ser avaliadas pontualmente, como por exemplo: 1. 2. 3. 4. 5. 6. Sistema Operacional (Compatvel com verses suportadas pelos fornecedores); Plataforma Sistema Operacional; Tipo de Banco de Dados; Servidores; JBoss (Compatvel com verses suportadas pela TOTVS) AppServer

12

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

7.

Etc. A proposta de servios deve fazer parte dos projetos de implantao e devero gerar atividades tais como:

1) Estudo para anlise de viabilidade tcnica; 2) Detalhamento escrito e desenho contendo a distribuio dos servidores, AppServer, Jboss, Banco de Dados etc; 3) Deciso e definio de estrutura para tolerncia a falha (comportamento do ambiente quando o servidor virtualizado parar se outro assume ou no); 4) Preparao de ambiente para homologao; 5) Homologao da soluo testando o produto nas suas principais funcionalidades; 6) Gerao de documentao que ser a base de consulta de eventuais problemas; 7) Etc. O atendimento para eventuais demandas geradas pela soluo proposta dever ser de responsabilidade do fornecedor do servio. A equipe de atendimento (consultoria tcnica) no ter como atender as demandas desse levantamento, porm, precisar tomar conhecimento dos clientes que aplicaro esse tipo de soluo e detalhes do que foi feito, para que possa dar o melhor direcionamento em eventuais acionamentos. Nos links abaixo, existem detalhes das plataformas homologadas paras as tecnologias Java e Progress: http://www.oracle.com/technetwork/java/javase/system-configurations-135212.html http://communities.progress.com/pcom/docs/DOC-32338

Instalao

4.1

Detalhes da Mdia de Instalao

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

Guia de Instalao do produto; Guia de Suporte ao Cliente; Guia de Unificao de Conceitos; Java; Setup e arquivos necessrios para instalao do produto.

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

Guia de Instalao Datasul 11.5.3 Verso 1.1

13

Guia de Instalao Datasul 11.5.3

Defina a topologia do ambiente. Nesta etapa, deve ser definido onde cada componente ser instalado. Escolha o hardware que ser utilizado como servidor de banco de dados, servidor de arquivos, servidor de aplicao e tambm as mquinas que estaro disponveis aos usurios. Para cada um destes componentes, verifique se os requisitos de hardware e software so atendidos; Instale os programas no servidor de arquivos; Instale os bancos de dados; Instale o servidor de aplicao; Carregue os bancos de dados utilizando os scripts pelo aplicativo Openedge Explorer; Inicialize o produto utilizando o atalho criado em Iniciar > Programas > TOTVS Datasul > Administrao > Inicializador do Produto durante a instalao do servidor de aplicao; Inicie o Jboss atravs do servio TOTVS Datasul - <ID> criado no Services do Windows. Aps a concluso destas etapas, o produto estar pronto para utilizao.

4.3

Planejando a Instalao

ALERTA: Caso a mdia tenha sido recebida em DVD, 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. Se for feito o download da mdia atravs do Portal de Suporte, todos os arquivos zip devem ser descompactados no mesmo diretrio. As etapas abaixo so comuns para todos os tipos de instalao do Datasul 11: 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:
14 Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

Programas Banco de dados Servidor de Aplicao Documentao

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

4.4

Instalao de Programas

Ao selecionar a opo Programas sero instalados os objetos Progress utilizados pelo Datasul 11. A rea de programas ser instalada na estrutura <Drive>:\Totvs\Datasul\<ID>\ERP. O diretrio ERP dever estar acessvel a todos os usurios que utilizaro o Datasul 11, devido execuo dos programas Progress. 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
Guia de Instalao Datasul 11.5.3 Verso 1.1 15

Guia de Instalao Datasul 11.5.3

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

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: A instalao da rea de programas pr-requisito para a instalao dos demais componentes da mdia de instalao.

16

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

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 de 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 bancos no sero gerenciados pelo Progress Explorer Tool. Arquivo responsvel pela configurao dos bancos que sero administrados pelo Progress Explorer Tool.

<Dir Instal Bancos>\scripts

datasulDescargaBancos.bat

<Dir Instal Bancos>\scripts

datasulCargaBancos.bat

<Dir Instal Bancos>\scripts

conmgr.properties

4.5.1.3 Sistemas Operacionais Unix / Linux

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

Guia de Instalao Datasul 11.5.3 Verso 1.1

17

Guia de Instalao Datasul 11.5.3

Acessar o console do servidor de banco de dados; Definir as variveis do Progress export DLC=<Dir Instal Progress> export PATH=<Dir Instal Progress>/Bin:$PATH

Criar o banco de dados prodb <nome banco> <Dir Instal Progress>/empty8

Acessar o Data Administration do Progress, conectando o banco de dados em modo mono usurio

pro -Mm 4096 -cpstream ibm850 -d dmy -E -rx -db <banco> -1 -p _admin.p Executar o load de definies (.df) pelo Admin > Load Data and Definitions > Data Definitions (.df file), para os bancos emsfnd e ems2uni; Criar o usurio sysprogress, senha sysprogress e o usurio pub, senha pub pelo Admin > Security > Edit User List; Fechar a sesso Progress e carregar o banco com um broker SQL proserve <banco> -S <porta> -N TCP -H <nome servidor banco> <parmetros> proserve <banco> -S <porta> -N TCP -H <nome servidor banco> -m3 ServerType SQL <parmetros> Acessar um client Windows com Progress instalado; Acessar o proenv do Progress em Iniciar > Programas > Progress > Proenv; Executar o load das definies (.dfsql) para os bancos emsdev, finance e payroll;

sqlexp user sysprogress password sysprogress -url jdbc:datadirect:openedge://<nome servidor banco>:<porta do broker SQL>;databaseName=<banco> -infile <arquivo.dfsql> DICA: A porta do broker a porta definida para o parmetro -S ao carregar o banco com o parmetro -ServerType SQL.

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

sqlexp user sysprogress password sysprogress -url jdbc:datadirect:openedge://<nome servidor banco>:<porta do broker SQL>;databaseName=<banco> Grant dba to pub; Commit;

ALERTA: Os bancos mdtfrw e mdmerge no possuem definio. Eles devem ser criados vazio e conectados ao produto desta forma, pois as tabelas so criadas durante a carga do Jboss. Aps a execuo desses procedimentos, os bancos utilizados pelo Datasul 11 estaro instalados e configurados.

18

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

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.

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 dos Bancos de Dados Oracle

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

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

Guia de Instalao Datasul 11.5.3 Verso 1.1

19

Guia de Instalao Datasul 11.5.3

4.5.2.2 Criao de Objetos no Banco Oracle

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

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

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

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

20

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

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

Selecione Avanar para continuar. Tela Nome da mquina

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

O Single Sign On (Josso) instalado e configurado junto com o Jboss. Dessa forma, informe o hostname do servidor de aplicao onde est sendo instalado o Jboss e a porta de comunicao com o Jboss. Selecione Avanar para continuar. Tela Nameserver

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

Tela de Configuraes do Jboss

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

Essa tela definir de que forma ser configurado o arquivo ubroker.properties do Progress. Esse o arquivo responsvel pela configurao do servio AppServer Datasul que ser administrado pelo Progress Explorer Tool. Permitir que o InstallShield modifique o arquivo ubroker.properties Ao selecionar essa opo, o arquivo ubroker.properties localizado abaixo do diretrio properties de instalao do Progress ser alterado. Nesse caso, aps iniciar o servio do AdminService possvel visualizar os servios pelo Progress Explorer Tool. Salvar as alteraes necessrias para o arquivo ubroker.properties.new Ao selecionar essa opo, ser criado o arquivo ubroker.properties.new abaixo diretrio properties de instalao do Progress e o arquivo ubroker.properties original do Progress no ser alterado. Nesse caso, antes de iniciar o servio do AdminService necessrio renomear o arquivo ubroker.properties.new para ubroker.properties e assim ser possvel visualizar o servio AppServer Datasul pelo Progress Explorer Tool. No fazer nenhuma alterao
Guia de Instalao Datasul 11.5.3 Verso 1.1 21

Guia de Instalao Datasul 11.5.3

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 Progres s e assim ser possvel visualizar o servio AppServer pelo Progress Explorer Tool. Tela de configurao do License Server

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

Esta tela contm um resumo das informaes digitadas nas telas anteriores. Caso alguma informao esteja incorreta, selecione a opo Voltar para efetuar as devidas correes. Ao selecionar a opo Avanar, os servios sero instalados e configurados. Ao finalizar as configuraes ser questionado se deseja informar as configuraes do LDAP. Estas informaes so utilizadas para o login integrado do produto. Se for escolhida a opo sim, ser solicitado um usurio e senha de rede para configurao com o Active Directory (AD). Aps a configurao com o Active Directory ser apresentada a tela de concluso da instalao do Servidor de Aplicao. 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.

4.6.1

Objetos criados na instalao do Servidor de Aplicao

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

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

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

datasul-progress.ini

datasul-configxml-alias.p

datasul-appserver-alias.p

datasul-aliasIni.p datasul.pf

22

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

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

e parmetros de conexo com os bancos. Arquivo responsvel pela configurao do servio AppServer datasul que ser administrado pelo Progress Explorer Tool.

ubroker.properties

4.7

Instalao da Documentao

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

4.8

Inicializando o Datasul 11

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

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

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

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

Os bancos apresentados nessa tela so os mesmos configurados para conexo no arquivo .pf, localizado abaixo da estrutura <Dir Instal Programas>\scripts. Selecione Iniciar para continuar. Esta tela somente informativa, no sendo possvel alterar os dados de conexo atravs dela. Otimizador de Performance

Essa funo melhora a performance do ambiente no que se refere ao uso de gatilhos de dicionrio. Com a execuo desse programa, so habilitados os gatilhos que possuem cdigos e desabilitados os gatilhos que no estejam sendo utilizados. Recomenda-se a execuo do otimizador de performance na inicializao (opo Sim). Nesse momento ser executada a inicializao do produto.
Guia de Instalao Datasul 11.5.3 Verso 1.1 23

Guia de Instalao Datasul 11.5.3

A ltima etapa do processo de inicializao a importao de dados para o banco de dados emsdev. Durante esta etapa, a tela do inicializador ficar travada. Ao final ser apresentado em tela o arquivo btb907za.txt, gerado abaixo do diretrio raiz de instalao dos programas. Esse arquivo um log dos procedimentos executados. A tela do inicializador ser liberada aps fechar o arquivo de log. Depois de verificar o log gerado, feche o arquivo e selecione concluindo o processo.

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

Acesso ao Datasul 11
Durante a instalao do Servidor de Aplicao criado um atalho em Iniciar > Programas > TOTVS Datasul. Porm, antes de acessar o produto, devem ser executados os seguintes procedimentos:

Iniciar os bancos de dados; Os bancos Progress podem ser iniciados via OpenEdge Explorer ou atravs do script datasulCargaBancos.bat.

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

Iniciar o servio do Jboss TOTVS Datasul em Painel de Controle > Ferramentas Administrativas > Services; ALERTA: Durante a primeira carga do Jboss so criados os objetos do Metadados. Por este motivo, esta carga inicial mais demorada. Aps iniciar o servio do Servidor de Aplicao JBOSS com sucesso, o arquivo <JBOSS_HOME>/server/<nomeinstancia>/conf/datasul/startup-state.xml no deve ser alterado em hiptese alguma, salvo se, e somente se, a TOTVS o fizer via documentao formalizada. Caso ocorra a alterao do arquivo os componentes metadados voltaro ao estado padro da mdia perdendo quaisquer alteraes j realizadas Iniciar o servio Totvs License Server;

4.10 Acesso Remoto

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

24

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

4.10.1

Datasul Connection for Web (GoGlobal)

Para que o Datasul Connection for Web (GoGlobal) funcione corretamente ser necessrio apontar o caminho dos arquivos .jar e .cab, e scripts Java disponibilizados na instalao. Seguem os procedimentos a serem executados para que o acesso remoto seja executado corretamente: Instalar a licena Progress Client Networking no servidor do Datasul Connection for Web (GoGlobal). Instalar o Java 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, sero registrados erros de acesso no log do GoGlobal. Configurar o arquivo config.xml localizado abaixo da estrutura <Dir Instal Programas> \scripts. Seguem os itens a serem configurados nesse arquivo, sendo que as tags no citadas no devero ser alteradas: RemoteConnectionType Informar o tipo de conexo remota (GOGLOBAL). Ex: <RemoteConnectionType>GOGLOBAL</RemoteConnectionType> RemoteServerPort Informe uma porta de comunicao com o Datasul Connection for Web (GoGlobal). Ex: <RemoteServerPort>8085</RemoteServerPort> RemoteShortcut Description Informe os parmetros para execuo da sesso Progress. Ex: <RemoteShortcut Description="GOGLOBAL" Path="-jar \\f16\ServidorAplicao\scripts-8080\datasulframework-citrixproxy-java-1.0.2.jar &quot;c:\dlc102b\bin\prowin32.exe&quot; &quot;\\f16\ERP\scripts\emsmult.pf&quot; &quot;\\f16\ERP\scripts\ems.ini&quot; &quot;men\men906za.p&quot;" /> MetaframeServer Informe nome ou IP do servidor GoGlobal.
Guia de Instalao Datasul 11.5.3 Verso 1.1 25

Guia de Instalao Datasul 11.5.3

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

4.10.2

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

Instalar a licena Progress Client Networking no servidor do Citrix. Instalar o Java 1.6. Copiar os arquivos citrix.properties, citrix.bat e datasul-framework-citrixproxy-java-1.0.2.jar, localizados na pasta scripts abaixo do diretrio onde foi instalado o servidor de aplicao, para uma pasta no servidor Citrix. Criar uma aplicao no Citrix Management Console em Presentation Server > NomeFarm > Applications > New > Publish application (esta aplicao dever estar visvel aos usurios via Web Interface). Display Name o nome da aplicao que ser executada (no exemplo, Datasul11); Type Installed application; Command line Deve apontar para o arquivo citrix.bat, seguido dos caracteres %* Ex: C:\AtalhosDatasul11\citrix.bat" %* Aps a aplicao do Hotfix Rollup Pack 2 ou superior do Presentation Ser ver, 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, ass im 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). No IIS7 converter este diretrio virtual para uma aplicao;

26

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

Os arquivos da pasta DatasulCtxWI publicada so 32-bits. Caso o servidor onde o diretrio virtual foi publicado seja 64-bits, necessrio configurar o IIS para executar em modo 32-bits. A partir do IIS 7, possvel criar um novo pool de aplicativos e configurar somente este pool para executar em modo 32-bits, relacionando a pasta criada a este. Aps criar o diretrio virtual, configurar o arquivo web.config abaixo da pasta DatasulCtxWI, conforme orientaes abaixo: <add key=" CtxWIConfigFile" value="C:\caminhoWebinterface\WebInterface.conf"/> Deve ser informado o caminho completo do arquivo WebInterface.conf do Citrix. Caso o diretrio virtual esteja em um servidor IIS diferente do WebInterface, o arquivo WebInterface.conf pode ser copiado para um diretrio local, como a prpria pasta DatasulCtxWI. <add key=" CtxFarmName" value="SUPORTE"/>

Informar o nome da Farm do citrix onde o atalho para o arquivo citrix.bat foi publicado. 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.3/ERP/scripts/datasul.pf Informar caminho ao arquivo .pf do ambiente utilizado. ini=C:/totvs/datasul/11.5.3/ERP/scripts/datasul-progress.ini Informar caminho ao arquivo .ini do ambiente utilizado. p=C:/totvs/datasul/11.5.3/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>

Guia de Instalao Datasul 11.5.3 Verso 1.1

27

Guia de Instalao Datasul 11.5.3

RemoteShortcut Description Informe uma descrio para a conexo. A valor do item Path pode ficar em branco, Ex: <RemoteShortcut Description="Citrix" Path="" /> MetaframeServer Informe o nome ou endereo IP do servidor Citrix. Ex: <MetaframeServer>citrixserver</MetaframeServer> ASPHttpServer Informe a URL para o diretrio virtula publicado anteriormente: Ex: <ASPHttpServer>http://citrixserver/DatasulCtxWI</ASPHttpServer> MetaframeServerId Informe o nome da aplicao criada no servidor Citrix. Ex: <MetaframeServerId>Datasul11</MetaframeServerId> 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.10.3

Terminal Server
necessrio que o Terminal Server esteja instalado no servidor onde ser feito o acesso remoto. Seguem os procedimentos a serem realizados para o acesso remoto via Terminal Server:

Instalar a licena Progress Client Networking no servidor do Terminal Server. Instalar o Java 1.6. No servidor de Terminal Server, criar uma aplicao no TS Remote App Manager, com a seguinte configurao: RemoteApp program name Informe o nome da aplicao (sugesto: Datasul11); Location Informe o caminho completo do prowin32.exe (localizado abaixo do diretrio Bin do Progress); Alias Informe prowin32. Este nome no deve ser alterado; Command-line arguments Selecionar a opo para permitir qualquer tipo de argument na linha de comando.

Configurar o arquivo config.xml localizado abaixo da estrutura <Dir Instal Programas>\scripts. Segue os itens a serem configurados nesse arquivo, sendo que as tags no citadas no devero ser alteradas: RemoteConnectionType Informar o tipo de conexo remota (Terminal Server). Ex: <RemoteConnectionType>TerminalServer</RemoteConnectionType> RemoteServerPort

28

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

Informe uma porta que servir de comunicao entre o Jboss e o Terminal Server. Ex: <RemoteServerPort>8085</RemoteServerPort> MetaframeServer Informe o nome ou endereo IP do servidor Terminal Server. Ex: <MetaframeServer>serverts</MetaframeServer> MetaframeServerPort Informe a porta de acesso ao Terminal Server. Ex: <MetaframeServerPort>3389</MetaframeServerPort> MetaframeServerId Informe o nome da aplicao criada no servidor TS. Ex: <MetaframeServerId>Datasul11</MetaframeServerId> RemoteShortcut Description Informe os parmetros para execuo da sesso Progress. Ex: <RemoteShortcut Description="TS" Path="-pf &quot;\\serverts\ERP\scripts\emsmult.pf&quot; &quot;\\serverts\ERP\scripts\ems.ini&quot; -p &quot;\\serverts\erp\scripts\alias.p&quot;" />

-ininame

4.11 Ajustes aps instalao

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

4.11.1

Permisso de Sequences

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

4.11.2

Configurao para acesso aos programas Progress

Guia de Instalao Datasul 11.5.3 Verso 1.1

29

Guia de Instalao Datasul 11.5.3

Ao final da instalao os programas Progress estaro disponveis para acesso somente atravs do servidor onde foi feita a instalao. Para que o acesso a estes programas esteja disponvel a todas as estaes da rede, necessrio seguir os procedimentos listados abaixo: Compartilhar o diretrio ERP, atribuindo permisso de leitura a todos os usurios que acessaro o produto. Ex: \\servidor\ERP Editar o arquivo ERP\scripts-8x80\datasul-progress.ini, alterando todas as entradas do Propath para o compartilhamento previamente criado; Ex: PROPATH=\\servidor\ERP,\\servidor\ERP\ems2,\\servidor\ERP\ems5, etc Editar o arquivo ERP\scripts-8x80\config.xml, alterando o endereo dos arquivos .ini, .pf e alias para o compartilhamento previamente criado.

4.11.3

Configurao para acesso ao Gesto de Planos

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

Configurao de envio de e-mail com autenticao

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

4.11.5

Matriz de Traduo no EMS 5

30

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

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

Instalao do Plug-in CRM Outlook

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

4.11.7

Verificao do ambiente aps instalao

Disponibilizamos um check-list do ambiente que facilitar a instalao e deteco de falhas na instalao. Segue o check-list do ambiente:

Verificar se os itens apresentados no captulo de requisitos foram atendidos; Verificar se o servio do AdminService est iniciado; Verificar se os bancos de dados esto carregados; Verificar se as portas utilizadas na carga dos bancos so as mesmas definidas para conexo com os mesmos; Verificar se o servio do AppServer est iniciado; Verificar se o servio do Jboss foi iniciado sem erros no log; Verifique se o arquivo config.xml localizado abaixo da estrutura <Dir Insta l Programas>\scripts-8080 est configurado corretamente, sendo ele o responsvel pelos atalhos para execuo dos programas Progress. Caso exista alguma tag vazia, ela deve ser comentada ou removida; Verificar se o arquivo de datasources (progress-ds.xml ou oracle-ds.xml) localizado no diretrio deploy da instncia do Jboss, est configurado corretamente, sendo ele o responsvel pela comunicao com os bancos de dados. Para ambientes Progress, este arquivo dever apontar para as portas correspondentes aos brokers SQL;
31

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

Verificar a existncia do arquivo datasul_framework.properties localizado abaixo da estrutura jboss_home\server\instance-8080\conf\datasul, sendo ele responsvel pela execuo dos servios integrados com o Jboss como AppServer, Totvs License Server, Flex, entre outros; Verificar se o arquivo di.properties localizado abaixo da estrutura jboss_home \server\instance8080\conf\datasul est configurado corretamente, sendo ele o responsvel pela localizao do arquivo config.xml;

Verificar se o arquivo hcm.properties localizado abaixo da estrutura jboss_home \server\instance-8080\deploy\ datasulbyyou-XX.X.X-SNAPSHOT.ear\payroll-config-X.X.X.jar est configurado corretamente, sendo que o parmetro hcmpayroll.appserverconnection deve estar apontando para o servio AppServer;

Atualizao
feita atravs da ferramenta Updater, disponvel no endereo

A atualizao do produto http://tools.totvs.com.br/updater.

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. A reinstalao pode ser utilizada para instalar os programas compilados em ambiente Caracter 32-bit ou Caracter 64-bit, por exemplo. Banco de Dados

Se o produto estiver operacional, selecionar uma rea ou servidor de banco de dados diferente do utilizado no ambiente de produo. Caso seja informada a mesma rea para a reinstalao, todos os dados inseridos at o presente momento sero eliminados. Somente sobreponha os arquivos quando tiver certeza do que realmente necessita. Alm disso, ao reinstalar os bancos, ser necessria a execuo da inicializao do produto novamente. Em ambiente Oracle, 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.

32

Guia de Instalao Datasul 11.5.3 Verso 1.1

Guia de Instalao Datasul 11.5.3

Reinstalao

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.

Guia de Instalao Datasul 11.5.3 Verso 1.1

33