systemdタイマの操作

次の例では、mailxパッケージのmailxコマンドを使用しています。Postfix電子メールサーバがインストールされ、正しく設定されている必要があります。

1. スクリプト/usr/local/bin/send_systemd_emailを作成します。

   1. このスクリプトには、$1 (電子メールアドレス)と$2 (失敗通知が受信されたサービスファイルの名前)の2つのパラメータが必要です。これらのパラメータはいずれも、メールスクリプトを実行するユニットファイルで指定します。

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

   2. スクリプトが実行可能であることを確認します。

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

2. ファイル/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

   ファイル内のUSERとEMAIL_ADDRESSを、電子メールを受信するユーザのログイン名と電子メールアドレスに置き換えます。%iは、失敗したサービスの名前です(%nパラメータで電子メールサービスに渡されます)。

3. サービスファイルを確認して、報告された問題を修正します。

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

   このコマンドから出力が返されなければ、ファイルは検証に適合しています。

4. 手順全体を確認するには、テスト用のdbusインスタンスを使用してサービスを開始します(現在実行している他のどのサービスも使用できます。あらゆるインストール環境でdbusサービスの動作が保証されているので、この例ではdbusを使用しています)。

   > sudo systemctl start send_email_to_USER@dbus.service

   サービスが正常に動作すれば、本文にdbusステータスメッセージが記述されて件名をService failure for dbusとした電子メールがEMAIL_ADDRESSに届きます(これはテストにすぎません。dbusサービスに問題は発生していないので、この電子メールを削除してもかまいません。どのようなアクションも不要です)。

   テストの電子メールが正常に送信されていれば、それをサービスファイルに取り込んで作業を続けます。

5. サービスに電子メール通知を追加するには、失敗の通知対象とするサービスファイルのUnitセクションにOnFailureオプションを追加します。

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

   1	OnFailureオプションは、引数としてサービス名を取ります。
   2	サービスユニットファイル名をログイン名で置き換えます。
   3	サービスの名前を指定します(この例ではhelloworld)。電子メールサービスファイルでは、この名前が%iで表現されます。

これで、systemdサービスの失敗通知が正常に設定されました。

1. スクリプトを実行するサービスファイルを作成します。詳細については例1「サービスファイル」を参照してください。

2. サービスファイルを実行するタイマファイルを作成します。一般的な手順については、例2「タイマファイル」を参照してください。

   1. カレンダのエントリを変換します。時間はcronとsystemdでは指定方法が異なります。次のパターンを変換テンプレートとして使用します。

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

      変換したカレンダエントリをテストするには5項 「カレンダエントリのテスト」の手順に従います。

   2. 次のように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. 変数の割り当てを変換します。systemdでの変数の割り当ては[Service]セクションに記述する必要があります。MAILTOは、この方法では変換できません。その変換方法については次のステップを参照してください。

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

   4. 6項 「タイマの失敗を通知する電子メールの取得」の手順に従って、cronのMAILTO機能を置き換える電子メール通知を設定します。