3.2.8. Alterações de Clustering

3.2.8.1. Realize Alterações ao seu Aplicativo para o Clustering

  1. 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 perfil all ou alguma derivação do mesmo, como por exemplo: 
    $ EAP5_HOME/bin/run.sh -c all
    No JBoss EAP 6, o método para a habilitação do clustering depende dos servidores serem autônomos ou serem executados num managed domain.

    1. Habilitação do cluster para servidores executando num managed domain

      Para habilitar o clustering para servidores iniciados usando o domain controller, atualize o seu domain.xml e determine um grupo de servidor para uso do seu perfil ha e grupo socket binding ha-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>

    2. 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

  2. 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.2
    OJBoss EAP 6 realiza o bind sockets nos endereços IP e interfaces contidas nos elementos <interfaces> dos arquivos standalone.xml, domain.xml e host.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 do jboss.bind.address.management e jboss.bind.address de propriedades de sistema. Caso as propriedades de sistema não sejam determinadas, o default 127.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.1

      Nota

      É 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.1
      O formato de sintaxe JBoss EAP 5 também é suportado: 
      EAP_HOME/bin/standalone.sh -b 127.0.0.1
      Perceba que o argumento -b apenas modifica as alterações da interface public. Isto não afeta a interface management.
    • Especifique o endereço bind no arquivo de configuração do servidor.
      Especifique os endereços bind no arquivo domain/configuration/host.xml para servidores executando num managed domain. Para servidores autônomos, especifique os endereços bind no arquivo standalone-ha.xml.
      A interface public na seguinte amostra é especificada como interface default para todos os sockets do grupo socket binding ha-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.

  3. Configure o jvmRoute para suportar o mod_jk e mod_proxy

    No JBoss EAP 5, o servidor da web jvmRoute foi configurado usando a propriedade no arquivo server.xml. No JBoss EAP 6, o atributo jvmRoute é configurado no subsistema da web do arquivo de combinação do servidor usando o atributo instance-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.
    O instance-id pode ser determinado usando o Management Console.

  4. 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 -u e -m da linha de comando, conforme abaixo: 
    $ EAP5_HOME/bin/run.sh -c all -u 228.11.11.11 -m 45688
    No 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 o jboss.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=45688

  5. Uso 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 sistema jboss.default.jgroups.stack. 
    $ EAP5_HOME/bin/run.sh -c all -Djboss.default.jgroups.stack=tcp
    No JBoss EAP 6, a pilha do protocolo default é definida pelo subsistema JGroups com o domain.xml ou standalone-ha.xml: 
    <subsystem xmlns="urn:jboss:domain:jgroups:1.0" default-stack="udp">
    <stack name="udp">
        <!-- ... -->
    </stack>
</subsystem>

  6. 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 modo DIST. 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.
    1. 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
    2. 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
    3. 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 elemento dist <distributed-cache> na configuração web <cache-container> do subsistema infinispan do arquivo standalone-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.
Reportar um erro