SONAR-14759 Database schema upgrade can consume a lot of disk space

diff --git a/server/sonar-docs/src/pages/setup/upgrading.md b/server/sonar-docs/src/pages/setup/upgrading.md
index 080b8045e643017e9dda38784994710739718467..9f3d4b465d14e25e95f57af4bf8f5632c1360241 100644 (file)
--- a/server/sonar-docs/src/pages/setup/upgrading.md
+++ b/server/sonar-docs/src/pages/setup/upgrading.md
@@ -36,6 +36,9 @@ This is a generic guide for upgrading across versions of SonarQube. Carefully re
 [[warning]]
 | Before you start, back up your SonarQube Database. Upgrade problems are rare, but you'll want the backup if anything does happen.
 
+### Database disk usage recommendations
+During your upgrade, tables may be duplicated to speed up the migration process, and this could cause your database disk usage to double. Because of this, we recommend that your database disk usage is below 50% before starting a migration.
+
 ### Upgrading from the ZIP file
 
 1. Download and unzip the SonarQube distribution of your edition in a fresh directory, let's say `$NEW_SONAR_HOME`