rgw: add documentation for upgrading with rgw_region_root_pool

Signed-off-by: Orit Wasserman <owasserm@redhat.com>

diff --git a/doc/radosgw/upgrade_to_jewel.rst b/doc/radosgw/upgrade_to_jewel.rst
index dbe1f741f2ae6786d92f907e877d92ae1a830c8f..ecd8e01e0764d00face293f33ce8f25c9ef90cb0 100644 (file)
--- a/doc/radosgw/upgrade_to_jewel.rst
+++ b/doc/radosgw/upgrade_to_jewel.rst
@@ -9,12 +9,18 @@ Upgrade of :term:`Ceph Object Gateway` to older versions of jewel (up to 10.2.3
 Mixed version of :term:`Ceph Object Gateway` is not supported
 
 Backup of old configuration
-================
+===========================
 rados mkpool .rgw.root.backup
 rados cppool .rgw.root .rgw.root.backup
 
+Non default setting for `rgw region root pool`
+==============================================
+If an existing multisite configuration uses a non-default setting for
+`rgw region root pool`, the new pool settings `rgw zonegroup root pool`,
+`rgw period root pool` and `rgw realm root pool` should be set to match.
+
 Fix confgiuration after upgrade
-================
+===============================
 Stop all :term:`Ceph Object Gateway` running in the cluster.
 
 Run the following commands:::