Páginas filhas
  • 01 - Instalação build HARPIA - LGX

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Instalação e configuração build 20.3.1.xx (Harpia) para produto Logix


Informações
iconfalse
Section
Column
width30%

Column
width70%


Índice
maxLevel2
minLevel2


Painel
borderColor#F5A9BC
bgColor#FBEFF2
borderWidth2
borderStyledashed
ATENÇÃO        O Build 64 Bits para LOGIX está disponível temporariamente apenas para clientes que estão em fase PILOTO de migração do build 32 x 64 bits.

                                      Assim que estiver disponível na Central de Downloads para todos os clientes Logix, será informado aqui o LINK para acesso.

                                      Framework Logix

Page Tree
root01 - Instalação build HARPIA - LGX

Objetivo 


Aqui nesta página estão registradas algumas orientações relacionadas a instalação e configuração do binário Harpia (AppServer, Smartclient, outros) para uso com o produto Logix, sendo:

Losango - ícones de formas grátis Mudanças em relação ao build 7.00.131227A (32 bits)

Losango - ícones de formas grátis Algumas novidades

Losango - ícones de formas grátis Ajustes de configurações


1. Introdução
Âncora
1.Introdução
1.Introdução



O binário TOTVS Application Server TOTVS Smartclient, disponível na arquitetura 64 bits para o Logix, é conhecido sob o nome HARPIA e o número de controle de revisão tem como prefixo 20.3.1.xx, sendo xx um número incremental a cada nova revisão liberada oficialmente no portal Totvs.

A disponibilização do build na arquitetura 64 bits traz vários benefícios, sendo que os principais envolvem maior velocidade e robustez, devido a maior capacidade de processamento e uso de memória RAM,

Para saber mais sobre o modelo operacional do Build Appserver clique AQUI.


2. O que foi descontinuado?



Veja o que não poderá mais ser utilizado a partir do TOTVS Application Server 20.3.1.x e quais serão as novas alternativas de ferramentas:


(informação) OBJETIVO (erro) DESCONTINUADO (erro) (estrela) NOVA FERRAMENTA (estrela) 
Balanceamento de conexõesSmartClient X AppServer 

LOAD BALANCE (AppServer Master X AppServer Slaves)TOTVS Broker
IDE de desenvolvimento

TOTVS Developer Studio Versão 11.3TOTVS Developer Studio para VSCode


Monitor de Conexões no TOTVS AppServer


TOTVS Monitor (totvsmonitor.exe)

TOTVS Monitor Electron
ou
TDS-VSCode (Monitor)


3. O que há de novo?



   O nome dos binários mudou para o produto Logix (grande sorriso).
          Agora o prefixo TOTVS não existe mais e TOTVSAppServer passou para AppServer (a partir do build 20.3.1.x) e TOTVSSmartclient passou para Smartclient (a partir do build 17.3.0.xx).


   A partir do build Harpia existe uma nova forma de controle do repositório de objetos (RPO), com o conceito de RPOs segregados, onde o ambiente passará a acessar dois RPOs, sendo:

  • um RPO padrão (default), que será distribuído pela TOTVS, como já ocorre com o build 32 bits e,
  • outro RPO customizado (custom), onde constarão todos os fontes e recursos customizados do ambiente de clientes.

Sendo assim, as funcionalidades customizadas de usuário deixarão de fazer parte do RPO padrão, como ocorre até então no build 32 bits e passarão a fazer parte exclusivamente de um novo RPO denominado CustomPara mais detalhes acesse Application Server - RPOs Segregados.


HTML
O 🎯 <strong>OBJETIVO</strong> é <strong><mark style="background-color:#1bced3;">melhorar a organização dos RPOs utilizados pelo ambiente</mark> </strong>, <br>
<br><p style="padding-left: 42px;">bem como <strong><mark style="background-color:#1bced3;">facilitar a atualização dos ambientes e futuros releases</mark> </strong>.</p>




  A partir do build 20.3.1.xx é possível realizar compilações e execuções por linha de comando, utilizando o próprio binário do AppServer.  Quer saber mais desta novidade?

Expandir
titleClique AQUI para visualizar sobre compilação via linha de comando
Painel
borderColordarkgrey
borderStyledashed
Incluir Página
tec:AppServer Command Line - Compilação por linha de comando
tec:AppServer Command Line - Compilação por linha de comando
Expandir
titleClique AQUI para visualizar sobre execução via linha de comando
Painel
borderColordarkgrey
borderStyledashed


 A porta de comunicação entre TOTVS Application Server X TOTVS SmartClient passa a trafegar dados de forma segura. Para mais detalhes acesse Application Server - Porta Multiprotocolo.


 Visando facilitar este processo de migração do build 32 bits para 64 bits, a equipe de Framework liberou uma (estrela) NOVA FERRAMENTA (estrela) denominada Assistente de Configuração LOGIX, onde será possível realizar a Instalação, Migração e Atualização de build a partir da versão Harpia.

Expandir
titleClique AQUI para saber mais sobre o Assistente de Configuração Logix
Painel
borderColor#C0C0C0
titleBGColor#C0C0C0
borderStyledashed

Assistente de Configuração



O Assistente de Configuração tem como objetivo facilitar o processo de instalação e configuração do Logix. Utilizando esse recurso será possível realizar as operações a seguir:


Totvs custom tabs box
tabsFuncionamento, Parâmetros de Instalação, Assitente de Instalação, Assistente de Atualização, Atualizar APPSERVER.INI, Downloads
idspg1,pg2,pg3,pg4,pg5,pg6
Totvs custom tabs box items
defaultyes
referenciapg1

Ao acessar este assistente será apresentado uma tela onde será necessário informar os dados iniciais para a instalação.

Durante a instalação todos os arquivos utilizados pelo assistente serão extraídos em uma pasta chamada workspace, esta pasta será criada no mesmo diretório de execução do assistente de configuração.


Painel
borderColor#C0C0C0
borderStyledashed

ATENÇÃO!

Somente o campo Diretório é OBRIGATÓRIO.

Caso as demais informações não sejam informadas, o assistente irá criar os AppServers necessários onde a porta TCP será criada a partir da sequência 4500

Totvs custom tabs box items
defaultno
referenciapg2

Losango - ícones de formas grátis Diretório (Obrigatório):  Informe o diretório de instalação do Logix (rootpath)

Losango - ícones de formas grátis Quantidade:  Quantidade de appservers que serão configurados.

Losango - ícones de formas grátis Porta: Porta TCP inicial que será utilizada na configuração dos appservers.

Losango - ícones de formas grátis Excluir arquivos de configuração ao final do processamento?  Indica se os arquivos serão excluídos da pasta workspace ao final do processo de instalação.

Losango - ícones de formas grátis Serviços Auxiliares:  Permite definir outros serviços appserver que serão criados durante o processo de instalação.     (informação) Serviços disponíveis:   JOBEAIRESTDEBUG ou TELNET

Losango - ícones de formas grátis Environment:  Nome do ambiente que será a criado nos appservers.

Losango - ícones de formas grátis Banco de dados:  Permite informar os parâmetros de conexão com o banco de dados.   

 Quando informados, durante o processo de instalação irá configurar as conexões de banco de dados automaticamente usando a ferramenta disponível na pasta do AppServer chamada testdbconnection.  
       Para mais detalhes sobre a ferramenta testdbconnection acesse DBAccess Logix - Como Fazer

Losango - ícones de formas grátis License Server:  Permite informar os dados de conexão com o License Server. Essas informações ficam armazenadas no arquivo appserver.ini na sessão [LICENSECLIENT].


Totvs custom tabs box items
defaultno
referenciapg3

A ferramenta irá criar toda a estrutura necessária para o funcionamento do Logix.


Painel
borderColor#ffff8c
bgColor#ffff8c
borderStyledashed

ATENÇÃO! Esta opção deve ser utilizada em situações APENAS onde deseja realizar uma nova instalação do Logix.

Totvs custom tabs box items
defaultno
referenciapg4
Painel
borderColor#ffff8c
bgColor#ffff8c
borderStyledashed

ATENÇÃO! Assistente utilizado APENAS para realizar a atualização do binário 64 bits.


Losango - ícones de formas grátis Funcionamento


         Este assistente será utilizado sempre que for liberado uma nova versão do Build Logix 64 bits.
         Basta selecionar os Appservers que deseja atualizar e a ferramenta irá realizar o download dos pacotes necessários e realizar todo o processo de atualização.
         Durante a atualização todos os arquivos utilizados pelo assistente serão extraídos em uma pasta chamada workspace, esta pasta será criada no mesmo diretório de execução do assistente de configuração.

Losango - ícones de formas grátis  Parâmetros de Atualização


                Diretório 64Bits:  Informe o diretório (rootpath) do Logix 64 bits.

                Excluir arquivos de configuração ao final do processamento?  Indica se os arquivos serão excluídos da pasta workspace.


Painel
borderColor#C0C0C0
borderStyledashed
  Ao clicar em Localizar, será apresentada uma lista com os appservers localizados do diretório informado. Selecione os diretórios que você deseja atualizar e clique em Iniciar Processamento.
Totvs custom tabs box items
defaultno
referenciapg5

Assistente utilizado para realizar a atualização do arquivo appserver.ini

Losango - ícones de formas grátis Funcionamento


         Utilize este assistente quando for necessário realizar alterações no arquivo appserver.ini.
         Através desta opção será possível replicar uma determinada parametrização para todos os arquivos appserver.ini do seu ambiente.

Losango - ícones de formas grátis Informações do Ambiente


                 Diretório 64Bits: Informe o diretório (rootpath) do Logix 64 bits.
                 Sessão [GENERAL]: Corresponde aos parâmetros definidos na sessão [GENERAL] do arquivo appserver.ini
                 Sessão [LICENSECLIENT]: Altera as informações de conexão com o License Server.
                 Sessão [UPDATE]: Utilizado para configurar a atualização automática do smartclient.


Painel
borderColor#C0C0C0
borderStyledashed
Ao clicar em Localizar, será apresentada uma lista dos arquivos appserver.ini localizados do diretório informado. Selecione os arquivos que você deseja atualizar e clique em Iniciar Processamento.
Totvs custom tabs box items
defaultno
referenciapg6

Nesta opção são disponibilizados links para downloads de arquivos necessários para o funcionamento do Logix.




  A partir do build 20.3.1.xx está disponível a ferramenta Application BTMonitor (Business Transaction), que permite o monitoramento de transações de negócio, gerenciado pela ferramenta externa AppDynamics. Para mais informações acesse Application Server - BTMonitor



4. Pré-requisitos para instalação e uso


Download do Build na versão mais atual disponível para produto Logix.  Acesse a Central de Downloads Totvs e veja builds do AppServer e Smartclient.

Download e instalação de Drivers Client de conexão com o tipo de Banco de Dados utilizado no produto Logix (Oracle, Informix ou Microsoft SQLServer);

Download do RPO Oficial Logix disponível na Central de Downloads Totvs, avaliando sempre a versão de pacote compatível com o pacote Logix que será utilizado. Este RPO será o RPO Default;

Instalação e configuração de AppServer(s) e SmartClient;

Aplicação de patches, seja patch RPO Totvs ou patch RPO Custom.

Expandir
titleClique AQUI para visualizar as premissas para aplicação de um PATCH de atualização de RPO Padrão ou RPO Custom

A aplicação de um patch no RPO Totvs ou RPO Custom será reconhecida automaticamente no momento da aplicação do patch considerando as seguintes premissas:

Losango - ícones de formas grátis  Quando o patch tiver sido gerado com token de compilação, que é gerado pela TOTVS para atualização de RPO padrão, a atualização do RPO padrão será aplicada se o nome do RPO coincidir com o nome do RPO para o qual o patch foi também gerado.

Losango - ícones de formas grátis  Quando o patch tiver sido gerado sem token de compilação, a atualização do RPO Custom será aplicada somente se o nome do RPO Custom coincidir com o que estiver configurado no ambiente selecionado para aplicação do patch. O patch para atualização de RPO Custom é gerado no caso de customizações implementadas e compiladas sem TOKEN de compilação. O Token de compilação é utilizado apenas nos ambientes internos de desenvolvimento e pela expedição da TOTVS.

 Na seção [APP_MONITOR] informar chave ENABLE=0;

      Na seção [GENERAL] informar chave BUILDKILLUSER=1;

      Manter serviços REST e JOB do appserver inativos para não deixar o RPO em uso.


Compilação dos fontes/recursos customizados (específicos) para gerar o RPO Custom;

       Conforme mencionado no item 3. O que há de novo?, existe agora no Build AppServer o controle de RPOs segregados e com isso todos os fontes/recursos específicos que, anteriormente, estavam disponíveis no RPO único do produto Logix, agora ficarão disponíveis única e exclusivamente num RPO que denominamos como RPO CUSTOM e este fica separado do RPO padrão do produto ao qual denominamos RPO DEFAULT.

       (interrogação) Como posso obter ou gerar o RPO CUSTOM com os fontes e recursos customizados (específicos)?

Expandir
titleClique        Clique AQUI para saber

Se os fontes e recursos customizados são mantidos pela TOTVS, deverá ser realizada abertura de ticket solicitando envio dos fontes customizados para que possa realizar a compilação a partir do seu ambiente utilizando o build Harpia 64 bits, ou então, pode solicitar um patch a ser aplicado no RPO CUSTOM, que deverá ser gerado sem uso de token de compilação para que não ocorra problemas de funções duplicadas futuramente.

Para os fontes que estiverem sob sua custódia, poderá ser feita a compilação local, se atentando para algumas coisas como:

                 Losango - ícones de formas grátis Tenha em mãos a versão mais atual do arquivo de schema Logix (arquivo logix.sch que contempla layout de definição das tabelas do banco de dados Logix), utilizado para compilação de fontes com extensão .4GL e .PER;

                 Losango - ícones de formas grátis Separe todos os fontes e recursos customizados que deverão ser compilados para gerar o RPO CUSTOM;

                 Losango - ícones de formas grátis Caso utilize algum include com extensão .CH (include ADVPL) desenvolvido pela TOTVS, deve-se realizar o download do pacote de includes Logix mais atualizado clicando AQUI (link será disponibilizado em breve), ou entre em contato com equipe de atendimento Framework Logix;

                 Losango - ícones de formas grátis Instale e configure o Build AppServer, lembrando de configurar o caminho de includes no VSCode, utilizadas para compilação de fontes ADVPL, e configurar a chave FGLDBPATH que deverá ser informada na seção do ambiente do arquivo appserver.ini utilizado para a compilação.

       A chave FGLDBPATH deverá apontar para uma pasta local do servidor onde foi armazenado o arquivo de schema logix.sch usado na compilação de fontes .4GL e .PER;

Na seção [APP_MONITOR] informar chave ENABLE=0;

Na seção [GENERAL] informar chave BUILDKILLUSER=1;

Manter serviços REST e JOB do appserver inativos para não deixar o RPO em uso.

                 Losango - ícones de formas grátis Certifique-se de ter configurado corretamente a chave de ambiente chamada RPOCUSTOM no arquivo AppServer.ini com o caminho completo da pasta e nome do arquivo RPO que armazenará no servidor a compilação dos fontes customizados. Para mais detalhes acesse RpoCustom;

                 Losango - ícones de formas grátis Para compilar os fontes e recursos existem duas opções disponíveis, sendo:

Painel
borderColor#C0C0C0
borderStyledashed

 Ferramenta IDE de desenvolvimento VScode utilizando a extensão "TOTVS Developer Studio for VSCode"

        • Instale e configure a ferramenta IDE de desenvolvimento VSCode disponível para download em https://code.visualstudio.com/download e configure a extensão "TOTVS Developer Studio for VSCode (AdvPL, TLPP e 4GL)" conforme orientações em https://github.com/totvs/tds-vscode#totvs-developer-studio-para-vscode. Existe um guia prático de instalação e configuração do VSCode para Logix disponível em Instalação VSCode + extensão TOTVS Developer Studio LOGIX
        • Lembre-se de configurar as pastas de includes com extensão .CH corretamente no TDS-VSCode, caso utilize-as para compilação de fontes ADVPL;
        • Com a ferramenta VSCode configurada e ambiente do AppServer conectado via extensão TDS-VSCode, crie uma workspace no VSCode com a lista completa dos fontes e recursos a serem compilados e proceda a compilação. Em caso de falhas de conexão ou inviabilidade de compilação, acesse a página central da ferramenta TDS-VSCode mencionada anteriormente para tentar identificar o problema e a solução.


Ferramenta AppServer Command Line - Compilação por linha de comando do AppServer

        • Agora é possível usar o próprio binário do AppServer para realizar as compilações de fontes e recursos. Para isso siga as orientações disponíveis em AppServer Command Line - Compilação por linha de comando
        • É possível que sejam reportados problemas na compilação de fontes e recursos específicos, devido a correções e melhorias realizadas no compilador do build AppServer. Neste caso, avalie as inconsistências ocorridas e faça as correções necessárias, refazendo posteriormente a recompilação.
        • Tendo finalizado com sucesso o processo de compilação de fontes e recursos customizados, confira se o RPO Custom foi atualizado e em caso positivo, prossiga com os demais passos até a execução do sistema Logix para avaliar se tudo ficou OK.

 Após teste de conexão do produto Logix com o ambiente AppServer e Smartclient instalados e configurados, avaliar outras configurações adicionais, como:

Losango - ícones de formas grátis Balanceamento de conexões;

Losango - ícones de formas grátis Configurações RESTHTTPHTTPSTELNETWEBAPP, entre outros;

Losango - ícones de formas grátis Configurações de atualização automática de Smartclient nas estações de trabalho.


5. Principais pontos de atenção na migração do build 32 bits para 64 bits



  A ferramenta TOTVS Monitor, até então disponível com o executável para ambiente Windows TotvsMonitor.exe, foi substituída pelo Monitor Electron, que também é compatível com build 32 bits. Para mais detalhes acesse Monitor Electron.


  Por ser binário com uma arquitetura diferente, não será possível utilizar a mesma estrutura de pastas e arquivos do build 32 bits, onde o processo de atualização sempre é feito de forma simples, apenas substituindo os atuais arquivos das pastas de TOTVS AppServer e TOTVS SmartClient.
          Neste casoserá necessário criar nova estrutura de pastas para instalar o binário na arquitetura 64 bits.


  O atual RPO utilizado no build 32 bits não é compatível com a nova arquitetura em 64 bits.  Será preciso obter uma nova versão de RPO Logix compilado na arquitetura 64 bits.


  O TOTVS SmartClient também foi atualizado para versão com arquitetura 64 bits, que contempla alguns componentes de resolução gráfica de maior qualidade e para ganhar desempenho.

Expandir
titleClique AQUI para visualizar algumas orientações IMPORTANTES a respeito do uso do SmartClient a partir do Build 20.3.1.x
Painel
borderColor#ff0000
borderStyledashed

Losango - ícones de formas grátis  É recomendado que o TOTVS SmartClient seja instalado em ambiente local de acesso dos usuários (estações de trabalho) para obter melhor performance e o acesso via Compartilhamento de Rede não é Homologado. Para mais informações acesse Uso do SmartClient em Compartilhamento de Rede

Losango - ícones de formas grátis  Para evitar que estações de trabalho fiquem com o smartclient desatualizado é necessário configurar a Atualização automática do TOTVS Smartclient. Para mais detalhes sobre a atualização automática do smartclient nas estações de trabalho acesse Application Server - Configuração Seção [Update]


  A ferramenta Console de Atualização Logix foi liberada em uma versão compatível para 64 bits. 


  Configurações de Variáveis de Ambiente no Sistema Operacional de instalação do TOTVS AppServer

Expandir
titleClique AQUI para visualizar a lista de variáveis de ambiente necessárias para o Logix (Independente do banco de dados conectado)...
Painel
borderColor#C0C0C0

Variáveis de Ambiente Logix e Application Server



Existem algumas variáveis de ambiente utilizadas pelo Logix ou Application Server para:

Losango - ícones de formas grátis Determinar o formato de valores numéricos ou de datas.

Losango - ícones de formas grátis Disponibilizar bibliotecas .jar utilizadas por alguns utilitários desenvolvidos em JAVA utilizados pelo Logix.

Losango - ícones de formas grátis Atalhos para acesso de outras ferramentas integradas ao Logix.


Variável ConteúdoDescriçãoPré-requisito para
DBMONEY,Define separador decimal para exibição de valores em telas e relatórios.
Valores:  vírgula(,) ou ponto(.)
Application Server
DBDATEdmy4/Define formato de data para exibição em telas e relatórios. Application Server
DBCENTURYCDefine o século corrente para complementar quando é digitado somente dois dígitos do ano em campos do tipo data.Application Server
CLASSPATHc:\totvs\logix\lib\activation.jar;c:\totvs\logix\lib\imap.jar; <.....outras....>Define o caminho das bibliotecas java .jar necessárias para os serviços de boleto bancário, relatório em PDF, NF-e, etc.Execução de aplicações desenvolvidas em Java acionadas a partir do Logix.
JAVA_HOME<pasta raiz de instalação do Java>

Define o caminho da instalação do Java (JDK ou JRE) utilizado para execução de bibliotecas .jar.

 Na variável de ambiente PATH também deverá constar a subpasta BIN de instalação desta instalação Java.

Execução de aplicações desenvolvidas em Java acionadas a partir do Logix.
LGXGRhttp://[IP-servidor-TOMCAT-GRL]:[porta-serviço-TOMCAT]Indica o endereço URL de acesso para a ferramenta GRL (Gerenciador de Relatórios Logix), quando estiver em uso, que é disponibilizada via serviço da ferramenta Apache TOMCAT.

Para mais detalhes acesse Gerenciador de Relatórios Logix (GRL)
Gerenciador de Relatórios LOGIX
LGXBIhttp://[IP-servidor-TOMCAT-BI]:[porta-serviço-TOMCAT]Indica o endereço URL de acesso a ferramenta Logix BI, quando estiver em uso. Logix BI
PROXY_NFE[IP_servidor_TSS:porta_TCP]Indica o servidor onde está instalado o serviço da ferramenta/módulo TSS e porta TCP configurada no arquivo appserver.ini do TOTVS AppServer TSS para integração com o Logix.

Logix TSS
LD_LIBRARY_PATHLista de pastas onde constam as bibliotecas Linux (arquivos .SO) do AppServer e de conexão com banco de dados disponíveis na instalação do client de conexão de banco de dados.

Obrigatório APENAS para ambiente AppServer Linux.

 Para build Harpia é preciso adicionar a pasta raiz do Application Server na variável de ambiente LD_LIBRARY_PATH devido a novas bibliotecas, arquivos com extensão .so, disponibilizados juntamente com o binário e utilizados na inicialização do Application Server em ambiente Linux.

Application Server


Configurações da Conexão do Banco de Dados pelo TOTVS AppServer 

Expandir
titleClique AQUI para visualizar as configurações necessárias para as conexões de Banco de Dados...
Painel
borderColor#C0C0C0

Conexão com Banco de Dados



Painel
borderColor#ff0000
borderStyledashed
Como o build AppServer é instalado com a arquitetura 64 bits, os Clients e Drivers de Conexão com Banco de Dados também precisam estar disponíveis na versão 64 bits.


Veja os procedimentos de conexão com os bancos de dados homologados para uso no Logix.

Totvs custom tabs box
tabsInformix, Oracle, Microsoft SQLServer, Conexão Banco de Dados ao TOTVS AppServer
idsdb1,db2,db3,db4
Totvs custom tabs box items
defaultyes
referenciadb1

Segue abaixo os procedimentos necessários para realizar a conexão do Logix com o banco de dados INFORMIX


Inicie instalando o Informix Client SDK IBM INFORMIX ODBC DRIVER na versão 64 bits respeitando a versão do sistema operacional do servidor onde o Logix está sendo instalado. 

Totvs custom tabs box
tabsLinux, Windows
idsso1,so2
Totvs custom tabs box items
defaultyes
referenciaso1

Para download do instalador Informix Client SDK acesse Client Informix SDK Linux.


Losango - ícones de formas grátis   Pré-requisito


           O Informix Client SDK homologado deve estar instalado no servidor LInux onde os TOTVS AppServers estão instalados.

Para conectar ao banco de dados Informix é necessário configurar alguns arquivos no servidor Linux, o que deverá ser feito com o usuário administrador do sistema operacional (root).


Losango - ícones de formas grátisArquivos a serem configurados


1. Arquivo .odbc.ini 

    Este arquivo deve ser criado no diretório raiz do usuário root (cd /root).

    Abaixo exemplo supondo que o diretório de instalação do Client SDK Informix seja /usr/informix:

Bloco de código
languagegroovy
themeConfluence
[ODBC]
Trace=0
TraceFile=/tmp/odbctrace.out
InstallDir=/usr/informix
     
[logix]
Database=logix
Servername=[nome da instância informix: INFORMIXSERVER]
CursorBehavior=1
EnableScrollableCursors=1
FetchBufferSize=32767



2. Arquivo SQLHOSTS

    Este arquivo está localizado na pasta /etc do Client SDK Informix ($INFORMIXDIR/etc/sqlhosts).

Bloco de código
languagegroovy
themeConfluence
#dbservername    nettype     hostname   servicename
logixprdshm      onipcshm    10.0.0.10  logix
logixprdsoc      onsoctcp    10.0.0.10  logixsrv
Painel
borderColor#C0C0C0
borderStyledashed
O arquivo SQLHOSTS pode ser copiado da instalação do Informix do servidor de banco de dados.   



3. Arquivo SERVICES

    Este arquivo está localizado no diretório raiz /etc do servidor Linux.

    Editar o arquivo e incluir uma linha com o nome do serviço que faz a comunicação com o banco de dados na porta TCP de comunicação.

          Exemplo:  logixsrv     5900/tcp

   


4. Arquivo totvsenv.sh

    Este arquivo está localizado na pasta de instalação dos TOTVS AppServers (/totvs/logix64/bin).

    Editar o arquivo e incluir as seguintes variáveis de ambiente no final do arquivo:

Bloco de código
languagegroovy
themeConfluence
export INFORMIXDIR=[diretório de instalação do informix SDK]
export PATH=INFORMIXDIR/bin:$PATH
export LD_LIBRARY_PATH=$INFORMIXDIR/lib:$INFORMIXDIR/lib/cli:$INFORMIXDIR/lib/esql:$LD_LIBRARY_PATH
Painel
borderColor#C0C0C0
borderStyledashed
Se durante a execução do Instalador do Logix foi informada a pasta de localização do Client SDK Informix em tela, não há necessidade de realizar esta configuração no arquivo totvsenv.sh.    
Totvs custom tabs box items
defaultno
referenciaso2

Para download do instalador Informix Client SDK acesse Client Informix SDK Windows.


Losango - ícones de formas grátis   Pré-requisito


           O Informix Client SDK homologado deve estar instalado no servidor Windows onde os TOTVS AppServers estão instalados.


Losango - ícones de formas grátis  Configurações de conexões ODBC


1.  No Windows acesse a ferramenta Administrador de Fonte de Dados ODBC 64 bits (executável %WinDir%\System32\odbcad32.exe)

Painel
borderColor#C0C0C0
borderStyledashed

ATENÇÃO! O Administrador de Fonte de Dados ODBC da pasta SysWow64 corresponde a arquitetura 32 bits.  (erro) NÃO realize a configuração via Fonte de Dados ODBC 32 bits.

      (seleção)   TODAS as configurações de conexões de banco de dados para build TOTVS AppServer 64 bits devem ser via ODBC 64 bits.



2.  Entre na aba DSN de Sistema ou Fonte de Dados de Sistema, pressione o botão e selecione o driver IBM INFORMIX ODBC DRIVER (64-bit).




3.  Preencha os demais dados de conexão solicitados e valide se a conexão com o banco é realizada corretamente. 

Painel
borderColor#C0C0C0
borderStyledashed

Para o LOGIX atente para algumas configurações necessárias como:

Na aba  Environment

CLIENT LOCALE            en_us.819
DATABASE LOCALE      en_us.819
CURSOR BEHAVIOR     1 - Preserve
FETCH BUFFER SIZE     32767

Na aba Advanced 

AUTO COMMIT OPTIMIZATION   Free Check Mark SVG, PNG Icon, Symbol. Download Image.     (por padrão já vem marcado)
INSERT CURSORS     
                      Free Check Mark SVG, PNG Icon, Symbol. Download Image.
SCROLLABLE CURSORS                  Free Check Mark SVG, PNG Icon, Symbol. Download Image.



4.  Na aba Connection pressione o botão   para avaliar se a conexão de banco é bem sucedida.

Painel
borderColor#C0C0C0
borderStyledashed

ATENÇÃO! Certifique-se de que as variáveis de ambiente abaixo estejam configuradas no servidor Windows onde acabou de configurar as conexões via ODBC:


INFORMIXDIR   
Registrar o diretório geral de instalação do Client SDK Informix.   
                            Exemplo: C:\Informix64\

PATH                   Acrescentar o diretório dos executáveis da instalação do Client SDK Informix (pasta bin).   
                            Exemplo: C:\Informix64\bin




Totvs custom tabs box items
defaultno
referenciadb2

Para o banco de dados ORACLE deve-se instalar a ferramenta para conexão com o banco chamada Oracle Client Runtime ou Oracle InstantClient na versão 64 bits.


Abaixo estão descritos os procedimentos para instalação e configurações a ferramenta Oracle InstantClient:

Totvs custom tabs box
tabsLinux,Windows
idslinux,windows
Totvs custom tabs box items
defaultyes
referencialinux

O download do ORACLE InstantClient, pode ser realizado em Client Oracle Linux


Losango - ícones de formas grátisArquivos a serem configurados



Painel
borderColor#C0C0C0
borderStyledashed
Para conectar ao banco de dados é necessário configurar alguns arquivos após instalar o Client Oracle e para isso é necessário fazer acesso ao ambiente linux utilizando um usuário administrador (root).



1. Arquivo tnsnames.ora 

    Localizado no diretório onde está instalado o Client Oracle. Exemplo: /opt/oracle/product/19c/network/admin

Bloco de código
languagegroovy
themeConfluence
# tnsnames.ora Network Configuration File: /oracle/product/19c/network/admin/tnsnames.ora
# Generated by Oracle configuration tools.
LOGIX12 =
(DESCRIPTION =
  (ADDRESS_LIST =
    (ADDRESS = (PROTOCOL = TCP)(HOST = lndb02)(PORT = 1521))
  )
  (CONNECT_DATA =
    (SERVICE_NAME = ora19c)
  )
)



2. Arquivo totvsenv.sh 

    Localizado no diretório de instalação de cada TOTVS AppServer (/totvs/logix64/bin).

Painel
borderColor#C0C0C0
borderStyledashed

Se desejar, pode-se manter uma única cópia deste arquivo totvsenv.sh para uso de todos os TOTVS AppServers que forem utilizar as mesmas configurações.

                  Se durante a execução do Instalador do Logix você informou em tela o diretório de instalação do Client Oracle, não há necessidade de realizar esta configuração no arquivo totvsenv.sh.  


 Configurar as seguintes variáveis de ambiente no final do arquivo:

Bloco de código
languagegroovy
themeConfluence
export ORACLE_HOME=/opt/oracle/product/19c
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=',.'
Totvs custom tabs box items
defaultyes
referenciawindows

O download do ORACLE InstantClient, pode ser realizado em Client Oracle Windows


Losango - ícones de formas grátis Instalação Client 


Faça a extração dos dados do arquivo de instalação Client Oracle Windows que realizou download em uma pasta que achar mais adequada.     Exemplo: c:\oracle\instantclient_19_13_x64

Losango - ícones de formas grátis Configurações 


 1.  Configure a conexão com o banco de dados Oracle Logix no arquivo tnsnames.ora localizado na mesma pasta para onde foram extraídos os arquivos do Client Oracle escolhido.

      (informação) O arquivo tnsnames.ora é responsável por armazenar os nomes de serviços de rede para que o servidor atual consiga identificar os dados de localização o servidor e instância de banco Oracle a ser conectado.


2.  Estabelecida a conexão com o banco de dados Oracle, será preciso configurar algumas variáveis de ambiente no Windows:

ORACLE_HOME = Indica o diretório de instalação do Client Oracle. Exemplo: c:\oracle\instantclient_19_13_x64

TNS_ADMIN = Indica o diretório de instalação do Client Oracle.  Exemplo:c:\oracle\instantclient_19_13_x64

NLS_LANG = AMERICAN_AMERICA.WE8ISO8859P1

NLS_DATE_FORMAT = dd/mm/yyyy hh24:mi:ss

NLS_NUMERIC_CHARACTERS = ,.


Painel
borderColor#C0C0C0
bgColor#ffff8f
borderStyledashed
ATENÇÃO! Caso opte pela instalação do ORACLE Runtime, será preciso também adicionar o caminho completo da pasta BIN da instalação do Oracle Runtime à variável de ambiente PATH do Windows.
Totvs custom tabs box items
defaultno
referenciadb3

Para conexão do Logix com o banco Microsoft SQLServer, será preciso instalar o driver ODBC Driver for SQL Server.

Losango - ícones de formas grátis Instalação Client 


Faça o download do driver ODBC para Microsoft SQLServer sempre a partir da página oficial da Microsoft clicando AQUI.

Painel
borderColor#C0C0C0
borderStyledashed
ATENÇÃO!Não esqueça que deverá instalar o driver ODBC Driver for SQL Server na versão 64 bits  SEMPRE respeitando a versão mais recente deste driver e compatível com a versão do banco a ser conectado. 


Losango - ícones de formas grátis Configurações 


1.  Execute a ferramenta Fontes de Dados ODBC (64 bits) (executável %WINDIR%\system32\odbcad32.exe).

Painel
borderColor#C0C0C0
borderStyledashed
    ATENÇÃO! para o título da janela da ferramenta de configuração para conexões ODBC no Windows pois deverá ser para arquitetura correspondente, ou seja,


2.  Entre na opção DSN de Sistema (Fonte de Dados de Sistema), clique em  e selecione o driver ODBC Driver for SQL Server instalado.



3. 
Preencha todos os dados necessários exigidos para a conexão e valide se a conexão com o banco é realizada corretamente.



Totvs custom tabs box items
defaultno
referenciadb4

Para configurar a conexão de banco de dados já realizada no client de conexão do respectivo banco de dados, deverá agora fazer com que o TOTVS AppServer consiga conectar nesta conexão de banco de dados configurada. Para isso é necessário utilizar a ferramenta testdbconnection, localizada na pasta do TOTVS AppServer, sendo que para ambiente Windows esta ferramenta tem extensão de arquivo .EXE.  

Para realizar o registro e validação de uma conexão de Banco de Dados com o TOTVS AppServer, acesse uma PROMPT de comando do servidor a partir da pasta do TOTVS Appserver, onde está localizado o executável testdbconnection e execute a seguinte linha de comando:


SINTAXE

Bloco de código
LINUX 
     testdbconnection –u <user> -p <password> -d [informix|oracle|mssql] –a <alias>

WINDOWS
     testdbconnection.exe –u <user> -p <password> -d [informix|oracle|mssql] –a <alias>


Sendo que os parâmetros são:

PARÂMETRODESCRIÇÃOCONTEÚDO


-u


Identificação do usuário de conexão ao
banco de dados.

ATENÇÃO! Informe um usuário com permissão de administrador no Banco de Dados.



Login do usuário no banco de dados


-p

Identificação da senha do usuário de conexão ao
banco de dados.

Senha do usuário no banco de dados



-d


Identificação do tipo do
 banco de dados. Valores possíveis para o LogixInformixOracle ou MSSQL.
INFORMIX 
ou
ORACLE
ou
MSSQL

-a


Nome do 
alias DataSource Name/ODBC criado para conexão ao banco de dados.
Nome da conexão registrada no Client
de conexão do banco de dados

(client / driver ODBC)
Painel
borderColor#C0C0C0
borderStyledashed

    ATENÇÃO! Se ao executar a linha de comando ocorrer falha de conexão, acesse o arquivo dbaccess.log e veja sempre no final do arquivo as últimas mensagens para identificar o motivo da falha de conexão.
            Na grande maioria das vezes isso pode ser resolvido revisando o passo a passo da instalação e configuração do client de conexão de banco de dados e criação da conexão do banco, realizado no passo a passo anterior  ( client / driver ODBC).



(seleção) PRONTO! Após realizar o procedimento, será criado ou atualizado o arquivo totvsdbaccess.ini, que mantem as informações de conexão com o banco de dados.

            Não há necessidade de executar o comando em cada diretório de appserver. Você poderá replicar o arquivo copiando para as demais pastas de appserver.

            Será necessário executar o comando novamente caso a senha/usuário de conexão seja alterado ou deseja criar um novo alias de comunicação.



Licenciamento

Para Informações relacionadas ao licenciamento acesse TOTVS License Server Virtual.



6. Como aplicar PATCHES e PACOTES de atualização no Logix?



A ferramenta oficial de atualização do Logix permanece sendo o Console de Atualização Logix, no entanto, ele foi disponibilizado na versão compatível com a arquitetura 64 bits. Acesse AQUI e baixe a versão identificada como X64.


Painel
borderColor#C0C0C0
borderStyledashed
Caso não encontre a versão X64 disponível para o Console de Atualização Logix, entre em contato com nossa equipe de atendimento Framework Logix.


7. Dicas



Expandir
titleComo instalar o AppServer como serviço do Windows
  • Configure a seção [SERVICE] no arquivo de configuração appserver.ini. Para mais detalhes acesse AQUI.
  • Execute o appserver por linha de comando, a partir da pasta do AppServer desejado, usando o parâmetro -install para instalar o AppServer. Para mais detalhes acesse AQUI.
  • Configure a autenticação do Serviço Windows criado para o AppServer utilizando um usuário de domínio que seja administrador do servidor, para evitar problemas com permissões de acesso durante a execução do Logix.


8. Links Úteis



Templatedocumentos

HTML
<style>

.custom-button {
	position: absolute;
    top: 50px;
    right: 35px;
}

.page-metadata div {
	float: none !important;
	margin: 4px 0 0 0 !important;
}

<!********TIRA O MENU LATERAL*********-->
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}
<!****************************-->

</style>