RepoMirrors/ceph
1
0
Fork 0
mirror of https://github.com/ceph/ceph synced 2025-03-31 07:53:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge PR #21263 into master

Browse Source 
* refs/pull/21263/head:
	doc: outline upgrade procedure for mds cluster

Reviewed-by: Douglas Fuller <dfuller@redhat.com>
This commit is contained in:
Patrick Donnelly 2018-04-09 08:59:11 -07:00
commit 3ab655b55d
No known key found for this signature in database
GPG Key ID: 3A2A7E25BEA8AADB
1 changed files with 48 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
doc/cephfs/upgrading.rst
View File

@ -1,3 +1,51 @@
Upgrading the MDS Cluster
=========================
Currently the MDS cluster does not have built-in versioning or file system
flags to support seamless upgrades of the MDSs without potentially causing
assertions or other faults due to incompatible messages or other functional
differences. For this reason, it's necessary during any cluster upgrade to
reduce the number of active MDS for a file system to one first so that two
active MDS do not communicate with different versions. Further, it's also
necessary to take standbys offline as any new CompatSet flags will propogate
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:
::
ceph fs set <fs_name> max_mds 1
2. Deactivate all non-zero ranks, from the highest rank to the lowest, while waiting for each MDS to finish stopping:
::
ceph mds deactivate <fs_name>:<n>
ceph status # wait for MDS to finish stopping
3. Take all standbys offline, e.g. using systemctl:
::
systemctl stop ceph-mds.target
ceph status # confirm only one MDS is online and is active
4. Upgrade the single active MDS, e.g. using systemctl:
::
systemctl restart ceph-mds.target
5. Upgrade/start the standby daemons.
6. Restore the previous max_mds for your cluster:
::
ceph fs set <fs_name> max_mds <old_max_mds>
Upgrading pre-Firefly filesystems past Jewel
============================================