grafana/docs/sources/shared/upgrade/upgrade-common-tasks.md
Isabel be6b407d73
docs: What’s new & Upgrade guide 10.2 (#75909)
* Added 10.2 what's new and upgrade guide

* Fixed title and added guidance

* add: no basic role feature to whats new

* Revert "add: no basic role feature to whats new"

This reverts commit eb2e31c3dc.

* Add field min/max calculation to what's new

* refresh token handling

* update

* Remove whitespace

* Revert "Add field min/max calculation to what's new"

This reverts commit 9b66ddd0ec.

* Revert refresh token handling and move it to separate PR

* Docs: Add permission validation enabled by default to what's new (#76376)

* Add permission validation enabled by default to whats new

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* update

* Apply suggestions from code review

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Fix Grafana editions note

* run prettier

---------

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Fixed typo

* Docs: Add No basic role feature description (#76345)

* add whats next for cloud

* Update docs/sources/whatsnew/whats-new-next/index.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-next/index.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-next/index.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-next/index.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-next/index.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-next/index.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

---------

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Auth: Whats new v10.2 (#76369)

* add whatsnew auth

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

* Apply suggestions from code review

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* separate ds and db managed permissions whats new

* Apply suggestions from code review

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

---------

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* What's new in transformations 10.2 (#76430)

* first draft

* spelling

* Add doc links and images

* Fix relrefs

* Apply suggestions from code review

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Add information about availability

* update availability for string format transform

* add field from calc modifications

* Fixed link version syntax

* Apply suggestions from code review

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

---------

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
Co-authored-by: Victor Marin <victor.marin@grafana.com>

* Add field min/max calculation to what's new (#76401)

* Add field min/max calculation to what's new

* fix whitespace

* Fix which editions it's available in

* Apply suggestions from code review

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* change availability

* reduce image size

---------

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Removed What's new next addition from this PR

* Added alertmanager update (#76584)

* Added alertmanager update

* Fixed order of items

* Added availability info

* remove typo

Co-authored-by: Oscar Kilhed <oscar.kilhed@grafana.com>

* Remove heading formatting

* initial draft of dataviz squad deliverables for 10.2 whats new

* add dashgpt (#dashboard-ai) whats new draft

* What's New: Correlations in 10.2 (#76505)

* What's new about correlations

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update availability

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/whatsnew/whats-new-in-v10-2.md

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

---------

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Updated linking guidance in template and fixed links

* Fixed link

Co-authored-by: Kate Brenner <32871890+katebrenner@users.noreply.github.com>

* Docs: update whats new links (#76639)

Replaced relrefs with fully qualified URLs

* DashGPT: update availability status to public preview

* Update What's New to Include information on Timezone and Applicability changes in transformations (#76571)

* Update what's new

* Fix misspelling

* Update to fix wording

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Remove merge conflict flag

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Fix capitalization

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Fix wording

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Sentence casing

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Fix up wording

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Fix availability

* One last fix :)

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Fixed typo (I introduced!)

---------

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Docs: add Cloud what's new items to 10.2 what's new (#76642)

* Added Cloud what's new content

* Apply suggestions from code review

Co-authored-by: Jennifer Villa <jvilla2013@gmail.com>

* Updated link formatting

* Updated Browse Dashboards with the latest content

* Updated availability

* Updated wording

Co-authored-by: Haris Rozajac <58232930+harisrozajac@users.noreply.github.com>

* Fixed typo

Co-authored-by: Haris Rozajac <58232930+harisrozajac@users.noreply.github.com>

---------

Co-authored-by: Jennifer Villa <jvilla2013@gmail.com>
Co-authored-by: joshhunt <josh@trtr.co>
Co-authored-by: Haris Rozajac <58232930+harisrozajac@users.noreply.github.com>

* Fixed title

* Removed all editions language

* General edits

* Copy edits

* Fixed availability note

* Copy editing

Removed Visualize enum entry

Added sharing section

Added alerting entry

Added introduction

Made minor copy edits

* Fixed capitalization

* Fixed typo

* add CTA and gif to AI features

* update recorded queries text

* Update edition availability

Cloud permissions were missing (even though this is an OSS release I think it's important to include details about Cloud availability) and some features listed the wrong availability.

* reorder topics for emphasis

Emphasize the most exciting improvements

* add links to feature toggle docs

* move recorded queries

* update wording and titles for readability

* add visualization media

* update wording in dataviz section

* dashgpt: finalize whats new for 10.2 (finally) 😬

* Fixed typo

* DataViz: finalize whats new content 😬

* Copy edits

* update enterprise ds availability

* Update whats-new-in-v10-2.md

* Fixed style issues and availability note

* Added missing Alerting items

* Updated availability note

* Fixed styling

* Reverted what's new link to relref

* update availability of No Basic Role

I consulted with Eric before making this change.

* Removed item not going out in this release

* Update Alerting items

* Fixed linting

---------

Co-authored-by: Eric Leijonmarck <eric.leijonmarck@gmail.com>
Co-authored-by: Oscar Kilhed <oscar.kilhed@grafana.com>
Co-authored-by: Mihaly Gyongyosi <mgyongyosi@users.noreply.github.com>
Co-authored-by: Jo <joao.guerreiro@grafana.com>
Co-authored-by: Victor Marin <victor.marin@grafana.com>
Co-authored-by: nmarrs <nathanielmarrs@gmail.com>
Co-authored-by: Piotr Jamróz <pm.jamroz@gmail.com>
Co-authored-by: Kate Brenner <32871890+katebrenner@users.noreply.github.com>
Co-authored-by: Kyle Cunningham <codeincarnate@users.noreply.github.com>
Co-authored-by: Jennifer Villa <jvilla2013@gmail.com>
Co-authored-by: joshhunt <josh@trtr.co>
Co-authored-by: Haris Rozajac <58232930+harisrozajac@users.noreply.github.com>
Co-authored-by: Mitch Seaman <mjseaman@users.noreply.github.com>
Co-authored-by: Mitchel Seaman <mitchel.seaman@gmail.com>
Co-authored-by: Miguel Palau <mpalauzarza@gmail.com>
2023-10-24 19:56:09 +03:00

4.9 KiB

labels title
products
enterprise
oss
Upgrade guide common tasks

Upgrade Grafana

The following sections provide instructions for how to upgrade Grafana based on your installation method.

Debian

To upgrade Grafana installed from a Debian package (.deb), complete the following steps:

  1. In your current installation of Grafana, save your custom configuration changes to a file named <grafana_install_dir>/conf/custom.ini.

    This enables you to upgrade Grafana without the risk of losing your configuration changes.

  2. Download the latest version of Grafana.

  3. Run the following dpkg -i command.

    wget <debian package url>
    sudo apt-get install -y adduser
    sudo dpkg -i grafana_<version>_amd64.deb
    

APT repository

To upgrade Grafana installed from the Grafana Labs APT repository, complete the following steps:

  1. In your current installation of Grafana, save your custom configuration changes to a file named <grafana_install_dir>/conf/custom.ini.

    This enables you to upgrade Grafana without the risk of losing your configuration changes.

  2. Run the following commands:

    sudo apt-get update
    sudo apt-get upgrade
    

Grafana automatically updates when you run apt-get upgrade.

Binary .tar file

To upgrade Grafana installed from the binary .tar.gz package, complete the following steps:

  1. In your current installation of Grafana, save your custom configuration changes to a file named <grafana_install_dir>/conf/custom.ini.

    This enables you to upgrade Grafana without the risk of losing your configuration changes.

  2. Download the binary .tar.gz package.

  3. Extract the downloaded package and overwrite the existing files.

RPM or YUM

To upgrade Grafana installed using RPM or YUM complete the following steps:

  1. In your current installation of Grafana, save your custom configuration changes to a file named <grafana_install_dir>/conf/custom.ini.

    This enables you to upgrade Grafana without the risk of losing your configuration changes.

  2. Perform one of the following steps based on your installation.

Docker

To upgrade Grafana running in a Docker container, complete the following steps:

  1. In your current installation of Grafana, save your custom configuration changes to a file named <grafana_install_dir>/conf/custom.ini.

    This enables you to upgrade Grafana without the risk of losing your configuration changes.

  2. Run a commands similar to the following commands.

    {{% admonition type="note" %}} This is an example. The parameters you enter depend on how you configured your Grafana container. {{% /admonition %}}

    docker pull grafana/grafana
    docker stop my-grafana-container
    docker rm my-grafana-container
    docker run -d --name=my-grafana-container --restart=always -v /var/lib/grafana:/var/lib/grafana grafana/grafana
    

Windows

To upgrade Grafana installed on Windows, complete the following steps:

  1. In your current installation of Grafana, save your custom configuration changes to a file named <grafana_install_dir>/conf/custom.ini.

    This enables you to upgrade Grafana without the risk of losing your configuration changes.

  2. Download the Windows binary package.

  3. Extract the contents of the package to the location in which you installed Grafana.

    You can overwrite existing files and folders, when prompted.

Mac

To upgrade Grafana installed on Mac, complete the following steps:

  1. In your current installation of Grafana, save your custom configuration changes to a file named <grafana_install_dir>/conf/custom.ini.

    This enables you to upgrade Grafana without the risk of losing your configuration changes.

  2. Download the Mac binary package.

  3. Extract the contents of the package to the location in which you installed Grafana.

    You can overwrite existing files and folders, when prompted.

Update Grafana plugins

After you upgrade Grafana, we recommend that you update all plugins because a new version of Grafana can make older plugins stop working properly.

Run the following command to update plugins:

grafana cli plugins update-all