tls618 - Improved Network Time Protocol Daemon New version of NTP/xntpd (xntp3-5.92d) for SCO Open Server Kamal A Mostafa 1998/04/24 This document contains information and instructions regarding a new version of NTP for SCO OpenServer 5.0.0, 5.0.2, and 5.0.4. This document does _not_ describe how to configure and use NTP. Consult the xntpd(ADMN) man page and the NTP documentation if you are not already familiar with NTP. This package is not officially supported by SCO. How NTP (xntpd) adjusts the system's time ------------------------------------------------------------------------------ The NTP daemon 'xntpd' attempts to keep the system's time synchronized to some external reference such as a radio clock, or a group of higher-level NTP servers. Xntpd adjusts the system's time by slowing down or speeding up the clock in microsecond increments ("slewing"), or by simply resetting the clock ("stepping") whenever the time is off by more than one-eighth of a second. Usually, the clock will only need to be stepped (reset) once when the system first boots up. From that point on, xntpd should almost always be able to keep the system's time synchronized to the reference source(s) just by slewing the clock rate. Problems with earlier SCO versions of NTP ------------------------------------------------------------------------------ These earlier releases of SCO operating systems contain a version of xntpd which works, but rather poorly: SCO UNIX 3.2 (all releases) SCO Open Desktop (all releases) SCO OpenServer 5.0.0, 5.0.2, and 5.0.4 The xntpd provided in these releases does not correctly slew the clock, allowing the system's time to drift away from the reference time. To correct the drift, xntpd then needs to step (reset) the clock frequently -- sometimes hundreds or thousands of times each day. While this behavior does keep the system's time synchronized to within one-eighth of a second, the frequent clock resets can cause other problems (e.g. cron jobs may run twice, or not at all). The latest version of the NTP subsystem (xntp3-5.92d) corrects the slewing problem. Xntpd can now keep an SCO system's clock synchronized without needing to step the clock (or at least stepping the clock only very rarely). Also, earlier SCO versions fail to disable the RTC (real time "hardware" clock) when starting xntpd. Disabling the RTC is a prerequisite for normal xntpd operation, as indicated in installation step 2. below. Setting up the new NTP on SCO OpenServer systems ------------------------------------------------------------------------------ **** This is for SCO OpenServer 5.0.0, 5.0.2, and 5.0.4 systems only! ***** - This version of NTP is already included in SCO OpenServer 5.0.5. - This version of NTP is currently not available for SCO Open Desktop or SCO UNIX 3.2 version 4.x systems. 1. Download and install the new NTP subsystem (xntp3-5.92d): - Currently, this package is only available as a tar file: Go get it at: ftp://ftp.sco.com/TLS/tls618.tar.Z Might as well just ftp it into your /tmp directory. NOTE: This is not a Software Manager installable package, so the "Software Verify" function will complain about these files. - Yourself being root, extract the tar file as follows: # cd /etc # zcat /tmp/tls618.tar.Z | tar xvf - 2. Disable the RTC (real time "hardware" clock) by adding the missing "tickadj -q -s" line to the /etc/tcp script: - Edit the file /etc/tcp. Find the section that looks like this: if [ -x /etc/xntpd -a -f /etc/ntp.conf ]; then xntpd & echo "xntpd \c" fi - Add the "tickadj -q -s" line, making it look like this: if [ -x /etc/xntpd -a -f /etc/ntp.conf ]; then tickadj -q -s # <-- NEW LINE ADDED xntpd # <-- or add "-g" (see below) echo "xntpd \c" fi 3. If you don't have one already, create an /etc/ntp.conf file (see the xntpd(ADMN) man page and NTP documentation for details). 4. To make the changes take effect, EITHER Shutdown and reboot the system, -or- As root, kill any running xntpd process, then run "tickadj -q -s", then run "xntpd". (Neither command should yield any output). 5. Wait a few moments, then run "ntpq -p" to verify that xntpd is running. Check /usr/adm/syslog after about 15 minutes, to verify that xntpd has synchronized to one of the servers specified in your /etc/ntp.conf file. Release Notes ------------------------------------------------------------------------------ NTP documentation. The latest version of the NTP documentation is only available in the source code package, but will be available in SCO OpenServer 5.0.5. A very close set of documentation is available from the NTP project's home page at http://www.eecis.udel.edu/~ntp/. Xntpd refuses to correct a system clock off by more than about 15 minutes. Many users are surprised by the fact that xntpd will, by default, refuse to correct the time on a system if the system's clock is determined to be off by more than about 15 minutes. When this happens, xntpd logs a "time error is way too large (set clock manually)" message to /usr/adm/syslog, then exits. If you want xntpd to correct any time offset, no matter how large, add the -g flag to your xntpd command in /etc/tcp. (e.g. "xntpd -g"). Broadcast clients now have authentication enabled (required) by default. Different from previous releases of xntpd, broadcast clients now require authentication by default. This will cause previously working "broadcastclient" configurations to silently ignore NTP packets sent to them by (non-authenticated) NTP broadcast servers. On secured networks, this new authentication requirement can be disabled by either applying the -A argument to the xntpd command (e.g. "xntpd -bA"), or by adding "disable auth" to the /etc/ntp.conf configuration file. On unsecured networks, authentication keys should be configured for broadcast clients and their broadcast servers (see the documentation for details). Reporting problems with this version ------------------------------------------------------------------------------ This version and package of NTP is not officially supported by SCO, but problems can be reported to Kamal A Mostafa . More Information ------------------------------------------------------------------------------ NTP home page at UDel: http://www.eecis.udel.edu/~ntp/ NTP Usenet newsgroup: comp.protocols.time.ntp Man pages: xntpd(ADMN), etc.