3.2.8. Cambios del uso de clústers

3.2.8.1. Realizar cambios a su aplicación para uso de clústers

  1. Inicie JBoss EAP 6 con el uso de clústers habilitado

    Para habilitar el uso de clústers en JBoss EAP 5.x, necesitaba iniciar sus instancias del servidor usando el perfil all o alguna derivación de este así:
    $ EAP5_HOME/bin/run.sh -c all
    En JBoss EAP 6, el método para habilitar el clúster depende de si los servidores son autónomos o si están ejecutando en un dominio administrado.
    1. Habilite el clúster para los servidores ejecutando en un dominio administrado

      Para habilitar el uso de clústers para los servidores iniciados usando el controlador de dominio, actualice su domain.xml y designe un grupo de servidores para utilizar el perfil ha y el grupo de enlace de sockets ha-sockets. Por ejemplo:
      <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. Habilitación del uso de clústers para servidores autónomos

      Para habilitar los clústers para los servidores autónomos inicie el servidor usando el archivo de configuración apropiado así:
      $ EAP_HOME/bin/standalone.sh --server-config=standalone-ha.xml -Djboss.node.name=UNIQUE_NODE_NAME
  2. Especifique la dirección de enlace

    En JBoss EAP 5.x usualmente indicaría la dirección de enlace utilizada para el uso de clústers utilizando el argumento de la línea de comandos -b así:
    $ EAP5_HOME/bin/run.sh -c all -b 192.168.0.2
    JBoss EAP 6 enlaza sockets a las direcciones IP e interfaces que se encuentran en los elementos <interfaces> en los archivos standalone.xml, domain.xml y host.xml. Las configuraciones estándar que se envían junto con JBoss EAP incluyen dos configuraciones de interfaz:
    <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>
    Estas configuraciones de interfaz usan los valores de las propiedades del sistema jboss.bind.address.management y jboss.bind.address. Si estas propiedades del sistema no se establecen entonces se utiliza el valor predeterminado 127.0.0.1 para cada valor.
    También puede especificar la dirección de enlace como un argumento de la línea de comandos cuando inicia el servidor o puede definirla explícitamente dentro del archivo de configuración del servidor JBoss EAP 6.
    • Especifique el argumento de enlace en la línea de comandos cuando incia el servidor autónomo JBoss EAP.
      El siguiente es un ejemplo de cómo especificar la dirección de enlace en la línea de comandos para un servidor autónomo:
      EAP_HOME/bin/standalone.sh -Djboss.bind.address=127.0.0.1

      Nota

      También puede utilizar el argumento -b, el cual es un atajo para -Djboss.bind.address=127.0.0.1:
      EAP_HOME/bin/standalone.sh -b=127.0.0.1
      El formato de la sintaxis de JBoss EAP 5 todavía se soporta:
      EAP_HOME/bin/standalone.sh -b 127.0.0.1
      Note que el argumento -b solo cambia la interfaz public. No afecta la interfaz management.
    • Especifique la dirección de enlace en el archivo de configuración del servidor.
      Para los servidores ejecutando en un dominio administrado, especifique las direcciones de enlace en el archivo domain/configuration/host.xml. Para los servidores autónomos especifique las direcciones de enlace en el archivo standalone-ha.xml.
      En el siguiente ejemplo, la interfaz public se especifica como la interfaz predeterminada para todos los sockets dentro del grupo de enlace de sockets 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

      Si especifica la dirección de enlace como un valor definido en lugar de una propiedad del sistema en el archivo de configuración entonces no puede sobreescribirlo con un argumento de la línea de comandos.
  3. Configure jvmRoute para soportar mod_jk y mod_proxy

    En JBoss EAP 5, el servidor web jvmRoute se configuraba usando una propiedad en el archivo server.xml. En JBoss EAP 6, el atributo jvmRoute se configura en el subsistema web del archivo de configuración del servidor usando el atributo instance-id así:
    <subsystem xmlns="urn:jboss:domain:web:1.1" default-virtual-server="default-host" native="false" instance-id="{JVM_ROUTE_SERVER}">
    
    El {JVM_ROUTE_SERVER} anterior se debe reemplazar por el id del servidor jvmRoute server.
    El instance-id también se puede configurar usando la consola de administración.
  4. Especifique la dirección y puerto multicast

    En JBoss EAP 5.x puede especificar la dirección y puerto multicast utilizados para la comunicación interna del clúster usando los argumentos de la línea de comandos -u y -m respectivamente, así:
    $ EAP5_HOME/bin/run.sh -c all -u 228.11.11.11 -m 45688
    En JBoss EAP 6, la dirección multicast y el puerto utilizado para la comunicación intra-clúster se definen por medio del enlace de socket referenciado por la pila del protocolo JGroups relevante así:
    <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>
    
    Si prefiere especificar la dirección multicast y el puerto en la línea de comandos, puede definir la dirección multicast y los puertos como propiedades del sistema y luego usar esas propiedades en la línea de comandos cuando inicie el servidor. En el siguiente ejemplo, jboss.mcast.addr es el nombre de la variable para la dirección multicast y jboss.mcast.port es el nombre de la variable para el puerto.
    <socket-binding name="jgroups-udp" port="55200"
     multicast-address="${jboss.mcast.addr:230.0.0.4}" multicast-port="${jboss.mcast.port:45688}"/>
    
    Luego puede iniciar su servidor utilizando los siguientes argumentos de la línea de comandos:
    $ EAP_HOME/bin/domain.sh -Djboss.mcast.addr=228.11.11.11 -Djboss.mcast.port=45688
  5. Use una pila opcional del protocolo

    En JBoss EAP 5.x, puede manipular la pila predeterminada del protocolo utilizada para todos los servicios de clúster usando la propiedad del sistema jboss.default.jgroups.stack.
    $ EAP5_HOME/bin/run.sh -c all -Djboss.default.jgroups.stack=tcp
    En JBoss EAP 6, la pila predeterminada del protocolo es definida por el subsistema JGroups dentro de domain.xml o standalone-ha.xml:
    <subsystem xmlns="urn:jboss:domain:jgroups:1.0" default-stack="udp">
        <stack name="udp">
            <!-- ... -->
        </stack>
    </subsystem>
  6. Reemplazar la replicación de compañeros

    JBoss EAP 5.x utilizaba JBoss Cache Buddy Replication para eliminar la replicación de datos en todas las instancias en un clúster.
    En JBoss EAP 6, la replicación de compañeros fue reemplazada por el caché distribuído de Infinispan también conocido como el modo DIST. La distribución es un modo de uso de clústers poderoso, el cual le permite a Infinispan el escalar linearmente cuando se agregan mas servidores al clúster. El siguiente es un ejemplo de cómo configurar el servidor para utilizar el modo de caché DIST.
    1. Abra una línea de comandos e inicie el servidor con el perfil HA o Full Profile, por ejemplo:
      EAP_HOME/bin/standalone.sh -c standalone-ha.xml
    2. Abra otra línea de comandos y conéctese al CLI de administración.
      • Para Linux, ingrese lo siguiente en la línea de comandos:
        $ EAP_HOME/bin/jboss-cli.sh --connect
        
      • Para Windows, ingrese lo siguiente en la línea de comandos:
        C:\>EAP_HOME\bin\jboss-cli.bat --connect
        
      Debe ver la siguiente respuesta:
      Conectado a un controlador autónomo en localhost:9999
    3. Emita los siguientes 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
      
      Debe ver la siguiente respuesta después de cada comando:
      "outcome" => "success"
      
      Estos comandos modifican el elemento dist <distributed-cache> en la configuración web <cache-container> en el subsistema infinispan del archivo standalone-ha.xml así:
      <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>
      
      Para mayor información consulte el capítulo titulado Clústers en aplicaciones web en la Guía de desarrollo para JBoss EAP 6 que se encuentra en el portal del cliente en https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.