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