Überarbeitung von Systemd/Timers

Entwurf

Timer bieten die Möglichkeit Aufgaben zeitlich zu steuern. Die Timer-Unit besteht aus einer .timer Datei die eine .service Datei ansteuert. Timer unterstehen systemd und müssen mit dem systemctl Befehl aktiviert werden. Eine Alternative hierzu bietet cron.

Beispiel

beispiel.timer

[Unit]
Description=Kurz-Beschreibung

[Timer]
OnBootSec=1h 30m

[Install]
WantedBy=basic.target

beispiel.service

[Unit]
Description=Kurz-Beschreibung

[Service]
ExecStart=/usr/bin/beispiel.sh

Service- und Timerdateien werden für

systemweite Dienste im Ordner /etc/systemd/system/
userbezoge Dienste unter ~/.config/systemd/user/ gespeichert.

Timer und Service müssen dabei den gleichen Namen tragen. Z.B.: (beispiel.timer und beispiel.service).

De- / Aktivierung

Mit systemctl enable --now startet der Timer unverzüglich und permanent, sodass er auch nach einem Neustart aktiv ist. Ohne --now werden enable oder auch disable erst nach einem reboot wirksam. Ein start bzw. stop wirken sich hingegen nur auf die laufende Sitzung aus. Bei der ersten Initialisierung legt das System automatisch einen passenden Symlink an.

Timer für systemweite Dienste werden mit Rootrechten aktiviert:

# systemctl enable --now <name>.timer

Timer im Userbereich werden mit der Option --user und mit Userrechten aktiviert:

$ systemctl --user enable --now <name>.timer

Aktualisierung von Timer und Sevice nach einer Änderung:

# systemctl reenable --now <name>.timer
$ systemctl --user reenable --now <name>.timer

Management

Auflistung der Auslösezeiten:

systemctl list-timers --all

(Sollen nur die aktiven Timer angezeigt werden genügt auch ein systemctl list-timers).

Statusmeldungen:

systemctl status <name>.timer
systemctl status <name>.service

Journaleinträge z.B.:

journalctl -u <name>.service -g Started

Die [Timer] Sektion

( Für die Konfiguration der Sektionen [Unit], [Install] und [Service] sei an dieser Stelle auf die entsprechenden man pages verwiesen)

In der Timer Sektion können auch mehrere Zeitangaben gemacht werden. Sie beeinflussen sich nicht und werden alle zu ihrem jeweiligen Zeitpunkt ausgeführt.

Kalendarische Zeitangaben

OnCalendar=

Absolute kalendarische Zeitangaben

OnCalendar=Thu,Fri 2026-*-1..5 11:12:13

(Jeweils um 11 Uhr 12, zwischen einschließlich dem 1. und 5. Kalendertag eines jeden Monats des Jahres 2026, jedoch nur an Donnerstagen und Freitagen wird der service ausgelöst.)

Die Angabe eines Wochentags erfolgt immer in Englisch. Sie ist optional. Jede Rubrik kann mit "," für die Aufzählung oder mit ".." für von bis versehen werden oder durch "*" für beliebig ersetzt werden.

Die Angaben erfolgen nach diesem Schema:

OnCalendar=Wochentag(englsch/optional) Jahr-Monat-Tag Stunde:Minute:Sekunde

Periodische kalendarische Zeitangaben

OnCalendar=weekly

Auch diese Werte sind möglich.

minutely, hourly, daily, monthly, weekly, yearly, quarterly, semiannually

Entsprechend den oberen Notierung, kann dafür auch diese Schreibweise genutzt werden.

*-*-* *:*:00, *-*-* *:00:00, *-*-* 00:00:00, *-*-01 00:00:00, Mon *-*-* 00:00:00, *-01-01 00:00:00, *-01,04,07,10-01 00:00:00, *-01,07-01 00:00:00

Testen von OnCalendar= Zeitangaben

Kalendarische Zeitangaben können auf der Konsole mit folgendem Befehl auf Funktion geprüft werden:

systemd-analyze calendar "<Zeitangabe>"

Mit der Option --iterations <N> werden weitere Auslösezeitpunkte aufgelistet.

Relative Zeitangaben

(Stehen in Relation zu anderen Ereignissen)

Beispiel:

OnBootSec=2d 1h 30m

Einmalige Ereignisse

{{{1}}} Die Zeitspanne seit dem Booten des Rechners.

OnStartupSec= Die Zeitspanne seit dem Start von systemd.
OnActiveSec= Die Zeitspanne seit Aktivierung der Timer-Unit.

Wiederholende Ereignisse

OnUnitActiveSec= Die Zeitspanne seit der Timer den letzten Job ausgelöst hat.
OnUnitInactiveSec= Die Zeitspanne der Inaktivität seit Beendigung des letzten Jobs.

Folgende Einheiten können für relative Zeitangaben gewählt werden:

usec, us
msec, ms
seconds, second, sec, s
minutes, minute, min, m
hours, hour, hr, h
days, day, d
weeks, week, w
months, month, M (definiert als 30.44 Tage)
years, year, y (definiert als 365.25 Tage)

(Ohne Verwendung einer Einheit werden alle Angaben als Sekunden gewertet.)

Testen Relativer Zeitangaben

Relative Zeitangaben können auf der Konsole mit folgendem Befehl auf Funktion geprüft werden:

systemd-analyze timespan "<Zeitangabe>"

Weitere Optionen in [Timer]

AccuracySec= Bestimmt die Genauigkeit des Auslösezeitpunkts (default 1 min).
RandomizedDelaySec= Wird verwendet damit nicht mehrere Timer exakt gleichzeitig z.B um 00:00 loslegen.
WakeSystem= Weckt das System aus dem suspend mode.
Unit= Als default ist dieser Wert identisch mit dem Suffix der .timer Datei (s. oben). Bei Verwendung muss eine Datei mit dem hier angegebenen Namen erstellt werden. Eine Verschachtelung von Units ist hierdurch möglich.
Persistent=true Bewirkt, dass ein versäumter Job beim nächsten Rechnerstart unverzüglich nachgeholt wird.

RemainAfterElapse=false beendet den Timer nach einmaliger Ausführung.

Manpages

systemctl, systemd, systemd-analyze, systemd.directives, systemd.service, systemd.socket, systemd.special, systemd-system.conf, systemd.time, systemd.timer, systemd.unit

Siehe auch

Weblinks

suse - Arbeiten mit systemd-Zeitgebern
Michael Kofler Blog Anleitung und Beispiel
Gentoo wiki section on systemd timer services