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.

...

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

Orientações gerais referente ao binário Harpia

  1. Introdução
  2. Assistente de Configuração Logix
  3. Requisitos - SO e DB ***
  4. Conceitos Gerais
    1. Estrutura do Logix 
    2. Appserver
    3. Smartclient
  5. Variáveis de Ambiente
  6. Banco de Dados
  7. Licenciamento
  8. Outras configurações - TSS - GRL



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

Painel
borderColor#C0C0C0
titleBGColor#C0C0C0
titleIntrodução

Harpia é o nome do novo binário que será utilizado com o Logix, com o Harpia o Logix estará sendo executado na arquitetura 64Bits oferecendo mais velocidade e robustez para a Linha Logix.

O Harpia traz uma nova forma de controle do repositório de objetos. Agora o Logix irá trabalhar com o conceito de RPOs segregados: um específico para os códigos padrão do sistema e outro para os códigos customizados. Ou seja, as funções de usuário ficarão armazenadas no RPO Custom. Já as funções do sistema estarão no RPO Padrão.

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

Nota
titleImportante

Por ser um novo binário não será possível pegar os arquivos do Harpia e substituir na pasta da atual Build 131227A.
Será necessário criar novos appservers para utilização desta nova arquitetura.

Nota
titleImportante

O arquivo RPO também precisa ser substituído por uma nova versão compilada nesta nova arquitetura.


Visando facilitar este processo de migração para a Build Harpia, esta sendo liberado a ferramenta Assistente de Configuração LOGIX, através desta ferramenta será possível realizar a Instalação, Migração e Atualização da Build Harpia 

Painel
borderColor#C0C0C0
titleBGColor#C0C0C0
titleRequisitos

1- Client de conexão com o banco de dados na versão 64bits. Para mais informações verifique a sessão Banco de Dados.
2- Para um melhor desempenho do sistema, recomendamos a utilização de Smartclient Local. Para evitar problemas com smartclient desatualizado é necessário configurar a atualização automatica.



Â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
** Smartclien Local
** UPDATE automatico smartclient



Painel
borderColor#C0C0C0
titleBGColor#C0C0C0
titleConceitos Gerais


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

DATEZERO=4gl  - Define a data zero para o Logix. Deverá ser sempre igual a "4gl" observando a grafia.
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.
FGLPROFILE=c:\totvs\logix\logixprofile.pro  - Define local e nome do arquivo que contém configurações para o Logix, como labels, teclas de atalho, email, etc.
FGLDBPATH=c:\totvs\logix\schema  - Identifica o diretório do arquivo schema (logix.sch) com layout/definções das tabelas do Logix utilizado na compilação de programas
?? FGLGUI=1  - Indica que os programas serão executados em modo gráfico
?? V4GL=4J3 / V4JS=4J3  - Indica para o Logix o uso de multiplos compiladores 
AMBIENTE=WINDOWS  - Indica para o Totvstec o sistema operacional do Servidor de aplicação. Valores permitidos:  Windows ou Linux.
?? CODCLIPAR=  - Informar o código de cliente Logix para ter acesso aos parâmetros específicos do cliente.
?? LGXDOC= Indica a URL para o Help/Manual online do Logix.
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.
?? SMTP_SERVER=
?? SMTP_USER=
?? SMTP_PASSWORD=
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

...