diff --git a/docs/sources/administration/back-up-grafana/index.md b/docs/sources/administration/back-up-grafana/index.md new file mode 100644 index 00000000000..2c9286f0b0e --- /dev/null +++ b/docs/sources/administration/back-up-grafana/index.md @@ -0,0 +1,15 @@ +--- +description: Describes how to back up a locally provisioned Grafana instance. +keywords: + - grafana + - backup +labels: + products: + - enterprise + - oss +title: Back up Grafana +weight: 80 +menuTitle: Back up Grafana +--- + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" >}} diff --git a/docs/sources/shared/back-up/back-up-grafana.md b/docs/sources/shared/back-up/back-up-grafana.md new file mode 100644 index 00000000000..c12ec9c6d4c --- /dev/null +++ b/docs/sources/shared/back-up/back-up-grafana.md @@ -0,0 +1,77 @@ +--- +headless: true +labels: + products: + - enterprise + - oss +title: Back up Grafana +--- + +# Back up Grafana + +This topic explains how to back up a local Grafana deployment, including configuration, plugin data, and the Grafana database. + +## Back up the Grafana configuration file + +Copy Grafana configuration files that you might have modified in your Grafana deployment to a backup directory. + +The Grafana configuration files are located in the following directories: + +- Default configuration: `$WORKING_DIR/conf/defaults.ini` +- Custom configuration: `$WORKING_DIR/conf/custom.ini` + +{{% admonition type="note" %}} +If you installed Grafana using the `deb` or `rpm` packages, then your configuration file is located at +`/etc/grafana/grafana.ini`. This path is specified in the Grafana `init.d` script using `--config` file parameter. +{{% /admonition %}} + +## Back up plugin data + +Installing plugins in Grafana creates a folder for each plugin with its associated files and data. Copy all files and folders recursively from this location to your backup repository. + +The Grafana plugin files are located in the following directories: + +- Default location for plugins in a binary or source installation: `$WORKING_DIR/data/plugins` +- Default location for plugins in a `deb` or `rpm` package: `/var/lib/grafana/plugins`. This path is specified in the Grafana init.d script using `--config` file parameter. + +## Back up the Grafana database + +We recommend that you back up your Grafana database so that you can roll back to a previous version, if required. + +### SQLite + +The default Grafana database is SQLite, which stores its data in a single file on disk. To back up this file, copy it to your backup repository. + +{{% admonition type="note" %}} +To ensure data integrity, shut down your Grafana service before backing up the SQLite database. +{{% /admonition %}} + +The SQLite database file is located in one of the following directories: + +- Default location for SQLite data in a binary or source installation: `$WORKING_DIR/data/grafana.db` +- Default location for SQLite data in a `deb` or `rpm` package: `/var/lib/grafana/grafana.db`. This path is specified in the Grafana + init.d script using `--config` file parameter. + +### MySQL + +To back up or restore a MySQL Grafana database, run the following commands: + +```bash +backup: +> mysqldump -u root -p[root_password] [grafana] > grafana_backup.sql + +restore: +> mysql -u root -p grafana < grafana_backup.sql +``` + +### Postgres + +To back up or restore a Postgres Grafana database, run the following commands: + +```bash +backup: +> pg_dump grafana > grafana_backup + +restore: +> psql grafana < grafana_backup +``` diff --git a/docs/sources/shared/upgrade/intro.md b/docs/sources/shared/upgrade/intro.md new file mode 100644 index 00000000000..2f77e8a04ae --- /dev/null +++ b/docs/sources/shared/upgrade/intro.md @@ -0,0 +1,25 @@ +--- +headless: true +labels: + products: + - enterprise + - oss +title: Upgrade guide introduction +--- + +We recommend that you upgrade Grafana often to stay current with the latest fixes and enhancements. +Because Grafana upgrades are backward compatible, the upgrade process is straightforward, and dashboards and graphs will not change. + +In addition to common tasks you should complete for all versions of Grafana, there might be additional upgrade tasks to complete for a version. + +{{% admonition type="note" %}} +There might be breaking changes in some releases. We outline these changes in the [What's New ]({{< relref "../../whatsnew/" >}}) document for most releases or a separate [Breaking changes]({{< relref "../../breaking-changes/" >}}) document for releases with many breaking changes. +{{% /admonition %}} + +For versions of Grafana prior to v9.2, we published additional information in the [Release Notes]({{< relref "../../release-notes/" >}}). + +When available, we list all changes with links to pull requests or issues in the [Changelog](https://github.com/grafana/grafana/blob/main/CHANGELOG.md). + +{{% admonition type="note" %}} +When possible, we recommend that you test the Grafana upgrade process in a test or development environment. +{{% /admonition %}} diff --git a/docs/sources/shared/upgrade/upgrade-common-tasks.md b/docs/sources/shared/upgrade/upgrade-common-tasks.md index 7c46a9c9756..921911614ef 100644 --- a/docs/sources/shared/upgrade/upgrade-common-tasks.md +++ b/docs/sources/shared/upgrade/upgrade-common-tasks.md @@ -6,62 +6,6 @@ labels: title: Upgrade guide common tasks --- -We recommend that you upgrade Grafana often to stay current with the latest fixes and enhancements. -Because Grafana upgrades are backward compatible, the upgrade process is straightforward, and dashboards and graphs will not change. - -In addition to common tasks you should complete for all versions of Grafana, there might be additional upgrade tasks to complete for a version. - -{{% admonition type="note" %}} -There might be breaking changes in some releases. We outline these changes in the [What's New ]({{< relref "../../whatsnew/" >}}) document for most releases or a separate [Breaking changes]({{< relref "../../breaking-changes/" >}}) document for releases with many breaking changes. -{{% /admonition %}} - -For versions of Grafana prior to v9.2, we published additional information in the [Release Notes]({{< relref "../../release-notes/" >}}). - -When available, we list all changes with links to pull requests or issues in the [Changelog](https://github.com/grafana/grafana/blob/main/CHANGELOG.md). - -{{% admonition type="note" %}} -When possible, we recommend that you test the Grafana upgrade process in a test or development environment. -{{% /admonition %}} - -## Back up the Grafana database - -Although Grafana automatically upgrades the database on startup, we recommend that you back up your Grafana database so that you can roll back to a previous version, if required. - -### SQLite - -If you use SQLite, you only need to back up the `grafana.db` file. On Unix systems, the database file is usually located in `/var/lib/grafana/`. - -If you are unsure which database you use and where it is stored, check the Grafana configuration file. If you -installed Grafana to a custom location using a binary tar/zip, the database is usually located in `/data`. - -### MySQL - -To back up or restore a MySQL Grafana database, run the following commands: - -```bash -backup: -> mysqldump -u root -p[root_password] [grafana] > grafana_backup.sql - -restore: -> mysql -u root -p grafana < grafana_backup.sql -``` - -### Postgres - -To back up or restore a Postgres Grafana database, run the following commands: - -```bash -backup: -> pg_dump grafana > grafana_backup - -restore: -> psql grafana < grafana_backup -``` - -## Backup plugins - -We recommend that you back up installed plugins before you upgrade Grafana so that you can roll back to a previous version of Grafana, if necessary. - ## Upgrade Grafana The following sections provide instructions for how to upgrade Grafana based on your installation method. diff --git a/docs/sources/upgrade-guide/upgrade-v10.0/index.md b/docs/sources/upgrade-guide/upgrade-v10.0/index.md index 950dbac62e6..71d2d8536e7 100644 --- a/docs/sources/upgrade-guide/upgrade-v10.0/index.md +++ b/docs/sources/upgrade-guide/upgrade-v10.0/index.md @@ -16,6 +16,10 @@ weight: 1700 # Upgrade to Grafana v10.0 +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + {{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} ## Technical notes diff --git a/docs/sources/upgrade-guide/upgrade-v8.0/index.md b/docs/sources/upgrade-guide/upgrade-v8.0/index.md index d45173bd245..1fe76d493f7 100644 --- a/docs/sources/upgrade-guide/upgrade-v8.0/index.md +++ b/docs/sources/upgrade-guide/upgrade-v8.0/index.md @@ -16,6 +16,10 @@ weight: 2900 # Upgrade to Grafana v8.0 +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + {{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} ## Technical notes diff --git a/docs/sources/upgrade-guide/upgrade-v8.1/index.md b/docs/sources/upgrade-guide/upgrade-v8.1/index.md index da61cae71ab..2224f3afd68 100644 --- a/docs/sources/upgrade-guide/upgrade-v8.1/index.md +++ b/docs/sources/upgrade-guide/upgrade-v8.1/index.md @@ -16,6 +16,10 @@ weight: 2800 # Upgrade to Grafana v8.1 +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + {{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} ## Technical notes diff --git a/docs/sources/upgrade-guide/upgrade-v8.2/index.md b/docs/sources/upgrade-guide/upgrade-v8.2/index.md index 34efd605f51..853dadb8021 100644 --- a/docs/sources/upgrade-guide/upgrade-v8.2/index.md +++ b/docs/sources/upgrade-guide/upgrade-v8.2/index.md @@ -16,6 +16,10 @@ weight: 2700 # Upgrade to Grafana v8.2 +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + {{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} ## Technical notes diff --git a/docs/sources/upgrade-guide/upgrade-v8.3/index.md b/docs/sources/upgrade-guide/upgrade-v8.3/index.md index 6805e95fa94..8c3c7505852 100644 --- a/docs/sources/upgrade-guide/upgrade-v8.3/index.md +++ b/docs/sources/upgrade-guide/upgrade-v8.3/index.md @@ -16,6 +16,10 @@ weight: 2600 # Upgrade to Grafana v8.3 +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + {{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} ## Technical notes diff --git a/docs/sources/upgrade-guide/upgrade-v8.4/index.md b/docs/sources/upgrade-guide/upgrade-v8.4/index.md index 223c4dabba5..fc80102f0a0 100644 --- a/docs/sources/upgrade-guide/upgrade-v8.4/index.md +++ b/docs/sources/upgrade-guide/upgrade-v8.4/index.md @@ -16,6 +16,10 @@ weight: 2500 # Upgrade to Grafana v8.4 +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + {{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} ## Technical notes diff --git a/docs/sources/upgrade-guide/upgrade-v8.5/index.md b/docs/sources/upgrade-guide/upgrade-v8.5/index.md index 6ed2d4b455c..03ddd4ba4d6 100644 --- a/docs/sources/upgrade-guide/upgrade-v8.5/index.md +++ b/docs/sources/upgrade-guide/upgrade-v8.5/index.md @@ -16,6 +16,10 @@ weight: 2400 # Upgrade to Grafana v8.5 +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + {{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} ## Technical notes diff --git a/docs/sources/upgrade-guide/upgrade-v9.0/index.md b/docs/sources/upgrade-guide/upgrade-v9.0/index.md index 2786326c240..19706c2707f 100644 --- a/docs/sources/upgrade-guide/upgrade-v9.0/index.md +++ b/docs/sources/upgrade-guide/upgrade-v9.0/index.md @@ -16,6 +16,10 @@ weight: 2300 # Upgrade to Grafana v9.0 +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + {{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} ## Technical notes diff --git a/docs/sources/upgrade-guide/upgrade-v9.1/index.md b/docs/sources/upgrade-guide/upgrade-v9.1/index.md index ff78cf90eb3..a7a80023c9c 100644 --- a/docs/sources/upgrade-guide/upgrade-v9.1/index.md +++ b/docs/sources/upgrade-guide/upgrade-v9.1/index.md @@ -16,6 +16,10 @@ weight: 2200 # Upgrade to Grafana v9.1 +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + {{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} ## Technical notes diff --git a/docs/sources/upgrade-guide/upgrade-v9.2/index.md b/docs/sources/upgrade-guide/upgrade-v9.2/index.md index 9bba13e1c3d..584560f303b 100644 --- a/docs/sources/upgrade-guide/upgrade-v9.2/index.md +++ b/docs/sources/upgrade-guide/upgrade-v9.2/index.md @@ -16,6 +16,10 @@ weight: 2100 # Upgrade to Grafana v9.2 +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + {{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} ## Technical notes diff --git a/docs/sources/upgrade-guide/upgrade-v9.3/index.md b/docs/sources/upgrade-guide/upgrade-v9.3/index.md index 8869e87625c..c14f6f8814d 100644 --- a/docs/sources/upgrade-guide/upgrade-v9.3/index.md +++ b/docs/sources/upgrade-guide/upgrade-v9.3/index.md @@ -16,6 +16,10 @@ weight: 2000 # Upgrade to Grafana v9.3 +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + {{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} ## Technical notes diff --git a/docs/sources/upgrade-guide/upgrade-v9.4/index.md b/docs/sources/upgrade-guide/upgrade-v9.4/index.md index e47751c1168..8ab283d1659 100644 --- a/docs/sources/upgrade-guide/upgrade-v9.4/index.md +++ b/docs/sources/upgrade-guide/upgrade-v9.4/index.md @@ -16,6 +16,10 @@ weight: 1995 # Upgrade to Grafana v9.4 +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + {{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} ## Technical notes diff --git a/docs/sources/upgrade-guide/upgrade-v9.5/index.md b/docs/sources/upgrade-guide/upgrade-v9.5/index.md index f080e7af3d0..6da451e64c2 100644 --- a/docs/sources/upgrade-guide/upgrade-v9.5/index.md +++ b/docs/sources/upgrade-guide/upgrade-v9.5/index.md @@ -16,6 +16,10 @@ weight: 1800 # Upgrade to Grafana v9.5 +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + {{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} ## Technical notes