* * * READ ME * * * * * * Veritas File System 6.0.1 * * * * * * Public Hot Fix 2 * * * Patch Date: 2012-09-18 This document provides the following information: * PATCH NAME * OPERATING SYSTEMS SUPPORTED BY THE PATCH * PACKAGES AFFECTED BY THE PATCH * BASE PRODUCT VERSIONS FOR THE PATCH * SUMMARY OF INCIDENTS FIXED BY THE PATCH * DETAILS OF INCIDENTS FIXED BY THE PATCH * INSTALLATION PRE-REQUISITES * INSTALLING THE PATCH * REMOVING THE PATCH PATCH NAME ---------- Veritas File System 6.0.1 Public Hot Fix 2 OPERATING SYSTEMS SUPPORTED BY THE PATCH ---------------------------------------- AIX 6.1 AIX 7.1 PACKAGES AFFECTED BY THE PATCH ------------------------------ VRTSvxfs BASE PRODUCT VERSIONS FOR THE PATCH ----------------------------------- * Veritas Storage Foundation for Oracle RAC 6.0.1 * Veritas Storage Foundation Cluster File System 6.0.1 * Veritas Storage Foundation 6.0.1 * Veritas Storage Foundation High Availability 6.0.1 * Symantec VirtualStore 6.0.1 SUMMARY OF INCIDENTS FIXED BY THE PATCH --------------------------------------- Patch ID: 6.0.100.200 * 2912412 (2857629) File system corruption can occur requiring a full fsck of the system. * 2912435 (2885592) vxdump to the vxcompress file system is aborted * 2923805 (2590918) Delay in freeing unshared extents upon primary switch over. DETAILS OF INCIDENTS FIXED BY THE PATCH --------------------------------------- This patch fixes the following Symantec incidents: Patch ID: 6.0.100.200 * 2912412 (Tracking ID: 2857629) SYMPTOM: When a new node takes over a primary for the file system, it could process stale shared extent records in a per node queue. The primary will detect a bad record and set the full fsck flag. It will also disable the file system to prevent further corruption. DESCRIPTION: Every node in the cluster that adds or removes references to shared extents, adds the shared extent records to a per node queue. The primary node in the cluster processes the records in the per node queues and maintains reference counts in a global shared extent device. In certain cases the primary node might process bad or stale records in the per node queue. Two situations under which bad or stale records could be processed are: 1. clone creation initiated from a secondary node immediately after primary migration to different node. 2. queue wraparound on any node and take over of primary by new node immediately afterwards. Full fsck might not be able to rectify the file system corruption. RESOLUTION: Update the per node shared extent queue head and tail pointers to correct values on primary before starting processing of shared extent records. * 2912435 (Tracking ID: 2885592) SYMPTOM: vxdump of a file system which is compressed using vxcompress is aborted. DESCRIPTION: vxdump is aborted due to malloc() failure. malloc()fails due to a memory leak in vxdump command code while handling compressed extents. RESOLUTION: Fixed the memory leak. * 2923805 (Tracking ID: 2590918) SYMPTOM: Upon new node in the cluster taking over as primary of the file system, there might be a significant delay in freeing up unshared extents. This problem can occur only in the case when shared extent addition or deletions occurred immediately after primary switch over to different node in the cluster. DESCRIPTION: When a new node in the cluster takes over as primary for the file system, a file system thread in the new primary performs a full scan of the shared extent device file to free up any shared extents that have become completely unshared. If heavy shared extent related activity such as additional sharing or unsharing of extents were to occur anywhere in the cluster while the full scan was being performed, the full scan could get interrupted. Due to a bug, the full scan is marked as completed and scheduled further scans of the shared extent device are partial scans. This will cause a substantial delay in freeing up some of the unshared extents in the device file. RESOLUTION: If the first full scan of shared extent device upon primary takeover gets interrupted, then do not mark the full scan as complete. INSTALLING THE PATCH -------------------- If the currently installed VRTSvxfs is below 6.0.100.000, you must upgrade VRTSvxfs to 6.0.100.000 level before installing this patch. AIX maintenance levels and APARs can be downloaded from the IBM Web site: http://techsupport.services.ibm.com Install the VRTSvxfs.bff patch if VRTSvxfs is already installed at fileset level 6.0.100.000 A system reboot is required after installing this patch. The VRTSvxfs.bff patch may be installed either manually (see below) or using the included installer. * To apply patch using the installer, enter these commands: # cd && ./installFS601P2 * To apply the patch manually, first unmount all VxFS file systems, then enter these commands: # mount | grep vxfs # STOP if this produces output # cd /patches # installp -aXd VRTSvxfs.bff VRTSvxfs # reboot REMOVING THE PATCH ------------------ A system reboot is required after removing this patch. The VRTSvxfs.bff patch may be removed either manually (see below) or using the uninstall script created during installation. * To remove patch using the uninstall script, enter these commands: # cd /opt/VRTS/install && ./uninstallFS601P2 * To remove the patch manually, first unmount all VxFS file systems, then enter these commands: # mount | grep vxfs # STOP if this produces output # installp -r VRTSvxfs # reboot SPECIAL INSTRUCTIONS -------------------- NONE OTHERS ------ NONE