From 8c7999d0f42397b9b09a03d8d85b409f01bedf6d Mon Sep 17 00:00:00 2001 From: Adam Kupczyk Date: Wed, 1 Jul 2020 23:09:17 +0200 Subject: [PATCH] os/bluestore: Add documentation for large bluefs log recovery Adds additional paragraph to ceph-bluestore-tool documentation, describing how to use *special* options --bluefs_replay_recovery and --bluefs_replay_recovery_disable_compact to recover large bluefs log. Fixes: https://tracker.ceph.com/issues/46714 Signed-off-by: Adam Kupczyk --- doc/man/8/ceph-bluestore-tool.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/man/8/ceph-bluestore-tool.rst b/doc/man/8/ceph-bluestore-tool.rst index 0ad5c20c3d60..667c330de925 100644 --- a/doc/man/8/ceph-bluestore-tool.rst +++ b/doc/man/8/ceph-bluestore-tool.rst @@ -152,6 +152,21 @@ BlueStore OSD with the *prime-osd-dir* command:: ceph-bluestore-tool prime-osd-dir --dev *main device* --path /var/lib/ceph/osd/ceph-*id* +BlueFS log rescue +===================== + +Some versions of BlueStore were susceptible to BlueFS log growing extremaly large - +beyond the point of making booting OSD impossible. This state is indicated by +booting that takes very long and fails in _replay function. + +This can be fixed by:: + ceph-bluestore-tool fsck --path *osd path* --bluefs_replay_recovery=true + +It is advised to first check if rescue process would be successfull:: + ceph-bluestore-tool fsck --path *osd path* \ + --bluefs_replay_recovery=true --bluefs_replay_recovery_disable_compact=true + +If above fsck is successfull fix procedure can be applied. Availability ============ -- 2.47.3