Annotation of embedaddon/ntp/html/hints/hpux, revision 1.1.1.1

1.1       misho       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@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@colby.edu>
                    101: To: Mills@huey.udel.edu
                    102: Subject: More minor bugs in xntp3.4s
                    103: In-Reply-To: <9506150022.aa12727@huey.udel.edu>
                    104: Message-Id: <Pine.HPP.3.91.950615083549.4557A-100000@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@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@huey.udel.edu wrote:
                    151: 
                    152: > Jeff,
                    153: > 
                    154: > Read the hpux file in the hints directory.
                    155: > 
                    156: > Dave
                    157: > 
                    158: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>