summaryrefslogtreecommitdiffstats
path: root/src/ceph/doc/dev/ceph-volume/systemd.rst
diff options
context:
space:
mode:
Diffstat (limited to 'src/ceph/doc/dev/ceph-volume/systemd.rst')
-rw-r--r--src/ceph/doc/dev/ceph-volume/systemd.rst37
1 files changed, 0 insertions, 37 deletions
diff --git a/src/ceph/doc/dev/ceph-volume/systemd.rst b/src/ceph/doc/dev/ceph-volume/systemd.rst
deleted file mode 100644
index 8553430..0000000
--- a/src/ceph/doc/dev/ceph-volume/systemd.rst
+++ /dev/null
@@ -1,37 +0,0 @@
-.. _ceph-volume-systemd-api:
-
-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@<sub command>-<extra metadata>
-
-For example, this is how enabling an OSD could look like for the
-:ref:`ceph-volume-lvm` sub command::
-
- systemctl enable ceph-volume@lvm-0-8715BEB4-15C5-49DE-BA6F-401086EC7B41
-
-
-These 3 pieces of persisted information are needed by the sub-command so that
-it understands what OSD it needs to activate.
-
-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@disk-0-8715BEB4-15C5-49DE-BA6F-401086EC7B41
-
-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.