Annotation of embedaddon/ntp/html/hints/hpux, revision 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>