Histórico da Página

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"

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 localhostrestringirá 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"}