Document a systemd daemon
Closed, ResolvedPublic
Actions

Assigned To

Authored By

	valerio.bozzolan
	Jun 12 2023, 13:02

Description

This is a very basic systemd daemon that I use in my production and would be awesome to document somewhere:

/etc/systemd/system/phorge-phd.service

[Unit]
Description=Phorge Daemons asd
After=syslog.target network.target mariadb.service

[Service]
Type=forking
User=phorge
Group=phorge
ExecStart=/var/www/phorge/bin/phd start
ExecStop=/var/www/phorge/bin/phd stop

[Install]
WantedBy=multi-user.target

To install that:

systemctl daemon-reload
systemctl enable phorge-phd
systemctl start  phorge-phd

For example here:

https://we.phorge.it/book/phorge/article/managing_daemons/

We can surely continue to do not document this, but it's not that strategic, since systemd is literally what now every distribution on the planet (except two) have.

Revisions and Commits

rP Phorge
	D25497	rPbd44ec833f43 Add example systemd unit for sshd in Diffusion docs
	D25293	rPa25af8ccef69 Diviner: add a minimal systemd example

Related Objects

Mentioned Here: D25497: Add example systemd unit for sshd in Diffusion docs

Event Timeline

valerio.bozzolan created this task.Jun 12 2023, 13:02

Herald added subscribers: Cigaryno, Matthew, chris and 2 others. · View Herald TranscriptJun 12 2023, 13:02

valerio.bozzolan added projects: Documentation, User-valerio.bozzolan.Jun 12 2023, 13:04

valerio.bozzolan updated the task description. (Show Details)

This is a nice contribution and definitely would be a valuable addition to the docs, IMO.

That said, I wonder if we should also consider supporting a world where systemd owns the individual daemons instead of having PHD do all the work.

It might make sense when running under systemd to actually have individual service unit for each of the daemons, using Type=simple instead of Type=forking

For example:

[Unit]
Description=Phorge Repository Daemon
After=syslog.target network.target mariadb.service

[Service]

Type=simple 
KillMode=process
Restart=always

User=phorge
Group=phorge

WorkingDirectory=/var/www/phorge/
ExecStart=/var/www/phorge/bin/phd debug PhabricatorRepositoryPullLocalDaemon

I'm not sure that it ever made sense for Phabricator to implement all of the daemon management logic. think it makes even less sense today than it ever did, especially in a systemd environment.

Note: If we were to properly support something like this then we'd want to implement something similar to the 'debug' command but without the verbose logging that debug mode enables.

20after4 awarded a token.Jun 14 2023, 05:03

valerio.bozzolan added a revision: D25293: Diviner: add a minimal systemd example.Jun 14 2023, 16:22

valerio.bozzolan triaged this task as Low priority.Jun 16 2023, 12:59

valerio.bozzolan moved this task from Backlog to PingDeath 🌚 on the User-valerio.bozzolan board.Jun 16 2023, 21:38

valerio.bozzolan closed this task as Resolved by committing rPa25af8ccef69: Diviner: add a minimal systemd example.Jun 23 2023, 06:50

valerio.bozzolan claimed this task.

valerio.bozzolan added a commit: rPa25af8ccef69: Diviner: add a minimal systemd example.

Partially related, a systemd unit for the SSH server. Proposal in D25497

valerio.bozzolan added a revision: D25497: Add example systemd unit for sshd in Diffusion docs.Dec 14 2023, 11:32

kuba-orlik added a commit: rPbd44ec833f43: Add example systemd unit for sshd in Diffusion docs.Dec 18 2023, 09:55