From d1687a6fc446e2d1876ae97fe5ed87034d2a0b1b Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Tue, 10 Sep 2024 05:39:34 +1000 Subject: [PATCH] doc/man: edit ceph-bluestore-tool.rst Edit the section "bluefs-bdev-migrate" in doc/man/8/ceph-bluestore-tool.rst to add the information that this operation expands the target storage by updating its size label, making "bluefs-bdev-expand" unnecessary. Improve the subject-verb agreement in this section, and supply some absent definite articles. Co-authored-by: Peter Gervai Signed-off-by: Zac Dover (cherry picked from commit 6b34707f827b2b197f53fe2e430d173b30b81401) --- doc/man/8/ceph-bluestore-tool.rst | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/doc/man/8/ceph-bluestore-tool.rst b/doc/man/8/ceph-bluestore-tool.rst index 634d3a8bb6eb0..8581566559ba6 100644 --- a/doc/man/8/ceph-bluestore-tool.rst +++ b/doc/man/8/ceph-bluestore-tool.rst @@ -93,15 +93,17 @@ Commands :command:`bluefs-bdev-migrate` --dev-target *new-device* --devs-source *device1* [--devs-source *device2*] - Moves BlueFS data from source device(s) to the target one, source devices - (except the main one) are removed on success. Target device can be both - already attached or new device. In the latter case it's added to OSD - replacing one of the source devices. Following replacement rules apply - (in the order of precedence, stop on the first match): - - - if source list has DB volume - target device replaces it. - - if source list has WAL volume - target device replace it. - - if source list has slow volume only - operation isn't permitted, requires explicit allocation via new-db/new-wal command. + Moves BlueFS data from source device(s) to the target device. Source devices + (except the main one) are removed on success. Expands the target storage + (updates the size label), making "bluefs-bdev-expand" unnecessary. The + target device can be either a new device or a device that is already + attached. If the device is a new device, it is added to the OSD replacing + one of the source devices. The following replacement rules apply (in the + order of precedence, stop on the first match): + + - if the source list has DB volume - the target device replaces it. + - if the source list has WAL volume - the target device replaces it. + - if the source list has slow volume only - the operation isn't permitted and requires explicit allocation via a new-DB/new-WAL command. :command:`show-label` --dev *device* [...] -- 2.39.5