Bug 862114

(3:47:27 PM) ccrouch: sunny-dee: can you point me at any docs we have around how agents get distributed HA JON servers by default
(4:20:44 PM) sunny-dee: yes, i have a link. hold on...
(4:22:45 PM) sunny-dee: ccrouch: this is what i have on HA in general: https://access.redhat.com/knowledge/docs/en-US/JBoss_Operations_Network/3.1/html/Admin_Configuring_JON_Servers_and_Agents/configuring-high-availability.html
(4:22:52 PM) sunny-dee: i think that's basically it

So looking at the page above, I think there could be clearer documentation around the default behaviour when agents connect to HA servers and no affinity group settings are used. This is the sentence I believe needs unpacking into several paragraphs and possibly some diagrams.

"Agents are handled by servers first based on a preference, or affinity, for a server because they belong to to the same affinity group. After affinity, or if an affinity group isn't configured, then agents are managed by the server in a round-robin style for availability."

I believe that in this situation the agents will become evenly distributed across the servers in the HA setup. Jay can correct me if I'm wrong and elaborate on any corner cases.

Also I believe we should define what we mean by "affinity group" before we use the term in the sentence above.

This BZ came up from talking to some Consultants who had gotten the wrong end of the stick about HA and were trying to use the affinity groups to produce the default behaviour.