Red Hat JBoss Enterprise Application Platform Administration I

A server group is a logical grouping of servers in a Red Hat JBoss Enterprise Application Platform (JBoss EAP) managed domain. You manage the server group as a single unit. The server groups are defined and managed by the domain controller, but each individual server is managed by the respective host controllers. Each secondary host controller communicates with the domain controller, and ensures that all the servers within a managed domain have the same configuration.

Each server group is assigned a unique profile. A profile consists of a list of JBoss EAP subsystems and their configuration.

Server groups are configured in the domain.xml file on the domain controller. Red Hat recommends creating and managing the server groups by using the JBoss EAP management console or the management CLI.

You can create server groups in a managed domain in the Runtime section of the management console.

Figure 5.5: Server groups view in the Runtime page

You must provide the following three key attributes to add a new server group:

Figure 5.6: Creating a server group

To remove a server group, ensure that there are no servers assigned to the server group. If there are servers assigned, stop them, and then remove the servers from the server group. Finally, remove the server group.

Figure 5.7: Removing a server group

You can create server groups by using the JBoss EAP management CLI.

The server groups are configured in the /server-group namespace of the management CLI. The management CLI implements commands to create, view, modify, and remove server groups in this namespace. To add a new server group, run the following command:

[domain@workstation:9990 /] /server-group=Group1:add\
(profile=full,socket-binding-group=full-sockets)
{
    "outcome" => "success",
    ...
}

You can verify the existing server groups by using the read-resource operation in the management CLI:

[domain@workstation:9990 /] /server-group=Group1:read-resource
{
    "outcome" => "success",
    "result" => {
        "management-subsystem-endpoint" => false,
        "profile" => "default",
        "socket-binding-default-interface" => undefined,
        "socket-binding-group" => "standard-sockets",
        "socket-binding-port-offset" => 0,
        "deployment" => undefined,
        "deployment-overlay" => undefined,
        "jvm" => undefined,
        "system-property" => undefined
    }
}

To remove a server group, ensure that there are no servers assigned to the server group. Then run the following command:

[domain@workstation:9990 /] /server-group=Group1:remove()
{
    "outcome" => "success",
    ...
}

You define server groups in a managed domain in the domain.xml configuration file of the domain controller by using the <server-groups> element. The child element <server-group> within the <server-groups> parent element can be used to define a server group. For example:

<server-groups>
  <server-group name="main-server-group" profile="default">  
      <jvm name="default"> 
        ...
      </jvm>
      <socket-binding-group ref="standard-sockets"> 
      <deployments> 
        ...
      </deployments>
  </server-group>
</server-groups>