aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorTobias Trabelsi <64127335+tobias-trabelsi-sonarsource@users.noreply.github.com>2021-08-31 09:42:12 +0200
committersonartech <sonartech@sonarsource.com>2021-08-31 20:07:03 +0000
commitebd68e2246de9a17cfc62ed5dcc359f942640f0c (patch)
treea9c6d0650507f4b5c945550312ea70684bf09ced
parent1453abbd801e72b87b1b6b636967b91fcd865cc5 (diff)
downloadsonarqube-ebd68e2246de9a17cfc62ed5dcc359f942640f0c.tar.gz
sonarqube-ebd68e2246de9a17cfc62ed5dcc359f942640f0c.zip
SONAR-15251 additional documentation for upgrade and rollback
-rw-r--r--server/sonar-docs/src/pages/setup/upgrading.md31
1 files changed, 29 insertions, 2 deletions
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