* * * READ ME * * * * * * InfoScale 7.1 * * * * * * Patch 200 * * * Patch Date: 2017-03-15 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 * KNOWN ISSUES PATCH NAME ---------- InfoScale 7.1 Patch 200 OPERATING SYSTEMS SUPPORTED BY THE PATCH ---------------------------------------- SLES12 x86-64 PACKAGES AFFECTED BY THE PATCH ------------------------------ VRTSamf VRTSaslapm VRTSdbac VRTSgab VRTSglm VRTSgms VRTSllt VRTSodm VRTSveki VRTSvxfen VRTSvxfs VRTSvxvm BASE PRODUCT VERSIONS FOR THE PATCH ----------------------------------- * InfoScale Availability 7.1 * InfoScale Enterprise 7.1 * InfoScale Foundation 7.1 * InfoScale Storage 7.1 SUMMARY OF INCIDENTS FIXED BY THE PATCH --------------------------------------- Patch ID: VRTSvxvm-7.1.0.200-SLES12 * 3912415 (3907800) VxVM package installation will fail on SLES12 SP2. * 3912593 (3909944) System may hang with soft lockup issue while using SmartIO read cache for VxVM (Veritas Volume Manager) volumes under heavy IO load. * 3912642 (3913298) System may panic while running vxstat in CVM (Clustered Volume Manager) environment. Patch ID: VRTSvxfs-7.1.0.200-SLES12 * 3911967 (3911966) VxFS module failed to load on SLES12 SP2. Patch ID: VRTSodm-7.1.0.200-SLES12 * 3911963 (3907933) ODM module failed to load on SLES12 SP2. Patch ID: VRTSdbac-7.1.0.200-SLES12 * 3902533 (3913168) Veritas Oracle Real Application Cluster does not support SUSE Linux Enterprise Server 12 Service Pack 2 (SLES 12 SP2). Patch ID: VRTSamf-7.1.0.200-SLES12 * 3897035 (3896875) Veritas Infoscale Availability (VCS) does not support SUSE Linux Enterprise Server 12 Service Pack 2 (SLES 12 SP2). Patch ID: VRTSvxfen-7.1.0.400-SLES12 * 3897027 (3896875) Veritas Infoscale Availability (VCS) does not support SUSE Linux Enterprise Server 12 Service Pack 2 (SLES 12 SP2). Patch ID: VRTSvxfen-7.1.0.100-SLES12 * 3879189 (3878333) In SCSI-3 mode, I/O fencing fails to automatically refresh registrations on coordination disks. Patch ID: VRTSgab-7.1.0.400-SLES12 * 3896902 (3896875) Veritas Infoscale Availability (VCS) does not support SUSE Linux Enterprise Server 12 Service Pack 2 (SLES 12 SP2). Patch ID: VRTSgab-7.1.0.100-SLES12 * 3893802 (3893801) In some cases, when a node joins a large cluster, few GAB directed messages are delivered in the wrong order. Patch ID: VRTSllt-7.1.0.500-SLES12 * 3896880 (3896875) Veritas Infoscale Availability (VCS) does not support SUSE Linux Enterprise Server 12 Service Pack 2 (SLES 12 SP2). Patch ID: VRTSgms-7.1.0.200-SLES12 * 3911960 (3907939) GMS module failed to load on SLES12 SP2. Patch ID: VRTSglm-7.1.0.200-SLES12 * 3911958 (3907936) GLM module failed to load on SLES12 SP2. Patch ID: VRTSveki-7.1.0.200-SLES12 * 3913506 (3913507) VEKI module failed to load on SLES12 SP2. Patch ID: VRTSvxfs-7.1.0.300 * 3916082 (3916611) Rearranging the ->followlink() and ->putlink code and fixing memory leak issue in vx_followlink(). * 3915630 (3906548) Start up vxfs after local file system mounted with rw through systemd. * 3915631 (3915578) vxfs module is failed to load after reboot. DETAILS OF INCIDENTS FIXED BY THE PATCH --------------------------------------- This patch fixes the following incidents: Patch ID: VRTSvxvm-7.1.0.200-SLES12 * 3912415 (Tracking ID: 3907800) SYMPTOM: VxVM package installation will fail on SLES12 SP2. DESCRIPTION: Since SLES12 SP2 has lot of kernel changes, package installation fails. Added code changes to provide SLES12 SP2 platform support for VxVM. RESOLUTION: Added code changes to provide SLES12 SP2 platform support. * 3912593 (Tracking ID: 3909944) SYMPTOM: System may hang with soft lockup issue while using SmartIO read cache for VxVM (Veritas Volume Manager) volumes under heavy IO load with following stack: _raw_spin_unlock_irqrestore vol_cache_evac_start voliod_iohandle voliod_loop kthread ret_from_fork DESCRIPTION: When IO load is high, SmartIO cache evacuation thread may not progress till the IO count on the cache object becomes zero. In turn, the IO threads on the volumes may not progress further because the SmartIO cache evacuation thread continuously gets rescheduled. As these threads are waiting for each other to progress, a deadlock situation may arise. RESOLUTION: The code is fixed to avoid the deadlock situation between the threads. * 3912642 (Tracking ID: 3913298) SYMPTOM: While running vxstat in CVM (Clustered Volume Manager) environment, system may panic with following stack: machine_kexec __crash_kexec crash_kexec oops_end no_context do_page_fault page_fault [exception RIP: vol_cvm_io_stats_common+143] __wake_up_common __wake_up_sync_key unix_destruct_scm __alloc_pages_nodemask volinfo_ioctl volsioctl_real vols_ioctl at vols_unlocked_ioctl do_vfs_ioctl sys_ioctl entry_SYSCALL_64_fastpath DESCRIPTION: The system panic occurs because while fetching the IO statistics from the VxVM (Veritas Volume Manager) kernel, an illegal address in the IO stats data is accessed which is not yet populated. RESOLUTION: The code is fixed to correctly populate the address in the IO stats data before fetching the IO stats. Patch ID: VRTSvxfs-7.1.0.200-SLES12 * 3911967 (Tracking ID: 3911966) SYMPTOM: VxFS module failed to load on SLES12 SP2. DESCRIPTION: Since SLES12 SP2 is new release therefore VxFS module failed to load on it. RESOLUTION: Added VxFS support for SLES12 SP2. Patch ID: VRTSodm-7.1.0.200-SLES12 * 3911963 (Tracking ID: 3907933) SYMPTOM: ODM module failed to load on SLES12 SP2. DESCRIPTION: Since SLES12 SP2 is new release therefore ODM module failed to load on it. RESOLUTION: Added ODM support for SLES12 SP2. Patch ID: VRTSdbac-7.1.0.200-SLES12 * 3902533 (Tracking ID: 3913168) SYMPTOM: Veritas Oracle Real Application Cluster does not work with SUSE Linux Enterprise Server 12 Service Pack 2 (SLES 12 SP2) and is unable to load the vcsmm module . DESCRIPTION: Veritas Oracle Real Application Cluster did not support SUSE Linux Enterprise Server versions released after SLES 12 SP1. RESOLUTION: Veritas Oracle Real Application Cluster support for SUSE Linux Enterprise Server 12 SP2 is now introduced. Patch ID: VRTSamf-7.1.0.200-SLES12 * 3897035 (Tracking ID: 3896875) SYMPTOM: Veritas Infoscale Availability (VCS) does not support SUSE Linux Enterprise Server 12 Service Pack 2 (SLES 12 SP2). DESCRIPTION: Veritas Infoscale Availability did not support SUSE Linux Enterprise Server versions released after SLES 12 SP1. RESOLUTION: Veritas Infoscale Availability support for SUSE Linux Enterprise Server 12 SP2 is now introduced. Patch ID: VRTSvxfen-7.1.0.400-SLES12 * 3897027 (Tracking ID: 3896875) SYMPTOM: Veritas Infoscale Availability (VCS) does not support SUSE Linux Enterprise Server 12 Service Pack 2 (SLES 12 SP2). DESCRIPTION: Veritas Infoscale Availability did not support SUSE Linux Enterprise Server versions released after SLES 12 SP1. RESOLUTION: Veritas Infoscale Availability support for SUSE Linux Enterprise Server 12 SP2 is now introduced. Patch ID: VRTSvxfen-7.1.0.100-SLES12 * 3879189 (Tracking ID: 3878333) SYMPTOM: With I/O fencing in SCSI-3 mode, if you enable the auto-refresh feature on the CoordPoint agent, then I/O fencing fails to automatically refresh registrations on the coordination points. This results in vxfen group to remain in faulted state. DESCRIPTION: Even to refresh registration on coordination disks, the vxfenswap script expects inputs about coordination disk groups from the CoordPoint agent. The CoordPoint agent does not provide this information to the vxfenswap script. This causes the vxfenswap script to fail and the vxfen group remains faulted until it is manually cleared. RESOLUTION: The I/O fencing program is modified such that in SCSI3 mode fencing, the vxfenswap script does not explicitly require the coordination disk group information for refreshing registration keys on disks. Patch ID: VRTSgab-7.1.0.400-SLES12 * 3896902 (Tracking ID: 3896875) SYMPTOM: Veritas Infoscale Availability (VCS) does not support SUSE Linux Enterprise Server 12 Service Pack 2 (SLES 12 SP2). DESCRIPTION: Veritas Infoscale Availability did not support SUSE Linux Enterprise Server versions released after SLES 12 SP1. RESOLUTION: Veritas Infoscale Availability support for SUSE Linux Enterprise Server 12 SP2 is now introduced. Patch ID: VRTSgab-7.1.0.100-SLES12 * 3893802 (Tracking ID: 3893801) SYMPTOM: In large clusters, a node join for a gab port gets stuck. DESCRIPTION: When a node joins a cluster, a few GAB directed messages might be delivered in the incorrect order to the GAB clients. This incorrect message order is because of a bug in code where the messages are added to the GAB delivery queue in incorrect order. RESOLUTION: The program is modified to ensure that during a node join scenario, the GAB directed messages are inserted in the various GAB queues in the correct order. Patch ID: VRTSllt-7.1.0.500-SLES12 * 3896880 (Tracking ID: 3896875) SYMPTOM: Veritas Infoscale Availability (VCS) does not support SUSE Linux Enterprise Server 12 Service Pack 2 (SLES 12 SP2). DESCRIPTION: Veritas Infoscale Availability did not support SUSE Linux Enterprise Server versions released after SLES 12 SP1. RESOLUTION: Veritas Infoscale Availability support for SUSE Linux Enterprise Server 12 SP2 is now introduced. Patch ID: VRTSgms-7.1.0.200-SLES12 * 3911960 (Tracking ID: 3907939) SYMPTOM: GMS module failed to load on SLES12 SP2. DESCRIPTION: Since SLES12 SP2 is new release therefore GMS module failed to load on it. RESOLUTION: Added GMS support for SLES12 SP2. Patch ID: VRTSglm-7.1.0.200-SLES12 * 3911958 (Tracking ID: 3907936) SYMPTOM: GLM module failed to load on SLES12 SP2. DESCRIPTION: Since SLES12 SP2 is new release therefore GLM module failed to load on it. RESOLUTION: Added GLM support for SLES12 SP2. Patch ID: VRTSveki-7.1.0.200-SLES12 * 3913506 (Tracking ID: 3913507) SYMPTOM: VEKI module failed to load on SLES12 SP2. DESCRIPTION: Since SLES12 SP2 is new release therefore VEKI module failed to load on it. RESOLUTION: Added VEKI support for SLES12 SP2. Patch ID: VRTSvxfs-7.1.0.300 * 3916082 (Tracking ID: 3916611) SYMPTOM: Rearranging the ->followlink() and ->putlink code. Fixing memory leak issue in vx_followlink(). DESCRIPTION: As in SLES12 SP2 the ->followlink() and ->putlink() calling convention is changed. So writing a wrapper around existing followlink() and putlink() code and making it such that the same code will run for SLES12 SP2 as well as other Linux platforms. There was also a memory leak issue in vx_followlink(), this change fixed it as well. RESOLUTION: Rearranged the ->followlink() and putlink() code. * 3915630 (Tracking ID: 3906548) SYMPTOM: Read-only file system errors reported while loading drivers to start up vxfs through systemd. DESCRIPTION: On SLES system, vxfs starting up could be invoked by other systemd unit while root and local file system still not be mounted as read/write, in such case, Read- only file system errors could be reported during system start up. RESOLUTION: Start up vxfs after local file system mounted with rw through systemd, also delay vxfs file system mounting by add "_netdev" mount option in /etc/fstab. * 3915631 (Tracking ID: 3915578) SYMPTOM: vxfs module failing to load after reaboot with dmesg log: [ 3.689385] systemd-sysv-generator[518]: Overwriting existing symlink /run/systemd/generator.late/vxfs.service with real service. [ 4.738143] vxfs: Unknown symbol ki_get_boot (err 0) [ 4.793301] vxfs: Unknown symbol ki_get_boot (err 0) DESCRIPTION: The vxfs module is dependent on the veki module. During boot time, the veki is not loaded before vxfs. So the vxfs module fails to load. RESOLUTION: During boot the veki should start before loading vxfs module. INSTALLING THE PATCH -------------------- Run the Installer script to automatically install the patch: ----------------------------------------------------------- Please be noted that the installation of this P-Patch will cause downtime. To install the patch perform the following steps on at least one node in the cluster: 1. Copy the patch infoscale-sles12_x86_64-Patch-7.1.0.200.tar.gz to /tmp 2. Untar infoscale-sles12_x86_64-Patch-7.1.0.200.tar.gz to /tmp/hf # mkdir /tmp/hf # cd /tmp/hf # gunzip /tmp/infoscale-sles12_x86_64-Patch-7.1.0.200.tar.gz # tar xf /tmp/infoscale-sles12_x86_64-Patch-7.1.0.200.tar 3. Install the hotfix(Please be noted that the installation of this P-Patch will cause downtime.) # pwd /tmp/hf # ./installVRTSinfoscale710P200 [ ...] You can also install this patch together with 7.1 base release using Install Bundles 1. Download this patch and extract it to a directory 2. Change to the Veritas InfoScale 7.1 directory and invoke the installer script with -patch_path option where -patch_path should point to the patch directory # ./installer -patch_path [] [ ...] Install the patch manually: -------------------------- Manual installation is not supported. REMOVING THE PATCH ------------------ Manual uninstallation is not supported. KNOWN ISSUES ------------ * Tracking ID: 3913711 SYMPTOM: DMP native support may failed to be enabled on SLES12 SP2 with following error: # vxdmpadm settune dmp_native_support=on VxVM vxdmpadm ERROR V-5-1-15690 Operation failed for one or more volume groups VxVM vxdmpadm ERROR V-5-1-15686 The following vgs could not be migrated as error in bootloader configuration file - WORKAROUND: The work around for this issue is to ensure the default menu entry is set prior to enabling DMP native support. The default menu entry can be set using the command agrub2-set-default "SLES 12-SP2a. * Tracking ID: 3913715 SYMPTOM: Root disk encapsulation is NOT supported on SLES12 SP2. WORKAROUND: Currently there is NO work around for this issue. OTHERS ------ NONE