Histórico da Página

Este documento

...

centraliza os processos necessários para realizar a instalação do TOTVS Agro API Hub em ambientes Windows.

O TOTVS Agro API Hub é compatível com a versão 12.1.2412 ou superior do TOTVS Agro Bioenergia.

Totvs custom tabs box

tabs	1 - Requisitos, 2 - Download, 3 - Processo de Instalação, 4 - Orientações e FAQ - TOTVS Agro API HUB
ids	REQUISITOS,DOWNLOADS,INSTALADOR,FAQ

Banco de Dados

PostgreSQL 15
- Permissão de Banco
  - GRANT CONNECT ON DATABASE <NOME_DO_BANCO> TO <NOME_DO_USUARIO>;,
  - GRANT CREATE, USAGE ON SCHEMA <NOME_DO_SCHEMA> TO <NOME_DO_USUARIO>;,
  - GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA <NOME_DO_SCHEMA> TO <NOME_DO_USUARIO>;,
  - ALTER DEFAULT PRIVILEGES IN SCHEMA <NOME_DO_SCHEMA> GRANT ALL ON TABLES TO <NOME_DO_USUARIO>;,
  - GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA <NOME_DO_SCHEMA> TO <NOME_DO_USUARIO>;,
  - ALTER DEFAULT PRIVILEGES IN SCHEMA <NOME_DO_SCHEMA> GRANT ALL ON SEQUENCES TO <NOME_DO_USUARIO>;,
  - ALTER DEFAULT PRIVILEGES IN SCHEMA <NOME_DO_SCHEMA> GRANT ALL ON FUNCTIONS TO <NOME_DO_USUARIO>;

⚠️ Base de Dados do Produto: Versão mínima requirida do banco de dados Oracle 12c, ou superior
- Permissão de Banco
  - GRANT CONNECT TO "NOME_OWNER";
  - GRANT RESOURCE TO "NOME_OWNER";
  - GRANT UNLIMITED TABLESPACE TO "NOME_OWNER";
  - GRANT CREATE SYNONYM TO "NOME_OWNER";
  - GRANT CREATE VIEW TO "NOME_OWNER";
  - GRANT CREATE PROCEDURE TO "NOME_OWNER";
  - GRANT CREATE TRIGGER TO "NOME_OWNER";
  - GRANT CREATE SEQUENCE TO "NOME_OWNER";
  - GRANT CREATE MATERIALIZED VIEW TO "NOME_OWNER
  - GRANT CREATE ANY TABLE TO ""NOME_OWNER";
  - GRANT ALTER ANY TABLE TO "NOME_OWNER";
  - GRANT INSERT ANY TABLE TO "NOME_OWNER";
  - GRANT UPDATE ANY TABLE TO "NOME_OWNER";
  - GRANT DELETE ANY TABLE TO "NOME_OWNER";
  - GRANT SELECT ANY TABLE TO "NOME_OWNER";
  - GRANT CREATE ANY TRIGGER TO "NOME_OWNER";

Acesso à internet (com acesso liberado ao endereço http://engenharia.agro.totvs.com.br:8080/*)

Comunicação entre os ambientes do TOTVS Agro API Hub e bases de dados de outros produtos (por exemplo, TOTVS Agro Bioenergia, com compatibilidade com Oracle);

Caso exista bloqueio/restrição na rede, baseado em whitelist, adicionar os hosts na máquina em que o TOTVS Agro API Hub será instalado:

https://tcserver-supplyagro.totvs.app/

http://engenharia.agro.totvs.com.br:8080/*

https://agro.totvs.app/*

Liberações de IPs do TOTVS iPaaS

https://tdn.totvs.com/display/public/IPAAS/TOTVS+iPaaS+%7C+Lista+de+IPs

Requisitos de Hardware

Recomendado (Equivalente ou superior): CPU Intel® Xeon® Gold 5415+ Processor (22.5M Cache, 2.90 GHz) / 4 vCPU

Recomendado (inicial): 12 GB de RAM disponível (somente para TOTVS Agro API Hub + PostgreSQL);

Recomendado: 30 GB espaço em disco disponível (somente para TOTVS Agro API Hub + PostgreSQL);

Observações de instalação (ambiente/infraestrutura)

Os requisitos de hardware (memória RAM e espaço em disco) podem ser superiores aos inicialmente recomendados, devido ao volume de dados monitorado/integrado entre as aplicações que estão sendo integradas por ele (para isto, será necessário monitorar e validar a necessidade de subida destes requisitos durante uma homologação);
Na instalação, os componentes/serviços do TOTVS API Hub devem estar o mais próximo das bases de dados de Oracle/Bioenergia, reduzindo assim questões de latência e/ou instabilidade com a base de dados monitorada/sincronizada;
Também recomendamos a separação entre ambiente/infraestrutura de TOTVS Agro API Hub e demais aplicações (por exemplo, TOTVS Agro Bioenergia, TOTVS Agro PIMSServer e/ou TOTVS Agro Portal Agrícola) - desta forma, seguir a recomendação mencionada no quadro "Infraestrutura e ambientes" (abaixo);
A latência (ping) entre ambiente de instalação dos componentes/serviços do TOTVS Agro API Hub e as bases de dados deve ser inferior aos valores recomendados (em milissegundos);
- "<= 3 ms": Uso de "ping" via comando "ping HOSTNAME";
  - Importante: O teste de ping não reflete diretamente na latência durante a comunicação com o banco de dados, mas sim na indicação geral da conectividade/latência entre cliente e servidor de banco de dados.
- "<= 3 ms": Uso de "tnsping" via comando "tnsping SERVICE_NAME";
  - Importante: O teste com tnsping não reflete diretamente na latência durante a comunicação com o banco de dados, mas sim para testar a latência na resolução de nomes de serviço e na conexão inicial com o banco de dados Oracle.
A latência durante as operações de banco de dados entre ambiente de instalação dos componentes/serviços do TOTVS Agro API Hub e as bases de dados deve ser inferior aos valores recomendados
- "<= 1 ms": Para execução de consultas simples, como exemplo:
  - Oracle: "SELECT 1 FROM DUAL"

Totvs custom tabs box items

default	yes
referencia	REQUISITOS

Informações

title	Requisitos recomendados

Esta página apresenta os requisitos recomendados para uma instalação e configuração padrões.

⚠️ Como TOTVS Agro API Hub é uma plataforma de comunicação com TOTVS Agro Bioenergia, tais requisitos podem ser revistos e sinalizados aos clientes, a qualquer momento, pois seu uso (TOTVS Agro API Hub) tem relação com volume de dados e poder computacional necessário para chamadas HTTP/REST.

Informações

title	Infraestrutura e ambientes

Recomenda-se a separação entre ambiente/servidor (TOTVS Agro API Hub) - com seus componentes (por exemplo, PostgreSQL) e ambientes/servidores das demais soluções/ferramentas TOTVS Agro que farão uso da plataforma.

Por exemplo:

1 ambiente/servidor para TOTVS Agro API Hub + 1 ambiente/servidor para TOTVS Agro Bioenergia (avaliar requisitos recomendados separados); ou
1 ambiente/servidor para TOTVS Agro API Hub + 1 ambiente/servidor para TOTVS Agro PIMSServer (avaliar requisitos recomendados separados);

* Em situações específicas (desde que alinhado com time TOTVS Agro), tais ambientes/servidores podem ser unificados, desde que os requisitos separados sejam atendidos em sua totalidade. Importante mencionar que a separação física/lógica destes ambientes/servidores otimiza aspectos de análise, investigação, disponibilidade e otimização de configurações.

Aviso

title	Compatibilidade com o TOTVS Agro Bioenergia

Arquitetura e Tecnologia - TOTVS Agro API Hub

Totvs custom tabs box items

default	no
referencia	DOWNLOADS

O pacote do instalador do TOTVS Agro API Hub está disponível na Central de Download da TOTVS, o modo de instalação silencioso e gráfico está disponível a partir da Release 12.1.2512.

O instalador do TOTVS Agro API Hub está disponível no servidor de Downloads da Engenharia Agro e pode ser acessado por meio da URL abaixo:

http://engenharia.agro.totvs.com.br:8080/download/ta-api-hub-installer.zip

Os dados de acesso ao servidor devem ser solicitados por meio da abertura de um chamado na Central de Atendimento da TOTVS, disponível em: https://suporte.totvs.com/

totvs

Totvs custom tabs box items

default	no
referencia	DOWNLOADS

totvs-custom-tabs-box-items

default	no
referencia	INSTALADOR

Descompacte o arquivo ta-api-hub-installer.zip e mova seu conteúdo para uma pasta com um nome sugestivo, como C:\

TOTVS

-

Agro

\

API

-HUB.

Execute o arquivo install.bat como administrador, pois o processo exige permissão para criação de um serviço do Windows.

Image Removed

A primeira tela exibirá uma solicitação de confirmação para iniciar o processo de instalação. Caso esteja de acordo, pressione Enter para dar continuidade à instalação.

Image Removed

Informe o nome da instância do serviço do TOTVS Agro API

Hub

Exemplo: Nome do Cliente - PRD
- Sugestão: Producao/Homologacao. Na nomenclatura, não deve conter acentos, caracteres especiais ou espaços.

Image Removed

Informe o IP do serviço do TOTVS Agro API HubDefault: 127.0.0.1

Insira o IP do servidor onde o serviço estará acessível.

Usar localhostrestringirá o acesso apenas à máquina local.

- Image Removed
- Informe a porta do serviço do TOTVS Agro API Hub
  - Default: 8080
  - Escolha uma porta disponível no servidor

Image Removed

- Informe o código do banco de dados do TOTVS Agro API Hub
  - Valor: 1
    - Atualmente, o API Hub está disponível apenas para PostgreSQL.

- Image Removed
- Informe a string de conexão JDBC da base do TOTVS Agro API Hub
  - Exemplo: jdbc:postgresql://IP_DO_BANCO:PORTA/NOME_DO_BANCO

Image Removed

- Informe o usuário com permissão para conexão e uso da base de dados do API Hub (Postgres).

- Image Removed
- Informe a senha com permissão para conexão e uso da base de dados do API Hub (Postgres).

- Image Removed
- Dados de conexão com o banco Oracle do TOTVS Agro Bioenergia
  - String de conexão JDBC modelo SID: Exemplo: jdbc:oracle:thin:@127.0.0.1:1521:ORCL
  - String de conexão JDBC modelo Services Name: Exemplo: jdbc:oracle:thin:@//127.0.0.1:1521/ORCL

Image Removed

- Informe o usuário com permissão para conexão e uso da base de dados do Produto (Oracle)

Image Removed

- Informe a senha com permissão para conexão e uso da base de dados do Produto (Oracle).

Image Removed

- - Informe a instância padrão utilizado no produto BIOENERGIA

- - - Informar a instância padrão do produto

Image Removed

- Informe se deseja incluir a integração com o TOTVS Agro Middleware
  - Esta opção deve ser utilizada apenas quando houver integração com o aplicativo TOTVS Agro Middleware.

Image Removed

- Tela de conclusão do processo de instalação do TOTVS Agro API Hub

Image Removed

Para verificar se a aplicação foi instalada com sucesso, acesse a URL http://IP_API_HUB:PORTA_API_HUB/api/actuator/health. Ao carregá-la, deverá exibir a mensagem {"status":"UP"}

Image Removed

(silencioso e gráfico)

O processo de conexão com a base do produto pode ser realizado por meio dos seguintes modelos:

Utilização do Owner do próprio produto
Conectar-se utilizando o mesmo Owner do produto, acessando diretamente seus objetos na base de dados.

Utilização de um Owner diferente do produto
Nesse cenário, é necessário utilizar o recurso do Oracle Logon Trigger. Esse mecanismo permite que o Owner definido acesse, de forma transparente, os objetos da base de dados do TOTVS Agro Bioenergia.

CREATE OR REPLACE TRIGGER trigger_nome_exemplo AFTER LOGON ON usuario_origem.SCHEMA BEGIN EXECUTE IMMEDIATE 'ALTER SESSION SET CURRENT_SCHEMA = usuario_destino'; END;

Orientações e FAQ - TOTVS Agro API HUB

Totvs custom tabs box items

default	no
referencia	FAQ

Expandir

title	Ativar protocolo HTTPS, utilizando o certificado SSL

Expandir

title	Conexão com a Base de Dados do Produto

Bloco de código

language	sql
title	Criação da Trigger de Logon

Páginas filhas

Versões comparadas

Versão antiga 41

Nova versão Atual

Chave

Este documento

centraliza os processos necessários para realizar a instalação do TOTVS Agro API Hub em ambientes Windows.