Histórico da Página

...

O aplicativo TOTVS Agro Connector Client é uma instalação realizada On-Premise, portanto, existem algumas premissas e definições a serem atendidas para realizar a instalação.

Para a instalação, recomendamos um servidor/VM Linux, porém, existem duas opções:

• ✔️ Docker (plataforma Linux) - recomendado:
  • Utilizado com o Sistema Operacional Linux (Debian ou CentOS GNU/Linux 10 (buster) ou distribuição Linux 64 bits com interface gráfica)
  • Deve ser a primeira opção
  • Deploy automatizado e sem downtime100% controlado pelo time da TOTVS, com performance superior ao cenário Windows
  • Monitoramento de erros e envio de notificações para o time da TOTVS, que por sua vez podem atuar de maneira pró-ativaproativa
  • 100% controlado pelo time da TOTVS (novas atualizações na plataforma de integração TOTVS Agro Connector)Melhor performance
• Windows Service (plataforma Windows):
  
  • Caso seja o Sistema Operacional Windows 
  • Escolher essa opção somente se não for possível realizar a instalação do TOTVS Agro Connector Client em um servidor que seja Linux (criando uma VM ou utilizando um servidor existente)
  • Utilizará de Windows Service Wrapper (WSW) para configuração como serviço do Windows
  • Dependência: RabbitMQ  (https://www.rabbitmq.com/docs/install-windows) + Erlang for Windows (De acordo com modelo utilizado pelo cliente)

Mais informações sobre o TOTVS Agro Connector Client aqui.podem ser consultadas neste link.

> Compatibilidade de versões Linux com plataforma Docker Server: https://docs.docker.com/engine/install/

Image Added

02. PREMISSAS

⚠️ 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 Connector + PostgreSQL + RabbitMQ + Redis);
• Recomendado: 20 5 GB espaço em disco disponível (somente para TOTVS Agro Connector + PostgreSQL + RabbitMQ + Redis);

⚠️ 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 Agro Connector Client devem estar o mais próximo das bases de dados de produtos a serem integrados (por exemplo, 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 Connector Client e demais aplicações (por exemplo, TOTVS Agro Bioenergia, TOTVS Agro Multicultivo e/ou TOTVS Agro Minha Borracharia) - 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 Connector Client 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 Connector Client 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"
    • SQL Server: "SELECT 1 AS Result;"
      

Requisitos de infraestrutura e ambiente

• Banco de dados (PostgresPostgreSQL, Oracle, SQLServer SQL Server ou MySQL)
• Acesso à internet (com acesso liberado ao endereço https://tcserver-supplyagro.totvs.app/)
• O produto (TOTVS Agro Multicultivo ou TOTVS Agro Bioenergia) precisará acessar um serviço do TOTVS Agro Connector Client (endpoint GET /api/v1/clientMetadata), portanto, o acesso ao serviço deverá estar liberado
• Comunicação entre os ambientes do TOTVS Agro Connector Client e bases de dados de outros produtos (por exemplo, TOTVS Agro Bioenergia ou TOTVS Agro Multicultivo, com compatibilidade com Oracle, SQL Server, PostgreSQL ou MySQL);
• Caso exista bloqueio/restrição na rede, baseado em whitelist, adicionar os hosts na máquina em que o TOTVS Agro Connector Client será instalado:
  • https://tcserver-supplyagro.totvs.app/https
  • http://dockerengenharia.agro.totvs.io/https://totvstfs.visualstudio.com/.com.br:8080/*
  • http://agrodata-gateway.agro.totvs.io:8092 
  • http://mdm.agro.totvs.io:8090 
  • https://discordapp.com
  • https://docker.totvs.io/
  • https://totvstfs.visualstudio.com/

Apoios para instalação (Framework)

...

• Para realizar a instalação via Windows Service, utilizar a página TOTVS Agro Connector - Windows Service
• O endereço endereço http://187engenharia.agro.94totvs.56com.241br:8080/ deverá estar liberado

Para instalações utilizando Linux

• O roteiro de instalação e configuração em Linux pode ser consultado neste material.

...