doc: add note about disabling standby-replay during upgrades

Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
(cherry picked from commit 29b4c0d9d5a9bb48fd54d17d050c5baa8e7660ff)

diff --git a/PendingReleaseNotes b/PendingReleaseNotes
index 463d2951c63ff2d82cd6a4a7384fb4870bc19397..fc46b7336130a0edd81f8e4f4416e9f6f9d7b377 100644 (file)
--- a/PendingReleaseNotes
+++ b/PendingReleaseNotes
@@ -1,5 +1,8 @@
 >=16.0.0
 --------
+* CephFS: Disabling allow_standby_replay on a file system will also stop all
+  standby-replay daemons for that file system.
+
 * New bluestore_rocksdb_options_annex config parameter. Complements
   bluestore_rocksdb_options and allows setting rocksdb options without repeating
   the existing defaults.

diff --git a/doc/cephfs/upgrading.rst b/doc/cephfs/upgrading.rst
index 8820ee855b6f1f3b21bc4fd918239776b7e4e1f5..3966079d364cfb4eac452647ed32cefcc8bb9863 100644 (file)
--- a/doc/cephfs/upgrading.rst
+++ b/doc/cephfs/upgrading.rst
@@ -12,45 +12,60 @@ via the MDSMap to all MDS and cause older MDS to suicide.
 
 The proper sequence for upgrading the MDS cluster is:
 
-1. Reduce the number of ranks to 1:
+1. Disable and stop standby-replay daemons.
+
+::
+
+    ceph fs set <fs_name> allow_standby_replay false
+
+In Pacific, the standby-replay daemons are stopped for you after running this
+command. Older versions of Ceph require you to stop these daemons manually.
+
+::
+
+    ceph fs dump # find standby-replay daemons
+    ceph mds fail mds.<X>
+
+
+2. Reduce the number of ranks to 1:
 
 ::
 
     ceph fs set <fs_name> max_mds 1
 
-2. Wait for cluster to stop non-zero ranks where only rank 0 is active and the rest are standbys.
+3. Wait for cluster to stop non-zero ranks where only rank 0 is active and the rest are standbys.
 
 ::
 
     ceph status # wait for MDS to finish stopping
 
-3. Take all standbys offline, e.g. using systemctl:
+4. Take all standbys offline, e.g. using systemctl:
 
 ::
 
     systemctl stop ceph-mds.target
 
-4. Confirm only one MDS is online and is rank 0 for your FS:
+5. Confirm only one MDS is online and is rank 0 for your FS:
 
 ::
 
     ceph status
 
-5. Upgrade the single active MDS, e.g. using systemctl:
+6. Upgrade the single active MDS, e.g. using systemctl:
 
 ::
 
     # use package manager to update cluster
     systemctl restart ceph-mds.target
 
-6. Upgrade/start the standby daemons.
+7. Upgrade/start the standby daemons.
 
 ::
 
     # use package manager to update cluster
     systemctl restart ceph-mds.target
 
-7. Restore the previous max_mds for your cluster:
+8. Restore the previous max_mds for your cluster:
 
 ::