Banco de Dados

• PostgreSQL 15

Acessos Externos

• É necessário que o servidor onde o TOTVS Agro API Hub está sendo instalado tenha acesso às URLs listadas abaixo:
  •  http://engenharia.agro.totvs.com.br:8080/download/ta-api-hub.jar

Liberações de IPs do TOTVS iPaaS

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

Requisitos de Hardware / Software

• Recomendado (Equivalente ou superior): CPU Intel® Xeon® Gold 5415+ Processor (22.5M Cache, 2.90 GHz) / 2 vCPU
• Recomendado (inicial): 8 GB de RAM disponível (somente para TOTVS Agro APIHub + PostgreSQL);

• Recomendado: 20 GB espaço em disco disponível (somente para TOTVS Agro APIHub + 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"

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

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

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

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

• • Informe o IP do serviço do TOTVS Agro API Hub
    • Default: 127.0.0.1
      • Insira o IP do servidor onde o serviço estará acessível.
      • Usar localhost restringirá o acesso apenas à máquina local.

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

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

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

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

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

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

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

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

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

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

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

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

• 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"}