Arbeiten mit systemd-Zeitgebern

Im folgenden Beispiel wird das Kommando mailx aus dem Paket mailx verwendet. Dazu muss der Postfix-E-Mail-Server installiert und korrekt konfiguriert sein.

1. Erstellen Sie das Skript /usr/local/bin/send_systemd_email.

   1. Das Skript benötigt zwei Parameter: $1, die E-Mail-Adresse und $2, der Name der Dienstdatei, für die die Fehlermeldung eingegangen ist. Beide Parameter werden von der Unit-Datei bereitgestellt, die das Mail-Skript ausführt.

      #!/bin/sh
      systemctl status --full "$2" | mailx -S sendwait\
       -s "Service failure for $2" -r root@$HOSTNAME $1

   2. Das Skript muss ausführbar sein:

      > sudo chmod 755 /usr/local/bin/send_systemd_email

2. Erstellen Sie die Datei /etc/systemd/system/send_email_to_USER@.service.

   [Unit]
   Description=Send systemd status information by email for %i to USER
   
   [Service]
   Type=oneshot
   ExecStart=/usr/local/bin/send_systemd_email EMAIL_ADDRESS %i
   User=root
   Group=systemd-journal

   Ersetzen Sie USER und EMAIL_ADDRESS in der Datei durch die Anmeldedaten und die E-Mail-Adresse des Benutzers, der die E-Mail erhalten soll. %i ist der Name des fehlerhaften Dienstes (wird über den Parameter %n an den E-Mail-Dienst übergeben).

3. Überprüfen Sie die Dienstdatei und beheben Sie die gemeldeten Probleme:

   > systemd-analyze verify /etc/systemd/system/send_email_to_USER@.service

   Wenn das Kommando keine Ausgabe zurückgibt, hat die Datei die Überprüfung erfolgreich bestanden.

4. Soll das gesamte Verfahren geprüft werden, starten Sie den Dienst mit der dbus-Instanz zum Testen. (Sie können jeden anderen Dienst verwenden, der aktuell ausgeführt wird. Dieses Beispiel greift auf dbus zurück, da dieser Dienst definitiv auf jeder Installation ausgeführt wird.)

   > sudo systemctl start send_email_to_USER@dbus.service

   Bei Erfolg erhält EMAIL_ADDRESS eine E-Mail mit dem Betreff Service failure for dbus und dbus-Statusmeldungen im Haupttext. (Dies ist nur ein Test; es liegt kein Problem mit dem dbus-Dienst vor. Sie können die E-Mail beruhigt löschen, da keine Maßnahmen erforderlich sind.)

   Wenn die Test-E-Mail erfolgreich gesendet wurde, integrieren Sie sie in die Dienstdatei.

5. Soll dem Dienst eine E-Mail-Benachrichtigung hinzugefügt werden, tragen Sie die Option OnFailure in Abschnitt Unit der Dienstdatei ein, für die Sie im Fehlerfall eine Benachrichtigung erhalten möchten:

   [Unit]
   Description="Hello World script"
   OnFailure1=send_email_to_USER2@%n3.service
   
   [Service]
   ExecStart=/usr/local/bin/helloworld.sh

   1	Die Option OnFailure verwendet den Dienst als Argument.
   2	Ersetzen Sie den Teil mit dem Namen der Unit-Dienstdatei durch den Anmeldenamen.
   3	Gibt den Namen des Dienstes an (in diesem Beispiel helloworld). Dieser Name ist in der E-Mail-Dienstdatei als %i verfügbar.

Sie haben die Fehlerbenachrichtigung für systemd-Dienste erfolgreich eingerichtet.

1. Erstellen Sie eine Dienstdatei, die das Skript ausführt. Ausführliche Informationen finden Sie unter Beispiel 1, „Die Dienstdatei“.

2. Erstellen Sie eine Zeitgeberdatei, die die Dienstdatei ausführt. Allgemeine Anweisungen finden Sie unter Beispiel 2, „Die Zeitgeberdatei“.

   1. Konvertieren Sie die Kalendereinträge. Die Zeit wird im cron-Daemon und in systemdunterschiedlich angegeben. Ziehen Sie die Schemas unten als Vorlage für die Konvertierung heran:

      Cron:               Minute Hour Day Month DayOfWeek
      systemd: OnCalendar=DayOfWeek Year-Month-Day Hour:Minute:Second

      Testen Sie den konvertierten Kalendereintrag anhand der Anweisungen in Abschnitt 5, „Testen von Kalendereinträgen“.

   2. Konvertieren Sie die Cron-Kurznamen (@NICK):

      Cron     : systemd timer
      -------- : ----------------------------
      @reboot  : OnBootSec=1s
      @yearly  : OnCalendar=*-01-01 00:00:00
      @annually: OnCalendar=*-01-01 00:00:00
      @monthly : OnCalendar=*-*-01 00:00:00
      @weekly  : OnCalendar=Sun *-*-* 00:00:00
      @daily   : OnCalendar=*-*-* 00:00:00
      @hourly  : OnCalendar=*-*-* *:00:00

   3. Konvertieren Sie die Variablenzuweisungen. Die systemd-Variablenzuweisung muss in Abschnitt [Service] eingetragen werden. Hiermit ist es nicht möglich, MAILTO zu konvertieren; beachten Sie dazu den nächsten Schritt.

      cron: VARIABLE=VALUE
      systemd: Environment="VARIABLE=VALUE"

   4. Richten Sie E-Mail-Benachrichtigungen ein, die die MAILTO-Funktion von Cron ersetzen sollen. Beachten Sie dazu die Anweisungen in Abschnitt 6, „E-Mail-Benachrichtigungen bei einem fehlerhaften Zeitgeber“.