* * * READ ME * * *
* * * Cluster Server Agent Extension for SFCFS Distribution 5.1 SP1 PR2 RP2 * * *
                         * * * P-patch 2 * * *
                         Patch Date: 2012-06-27


This document provides the following information:

   * PATCH NAME
   * PACKAGES AFFECTED BY THE PATCH
   * BASE PRODUCT VERSIONS FOR THE PATCH
   * OPERATING SYSTEMS SUPPORTED BY THE PATCH
   * INCIDENTS FIXED BY THE PATCH
   * INSTALLATION PRE-REQUISITES
   * INSTALLING THE PATCH
   * REMOVING THE PATCH


PATCH NAME
----------
Cluster Server Agent Extension for SFCFS Distribution 5.1 SP1 PR2 RP2 P-patch 2


PACKAGES AFFECTED BY THE PATCH
------------------------------
VRTScavf


BASE PRODUCT VERSIONS FOR THE PATCH
-----------------------------------
   * Veritas Storage Foundation Cluster File System 5.1 SP1 PR2
   * Veritas Storage Foundation Cluster File System for Oracle RAC 5.1 SP1 PR2
   * Symantec VirtualStore 5.1 SP1 PR2


OPERATING SYSTEMS SUPPORTED BY THE PATCH
----------------------------------------
SLES10 x86-64
SLES11 x86-64


INCIDENTS FIXED BY THE PATCH
----------------------------
This patch fixes the following Symantec incidents:

Patch ID: 5.1.132.200

* 2694495 (Tracking ID: 2669724)

SYMPTOM:
CFSMount agent hit assert on monitor timeout with stack similar to the 
following:

VCSAssert()
VCSAgThreadTbl::add()
VCSAgRes::call_entry_point()
VCSAgIntState::process_res_fault()
VCSAgISMonitoring::timedout()
VCSAgRes::process_cmd()
vcsag_service_thread_join()
start_thread()

Also following messages will apear in the engine log:

Thread(4149205920) Agent is calling clean for resource(cfsmount12) because 1 
successive invocations of the monitor procedure did not complete within the 
expected time.
2010 Jul 23 21:30:09 swsfs2_01 AgentFramework[3942]: ASSERTION FAILED

DESCRIPTION:
The pthread cancellation is not processed cleanly by the library 
glibc routines used in monitor entry point. Due to this the cancellation 
cleanup handler was not getting called.

RESOLUTION:
Replaced the glibc function with the unix system call to avoid it, 
e.g fopen() replaced with open and fgets() replaced with read().

* 2788309 (Tracking ID: 2684573)

SYMPTOM:
The performance of the cfsumount(1M) command for the VRTScavf package is slow 
when some checkpoints are deleted.

DESCRIPTION:
When a checkpoint is removed asynchronously, a kernel thread is started to 
handle the job in the background. If an unmount command is issued before these 
checkpoint removal jobs are completed, the command waits for the completion of 
these jobs. A forced unmount can interrupt the process of checkpoint deletion 
and the remaining work is left to the next mount.

RESOLUTION:
The code is modified to add a counter in the vxfsstat(1M) command to determine 
the number of checkpoint removal threads in the kernel. The '-c' option is 
added to the cfsumount(1M) command to force unmount a mounted file system if 
the checkpoint jobs are running.

* 2824916 (Tracking ID: 2824895)

SYMPTOM:
vcscvm test cfsumount was failing while umount of a storage checkpoint instance
through cfsumount.

DESCRIPTION:
While umount through cfsumount when storage checkpoint instance on one of the
node of cluster is mounted, the cfsumount didn't succeeded on nodes where parent
is not ONLINE.

RESOLUTION:
Update proper checks in check_offline function to make sure in failed umount
case and return correct umount exit code.

Patch ID: 5.1.132.100

* 2619910 (Tracking ID: 2591702)

SYMPTOM:
Following error messages are seen in VCS engine.log :

Can't exec "/sbin/portmap": No such file or directory at
/opt/VRTSvcs/bin/ApplicationNone/CNFS.pm line 353.
mount: nfsd already mounted or /proc/fs/nfsd busy
mount: according to mtab, nfsd is already mounted on
/proc/fs/nfsdfs.nfs.nlm_grace_period = 90 Can't exec "rpc.lockd": No such file
or directory at /opt/VRTSvcs/bin/ApplicationNone/CNFS.pm line 268.

DESCRIPTION:
Reason for above 3 different error messages seen is described below:
1] Can't exec "/sbin/portmap" error message : portmap service is not available
in RHEL6 and is replaced by "rpcbind".
2] Can't exec "rpc.lockd" error message :  This daemon was required for NFS file
locking. This daemon is not separately available in RHEL6. 
This functionality is now moved in RHEL6 kernel. 
3] mount error messages : It was due to incorrect remount of 'nfsd' while
starting a VCS agent.

RESOLUTION:
Now RPC bind service is used instead of 'portmap' service. 'rpc.lockd' is not
used as NFS file locking functionality is available in kernel itself. Now
incorrect remounting of 'nfsd' has been corrected.


INSTALLING THE PATCH
--------------------
(RHEL5_x86_64)
# rpm -Uvh VRTScavf-5.1.132.100-SP1RP2P2_RHEL5.i386.rpm
(RHEL6_x86_64)
# rpm -Uvh VRTScavf-5.1.132.100-SP1RP2P2_RHEL6.i386.rpm
(SLES10 x86_64)
# rpm -Uvh VRTScavf-5.1.132.100-SP1RP2P2_SLES10.i386.rpm
(SLES11 x86_64)
# rpm -Uvh VRTScavf-5.1.132.100-SP1RP2P2_SLES11.i386.rpm


REMOVING THE PATCH
------------------
rpm -e rpm_name


SPECIAL INSTRUCTIONS
--------------------
NONE


OTHERS
------
NONE