Skip to content

Latest commit

 

History

History
54 lines (30 loc) · 1.56 KB

systemd.rst

File metadata and controls

54 lines (30 loc) · 1.56 KB
Raw

systemd Configs

You can run :py:mod:`cobald` as a system service. We provide systemd configs for multiple :py:mod:`cobald` instances run as services. You can manage several instances which are identified with a systemd instance name.

Create a file named cobald@.service in the /usr/lib/systemd/system directory.

An example of a systemd config file:

.. literalinclude:: cobald@.service

In this example, the configs for the different COBalD instances are located at /etc/cobald/instance-name.py. :py:mod:`cobald` can handle .py and .yaml configuration files. Please ensure that the chosen python interpreter has :py:mod:`cobald` installed! We recommend to use a virtualenv. By using a virtualenv you have to set the ExecStart to ExecStart={{ virtualenv }}/bin/python -m cobald.daemon /etc/cobald/%i.yaml.

After you created or changed the file you need to run:

$ systemctl daemon-reload

Now you can manage the :py:mod:`cobald` instance which loads the /etc/cobald/instance-name.py config file.

  • start one instance of :py:mod:`cobald`

    $ systemctl start cobald@instance-name

  • stop the instance of :py:mod:`cobald`

    $ systemctl stop cobald@instance-name

  • report the current status of the :py:mod:`cobald` instance

    $ systemctl status cobald@instance-name

  • enable :py:mod:`cobald` instance start at boot time

    $ systemctl enable cobald@instance-name