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




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 e TOTVS Smartclient disponível na arquitetura 64 bits para o Logix é conhecido sob o nome HARPIA e o número de controle de revisão tem como prefixo 20.3.1.xx, sendo xx um número incremental a cada nova revisão liberada oficialmente no portal Totvs.

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

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



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

           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, ou seja:

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>&nbsp;&nbsp;bem como <strong><mark style="background-color:#1bced3;">facilitar a atualização dos ambientes e futuros releases</mark> </strong>.<br>


 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.


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



Painel
borderColor#004C99
titleColor#FFFFFF
titleBGColor#004C99
titleMenu




Âncora
2.Assistente
2.Assistente

Painel
borderColor#C0C0C0
titleBGColor#C0C0C0
titleAssistente de Configuração Logix

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 seguintes atividades:
Instalação
Atualização
Ajustes appserver.ini
Downloads

Painel
borderColor#008080
titleColorwhite
titleBGColor#008080
titleSobre o Assistente
Deck of Cards
idSobre
Card
labelSobre o Assitente

A ferramenta pode ser utilizada em ambientes Windows e Linux e deve ser executada no servidor onde será realizada a instalação do Logix.
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.

Card
labelAssistente de Instalação

Esta opção deve ser utilizada em situações onde se deseja realizar uma nova instalação do Logix.
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
titleObservação

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


Parâmetros de Instalação:
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


Card
labelAssistente de Atualização

Assistente utilizado para realizar a atualização do binário 64bits.

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.

Card
labelAtualizar appserver.ini

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

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

Painel
borderColor#C0C0C0
titleBGColor#C0C0C0
titleRequisitos

O smartclient também foi atualizado para a versão 64Bits e visando um melhor desempenho recomendamos que seja utilizado smartclient local nas estações de trabalho.
Para evitar que estações de trabalho fiquem com o smartclient desatualizado é necessário configurar a atualização automática do smartclient.

Para mais informações sobre a atualização automática do smartclient verifique a seguinte documentação: Application Server - [Update]




Painel
borderColor#C0C0C0
titleBGColor#C0C0C0
titleVariáveis de Ambiente
Painel
borderColor#008080
titleColorwhite
titleBGColor#008080
titleConfigurando Variáveis de Ambiente
Deck of Cards
idvariaveis
Card
labelVariáveis

DBMONEY=,  - Define separador decimal para exibição de valores em telas e relatórios. Valores:  vírgula(,) ou ponto(.)
DBDATE=dmy4/  - Define formato de data para exibição em telas e relatórios. 
DBCENTURY=C  - Define o século corrente para complementar quando é digitado somente s dois dígitos do ano.
CLASSPATH=c:\totvs\logix\lib\activation.jar:c:\totvs\....  - Define o caminho das bibliotecas necessárias para os serviços de boleto bancário, relatório em PDF, NF-e, etc.
LGXGR=http://ip_servidor_tomcat:8080  - Indica a URL e porta do serviço TomCat para o Gerenciador de Relatórios.
LGXBI=http://ip_servidor_tomcat:8080/bi  - Indica a URL e porta do serviço TomCat para o Logix BI.
PROXY_NFE=ip_servidor_tss:portaTCP  - Indica o servidor onde está instalado o TSS e porta TCP (configurada no arquivo appserver.ini do tss) para comunicação com o Logix.

Card
labelWindows


Card
labelLinux


Painel
borderColor#C0C0C0
titleBGColor#C0C0C0
titleBanco de Dados
Painel
borderColor#008080
titleColorwhite
titleBGColor#008080
titleConexão com o Banco de Dados
Deck of Cards
iddatabase
Card
labelIntrodução

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.
Nesta sessão estaremos apresentando o procedimento de conexão com os 3 bancos de dados homologados para serem utilizados com o Logix.

Card
labelInformix

Segue abaixo os procedimentos necessários para realizar a conexão do Logix com o banco de dados 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
titleAtenção

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


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

Card
labelOracle

Para o banco de dados ORACLE você pode realizar a instalação do Oracle Client Runtime ou utilizar o Oracle InstantClient

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


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.  

Card
labelSQL SERVER

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

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
titleAtenção

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- Entre na opção DSN de Sistema ou Fonte de Dados de Sistema, clique em Adicionar e selecione Driver ODBC Driver 11 for SQL Server



4- Preencha os demais dados da conexão e valide se a conexão com o banco é realizada corretamente.

Card
labelTeste 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.


Painel
borderColor#C0C0C0
titleBGColor#C0C0C0
titleLicenciamento
Painel
borderColor#008080
titleColorwhite
titleBGColor#008080
titleLicense Server Virtual
Deck of Cards
idLicense
Card
labelSobre

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.

Card
labelDocumentação

Incluir Página
framework:TOTVS License Server Virtual
framework:TOTVS License Server Virtual


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
rootLGX - Build HARPIA
searchBoxtrue