X-Git-Url: https://gerrit.opnfv.org/gerrit/gitweb?a=blobdiff_plain;f=src%2Fceph%2Fdoc%2Fdev%2Fceph-volume%2Fsystemd.rst;fp=src%2Fceph%2Fdoc%2Fdev%2Fceph-volume%2Fsystemd.rst;h=0000000000000000000000000000000000000000;hb=7da45d65be36d36b880cc55c5036e96c24b53f00;hp=8553430ee0d821d5ec1f73d5384cbf354f4c5aa8;hpb=691462d09d0987b47e112d6ee8740375df3c51b2;p=stor4nfv.git 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@- - -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.