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:

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

Monitor de Conexões no TOTVS AppServer

TOTVS Monitor (totvsmonitor.exe)

TOTVS Monitor Electron
ou
TDS-VSCode (Monitor)

3. O que há de novo?

O nome dos binários mudou para o produto Logix .
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.

O 🎯 OBJETIVO é melhorar a organização dos RPOs utilizados pelo ambiente , bem como facilitar a atualização dos ambientes e futuros releases .

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?

Clique AQUI para visualizar sobre compilação via linha de comando

DISPONÍVEL A PARTIR DA VERSÃO 17.3.0.9

Ferramenta de compilação por linha de comando embutida no AppServer para acesso e manipulação de recursos relacionados a compilação, geração e aplicação de patch, defrag de rpo e etc.

Principais características:

Não tem comunicação cliente/server TCP, os comandos são executados diretamente no AppServer.
Ambiente simples que necessita apenas do appre, binário do appserver e arquivo de configuração "appserver.ini".
Compilação mais rápida.
Suporte a atual chave de compilação utilizada pelo TDS e TDSCli.
Chave de compilação para Linux utilizando criptografia AES 256bits.
Compatível com Sistemas Operacionais Windows e Linux.

Compilação

Parâmetros:

Nome	Descrição	Obrigatório
-compile	Necessário para inicialização da ferramenta	Sim
-files	Informa quais fontes serão compilados podendo ser informado das seguintes formas: Arquivo Lst Pastas (Diretórios e sub-diretórios). Obs: O que não é programa será compilado como resource. Arquivo único (fonte ou resource).	Sim
-includes	Informa o diretório de includes usado durante a o pré-processamento dos fontes.	Sim
-src
-env	Informa o ambiente que deverá ser acessado para compilação.	Sim
-nodelfiles	Utilizado para debug, caso informado, não deleta os arquivos gerados durante o pré-processamento e também mantem os arquivos temporários .Lst gerados durante o processo.	Não
-authorization	Informa a chave de compilação no formato de arquivo .aut, padrão TDS / TDSCli ou, o token de compilação no formato de arquivo .token, no padrão JWT.	Não	A PARTIR DA VERSÃO 20.3.2.0, NÃO SERÁ MAIS UTILIZADA A AUTORIZAÇÃO DA CHAVE DE COMPILAÇÃO.
-outreport	Gera os arquivos compile_sucess.log, que contem a lista de fontes compilados com sucesso no formato do arquivo .lst, e compile_errors.log, que contem a lista de fontes não compilados e os erros de compilação. A partir da versão 17.3.0.19, também é possível definir o diretório de saída para esses arquivos.	Não	DISPONÍVEL A PARTIR DA VERSÃO 17.3.0.15

Arquivo .Lst:

Tipo de arquivo com extensão .lst que pode conter uma lista de fontes e resources no formato de path absoluto, ou diretórios para compilação. Quando houverem diretórios, um novo arquivo .lst temporário com prefixo _generated será gerado para a extração dos arquivos contidos no diretório informado, compondo assim uma nova lista de arquivos a serem compilados. Por meio do parâmetro nodelfiles, é possível manter também esses arquivos temporários para análise.

O conteúdo do arquivo deverá respeitar as seguintes regras:

Usar separador ' ; '
Todos caminhos de arquivos ou diretórios devem ser inseridos em uma única linha com separador no final.

Veja o exemplo de arquivo anexado: exemplo.lst

Exemplos:

appserver.exe -compile -files=D:\totvs\lobo-guara\cmdline\teste.prw -includes=C:\totvs\lobo-guara\Include -src=D:\totvs\lobo-guara\cmdline -env=environment

appserver.exe -compile -files=D:\totvs\lobo-guara\cmdline -includes=C:\totvs\lobo-guara\Include -src=D:\totvs\lobo-guara\cmdline-env=environment

appserver.exe -compile -files=D:\totvs\lobo-guara\cmdline\lista.lst -includes=C:\totvs\lobo-guara\Include -src=D:\totvs\lobo-guara\cmdline -env=environment

Chave de compilação:

Observação:

A partir da versão 20.3.2.0, os recursos de geração e de autenticação por meio de uma chave de compilação foram descontinuados. Será utilizado somente o token de compilação.

Compatível com a chave de compilação gerada e utilizada no TDS e TDSCli. Para a utilização da ferramenta Compile, é preciso exportar as informações de uma nova ou já existente chave criando um arquivo com extensão .aut. No Linux, é utilizado o mesmo padrão de criação de chave realizando o controle pelo UUID do disco porem, a chave é criada e criptografada utilizando algoritmo AES 256bits.

Exemplos:

Windows

[AUTHORIZATION]
ID=FA15-EB7C
GENERATION=12/02/2019
VALIDATION=13/05/2019
PERMISSION=1
KEY=042MQC032QYIQ74A1E7671302

Baixar exemplo.

Linux

[AUTHORIZATION]
ID=d40f3aa2-d5ae-4a0b-a0f5-a44e29bcd344
GENERATION=20/02/2019
VALIDATION=21/05/2019
PERMISSION=1
KEY=gjvqs3U7vInn/VcX9Hl0Av2is+mLrr4j/BxHMdyR7uPaOcQC7OVtTIWhIMU0/5AkfipUxQukozs121WVNafNyQ==

Baixar exemplo.

Para criação de uma nova chave no Linux, será necessário a coleta do UUID onde a ferramenta está instalada e posteriormente entrar em contato com a Tecnologia - AppServer.

Comando para obtenção do UUID no linux:

./appsrvlinux -compile -uuid

Geração de Patch:

Recurso para geração de path. Por default, os patchs serão gerados na pasta "cmdgenpatch" dentro do Environment.

Parâmetros:

Nome	Descrição	Obrigatório
-compile	Necessário para inicialização da ferramenta	Sim
-genpatch	Indica geração de Patch	Sim
-files	Informa os programas que irão compor o patch da seguinte forma: Arquivo .lst contendo os programas que deverão compor o Patch. Neste arquivo, apenas os nomes dos programas respeitando: Usar separador ' ; ' Todos nomes de programas devem ser inseridos em uma unica linha com separador no final. Um único nome de programa ou mais, separados por ";"	Sim
-env	Informa o ambiente que deverá ser acessado para compilação.	Sim
-patchtype	Extensão de patch: ptm, upd ou pak. Por default, é gerado com extensão ptm.	Não
-outgenpatch	Permite a definição de um diretório de output.	Não	DISPONÍVEL A PARTIR DA VERSÃO 17.3.0.19

Exemplos:

appserver.exe -compile -genpatch -files=D:\totvs\lobo-guara\sources\mainfunc.prw -env=environment -patchtype=ptm

appserver.exe -compile -genpatch -files=D:\totvs\lobo-guara\sources\mainfunc.prw;teste.prw -env=environment -patchtype=ptm

appserver.exe -compile -genpatch -files=D:\totvs\lobo-guara\patch.lst -env=environment -patchtype=ptm

appserver.exe -compile -genpatch -files=D:\totvs\lobo-guara\patch.lst -env=environment -patchtype=ptm -outgenpatch=d:\patchs\teste1

Validação de Patch DISPONÍVEL A PARTIR DA VERSÃO 17.3.0.20

Este recurso permite ao desenvolvedor adicionar uma etapa de verificação do Patch antes de aplicá-lo. O resultado dessa verificação pode ser armazenado em um arquivo Log e analisado posteriormente.

Parâmetros:

Nome	Descrição	Obrigatório
-compile	Necessário para inicialização da ferramenta	Sim
-validatePatch	Indica Validação de Patch	Sim
-files	Informa o patch a ser aplicado com extensão ("PTM", "UPD" E "PAK").	Sim
-env	Informa o ambiente que deverá ser acessado para compilação.	Sim
-outreport	Gera o arquivo patch_errors.log contendo o resultado da verificação de patch. Também é possível definir o diretório de saída para esse arquivo.	Não

Exemplo:

appserver.exe -compile -validatepatch -files=D:\totvs\patch\tttp120.ptm -env=advplc -outreport

Aplicação de Patch

Recurso para aplicação de Patch.

Parâmetros:

Nome	Descrição	Obrigatório
-compile	Necessário para inicialização da ferramenta	Sim
-applypatch	Indica aplicação de Patch	Sim
-files	Informa o patch a ser aplicado com extensão ("PTM", "UPD" E "PAK").	Sim
-env	Informa o ambiente que deverá ser acessado para compilação.	Sim
-applyoldprogram	Informa que serão aceitos fontes mais antigos que o RPO. Por default, aceita somente os fontes mais novos.	Não
-cbfiles	Interno. Não é possível utilizar sem o token interno da TOTVS.	Não	DISPONÍVEL A PARTIR DA VERSÃO 20.3.1.3

Exemplo:

appserver.exe -compile -applypatch -files=D:\totvs\patch\tttp120.ptm -env=advplc -applyoldprogram

Desfragmentação RPO DISPONÍVEL A PARTIR DA VERSÃO 17.3.0.15

Recurso DefragRPO para desfragmentação de RPO.

Parâmetros:

Nome	Descrição	Obrigatório
-compile	Inicialização da ferramenta.	Sim
-defragrpo	Indica desfragmentação de RPO.	Sim
-env	Informa o ambiente que deverá ser desfragmentado.	Sim

Exemplo:

appserver.exe -console -compile -defragrpo -env=advplc

Inspetor de Objetos DISPONÍVEL A PARTIR DA VERSÃO 20.3.0.0

Realiza a inspeção de objetos (Fontes e recursos) no RPO de acordo com as regras de acesso: com token de autorização faz a inspeção no RPO default e sem token, faz a inspeção no RPO Custom.

Por padrão, serão retornadas informações sobre "Resources" e "Sources", mas também é possível aplicar filtros para selecionar as informações desejadas.

Importante:

SourceStatus	Descrição
0	No Status (No Authorization)
1	Production
2	Development

RpoType	Descrição
1	Padrão
2	TLPP
3	Custom
4	Auxiliar

Parâmetros:

Nome	Descrição	Obrigatório
-compile	Inicialização da ferramenta.	Sim
-inspectorobjects	inspetor de Objetos	Sim
-env	Informa o ambiente	Sim
-applyField	Indica se a pesquisa deverá ser feita considerando apenas "Resources" ou "Sources". Por exemplo -applyField=sources. Por padrão retornará Sources e Resources.	Não
-authorization	Indica o token de compilação que irá selecionar o RPO a ser inspecionado. Caso não seja informado, o RPO Custom será selecionado por padrão.	Não
-outputdir	Define o diretório de saída para o arquivo no formato txt que contêm as informações coletadas. O diretório padrão é a pasta cmdoutpudir dentro do RoothPath. Também é possível alterar o diretório de saída para esse arquivo informando outro diretório. Por exemplo: -outputdir=c:\totvs\outrodir	Não
-outreport	Gera o arquivo inspectorobjects_erros.log. Por padrão, o diretório de saída do arquivo é na pasta cmdreport dentro do RootPath. Também é possível alterar o path de saída do arquivo indicando outro diretório. Por exemplo: -outreport=c:\totvs\report.	Não

Exemplo:

./appserver -compile -inspectorobjects -env=test -outputdir=c:\tmp\inspector -outreport=c:\tmp\inspector\logs

Exemplo listando apenas Resources:

./appserver -compile -inspectorobjects -env=test -applyField=resources -outputdir=c:\tmp\inspector -outreport=c:\tmp\inspector\logs

Exemplo listando apenas Sources:

./appserver -compile -inspectorobjects -env=test -applyField=sources -outputdir=c:\tmp\inspector -outreport=c:\tmp\inspector\logs

Exemplo listando fontes e recursos com token de compilação

./appserver -compile -inspectorobjects -env=test -outputdir=c:\tmp\inspector -outreport=c:\tmp\inspector\logs -authorization=c:\tmp\development.token

Inspetor de Funções DISPONÍVEL A PARTIR DA VERSÃO 20.3.0.0

Realiza a inspeção de Funções (Funções, Classes e Métodos) no RPO de acordo com as regras de acesso: com token de autorização faz a inspeção no RPO default e sem token, faz a inspeção no RPO Custom.

Por padrão, serão retornadas informações sobre "Funções", "Classes" e "Métodos", mas também é possível aplicar filtros para selecionar as informações desejadas.

Importante:

SourceStatus	Descrição
0	No Status (No Authorization)
1	Production
2	Development

RpoType	Descrição
1	Padrão
2	TLPP
3	Custom
4	Auxiliar

Parâmetros:

Nome	Descrição	Obrigatório
-compile	Inicialização da ferramenta.	Sim
-inspectorfunctions	inspetor de Funções	Sim
-env	Informa o ambiente	Sim
-applyField	Indica se a pesquisa deverá ser feita considerando apenas "Functions" ou "ClassMethods". Por exemplo -applyField=functions. Por padrão retornará Functions, Class e Methods.	Não
-authorization	Indica o token de compilação que irá selecionar o RPO a ser inspecionado. Caso não seja informado, o RPO Custom será selecionado por padrão.	Não
-outputdir	Define o diretório de saída para o arquivo no formato txt que contêm as informações coletadas. O diretório padrão é a pasta cmdoutpudir dentro do RoothPath. Também é possível alterar o diretório de saída para esse arquivo informando outro diretório. Por exemplo: -outputdir=c:\totvs\outrodir	Não
-outreport	Gera o arquivo inspectorfunctions_erros.log. Por padrão, o diretório de saída do arquivo é na pasta cmdreport dentro do RootPath. Também é possível alterar o path de saída do arquivo indicando outro diretório. Por exemplo: -outreport=c:\totvs\report.	Não

Exemplo:

./appserver -compile -inspectorfunctions -env=test -outputdir=c:\tmp\inspector -outreport=c:\tmp\inspector\logs

Exemplo listando apenas Functions:

./appserver -compile -inspectorfunctions -env=test -applyField=functions -outputdir=c:\tmp\inspector -outreport=c:\tmp\inspector\logs

Exemplo listando apenas Classes e Metódos:

./appserver -compile -inspectorfunctions -env=test -applyField=classmethods -outputdir=c:\tmp\inspector -outreport=c:\tmp\inspector\logs

Exemplo listando funções, classes e métodos com token de compilação

./appserver -compile -inspectorfunctions -env=test -outputdir=c:\tmp\inspector -outreport=c:\tmp\inspector\logs -authorization=c:\tmp\development.token

Clique AQUI para visualizar sobre execução via linha de comando

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.

Clique AQUI para saber mais sobre o Assistente de Configuração Logix

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

Clique AQUI para visualizar algumas orientações de configuração para AppServer 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.

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

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

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

Clique AQUI para saber

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

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

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.

Clique AQUI para visualizar algumas orientações IMPORTANTES a respeito do uso do SmartClient a partir do Build 20.3.1.x

É 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

Clique AQUI para visualizar a lista de variáveis de ambiente necessárias para o Logix (Independente do banco de dados conectado)...

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. Na variável de ambiente PATH também deverá constar a subpasta BIN de instalação desta instalação Java.	Execução de aplicações desenvolvidas em Java acionadas a partir do Logix.
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. Para build Harpia é preciso adicionar a pasta raiz do Application Server na variável de ambiente LD_LIBRARY_PATH devido a novas bibliotecas, arquivos com extensão .so, disponibilizados juntamente com o binário e utilizados na inicialização do Application Server em ambiente Linux.	Application Server

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

Clique AQUI para visualizar as configurações necessárias para as conexões de Banco de Dados...

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 Free Check Mark SVG, PNG Icon, Symbol. Download Image.
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 = ,.

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.

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.

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.

Configurações

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

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

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

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

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
-u	Identificação do usuário de conexão ao banco de dados. ATENÇÃO! Informe um usuário com permissão de administrador no Banco de Dados.	Login do usuário no banco de dados
-p	Identificação da senha do usuário de conexão ao banco de dados.	Senha do usuário no banco de dados
-d	Identificação do tipo do banco de dados. Valores possíveis para o 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

Como instalar o AppServer como serviço do Windows

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