Uploaded image for project: 'JBoss Enterprise Application Platform'
  1. JBoss Enterprise Application Platform
  2. JBEAP-6357

Documentation Azure - Add note that if jgroups stack is using jgroups-tck socket binding with private interface then it must not be on 127.0.0.1 to work

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Done
    • Icon: Major Major
    • None
    • 7.0.0.GA
    • Documentation

      This should be added to chapter "6.2. Starting JBoss EAP High Availability" to [1]. In order for AZURE_PING protocol to work properly, the socket binding used by jgroups "tcp" stack with configured AZURE_PING protocol must not be bound to 127.0.0.1 (loopback). It must be bound to private interface of Azure container.

      Here is example of JGroups tck stack with azure_ping protocol. "jgroups-tcp" must use socket binding not bound to 127.0.0.1. In configuration below there must be set system property jboss.bind.address.private to private IP address of Azure container to make work.

      <subsystem xmlns="urn:jboss:domain:jgroups:4.0">
          <stacks>
          ...
      	<stack name="tcp">
      	    <transport type="TCP" socket-binding="jgroups-tcp"/>
      	    <protocol type="azure.AZURE_PING">
      		<property name="storage_account_name">${jboss.jgroups.azure_ping.storage_account_name}</property>
      		<property name="storage_access_key">${jboss.jgroups.azure_ping.storage_access_key}</property>
      		<property name="container">${jboss.jgroups.azure_ping.container}</property>
      		<property name="remove_all_files_on_view_change">true</property>
      	    </protocol>
      	    <protocol type="MERGE3"/>
      	    <protocol type="FD_SOCK" socket-binding="jgroups-tcp-fd"/>
      	    <protocol type="FD"/>
      	    <protocol type="VERIFY_SUSPECT"/>
      	    <protocol type="pbcast.NAKACK2"/>
      	    <protocol type="UNICAST3"/>
      	    <protocol type="pbcast.STABLE"/>
      	    <protocol type="pbcast.GMS">
      		<property name="max_join_attempts">3</property>
      	    </protocol>
      	    <protocol type="FRAG2"/>
      	</stack>
          </stacks>
      </subsystem>
      ...
      <interfaces>
      	...
              <interface name="private">
                  <inet-address value="${jboss.bind.address.private:127.0.0.1}"/>
              </interface>
      	...
      </interfaces>
      <socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:0}">
             ...
              <socket-binding name="jgroups-tcp" interface="private" port="7600"/>
             ...
      </socket-binding-group>
      

      [1] https://access.qa.redhat.com/documentation/en/red-hat-jboss-enterprise-application-platform/7.0/single/using-jboss-eap-on-microsoft-azure/

              lcosti.redhat Lucas Costi (Inactive)
              mnovak1@redhat.com Miroslav Novak
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated:
                Resolved: