chrony

roles/mgrote_ntp_chrony_client/templates/chrony.conf.j2

@@ -1,19 +1,50 @@
 {{ file_header | default () }}
-# servers
+# Welcome to the chrony configuration file. See chrony.conf(5) for more
+# information about usable directives.
+
+# Include configuration files found in /etc/chrony/conf.d.
+confdir /etc/chrony/conf.d
+
+# This will use (up to):
+# - 4 sources from ntp.ubuntu.com which some are ipv6 enabled
+# - 2 sources from 2.ubuntu.pool.ntp.org which is ipv6 enabled as well
+# - 1 source from [01].ubuntu.pool.ntp.org each (ipv4 only atm)
+# This means by default, up to 6 dual-stack and up to 2 additional IPv4-only
+# sources will be used.
+# At the same time it retains some protection against one of the entries being
+# down (compare to just using one of the lines). See (LP: #1754358) for the
+# discussion.
+#
+# About using servers from the NTP Pool Project in general see (LP: #104525).
+# Approved by Ubuntu Technical Board on 2011-02-08.
+# See http://www.pool.ntp.org/join.html for more information.
 {% for item in ntp_chrony_servers %}
 server {{ item.address }} {{ item.options |default() }}
 {% endfor %}
+# Use time sources from DHCP.
+sourcedir /run/chrony-dhcp
 
-# keys
+# Use NTP sources found in /etc/chrony/sources.d.
+sourcedir /etc/chrony/sources.d
+
+# This directive specify the location of the file containing ID/key pairs for
+# NTP authentication.
 keyfile /etc/chrony/chrony.keys
 
-# driftfile
+# This directive specify the file into which chronyd will store the rate
+# information.
 driftfile {{ ntp_chrony_driftfile_directory }}/chrony.drift
 
+# Save NTS keys and cookies.
+ntsdumpdir /var/lib/chrony
+
+# Uncomment the following line to turn logging on.
+{% if ntp_chrony_logging is sameas true %}
+#log tracking measurements statistics
+{% endif %}
 
 {% if ntp_chrony_logging is sameas true %}
-# Logging
-log tracking measurements statistics
+# Log files location.
 logdir /var/log/chrony
 {% endif %}
 
@@ -21,9 +52,14 @@ logdir /var/log/chrony
 maxupdateskew 100.0
 
 # This directive enables kernel synchronisation (every 11 minutes) of the
-# real-time clock. Note that it can’t be used along with the 'rtcfile' directive.
+# real-time clock. Note that it can't be used along with the 'rtcfile' directive.
 rtcsync
 
 # Step the system clock instead of slewing it if the adjustment is larger than
 # one second, but only in the first three clock updates.
 makestep 1 3
+
+# Get TAI-UTC offset and leap seconds from the system tz database.
+# This directive must be commented out when using time sources serving
+# leap-smeared time.
+leapsectz right/UTC