From: Venky Shankar Date: Thu, 12 May 2022 06:52:06 +0000 (+0530) Subject: doc: add note about checking pending stray directory entries before initiating upgrade X-Git-Tag: v18.0.0~899^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=92724156e64038f7244f41368c7e3a730fc1ecb1;p=ceph.git doc: add note about checking pending stray directory entries before initiating upgrade Signed-off-by: Venky Shankar --- diff --git a/doc/releases/pacific.rst b/doc/releases/pacific.rst index d33ea3298634..2a4e83afaecf 100644 --- a/doc/releases/pacific.rst +++ b/doc/releases/pacific.rst @@ -974,6 +974,19 @@ recovering OSDs). (This is optional, but recommended.) <= 16.2.6, because this can lead to data corruption, details in https://tracker.ceph.com/issues/53062. +.. note:: + When using multiple active Ceph Metadata Servers, ensure that there are + no pending stray entries which are directories for active ranks except rank 0 as + starting an upgrade (which sets `max_mds` to 1) could crash the Ceph + Metadata Server. The following command should return zero (0) stray entries + for all stray directories:: + + # for idx in {0..9}; do ceph tell mds. dump tree ~mdsdir/stray$idx| jq '.[] | select (.nlink == 0 and .dir_layout.dir_hash > 0) | .stray_prior_path' | wc -l; done + + Ensure that all active ranks except rank 0 are checked for absence of stray + entries which are directories (using the above command). Details are captured + in http://tracker.ceph.com/issues/53597. + Upgrading cephadm clusters ~~~~~~~~~~~~~~~~~~~~~~~~~~