Informações

title	Atenção

Esta página foi revisada para considerar as configurações de server do TOTVS Fluig Plataforma para a atualização 1.6.3 ou superiores.

Para atualizações entre 1.6.0 e 1.6.2 acesse: Como configurar a plataforma em load balance com Apache mod_proxy em Linux das releases 1.6.0 à 1.6.2?

Índice

outline	true
exclude	.*ndice
style	none

Pré-requisitos

...

Para atualizar os parâmetros de configuração, deve-se obedecer aos seguintes pré-requisitos:

O usuário deve ser administrador da plataforma;
O usuário deve ter acesso aos arquivos de configuração da plataforma.

Aviso

title	Importante

Antes de prosseguir com as instruções descritas nessa página, siga com atenção as instruções contidas na documentação Alta disponibilidade e Balanceamento de carga

Considerações iniciais

...

A configuração de balanceamento de carga (load balance) é a forma mais simples de se obter distribuição de carga e algum nível de alta disponibilidade.

Nota
Em ambientes com load balance, é muito importante manter todos os servidores com o horário sincronizado.

A grande desvantagem é a necessidade de afinidade de sessão, ou seja, uma vez que o usuário foi autenticado em uma instância, sempre será direcionado para a mesma instância. Nesse caso, se essa instância ficar indisponível, o usuário terá que logar novamente na aplicação.

Instalando a primeira instância

...

Siga os procedimentos abaixo para realizar a instalação da primeira instância do Fluig em um ambiente load balance.

Deck of Cards

history	false
id	FirstNode

Card

default	true
id	1
label	Passo 1

Faça uma instalação normal, conforme o Guia de instalação da plataforma, mas não inicie os serviços do Fluig.

Card

id	2
label	Passo 2

Considerações iniciais

O serviço de indexação (Solr) precisa ser único e compartilhado por todas as instâncias, portanto deve ser isolado em outro ambiente - acesse mais informações;
O repositório de arquivos do Fluig (Volume) deve estar em uma pasta compartilhada por todas as instâncias;
A pasta de aplicativos "(FLUIG_HOME/appserver/apps") deve estar em uma pasta compartilhada por todas as instâncias;
O banco de dados dever ser único para todas as instâncias;
Todas as instâncias devem estar atualizadas com a mesma versão do fluig.
Cada instância precisa ter um nome diferente, configurada via arquivo FLUIG_HOME/appserver/domain/configuration/host.xml.

Preparando ambiente

Antes de começar a instalação, é preciso estar com o ambiente preparado. Faça o seguinte:

Instale o banco de dados e crie uma instância;
É mandatório a utilização de um servidor de Cache externo. A recomendação é utilizar o Redis (Instalar conforme as recomendações [TODO: Por link]);
Escolha uma pasta em um servidor e torne-a acessível para todas as máquinas que farão parte do Load Balancer. Essa pasta conterá os arquivos que precisam ser compartilhados entre todas as instâncias. Conterá no mínimo duas pastas: apps e wcmdir.

Instalando a primeira instância

Para efeitos de simplificação, esse tutorial irá considerar que: 1) o servidor Realtime a ser usado será o instalado nesse nó; 2) a instalação será feita na pasta padrão (“/opt/fluig”).

O Fluig possui uma configuração especial para ser executado em cluster com Load Balancing. Essa configuração é habilitada durante a instalação.

Instale a aplicação, usando o procedimento normal, porém utilize a seguinte linha de comando:

...

language	bash
title	No Linux

...

Abra em um editor de texto o

...

arquivo [diretório_instalação]/appserver/domain/configuration/domain.xml

...

e altere

...

as seguintes configurações:

...

Localize a propriedade de binding "java:global/wcm/globalDataDir" e altere

...

-a informando o caminho da pasta compartilhada entre as instâncias;

Bloco de código

language	html/xml

<simple name="java:global/wcm/globalDataDir" value="

...

GLOBAL_DATA_DIR/wcmdir"/>

...

Localize o subsystem "urn:com.totvs.technology.wcm:1.0" e altere

...

-o informando o caminho da pasta compartilhada entre as instâncias;

Bloco de código

language	html/xml

<subsystem xmlns="urn:com.totvs.technology.wcm:1.0" dir="

...

GLOBAL_DATA_DIR/apps" refresh="15"/>

Card

id	3
label	Passo 3

Mova o conteúdo da pasta

...

[diretório_

...

instalação]/repository/wcmdir

...

para a pasta

...

GLOBAL_DATA_DIR/wcmdir

Mova o conteúdo da pasta

...

[diretório_

...

instalação]/appserver/apps

...

para a pasta

...

GLOBAL_DATA_DIR/apps

Card

id	4
label	Passo 4

Configure o servidor de indexação (fluig Indexer

...

) para ser executado em servidor separado,

...

conforme instruções aqui.

...

Encontre a chave "wcm/cacheServerAddress" e altere o valor para apontar para o servidor de cache configurado conforme recomendação [TODO: por Link].

Card

id	5
label	Passo 5

Inicie os serviços fluig_Indexer, fluig_RealTime e em seguida,

...

inicie o fluig.

Acesse

...

a plataforma com o usuário "wcmadmin", crie

...

uma nova empresa (tenant) e

...

realize as configurações necessárias.

...

Pare o fluig e os serviços

...

do fluig_RealTime

...

e fluig_Indexer

...

.

Criando uma segunda instância na mesma instalação

...

O fluig já vem preparado para Fluig permite executar uma segunda instância na mesma instalação. Basta habilitar e configurar parâmetros como memória, port offset e nome da instância., ou seja, sem a necessidade de instalar tudo novamente.

Deck of Cards

history	false
id	SecondInstance

Card

default	true
id	1
label	Passo 1

Abra em um editor de texto o

...

arquivo [diretório_instalação]/appserver/domain/configuration/host.xml

...

Localize a tag <servers>

Dentro dela haverão tags chamadas <server>

Adicione uma nova tag <server>, conforme exemplo:

Bloco de código

language	xml
theme	Eclipse
title	host.xml

<server auto-start="false" group="fluig" name="fluig2">
    <socket-bindings port-offset="150" socket-binding-group="full-sockets"/>
    <jvm name="default">
        <heap max-size="12g" size="4g"/>
        <jvm-options>
            <option value="-Dfile.encoding=utf8"/>
            <option value="-Djsse.enableSNIExtension=false"/>
            <option value="-XX:MaxMetaspaceSize=1024m"/>
            <option value="-Djavamelody.disabled=true"/>
        </jvm-options>
    </jvm>
</server>

Card

id	2
label	Passo 2

Certifique-se que o atributo name contenha um valor que jamais será repetido em outra instância.

A primeira instância sempre deverá se chamar "fluig1", enquanto as demais instâncias podem ter qualquer nome definido.

Card

id	3
label	Passo 3

O atributo auto-start indica se a instância deve (true) ou não (false) ser iniciada imediatamente quando o Fluig for iniciado. Se informado false, será preciso iniciá-la manualmente posteriormente usando a ferramenta jboss-cli. A recomendação é que a primeira instância seja iniciada sozinha e posteriomente sejam iniciadas as demais instâncias.

Card

id	4
label	Passo 4

Caso desejar ou for necessário, altere o atributo

...

port-offset

...

da tag

...

socket-bindings

...

. Cada nova instância precisa de um valor diferente (múltiplos de 150 são uma boa indicação).

Card

id	5
label	Passo 5

Ajuste as configurações de memória na tag

...

heap

...

.

É possível adicionar mais instâncias na mesma instalação. Basta replicar toda a seção "<server>" e tomar o cuidado de alterar, pelo menos, os atributos "port-offset" e "name". e name.

As instâncias que forem configuradas para não iniciar automaticamente (auto-start="false") devem ser iniciadas manualmente utilizando a ferramenta jboss-cli, que se encontra em [diretório_instalação]/appserver/bin, com o seguinte comando:

No Linux:

Bloco de código

language	bash
title	Linux

./jboss-cli.sh --controller="<ip-da-maquina>:9990" --connect --command="/host=master/server-config=fluig2:start"

No Windows:

Bloco de código

language	bash
title	Windows

jboss-cli.bat --controller="<ip-da-maquina>:9990" --connect --command="/host=master/server-config=fluig2:start"

Onde <ip-da-maquina> é o endereço IP/hostname configurado no arquivo host.xml (localizado em [diretório_instalação]/appserver/domain/configuration), na seção:

Bloco de código
<interface name="management"> <inet-address value="192.168.2.3"/> </interface>

Criando uma instância em outra máquina

...

Deck of Cards

history	false
id	ThirdInstance

Card

id	1
label	Passo 1

Instale a aplicação pelo procedimento normal e siga as instruções até o procedimento antes de iniciar o servidor.

Card

id	2
label	Passo 2

Abra em um editor de texto o arquivo

...

[diretório_

...

instalação]/appserver/domain/configuration/host.xml.

...

Localize a tag <servers>.

Dentro dela haverão tags chamadas <server>. Altere o atributo

...

name

...

dessas tags. O valor desse atributo precisa ser diferente em cada instância.

Configurando o

...

balanceador (mod_

...

proxy)

...

O fluig utiliza o módulo mod_cluster (juntamente Fluig homologa o Apache com o módulo mod_proxy ) para fazer um correto o balanceamento de carga e tolerância a falha. Recomenda-se a utilização da versão disponibilizada aqui.

...

.

Deck of Cards

history	false
id	ModProxy

Card

default	true
id	1
label	Passo 1

Instale o servidor HTTP Apache, versão 2.4.x.

Card

id	2
label	Passo 2

Configure o Apache para carregar os módulos necessários (comumente feito através do arquivo /etc/apache2/mods-enabled/mod_proxy.load), conforme abaixo.

Nota
A ordem de carregamento dos módulos é extremamente importante.

 Bloco de código
languagetext
LoadModule lbmethod_bybusyness_module /usr/lib/apache2/modules/mod_lbmethod_bybusyness.so
LoadModule proxy_module /usr/lib/apache2/modules/mod_proxy.so
LoadModule slotmem_shm_module /usr/lib/apache2/modules/mod_slotmem_shm.so
LoadModule proxy_balancer_module /usr/lib/apache2/modules/mod_proxy_balancer.so
LoadModule proxy_http_module /usr/lib/apache2/modules/mod_proxy_http.so
LoadModule headers_module /usr/lib/apache2/modules/mod_headers.so
LoadModule lbmethod_byrequests_module 

...

/usr/lib/apache2/modules

...

/mod_lbmethod_byrequests.so

A primeira linha indica o tipo de balanceamento que será feito. No exemplo acima, ele é feito por carga do servidor. Para conhecer outras formas, consulte o manual do Apache.

Card

id	3
label	Passo 3

Habilite o mod_

...

proxy (em geral isso é feito criando o arquivo /etc/apache2/sites-enabled/mod_

...

proxy.conf)

...

.

Bloco de código

language

...

xml

Header add Set-Cookie "FLUIGCOOKIE=%{UNIQUE_ID}e.%{BALANCER_WORKER_ROUTE}e; path=/" env=!VARCOOKIE
<VirtualHost *:80>
                ProxyRequests Off
                ProxyPreserveHost On

                <Proxy balancer://mycluster>
                        BalancerMember http://{ip servidor 1}:8080 route=fluig1
                        BalancerMember http://{ip servidor 1}:8230 route=fluig2
                        BalancerMember http://{ip servidor 2}:8230 route=fluig3
						ProxySet stickysession=FLUIGCOOKIE
                </Proxy>

                <Location /balancer-manager>
                        SetHandler balancer-manager
                        Order Deny,Allow
                        Allow from all
                </Location>
                <Location /

...

 Order allow,deny
                        Allow

...

from all

...


                </Location>

                ProxyPass / balancer://mycluster/ stickysession=FLUIGCOOKIE nofailover=Off
                ProxyPassReverse /

...

balancer://mycluster/

...

</

...

asdfasdf

Configurando o apache mod_proxy

Abra o arquivo httpd.conf e adicione o seguinte código:

VirtualHost>

Aviso

title	Atenção

Cada “BalancerMember” indica um servidor e deve apontar para o IP e porta corretos.

Um cookie chamado “FLUIGCOOKIE” é criado para manter a afinidade da sessão. Sem o cookie, o procedimento não irá funcionar.

Card

id	4
label	Passo 4
title	Load Balance RealTime

Aviso

title	Importante

O procedimento abaixo deve ser realizado para utilizar o serviço de Realtime em Load balance.

Passos para usar o Load Balance do Realtime

Realizar a configuração do Realtime para Load Balance conforme apresentado em Configurando o fluig Realtime para execução em Load Balance.
Adicionar o módulo abaixo, ao final dos demais módulos citados no passo 2.

Bloco de código

language	text

LoadModule rewrite_module /usr/lib/apache2/modules/mod_proxy_wstunnel.so

Realizadas as configurações acima, adicionar o código abaixo ao arquivo de configuração do servidor (Passo 3).

Bloco de código
Listen 8888

Bloco de código

language	html/xml

Header add Set-Cookie "

FLUIGCOOKIE=%{UNIQUE_ID}e

SERVERID=sticky.%{BALANCER_WORKER_ROUTE}e; path=/" env=

!VARCOOKIE <Proxy balancer://mycluster> Order deny,allow Allow from all BalancerMember http://{ip-servidor-1}:8180 route=node1

BALANCER_ROUTE_CHANGED
AllowConnect 8888
 <VirtualHost *:8888>
	
	ProxyRequests Off
    ProxyPreserveHost On
   

    <Proxy balancer://mycluster1>
            BalancerMember http://{ip

-

 servidor

-1

 realtime1}:

8280

8888 route=

node2

load1
            BalancerMember http://{ip

-

 servidor

-2

 realtime2}:

8080

8888 route=

node3

load2
            ProxySet stickysession=

FLUIGCOOKIE

SERVERID
    </Proxy>

<VirtualHost *:80> ProxyPreserveHost On ProxyPass / balancer://mycluster/ stickysession=FLUIGCOOKIE nofailover=Off DocumentRoot /var/www <Directory /var/www> Options -Indexes

    
    <Location /balancer-manager>
            SetHandler balancer-manager
            Order Deny,Allow
            Allow from all
    </Location>
    <Location />
            Order allow,deny
            Allow from all
    </

Directory> </VirtualHost>

O que é importante entender aqui:

...

Location>


    ProxyPass / balancer://mycluster1/ stickysession=SERVERID nofailover=Off
    ProxyPassReverse / balancer://mycluster1/
</VirtualHost>



Listen 7777
Header add Set-Cookie "SERVERID=sticky.%{BALANCER_WORKER_ROUTE}e; path=/" env=BALANCER_ROUTE_CHANGED
AllowConnect 7777
 <VirtualHost *:7777>
	
	ProxyRequests Off
    ProxyPreserveHost On


    <Proxy "balancer://nodes_polling">
            BalancerMember http://{ip servidor realtime1}:7777 route=read1
            BalancerMember http://{ip servidor realtime2}:7777 route=read2
            ProxySet stickysession=SERVERID
    </Proxy>
    
    <Proxy "balancer://nodes_ws">
            BalancerMember ws://{ip servidor realtime1}:7777 route=read1
            BalancerMember ws://{ip servidor realtime2}:7777 route=read2
            ProxySet stickysession=SERVERID
    </Proxy>
    
    
    RewriteEngine On
	RewriteCond %{HTTP:Upgrade} =websocket [NC]
	RewriteRule /(.*) balancer://nodes_ws/$1 [P,L]
	RewriteCond %{HTTP:Upgrade} !=websocket [NC]
	RewriteRule /(.*) balancer://nodes_polling/$1 [P,L] 

    
</VirtualHost>

Ambiente HTTPS

...

Ambientes HTTPS

Quando o usuário estiver usando um ambiente HTTPS, é necessário que as flags de segurança "Secure" e "HttpOnly" dos cookies estejam habilitadas na sessão. Para isso, siga a instrução abaixo:

Editar o arquivo /etc/apache2/sites-enabled/mod_proxy.conf e adicionar a seguinte linha no final do arquivo:

Bloco de código
Header edit Set-Cookie ^(.*)$ $1;HttpOnly;Secure

...

Nota

title	Configuração do Fluig

Altere a tag abaixo no arquivo $FLUIG_HOME/jboss/standalone/configuration/standalone.xml de cada servidor do Fluig para:

<subsystem xmlns="urn:jboss:domain:web:1.5" default-virtual-server="default-host" instance-id="${jboss.node.name:fluignd2}" native="false">
<connector name="http" protocol="HTTP/1.1" scheme="https" socket-binding="http" proxy-name="<url_virtual_host_fluig>" proxy-port="<porta_virtual_host_fluig>"/>
<connector name="httplog" protocol="HTTP/1.1" scheme="http" socket-binding="httplog"/>
<connector name="ajp" protocol="AJP/1.3" scheme="http" socket-binding="ajp" enabled="true"/>
<virtual-server name="default-host" enable-welcome-root="false">
<sso cache-container="web" cache-name="sso" reauthenticate="false"/>
</virtual-server>
</subsystem>

Onde:

<url_virtual_host_fluig>: é a URL definida no Apache para acessar o Fluig;
<porta_virtual_host_fluig>: é a porta definida no Apache para acessar o Fluig.

...

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 17

Nova versão Atual

Chave

Pré-requisitos

Considerações iniciais

Instalando a primeira instância

Considerações iniciais

Preparando ambiente

Instalando a primeira instância

Criando uma segunda instância na mesma instalação

Criando uma instância em outra máquina

Configurando o

balanceador (mod_

proxy)

Configurando o apache mod_proxy

Passos para usar o Load Balance do Realtime

Ambiente HTTPS

Atalhos

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 17

Nova versão Atual

Chave

Pré-requisitos

Considerações iniciais

Instalando a primeira instância

Considerações iniciais

Preparando ambiente

Instalando a primeira instância

Criando uma segunda instância na mesma instalação

Criando uma instância em outra máquina

Configurando o

balanceador (mod_

proxy)

Configurando o apache mod_proxy

Passos para usar o Load Balance do Realtime

Ambiente HTTPS