Set up resource groups

Goal

EGO comes with three default resource groups that have core services and sample applications registered to them. Out-of-the-box, there is also a basic consumer tree and resource plan. In this tutorial, you add a new resource group alongside the existing ones, but use the provided consumer tree and resource plan.

At a glance

Contents include the following:

  1. Recognize the default configurations

  2. Learn about resource groups

  3. Create a new resource group by host names

  4. Assign the new resource group to a consumer

  5. Update the resource plan with new resource group

1. Recognize the default configurations

To help orient you, here is a list of the default consumer tree, resource groups, and resource plan components you see and work with in the Platform Management Console:

  • Consumer tree: “ManagementServices” (with nested child consumer “EGOManagementServices”), “SampleApplications” (with nested child consumer “EclipseSamples”), and ClusterServices (with nested child consumer “EGOClusterServices”).

    In this tutorial, we work with the “SampleApplications” top-level consumer and its “EclipseSamples” sub-consumer.

  • Resource groups: “ComputeHosts” (executes workload units), “InternalResourceGroup” and “ManagementHosts” (run important EGO components and services).

    In this tutorial, we work with the “ComputeHosts” resource group, and create a new resource group.

  • Resource plan (default resource group upon opening page is “ComputeHosts”): Only consumers registered to a selected resource group show; select different resource groups to modify corresponding resource plans.

    In this tutorial, we update the resource plan to include the new resource group you create.

2. Learn about resource groups

Resource groups generally fall into one of three categories:

  • Resource groups that include compute hosts with certain identifiable attributes a consumer may require in a requested resource (for example, resources with large amounts of memory; considered “dynamic”—new hosts added to the cluster that meet the requirements are automatically added to the resource group)

  • Resource groups that only include certain compute hosts (for example, so that specified resources are accessed by approved consumers; considered “static”—any new hosts added to the cluster have to be manually added to the resource group)

  • Resource groups that encompass management hosts only (reserved for running services, not a distributed workload; for example, the out-of-the-box “ManagementHosts” group)

3. Create a new resource group by host names

You must be logged in as a cluster administrator and you should have already added most of your hosts to the cluster.

Create a new resource group from the Platform Management Console to ensure your consumers have the appropriate group of compute hosts available to them. Resource groups are often the easiest way to create a group of same-type hosts for a consumer. Resource groups are either defined by resource requirements (dynamic) or by host names (static).

  1. In the Platform Management Console, click Resources > Configure Resource Groups > Resource Groups.

    Out-of-the-box, existing resource groups include “ComputeHosts”, “InternalResourceGroup”, and “ManagementHosts”. DO NOT delete the “InternalResourceGroup” or “ManagementHosts” groups nor modify the existing EGO services registered to them.

  2. From the Global Actions drop-down list, select Create a Resource Group.

  3. Identify the new resource group in the top section of the Properties page:

    1. Specify a resource group name.

      Resource group names must consist of letters and numbers only (no spaces or special characters) and must be 64 characters or less.

    2. Include a description (max. 200-characters) of the resource group.

    3. Leave the default setting of 1 slot per CPU for Workload Slots (this defines how many slots per host you would like to have the system count; unless you are an advanced user, do not change this setting).

    4. For Resource Selection Method, select Static (List of Names).

      Static resource selection means that you are manually selecting specific hosts to belong to this resource group. Any new compute hosts that are later added to the cluster, and that you want to add to this resource group, must be manually added.

  4. Under Hosts to Show in List, select All hosts.

    A list of all hosts that belong to your cluster displays.

  5. Review the hosts found in your cluster:

    1. Click Member hosts to expand the section and review the hosts found in your cluster.

    2. Review your member hosts and select the hosts you want using the check boxes.

      If you select no member hosts, all hosts in your cluster are added to this resource group when you create it.

    3. Click Check for overlaps.

      If any hosts overlap, remove them from this resource group or remove them from the overlapping resource group.

      No hosts should overlap between resource groups. Resource groups are used to plan resource distribution in your resource plan. Having overlaps causes the hosts to be double-counted (or more) in the resource plan, resulting in recurring under-allocation of some consumers. The exception is with hosts listed in InternalResourceGroup—although all hosts in the cluster are listed here they are not “double-counted” in the resource plan.

  6. Click Create.

4. Assign the new resource group to a consumer

You need to assign new resource groups to consumers. Consumers must already exist and be a part of your consumer tree.

  1. Click Consumers > Consumers & Plans > Consumers.

  2. Select a consumer to assign the new resource group to.
    • If you have already created your consumer tree and modified the out-of-box structure, locate and click the consumer from tree to which you want to assign the new resource group.

    • If you have not modified the consumer tree, click SampleApplications from the consumer tree pane on the left to assign the new resource group to this consumer.

  3. Click Consumer Properties.

  4. Specify one or more resource groups that this consumer should have access to.

  5. Click Apply.

    The Consumer Properties page updates and your changes are saved.

5. Update the resource plan with new resource group

Any time you add or modify a resource group, you need to manage resource distribution for it using the resource distribution plan. If you have not yet created a new resource plan, or set up the provided out-of-box plan to meet your needs, do not complete this step.

  1. Click Consumers> Consumers & Plans > Resource Plan.

  2. Use the drop-down menu to switch between resource groups, and then modify your resource plan details for each resource group.

    Note:

    Resources groups that do not yet have consumers assigned to them do not appear in the drop-down menu. Consumers must first be assigned from the Consumers & Plans page.