「Systemd-timesyncd」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(→‎設定: 英語版と同期して情報を追加)
(→‎設定: リンクを修正)
 
(2人の利用者による、間の15版が非表示)
6行目: 6行目:
 
[[zh-hans:Systemd-timesyncd]]
 
[[zh-hans:Systemd-timesyncd]]
 
{{Related articles start}}
 
{{Related articles start}}
{{Related|時刻}}
 
{{Related|Network Time Protocol daemon}}
 
{{Related|OpenNTPD}}
 
{{Related|Chrony}}
 
 
{{Related|systemd-networkd}}
 
{{Related|systemd-networkd}}
 
{{Related|systemd}}
 
{{Related|systemd}}
  +
{{Related|システム時刻}}
 
{{Related articles end}}
 
{{Related articles end}}
   
17行目: 14行目:
   
 
:''systemd-timesyncd'' はネットワークを介してシステム時刻を同期させるために追加されたデーモンです。SNTP クライアントが実装されています。chrony や NTP リファレンスサーバーなどの NTP 実装とは対照的に、timesyncd はクライアント側しか実装しておらず、完全な NTP の複雑性に悩むことなく、リモートサーバーに時刻を問い合わせてそれにローカルクロックを同期させることだけに焦点を置いています。NTP をネットワークのクライアントに提供したりローカルのハードウェアクロックに接続したいのでなければ、このシンプルな NTP クライアントだけでほとんどの場合は十二分に間に合います。デーモンは最小権限で動作し、networkd と紐付けられることでネットワーク接続が有効なときだけ同期を行います。Raspberry Pi や組み込みデバイスなどの RTC を載せてないシステムのために、新しい NTP の同期が取得される度にディスクに現在の時刻を保存し、それを使って起動時にシステム時刻を修正することができ、時刻が常に正しいわけではないときでも、それらのシステムで時刻がモノトニックに進むことを保証します。このデーモンを利用するには systemd のインストール時に新しいユーザーとグループ "systemd-timesync" を作る必要があります。
 
:''systemd-timesyncd'' はネットワークを介してシステム時刻を同期させるために追加されたデーモンです。SNTP クライアントが実装されています。chrony や NTP リファレンスサーバーなどの NTP 実装とは対照的に、timesyncd はクライアント側しか実装しておらず、完全な NTP の複雑性に悩むことなく、リモートサーバーに時刻を問い合わせてそれにローカルクロックを同期させることだけに焦点を置いています。NTP をネットワークのクライアントに提供したりローカルのハードウェアクロックに接続したいのでなければ、このシンプルな NTP クライアントだけでほとんどの場合は十二分に間に合います。デーモンは最小権限で動作し、networkd と紐付けられることでネットワーク接続が有効なときだけ同期を行います。Raspberry Pi や組み込みデバイスなどの RTC を載せてないシステムのために、新しい NTP の同期が取得される度にディスクに現在の時刻を保存し、それを使って起動時にシステム時刻を修正することができ、時刻が常に正しいわけではないときでも、それらのシステムで時刻がモノトニックに進むことを保証します。このデーモンを利用するには systemd のインストール時に新しいユーザーとグループ "systemd-timesync" を作る必要があります。
 
== インストール ==
 
 
''systemd-timesyncd'' サービスは {{Pkg|systemd}} 213 から利用することができます。サービスを[[systemd#systemctl の基本的な使い方|起動・有効化]]するには:
 
# timedatectl set-ntp true
 
 
サービスの状態を確認したいときは、{{ic|timedatectl status}} を使います:
 
 
{{hc|$ timedatectl status|
 
Local time: Thu 2015-07-09 18:21:33 CEST
 
Universal time: Thu 2015-07-09 16:21:33 UTC
 
RTC time: Thu 2015-07-09 16:21:33
 
Time zone: Europe/Amsterdam (CEST, +0200)
 
Network time on: yes
 
NTP synchronized: yes
 
RTC in local TZ: no}}
 
 
詳細なサービス情報を表示するには、 {{ic|timedatectl timesync-status}} を使います:
 
 
{{hc|$ timedatectl timesync-status|
 
Server: 103.47.76.177 (0.arch.pool.ntp.org)
 
Poll interval: 2min 8s (min: 32s; max 34min 8s)
 
Leap: normal
 
Version: 4
 
Stratum: 2
 
Reference: C342F10A
 
Precision: 1us (-21)
 
Root distance: 231.856ms (max: 5s)
 
Offset: -19.428ms
 
Delay: 36.717ms
 
Jitter: 7.343ms
 
Packet count: 2
 
Frequency: +267.747ppm
 
}}
 
 
{{Tip|systemd 216 以前は ''systemd-timesyncd'' を使うにはネットワークの起動・停止イベントを拾うために [[systemd-networkd]] を起動させる必要がありました (ただし設定は不要)。現在はこの仕様は変更されており、[[dhcpcd]] や [[NetworkManager]] からのイベントも受信します。ネットワークの設定に依存するかネットワーク管理ツールを使わなくてはならないのは変わっていません。}}
 
   
 
== 設定 ==
 
== 設定 ==
   
{{Pkg|systemd}} で利用可能な {{ic|systemd-timesyncd.service}} を [https://wiki.archlinux.jp/index.php/Systemd#.E3.83.A6.E3.83.8B.E3.83.83.E3.83.88.E3.82.92.E4.BD.BF.E3.81.86 Start/enable ] します。
+
{{Pkg|systemd}} で利用可能な {{ic|systemd-timesyncd.service}} を [[起動/有効化]] します。
起動すると、''systemd-timesyncd'' は {{ic|/etc/systemd/timesyncd.conf}} から構成ファイルを読み取ります。これは次のようになります。
+
起動すると、''systemd-timesyncd'' は {{ic|/etc/systemd/timesyncd.conf}} から設定ファイルを読み取ります。これは次のようになります。
   
 
{{hc|/etc/systemd/timesyncd.conf|2=
 
{{hc|/etc/systemd/timesyncd.conf|2=
91行目: 52行目:
 
}}
 
}}
   
デーモンの設定だけでなく、[[Systemd-networkd#.5BNetDev.5D|systemd-networkd]] の設定の {{ic|1=NTP=}} オプションを使ったり、動的に、DHCP サーバーを使うことで提供される NTP サーバーもあります (''systemd'' 216 から)
+
デーモンの設定だけでなく、[[Systemd-networkd#.5BNetDev.5D|systemd-networkd]] の設定の {{ic|1=NTP=}} オプションを使ったり、動的に、DHCP サーバーを使うことで提供される NTP サーバーもあります。
   
 
使用される NTP サーバーは以下のルールによって決まります:
 
使用される NTP サーバーは以下のルールによって決まります:
98行目: 59行目:
 
* 以上の手順を踏んでも NTP サーバーの情報がまったく得られなかったとき、{{ic|1=FallbackNTP=}} に定義された NTP サーバーのホスト名や IP アドレスが使われます。
 
* 以上の手順を踏んでも NTP サーバーの情報がまったく得られなかったとき、{{ic|1=FallbackNTP=}} に定義された NTP サーバーのホスト名や IP アドレスが使われます。
   
  +
{{Note|
{{Warning|サービスによって同期が行われるたびに {{ic|/var/lib/systemd/clock}} ファイルに書き込みが行われます。このファイルの場所はハードコードされており変更できません。ルートパーティションを読み込み専用で使用する場合や SD カードへの書き込みを減らしたいときに問題となる可能性があります。}}
 
  +
* サービスは、同期ごとおよび 60 秒ごとにローカルファイル {{ic|/var/lib/systemd/timesync/Clock}} に書き込みます。この場所はハードコーディングされているため、変更できません。
  +
* この書き込みは、読み取り専用のルートパーティションを実行したり、SD カードへの書き込みを最小限に抑えようとした場合に問題となる可能性があります。
  +
* 書き込み回数は、{{ic|1=PollIntervalMinSec=1d}} や {{ic|1=SaveIntervalSec=infinity}} のような構成で最小限に抑えることができます。
  +
}}
   
  +
== 使い方 ==
== トラブルシューティング ==
 
   
  +
=== 起動して有効化 ===
=== systemd 242.0-1 に更新後 systemd-timesyncd の起動に失敗する ===
 
   
  +
''systemd-timesyncd'' サービスは {{Pkg|systemd}} 213 から利用することができます。サービスを[[systemd#systemctl の基本的な使い方|起動・有効化]]するには:
ログにこのエラーが表示される場合
 
   
  +
# timedatectl set-ntp true
ExecStart=/usr/lib/systemd/systemd-timesyncd (code=exited, status=238/STATE_DIRECTORY)
 
   
  +
=== サービスをチェック ===
次のコマンドを実行して、問題を修正します。
 
   
  +
同期プロセスが著しく遅くなる可能性があります。これは予想されることです。問題があると判断する前に、しばらく待つ必要があります。サービスのステータスを確認するには、次を使用します:
# rm -rf /var/lib/systemd/timesync
 
# rm -rf /var/lib/private/systemd/timesync
 
   
  +
{{hc|$ timedatectl status|
{{Bug|62161}} を参照してください。
 
  +
Local time: Thu 2015-07-09 18:21:33 CEST
  +
Universal time: Thu 2015-07-09 16:21:33 UTC
  +
RTC time: Thu 2015-07-09 16:21:33
  +
Time zone: Europe/Amsterdam (CEST, +0200)
  +
System clock synchronized: yes
  +
NTP service: active
  +
RTC in local TZ: no
  +
}}
   
  +
=== 冗長チェック ===
=== DHCP 経由で受信した NTP サーバーを動的に設定 ===
 
   
  +
詳細なサービス情報を表示するには、 {{ic|timedatectl timesync-status}} を使います:
前提:
 
   
  +
{{hc|$ timedatectl timesync-status|
* システムクロックは、systemd-timesyncd によってNTPサーバーと同期されます。
 
  +
Server: 103.47.76.177 (0.arch.pool.ntp.org)
  +
Poll interval: 2min 8s (min: 32s; max 34min 8s)
  +
Leap: normal
  +
Version: 4
  +
Stratum: 2
  +
Reference: C342F10A
  +
Precision: 1us (-21)
  +
Root distance: 231.856ms (max: 5s)
  +
Offset: -19.428ms
  +
Delay: 36.717ms
  +
Jitter: 7.343ms
  +
Packet count: 2
  +
Frequency: +267.747ppm
  +
}}
   
  +
=== デフォルト以外の設定を表示する ===
* ネットワークは NetworkManager によって設定されます。
 
   
  +
デフォルト以外の設定オプションセットと、それらのオプションの派生元のファイルを確認するには、次を使用します:
異なるネットワーク (会社の LAN、自宅の Wi-Fi、その他のさまざまな Wi-Fi など) 間をローミングする場合は、timesyncd で使用される NTP サーバーを DHCP で提供されるサーバーに設定することをお勧めします。 systemd-networkd とは異なり、NetworkManager は systemd-timesyncd と通信してNTPサーバーを設定することはできません。
 
  +
{{hc|$ systemd-analyze cat-config systemd/timesyncd.conf --tldr|2=
  +
# /etc/systemd/timesyncd.conf
  +
[Time]
   
  +
# /etc/systemd/timesyncd.conf.d/local.conf
NetworkManager dispatcher で解決する場合 (以下のすべてのアクションはrootとして実行する必要があります。したがって、{{ic|sudo -i}} を使用してルートシェルを起動するか、すべてのコマンドの前に {{ic|sudo}} を追加します。)
 
  +
[Time]
  +
NTP=0.nl.pool.ntp.org 1.nl.pool.ntp.org 2.nl.pool.ntp.org 3.nl.pool.ntp.org
  +
RootDistanceMaxSec=0.1
  +
PollIntervalMinSec=1d
  +
PollIntervalMaxSec=4w
  +
SaveIntervalSec=infinity
  +
}}
   
  +
=== ログを見る ===
まだ存在していない場合は、systemd-timesyncd 構成のオーバーレイディレクトリ {{ic|/etc/systemd/timesyncd.conf.d}} を作成します。 また、まだ存在していない場合は、ディレクトリ {{ic|/etc/NetworkManager/dispatcher.d}} を作成します。 次の dispatcher スクリプトをそこに配置します
 
   
  +
過去 24 時間のログに記録されたイベントを表示するには、次を使用します:
{{hc|/etc/NetworkManager/dispatcher.d/10-update-timesyncd|<nowiki>
 
  +
{{hc|# journalctl -u systemd-timesyncd --no-hostname --since "1 day ago"|
#! /usr/bin/bash
 
  +
Jan 19 15:14:20 systemd[1]: Stopping Network Time Synchronization...
 
  +
Jan 19 15:14:20 systemd[1]: systemd-timesyncd.service: Deactivated successfully.
[ -n "$CONNECTION_UUID" ] || exit
 
  +
Jan 19 15:14:20 systemd[1]: Stopped Network Time Synchronization.
 
  +
Jan 19 15:14:20 systemd[1]: Starting Network Time Synchronization...
INTERFACE=$1
 
  +
Jan 19 15:14:20 systemd[1]: Started Network Time Synchronization.
ACTION=$2
 
  +
Jan 19 15:14:20 systemd-timesyncd[1023]: Contacted time server 178.215.228.24:123 (0.nl.pool.ntp.org).
 
  +
Jan 19 15:14:20 systemd-timesyncd[1023]: Initial clock synchronization to Fri 2024-01-19 15:14:20.393865 CET.
case $ACTION in
 
  +
}}
up | dhcp4-change | dhcp6-change)
 
[ -n "$DHCP4_NTP_SERVERS" ] || exit
 
exec > /etc/systemd/timesyncd.conf.d/$CONNECTION_UUID.conf
 
echo "[Time]"
 
echo "NTP=$DHCP4_NTP_SERVERS"
 
systemctl restart systemd-timesyncd
 
;;
 
down)
 
rm -f /etc/systemd/timesyncd.conf.d/$CONNECTION_UUID.conf
 
systemctl restart systemd-timesyncd
 
;;
 
esac
 
</nowiki>}}
 
 
このスクリプトを、 {{ic|chmod 700 10-update-timesync}} を使用して root でのみ実行可能にします。最後に、 NetworkManager dispatcher が有効になっていて起動していることを確認してください。
 
 
では、ここで何が起こるのでしょうか? NetworkManager が新しいネットワーク接続をセットアップするか ({{ic|1=ACTION=up}}) または既存の接続の更新を取得するたび ({{ic|1=ACTION=dhcp4-change}} または {{ic|1=ACTION=dhcp6-change}}) 提供された接続データにはNTP サーバーに関する情報が含まれます ({{ic|DHCP4_NTP_SERVERS}}) 次に、接続固有のオーバーレイ設定ファイルが、提供された NTP サーバーを含む {{ic|/etc/systemd/timesyncd.conf.d}} に書き込まれます。接続が切断されると ({{ic|1=ACTION=down}}) 接続固有のオーバーレイファイルが再び削除されます。 systemd-timesyncd の設定を変更するたびに、このサービスが再起動され、更新された設定が取得されます。接続固有の設定ファイルの使用は意図的なものであるため、2つ以上の接続が NetworkManager によって並行して管理されている場合、{{ic|up}} 、{{ic|dhcp4-change}}, {{ic|dhcp6-change}} 、および {{ic|down}} アクションが任意の順序で発生する可能性があるため、 config は上書きされません。
 
   
 
== 参照 ==
 
== 参照 ==
160行目: 140行目:
 
* [https://bbs.archlinux.org/viewtopic.php?id=182600 フォーラム: systemd-timesyncd is not syncing time]
 
* [https://bbs.archlinux.org/viewtopic.php?id=182600 フォーラム: systemd-timesyncd is not syncing time]
 
* [https://bbs.archlinux.org/viewtopic.php?id=182172 フォーラム: Using systemd-timesync instead of NTP]
 
* [https://bbs.archlinux.org/viewtopic.php?id=182172 フォーラム: Using systemd-timesync instead of NTP]
  +
* [https://github.com/systemd/systemd/blob/main/src/timesync/timesyncd.c Git Sourcecode of timesyncd]
  +
* {{man|8|systemd-timesyncd}}
  +
* {{man|5|timesyncd.conf}}

2024年2月2日 (金) 02:17時点における最新版

関連記事

systemd メーリングリスト より:

systemd-timesyncd はネットワークを介してシステム時刻を同期させるために追加されたデーモンです。SNTP クライアントが実装されています。chrony や NTP リファレンスサーバーなどの NTP 実装とは対照的に、timesyncd はクライアント側しか実装しておらず、完全な NTP の複雑性に悩むことなく、リモートサーバーに時刻を問い合わせてそれにローカルクロックを同期させることだけに焦点を置いています。NTP をネットワークのクライアントに提供したりローカルのハードウェアクロックに接続したいのでなければ、このシンプルな NTP クライアントだけでほとんどの場合は十二分に間に合います。デーモンは最小権限で動作し、networkd と紐付けられることでネットワーク接続が有効なときだけ同期を行います。Raspberry Pi や組み込みデバイスなどの RTC を載せてないシステムのために、新しい NTP の同期が取得される度にディスクに現在の時刻を保存し、それを使って起動時にシステム時刻を修正することができ、時刻が常に正しいわけではないときでも、それらのシステムで時刻がモノトニックに進むことを保証します。このデーモンを利用するには systemd のインストール時に新しいユーザーとグループ "systemd-timesync" を作る必要があります。

設定

systemd で利用可能な systemd-timesyncd.service起動/有効化 します。 起動すると、systemd-timesyncd/etc/systemd/timesyncd.conf から設定ファイルを読み取ります。これは次のようになります。

/etc/systemd/timesyncd.conf
[Time]
#NTP=
#FallbackNTP=0.arch.pool.ntp.org 1.arch.pool.ntp.org 2.arch.pool.ntp.org 3.arch.pool.ntp.org
#RootDistanceMaxSec=5
#PollIntervalMinSec=32
#PollIntervalMaxSec=2048

時刻サーバーを追加したり変更するには、適当な行をアンコメントして、空白で区切られたホスト名か IP を記述してください。例えば、NTP プールプロジェクト によって提供されているサーバーやデフォルトの Arch のサーバーを使うことができます (こちらも NTP プールプロジェクトによって提供されています):

/etc/systemd/timesyncd.conf
[Time]
NTP=0.arch.pool.ntp.org 1.arch.pool.ntp.org 2.arch.pool.ntp.org 3.arch.pool.ntp.org
FallbackNTP=0.pool.ntp.org 1.pool.ntp.org 0.jp.pool.ntp.org

構成を確認するには、timedatectl show-timesync --all を使用します。

$ timedatectl show-timesync --all
LinkNTPServers=
SystemNTPServers=
FallbackNTPServers=0.arch.pool.ntp.org 1.arch.pool.ntp.org 2.arch.pool.ntp.org 3.arch.pool.ntp.org
ServerName=0.arch.pool.ntp.org
ServerAddress=103.47.76.177
RootDistanceMaxUSec=5s
PollIntervalMinUSec=32s
PollIntervalMaxUSec=34min 8s
PollIntervalUSec=1min 4s
NTPMessage={ Leap=0, Version=4, Mode=4, Stratum=2, Precision=-21, RootDelay=177.398ms, RootDispersion=142.196ms, Reference=C342F10A, OriginateTimestamp=Mon 2018-07-16 13:53:43 +08, ReceiveTimestamp=Mon 2018-07-16 13:53:43 +08, TransmitTimestamp=Mon 2018-07-16 13:53:43 +08, DestinationTimestamp=Mon 2018-07-16 13:53:43 +08, Ignored=no PacketCount=1, Jitter=0 }
Frequency=22520548

デーモンの設定だけでなく、systemd-networkd の設定の NTP= オプションを使ったり、動的に、DHCP サーバーを使うことで提供される NTP サーバーもあります。

使用される NTP サーバーは以下のルールによって決まります:

  • systemd-networkd.service(8) の設定や DHCP によるインターフェイスごとの NTP サーバーが優先されます。
  • /etc/systemd/timesyncd.conf に定義された NTP サーバーは実行時にインターフェイスごとのリストに追加され、デーモンはサーバーのどれかが応答するまで通信を行います。
  • 以上の手順を踏んでも NTP サーバーの情報がまったく得られなかったとき、FallbackNTP= に定義された NTP サーバーのホスト名や IP アドレスが使われます。
ノート:
  • サービスは、同期ごとおよび 60 秒ごとにローカルファイル /var/lib/systemd/timesync/Clock に書き込みます。この場所はハードコーディングされているため、変更できません。
  • この書き込みは、読み取り専用のルートパーティションを実行したり、SD カードへの書き込みを最小限に抑えようとした場合に問題となる可能性があります。
  • 書き込み回数は、PollIntervalMinSec=1dSaveIntervalSec=infinity のような構成で最小限に抑えることができます。

使い方

起動して有効化

systemd-timesyncd サービスは systemd 213 から利用することができます。サービスを起動・有効化するには:

# timedatectl set-ntp true

サービスをチェック

同期プロセスが著しく遅くなる可能性があります。これは予想されることです。問題があると判断する前に、しばらく待つ必要があります。サービスのステータスを確認するには、次を使用します:

$ timedatectl status
               Local time: Thu 2015-07-09 18:21:33 CEST
           Universal time: Thu 2015-07-09 16:21:33 UTC
                 RTC time: Thu 2015-07-09 16:21:33
                Time zone: Europe/Amsterdam (CEST, +0200)
System clock synchronized: yes
              NTP service: active
          RTC in local TZ: no

冗長チェック

詳細なサービス情報を表示するには、 timedatectl timesync-status を使います:

$ timedatectl timesync-status
       Server: 103.47.76.177 (0.arch.pool.ntp.org)
Poll interval: 2min 8s (min: 32s; max 34min 8s)
         Leap: normal
      Version: 4
      Stratum: 2
    Reference: C342F10A
    Precision: 1us (-21)
Root distance: 231.856ms (max: 5s)
       Offset: -19.428ms
        Delay: 36.717ms
       Jitter: 7.343ms
 Packet count: 2
    Frequency: +267.747ppm

デフォルト以外の設定を表示する

デフォルト以外の設定オプションセットと、それらのオプションの派生元のファイルを確認するには、次を使用します:

$ systemd-analyze cat-config systemd/timesyncd.conf --tldr
# /etc/systemd/timesyncd.conf
[Time]

# /etc/systemd/timesyncd.conf.d/local.conf
[Time]
NTP=0.nl.pool.ntp.org 1.nl.pool.ntp.org 2.nl.pool.ntp.org 3.nl.pool.ntp.org
RootDistanceMaxSec=0.1
PollIntervalMinSec=1d
PollIntervalMaxSec=4w
SaveIntervalSec=infinity

ログを見る

過去 24 時間のログに記録されたイベントを表示するには、次を使用します:

# journalctl -u systemd-timesyncd --no-hostname --since "1 day ago"
Jan 19 15:14:20 systemd[1]: Stopping Network Time Synchronization...
Jan 19 15:14:20 systemd[1]: systemd-timesyncd.service: Deactivated successfully.
Jan 19 15:14:20 systemd[1]: Stopped Network Time Synchronization.
Jan 19 15:14:20 systemd[1]: Starting Network Time Synchronization...
Jan 19 15:14:20 systemd[1]: Started Network Time Synchronization.
Jan 19 15:14:20 systemd-timesyncd[1023]: Contacted time server 178.215.228.24:123 (0.nl.pool.ntp.org).
Jan 19 15:14:20 systemd-timesyncd[1023]: Initial clock synchronization to Fri 2024-01-19 15:14:20.393865 CET.

参照