3.2.8. Alterações de Clustering
3.2.8.1. Realize Alterações ao seu Aplicativo para o Clustering
Inicie o JBoss EAP 6 com o clustering habilitado
Para habilitar o clustering no JBoss EAP 5.x, era necessário iniciar suas instâncias do servidor usando o perfilallou alguma derivação do mesmo, como por exemplo:$ EAP5_HOME/bin/run.sh -c allNo JBoss EAP 6, o método para a habilitação do clustering depende dos servidores serem autônomos ou serem executados num managed domain.Habilitação do cluster para servidores executando num managed domain
Para habilitar o clustering para servidores iniciados usando o domain controller, atualize o seudomain.xmle determine um grupo de servidor para uso do seu perfilhae grupo socket bindingha-sockets. Por exemplo:<server-groups> <server-group name="main-server-group" profile="ha"> <jvm name="default"> <heap size="64m" max-size="512m"/> </jvm> <socket-binding-group ref="ha-sockets"/> </server-group> </server-group>Habilitação do cluster para servidores autônomos
Inicie o servidor usando o arquivo de configuração apropriado conforme a seguinte amostra de habilitação do cluster para servidores autônomos:$ EAP_HOME/bin/standalone.sh --server-config=standalone-ha.xml -Djboss.node.name=UNIQUE_NODE_NAME
Especificação do endereço bind
No JBoss EAP 5.x, você normalmente indica o endereço bind usado para clustering usando o argumento da linha de comando-b, conforme abaixo:$ EAP5_HOME/bin/run.sh -c all -b 192.168.0.2OJBoss EAP 6 realiza o bind sockets nos endereços IP e interfaces contidas nos elementos<interfaces>dos arquivosstandalone.xml,domain.xmlehost.xml. As configurações padrões que lançam o JBoss EAP incluem duas configurações de interface:<interfaces> <interface name="management"> <inet-address value="${jboss.bind.address.management:127.0.0.1}"/> </interface> <interface name="public"> <inet-address value="${jboss.bind.address:127.0.0.1}"/> </interface> </interfaces>Essas configurações de interface usam valores dojboss.bind.address.managementejboss.bind.addressde propriedades de sistema. Caso as propriedades de sistema não sejam determinadas, o default127.0.0.1é usado para cada valor.O endereço bind pode ser definido como um argumento da linha de comando quando você inicia o servidor ou você pode explicitamente defini-lo com o arquivo de configuração do servidor do JBoss EAP 6.- Especifique o argumento bind na linha de comando quando iniciando o servidor autônomo do JBoss EAP.Segue abaixo uma amostra de como especificar o endereço bind na linha de comando para o servidor autônomo:
EAP_HOME/bin/standalone.sh -Djboss.bind.address=127.0.0.1Nota
É possível usar o argumento-b, que é um atalho para o-Djboss.bind.address=127.0.0.1:EAP_HOME/bin/standalone.sh -b=127.0.0.1O formato de sintaxe JBoss EAP 5 também é suportado:
Perceba que o argumentoEAP_HOME/bin/standalone.sh -b 127.0.0.1-bapenas modifica as alterações da interfacepublic. Isto não afeta a interfacemanagement. - Especifique o endereço bind no arquivo de configuração do servidor.Especifique os endereços bind no arquivo
domain/configuration/host.xmlpara servidores executando num managed domain. Para servidores autônomos, especifique os endereços bind no arquivostandalone-ha.xml.A interfacepublicna seguinte amostra é especificada como interface default para todos os sockets do grupo socket bindingha-sockets.<interfaces> <interface name="management"> <inet-address value="192.168.0.2"/> </interface> <interface name="public"> <inet-address value="192.168.0.2"/> </interface> </interfaces><socket-binding-groups> <socket-binding-group name="ha-sockets" default-interface="public"> <!-- ... --> </socket-binding-group> </socket-binding-groups>Nota
Caso o endereço bind for especificado como um valor codificado ao invés de uma propriedade de sistema no arquivo de configuração, não será possível substituí-lo num argumento da linha de comando.
Configure o
jvmRoutepara suportar o mod_jk e mod_proxyNo JBoss EAP 5, o servidor da webjvmRoutefoi configurado usando a propriedade no arquivoserver.xml. No JBoss EAP 6, o atributojvmRouteé configurado no subsistema da web do arquivo de combinação do servidor usando o atributoinstance-id, conforme o seguinte:<subsystem xmlns="urn:jboss:domain:web:1.1" default-virtual-server="default-host" native="false" instance-id="{JVM_ROUTE_SERVER}">O {JVM_ROUTE_SERVER} acima deve ser substituído pela ID do servidor jvmRoute.Oinstance-idpode ser determinado usando o Management Console.Especificação do endereço multicast e porta
No JBoss EAP 5.x, é possível especificar a porta e o endereço multicast usados para a comunicação de intra-cluste usando os argumentos-ue-mda linha de comando, conforme abaixo:$ EAP5_HOME/bin/run.sh -c all -u 228.11.11.11 -m 45688No JBoss EAP 6, o endereço e porta multicast usados para a comunicação do cluster são definidos pelo socket-binding referenciado pela pilha do protocolo JGroups relevante, conforme abaixo:<subsystem xmlns="urn:jboss:domain:jgroups:1.0" default-stack="udp"> <stack name="udp"> <transport type="UDP" socket-binding="jgroups-udp"/> <!-- ... --> </stack> </subsystem><socket-binding-groups> <socket-binding-group name="ha-sockets" default-interface="public"> <!-- ... --> <socket-binding name="jgroups-udp" port="55200" multicast-address="228.11.11.11" multicast-port="45688"/> <!-- ... --> </socket-binding-group> </socket-binding-groups>Caso você preferir especificar o endereço multicast e a porta na linha de comando, você pode definir o endereço multicast e as portas como propriedades de sistema e usá-las na linha de comando quando você iniciar o servidor. A seguinte amostra,jboss.mcast.addré o nome da variável para o endereço multicast e ojboss.mcast.porté o nome da variável para a porta.<socket-binding name="jgroups-udp" port="55200" multicast-address="${jboss.mcast.addr:230.0.0.4}" multicast-port="${jboss.mcast.port:45688}"/>Você pode iniciar o seu servidor usando os seguintes argumentos da linha de comando:$ EAP_HOME/bin/domain.sh -Djboss.mcast.addr=228.11.11.11 -Djboss.mcast.port=45688Uso da pilha de protocolo alternativo
No JBoss EAP 5.x, é possível manipular a pilha do protocolo default para todos os serviços de clustering usando a propriedade de sistemajboss.default.jgroups.stack.$ EAP5_HOME/bin/run.sh -c all -Djboss.default.jgroups.stack=tcpNo JBoss EAP 6, a pilha do protocolo default é definida pelo subsistema JGroups com odomain.xmloustandalone-ha.xml:<subsystem xmlns="urn:jboss:domain:jgroups:1.0" default-stack="udp"> <stack name="udp"> <!-- ... --> </stack> </subsystem>Substituição da Replicação Buddy
O JBoss EAP 5.x usava o JBoss Cache Buddy Replication para suprimir a replicação de dados de todas as instâncias num cluster.No JBoss EAP 6, o Buddy Replication foi substituído pelo cache distribuído do Infinispan, também conhecido como modoDIST. A distribuição é um modo de clustering que permite o Infinispan escalar linearmente com mais servidores que são adicionados ao cluster. Segue abaixo uma amostra de como configurar o servidor para uso no modo de DIST caching.- Abra a linha de comando e inicie o servidor com tanto o Perfil Completo ou HA. Por exemplo:
EAP_HOME/bin/standalone.sh -c standalone-ha.xml
- Abra outra linha de comando e conecte-se ao Management CLI.
- Insira a seguinte linha de comando para o Linux:
$ EAP_HOME/bin/jboss-cli.sh --connect
- Insira a seguinte linha de comando para o Windows:
C:\>EAP_HOME\bin\jboss-cli.bat --connect
Você deverá observar a seguinte resposta:Conectado ao controlador autônomo no localhost:9999
- Adicione os seguintes comandos:
/subsystem=infinispan/cache-container=web/:write-attribute(name=default-cache,value=dist) /subsystem=infinispan/cache-container=web/distributed-cache=dist/:write-attribute(name=owners,value=3) :reload
Você deverá ver a seguinte resposta após cada comando:"outcome" => "success"
Esses comandos modificam o elementodist<distributed-cache>na configuraçãoweb<cache-container>do subsistemainfinispando arquivostandalone-ha.xml, conforme abaixo:<cache-container name="web" aliases="standard-session-cache" default-cache="dist" module="org.jboss.as.clustering.web.infinispan"> <transport lock-timeout="60000"/> <replicated-cache name="repl" mode="ASYNC" batching="true"> <file-store/> </replicated-cache> <replicated-cache name="sso" mode="SYNC" batching="true"/> <distributed-cache name="dist" owners="3" l1-lifespan="0" mode="ASYNC" batching="true"> <file-store/> </distributed-cache> </cache-container>Refira-se ao capítulo nomeado Clustering nos Aplicativos da Web no Guia de Desenvolvimento do JBoss EAP 6 localizado no Portal do Cliente https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/ para maiores informações a este respeito.