Patch Name: PHCO_24172

Patch Description: s700_800 11.00 ups_mond(1M), power_onoff(1M) cumulative

Creation Date: 01/06/12

Post Date: 01/07/10

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

Products: N/A

Filesets:
	OS-Core.ADMN-ENG-A-MAN,fr=B.11.00,fa=HP-UX_B.11.00_32/64,v=HP
	OS-Core.UPS-TOOLS,fr=B.11.00,fa=HP-UX_B.11.00_32/64,v=HP

Automatic Reboot?: No

Status: General Release

Critical:
	Yes
	PHCO_24172: OTHER
		If defect JAGad69878 occurs, the system will
		perform a reboot rather than a graceful
		system shutdown.
	PHCO_23831: OTHER
		If this defect occurs, the system will be
		gracefully shutdown.

Category Tags:
	defect_repair enhancement general_release critical

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

Symptoms:
	PHCO_24172:
	     ( SR: 8606200702 CR: JAGad69878 )
	     If third party software is executing a script on
	     a single processor machine which executes ups_mond,
	     the script may hang when ups_mond issues its
	     shutdown command with real-time priority.  This
	     will cause ups_mond's timer to pop and reboot the
	     system.

	     ( SR: 8606198008 CR: JAGad67199 )
	     The ups_conf(4) man page was confusing.  There was no
	     explanation of UPS types, what the default for the
	     "kill_after_shutdown" keyword is, or an example that
	     shows how to use the "kill_after_shutdown" keyword.
	     The "Series 800 Only" text in ups_conf(4),
	     ups_mond(1M), and power_onoff(1M) man pages is
	     misleading since it is supported on Series 700.

	     ( SR: 8606200816 CR: JAGad69992 )
	     Ups_mond did not support UPS systems with battery life
	     longer than 16 minutes.

	PHCO_23831:
	     ( SR: 8606176412 CR: JAGad45650 )
	     If the Support Tool Manager (STM) version A.22.00,
	     A.24.00, or A.25.00 is installed, and patch PHCO_19040
	     is installed later, the version of ups_mond will be
	     downgraded.  As a result, the UPS EMS monitor (dm_ups)
	     will not operate.

	     ( SR: 8606186115 CR: JAGad55320 )
	     If the Support Tool Manager (STM) version A.22.00,
	     A.24.00, or A.25.00 is installed; ups_mond and the
	     EMS monitor dm_ups are running; the system receives
	     a power outage for approximately one second.  The
	     "power return" status is not seen by ups_mond and
	     the system gets shut down.

	PHCO_19040:
	     ( SR: 1653298950 CR: JAGab00048 )
	     Without this patch, the customer will not have the
	     ability to stop the UPS from automatically restarting
	     the system upon restoration of AC power.

	PHCO_14810:
	     ( SR: 4701387902 CR: JAGaa50594 )
	     When the system time is in the 20th century,
	     power_onoff does not process jobs using 2
	     digit years beyond year 2000.  When the system
	     time is in the 21st century, power_onoff does
	     not process jobs using both 2 or 4 digit years.

Defect Description:
	PHCO_24172:
	     ( SR: 8606200702 CR: JAGad69878 )
	     Ups_mond can only be run with real-time priority.

	     Resolution:
	     This version of ups_mond adds a new "-t" option which
	     will exec the /usr/shutdown command with timeshare
	     priority rather than real-time priority.

	     ( SR: 8606198008 CR: JAGad67199 )
	     Man pages needed to be corrected and clarified.

	     Resolution:
	     Updated the ups_conf(4) man page.  Added text to
	     explain the "SOLA" UPS type and how it is used.
	     Added text that defines the default value for the
	     "kill_after_shutdown" keyword.  Added
	     "kill_after_shutdown" to an example.  Removed
	     "Series 800 Only" from ups_conf(4), ups_mond(1M),
	     and power_onoff(1M) man pages.

	     ( SR: 8606200816 CR: JAGad69992 )
	     If ups_mond reads a value larger than
	     999 seconds, it will truncate to 999 seconds.
	     The maximum allowed in the configuration file
	     is 16 minutes.

	     Resolution:
	     PowerTrust II LR and PowerTrust II MR UPS units have
	     been enhanced with a new command that would allow the
	     value of the "shutdown_timeout_mins" keyword in
	     ups_mond's config file increase from 16 minutes to
	     1092 minutes.  The firmware rev that supports the new
	     functionality for these units is:
	     PowerTrust II LR: 2.0
	     PowerTrust II MR: BD
	     On the PowerTrust II MR unit, the PTPI interface card
	     must be visually inspected since there is no way to
	     programmatically get the firmware revision.  If the
	     PTPI interface card has a date code of 4130 or
	     greater, then it supports this new functionality.
	     This version of ups_mond has been enhanced to determine
	     if it is running on new UPS firmware or not.  If so,
	     it accepts a maximum of 1092 for the
	     "shutdown_timeout_mins" keyword.  If old firmware, it
	     behaves exactly as the previous version of ups_mond.

	PHCO_23831:
	     ( SR: 8606176412 CR: JAGad45650 )
	     If patch PHCO_19040 is installed on a system running
	     STM versions A.22.00, A.24.00, or A.25.00, the UPS EMS
	     monitor dm_ups will no longer operate.

	     Resolution:
	     The version of ups_mond supplied in this patch
	     supports the UPS EMS monitor (dm_ups), and provides
	     all fixes delivered in PHCO_19040.

	     ( SR: 8606186115 CR: JAGad55320 )
	     If a system running STM versions A.22.00, A.24.00, or
	     A.25.00; ups_mond and the EMS monitor (dm_ups) are
	     running; and the system receives a one second power
	     outage; then the system will be shut down.

	     Resolution:
	     The code was modified to not gather state information
	     about the UPS in the case of a power outage.

	PHCO_19040:
	     ( SR: 1653298950 CR: JAGab00048 )
	     The ups_mond(1M) command does not allow an option
	     to be set that suppresses the automatic restarting
	     of the system when AC power is restored.

	     Resolution:
	     A new option (kill_after_shutdown:Y) in the
	     ups_conf file has been added.

	PHCO_14810:
	     ( SR: 4701387902 CR: JAGaa50594 )
	     The code in power_onoff does not check for
	     dates past year 2000 and does not check for
	     2 digit boundaries that requires the
	     interpretations of the years 00-68 as
	     2000-2068 and years 69-99 as 1969-1999.

	     Resolution:
	     Modified to accept 2 and 4 digit dates past y2k.

SR:
	8606200702 8606198008 8606200816 8606176412 8606186115
	1653298950 4701387902 4701387902

Patch Files:
	
	OS-Core.ADMN-ENG-A-MAN,fr=B.11.00,fa=HP-UX_B.11.00_32/64,
		v=HP:
	/usr/share/man/man1m.Z/ups_mond.1m
	/usr/share/man/man1m.Z/power_onoff.1m
	/usr/share/man/man4.Z/ups_conf.4

	OS-Core.UPS-TOOLS,fr=B.11.00,fa=HP-UX_B.11.00_32/64,v=HP:
	/usr/lbin/ups_mond
	/usr/sbin/power_onoff

what(1) Output:
	
	OS-Core.UPS-TOOLS,fr=B.11.00,fa=HP-UX_B.11.00_32/64,v=HP:
	/usr/lbin/ups_mond:
		$Revision: 80.1.1.4 $
		$Revision: 80.1.1.16 $
		$ PATCH/11.00:PHCO_19491  Aug  9 1999 09:49:32 $

	OS-Core.UPS-TOOLS,fr=B.11.00,fa=HP-UX_B.11.00_32/64,v=HP:
	/usr/sbin/power_onoff:
		$Revision: 82.1.1.1 $
		$Revision: 72.5.1.2 $
		$Revision: 80.1.1.16 $

	OS-Core.ADMN-ENG-A-MAN,fr=B.11.00,fa=HP-UX_B.11.00_32/64,
		v=HP:
	/usr/share/man/man1m.Z/ups_mond.1m:
		None

	OS-Core.ADMN-ENG-A-MAN,fr=B.11.00,fa=HP-UX_B.11.00_32/64,
		v=HP:
	/usr/share/man/man1m.Z/power_onoff.1m:
		None

	OS-Core.ADMN-ENG-A-MAN,fr=B.11.00,fa=HP-UX_B.11.00_32/64,
		v=HP:
	/usr/share/man/man4.Z/ups_conf.4:
		None

cksum(1) Output:
	
	OS-Core.UPS-TOOLS,fr=B.11.00,fa=HP-UX_B.11.00_32/64,v=HP:
	2107643855 258048 /usr/lbin/ups_mond

	OS-Core.UPS-TOOLS,fr=B.11.00,fa=HP-UX_B.11.00_32/64,v=HP:
	37074905 40960 /usr/sbin/power_onoff

	OS-Core.ADMN-ENG-A-MAN,fr=B.11.00,fa=HP-UX_B.11.00_32/64,
		v=HP:
	2936983258 5540 /usr/share/man/man1m.Z/ups_mond.1m

	OS-Core.ADMN-ENG-A-MAN,fr=B.11.00,fa=HP-UX_B.11.00_32/64,
		v=HP:
	378622921 4340 /usr/share/man/man1m.Z/power_onoff.1m

	OS-Core.ADMN-ENG-A-MAN,fr=B.11.00,fa=HP-UX_B.11.00_32/64,
		v=HP:
	1508271206 2507 /usr/share/man/man4.Z/ups_conf.4

Patch Conflicts: None

Patch Dependencies: None

Hardware Dependencies: None

Other Dependencies: None

Supersedes:
	PHCO_14810 PHCO_19040 PHCO_23831

Equivalent Patches:
	PHCO_24152:
	s700: 10.20

	PHCO_24153:
	s800: 10.20

Patch Package Size: 340 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 PHCO_24172

	5. Run swinstall to install the patch:

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

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

		swinstall -x autoreboot=true -x patch_match_target=true \
			  -x patch_save_files=false -s /tmp/PHCO_24172.depot

	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 PHCO_24172.text file is 
	available in the product readme:

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

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

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

Special Installation Instructions:
	How to get UPS firmware revision:
	PowerTrust II LR
	To check the UPS firmware:
	1. Edit the file "/etc/uucp/Devices"
	2. Add "Direct ttyxxx - 1200 direct"
	   xxx = RS-232 tty port used by UPS
	3. At unix prompt, issue "cu -l ttyxxx
	4. Enter "V"

