|
|
| (22 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt) |
| Zeile 1: |
Zeile 1: |
| {{inuse|[[Benutzer:Tuxnix|Tuxnix]] ([[Benutzer Diskussion:Tuxnix|Diskussion]])}}
| |
| [[Kategorie:Systemverwaltung]]
| |
| [[Kategorie:Services]]
| |
|
| |
| [[en:Systemd/Timers]]
| |
| [[ja:Systemd/タイマー]]
| |
| [[ru:Systemd/Timers]]
| |
|
| |
|
| |
| {{righttoc}} | | {{righttoc}} |
| Timer bieten die Möglichkeit Aufgaben zeitlich zu steuern. Die Timer-Unit besteht aus einer {{ic|.timer}} Datei die eine {{ic|.service}} Datei ansteuert. | | Timer bieten die Möglichkeit Aufgaben zeitlich zu steuern. Die Timer-Unit besteht aus einer {{ic|.timer}} Datei die eine {{ic|.service}} Datei ansteuert. Timer unterstehen [[systemd]] und müssen 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 == |
| | | {{hc|1=beispiel.timer|2= |
| === Die {{ic|.timer}} Datei ===
| |
| <nowiki># Datei /etc/systemd/system/beispiel.timer
| |
| | |
| [Unit] | | [Unit] |
| Description=Beispielaktion 2Tage1St30Min nach dem Booten | | Description=Kurz-Beschreibung |
|
| |
|
| [Timer] | | [Timer] |
| OnBootSec=2d 1h 30m | | OnBootSec=1h 30m |
|
| |
|
| [Install] | | [Install] |
| WantedBy=basic.target</nowiki> | | WantedBy=basic.target}} |
| | |
| === Die {{ic|.service}} Datei ===
| |
| <nowiki># Datei /etc/systemd/system/beispiel.service
| |
|
| |
|
| | {{hc|1=beispiel.service|2= |
| [Unit] | | [Unit] |
| Description=Beispiel Service | | Description=Kurz-Beschreibung |
|
| |
|
| [Service] | | [Service] |
| ExecStart=/home/user/beispiel.sh</nowiki> | | ExecStart=/usr/bin/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. | | Service- und Timerdateien werden für |
| | * systemweite Dienste im Ordner {{ic|/etc/systemd/system/}} |
| | * userbezoge Dienste unter {{ic|~/.config/systemd/user/}} gespeichert. |
|
| |
|
| === De-/Aktivierung ===
| | Timer und Service müssen dabei den gleichen Namen tragen. Z.B.: |
| systemctl enable --now beispiel.timer
| | ({{ic|'''beispiel'''.timer}} und {{ic|'''beispiel'''.service}}). |
| (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. | | == De- / Aktivierung == |
| | Mit {{ic|systemctl enable --now}} startet der Timer unverzüglich und permanent, sodass er auch nach einem Neustart aktiv ist. Ohne {{ic|--now}} werden {{ic|enable}} oder auch {{ic|disable}} erst nach einem reboot wirksam. Ein {{ic|start}} bzw. {{ic|stop}} wirken sich hingegen nur auf die laufende Sitzung aus. Bei der ersten Initialisierung legt das System automatisch einen passenden [[ln|Symlink]] an. |
|
| |
|
| Ohne ''--now'' werden ''enable oder disable'' erst nach einem reboot wirksam.
| | Timer für systemweite Dienste werden mit Rootrechten aktiviert: |
| | # systemctl enable --now <name>.timer |
|
| |
|
| Ein ''start oder stop'' wirkt sich nur auf die laufende Sitzung aus.
| | Timer im Userbereich werden mit der Option {{ic|--user}} und mit Userrechten aktiviert: |
| | $ systemctl --user enable --now <name>.timer |
|
| |
|
| systemctl reenable --now beispiel.timer | | Aktualisierung von Timer und Sevice nach einer Änderung: |
| Genügt damit eine nachträgliche Veränderung der Timer-Unit sofort wirksam wird.
| | # systemctl reenable --now <name>.timer |
| | $ systemctl --user reenable --now <name>.timer |
|
| |
|
| === Management ===
| | == Management == |
| | Auflistung der Auslösezeiten: |
| 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''.
| | (Sollen nur die aktiven Timer angezeigt werden genügt auch ein {{ic|systemctl list-timers}}). |
|
| |
|
| | Statusmeldungen: |
| | systemctl status <name>.timer |
| | systemctl status <name>.service |
|
| |
|
| Die folgenden Befehle können beim Debuggen helfen:
| | Journaleinträge z.B.: |
| systemctl status beispiel.timer | | journalctl -u <name>.service -g Started |
|
| |
|
| journalctl -xe
| | == Die [Timer] Sektion == |
| | ( Für die Konfiguration der Sektionen [Unit], [Install] und [Service] sei an dieser Stelle auf die entsprechenden man pages verwiesen) |
|
| |
|
| == Optionen ==
| | In der Timer Sektion können auch mehrere Zeitangaben gemacht werden. Sie beeinflussen sich nicht und werden alle zu ihrem jeweiligen Zeitpunkt ausgeführt. |
| Die folgende Auflistung der einzelnen Optionen innerhalb der Sektionen der {{ic|.timer}} und {{ic|.service}} Dateien will lediglich einen Überblick bieten.
| |
|
| |
|
| Für Details wird auf die jeweilige ''man page'' verwiesen.
| |
|
| |
|
| Nur die '''fettgedruckten Optionen sind Pflichtangaben ''' der betreffenden Sektion.
| |
|
| |
|
| === [Unit] Sektion === | | === Kalendarische Zeitangaben === |
| * '''Description=''' #Hier muss die Einheit beschrieben werden. Die Formulierung ist frei. Auch darf sie in der {{ic|.timer}} und {{ic|.service}} Datei unterschiedlich sein. Kurze, aussagefähige Beschreibungen sind hierbei vorzuziehen. | | * OnCalendar= |
| * 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.
| |
| * RebootArgument= #Optionales reboot.
| |
| * ConditionArchitecture=, ConditionVirtualization=, ConditionHost=, ConditionKernelCommandLine=, ConditionSecurity=, ConditionCapability=, ConditionACPower=, ConditionNeedsUpdate=, ConditionFirstBoot=, ConditionPathExists=, ConditionPathExistsGlob=, ConditionPathIsDirectory=, ConditionPathIsSymbolicLink=, ConditionPathIsMountPoint=, ConditionPathIsReadWrite=, ConditionDirectoryNotEmpty=, ConditionFileNotEmpty=, ConditionFileIsExecutable= # Vorbedingung für die Ausführung der Unit.
| |
| * AssertArchitecture=, AssertVirtualization=, AssertHost=, AssertKernelCommandLine=, AssertSecurity=, AssertCapability=, AssertACPower=, AssertNeedsUpdate=, AssertFirstBoot=, AssertPathExists=, AssertPathExistsGlob=, AssertPathIsDirectory=, AssertPathIsSymbolicLink=, AssertPathIsMountPoint=, AssertPathIsReadWrite=, AssertDirectoryNotEmpty=, AssertFileNotEmpty=, AssertFileIsExecutable= # Wie Condition...allerdings incl. ''logged loudly'' bei failure.
| |
| * SourcePath= # Überprüft das Vorhandensein einer Datei.
| |
|
| |
| Genauere Auskunft gibt: {{ic|man systemd.unit}}
| |
|
| |
|
| === [Timer] Sektion === | | ==== Absolute kalendarische Zeitangaben ==== |
| Es können hier mehrere Zeitangaben gemacht werden. Mindestens '''eine Zeitangabe muss''' es in [Timer] geben.
| |
|
| |
|
| ==== Relative Zeitangaben ==== | | OnCalendar=Thu,Fri 2026-*-1..5 11:12:13 |
| 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:
| | (Der service wird jeweils um 11 Uhr 12, zwischen dem 1. und 5. Kalendertag eines jeden Monats des Jahres 2026 ausgelöst, wenn dies Donnerstage oder Freitage sind.) |
| 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.
| |
|
| |
|
| Beispiel:
| | Die Angabe von Wochentagen erfolgt immer in Englisch und ist optional. |
| OnBootSec=2d 1h 30m
| | 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(englisch/optional) Jahr-Monat-Tag Stunde:Minute:Sekunde |
|
| |
|
| ==== Absolute Zeitangaben ==== | | ==== Periodische kalendarische Zeitangaben ==== |
| * OnCalendar= #absolute Zeitangabe
| |
|
| |
|
| Die absolute Zeitangabe hat folgende Syntax:
| | OnCalendar=weekly |
| 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.
| | Auch diese Werte sind möglich. |
| | minutely, hourly, daily, monthly, weekly, yearly, quarterly, semiannually |
|
| |
|
| Die Angabe eines Wochentags erfolgt in Englisch. Sie ist optional.
| | Entsprechend den oberen Notierung, kann dafür auch diese Schreibweise genutzt werden. |
| Jede Rubrik kann mit "," oder ".." versehen werden oder durch "*" ersetzt 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 |
|
| |
|
| ==== Weitere Optionen in [Timer] ==== | | ==== Testen von OnCalendar= Zeitangaben ==== |
| * AccuracySec= #Die Zeitspanne zum Ausführen beträgt als default 1 Minute. Durch Verwendung von AccuracySec kann diese Zeitspannen variiert werden.
| | Kalendarische Zeitangaben können auf der Konsole mit folgendem Befehl auf Funktion geprüft werden: |
| * RandomizedDelaySec= #Kann verwendet werden damit nicht mehrere Timer exakt zur gleichen Zeit loslegen. default ist 0.
| | systemd-analyze calendar "<Zeitangabe>" |
| * Unit= #Als default ist dieser Wert identisch mit dem Suffix der {{ic|.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 [http://blog.higgsboson.tk/2013/06/09/use-systemd-as-a-cron-replacement 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.
| |
|
| |
|
| Weiteres dazu siehe {{ic|man systemd.time}}.
| | Mit der Option {{ic|--iterations <N>}} werden weitere Auslösezeitpunkte aufgelistet. |
|
| |
|
| === [Install] Sektion === | | === Relative Zeitangaben === |
| * Alias= #Aliasnamen der Unit. Wird nicht von jedem Type unterstützt.
| | (Stehen in Relation zu anderen Ereignissen) |
| * '''WantedBy=''', RequiredBy= basic.target #Legt einen symbolischen Link nach .wants/ bzw. .requires/ bei Initialisierung der Unit. Bei Angabe weiterer Units erhalten,in Zusammenhang mit Wants= and Requires= der [Unit] Sektion weitere Units einen Symlink.
| |
| * Also= #installiert oder deinstalliert andere Units bei Aktivierung dieser Unit.
| |
| * DefaultInstance= #Regelt den expliziten Einsatz von Vorlage Unit Dateien.
| |
|
| |
|
| Näheres dazu siehe {{ic|man systemd.unit}}.
| | Beispiel: |
| | OnBootSec=2d 1h 30m |
|
| |
|
|
| | ====Einmalige Ereignisse==== |
| === [Service] === | | * OnBootSec= - Die Zeitspanne seit dem Booten des Rechners. |
| * Type=simple, forking, oneshot, dbus, notify, idle #default ist simple.
| | * OnStartupSec= - Die Zeitspanne seit dem Start von systemd. |
| * RemainAfterExit= #Default ist no. yes hält den service aktiv.
| | * OnActiveSec= - Die Zeitspanne seit Aktivierung der Timer-Unit. |
| * GuessMainPID= #Default ist yes. Wenn die PID nicht exakt bestimmt werden kann wird normalerweise versucht sie zu berechnen. Dies kann hier ausgeschaltet werden. | |
| * PIDFile= #In Zusammenhang mit Type=forking kann für den Fork eine PID hinterlegt werden. | |
| * BusName= #Bei Type=dbus kann hier der betreffende D-bus Name vereinbart werden. | |
| * '''ExecStart=''' Angabe von einem oder mehrerer Befehle und deren Argumente oder eines ausführbaren Scripts. Die absolute Pfadangabe wird verlangt.
| |
| * ExecStartPre=, ExecStartPost= #Hier aufgeführte Befehle werden vor bzw. nach ExecStart= ausgeführt.
| |
| * ExecReload=# Wind genutzt um eine Rekonfiguration des Service zu veranlassen.
| |
| * ExecStop= #Wird benötigt falls der Service zum Beenden spezielle Befehle braucht.
| |
| * ExecStopPost= #Ergänzt ExecStop=
| |
| * RestartSec= #wird nur für Restart= gebraucht.
| |
| *
| |
| *
| |
| *
| |
| *
| |
|
| |
|
| | ====Wiederkehrende Ereignisse==== |
| | * OnUnitActiveSec= - Die Zeitspanne seit dem der Timer das letzte mal den Job ausgelöst hat. |
| | * OnUnitInactiveSec= - Die Zeitspanne seit der Beendigung des letzten Jobs. |
|
| |
|
| * Nice=19
| | Folgende Einheiten können für relative Zeitangaben gewählt werden: |
| * IOSchedulingClass=2
| | usec, us |
| * IOSchedulingPriority=7
| | msec, ms |
| * Environment="ABRT_IGNORE_PYTHON=1"
| | seconds, second, sec, s |
| * TimeoutStopSec=180
| | minutes, minute, min, m |
| * KillMode=process
| | hours, hour, hr, h |
| * KillSignal=SIGINT
| | 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>" |
|
| |
|
| RestartSec=
| | === Weitere Optionen in [Timer] === |
| Configures the time to sleep before restarting a service (as
| | * AccuracySec= - Bestimmt die Genauigkeit des Auslösezeitpunkts (default 1 min). |
| configured with Restart=). Takes a unit-less value in seconds, or a
| | * RandomizedDelaySec= - Wird verwendet damit nicht mehrere Timer exakt gleichzeitig z.B um 00:00 loslegen. |
| time span value such as "5min 20s". Defaults to 100ms.
| | * 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 existieren. Eine Verschachtelung von Units ist 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. |
|
| |
|
| TimeoutStartSec=
| | == Manpages == |
| Configures the time to wait for start-up. If a daemon service does
| |
| not signal start-up completion within the configured time, the
| |
| service will be considered failed and will be shut down again.
| |
| Takes a unit-less value in seconds, or a time span value such as
| |
| "5min 20s". Pass "infinity" to disable the timeout logic. Defaults
| |
| to DefaultTimeoutStartSec= from the manager configuration file,
| |
| except when Type=oneshot is used, in which case the timeout is
| |
| disabled by default (see systemd-system.conf(5)).
| |
|
| |
|
| TimeoutStopSec=
| | systemctl, systemd, systemd-analyze, systemd.directives, systemd.service, systemd.socket, systemd.special, systemd-system.conf, systemd.time, systemd.timer, systemd.unit |
| Configures the time to wait for stop. If a service is asked to
| |
| stop, but does not terminate in the specified time, it will be
| |
| terminated forcibly via SIGTERM, and after another timeout of equal
| |
| duration with SIGKILL (see KillMode= in systemd.kill(5)). Takes a
| |
| unit-less value in seconds, or a time span value such as "5min
| |
| 20s". Pass "infinity" to disable the timeout logic. Defaults to
| |
| DefaultTimeoutStopSec= from the manager configuration file (see
| |
| systemd-system.conf(5)).
| |
|
| |
|
| TimeoutSec=
| | == Siehe auch == |
| A shorthand for configuring both TimeoutStartSec= and
| | * [[systemd]] |
| TimeoutStopSec= to the specified value.
| | * [[systemd/Eigener Service|Einen eigenen systemd-Service erstellen]] |
| | * [[Automatische Sicherung (Beispiel)]] |
|
| |
|
| RuntimeMaxSec=
| | == Weblinks == |
| Configures a maximum time for the service to run. If this is used
| | * [https://documentation.suse.com/de-de/sle-micro/6.0/pdf/Micro-systemd-working-with-timers_de.pdf suse - Arbeiten mit systemd-Zeitgebern ] {{sprache|de}} |
| and the service has been active for longer than the specified time
| | * [https://kofler.info/systemd-timer-als-cron-alternative/ Michael Kofler Blog] Anleitung und Beispiel {{sprache|de}} |
| it is terminated and put into a failure state. Note that this
| | * [https://wiki.gentoo.org/wiki/Systemd#Timer_services Gentoo wiki section] on ''systemd'' timer services {{sprache|en}} |
| setting does not have any effect on Type=oneshot services, as they
| |
| terminate immediately after activation completed. Pass "infinity"
| |
| (the default) to configure no runtime limit.
| |
|
| |
|
| WatchdogSec=
| | [[Kategorie:Systemverwaltung]] |
| Configures the watchdog timeout for a service. The watchdog is
| | [[Kategorie:Service]] |
| activated when the start-up is completed. The service must call
| |
| sd_notify(3) regularly with "WATCHDOG=1" (i.e. the "keep-alive
| |
| ping"). If the time between two such calls is larger than the
| |
| configured time, then the service is placed in a failed state and
| |
| it will be terminated with SIGABRT. By setting Restart= to
| |
| on-failure, on-watchdog, on-abnormal or always, the service will be
| |
| automatically restarted. The time configured here will be passed to
| |
| the executed service process in the WATCHDOG_USEC= environment
| |
| variable. This allows daemons to automatically enable the
| |
| keep-alive pinging logic if watchdog support is enabled for the
| |
| service. If this option is used, NotifyAccess= (see below) should
| |
| be set to open access to the notification socket provided by
| |
| systemd. If NotifyAccess= is not set, it will be implicitly set to
| |
| main. Defaults to 0, which disables this feature. The service can
| |
| check whether the service manager expects watchdog keep-alive
| |
| notifications. See sd_watchdog_enabled(3) for details.
| |
| sd_event_set_watchdog(3) may be used to enable automatic watchdog
| |
| notification support.
| |
|
| |
|
| Restart=
| | [[en:Systemd/Timers]] |
| Configures whether the service shall be restarted when the service
| | [[fr:Systemd/cron]] |
| process exits, is killed, or a timeout is reached. The service
| | [[ja:Systemd/タイマー]] |
| process may be the main service process, but it may also be one of
| | [[ru:Systemd/Timers]] |
| the processes specified with ExecStartPre=, ExecStartPost=,
| |
| ExecStop=, ExecStopPost=, or ExecReload=. When the death of the
| |
| process is a result of systemd operation (e.g. service stop or
| |
| restart), the service will not be restarted. Timeouts include
| |
| missing the watchdog "keep-alive ping" deadline and a service
| |
| start, reload, and stop operation timeouts.
| |
| | |
| Takes one of no, on-success, on-failure, on-abnormal, on-watchdog,
| |
| on-abort, or always. If set to no (the default), the service will
| |
| not be restarted. If set to on-success, it will be restarted only
| |
| when the service process exits cleanly. In this context, a clean
| |
| exit means an exit code of 0, or one of the signals SIGHUP, SIGINT,
| |
| SIGTERM or SIGPIPE, and additionally, exit statuses and signals
| |
| specified in SuccessExitStatus=. If set to on-failure, the service
| |
| will be restarted when the process exits with a non-zero exit code,
| |
| is terminated by a signal (including on core dump, but excluding
| |
| the aforementioned four signals), when an operation (such as
| |
| service reload) times out, and when the configured watchdog timeout
| |
| is triggered. If set to on-abnormal, the service will be restarted
| |
| when the process is terminated by a signal (including on core dump,
| |
| excluding the aforementioned four signals), when an operation times
| |
| out, or when the watchdog timeout is triggered. If set to on-abort,
| |
| the service will be restarted only if the service process exits due
| |
| to an uncaught signal not specified as a clean exit status. If set
| |
| to on-watchdog, the service will be restarted only if the watchdog
| |
| timeout for the service expires. If set to always, the service will
| |
| be restarted regardless of whether it exited cleanly or not, got
| |
| terminated abnormally by a signal, or hit a timeout.
| |
| | |
| | |
| | |
| == E-Mail ==
| |
| [[en:Systemd/Timers]] Die engliche Archwiki Seite berichtet ausführlich darüber. | |
| | |
| == Weblinks ==
| |
| * [https://kofler.info/systemd-timer-als-cron-alternative/ Michael Kofler Blog] Anleitung und Beispiel
| |
| * [https://www.techrapid.co.uk/linux/arch-linux/automatic-update-arch-linux-with-systemd Techrapid] Autoupdate #Nur bedingt zu empfehlen!
| |
| * [http://www.dsm.fordham.edu/cgi-bin/man-cgi.pl?topic=systemd.unit&sect=5 man page systemd.unit] - [Unit] configuration
| |
| * [http://www.dsm.fordham.edu/cgi-bin/man-cgi.pl?topic=systemd.timer&sect=5 Man Page] systemd.timer - [Timer] configuration
| |
| * [http://www.dsm.fordham.edu/cgi-bin/man-cgi.pl?topic=systemd.service&sect=5 Man Pge] systemd.service - [Service] configuration
| |
| * [http://www.dsm.fordham.edu/cgi-bin/man-cgi.pl?topic=systemd.time&sect=7 Man Page] systemd.time - Time and date specifications
| |
| * [https://fedoraproject.org/wiki/Features/SystemdCalendarTimers Fedora Project wiki page] on ''systemd'' calendar timers
| |
| * [https://wiki.gentoo.org/wiki/Systemd#Timer_services Gentoo wiki section] on ''systemd'' timer services
| |
| * [https://www.freedesktop.org/software/systemd/man/systemd.timer.html freedesktop.org]Man page timer
| |
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
Absolute kalendarische Zeitangaben
OnCalendar=Thu,Fri 2026-*-1..5 11:12:13
(Der service wird jeweils um 11 Uhr 12, zwischen dem 1. und 5. Kalendertag eines jeden Monats des Jahres 2026 ausgelöst, wenn dies Donnerstage oder Freitage sind.)
Die Angabe von Wochentagen erfolgt immer in Englisch und 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(englisch/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
- OnBootSec= - Die Zeitspanne seit dem Booten des Rechners.
- OnStartupSec= - Die Zeitspanne seit dem Start von systemd.
- OnActiveSec= - Die Zeitspanne seit Aktivierung der Timer-Unit.
Wiederkehrende Ereignisse
- OnUnitActiveSec= - Die Zeitspanne seit dem der Timer das letzte mal den Job ausgelöst hat.
- OnUnitInactiveSec= - Die Zeitspanne seit der 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 existieren. Eine Verschachtelung von Units ist 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
