CEPH-BLUESTORE-TOOL(8) | Ceph | CEPH-BLUESTORE-TOOL(8) |
ceph-bluestore-tool - bluestore administrative tool
ceph-bluestore-tool command [ --dev device ... ] [ --path osd path ] [ --out-dir dir ] [ --log-file | -l filename ] [ --deep ] ceph-bluestore-tool fsck|repair --path osd path [ --deep ] ceph-bluestore-tool show-label --dev device ... ceph-bluestore-tool prime-osd-dir --dev device --path osd path ceph-bluestore-tool bluefs-export --path osd path --out-dir dir ceph-bluestore-tool bluefs-bdev-new-wal --path osd path --dev-target new-device ceph-bluestore-tool bluefs-bdev-new-db --path osd path --dev-target new-device ceph-bluestore-tool bluefs-bdev-migrate --path osd path --dev-target new-device --devs-source device1 [--devs-source device2] ceph-bluestore-tool free-dump|free-score --path osd path [ --allocator block/bluefs-wal/bluefs-db/bluefs-slow ]
ceph-bluestore-tool is a utility to perform low-level administrative operations on a BlueStore instance.
help
fsck [ --deep ]
repair
bluefs-export
bluefs-bdev-sizes --path osd path
bluefs-bdev-expand --path osd path
bluefs-bdev-new-wal --path osd path --dev-target new-device
bluefs-bdev-new-db --path osd path --dev-target new-device
bluefs-bdev-migrate --dev-target new-device --devs-source device1 [--devs-source device2]
show-label --dev device [...]
free-dump --path osd path [ --allocator block/bluefs-wal/bluefs-db/bluefs-slow ]
free-score --path osd path [ --allocator block/bluefs-wal/bluefs-db/bluefs-slow ]
Every BlueStore block device has a single block label at the beginning of the device. You can dump the contents of the label with:
ceph-bluestore-tool show-label --dev *device*
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).
You can generate the content for an OSD data directory that can start up a BlueStore OSD with the prime-osd-dir command:
ceph-bluestore-tool prime-osd-dir --dev *main device* --path /var/lib/ceph/osd/ceph-*id*
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.
If above fsck is successfull fix procedure can be applied.
ceph-bluestore-tool is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to the Ceph documentation at http://ceph.com/docs for more information.
2010-2021, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
May 27, 2021 | dev |