Patch Name: PHNE_27442

Patch Description: s700_800 11.04 (VVOS) NTP timeservices upgrade + utilities

Creation Date: 02/07/04

Post Date:  02/08/01

Repost: 03/07/22 
	The Special Installation Instructions section of the patch
	documentation was modified to clarify that extra steps may
	be necessary to properly restart xntpd(1M) following the
	patch installation if a reboot occurred as a result of the
	installation session. 

Hardware Platforms - OS Releases:
	s700: 11.04
	s800: 11.04

Products: N/A

Filesets:
	InternetSrvcs.INETSVCS-BOOT,fr=B.11.04,fa=HP-UX_B.11.04_32/64,v=HP
	InternetSrvcs.INET-ENG-A-MAN,fr=B.11.04,fa=HP-UX_B.11.04_32/64,v=HP

Automatic Reboot?: No

Status: General Release

Critical: No

Category Tags:
	defect_repair enhancement general_release

Path Name: /hp-ux_patches/s700_800/11.X/PHNE_27442

Symptoms:
	PHNE_27442:
	  Ported HP-UX patch PHNE_27223 to VVOS

	Based on HP-UX patch PHNE_27223:
	1. JAGae26628 / SR8606262293:
	   xntpd can cause performance problem.

	PHNE_24077:
	  Ported HP-UX patch PHNE_23697 to VVOS
	Based on HP-UX patch PHNE_23697:
	JAGad58543 / SR 8606189328:
	Description: xntpd core dumps.

	JAGad14276 / SR 8606144936:
	Description: xntpd -x does step instead of slew.

	JAGac20260 / SR 8606113990:
	Description: "/sbin/init.d/xntpd stop" command does not
	terminate xntpd daemon.

	PHNE_22512:
	Ported HP-UX patch PHNE_19711 to VVOS
	Based on HP-UX patch PHNE_19711:
	1.The NTP clock driver for the HP58503 GPS receiver does
	  not recognize the leap day in the years: 2000, 2400,
	  2800, etc. As a result, if the HP58503 GPS receiver is
	  the *ONLY* source for NTP time synchronization on the
	  leap day in the years 2000, 2400, 2800, etc, the system
	  will revert to only using the system internal clock as
	  its source of time. If other time sources are available
	  they will continue to be used for synchronization.
	2.When filegen is configured to use the day or month, the
	  NTP filegen option does not correctly generate the proper
	  name for the optional statistics file on the leap day of
	  any leap year.
	3.xntpd creates /var/adm/wtmp if it does not exist.
	4.The clock driver for Trimble Palisade GPS is not
	  supported.
	5.Need SLEW capability similar to PHNE_12689 on HP-UX 10.x.

Defect Description:
	PHNE_27442:
	  Ported HP-UX patch PHNE_27223 to VVOS

	Based on HP-UX patch PHNE_27223:
	1. JAGae26628 / SR8606262293:
	Description:
	   xntpd can cause performance degradation under certain
	   circumstances.
	Resolution:
	   The performance problem is now fixed.

	PHNE_24077:
	  Ported HP-UX patch PHNE_23697 to VVOS
	Based on HP-UX patch PHNE_23697:
	JAGad58543 / SR 8606189328:
	Description: xntpd core dumps with SIGSEGV.
	Resolution: Now xntpd does not core dump.

	JAGad14276 / SR 8606144936:
	Description: xntpd -x was slewing in one direction only. In
	the other direction it was stepping instead of slewing.
	Resolution: Now xntpd -x slews for backward as well as for
	forward clock adjustment.

	JAGac20260 / SR 8606113990:
	Description: "/sbin/init.d/xntpd stop" command does not
	stop xntpd daemon due to improper process filtering in the
	script.
	Resolution: Now "/sbin/init.d/xntpd stop" command stops
	the xntpd daemon.

	PHNE_22512:
	Ported HP-UX patch PHNE_19711 to VVOS
	Based on HP-UX patch PHNE_19711:
	1.The NTP clock driver for the HP58503 GPS receiver does
	  not recognize the leap day in the years: 2000, 2400,
	  2800, etc. As a result, if the HP58503 GPS receiver is
	  the *ONLY* source for NTP time synchronization on the
	  leap day in the years 2000, 2400, 2800, etc, the system
	  will revert to only using the system internal clock as
	  its source of time. If other time sources are available
	  they will continue to be used for synchronization.
	2.When filegen is configured to use the day or month, the
	  NTP filegen option does not correctly generate the proper
	  name for the optional statistics file on the leap day of
	  any leap year.
	3.xntpd was creating /var/adm/wtmp file if it did not
	  exist. As per the wtmp manpage, no application should
	  create /var/adm/wtmp file if it does not exist.
	4.The clock driver for Trimble Palisade GPS is not
	  supported.
	5.Some customers have requested this special behavior where
	  the time daemon never makes a STEP adjustment.
	Resolution:
	1.All the clock drivers that HP-UX NTP supports, now
	  recognize leap year.
	2.NTP now creates file on 29-Feb with correct file name
	  when filegen option is used with type day or month.
	3.xntpd checks for the /var/adm/wtmp file to exist. If
	  it exists it opens it but if it does not exist
	  it does not create it.
	4.The clock driver for Trimble Palisade GPS is now included.
	  The HP Supported clocks are now:
	        Undisciplined Local Clock  (driver#1)  (last resort)
	        Spectracom Netclock/2 WWVB (driver#4)
	        HP58503 GPS                (driver#26)
	        Trimble Palisade GPS       (driver#29)
	5.SLEW is now provided with the "-x" command line option.
	  The time adjustments are made in a graceful slewing
	  fashion, and the system clock is never STEP adjusted
	  backwards. See xntpd manpage for details.

Enhancement:
	No (superseded patches contained enhancements)
	PHNE_24077:
	PHNE_22512:
	Ported HP-UX patch PHNE_19711 to VVOS

	Based on HP-UX patch PHNE_19711:
	1) This patch delivers an enhancement in xntpd to support
	   driver for Trimble Palisade GPS clock receiver.
	2) This patch delivers a new functionality in xntpd to
	   enable clock adjustment by slewing.

SR:
	8606189328 8606144936 8606113990 8606103143 1653307074
	5003448407 8606106338 1653298596 8606262293 8606262336

Patch Files:
	
	InternetSrvcs.INETSVCS-BOOT,fr=B.11.04,
		fa=HP-UX_B.11.04_32/64,v=HP:
	/usr/sbin/xntpd
	/usr/sbin/ntpdate
	/usr/sbin/ntpq
	/usr/sbin/xntpdc
	/usr/sbin/ntptrace
	/sbin/init.d/xntpd
	/etc/ntp.conf.example
	/usr/share/doc/NTP_Primer.txt

	InternetSrvcs.INET-ENG-A-MAN,fr=B.11.04,
		fa=HP-UX_B.11.04_32/64,v=HP:
	/usr/share/man/man1m.Z/xntpd.1m
	/usr/share/man/man1m.Z/ntpdate.1m
	/usr/share/man/man1m.Z/ntpq.1m
	/usr/share/man/man1m.Z/xntpdc.1m

what(1) Output:
	
	InternetSrvcs.INETSVCS-BOOT,fr=B.11.04,
		fa=HP-UX_B.11.04_32/64,v=HP:
	/usr/sbin/xntpd:
		$Revision: Hewlett-Packard ISSL Level vvos_rose42 $ 
			$Header: Hewlett-Packard ISSL Release vvos_r
			ose $ $Date: Wed Jul 10 11:54:51 EDT 2002 $
		$Source: net/INETSVCS/xntp/xntpd/ntp_loopfilter.c, h
			puxcmdnet, vvos_rose, rose0270 $ $Date: 00/1
			1/02 16:57:40 $ $Revision: 1.10 PATCH_11.04 
			(PHNE_22512) $
	/usr/sbin/ntpdate:
		$Revision: Hewlett-Packard ISSL Level vvos_rose42 $ 
			$Header: Hewlett-Packard ISSL Release vvos_r
			ose $ $Date: Wed Jul 10 11:54:51 EDT 2002 $
	/usr/sbin/ntpq:
		ntpq version 3.5f: Fri Dec 10 18:29:01 GMT 1999 PHNE
			_19711
		Copyright 1992 David L. Mills
	/usr/sbin/xntpdc:
		xntpdc version 3.5f: Fri Dec 10 18:28:59 GMT 1999 PH
			NE_19711
		Copyright 1992 David L. Mills
	/usr/sbin/ntptrace:
		ntptrace version 3.5f: Fri Dec 10 18:29:04 GMT 1999 
			PHNE_19711
		Copyright 1992 David L. Mills
	/sbin/init.d/xntpd:
		None
	/etc/ntp.conf.example:
		None
	/usr/share/doc/NTP_Primer.txt:
		None

	InternetSrvcs.INET-ENG-A-MAN,fr=B.11.04,
		fa=HP-UX_B.11.04_32/64,v=HP:
	/usr/share/man/man1m.Z/xntpd.1m:
		None
	/usr/share/man/man1m.Z/ntpdate.1m:
		None
	/usr/share/man/man1m.Z/ntpq.1m:
		None
	/usr/share/man/man1m.Z/xntpdc.1m:
		None

cksum(1) Output:
	
	InternetSrvcs.INETSVCS-BOOT,fr=B.11.04,
		fa=HP-UX_B.11.04_32/64,v=HP:
	1658400139 290816 /usr/sbin/xntpd
	3179786788 65536 /usr/sbin/ntpdate
	1016435181 90112 /usr/sbin/ntpq
	19208359 90112 /usr/sbin/xntpdc
	253316861 32768 /usr/sbin/ntptrace
	3637993676 2136 /sbin/init.d/xntpd
	1269062075 17179 /etc/ntp.conf.example
	3500555408 49684 /usr/share/doc/NTP_Primer.txt

	InternetSrvcs.INET-ENG-A-MAN,fr=B.11.04,
		fa=HP-UX_B.11.04_32/64,v=HP:
	1894712962 13863 /usr/share/man/man1m.Z/xntpd.1m
	2044036299 3550 /usr/share/man/man1m.Z/ntpdate.1m
	3028733388 7760 /usr/share/man/man1m.Z/ntpq.1m
	2827577582 8960 /usr/share/man/man1m.Z/xntpdc.1m

Patch Conflicts: None

Patch Dependencies: None

Hardware Dependencies: None

Other Dependencies: None

Supersedes:
	PHNE_22512 PHNE_24077

Equivalent Patches:
	PHNE_27223:
	s700: 11.00
	s800: 11.00

	PHNE_24510:
	s700: 10.01 10.20
	s800: 10.01 10.20

	PHNE_24512:
	s700: 11.11
	s800: 11.11

Patch Package Size: 710 KBytes

Installation Instructions:
	Please review all instructions and the Hewlett-Packard
	SupportLine User Guide or your Hewlett-Packard support terms
	and conditions for precautions, scope of license,
	restrictions, and, limitation of liability and warranties,
	before installing this patch.
	------------------------------------------------------------
	1. Back up your system before installing a patch.

	2. Login as root.

	3. Copy the patch to the /tmp directory.

	4. Move to the /tmp directory and unshar the patch:

		cd /tmp
		sh PHNE_27442

	5. Run swinstall to install the patch:

		swinstall -x autoreboot=true -x patch_match_target=true \
			  -s /tmp/PHNE_27442.depot

	By default swinstall will archive the original software in 
	/var/adm/sw/save/PHNE_27442.  If you do not wish to retain a
	copy of the original software, include the patch_save_files
	option in the swinstall command above:

		-x patch_save_files=false

	WARNING: If patch_save_files is false when a patch is installed,
		 the patch cannot be deinstalled.  Please be careful
		 when using this feature.

	For future reference, the contents of the PHNE_27442.text file is 
	available in the product readme:

		swlist -l product -a readme -d @ /tmp/PHNE_27442.depot

	To put this patch on a magnetic tape and install from the
	tape drive, use the command:

		dd if=/tmp/PHNE_27442.depot of=/dev/rmt/0m bs=2k

Special Installation Instructions:
	When this patch is installed with other software or patches
	that will cause a system reboot, and the xntpd daemon is
	enabled in the system, then the xntpd daemon may not start
	properly after the system reboot following the initial
	installation.  To ensure proper operation of xntpd(1M)
	following the initial reboot, execute the following commands
	after the system reboot to start the daemon properly:

	  /sbin/init.d/xntpd stop
	  /sbin/init.d/xntpd start

	Be sure to look at /etc/ntp.conf.example for suggested
	configurations and hints.
	# These lines could be used for a timeserver
	# with HP GPS clock;
	# Choose the correct "fudge" line for your system
	#
	#HP58503 GPS clock
	server 127.127.26.1 prefer minpoll 3 maxpoll 4
	#9000/7xx at 9600 baud (optional)
	fudge  127.127.26.1 time1 -0.955
	#9000/8xx at 9600 baud (optional)
	fudge  127.127.26.1 time1 -0.930
	#
	# You must also create (using "mknod" or "ln -s") a device
	# file that corresponds to your serial port and has the
	# name /dev/hpgps1.
	# Hint:  Use SAM to create /dev/hpgps1 and then rename it
	# or "/usr/bin/ln -s /dev/tty0p0 /dev/hpgps1.
	# (use correct serial port for your system)
	#
	# This line could be used for a timeserver with Trimble
	# Palisade GPS clock and /dev/palisade1
	#
	server 127.127.29.1 prefer  # Trimble Palisade GPS
	#
	# This line could be used for a timeserver with Spectracom
	# Netclock/2 WWVB receiver and /dev/wwvb1
	#
	# Trimble Palisade GPS
	server 127.127.4.1 prefer minpoll 3 maxpoll 4
	#
	# These lines could be used for Undiscplined Local Clock
	# A good "clock of last resort" in case all other
	# timesources disappear
	# Highly recommended for all timeservers
	server 127.127.1.1  # Local Clock Impersonator
	fudge  127.127.1.1  stratum 10 # show poor stratum