From: Zac Dover Date: Mon, 9 Sep 2024 19:39:34 +0000 (+1000) Subject: doc/man: edit ceph-bluestore-tool.rst X-Git-Tag: v18.2.5~404^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=e5f14a5a560cf50779d73b22b1b0dfb69b026cd9;p=ceph.git 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) --- diff --git a/doc/man/8/ceph-bluestore-tool.rst b/doc/man/8/ceph-bluestore-tool.rst index f6c88da09b24c..7f737f2d62b64 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* [...]