Comunicação entre os ambientes doTOTVS 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
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"
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.
Totvs custom tabs box items
default
no
referencia
DOWNLOADS
O pacote do instalador do TOTVS Agro API Hub está disponível naCentral de Download da TOTVS, o modo de instalação silencioso e gráfico está disponívela partir da Release 12.1.2512.
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.
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/
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