2017-08-17 13:24:14 +00:00
|
|
|
.. _ceph-volume:
|
|
|
|
|
|
|
|
|
|
ceph-volume
|
|
|
|
|
===========
|
|
|
|
|
Deploy OSDs with different device technologies like lvm or physical disks using
|
2017-11-06 19:17:20 +00:00
|
|
|
pluggable tools (:doc:`lvm/index` itself is treated like a plugin) and trying to
|
|
|
|
|
follow a predictable, and robust way of preparing, activating, and starting OSDs.
|
2017-08-17 13:24:14 +00:00
|
|
|
|
|
|
|
|
:ref:`Overview <ceph-volume-overview>` |
|
|
|
|
|
:ref:`Plugin Guide <ceph-volume-plugins>` |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**Command Line Subcommands**
|
2018-11-14 13:09:37 +00:00
|
|
|
|
2017-11-06 19:17:20 +00:00
|
|
|
There is currently support for ``lvm``, and plain disks (with GPT partitions)
|
|
|
|
|
that may have been deployed with ``ceph-disk``.
|
2017-08-17 13:24:14 +00:00
|
|
|
|
2019-10-30 12:17:08 +00:00
|
|
|
``zfs`` support is available for running a FreeBSD cluster.
|
|
|
|
|
|
2017-08-17 13:24:14 +00:00
|
|
|
* :ref:`ceph-volume-lvm`
|
2017-11-06 19:17:20 +00:00
|
|
|
* :ref:`ceph-volume-simple`
|
2019-10-30 12:17:08 +00:00
|
|
|
* :ref:`ceph-volume-zfs`
|
2017-08-17 13:24:14 +00:00
|
|
|
|
2018-11-14 13:09:37 +00:00
|
|
|
**Node inventory**
|
|
|
|
|
|
|
|
|
|
The :ref:`ceph-volume-inventory` subcommand provides information and metadata
|
|
|
|
|
about a nodes physical disk inventory.
|
|
|
|
|
|
2017-11-17 18:10:29 +00:00
|
|
|
|
|
|
|
|
Migrating
|
|
|
|
|
---------
|
2018-08-03 20:19:41 +00:00
|
|
|
Starting on Ceph version 13.0.0, ``ceph-disk`` is deprecated. Deprecation
|
2017-11-17 18:10:29 +00:00
|
|
|
warnings will show up that will link to this page. It is strongly suggested
|
2018-05-08 17:47:48 +00:00
|
|
|
that users start consuming ``ceph-volume``. There are two paths for migrating:
|
|
|
|
|
|
|
|
|
|
#. Keep OSDs deployed with ``ceph-disk``: The :ref:`ceph-volume-simple` command
|
|
|
|
|
provides a way to take over the management while disabling ``ceph-disk``
|
|
|
|
|
triggers.
|
|
|
|
|
#. Redeploy existing OSDs with ``ceph-volume``: This is covered in depth on
|
|
|
|
|
:ref:`rados-replacing-an-osd`
|
2017-11-17 18:10:29 +00:00
|
|
|
|
2018-07-23 20:22:13 +00:00
|
|
|
For details on why ``ceph-disk`` was removed please see the :ref:`Why was
|
|
|
|
|
ceph-disk replaced? <ceph-disk-replaced>` section.
|
|
|
|
|
|
|
|
|
|
|
2017-11-17 18:10:29 +00:00
|
|
|
New deployments
|
|
|
|
|
^^^^^^^^^^^^^^^
|
|
|
|
|
For new deployments, :ref:`ceph-volume-lvm` is recommended, it can use any
|
|
|
|
|
logical volume as input for data OSDs, or it can setup a minimal/naive logical
|
|
|
|
|
volume from a device.
|
|
|
|
|
|
|
|
|
|
Existing OSDs
|
|
|
|
|
^^^^^^^^^^^^^
|
|
|
|
|
If the cluster has OSDs that were provisioned with ``ceph-disk``, then
|
|
|
|
|
``ceph-volume`` can take over the management of these with
|
|
|
|
|
:ref:`ceph-volume-simple`. A scan is done on the data device or OSD directory,
|
2018-02-02 13:28:40 +00:00
|
|
|
and ``ceph-disk`` is fully disabled. Encryption is fully supported.
|
2017-11-17 18:10:29 +00:00
|
|
|
|
|
|
|
|
|
2017-08-17 13:24:14 +00:00
|
|
|
.. toctree::
|
|
|
|
|
:hidden:
|
|
|
|
|
:maxdepth: 3
|
|
|
|
|
:caption: Contents:
|
|
|
|
|
|
|
|
|
|
intro
|
2017-11-09 15:50:43 +00:00
|
|
|
systemd
|
2018-11-14 13:09:37 +00:00
|
|
|
inventory
|
2020-04-21 13:47:42 +00:00
|
|
|
drive-group
|
2017-08-17 13:24:14 +00:00
|
|
|
lvm/index
|
|
|
|
|
lvm/activate
|
2018-08-03 20:19:41 +00:00
|
|
|
lvm/batch
|
2018-01-22 19:21:37 +00:00
|
|
|
lvm/encryption
|
2017-08-17 13:24:14 +00:00
|
|
|
lvm/prepare
|
2017-08-21 20:02:15 +00:00
|
|
|
lvm/create
|
2017-08-17 13:24:14 +00:00
|
|
|
lvm/scan
|
|
|
|
|
lvm/systemd
|
2017-10-03 15:41:10 +00:00
|
|
|
lvm/list
|
2017-10-24 15:13:40 +00:00
|
|
|
lvm/zap
|
2021-09-03 19:44:39 +00:00
|
|
|
lvm/migrate
|
|
|
|
|
lvm/newdb
|
|
|
|
|
lvm/newwal
|
2017-11-06 19:17:20 +00:00
|
|
|
simple/index
|
|
|
|
|
simple/activate
|
|
|
|
|
simple/scan
|
|
|
|
|
simple/systemd
|
2019-10-30 12:17:08 +00:00
|
|
|
zfs/index
|
|
|
|
|
zfs/inventory
|
