OS: Linux
OS Version: RHEL40 (x86_64)
Fixes Applied for Products:
	VRTSvxfen - Veritas I/O Fencing by Symantec

Additional Instructions:
Please read the instructions below before installing the patch.

 PATCH VxFEN 5.0 MP3 RP2 HF2 for VxFEN 5.0 MP3 RP2 (Linux)
===============================================================

 Patch Date:  October, 2009

This README provides information on:
 * BEFORE GETTING STARTED
 * CRC AND BYTE COUNT
 * FIXES AND ENHANCEMENTS INCLUDED IN THE PATCH
 * PACKAGES AFFECTED BY THE PATCH
 * INSTALLING THE PATCH
 * UNINSTALLING THE PATCH


BEFORE GETTING STARTED:
----------------------
This patch only applies to:
	VxFEN 5.0 MP3 RP2 running on Linux (RHEL40 x86_64)

Ensure that you are running the supported configurations before
installing this patch.


CRC AND BYTE COUNT:
------------------
Ensure that the patch file you have downloaded matches the following
checksum and byte count.

The following command can be used to ascertain this:
# cksum VRTSvxfen-5.0.30.22-MP3RP2HF2_RHEL4.x86_64.rpm
793992364	569185	VRTSvxfen-5.0.30.22-MP3RP2HF2_RHEL4.x86_64.rpm


FIXES AND ENHANCEMENTS INCLUDED IN THE PATCH: 
--------------------------------------------
Etrack Incidents: 1779129, 1822731

SDR's of Fixed Symantec Incidents:
--------------------------------
Symantec Incident : 1822731
Symptom:
	vxfenswap(1m) utility logs the following message in the utility's 
	log file even though I/O fencing is configured:
	"I/O fencing does not appear to be configured on node."
Defect Description:
	vxfenswap(1m) utility is not invoking command on remote host with 
	proper syntax. Because of this, it could not collect correct 
	status of I/O fencing module, whether it is running or not.
Resolution:
	The code has been added to invoke command with 
	appropriate syntax/argument.

Symantec Incident : 1779129
Symptom:
	The command "/etc/init.d/vxfen stop" fails with the error in console:
	"ERROR: failed to stop vxfen" 
	and the following error appears in /var/VRTSvcs/log/vxfen/vxfen.log:
	"VXFEN vxfenconfig ERROR V-11-2-1071 Ioctl VXFEN_IOC_CLUSTSTAT failed!"
Defect Description:
	VxFEN was using a variable without proper memory allocation. 
	The problem occurred when, the variable failed to store a 
	large amount of data, due to its size limitation. Hence, 
	recovering information correctly from the variable was 
	not possible and the error messages are seen.
Resolution:
	The variable now have proper memory allocation.

PACKAGES AFFECTED BY THE PATCH:
-------------------------------
This patch updates the following VCS package(s) 
	VxFEN from 5.0MP3RP2 (5.0.3.20) or higher 
		to 5.0MP3RP2HF2 (5.0.3.22) for RHEL40 (x86_64)

INSTALLING THE PATCH:
--------------------
The following steps should be run on all nodes in the VCS cluster:

Stopping VCS on the cluster node:
--------------------------------
1. Verify that /opt/VRTSvcs/bin is set in the PATH variable 
   so you can execute all VCS commands.

2. Ensure that none of the service groups are online on this system.
2a. For each failover group online on this sytem, switch over 
    the service group to a node that is running:
        # hagrp -switch [service_group] -to [node]
2b. Offline every parallel group online on this system:
	# hagrp -offline [service_group] -sys [this_node]

3. Make the VCS configuration writable. On a node that you want 
   to upgrade, type:
        # haconf -makerw

4. Freeze the service group operations. Perform this task on each node 
   if you had selected a group of nodes to upgrade:
        # hasys -freeze -persistent [node]

5. Make the VCS configuration read-only:
        # haconf -dump -makero

6. Stop VCS, using the following command, in each node in 
   the group that is being upgraded:
        # hastop -local

7. Stop the VCS command server:
       # killall CmdServer

8. Stop VxFEN module using the following command:
	# /etc/init.d/vxfen stop

9. If the above command fails to stop VxFen module with symptoms
   documented in the "Symptom" section, then follow the steps mentioned
   below for the same:
   To remove vxfen script from all the run-levels for next boot, 
   run the following command as appropriate on all nodes:
	For RHEL:
		# chkconfig --del vxfen
	For SUSE:
		# insserv -r vxfen
   Reboot the node, which will stop vxfen from running in any run-level.
   Note that a forced reboot may be necessary. Also, if VCS was
   configured to make use of fencing (Cluster Attribute "UseFence" set to
   "SCSI3"), the "had" process will not come up immediately after the
   reboot. This is expected.

Installing the Patch:
--------------------
1. Un-compress the downloaded patch from Symantec.
   Change directory to the unzipped patch location. 
   Install the VxFEN 5.0MP3RP2HF2 patch using the following command:
	# rpm -Uvh VRTSvxfen-5.0.30.22-MP3RP2HF2_RHEL4.x86_64.rpm

2. Verify that the new patch has been installed:
	# rpm -qa | grep VRTSvxfen
   You will find the following output on display with the patch 
   installed properly:
	VRTSvxfen-5.0.30.22-MP3RP2HF2_RHEL4


Re-starting VCS on the cluster node:
-----------------------------------
1. Re-start VxFEN on the node using the command :
	# /etc/init.d/vxfen start

2. If VCS was configured to make use of fencing, a re-start of VCS is
   required :
	# /etc/init.d/vcs start

3. Make the VCS configuration writable. Run the following command 
   from any node in the upgraded group.
	# haconf -makerw

4. Unfreeze the service group operations. Perform this task on 
   each node if you had upgraded a group of nodes.
	# hasys -unfreeze -persistent [node]

5. Make the configuration read-only.
	# haconf -dump -makero

6. Start the parallel service groups that were stopped as part of step 2a.
	# hagrp -online [service_group] -sys [this_node]

7. Switch back the service group to the original node.
	# hagrp -switch [service_group] -to [node]

For each cluster node, repeat all the steps above, starting with Step 1
of subsection "Stopping VCS on the cluster node".


UNINSTALLING THE PATCH:
-----------------------
Removal of the patch will result in removing whole package 
from the system/node. To go back to a previous installed version 
of the package, you may need to re-install the package again.
Following steps need to be run on all the VCS cluster node:

Steps to remove the Patch from a cluster node:
---------------------------------------------
1. Follow the steps 1 to 8, provided under "Stopping VCS on the 
   cluster node" section above, to stop VCS on the node & 
   unload any drivers, as required.

2. Remove the package by the following command:
	# rpm -e VRTSvxfen

3. Verify that the patch has been removed from the system:
	# rpm -qa | grep VRTSvxfen
   There will be no result displayed at the console.

4. Install VRTSvxfen package from VCS 5.0MP3 Installer CD 
   and upgrade to VxFEN 5.0MP3RP2 or higher.

5. Restart the node following the steps under 
   "Re-starting VCS on the cluster node" section above.