ÍNDICE

1. Visão Geral
2. Pré-Requisitos
3. Ambiente sem TGM
4. Instalando o TGM (Máquina Local)
   
5. Instalando o TGM (Outra Máquina)
6. Vantagens e Possibilidades do TGM
7. Logs

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. 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.

03. PRÉ-REQUISITOS

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

04.

Um ambiente sem o TGM compreende apenas

• Balanceamento nativo,
• Sessões confiáveis

Exemplo de como configurar um ambiente sem TGM

Image Removed

INSTALANDO O TGM

04.01

Descrição das Colunas

• Porta de WCF: Porta WCF do RM
  
• Porta de WebService: Porta HTTP para utilização nos WebServices RM (por exemplo, TBC).
  
• Porta de WebApi: Porta HTTP para utilização no Web API RM, Serviços Rest.

• Em seguida 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 haja o balanceamento nativo (distribuição das requisições entre os hosts). 

Image Removed

(MÁQUINA LOCAL)

04.02 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:  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.

06

05. LOG DE ERROS

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

Totvs custom tabs box
tabs TGM,RM.Host/RM.Host.Service,RM.Host.ServiceManager ids 8,9,10
Totvs custom tabs box items default yes referencia 8 Painel borderColor #ddd borderStyle solid title TGM O log do TGM está centralizado no EventViewer (Visualizador de Eventos) do Windows. Totvs custom tabs box items default no referencia 9 Painel borderColor #ddd borderStyle solid title RM.Host / RM.Host.Service Caso hajam erros nos serviços relacionados ao TGM no RM.Host, os mesmos serão apresentados no TraceFile. obs.: é necessário habilitar a Tag Tracefile no config (https://tdn.totvs.com/display/LRM/Habilitar+Tag+Tracefile) 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.