* * * READ ME * * * * * * Veritas Oracle Disk Manager 6.0.5 * * * * * * Patch 6.0.5.400 * * * Patch Date: 2016-02-24 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 Oracle Disk Manager 6.0.5 Patch 6.0.5.400 OPERATING SYSTEMS SUPPORTED BY THE PATCH ---------------------------------------- Solaris 11 X64 PACKAGES AFFECTED BY THE PATCH ------------------------------ VRTSodm BASE PRODUCT VERSIONS FOR THE PATCH ----------------------------------- * Symantec VirtualStore 6.0.1 * Veritas Storage Foundation 6.0.1 * Veritas Storage Foundation Cluster File System HA 6.0.1 * Veritas Storage Foundation for Oracle RAC 6.0.1 * Veritas Storage Foundation HA 6.0.1 SUMMARY OF INCIDENTS FIXED BY THE PATCH --------------------------------------- Patch ID: 6.0.500.400 * 3799901 (3451730) Installation of VRTSodm, VRTSvxfs in a zone fails when running zoneadm -z Zone attach -U Patch ID: 6.0.500.100 * 3515842 (3481825) The system is unable to turn off the vxodm service only for Smart Flash Cache. The system panics when it attempts to use the ZFS raw. * 3544831 (3525858) The system panics when the Oracle Disk Manager (ODM) device (/dev/odm) is mounted in a Solaris Zone. Patch ID: 6.0.500.000 * 3322294 (3323866) Some ODM operations may fail with "ODM ERROR V-41-4-1-328-22 Invalid argument" Patch ID: 6.0.300.000 * 3018873 (3018869) On Solaris 11 update 1 fsadm command shows that the mountpoint is not a vxfs file system DETAILS OF INCIDENTS FIXED BY THE PATCH --------------------------------------- This patch fixes the following Symantec incidents: Patch ID: 6.0.500.400 * 3799901 (Tracking ID: 3451730) SYMPTOM: Installation of VRTSodm, VRTSvxfs in a zone fails when running zoneadm -z Zoneattach -U DESCRIPTION: When you upgrade a zone using attach U option, the checkinstall script is executed. There were certain zone-irrelevant commands (which should not be executed during attach) in the checkinstall script which failed the installation of VRTSodm, VRTSvxfs. RESOLUTION: Code is added in the postinstall script to fix the checkinstall script. Patch ID: 6.0.500.100 * 3515842 (Tracking ID: 3481825) SYMPTOM: The panic stack is like this: unix:panicsys unix:vpanic_common unix:panic unix:die unix:trap unix:ktl0 zfs:dmu_objset_spa zvol_ioctl specfs:spec_ioctl genunix:fop_ioctl odm:odm_raw_check odm:odm_identify odm:odmioctl genunix:fop_ioctl DESCRIPTION: The odm_raw_check()function calls fop_ioctl() without first opening the zvol folder. RESOLUTION: Symantec has disabled Oracle Disk Manager (ODM)for Solaris on non-VxVM raw devices. * 3544831 (Tracking ID: 3525858) SYMPTOM: The system panics in the odmmount_getzid() function with the following stack: odm:odmmount_getzid () odm:odmroot_zone () odm:odmroot() genunix:fsop_root( genunix:lookuppnvp() genunix:lookuppnat() genunix:lookupnameat() genunix:cstatat_getvp() genunix:cstatat64_32() unix:syscall_trap32() DESCRIPTION: Whenever /dev/odm is mounted inside a zone, ODM maintains information for that mount in a linked list of elements - each element representing a zone mount. This linked list gets corrupted if zones are unmounted simultaneously, due to a race condition. When such a list is referred to during subsequent zone mounts, it leads to panic. RESOLUTION: Symantec has fixed the race condition in odmmount_putentry() called from the ODM zone umount code paths. Patch ID: 6.0.500.000 * 3322294 (Tracking ID: 3323866) SYMPTOM: Some ODM operations may fail with the following error: ODM ERROR V-41-4-1-328-22 Invalid argument DESCRIPTION: On systems having heavy database activity using ODM some operations may fail an error. This is a corner case and it occurs when a new task enters in ODM. To avoid deadlocks ODM maintains two lists of tasks viz. hold list and deny list. All the active tasks are maintained in the hold list and the task that are being exited from ODM are stored in the deny list. The error is returned when the ODM PID structure gets re-used for a PID that is still being exited from the ODM and is there in the deny list in that case ODM don't allow the task to enter in the ODM and above error is returned. RESOLUTION: The code is modified such as to add an extra check while adding a new task in ODM to avoid returning the error in such scenarios. Patch ID: 6.0.300.000 * 3018873 (Tracking ID: 3018869) SYMPTOM: fsadm command shows that the mountpoint is not a vxfs file system DESCRIPTION: The Solaris11 update1 has some changes in function fstatvfs() [VFS layer] which breaks VxFS's previous assumptions. The statvfs.f_basetype gets populated with some garbage value instead of "vxfs". So, during the fsadm, when we check for the file system type, the check fails and so we get the error. RESOLUTION: Made changes to fetch correct value for fstype using OS provided API's so that the statvfs.f_basetype field gets valid i.e. "vxfs" value. 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 odm-sol11_x64-Patch-6.0.5.400.tar.gz to /tmp 2. Untar odm-sol11_x64-Patch-6.0.5.400.tar.gz to /tmp/hf # mkdir /tmp/hf # cd /tmp/hf # gunzip /tmp/odm-sol11_x64-Patch-6.0.5.400.tar.gz # tar xf /tmp/odm-sol11_x64-Patch-6.0.5.400.tar 3. Install the hotfix # pwd /tmp/hf # ./installODM605P4 [ ...] You can also install this patch together with 6.0.1 GA release and 6.0.5 Patch release # ./installODM605P4 -base_path [<601 path>] -mr_path [<605 path>] [ ...] where the -mr_path should point to the 6.0.5 image directory, while -base_path to the 6.0.1 image. Install the patch manually: -------------------------- 1. pkg uninstall VRTSodm 2. pkg unset-publisher Symantec 3. pkg unset-publisher Veritas 4. pkg set-publisher -g Veritas 5. pkg install --accept -g VRTSodm REMOVING THE PATCH ------------------ 1. pkg uninstall VRTSodm SPECIAL INSTRUCTIONS -------------------- NONE OTHERS ------ NONE