Docs: Update debian-ubuntu installation instructions (#20875)
* Update debian-ubuntu installation Major rework of debian.md, minor updates to a configuration.md and upgrading.md. * updated docs Updated per Torkel's comments * Update debian.md Added wget to common properties install command * Update docs/sources/installation/debian.md Co-Authored-By: Dan Cech <dcech@grafana.com> * Update docs/sources/installation/debian.md Co-Authored-By: Dan Cech <dcech@grafana.com> * Update docs/sources/installation/debian.md Co-Authored-By: Dan Cech <dcech@grafana.com> * Update docs/sources/installation/debian.md Co-Authored-By: Dan Cech <dcech@grafana.com> * Update docs/sources/installation/debian.md Co-Authored-By: Dan Cech <dcech@grafana.com> * Update docs/sources/installation/debian.md Co-Authored-By: Dan Cech <dcech@grafana.com> * Update docs/sources/installation/debian.md Co-Authored-By: Dan Cech <dcech@grafana.com> * Apply suggestions from code review Co-Authored-By: Dan Cech <dcech@grafana.com> * Update upgrading.md * Update upgrading.md * Update debian.md Added ARM link
This commit is contained in:
Diana Payton
Dan Cech
@@ -1,21 +1,21 @@
|
||||
+++
|
||||
title = "Upgrading"
|
||||
description = "Upgrading Grafana guide"
|
||||
title = "Upgrade Grafana"
|
||||
description = "Guide for upgrading Grafana"
|
||||
keywords = ["grafana", "configuration", "documentation", "upgrade"]
|
||||
type = "docs"
|
||||
[menu.docs]
|
||||
name = "Upgrading"
|
||||
name = "Upgrade Grafana"
|
||||
identifier = "upgrading"
|
||||
parent = "installation"
|
||||
weight = 800
|
||||
+++
|
||||
|
||||
# Upgrading Grafana
|
||||
# Upgrade Grafana
|
||||
|
||||
We recommend everyone to upgrade Grafana often to stay up to date with the latest fixes and enhancements.
|
||||
We recommend that you upgrade Grafana often to stay up to date with the latest fixes and enhancements.
|
||||
In order make this a reality, Grafana upgrades are backward compatible and the upgrade process is simple and quick.
|
||||
|
||||
Upgrading is generally always safe (between many minor and one major version) and dashboards and graphs will look the same. There can be minor breaking changes in some edge cases which are usually outlined in the [Release Notes](https://community.grafana.com/c/releases) and [Changelog](https://github.com/grafana/grafana/blob/master/CHANGELOG.md)
|
||||
Upgrading is generally safe (between many minor and one major version) and dashboards and graphs will look the same. There may be minor breaking changes in some edge cases, which are outlined in the [Release Notes](https://community.grafana.com/c/releases) and [Changelog](https://github.com/grafana/grafana/blob/master/CHANGELOG.md)
|
||||
|
||||
## Update plugins
|
||||
|
||||
@@ -58,29 +58,41 @@ restore:
|
||||
> psql grafana < grafana_backup
|
||||
```
|
||||
|
||||
### Ubuntu / Debian
|
||||
### Ubuntu or Debian
|
||||
|
||||
If you installed grafana by downloading a debian package (`.deb`) you can just follow the same installation guide
|
||||
and execute the same `dpkg -i` command but with the new package. It will upgrade your Grafana install.
|
||||
You can upgrade Grafana by following the same procedure as when you installed it.
|
||||
|
||||
If you used our APT repository:
|
||||
#### Upgrade Debian package
|
||||
|
||||
If you installed Grafana by downloading a Debian package (`.deb`), then you can execute the same `dpkg -i` command but with the new package. It will upgrade your Grafana installation.
|
||||
|
||||
Go to the [download page](https://grafana.com/grafana/download?platform=linux) for the latest download
|
||||
links.
|
||||
|
||||
```bash
|
||||
wget <debian package url>
|
||||
sudo apt-get install -y adduser libfontconfig1
|
||||
sudo dpkg -i grafana_<version>_amd64.deb
|
||||
```
|
||||
|
||||
#### Upgrade from APT repository
|
||||
|
||||
If you installed Grafana from our APT repository, then Grafana will automatically update when you run apt-get upgrade to upgrade all system packages.
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install grafana
|
||||
```
|
||||
|
||||
#### Upgrading from binary tar file
|
||||
#### Upgrade from binary .tar file
|
||||
|
||||
If you downloaded the binary tar package you can just download and extract a new package
|
||||
and overwrite all your existing files. But this might overwrite your config changes. We
|
||||
recommend you place your config changes in a file named `<grafana_install_dir>/conf/custom.ini`
|
||||
as this will make upgrades easier without risking losing your config changes.
|
||||
If you downloaded the binary `.tar.gz` package, then you can just download and extract the new package and overwrite all your existing files. However, this might overwrite your config changes.
|
||||
|
||||
We recommend that you save your custom config changes in a file named `<grafana_install_dir>/conf/custom.ini`.
|
||||
This allows you to upgrade Grafana without risking losing your configuration changes.
|
||||
|
||||
### Centos / RHEL
|
||||
|
||||
If you installed grafana by downloading a rpm package you can just follow the same installation guide
|
||||
and execute the same `yum install` or `rpm -i` command but with the new package. It will upgrade your Grafana install.
|
||||
If you installed Grafana by downloading an RPM package you can just follow the same installation guide and execute the same `yum install` or `rpm -i` command but with the new package. It will upgrade your Grafana installation.
|
||||
|
||||
If you used our YUM repository:
|
||||
|
||||
@@ -101,10 +113,7 @@ docker run --name=my-grafana-container --restart=always -v /var/lib/grafana:/var
|
||||
|
||||
### Windows
|
||||
|
||||
If you downloaded the Windows binary package you can just download a newer package and extract
|
||||
to the same location (and overwrite the existing files). This might overwrite your config changes. We
|
||||
recommend you place your config changes in a file named `<grafana_install_dir>/conf/custom.ini`
|
||||
as this will make upgrades easier without risking losing your config changes.
|
||||
If you downloaded the Windows binary package you can just download a newer package and extract to the same location (and overwrite the existing files). This might overwrite your config changes. We recommend that you save your config changes in a file named `<grafana_install_dir>/conf/custom.ini` as this will make upgrades easier without risking losing your config changes.
|
||||
|
||||
## Upgrading from 1.x
|
||||
|
||||
@@ -116,9 +125,7 @@ We are not aware of any issues upgrading directly from 2.x to 4.x but to be on t
|
||||
|
||||
## Upgrading to v5.0
|
||||
|
||||
The dashboard grid layout engine has changed. All dashboards will be automatically upgraded to new
|
||||
positioning system when you load them in v5. Dashboards saved in v5 will not work in older versions of Grafana. Some
|
||||
external panel plugins might need to be updated to work properly.
|
||||
The dashboard grid layout engine has changed. All dashboards will be automatically upgraded to new positioning system when you load them in v5. Dashboards saved in v5 will not work in older versions of Grafana. Some external panel plugins might need to be updated to work properly.
|
||||
|
||||
For more details on the new panel positioning system, [click here]({{< relref "../reference/dashboard.md#panel-size-position" >}})
|
||||
|
||||
|
||||
Reference in New Issue
Block a user