29/11/22, 18:17 Uso do Protheus Monitor na porta do Broker - TOTVSTEC - TDN

Páginas / … /
Broker para Smartclient Desktop

Uso do Protheus Monitor na porta do Broker

Tempo aproximado para leitura: 3 minutos

 Funcionalidade disponível a partir da versão 20.3.0.0 do TOTVS | Application Server.

Até as versões 19.3.1.x o TOTVS | Broker configurado para TOTVS | SmartClient Desktop somente permitia o monitoramento das conexões usando o TOTVS | Monitor e/ou TDS /
VSCode mediante a configuração de um serviço adicional de TOTVS | Application Server, configurado como Master/Balance.
O TOTVS | Monitor conecta na porta TCP do TOTVS | Broker, que repassa a conexão para este serviço adicional. Isso exige o deploy de mais um serviço e, caso sejam
acrescentados ou removidos serviços para o balanceamento do TOTVS | Broker, a configuração do TOTVS | Application Server Master/Balance adicional deve ser atualizada
manualmente.
Para facilitar a utilização do TOTVS | Monitor nos cenários onde o TOTVS | Broker é utilizado, foi criado um mecanismo de monitoramento interno ao TOTVS | Broker que elimina a
necessidade de criar e sincronizar uma instância adicional de serviço Master/Balance.
Esse novo recurso de monitoramento é ativado pela chave PROTHEUS_MONITOR_EMBEDDED=1 no arquivo de configuração do TOTVS | Broker.
É necessário também que seja configurado um ambiente de TOTVS | Application Server para a realização de  autenticação do mecanismo de monitoramento.

Observações
Não é necessário configurar as chaves PROTHEUS_MONITOR_ADDRESS e PROTHEUS_MONITOR_PORT, que ficam exclusivas para o monitoramento através de
um TOTVS | Application Server configurado para balanceamento (vide link).
Não é possível utilizar conexão em modo seguro entre o TOTVS | Monitor e o TOTVS | Broker.
Quando os servidores TOTVS | Application Server balanceados pelo TOTVS | Broker não estiverem utilizando comunicação segura, então a configuração do TOTVS | Broker
deverá conter explicitamente a chave MONITORING_TYPE=SMARTCLIENT_ACTIVE configurada para que o TOTVS | Monitor possa funcionar (esta chave é consultada
pela monitoração interna do broker para saber se a comunicação com os servidores é encriptada).
Em ambiente Linux o nome do binário do TOTVS | Broker deve começar com "appserver": appserver, appserver-broker, etc. Notar que o arquivo de configuração do TOTVS |
Broker deve acompanhar o nome do binário: appserver/appserver.ini, appserver-broker/appserver-broker.ini, etc.

Exemplo de configuração
Para este exemplo, vamos configurar 1 TOTVS | Broker e 3 serviços de TOTVS | Application Server que serão monitorados.
Vamos supor que o TOTVS | Broker e os serviços de TOTVS | Application Server estejam na mesma máquina física ou VM. (Isto não é necessário, mas é uma configuração comum).
Neste caso, todos os serviços possuem IP 127.0.0.1 (localhost).
Apenas o broker precisa ter o IP e porta publicados.
TOTVS | Broker: IP 10.172.36.130 porta 4321

Serviços de TOTVS | Application Server: IP 127.0.0.1 porta 4001, 127.0.0.1 porta 4002, 127.0.0.1 porta 4003.

Configuração do broker (appserver.ini)

Configuração básica para ambientes com Dicionário e arquivos de Sistema gerenciados pelo Banco de Dados

[BALANCE_SMART_CLIENT_DESKTOP]
LOCAL_SERVER_PORT=4321
REMOTE_SERVER_01=127.0.0.1 4001
REMOTE_SERVER_02=127.0.0.1 4002
REMOTE_SERVER_03=127.0.0.1 4003
 
; configuracao para o protheus monitor
PROTHEUS_MONITOR_EMBEDDED=1
 
; environment para autenticação do monitoramento
; observação: broker utiliza a dll dbapi.dll no Windows (ou equivalente no Linux)
[environment]
SourcePath=C:\protheus\environment\apo
RootPath=C:\protheus\environment\protheus_data
StartPath=\system\
RpoDB=TOP
RpoLanguage=Portuguese
RpoVersion=120
DBDatabase=...
DBServer=...
DBAlias=...
DBPort=...

Configuração necessária para ambientes que utilizam o CtreeServer para gerenciamento de arquivos

; obervação: broker utiliza as dlls do CTree (ou equivalentes no Linux)

[CtreeServer]

https://tdn.totvs.com/display/tec/Uso+do+Protheus+Monitor+na+porta+do+Broker 1/2
29/11/22, 18:17 Uso do Protheus Monitor na porta do Broker - TOTVSTEC - TDN
ctUserId=ADMIN
ctUserPass=ADMIN
ctServerName=FAIRCOMS@localhost
 
[General]
CtreeMode=Server

Sem rótulos

Política de Termos
privacidade de uso

https://tdn.totvs.com/display/tec/Uso+do+Protheus+Monitor+na+porta+do+Broker 2/2