Seo [ServerNetwork]

Permite configurar mais de um servio do Protheus para balanceamento de carga via software.

Para isso, deve-se informar os servidores disponveis na rede para realizar a(s) conexo(es). Alm disso, para cada servidor
disponvel, necessrio criar uma nova seo, no arquivo de configurao (INI) do TOTVS Application Server, e informar o tipo de
conexo (TCP), porta, nome do servidor e/ou IP e o nmero mximo de conexes permitidas para o servidor enumerado.

Exemplo

[ServerNetwork]
Servers=SERVER1,SERVER2

[SERVER1]
TYPE=TCPIP
Server=Servidor1
Port=1024
Connections=60
[SERVER2]
TYPE=TCPIP
Server=Servidor2
Port=3024
Connections=40

Consideraes Importantes sobre Balanceamento de Carga

Ao configurar um servio do ERP (Microsiga Protheus) para balanceamento de carga, nomeamos de Master ou Balance. Os demais
servidores, que compem a lista de servidores para balanceamento, especificados na chave SERVERS, so chamados de Slaves.

Importante

Recomendamos que o servio do ERP (Microsiga Protheus), criado para balanceamento de carga, no aponte para ele mesmo como um Slave
para execuo de programas e/ou processamento.

Quando configuramos um servio para balanceamento de carga, devemos configurar os servios "slave" do Protheus com os
mesmos ambientes configurados no servio de balanceamento, onde cada ambiente de mesmo nome far uso compartilhado do
mesmo ROOTPATH. Para isto ser possvel, deve-se compartilhar a pasta raiz do ambiente no servidor onde os arquivos esto, e

todas as configuraes de ROOTPATH que acessam estes arquivos devem apontar para o caminho de rede deste
compartilhamento, inclusive os servios que esto na prpria mquina onde esto estes arquivos. O compartilhamento no servidor
criado para o ROOTPATH deve ser acessado pelos servios Slave com direitos "FULL " sobre a pasta, sub-pastas e seu contedo.
Adicionalmente, deve ser utilizado uma RDD para controle dos arquivos locais com arquitetura client-server, como um ADS Server
( para plataformas Windows ) ou c-Tree Server ( Para Windows e/ou Linu x) . Para plataformas Unix / Linux, existem etapas
adicionais, como a configurao de um servio de LockServer, e o compartilhamento de rede para acesso aos arquivos deve ser
feito via NFS, onde os servidores "slave" que acessam o rootpath via NFS devem mapear este path com o mesmo caminho da
mquina onde os arquivos esto fisicamente.

Informaes adicionais

Nmero de conexes
O nmero mximo de conexes permitidas (CONNECTIONS) informado para cada servidor da lista, no um fator limitante
do nmero de conexes, mas sim um nmero base para distribuio. Dessa forma, sugerimos que configurado o nmero
mximo de conexes estimadas de usurios que o equipamento suporte, para distribuir melhor a carga do ambiente.
Por exemplo, na configurao citada acima, 60% das conexes sero direcionadas para o Slave 1 e 40% direcionadas para o
Slave 2. No entanto, essa configurao no limitar o ambiente a 100 conexes.

Nmero de servios Protheus recomendvel por Servidor

A princpio, uma mquina dedicada a comportar servios do Protheus configurados como "Slaves" pode ter mais de um servio
dedicado do Protheus no mesmo equipamento. Isto recomendvel que seja feito, desde que exista memria suficiente no
equipamento para suportar a carga projetada, E, o servidor em questo possua mais de um processador ou ncleo ( core ) de
processamento, E o nmero de servios do Protheus configurados na mquina no ultrapasse o nmero de cores e/ou ncleos
de processamento da mquina. O uso de mais de um servio, mesmo que na mesma mquina, melhora a escalabilidade,
robustez de processo, e utiliza de forma mais produtiva a capacidade de processamento do equipamento.

Conexo via SSL - Secure Sockets Layer

A conexo via SSL entre o TOTVS Smart Client e o TOTVS Application Server no era suportada em builds iguais ou inferiores a
7.00.080307A. A partir da build 7.00.080307A, possvel realizar a configurao segura (SSL) para os servidores Slaves e
Master/Balance. Para mais informaes referente as configuraes do SSL no ERP (Microsiga Protheus), consulte a documentao
da seo [SSLConfigure].
Inicialmente, deve-se habilitar a conexo segura (SSL) no servio Slave do ERP. De modo que, cada servio Slave ter uma porta

de conexo TCP e uma porta de conexo segura SSL. No entanto, ao configurar as sees dos servidores Slaves, especificados
na seo [ServerNetwork], chave SERVERS, necessrio informar a porta de conexo segura de cada Slave, atravs da chave
SecurePort.
Observe, no exemplo abaixo, a configurao de dois servios Slave em mquinas distintas, onde cada um dos servios possui a
porta TCP 5024 aberta e a porta de conexo segura (SSL) 6024.

Neste exemplo, configuramos o TOTVS Smart Client para conectar na porta TCP do servio Master/Balance, que distribuir essa
conexo para um dos Slaves configurados, na porta SSL especificada. Mesmo que o TOTVS Smart Client no tenha sido
configurado, explicitamente, para uso de conexo segura, quando o TOTVS Application Server redirecionar a conexo para um
Slave com SSL, o TOTVS Application Server garante que a conexo estabelecida ser segura. Por isso, no existe a necessidade
explicita de configurar tambm o SSL no servidor Master/Balance.

[ServerNetwork]
Servers=SERVER1,SERVER2

[SERVER1]
TYPE=TCPIP
Server=Servidor1
Port=5024
SecurePort=6024
Connections=60
[SERVER2]
TYPE=TCPIP
Server=Servidor2
Port=5024
SecurePort=6024
Connections=60

Nesse exemplo, configuramos o TOTVS Smart Client para conectar na porta TCP do servio Master/Balance, que distribuir essa
conexo para um dos Slaves configurados, na porta SSL especificada. Mesmo que o TOTVS Smart Client no tenha sido
configurado, explicitamente, para uso de conexo segura, quando o TOTVS Application Server redirecionar a conexo para um
Slave com SSL, o TOTVS Application Server garante que a conexo estabelecida ser segura. Por isso, no existe a necessidade
explicita de configurar tambm o SSL no servidor Master/Balance.

No entanto, se o TOTVS Smart Client for configurado para realizar diretamente e apenas conexes seguras, via SSL, deve-se
habiltar o SSL no servidor Master/Balance e a conexo configurada no TOTVS Smart Client deve apontar para a porta SSL do
servidor Master e no a porta TCP.

Conexes e Portas TCP e SSL

Para o balanceamento de carga, ao configurar os servidores, deve-se especificar a porta TCP do Slave, na chave Port, e a porta
de conexo segura, na chave SecurePort. O servidor Master/Balance estabelecer uma conexo TCP com cada um dos Slaves,
para controle de distribuio e monitoramento.
A conexo SSL ser utilizada entre o TOTVS Smart Client e o servidor Slave para o qual o Master/Balance redirecionou a conexo.