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



Banco de Dados

  • PostgreSQL 15


Acessos Externos


Liberações de IPs do TOTVS iPaaS


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:


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.


  • 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.
        • (aviso) Usar localhost restringirá o acesso apenas à máquina local.
    • Informe a porta do serviço do TOTVS Agro API Hub
      • Default: 8080
      • (aviso) 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
    • 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 padrao utilizado no produto BIOENERGIA
      • Informar a instância padrão do produto
    • Informe se deseja incluir a integração com o TOTVS Agro Middleware
      • Essa opção deverá ser utilizada somente caso utilizar integração com aplicativo TOTVS Agro Middleware