* * * READ ME * * * * * * Symantec Storage Foundation HA 6.2.1 * * * * * * Patch 100 * * * Patch Date: 2015-08-26 Note: ---- The CPI Installer of this patch was updated on Dec. 6, 2016 to fixed the following issue. Incident: 3893547 ONE_LINE_ABSTRACT: Veritas product installation fails for the new operating system (OS) update version since the installer cannot validate the correct version of dependency Operating System (OS) rpms for the new OS update. SYMPTOM: Veritas product installation failed for the new OS update version. DESCRIPTION: During installation, the installer verifies the dependency rpms of OS for the product. For the new OS update version, there is no defined or set dependency rpms value. Hence, the product installation fails or the installer displays incorrect versions of OS rpms. RESOLUTION: Set a default dependency OS rpms for each platform (RHEL6, RHEL7, SLES11, and SLES12) and for each release. Remove the specific version for each rpm, just keep the rpm name and architecture type, like: glibc.x86_64. 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 ---------- Symantec Storage Foundation HA 6.2.1 Patch 100 OPERATING SYSTEMS SUPPORTED BY THE PATCH ---------------------------------------- RHEL6 x86-64 PACKAGES AFFECTED BY THE PATCH ------------------------------ VRTSamf VRTSdbac VRTSgab VRTSllt VRTSvxfen BASE PRODUCT VERSIONS FOR THE PATCH ----------------------------------- * Symantec Application HA 6.2 * Symantec Cluster Server 6.2 * Symantec Storage Foundation Cluster File System HA 6.2 * Symantec Storage Foundation for Oracle RAC 6.2 * Symantec Storage Foundation HA 6.2 SUMMARY OF INCIDENTS FIXED BY THE PATCH --------------------------------------- Patch ID: VRTSamf-6.2.1.100-RHEL6 * 3794201 (3794154) Veritas Cluster Server (VCS) does not support Red Hat Enterprise Linux 6 Update 7 (RHEL6.7). Patch ID: VRTSllt-6.2.1.100-RHEL6 * 3794201 (3794154) Veritas Cluster Server (VCS) does not support Red Hat Enterprise Linux 6 Update 7 (RHEL6.7). Patch ID: VRTSgab-6.2.1.100-RHEL6 * 3794201 (3794154) Veritas Cluster Server (VCS) does not support Red Hat Enterprise Linux 6 Update 7 (RHEL6.7). Patch ID: VRTSvxfen-6.2.1.100-RHEL6 * 3794201 (3794154) Veritas Cluster Server (VCS) does not support Red Hat Enterprise Linux 6 Update 7 (RHEL6.7). Patch ID: VRTSdbac-6.2.0.100-RHEL6 * 3831495 (3845021) 6.2.0 vcsmm module does not load with RHEL6.7 (2.6.32-565.el6.x86_64 kernel) DETAILS OF INCIDENTS FIXED BY THE PATCH --------------------------------------- This patch fixes the following incidents: Patch ID: VRTSamf-6.2.1.100-RHEL6 * 3794201 (Tracking ID: 3794154) SYMPTOM: Veritas Cluster Server (VCS) does not support Red Hat Enterprise Linux 6 Update 7 (RHEL6.7). DESCRIPTION: VCS did not support RHEL versions released after RHEL6 Update 6. RESOLUTION: VCS support for Red Hat Enterprise Linux 6 Update 7 (RHEL6.7) is now introduced. Patch ID: VRTSllt-6.2.1.100-RHEL6 * 3794201 (Tracking ID: 3794154) SYMPTOM: Veritas Cluster Server (VCS) does not support Red Hat Enterprise Linux 6 Update 7 (RHEL6.7). DESCRIPTION: VCS did not support RHEL versions released after RHEL6 Update 6. RESOLUTION: VCS support for Red Hat Enterprise Linux 6 Update 7 (RHEL6.7) is now introduced. Patch ID: VRTSgab-6.2.1.100-RHEL6 * 3794201 (Tracking ID: 3794154) SYMPTOM: Veritas Cluster Server (VCS) does not support Red Hat Enterprise Linux 6 Update 7 (RHEL6.7). DESCRIPTION: VCS did not support RHEL versions released after RHEL6 Update 6. RESOLUTION: VCS support for Red Hat Enterprise Linux 6 Update 7 (RHEL6.7) is now introduced. Patch ID: VRTSvxfen-6.2.1.100-RHEL6 * 3794201 (Tracking ID: 3794154) SYMPTOM: Veritas Cluster Server (VCS) does not support Red Hat Enterprise Linux 6 Update 7 (RHEL6.7). DESCRIPTION: VCS did not support RHEL versions released after RHEL6 Update 6. RESOLUTION: VCS support for Red Hat Enterprise Linux 6 Update 7 (RHEL6.7) is now introduced. Patch ID: VRTSdbac-6.2.0.100-RHEL6 * 3831495 (Tracking ID: 3845021) SYMPTOM: VRTSdbac patch version does not work with RHEL6.7 (2.6.32-565.el6.x86_64 kernel) and is unable to load the vcsmm module on RHEL6.7. DESCRIPTION: Installation of VRTSdbac patch version 6.2.0 fails on RHEL6.7 as the VCSMM module is not available on RHEL6.7 kernel 2.6.32-565.el6.x86_64. The system log file logs the following messages: Starting VCSMM: ERROR: No appropriate modules found. Error in loading module "vcsmm". See documentation. Error : VCSMM driver could not be loaded. Error : VCSMM could not be started. Error : VCSMM could not be started. RESOLUTION: The VRTSdbac package is re-compiled with RHEL6.7 kernel in the build environment to mitigate the failure. 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 sfha-rhel6.7_x86_64-Patch-6.2.1.100.tar.gz to /tmp 2. Untar sfha-rhel6.7_x86_64-Patch-6.2.1.100.tar.gz to /tmp/hf # mkdir /tmp/hf # cd /tmp/hf # gunzip /tmp/sfha-rhel6.7_x86_64-Patch-6.2.1.100.tar.gz # tar xf /tmp/sfha-rhel6.7_x86_64-Patch-6.2.1.100.tar 3. Install the hotfix(Please be noted that the installation of this P-Patch will cause downtime.) # pwd /tmp/hf # ./installSFHA621P1 [ ...] You can also install this patch together with 6.2.1 maintenance release using Install Bundles 1. Download this patch and extract it to a directory 2. Change to the Veritas InfoScale 6.2.1 directory and invoke the installmr script with -patch_path option where -patch_path should point to the patch directory # ./installmr -patch_path [] [ ...] Install the patch manually: -------------------------- Perform the following steps on the node on which this patch is being applied: 1. Take backup of your configurations 2. Stop VCS 3. Install the patch 4. Restart VCS on the node Stopping VCS on the cluster node -------------------------------- 1. Ensure that the "/opt/VRTSvcs/bin" directory is included in your PATH environment variable so that you can execute all the VCS commands. Refer to Veritas Cluster Server Installation Guide for more information. 2. Freeze all the service groups persistently. # haconf -makerw # hagrp -freeze [group] -persistent 3. If the cluster is writable, you may close the configuration before stopping the cluster. Stop the cluster on this node: # haconf -dump -makero run the following command: # hastop -local Verify that the cluster is stopped by running the ha command: # hasys -state make sure that both had and hashadow processes are stopped. Also, stop the VCS CmdServer: # CmdServer -stop 4. Stop the cluster services in order: - For AMF: # /etc/init.d/amf stop - For VxFEN: # /etc/init.d/vxfen stop - For GAB: # /etc/init.d/gab stop - For LLT # /etc/init.d/llt stop Note: Stop any other services depending on GAB Installing the Patch -------------------- 1. Un-compress the downloaded patch from Symantec and change the directory to the uncompressed patch location. Install the patch using the following command: - For LLT: # rpm -Uvh VRTSllt-6.2.1.100-RHEL6.x86_64.rpm - For GAB: # rpm -Uvh VRTSgab-6.2.1.100-RHEL6.x86_64.rpm - For VxFEN: # rpm -Uvh VRTSvxfen-6.2.1.100-RHEL6.x86_64.rpm - For AMF: # rpm -Uvh VRTSamf-6.2.1.100-RHEL6.x86_64.rpm - For RAC: # rpm -Uvh VRTSdbac-6.2.0.100-RHEL6.x86_64.rpm 2. Run the following command to verify if the new patch has been installed: - For LLT: # rpm -q VRTSllt - For GAB: # rpm -q VRTSgab - For VxFEN: # rpm -q VRTSvxfen - For AMF: # rpm -q VRTSamf - For RAC: # rpm -q VRTSdbac If the proper patch is installed, the following output is displayed: - For LLT: VRTSllt-6.2.1.100-RHEL6 - For GAB: VRTSgab-6.2.1.100-RHEL6 - For VxFEN: VRTSvxfen-6.2.1.100-RHEL6 - For AMF: VRTSamf-6.2.1.100-RHEL6 - For RAC: VRTSdbac-6.2.0.100-RHEL6 Re-starting the cluster services: -------------------------------- 1. To start the cluster services in order run the following command: - For LLT: # /etc/init.d/llt start - For GAB: # /etc/init.d/gab start - For VxFEN: # /etc/init.d/vxfen start - For AMF: # /etc/init.d/amf start - For VCS: # hastart # /opt/VRTSvcs/bin/CmdServer 2. Make VCS cluster writable: # haconf -makerw 3. Unfreeze all the groups: # hagrp -unfreeze [group] -persistent # haconf -dump -makero REMOVING THE PATCH ------------------ Removal of the patch will result in removing the whole package from the system/node. To go back to a previous installed version of the package, you may need to re-install the package. Run the following steps on the node where the patch is being uninstalled: To remove the patch from a cluster node: --------------------------------------------- 1. Freeze all the service groups persistently. # haconf -makerw # hagrp -freeze [group] -persistent 2. Stop VCS on the node by running the following command: - Follow the stop sequence as mentioned in the PATCH INSTALLATION section. 3. Remove the patch by using the following command: - For LLT: # rpm -e VRTSllt - For GAB: # rpm -e VRTSgab - For VxFEN: # rpm -e VRTSvxfen - For AMF: # rpm -e VRTSamf 4. Verify that the patch has been removed from the system: - For LLT: # rpm -qa|grep VRTSllt - For GAB: # rpm -qa|grep VRTSgab - For VxFEN: # rpm -qa|grep VRTSvxfen - For AMF: # rpm -qa|grep VRTSamf Ensure that the package is not be displayed. This confirms that the package is removed. 5. Install the relevant package from the VCS base media. Also refer to SORT for any applicable patches. 6. To start the cluster service, run the following command first on one node: - Follow the start sequence as mentioned in the PATCH INSTALLATION section. 7. Unfreeze all the groups. # hagrp -unfreeze [group] -persistent # haconf -dump -makero SPECIAL INSTRUCTIONS -------------------- NONE OTHERS ------ NONE