Manual de Instalao TOTVS Tec

Rev.18 27/08/2010

TOTVS Unidade Joinville Av. Santos Dumont, 831 Bairro Bom Retiro Fone: (47) 2101-3000 Fax: (47) 2101-3001 89222-9000 Joinville Santa Catarina www.totvs.com.br

Guia de Instalao

TOTVS Tec

NDICE
CARACTERISTICAS DA TECNOLOGIA ................................................................ 1 1. 2. 3. 4. Componentes TotvsTec .......................................................................................... 2 Aplicativos TOTVS Tec ......................................................................................... 3 Controle de Licenas .............................................................................................. 4 Instalao TOTVS Tec ........................................................................................... 5 4.1. Requisitos ......................................................................................................... 5 4.1.1. Espao em Disco Mnimo ........................................................................ 5 4.1.2. Usurio ..................................................................................................... 5 4.1.3. Sistema Operacional ................................................................................. 5 4.1.4. Banco de Dados ........................................................................................ 6 Como Instalar o TOTVS Tec................................................................................. 7 5.1. Instalao Windows.......................................................................................... 7 5.1.1. AutoRun ................................................................................................... 7 5.1.2. Manual ...................................................................................................... 8 5.1.3. Processo de Instalao .............................................................................. 8 5.2. Instalao Linux ............................................................................................. 13 5.2.1. Instalando ............................................................................................... 13 5.2.2. Processo de Instalao ............................................................................ 13 Instalao Servidor de Licenas .......................................................................... 15 6.1. Instalao Fsica do Hardlock......................................................................... 16 6.2. Instalao do Driver Proteq (compact-500) ................................................... 16 Configurando o TOTVS Tec ............................................................................... 18 7.1. Configurando o acesso do manual Logix ....................................................... 18 7.1.1. Windows ................................................................................................. 18 7.1.2. Linux....................................................................................................... 18 7.2. Configurando Conexo com Banco de Dados................................................ 19 7.2.1. Windows ................................................................................................. 19 7.2.1.1. Informix .............................................................................................. 19 7.2.1.2. Oracle ................................................................................................. 30 7.2.1.3. MS-SQL Server .................................................................................. 38 7.2.2. Linux....................................................................................................... 50 7.2.2.1. Informix .............................................................................................. 50 7.2.2.2. Oracle ................................................................................................. 55 7.3. Configurando Variveis de Ambiente ............................................................ 61 7.3.1. Criando as variveis de ambiente no Windows ...................................... 61 7.3.2. Criando as variveis de ambiente no Linux............................................ 63 7.3.3. Variveis de Ambiente ........................................................................... 63 7.4. Configurando TOTVSAppServer ................................................................... 66 7.5. Configurando TOTVSSmartClient ................................................................. 78 7.6. Configurando TOTVSAppServer como servio do Windows ....................... 82 7.7. Configurando TOTVSMonitor ....................................................................... 84 7.8. Configurando Telnet ....................................................................................... 85
LOGIX

5.

6.

7.

Guia de Instalao

TOTVS Tec

7.9. 7.10. 8.

Configurando atalhos...................................................................................... 86 Configurando Parmetros da Linha de Comando do TOTVSSmartClient 88

Atualizao TOTVS Tec e RPO .......................................................................... 90 8.1. TOTVS Tec .................................................................................................... 90 8.2. Atualizao Automtica TOTVSSMARTCLIENT........................................ 90 8.3. RPO Repositrio de Programas ................................................................... 91 8.4. Passos para atualizao do RPO ..................................................................... 92 Topologia de Utilizao de Rede do TOTVS Tec .............................................. 92 9.1. Caractersticas e possibilidades de topologias de rede ................................... 94

9.

LOGIX

Guia de Instalao

TOTVS Tec

CARACTERISTICAS DA TECNOLOGIA O TOTVS Tec a evoluo tecnolgica da linguagem 4GL/4JS, que tem a Inteligncia toda dividida em quatro camadas, sendo 100% compatvel com a tecnologia atual (4GL/4JS), preservando assim o legado existente. A verso TOTVS Tec composta por 4 principais componentes e 2 aplicativos auxiliares para o desenvolvimento e monitoramento. Componentes TOTVS Tec: TOTVSAppServer - Servidor de Aplicao (Application Server) TOTVSSmartClient Interface Terminal com Servidor TOTVSDbAccess Comunicao Banco de Dados RPO Objetos de aplicativos/Repositrio de programas/funes Aplicativos TOTVS Tec: TOTVSDevStudio Ambiente de Desenvolvimento Integrado (IDE) TOTVSMonitor Ambiente de monitoramento Telnet - Permite a execuo do Logix em modo caracter.

LOGIX

Guia de Instalao

TOTVS Tec

1. Componentes TotvsTec TOTVSAppServer o servidor de aplicao(Application Server), a aplicao encarregada da compilao e execuo do cdigo 4GL no qual o Logix foi escrito. Esta a parte do sistema que ser executada no servidor e ser responsvel pela comunicao entre o cliente, a base de dados e o repositrio de RPOs. Na Linguagem TOTVS Tec 4GL as rotinas so mantidas em repositrios. Isso permite que as rotinas sejam carregadas e descarregadas dinamicamente da memria da mquina onde o servidor est sendo executado, ou seja, de acordo com a necessidade de execuo dos terminais conectados. Isso facilita a atualizao aps correes de no conformidades ou criao de melhorias, pois apenas os repositrios modificados necessitam ser atualizados. Desse modo, a performance alta e no requer muito da mquina, para a execuo do servidor. O objetivo do servidor de aplicaes disponibilizar uma plataforma, que abstraia do desenvolvedor de software algumas das complexidades de um sistema computacional. No desenvolvimento de aplicaes comerciais, por exemplo, o foco dos desenvolvedores deve ser a resoluo de problemas relacionados ao negcio da empresa, e no de questes de infraestrutura da aplicao. O servidor de aplicaes responde a algumas questes comuns todas as aplicaes, como segurana, garantia de disponibilidade, balanceamento de carga e tratamento de excees. TOTVSSmartClient a aplicao encarregada da interface com o usurio. No existe processamento local, por isso o trfego de rede entre o terminal e o servidor de aplicao baixo, tratando apenas de comandos para o desenho das telas e tratamento do teclado e mouse. uma aplicao thin-client, que realiza apenas a interface com o usurio. TOTVSDbaccess aplicao encarregada de efetuar a comunicao com o banco de dados. Acesso aos dados realizado pelo servidor de aplicao, por meio do padro SQL. APO/RPO nesta parte do sistema que estaro os programas escritos em 4GL, serem acionados para a execuo de determinadas tarefas. por meio dos repositrios que poderemos incluir novas customizaes no sistema. O RPO um arquivo binrio compilado, que por sua vez no pode ser editado ou modificado, pois so os programas desenvolvidos pela LOGOCENTER.

LOGIX

Guia de Instalao

TOTVS Tec

2. Aplicativos TOTVS Tec TOTVSDevStudio (IDE) - Trata-se do Ambiente de Desenvolvimento Integrado do TOTVS Tec. por meio deste Aplicativo, que iremos realizar todos os acessos aos Repositrios de RPOs (Compilao de Customizaes, Visualizao de Funes existentes, etc...).Alm de Depurar Programas Customizados. TOTVSMonitor - Trata-se do Ambiente de Monitorao do TOTVS Tec. Por meio do TOTVSMonitor, poderemos interagir com os Usurios Conectados ao Sistema, Analisar os Programas em Uso, Derrubar Conexes Pendentes, Enviar Mensagens ao Usurios. Telnet - Esta funcionalidade foi mantida, garantindo assim que seja possvel utilizar o Logix em ambiente no Windows, para processamentos remotos onde no possvel um grande fluxo de informaes pela rede ou em ambientes onde se exige equipamentos mais robustos, que no so compatveis com Windows. Pois o TOTVSAppServer tambm um servidor Telnet. Neste ambiente podem ser executadas todas as aplicaes que no tenham funes grficas, folders por exemplo. O menu para o sistema Logix ser MEN3000.4GL.

LOGIX

Guia de Instalao

TOTVS Tec

3.

Controle de Licenas

A TOTVS envia junto aos CDs de instalao do TOTVS Tec um hardware de proteo que tem por objetivo a segurana de suas informaes usando algoritmo de criptografia baseados em chaves de 128 bits, liberando mecanismos mais eficientes para proteger o sistema contra acessos indevidos. Aliando a isso, mais agilidade no processo de liberao de senhas e nos processos de controle aos acessos simultneos. Para utilizao do sistema, necessrio que um dos servidores TOTVS Tec seja o servidor de licenas.

LOGIX

Guia de Instalao

TOTVS Tec

4.

Instalao TOTVS Tec

4.1.

Requisitos

4.1.1. Espao em Disco Mnimo O TOTVS Tec precisa de no mnimo 1GB para instalao. Verifique se voc tem espao suficiente antes de iniciar a instalao. 4.1.2. Usurio Windows Ter efetuado o login como Administrador ou usurio equivalente. Linux Ter efetuado o login como Administrador (root)

4.1.3. Sistema Operacional A tabela a seguir mostra a lista dos sistemas operacionais e verses suportadas: Sistema Operacional e Verso Windows XP (1, 6, 7) Windows Vista Windows 7 (8) Windows 2000 Server (1, 4,
5)

Processador X86 X86 X86 X86 X86 X86 X86 X86 X86 X86 X86 X86 X86 X86 X86 X86

Arquitetura 32 bit 32/64 bit 32 bit 32 bit 32/64 bit 32/64 bit 32/64 bit 32/64 bit 32 bit 32 bit 32/64 bit 32 bit 32/64 bit 32 bit 32 bit 32 bit

Application Server N/A N/A N/A

Client Station

Windows 2003 Server Windows 2008 Server Linux SUSE 10 SLES Linux SUSE 11 SLES Linux OpenSUSE 10.2 Linux RedHat AS 3 (1, 2) Linux RedHat ES 4 (1, 3) Linux RedHat ES 4 update 4 (1, 3) Linux RedHat ES 5.4 Linux RedHat 5 Desktop Linux Ubuntu 7.04 Linux Ubuntu 9.04

N/A N/A

N/A

N/A N/A N/A N/A

N/A N/A N/A

1- Sistema operacional descontinuado pelo fabricante e em processo de desuso para a aplicao. 2- Suspenso do suporte pela Red Hat em 20/07/2006. 3- Suspenso do suporte pela Red Hat em 31/03/2009. 4- Suspenso do suporte pela Microsoft em 30/06/2005. 5- Suspenso do suporte extendido da Microsoft em 13/07/2010. 6- Suspendido o suporte pela Microsoft em 14/04/2009. 7- Suspenso do suporte extendido da Microsoft em 08/04/2014. 8- Sistema operacional homologado para build igual ou superior a 7.00.090818P-20091104.

LOGIX

Guia de Instalao

TOTVS Tec

Para Sistemas Operacionais com arquitetura 64 bits, preciso utilizar o client de conectividade com o Banco de Dados ou ODBC na verso 32 bits, pois a arquitetura do TOTVS Tec 32 bits.

Os sistemas operacionais homologados somente suportam o range de caracteres ocidentais. A TOTVS no homologa ambientes ou mquinas virtuais. No entanto, se o fornecedor do sistema operacional e o fornecedor do virtualizador de ambiente garantirem que as caractersticas do ambiente se mantm, o uso deste ambiente vlido.

4.1.4. Banco de Dados A tabela a seguir mostra a lista dos bancos de dados e verses homologados: Banco de Dados Informix (1) Informix Informix Informix Oracle (1) Oracle Oracle MS-SQL Server (1) MS-SQL Server MS-SQL Server Server 9.4 10.x 11.10 11.50 9i 10g patch 10.2.04 11g Release 1 2000 2005 2008 Arquitetura 32 bit 32 bit 32/64 bit 32/64 bit 32 bit 32 bit 32/64 bit 32 bit 32 bit 32/64 bit Client SDK 2.8x e 2.9x SDK 2.8x e 2.9x SDK 2.9x, 3.00 e 3.50 SDK 2,9x, 3.00 e 3.50 9i 9i e 10g 9i, 10g e 11g 2000 2000 e 2005 2000, 2005 e 2008

1- Verso do banco de dados descontinuado pelo fabricante e em processo de desuso para a aplicao.

LOGIX

Guia de Instalao

TOTVS Tec

5.

Como Instalar o TOTVS Tec

O primeiro passo para instalao do TOTVS Tec a instalao do TOTVSAppServer, TOTVSSmartClient e Manual Logix, que efetuada por meio da SHELL SCRIPT de instalao. Diretrio de Instalao Padro definido como: c:\totvs\logix = Windows /totvs/logix = Linux No podem ser usadas unidades lgicas (drives de rede), para tanto utilize sempre o computador que faz o papel de servidor para efetuar a instalao. Com isso, diminui-se o risco de erros em eventual remoo do sistema.

5.1.

Instalao Windows

A shell script de instalao permite ao administrador instalar o TOTVS Tec de dois modos:

5.1.1. AutoRun O AutoRun executado automaticamente se o Windows estiver configurado com este recurso. Porm, possvel execut-lo por meio do comando: X:\INSTALLTOTVS.EXE onde: X a unidade de CD-ROM Coloque o CD-ROM no driver e aguarde a exibio da tela de abertura conforme a seguir.

LOGIX

Guia de Instalao

TOTVS Tec

No centro da tela sero apresentadas as opes dos aplicativos para instalao: Instalao do TOTVSAppServer Instalao do TOTVSSmartClient Instalao do Manual Logix Selecionada a opo iniciada a cpia dos arquivos e criao dos diretrios e pastas.

5.1.2. Manual Execuo dos seguintes programas a partir do respectivo CD: Instalao do TOTVSAppServer no Windows \INSTALLSERVER.BAT Instalao do TOTVSSmartClient no Windows \INSTALLCLIENT. BAT Instalao do Manual Logix no Windows \INSTALLMANUAL.BAT iniciada a cpia dos arquivos e criao dos diretrios e pastas. 5.1.3. Processo de Instalao Instalando o Manual Logix

LOGIX

Guia de Instalao

TOTVS Tec

Para consultar a documentao online, necessrio instalar o Manual do Logix. A documentao poder ser acessada no Logix, por meio da tecla [F1].

O Manual Logix instalado do diretrio padro c:\TOTVS\doc\logix. Instalando o TOTVSAppServer O TOTVSAppServer pode ser instalado fisicamente em uma estao, por meio de uma opo da tela inicial de instalao do TOTVS Tec. Este recurso til para instalao do TOTVSAppServer em computadores que no esto conectados rede local, ou seja, que necessitam que os executveis estejam fisicamente na mquina. Por exemplo, em casos de filiais que acessam a matriz por uma linha discada por meio do protocolo TCP/IP. Devemos ressaltar que o procedimento de instalao do TOTVSAppServer nas estaes s recomendado em casos especficos (utilizao remota, alto trfego de dados na rede, etc.). Preferencialmente, indicado o uso centralizado do TOTVSAppServer no Servidor, e por meio da criao de atalho para acesso. Coloque o CD-ROM no driver e aguarde a exibio da tela de abertura conforme a seguir:

LOGIX

Guia de Instalao

TOTVS Tec

No centro da tela so apresentadas as opes dos aplicativos para instalao: Instalao do TOTVSAppServer Instalao do TOTVSSmartClient Instalao do Manual Logix Clique na opo TOTVSAppServer.

A Shell Script inicia o processo de instalao, apresentando a janela de confirmao da instalao dos produtos. Pressione a tecla ENTER para prosseguir.

Diretrio de Instalao Padro (c:\totvs\logix\bin\appserver); No podem ser usadas unidades lgicas (drives de rede), para tanto, utilize sempre o computador que faz o papel de servidor para efetuar a instalao. Com isso, diminui-se o risco de erros em eventual remoo do sistema.

Concluso da Instalao Ao final da instalao apresentada a tela sobre a concluso do processo.

Verificao das Configuraes de Instalao Verifique a configurao de instalao na seo configurando TOTVS Tec.

Instalando TOTVSSmartClient

LOGIX

10

Guia de Instalao

TOTVS Tec

O TOTVSSmartClient pode ser instalado fisicamente em uma estao, por meio de uma opo da tela inicial de instalao do TOTVS Tec. Este recurso til para instalao do TOTVSSmartClient em computadores que no esto conectados rede local, ou seja, que necessitam que os executveis estejam fisicamente na mquina. Por exemplo, em casos de filiais que acessam a matriz por uma linha discada por meio do protocolo TCP/IP. Devemos ressaltar que o procedimento de instalao do TOTVSSmartClient nas estaes s recomendado em casos especficos (utilizao remota, alto trfego de dados na rede, etc.). Preferencialmente, indicado o uso centralizado do TOTVSSmartClient no Servidor, por meio da criao de atalho para acesso. Coloque o CD-ROM no drive e aguarde a exibio da tela de abertura conforme a seguir:

No centro da tela so apresentadas as opes dos aplicativos para instalao: Instalao do TOTVSAppServer Instalao do TOTVSSmartClient Instalao do Manual Logix Clique na opo TOTVSSmartClient.

A Shell Script inicia o processo de instalao, apresentando a janela de Bem-vindo.

LOGIX

11

Guia de Instalao

TOTVS Tec

Pressione a tecla ENTER para prosseguir.

Diretrio de Instalao Padro (c:\totvs\logix\bin\smartclient) No podem ser usadas unidades lgicas (drives de rede), para tanto, utilize sempre o computador que faz o papel de servidor para efetuar a instalao. Com isso, diminui-se o risco de erros em eventual remoo do sistema

Concluso da Instalao Ao final da instalao, apresentada a tela sobre a concluso do processo. Verificao das Configuraes de Instalao Verifique a configurao de instalao na seo configurando TOTVS Tec.

LOGIX

12

Guia de Instalao

TOTVS Tec

5.2.

Instalao Linux

Nesta seo, explicado ao administrador como instalar o TOTVS Tec em Linux.

5.2.1. Instalando Faa o download do instalador e salve em uma rea auxiliar. Ex. /tmp 5.2.2. Processo de Instalao Execute o script shell: cd /tmp ./installTOTVS.bin Aguarde a exibio da tela de abertura conforme a seguir.

iniciada a instalao do TOTVS Tec com todas suas pastas e arquivos para a pasta padro /totvs. Instalao do Manual Logix Para consultar a documentao online, necessrio instalar o Manual do Logix. A documentao acessada a partir do Logix, pela tecla [F1]. O Manual Logix instalado do diretrio padro c:\totvs\logix\doc a partir do instalador para ambiente Windows.

LOGIX

13

Guia de Instalao

TOTVS Tec

Instalando TOTVSSmartClient O TOTVSSmartClient um aplicativo para execuo do Logix nas estaes clientes. Elas podem ser Linux ou Windows. Nesta instalao o TOTVSSmartClient j instalado para ambiente Linux, necessitando apenas a sua configurao conforme o captulo Configurando TOTVSSmartClient neste documento. Para instalar em outras estaes voc necessita apenas copiar a pasta /totvs/logix/bin/smartclient ou compartilhar para as demais estaes clientes Linux. Para estaes clientes Windows ser necessrio executar o procedimento Instalao Windows o item Instalando TOTVSSmartClient neste documento.

Concluso da Instalao Ao final da instalao apresentada a tela sobre a concluso do processo. Verificao das Configuraes de Instalao Verifique a configurao de instalao na seo configurando TOTVS Tec.

LOGIX

14

Guia de Instalao

TOTVS Tec

6.

Instalao Servidor de Licenas

O servidor de licenas deve ter conectado o HardLock (dispositivo de segurana) na porta USB e o driver do dispositivo instalado (se necessrio). Para cada contrato de manuteno a TOTVS envia um HardLock Proteq.

Assim que receber a mdia de instalao, antes de iniciar a instalao, necessrio abrir um chamado na pgina de suporte da TOTVS (http://suporte.totvs.com) no link CST (Centro de Servios TOTVS) e solicitar a chave de liberao da senha.

Figura pgina de suporte a clientes TOTVS

Devido necessidade de alta disponibilidade do Servidor de Licenas, recomendamos que seja configurado em um servio separado, mesmo que esteja na mesma mquina. Para detalhes de configurao consulte Procedimento Instalao Controle de Licenas disponvel na pgina de suporte do TotvsTec.

LOGIX

15

Guia de Instalao

TOTVS Tec

6.1.

Instalao Fsica do Hardlock

Conectar o dispositivo na porta USB:

Para ambientes que no possuem dispositivo USB, no caso BLADE possvel a utilizao do dispositivo AnywhereUSB, mas somente para ambiente Windows, no existe soluo para Linux at o momento. Mais informaes em http://www.albacore.com.br/anywhereusb.htm.

6.2.

Instalao do Driver Proteq (compact-500)

Windows No diretrio d:\totvs\logix\bin\drivers\ necessrio executar o instalador SetupProteq.exe para sistema 32bits e para sistema 64bits executar o instalador CompactDrivers64bitsigned.exe para instalar o driver (proteq.vxd e proreq.sys) e DLLs correspondentes. No diretrio \totvs\logix\bin\drivers\ executar o instalador SetupProteq.exe para instalar o driver (PROTEQ.VXD E PROREQ.SYS) e DLLs correspondentes.

O arquivo de licena (Applylic.key) deve ser gravado na pasta c:\totvs\logix\bin\appserver(windows) ou /totvs/logix/bin/appserver (Linux) no Server que ir efetuar o controle de licenas.

Efetuar o login com o administrador e o usar a ltima verso do Service Pack disponvel. Linux No h necessidade de instalao de driver para o modelo Proteq Compact-500. O modelo HASP vlido somente para sistema operacional Linux 32bits e quando o seu sistema operacional no tiver o driver instalado, voc dever fazer o download da pgina do fornecedor Alladin Knowledge System Ltd. (http://www.aladdin.com/support/hasp/hasp4/linuxdrv.aspx) do respectivo driver para instalar no seu sistema operacional.

LOGIX

16

Guia de Instalao

TOTVS Tec

Fazer o download dos arquivos 1 e 2 no mesmo diretrio e executar o shell script dinst.

LOGIX

17

Guia de Instalao

TOTVS Tec

7. 7.1.

Configurando o TOTVS Tec Configurando o acesso do manual Logix

7.1.1. Windows No arquivo que inicia o servio do TOTVSAppServer, o totvsserver.bat tem a varivel LGXDOC que indica para o Logix o caminho onde est instalado o Manual Logix, este arquivo fica em c:\totvs\logix\bin\appserver. Quando o TOTVSAppServer estiver configurado como um servio do Windows (item 5.6) esta varivel dever ser definida nas variveis de ambiente do Windows. Exemplo: SET LGXDOC=z:\logix\doc\

(unidade compartilhada e mapeada)

A documentao on-line do Logix 10 composta por muitos arquivos, por este motivo recomendamos que o mesmo seja instalado abaixo de um servio Apache-Tomcat que j necessrio para o BI-Logix e Gerenciador de Relatrios conforme descrito no documento TOTVSTec Melhores Prticas.

7.1.2. Linux Quando o Manual Logix instalado em um diretrio do Linux ele deve ser mapeado no Samba ou similar, para ficar accessvel via Windows, pois o Manual Logix Online utiliza o Browser Internet Explorer para abrir a documentao. Samba um programa para Linux (ou qualquer outro sistema operacional baseado em UNIX) que simula um servidor Windows, permitindo que seja feito gerenciamento e compartilhamento de arquivos e impressoras em uma rede Microsoft. (www.samba.org) No arquivo que inicia o servio do TOTVSAppServer, o start_TOTVSappserver.sh tem a varivel LGXDOC que indica para o Logix o caminho onde est instalado o Manual Logix este arquivo fica em /totvs/logix/bin/appserver; Exemplo: export LGXDOC=c:\totvs\logix\doc

A documentao on-line do Logix 10 composta por muitos arquivos, por este motivo recomendamos que o mesmo seja instalado abaixo de um servio Apache-Tomcat que j necessrio para o BI-Logix e Gerenciador de Relatrios conforme descrito no documento TOTVSTec Melhores Prticas.

LOGIX

18

Guia de Instalao

TOTVS Tec

7.2.

Configurando Conexo com Banco de Dados

7.2.1. Windows 7.2.1.1. Informix Para conectar ao banco de dados Informix necessrio criar uma fonte de dados de sistema ODBC para cada banco de dados que desejar conectar via TOTVS Tec. Essa fonte de dados pode ser configurado por meio da ferramenta do Windows Administrador de fonte de dados ODBC. Pr-requisito O Informix Connect for Windows dever estar instalado na mquina onde est sendo configurada a conexo conforme as verses homologadas. Criando uma fonte de dados de sistema ODBC 1. V em, Iniciar > Configuraes > Painel de Controle > Ferramentas Administrativas

2. Fontes de Dados (ODBC)

LOGIX

19

Guia de Instalao

TOTVS Tec

3. Selecione a pasta Fonte de dados de sistema

4. Selecione a opo Adicionar

LOGIX

20

Guia de Instalao

TOTVS Tec

5. Selecione o driver IBM INFORMIX 3.82 32 BIT

LOGIX

21

Guia de Instalao

TOTVS Tec

6. Na pasta General. Informe o nome Data Source Name, que dever ser informado no arquivo de configurao do TOTVSAppServer (TOTVSappserver.ini) na seo TOTVSDBACCESS, chave ALIAS ou na chave DBALIAS.

7. Na pasta Connection informe os dados conforme as configuraes da instalao do banco de dados Informix.

8. Na pasta Environment informe os dados conforme abaixo.

LOGIX

22

Guia de Instalao

TOTVS Tec

9. Na pasta Advanced setar as opes; Auto Commit Optimization Insert Cursors Scrollable Cursors

Para confirmar o cadastro selecione Aplicar e OK.

LOGIX

23

Guia de Instalao

TOTVS Tec

Para validar o cadastro e a conexo, selecione a pasta Connection - boto Apply & Test Connection

LOGIX

24

Guia de Instalao

TOTVS Tec

10. Depois de concluda a configurao da fonte de dados no ODBC necessrio validar no TOTVSDBACCESS a conexo com o banco de dados no TOTVS Tec. 11. Para iniciar o servio TOTVSDbAccess necessrio execut-lo. V em, Iniciar > Executar... > cmd

12. Depois, informe cd \totvs\logix\bin\appserver 13. Para iniciar o servio de conexo com o banco de dados digite: Totvsdbaccess.exe console

14. Depois de iniciado o servio acima necessrio configurar o usurio e senha padro para validar o acesso ao banco de dados no TOTVSDBACCESS.
LOGIX

25

Guia de Instalao

TOTVS Tec

Executando o aplicativo TOTVSDbMonitor: c:\totvs\logix\bin\appserver\TOTVSdbmonitor

No campo Servidor informar o IP da mquina onde est sendo instalado o TOTVS Tec e foi iniciado o servio TOTVSDbAccess. No campo Porta deixar o valor padro 7890. Selecionar OK para prosseguir com a configurao.

Para incluir ou atualizar as configuraes, selecionar Configuraes, Informix, Novo. Informar o nome do servio de conexo com o banco de dados definido no ODBC fonte de dados, e o usurio e senha padro para conexo com o Banco de Dados.

LOGIX

26

Guia de Instalao

TOTVS Tec

O nome do Ambiente dever ser informado no arquivo de configurao do TOTVSAppServer (TOTVSappserver.ini) na seo TOTVSDBACCESS chave ALIAS ou na seo Logix chave DBALIAS.

15. Utilizar o nome do Ambiente o mesmo nome utilizado no fonte de dados no ODBC. Depois de informados os dados, selecionar Salvar. 16. Para validar a configurao e a conexo deve ser selecionada a opo Assistentes Validao de Conexo e informados os dados, conforme mostram as figuras abaixo:

LOGIX

27

Guia de Instalao

TOTVS Tec

LOGIX

28

Guia de Instalao

TOTVS Tec

LOGIX

29

Guia de Instalao

TOTVS Tec

7.2.1.2. Oracle Para conectar ao banco de dados Oracle necessrio criar um servio independente para cada banco de dados que desejar conectar via TOTVS Tec. Esse servio pode ser configurado por meio da ferramenta Oracle Net Manager. No arquivo de configurao do TOTVSAppServer (TOTVSappserver.ini) na seo TOTVSDBACCESS chave DATABASE dever ser ORACLE. Pr-requisito O Client Oracle for Windows homologado dever estar instalado na mquina onde est sendo configurada a conexo. Importante Caso exista mais de um produto Oracle instalado na maquina, a varivel de ambiente ORACLE_HOME dever ser definida, esta varivel dever apontar para o diretrio de instalao do produto Oracle e a ser usado para a conexo com o TOTVSTec. Alm desta varivel, a uma outra denominada TNS_ADMIN tambm dever ser definida. Abaixo descreve-se um exemplo desta configurao, supondo que o diretrio de instalao do Oracle C:\oracle\ora92: ORACLE_HOME=c:\oracle\ora92 TNS_ADMIN=c:\oracle\ora92\network\admin Outras variveis de ambiente importantes Para o correto funcionamento das aplicaes da TOTVS/Logocenter necessrio definir as variaveis de ambiente de configurao de caracteres do Oracle de acordo com a especificao abaixo. NLS_LANG=AMERICAN_AMERICA.WE8ISO8859P1 NLS_DATE_FORMAT=dd/mm/yyyy hh24:mi:ss NLS_NUMERIC_CHARACTERS=,. Criando um servio independente no Oracle Net Manager 1. V em, Iniciar > Programas > Oracle OraHome92 ou Oracle OraClient10g_home1 > Configuration and Migration Tools > Net Manager

LOGIX

30

Guia de Instalao

TOTVS Tec

LOGIX

31

Guia de Instalao

TOTVS Tec

2. Selecione a opo Local

3. Selecione a opo Nomeao de Servio

LOGIX

32

Guia de Instalao

TOTVS Tec

4. Adicionar um novo servio de conexo ou verificar os servios j existentes. O nome desse servio ser utilizado no TOTVSDbMonitor para validar a conexo do banco no TOTVS Tec.

O nome do servio de conexo dever ser informado no arquivo de configurao do TOTVSAppServer (TOTVSappserver.ini) na seo TOTVSDBACCESS chave ALIAS ou na seo Logix chave DBALIAS. 5. Depois da concluso da configurao do servio no Client do Oracle necessrio iniciar o TOTVSDbAccess para concluir a configurao de conexo com o banco de dados no TOTVS Tec. 6. Para iniciar o servio TOTVSDbAccess necessrio execut-lo. V em, Iniciar > Executar... > cmd

7. Depois digite: cd \totvs\logix\bin\appserver 8. Em seguida digite: Totvsdbaccess.exe console

LOGIX

33

Guia de Instalao

TOTVS Tec

9. Antes de proceder com a inicializao do Servio do TOTVSDbaccess necessrio incluir uma sesso denominada ORACLE e a diretiva ClientLibrary manualmente no arquivo de configurao TOTVSDbAccess.ini . A diretiva ClientLibrary dever indicar o caminho no qual est localizada a DLL oci.dll. O arquivo de configurao TOTVSDbAccess.ini est localizado na mesma pasta que foi executado o TOTVSDbMonitor, C:\totvs\logix\bin\appserver. Um exemplo desta configurao descrito abaixo: [ORACLE] ClientLibrary=C:\oracle\ora92\bin\oci.dll environments=logix10 10. Depois de iniciar os servios acima citados necessrio configurar o usurio e senha padro para acesso inicial ao banco de dados. Para efetuar essa configurao necessrio que o TOTVSAppserver Windows esteja instalado, pois o aplicativo usado est junto com o Appserver. Executando o aplicativo TOTVSDbMonitor: c:\totvs\logix\bin\appserver\TOTVSdbmonitor

No campo Servidor informar o IP da mquina onde est sendo instalado o TOTVS Tec e foi iniciado o servio TOTVSDbAccess. No campo Porta deixar o valor padro 7890. Selecionar OK para prosseguir com a configurao.

LOGIX

34

Guia de Instalao

TOTVS Tec

Para incluir ou atualizar as configuraes clicar em Configuraes, Oracle, Novo. Informar o nome do servio de conexo com o banco de dados definido no Net Manager, e o usurio e senha padro para conexo com o Banco de Dados.

O nome do Ambiente dever ser informado no arquivo de configurao do TOTVSAppServer (TOTVSappserver.ini) na seo TOTVSDBACCESS - chave ALIAS ou na seo Logix - chave DBALIAS.

13. Utilizar o nome do Ambiente o mesmo nome utilizado no Client do Oracle.

LOGIX

35

Guia de Instalao

TOTVS Tec

Depois de informados os dados, selecione Salvar. 14. Para validar a configurao e a conexo clicar na opo Assistentes, selecione Validao de Conexo e informe os dados.

LOGIX

36

Guia de Instalao

TOTVS Tec

LOGIX

37

Guia de Instalao

TOTVS Tec

7.2.1.3. MS-SQL Server Para conectar ao banco de dados MS-SQL Server necessrio criar uma fonte de dados de sistema ODBC para cada banco de dados que desejar conectar via TOTVS Tec. Essa fonte de dados pode ser configurada por meio da ferramenta do Windows Administrador de fonte de dados ODBC. No arquivo de configurao do TOTVSAppServer (TOTVSappserver.ini) na seo TOTVSDBACCESS chave DATABASE dever ser MSSQL.

Criando uma fonte de dados de sistema ODBC 1. V em, Iniciar > Configuraes > Painel de Controle > Ferramentas Administrativas

LOGIX

38

Guia de Instalao

TOTVS Tec

2. Fontes de Dados (ODBC)

3. Selecione a aba Fonte de dados de sistema.

LOGIX

39

Guia de Instalao

TOTVS Tec

4. Selecione a opo Adicionar

LOGIX

40

Guia de Instalao

TOTVS Tec

5. Selecione o driver SQL Server

6. Na pasta General. Informe o Nome, que dever ser informado no arquivo de configurao do TOTVSAppServer (TOTVSappserver.ini) na seo TOTVSDBACCESS chave ALIAS.

7. Autenticao

LOGIX

41

Guia de Instalao

TOTVS Tec

Informe a forma de autenticao no banco de dados usada. Aqui sugerimos por meio de um usurio especfico que ser o proprietrio (owner) das tabelas do sistema Logix.

7. Seleo do banco de dados a ser conectado.

8. Continuando....

LOGIX

42

Guia de Instalao

TOTVS Tec

9. Para validar o cadastro e a conexo selecione o boto Testar Fonte de dados... e OK

LOGIX

43

Guia de Instalao

TOTVS Tec

10. Depois da concluso da configurao da ODBC necessrio iniciar o TOTVSDbAccess para concluir a configurao de conexo com o banco de dados no TOTVS Tec. 11. Para iniciar o servio TOTVSDbAccess necessrio execut-lo. V em, Iniciar > Executar... > cmd

12. Depois digite: cd \totvs\logix\bin\appserver 13. Em seguida digite: Totvsdbaccess.exe console

LOGIX

44

Guia de Instalao

TOTVS Tec

14. Com o servio TotvsDbaccess iniciado necessrio configurar o usurio e senha padro para acesso inicial ao banco de dados. Executando o aplicativo TOTVSDbMonitor: c:\TOTVS\bin\appserver\TOTVSdbmonitor

No campo Servidor deve ser informado o IP da mquina onde est sendo instalado o TOTVS Tec e foi iniciado o servio TOTVSDbAccess. No campo Porta deve ser informado o valor padro 7890. Selecionar OK para prosseguir com a configurao.

LOGIX

45

Guia de Instalao

TOTVS Tec

15. Para incluir ou atualizar as configuraes, selecionar Configuraes, Microsoft SQL, Novo. Dever ser informado o nome da ODBC de conexo com o banco de dados e o usurio e senha padro para conexo com o Banco de Dados.

O nome do Ambiente dever ser informado no arquivo de configurao do TOTVSAppServer (TOTVSappserver.ini) na seo TOTVSDBACCESS chave ALIAS ou na seo Logix chave DBALIAS.

16. Utilizar no nome do Ambiente o mesmo nome utilizado na definio da ODBC.

LOGIX

46

Guia de Instalao

TOTVS Tec

Depois de informar os dados, selecionar Salvar. 17. Para validar a configurao e a conexo, selecione a opo Assistentes - boto validao de Conexo - e informe os dados.

LOGIX

47

Guia de Instalao

TOTVS Tec

LOGIX

48

Guia de Instalao

TOTVS Tec

18. A configurao de conexo com o banco de dados est concluda.

LOGIX

49

Guia de Instalao

TOTVS Tec

7.2.2. Linux 7.2.2.1. Informix Para conectar ao banco de dados necessrio configurar alguns arquivos, o que dever ser feito como usurio administrador (root). No arquivo de configurao do TOTVSAppServer (TOTVSappserver.ini) na seo TOTVSDBACCESS chave DATABASE dever ser INFORMIX.
Pr-requisito

O Informix SDK homologado dever estar instalado na mquina onde est sendo configurada a conexo. Arquivos a serem configurados: O arquivo .ODBC.INI est localizado no diretrio raiz do root. (cd /root)
[ODBC] Trace=0 TraceFile=/tmp/odbctrace.out InstallDir=/usr/informix [logix10] Database=logix Servername=logix10soc CursorBehavior=1 EnableScrollableCursors=1

O arquivo SQLHOSTS est localizado no diretrio onde est instalado o client do Informix. (/usr/informix/etc/sqlhosts)
# logix10shm logix10soc logix10 # onipcshm onsoctcp olsoctcp 10.10.10.11 10.10.10.11 10.10.10.11 logix10 logix10srv logix10srv

O arquivo SERVICES est localizado no diretrio /etc. do root. (cd /etc.). Dever ter o nome do servio que faz a comunicao com o banco a port e tipo de comunicao.
# logix10srv logix10tsrv # 5800/tcp 5801/tcp

O arquivo PROFILE do root est localizado no diretrio /etc. do root. (cd /etc.). Dever ter configurado o caminho que est instalado o Informix SDK para que o TOTVS Tec possa carregar as bibliotecas de comunicao com o banco de dados.
# LD_LIBRARY_PATH=/usr/sdk/lib:/usr/sdk/lib/cli:/usr/sdk/lib/esql:$LD_LIBRARY_PATH export LD_LIBRARY_PATH #

LOGIX

50

Guia de Instalao

TOTVS Tec

Concluindo a configurao dos arquivos necessrio iniciar o servio TOTVSDbAccess no Linux, para concluir a configurao de conexo com o banco de dados. Para iniciar o servio o seguinte comando no Linux devem ser executado: linux01:/totvs/logix/bin/appserver >./totvsdbaccess & Depois de iniciar o servio acima citado necessrio configurar o usurio e senha padro para acesso inicial ao banco de dados. Para efetuar essa configurao necessrio que o TOTVSAppserver Windows esteja instalado, pois o aplicativo usado est junto com o Appserver. Executando o aplicativo TOTVSDbMonitor: c:\totvs\logix\bin\appserver\totvsdbmonitor

No campo Servidor deve ser informado o IP da mquina onde est sendo instalado o TOTVS Tec e foi iniciado os servios TOTVSDbAccess e TOTVSAppServer. No campo Porta deve ser informado o valor padro 7890. Selecionar OK para prosseguir com a configurao.

LOGIX

51

Guia de Instalao

TOTVS Tec

Para incluir ou atualizar as configuraes, selecionar Configuraes, Informix, Novo. Deve ser informado o nome do ambiente, definido no arquivo .ODBC.INI, e o usurio e senha padro para conexo com o Banco de Dados.

O nome do ambiente dever ser informado no arquivo de configurao do TOTVSAppServer (TOTVSappserver.ini) na seo TOTVSDBACCESS - chave ALIAS ou na seo Logix - chave DBALIAS.

Depois de informar os dados, selecione Salvar.

LOGIX

52

Guia de Instalao

TOTVS Tec

Para validar a configurao e a conexo, selecione a opo Assistentes, boto Validao de Conexo, e informe os dados.

LOGIX

53

Guia de Instalao

TOTVS Tec

Se a configurao estiver correta, a tela Conexo Ok! ser exibida.

LOGIX

54

Guia de Instalao

TOTVS Tec

7.2.2.2. Oracle Para conectar ao banco de dados Oracle necessrio criar um servio independente para cada banco de dados que ser conectado via TOTVS Tec. Esse servio pode ser configurado por meio da ferramenta Oracle Net Manager. No arquivo de configurao do TOTVSAppServer (TOTVSappserver.ini), na seo TOTVSDBACCESS - chave DATABASE, dever ser ORACLE.
Pr-requisito

O Client Oracle homologado dever estar instalado na mquina onde est sendo configurada a conexo.

Arquivos a serem configurados: O arquivo tnsnames.ora est localizado no diretrio onde est instalado o Client do Oracle. (exemplo: /opt/oracle/product/10g/network/admin) Para cada ambiente TOTVS Tec necessrio um servio TNS. # tnsnames.ora Network Configuration File: /oracle/product/10g/network/admin/tnsnames.ora
# Generated by Oracle configuration tools. LOGIX10 = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = lndb02)(PORT = 1521)) ) (CONNECT_DATA = (SERVICE_NAME = ora10g) ) )

O arquivo PROFILE do root, que est localizado no diretrio /etc. do root. (cd /etc), dever ter configurado o caminho que est instalado o client do Oracle, para que o TOTVS Tec possa carregar as bibliotecas de comunicao com o banco de dados, bem como as variveis de ambiente que indicam das configuraes regionais de caracteres aceitos pelo banco.

LOGIX

55

Guia de Instalao

TOTVS Tec

# export export export export export export #

ORACLE_HOME=/opt/oracle/product/10g LD_LIBRARY_PATH=$ORACLE_HOME/lib TNS_ADMIN=$ORACLE_HOME/network/admin NLS_LANG=AMERICAN_AMERICA.WE8ISO8859P1 NLS_DATE_FORMAT='dd/mm/yyyy hh24:mi:ss' NLS_NUMERIC_CHARACTERS=',.'

Antes de proceder com a inicializao do Servio do TOTVSDbaccess necessrio incluir uma sesso denominada ORACLE e a diretiva ClientLibrary manualmente no arquivo de configurao TOTVSDbAccess.ini . A diretiva ClientLibrary dever indicar o caminho no qual est localizada a biblioteca de conexo libclntsh.so. O arquivo de configurao TOTVSDbAccess.ini est localizado na mesma pasta que foi executado o TotvsDbaccess , /totvs/logix/bin/appserver. Um exemplo desta configurao descrito abaixo:
[ORACLE] ClientLibrary=/opt/oracle/product/10gr2cli/lib/libclntsh.so. environments=logix10

Concluindo a configurao dos arquivos necessrio iniciar o servio TOTVSDbAccess no Linux, para concluir a configurao de conexo com o banco de dados. Para iniciar o servio o seguinte comando no Linux devem ser executado: linux01:/totvs/logix/bin/appserver >./totvsdbaccess & Depois de iniciar o servio acima citado necessrio configurar o usurio e senha padro para acesso inicial ao banco de dados. Para efetuar essa configurao necessrio que o TOTVSAppserver Windows esteja instalado, pois o aplicativo usado est junto com o Appserver. Executando o aplicativo TOTVSDbMonitor: c:\totvs\logix\bin\appserver\totvsdbmonitor

LOGIX

56

Guia de Instalao

TOTVS Tec

No campo Servidor deve ser informado o IP da mquina onde est sendo instalado o TOTVS Tec e onde foi iniciado os servios TOTVSDbAccess e TOTVSAppServer. No campo Porta informar o valor padro 7890. Selecionar OK para prosseguir com a configurao.

Para incluir ou atualizar as configuraes, selecionar Configuraes, Oracle, Novo. Deve ser informado o nome do servio de conexo com o banco definido no arquivo tnsnames.ora e o usurio e senha padro para conexo com o Banco de Dados.

O nome do ambiente dever ser informado no arquivo de configurao do TOTVSAppServer (TOTVSappserver.ini), seo TOTVSDBACCESS - chave ALIAS, ou na seo Logix - chave DBALIAS.

LOGIX

57

Guia de Instalao

TOTVS Tec

12. Utilizar no nome do Ambiente o mesmo nome utilizado no Client do Oracle. Depois de informar os dados, selecionar Salvar. 13. Para validar a configurao e a conexo, selecionar a opo Assistentes, boto Validao de Conexo e informar os dados.

LOGIX

58

Guia de Instalao

TOTVS Tec

LOGIX

59

Guia de Instalao

TOTVS Tec

LOGIX

60

Guia de Instalao

TOTVS Tec

7.3.

Configurando Variveis de Ambiente

Na conexo com o banco de dados necessrio criar/configurar algumas variveis de ambiente e outras variveis de ambiente tambm so necessrias para Logix. 7.3.1. Criando as variveis de ambiente no Windows 1. V em, Iniciar > Configuraes > Painel de Controle > Sistema

2. Selecione a pasta Avanado e boto Variveis de Ambiente.

LOGIX

61

Guia de Instalao

TOTVS Tec

LOGIX

62

Guia de Instalao

TOTVS Tec

7.3.2. Criando as variveis de ambiente no Linux As varveis de ambiente no sistema operacional Linux so definidas no arquivo PROFILE. O arquivo PROFILE do root est localizado no diretrio /etc. do root. (cd /etc.). Dever ter configurado o caminho que est instalado o Informix SDK para que o TOTVS Tec possa carregar as bibliotecas de comunicao com o banco de dados.

7.3.3. Variveis de Ambiente As variveis de ambiente necessrias podem ser definidas de forma padro conforme cada ambiente ou ser definidas no Shell script que inicia os servios do TotvsTec. No Linux start_totvsappserver.sh e no Windows totvsserver.bat.

LOGIX

63

Guia de Instalao

TOTVS Tec

As variveis necessrias para o Logix so: DBMONEY DBDATE DBCENTURY CLASSPATH FGLPROFILE FGLDBPATH FGLGUI V4GL V4JS AMBIENTE CODCLIPAR LGXDOC LGXGR LGXBI SMTP_SERVER

A seguir so detalhadas as variveis a serem definidas:

Chave DBMONEY Descrio Define o ponto decimal a ser exibida nas telas e relatrios do Logix.

DBMONEY=, DBDATE DBCENTURY CLASSPATH

Define o formato da data a ser exibida nas telas e relatrios do Logix.

DBDATE=dmy4/
Define o sculo corrente para complementar quando digitado somente os dois dgitos do ano.

DBCENTURY=C
Define o caminho das bibliotecas necessrias para os servios do Java Envia, Java PDF, Botelo Bancrio, NFe, etc.

CLASSPATH=c:\totvs\logix\lib\activation.jar:c:\totvs\logi x\lib...
FGLDBPATH Identifica o diretrio onde est o arquivo SCHEMA (logix.sch) com o layout/definies das tabelas do Logix utilizado na compilao de programas.

FGLDBPATH=c:\totvs\logix\apo
FGLPROFILE Identifica o diretrio onde est o arquivo de configurao dos labels das teclas utilizadas nos programas.

FGLPROFILE=c:\totvs\logix\logixprofile.pro
FGLGUI V4GL/V4JS Identifica para os programas que a execuo em ambiente grfico.

FGLGUI=1
Identifica para o Logix o uso de mltiplos compiladores.

V4GL=4j3 V4JS=4j3
VIS_4JS Identifica para o menu (men3000) o visualizador de arquivo que deve ser utilizado.

VIS_4JS=9
AMBIENTE Identifica o sistema operacional que est sendo executado o servidor de aplicao para o Logix.

LOGIX

64

Guia de Instalao

TOTVS Tec

AMBIENTE=WINDOWS ou AMBIENTE=LINUX
LGXDOC Identifica o diretrio onde est instalado o Help/Manual online do Logix. Verifique o documento TotvsTec Melhores Prticas.

LGXDOC=http://localhost:8080/lgxdoc
LGXGR Identifica o diretrio onde est instalado o Gerenciador de Relatrios. Verifique o documento TotvsTec Melhores Prticas.

LGXGR=http://localhost:8080
LGXBI SMTP_SERVER Identifica o diretrio onde est instalado o Logix BI.

LGXBI=http://localhost:7070/lgxbi
Identifica o servidor do servio de envio de e-mail para o Logix.

SMTP_SERVER=smtp.provedor.com.br

LOGIX

65

Guia de Instalao

TOTVS Tec

7.4.

Configurando TOTVSAppServer

A instalao prepara o TOTVSAppServer com as configuraes mnimas para a sua correta execuo. Porm, pode-se configur-lo por meio da manuteno do arquivo de configuraes TOTVSAPPSERVER.INI, utilizando um editor de texto notepad, edit, etc. Esse arquivo fica em: Windows = c:\totvs\logix\bin\appserver ou Linux = /totvs/logix/bin/appserver

totvsappserver.INI O arquivo totvsappserver.ini responsvel pela configurao do TOTVSAppServer. A seguir so detalhadas todas as configuraes que se encontram no arquivo totvsappserver.INI. As configuraes para TOTVSAppServer so mantidas em diferentes sees, conforme a estrutura do arquivo de configuraes a seguir. Sees Environment (Logix) A seo Environment nomeada aqui como Logix contm as informaes dos diretrios de execuo do TOTVSAppServer, informaes do idioma, interface, diretrios, repositrio e informaes para acesso ao TOTVSDbaccess. Estas informaes so identificadas para cada conexo, ou seja, cada TOTVSSmartClient que se conectar ao Servidor deve informar qual a seo que ser utilizada. Assim, os diretrios para trabalho, o idioma, a interface e o repositrio podem ser obtidos a partir das informaes da seo definida. Uma seo padro, chamada Logix, criada na instalao e utilizada sempre que o TOTVSSmartClient se conectar sem informar uma seo por meio de parmetros de linha de comando.
Chave SourcePath RootPath StartPath Descrio Identifica o diretrio onde os repositrios de APOs so mantidos na mquina em que o TOTVSAppServer est instalado. Identifica o diretrio raiz do TOTVS Tec, a partir do qual todos os diretrios utilizados pelo TOTVS Tec sero criados. Identifica o diretrio onde o arquivo de error do TOTVS Tec se encontra. Alguns programas geram informaes do contedo de suas variveis neste arquivo. Este diretrio criado a partir do diretrio raiz, definido na chave anterior. Identifica o idioma que ser utilizado. Pode ser Portuguese, English ou Spanish. Esta informao tambm utilizada pelo servidor para definio do repositrio a ser acessado. Identifica a verso do Logix. Identifica o prefixo do RPO Logix.

RpoLanguage

RpoVersion RpoPrefix

LOGIX

66

Guia de Instalao

TOTVS Tec

Exemplo: RpoPrefix=lgx FGLSQLReplay Indica se haver gravao do Log de Warnings, referente as informaes de acesso ao banco de dados. O arquivo de log TOTVSconsole.log gravado no diretrio \totvs\logix\bin\appserver. Valores possveis: 1 - Grava o log; 0 - No grava o log. SCROLLCURSORSIZE Define a quantidade mxima de registros do buffer de leitura que podem ser recuperados do banco de dados para um cursor definido no programa como Scroll. Quantidade padro igual a 1000 DBAlias Identifica o Data Source Name da configurao do ODBC Informix Driver Setup ou nome do servio configurado no Client do Oracle, ou ainda, o nome utilizado no ODBC como fonte de dados para o SQLSERVER; define a conexo com o banco de dados. Exemplo: DBALIAS=Logix10 Obs: Utilizado quando existe mais de uma seo Environment Logix e cada uma ir acessar uma base de dados diferente, base de teste e base de produo. DBDataBase Identifica o nome do DataBase que ser utilizado. Valores aceitos: ORACLE, INFORMIX, MSSQL Exemplo: DBDataBase = INFORMIX. OUTPUTDIR Determina o caminho padro para gravao de arquivos (relatrios) quando o caminho no programa no est definido. Quando essa chave no est definida, e no programa tambm no est definido o caminho, os arquivos (relatrios) so gravados dentro da pasta do Server TOTVS Tec. (/TOTVS/Bin/appserver/) Exemplo: OutputDir=c:\publico\lst\ InactiveTimeout Determina o tempo de espera para a interrupo da conexo entre o client com o servidor, esse tempo o perodo que o client fica sem nenhuma atividade. Esta configurao pode ser realizada na seo [General]. Porm, ser vlida para todos os ambientes configurados no servidor. A especificao da chave InactiveTimeOut, na seo [Environment], prevalecer sobre a configurada na seo [General]. Esse tempo determinado em segundos. Exemplo: InactiveTimeout=600 equivalente a 10 minutos.

TOTVSDbAccess A seo TOTVSDbaccess contm as informaes utilizadas para o acesso base de dados. As informaes desta seo so utilizadas para todas as conexes, a no ser que estejam definidas na seo Logix das conexes, como detalhado a seguir.
Chave DataBase Descrio Identifica o nome do DataBase que deve ser utilizado.

LOGIX

67

Guia de Instalao

TOTVS Tec

DRIVER Alias

Valores aceitos: ORACLE, INFORMIX, MSSQL. Exemplo: DataBase = INFORMIX Define o driver de comunicao com o banco de dados utilizado. DRIVER=TOTVSDbsrv.dll Identifica o Data Source Name da configurao do ODBC Informix Driver Setup. Utilizado no TOTVSDbaccess para acesso base de dados. ALIAS=Logix10 Opcionalmente, pode-se colocar a chave ALIAS na seo Logix, acrescentando DB no incio da chave: Exemplo: [Logix] DBALIAS=Logix10

DRIVERS A seo Drivers define quais os protocolos de conexo podero ser utilizados para os terminais conectarem ao TOTVSAppServer. Chave Active Descrio Identifica os nomes das sees de configurao de protocolos ativos. Mais de um protocolo pode ser informado separando por vrgula (,), desse modo permite que existam conexes de terminais ao servidor efetuadas por meio de diferentes protocolos.

Protocolos de Conexo (definidos na seo Drivers) TCP O TOTVSAppServer utiliza o protocolo TCP-IP para realizar a conexo com os terminais. A configurao do protocolo utilizado efetuada por meio de sees com as chaves, definido na seo Drivers, informaes como a porta de conexo, o servio e o tipo da conexo. As conexes ativas, ou seja, que podem ser utilizadas pelos terminais para conectar ao Servidor so aquelas que esto definidas na seo Drivers na chave Active, descrita anteriormente. Podem ser criadas diversas sees para as conexes ativas.
Chave Port Descrio Identifica a porta que ser utilizada para as comunicaes via TCP-IP. Obs: O TOTVSAppServer utiliza TCP Stack (A mesma porta para todos os usurios).

ServerNetwork Esta seo utilizada no caso do uso de Balanceamento de Carga. Devem ser informados na chave a seguir quais so os servidores disponveis na rede.
Chave MasterConnection Descrio Determina se o servidor MASTER ir aceitar conexes. 0 = desabilita (recomendado)
LOGIX

68

Guia de Instalao

TOTVS Tec

Servers

1 = habilita Especificar os nomes das sees que contm as informaes dos servidores, separados por vrgula e na seqncia de busca desejada. Dentro de cada nova seo de servidor deve ser informado o nome, o tipo de conexo (TCP), a porta ou servio e o nmero de conexes permitidas. Exemplo: [ServerNetwork] Servers=SERVER1,SERVER2 Masterconnection=0 (Default ligado); Informa que o master no ir aceitar conexes [SERVER1] TYPE=TCPIP Server=Servidor1 Port=4321 Connections=60 [SERVER2] TYPE=TCPIP Server=Servidor2 Port=4322 Connections=40

Service Esta seo utilizada para informar o nome interno e externo do Servio do TOTVSAppServer Windows (ver item 5.6). Esta opo til quando for necessrio utilizar mais de um TOTVSAppServer rodando como servio Windows na mesma mquina, pois permite ao usurio informar nomes diferentes.
Chave Name Displayname Descrio Nome interno do Servio. Nome a ser exibido na janela de servios do Windows.

HTTP Esta seo permite ao TOTVS Application Server atuar como servidor HTTP (protocolo internet), ou seja, pode fornecer paginas em Html para um Browser.
Chave Enable Port Path Descrio Enable=1 (1=habilitado 0=desabilitado) Identifica a porta que ser utilizada para a conexo HTTP. Port=8090 Define o caminho do diretrio onde est localizado o arquivo de configurao para execuo via WEB, TOTVSSMARTCLIENT.HTM E TOTVSSMARTCLIENTAX.CAB. path=c:\totvs\bin\smartclient\

LicenseServer A seo LicenseServer contm as informaes sobre o Servidor de Licenas.

LOGIX

69

Guia de Instalao

TOTVS Tec

Chave Enable Port

ShowStatus

Descrio Indica se o servidor TOTVS Tec ser um servidor de licenas. Enable=1 (1=habilitado 0=desabilitado) Identifica a porta que ser utilizada para as comunicao entre o servidor de Licenas e os servidores TOTVS Tec. Port=4310 Esta chave permite o controle de requisies e liberaes de licena e semforos atravs de mensagens na tela de console. ShowStatus=1 (1=habilitado 0=desabilitado)

Para proceder com a configurao do servidor de licena do Logix verifique no documento Procedimento_instalacao_controle_licenca.pdf disponvel na pgina de suporte on-line da Tecnologia TOTVS Tec.
LicenseClient A seo LicenseClient define as informaes que sero utilizadas para o servidor TOTVS Tec se conectar a um Servidor de Licenas. Chave Server Descrio o nome ou nmero do IP do computador onde est o Servidor de Licenas. Server=10.10.10.10 Identifica a porta que ser utilizada para a comunicao entre o servidor TOTVS Tec e o Servidor de Licenas. Portanto, deve ser o mesmo valor da chave Port na seo LicenseServer do servidor de Licenas. Port=4310

Port

General A seo General contm as informaes globais sobre o Servidor TOTVSAppServer, aquelas que so comuns para todos os ambientes.
Chave Console BuildKillUsers Descrio Default = 1 Na compilao, se esta chave estiver ativa e houver algum usurio conectado, o usurio ser desconecto. 0 = desabilita (padro) 1 = habilita Define a gravao de um log, no diretrio de instalao do TOTVS Application Server (totvsconsole.log), com as informaes necessrias para diagnosticar erros e calcular o tempo de execuo de uma determinada rotina no TOTVS Application Server. Todas as mensagens enviadas e recebidas entre o TOTVS Application Server e o TOTVS Smart Client, so logadas por esta chave. Com isso, possvel verificar o tempo de execuo das mensagens enviadas e o tempo que o TOTVS Application Server levou para processar uma determinada rotina.

LogMessages

LOGIX

70

Guia de Instalao

TOTVS Tec

ConsoleLog consolemaxsize InactiveTimeout

0 = desabilita (padro) 1 = habilita Ativa a gravao do arquivo de LOG das mensagens da console. Default = 1 (grava) Define o tamanho mximo do arquivo de LOG. Default = 5242880 (5MB) Determina o tempo de espera para a interrupo da conexo entre o client com o servidor, esse tempo o perodo que o client fica sem nenhuma atividade. Esta configurao pode ser realizada na seo [Environment]. Porm, ir prevalecer sobre a configurada na seo [General]. Esse tempo determinado em segundos. Exemplo: InactiveTimeout=600 equivalente a 10 minutos.

ConsoleFile

MonitorKey

Define a pasta e nome do arquivo onde sero gravados os logs das mensagens da console. Exemplo: ConsoleFile=c:\temp\meu_arquivo_log.log Define a comunicao com o TotvsMonitor. Sempre dever ter o valor LOGIX. Exemplo: MonitorKey=LOGIX A mesma chave dever estar definida no totvsmonitor.ini na seo [Preferences]. Esta chave habilita uma coluna no TotvsMonitor, onde ser informada a quantidade de memria utilizada para cada processo apresentado no monitoramento. 0 = desabilita (padro) 1 = habilita Exemplo: DebugThreadUsedMemory=1 Define se a instncia atual do TOTVS Application Server receber conexes do TOTVS Development Studio. Esta chave recomendada para ser configurada nos servios de produo. Pois, desta forma, o servio no atender as conexes do TOTVS Development Studio (IDE), mesmo que indevidamente seja apontado um IDE para o servio de produo. 0 = no permite conexes do IDE 1 = permite conexes do IDE (padro)

DebugThreadUsedMe mory

CanAcceptDebugger

LogixTelnet A seo LogixTelnet contm as informaes necessrias para a execuo de programas modo caracter via Telnet.

Essa seo obrigatria, mesmo que no seja feito acesso via telnet ao sistema.

LOGIX

71

Guia de Instalao

TOTVS Tec

Enable Port Environment Main

Define se o a execuo via telnet est habilitada. Enable=1 (1=habilitado 0=desabilitado) Identifica a porta que ser utilizada para as comunicaes via TCPIP. Port Default=5520 Define a seo Logix que ser utilizada na execuo dos programas. Define o programa que ser executado. Main=men3000.4gl

Exemplo de Configurao A seguir, so apresentados exemplos de configuraes do TOTVSAppServer, onde pode ser visualizado um exemplo com apenas uma seo Environments Logix e um outro exemplo com duas sees Environments Logix diferentes: No exemplo onde temos duas sees Environmenst Logix, Logix e Logixtst, no foi definida a seo TOTVSDbaccess, pois essa configurao est dentro da seo Environmenst Logix, outra diferena entre eles que utilizam Repositrios e base de dados diferentes. Exemplos do arquivo de configurao do TOTVSAPPSERVER.INI Para um servidor com uma seo environment Logix. [Logix] SourcePath=c:\totvs\logix\apo RootPath=c:\totvs\logix StartPath=\totvs_data RpoLanguage=Portuguese RpoVersion=102 RpoPrefix=lgx ;FGLSQLREPLAY=1 SCROLLCURSORSIZE=100000000 [Drivers] Active=TCP [TCP] TYPE=TCPIP Port=4320 [TotvDbaccess] DataBase=Informix Driver=totvsdbsrv.dll ALIAS=logix10 [General] Console=1 BuildKillUsers=1 LogEnable=1
LOGIX

72

Guia de Instalao

TOTVS Tec

ConsoleLog=1 Consolemaxsize=50000000 MonitorKey=LOGIX

[LicenseClient] Server=10.10.10.10 Port=4310

[LogixTelnet] Enable=1 Port=5520 Environment=logix main=men3000.4gl [SERVICE] --- Como servio no Windows Name=totvsappserver DisplayName=Totvs Server Para um servidor de controle de Licena. [Drivers] Active=TCP [TCP] TYPE=TCPIP Port=4311 [LicenseServer]
Enable=1 Port=4310 ShowStatus=0

[SERVICE] --- Como servio no Windows Name=totvsappserverlic DisplayName=TotvsServer License [General] Console=1 BuildKillUsers=1 LogEnable=1 ConsoleLog=1 Consolemaxsize=50000000 MonitorKey=LOGIX Para um servidor com duas sees environment Logix. [Logixprd] SourcePath=c:\totvs\logix\apo RootPath=c:\totvs\logix StartPath=\totvs_data
LOGIX

73

Guia de Instalao

TOTVS Tec

RpoLanguage=Portuguese RpoVersion=102 RpoPrefix=lgx DBALIAS=logix10prd SCROLLCURSORSIZE=10000 [Logixtst] SourcePath=c:\totvs\logix\apo\tst RootPath=c:\totvs\logix StartPath=\totvs_data\tst RpoLanguage=Portuguese RpoVersion=102 RpoPrefix=lgx DBALIAS=logix10tst SCROLLCURSORSIZE=100000000 [Drivers] Active=TCP [TCP] TYPE=TCPIP Port=4320 [General] Console=1 BuildKillUsers=1 LogEnable=1 ConsoleLog=1 consolemaxsize=50000000 MonitorKey=LOGIX [TotvDbaccess] DataBase=Informix Driver=totvsdbsrv.dll [LogixTelnet] Enable=1 Port=5520 Environment=logix main=men3000.4gl
[LicenseClient] Server=10.10.10.10 Port=4310

[SERVICE] --- Como servio no Windows Name=totvsappserver DisplayName=Totvs Server

LOGIX

74

Guia de Instalao

TOTVS Tec

Para um servidor Master com Load Balance com 3 servidores Slaves e duas seo environment Logix [Logixprd] SourcePath=c:\totvs\logix\apo RootPath=c:\totvs\logix StartPath=\totvs_data RpoLanguage=Portuguese RpoVersion=102 RpoPrefix=lgx DBALIAS=logix10prd SCROLLCURSORSIZE=100000000 [Logixtst] SourcePath= c:\totvs\logix\apo\tst RootPath= c:\totvs\logix StartPath=\totvs_data\tst\ RpoLanguage=Portuguese RpoVersion=102 RpoPrefix=lgx DBALIAS=logix10tst SCROLLCURSORSIZE=100000000 [Drivers] Active=TCP [TCP] TYPE=TCPIP Port=4320 [General] Console=1 BuildKillUsers=1 LogEnable=1 ConsoleLog=1 consolemaxsize=50000000 MonitorKey=LOGIX [TotvDbaccess] DataBase=Informix Driver=TOTVSDbsrv.dll [LogixTelnet] Enable=1 Port=5520 Environment=logix main=men3000.4gl

LOGIX

75

Guia de Instalao

TOTVS Tec

[LicenseClient] Server=10.10.10.10 Port=4310

[ServerNetwork] MASTERCONNECTION=0 Servers=SLAVE1,SLAVE2,SLAVE3 [SLAVE1] TYPE=TCPIP Port=4321 Server=10.10.10.10 Connections=30 [SLAVE2] TYPE=TCPIP Port=4322 Server=10.10.10.10 Connections=30 [SLAVE3] TYPE=TCPIP Port=4323 Server=10.10.10.10 Connections=30 [SERVICE] --- Como servio no Windows Name=totvsappserver DisplayName=Totvs Server Master Para um servidor Slave com duas sees environment Logix. [Logixprd] SourcePath= c:\totvs\logix\apo RootPath= c:\totvs StartPath=\totvs_data RpoLanguage=Portuguese RpoVersion=102 RpoPrefix=lgx DBALIAS=logix10prd SCROLLCURSORSIZE=100000000

[Logixtst] SourcePath= c:\totvs\logix\apo\tst RootPath= c:\totvs\logix StartPath=\totvs_data\tst\ RpoLanguage=Portuguese

LOGIX

76

Guia de Instalao

TOTVS Tec

RpoVersion=102 RpoPrefix=lgx DBALIAS=logix10tst SCROLLCURSORSIZE=100000000 [Drivers] Active=TCP [TCP] TYPE=TCPIP Port=4321 [General] Console=1 BuildKillUsers=1 LogEnable=1 ConsoleLog=1 consolemaxsize=50000000 MonitorKey=LOGIX [TotvDbaccess] DataBase=Informix Driver=totvsdbsrv.dll [LogixTelnet] Enable=1 Port=5521 Environment=logix main=men3000.4gl
[LicenseClient] Server=10.10.10.10 Port=4310

[SERVICE] --- Como servio no Windows Name=totvsappserver1 DisplayName=Totvs Server Slave1

LOGIX

77

Guia de Instalao

TOTVS Tec

7.5.

Configurando TOTVSSmartClient

A instalao prepara o TOTVSSmartClient com as configuraes mnimas para a sua correta execuo. Porm, pode-se configur-lo por meio da manuteno do arquivo de configuraes TOTVSSMARTCLIENT.INI, utilizando um editor de texto notepad, edit, etc. As configuraes do SmartClient podem ser customizadas, de modo que pode ser mantida diferente conexo em um mesmo servidor. Por exemplo: Uma rede local com conexes via TCP-IP e algumas outras conexes remotas, via modem ou Internet, utilizando TCP-IP; Diferentes redes conectadas via linha privada. Cada uma destas redes mantm um TOTVSAppServer para o processamento distribudo. As configuraes so mantidas em diferentes sees, conforme a estrutura do arquivo de configuraes, encontrado no diretrio de execuo do SmartClient. TOTVSSmartClient.INI O arquivo TOTVSSmartClient.INI responsvel pela configurao do SmartClient. A seguir so detalhadas todas as configuraes que se encontram no arquivo TOTVSSmartClient.INI. Sees Config Identifica informaes gerais de configurao do SmartClient. Chave LastMainProg Descrio Contm a lista dos ltimos programas iniciais a serem executados no TotvsSmartClient. Por exemplo, pode-se iniciar MEN3000.4gl. Contm a lista de ambientes a serem executados no TotvsSmartClient.

ENVSERVER

Drivers A seo Drivers define quais os protocolos podem ser utilizados para que o Terminal conecte-se ao TOTVSAppServer. igual a seo de mesmo nome no arquivo de configuraes do TOTVSAppServer.INI, a diferena que as sees aqui informadas (que devem ser separadas por vrgulas) so utilizadas em tentativas de conexo, de acordo com a ordem em que foram informadas.

Chave Active

Descrio Identifica os nomes das sees de configurao de protocolos ativos. Mais de um protocolo pode ser informado separando por vrgula (,).

LOGIX

78

Guia de Instalao

TOTVS Tec

Protocolos de Conexo (definidos na seo Drivers) As sees de configurao de protocolos so definidas da mesma forma que no arquivo de configuraes do TOTVSAppServer. No necessitam ter o mesmo nome que o definido no TOTVSAppServer, porm as informaes devem ser as mesmas e, somente os protocolos definidos na chave Active da seo Drivers do arquivo de configurao do TOTVSAppServer, podem ser utilizados quando estiver configurando o TOTVSSmartClient.
Chave Server Descrio Identifica o servidor de aplicao do TOTVSAppServer. Para a execuo local (TOTVSAppServer e TOTVSSmartClient executados na mesma mquina) pode-se informar: Server = LocalHost. Para execuo remota, o nome do servidor ou o endereo IP deve ser informado. Para o TOTVSSmartClient o Server deve ser o mesmo configurado no TOTVSAppServer onde o terminal est conectado. Identifica a porta que ser utilizada para as comunicaes via TCP-IP. Para execuo remota ou local a Port deve ser informada. Para o TOTVSSmartClient deve ser o mesmo configurado no TOTVSAppServer onde o terminal est conectado. A porta informada deve ser a mesma configurada em ambos, TOTVSAppServer e TOTVSSmartClient;

Port

Exemplo de Configurao A seguir apresentado TOTVSSmartClient. um exemplo do arquivo de configuraes do

[Config] LastMainProg=men1002 (Logix10) ou men3000 (Logix05) EnvServer=logixprd,logixtst [Drivers] Active=TCP [TCP] Server=10.15.10.88 ou localhost ou ServerLogix [Nome do Computador ou nmero IP do Computador] Port=4320

TOTVSSmartClient.htm O arquivo TOTVSSmartClient.HTM responsvel pela configurao do TOTVSSmartClient para execuo via WEB. A seguir os detalhes das configuraes necessrias do arquivo TOTVSSmartClient.HTM.

LOGIX

79

Guia de Instalao

TOTVS Tec

A cada atualizao do TOTVSSmartclient ActiveX, que ocorre a cada troca de build do TOTVS Tec, as chaves do .htm 'classid' e 'codebase' sofrem alteraes de verso e portanto necessrio utilizar .htm com os novos valores.
Chave classid codebase Server Descrio

classid="clsid:035a66df-db41-4020-89d5-869049748e5c" codebase="totvssmartclientax.cab#version=8,8,307,0" Identifica o servidor de aplicao do TOTVSAppServer. Endereo TCP/IP ou Nome TOTVSAppServer. <param name="Server" value="10.10.10.10">
Identifica a porta que ser utilizada para as comunicaes. Porta TCP/IP em uso no TOTVSAppServer. <param name="TCPPort" value="4320"> Define o programa inicial a ser executado. <param name="StartProgram" value="men1002">

Port

StartProgram

Exemplo:
<html> <head> <meta http-equiv="Content-Language" content="en-us"> <meta http-equiv="Content-Type" content="text/html; charset=windows1252"> <title>TOTVS Tec - Logix</title> <script> window.onhelp = new Function('return false;'); parent.window.moveTo(0,0); parent.window.resizeTo(screen.width-(screen.widthscreen.availWidth),screen.height-(screen.height-screen.availHeight)); </script> </head> <body topmargin="0" leftmargin="0" rightmargin="0"> <object classid="clsid:035a66df-db41-4020-89d5-869049748e5c" codebase="totvssmartclientax.cab#version=8,8,307,0" width="100%" height="100%" align=center hspace="0" border="0" > <param name="Server" value="10.10.10.10"> <!-- Nome TCP/IP ou URL do Totvs Server --> <param name="TCPPort" value="4320"> <!-uso no Totvs Server --> <param name="Environment" value="logix102"> <!-execuo --> <param name="Language" value="1"> <!-execuo 1=portugues 2=espaol 3=english --> <param name="StartProgram" value="men1002"> <!-inicial --> <param name="ReadOnly" value="OFF"> <!-edicao dos parametros -->

ou endereo Porta TCP/IP em Ambiente de Idioma de Programa OFF = permite

LOGIX

80

Guia de Instalao

TOTVS Tec

<param name="SecureConnection" value="0"> <!-- 0 (default) no utiliza conexao segura, 1= utiliza conexo segura, Protheus Server deve estar configurado tambm --> </object> </body> </html>

LOGIX

81

Guia de Instalao

TOTVS Tec

7.6.

Configurando TOTVSAppServer como servio do Windows

Para instalar o TOTVSAppServer como servio no Windows deve ser executado o seguinte comando a partir do diretrio do executvel do TOTVSAppServer. c:\totvs\logix\bin\appserver\totvsappserver.exe install

necessrio que o arquivo TOTVSAPPSERVER.INI exista. Para remover o TOTVSAppServer dos servios do Windows deve ser executado o seguinte comando a partir do diretrio do executvel do TOTVSAppServer. c:\totvs\logix\bin\appserver\totvsappserver.exe remove

LOGIX

82

Guia de Instalao

TOTVS Tec

As seguintes variveis de ambiente de sistema devero ser definidas conforme instrues constantes no item 5.3 - Configurando Variveis de Ambiente. FGLPROFILE V4GL V4JS AMBIENTE LGXDOC Estas variveis e seus valores so encontrados no arquivo totvsserver.bat que est em: c:\totvs\logix\bin\appserver\.

LOGIX

83

Guia de Instalao

TOTVS Tec

7.7.

Configurando TOTVSMonitor

A instalao prepara o TOTVSMonitor com as configuraes mnimas para a sua correta execuo. Porm, para o seu uso, deve ser includa uma chave nos arquivos de configurao TOTVSAPPSERVER.INI e TOTVSMONITOR.INI, utilizando um editor de texto notepad, edit, etc. TOTVSAPPSERVER.INI O arquivo TOTVSAPPSERVER.INI localiza-se na pasta do Server; Windows=c:\totvs\logix\bin\appserver Linux=/totvs/logix/bin/appserver Seo General Chave MonitorKey Descrio Identifica a chave de liberao para o monitoramento. Valor padro: MonitorKey=LOGIX

TOTVSMONITOR.INI O arquivo TOTVSMONITOR.INI localiza-se na pasta do Client; Windows=c:\totvs\logix\bin\smartclient Seo Preferences Chave MonitorKey Descrio Identifica a chave de liberao para o monitoramento. Valor padro: MonitorKey=LOGIX

LOGIX

84

Guia de Instalao

TOTVS Tec

7.8.

Configurando Telnet

Para executar programas em modo caractere via Telnet pode ser utilizado qualquer aplicativo Client Telnet, abaixo exemplo utilizando o aplicativo Putty.

LOGIX

85

Guia de Instalao

TOTVS Tec

7.9.

Configurando atalhos

Criar os seguintes atalhos na rea de trabalho: TOTVSAppServer Este atalho utilizado para iniciar o servidor de aplicao do TOTVSAppServer, quando no estiver configurado como um servio do Windows. O servidor de aplicao TOTVSAppServer sempre dever estar ativo antes de efetuar qualquer compilao e execuo de programas no Logix, pelo IDE ou TOTVSSmartClient.

LOGIX

86

Guia de Instalao

TOTVS Tec

TOTVSSmartClient Atalho para executar os programas do Logix no ambiente grfico. Efetua a comunicao entre o Client (terminal) e o Server, a interface do usurio.

LOGIX

87

Guia de Instalao

TOTVS Tec

7.10. Configurando Parmetros da Linha de Comando do TOTVSSmartClient Ao ser iniciado, o TOTVSSmartClient exibe a tela de parmetros iniciais, para identificao do Ambiente e da Conexo inicial. Porm, tais parametrizaes podem ser informadas por meio da linha de comando do cone de acesso ao TOTVSSmartClient.

c:\totvs\logix\bin\smartclient\totvssmartclient.exe As opes de linha de comando do TOTVSSmartClient so: -Q (Quiet): Indica que o TOTVSSmartClient no deve mostrar o Splash (imagem de apresentao) e a tela de identificao de parmetros iniciais necessita ser acompanhada da clusula P; -P (Main Program): Identifica o programa inicial; -R (CfgSection): Nome da seo de configurao. Por default, Config; -E (Environment Logix): Nome da seo de environment Logix no .INI do TOTVSAppServer que ser utilizada para definies gerais;

LOGIX

88

Guia de Instalao

TOTVS Tec

-C (Connection): Nome da seo de conexo que ser utilizada para a conexo ao TOTVSAppServer; -A (Parmetros para o Programa Inicial): Identifica um parmetro que ser passado para o programa inicial; -M (AllowMultiSession): Permite mltiplas instncias (Cpias) do TOTVSSmartClient na mesma mquina (Default: no permite); Por exemplo, pode-se utilizar a seguinte linha de comando: TOTVSSMARTCLIENT.EXE -Q -P=MEN3000 -E=LOGIX para executar o MEN3000 do Logix utilizando as configuraes do environment LOGIX definido do .INI do TOTVSAppServer. Exemplo:

c:\totvs\logix\bin\smartclient\totvssmartclient.exe -M -Q -P=men3000 -C=tcp -E=logix

Para Logix 05.10:

Para Logix 10:

c:\totvs\logix\bin\smartclient\totvssmartclient.exe -M -Q -P=men1002 -C=tcp -E=logix

LOGIX

89

Guia de Instalao

TOTVS Tec

8. 8.1.

Atualizao TOTVS Tec e RPO TOTVS Tec

A atualizao do TOTVS Tec consiste em baixar os respectivos arquivos recebidos dentro da sua pasta correspondente (importante que seja feito um backup dos arquivos existentes nas pastas antes de efetuar a atualizao) Windows: TOTVSAppServer (c:\totvs\logix\bin\appserver) TOTVSSmartClient (c:\totvs\logix\bin\smartclient) Help Online (c:\totvs\logix\doc) Linux: TOTVSAppServer (/totvs/logix/bin/appserver) TOTVSSmartClient (/totvs/logix/bin/smartclient)

8.2.

Atualizao Automtica TOTVSSMARTCLIENT

Para agilizar a atualizao do TOTVSSmartClient nas estaes, possvel configurar uma mquina com a verso mais recente e, a partir dela, efetuar a atualizao automtica nas estaes. Para habilitar este procedimento necessrio incluir a seo 'UPDATE', no arquivo TOTVSAPPSERVER.INI, com as seguintes chaves: Seo Update Chave Enable PathWindows Descrio
Define se a atualizao automtica est habilitada. Enable=1 (1=habilitado 0=desabilitado)

PathLinux

Identifica o caminho onde est o pacote de atualizao do TOTVSSMARTCLIENT para ambiente Windows PathWindows=c:\totvs\logix\bin\smartclient_win_upd (server Windows) PathWindows=/totvs/logix/bin/smartclient_win_upd (server Linux) Identifica o caminho onde est o pacote de atualizao do TOTVSSMARTCLIENT para ambiente Linux PathLinux=c:\totvs\logix\bin\smartclient_lin_upd (server Windows) PathLinux=/totvs/logix/bin/smartclient_lin_upd (server Linux)

Quando uma estao carregar o TOTVSSMARTCLIENT, o sistema ir verificar se o Build do Client compatvel com o servidor.

LOGIX

90

Guia de Instalao

TOTVS Tec

Caso os Builds no sejam compatveis, ao iniciar qualquer programa do Logix, e o recurso de atualizao automtica estiver devidamente configurado e habilitado, sero verificados automaticamente os arquivos da pasta especificada no servidor para atualizao e os arquivos da pasta do smartclient em execuo na estao. Caso um arquivo existente no servidor no seja encontrado na estao, ele copiado para esta. Caso os arquivos existam, porm apresentando alguma diferena (tamanho, data e/ou horrio), o arquivo tambm copiado do servidor para a estao. Este processo executado automaticamente exibindo na tela do Client uma janela informando sobre o progresso da verificao/atualizao. Para que a atualizao automtica seja realizada corretamente importante observar: Os arquivos constantes nas pastas de atualizao no smartclient devero estar descompactados; O usurio deve ter direito de gravao no diretrio do smartclient da estao onde este aplicativo est sendo executado/atualizado; Quando utilizamos o smartclient em ambiente Linux, os arquivos das pastas de atualizao automtica devem conter apenas letras minsculas, mesmo que se destinem atualizao de um Client para ambiente Windows;

Ao definir a(s) pasta(s) para conter os arquivos a serem atualizados do smartclient no servidor, devemos criar uma pasta especfica para esta finalidade e no utilizar para execuo do TOTVSSMARTCLIENT na estao servidora. Para que, nesta pasta, existam apenas os arquivos da pasta SMARTCLIENT que devam ser enviados todas as estaes remotas.

8.3.

RPO Repositrio de Programas

Em funo de atualizaes legais, melhorias ou correes so disponibilizados arquivos de atualizao. PAK = Pacote de atualizao, utilizado para um grupo de pragramas. UPD = Atualizao completa do RPO, atualizaes referente a um perodo. PTM = Atualizao de um pequeno numero de programas. Copiar o arquivo de atualizao para a pasta do RPO correspondente que ser atualizado. c:\totvs\logix\apo

Importante que se mantenha mais de um ambiente para baixa de programas. Os ambientes so configurados no arquivo INI do TOTVSAppServer c:\totvs\logix\apo\tst\

LOGIX

91

Guia de Instalao

TOTVS Tec

c:\totvs\logix\apo\prd\ Apos efetuar a copia do arquivo de atualizao necessrio aplicar no RPO por meio TOTVSDevStudio. A aplicao do arquivo de atualizao realizada por meio do TOTVSDevStudio e pode ser processada das seguintes formas: Executando o TOTVSDevStudio a partir do prprio servidor Executando o TOTVSDevStudio a partir de um Client (estao) Montando um ambiente TOTVS Tec local (com \BIN e \RPO), aplicando o arquivo e, em seguida, copiando o RPO atualizado para o Servidor. Este procedimento agiliza a aplicao de arquivos de atualizao, pois, evita a paralisao do Servidor de produo para esta operao. O processo de atualizao exige que se tenha acesso exclusivo ao sistema (No deve existir nenhum usurio utilizando-o). 8.4. Passos para atualizao do RPO

Para proceder a atualizao do repositrio (RPO) consulte a documentao Procedimento_para_aplicacao_de_atualizacoes.pdf disponvel na pgina de suporte on-line da Tecnologia TOTVS Tec. 9. Topologia de Utilizao de Rede do TOTVS Tec

Devido sua diviso em camadas, a tecnologia TOTVS Tec permite montar o ambiente de execuo com diferentes topologias, priorizando a execuo, o trfego de rede ou os recursos individuais das mquinas existentes, o que torna o processamento distribudo. Essa uma das grandes vantagens da tecnologia TOTVS Tec.

LOGIX

92

Guia de Instalao

TOTVS Tec

LOGIX

93

Guia de Instalao

TOTVS Tec

9.1.

Caractersticas e possibilidades de topologias de rede Pode-se manter um ou mais servidores de aplicao do Logix (TOTVSAppServer); Mquinas melhores ou com mais recursos podem ter um TOTVSAppServer executando localmente. Isto prioriza o processamento local, mas aumenta o trfego de rede entre o gerenciador de banco de dados e o TOTVSAppServer; Do mesmo modo, pode-se executar servidores remotamente, priorizando o processamento; As conexes devem ser efetuadas por meio do protocolo TCP-IP; Pode-se criar conexes via Internet por meio da montagem de um Web Server na empresa ou por meio de provedores de acesso (como a UOL e o ZAZ). Neste caso, o TOTVSAppServer pode ser executado no provedor ou na empresa utilizando uma LP para a conexo ao provedor de acesso; A Internet utilizada apenas como o meio de comunicao, ou seja, a conexo TCPIP entre o TOTVSSmartClient e o TOTVSAppServer. Alm da segurana fornecida pelo sistema Advanced, a segurana deve ser oferecida pela conexo. Por isso, aconselhvel que o servidor Web no seja o mesmo servidor da base de dados;

Pode-se manter uma pgina para o download do TOTVSSmartClient, de modo que os usurios remotos possam efetuar o download para conectar-se e utilizar o sistema.

A definio da melhor topologia para execuo um passo importante da implementao da tecnologia TOTVS Tec, pois influencia totalmente a performance. O maior trfego de rede est localizado entre o TOTVSAppServer e o Banco de Dados, j que o trfego entre o TOTVSAppServer e o TOTVSSmartClient contm somente informaes para montagem de telas e controle de teclado e mouse. Desta forma, dependendo do tipo e da velocidade da conexo, pode se tornar invivel manter um TOTVSAppServer em uma cidade conectado ao banco de dados em outra. Por outro lado, caso existam muitas conexes nesta outra cidade, ou caso estas conexes executem processamentos pesados, priorizar o processamento disponibilizando um TOTVSAppServer para ser executado localmente nesta cidade pode ser uma boa soluo.

LOGIX

94

Guia de Instalao

TOTVS Tec

Reviso 01 02

03 04

05 06 07 08 09

10 11 12 13 14 15 16 17 18

Quadro de Revises Descrio Alterao Inicial. Includa explicao das seguintes chaves de configurao: OUTPUTDIR, LGXGR, DBDATABASE, DBALIAS, INACTIVETIMEOUT; Includa explicao da configurao do TOTVSMONITOR; Includa explicao da configurao para a atualizao automtica do TOTVSSMARTCLIENT; Includa observao que deve ser iniciado o servio TOTVSDBACCESS utilizando um usurio com permisso de conexo no banco. Includas as opes Linux RedHat ES 5 e Linux Ubuntu 7.04 na planilha Sistema Operacional - captulo Instalao TOTVS Tec. Includos os captulo 3 (Controle de Licenas) e 6 (Instalao Servidor de Licenas); Includas, no cap. 7 (Configurando o TOTVS Tec), as seguintes sees: HTTP, LicenseServer, LicenseClient, Exemplos do arquivo de configurao do TOTVSAPPSERVER.INI e TOTVSSmartClient.htm. Revisado documento e corrigido os exemplos Atualizado tabela de sistemas operacionais homologados e atualizado texto dos itens 6.1 e 6.2 Corrigido local do TotvsDBMonitor Alterado descritivo do uso de conexes TELNET em COMPONENTES TOTVS TEC - Eliminado a chave RPODB do environment; - Includo informao da necessidade do patch Oracle 10.2.04 na lista de SGBD homologados. - Includo no item 8.2 a informao e detalhamento para ambiente Linux Alterado a nomenclatura das pastas da instalao do TOTVSTEC Eliminado variveis de ambiente LOGNAME, USERNAME e USERLOGIX Descrito a diretiva CONSOLEFILE, MONITORKEY, CONSOLEMAXSIZE Atualizada lista de sistemas operacionais e banco de dados homologados Alterado captulo 6, a forma de solicitao de liberao de senha de acesso Descrito a diretiva DEBUGTHREADUSEDMEMORY, LOGMESSAGES, CANACCEPTDEBUGGER, INACTIVETIMEOUT na seo Environment Includo Fique Atento no capitulo 7.4 seo LICENSE SERVER Alterado item 4, homologado MS-SQL Server 2008 e banco Oracle 11g Release 1 e cliente 11g Reviso dos itens 6, 7.1, 7.2 e 7.3

Data 30/03/07 28/08/08

10/09/08 03/10/08

08/09/09 15/10/09 23/10/09 05/11/09 01/12/09

16/12/09 17/02/10 04/03/10 26/03/10 12/04/10 14/04/10 14/05/10 02/07/10 27/08/10

LOGIX

95