@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.)
hq.recaptime.dev/wiki/Phorge
phorge
phabricator
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
+56
+56
src/docs/user/configuration/managing_daemons.diviner
+56
src/docs/user/configuration/managing_daemons.diviner
···
46
46
NOTE: When you upgrade Phorge or change configuration, you should restart
47
47
the daemons by running `phd restart`.
48
48
49
+
Automatically start phd
50
+
=======================
51
+
52
+
NOTE: If you are opinionated against systemd, cover the eyes of your children
53
+
right now!1!
54
+
55
+
Computers are good in automatically starting stuff, thanks to the invention
56
+
of the "init system".
57
+
58
+
Phorge virtually supports any init system. Which one is yours? Don't worry.
59
+
If you don't know, it's systemd.
60
+
61
+
We propose a minimal systemd configuration file, following some assumptions:
62
+
63
+
- your lovely Phorge is installed `/somewhere`
64
+
- you have a database service called `mariadb`
65
+
- you have a dedicated Unix user called `daemon-user` - coming from
66
+
@{article:Diffusion User Guide}
67
+
68
+
With the above assumptions, create this configuration file as super-user:
69
+
70
+
```lang=ini,name=/etc/systemd/system/phorge-phd.service
71
+
[Unit]
72
+
Description=Phorge Daemons
73
+
Documentation=https://we.phorge.it/book/phorge/article/managing_daemons/
74
+
After=syslog.target network.target mariadb.service
75
+
76
+
[Service]
77
+
Type=forking
78
+
User=daemon-user
79
+
Group=daemon-user
80
+
ExecStart=/somewhere/phorge/bin/phd start
81
+
ExecStop=/somewhere/phorge/bin/phd stop
82
+
83
+
[Install]
84
+
WantedBy=multi-user.target
85
+
```
86
+
87
+
To install this new systemd configuration, execute these commands as
88
+
super-user:
89
+
90
+
```
91
+
systemctl daemon-reload
92
+
systemctl enable --now phorge-phd
93
+
```
94
+
95
+
Now the process has started and will survive after any reboot.
96
+
97
+
To check if everything is OK:
98
+
99
+
```
100
+
systemctl status phorge-phd
101
+
```
102
+
103
+
Anything else can be explored in depth by reading the systemd documentation.
104
+
49
105
= Daemon Console =
50
106
51
107
You can view status and debugging information for daemons in the Daemon Console