From: Tobias Trabelsi <64127335+tobias-trabelsi-sonarsource@users.noreply.github.com>
Date: Tue, 31 Aug 2021 07:42:12 +0000 (+0200)
Subject: SONAR-15251 additional documentation for upgrade and rollback
X-Git-Tag: 9.1.0.47736~69
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=ebd68e2246de9a17cfc62ed5dcc359f942640f0c;p=sonarqube.git

SONAR-15251 additional documentation for upgrade and rollback
---

diff --git a/server/sonar-docs/src/pages/setup/upgrading.md b/server/sonar-docs/src/pages/setup/upgrading.md
index 8d6760b3940..2ef48b33106 100644
--- a/server/sonar-docs/src/pages/setup/upgrading.md
+++ b/server/sonar-docs/src/pages/setup/upgrading.md
@@ -59,9 +59,36 @@ To upgrade SonarQube using the Docker image:
 
 No specific Docker operations are needed, just use the new tag.
 
-## Upgrading from the Helm Chart
+## Upgrading from the Helm Chart 
 
-Follow the instructions in the **Upgrade** section of the SonarQube Helm Chart repository [README](https://github.com/SonarSource/helm-chart-sonarqube/tree/master/charts/sonarqube).
+[[info]]
+| If you're upgrading with an Oracle database or you're using plugins, you can reuse your extensions PVC from the previous version to avoid moving plugins or drivers. Use the [Compatibility Matrix](https://docs.sonarqube.org/display/PLUG/Plugin+Version+Matrix) to ensure that your plugins are compatible with your version. Analysis of all languages provided by your edition is available by default without plugins.
+
+To upgrade SonarQube using our official Helm Chart:
+
+1. Change the SonarQube version on your `values.yaml`.
+
+2. Redeploy SonarQube with the same helm chart:
+
+	```bash
+	helm upgrade --install -f values.yaml -n <your namespace> <your release name> <path to sonarqube helm chart>
+	```
+
+3. Go to `http://yourSonarQubeServerURL/setup` and follow the setup instructions.
+
+4. Reanalyze your projects to get fresh data.
+
+## Rollback
+
+If you need to revert to the previous version of SonarQube, the high-level rollback procedure for all deployments is as follows: 
+
+1. Shutdown your SonarQube instance/cluster.
+
+2. Roll back your database to the backup you took before starting the upgrade.
+
+3. Switch back to the previous version of your SonarQube installation.
+
+4. Start your SonarQube instance/cluster.
 
 ## Changing your edition