Zum Inhalt springen

Benutzer:Tuxnix

Aus wiki.archlinux.de

Ü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=Beispiel

[Timer]
OnBootSec=1h 30m

[Install]
WantedBy=basic.target
beispiel.service
[Unit]
Description=Beispiel

[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 <beispiel>.timer

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

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

Aktualisierung von Timer und Sevice nach einer Änderung: 

# systemctl reenable --now <beispiel>.timer
$ systemctl --user reenable --now <beispiel>.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 <beispiel>.timer
systemctl status <beispiel>.service

Journaleinträge: 

journalctl -u <beispiel>.service -g Started

Die [Timer] Sektion

( Für die Konfiguration der Sektionen [Unit], [Install] und [Service] sei an dieser Stelle auf die 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

Zum obigen Beispiel: 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 "*" 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 der OnCalendar= Einträge

Die kalendarischen Einträge können auf der Konsole mit folgendem Befehl auf Funktion geprüft werden: 

systemd-analyze calendar <Eintrag>

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

Relative Zeitangaben

(Stehen in Relation zu anderen Ereignissen)

Beispiel: 

OnBootSec=2d 1h 30m
  • OnBootSec= - Zeitspanne seit dem Booten des Rechners.
  • OnStartupSec= - Zeitspanne seit dem Start von systemd.
  • OnActiveSec= - Zeitspanne seit Aktivierung der Timer-Unit.
  • OnUnitActiveSec= - Zeitspanne seit der Timer den letzten Job ausgelöst hat.
  • OnUnitInactiveSec= - 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

systemd-analyze timespan "Zeitangabe"

Weitere Optionen in [Timer]

  • AccuracySec= Die Zeitspanne zum Ausführen beträgt als default 1 Minute. Durch Verwendung von AccuracySec kann diese Zeitspanne variiert werden.
  • RandomizedDelaySec= Kann verwendet werden damit nicht mehrere Timer exakt um z.B um 0 Uhr loslegen.
  • Unit= Als default ist dieser Wert identisch mit dem Suffix der .timer Datei. Bei der Verwendung von Unit= muss auch eine Datei mit selbigen Namen erstellt werden. Eine Verschachtelung von Units ist hierdurch möglich. Siehe Higgsboson Blog Reflector
  • Persistent=true bewirkt, dass ein versäumter Job beim nächsten Rechnerstart unverzüglich nachgeholt wird.
  • WakeSystem= weckt das System aus dem supend mode.
  • RemainAfterElapse= true hält den Timer aktiv, false beendet den Timer nach einmaliger Ausführung.

Weiteres dazu siehe man systemd.time.


Näheres dazu siehe man systemd.unit und man systemd.special.


Näheres dazu siehe man systemd.service.

man pages

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

Siehe auch

Abgerufen von „https://wiki.archlinux.de/index.php?title=Benutzer:Tuxnix&oldid=25467“