Índice
Plataforma
Produto: fluig
Versão: da 1.6.0 à 1.6.2
Ocorrência
Como configurar o fluig com balanceamento de carga (load balance) utilizando Apache mod_proxy em Linux das releases 1.6.0 à 1.6.2?
Solução
A configuração em load balance é a forma mais simples de se obter distribuição de carga e algum nível de alta disponibilidade.
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.
- Abra em um editor de texto o arquivo [Instalação fluig]/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"/> |
<subsystem xmlns="urn:com.totvs.technology.wcm:1.0" dir="GLOBAL_DATA_DIR/apps" refresh="15"/> |
|
- Abra em um editor de texto o arquivo [Instalação do fluig]/repository/wcmdir/config/configuration.properties e altere a seguinte configuração:
- Localize a chave "wcm/cacheServerAddress" e altere o valor com o endereço do servidor de cache configurado conforme recomendação.
|
- Mova o conteúdo da pasta [Instalação fluig]/repository/wcmdir para a pasta GLOBAL_DATA_DIR/wcmdir
- Mova o conteúdo da pasta [Instalação fluig]/appserver/apps para a pasta GLOBAL_DATA_DIR/apps
|
- Configure o fluig Indexer (Solr) para ser executado em servidor separado, conforme instruções aqui.
|
- Inicie os serviços do cache, fluig_Indexer e fluig_RealTime e em seguida inicie o fluig.
- Acesse o fluig com o usuário "wcmadmin", crie uma nova empresa (tenant) e realize as configurações necessárias.
- Derrube o fluig e os serviços do fluig_RealTime, fluig_Indexer e do cache.
|
|
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 [Instalação do fluig]/appserver/domain/configuration/host.xml
- Dentro dela haverão tags chamadas <server>
- Adicione uma nova tag <server>, conforme exemplo:
<server auto-start="true" group="fluig" name="fluig2">
<socket-bindings port-offset="150" socket-binding-group="full-sockets"/>
<jvm name="default">
<heap max-size="4g" size="2g"/>
<jvm-options>
<option value="-Dfile.encoding=utf8"/>
<option value="-Djsse.enableSNIExtension=false"/>
<option value="-XX:MaxMetaspaceSize=512m"/>
<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 ser iniciada imediatamente quando o fluig for iniciado. Se informado false, será preciso iniciá-la manualmente posteriormente usando o painel de controle do servidor de aplicação.
|
- 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.
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 [Instalação do fluig]/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 |
|
- Habilite o mod_proxy (em geral isso é feito criando o arquivo /etc/apache2/sites-enabled/mod_proxy.conf).
<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
</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>
|
- 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.
|
|
|