Páginas filhas
  • TOTVS Agro API Hub (Instalação)

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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
tabs1 - Requisitos, 2 - Download, 3 - Processo de Instalação, 4 - Orientações e FAQ - TOTVS Agro API HUB
idsREQUISITOS,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
    defaultyes
    referenciaREQUISITOS
    Informações
    titleRequisitos 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
    titleInfraestrutura 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
    titleCompatibilidade com o TOTVS Agro Bioenergia


    Arquitetura e Tecnologia - TOTVS Agro API Hub


    Totvs custom tabs box items
    defaultno
    referenciaDOWNLOADS


    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:

    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 custom tabs box items
    defaultno
    referenciaDOWNLOADS
    Totvs custom tabs box items
    defaultno
    referenciaINSTALADOR


    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.
  • (aviso) Usar localhostrestringirá o acesso apenas à máquina local.
      • Image Removed 
    •  
      • Informe a porta do serviço do TOTVS Agro API Hub
        • Default: 8080
        • (aviso) 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 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

    Image Removed

    Hub (silencioso e gráfico)


    Totvs custom tabs box items
    defaultno
    referenciaFAQ


    Orientações e FAQ - TOTVS Agro API HUB