* * * READ ME * * * * * * Veritas File System 7.0 * * * * * * Patch 100 * * * Patch Date: 2015-08-13 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 7.0 Patch 100 OPERATING SYSTEMS SUPPORTED BY THE PATCH ---------------------------------------- RHEL7 x86-64 PACKAGES AFFECTED BY THE PATCH ------------------------------ VRTSvxfs BASE PRODUCT VERSIONS FOR THE PATCH ----------------------------------- * InfoScale Enterprise 7.0 * InfoScale Foundation 7.0 * InfoScale Storage 7.0 SUMMARY OF INCIDENTS FIXED BY THE PATCH --------------------------------------- Patch ID: 7.0.0.100 * 3790562 (3736398) NULL pointer dereference panic in lazy unmount. * 3807368 (3807366) The man pages included in the VRTSvxfs, VRTSfsadv and VRTSfssdk packages have an incorrect product version. * 3816107 (3812914) On RHEL 6.5 and RHEL 6.4 latest kernel patch, umount(8) system call hangs if an application watches for inode events using inotify(7) APIs. DETAILS OF INCIDENTS FIXED BY THE PATCH --------------------------------------- This patch fixes the following Symantec incidents: Patch ID: 7.0.0.100 * 3790562 (Tracking ID: 3736398) SYMPTOM: Panic in the lazy unmount path during deinit of VxFS-VxVM API. DESCRIPTION: The panic is caused when an exiting thread drops the last reference to a lazy-unmounted VxFS file-system where that fs is the last VxFS mount in the system. The exiting thread does unmount, which then calls into VxVM to de-initialize the private FS-VM API(as it is the last VxFS mounted fs). The function to be called in VxVM is looked-up via the files under /proc, this requires an opening of a file but the exit processing has removed the structs needed by the thread to open a file. RESOLUTION: The solution is to cache the de-init function (vx_fsvm_api_deinit) when the VxFS-VxVM API is initialized, so no function look-up is needed during an unmount. The cached function pointer can then be called during the last unmount bypassing the need to open the file by the exiting thread. * 3807368 (Tracking ID: 3807366) SYMPTOM: The man pages included in the VRTSvxfs, VRTSfsadv and VRTSfssdk packages identify the product version incorrectly as 6.2, instead of the correct 7.0. DESCRIPTION: Man pages included in the packages identify the product version they document. For the man pages included in the 7.0 release, this version was incorrectly mentioned as 6.2. The online versions of the man pages available from SORT have previously been updated to mention the correct version. RESOLUTION: The versions in the man pages have been corrected and updated man pages have been included in the packages. * 3816107 (Tracking ID: 3812914) SYMPTOM: On RHEL 6.5 and RHEL 6.4 latest kernel patch, umount(8) system call hangs if an application watches for inode events using inotify(7) APIs. DESCRIPTION: On RHEL 6.5 and RHEL 6.4 latest kernel patch, additional OS counters were added in the super block to track inotify Watches. These new counters were not implemented in VxFS for RHEL6.5/RHEL6.4 kernel. Hence, while doing umount, the operation hangs until the counter in the superblock drops to zero, which would never happen since they are not handled in VxFS. RESOLUTION: The code is modified to handle additional counters added in super block of RHEL6.5/RHEL6.4 latest kernel. INSTALLING THE PATCH -------------------- Run the Installer script to automatically install the patch: ----------------------------------------------------------- To install the patch perform the following steps on at least one node in the cluster: 1. Copy the patch fs-rhel7_x86_64-Patch-7.0.0.100.tar.gz to /tmp 2. Untar fs-rhel7_x86_64-Patch-7.0.0.100.tar.gz to /tmp/hf # mkdir /tmp/hf # cd /tmp/hf # gunzip /tmp/fs-rhel7_x86_64-Patch-7.0.0.100.tar.gz # tar xf /tmp/fs-rhel7_x86_64-Patch-7.0.0.100.tar 3. Install the hotfix # pwd /tmp/hf # ./installVRTSvxfs700P100 [ ...] Install the patch manually: -------------------------- rpm -Uvh VRTSvxfs-7.0.0.100-RHEL7.x86_64.rpm REMOVING THE PATCH ------------------ rpm -e rpm_name SPECIAL INSTRUCTIONS -------------------- NONE OTHERS ------ NONE