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.

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.

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

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.

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.

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

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.

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.

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

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.

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.    

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.

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.  

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

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.

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.

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.