]> git.proxmox.com Git - ceph.git/blobdiff - ceph/doc/ceph-volume/lvm/systemd.rst
update sources to 12.2.2
[ceph.git] / ceph / doc / ceph-volume / lvm / systemd.rst
index 7162e0433526f1e7074358fdf0a6541d5ae967af..30260de7e8826ae939f66094bd53952a8a6da44e 100644 (file)
@@ -1,31 +1,7 @@
-.. _ceph-volume-systemd:
+.. _ceph-volume-lvm-systemd:
 
 systemd
 =======
-As part of the :ref:`ceph-volume-lvm-activate` process, a few systemd units will get enabled
-that will use the OSD id and uuid as part of their name. These units will be
-run when the system boots, and will proceed to activate their corresponding
-volumes.
-
-The API for activation requires both the :term:`OSD id` and :term:`OSD uuid`,
-which get persisted by systemd. Internally, the activation process enables the
-systemd unit using the following convention::
-
-    ceph-volume@<type>-<extra metadata>
-
-Where ``type`` is the sub-command used to parse the extra metadata, and ``extra
-metadata`` is any additional information needed by the sub-command to be able
-to activate the OSD. For example an OSD with an ID of 0, for the ``lvm``
-sub-command would look like::
-
-    systemctl enable ceph-volume@lvm-0-0A3E1ED2-DA8A-4F0E-AA95-61DEC71768D6
-
-
-Process
--------
-The systemd unit is a :term:`systemd oneshot` service, meant to start at boot after the
-local filesystem is ready to be used.
-
 Upon startup, it will identify the logical volume using :term:`LVM tags`,
 finding a matching ID and later ensuring it is the right one with
 the :term:`OSD uuid`.
@@ -41,6 +17,12 @@ be mounted at::
 
     /var/lib/ceph/osd/ceph-0
 
+
 Once that process is complete, a call will be made to start the OSD::
 
     systemctl start ceph-osd@0
+
+The systemd portion of this process is handled by the ``ceph-volume lvm
+trigger`` sub-command, which is only in charge of parsing metadata coming from
+systemd and startup, and then dispatching to ``ceph-volume lvm activate`` which
+would proceed with activation.