3.2.7. Alterações de Clustering

Procedimento 3.22. 

1. Inicie o JBoss Enterprise Application Plataform 6 com o clustering ativado

   Para ativar o clustering no JBoss Enterprise Application Plataform 5.x, você precisava 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 Enterprise Application Plataform 6, o método para ativação do clustering depende dos servidores serem autônomos ou serem executados num storage domain.

   1. Ativação do cluster para servidores rodando num storage domain

      Para ativar o clustering para servidores iniciados usando o controlador do domain, atualize o seu domain.xml e determine um grupo de servidor para uso do seu perfil ha e grupo binding de socket 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. Ativação do cluster para servidores autônomos

      Para ativar o clustering para os servidores autônomos, inicie o servidor usando o arquivo de configuração apropriado conforme o seguinte: $ 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 Enterprise Application Plataform 5.x, você normalmente indicaria o endereço bind usado para o clustering usando o argumento da linha de comando -b parecido com: $ EAP_HOME/bin/run.sh -c all -b 192.168.0.2
   No JBoss Enteprise Application Plataform 6, os endereços bind são claramente definidos pelos bindings de sockets relevantes com os arquivos da configuração do JBoss Enterprise Application Plataform 6. Para os servidores iniciados usando o controlador do domain, os endereços bind são especificados com o arquivo domain/configuration/host.xml. Para os servidores autônomos, os endereços bind são especificados com o arquivo standalone-ha.xml:

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

   A interface public é especificada na amostra acima como interface default para todos os sockets com o grupo binding de socket ha-sockets.

3. Configure o jvmRoute para suportar o mod_jk e mod_proxy

   No JBoss Enterprise Application Plataform 5, o servidor da web jvmRoute foi configurado usando a propriedade no arquivo server.xml. No JBoss Enterprise Application Plataform 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 Enterprise Application Plataform 5.x, você pode especificar o endereço multicast e a porta usada para a comunicação infra-cluster usando os argumentos da linha de comando -u e -m, respectivamente, como por exemplo: $ EAP_HOME/bin/run.sh -c all -u 228.11.11.11 -m 45688
   No JBoss Enterprise Application Plataform 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ê inciar 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 inciar o seu servidor usando os 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 Enterprise Application Plataform 5.x, você pode manipular a pilha de protocolo default para todos os serviços de clustering usando a propriedade de sistema jboss.default.jgroups.stack. $ EAP_HOME/bin/run.sh -c all -Djboss.default.jgroups.stack=tcp
   No JBoss Enterprise Application Plataform 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>