From eba25becb89317b29febbf92f473bac658381c7a Mon Sep 17 00:00:00 2001 From: Patrick Donnelly Date: Tue, 16 Mar 2021 08:31:48 -0700 Subject: [PATCH] doc: add note about disabling standby-replay during upgrades Signed-off-by: Patrick Donnelly (cherry picked from commit 29b4c0d9d5a9bb48fd54d17d050c5baa8e7660ff) --- PendingReleaseNotes | 3 +++ doc/cephfs/upgrading.rst | 29 ++++++++++++++++++++++------- 2 files changed, 25 insertions(+), 7 deletions(-) diff --git a/PendingReleaseNotes b/PendingReleaseNotes index 463d2951c63..fc46b733613 100644 --- 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 8820ee855b6..3966079d364 100644 --- 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 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. + + +2. Reduce the number of ranks to 1: :: ceph fs set 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: :: -- 2.47.3