systemd.timer

Beschreibung

Timer Unit

Beschreibt, wann eine Service Unit ausgeführt werden soll

Kann Aufgaben übernehmen, welche traditionell von Cron ausgeführt werden

Flexibilität

Timer Units können nicht nur Befehle zu einem festen Zeitpunkt ausführen (beispielsweise "um Mitternacht"), sondern auch relativ zum Systemstart (beispielsweise "5 Minuten später")

Installation

Systeme, die systemd verwenden, enthalten die benötigten Komponenten standardmäßig

Aufruf

Optionen

Unix	GNU	Parameter	Beschreibung

Parameter

Umgebungsvariablen

Exit-Status

Wert	Beschreibung
0	Erfolg
>0	Fehler

Anwendung

Aktivierung

Timer aktivieren

Timer Units aktivieren

Nach der Erstellung müssen Timer Unitsaktiviert und gestartet werden

sudo systemctl enable name_des_timers.timer
sudo systemctl start name_des_timers.timer

Ausführungszeitpunkte

Timer Units kennen fünf verschiedene Schlüssel für relative Ausführungszeitpunkte:

Schlüssel	Beschreibung
`OnActiveSec`	relative Zeit bezogen auf den Zeitpunkt, als die Timer Unit zuletzt aktiviert wurde
`OnBootSec`	relative Zeit bezogen auf den Zeitpunkt, als der Rechner gestartet wurde
`OnStartupSec`	relative Zeit bezogen auf den Zeitpunkt, als systemd gestartet wurde
`OnUnitActiveSec`	relative Zeit bezogen auf den Zeitpunkt, als die Service Unit zuletzt aktiviert wurde
`OnUnitInactiveSec`	relative Zeit bezogen auf den Zeitpunkt, als die Service Unit zuletzt deaktiviert wurde

Außerdem kennen Timer Units noch absolute Zeitangaben

Diese werden im Schlüssel OnCalendar angeben
So würde z.B
die folgende Timer Unit:

1 2 3 4 5 6 7 8 9	[Unit] Description=Eine kurze Beschreibung des Timers [Timer] OnCalendar=Mon-Fri --* 12:00:00 Unit=name_der_zu_startenden_unit.service [Install] WantedBy=multi-user.target

die Service Unit name_der_zu_startenden_unit.service an jedem Tag von Montag bis Freitag um 12 Uhr ausführen

Zeitangaben

Die Timer von systemd kennen eine Vielzahl von Zeiteinheiten

Die kleinste Zeiteinheit sind Mikrosekunden, die größte Jahre
Eine komplette Übersicht inklusive der Einheiten ist in der Dokumentation von systemd zu finden

Für die Werte des OnCalendar Schlüssel kennt systemd eine flexible Syntax zur Zeitangabe

So steht z.B
der Wert Thu,Fri 2016-*-1,5 11:12:13 für:
am 1
und 5
jedes Monats im Jahr 2016 um 11 Uhr, 12 Minuten und 13 Sekunden ausführen
aber nur, wenn diese Tage ein Donnerstag oder Freitag sind

Eine vollständige Übersicht inklusive vieler Beispiele findet man in der Dokumentation von systemd

Verpasste Timer

Verpasste Timer nachholen

Möchte man eine Timer-Unit auch nachträglich ausführen lassen

also etwa falls der Rechner zum Zeitpunkt der Fälligkeit des Timers ausgeschaltet war
muss man im Abschnitt [Timer] zusätzlich die Direktive

Persistent=true

setzen

Voreinstellung

Die Voreinstellung von systemd ist hier false

verpasste Timer werden nicht nachgeholt
Die Direktive funktioniert nur in Kombination mit der OnCalendar Direktive, nicht mit anderen Direktiven für Zeitpunkte

at Ersatz

Neben den Aufgaben, die traditionell Cron erledigt, kann systemd auch die typische Aufgabe von at übernehmen, einen Job nur ein einziges mal zu einem bestimmten Zeitpunkt zu starten

Es muss kein Script angelegt werden, sondern es genügt das Abschicken eines Befehls im Terminal

Beispiel

Als root

sudo systemd-run --on-calendar="2022-01-30 20:01:35" touch /tmp/testfile

Als normaler User

systemd-run --user --on-calendar="2022-01-30 20:01:35" touch ~/testfile

Diese Timer werden in den Verzeichnissen /run/systemd/transient (systemweit) und für Benutzer in /run/user/<uid>/systemd/transient angelegt

Dabei wird standardmäßig ein zufälliger Name generiert
Man kann den Namen des Timers aber auch explizit mit der Option --unit= festlegen

Genauigkeit

Per Voreinstellung haben die Timer eine Genauigkeit von einer Minute, d.h aller spätestens eine Minute nach der in der .timer Datei angegebenen Zeit wird die vom Timer aufgerufene Service Unit aufgerufen

Wer für einzelne Timer Units einen genaueren Ausführungszeitraum braucht, der kann in der Sektion "[Timer]" zusätzlich den Schlüssel AccuracySec angeben, gefolgt von einer Zeitangabe

So würde beispielsweise AccuracySec=5s die Genauigkeit auf 5 Sekunden setzen

Wer eine höhere Genauigkeit für alle Timer systemweit benötigt, der hinterlegt den gewünschten Wert in der Konfigurationsdatei /etc/systemd/system.conf

Aufgrund dieser Tatsache kann nicht eindeutig die verbleibende Zeit bis zum Trigger ermittelt werden

Dieser Umstand wird im unix.stackexchange ausführlich beschrieben
Darüber hinaus gibt es noch die Möglichkeit mit RandomizedDelaySec eine absichtliche gleichverteilt zufällige Verzögerung zu erzeugen

Timer stoppen/deaktivieren

Stoppen

Wie alle anderen Systemd-Units lassen sich Timer stoppen

sudo systemctl stop name_des_timers.timer

Deaktivieren

Sofern Timer wiederkehrend mit dem System-Start aktiviert wurden, deaktiviert man sie unter Verwendung von

sudo systemctl disable name_des_timers.timer

systemd-run

Bei mittels systemd-run angelegten Timern muss berücksichtigt werden, dass das System für diese zwei Dateien pro Timer generiert; eine mit der Endung .service und eine mit der Endung .timer

Dementsprechend stopt man diese mittels

sudo systemctl stop name_des_timers.{service,timer}

Die systemd-run-Timer werden damit auch gleichzeitig aus den betreffenden Verzeichnissen gelöscht, sodass sie gegebenenfalls durch erneutes Anlegen mittels systemd-run neu eingerichtet werden müssen

Konfiguration

Aufbau

Aufbau eine Timer Unit

Textdatei

Ähnlich einer INI-Dateien
Der Dateiname kann frei gewählt werden, muss aber auf .timer enden

Selbsterstellte Timer

Selbsterstellte Timer werden

/etc/systemd/system
Root-Rechte erforderlich

[Unit]
Description=Eine kurze Beschreibung des Timers

[Timer]
OnBootSec=2min
OnUnitActiveSec=5min
Unit=name_der_zu_startenden_unit.service

[Install]
WantedBy=multi-user.target

Sektionen

Sektion	Beschreibung
[Unit]
[Timer]
[Install]

Die Bedeutung der Sektionen "[Unit]" und "[Install]"

identisch mit der von Service Units
Die Sektion "[Timer]" enthält dabei die Informationen, wann die im Schlüssel Unit hinterlegte Unit ausgeführt werden soll

Beispiel

würde die Unit namens name_der_zu_startenden_unit.service wie folgt ausgeführt

OnBootSec=2min - erste Ausführung 2 Minuten nach Beginn des Bootvorgangs
OnUnitActiveSec=5min - weitere Ausführungen jeweils 5 Minuten, nachdem die Service Unit zu letzten Mal gestartet wurde

Dateien

Datei	Beschreibung

Anhang

Siehe auch

Dokumentation

Links

Projekt

Weblinks