1
0
Fork 0
mirror of https://we.phorge.it/source/phorge.git synced 2024-11-22 14:52:41 +01:00

Diviner: add a minimal systemd example

Summary:
After this change the section "Managing Daemons with phd"
mentions a minimally viable systemd configuration file
to make systemd-users happier and systemd-haters saddest.

Closes T15467

Test Plan: - read the page, see systemd, don't cry

Reviewers: O1 Blessed Committers, 20after4

Reviewed By: O1 Blessed Committers, 20after4

Subscribers: 20after4, speck, tobiaswiese, Matthew, Cigaryno

Maniphest Tasks: T15467

Differential Revision: https://we.phorge.it/D25293
This commit is contained in:
Valerio Bozzolan 2023-06-23 08:48:18 +02:00
parent 7c1487e4dc
commit a25af8ccef

View file

@ -46,6 +46,62 @@ If you want finer-grained control, you can use:
NOTE: When you upgrade Phorge or change configuration, you should restart NOTE: When you upgrade Phorge or change configuration, you should restart
the daemons by running `phd restart`. the daemons by running `phd restart`.
Automatically start phd
=======================
NOTE: If you are opinionated against systemd, cover the eyes of your children
right now!1!
Computers are good in automatically starting stuff, thanks to the invention
of the "init system".
Phorge virtually supports any init system. Which one is yours? Don't worry.
If you don't know, it's systemd.
We propose a minimal systemd configuration file, following some assumptions:
- your lovely Phorge is installed `/somewhere`
- you have a database service called `mariadb`
- you have a dedicated Unix user called `daemon-user` - coming from
@{article:Diffusion User Guide}
With the above assumptions, create this configuration file as super-user:
```lang=ini,name=/etc/systemd/system/phorge-phd.service
[Unit]
Description=Phorge Daemons
Documentation=https://we.phorge.it/book/phorge/article/managing_daemons/
After=syslog.target network.target mariadb.service
[Service]
Type=forking
User=daemon-user
Group=daemon-user
ExecStart=/somewhere/phorge/bin/phd start
ExecStop=/somewhere/phorge/bin/phd stop
[Install]
WantedBy=multi-user.target
```
To install this new systemd configuration, execute these commands as
super-user:
```
systemctl daemon-reload
systemctl enable --now phorge-phd
```
Now the process has started and will survive after any reboot.
To check if everything is OK:
```
systemctl status phorge-phd
```
Anything else can be explored in depth by reading the systemd documentation.
= Daemon Console = = Daemon Console =
You can view status and debugging information for daemons in the Daemon Console You can view status and debugging information for daemons in the Daemon Console