Update HowTo to on using the pool

* default to use of pool directive
* default to us of 2. pools (for IPv6)
* document us of chrony and timedatectl
* provide updated samples
* fix dead links
* use tab for indent throughout the file

Author: penguinpee

docs/ntppool/en/use.html

@@ -13,23 +13,48 @@ <h3 id="use">How do I use pool.ntp.org?</h3>
 	The 0, 1, 2 and 3.pool.ntp.org names point to a random set of servers that will
 	change every hour.  Make sure your computer's clock is set to something
 	sensible (within a few minutes of the 'true' time) - you could use <code>ntpdate
-	pool.ntp.org</code>, or you could just use the <code>date</code> command and set it
+	2.pool.ntp.org</code>, or you could just use the <code>date</code> command and set it
 	to your wristwatch. Start ntpd, and after some time (this could take as long as
 	half an hour!), <code>ntpq -pn</code> should output something like:
 	</p>
 
-	[% INCLUDE "ntppool/use/sample-ntpq.html" %]
+	[% INCLUDE "ntppool/use/sample-pool-ntpq.html" %]
 
 	<p>
 	The IP addresses will be different, because you've been assigned random
 	timeservers. The essential thing is that one of the lines starts with an
 	asterisk (<code>*</code>), this means your computer gets the time from the internet
 	- you'll never have to worry about it again!
 	</p>
+	<p>On more recent Linux operating systems, time setting has been delegated to
+	<code>systemd</code>. You can use <code>timedatectl</code> to set the time:
+	</p>
+
+	[% INCLUDE "ntppool/use/sample-timedatectl.html" %]
+
+	<p>
+	On RedHat et al. (Fedora, CentOS, etc.) <a href="https://chrony.tuxfamily.org/"><code>chronyd</code></a>
+	has replaced <code>ntpd</code> as the default NTP client (and server). With respect
+	to the time source configuration it uses the same syntax as <code>ntpd</code>,
+	so you can use the example above. Usually, the shipped configuration comes with a
+	a sensible default using the distribution's vendor pool and doesn't need any adjusting at all.
+	For checking on the synchronization status, use <code>chronyc -n sources</code>.
+	The output is similar to <code>ntpq</code> including the asterisk designating
+	the current time source.
+	</p>
+	<p> On older systems, <code>ntpd</code> may not support the pool configuration described
+	above. The following should work with legacy <code>ntpd</code> versions:
+	</p>
+
+	[% INCLUDE "ntppool/use/sample-ntpq.html" %]
+
 	<p>
-	Looking up <code>pool.ntp.org</code> (or <code>0.pool.ntp.org</code>,
+	Looking up <code>2.pool.ntp.org</code> (or <code>0.pool.ntp.org</code>,
 	<code>1.pool.ntp.org</code>, etc) will usually return IP addresses for servers
-	in or close to your country. For most users this will give the best results.
+	in or close to your country. For most users this will give the best results.<br>
+	<strong>Note:</strong> For historical reasons only <code>2.pool.ntp.org</code> will
+	return both IPv4 <emphasize>and</emphasize> IPv6 addresses. The other names only
+	return IPv4 addresses.
 	</p>
 
 	<p>You can also use the <a href="/zone/@">continental zones</a> (For example
@@ -46,13 +71,13 @@ <h3 id="use">How do I use pool.ntp.org?</h3>
 	If you're using <b>a recent Windows version</b>, you can use the ntp
 	client that is built into the system. As administrator enter</p>
 <pre class="code">
-w32tm /config /syncfromflags:manual /manualpeerlist:"0.pool.ntp.org 1.pool.ntp.org 2.pool.ntp.org 3.pool.ntp.org"
+w32tm /config /syncfromflags:manual /manualpeerlist:"2.pool.ntp.org 3.pool.ntp.org 0.pool.ntp.org 1.pool.ntp.org"
 </pre>
 	<p>
 	at the command prompt.  This will work on Windows 2003 and newer.  If you use an
 	older version of windows you can try</p>
 <pre class="code">
-net time /setsntp:"0.pool.ntp.org 1.pool.ntp.org 2.pool.ntp.org"
+net time /setsntp:"2.pool.ntp.org 3.pool.ntp.org 0.pool.ntp.org"
 </pre>
 	<p>
 	The same can be achieved by, as administrator, right-clicking the clock in the taskbar,
@@ -73,23 +98,23 @@ <h3 id="use">How do I use pool.ntp.org?</h3>
 <div class="block">
 	<h3 id="notes">Additional Notes</h3>
 
-        <p><span class="hook">Consider if the NTP Pool is appropriate
-        for your use</span>. If business, organization or human life
-        depends on having correct time or can be harmed by it being
-        wrong, you shouldn't "just get it off the internet". The NTP
-        Pool is generally very high quality, but it is a service run
-        by volunteers in their spare time. Please talk to your
-        equipment and service vendors about getting local and reliable
-        service setup for you. See also our <a href="/tos.html">terms
-        of service</a>.
-
-        We recommend time servers from
-        <a href="http://www.meinbergglobal.com/english/products/ntp-time-server.htm">Meinberg</a>,
-        but you can also find time servers from
-        <a href="http://www.endruntechnologies.com/NTP-Servers/gps-cdma-ntp.htm">End Run</a>,
-        <a href="http://spectracom.com/products-services/precision-timing#anchor-2172">Spectracom</a>
-        and many others.
-        </p>
+		<p><span class="hook">Consider if the NTP Pool is appropriate
+		for your use</span>. If business, organization or human life
+		depends on having correct time or can be harmed by it being
+		wrong, you shouldn't "just get it off the internet". The NTP
+		Pool is generally very high quality, but it is a service run
+		by volunteers in their spare time. Please talk to your
+		equipment and service vendors about getting local and reliable
+		service setup for you. See also our <a href="/tos.html">terms
+		of service</a>.
+
+		We recommend time servers from
+		<a href="http://www.meinbergglobal.com/english/products/ntp-time-server.htm">Meinberg</a>,
+		but you can also find time servers from
+		<a href="https://endruntechnologies.com/products/ntp-time-servers">End Run</a>,
+		<a href="https://www.orolia.com/solution/timing-and-synchronization/">Orolia</a>
+		and many others.
+		</p>
 
 	<p><span class="hook">If you have a static IP address and a reasonable Internet connection</span> (bandwidth
 	is not so important, but it should be stable and not too highly loaded), please
@@ -114,7 +139,7 @@ <h3 id="notes">Additional Notes</h3>
 	servers are really file or mail or webservers which just happen to also run ntp.
 	So don't use more than four time servers in your configuration, and don't play
 	tricks with <code>burst</code> or <code>minpoll</code> - all you will gain is extra
-        load on the volunteer time servers.</p>
+		load on the volunteer time servers.</p>
 
 	<p><span class="hook">Make sure that the <i>time zone configuration</i> of your computer is correct</span>.
 	ntpd itself does not do anything about the time zones, it just uses UTC
@@ -123,7 +148,7 @@ <h3 id="notes">Additional Notes</h3>
 	<p><span class="hook">If you are synchronising a network to pool.ntp.org</span>, please set up one of your
 	computers as a time server and synchronize the other computers to that one.
 	(you'll have some reading to do - it's not difficult though. And there's always
-	the <a href="news:comp.protocols.time.ntp">comp.protocols.time.ntp newsgroup</a>.)</p>
+	the <a href="https://community.ntppool.org/">community</a> to help out.)</p>
 
 	<p class="thanks">At this point, I'd like to thank those donating their time and timeservers to
 	this network.</p>

docs/ntppool/use/sample-config.html renamed to docs/ntppool/use/sample-legacy-config.html

@@ -1,8 +1,8 @@
 <pre class="code">
 driftfile /var/lib/ntp/ntp.drift
 
-server 0.pool.ntp.org
-server 1.pool.ntp.org
 server 2.pool.ntp.org
 server 3.pool.ntp.org
+server 0.pool.ntp.org
+server 1.pool.ntp.org
 </pre>

docs/ntppool/use/sample-pool-config.html

@@ -0,0 +1,8 @@
+<pre class="code">
+driftfile /var/lib/ntp/ntp.drift
+
+pool 2.pool.ntp.org iburst
+pool 3.pool.ntp.org iburst
+pool 0.pool.ntp.org iburst
+pool 1.pool.ntp.org iburst
+</pre>

docs/ntppool/use/sample-timedatectl.html

@@ -0,0 +1,4 @@
+<pre class="code">
+timedatectl set-timezone "Europe/Kiev"
+timedatectl set-time "2012-10-30 18:17:16"
+</pre>