RepoMirrors/ceph
1
0
Fork 0
mirror of https://github.com/ceph/ceph synced 2025-01-29 14:34:40 +00:00
Code Issues Packages Projects Releases Wiki Activity

doc/ceph-volume document multipath support

Browse Source 
Signed-off-by: Alfredo Deza <adeza@redhat.com>
This commit is contained in:
Alfredo Deza 2018-03-13 15:26:46 -04:00
parent 58560cf6b5
commit 1dca5eac38
1 changed files with 27 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
doc/ceph-volume/lvm/prepare.rst
View File

@ -235,6 +235,33 @@ work for both bluestore and filestore OSDs::
ceph-volume lvm prepare --bluestore --data vg/lv --crush-device-class foo
.. _ceph-volume-lvm-multipath:
``multipath`` support
---------------------
Devices that come from ``multipath`` are not supported as-is. The tool will
refuse to consume a raw multipath device and will report a message like::
--> RuntimeError: Cannot use device (/dev/mapper/<name>). A vg/lv path or an existing device is needed
The reason for not supporting multipath is that depending on the type of the
multipath setup, if using an active/passive array as the underlying physical
devices, filters are required in ``lvm.conf`` to exclude the disks that are part of
those underlying devices.
It is unfeasible for ceph-volume to understand what type of configuration is
needed for LVM to be able to work in various different multipath scenarios. The
functionality to create the LV for you is merely a (naive) convenience,
anything that involves different settings or configuration must be provided by
a config management system which can then provide VGs and LVs for ceph-volume
to consume.
This situation will only arise when trying to use the ceph-volume functionality
that creates a volume group and logical volume from a device. If a multipath
device is already a logical volume it *should* work, given that the LVM
configuration is done correctly to avoid issues.
Storing metadata
----------------
The following tags will get applied as part of the preparation process