1+++ 2title = "Activate a Grafana Enterprise license from AWS Marketplace on EKS" 3description = "Activate a Grafana Enterprise license from AWS Marketplace on EKS" 4keywords = ["grafana", "enterprise", "aws", "marketplace", "eks", "activate"] 5aliases = ["/docs/grafana/latest/enterprise/activate-aws-marketplace-license/activate-license-on-eks"] 6weight = 200 7+++ 8 9# Activate a Grafana Enterprise license from AWS Marketplace on EKS 10 11If you have purchased a Grafana Enterprise subscription through AWS Marketplace, you must activate it in order to use Grafana Enterprise data source plugins and features in Grafana. 12 13## Before you begin: 14 15- Purchase a subscription to [Grafana Enterprise from AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-dlncd4kzt5kx6). 16- Be sure that the IAM user that was used to purchase Grafana Enterprise has permission to manage subscriptions, create new IAM users and roles, and create access policies. 17 18To activate your license, complete the following tasks: 19 20## Task 1: Deploy Grafana Enterprise on Amazon EKS 21 221. Deploy Grafana Enterprise on Amazon EKS. 23 24 For more information about deploying an application on Amazon EKS, refer to [Getting started with Amazon EKS – AWS Management Console and AWS CLI](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-console.html). 25 26 For more information about installing Grafana on Kubernetes using the Helm Chart, refer to the [Grafana Helm Chart](https://github.com/grafana/helm-charts/tree/main/charts/grafana#readme). 27 281. Use `kubectl set image deployment/my-release grafana=grafana/grafana-enterprise:<version>` to update the container image to Grafana Enterprise version 8.3.0 or later. 29 30 For example, enter `grafana/grafana-enterprise:8.3.3`. 31 32> Only Grafana Enterprise versions 8.3.0 and later support licenses granted through AWS Marketplace. 33 34## Task 2: Configure Grafana for high availability 35 36Grafana requires that you configure a database to hold dashboards, users, and other persistent data. 37 38### Before you begin 39 40- Ensure that you have a supported Grafana database available. 41 - For a list of supported databases, refer to [Supported databases]({{< relref "../../../installation/requirements.md#supported-databases" >}}). 42 - For information about creating a database, refer to [Creating an Amazon RDS DB instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html). 43- Review the information required to connect to the RDS DB instance. For more information, refer to [Connecting to an Amazon RDS DB instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_CommonTasks.Connect.html). 44 45To configure Grafana for high availability, choose **one** of the following options: 46 47- **Option 1:** Use `kubectl edit configmap grafana` to edit `grafana.ini` add the following section to the configuration: 48 49 ``` 50 [database] 51 type = [database type] 52 host = [database address and port] 53 name = [database name] 54 user = [database username] 55 password = [database password] 56 ``` 57 58- **Option 2:** use `kubectl edit deployment my-release` to edit the pod `env` variables and add the following database variables: 59 60 ``` 61 - name: GF_DATABASE_TYPE 62 value: [database type] 63 - name: GF_DATABASE_HOST 64 value: [database address and port] 65 - name: GF_DATABASE_NAME 66 value: [database name] 67 - name: GF_DATABASE_USER 68 value: [database username] 69 - name: GF_DATABASE_PASSWORD 70 value: [database password] 71 ``` 72 73For more information on Grafana High Availability setup, refer to [Set up Grafana for high availability]({{< relref "../../../administration/set-up-for-high-availability.md" >}}). 74 75## Task 3: Configure Grafana Enterprise to validate its license with AWS 76 77In this task, you configure Grafana Enterprise to validate the license with AWS instead of Grafana Labs. 78 791. In AWS IAM, assign the following permissions to the Node IAM role (if you are using a Node Group), or the Pod Execution role (if you are using a Fargate profile): 80 81 - `"license-manager:CheckoutLicense"` 82 - `"license-manager:ListReceivedLicenses"` 83 - `"license-manager:GetLicenseUsage"` 84 - `"license-manager:CheckInLicense"` 85 86 For more information about creating an access policy, refer to [Creating IAM policies (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html). 87 88 For more information about AWS license permissions, refer to [Actions, resources, and condition keys for AWS License Manager](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awslicensemanager.html). 89 901. Choose **one** of the following options to update the [license_validation_type]({{< relref "../../enterprise-configuration.md#license_validation_type" >}}) configuration to `aws`: 91 92 - **Option 1:** Use `kubectl edit configmap grafana` to edit `grafana.ini` add the following section to the configuration: 93 94 ``` 95 [enterprise] 96 license_validation_type=aws 97 ``` 98 99 - **Option 2:** Use `kubectl edit deployment my-release` to edit the pod `env` variables and add the following variable: 100 101 ``` 102 name: GF_ENTERPRISE_LICENSE_VALIDATION_TYPE 103 value: aws 104 ``` 105 106### Task 4: Start or restart Grafana 107 108To activate Grafana Enterprise features, you must start (or restart) Grafana. 109 110To restart Grafana on a Kubernetes cluster, 111 1121. Run the command `kubectl rollout restart deployment my-release`. 113 1141. After you update the service, navigate to your Grafana instance, sign in with Grafana Admin credentials, and navigate to the Statistics and Licensing page to validate that your license is active. 115 116For more information about restarting Grafana, refer to [Restart Grafana]({{< relref "../../../installation/restart-grafana" >}}). 117 118> If you experience issues when you update the EKS cluster, refer to [Amazon EKS troubleshooting](https://docs.aws.amazon.com/eks/latest/userguide/troubleshooting.html). 119