Home | History | Annotate | Line # | Download | only in hints
      1 Last update: Sun Mar 13 15:05:31 PST 1994
      2 
      3 This file hopefully describes the whatever and however of how to get xntp
      4 running on hpux 7.0 and later s300. s400, s700, and s800.  
      5 
      6 First off,  all the standard disclaimers hold here ... HP doesn't have anthing
      7 to do with this stuff.  I fool with it in my spare time because we use it and
      8 because I like to.  We just happen to have a lot of HP machines around here :-)
      9 Xntpd has been in use here for several years and has a fair amount of mileage
     10 on various HP platforms within the company.  I can't really guarantee bug fixes
     11 but I'd certainly like to hear about bugs and I won't hestitate to look at
     12 any fixes sent to me.  
     13 
     14 Now lets talk OS.  If you don't have 7.0 or later, pretty much hang it up now.
     15 This stuff has run here on pretty much everything from 8.0 upward on s300, 
     16 s700, and s800.  It is known to run on 7.0 s300/s400 but all reports are 
     17 from the field and not my personal experience.
     18 
     19 If you are lucky enough to have a s300 or s400 with 9.03, then you no longer
     20 have to worry about adjtimed as HP-UX now has adjtime(2).  The rest of you
     21 will have to wait on 10.0 which will have adjtime(2) and a supported though
     22 a bit older version of xntpd.
     23 
     24 Next, let me explain a bit about how this stuff works on HP-UX's that do not
     25 have adjtime(2).  The directory adjtime contains libadjtime.a and the adjtimed
     26 daemon.  Instead of the adjtime(2) system call, we use a library routine to
     27 talk to adjtimed thru message queues.  Adjtimed munges into /dev/kmem and
     28 causes the clock to skew properly as needed.  PLEASE NOTE that the adjtime
     29 code provided here is NOT a general replacement for adjtime(2) ... use of
     30 this adjtime(3)/adjtimed(8) other than with xntpd may yield very odd results.
     31 
     32 What to do to get this stuff running ?
     33 
     34     * If you are running an OS less than 10.0 or do not have a s300/s400 
     35       with 9.03 or better
     36 	-> cd machines
     37 	-> vi hpux
     38 	-> (change -DSYS_HPUX=? to match whatever you are running [7,8,9])
     39 	-> cd ..
     40 
     41     * Say "make makeconfig"
     42 
     43     * Say "make", sit back for a few minutes.
     44 
     45     * cd authstuff
     46 	* Say "./authcert < certdata" and check the output.  Every line should
     47 	  end with "OK" ... if not, we got trouble.
     48 	* Now try "./authspeed auth.samplekeys".  What we want to 
     49 	  remember here is the "authentication delay in CPU time" 
     50 	* cd ..
     51 
     52     * Say "make install"
     53 
     54     * I'd suggest reading the xntp docs about now :-) ... seriously !!
     55 
     56     * One thing I have added to this version of xntpd is a way to select 
     57       config files if you are sharing /usr/local thru NFS or whatever.  
     58       If the file /usr/local/etc/xntp.conf happens to be a directory, the 
     59       files in that directory are searched until a match is found.  The 
     60       rules for a match are:
     61 
     62 	1. Our hostname
     63 	2. default.<machine id> (as in default.375 or default.850)
     64 	3. default
     65 
     66     * Ok, make sure adjtimed is running (just start it up for now with
     67       "/usr/local/etc/adjtimed").  Using -z as an option will get you 
     68       a usage message.
     69 
     70     * Now start up xntpd and watch it work.
     71 
     72     * Make sure that adjtimed gets started at boot right before xntpd.
     73       We do this in /etc/netbsdsrc.  They must both run as root !!
     74 
     75 Possible problems ?
     76 
     77     * On some 320's and 835's we have had to run adjtimed with "-p 45" or
     78       so to get rid of syslog messages about "last adjust did not finish".
     79 
     80     * At 9.0, there is a problem with DIAGMON (patch available from the
     81       response center) which causes it to delete the message queue that
     82       adjtimed/xntpd use to communicate. (see next note for result)
     83 
     84     * Xntpd has been known to get really ticked off when adjtime() fails
     85       which is usually only while running the emulation code on HP-UX.
     86       When it gets mad, it usually jumps the clock into never never land.
     87       Possible reasons for this are adjtimed being killed or just never
     88       started or adjtimed being completely swapped out on a really busy
     89       machine (newer adjtimed try to lock themselves in memory to prevent
     90       this one).
     91 
     92 Anything else ... just drop me a line at ken (a] sdd.hp.com
     93 
     94 Received: from louie.udel.edu by huey.udel.edu id aa14418; 15 Jun 95 9:19 EDT
     95 Received: from host5.colby.edu (host-05.colby.edu) by host-04.colby.edu with ESMTP  (1.37.109.15/Colby 1.1)
     96 	id AA165442355; Thu, 15 Jun 1995 09:19:16 -0400
     97 Received: by host5.colby.edu  (1.37.109.15/Colby 1.1)
     98 	id AA056252339; Thu, 15 Jun 1995 09:18:59 -0400
     99 Date: Thu, 15 Jun 1995 09:18:59 -0400 (EDT)
    100 From: "Jeff A. Earickson" <jaearick (a] colby.edu>
    101 To: Mills (a] huey.udel.edu
    102 Subject: More minor bugs in xntp3.4s
    103 In-Reply-To: <9506150022.aa12727 (a] huey.udel.edu>
    104 Message-Id: <Pine.HPP.3.91.950615083549.4557A-100000 (a] host5.colby.edu>
    105 Mime-Version: 1.0
    106 Content-Type: TEXT/PLAIN; charset=US-ASCII
    107 
    108 Dave,
    109    After reading the hpux hints file, I realized I didn't install or 
    110 start adjtimed.  In the course of doing this, I discovered that:
    111 
    112 --> $(TOP) is not defined in adjtime/Makefile, so "make install" can't
    113     find the install.sh script.
    114 
    115 --> "make install" from the main Makefile never goes into the adjtime
    116     directory, so I added the following two lines into the install
    117     target of the main Makefile:
    118 
    119     @echo installing from adjtime
    120     @cd adjtime && $(MAKE) $(MFLAGS) MFLAGS="$(MFLAGS)" MAKE="$(MAKE)" install
    121 
    122 This twiddle may not be right for all systems, but it got adjtimed
    123 installed for me.
    124 
    125    You might also want to add to the hpux hints file that one way to
    126 fire things up at boot time is to add the following lines to the localrc
    127 function of /etc/rc:
    128 
    129     #---daemons for Network Time Protocol (version 3.4s)
    130     #---note that adjtimed is only needed for HP-UX 9.X, not 10.0
    131     #---adjtimed must be running or xntpd won't work right...
    132     if [ -x /usr/local/bin/adjtimed ]; then
    133         /usr/local/bin/adjtimed -r & echo -n ' adjtimed'
    134         if [ -x /usr/local/bin/xntpd ]; then
    135             /usr/local/bin/xntpd &    echo -n ' xntpd'
    136         fi
    137     fi
    138 
    139 I discovered that the "-r" option of adjtimed is needed to clear out any
    140 trash from a previous execution of it.  Otherwise adjtimed quietly dies
    141 and leaves xntpd in the lurch...
    142 
    143 Thanks for the help.
    144 
    145 ** Jeff A. Earickson, Ph.D                         PHONE: 207-872-3659
    146 ** Senior UNIX Sysadmin, Information Technology    EMAIL: jaearick (a] colby.edu
    147 ** Colby College, 4214 Mayflower Hill,               FAX: 207-872-3555
    148 ** Waterville ME, 04901-8842
    149 
    150 On Thu, 15 Jun 1995 Mills (a] huey.udel.edu wrote:
    151 
    152 > Jeff,
    153 > 
    154 > Read the hpux file in the hints directory.
    155 > 
    156 > Dave
    157 > 
    158 
    159