Instalação e configuração build 20.3.1.xx (Harpia) para produto Logix
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:
Mudanças em relação ao build 7.00.131227A (32 bits)
Algumas novidades
Ajustes de configurações
1. Introdução
O binário TOTVS Application Server e 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:
 OBJETIVO |  DESCONTINUADO |  NOVA FERRAMENTA |
|---|---|---|
Balanceamento de Conexões SmartClient X AppServer | LOAD BALANCE (AppServer Master X AppServer Slaves) | TOTVS Broker |
IDE de Desenvolvimento | TOTVS Developer Studio Versão 11.3 | TOTVS Developer Studio para VSCode |
| 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
.
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 Custom. Para mais detalhes acesse Application Server - RPOs Segregados.
bem como facilitar a atualização dos ambientes e futuros releases . |
|---|
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?
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
NOVA FERRAMENTA 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.
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:
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.
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
Diretório (Obrigatório): Informe o diretório de instalação do Logix (rootpath)
Quantidade: Quantidade de appservers que serão configurados.
Porta: Porta TCP inicial que será utilizada na configuração dos appservers.
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.
Serviços Auxiliares: Permite definir outros serviços appserver que serão criados durante o processo de instalação.
Serviços disponíveis: JOB, EAI, REST, DEBUG ou TELNET
Environment: Nome do ambiente que será a criado nos appservers.
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
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].
A ferramenta irá criar toda a estrutura necessária para o funcionamento do Logix.
ATENÇÃO! Esta opção deve ser utilizada em situações APENAS onde deseja realizar uma nova instalação do Logix.
ATENÇÃO! Assistente utilizado APENAS para realizar a atualização do binário 64 bits.
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.
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.
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.
Assistente utilizado para realizar a atualização do arquivo appserver.ini 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. 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 instalado na estação local.
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.
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 disponívels para o LOGIX clicando AQUI.
Você pode também optar pelo download do Assistente de Configuração LOGIX que já faz busca automaticamente a versão de build mais atual disponível para o Logix e auxilia em todo o passo a passo de instalação do Build. Para download do Assistente de Configuração LOGIX clique AQUI 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;
Seguem algumas dicas na hora de configurar o arquivo INI para o Smartclient e AppServer:
AppServer
♦ A seção TOTVSDBACCESS mudou para DBACCESS, mas ela não é mais necessária. Basta definir as chaves DBDATABASE e DBALIAS em cada um dos ambientes configurados no INI do appserver.
♦ Defina em cada ambiente a chave RPOCUSTOM para determinar a pasta onde estará o RPO com os recursos customizados. Quando esta chave não é definida o AppServer assume que o RPOCUSTOM está armazenado na pasta raiz do AppServer. Em caso de dúvidas sobre RPO CUSTOM acesse Informações sobre RPO Custom.
♦ Preste atenção em algumas mudanças de chaves configuradas nas seção de cada ambiente.
♦ Para configurar um appserver BROKER acesse a documentação TOTVS Broker - Balanceamento de conexões
♦ Baixe AQUI o arquivo modelo de configuração de AppServer Logix.
Smartclient
♦ Atente para configuração de chave BROKERPROXY em caso de conexão com BROKER. Para mais informações acesse TOTVS Broker - Balanceamento de conexões.
♦ Baixe AQUI o arquivo modelo de configuração de Smartclient Logix.
Aplicação de patches, seja patch RPO Totvs ou patch 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:
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.
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.
Como posso obter ou gerar o RPO CUSTOM com os fontes e recursos customizados (específicos)?
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:
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;
Separe todos os fontes e recursos customizados que deverão ser compilados para gerar o RPO CUSTOM;
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;
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.
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;
Para compilar os fontes e recursos existem duas opções disponíveis, sendo:
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:
Balanceamento de conexões;
Configurações REST, HTTP, HTTPS, TELNET, WEBAPP, entre outros;
Configurações para 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 caso será 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.
É 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
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]
Para monitores onde nas configurações de resolução de tela esteja informada uma escala superior a 100%, as imagens das telas podem perder resolução e o tamanho da fontes das telas podem ficar desproporcionais, gerando um pouco de desconforto ao usuário. Neste caso é sugerido utilizar o parâmetro adicional -OLDDPI no atalho do SmartClient.
Exemplo: Smartclient.exe -m -OLDDPI
Para mais informações a respeito de parâmetros dos Smartcliente acesse SmartClient - Parâmetros de linha.
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
Variáveis de Ambiente Logix e Application Server
Existem algumas variáveis de ambiente utilizadas pelo Logix ou Application Server para:
Determinar o formato de valores numéricos ou de datas.
Disponibilizar bibliotecas .jar utilizadas por alguns utilitários desenvolvidos em JAVA utilizados pelo Logix.
Atalhos para acesso de outras ferramentas integradas ao Logix.
| Variável | Conteúdo | Descrição | Pré-requisito para |
|---|---|---|---|
| DBMONEY | , | Define separador decimal para exibição de valores em telas e relatórios. Valores: vírgula(,) ou ponto(.) | Application Server |
| DBDATE | dmy4/ | Define formato de data para exibição em telas e relatórios. | Application Server |
| DBCENTURY | C | Define o século corrente para complementar quando é digitado somente dois dígitos do ano em campos do tipo data. | Application Server |
| CLASSPATH | c:\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.
| Execução de aplicações desenvolvidas em Java acionadas a partir do Logix. |
| LGXGR | http://[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 |
| LGXBI | http://[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_PATH | Lista 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.
| Application Server |
Configurações da Conexão do Banco de Dados pelo TOTVS AppServer
Conexão com Banco de Dados
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.
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.
Para download do instalador Informix Client SDK acesse Client Informix SDK Linux.
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).
Arquivos 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:
[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).
#dbservername nettype hostname servicename logixprdshm onipcshm 10.0.0.10 logix logixprdsoc onsoctcp 10.0.0.10 logixsrv
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:
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
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.
Para download do instalador Informix Client SDK acesse Client Informix SDK Windows.
Pré-requisito
O Informix Client SDK homologado deve estar instalado no servidor Windows onde os TOTVS AppServers estão instalados.
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)
ATENÇÃO! O Administrador de Fonte de Dados ODBC da pasta SysWow64 corresponde a arquitetura 32 bits.
NÃO realize a configuração via Fonte de Dados ODBC 32 bits.
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.
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 (por padrão já vem marcado)
INSERT CURSORS
SCROLLABLE CURSORS
4. Na aba Connection pressione o botão 
para avaliar se a conexão de banco é bem sucedida.
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
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:
O download do ORACLE InstantClient, pode ser realizado em Client Oracle Linux
Arquivos a serem configurados
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
# 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).
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:
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=',.'
O download do ORACLE InstantClient, pode ser realizado em Client Oracle Windows
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
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.
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 = ,.
Para conexão do Logix com o banco Microsoft SQLServer, será preciso instalar o driver ODBC Driver for SQL Server.
Instalação Client
Faça o download do driver ODBC para Microsoft SQLServer sempre a partir da página oficial da Microsoft clicando AQUI.
Configurações
1. Execute a ferramenta Fontes de Dados ODBC (64 bits) (executável %WINDIR%\system32\odbcad32.exe).
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.
ATENÇÃO! Banco SQL Server ainda NÃO ESTÁ HOMOLOGADO para conectar com AppServer na versão 64 bits em ambiente Linux para o produto LOGIX.
Em breve traremos novidades em relação a esta homologação. Fique atento as novidades publicadas no portal Comunica Framework Logix.
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
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ÂMETRO | DESCRIÇÃO | CONTEÚDO |
|---|---|---|
|
|
|
-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 Logix: Informix, Oracle 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) |
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).
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.
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. Será preciso fazer uma validação da tecnologia na arquitetura 64 bits em meu ambiente?
Recomendamos que, para assegurar o sucesso na adoção da tecnologia substituta, seja realizada a validação da aderência e definição de configurações específicas e novas parametrizações, seguidas de ciclos de testes.
Em alguns casos, a implantação da tecnologia substituta pode gerar a necessidade de treinamentos e capacitações a serem fornecidos sob demanda.
8. Dicas
9. Links Úteis
Plataforma homologada dos produtos desenvolvidos pela Tecnologia TOTVS
Download build AppServer e Smartclient HARPIA para Logix
Application Server
Sistemas Operacionais Homologados - Application Server
Application Server - Como fazer
Application Server - Notas de release
Informações adicionais de processos e memória - Application Server - Chave ServerMemoryInfo
Application Server - Informações adicionais
Application Server - Linux packages
Application Server - BTMonitor
AppServer Command Line - Compilação por linha de comando
TOTVS Broker - Balanceamento de conexões
TOTVS Broker - Histórico de Versões
SmartClient
Sistemas Operacionais Homologados - SmartClient
SmartClient - Guia de instalação
SmartClient - Notas de release
SmartClient - Parâmetros de linha
Atualização automática de Smartclient Local - Application Server - seção [Update]
WebApp - WebAgent (Futura Homologação para Logix)
DBAccess
Banco de dados homologados - DBAccess
DBAccess - Como fazer
TOTVS Monitor
IDE de Desenvolvimento
Instalação VSCode + extensão TOTVS Developer Studio LOGIX
CONSOLE DE ATUALIZAÇÃO LOGIX
Como instalar o Console de Atualização Logix
Como configurar o Console de Atualização Logix
Como utilizar o Console de Atualização Logix
ASSISTENTE DE CONFIGURAÇÃO LOGIX
Download do Assistente de Configuração LOGIX
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas