Patch Name: PHCO_29600

Patch Description: s700_800 11.11 VxVM B.03.20.1 CVM Patch for MC/SG

Creation Date: 04/01/08

Post Date: 04/02/16

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

Products:
	HP VxVM B.03.20.1

Filesets:
	HPvxvm.VXVM-RUN,fr=B.03.20.1,fa=HP-UX_B.11.11_32/64,v=HP

Automatic Reboot?: No

Status: General Release

Critical:
	Yes
	PHCO_29600: OTHER
		vxclustd cannot be halted and hence Service Guard
		forcefully brings the system down, after waiting
		for some time.

Category Tags:
	defect_repair general_release critical

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

Symptoms:
	PHCO_29600:
	( SR:8606307156 CR:JAGae70189 )
	ServiceGuard brings down the system during halting
	because vxclustd is unable to halt.

Defect Description:
	PHCO_29600:
	( SR:8606307156 CR:JAGae70189 )
	If the vxclustd daemon can not be shut down cleanly during
	a cmhaltcl or cmhaltnode operations, MC/ServiceGuard will
	TOC the cluster node.

	The most common case for vxclustd to fail to shutdown is
	if a disk group is still active. Vxclustd will hang waiting
	for the disk group to be deactivated. cmcld will then
	timeout the VxVM-CVM-pkg halt script and fail the node due
	to FAILFAST being set. Syslog will show messages:

	     cmcld: Control script for package VxVM-CVM-pkg killed
	after not completing within 201 seconds.
	     cmcld: Halted package VxVM-CVM-pkg on node mucobt51.
	     cmcld: Package VxVM-CVM-pkg halt script timed out.
	     cmcld: Examine the file
	/etc/cmcluster/cvm/VxVM-CVM-pkg.sh.log for more details.
	     cmcld: Failed node in response to failure of package
	VxVM-CVM-pkg.
	     cmcld: Halting mucobt51 to preserve data integrity
	     cmcld: Reason: A crucial package failed

	The situation could have been handled more gracefully than
	doing a SG TOC.

	Resolution:

	A new script /etc/cmcluster/cvm/VxVM-CVM-pkg-preshutdown.sh
	is added to check if vxclustd can be cleanly shutdown. This
	new script will be called via MC/ServiceGuard's cmcld daemon
	at cmhaltcl and cmhaltnode time prior to halting the
	VxVM-CVM-pkg package to make sure that no disk groups are
	active. If there are, then appropriate error messages will
	be logged and the command will fail; if not, then further
	halt will proceed.

	The MC/ServiceGuard patch to call this pre shutdown script
	is PHSS_29122.  It is recommended that this MC/ServiceGuard
	patch also be installed on your system.

Enhancement:
	No

SR:
	8606307156

Patch Files:
	
	HPvxvm.VXVM-RUN,fr=B.03.20.1,fa=HP-UX_B.11.11_32/64,v=HP:
	/etc/cmcluster/cvm/VxVM-CVM-pkg-preshutdown.sh

what(1) Output:
	
	HPvxvm.VXVM-RUN,fr=B.03.20.1,fa=HP-UX_B.11.11_32/64,v=HP:
	/etc/cmcluster/cvm/VxVM-CVM-pkg-preshutdown.sh:
		None

cksum(1) Output:
	
	HPvxvm.VXVM-RUN,fr=B.03.20.1,fa=HP-UX_B.11.11_32/64,v=HP:
	1924596005 2115 /etc/cmcluster/cvm/
		VxVM-CVM-pkg-preshutdown.sh

Patch Conflicts: None

Patch Dependencies:
	s700: 11.11: PHCO_26421 PHSS_29122
	s800: 11.11: PHCO_26421 PHSS_29122

Hardware Dependencies: None

Other Dependencies: None

Supersedes: None

Equivalent Patches: None

Patch Package Size: 20 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_29600

	5. Run swinstall to install the patch:

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

	By default swinstall will archive the original software in 
	/var/adm/sw/save/PHCO_29600.  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 PHCO_29600.text file is 
	available in the product readme:

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

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

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

Special Installation Instructions: None