Tempo aproximado para leitura: 00:10:00 min
Dúvidas frequentes na instalação do TGM
Ambiente
Framework - Linha RM - Frame - A partir da versão 12.1.25
1- O que é o TGM?
O TGM ( O TOTVS Gateway Manager) é um centralizador de requisições (ponto único de acesso), que realiza a análise, a filtragem e redirecionamento do tráfego de terceiros entre os hosts ativos.
As funções presentes no API Gateway permitem as mais diversas vantagens para quem o utiliza. Um único ponto de acesso, por exemplo, significa uma redução de esforço em administrar as portas de entradas dos serviços utilizados, podendo focar seus esforços em um único local.
As funções presentes no API Manager fornecem uma camada de gestão para o API Gateway. Além de definir o comportamento do API Gateway, o API Manager lida com a análise de cada requisição.
2- Qual é a finalidade do TOTVS Gateway Manager (TGM)?
A finalidade do TGM (TOTVS Gateway Manager) é atuar como um gerenciador centralizado e seguro para todo o tráfego de dados que entra no ERP da Linha RM por meio de integrações, APIs e Web Services.
3- Se o ambiente do RM não utiliza nenhuma integração com sistemas externos, APIs ou Web Services, ainda assim é necessário instalar o TGM?
Não. Se o seu ambiente da Linha RM é utilizado de forma estritamente interna (apenas por usuários via SmartClient ou Portal) e não consome nem expõe nenhuma API, Web Service ou integração externa, a instalação do TGM não é necessária.
4- Qual é a diferença entre o balanceamento nativo de host do RM e o balanceamento realizado pelo TGM?
A principal diferença está no tipo de tráfego que cada um gerencia. Enquanto o balanceamento de host foca no usuário interno do ERP, o TGM foca em conexões de sistemas externos.
O balanceamento de host garante que o seu servidor aguente a quantidade de funcionários trabalhando simultaneamente nas telas do RM. O TGM garante que, quando um sistema externo disparar milhares de notas fiscais ou consultas via API, por exemplo, esse volume de dados seja organizado e filtrado para não derrubar os hosts que os usuários internos estão utilizando.
5- Em qual máquina o TGM deve ser instalado, no servidor de APP ou Job?
O TGM deve ser instalado no servidor de APP (AppServer).
6- Em quais cenários é recomendada a instalação do TOTVS Gateway Manager (TGM)?
A instalação do TOTVS Gateway Manager (TGM) é recomendada principalmente para cenários que exigem alta performance, segurança e centralização no tráfego de dados e integrações. Os principais cenários incluem:
Exposição Segura de APIs do RM (DataServer / Web Services): recomendada para empresas que precisam expor os serviços do RM (sejam Web Services legados ou novas APIs REST) para o ambiente externo (internet), criando uma camada de segurança (Proxy) que evita a exposição direta do servidor de aplicação do RM.
Integrações com Outros ERPs ou Plataformas (Ex: Fluig, Protheus): quando o RM faz parte de uma estrutura integrada e necessita de um gerenciador de tráfego que controle a volumetria de requisições, evitando que picos de integração causem lentidão ou indisponibilidade nos serviços de host do RM.
Garantia de Alta Disponibilidade (Load Balancing): cenários em que a estrutura de soluções não pode sofrer interrupções, permitindo que o TGM distribua as requisições de forma inteligente entre os servidores disponíveis.
7- Se eu possuo apenas um servidor de aplicação robusto com múltiplos serviços de host RM configurados, ainda assim preciso instalar o TGM?
Sim, o TGM é recomendado para ambientes onde são utilizadas integrações, APIs e Web Services.
8- Do que se trata cada porta de configuração do TGM?
Porta de serviço: Porta onde o TGM irá realizar o serviço de configuração.
Porta de resiliência: Porta onde o TGM irá realizar a resiliência do provider (NGINX).
Portas de escuta do TGM
Porta de WCF: Porta onde o TGM irá receber requisições TCP e redirecionar para os hosts cadastrados para responder TCP.
Porta de WebService: Porta onde o TGM irá receber requisições HTTP e redirecionar para os hosts cadastrados para responder HTTP.
Porta de WebApi: Porta para disponibilização do endpoint do serviço rest para configuração do TGM.
Connect (s): Valor em segundos para aguardar a conexão com o Proxy.
Time-out (s): Valor em segundos para aguardar a resposta da requisição.
9 - Em ambientes onde o Servidor de APP e o Servidor de Jobs são isolados, o TGM instalado no APP realiza o balanceamento do servidor de Jobs? É necessária uma nova instalação do TGM no servidor de Jobs ou efetuar algum apontamento?
O balanceamento de jobs no RM ocorre diretamente via banco de dados (tabelas GJOBSERVER e GKNOWNJOBSERVER) e não por requisições de rede HTTP/API. Quando um processo é solicitado, ele entra em uma fila na base de dados que é monitorada e executada nativamente pelo host. Por esse motivo, a execução de processos não passa pelo TGM, sendo desnecessário realizar qualquer configuração ou apontamento do gateway para o Servidor de Jobs.
Saiba mais
Para mais informações quanto a configuração do TGM:
Framework - Linha RM - Frame - TOTVS Gateway Manager (TGM)
TOTVS Gateway Manager (TGM)
0 Comentários