* * * READ ME * * * * * * Veritas Cluster Server 5.1 SP1 * * * * * * P-patch 1 * * * Patch Date: 2011-08-22 This document provides the following information: * PATCH NAME * PACKAGES AFFECTED BY THE PATCH * BASE PRODUCT VERSIONS FOR THE PATCH * OPERATING SYSTEMS SUPPORTED BY THE PATCH * INCIDENTS FIXED BY THE PATCH * INSTALLATION PRE-REQUISITES * INSTALLING THE PATCH * REMOVING THE PATCH PATCH NAME ---------- Veritas Cluster Server 5.1 SP1 P-patch 1 PACKAGES AFFECTED BY THE PATCH ------------------------------ VRTSgab BASE PRODUCT VERSIONS FOR THE PATCH ----------------------------------- * Veritas Cluster Server 5.1 SP1 * Veritas Storage Foundation for Oracle RAC 5.1 SP1 * Veritas Storage Foundation Cluster File System 5.1 SP1 * Veritas Storage Foundation High Availability 5.1 SP1 OPERATING SYSTEMS SUPPORTED BY THE PATCH ---------------------------------------- AIX INCIDENTS FIXED BY THE PATCH ---------------------------- This patch fixes the following Symantec incidents: Patch ID: 5.1.100.100 * 2508637 (Tracking ID: 2508633) SYMPTOM: If the GAB driver fails to unload due to a device removal error on a system, and if you repeatedly try to unload the GAB driver, the system crashes. DESCRIPTION: When the GAB driver fails to unload due to the device removal error, the GAB module deletes its data structures without checking for the device removal error. If you try to unload the GAB driver again, the GAB module attempts to access the deleted data structures, and the system crashes. RESOLUTION: Symantec has modified the GAB module to check for the device removal error. If the check fails, the module does not delete its data structures, and the system crash is prevented. INSTALLING THE PATCH -------------------- Patch Installation Instructions: -------------------------------- PACKAGES AFFECTED BY THE PATCH ------------------------------- This patch updates the following VCS package(s) VRTSgab from 5.1.100.0 to 5.1.100.100 INSTALLING THE PATCH IN THE VCS ENVIRONMENT --------------------------------------- Execute the following steps on all the nodes in the VCS cluster: Stopping VCS on the cluster node -------------------------------- 1. Take offline all applications, which are configured on CVM/CFS and are outside VCS control. After you take offline all applications that use CFS and CVM, run 'slibclean' to unload the libraries from memory. 2. Stop VCS on the current node: # /opt/VRTSvcs/bin/hastop -local Verify that ports 'f' (CFS), 'v' and 'w' (CVM), and 'h' (VCS) are closed: # /sbin/gabconfig -a The display must not include port 'f', 'v', 'w' and 'h'. 3. Unconfigure VxFEN if configured: # /etc/init.d/vxfen.rc stop 4. Unconfigure GAB if configured: # /etc/init.d/gab.rc stop 5. Unload the GAB driver: # /etc/methods/gabkext -stop 6. Verify that the GAB driver is unloaded: # /etc/methods/gabkext -status Installing the patch --------------------------- 1. Un-compress the patch downloaded from Symantec. Change directory to the unzipped patch location. Install the VRTSgab (5.1.100.100) patch by using the following command: # installp -a -d [extract dir]/patches/VRTSgab.bff VRTSgab 2. Verify that the new patch has been installed: #lslpp -l VRTSgab Fileset Level State Description ---------------------------------------------------------------------------- Path: /usr/lib/objrepos VRTSgab 5.1.100.100 APPLIED Veritas Group Membership and Atomic Broadcast by Symantec 08/21/2011-23_39_58 Re-starting VCS on the cluster node ------------------------------------ 1. Load the newly installed driver: # /etc/methods/gabkext -start 2. Configure GAB: # /etc/init.d/gab.rc start Verify that GAB is configured: # /sbin/gabconfig -a 3. Configure VxFEN if required: # /etc/init.d/vxfen.rc start Verify that VxFEN is up and running: # /sbin/gabconfig -a 4. Start VCS: # /opt/VRTSvcs/bin/hastart Verify that VCS is up and running: # /sbin/gabconfig -a The output must include ports 'h'. If CVM and CFS are configured, the 'f', 'v' and 'w' ports are also listed . 5. Start the applications (stopped earlier) that are outside VCS control. REMOVING THE PATCH ------------------ Patch Uninstallation Instructions: ---------------------------------- UNINSTALLING THE PATCH FROM THE VCS ENVIRONMENT ----------------------------------------------- The VRTSgab patch can only be backed out if it is not committed. Steps to remove the patch from a cluster node --------------------------------------------- 1. To stop VCS on the node and unload any drivers, as required, execute the steps described in the "Stopping VCS on the cluster node" section. 2. Back out the patch by using the following command: # installp -r VRTSgab 5.1.100.100 3. Verify that the patch is removed from the system: (Note: The previously installed fileset(s) will be in the committed state again, unless a hotfix is installed on top of VCS 5.1SP1) # lslpp -l |grep VRTSgab If the patch is properly removed, the following output appears: Fileset Level State Description ---------------------------------------------------------------------------- Path: /usr/lib/objrepos VRTSgab 5.1.100.0 APPLIED Veritas Group Membership and Atomic Broadcast by Symantec 10/01/2010-02:23:32 4. Restart the node by executing the steps described in the "Re-starting VCS on the cluster node" section. SPECIAL INSTRUCTIONS -------------------- NONE OTHERS ------ NONE