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?
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.
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.
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.
- Faça uma instalação normal, conforme o Guia de instalação da plataforma, mas não inicie os serviços do Fluig.
- 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;
<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;
<subsystem xmlns="urn:com.totvs.technology.wcm:1.0" dir="GLOBAL_DATA_DIR/apps" refresh="15"/>
- 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
- Configure o servidor de indexação (fluig Indexer) para ser executado em servidor separado, conforme instruções aqui.
- 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 permite executar uma segunda instância na mesma instalação, ou seja, sem a necessidade de instalar tudo novamente.
- 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:
<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>
- 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.
- 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.
- 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).
- 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.
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:
./jboss-cli.sh --controller="<ip-da-maquina>:9990" --connect --command="/host=master/server-config=fluig2:start"
No 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:
<interface name="management"> <inet-address value="192.168.2.3"/> </interface>
Criando uma instância em outra máquina
- Instale a aplicação pelo procedimento normal e siga as instruções até o procedimento antes de iniciar o servidor.
- 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 homologa o Apache com o módulo mod_proxy para fazer o balanceamento de carga.
- 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.
A ordem de carregamento dos módulos é extremamente importante.
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.
- Habilite o mod_proxy (em geral isso é feito criando o arquivo /etc/apache2/sites-enabled/mod_proxy.conf).
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/ </VirtualHost>
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.
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.
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).
Listen 8888 Header add Set-Cookie "SERVERID=sticky.%{BALANCER_WORKER_ROUTE}e; path=/" env=BALANCER_ROUTE_CHANGED AllowConnect 8888 <VirtualHost *:8888> ProxyRequests Off ProxyPreserveHost On <Proxy balancer://mycluster1> BalancerMember http://{ip servidor realtime1}:8888 route=load1 BalancerMember http://{ip servidor realtime2}:8888 route=load2 ProxySet stickysession=SERVERID </Proxy> <Location /balancer-manager> SetHandler balancer-manager Order Deny,Allow Allow from all </Location> <Location /> Order allow,deny Allow from all </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:
Header edit Set-Cookie ^(.*)$ $1;HttpOnly;Secure