Host resource groups in AWS License Manager - AWS License Manager

Host resource groups in AWS License Manager

Amazon EC2 Dedicated Hosts are physical servers with EC2 instance capacity fully dedicated to your use. A host resource group is a collection of Dedicated Hosts that you can manage as a single entity. As you launch instances, License Manager allocates the hosts and launches instances on them based on the settings that you configured. You can add existing Dedicated Hosts to a host resource group and take advantage of automated host management through License Manager. For more information, see Dedicated Hosts in the Amazon EC2 User Guide for Linux Instances.

You can use host resource groups to separate hosts by purpose, for example, development test hosts versus production, organizational unit, or license constraint. After you add a Dedicated Host to a host resource group, you cannot launch instances directly on the Dedicated Host, you must launch them using the host resource group.

Settings

You can configure the following settings for a host resource group:

  • Allocate hosts automatically–Indicates whether Amazon EC2 can allocate new hosts on your behalf if launching an instance in this host resource group would exceed its available capacity.

  • Release hosts automatically–Indicates whether Amazon EC2 can release unused hosts on your behalf. An unused host has no running instances.

  • Recover hosts automatically–Indicates whether Amazon EC2 can move instances from a host that has failed unexpectedly to a new host.

  • Associated self-managed licenses–The self-managed licenses that can be used to launch instances in this host resource group.

  • (Optional) Instance families–The types of instances that you can launch. By default, you can launch any instance types that are supported on a Dedicated Host. If you launch Nitro-based instances, then you can launch instances with different instance types in the same host resource group. Otherwise, you must launch only instances with the same instance type in the same host resource group.

Create a host resource group

Configure a host resource group to enable License Manager to manage your Dedicated Hosts. To best utilize your most expensive licenses, you can associate one or more core- or socket-based self-managed licenses with your host resource group. To best optimize host utilization, you can allow all core- or socket-based self-managed licenses with your host resource group.

To create a host resource group
  1. Open the License Manager console at https://console.aws.amazon.com/license-manager/.

  2. In the left navigation pane, choose Host resource groups.

  3. Choose Create host resource group.

  4. For Host resource group details, specify a name and description for the host resource group.

  5. For EC2 Dedicated Host management settings, enable or disable the following settings as needed:

    • Allocate hosts automatically

    • Release hosts automatically

    • Recover hosts automatically

  6. (Optional) For Additional settings, select the instance families that you can launch in the host resource group.

  7. For self-managed licenses, select one or more core- or socket-based self-managed licenses.

  8. (Optional) For Tags, add one or more tags.

  9. Choose Create.

Adding Dedicated Hosts to a host resource group

You can add your existing hosts to a host resource group from the AWS Management Console, AWS CLI, or AWS API. To add your hosts, you must be the AWS account owner where you created the Dedicated Host and host resource groups. If your host resource group lists allowed self-managed licenses and instances types, the host you add must match these requirements.

Note

Suppose you stop the instances and want to restart them. You must perform the following two tasks:

  • Modify the instance to point to the host resource group.

  • Associate self-managed licenses to match the host resource group.

For more information about Resource Groups, see AWS Resource Groups User Guide.

Use the following steps to add one or more Dedicated Hosts to a resource group:

  1. Log into the License Manager console at https://console.aws.amazon.com/license-manager/.

  2. Choose Host Resource Groups.

  3. From the list of host resource group names, click on the name of the host resource group where you want to add the Dedicated Host.

  4. Choose Dedicated Hosts.

  5. Choose Add.

  6. Choose one or more Dedicated Hosts to add to the host resource group.

  7. Choose Add.

    Adding the host may take 1 - 2 minutes, and then it appears in the list of Dedicated Hosts.

Share a host resource group

You can use AWS Resource Access Manager to shared your host resource groups through AWS Organizations. After you share a host resource group and self-managed license, member accounts can launch instances into the shared host resource group. The new hosts are allocated in the account that owns the host resource group. The member account owns the instances. For more information, see the AWS RAM User Guide.

Launch an instance in a host resource group

When you launch an instance, you can specify a host resource group. For example, you can use the following run-instances command. You must associate a core- or socket-based self-managed license with the AMI.

aws ec2 run-instances --min-count 2 --max-count 2 \ --instance-type c5.2xlarge --image-id ami-0abcdef1234567890 \ --placement="Tenancy=host,HostResourceGroupArn=arn"

You can also use the Amazon EC2 console. For more information, see Launching Instances into a Host Resource Group in the Amazon EC2 User Guide.

Modify a host resource group

You can modify the settings for a host resource group at any time. You cannot set the host limit lower than the number of existing hosts in the host resource group. You cannot remove an instance type if there's an instance of that type running in the host resource group.

To modify a host resource group
  1. Open the License Manager console at https://console.aws.amazon.com/license-manager/.

  2. In the left navigation pane, choose Host resource groups.

  3. Select the host resource group and choose Actions, Edit.

  4. Modify the settings as needed.

  5. Choose Save changes.

Removing Dedicated Hosts from a host resource group

When you remove a host from the host resource group, the instance running on the host remains on the host. The instances attached to the host resource group remain associated with the group, and instances directly attached to the host through affinity maintain the same property. If you share the host resource group with other AWS accounts, License Manager automatically removes the shared host and consumers receive an eviction notice to move their instances from the host in 15 days. To work with a Dedicated Host that has been removed from a host resource group, see Work with Dedicated Hosts in the Amazon EC2 User Guide for Linux Instances.

Use the following steps to remove a Dedicated Host to a host resource group:

  1. Log into the License Manager console at https://console.aws.amazon.com/license-manager/.

  2. Choose Host Resource Groups.

  3. Click on the name of the host resource that you want to remove a Dedicated Host.

  4. Choose Dedicated Hosts.

  5. Choose the Dedicated Host to delete from the host resource group. Or, you can search for a Dedicated Host by host ID, host type, host state, or availability zone.

  6. Choose Remove.

  7. Choose Remove again to confirm.

Delete a host resource group

You can delete a host resource group if it has no hosts.

To delete a host resource group
  1. Open the License Manager console at https://console.aws.amazon.com/license-manager/.

  2. In the left navigation pane, choose Host resource groups.

  3. Select the host resource group and choose Actions, Delete.

  4. When prompted for confirmation, choose Delete.