From: Zac Dover Date: Mon, 9 Sep 2024 19:39:34 +0000 (+1000) Subject: doc/man: edit ceph-bluestore-tool.rst X-Git-Tag: v20.0.0~1100^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F59677%2Fhead;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 --- diff --git a/doc/man/8/ceph-bluestore-tool.rst b/doc/man/8/ceph-bluestore-tool.rst index fa25facedce0..82437f801ea0 100644 --- a/doc/man/8/ceph-bluestore-tool.rst +++ b/doc/man/8/ceph-bluestore-tool.rst @@ -94,15 +94,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* [...]