* * * READ ME * * * * * * Cluster Server Agent Extension for SFCFS Distribution 5.1 SP1 RP2 * * * * * * P-patch 1 * * * 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 RP2 P-patch 1 PACKAGES AFFECTED BY THE PATCH ------------------------------ VRTScavf BASE PRODUCT VERSIONS FOR THE PATCH ----------------------------------- * Veritas Storage Foundation for Oracle RAC 5.1 SP1 * Veritas Storage Foundation Cluster File System 5.1 SP1 OPERATING SYSTEMS SUPPORTED BY THE PATCH ---------------------------------------- AIX 5.3 AIX 6.1 AIX 7.1 INCIDENTS FIXED BY THE PATCH ---------------------------- This patch fixes the following Symantec incidents: Patch ID: 5.1.112.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. INSTALLING THE PATCH -------------------- If the currently installed VRTScavf is below 5.1.112.0 level / AIX maintenance levels and APARs can be downloaded from the IBM Web site: http://techsupport.services.ibm.com Install the VRTScavf.bff patch if VRTScavf is already installed at fileset level 5.1.112.0 To apply the patch, enter these commands: # mount | grep cavf # cd # installp -aXd VRTScavf.bff VRTScavf # reboot REMOVING THE PATCH ------------------ If you need to remove the patch, enter these commands: # mount | grep cavf # installp -r VRTScavf # reboot SPECIAL INSTRUCTIONS -------------------- NONE OTHERS ------ NONE