Histórico da Página
Configuração para balanceamento de cargaSmartclient Desktop X Appserver usando TOTVS BROKER
Broker
O TOTVS Broker faz o balanceamento de carga, assim como o Appserver Master, mas com a vantagem de ser um pouco 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. O Já o appserver master não está apto a realizar este tipo de gerenciamento e por isso pode 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:
...
- 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.
Dica | ||
---|---|---|
|
...
Produto: |
...
Protheus Versão: |
...
TOTVSTEC-FRAMEWORK Ambiente: |
...
Appserver |
Baixar Baixe a versão de binário mais recente disponível na central de downloads da Totvs para o produto Protheus 12 mais recente . 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
...
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:
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[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:
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[broker] |
...
; máquina onde o *broker server* está rodando |
...
server=localhost |
...
; porta onde o *broker server* está atendendo |
...
port=5811 |
...
BrokerProxy = 1 |
è Substituir Substituia os valores LOCALHOST e 5811 pelas respectivas portas configuradas no appserver broker.
Adicionar Adicione a nova chave BROKER, criada acima, na seção drivers DRIVERS referenciando a seção criada acima. Exemplo:
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
[drivers] |
...
active=tcp,broker |
Nota | |
---|---|
|
...
|
...
|
...
|
...
|
...
|
...
...
Instalação Appserver Broker como serviço no Windows
Para instalar o appserver broker como serviço no Windows é um pouco diferente da instalação como serviço de um appserver de execução de aplicações do ERP Logix.
Neste caso de appserver como broker para smartclient desktop é preciso via linha de comando no Windows, utilizando permissão de administrador, executar a seguinte instrução a partir da pasta onde está o binário do appserver broker, com as chaves SERVICE_DISPLAY_NAME e SERVICE_NAME devidamente configuradas no arquivo appserver_broker.ini.
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Appserver_broker.exe -balance_smart_client_desktop –i |
Irá apresentar a seguinte mensagem em caso de sucesso de execução:
Bloco de código | |||
---|---|---|---|
|
*
* installation of Windows service
*
* Windows service installation was successful: TOTVSBROKER1
*
* *** fim ***
*
...
| |
*
* 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.
Para mais informações acesse “Balanceamento de carga com broker” no TDN em http://tdn.totvs.com/display/tec/Balanceamento+de+carga+com+broker.
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/pingOBS: O
Nota | ||
---|---|---|
| ||
O IP 127.0.0.1 e Porta 5811 devem ser ajustados conforme o IP e porta das configurações do Appserver Broker instalado. |
Observações
Mais informações a respeito do TOTVS Broker acesse acesse Broker