import 15.2.5

[ceph.git] / ceph / doc / man / 8 / ceph-bluestore-tool.rst

diff --git a/ceph/doc/man/8/ceph-bluestore-tool.rst b/ceph/doc/man/8/ceph-bluestore-tool.rst
index 2bc951ebd13c95459d61985c226f36d7311bb1fa..af56cd759653315888665158fc18fafa5c62f57b 100644 (file)
--- a/ceph/doc/man/8/ceph-bluestore-tool.rst
+++ b/ceph/doc/man/8/ceph-bluestore-tool.rst
@@ -158,6 +158,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
 ============