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

EAP doc section 24.2.3. "Configure TCPPING" should be updated with FRAG3 instead of FRAG2

    XMLWordPrintable

Details

    Description

      Issue description
      Customer has done manual tcping clustering configuration.

      He has followed Jboss EAP documentation, which is mentioning FRAG2 in the provided example [1].

      By default, RH-SSO is configured with FRAG3 as protocol used for fragmentation.

      Not having used FRAG3 but FRAG2 instead has led to major fragmentation and slowness issue on RH-SSO.

      So should JBoss EAP documentation (section 24.2.3. Configure TCPPING) be updated with FRAG3 instead of FRAG2 ? 

       

       

       

      JBoss EAP documentation providing example Frag2
      24.2.3. Configure TCPPING [1]

      ~~~

      # Define the socket bindings
      /socket-binding-group=standard-sockets/remote-destination-outbound-socket-binding=jgroups-host-a:add(host=HOST_A,port=7600)
      /socket-binding-group=standard-sockets/remote-destination-outbound-socket-binding=jgroups-host-b:add(host=HOST_B,port=7600)
      batch
      # Add the tcpping stack
      /subsystem=jgroups/stack=tcpping:add
      /subsystem=jgroups/stack=tcpping/transport=TCP:add(socket-binding=jgroups-tcp)
      /subsystem=jgroups/stack=tcpping/protocol=TCPPING:add(socket-bindings=[jgroups-host-a,jgroups-host-b])
      /subsystem=jgroups/stack=tcpping/protocol=MERGE3:add
      /subsystem=jgroups/stack=tcpping/protocol=FD_SOCK:add
      /subsystem=jgroups/stack=tcpping/protocol=FD_ALL:add
      /subsystem=jgroups/stack=tcpping/protocol=VERIFY_SUSPECT:add
      /subsystem=jgroups/stack=tcpping/protocol=pbcast.NAKACK2:add
      /subsystem=jgroups/stack=tcpping/protocol=UNICAST3:add
      /subsystem=jgroups/stack=tcpping/protocol=pbcast.STABLE:add
      /subsystem=jgroups/stack=tcpping/protocol=pbcast.GMS:add
      /subsystem=jgroups/stack=tcpping/protocol=MFC:add
      /subsystem=jgroups/stack=tcpping/protocol=FRAG2:add
      # Set tcpping as the stack for the ee channel
      /subsystem=jgroups/channel=ee:write-attribute(name=stack,value=tcpping)
      run-batch
      reload
      ~~~

       

       

      RH-SSO using FRAG3 as default

      RH-SSO 7.3 is specifying FRAG3 as default.

      extract from standalone.xml (same with domain.xml and standalone-ha.xml) 

      ~~~
      <stack name="tcp">
      <transport type="TCP" socket-binding="jgroups-tcp"/>
      <socket-protocol type="MPING" socket-binding="jgroups-mping"/>
      <protocol type="MERGE3"/>
      <protocol type="FD_SOCK"/>
      <protocol type="FD_ALL"/>
      <protocol type="VERIFY_SUSPECT"/>
      <protocol type="pbcast.NAKACK2"/>
      <protocol type="UNICAST3"/>
      <protocol type="pbcast.STABLE"/>
      <protocol type="pbcast.GMS"/>
      <protocol type="MFC"/>
      <protocol type="FRAG3"/>
      </stack>
      ~~~

       

       

       

      [1] https://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/7.3/html/configuration_guide/configuring_high_availability

       

       

      Attachments

        Issue Links

          Activity

            People

              gtrivedi@redhat.com Gaurav Trivedi
              pferraro@redhat.com Paul Ferraro
              Votes:
              0 Vote for this issue
              Watchers:
              5 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: