[Git][NTPsec/ntpsec][master] Added some status and testing info

Tue Dec 1 12:14:03 UTC 2015

Hal Murray pushed to branch master at NTPsec / ntpsec


Commits:
b1b27d37 by Hal Murray at 2015-12-01T04:13:02Z
Added some status and testing info

- - - - -


2 changed files:

- + devel/HOWTO-test
- + devel/STATUS


Changes:

=====================================
devel/HOWTO-test
=====================================

--- /dev/null
+++ b/devel/HOWTO-test
@@ -0,0 +1,86 @@
+This assumes you have downloaded the source and built a system
+and now you want to test your new ntpd.
+
+For help on getting that far, see ../INSTALL
+
+
+For a one off test:
+  Do "ps ax | grep ntpd" or equivalent to find out what the command line is.
+  Use whatever you do on your system to stop the normal ntpd.
+  Run ./build/ntpd/ntpd plus the command line parameters from above.
+  It will daemonize itself and give you back your terminal.
+
+Your current /etc/ntp.conf should work correctly.
+
+Check your log files to see if there is anything strange.
+Check ntpq to see if things look normal.
+
+--------
+
+For a longer test, including over reboots...
+
+Install your new code using "./waf install" (as root).
+That will install your new ntpd into /usr/local/sbin/ntpd
+
+Now you have to patch your (re)start scripts to look there
+and restart ntpd.  The details vary by OS/distro.
+
+Fedora and CentOS using systemd:
+  Edit /usr/lib/systemd/system/ntpd.service
+  Change ExecStart=/usr/sbin/ntpd -u ntp:ntp $OPTIONS
+  to     ExecStart=/usr/local/sbin/ntpd -u ntp:ntp $OPTIONS
+  then   service ntpd restart
+    systemctl will barf about an out of date file and tell you
+    how to fix it.  Follow its directions and try again.
+
+dnf update may undo that edit and revert to running the system version.
+
+
+Older versions used /etc/rc.d/init.d/ntpd.
+  I put a patch in /etc/sysconfig/ntpd
+  It gets sourced so you can put real code in there.
+  systemd doesn't do that.
+  I inserted:
+    PATH="/usr/local/sbin:$PATH"
+
+
+Debian, Ubuntu, Raspbian:
+  Edit /etc/init.d/ntp
+  Change DAEMON=/usr/sbin/ntpd
+  to     DAEMON=/usr/local/sbin/ntpd
+I duplicate that line, commend out the first one and fixup the second
+one so it looks like this:
+    # DAEMON=/usr/sbin/ntpd
+    DAEMON=/usr/local/sbin/ntpd
+
+If you are using DHCP and your DHCP servers provide NTP servers,
+Debian makes a dummy ntp.conf using those servers and not the
+ones you put into the normal /etc/ntp.conf.  To use your ntp.conf
+rather than the one it wants you to:
+  Edit /etc/init.d/ntp
+  Comment out the clump of 3 lines that references dhcp:
+# if [ -e /var/lib/ntp/ntp.conf.dhcp ]; then
+#       NTPD_OPTS="$NTPD_OPTS -c /var/lib/ntp/ntp.conf.dhcp"
+# fi
+
+apt-get upgrade may undo those edits and revert to running the system version.
+
+
+FreeBSD:
+  Edit /etc/rc.conf
+  It needs to contain
+    ntpd_enable="YES"
+    ntpd_program="/usr/local/sbin/ntpd"
+If you are running ntpd, the first line will be there
+already.  The default is NO.
+
+
+NetBSD:
+  Edit /etc/rc.d/ntpd:
+  Change: command="/usr/sbin/${name}"
+  To:     command="/usr/local/sbin/${name}"
+I duplicate the line, comment out the first one and edit the second one.
+It looks like this:
+  # command="/usr/sbin/${name}"
+  command="/usr/local/sbin/${name}"
+


=====================================
devel/STATUS
=====================================
--- /dev/null
+++ b/devel/STATUS
@@ -0,0 +1,43 @@
+Last update, 2015 Dec 01
+
+It builds on the following systems.  In general there should be no warnings,
+but as of the above date, there are a few that haven't been stamped out yet.
+
+  Fedora 22 and 23 on i686 and x86_64
+  Debian wheezy and jessie on amd64
+  Ubuntu 14.04.3 LTS and 15.04 on x86_64
+  Raspbian wheezy and jessie on ARM v6 and v7 (Pi and Pi 2)
+  Debian wheezy on BeagleBone Black ARM v7
+
+  FreeBSD 9.3 on i386 and 10.1 on amd64
+
+
+NetBSD needs more work.  The basic ntpd builds and runs.
+  NetBSD 6.1.5 and 7.0 on x86_64
+
+Audio doesn't work.  That is used by
+  6     IRIG Audio Decoder
+  7     Radio CHU Audio Demodulator/Decoder
+  util/tg2
+
+Loading libevent2 doesn't work.  That breaks
+  ntpdig and one of the tests
+Both build ok but don't load at run time.
+
+I haven't found libevent2 for NetBSD 6.1 so ntpdig doesn't build.
+
+
+
+
+The basic parts of ntpd run on all of the above systems.
+
+That are many options we havn't tested yet.
+
+Refclocks known to work on Linux:
+  20    NMEA GPS Receiver
+  22    PPS Clock Discipline
+  26    Hewlett Packard 58503A GPS Receiver
+  28    Shared Memory Driver
+  29    Trimble Navigation Palisade GPS (with Thunderbolt)
+  46    GPSD NG client protocol
+



View it on GitLab: https://gitlab.com/NTPsec/ntpsec/commit/b1b27d3766c917b622b8ca791889c9ad59eca48c
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.ntpsec.org/pipermail/vc/attachments/20151201/71f2afd3/attachment.html>
