Configuração para balanceamento de carga Smartclient Desktop X Appserver Logix 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 Appserver 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. O build Appserver Protheus é compatível com o build Logix para utilização como Appserver Broker.

A instalação do Totvs Broker se resume na substituição do Appserver Master utilizado para balanceamento de carga do Smartclient por um novo Appserver Protheus que será denominado "Appserver Broker". Os demais slaves do Logix permanecerão instalados com o build Appserver Logix. 

Veja imagem abaixo que apresenta como a estrutura do LOAD BALANCE ficará após instalação do Appserver Broker para substituir o Appserver Master:

1. CLIQUE AQUI e selecione a versão de binário disponível na central de downloads da Totvs para o produto Protheus 12, identificado com build versão 13.2.3.XX, onde XX terá o número da revisão do build. 
   
   
2. Caso o link não apresente os dados, certifique-se de que a opção Filtro de pacotes esteja selecionada como "Todos pacotes disponíveis", ou então realize o filtro manualmente conforme descrito no quadro acima. Um exemplo de como a descrição do pacote a ser baixado será exibido no portal é "APPSERVER VERSAO 12 WINDOWS 13.2.3.48 ATÉ A RELEASE 12.1.17", mas esta descrição pode mudar de acordo com a versão disponível atualmente para download.
   Existe versão tanto para ambiente Windows como para Linux. O conteúdo da descrição do pacote disponível pode mudar em relação a versão de Build. 
   
   
3. Descompacte o pacote do binário Appserver Protheus citado acima, que será configurado como appserver Broker, dentro de um diretório em seu ambiente.
                     Exemplo de nome para pasta de instalação: appserver_broker
   
   
4. Segue um exemplo do contendo do arquivo de configuração do appserver broker (arquivo .ini) com as respectivas explicações de cada chave a ser configurada em seu próprio conteúdo. Estas mesmas configurações estão detalhadas em Configuração padrão do broker.

[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 ou smartclient.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. Apenas é necessário disponibilizar esta DLL na mesma pasta onde está o executável do Smartclient do Logix.

Além disso, também é preciso adicionar a seguinte configuração no arquivo 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

Substitua 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. No caso do Appserver como Broker para Smartclient Desktop é preciso que, via linha de comando no Windows, usando permissão de acesso como 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 ***
*

 O nome TOTVSBROKER1 reflete o nome do serviço registrado na seção [SERVICENAME] do arquivo appserver.ini do Appserver Broker que foi instalado como serviço do Windows.

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:

Veja também

• TOTVS Broker
• Balanceamento de carga com broker
• Base de Conhecimento do Broker