Symantec Access Management

 View Only
  • 1.  Wildfly 8.x (JBOSS EAP 7) Unicast & File Replication "Chain" Clustering

    Posted Apr 11, 2018 03:30 PM



    While working with clients, both Amit Sinha sinam09 & I were reviewing the Identity Suite J2EE/Wildfly cluster configuration using the hornetq process.


    Hornetq provides two (2) types of clustering:  symmetric and chain.     Both provide reliability for SPOF (single point of failure).   Chain configuration requires minimal configuration; and lowers traffic between the # of cluster nodes.


    HornetQ User Manual 



    From analysis of the Identity Manager in a five (5) node cluster, we have created rules to assist with setup & validation of a cluster larger than two (2) nodes.




    1) Of the possible configuration, we selected Uni-Cast (TCP) over Multi-Cast (UDP) to avoid forcing all nodes to be on the same subnet.   This allows cluster nodes to reside on different network segments or even across a WAN (be aware of latency challenges due to global distances).


    2) Of the two (2) configuration to share data, between File Replication & Shared Storage, we chose "File Replication" to avoid the dependency and need to have a common NFS/SMB/other shared location between all the nodes.    We also wish to avoid any possible lock file concerns.


    3) When setting up a cluster, declare one of the nodes to be master, for the "standalone-full-ha-xml" file.    This file will be 99% the same for all cluster nodes.    This will help eliminate challenges due to incorrect formats between nodes.   This "master" file, with all of it's data sources pre-defined with hashed passwords, and any other updates will be copied to the remaining "cluster nodes".     


    4) Before starting the other nodes,

         a)  Three (3) updates will be done within the JBOSS_HOME/bin/ file for each node/server of the cluster.




    or be clever and use the ability to "run an executable command" in the shell script, e.g. `hostname` or `hostname -I`

    -  This will allow the "" file to be exactly the same between all cluster nodes.  


    JGROUPS_BIND_ADDRESS=`hostname -I`
    NODE_NAME=`hostname -I`
    BIND_ADDRESS=`hostname -I`


    Note:   This assumes that the other variables, in, have the same values.


    Example:  Shared Settings:  Define the other cluster members’ host names & the unicast port.   [All other values should be the same, just pulled these out to clarify.]



        b)   Six (6) updates will be done within the JBOSS_HOME/standalone/configuration/standalone-full-ha.xml file for each node/server of the cluster.   


    Chain cluster implies that each server is in a chain from a prior one to another one.




        <shared-store>true</shared-store>       [This is the confusing part, while this implies that a share storage is required, if the other values do not reference a remote storage location, then file-replication will be used.]
            <backup-group-name>node1</backup-group-name>    [unique name for each node1, use the defaults of “node1”, “node2”, “node3”, etc.


        <broadcast-group name="bg-group1">                  [aka   “LIVE” broadcast group]
        <broadcast-group name="bg-group2">
            <jgroups-channel>node1_live_to_node2_backup</jgroups-channel>     [Note this format; it is important!!!..    nodeN_live_to_node(N+1)_backup  ]


        <discovery-group name="dg-group1">
        <discovery-group name="dg-group2">
            <jgroups-channel>node1_live_to_node2_backup</jgroups-channel>     [SAME format as above for “LIVE” configuration]


    <hornetq-server name="backup">
        <backup-group-name>node2</backup-group-name>     [This name will be the “next” node in the chain, keep this naming format]
        <broadcast-group name="bg-group1">
            <jgroups-channel>node5_live_to_node1_backup</jgroups-channel>    [Note this format; it is important!!!..    node(N-1)_live_to_node(N)_backup  ]


        <discovery-group name="dg-group1">
            <jgroups-channel>node5_live_to_node1_backup</jgroups-channel>     [Note this format; it is important!!!..    node(N-1)_live_to_node(N)_backup  ]


    ####   If the node is the last node, then it MUST be the prior chain “node” for node1.      So for five (5) nodes, you would use node5,  for three (3) nodes, you would use node3; when updating the standalone-full-ha.xml for node1  ####    


    5) Validate the cluster by monitoring the following:


     a)   Monitor the J2EE server.log  / wildfly.log for any hornetq error messages   [expect to see start/shut down message but no others]


    b) Use the process to monitor the JMS queue

    Useful Wildfly/JBOSS CLI Monitoring Scripts 



    c) Exercise a use-case update within the IM User Console, with two (2) browser windows

          i.   Within the first browser, update an IM Admin Role description

         ii.    Within the 2nd browser, view the IM Admin Role to see if the description update can be seen.

              (If the cluster is setup correctly, then the 1st Wildfly serer would have sent a JMS message to the 2nd Wildfly server to tell it, to refresh itself from the IM objectstore.    If the cluster is NOT setup correctly, then the description will not have appeared to change. ]







    Alan & Amit sinam09






    Edit: 4/11/2018    Delta view of the two (2) files using open source WinMerge (for both & standalone-full-ha.xml).    WinMerge 




  delta between node1 and node2

       Note:   Three (3) deltas ONLY.    

       Note2:   May be zero (0) deltas if using the executable command `hostname -I` for the three (3) lines. delta between node 5 and node 1



    standalone-full-ha.xml   [ca-standalone-full-ha.xml]   delta between  node1 and node2  

    Note:   Six (6) Deltas ONLY





    standalone-full-ha.xml   [ca-standalone-full-ha.xml]   delta between  node5 and node1 

    Note:   Six (6) Deltas ONLY






    Edit:  7/24/2018    Added example of input files for five (5) nodes;  includes JMS and updates for data sources of TP/OS for the CA IM solution.

  • 2.  Re: Wildfly 8.x (JBOSS EAP 7) Unicast & File Replication "Chain" Clustering

    Posted Oct 30, 2018 11:29 AM



    Recently had to use the above process to address a challenge on the Identity Suite vApp, where the Wildfly standalone-full-ha.xml file was corrupt.   Instead of replacing it, the client wished to restart that node/server; and re-purpose it for alternative tier / component.   


    To adjust the remaining nodes, to correct the "chain" cluster, we build the following table, then built the correct batch input file to make these changes.




    See example under this note to update the Jboss/Wildfly cluster.

     *** Always use "batch" mode for scripts to avoid impacting dependencies of configuration objects.

    *** If script update a field with incorrect data, then the jboss/wildfly may not restart; which mean you can not use to re-edit that field (as jboss/wildfly has to be running); and would need to fall back to vi/editors (if you have access to the wildfly service id for the files).

    Database High Performance 







  • 3.  Re: Wildfly 8.x (JBOSS EAP 7) Unicast & File Replication "Chain" Clustering

    Posted Feb 28, 2019 11:55 PM

    Alan_Baugher, did you not experience the HQ222116 issue while running this or similar setups?

    I have been replicating this setup, but kept running into a HornetQ error that I finally tracked down to that issue.


    Ironically, only after I found the underlying problem, did I find that CA identified this issue in the 14.2 Platform and Support Matrix regarding WildFly 8.2.1: Server Environments - CA Identity Manager - 14.2 - CA Technologies Documentation:

    • Unicast with Replication configuration is not supported for Wildfly 8.2.x cluster due to a known bug with HornetQ in Wildfly 8.2.x. For more information, search for the Knowledge Base article with the number HQ222116 in the website

    I am stuck with WildFly 8.2.1 until CA releases Identity Manager that is certified to a later build.


    Do you have any ideas and/or workarounds?

  • 4.  Re: Wildfly 8.x (JBOSS EAP 7) Unicast & File Replication "Chain" Clustering

    Posted May 20, 2019 02:13 AM

    Hi Steve,


    I am exactly at same situation. Did you manage to get away with hq222117/hq222116 ?


    Please share details, if so.




  • 5.  Re: Wildfly 8.x (JBOSS EAP 7) Unicast & File Replication "Chain" Clustering
    Best Answer

    Posted May 20, 2019 08:46 AM

    Hi Sai, I ended up reconfiguring my environment back to multicast to avoid the issue altogether.


    Until CA releases a new platform that supports something newer than the four year old WildFly version, I'm afraid you have no fixes coming your way. If you need unicast, you'll have to wait until Q3 I've been told.

    I hope that they will keep up with WildFly/JBoss develoments, and make us wait another 4/5 years. This is painful.