Manual Instalacao TOTVS Tec
-
Upload
joao-felipe-soares-barreto -
Category
Documents
-
view
575 -
download
43
Transcript of 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
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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:
Guia de Instalação TOTVS Tec
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.
Diretório de Instalação
· 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
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
LOGIX 12
• Pressione a tecla “ENTER” para prosseguir.
Diretório de Instalação
· 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
Conclusão da Instalação
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.
Guia de Instalação 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.
Guia de Instalação TOTVS Tec
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.
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.
Guia de Instalação 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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
LOGIX 17
Fazer o download dos arquivos 1 e 2 no mesmo diretório e executar o shell script “dinst”.
Guia de Instalação TOTVS Tec
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”.
Guia de Instalação TOTVS Tec
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)
Guia de Instalação TOTVS Tec
LOGIX 20
3. Selecione a pasta “Fonte de dados de sistema”
4. Selecione a opção Adicionar
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
LOGIX 24
Para validar o cadastro e a conexão, selecione a pasta Connection - botão Apply & Test Connection
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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:
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
LOGIX 32
2. Selecione a opção Local
3. Selecione a opção Nomeação de Serviço
Guia de Instalação TOTVS Tec
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:
Totvsdbaccess.exe –console
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
LOGIX 39
2. Fontes de Dados (ODBC)
3. Selecione a aba “Fonte de dados de sistema”.
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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....
Guia de Instalação TOTVS Tec
LOGIX 43
9. Para validar o cadastro e a conexão selecione o botão “Testar Fonte de dados...” e “OK”
Guia de Instalação TOTVS Tec
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:
Totvsdbaccess.exe –console
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
LOGIX 49
18. A configuração de conexão com o banco de dados está concluída.
Guia de Instalação TOTVS Tec
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 #
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
LOGIX 54
Se a configuração estiver correta, a tela “Conexão Ok!” será exibida.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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”.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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)
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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 (,).
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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"> <!-- Nome ou endereço TCP/IP ou URL do Totvs Server --> <param name="TCPPort" value="4320"> <!-- Porta TCP/IP em uso no Totvs Server --> <param name="Environment" value="logix102"> <!-- Ambiente de execução --> <param name="Language" value="1"> <!-- Idioma de execução 1=portugues 2=español 3=english --> <param name="StartProgram" value="men1002"> <!-- Programa inicial --> <param name="ReadOnly" value="OFF"> <!-- OFF = permite edicao dos parametros -->
Guia de Instalação TOTVS Tec
LOGIX 81
<param name="SecureConnection" value="0"> <!-- 0 (default) não utiliza conexao segura, 1= utiliza conexão segura, Protheus Server deve estar configurado também --> </object> </body> </html>
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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\”.
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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;
Guia de Instalação TOTVS Tec
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
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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\
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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.
Guia de Instalação TOTVS Tec
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