OS: Linux OS Version: RHEL4 (i686/x86_64) Fixes Applied for Products: VRTSvcsag - Veritas Cluster Server Bundled Agents by Symantec Additional Instructions: Please read the instructions below before installing the patch. PATCH VRTSvcsag 5.0MP3RP2HF6 for VCS Bundled Agent 5.0MP3RP2 =============================================================== Patch Date: October, 2009 This README provides information on: * BEFORE GETTING STARTED * CRC AND BYTE COUNT * FIXES AND ENHANCEMENTS INCLUDED IN THE PATCH * PACKAGES AFFECTED BY THE PATCH * INSTALLING THE PATCH * UNINSTALLING THE PATCH BEFORE GETTING STARTED: ---------------------- This patch only applies to: VRTSvcsag 5.0MP3RP2 running on RHEL4 (i686/x86_64) Ensure that you are running the supported configurations before installing this patch. CRC AND BYTE COUNT: ------------------ Ensure that the patch file you have downloaded matches the following checksum and byte count. The following command can be used to ascertain this: # cksum VRTSvcsag-5.0.30.26-MP3RP2HF6_RHEL4.i686.rpm 1141389890 478260 VRTSvcsag-5.0.30.26-MP3RP2HF6_RHEL4.i686.rpm FIXES AND ENHANCEMENTS INCLUDED IN THE PATCH: -------------------------------------------- Etrack Incidents: 1852510, 1789008, 1730192, 1723347, 1557126, 1638428, 1665814, 1676451 SDR's of Fixed Symantec Incidents: -------------------------------- Symantec Incident : 1852510 Symptom: DiskGroupSnap resource failed to come online. Defect Description: The agent currently assumes that all nodes in the cluster would be involved in the campus cluster configuration. Resolution: Removed the assumption that all nodes in the cluster participate in the campus cluster setup as well. Previous Patch Fixes: Symantec Incident : 1789008 Symptom: Presence of file /var/lib/nfs/etab, upon panic reboot causes incorrect operation of Share agent. Defect Description: When the system panics, the /var/lib/nfs/etab file is not cleared at boot-time. This results in VCS incorrectly seeing share resources as online. The Share agent service group cannot be failed over to the other node as the service group goes into partial state. The NFS client receives an "Stale NFS File Handle" error. Resolution: A new mandatory attribute is added to Share agent type definition named 'NFSRes'. This attribute is the NFS Resource configured on the system. This ensures that the /var/lib/nfs/etab file is cleared during the First Probe of Share resource, if NFS resource is not yet up. Description of NFSRes attribute: NFSRes, the NFS resource be configured on the system. This attribute is required to determine the current state of the NFS Resource. Type and dimension: string-scalar Sample Configuration: NFS nfs ( Address = "[ip-address]" ) Share share ( NFSRes = nfs PathName = "/nfs_mnt" Options = "rw" ) Symantec Incident: 1730192 Symptom: DNS clean never used to succeed. Defect Description: The DNS clean entry point was not parsing the argument list correctly. Hence, it always reported the clean operation as failed. VCS kept on re-attempting clean operation and this sequence never used to end. Resolution: Fixed the clean entry point code to parse the argument list correctly. Now the DNS resource's clean operation should succeed, if there is no fault. Symantec Incident: 1723347 Symptom: Mount agent returns offline even when the resource is mounted. Defect Description: Mount agent did not support large file systems. Thus statvfs(3P) call within large file systems used to fail. Due to this, the monitor entry point used to return offline status. Resolution: Fixed the Mount agent to support large file systems and return correct status. Symantec Incident: 1557126 The VCS Application agent was not able to recognize a running process containing special characters like round brackets. Symantec Incident: 1638428 Mount agent doesn't support NFS version 4 in Linux, even though NFS agent supports it. Symantec Incident: 1665814 The offline entry point of NFSRestart does not stop NFS daemons. Symantec Incident: 1676451 NFS clients were getting "permission denied" errors after NFS service group failover. PACKAGES AFFECTED BY THE PATCH: ------------------------------- This patch updates the following VCS package(s) VRTSvcsag from 5.0MP3RP2 or higher to 5.0MP3RP2HF6 INSTALLING THE PATCH: -------------------- The following steps should be run on all nodes in the VCS cluster: Stopping VCS on the cluster node: -------------------------------- 1. Ensure that "/opt/VRTS/bin" directory is included in your PATH environment variable so you can execute all the VCS commands. Refer to Veritas Cluster Server Installation Guide for more information. 2. Verify that the version of VRTSvcs and VRTSvcsag is 5.0MP3RP2 or higher for Linux. 3. Freeze all the service groups persistently. # haconf -makerw # hagrp -freeze [group] -persistent # haconf -dump -makero 4. Stop the cluster on all nodes. If the cluster is writable, you may close the configuration before stopping the cluster. # haconf -dump -makero From any node, execute the following command. # hastop -all or # hastop -all -force Verify that the cluster is stopped on all nodes by running the ha command. # hasys -state On all nodes, make sure that both had and hashadow processes are stopped. Also, stop the VCS CmdServer on all nodes. # CmdServer -stop 5. Move /etc/VRTSvcs/conf/config/types.cf file to /etc/VRTSvcs/conf/config/types.cf.orig. Installing the Patch: -------------------- 1. Un-compress the downloaded patch from Symantec. Change directory to the unzipped patch location. Install the VRTSvcsag 5.0MP3RP2HF6 patch using the following command: # rpm -Uvh VRTSvcsag-5.0.30.26-MP3RP2HF6_RHEL4.i686.rpm 2. Verify that the new patch has been installed: # rpm -q VRTSvcsag You will find the following output on display with the patch installed properly: VRTSvcsag-5.0.30.26-MP3RP2HF6_RHEL4 Re-starting VCS on the cluster node: ----------------------------------- Manual configuration update steps: 1. Adding NFSRes attribute to all the systems: Add NFSRes attribute to every Share resource configuration in main.cf. Sample Configuration, that need to be added : NFS nfs ( Address = "[ip-address]" ) Share share ( NFSRes = nfs PathName = "/nfs_mnt" Options = "rw" ) Verify consistency of main.cf file after updation: # hacf -verify /etc/VRTSvcs/conf/config/ Note: Please make sure that the NFSRes attribute is added to every Share resource that is configured on the system, after applying this patch. In case of attribute mismatch error for NFSRes attribute, please verify the types.cf is upgraded properly. 2. At this time, you can start the cluster services on all cluster nodes. First start VCS on one node: # hastart On all the other nodes, start VCS by issuing hastart after the first node goes to LOCAL_BUILD or RUNNING state. 3. Unfreeze all the groups. # haconf -makerw # hagrp -unfreeze [group] -persistent # haconf -dump -makero OR Runtime configuration update steps: 1. At this time, you can start the cluster services on all cluster nodes. First start VCS on one node: # hastart On all the other nodes, start VCS by issuing hastart after the first node goes to LOCAL_BUILD or RUNNING state. 2. Make VCS cluster Writable: # haconf -makerw 3. To modify the configuration at run-time, instead of modifying main.cf manually please execute the following commands: NOTE: Please make sure that the Service groups are freezed. # for res in `hatype -resources Share`; do hares -modify $res NFSRes [NFS_Resource_Name] done Note: Please make sure that the NFSRes attribute is added to every Share resource that is configured on the system, after applying this patch. In case of attribute mismatch error for NFSRes attribute, please verify the types.cf is upgraded properly. 4. Unfreeze all the groups. # hagrp -unfreeze [group] -persistent # haconf -dump -makero UNINSTALLING THE PATCH: ----------------------- Removal of the patch will result in removing 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 again. Following steps need to be run on all the VCS cluster node: Steps to remove the Patch from a cluster node: --------------------------------------------- 1. Follow the steps 1-4 provided under "Stopping VCS on the cluster node" section above, to stop VCS on the node. 2. Remove the patch by the following command: # rpm -e VRTSvcsag 3. Verify that the patch has been removed from the system: # rpm -qa | grep VRTSvcsag The package VRTSvcsag should not be displayed, which confirms that the package is removed. 4. Install VRTSvcsag package from VCS 5.0MP3 Installer CD/DVD and upgrade to VCS 5.0MP3RP2. 5. At this time, you can start the cluster services on all cluster nodes. First start VCS on one node: # hastart On all the other nodes, start VCS by issuing hastart after the first node goes to LOCAL_BUILD or RUNNING state. 6. Unfreeze all the groups. # haconf -makerw # hagrp -unfreeze [group] -persistent # haconf -dump -makero