Convert a license type for Linux - Amazon License Manager
ConsiderationsUsing the License Manager consoleUsing the Amazon CLIRemove a subscription
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Convert a license type for Linux

You can use either the License Manager Console or the Amazon CLI to convert the license type of eligible Ubuntu LTS instances.

License type conversion considerations

Some of the considerations that license type conversion is subject to are listed as follows. This is not a comprehensive list and is subject to change.

  • The instance must be running Ubuntu LTS in order to convert the license type to Ubuntu Pro.

  • You can’t use license type conversion for a Ubuntu Pro subscription. To remove a Ubuntu Pro subscription, see Remove a Ubuntu Pro subscription.

  • Ubuntu Pro is not available as a Reserved Instance. For savings with On-Demand Instance pricing, we recommend that you use Ubuntu Pro with Savings Plans. For more information, see Reserved Instances in the Amazon EC2 User Guide and What are Savings Plans? in the Savings Plans User Guide.

Convert a license type using the License Manager console

You can use the License Manager console to convert a license type.

Note

Only instances that are in a stopped state and have been associated by Amazon Systems Manager Inventory are displayed.

To start a license type conversion in the console

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

  2. From the left navigation pane, choose License type conversion, then choose Create license type conversion.

  3. For Source operating system, choose the platform of the instance you want to convert:

    1. Ubuntu LTS

    2. Windows BYOL

    3. Windows license included

  4. (Optional) Filter the available instances by specifying a value for Instance ID or Usage operation value.

  5. Select the instances whose licenses you want to convert, and then choose Next.

  6. Enter the Usage operation value for the license type, select the license that you are converting to, and choose Next.

  7. Verify that you are satisfied with your license type conversion configuration and choose Start conversion.

You can view the status of your license type conversion from the license type conversion panel. The Conversion status column displays the status of the conversion as In progress, Completed, or Failed.

Convert a license type using the Amazon CLI

To start a license type conversion in the Amazon CLI, you should confirm the license type of your instance is eligible, and then perform a license type conversion to change to the required subscription. For more information on eligible subscription types, see Eligible subscription types for Linux.

Determine the license type of your instance

Verify that you have installed and set up the Amazon CLI. For more information, see Installing, updating, and uninstalling the Amazon CLI and Configuring the Amazon CLI.

Important

You might need to update the Amazon CLI to run certain commands and receive all required output in the following steps. Verify that you have permissions to run the create-license-conversion-task-for-resource Amazon CLI command. For more information, see Create IAM policies for License Manager.

To determine the license type currently associated with your instance, run the following Amazon CLI command. Replace the instance ID with the ID of the instance for which you want to determine the license type:

aws ec2 describe-instances --instance-ids <instance-id> --query "Reservations[*].Instances[*].{InstanceId: InstanceId, PlatformDetails: PlatformDetails, UsageOperation: UsageOperation, UsageOperationUpdateTime: UsageOperationUpdateTime}"

The following is an example response to the describe-instances command. The UsageOperation value is the billing information code associated with the license. A usage operation value of RunInstances indicates that the instance is using Amazon provided licensing. The UsageOperationUpdateTime is the time when the billing code was updated. For more information, see DescribeInstances in the Amazon EC2 API Reference.

"InstanceId": "i-0123456789abcdef",
"Platform details": "Linux/UNIX",
"UsageOperation": "RunInstances",
"UsageOperationUpdateTime: "2021-08-16T21:16:16.000Z"
Convert to Ubuntu Pro

When you convert your instance from Ubuntu LTS to Ubuntu Pro, you must have outbound internet access from the instance to retrieve a license token from the Canonical servers and have the Ubuntu Pro Client installed. For more information, see Conversion prerequisites.

To convert Ubuntu LTS to Ubuntu Pro:

  1. Run the following command from the Amazon CLI while specifying your instance’s ARN:

    aws license-manager create-license-conversion-task-for-resource \
    --resource-arn <instance_arn> \
    --source-license-context UsageOperation=RunInstances \
    --destination-license-context UsageOperation=RunInstances:0g00

  2. Run the following command from within the instance to retrieve details about your Ubuntu Pro subscription status:

    pro status

  3. Confirm your output indicates that the instance has a valid Ubuntu Pro subscription:

    Example output of the Ubuntu pro command with an active Ubuntu Pro subscription.

Remove a Ubuntu Pro subscription

License type conversion can only be used to convert from Ubuntu LTS to Ubuntu Pro. If you need to convert from Ubuntu Pro to Ubuntu LTS, you will need to raise a request to Amazon Web Services Support. For more information, see Creating a support case.