Zum Inhalt springen

Systemd.timer: Unterschied zwischen den Versionen

Aus Foxwiki
Versionsgeschichte interaktiv durchsuchen
← Zum vorherigen Versionsunterschied
Visuell
Keine Bearbeitungszusammenfassung
K Textersetzung - „<div style="column-count:3">“ durch „<div style="column-count:2">“
 
(62 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
== Timer Units ==
'''systemd.timer''' - [[Systemd]] [[Timer Units]]
[https://wiki.ubuntuusers.de/systemd/ systemd] bietet die Möglichkeit, Timer Units zu erstellen. In einer Timer Unit kann hinterlegt werden, dass eine [https://wiki.ubuntuusers.de/systemd/Service_Units/ Service Unit] zu einem bestimmten Zeitpunkt ausgeführt wird.


Timer Units können also Aufgaben übernehmen, welche traditionell von [https://wiki.ubuntuusers.de/Cron/ Cron] ausgeführt werden. Aber Timer Units können nicht nur Befehle zu einem festen Zeitpunkt ausführen (z.B. "um Mitternacht"), sondern auch relativ zum Systemstart (z.B. "5 Minuten später").
== 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 ==
== Installation ==
Da systemd ab Ubuntu 15.04 integraler Bestandteil des Systems ist (und dieses ohne systemd nicht lauffähig ist), sind alle benötigten Komponenten bereits installiert.
Systeme, die [[systemd]] verwenden, enthalten die benötigten Komponenten standardmäßig


== Benutzung ==
== Aufruf ==
Timer Units werden als einfache Textdateien angelegt[https://wiki.ubuntuusers.de/systemd/Timer_Units/#source-2 [2]], mit einer Syntax und einem Aufbau ähnlich [https://de.wikipedia.org/wiki/Initialisierungsdatei INI-Dateien]. Der Dateiname kann frei gewählt werden, muss aber auf '''.timer''' enden. Selbsterstellte Timer werden im Verzeichnis '''/etc/systemd/system''' abgespeichert, wozu Root-Rechte[https://wiki.ubuntuusers.de/systemd/Timer_Units/#source-3 [3]] erforderlich sind.
<syntaxhighlight lang="bash" highlight="1" line copy>
</syntaxhighlight>


Eine Timer Unit hat z.B. folgenden Aufbau:
=== Optionen ===
{| class="wikitable sortable options gnu"
|-
! Unix !! GNU !! Parameter !! Beschreibung
|-
| || || ||
|-
|}


[Unit]
=== Parameter ===
Description=Eine kurze Beschreibung des Timers
 
=== Umgebungsvariablen ===


[Timer]
=== Exit-Status ===
OnBootSec=2min
{| class="wikitable options col1center"
OnUnitActiveSec=5min
|-
Unit=name_der_zu_startenden_unit.service
! Wert !! Beschreibung
|-
| 0 || Erfolg
|-
| >0 || Fehler
|}


[Install]
== Anwendung ==
WantedBy=multi-user.target
=== Anzeige ===
Timer anzeigen
; Systemweite Timer
<syntaxhighlight lang="bash" highlight="1" line copy>
sudo systemctl list-timers
</syntaxhighlight>


Es gibt drei Sektionen: * ''"[Unit]"''
; Von Benutzern angelegte Timer
* ''"[Timer]"'' und
<syntaxhighlight lang="bash" highlight="1" line copy>
* ''"[Install]"''
sudo systemctl --user list-timers
</syntaxhighlight>


Die Bedeutung der Sektionen ''"[Unit]"'' und ''"[Install]"'' ist identisch mit der von [https://wiki.ubuntuusers.de/systemd/Service_Units/#Eigene-Service-Units-anlegen Service Units]. Die Sektion ''"[Timer]"'' enthält dabei die Informationen, wann die im Schlüssel <tt>Unit</tt> hinterlegte Unit ausgeführt werden soll.
; Inaktiven Timer
<blockquote>
Inaktive Timer werden mit der Option <tt>--all</tt> angezeigt
</blockquote>


Im obigen Beispiel würde die Unit namens '''name_der_zu_startenden_unit.service''' wie folgt ausgeführt: * <tt>OnBootSec=2min</tt> - erste Ausführung 2 Minuten nach Beginn des Bootvorgangs
=== Aktivierung ===
* <tt>OnUnitActiveSec=5min</tt> - weitere Ausführungen jeweils 5 Minuten, nachdem die Service Unit zu letzten Mal gestartet wurde
Timer aktivieren
; Timer Units aktivieren
Nach der Erstellung müssen Timer Unitsaktiviert und gestartet werden
<syntaxhighlight lang="bash" highlight="1-2" line copy>
sudo systemctl enable name_des_timers.timer
sudo systemctl start name_des_timers.timer
</syntaxhighlight>


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


{| style="border-spacing:0;width:17cm;"
{| class="wikitable options"
|- style="border:none;padding:0.049cm;"
|-
|| Schlüssel
! Schlüssel !! Beschreibung
|| Erklärung
|-
|- style="border:none;padding:0.049cm;"
|| <tt>OnActiveSec</tt>
|| <tt>OnActiveSec</tt>
|| relative Zeit bezogen auf den Zeitpunkt, als die Timer Unit zuletzt aktiviert wurde
|| relative Zeit bezogen auf den Zeitpunkt, als die Timer Unit zuletzt aktiviert wurde
|- style="border:none;padding:0.049cm;"
|-
|| <tt>OnBootSec</tt>
|| <tt>OnBootSec</tt>
|| relative Zeit bezogen auf den Zeitpunkt, als der Rechner gestartet wurde
|| relative Zeit bezogen auf den Zeitpunkt, als der Rechner gestartet wurde
|- style="border:none;padding:0.049cm;"
|-
|| <tt>OnStartupSec</tt>
|| <tt>OnStartupSec</tt>
|| relative Zeit bezogen auf den Zeitpunkt, als systemd gestartet wurde
|| relative Zeit bezogen auf den Zeitpunkt, als systemd gestartet wurde
|- style="border:none;padding:0.049cm;"
|-
|| <tt>OnUnitActiveSec</tt>
|| <tt>OnUnitActiveSec</tt>
|| relative Zeit bezogen auf den Zeitpunkt, als die Service Unit zuletzt aktiviert wurde
|| relative Zeit bezogen auf den Zeitpunkt, als die Service Unit zuletzt aktiviert wurde
|- style="border:none;padding:0.049cm;"
|-
|| <tt>OnUnitInactiveSec</tt>
|| <tt>OnUnitInactiveSec</tt>
|| relative Zeit bezogen auf den Zeitpunkt, als die Service Unit zuletzt deaktiviert wurde
|| 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 <tt>OnCalendar</tt> angeben. So würde z.B. die folgende Timer Unit:


{| style="border-spacing:0;width:10.428cm;"
Außerdem kennen Timer Units noch absolute Zeitangaben
|- style="border:none;padding:0.049cm;"
* Diese werden im Schlüssel <tt>OnCalendar</tt> angeben
* So würde z.B
* die folgende Timer Unit:
 
{| class="wikitable options"
|-
|| 1
|| 1
2
2
Zeile 79: Zeile 117:
|-
|-
|}
|}
die Service Unit '''name_der_zu_startenden_unit.service''' an jedem Tag von Montag bis Freitag um 12 Uhr ausführen.


=== Zeitangaben ===
die Service Unit '''name_der_zu_startenden_unit.service''' an jedem Tag von Montag bis Freitag um 12 Uhr ausführen
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 [http://www.freedesktop.org/software/systemd/man/systemd.time.html#Parsing%20Time%20Spans Dokumentation] von systemd zu finden.
 
; 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 [http://www.freedesktop.org/software/systemd/man/systemd.time.html#Parsing%20Time%20Spans Dokumentation] von systemd zu finden


Für die Werte des <tt>OnCalendar</tt> Schlüssel kennt systemd eine flexible Syntax zur Zeitangabe. So steht z.B. der Wert <tt>Thu,Fri 2016-*-1,5 11:12:13</tt> für: * am 1. und 5. jedes Monats im Jahr 2016 um 11 Uhr, 12 Minuten und 13 Sekunden ausführen
Für die Werte des <tt>OnCalendar</tt> Schlüssel kennt systemd eine flexible Syntax zur Zeitangabe
* So steht z.B
* der Wert <tt>Thu,Fri 2016-*-1,5 11:12:13</tt> 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
* aber nur, wenn diese Tage ein Donnerstag oder Freitag sind


Eine vollständige Übersicht inklusive vieler Beispiele findet man in der [http://www.freedesktop.org/software/systemd/man/systemd.time.html#Calendar%20Events Dokumentation] von systemd.
Eine vollständige Übersicht inklusive vieler Beispiele findet man in der [http://www.freedesktop.org/software/systemd/man/systemd.time.html#Calendar%20Events 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 <tt>[Timer]</tt> zusätzlich die Direktive
Persistent=true
setzen
 
; Voreinstellung
Die Voreinstellung von systemd ist hier <tt>false</tt>
* verpasste Timer werden nicht nachgeholt
* Die Direktive funktioniert nur in Kombination mit der <tt>OnCalendar</tt> Direktive, nicht mit anderen Direktiven für Zeitpunkte


=== verpasste Timer nachholen ===
=== at Ersatz ===
Möchte man eine Timer Unit auch noch nachträglich ausführen lassen, also z.B. falls der Rechner zum Zeitpunkt der Fälligkeit des Timers ausgeschaltet war, muss man im Abschnitt <tt>[Timer]</tt> zusätzlich die Direktive
Neben den Aufgaben, die traditionell [https://wiki.ubuntuusers.de/Cron/ Cron] erledigt, kann systemd auch die typische Aufgabe von [https://wiki.ubuntuusers.de/at/ 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


Persistent=true
; Beispiel
Als root
sudo systemd-run --on-calendar="2022-01-30 20:01:35" touch /tmp/testfile


setzen. Die Voreinstellung von systemd ist hier <tt>false</tt>, d.h. verpasste Timer werden nicht nachgeholt. Die Direktive funktioniert nur in Kombination mit der <tt>OnCalendar</tt> Direktive, nicht mit anderen Direktiven für Zeitpunkte.
Als normaler User
systemd-run --user --on-calendar="2022-01-30 20:01:35" touch ~/testfile


=== Timer Units aktivieren ===
Diese Timer werden in den Verzeichnissen '''/run/systemd/transient''' (systemweit) und für Benutzer in '''/run/user/<uid>/systemd/transient''' angelegt
Nach dem Erstellen müssen Timer Units noch aktiviert und gestartet werden[https://wiki.ubuntuusers.de/systemd/Timer_Units/#source-1 [1]]:
* Dabei wird standardmäßig ein zufälliger Name generiert
* Man kann den Namen des Timers aber auch explizit mit der Option <tt>--unit=</tt> festlegen


sudo systemctl enable name_des_timers.timer
=== Genauigkeit ===
sudo systemctl start name_des_timers.timer
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


=== at Ersatz ===
Wer für einzelne Timer Units einen genaueren Ausführungszeitraum braucht, der kann in der Sektion ''"[Timer]"'' zusätzlich den Schlüssel <tt>AccuracySec</tt> angeben, gefolgt von einer Zeitangabe
Neben den Aufgaben, die traditionell [https://wiki.ubuntuusers.de/Cron/ Cron] erledigt, kann systemd auch die typische Aufgabe von [https://wiki.ubuntuusers.de/at/ 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:
* So würde beispielsweise <tt>AccuracySec=5s</tt> die Genauigkeit auf 5 Sekunden setzen


<nowiki># als root</nowiki>
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'''
sudo systemd-run --on-calendar="2022-01-30 20:01:35" touch /tmp/testfile
<nowiki># als normaler User</nowiki>
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 <tt>--unit=</tt> festlegen.
Aufgrund dieser Tatsache kann nicht eindeutig die verbleibende Zeit bis zum Trigger ermittelt werden
* Dieser Umstand wird im [https://unix.stackexchange.com/a/526906/427268 unix.stackexchange] ausführlich beschrieben
* Darüber hinaus gibt es noch die Möglichkeit mit <tt>RandomizedDelaySec</tt> eine absichtliche gleichverteilt zufällige Verzögerung zu erzeugen


=== Genauigkeit ===
=== Timer stoppen/deaktivieren ===
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.
; Stoppen
Wie alle anderen Systemd-Units lassen sich Timer stoppen
<syntaxhighlight lang="bash" highlight="1" line copy>
sudo systemctl stop name_des_timers.timer
</syntaxhighlight>


Wer für einzelne Timer Units einen genaueren Ausführungszeitraum braucht, der kann in der Sektion ''"[Timer]"'' zusätzlich den Schlüssel <tt>AccuracySec</tt> angeben, gefolgt von einer Zeitangabe. So würde z.B. <tt>AccuracySec=5s</tt> die Genauigkeit auf 5 Sekunden setzen.
; Deaktivieren
Sofern Timer wiederkehrend mit dem System-Start aktiviert wurden, deaktiviert man sie unter Verwendung von
<syntaxhighlight lang="bash" highlight="1" line copy>
sudo systemctl disable name_des_timers.timer
</syntaxhighlight>


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'''.
; systemd-run
Bei mittels <tt>systemd-run</tt> 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'''


Aufgrund dieser Tatsache kann nicht eindeutig die verbleibende Zeit bis zum Trigger ermittelt werden. Dieser Umstand wird im [https://unix.stackexchange.com/a/526906/427268 unix.stackexchange] ausführlich beschrieben. Darüber hinaus gibt es noch die Möglichkeit mit <tt>RandomizedDelaySec</tt> eine absichtliche gleichverteilt zufällige Verzögerung zu erzeugen.
Dementsprechend stopt man diese mittels
<syntaxhighlight lang="bash" highlight="1" line copy>
sudo systemctl stop name_des_timers.{service,timer}
</syntaxhighlight>


=== Timer anzeigen ===
Die <tt>systemd-run</tt>-Timer werden damit auch gleichzeitig aus den betreffenden Verzeichnissen gelöscht, sodass sie gegebenenfalls durch erneutes Anlegen mittels <tt>systemd-run</tt> neu eingerichtet werden müssen
Man kann sich alle aktiven Timer mit Hilfe von [https://wiki.ubuntuusers.de/systemd/systemctl/ systemctl] wie folgt anzeigen lassen:


<nowiki># Systemweite Timer:</nowiki>
== Konfiguration ==
systemctl list-timers
=== Aufbau ===
; Aufbau eine Timer Unit
[[Textdatei]]
* Ähnlich einer [https://de.wikipedia.org/wiki/Initialisierungsdatei INI-Dateien]
* Der Dateiname kann frei gewählt werden, muss aber auf '''.timer''' enden


<nowiki># Von Benutzern angelegte Timer:</nowiki>
=== Selbsterstellte Timer ===
systemctl --user list-timers
Selbsterstellte Timer werden
* /etc/systemd/system
* Root-Rechte erforderlich


Möchte man zusätzlich die inaktiven Timer sehen, muss man dem Befehl noch die Option <tt>--all</tt> hinzufügen.
<syntaxhighlight lang="bash" highlight="1,4,9" line copy>
[Unit]
Description=Eine kurze Beschreibung des Timers


=== Timer stoppen und deaktivieren ===
[Timer]
Wie alle anderen Systemd-Units lassen sich Timer mittels,
OnBootSec=2min
OnUnitActiveSec=5min
Unit=name_der_zu_startenden_unit.service


sudo systemctl stop name_des_timers.timer
[Install]
WantedBy=multi-user.target
</syntaxhighlight>


stoppen.
=== Sektionen ===
{| class="wikitable options"
|-
! Sektion  !! Beschreibung
|-
| [Unit] ||
|-
| [Timer] ||
|-
| [Install] ||
|}


Sofern Timer wiederkehrend mit dem System-Start aktiviert wurden, deaktiviert man sie unter Verwendung von
Die Bedeutung der Sektionen ''"[Unit]"'' und ''"[Install]"''
* identisch mit der von [https://wiki.ubuntuusers.de/systemd/Service_Units/#Eigene-Service-Units-anlegen Service Units]
* Die Sektion ''"[Timer]"'' enthält dabei die Informationen, wann die im Schlüssel <tt>Unit</tt> hinterlegte Unit ausgeführt werden soll


sudo systemctl disable name_des_timers.timer
; Beispiel
würde die Unit namens '''name_der_zu_startenden_unit.service''' wie folgt ausgeführt
* <tt>OnBootSec=2min</tt> - erste Ausführung 2 Minuten nach Beginn des Bootvorgangs
* <tt>OnUnitActiveSec=5min</tt> - weitere Ausführungen jeweils 5 Minuten, nachdem die Service Unit zu letzten Mal gestartet wurde


Bei mittels <tt>systemd-run</tt> 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:
=== Dateien ===
{| class="wikitable options"
|-
! Datei !! Beschreibung
|-
| ||
|-
| ||
|}
<noinclude>


sudo systemctl stop name_des_timers.{service,timer}
== Anhang ==


Die <tt>systemd-run</tt>-Timer werden damit auch gleichzeitig aus den betreffenden Verzeichnissen gelöscht, so dass sie gegebenenfalls durch erneutes Anlegen mittels <tt>systemd-run</tt> neu eingerichtet werden müssen.
=== Siehe auch ===
<div style="column-count:2">
<categorytree hideroot=on mode="pages">systemd</categorytree>
</div>
----
{{Special:PrefixIndex/{{BASEPAGENAME}}/}}


== Links ==
=== Dokumentation ===
* [http://www.freedesktop.org/software/systemd/man/systemd.timer.html Dokumentation] von systemd Timer Units
<!--
* [https://wiki.archlinux.org/index.php/Systemd/Timers#Example systemd Timer] im Wiki von Archlinux
; Man-Page
# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]


; Info-Pages
-->


=== Links ===
==== Projekt ====


==== Weblinks ====
# http://www.freedesktop.org/software/systemd/man/systemd.timer.html
# https://wiki.archlinux.org/index.php/Systemd/Timers
# https://de.wikipedia.org/wiki/Systemd
# https://de.wikipedia.org/wiki/Systemd
# https://de.wikipedia.org/wiki/Cron
# https://de.wikipedia.org/wiki/Cron
# https://wiki.ubuntuusers.de/systemd/Timer_Units
# https://wiki.ubuntuusers.de/systemd
# [https://wiki.ubuntuusers.de/systemd/Service_Units/ Service Unit]
{{DEFAULTSORT:systemd.timer}}
{{DISPLAYTITLE:systemd.timer}}
[[Kategorie:systemd]]
</noinclude>

Aktuelle Version vom 28. Juni 2025, 11:13 Uhr

systemd.timer - Systemd Timer Units

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

Anzeige

Timer anzeigen

Systemweite Timer
sudo systemctl list-timers
Von Benutzern angelegte Timer
sudo systemctl --user list-timers
Inaktiven Timer

Inaktive Timer werden mit der Option --all angezeigt

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

  1. http://www.freedesktop.org/software/systemd/man/systemd.timer.html
  2. https://wiki.archlinux.org/index.php/Systemd/Timers
  3. https://de.wikipedia.org/wiki/Systemd
  4. https://de.wikipedia.org/wiki/Cron
  5. https://wiki.ubuntuusers.de/systemd/Timer_Units
  6. https://wiki.ubuntuusers.de/systemd
  7. Service Unit


Abgerufen von „https://wiki.foxtom.de/index.php?title=Systemd.timer&oldid=147838“