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

Versões comparadas

Chave

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


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











Informações
iconfalse

Índice
minLevel2



Page Tree
rootLGX - Build HARPIA

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



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

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

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


2. O que 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 CustomPara mais detalhes acesse Application Server - RPOs Segregados.


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


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

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

Assistente de Configuração



O Assistente de Configuração tem como objetivo facilitar o processo de instalação e configuração do Logix.


Através desta ferramenta será possível realizar as operações a seguir:


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

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

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



ATENÇÃO! Somente o campo Diretório é OBRIGATÓRIO.
Caso as demais informações não sejam informadas, o assistente irá criar os AppServers necessários onde a porta TCP será criada a partir da sequência 4500


Totvs custom tabs box items
defaultno
referenciapg2

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

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

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

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

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

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

Losango - ícones de formas grátis Banco de dados:  Permite informar os parâmetros de conexão com o banco de dados.    Quando informados, durante o processo de instalação irá configurar as conexões de banco de dados automaticamente usando a ferramenta disponível na pasta do AppServer chamada testdbconnection.  
         Para mais detalhes sobre a ferramenta testdbconnection acesse DBAccess Logix - Como Fazer

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


Totvs custom tabs box items
defaultno
referenciapg3

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

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


Totvs custom tabs box items
defaultno
referenciapg4

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

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

Losango - ícones de formas grátis  Parâmetros de Atualização
                 Diretório 64Bits:  Informe o diretório (rootpath) do Logix 64 bits.
                 Excluir arquivos de configuração ao final do processamento?  Indica se os arquivos serão excluídos da pasta workspace.



  Ao clicar em Localizar, será apresentada uma lista com os appservers localizados do diretório informado. Selecione os diretórios que você deseja atualizar e clique em Iniciar Processamento.


Totvs custom tabs box items
defaultno
referenciapg5

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

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

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



Ao clicar em Localizar, será apresentada uma lista dos arquivos appserver.ini localizados do diretório informado. Selecione os arquivos que você deseja atualizar e clique em Iniciar Processamento.


Totvs custom tabs box items
defaultno
referenciapg6

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



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 é 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  é 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 "A
tualizaçã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]

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

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

Variáveis de Ambiente Logix



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.


Variável ConteúdoDescrição
DBMONEY,Define separador decimal para exibição de valores em telas e relatórios. Valores:  vírgula(,) ou ponto(.)
DBDATEdmy4/Define formato de data para exibição em telas e relatórios. 
DBCENTURYCDefine o século corrente para complementar quando é digitado somente dois dígitos do ano em campos do tipo data.
CLASSPATHc:\totvs\logix\lib\activation.jar;c:\totvs\logix\lib\imap.jar; <.....outras....>Define o caminho das bibliotecas necessárias para os serviços de boleto bancário, relatório em PDF, NF-e, etc.
LGXGRhttp://[IP-servidor-TOMCAT-GRL]:[porta-serviço-TOMCAT]Indica o endereço URL de acesso para a ferramenta GRL (Gerenciador de Relatórios Logix), quando estiver em uso, que é disponibilizada via serviço da ferramenta Apache TOMCAT.
Para mais detalhes acesse 
LGXBIhttp://[IP-servidor-TOMCAT-BI]:[porta-serviço-TOMCAT]Indica o enderço URL de acesso a ferramenta Logix BI, quando estiver em uso. 
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.




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

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

Conexão com Banco de Dados


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.


Totvs custom tabs box
tabsInformix, Oracle, Microsoft SQLServer, Teste de conexão
idsdb1,db2,db3,db4
Totvs custom tabs box items
defaultyes
referenciadb1

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


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


Totvs custom tabs box
tabsLINUX, WINDOWS
idsso1,so2
Totvs custom tabs box items
defaultyes
referenciaso1

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


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


Losango - ícones de formas grátis Pré-requisito
         O Informix SDK homologado deve estar instalado na máquina onde está sendo configurada a conexão.


Losango - ícones de formas grátisArquivos 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:

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


2. Arquivo SQLHOSTS localizado na pasta /etc do Client SDK Informix (cd $INFORMIXDIR/etc/sqlhosts).

Bloco de código
languagegroovy
themeConfluence
#dbservername    nettype     hostname   servicename
logixprdshm      onipcshm    10.0.0.10  logix
logixprdsoc      onsoctcp    10.0.0.10  logixsrv

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

   
4. Arquivo totvsenv.sh localizado na pasta de instalação dos TOTVS AppServers (/totvs/logix64/bin).

    Edite o arquivo e insira as seguintes variáveis no final do arquivo:

Bloco de código
languagegroovy
themeConfluence
export INFORMIXDIR=[diretório de instalação do informix SDK]
export PATH=INFORMIXDIR/bin:$PATH
export LD_LIBRARY_PATH=$INFORMIXDIR/lib:$INFORMIXDIR/lib/cli:$INFORMIXDIR/lib/esql:$LD_LIBRARY_PATH

    
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.    


Totvs custom tabs box items
defaultno
referenciaso2

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!


2- Entre na opção DSN de Sistema ou Fonte de Dados de Sistema, clique em Adicionar e selecione Driver IBM INFORMIX ODBC DRIVER (64-bit)



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







Totvs custom tabs box items
defaultno
referenciadb2

Para o banco de dados ORACLE você pode instalar a ferramenta para conexão com o banco chamada Oracle Client Runtime ou Oracle InstantClient.

Abaixo estão descritos os procedimentos para a ferramenta Oracle InstantClient para realizar a conexão do banco Logix em 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.

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.  

Totvs custom tabs box items
defaultno
referenciadb3

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

1. Instale o driver ODBC Driver for SQL Server na versão 64 bitsSEMPRE respeitando a versão mais recente deste driver e compatível com a versão do banco a ser conectado. Acesse a página de download oficial do driver ODBC para Microsoft SQLServer AQUI.


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


3. Entre na opção DSN de Sistema (Fonte de Dados de Sistema), clique em  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.



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


Totvs custom tabs box items
defaultno
referenciadb4

Para 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 LogixInformixOracle 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.



Licenciamento

Expandir
titleClique AQUI para visualizar as configurações relacionadas a configuração do Controle de Licenças...
framework:TOTVS License Server Virtual.

Painel
borderColor#C0C0C0

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

Incluir Página
framework:TOTVS License Server Virtual

Templatedocumentos

HTML
<script>
AJS.toInit(function () {
  // 55 px is collapsed state
  if (AJS.$("div.ia-fixed-sidebar").width() != 55) {
    AJS.$("a.expand-collapse-trigger").click();
  }
});
</script>