blob: 9271bc2a0e96796704eb74f7446be2f2c49b0077 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
.. _ceph-volume:
ceph-volume
===========
Deploy OSDs with different device technologies like lvm or physical disks using
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.
:ref:`Overview <ceph-volume-overview>` |
:ref:`Plugin Guide <ceph-volume-plugins>` |
**Command Line Subcommands**
There is currently support for ``lvm``, and plain disks (with GPT partitions)
that may have been deployed with ``ceph-disk``.
``zfs`` support is available for running a FreeBSD cluster.
* :ref:`ceph-volume-lvm`
* :ref:`ceph-volume-simple`
* :ref:`ceph-volume-zfs`
**Node inventory**
The :ref:`ceph-volume-inventory` subcommand provides information and metadata
about a nodes physical disk inventory.
Migrating
---------
Starting on Ceph version 13.0.0, ``ceph-disk`` is deprecated. Deprecation
warnings will show up that will link to this page. It is strongly suggested
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`
For details on why ``ceph-disk`` was removed please see the :ref:`Why was
ceph-disk replaced? <ceph-disk-replaced>` section.
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,
and ``ceph-disk`` is fully disabled. Encryption is fully supported.
.. toctree::
:hidden:
:maxdepth: 3
:caption: Contents:
intro
systemd
inventory
drive-group
lvm/index
lvm/activate
lvm/batch
lvm/encryption
lvm/prepare
lvm/create
lvm/scan
lvm/systemd
lvm/list
lvm/zap
lvm/migrate
lvm/newdb
lvm/newwal
simple/index
simple/activate
simple/scan
simple/systemd
zfs/index
zfs/inventory
|
