Instalação e configuração build 20.3.

2.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:

Image Added Mudanças em relação ao build 7.00.131227A (32 bits)

Image Added Algumas novidades

Image Added Ajustes de configurações

1. Introdução

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

O binário TOTVS Application Server e TOTVS Smartclient Smartclient, disponível na arquitetura 64 bits para o Logix Logix, é conhecido sob o nome HARPIA e o número de controle de revisão tem como prefixo 20.3.12.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

Image Removed   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á distribuido 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.

foi descontinuado?

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

OBJETIVO	DESCONTINUADO	NOVA FERRAMENTA
Balanceamento de ConexõesSmartClient 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
Monitor de Conexões no TOTVS AppServer	TOTVS Monitor (totvsmonitor.exe)	TOTVS Monitor Electron ou TDS-VSCode (Monitor)

3. O que há de novo?

Image Added   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.2.x) e TOTVSSmartclient passou para Smartclient (a partir do build 17.3.0.xx).

Image Added   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.

Image Added  A partir do build 20.3.2.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
title Clique AQUI para visualizar sobre execução via linha de comando
Painel borderColor darkgrey borderStyle dashed Image Added

Image Added  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.

Image Added  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.

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

Image Removed  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.

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

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

Image Removed

Image Removed  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.

Image Removed  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 sempre instalado como local nas estações de trabalho. 
          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]

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

Variáveis de Ambiente Logix

Existem algumas variáveis de ambiente utilizadas pelo Logix 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.

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

Conexão com Banco de Dados

Image Removed 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 procedimento 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

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

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

Image Removed Pré-requisito
         O Informix SDK homologado deve estar instalado na máquina onde está sendo configurada a conexão.

Image RemovedArquivos a serem configurados

1. Arquivo .odbc.ini deve ser criado no diretório raiz do root (cd /root). Abaixo exemplo supondo que o diretório de instalação do client SDK é /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 localizado na pasta /etc do Client SDK Informix (cd $INFORMIXDIR/etc/sqlhosts).

#dbservername    nettype     hostname   servicename
logixprdshm      onipcshm    10.0.0.10  logix
logixprdsoc      onsoctcp    10.0.0.10  logixsrv

Image Removed O arquivo SQLHOSTS pode ser copiado da instalação do Informix do servidor de banco de dados.   

3. Arquivo SERVICES localizado no diretório /etc do servidor Linux (cd /etc).

    Edite o arquivo e insira 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

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

    
Image Removed Se durante a execução do Instalador do Logix foi informado em tela a pasta de localização do Client SDK Informix, 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.

1- Execute %WinDir%\System32\odbcad32.exe - para acessar a ferramenta Administrador de Fonte de Dados ODBC 64 bits

O Administrador de Fonte de Dados ODBC da pasta SysWow64 corresponde a arquitetura 32 bits. Não realize a configuração desta Fonte de Dados ODBC!

Image Removed

Atenção:
Na aba “Environment” o parâmetro “Cursor Behavior” deve ficar com valor “1 – Preserve”.
Na aba “Advanced” deverá marcar: “Auto Commit Optimization”, “Insert Cursors” e “Scrollable Cursors”.

O download do ORACLE InstantClient, pode ser realizado através dos seguintes links:
- Client Oracle Windows
- Client Oracle Linux

WINDOWS

Image Removed

2- Configure o arquivo TNSNAMES.ora para realizar a comunicação com o banco de dados.

O arquivo tnsnames.ora é responsável por armazenar os nomes de serviço de rede para que a estação de trabalho (client) consiga conectar-se ao servidor Oracle

3- Estabelecida a conexão com o banco de dados é necessário configurar as seguintes variáveis de ambiente:

ORACLE_HOME=Indica o diretório de instalação do Client Oracle exemplo: c:\oracle\instantclient_21_6
TNS_ADMIN=Indica o diretório de instalação do Client Oracle exemplo: c:\oracle\instantclient_21_6
NLS_LANG=AMERICAN_AMERICA.WE8ISO8859P1
NLS_DATE_FORMAT=dd/mm/yyyy hh24:mi:ss
NLS_NUMERIC_CHARACTERS=,.

LINUX

Para conectar ao banco de dados é necessário configurar alguns arquivos após instalar o client Oracle. Utilize o usuário administrador (root).

Arquivos a serem configurados:

1- Arquivo tnsnames.ora localizado no diretório onde está instalado o Client do Oracle. (exemplo: /opt/oracle/product/19c/network/admin)
Para cada ambiente TOTVS Tec é necessário um serviço TNS.
# 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" do totvstec, localizado no diretório de instalação dos appserver (/totvs/logix64/bin).
 Configurar as seguintes variáveis 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=',.'

   Observação: Se na execução do instalador do Logix você informou em tela o caminho do client Oracle, não há necessidade de realizar esta configuração no arquivo totvsenv.sh.  

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

   Image Removed 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,Image Removed

3. Entre na opção DSN de Sistema (Fonte de Dados de Sistema), clique em Image Removed e selecione o driver ODBC Driver for SQL Server, sempre respeitando a versão mais recente deste driver e compatível com a versão do banco Microsoft SQLServer a ser conectado.

Image Removed

Para validar a conexão entre o Totvsappserver e banco de dados utilize o testdbconnection|testdbconnection.exe (linux|windows). Para realizar a validação você deve acessar o prompt de comando do servidor de aplicação posicionando na pasta Appserver da instalação do Totvstec

Sintaxe:

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

Parâmetros:

 -u Identificação do usuário de conexão ao banco de dados;
-p Identificação da senha do usuário de conexão ao banco de dados;
-d Identificação do tipo do banco de dados. Valores possíveis para o Logix: Informix, Oracle ou MSSQL;
-a Nome do alias DataSource Name/ODBC criado para conexão ao banco de dados;
-t LOGIX parâmetro obrigatório para o Logix.

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.

Image Removed Licenciamento

pg3 A ferramenta irá criar toda a estrutura necessária para o funcionamento do Logix. Painel borderColor #ffff8c bgColor #ffff8c borderStyle dashed Image Added 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 default no referencia pg4 Painel borderColor #ffff8c bgColor #ffff8c borderStyle dashed Image Added ATENÇÃO! Assistente utilizado APENAS para realizar a atualização do binário 64 bits. Image Added 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. Image Added  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 borderStyle dashed   Image Added 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 default no referencia pg5 Assistente utilizado para realizar a atualização do arquivo appserver.ini Image Added 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. Image Added 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. Painel borderColor #C0C0C0 borderStyle dashed Image Added 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 default no referencia pg6 Nesta opção são disponibilizados links para downloads de arquivos necessários para o funcionamento do Logix.

Image Added  A partir do build 20.3.2.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

Image Added 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

Image Added 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);

Image Added 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;

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

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

Image Added 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)?

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

Image Added Balanceamento de conexões;

Image Added Configurações REST, HTTP, HTTPS, TELNET, WEBAPP, entre outros;

Image Added 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

Image Added  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.

Image Added  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.

Image Added  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.

Image Added  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.

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

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

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

Expandir
title Clique 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 borderStyle dashed Image Added 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 tabs Informix, Oracle, Microsoft SQLServer, Conexão Banco de Dados ao TOTVS AppServer ids db1,db2,db3,db4 Totvs custom tabs box items default yes referencia db1 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 tabs Linux, Windows ids so1,so2 Totvs custom tabs box items default yes referencia so1 Para download do instalador Informix Client SDK acesse Client Informix SDK Linux. Image Added   Pré-requisito            O Informix Client SDK homologado deve estar instalado no servidor LInux onde os TOTVS AppServers estão instalados. Image Added 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). Image AddedArquivos 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 language groovy theme Confluence [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 language groovy theme Confluence #dbservername    nettype     hostname   servicename logixprdshm      onipcshm   10.0.0.10  logix logixprdsoc      onsoctcp    10.0.0.10  logixsrv Painel borderColor #C0C0C0 borderStyle dashed Image Added 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 language groovy theme Confluence 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 borderStyle dashed Image Added 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 default no referencia so2 Para download do instalador Informix Client SDK acesse Client Informix SDK Windows. Image Added   Pré-requisito            O Informix Client SDK homologado deve estar instalado no servidor Windows onde os TOTVS AppServers estão instalados. Image Added  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 borderStyle dashed Image Added 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 Image Added e selecione o driver IBM INFORMIX ODBC DRIVER (64-bit). Image Added 3.  Preencha os demais dados de conexão solicitados e valide se a conexão com o banco é realizada corretamente.  Painel borderColor #C0C0C0 borderStyle dashed Image Added 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   Image Added     (por padrão já vem marcado) INSERT CURSORS                           Image Added SCROLLABLE CURSORS                  Image Added 4.  Na aba Connection pressione o botão Image Added  para avaliar se a conexão de banco é bem sucedida. Painel borderColor #C0C0C0 borderStyle dashed Image Added 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 default no referencia db2 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 tabs Linux,Windows ids linux,windows Totvs custom tabs box items default yes referencia linux O download do ORACLE InstantClient, pode ser realizado em Client Oracle Linux Image AddedArquivos a serem configurados Painel borderColor #C0C0C0 borderStyle dashed Image AddedPara 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 language groovy theme Confluence # 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 borderStyle dashed Image Added 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 language groovy theme Confluence 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 default yes referencia windows O download do ORACLE InstantClient, pode ser realizado em Client Oracle Windows Image Added 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 Image Added 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 = ,. Painel borderColor #C0C0C0 bgColor #ffff8f borderStyle dashed Image Added 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 default no referencia db3 Para conexão do Logix com o banco Microsoft SQLServer, será preciso instalar o driver ODBC Driver for SQL Server. Totvs custom tabs box tabs Windows,Linux ids sis1,sis2 Totvs custom tabs box items default yes referencia sis1 Image Added 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 borderStyle dashed Image Added 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.    Image Added Configurações  1.  Execute a ferramenta Fontes de Dados ODBC (64 bits) (executável %WINDIR%\system32\odbcad32.exe). Painel borderColor #C0C0C0 borderStyle dashed    Image Added 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,Image Added 2.  Entre na opção DSN de Sistema (Fonte de Dados de Sistema), clique em Image Added e selecione o driver ODBC Driver for SQL Server instalado. Image Added 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 default no referencia sis2 Painel borderColor #C0C0C0 borderStyle dashed Image Added 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. Totvs custom tabs box items default no referencia db4 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ÂMETRO DESCRIÇÃO CONTEÚDO -u Identificação do usuário de conexão ao banco de dados. Image Added 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 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) Painel borderColor #C0C0C0 borderStyle dashed    Image Added 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.

Image Added 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 borderStyle dashed
Image Added 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 sobre RPO Custom

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

TOTVS Broker Agent

SmartClient

Sistemas Operacionais Homologados - SmartClient

SmartClient - Guia de instalação

SmartClient - Como fazer

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

TOTVS Monitor Electron

Monitor no TDS para VSCode

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

<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>

Image AddedImage Added