Utilisation des minuteurs systemd

Dans l'exemple suivant, nous utilisons la commande mailx du paquet mailx. Le serveur de messagerie Postfix doit être installé et configuré correctement.

1. Créez le script /usr/local/bin/send_systemd_email.

   1. Le script requiert deux paramètres : $1, l'adresse électronique et $2, le nom du fichier de service pour lequel la notification d'échec est reçue. Les deux paramètres sont fournis par le fichier d'unité qui exécute le script de messagerie.

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

   2. Assurez-vous que le script est exécutable :

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

2. Créez le fichier /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

   Remplacez USER et EMAIL_ADDRESS dans le fichier par l'adresse de connexion et l'adresse électronique de l'utilisateur qui doit recevoir le message électronique. %i est le nom du service qui a échoué (il est transmis au service de messagerie par le paramètre %n).

3. Vérifiez le fichier de service et corrigez les problèmes signalés :

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

   Si la commande ne renvoie aucun résultat, le fichier a réussi la vérification.

4. Pour vérifier la procédure complète, démarrez le service à l'aide de l'instance dbus à des fins de test. (Vous pouvez utiliser tout autre service en cours d'exécution. dbus est employé dans cet exemple, car l'exécution du service est garantie sur n'importe quelle installation.)

   > sudo systemctl start send_email_to_USER@dbus.service

   En cas de réussite, EMAIL_ADDRESS reçoit un courrier électronique ayant comme objet Service failure for dbus et contenant les messages d'état dbus dans le corps. (Il s'agit simplement d'un test. Il n'y a aucun problème avec le service dbus. Vous pouvez supprimer le message en toute sécurité, aucune action n'est requise).

   Si le message électronique de test a bien été envoyé, intégrez-le à votre fichier de service.

5. Pour ajouter une notification par message électronique au service, ajoutez une option OnFailure à la section Unit du fichier de service pour lequel vous souhaitez être averti en cas d'échec :

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

   1	L'option OnFailure prend un service comme argument.
   2	Remplacez la partie du nom de fichier de l'unité de service par le nom de connexion.
   3	Spécifie le nom du service (helloworld, dans cet exemple). Ce nom est disponible dans le fichier de service de messagerie en tant que %i.

Vous avez correctement configuré la notification d'échec pour les services systemd.

1. Créez un fichier de service exécutant le script. Pour plus de détails, reportez-vous à l'Exemple 1, « le fichier de service ».

2. Créez un fichier de minuteur exécutant le fichier de service. Pour des instructions générales, consultez l'Exemple 2, « le fichier de minuteur ».

   1. Convertissez les entrées du calendrier. L'heure est spécifiée différemment dans cron et dans systemd. Utilisez les modèles ci-dessous comme modèle de conversion :

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

      Pour tester l'entrée de calendrier convertie, suivez les instructions de la Section 5, « Test des entrées du calendrier ».

   2. Convertissez les pseudonymes cron (@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. Convertissez les assignations de variables. L'assignation de variable systemd doit aller dans la section [Service]. Vous ne pouvez pas convertir MAILTO de cette manière. Pour ce faire, reportez-vous à l'étape suivante.

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

   4. Configurez des notifications par message électronique pour remplacer la fonction MAILTO de cron en suivant les instructions de la Section 6, « Notifications par message électronique en cas d'échec d'un minuteur ».