Histórico da Página

ÍNDICE

Visão Geral
Pré-Requisitos
Ambiente sem TGM
Instalando o TGM (Máquina Local)
Instalando o TGM (Outra Máquina)

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. PRÉ-REQUISITOS

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

Totvs custom tabs box

tabs	Asp.Net Core,.Net Core,Node.js
ids	1,2,3

Totvs custom tabs box items

default	yes
referencia	1

Painel

borderColor	#ddd
borderStyle	solid
title	ASP.NET CORE 2.2.0

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.

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

Clique em Install.

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

Clique em close.

Totvs custom tabs box items

default	no
referencia	2

Painel

borderColor	#ddd
borderStyle	solid
title	.NET CORE 2.2.0

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.

Clique em Install.

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

Clique em Close

Totvs custom tabs box items

default	no
referencia	3

Painel

borderColor	#ddd
borderStyle	solid
title	Node.js (OPCIONAL - Destinado a publicação da solução - Somente para desenvolvedores)

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.

Espere as contagens e diagnósticos iniciais do sistema.

Clique em "Next".

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

Clique em "Next".

Escolha uma pasta de destino da instalação.

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

Clique em Install.

Espere a instalação do Node.js.

Clique em Finish

03. AMBIENTE SEM TGM

Um ambiente sem o TGM compreende apenas

Balanceamento nativo,
Sessões confiáveis

Exemplo de como configurar um ambiente sem TGM

Acessar o aplicativo "RM.Host.ServiceManager.exe" e adicionar a quantidade de serviços desejada.
Image Removed
Image Added
Em seguida era será necessário a configuração do arquivo "RM.exe.Config", configurando todos os hosts e portas adicionadas no "RM.Host.ServiceManager.exe", para que houvesse haja o balanceamento nativo (distribuição das requisições entre os hosts).

04. INSTALANDO O TGM (MÁQUINA LOCAL)

Iremos apresentar como instalar o TGM.

Totvs custom tabs box

tabs	Instalador da Biblioteca RM,Instalador do TGM,RM.Host.ServiceManager.exe
ids	4,5,6

Na instalação da Biblioteca o usuário poderá informar se usará o TGM, conforme parâmetro abaixo:

Image Removed

Totvs custom tabs box items

default	yesno
referencia	4

Totvs custom tabs box items

referencia

default	no
	5

E contará com o instalador do TOTVS Gateway Manager (TGM) que terá um instalador exclusivo onde o usuário irá informar os campos abaixo:

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.

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	6	5

Na

Após a instalação, ao acessar o RM.Host.Service.manager observe que as informações de Porta WCF, Porta WebService e Porta WebApi serão preenchidas.

Image Removed

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.

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.
Porta de WCF: Porta para disponibilização do endpoint do serviço rest para configuração do TGM.
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 onde o TGM irá receber requisições TCP e redirecionar para os Hosts cadastrados para responder TCP.
Porta de PING: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".
Em seguida, clique para instalar nas operações do serviço TGM.
Após realizada a instalação, configure as portas WebService e WebApi e clique em "Aplicar".
Verifique que o TGM foi instalado corretamente, como mostra a imagem disponível abaixo:

Image Modified

05. INSTALANDO O TGM (EM OUTRA MÁQUINA)

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

Totvs custom tabs box

tabs	Instalador da Biblioteca RM,RM.Host.ServiceManager.exe
ids	6,7

Totvs custom tabs box items

default	yes
referencia	6

Na instalação da Biblioteca o usuário poderá informar se usará o TGM, conforme parâmetro abaixo:

Image Added

Aviso

icon	false

É necessário que seja feita a alteração no arquivo "RM.exe.config" quando utilizado o TGM em outra máquina (Alterar os tags "Port" e "Host").

Totvs custom tabs box items

default	no
referencia	7

Marcar a opção "Utilizar TGM em outra maquina" e preencher o campo com "Host:Porta" da maquina que será utilizada para a instalação do TGM.
Alterar o arquivo "RM.exe.config", apontar as tags do host e porta para maquina que está sendo utilizada.
Verifique que a comunicação é feita corretamente entre as maquinas (através dos hosts ativos).

Aviso

icon	false

É necessário que seja feita a alteração no arquivo "RM.exe.config" quando utilizado o TGM em outra máquina (Alterar os tags "Port" e "Host").

Aviso

icon	false

Caso a sua empresa possua firewall e/ou restrições de acesso à internet, é necessário que o administrador da rede libere o acesso às portas configuradas.

Painel