Í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.
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 |
---|
|
Card |
---|
default | true |
---|
id | 1 |
---|
label | Passo 1 |
---|
|
|
|
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
|
|
...
...
- 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 |
---|
| <simple name="java:global/wcm/globalDataDir" value=" |
|
|
...
GLOBAL_DATA_DIR/wcmdir"/> |
|
|
...
...
Bloco de código |
---|
| <subsystem xmlns="urn:com.totvs.technology.wcm:1.0" dir=" |
|
|
...
GLOBAL_DATA_DIR/apps" refresh="15"/> |
|
|
...
...
- instalação]/repository/wcmdir
|
|
...
...
...
...
- instalação]/appserver/apps
|
|
...
...
Card |
---|
|
- 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 |
---|
|
- Inicie os serviços fluig_Indexer, fluig_RealTime e em seguida,
|
|
...
...
- 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
|
|
...
...
...
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
|
|
...
- 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 |
---|
|
- 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 |
---|
|
- 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 |
---|
|
- Caso desejar ou for necessário, altere o atributo
|
|
...
...
...
...
- . Cada nova instância precisa de um valor diferente (múltiplos de 150 são uma boa indicação).
|
Card |
---|
|
- Ajuste as configurações de memória na tag
|
|
...
...
É 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 |
---|
|
./jboss-cli.sh --controller="<ip-da-maquina>:9990" --connect --command="/host=master/server-config=fluig2:start" |
No Windows:
Bloco de código |
---|
|
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 |
---|
|
- Instale a aplicação pelo procedimento normal e siga as instruções até o procedimento antes de iniciar o servidor.
|
Card |
---|
|
- Abra em um editor de texto o arquivo
|
|
...
...
- instalação]/appserver/domain/configuration/host.xml.
|
|
...
- Localize a tag <servers>.
- Dentro dela haverão tags chamadas <server>. Altere o atributo
|
|
...
...
- 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 |
---|
|
Card |
---|
default | true |
---|
id | 1 |
---|
label | Passo 1 |
---|
|
|
Card |
---|
|
- 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 |
---|
| 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 |
|
|
...
...
/mod_lbmethod_byrequests.so |
|
|
...
- proxy (em geral isso é feito criando o arquivo /etc/apache2/sites-enabled/mod_
|
|
...
...
...
| 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 / |
|
|
...
...
...
...
</Location>
ProxyPass / balancer://mycluster/ stickysession=FLUIGCOOKIE nofailover=Off
ProxyPassReverse / |
|
|
...
...
...
asdfasdf
Configurando o apache mod_proxy
Abra o arquivo httpd.conf e adicione o seguinte código:
Aviso |
---|
| - 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 |
---|
| O procedimento abaixo deve ser realizado para utilizar o serviço de Realtime em Load balance. |
Bloco de código |
---|
| 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 |
---|
|
FLUIGCOOKIE=%{UNIQUE_ID}eSERVERID=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 |
| --18280node2
load1
BalancerMember http://{ip |
| --28080node3
load2
ProxySet stickysession= |
| FLUIGCOOKIE<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.
|
...