Configuração para balanceamento de cargaSmartclient Desktop X Appserver usando TOTVS BROKER

O TOTVS Broker faz o balanceamento de carga, assim como o Appserver Master, mas com a vantagem de ser um mais inteligente com relação ao tratamento dos Appservers Slaves.  Isso significa que quando um slave trava ou para de responder, o broker identifica e retira o servidor da lista de slaves que estão aptos a receber novas novas conexões, fazendo com que a operação continue sem qualquer problema. Já o appserver master não está apto a realizar este tipo de gerenciamento e por isso podem ocorrer travamentos no uso do smartclient com load balance, quando um dos appservers deixa de responder (travamento), que tem relação bem com um com alguma falha de comunicação de rede.

Além disso, o uso do TOTVS Broker possui outras vantagens como:

• Fácil instalação pois pode ser instalado em paralelo com o appserver Master sem prejudicar a operação, mas isso requer atenção pois caso ocorram conexões via appserver Master, o appserver Broker não contabilizará no controle tais conexões e slaves.

• Quando ocorre oscilação na rede e a conexão com smartclient é interrompida, um processo de recuperação da conexão é feito pelo broker client.

• O TOTVS Broker possui uma interface WEB onde é possível verificar o status, slaves, conexões e configurações.

• Falando de segurança, utilizando o TOTVS Broker, é preciso apenas liberar a porta de comunicação utilizada por ele, ou seja, não precisa liberar dos slaves.

Instalação e configuração do Appserver Broker

Para instalação do Broker, deve-se fazer o download do binário Appserver Protheus 12 disponibilizado no portal de suporte, pois o binário appserver Logix não possui a funcionalidade Totvs Broker habilitada.

Baixe a versão de binário mais recente disponível na central de downloads da Totvs para o produto Protheus 12. Este build estará identificado com build versão 13.2.3.XX, onde XX terá o número da revisão disponível. Exemplo:  APPSERVER VERSAO 12 WINDOWS 13.2.3.36

Descompacte o pacote do binário Broker dentro de um diretório em seu ambiente. Exemplo: appserver_broker

Dentro do diretório descompactado terá disponível o arquivo de configuração pronto para uso que deve ser ajustado em relação a porta de comunicação,  o endereço IP e porta dos appservers slaves e limite de conexões se for o caso.  

Segue um exemplo do contendo do arquivo appserver_broker.ini com as respectivas explicações de cada chave a ser configurada em seu próprio conteúdo:

[GENERAL]
CONSOLELOG=1

[BALANCE_SMART_CLIENT_DESKTOP]
; Porta onde este broker server atende pedidos de conexão dos broker clients
LOCAL_SERVER_PORT = 5811

; Chave REMOTE_SERVER_?? = [Hostname ou endereço IP] [Porta TCP appserver] [Número de conexões]
; Lista dos Appserver de destino das conexões vindas dos broker clients.
; O sufixo da chave (??) aceita letras e números para identificar os servidores. A ordem em que
; os appservers são registrados é livre.
; Por exemplo: REMOTE_SERVER_0A, REMOTE_SERVER_XY, etc.
REMOTE_SERVER_01 = jvn60101297 7085 3
REMOTE_SERVER_02 = jvn60101297 7091 3
REMOTE_SERVER_03 = jvn60101297 7092 3

; Tempo em segundos que o Totvs Server Broker armazena informações sobre uma conexão perdida,
; para possibilitar a retomada da conexão pelo broker client. 90 segundos é o tempo máximo,
; pois o Totvstec, por padrão, derruba qualquer conexão que fique sem atividade após este intervalo.
STANDBY_TIME = 90

; Chave SERVICE_NAME = [Nome do serviço].
; Pode ser qualquer nome que não contenha espaços.
; Só tem importância se o broker server for instalado como um serviço no Windows
SERVICE_NAME = TOTVS_BROKER_SMARTCLIENT

; Chave SERVICE_DISPLAY_NAME (opcional, disponível a partir de 01/dez/2017)
; Descrição do serviço (Display Name) para exibição na lista de Serviços do Windows.
SERVICE_DISPLAY_NAME = "TOTVS BROKER SmartClient"

Configuração do SmartClient Desktop

Para o SmartClient, é necessário colocar a DLL totvsbrokercg na mesma pasta onde fica o binário totvssmartclient.exe usado para acesso ao Logix.  Esta DLL está disponível juntamente com o pacote de atualização do build Logix no portal da Totvs. Cabe apenas disponibilizar esta DLL na pasta onde está o executável do Smartclient do Logix.

Além disso, também é preciso adicionar a seguinte configuração no totvssmartclient.ini do Logix:

[broker]
; máquina onde o *broker server* está rodando
server=localhost
; porta onde o *broker server* está atendendo

port=5811
BrokerProxy = 1

Substituia os valores LOCALHOST e 5811 pelas respectivas portas configuradas no appserver broker.

Adicione a nova chave BROKER, criada acima, na seção DRIVERS referenciando a seção criada acima.

[drivers]
active=tcp,broker

Instalação Appserver Broker como serviço no Windows

Para instalar o appserver broker como serviço do Windows é um pouco diferente da instalação de serviço de um appserver para ERP Logix. Neste caso de appserver como broker para smartclient desktop é preciso que, via linha de comando no Windows, utilizando permissão de administrador, execute a seguinte instrução a partir da pasta onde está o binário do appserver broker:   

Appserver_broker.exe -balance_smart_client_desktop –i

Irá apresentar a seguinte mensagem em caso de sucesso de execução:

*
* installation of Windows service
*
* Windows service installation was successful: TOTVSBROKER1
*
* *** fim ***
*

Acesse a tela de gerenciamento de serviços do Windows e confirme a criação do serviço do appserver broker e configure o serviço como automático se desejar inicialização automática, juntamente com o servidor/máquina local onde foi realizada a instalação.

Link para acesso a telas de monitoramento do Totvs Broker (interface WEB)

Todas as telas de monitoramento do TOTVS Broker possuem interface WEB e podem ser acessadas através dos links a seguir:

Status do broker

http://127.0.0.1:5811/TOTVS_BROKER_QUERY/status

Informações sobre configuração

http://127.0.0.1:5811/TOTVS_BROKER_QUERY/cfg

Ping – Para avaliar se o totvs broker está disponível (serviço está no ar)

http://127.0.0.1:5811/TOTVS_BROKER_QUERY/ping

Observações

Para informações a respeito do TOTVS Broker acesse Broker

Para informações a respeito de “Balanceamento de carga com broker” acesse Balanceamento de carga com broker.