Skip to content

Commit

Permalink
ceph: add example BlueStore migration via the ceph-objectstore-tool d…
Browse files Browse the repository at this point in the history
…up operation

Signed-off-by: Anthony D'Atri <[email protected]>
anthonyeleven committed Sep 23, 2021
1 parent d855dbb commit 2a181ef
Showing 3 changed files with 393 additions and 12 deletions.
25 changes: 13 additions & 12 deletions doc/rados/operations/bluestore-migration.rst
Original file line number Diff line number Diff line change
@@ -272,21 +272,22 @@ Caveats:

* The device must be manually partitioned.

* Tooling not implemented!

* Not documented!
* An unsupported user-contributed script that shows this process may be found at
https://github.com/ceph/ceph/blob/master/src/script/contrib/ceph-migrate-bluestore.bash

Advantages:

* Little or no data migrates over the network during the conversion.
* Little or no data migrates over the network during the conversion, so long as
the `noout` or `norecover`/`norebalance` flags are set on the OSD or the cluster
while the process proceeds.

Disadvantages:

* Tooling not fully implemented.
* Process not documented.
* Each host must have a spare or empty device.
* The OSD is offline during the conversion, which means new writes will
be written to only a subset of the OSDs. This increases the risk of data
loss due to a subsequent failure. (However, if there is a failure before
conversion is complete, the original FileStore OSD can be started to provide
access to its original data.)
* Tooling is not fully implemented, supported, or documented.
* Each host must have an appropriate spare or empty device for staging.
* The OSD is offline during the conversion, which means new writes to PGs
with the OSD in their acting set may not be ideally redundant until the
subject OSD comes up and recovers. This increases the risk of data
loss due to an overlapping failure. However, if another OSD fails before
conversion and start-up are complete, the original Filestore OSD can be
started to provide access to its original data.
10 changes: 10 additions & 0 deletions src/tools/contrib/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
contrib
==================

This directory houses scripts and other files that may be useful to Ceph
administrators. Everything here is provided *as-is*, and may or may
not be up-to-date or functional. Code may not be up to official standards.
Please do not assume any level of support. Your mileage may vary.

Each file's header must include a tracker number and an author signed-off-by
line.
Loading

0 comments on commit 2a181ef

Please sign in to comment.