[ceph.git] / ceph / doc / ceph-volume / intro.rst

.. _ceph-volume-overview:

Overview
--------
The ``ceph-volume`` tool aims to be a single purpose command line tool to deploy
logical volumes as OSDs, trying to maintain a similar API to ``ceph-disk`` when
preparing, activating, and creating OSDs.

It deviates from ``ceph-disk`` by not interacting or relying on the udev rules
that come installed for Ceph. These rules allow automatic detection of
previously setup devices that are in turn fed into ``ceph-disk`` to activate
them.


``ceph-volume lvm``
-------------------
By making use of :term:`LVM tags`, the :ref:`ceph-volume-lvm` sub-command is
able to store and later re-discover and query devices associated with OSDs so
that they can later activated.
Commit	Line	Data
b5b8bbf5 FG	1	.. _ceph-volume-overview:
	2
	3	Overview
	4	--------
	5	The ``ceph-volume`` tool aims to be a single purpose command line tool to deploy
	6	logical volumes as OSDs, trying to maintain a similar API to ``ceph-disk`` when
	7	preparing, activating, and creating OSDs.
	8
	9	It deviates from ``ceph-disk`` by not interacting or relying on the udev rules
	10	that come installed for Ceph. These rules allow automatic detection of
	11	previously setup devices that are in turn fed into ``ceph-disk`` to activate
	12	them.
	13
	14
	15	``ceph-volume lvm``
	16	-------------------
	17	By making use of :term:`LVM tags`, the :ref:`ceph-volume-lvm` sub-command is
	18	able to store and later re-discover and query devices associated with OSDs so
	19	that they can later activated.