ÍNDICE

01. VISÃO GERAL

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.

02.

Serão listados abaixo a lista de pré-requisitos para o correto funcionamento do TGM, são eles:

Informações de Download

Site: Acesse o site https://dotnet.microsoft.com/download/thank-you/dotnet-runtime-2.2.0-windows-x64-asp.net-core-runtime-installer. [1]

Passo a Passo de Instalação

Espere o download e execute o arquivo de instalação.

Image Removed

Marque a opção "I agree to the license terms and conditions".

Clique em Install.

Image Removed

Aguarde a instalação do Asp.Net Core 2.2.0.

Image Removed

Clique em close.

Image Removed

Informações de Download

Site: https://dotnet.microsoft.com/download/thank-you/dotnet-runtime-2.2.0-windows-x64-installer. [2]

Passo a Passo da Instalação

Espere o download e execute o arquivo de instalação.

Image Removed

Clique em Install.

Image Removed

Espere o término da instalação do .NET CORE 2.2.0

Image Removed

Clique em Close

Image Removed

Informações de Download

Site: https://nodejs.org/en/. [3]

Passo a Passo da Instalação

Escolha a opção 10.16.0 LTS.

Espere o download e execute o arquivo de instalação.

Image Removed

Espere as contagens e diagnósticos iniciais do sistema.

Image Removed

Clique em "Next".

Image RemovedMarque a opção "I accept the terms  in the License Agreement".

Clique em "Next".

Image Removed

Escolha uma pasta de destino da instalação.

Image Removed

Ignore as configurações da pagina abaixo e clique em "Next", serão instalados as funcionalidades padrões do Node.js.

Image Removed

Clique em Install.

Image Removed

Espere a instalação do Node.js.

Image Removed

Clique em Finish

Image Removed

VANTAGENS E POSSIBILIDADES DO TGM

      Haverá um ponto central de comunicação com os Serviços para requisições de portais web, sem que seja necessário implementar uma regra de balanceamento e descoberta em cada portal.

      Não é necessário mais re-configurar todas as aplicações clientes ao incrementar ou modificar o parque de Servers.

      Será possível visualizar todos os Servers disponíveis no parque,  além de poder testar a saúde de comunicação dos mesmos, é até reconfigurar cada server para que ele atenda a determinados tipos de serviços.

      Principais características de destaque do TGM:

• A solução é de fácil implantação, tanto para novas instalações quanto para instalações já existentes. 
• O sistema é modularizável e servirá à qualquer linha de produto da TOTVS.
• Será possível que o administrador do ERP tenha uma visão completa de todo o parque de servidores.

Image Added

03. REQUISITOS

A partir da versão 12.1.2406 do RM, não há pré-requisitos para a instalação do TGM.

Para versões anteriores, consultar: Dependências de execução do TGM na versão 12.1.2402 e anteriores - Linha RM - TDN (totvs.com.br)

04. INSTALANDO O TGM

04.01 (MÁQUINA LOCAL)

03. EXEMPLO DE UTILIZAÇÃO

Exemplo do Comportamento Antigo (até a versão 12.1.24):

Image Removed

Image Removed

Image Removed

Image Removed

Informações title Atenção As configurações dos serviços serão inseridas no arquivo "appServerList.json" onde o mesmo será lido ao subir o serviço do TGM, adicionando as informações dos Serviços de Proxy na configuração do TGM.

Image Removed|

Ao instalar o TGM via instalador, ao final verificar se o serviço do TGM está online. Image Added Totvs custom tabs box items default no referencia 5 O serviço do TGM  pode ser feita via RM.Host.ServiceManager, basta marcar o campo "Instalar TGM" e clicar no botão Instalar após informar o diretório onde o TGM foi instalado.                                    Image Added Aviso title Atenção Caso o serviço do TGM não inicie, verifique na documentação TGM Troubleshooting.

Para mais informações sobre como alterar as portas WebApi ou WebService, acesse o link.

Já na sub pasta TOTVS Gateway Manager o campo "Instalar TGM" virá marcado.

Image Removed
  

Descrição dos Campos: Instalar TGM: Opção para que o serviço do Totvs Gateway Manager seja instalado na maquina que está sendo utilizada.  Caminho completo do arquivo: Caminho onde está instalado o executável do Totvs Gateway Manager. Portas de eonfiguração do TGM Porta de

WCF

serviço: Porta

para disponibilização do endpoint do serviço rest para configuração do TGM.
Porta de WebService

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

HTTP

TCP e redirecionar para os Hosts cadastrados para responder

HTTP

TCP. Porta de

WebApi

WebService: Porta onde o TGM irá receber requisições

TCP

HTTP e redirecionar para os Hosts cadastrados para responder

TCP

HTTP. Porta de

PING:

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

Porta onde o TGM irá realizar a resiliência do NGINX

. Utilizar TGM em outra maquina: Opção dada ao usuário para que o Totvs Gateway Manager seja instalado em outra maquina (informando Host:Porta). Passo a passo para configuração do TGM (Totvs Gateway Manager): Acessar o aplicativo "RM.Host.ServiceManager.exe" e adicionar a quantidade de serviços desejada. Acessar a aba "Totvs Gateway Manager" e ,marcar a opção "Instalar TGM".  Informe o caminho onde o TGM foi instalado anteriormente. Em seguida, clique para

04.02 EM OUTRA MÁQUINA

Iremos apresentar como instalar o TGM em outra máquina.

05. LOG DE ERROS

      Erros podem ocorrer no RM.Host ou no RM.Host.ServiceManager

Image Removed

com/display/LRM/Habilitar+Tag+Tracefile) Image Added Totvs custom tabs box items default no referencia 10 Painel borderColor #ddd borderStyle solid title RM.Host.ServiceManager Caso hajam erros nos serviços relacionados ao TGM no RM.Host.ServiceManager, os mesmos serão apresentados na tela. Image Added