Conversion prerequisites - AWS License Manager
GeneralWindowsLinux

Conversion prerequisites

To convert license types with License Manager, there are general and operating system specific prerequisites.

General

You must meet the following general prerequisites before performing a license type conversion:

  • Your AWS account must be onboarded to License Manager. See Getting started with AWS License Manager.

  • The target instance must be in the stopped state before you convert the license type. For more information, see Stop and start your instance in the Amazon EC2 User Guide.

  • If stop protection is enabled on the target instance, the conversion process will fail. For more information, see Troubleshooting license type conversion.

  • The target instance must be configured with AWS Systems Manager Inventory. For more information, see Setting up Systems Manager for EC2 instances and AWS Systems Manager Inventory in the AWS Systems Manager User Guide.

  • Your user or role must have the following permissions:

    • ssm:GetInventory

    • ssm:StartAutomationExecution

    • ssm:GetAutomationExecution

    • ssm:SendCommand

    • ssm:GetCommandInvocation

    • ssm:DescribeInstanceInformation

    • ec2:DescribeImages

    • ec2:DescribeInstances

    • ec2:StartInstances

    • ec2:StopInstances

    • license-manager:CreateLicenseConversionTaskForResource

    • license-manager:GetLicenseConversionTask

    • license-manager:ListLicenseConversionTasks

    • license-manager:GetLicenseConfiguration

    • license-manager:ListUsageForLicenseConfiguration

    • license-manager:ListLicenseSpecificationsForResource

    • license-manager:ListAssociationsForLicenseConfiguration

    • license-manager:ListLicenseConfigurations

    For more information about Systems Manager Inventory, see AWS Systems Manager Inventory.

Windows

Windows instances must meet the following prerequisites:

  • Instances that were originally launched from an Amazon provided Amazon Machine Image (AMI) are not eligible for license type conversion to BYOL. The original Amazon EC2 instance must be launched from your own virtual machine (VM) image. For more information about converting a VM to Amazon EC2, see VM Import/Export.

  • To change your SQL Server license to BYOL, SQL Server must have been installed using your own media.

Linux

Linux instances must meet the following prerequisites:

  • Instances must be running Ubuntu LTS.

  • The Ubuntu Pro Client must be installed in your Ubuntu operating system.

    • Run the following command to confirm if the Ubuntu Pro Client is installed:

      pro --version

    • If the command is not found, or the version needs to be updated, run the following command to install the Ubuntu Pro Client:

      apt-get update && apt-get dist-upgrade

  • Instances must be able to reach multiple endpoints to activate their Ubuntu Pro subscription and receive updates. You must allow outbound traffic from your instance over TCP port 443 to reach the following endpoints:

    • contracts.canonical.com – Used for Ubuntu Pro activation.

    • esm.ubuntu.com – Used for APT repository access for most services.

    • api.snapcraft.io – Used for installing and running snaps.

    • dashboard.snapcraft.io – Used for installing and running snaps.

    • login.ubuntu.com – Used for installing and running snaps.

    • cloudfront.cdn.snapcraftcontent.com – Used for downloading from content development networks (CDNs).

    • livepatch.canonical.com – Used for downloading patches from the Livepatch server.

    For more information, see Ubuntu Pro Client network requirements in the Ubuntu Pro Client documentation and Network requirements in the Canonical Snapcraft documentation.