Systemd/Timers: Unterschied zwischen den Versionen

Aus wiki.archlinux.de
Zur Navigation springen Zur Suche springen
Zeile 6: Zeile 6:
 
[[ja:Systemd/タイマー]]
 
[[ja:Systemd/タイマー]]
 
[[ru:Systemd/Timers]]
 
[[ru:Systemd/Timers]]
 +
  
 
{{righttoc}}
 
{{righttoc}}
Timer bieten die Möglichkeit Aufgaben zeitlich zu steuern. Die Timer-Unit bestehen aus einer {{ic|.timer}} und einer {{ic|.service}} Datei.
+
Timer bieten die Möglichkeit Aufgaben zeitlich zu steuern. Die Timer-Unit besteht aus einer {{ic|.timer}} Datei die eine {{ic|.service}} Datei ansteuert.
Sie untersteht [[systemd]] und muss mit dem systemctl Befehl aktiviert werden. Eine Alternative hierzu bietet [[cron]].
+
Timer unterstehen [[systemd]] und müssen mit dem systemctl Befehl aktiviert werden. Eine Alternative hierzu bietet [[cron]].
  
 
== Beispiel ==
 
== Beispiel ==
  
 
=== Die {{ic|.timer}} Datei ===
 
=== Die {{ic|.timer}} Datei ===
  # Datei /usr/lib/systemd/system/foo.timer
+
  <nowiki># Datei /etc/systemd/system/beispiel.timer
[Unit]
+
 
Description=foo
+
[Unit]
[Timer]
+
Description=Beispielaktion 2Tage1St30Min nach dem Booten
OnBootSec=2d 1h 30m
+
 
[Install]
+
[Timer]
WantedBy=basic.target
+
OnBootSec=2d 1h 30m
 +
 
 +
[Install]
 +
WantedBy=basic.target</nowiki>
  
 
=== Die {{ic|.service}} Datei ===
 
=== Die {{ic|.service}} Datei ===
  # Datei /usr/lib/systemd/system/foo.service
+
  <nowiki># Datei /etc/systemd/system/beispiel.service
[Unit]
+
 
Description=foo
+
[Unit]
[Service]
+
Description=Beispiel Service
ExecStart=/usr/bin/foo
+
 
 +
[Service]
 +
ExecStart=/home/user/beispiel.sh</nowiki>
  
Das Beispiel stellt eine Minimalvariante dar Dateien dar.. Weitere Optionen siehe [[Systemd/Timers#Details]].
+
Dieses Beispiel stellt eine Minimalvariante der Dateien dar. Weitere Optionen siehe [[Systemd/Timers#Details]].
 
Als [Service] kann ein Befehl oder ein ausführbares Script genutzt werden.
 
Als [Service] kann ein Befehl oder ein ausführbares Script genutzt werden.
Service- und Timerdatei werden mit root Rechten in /usr/lib/systemd/system/ abgelegt und müssen vor dem . (Punkt) den gleichen Namen tragen.
+
Service- und Timerdatei werden mit root Rechten in /etc/systemd/system/ abgelegt und müssen vor dem . (Punkt) den gleichen Namen tragen.
  
 
=== De-/Aktivierung ===
 
=== De-/Aktivierung ===
(Bei der ersten Initialisierung legt das System automatisch einen symlink /etc/systemd/system/basic.target.wants/ → /usr/lib/systemd/system/ der {{ic|.timer}} Datei an.)
+
systemctl enable --now beispiel.timer
 +
(Bei der ersten Initialisierung legt das System automatisch einen symlink /etc/systemd/system/basic.target.wants/ → /etc/systemd/system/ der {{ic|.timer}} Datei an.)
 
Mit ''enable --now'' startet der Timer unverzüglich und permanent, sodass er auch nach einem Neustart aktiv ist.
 
Mit ''enable --now'' startet der Timer unverzüglich und permanent, sodass er auch nach einem Neustart aktiv ist.
Ohne ''--now'' werden ''enable, disable'' oder ''reenable'' erst nach einem reboot wirksam.
+
Ohne ''--now'' werden ''enable oder disable'' erst nach einem reboot wirksam.
 
Ein ''start oder stop'' wirkt sich hingegen nur auf die laufende Sitzung aus.
 
Ein ''start oder stop'' wirkt sich hingegen nur auf die laufende Sitzung aus.
  
  systemctl reenable --now foo.timer  
+
  systemctl reenable --now beispiel.timer
Genügt damit eine nachträgliche Veränderung der Timer-Unit auch wirksam wird.
+
Genügt damit eine nachträgliche Veränderung der Timer-Unit sofort wirksam wird.
  
 
=== Management ===
 
=== Management ===
 
  systemctl list-timers --all
 
  systemctl list-timers --all
Listet alle Timer auf. Sollen nur die aktiven Timer angezeigt werden genügt ein ''systemctl list-timers''
+
Listet alle Timer auf. Sollen nur die aktiven Timer angezeigt werden genügt ein ''systemctl list-timers''.
Debuggen: systemctl status foo.timer" and "journalctl -xe" for details
+
 
 +
 
 +
Die folgenden Befehle können beim Debuggen helfen:
 +
systemctl status beispiel.timer
 +
 
 +
journalctl -xe
 +
 
 
== Details ==
 
== Details ==
 
Nun zu den Optionen innerhalb der {{ic|.timer}} und {{ic|.service}} Dateien und welche Angaben hier getätigt werden können.
 
Nun zu den Optionen innerhalb der {{ic|.timer}} und {{ic|.service}} Dateien und welche Angaben hier getätigt werden können.

Version vom 22. März 2017, 21:12 Uhr

Construction.png „Systemd/Timers“ wurde von Tuxnix (Diskussion) als in Bearbeitung markiert. Um Bearbeitungskonflikte zu vermeiden, kontaktiere Tuxnix (Diskussion) bitte, bevor du den Artikel bearbeitest.



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

Die .timer Datei

# Datei /etc/systemd/system/beispiel.timer

[Unit]
Description=Beispielaktion 2Tage1St30Min nach dem Booten

[Timer]
OnBootSec=2d 1h 30m

[Install]
WantedBy=basic.target

Die .service Datei

# Datei /etc/systemd/system/beispiel.service

[Unit]
Description=Beispiel Service

[Service]
ExecStart=/home/user/beispiel.sh

Dieses Beispiel stellt eine Minimalvariante der Dateien dar. Weitere Optionen siehe Systemd/Timers#Details. Als [Service] kann ein Befehl oder ein ausführbares Script genutzt werden. Service- und Timerdatei werden mit root Rechten in /etc/systemd/system/ abgelegt und müssen vor dem . (Punkt) den gleichen Namen tragen.

De-/Aktivierung

systemctl enable --now beispiel.timer

(Bei der ersten Initialisierung legt das System automatisch einen symlink /etc/systemd/system/basic.target.wants/ → /etc/systemd/system/ der .timer Datei an.) Mit enable --now startet der Timer unverzüglich und permanent, sodass er auch nach einem Neustart aktiv ist. Ohne --now werden enable oder disable erst nach einem reboot wirksam. Ein start oder stop wirkt sich hingegen nur auf die laufende Sitzung aus.

systemctl reenable --now beispiel.timer

Genügt damit eine nachträgliche Veränderung der Timer-Unit sofort wirksam wird.

Management

systemctl list-timers --all

Listet alle Timer auf. Sollen nur die aktiven Timer angezeigt werden genügt ein systemctl list-timers.


Die folgenden Befehle können beim Debuggen helfen:

systemctl status beispiel.timer
journalctl -xe

Details

Nun zu den Optionen innerhalb der .timer und .service Dateien und welche Angaben hier getätigt werden können. Nur die fettgedruckten Parameter sind Pflichtangaben.

[Unit]

  • Description= #Hier muss die Einheit benannt werden.
  • Documentation= #Eine URL kann hier angegeben werden.
  • Requires=, Requisite= #Weitere Units können hier angegeben werden.
  • Wants= #ein etwas weicheres Requires=
  • BindsTo= #Auch hier wird eine Unit angegeben. Fällt der service aus, weil z.B. ein device entfernt wurde, wird die Timer-Unit an der Ausführung gehindert.
  • PartOf= #beim Ausfall eines service stopp die timer-unit. Jedoch ohne Auswirkungen auf die hier aufgeführten services.
  • Conflicts=
  • Before=, After= #legt die Start Reihenfolge von services fest.
  • OnFailure= #Ersatz-Units die bei Ausfall genutzt werden sollen.
  • PropagatesReloadTo=, ReloadPropagatedFrom= #ähndelt OnFailure=
  • JoinsNamespaceOf= #Nur wichtig wenn PrivateNetwork= oder PrivateTmp= eingesetzt wird.
  • RequiresMountsFor= #Überprüft ob devices auch gemountet sind.
  • OnFailureJobMode=fail, replace, replace-irreversibly, isolate, flush, ignore-dependencies, ignore-requirements #legt das Verhalten für OnFailure= fest. Default ist replace.
  • IgnoreOnIsolate=true/false #default ist false. Bei true wird nicht mehr gestoppt bei Isolierung einer anderen Unit.
  • StopWhenUnneeded=true/false #default ist false. Steht im Zusammenhang mit Requires=. Bei true werden nicht mehr benötigte units deaktiviert.
  • RefuseManualStart=true/false, RefuseManualStop=true/false #default ist false. Ein Sicherheitstool. bei true wird die die explizite User Eingabe verlangt, bevor Units de/aktiviert werden können.
  • AllowIsolate=true/false #default ist false. Sinnvoll um ähnlich der runlevels in SysV init Systemen um unbestimmte Systemzustände zu vermeiden.
  • DefaultDependencies=true/false #Default ist true und stellt sicher, das das System komplett hochgelaufen ist bevor die timer-unit gestartet wird.
  • JobTimeoutSec=, JobTimeoutAction=, JobTimeoutRebootArgument= #stellt bei gestaffelten Jobs ein time-out zur Verfügung.
  • StartLimitIntervalSec=, StartLimitBurst= #Als default werden 5 Ausführungen eines service innerhalb von 10 Sekunden zugestanden. Dieses Limit kann hier den speziellen Anforderungen angepasst werden.
  • StartLimitAction= #Ein Ersatzservice kann bestimmt werden falls das vereinbarte StartLimitIntervalSec=, StartLimitBurst= überschritten wird.

Die Auflistung der Optionen kann lediglich einem ersten Überblick dienen. Genauere Auskunft gibt:Man Page systemd.unit

[Timer]

Es können hier mehrere Zeitangaben gemacht werden. Mindestens eine Zeitangabe muss es in [Timer] geben.

relative Zeitangaben

Sind abhängig von anderen Ereignissen

  • OnActiveSec= #Zeitspanne seit Aktivierung des Timers selbst
  • OnBootSec= #Zeitspanne seit dem Booten des Rechners
  • OnStartupSec= #Zeitspanne seit dem ersten Start von systemd
  • OnUnitActiveSec= #Zeitspanne seit dem letzten Start des Timers
  • OnUnitInactiveSec= #Zeitspanne seit Inaktivität der Timer-Unit

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)


Beispiel:

OnBootSec=2d 1h 30m

siehe auch man systemd.time Ohne Verwendung einer Einheit werden alle Angaben als Sekunden gewertet.

absolute Zeitangaben

  • OnCalendar= #absolute Zeitangabe

Die absolute Zeitangabe hat folgende Syntax:

Thu,Fri 2012-*-1..5 11:12:13

Das obige Beispiel besagt: Um 11:12:13 Uhr, zwischen einschl. dem 1. und 5. Tag, aller Monate, des Jahres 2012, jedoch ausschließlich nur an Donnerstagen und Freitagen.

Die Angabe eines Wochentags erfolgt in Englisch. Sie ist optional. Jede Rubrik kann mit "," oder ".." versehen werden oder durch "*" ersetzt werden.

Weiteres dazu siehe man systemd.time.

Weitere Optionen in [Timer]

  • AccuracySec= #Die Zeitspanne zum Ausführen beträgt als default 1 Minute. Durch Verwendung von AccuracySec kann diese Zeitspannen variiert werden.
  • RandomizedDelaySec= #Kann verwendet werden damit nicht mehrere Timer exakt zur gleichen Zeit loslegen. default ist 0.
  • 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/false #true hält den Timer aktiv, false beendet den Timer nach einmaliger Ausführung.

[Install]

  • WantedBy=basic.target

[Service]

  • Type=oneshot
  • Nice=19
  • IOSchedulingClass=2
  • IOSchedulingPriority=7
  • Environment="ABRT_IGNORE_PYTHON=1"
  • ExecStart= Angabe eines Befehls oder eines ausführbaren Scripts.

E-Mail

Die engliche Wiki Seite berichtet darüber.

Weblinks