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:
parent
7c1487e4dc
commit
a25af8ccef
1 changed files with 56 additions and 0 deletions
|
@ -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
|
||||||
|
|
Loading…
Reference in a new issue