summaryrefslogtreecommitdiffstats
path: root/doc/man/8/ceph-bluestore-tool.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/8/ceph-bluestore-tool.rst')
-rw-r--r--doc/man/8/ceph-bluestore-tool.rst16
1 files changed, 13 insertions, 3 deletions
diff --git a/doc/man/8/ceph-bluestore-tool.rst b/doc/man/8/ceph-bluestore-tool.rst
index 82437f801ea..883d4dfd8f2 100644
--- a/doc/man/8/ceph-bluestore-tool.rst
+++ b/doc/man/8/ceph-bluestore-tool.rst
@@ -30,6 +30,7 @@ Synopsis
| **ceph-bluestore-tool** reshard --path *osd path* --sharding *new sharding* [ --sharding-ctrl *control string* ]
| **ceph-bluestore-tool** show-sharding --path *osd path*
| **ceph-bluestore-tool** trim --path *osd path*
+| **ceph-bluestore-tool** zap-device --dev *dev path*
Description
@@ -108,7 +109,8 @@ Commands
:command:`show-label` --dev *device* [...]
- Show device label(s).
+ Show device label(s).
+ The label may be printed while an OSD is running.
:command:`free-dump` --path *osd path* [ --allocator block/bluefs-wal/bluefs-db/bluefs-slow ]
@@ -141,6 +143,10 @@ Commands
and allows the drive to perform more efficient internal housekeeping.
If BlueStore runs with discard enabled, this option may not be useful.
+:command: `zap-device` --dev *dev path*
+
+ Zeros all device label locations. This effectively makes device appear empty.
+
Options
=======
@@ -202,8 +208,8 @@ Useful to provide necessary configuration options when access to monitor/ceph.co
Device labels
=============
-Every BlueStore block device has a single block label at the beginning of the
-device. You can dump the contents of the label with::
+Every BlueStore block device has a block label at the beginning of the device.
+You can dump the contents of the label with::
ceph-bluestore-tool show-label --dev *device*
@@ -211,6 +217,10 @@ The main device will have a lot of metadata, including information
that used to be stored in small files in the OSD data directory. The
auxiliary devices (db and wal) will only have the minimum required
fields (OSD UUID, size, device type, birth time).
+The main device contains additional label copies at offsets: 1G, 10G, 100G and 1000G.
+Corrupted labels are fixed as part of repair::
+
+ ceph-bluestore-tool repair --dev *device*
OSD directory priming
=====================