From 12a7b342b91e4e8cb23b7cfbe3a62754716ed6aa Mon Sep 17 00:00:00 2001 From: Vardan Torosyan Date: Tue, 26 Jan 2021 17:19:57 +0100 Subject: [PATCH] Licensing Docs: Adding license restrictions docs (#30216) --- docs/sources/enterprise/activate-license.md | 2 +- docs/sources/enterprise/license-expiration.md | 2 +- .../enterprise/license-restrictions.md | 49 +++++++++++++++++++ 3 files changed, 51 insertions(+), 2 deletions(-) create mode 100644 docs/sources/enterprise/license-restrictions.md diff --git a/docs/sources/enterprise/activate-license.md b/docs/sources/enterprise/activate-license.md index 69861b5d6d7..904cfc67529 100644 --- a/docs/sources/enterprise/activate-license.md +++ b/docs/sources/enterprise/activate-license.md @@ -2,7 +2,7 @@ title = "Activate an Enterprise license" description = "Activate an Enterprise license" keywords = ["grafana", "licensing", "enterprise"] -weight = 7 +weight = 100 +++ # Activate an Enterprise license diff --git a/docs/sources/enterprise/license-expiration.md b/docs/sources/enterprise/license-expiration.md index d2a242ff782..d2d8584dac4 100644 --- a/docs/sources/enterprise/license-expiration.md +++ b/docs/sources/enterprise/license-expiration.md @@ -2,7 +2,7 @@ title = "License Expiration" description = "" keywords = ["grafana", "licensing"] -weight = 8 +weight = 120 +++ # License expiration diff --git a/docs/sources/enterprise/license-restrictions.md b/docs/sources/enterprise/license-restrictions.md new file mode 100644 index 00000000000..aef95cf3b9e --- /dev/null +++ b/docs/sources/enterprise/license-restrictions.md @@ -0,0 +1,49 @@ ++++ +title = "License restrictions" +description = "Grafana Enterprise license restrictions" +keywords = ["grafana", "licensing", "enterprise"] +weight = 110 ++++ + +# License restrictions + +Enterprise licenses are limited by the number of active users, a license expiration date, and the URL of the Grafana instance. + +## User limits + +Grafana licenses allow for a certain number of active users per instance. An active user is any user that has signed in to Grafana within the past 30 days. + +In the context of licensing, each user is classified as either a viewer or an editor: + +- An editor is a user who has permission to edit and save a dashboard. Examples of editors are as follows: + - Grafana server administrators. + - Users who are assigned an organizational role of Editor or Admin. + - Users that have been granted Admin or Edit permissions at the dashboard or folder level. Refer to [Dashboard and folder permissions](https://grafana.com/docs/grafana/latest/permissions/dashboard_folder_permissions/). +- A viewer is a user with the Viewer role, which does not permit the user to save a dashboard. + +Restrictions are applied separately for viewers and editors. + +When the number of maximum active viewers or editors is reached, Grafana displays a warning banner. + +## Expiration date + +The license expiration date is the date when a license is no longer active. As the license expiration date approaches, Grafana Enterprise displays a banner. + +## License URL + +License URL is the root URL of your Grafana instance. The license will not work on an instance of Grafana with a different root URL. + +## Download a dashboard and folder permissions report + +This CSV report helps to identify users, teams, and roles that have been granted Admin or Edit permissions at the dashboard or folder level. + +To download the report: +1. Hover your cursor over the **Server Admin** (shield) icon in the side menu and then click **Licensing**. +2. At the bottom of the page, click **Download report**. + +## Update license restrictions + +To increase the number of licensed users within Grafana, extend a license, or change your licensed URL, contact [Grafana support](https://grafana.com/profile/org#support) or your Grafana Labs account team. They will update your license, which you can activate from within Grafana. + +For instructions on how to activate your license after it is updated, refer to +[Activate an Enterprise license]({{< relref "./activate-license.md" >}})