Histórico da Página
Instalação e configuração build 20.3.
12.xx (Harpia) para produto Logix
| Informações | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
|
Page Tree root 01 - 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:
Mudanças em relação ao build 7.00.131227A (32 bits)
Algumas novidades
Ajustes de configurações
1. Introdução Âncora 1.Introdução 1.Introdução
| 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
há de novo? 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.
| 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> |
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 |
| 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.2.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.
|
|---|
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 | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||
|
| Expandir | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
|
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.
| Expandir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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
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;
| Expandir | ||
|---|---|---|
| ||
Seguem algumas dicas na hora de configurar o arquivo INI para o Smartclient e 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.
♦ 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.
| Expandir | ||
|---|---|---|
| ||
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:
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)?
| Expandir | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
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. 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.
|
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 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 | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
|
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 | |||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||
|
Configurações da Conexão do Banco de Dados pelo TOTVS AppServer
| Expandir | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 | ||||
|---|---|---|---|---|
| ||||
 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
| Expandir | ||
|---|---|---|
| ||
|
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
| 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> |
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.
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.
| title | Clique AQUI para saber mais sobre o Assistente de Configuração Logix |
|---|
| borderColor | #C0C0C0 |
|---|---|
| titleBGColor | #C0C0C0 |
O Assistente de Configuração tem como objetivo facilitar o processo de instalação e configuração do Logix.
Através desta ferramenta será possível realizar as operações a seguir:
| borderColor | #C0C0C0 |
|---|---|
| titleColor | white |
| titleBGColor | #33cccc |
| id | Sobre |
|---|
| label | Sobre o Assitente |
|---|
O assistente foi desenvolvida para ser utilizada com interface Web, ao ser executado será aberta uma janela de console informando o endereço de acesso.
Por padrão a ferramenta será iniciada na porta 8050. Caso seja necessário alterar a porta de acesso, basta editar o arquivo console_web.ini que foi criado no mesmo diretório de execução do assistente.
| label | Assistente de Instalação |
|---|
A ferramenta irá criar toda a estrutura necessária para o funcionamento do Logix.
Funcionamento:
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.
| Nota | ||
|---|---|---|
| ||
Somente o campo Diretório é obrigatório, caso as demais informações não sejam informadas o assistente irá criar um Appserver Master e um Appserver Slave a porta TCP será criada a partir da sequencia 4500 |
Diretório: Informe o diretório de instalação do Logix (rootpath) (Obrigatório)
Quantidade: Quantidade de appservers Slaves que será configurado.
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.
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
Caso esses dados sejam informados, durante o processo de instalação será realizado de forma automática o testdbconnection.
License Server:
Permite informar os dados de conexão com o License Server. Essas informações ficam gravadas dentro do arquivo appserver.ini na sessão LICENSECLIENT
| label | Assistente de Atualização |
|---|
Funcionamento:
Este assistente será utilizado sempre que for liberado uma nova versão do Build Logix 64bits. Desta forma basta selecionar os Appservers que você 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 64Bits
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.
| label | Atualizar 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 64Bits
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.
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.
| Card | ||
|---|---|---|
| ||
Nesta opção são disponibilizados links para downloads de arquivos necessários para o funcionamento do Logix. |
3. 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ído 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 era feito de forma simples, apenas substituindo os atuais arquivos das pastas de TOTVS AppServer e TOTVS SmartClient. 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.
| borderColor | #004C99 |
|---|---|
| titleColor | #FFFFFF |
| titleBGColor | #004C99 |
| title | Menu |
| borderColor | #C0C0C0 |
|---|---|
| titleBGColor | #C0C0C0 |
| title | Requisitos |
Para evitar que estações de trabalho fiquem com o smartclient desatualizado é necessário configurar a atualização automática do smartclient.
Para mais informações sobre a atualização automática do smartclient verifique a seguinte documentação: Application Server - [Update]
| borderColor | #C0C0C0 |
|---|---|
| titleBGColor | #C0C0C0 |
| title | Variáveis de Ambiente |
| borderColor | #008080 |
|---|---|
| titleColor | white |
| titleBGColor | #008080 |
| title | Configurando Variáveis de Ambiente |
| id | variaveis |
|---|
| Card | ||
|---|---|---|
| ||
DBMONEY=, - Define separador decimal para exibição de valores em telas e relatórios. Valores: vírgula(,) ou ponto(.) |
| label | Windows |
|---|
| label | Linux |
|---|
| borderColor | #C0C0C0 |
|---|---|
| titleBGColor | #C0C0C0 |
| title | Banco de Dados |
| borderColor | #008080 |
|---|---|
| titleColor | white |
| titleBGColor | #008080 |
| title | Conexão com o Banco de Dados |
| id | database |
|---|
| Card | ||
|---|---|---|
| ||
O Build Harpia foi desenvolvido sobre a arquitetura 64Bits, desta forma é obrigatório que sejam instalados Clients de conexão com o banco de dados na versão 64Bits. |
| label | Informix |
|---|
Inicie instalando o IBM INFORMIX ODBC DRIVER (64-bit) conforme o sistema operacional. O download pode ser realizado através dos seguintes links:
- Client Informix Windows
- Client Informix Linux
WINDOWS
1- Execute %WinDir%\System32\odbcad32.exe - para acessar a ferramenta Administrador de Fonte de Dados ODBC 64 bits
| Nota | ||
|---|---|---|
| ||
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! |
3- Preencha os demais dados da conexão e valide se a conexão com o banco é realizada corretamente.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”.4- Estabelecida a conexão com o banco de dados é necessário configurar 2 variáveis de ambiente:
INFORMIXDIR - Indica o diretório de instalação do Client Informix, exemplo: C:\Informix64\
PATH - Diretório de instalação do Client Informix + \bin\, exemplo: C:\Informix64\bin
LINUX
Para conectar ao banco de dados é necessário configurar alguns arquivos, o que deverá ser feito como usuário administrador (root).
Pré-requisito
O Informix SDK homologado deve estar instalado na máquina onde está sendo configurada a conexão.
Arquivos 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
[logix12]
Database=logix
Servername=[nome da instância informix: INFORMIXSERVER]
CursorBehavior=1
EnableScrollableCursors=1
FETCHBUFFERSIZE=32767
2- Arquivo SQLHOSTS deve ser configurado no diretório etc do client do Informix (/usr/informix/etc/sqlhosts). Pode ser copiado da instalação do Informix do servidor de banco de dados.
#dbservername nettype hostname servicename
logixprdshm onipcshm 10.0.0.10 logix
logixprdsoc onsoctcp 10.0.0.10 logixsrv
3- Arquivo SERVICES está localizado no diretório "/etc" do servidor (cd /etc).
Editar o arquivo e inserir uma linha com nome do serviço que faz a comunicação com o banco a porta TCP de comunicação. Exemplo
logixsrv 5900/tcp
4- 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 PATH=INFORMIXDIR/bin:$PATH
export LD_LIBRARY_PATH=$INFORMIXDIR/lib:$INFORMIXDIR/lib/cli:$INFORMIXDIR/lib/esql:$LD_LIBRARY_PATH
Observação: Se na execução do instalador do Logix você informou em tela o caminho do client do informix, não há necessidade de realizar esta configuração no arquivo totvsenv.sh.
| label | Oracle |
|---|
Nesta documentação estamos realizando os procedimentos utilizando o Oracle InstantClient, segue abaixo os procedimentos necessários para realizar a conexão do Logix com o banco de dados ORACLE
O download do ORACLE InstantClient, pode ser realizado através dos seguintes links:
- Client Oracle Windows
- Client Oracle Linux
WINDOWS
1- Faça a extração dos dados no diretório que você achar mais adequado, exemplo: c:\oracle\instantclient_21_6
2- Configure o arquivo TNSNAMES.ora para realizar a comunicação com o banco de dados.
| Nota |
|---|
| 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 |
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.
| label | SQL SERVER |
|---|
1- Instale o ODBC Driver 11 para SQL Server, o download pode ser realizado através do seguinte link:
- Client SQL Server
2- Execute %WinDir%\System32\odbcad32.exe - para acessar a ferramenta Administrador de Fonte de Dados ODBC 64 bits
| Nota | ||
|---|---|---|
| ||
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! |
4- Preencha os demais dados da conexão e valide se a conexão com o banco é realizada corretamente.
| label | Teste de Conexão |
|---|
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.
| borderColor | #C0C0C0 |
|---|---|
| titleBGColor | #C0C0C0 |
| title | Licenciamento |
| borderColor | #008080 |
|---|---|
| titleColor | white |
| titleBGColor | #008080 |
| title | License Server Virtual |
| id | License |
|---|
| Card | ||
|---|---|---|
| ||
License Server é um recurso computacional da TOTVS que têm como objetivo realizar o controle das licenças de uso dos softwares e aplicações TOTVS. Através deste recurso é possível prover de forma eficiente e segura as licenças e liberações de utilização de módulos e/ou funcionalidades das aplicações TOTVS em conformidade com o contrato firmado entre o cliente e a TOTVS. |
| label | Documentação |
|---|
Aqui existem algumas orientações de como instalar, configurar e atualizar o build HARPIA para desenvolvimento e uso do produto Logix.
Páginas em construção...
Page Tree
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas