Tempo aproximado para leitura: 00:09:00 min
Dúvida
Como realizar a instalação e configuração do TGM?
Ambiente
Framework - Linha RM - Frame - A partir da versão 12.1.25
Solução
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.
Importante:
É necessário a instalação da Biblioteca RM para configuração do TGM. A instalação da Biblioteca deve ser realizada em N camadas (Servidor de Aplicação (AppServer):
1 - Instalação do TGM na máquina local (Servidor):
Neste exemplo, iremos realizar a instalação do TGM na versão 12.1.2602.
Para realizar a instalação do TGM no servidor, utilize o instalador TOTVS Gateway Manager - 12.1.2602.exe, disponível na central de Downloads:
Execute o instalador:
No Wizard de instalação, na janela de utilitários para configuração do TGM, configure as portas conforme exemplo abaixo:
Porta de Serviço: Porta utilizada pelo serviço do TGM
Porta de Resiliência: Porta utilizada para validar o funcionamento do TGM.
Dica: As portas utilizadas na instalação do TGM devem ser diferentes das portas configuradas nos serviços do host (aplicativo RM.Host.ServiceManager.exe).
Prossiga com a instalação:
Altere a conta de Sistema para LocalSystem:
Finalize a instalação:
Acesse o aplicativo RM.Host.ServiceManager.exe (UNIDADE:\TOTVS\CorporeRM\RM.Net) e clique na aba Totvs Gateway Manager e avalie se as informações foram preenchidas com sucesso:
Reinstale os serviços do host:
Após reinstalar os serviços do host, para avaliar o correto funcionamento do TGM, acesse o endereço:
http://IP_DO_SERVIDOR:8000/api/tgm/ping, conforme exemplo abaixo. Em caso de êxito será apresentada a mensagem abaixo:
Neste teste de validação, observe que utilizamos a porta do TGM que fora configurada: Porta: 8000.
Acesse o endereço http://IP_DO_SERVIDOR:8001/api/provider para validar o correto carregamento das informações parametrizadas. Neste teste de validação, observe que foi utilizada a porta de resiliência que fora configurada: 8001.
Dica: Acesse os endereços de testes acima através do Browser Firefox, pois o mesmo formata o conteúdo da página sem necessidade de plugin (o conteúdo está no formato JSON).
Acesse TODOS os arquivos de configuração do diretório RM.Net e altere o conteúdo do mesmo, apagando as demais portas e host para apontar apenas para a porta WCF do TGM, neste exemplo, a porta configurada foi a 8070:
Exemplo abaixo para o arquivo de configuração RM.exe.config (MDI):
Exemplo abaixo para o arquivo de configuração RM.AliasManager.exe.config (RM.AliasManager):
2 - Instalação do TGM em outra máquina:
Neste exemplo em um servidor de APP (TGM já deve estar instalado e configurado no servidor inicial):
Ao realizar a instalação da Biblioteca .MSI marcar a flag abaixo no Wizard de instalação e informar as configurações do servidor de TGM previamente instalado e configurado:
A instalação da Biblioteca RM .MSI irá criar automaticamente as tags abaixo nos arquivos de configuração dos hosts:
<add key="TGMADDRESS" value="BH-SUP-BDFRAME:8000" />
<add key="TGMGROUPFORTCP" value="RM_WCF" />
<add key="TGMGROUPFORHTTP" value="RM_WEBSERVICE" />
<add key="TGMGROUPFORAPI" value="RM_WEBAPI" />
No aplicativo RM.Host.ServiceManager, realizar as configurações abaixo:
Realizar a configuração manualmente em TODOS os arquivos de configuração (diretório RM.Net) no exemplo abaixo arquivo RM.exe.config:
Caso seja necessário reinstalar os serviços do host, pode ser apresentada a mensagem abaixo, neste caso, basta clicar em Ok na mensagem e instalar o segundo serviço:
Instale o próximo serviço:
3 - Instalação do TGM em máquina client:
Ao realizar a instalação da Biblioteca RM em máquinas client:
No Wizard de instalação, informe o servidor do TGM e a porta WCF:
Saiba mais
Para mais informações, consulte o link TOTVS Gateway Manager (TGM)
0 Comentários