Red Hat Training

A Red Hat training course is available for Red Hat JBoss Operations Network

4.2. Creating Affinity Groups

An affinity group sets a preference for which JBoss ON servers manage which JBoss ON agents. An affinity group only sets a preference or hint for which server will manage the agent, not an absolute requirement. All agents are still managed within the JBoss ON server cloud, so any JBoss ON server can, theoretically, manage any JBoss ON agent based on the current load and performance.


Only agents have an affinity preference in high availability. This means that agents have a preference in which server they attempt to contact. JBoss ON uses two-way communication, however, so servers also contact agents. Servers — regardless of the partition or the agent affinity configuration — can contact any agent in JBoss ON even if the server is not in that agent's affinity group or if the server does not manage the agent.
The affinity groups page shows the number of agents and servers assigned to each affinity group.
Listing Affinity Groups

Figure 6. Listing Affinity Groups


An agent and a server can only belong to a single affinity group.
To create a new affinity group:


To edit an affinity group, click its name, then manage it the same as creating a new affinity group.
  1. Click the Administration tab in the top menu.
  2. In the Topology menu table on the left, select the Affinity Groups item.
  3. Click the CREATE NEW button.
  4. Enter a name for the new affinity group, and click OK.
  5. In the new affinity group's details page, click the EDIT GROUP AGENTS button.
  6. In the lower section, Agents not part of an affinity group, click the checkboxes by the agent names to add to the group, and click ADD TO GROUP.
  7. Click the Return to Affinity Group Link.
  8. As with the agents, click the EDIT GROUP SERVERS button to open the server lists and look at the list in the lower section of servers which do not currently belong to the affinity group. Click the checkboxes by the server names to add to the group, and click ADD TO GROUP.
Once both servers and agents have been added to the affinity group, the group is fully configured.