Facciamo un esempio completo.

Vogliamo creare un servizio che avvii uno script python con uvicorn. Il servizio si chiamerà chatserv.

Per gestire solo il servizio, ci basterebbe creare un file chiamato /etc/systemd/system/chatserv.service con all’interno:

[Unit]
Description=Start uvicorn service fastapi
After=network.target

[Service]
Type=simple
User=web1
Group=web1
DynamicUser=true

WorkingDirectory=/var/www/web1/python/f24-online
PrivateTmp=true

ExecStart=/var/www/web1/python/bin/uvicorn --app-dir /var/www/web1/python/chatserv chatserv:app --host 127.0.0.1 --port 8000 --reload

ExecReload=/bin/kill -HUP ${MAINPID}
RestartPreventExitStatus = 255
RestartSec=1
Restart=always

[Install]
WantedBy=multi-user.target

Per abilitare il servizio ci basterà:

systemctl daemon-reload
systemctl enable chatserv.service
systemctl start chatserv.service

Se volessimo aggiungere un monitoraggio su eventuali cambiamenti all’interno della cartella /var/www/web1/python/chatserv dovremmo creare due file.

Il file del servizio di monitoraggio /etc/systemd/system/chatserv-watcher.service:

[Unit]
Description=chatserv.service restarter on script change
After=network.target
StartLimitIntervalSec=10
StartLimitBurst=5

[Service]
Type=oneshot
ExecStart=/usr/bin/systemctl restart chatserv.service
RestartSec=5s

[Install]
WantedBy=multi-user.target

dove StartLimitIntervalSec=10 e StartLimitBurst=5 indicano che non è consentito che il sistema si riavvii più di 5 volte in 10 secondi e RestartSec=5s indica che il riavvio avverrà dopo 5 secondi.

Infine il file del path unit service /etc/systemd/system/chatserv-watcher.path:

[Path]
Unit=chatserv-watcher.service
PathChanged=/var/www/web1/python/chatserv

[Install]
WantedBy=multi-user.target

Abilitiamo anche il servizio di monitoraggio:

systemctl enable chatserv-watcher.{path,service}
systemctl start chatserv-watcher.{path,service}

Fatto, possiamo ora provare a modificare lo script e poi controllare che il servizio venga riavviato con:

journalctl -r -u chatserv

enjoy!

systemctl set-default multi-user.target

nel nostro terminale.

Per ripristinare l’avvio automatico con GUI al boo, basterà digitare nel terminale:

systemctl set-default graphical.target

Infine, per verificare l’attuale impostazione, basterà digitare:

systemctl get-default

che non fa altro che verificare a cosa è linkato /etc/systemd/system/default.target

Per vedere tutti i target disponibili, possiamo digitare nel terminale:

systemctl list-units --type target

Per passare da console a GUI direttamente senza riavviare:

systemctl isolate graphical.target

o, viceversa per passare da GUI a console:

systemctl isolate multi-user.target

Per i nostalgici di SysV, nella seguente tabella c’è un confronto tra SysV e SystemD:

enjoy!

Ad esempio per controllare i log per l’utente apache si può digitare:

journalctl -u apache

Per visualizzare i log di un utente, in base all’UID, es UID 100:

journalctl _UID=100

Per visualizzare i log di un processo in particolare:

journalctl _PID=1234

Per vedere i log degli ultimi 20 minuti:

journalctl --since "20 min ago"

Per visualizzare i log in tempo reale:

journalctl -f

Per visualizzare i log filtrati per una stringa, es “error”:

journalctl -g error

Infine, i log sono archiviati in /var/log/journal e per cancellare log più vecchi di 30 giorni possiamo digitare:

journalctl --vacuum-time=30d

oppure per cancellare tutti i log e lasciarne solo 100MB:

journalctl --vacuum-size=100M

enjoy!

Per verificarne lo stato basta fare:

systemctl status systemd-timesyncd

Prima di iniziare, verificare di non aver installato NTP con:

apt purge ntp

Per avviare il servizio:

systemctl enable systemd-timesyncd
systemctl start systemd-timesyncd

Per verificare che tutto funzion correttamente, digitare:

timedatectl

e controllare che le righe NTP enabled e NTP synchronized siano impostate a Yes.

Se non risulta abilitato, abilitarlo con:

timedatectl set-ntp on

Infine, il file di configurazione è /etc/systemd/timesyncd.conf dove eventualmente specificare altri server NTP. A seguito di modifiche, riavviare con:

systemctl restart systemd-timesyncd.service

Per verificare lo status e la configurazione si può usare:

timedatectl show-timesync

enjoy!

Dopo aver creato il file in:

/lib/systemd/system/

ed aver ricaricato l’elenco dei servizi con:

systemctl daemon-reload

ho abilitato il servizio:

systemctl enable redis6-server.service

ed ho provato ad avviarlo con:

systemctl start redis6-server.service

Il servizio non si avviava, mostrando:

start request repeated too quickly, refusing to start

Provando con i comandi suggeriti da systemd non si riusciva a capire quale fosse effettivamente l’errore, ma eseguendo:

journalctl -u redis6-server.service

e’ venuto fuori che non riusciva a scrivere il nuovo file di log…

NB: Ricordo sempre che un’altra cosa importante da controllare sempre sono i files di log. Il path è specificato nel file di configurazione alla direttiva logfile

enjoy!

in questo caso, basta installare il pacchetto bash-completion e poi fare nuovamente il login:
apt-get install bash-completion

enjoy!

Modifiche ai parametri per il boot del kernel

Di default systemd attiva il target unit denominato default.target.
Per sovrascrivere questo funzionamento, si può modificare il parametro systemd.unit= passato al kernel durante il boot (ad esempio modificando al volo i parametri con grub).
Il target systemd.unit=rescue.target server per attivare una shell di recupero (simile al runlevel 1); systemd.unit=emergency.target è invece molto simile al “vecchio” init=/bin/sh ma con l’aggiunta che viene avviato il sistema completo; systemd.unit=multi-user.target è per l’avvio in modalita non grafica ed infine systemd.unit=graphical.target è per l’avvio in modalità grafica.

Per modificare il target (per intenderci il runlevel di sysinit), si può usare isolate (per simulare il runlevel 3):

systemctl isolate multi-user.target

e (per simulare il runlevel 5):

systemctl isolate graphical.target

Per impostare il target di default, si può usare set-default, es:

systemctl set-default multi-user.target

oppure

systemctl set-default graphical.target

Per vedere tutti i target disponibili:

systemctl list-units --type=target

Infine, per conoscere il target attuale, si può usare:

systemctl get-default

Come gestire i servizi con systemd

I file relativi ai servizi sono in:

/usr/lib/systemd/system/

Per la visualzzazione di tutti i servizi:

systemctl

oppure per avere una visualizzazione “ad albero”:

systemd-cgls

Per avviare/fermare/riavviare un servizio:

systemctl start nome_servizio

systemctl stop nome_servizio

systemctl restart nome_servizio

Per conoscere lo stato di un servizio:

systemctl status nome_servizio

Per abilitare/disabilitare l’avvio di un servizio al boot:

systemctl enable nome_servizio

systemctl disable nome_servizio

e per verificare se è abilitato o meno:

systemctl is-enabled nome_servizio

Per ora è tutto, questi i comandi principali che possono servire per la gestione di systemd.

enjoy!