manual instalacao totvs tec

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

Manual de Instalação TOTVS Tec

Rev.18 – 27/08/2010

Guia de Instalação TOTVS Tec

LOGIX i

ÍNDICE

CARACTERISTICAS DA TECNOLOGIA ................................................................ 1

1. Componentes TotvsTec .......................................................................................... 2

2. Aplicativos TOTVS Tec ......................................................................................... 3

3. Controle de Licenças .............................................................................................. 4

4. Instalação TOTVS Tec ........................................................................................... 5 4.1. Requisitos ......................................................................................................... 5

4.1.1. Espaço em Disco Mínimo ........................................................................ 5 4.1.2. Usuário ..................................................................................................... 5 4.1.3. Sistema Operacional ................................................................................. 5 4.1.4. Banco de Dados ........................................................................................ 6

5. Como Instalar o TOTVS Tec ................................................................................. 7 5.1. Instalação Windows .......................................................................................... 7

5.1.1. AutoRun ................................................................................................... 7 5.1.2. Manual ...................................................................................................... 8 5.1.3. Processo de Instalação .............................................................................. 8

5.2. Instalação Linux ............................................................................................. 13 5.2.1. Instalando ............................................................................................... 13 5.2.2. Processo de Instalação ............................................................................ 13

6. Instalação Servidor de Licenças .......................................................................... 15 6.1. Instalação Física do Hardlock......................................................................... 16 6.2. Instalação do Driver Proteq (compact-500) ................................................... 16

7. 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 Conexão 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 Variáveis de Ambiente ............................................................ 61 7.3.1. Criando as variáveis de ambiente no Windows ...................................... 61 7.3.2. Criando as variáveis de ambiente no Linux............................................ 63 7.3.3. Variáveis de Ambiente ........................................................................... 63

7.4. Configurando TOTVSAppServer ................................................................... 66 7.5. Configurando TOTVSSmartClient ................................................................. 78 7.6. Configurando TOTVSAppServer como serviço do Windows ....................... 82 7.7. Configurando TOTVSMonitor ....................................................................... 84 7.8. Configurando Telnet ....................................................................................... 85


LOGIX

7.9. Configurando atalhos ...................................................................................... 86 7.10. Configurando Parâmetros da Linha de Comando do TOTVSSmartClient 88

8. Atualização TOTVS Tec e RPO .......................................................................... 90 8.1. TOTVS Tec .................................................................................................... 90 8.2. Atualização Automática TOTVSSMARTCLIENT........................................ 90 8.3. RPO – Repositório de Programas ................................................................... 91 8.4. Passos para atualização do RPO ..................................................................... 92

9. Topologia de Utilização de Rede do TOTVS Tec .............................................. 92 9.1. Características e possibilidades de topologias de rede ................................... 94


LOGIX

1

CARACTERISTICAS DA TECNOLOGIA

O TOTVS Tec é a evolução tecnológica da linguagem 4GL/4JS, que tem a Inteligência toda dividida em quatro camadas, sendo 100% compatível com a tecnologia atual (4GL/4JS), preservando assim o legado existente. A versão TOTVS Tec é composta por 4 principais componentes e 2 aplicativos auxiliares para o desenvolvimento e monitoramento.

Componentes TOTVS Tec: TOTVSAppServer - Servidor de Aplicação (Application Server)

TOTVSSmartClient – Interface Terminal com Servidor

TOTVSDbAccess – Comunicação Banco de Dados

RPO

– Objetos de aplicativos/Repositório de programas/funções

Aplicativos TOTVS Tec: TOTVSDevStudio – Ambiente de Desenvolvimento Integrado (IDE)

TOTVSMonitor – Ambiente de monitoramento

Telnet

- Permite a execução do Logix em modo caracter.


LOGIX 2

1. Componentes TotvsTec

TOTVSAppServer é o servidor de aplicação(Application Server), é a aplicação encarregada da compilação e execução do código 4GL no qual o Logix foi escrito.

Esta é a parte do sistema que será executada no servidor e será responsável pela comunicação entre o cliente, a base de dados e o repositório de RPOs.

Na Linguagem TOTVS Tec 4GL as rotinas são mantidas em repositórios.

Isso permite que as rotinas sejam carregadas e descarregadas dinamicamente da memória da máquina onde o servidor está sendo executado, ou seja, de acordo com a necessidade de execução dos terminais conectados.

Isso facilita a atualização após correções de não conformidades ou criação de melhorias, pois apenas os repositórios modificados necessitam ser atualizados.

Desse modo, a performance é alta e não requer muito da máquina, para a execução do servidor.

O objetivo do servidor de aplicações é disponibilizar uma plataforma, que abstraia do desenvolvedor de software algumas das complexidades de um sistema computacional.

No desenvolvimento de aplicações comerciais, por exemplo, o foco dos desenvolvedores deve ser a resolução de problemas relacionados ao negócio da empresa, e não de questões de infraestrutura da aplicação. O servidor de aplicações responde a algumas questões comuns à todas as aplicações, como segurança, garantia de disponibilidade, balanceamento de carga e tratamento de exceções.

TOTVSSmartClient é a aplicação encarregada da interface com o usuário. Não existe processamento local, por isso o tráfego de rede entre o terminal e o servidor de aplicação é baixo, tratando apenas de comandos para o desenho das telas e tratamento do teclado e mouse.

É uma aplicação “thin-client”, que realiza apenas a interface com o usuário.

TOTVSDbaccess é aplicação encarregada de efetuar a comunicação com o banco de dados. Acesso aos dados é realizado pelo servidor de aplicação, por meio do padrão SQL.

APO/RPO é nesta parte do sistema que estarão os programas escritos em 4GL, à serem acionados para a execução de determinadas tarefas.

É por meio dos repositórios que poderemos incluir novas customizações no sistema.

O RPO é um arquivo binário compilado, que por sua vez não pode ser editado ou modificado, pois são os programas desenvolvidos pela LOGOCENTER.


LOGIX 3

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 Repositórios de RPO´s (Compilação de Customizações, Visualização de Funções existentes, etc...).Além de Depurar Programas Customizados. TOTVSMonitor - Trata-se do Ambiente de Monitoração do TOTVS Tec. Por meio do TOTVSMonitor, poderemos interagir com os Usuários Conectados ao Sistema, Analisar os Programas em Uso, Derrubar Conexões Pendentes, Enviar Mensagens ao Usuários. Telnet - Esta funcionalidade foi mantida, garantindo assim que seja possível utilizar o Logix em ambiente não Windows, para processamentos remotos onde não é possível um grande fluxo de informações pela rede ou em ambientes onde se exige equipamentos mais robustos, que não são compatíveis com Windows. Pois o TOTVSAppServer é também um servidor Telnet. Neste ambiente podem ser executadas todas as aplicações que não tenham funções gráficas, folders por exemplo. O menu para o sistema Logix será MEN3000.4GL.


LOGIX 4

3. Controle de Licenças A TOTVS envia junto aos CDs de instalação do TOTVS Tec um hardware de proteção que tem por objetivo a segurança de suas informações 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 liberação de senhas e nos processos de controle aos acessos simultâneos. Para utilização do sistema, é necessário que um dos servidores TOTVS Tec seja o servidor de licenças.


LOGIX 5

4. Instalação TOTVS Tec 4.1. Requisitos 4.1.1. Espaço em Disco Mínimo O TOTVS Tec precisa de no mínimo 1GB para instalação. Verifique se você tem espaço suficiente antes de iniciar a instalação. 4.1.2. Usuário Windows – Ter efetuado o login como Administrador ou usuário 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 versões suportadas: Sistema Operacional e Versão

Processador Arquitetura Application Server

Client Station

Windows XP (1, 6, 7) X86 32 bit N/A √ Windows Vista X86 32/64 bit N/A √ Windows 7 (8) X86 32 bit N/A √ Windows 2000 Server (1, 4, 5)

X86 32 bit √ √

Windows 2003 Server X86 32/64 bit √ √ Windows 2008 Server X86 32/64 bit √ √ Linux SUSE 10 SLES X86 32/64 bit √ N/A Linux SUSE 11 SLES X86 32/64 bit √ N/A Linux OpenSUSE 10.2 X86 32 bit N/A √ Linux RedHat AS 3 (1, 2) X86 32 bit √ N/A Linux RedHat ES 4 (1, 3) X86 32/64 bit √ N/A Linux RedHat ES 4 update 4 (1, 3)

X86 32 bit √ N/A

Linux RedHat ES 5.4 X86 32/64 bit √ N/A Linux RedHat 5 Desktop X86 32 bit N/A √ Linux Ubuntu 7.04 X86 32 bit N/A √ Linux Ubuntu 9.04 X86 32 bit N/A √ 1- Sistema operacional descontinuado pelo fabricante e em processo de desuso para a aplicação. 2- Suspensão do suporte pela Red Hat em 20/07/2006. 3- Suspensão do suporte pela Red Hat em 31/03/2009. 4- Suspensão do suporte pela Microsoft em 30/06/2005. 5- Suspensão do suporte extendido da Microsoft em 13/07/2010. 6- Suspendido o suporte pela Microsoft em 14/04/2009. 7- Suspensão do suporte extendido da Microsoft em 08/04/2014. 8- Sistema operacional homologado para build igual ou superior a 7.00.090818P-20091104.


LOGIX 6

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

Os sistemas operacionais homologados somente suportam o range de caracteres ocidentais. A TOTVS não homologa ambientes ou máquinas virtuais. No entanto, se o fornecedor do sistema operacional e o fornecedor do virtualizador de ambiente garantirem que as características do ambiente se mantém, o uso deste ambiente é válido. 4.1.4. Banco de Dados A tabela a seguir mostra a lista dos bancos de dados e versões homologados:

Banco de Dados Server Arquitetura Client Informix (1) 9.4 32 bit SDK 2.8x e 2.9x Informix 10.x 32 bit SDK 2.8x e 2.9x Informix 11.10 32/64 bit SDK 2.9x, 3.00 e

3.50 Informix 11.50 32/64 bit SDK 2,9x, 3.00 e

3.50 Oracle (1) 9i 32 bit 9i Oracle 10g patch 10.2.04 32 bit 9i e 10g Oracle 11g Release 1 32/64 bit 9i, 10g e 11g MS-SQL Server (1) 2000 32 bit 2000 MS-SQL Server 2005 32 bit 2000 e 2005 MS-SQL Server 2008 32/64 bit 2000, 2005 e 2008 1- Versão do banco de dados descontinuado pelo fabricante e em processo de desuso para a aplicação.


LOGIX 7

5. Como Instalar o TOTVS Tec O primeiro passo para instalação do TOTVS Tec é a instalação do TOTVSAppServer, TOTVSSmartClient e Manual Logix, que é efetuada por meio da SHELL SCRIPT de instalação.

Diretório de Instalação

· Padrão definido como: c:\totvs\logix = Windows /totvs/logix = Linux

· Não podem ser usadas unidades lógicas (drives de rede), para tanto utilize sempre o computador que faz o papel de servidor para efetuar a instalação. Com isso, diminui-se o risco de erros em eventual remoção do sistema.

5.1. Instalação Windows A shell script de instalação 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. Porém, é possível 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 exibição da tela de abertura conforme a

seguir.


LOGIX 8

No centro da tela serão apresentadas as opções dos aplicativos para instalação:

Instalação do TOTVSAppServer Instalação do TOTVSSmartClient Instalação do Manual Logix · Selecionada a opção é iniciada a cópia dos arquivos e criação dos diretórios e pastas. 5.1.2. Manual Execução dos seguintes programas a partir do respectivo CD: · Instalação do TOTVSAppServer no Windows

\INSTALLSERVER.BAT

· Instalação do TOTVSSmartClient no Windows

\INSTALLCLIENT. BAT

· Instalação do Manual Logix no Windows

\INSTALLMANUAL.BAT · É iniciada a cópia dos arquivos e criação dos diretórios e pastas. 5.1.3. Processo de Instalação

Instalando o Manual Logix


LOGIX 9

Para consultar a documentação online, é necessário instalar o Manual do Logix. A documentação poderá ser acessada no Logix, por meio da tecla [F1].

O Manual Logix é instalado do diretório padrão c:\TOTVS\doc\logix.

Instalando o TOTVSAppServer

O TOTVSAppServer pode ser instalado fisicamente em uma estação, por meio de uma opção da tela inicial de instalação do TOTVS Tec.

Este recurso é útil para instalação do TOTVSAppServer em computadores que não estão conectados à rede local, ou seja, que necessitam que os executáveis estejam fisicamente na máquina. 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 instalação do TOTVSAppServer nas estações só é recomendado em casos específicos (utilização remota, alto tráfego de dados na rede, etc.). Preferencialmente, é indicado o uso centralizado do TOTVSAppServer no Servidor, e por meio da criação de atalho para acesso. • Coloque o CD-ROM no driver e aguarde a exibição da tela de abertura conforme a

seguir:


LOGIX 10

No centro da tela são apresentadas as opções dos aplicativos para instalação:

Instalação do TOTVSAppServer Instalação do TOTVSSmartClient Instalação do Manual Logix • Clique na opção “TOTVSAppServer”. A Shell Script inicia o processo de instalação, apresentando a janela de confirmação da instalação dos produtos. • Pressione a tecla “ENTER” para prosseguir.


· Padrão (c:\totvs\logix\bin\appserver); · Não podem ser usadas unidades lógicas (drives de rede), para tanto, utilize sempre o

computador que faz o papel de servidor para efetuar a instalação. Com isso, diminui-se o risco de erros em eventual remoção do sistema.

Conclusão da Instalação

Ao final

da instalação é apresentada a tela sobre a conclusão do processo.

Verificação das Configurações de Instalação

Verifique a configuração de instalação na seção configurando TOTVS Tec.

Instalando TOTVSSmartClient


LOGIX 11

O TOTVSSmartClient pode ser instalado fisicamente em uma estação, por meio de uma opção da tela inicial de instalação do TOTVS Tec. Este recurso é útil para instalação do TOTVSSmartClient em computadores que não estão conectados à rede local, ou seja, que necessitam que os executáveis estejam fisicamente na máquina. 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 instalação do TOTVSSmartClient nas estações só é recomendado em casos específicos (utilização remota, alto tráfego de dados na rede, etc.). Preferencialmente, é indicado o uso centralizado do TOTVSSmartClient no Servidor, por meio da criação de atalho para acesso. • Coloque o CD-ROM no drive e aguarde a exibição da tela de abertura conforme a

seguir:

No centro da tela são apresentadas as opções dos aplicativos para instalação:

Instalação do TOTVSAppServer Instalação do TOTVSSmartClient Instalação do Manual Logix • Clique na opção “TOTVSSmartClient”. A Shell Script inicia o processo de instalação, apresentando a janela de Bem-vindo.


LOGIX 12

• Pressione a tecla “ENTER” para prosseguir.


· Padrão (c:\totvs\logix\bin\smartclient) · Não podem ser usadas unidades lógicas (drives de rede), para tanto, utilize sempre o

computador que faz o papel de servidor para efetuar a instalação. Com isso, diminui-se o risco de erros em eventual remoção do sistema


Ao final

da instalação, é apresentada a tela sobre a conclusão do processo.

Verifique a configuração de instalação na seção Verificação das Configurações de Instalação

configurando TOTVS Tec.


LOGIX 13

5.2. Instalação Linux Nesta seção, é explicado ao administrador como instalar o TOTVS Tec em Linux. 5.2.1. Instalando Faça o download do instalador e salve em uma área auxiliar. Ex. /tmp 5.2.2. Processo de Instalação • Execute o script shell:

cd /tmp ./installTOTVS.bin

• Aguarde a exibição da tela de abertura conforme a seguir.

É iniciada a instalação do TOTVS Tec com todas suas pastas e arquivos para a pasta padrão “/totvs”.

Instalação do Manual Logix

Para consultar a documentação online, é necessário instalar o Manual do Logix. A documentação é acessada a partir do Logix, pela tecla [F1]. O Manual Logix é instalado do diretório padrão c:\totvs\logix\doc a partir do instalador para ambiente Windows.


LOGIX 14

Instalando TOTVSSmartClient

O TOTVSSmartClient é um aplicativo para execução do Logix nas estações clientes. Elas podem ser Linux ou Windows. Nesta instalação o TOTVSSmartClient já é instalado para ambiente Linux, necessitando apenas a sua configuração conforme o capítulo “Configurando TOTVSSmartClient” neste documento. Para instalar em outras estações você necessita apenas copiar a pasta “/totvs/logix/bin/smartclient” ou compartilhar para as demais estações clientes Linux. Para estações clientes Windows será necessário executar o procedimento “Instalação Windows” o item “Instalando TOTVSSmartClient” neste documento.


Ao final

da instalação é apresentada a tela sobre a conclusão do processo.

Verificação das Configurações de Instalação

Verifique a configuração de instalação na seção configurando TOTVS Tec.


LOGIX 15

6. Instalação Servidor de Licenças O servidor de licenças deve ter conectado o HardLock (dispositivo de segurança) na porta USB e o driver do dispositivo instalado (se necessário). Para cada contrato de manutenção a TOTVS envia um HardLock Proteq.

Assim que receber a mídia de instalação, antes de iniciar a instalação, é necessário abrir um chamado na página de suporte da TOTVS (http://suporte.totvs.com) no link CST (Centro de Serviços TOTVS) e solicitar a chave de liberação da senha.

Figura – página de suporte a clientes TOTVS

Devido à necessidade de alta disponibilidade do Servidor de Licenças, recomendamos que seja configurado em um serviço separado, mesmo que esteja na mesma máquina. Para detalhes de configuração consulte “Procedimento Instalação Controle de Licenças” disponível na página de suporte do TotvsTec.

http://suporte.totvs.com/�


LOGIX 16

6.1. Instalação Física do Hardlock Conectar o dispositivo na porta USB:

Para ambientes que não possuem dispositivo USB, no caso BLADE é possível a utilização do dispositivo AnywhereUSB, mas somente para ambiente Windows, não existe solução para Linux até o momento. Mais informações em http://www.albacore.com.br/anywhereusb.htm. 6.2. Instalação do Driver Proteq (compact-500)

No diretório d:\totvs\logix\bin\drivers\ é necessário 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.

Windows

No diretório \totvs\logix\bin\drivers\ executar o instalador SetupProteq.exe para instalar o driver (PROTEQ.VXD E PROREQ.SYS) e DLLs correspondentes.

O arquivo de licença (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 licenças.

Efetuar o login com o administrador e o usar a última versão do Service Pack disponível.

Não há necessidade de instalação de driver para o modelo Proteq Compact-500. Linux

O modelo HASP é válido somente para sistema operacional Linux 32bits e quando o seu sistema operacional não tiver o driver instalado, você deverá fazer o download da página do fornecedor Alladin Knowledge System Ltd. (http://www.aladdin.com/support/hasp/hasp4/linuxdrv.aspx) do respectivo driver para instalar no seu sistema operacional.

http://www.albacore.com.br/anywhereusb.htm�

http://www.aladdin.com/support/hasp/hasp4/linuxdrv.aspx�


LOGIX 17

Fazer o download dos arquivos 1 e 2 no mesmo diretório e executar o shell script “dinst”.


LOGIX 18

7. Configurando o TOTVS Tec 7.1. Configurando o acesso do manual Logix 7.1.1. Windows No arquivo que inicia o serviço do TOTVSAppServer, o “totvsserver.bat” tem a variável 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 serviço do Windows (item 5.6) esta variável deverá ser definida nas variáveis de ambiente do Windows. Exemplo: SET LGXDOC=z:\logix\doc\ (unidade compartilhada e mapeada)

A documentação on-line do Logix 10 é composta por muitos arquivos, por este motivo recomendamos que o mesmo seja instalado abaixo de um serviço Apache-Tomcat que já é necessário para o BI-Logix e Gerenciador de Relatórios conforme descrito no documento “TOTVSTec Melhores Práticas”. 7.1.2. Linux

Quando o Manual Logix é instalado em um diretório do Linux ele deve ser mapeado no Samba ou similar, para ficar accessível via Windows, pois o Manual Logix Online utiliza o Browser Internet Explorer para abrir a documentação. 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 serviço do TOTVSAppServer, o start_TOTVSappserver.sh tem a variável 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 documentação on-line do Logix 10 é composta por muitos arquivos, por este motivo recomendamos que o mesmo seja instalado abaixo de um serviço Apache-Tomcat que já é necessário para o BI-Logix e Gerenciador de Relatórios conforme descrito no documento “TOTVSTec Melhores Práticas”.


LOGIX 19

7.2. Configurando Conexão com Banco de Dados 7.2.1. Windows

7.2.1.1. Informix Para conectar ao banco de dados Informix é necessário 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 máquina onde está sendo configurada a conexão conforme as versões homologadas.

Criando uma fonte de dados de sistema ODBC

1. Vá em, Iniciar > Configurações > Painel de Controle > Ferramentas Administrativas

2. Fontes de Dados (ODBC)


LOGIX 20

3. Selecione a pasta “Fonte de dados de sistema”

4. Selecione a opção Adicionar


LOGIX 21

5. Selecione o driver IBM INFORMIX 3.82 32 BIT


LOGIX 22

6. Na pasta General.

Informe o nome Data Source Name, que deverá ser informado no arquivo de configuração do TOTVSAppServer (TOTVSappserver.ini) na seção TOTVSDBACCESS, chave ALIAS ou na chave DBALIAS.

7. Na pasta Connection informe os dados conforme as configurações da instalação do banco de dados Informix.

8. Na pasta Environment informe os dados conforme abaixo.


LOGIX 23

9. Na pasta Advanced setar as opções;

Auto Commit Optimization Insert Cursors Scrollable Cursors

Para confirmar o cadastro selecione Aplicar e OK.


LOGIX 24

Para validar o cadastro e a conexão, selecione a pasta Connection - botão Apply & Test Connection


LOGIX 25

10. Depois de concluída a configuração da fonte de dados no ODBC é necessário

validar no TOTVSDBACCESS a conexão com o banco de dados no TOTVS Tec. 11. Para iniciar o serviço TOTVSDbAccess é necessário executá-lo. Vá em, Iniciar >

Executar... > cmd

12. Depois, informe cd \totvs\logix\bin\appserver 13. Para iniciar o serviço de conexão com o banco de dados digite:

Totvsdbaccess.exe –console

14. Depois de iniciado o serviço acima é necessário configurar o usuário e senha

padrão para validar o acesso ao banco de dados no TOTVSDBACCESS.


LOGIX 26

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

No campo Servidor informar o IP da máquina onde está sendo instalado o TOTVS Tec e foi iniciado o serviço TOTVSDbAccess. No campo “Porta” deixar o valor padrão 7890. Selecionar OK para prosseguir com a configuração.

Para incluir ou atualizar as configurações, selecionar Configurações, Informix, Novo. Informar o nome do serviço de conexão com o banco de dados definido no ODBC fonte de dados, e o usuário e senha padrão para conexão com o Banco de Dados.


LOGIX 27

O nome do Ambiente deverá ser informado no arquivo de configuração do TOTVSAppServer (TOTVSappserver.ini) na seção TOTVSDBACCESS chave ALIAS ou na seção 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 configuração e a conexão deve ser selecionada a opção Assistentes -

Validação de Conexão e informados os dados, conforme mostram as figuras abaixo:


LOGIX 28


LOGIX 29


LOGIX 30

7.2.1.2. Oracle Para conectar ao banco de dados Oracle é necessário criar um serviço independente para cada banco de dados que desejar conectar via TOTVS Tec. Esse serviço pode ser configurado por meio da ferramenta Oracle Net Manager. No arquivo de configuração do TOTVSAppServer (TOTVSappserver.ini) na seção TOTVSDBACCESS chave DATABASE deverá ser “ORACLE”. · Pré-requisito O Client Oracle for Windows homologado deverá estar instalado na máquina onde está sendo configurada a conexão. · Importante Caso exista mais de um produto Oracle instalado na maquina, a variável de ambiente ORACLE_HOME deverá ser definida, esta variável deverá apontar para o diretório de instalação do produto Oracle e a ser usado para a conexão com o TOTVSTec. Além desta variável, a uma outra denominada TNS_ADMIN também deverá ser definida. Abaixo descreve-se um exemplo desta configuração, supondo que o diretório de instalação do Oracle é C:\oracle\ora92: ORACLE_HOME=c:\oracle\ora92 TNS_ADMIN=c:\oracle\ora92\network\admin · Outras variáveis de ambiente importantes Para o correto funcionamento das aplicações da TOTVS/Logocenter é necessário definir as variaveis de ambiente de configuração de caracteres do Oracle de acordo com a especificação abaixo. NLS_LANG=AMERICAN_AMERICA.WE8ISO8859P1 NLS_DATE_FORMAT=dd/mm/yyyy hh24:mi:ss NLS_NUMERIC_CHARACTERS=,.

Criando um serviço independente no Oracle Net Manager

1. Vá em, Iniciar > Programas > Oracle – OraHome92 ou Oracle – OraClient10g_home1 > Configuration and Migration Tools > Net Manager


LOGIX 31


LOGIX 32

2. Selecione a opção Local

3. Selecione a opção Nomeação de Serviço


LOGIX 33

4. Adicionar um novo serviço de conexão ou verificar os serviços já existentes. O

nome desse serviço será utilizado no TOTVSDbMonitor para validar a conexão do banco no TOTVS Tec.

O nome do serviço de conexão deverá ser informado no arquivo de configuração do TOTVSAppServer (TOTVSappserver.ini) na seção TOTVSDBACCESS chave ALIAS ou na seção Logix chave DBALIAS. 5. Depois da conclusão da configuração do serviço no Client do Oracle é necessário

iniciar o TOTVSDbAccess para concluir a configuração de conexão com o banco de dados no TOTVS Tec.

6. Para iniciar o serviço TOTVSDbAccess é necessário executá-lo. Vá em, Iniciar >

Executar... > cmd

7. Depois digite:

cd \totvs\logix\bin\appserver 8. Em seguida digite:



LOGIX 34

9. Antes de proceder com a inicialização do Serviço do TOTVSDbaccess é necessário

incluir uma sessão denominada ORACLE e a diretiva ClientLibrary manualmente no arquivo de configuração TOTVSDbAccess.ini . A diretiva ClientLibrary deverá indicar o caminho no qual está localizada a DLL oci.dll. O arquivo de configuração TOTVSDbAccess.ini está localizado na mesma pasta que foi executado o TOTVSDbMonitor, C:\totvs\logix\bin\appserver.

Um exemplo desta configuração é descrito abaixo:

[ORACLE] ClientLibrary=C:\oracle\ora92\bin\oci.dll environments=logix10

10. Depois de iniciar os serviços acima citados é necessário configurar o usuário e senha padrão para acesso inicial ao banco de dados.

Para efetuar essa configuração é necessário 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 máquina onde está sendo instalado o TOTVS Tec e foi iniciado o serviço TOTVSDbAccess. No campo “Porta” deixar o valor padrão 7890. Selecionar OK para prosseguir com a configuração.


LOGIX 35

Para incluir ou atualizar as configurações clicar em Configurações, Oracle, Novo. Informar o nome do serviço de conexão com o banco de dados definido no Net Manager, e o usuário e senha padrão para conexão com o Banco de Dados.

O nome do Ambiente deverá ser informado no arquivo de configuração do TOTVSAppServer (TOTVSappserver.ini) na seção TOTVSDBACCESS - chave ALIAS ou na seção Logix - chave DBALIAS.

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


LOGIX 36

Depois de informados os dados, selecione Salvar. 14. Para validar a configuração e a conexão clicar na opção Assistentes, selecione “Validação de Conexão” e informe os dados.


LOGIX 37


LOGIX 38

7.2.1.3. MS-SQL Server Para conectar ao banco de dados MS-SQL Server é necessário 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 configuração do TOTVSAppServer (TOTVSappserver.ini) na seção TOTVSDBACCESS chave DATABASE deverá ser “MSSQL”.

Criando uma fonte de dados de sistema ODBC

1. Vá em, Iniciar > Configurações > Painel de Controle > Ferramentas Administrativas


LOGIX 39

2. Fontes de Dados (ODBC)

3. Selecione a aba “Fonte de dados de sistema”.


LOGIX 40

4. Selecione a opção “Adicionar”


LOGIX 41

5. Selecione o driver SQL Server

6. Na pasta General.

Informe o “Nome”, que deverá ser informado no arquivo de configuração do TOTVSAppServer (TOTVSappserver.ini) na seção TOTVSDBACCESS chave ALIAS.

7. Autenticação


LOGIX 42

Informe a forma de autenticação no banco de dados usada. Aqui sugerimos por meio de um usuário específico que será o proprietário (owner) das tabelas do sistema Logix.

7. Seleção do banco de dados a ser conectado.

8. Continuando....


LOGIX 43

9. Para validar o cadastro e a conexão selecione o botão “Testar Fonte de dados...” e “OK”


LOGIX 44

10. Depois da conclusão da configuração da ODBC é necessário iniciar o TOTVSDbAccess para concluir a configuração de conexão com o banco de dados no TOTVS Tec. 11. Para iniciar o serviço TOTVSDbAccess é necessário executá-lo. Vá em, Iniciar > Executar... > cmd

12. Depois digite:

cd \totvs\logix\bin\appserver 13. Em seguida digite:



LOGIX 45

14. Com o serviço TotvsDbaccess iniciado é necessário configurar o usuário e senha padrão 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 máquina onde está sendo instalado

o TOTVS Tec e foi iniciado o serviço TOTVSDbAccess. • No campo “Porta” deve ser informado o valor padrão 7890. • Selecionar OK para prosseguir com a configuração.


LOGIX 46

15. Para incluir ou atualizar as configurações, selecionar Configurações, Microsoft SQL, Novo. Deverá ser informado o nome da ODBC de conexão com o banco de dados e o usuário e senha padrão para conexão com o Banco de Dados.

O nome do Ambiente deverá ser informado no arquivo de configuração do TOTVSAppServer (TOTVSappserver.ini) na seção TOTVSDBACCESS chave ALIAS ou na seção Logix chave DBALIAS.

16. Utilizar no nome do Ambiente o mesmo nome utilizado na definição da ODBC.


LOGIX 47

Depois de informar os dados, selecionar Salvar. 17. Para validar a configuração e a conexão, selecione a opção Assistentes - botão validação de Conexão - e informe os dados.


LOGIX 48


LOGIX 49

18. A configuração de conexão com o banco de dados está concluída.


LOGIX 50

7.2.2. Linux

7.2.2.1. Informix Para conectar ao banco de dados é necessário configurar alguns arquivos, o que deverá ser feito como usuário administrador (root). No arquivo de configuração do TOTVSAppServer (TOTVSappserver.ini) na seção TOTVSDBACCESS chave DATABASE deverá ser “INFORMIX”. • Pré-requisito O Informix SDK homologado deverá estar instalado na máquina onde está sendo configurada a conexão. Arquivos a serem configurados: O arquivo .ODBC.INI está localizado no diretório 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 diretório onde está instalado o client do Informix. (/usr/informix/etc/sqlhosts) # logix10shm onipcshm 10.10.10.11 logix10 logix10soc onsoctcp 10.10.10.11 logix10srv logix10 olsoctcp 10.10.10.11 logix10srv # O arquivo SERVICES está localizado no diretório /etc. do root. (cd /etc.). Deverá ter o nome do serviço que faz a comunicação com o banco a port e tipo de comunicação. # logix10srv 5800/tcp logix10tsrv 5801/tcp # O arquivo PROFILE do root está localizado no diretório /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 comunicação 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 51

Concluindo a configuração dos arquivos é necessário iniciar o serviço TOTVSDbAccess no Linux, para concluir a configuração de conexão com o banco de dados. Para iniciar o serviço o seguinte comando no Linux devem ser executado: linux01:/totvs/logix/bin/appserver >./totvsdbaccess & Depois de iniciar o serviço acima citado é necessário configurar o usuário e senha padrão para acesso inicial ao banco de dados. Para efetuar essa configuração é necessário 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 máquina onde está sendo instalado o TOTVS Tec e foi iniciado os serviços TOTVSDbAccess e TOTVSAppServer. No campo “Porta” deve ser informado o valor padrão 7890. Selecionar OK para prosseguir com a configuração.


LOGIX 52

Para incluir ou atualizar as configurações, selecionar Configurações, Informix, Novo. Deve ser informado o nome do ambiente, definido no arquivo .ODBC.INI, e o usuário e senha padrão para conexão com o Banco de Dados.

O nome do ambiente deverá ser informado no arquivo de configuração do TOTVSAppServer (TOTVSappserver.ini) na seção TOTVSDBACCESS - chave ALIAS ou na seção Logix - chave DBALIAS.

Depois de informar os dados, selecione Salvar.


LOGIX 53

Para validar a configuração e a conexão, selecione a opção Assistentes, botão “Validação de Conexão”, e informe os dados.


LOGIX 54

Se a configuração estiver correta, a tela “Conexão Ok!” será exibida.


LOGIX 55

7.2.2.2. Oracle Para conectar ao banco de dados Oracle é necessário criar um serviço independente para cada banco de dados que será conectado via TOTVS Tec. Esse serviço pode ser configurado por meio da ferramenta Oracle Net Manager. No arquivo de configuração do TOTVSAppServer (TOTVSappserver.ini), na seção TOTVSDBACCESS - chave DATABASE, deverá ser “ORACLE”. • Pré-requisito O Client Oracle homologado deverá estar instalado na máquina onde está sendo configurada a conexão. Arquivos a serem configurados: O arquivo tnsnames.ora está localizado no diretório onde está instalado o Client do Oracle. (exemplo: /opt/oracle/product/10g/network/admin) Para cada ambiente TOTVS Tec é necessário um serviço 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 diretório /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 comunicação com o banco de dados, bem como as variáveis de ambiente que indicam das configurações regionais de caracteres aceitos pelo banco.


LOGIX 56

# export ORACLE_HOME=/opt/oracle/product/10g export LD_LIBRARY_PATH=$ORACLE_HOME/lib export TNS_ADMIN=$ORACLE_HOME/network/admin export NLS_LANG=AMERICAN_AMERICA.WE8ISO8859P1 export NLS_DATE_FORMAT='dd/mm/yyyy hh24:mi:ss' export NLS_NUMERIC_CHARACTERS=',.' # Antes de proceder com a inicialização do Serviço do TOTVSDbaccess é necessário incluir uma sessão denominada ORACLE e a diretiva ClientLibrary manualmente no arquivo de configuração TOTVSDbAccess.ini . A diretiva ClientLibrary deverá indicar o caminho no qual está localizada a biblioteca de conexão libclntsh.so. O arquivo de configuração TOTVSDbAccess.ini está localizado na mesma pasta que foi executado o TotvsDbaccess , /totvs/logix/bin/appserver.

Um exemplo desta configuração é descrito abaixo: [ORACLE] ClientLibrary=/opt/oracle/product/10gr2cli/lib/libclntsh.so. environments=logix10 Concluindo a configuração dos arquivos é necessário iniciar o serviço TOTVSDbAccess no Linux, para concluir a configuração de conexão com o banco de dados. Para iniciar o serviço o seguinte comando no Linux devem ser executado: linux01:/totvs/logix/bin/appserver >./totvsdbaccess & Depois de iniciar o serviço acima citado é necessário configurar o usuário e senha padrão para acesso inicial ao banco de dados. Para efetuar essa configuração é necessário 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 57

No campo “Servidor” deve ser informado o IP da máquina onde está sendo instalado o TOTVS Tec e onde foi iniciado os serviços TOTVSDbAccess e TOTVSAppServer. No campo “Porta” informar o valor padrão 7890. Selecionar OK para prosseguir com a configuração.

Para incluir ou atualizar as configurações, selecionar Configurações, Oracle, Novo. Deve ser informado o nome do serviço de conexão com o banco definido no arquivo tnsnames.ora e o usuário e senha padrão para conexão com o Banco de Dados.

O nome do ambiente deverá ser informado no arquivo de configuração do TOTVSAppServer (TOTVSappserver.ini), seção TOTVSDBACCESS - chave ALIAS, ou na seção Logix - chave DBALIAS.


LOGIX 58

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 configuração e a conexão, selecionar a opção Assistentes, botão “Validação de Conexão” e informar os dados.


LOGIX 59


LOGIX 60


LOGIX 61

7.3. Configurando Variáveis de Ambiente

Na conexão com o banco de dados é necessário criar/configurar algumas variáveis de ambiente e outras variáveis de ambiente também são necessárias para Logix. 7.3.1. Criando as variáveis de ambiente no Windows

1. Vá em, Iniciar > Configurações > Painel de Controle > Sistema

2. Selecione a pasta Avançado e botão Variáveis de Ambiente.


LOGIX 62


LOGIX 63

7.3.2. Criando as variáveis de ambiente no Linux As varáveis de ambiente no sistema operacional Linux são definidas no arquivo “PROFILE”. O arquivo PROFILE do root está localizado no diretório /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 comunicação com o banco de dados.

7.3.3. Variáveis de Ambiente As variáveis de ambiente necessárias podem ser definidas de forma padrão conforme cada ambiente ou ser definidas no Shell script que inicia os serviços do TotvsTec. No Linux “start_totvsappserver.sh” e no Windows “totvsserver.bat”.


LOGIX 64

As variáveis necessárias para o Logix são: DBMONEY DBDATE DBCENTURY CLASSPATH FGLPROFILE FGLDBPATH FGLGUI V4GL V4JS AMBIENTE CODCLIPAR LGXDOC LGXGR LGXBI SMTP_SERVER

A seguir são detalhadas as variáveis a serem definidas: Chave Descrição DBMONEY Define o ponto decimal a ser exibida nas telas e relatórios do Logix.

DBDATE DBMONEY=, Define o formato da data a ser exibida nas telas e relatórios do Logix.

DBCENTURY DBDATE=dmy4/ Define o século corrente para complementar quando é digitado somente os dois dígitos do ano.

CLASSPATH DBCENTURY=C Define o caminho das bibliotecas necessárias para os serviços do Java Envia, Java PDF, Botelo Bancário, NFe, etc.

FGLDBPATH

CLASSPATH=c:\totvs\logix\lib\activation.jar:c:\totvs\logix\lib..…. Identifica o diretório onde está o arquivo SCHEMA (logix.sch) com o layout/definições das tabelas do Logix utilizado na compilação de programas.

FGLPROFILE FGLDBPATH=c:\totvs\logix\apo Identifica o diretório onde está o arquivo de configuração dos labels das teclas utilizadas nos programas.

FGLGUI FGLPROFILE=c:\totvs\logix\logixprofile.pro Identifica para os programas que a execução é em ambiente gráfico.

V4GL/V4JS FGLGUI=1 Identifica para o Logix o uso de múltiplos compiladores. V4GL=4j3

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

AMBIENTE VIS_4JS=9 Identifica o sistema operacional que está sendo executado o servidor de aplicação para o Logix.


LOGIX 65

AMBIENTE=WINDOWS ou

LGXDOC AMBIENTE=LINUX Identifica o diretório onde está instalado o Help/Manual online do Logix. Verifique o documento “TotvsTec Melhores Práticas”.

LGXGR LGXDOC=http://localhost:8080/lgxdoc Identifica o diretório onde está instalado o Gerenciador de Relatórios. Verifique o documento “TotvsTec Melhores Práticas”.

LGXBI LGXGR=http://localhost:8080 Identifica o diretório onde está instalado o Logix BI.

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

SMTP_SERVER=smtp.provedor.com.br


LOGIX 66

7.4. Configurando TOTVSAppServer A instalação prepara o TOTVSAppServer com as configurações mínimas para a sua correta execução. Porém, pode-se configurá-lo por meio da manutenção do arquivo de configurações 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 é responsável pela configuração do TOTVSAppServer. A seguir são detalhadas todas as configurações que se encontram no arquivo totvsappserver.INI. As configurações para TOTVSAppServer são mantidas em diferentes seções, conforme a estrutura do arquivo de configurações a seguir.

Seções

Environment (Logix)

A seção “Environment” nomeada aqui como Logix contém as informações dos diretórios de execução do TOTVSAppServer, informações do idioma, interface, diretórios, repositório e informações para acesso ao TOTVSDbaccess. Estas informações são identificadas para cada conexão, ou seja, cada TOTVSSmartClient que se conectar ao Servidor deve informar qual a seção que será utilizada. Assim, os diretórios para trabalho, o idioma, a interface e o repositório podem ser obtidos a partir das informações da seção definida. Uma seção padrão, chamada Logix, é criada na instalação e utilizada sempre que o TOTVSSmartClient se conectar sem informar uma seção por meio de parâmetros de linha de comando. Chave Descrição SourcePath Identifica o diretório onde os repositórios de APOs são mantidos na

máquina em que o TOTVSAppServer está instalado. RootPath Identifica o diretório raiz do TOTVS Tec, a partir do qual todos os

diretórios utilizados pelo TOTVS Tec serão criados. StartPath Identifica o diretório onde o arquivo de “error” do TOTVS Tec se

encontra. Alguns programas geram informações do conteúdo de suas variáveis neste arquivo. Este diretório é criado a partir do diretório raiz, definido na chave anterior.

RpoLanguage Identifica o idioma que será utilizado. Pode ser Portuguese, English ou Spanish. Esta informação também é utilizada pelo servidor para definição do repositório a ser acessado.

RpoVersion Identifica a versão do Logix. RpoPrefix Identifica o prefixo do RPO Logix.


LOGIX 67

Exemplo: RpoPrefix=lgx

FGLSQLReplay Indica se haverá gravação do Log de Warnings, referente as informações de acesso ao banco de dados. O arquivo de log TOTVSconsole.log é gravado no diretório “\totvs\logix\bin\appserver”. Valores possíveis: 1 - Grava o log; 0 - Não grava o log.

SCROLLCURSORSIZE Define a quantidade máxima de registros do buffer de leitura que podem ser recuperados do banco de dados para um cursor definido no programa como Scroll. Quantidade padrão igual a 1000

DBAlias Identifica o Data Source Name da configuração do ODBC Informix Driver Setup ou nome do serviço configurado no Client do Oracle, ou ainda, o nome utilizado no ODBC como fonte de dados para o SQLSERVER; define a conexão com o banco de dados. Exemplo: DBALIAS=Logix10 Obs: Utilizado quando existe mais de uma seção Environment Logix e cada uma irá acessar uma base de dados diferente, base de teste e base de produção.

DBDataBase Identifica o nome do DataBase que será utilizado. Valores aceitos: ORACLE, INFORMIX, MSSQL Exemplo: DBDataBase = INFORMIX.

OUTPUTDIR Determina o caminho padrão para gravação de arquivos (relatórios) quando o caminho no programa não está definido. Quando essa chave não está definida, e no programa também não está definido o caminho, os arquivos (relatórios) são gravados dentro da pasta do Server TOTVS Tec. (/TOTVS/Bin/appserver/) Exemplo: OutputDir=c:\publico\lst\

InactiveTimeout Determina o tempo de espera para a interrupção da conexão entre o client com o servidor, esse tempo é o período que o client fica sem nenhuma atividade. Esta configuração pode ser realizada na seção [General]. Porém, será válida para todos os ambientes configurados no servidor. A especificação da chave InactiveTimeOut, na seção [Environment], prevalecerá sobre a configurada na seção [General]. Esse tempo é determinado em segundos. Exemplo: InactiveTimeout=600 equivalente a 10 minutos.

TOTVSDbAccess

A seção TOTVSDbaccess contém as informações utilizadas para o acesso à base de dados. As informações desta seção são utilizadas para todas as conexões, a não ser que estejam definidas na seção Logix das conexões, como detalhado a seguir. Chave Descrição DataBase Identifica o nome do DataBase que deve ser utilizado.


LOGIX 68

Valores aceitos: ORACLE, INFORMIX, MSSQL. Exemplo: DataBase = INFORMIX

DRIVER Define o driver de comunicação com o banco de dados utilizado. DRIVER=TOTVSDbsrv.dll

Alias Identifica o Data Source Name da configuração do ODBC Informix Driver Setup. Utilizado no TOTVSDbaccess para acesso à base de dados. ALIAS=Logix10 Opcionalmente, pode-se colocar a chave ALIAS na seção Logix, acrescentando “DB” no início da chave: Exemplo: [Logix] DBALIAS=Logix10

DRIVERS

A seção Drivers define quais os protocolos de conexão poderão ser utilizados para os terminais conectarem ao TOTVSAppServer. Chave Descrição Active Identifica os nomes das seções de configuração de protocolos

ativos. Mais de um protocolo pode ser informado separando por vírgula (,), desse modo permite que existam conexões de terminais ao servidor efetuadas por meio de diferentes protocolos.

Protocolos de Conexão (definidos na seção Drivers)

TCP

O TOTVSAppServer utiliza o protocolo TCP-IP para realizar a conexão com os terminais. A configuração do protocolo utilizado é efetuada por meio de seções com as chaves, definido na seção Drivers, informações como a porta de conexão, o serviço e o tipo da conexão. As conexões ativas, ou seja, que podem ser utilizadas pelos terminais para conectar ao Servidor são aquelas que estão definidas na seção Drivers na chave Active, descrita anteriormente. Podem ser criadas diversas seções para as conexões ativas. Chave Descrição Port Identifica a porta que será utilizada para as comunicações via TCP-IP.

Obs: O TOTVSAppServer utiliza TCP Stack (A mesma porta para todos os usuários).

ServerNetwork

Esta seção é utilizada no caso do uso de Balanceamento de Carga. Devem ser informados na chave a seguir quais são os servidores disponíveis na rede. Chave Descrição MasterConnection Determina se o servidor MASTER irá aceitar conexões.

0 = desabilita (recomendado)


LOGIX 69

1 = habilita Servers Especificar os nomes das seções que contêm as informações dos

servidores, separados por vírgula e na seqüência de busca desejada. Dentro de cada nova seção de servidor deve ser informado o nome, o tipo de conexão (TCP), a porta ou serviço e o número de conexões permitidas. Exemplo: [ServerNetwork] Servers=SERVER1,SERVER2 Masterconnection=0 (Default ligado); Informa que o master não irá aceitar conexões [SERVER1] TYPE=TCPIP Server=Servidor1 Port=4321 Connections=60 [SERVER2] TYPE=TCPIP Server=Servidor2 Port=4322 Connections=40

Service

Esta seção é utilizada para informar o nome interno e externo do Serviço do TOTVSAppServer Windows (ver item 5.6). Esta opção é útil quando for necessário utilizar mais de um TOTVSAppServer rodando como serviço Windows na mesma máquina, pois permite ao usuário informar nomes diferentes. Chave Descrição Name Nome interno do Serviço. Displayname Nome a ser exibido na janela de serviços do Windows.

HTTP

Esta seção permite ao TOTVS Application Server atuar como servidor HTTP (protocolo internet), ou seja, pode fornecer paginas em Html para um Browser. Chave Descrição Enable Enable=1 (1=habilitado 0=desabilitado) Port Identifica a porta que será utilizada para a conexão HTTP.

Port=8090 Path Define o caminho do diretório onde está localizado o arquivo de

configuração para execução via WEB, TOTVSSMARTCLIENT.HTM E TOTVSSMARTCLIENTAX.CAB. path=c:\totvs\bin\smartclient\

LicenseServer

A seção LicenseServer contém as informações sobre o Servidor de Licenças.


LOGIX 70

Chave Descrição Enable Indica se o servidor TOTVS Tec será um servidor de licenças.

Enable=1 (1=habilitado 0=desabilitado) Port Identifica a porta que será utilizada para as comunicação entre o

servidor de Licenças e os servidores TOTVS Tec. Port=4310

ShowStatus Esta chave permite o controle de requisições e liberações de licença e semáforos através de mensagens na tela de console. ShowStatus=1 (1=habilitado 0=desabilitado)

Para proceder com a configuração do servidor de licença do Logix verifique no documento “Procedimento_instalacao_controle_licenca.pdf” disponível na página de suporte on-line da Tecnologia TOTVS Tec. LicenseClient A seção LicenseClient define as informações que serão utilizadas para o servidor TOTVS Tec se conectar a um Servidor de Licenças. Chave Descrição Server É o nome ou número do IP do computador onde está o Servidor de

Licenças. Server=10.10.10.10

Port Identifica a porta que será utilizada para a comunicação entre o servidor TOTVS Tec e o Servidor de Licenças. Portanto, deve ser o mesmo valor da chave “Port” na seção “LicenseServer” do servidor de Licenças. Port=4310

General

A seção General contém as informações globais sobre o Servidor TOTVSAppServer, aquelas que são comuns para todos os ambientes. Chave Descrição Console Default = 1 BuildKillUsers Na compilação, se esta chave estiver ativa e houver algum usuário

conectado, o usuário será desconecto. 0 = desabilita (padrão) 1 = habilita

LogMessages Define a gravação de um log, no diretório de instalação do TOTVS Application Server (totvsconsole.log), com as informações necessárias para diagnosticar erros e calcular o tempo de execução de uma determinada rotina no TOTVS Application Server. Todas as mensagens enviadas e recebidas entre o TOTVS Application Server e o TOTVS Smart Client, são logadas por esta chave. Com isso, é possível verificar o tempo de execução das mensagens enviadas e o tempo que o TOTVS Application Server levou para processar uma determinada rotina.


LOGIX 71

0 = desabilita (padrão) 1 = habilita

ConsoleLog Ativa a gravação do arquivo de LOG das mensagens da console. Default = 1 (grava)

consolemaxsize Define o tamanho máximo do arquivo de LOG. Default = 5242880 (5MB)

InactiveTimeout Determina o tempo de espera para a interrupção da conexão entre o client com o servidor, esse tempo é o período que o client fica sem nenhuma atividade. Esta configuração pode ser realizada na seção [Environment]. Porém, irá prevalecer sobre a configurada na seção [General]. Esse tempo é determinado em segundos. Exemplo: InactiveTimeout=600 equivalente a 10 minutos.

ConsoleFile Define a pasta e nome do arquivo onde serão gravados os logs das mensagens da console. Exemplo: ConsoleFile=c:\temp\meu_arquivo_log.log

MonitorKey Define a comunicação com o TotvsMonitor. Sempre deverá ter o valor “LOGIX”. Exemplo: MonitorKey=LOGIX A mesma chave deverá estar definida no totvsmonitor.ini na seção [Preferences].

DebugThreadUsedMemory

Esta chave habilita uma coluna no TotvsMonitor, onde será informada a quantidade de memória utilizada para cada processo apresentado no monitoramento. 0 = desabilita (padrão) 1 = habilita Exemplo: DebugThreadUsedMemory=1

CanAcceptDebugger Define se a instância atual do TOTVS Application Server receberá conexões do TOTVS Development Studio. Esta chave é recomendada para ser configurada nos serviços de produção. Pois, desta forma, o serviço não atenderá as conexões do TOTVS Development Studio (IDE), mesmo que indevidamente seja apontado um IDE para o serviço de produção. 0 = não permite conexões do IDE 1 = permite conexões do IDE (padrão)

LogixTelnet

A seção LogixTelnet contém as informações necessárias para a execução de programas modo caracter via Telnet.

Essa seção é obrigatória, mesmo que não seja feito acesso via telnet ao sistema.


LOGIX 72

Enable Define se o a execução via telnet está habilitada. Enable=1 (1=habilitado 0=desabilitado)

Port Identifica a porta que será utilizada para as comunicações via TCPIP. Port Default=5520

Environment Define a seção Logix que será utilizada na execução dos programas. Main Define o programa que será executado.

Main=men3000.4gl

Exemplo de Configuração

A seguir, são apresentados exemplos de configurações do TOTVSAppServer, onde pode ser visualizado um exemplo com apenas uma seção Environments Logix e um outro exemplo com duas seções Environments Logix diferentes: No exemplo onde temos duas seções Environmenst Logix, Logix e Logixtst

, não foi definida a seção TOTVSDbaccess, pois essa configuração está dentro da seção Environmenst Logix, outra diferença entre eles é que utilizam Repositórios e base de dados diferentes.

Exemplos do arquivo de configuração do TOTVSAPPSERVER.INI

Para um servidor com uma seção 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 73

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 serviço no Windows Name=totvsappserver DisplayName=Totvs Server Para um servidor de controle de Licença. [Drivers] Active=TCP [TCP] TYPE=TCPIP Port=4311 [LicenseServer] Enable=1 Port=4310 ShowStatus=0 [SERVICE] --- Como serviço 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 seções environment Logix. [Logixprd] SourcePath=c:\totvs\logix\apo RootPath=c:\totvs\logix StartPath=\totvs_data


LOGIX 74

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 serviço no Windows Name=totvsappserver DisplayName=Totvs Server


LOGIX 75

Para um servidor Master com Load Balance com 3 servidores Slaves e duas seção 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 76

[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 serviço no Windows Name=totvsappserver DisplayName=Totvs Server Master Para um servidor Slave com duas seções 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 77

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 serviço no Windows Name=totvsappserver1 DisplayName=Totvs Server Slave1


LOGIX 78

7.5. Configurando TOTVSSmartClient A instalação prepara o TOTVSSmartClient com as configurações mínimas para a sua correta execução. Porém, pode-se configurá-lo por meio da manutenção do arquivo de configurações TOTVSSMARTCLIENT.INI, utilizando um editor de texto notepad, edit, etc. As configurações do SmartClient podem ser customizadas, de modo que pode ser mantida diferente conexão em um mesmo servidor. Por exemplo: · Uma rede local com conexões via TCP-IP e algumas outras conexões remotas, via

modem ou Internet, utilizando TCP-IP; · Diferentes redes conectadas via linha privada. Cada uma destas redes mantém um

TOTVSAppServer para o processamento distribuído. As configurações são mantidas em diferentes seções, conforme a estrutura do arquivo de configurações, encontrado no diretório de execução do SmartClient.

TOTVSSmartClient.INI

O arquivo TOTVSSmartClient.INI é responsável pela configuração do SmartClient. A seguir são detalhadas todas as configurações que se encontram no arquivo TOTVSSmartClient.INI.

Seções

Identifica informações gerais de configuração do SmartClient. Config

Chave Descrição LastMainProg Contém a lista dos últimos programas iniciais a serem executados

no TotvsSmartClient. Por exemplo, pode-se iniciar MEN3000.4gl.

ENVSERVER Contém a lista de ambientes a serem executados no TotvsSmartClient.

A seção Drivers define quais os protocolos podem ser utilizados para que o Terminal conecte-se ao TOTVSAppServer. É igual a seção de mesmo nome no arquivo de configurações do TOTVSAppServer.INI, a diferença é que as seções aqui informadas (que devem ser separadas por vírgulas) são utilizadas em

Drivers

tentativas

de conexão, de acordo com a ordem em que foram informadas.

Chave Descrição Active Identifica os nomes das seções de configuração de protocolos

ativos. Mais de um protocolo pode ser informado separando por vírgula (,).


LOGIX 79

Protocolos de Conexão (definidos na seção Drivers)

As seções de configuração de protocolos são definidas da mesma forma que no arquivo de configurações do TOTVSAppServer. Não necessitam ter o mesmo nome que o definido no TOTVSAppServer, porém as informações devem ser as mesmas e, somente os protocolos definidos na chave Active da seção Drivers do arquivo de configuração do TOTVSAppServer, podem ser utilizados quando estiver configurando o TOTVSSmartClient. Chave Descrição Server Identifica o servidor de aplicação do TOTVSAppServer.

Para a execução local (TOTVSAppServer e TOTVSSmartClient executados na mesma máquina) pode-se informar: Server = LocalHost. Para execução remota, o nome do servidor ou o endereço IP deve ser informado. Para o TOTVSSmartClient o Server deve ser o mesmo configurado no TOTVSAppServer onde o terminal está conectado.

Port Identifica a porta que será utilizada para as comunicações via TCP-IP. Para execução 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;

Exemplo de Configuração

A seguir é apresentado um exemplo do arquivo de configurações do TOTVSSmartClient. [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 número IP do Computador] Port=4320

TOTVSSmartClient.htm

O arquivo TOTVSSmartClient.HTM é responsável pela configuração do TOTVSSmartClient para execução via WEB. A seguir os detalhes das configurações necessárias do arquivo TOTVSSmartClient.HTM.

LOGIX 80

A cada atualização do TOTVSSmartclient ActiveX, que ocorre a cada troca de build do TOTVS Tec, as chaves do .htm 'classid' e 'codebase'

sofrem alterações de versão e portanto é necessário utilizar .htm com os novos valores.

Chave Descrição classid classid="clsid:035a66df-db41-4020-89d5-869049748e5c" codebase codebase="totvssmartclientax.cab#version=8,8,307,0" Server Identifica o servidor de aplicação do TOTVSAppServer.

Endereço TCP/IP ou Nome TOTVSAppServer. <param name="Server" value="10.10.10.10">

Port Identifica a porta que será utilizada para as comunicações. Porta TCP/IP em uso no TOTVSAppServer. <param name="TCPPort" value="4320">

StartProgram Define o programa inicial a ser executado. <param name="StartProgram" value="men1002">

Exemplo: <html> <head> <meta http-equiv="Content-Language" content="en-us"> <meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> <title>TOTVS Tec - Logix©</title> <script> window.onhelp = new Function('return false;'); parent.window.moveTo(0,0); parent.window.resizeTo(screen.width-(screen.width-screen.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">  <param name="TCPPort" value="4320">  <param name="Environment" value="logix102">  <param name="Language" value="1">  <param name="StartProgram" value="men1002">  <param name="ReadOnly" value="OFF">

LOGIX 81

<param name="SecureConnection" value="0">  </object> </body> </html>


LOGIX 82

7.6. Configurando TOTVSAppServer como serviço do Windows Para instalar o TOTVSAppServer como serviço no Windows deve ser executado o seguinte comando a partir do diretório do executável do TOTVSAppServer. c:\totvs\logix\bin\appserver\totvsappserver.exe –install

É necessário que o arquivo TOTVSAPPSERVER.INI exista. Para remover o TOTVSAppServer dos serviços do Windows deve ser executado o seguinte comando a partir do diretório do executável do TOTVSAppServer. c:\totvs\logix\bin\appserver\totvsappserver.exe –remove


LOGIX 83

As seguintes variáveis de ambiente de sistema deverão ser definidas conforme instruções constantes no item 5.3 - Configurando Variáveis de Ambiente.

FGLPROFILE V4GL V4JS AMBIENTE LGXDOC

Estas variáveis e seus valores são encontrados no arquivo “totvsserver.bat” que está em: “c:\totvs\logix\bin\appserver\”.


LOGIX 84

7.7. Configurando TOTVSMonitor A instalação prepara o TOTVSMonitor com as configurações mínimas para a sua correta execução. Porém, para o seu uso, deve ser incluída uma chave nos arquivos de configuração 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

Seção

General

Chave Descrição MonitorKey Identifica a chave de liberação para o monitoramento.

Valor padrão: MonitorKey=LOGIX

TOTVSMONITOR.INI

O arquivo TOTVSMONITOR.INI localiza-se na pasta do Client; Windows=c:\totvs\logix\bin\smartclient

Seção

Preferences

Chave Descrição MonitorKey Identifica a chave de liberação para o monitoramento.

Valor padrão: MonitorKey=LOGIX


LOGIX 85

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 86

7.9. Configurando atalhos

Criar os seguintes atalhos na área de trabalho:

Este atalho é utilizado para iniciar o servidor de aplicação do TOTVSAppServer, quando não estiver configurado como um serviço do Windows.

TOTVSAppServer

O servidor de aplicação TOTVSAppServer sempre deverá estar ativo antes de efetuar qualquer compilação e execução de programas no Logix, pelo IDE ou TOTVSSmartClient.


LOGIX 87

Atalho para executar os programas do Logix no ambiente gráfico. TOTVSSmartClient

Efetua a comunicação entre o Client (terminal) e o Server, a interface do usuário.


LOGIX 88

7.10. Configurando Parâmetros da Linha de Comando do TOTVSSmartClient Ao ser iniciado, o TOTVSSmartClient exibe a tela de parâmetros iniciais, para identificação do Ambiente e da Conexão inicial. Porém, tais parametrizações podem ser informadas por meio da linha de comando do ícone de acesso ao TOTVSSmartClient.

c:\totvs\logix\bin\smartclient\totvssmartclient.exe

As opções de linha de comando do TOTVSSmartClient são:

-Q (Quiet): Indica que o TOTVSSmartClient não deve mostrar o Splash (imagem de apresentação) e a tela de identificação de parâmetros iniciais necessita ser acompanhada da cláusula –P; -P (Main Program): Identifica o programa inicial; -R (CfgSection): Nome da seção de configuração. Por default, é “Config”; -E (Environment Logix): Nome da seção de environment Logix no .INI do TOTVSAppServer que será utilizada para definições gerais;


LOGIX 89

-C (Connection): Nome da seção de conexão que será utilizada para a conexão ao TOTVSAppServer; -A (Parâmetros para o Programa Inicial): Identifica um parâmetro que será passado para o programa inicial; -M (AllowMultiSession): Permite múltiplas instâncias (Cópias) do TOTVSSmartClient na mesma máquina (Default: não 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 configurações do environment LOGIX definido do .INI do TOTVSAppServer. Exemplo:

Para Logix 05.10: c:\totvs\logix\bin\smartclient\totvssmartclient.exe -M -Q -P=men3000 -C=tcp -E=logix Para Logix 10: c:\totvs\logix\bin\smartclient\totvssmartclient.exe -M -Q -P=men1002 -C=tcp -E=logix


LOGIX 90

8. Atualização TOTVS Tec e RPO 8.1. TOTVS Tec A atualização 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 atualização)

TOTVSAppServer (c:\totvs\logix\bin\appserver) Windows:

TOTVSSmartClient (c:\totvs\logix\bin\smartclient) Help Online (c:\totvs\logix\doc)

TOTVSAppServer (/totvs/logix/bin/appserver) Linux:

TOTVSSmartClient (/totvs/logix/bin/smartclient) 8.2. Atualização Automática TOTVSSMARTCLIENT Para agilizar a atualização do TOTVSSmartClient nas estações, é possível configurar uma máquina com a versão mais recente e, a partir dela, efetuar a atualização automática nas estações. Para habilitar este procedimento é necessário incluir a seção 'UPDATE', no arquivo TOTVSAPPSERVER.INI, com as seguintes chaves:

Seção

Update

Chave Descrição Enable Define se a atualização automática está habilitada.

Enable=1 (1=habilitado 0=desabilitado) PathWindows Identifica o caminho onde está o pacote de atualização do

TOTVSSMARTCLIENT para ambiente Windows PathWindows=c:\totvs\logix\bin\smartclient_win_upd (server Windows) PathWindows=/totvs/logix/bin/smartclient_win_upd (server Linux)

PathLinux Identifica o caminho onde está o pacote de atualização 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 estação carregar o TOTVSSMARTCLIENT, o sistema irá verificar se o Build do Client é compatível com o servidor.


LOGIX 91

Caso os Builds não sejam compatíveis, ao iniciar qualquer programa do Logix, e o recurso de atualização automática estiver devidamente configurado e habilitado, serão verificados automaticamente os arquivos da pasta especificada no servidor para atualização e os arquivos da pasta do smartclient em execução na estação. Caso um arquivo existente no servidor não seja encontrado na estação, ele é copiado para esta. Caso os arquivos existam, porém apresentando alguma diferença (tamanho, data e/ou horário), o arquivo também é copiado do servidor para a estação. Este processo é executado automaticamente exibindo na tela do Client uma janela informando sobre o progresso da verificação/atualização. Para que a atualização automática seja realizada corretamente é importante observar: Os arquivos constantes nas pastas de atualização no smartclient deverão estar

descompactados; O usuário deve ter direito de gravação no diretório do smartclient da estação onde

este aplicativo está sendo executado/atualizado; Quando utilizamos o smartclient em ambiente Linux, os arquivos das pastas de

atualização automática devem conter apenas letras minúsculas, mesmo que se destinem à atualização 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 específica para esta finalidade e não utilizar para execução do TOTVSSMARTCLIENT na estação servidora. Para que, nesta pasta, existam apenas os arquivos da pasta SMARTCLIENT que devam ser enviados à todas as estações remotas. 8.3. RPO – Repositório de Programas Em função de atualizações legais, melhorias ou correções são disponibilizados arquivos de atualização. PAK = Pacote de atualização, utilizado para um grupo de pragramas. UPD = Atualização completa do RPO, atualizações referente a um período. PTM = Atualização de um pequeno numero de programas.

Copiar o arquivo de atualização 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 são configurados no arquivo INI do TOTVSAppServer

c:\totvs\logix\apo\tst\


LOGIX 92

c:\totvs\logix\apo\prd\ Apos efetuar a copia do arquivo de atualização é necessário aplicar no RPO por meio TOTVSDevStudio. A aplicação do arquivo de atualização é realizada por meio do TOTVSDevStudio e pode ser processada das seguintes formas: Executando o TOTVSDevStudio a partir do próprio servidor Executando o TOTVSDevStudio a partir de um Client (estação)

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 aplicação de arquivos de atualização, pois, evita a paralisação do Servidor de produção para esta operação. O processo de atualização exige que se tenha acesso exclusivo ao sistema (Não deve existir nenhum usuário utilizando-o). 8.4. Passos para atualização do RPO Para proceder a atualização do repositório (RPO) consulte a documentação “Procedimento_para_aplicacao_de_atualizacoes.pdf” disponível na página de suporte on-line da Tecnologia TOTVS Tec. 9. Topologia de Utilização de Rede do TOTVS Tec Devido à sua divisão em camadas, a tecnologia TOTVS Tec permite montar o ambiente de execução com diferentes topologias, priorizando a execução, o tráfego de rede ou os recursos individuais das máquinas existentes, o que torna o processamento distribuído. Essa é uma das grandes vantagens da tecnologia TOTVS Tec.


LOGIX 93


LOGIX 94

9.1. Características e possibilidades de topologias de rede

• Pode-se manter um ou mais servidores de aplicação do Logix (TOTVSAppServer);

• Máquinas melhores ou com mais recursos podem ter um TOTVSAppServer executando localmente. Isto prioriza o processamento local, mas aumenta o tráfego de rede entre o gerenciador de banco de dados e o TOTVSAppServer

• Do mesmo modo, pode-se executar servidores remotamente, priorizando o processamento;

;

• As conexões devem ser efetuadas por meio do protocolo TCP-IP; • Pode-se criar conexões 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

• A Internet é utilizada apenas como o meio de comunicação, ou seja, a conexão TCPIP entre o

pode ser executado no provedor ou na empresa utilizando uma LP para a conexão ao provedor de acesso;

TOTVSSmartClient e o TOTVSAppServer

. Além da segurança fornecida pelo sistema Advanced, a segurança deve ser oferecida pela conexão. Por isso, é aconselhável que o servidor Web não seja o mesmo servidor da base de dados;

• Pode-se manter uma página para o download do TOTVSSmartClient

, de modo que os usuários remotos possam efetuar o download para conectar-se e utilizar o sistema.

A definição da melhor topologia para execução é um passo importante da implementação da tecnologia TOTVS Tec, pois influencia totalmente a performance. O maior tráfego de rede está localizado entre o TOTVSAppServer e o Banco de Dados, já que o tráfego entre o TOTVSAppServer e o TOTVSSmartClient contém somente informações para montagem de telas e controle de teclado e mouse. Desta forma, dependendo do tipo e da velocidade da conexão, pode se tornar inviável manter um TOTVSAppServer em uma cidade conectado ao banco de dados em outra. Por outro lado, caso existam muitas conexões nesta outra cidade, ou caso estas conexões executem processamentos pesados, priorizar o processamento disponibilizando um TOTVSAppServer para ser executado localmente nesta cidade pode ser uma boa solução.


LOGIX 95

Quadro de Revisões Revisão Descrição Alteração Data

01 Inicial. 30/03/07 02 · Incluída explicação das seguintes chaves de configuração: OUTPUTDIR,

LGXGR, DBDATABASE, DBALIAS, INACTIVETIMEOUT; · Incluída explicação da configuração do TOTVSMONITOR; · Incluída explicação da configuração para a atualização automática do

TOTVSSMARTCLIENT; · Incluída observação que deve ser iniciado o serviço TOTVSDBACCESS

utilizando um usuário com permissão de conexão no banco.

28/08/08

03 Incluídas as opções “Linux RedHat ES 5” e “Linux Ubuntu 7.04” na planilha “Sistema Operacional” - capítulo “Instalação TOTVS Tec”.

10/09/08

04 · Incluídos os capítulo 3 (Controle de Licenças) e 6 (Instalação Servidor de Licenças);

· Incluídas, no cap. 7 (Configurando o TOTVS Tec), as seguintes seções: HTTP, LicenseServer, LicenseClient, Exemplos do arquivo de configuração do TOTVSAPPSERVER.INI e TOTVSSmartClient.htm.

03/10/08

05 Revisado documento e corrigido os exemplos 08/09/09 06 Atualizado tabela de sistemas operacionais homologados e atualizado texto dos

itens 6.1 e 6.2 15/10/09

07 Corrigido local do TotvsDBMonitor 23/10/09 08 Alterado descritivo do uso de conexões TELNET em COMPONENTES

TOTVS TEC 05/11/09

09 - Eliminado a chave RPODB do environment; - Incluído informação da necessidade do patch Oracle 10.2.04 na lista de SGBD homologados. - Incluído no item 8.2 a informação e detalhamento para ambiente Linux

01/12/09

10 Alterado a nomenclatura das pastas da instalação do TOTVSTEC 16/12/09 11 Eliminado variáveis de ambiente LOGNAME, USERNAME e USERLOGIX 17/02/10 12 Descrito a diretiva CONSOLEFILE, MONITORKEY, CONSOLEMAXSIZE 04/03/10 13 Atualizada lista de sistemas operacionais e banco de dados homologados 26/03/10 14 Alterado capítulo 6, a forma de solicitação de liberação de senha de acesso 12/04/10 15 Descrito a diretiva DEBUGTHREADUSEDMEMORY, LOGMESSAGES,

CANACCEPTDEBUGGER, INACTIVETIMEOUT na seção Environment 14/04/10

16 Incluído “Fique Atento” no capitulo 7.4 seção “LICENSE SERVER” 14/05/10 17 Alterado item 4, homologado MS-SQL Server 2008 e banco Oracle 11g

Release 1 e cliente 11g 02/07/10

18 Revisão dos itens 6, 7.1, 7.2 e 7.3 27/08/10

manual instalacao totvs tec

Documents