mirror of
https://github.com/ceph/ceph
synced 2024-12-24 04:14:07 +00:00
38 lines
1.3 KiB
ReStructuredText
38 lines
1.3 KiB
ReStructuredText
.. _ceph-volume-systemd:
|
|
|
|
systemd
|
|
=======
|
|
The workflow to *"activate"* an OSD is by relying on systemd unit files and its
|
|
ability to persist information as a suffix to the instance name.
|
|
|
|
``ceph-volume`` exposes the following convention for unit files::
|
|
|
|
ceph-volume@<osd id>-<osd uuid>-<device type>
|
|
|
|
For example, this is how enabling an OSD could look like using the :doc:`lvm
|
|
<lvm/lvm>` sub command::
|
|
|
|
systemctl enable ceph-volume@0-8715BEB4-15C5-49DE-BA6F-401086EC7B41-lvm
|
|
|
|
|
|
These 3 pieces of persisted information are needed by the systemd unit so that
|
|
it understands what OSD it needs to activate along with the related sub
|
|
command. Since ``lvm`` is not the only subcommand that will be supported, this
|
|
is how it will allow other device types to be defined.
|
|
|
|
At some point for example, for plain disks, it could be::
|
|
|
|
systemctl enable ceph-volume@0-8715BEB4-15C5-49DE-BA6F-401086EC7B41-disk
|
|
|
|
|
|
At startup, the systemd unit will execute a helper script that will parse the
|
|
suffix and will end up calling ``ceph-volume`` back. Using the previous
|
|
example for lvm, that call will look like::
|
|
|
|
ceph-volume lvm activate 0 8715BEB4-15C5-49DE-BA6F-401086EC7B41
|
|
|
|
|
|
.. warning:: These workflows are not meant to be public, but are documented so that
|
|
it is clear what the tool is doing behind the scenes. Do not alter
|
|
any of these values.
|