* * README - VERITAS Cluster Server 5.0MP1 (SOL/sparc) - Patch e1668609 * *
Patch Date: June 2009
VCS5.0MP1SOL+e1668609
Date:
-----
2009-June-05
OS:
---
SOLARIS
OS Version:
-----------
All supported OS versions for VCS5.0MP1
Packages:
---------
No packages exist in this patch.
The files that will get updated are
/usr/lib/libvcsagfw.so.2
/opt/VRTSvcs/bin/Proxy/ProxyAgent
Case IDs: 320-173-143
---------------------
Etrack Incidents: 1216309, 1282209, 1285122, 1280144, 643021, 1061056, 1225536, 631644, 1187581, 1161339, 1133171, 597530, 1668614, 1520570, 1545222, 1522568, 1397936, 1668609
---------------------------------------
Agent-Framework incidents
1216309 SxRT5.0MP3:I18N: VCS: hares -display - attribute - date format doesn't respect locale settings on JPN
1282209 Output from action EP is not always visible to the caller.
1285122 Race condition for MSG_RES_DELETE followed by MSG_RES_ADD
1280144 Subroutines required to set and reset locale in ag_i18n_inc module
643021 VCSAgExecInContainer() should not create the requested child process if the container is down
1061056 Child process of Agents' should not make calls to logging functions of VCSAgLog object
1225536 Reset OnlineRetryCount, OnlineWaitCount and OfflineWaitCount when resource is flushed
631644 Cookie APIs don't provide atomic clearing of cookie
1187581 ActionTimeout attribute issues
1161339 Application agent does not inherit user defined LANG parameter
1133171 haconf -dump does not change the SRDF NumThreads variable
597530 Need for an OfflineWaitLimit attribute that works the same way as the OnlineWaitLimit
----- (all above incidents were shipped as part of VCS5.0MP3) ----
1668614 After open entry point is complete, append first probe at end of cmd-Q instead of inserting at beginning of cmd-Q
1520570 Engine logs state CPU usage even after deleting HostMonitor resource
1545222 Need ability to pass static attribute/EPTimeout value in ArgListValues
1522568 Crash in agent framework while setting dependent attr's resource name
1397936 Oracle resource in Solaris local-zone prints warning message in logs and does not get probed on offline node
---------------------------------------
Agent incidents
1668609 Update Proxy agent to allow target resource to get probed
---------------------------------------
Fixes Applied for Products:
---------------------------
Veritas Cluster Server for SOL
Install/Uninstall Instructions:
-------------------------------
BEFORE GETTING STARTED
----------------------
This patch is for VCS5.0MP1, VCS5.0MP3, VCS5.0MP3RP1 installations. The patch fixes
a number of problems with the VCS agent framework and one problem with the
Proxy agent as listed above.
If you are running any VCS version below VCS5.0MP1, you will have to upgrade
to VCS5.0MP1 before applying this patch.
If you are already running VCS5.0MP1 (or above), you can apply this point-patch directly
(guidelines below).
NOTE: This patch should only be applied on top of VCS5.0MP1, VCS5.0MP3 or VCS5.0MP3RP1.
VCS 5.0MP3RP2 (when available) will obsolete this patch. VCS 5.0MP3RP2 can be applied on
top of this patch as VCS5.0MP3RP2 would contain either the same or a newer version of the
binary files contained in this patch.
If VCS5.0MP3RP2 is available, one should directly apply VCS5.0MP3RP2 on top
of VCS5.0GA or VCS5.0MP1 and does not need to apply this point-patch.
This patch contains two binary files:
libvcsagfw.so.2
ProxyAgent
INSTALLING THE VCS PATCH
------------------------
To install the patch:
1. Make the VCS configuration writable. On any system, type:
# haconf -makerw
2. Freeze all service groups. On any system, type:
# hagrp -freeze <service_group> -persistent
3. Verify that service groups are frozen. On any system, type:
# hastatus -sum
5. Save this configuration change to the main.cf file with the groups frozen.
On any system, type:
# haconf -dump -makero
6. Stop VCS. On any system, type:
# hastop -all -force
7. Check that VCS has shut down. On each system, type:
# ps -ef | grep had
8. Save the old agent framework library and ProxyAgent binary:
# cp /usr/lib/libvcsagfw.so.2 /usr/lib/libvcsagfw.so.2.pre_e1668609
# cp /opt/VRTSvcs/bin/Proxy/ProxyAgent /opt/VRTSvcs/bin/Proxy/ProxyAgent.pre_e1668609
9. Install the patched agent framework library to /usr/lib/ and patched agent to /opt/VRTSvcs/bin/Proxy/
# cd <patch_location>
# cp ./libvcsagfw.so.2 /usr/lib/libvcsagfw.so.2
# cp ./ProxyAgent /opt/VRTSvcs/bin/Proxy/ProxyAgent
12. Verify that the patch has installed and the old agent framework library and ProxyAgent
are backed up.
# ls -l /usr/lib/libvcsagfw.*
# ls -l /opt/VRTSvcs/bin/Proxy/
13. Restart VCS. On each system in the cluster, type:
# hastart
14. Verify all resources have been probed. On any system, type:
# hastatus -summary
15. Make the configuration writable and unfreeze all service groups.
On any system, type:
# haconf -makerw
# hagrp -unfreeze <service_group> -persistent
16. Save the changes to the configuration file (main.cf). On any system, type:
# haconf -dump -makero
REMOVING THE PATCH
-------------------
To remove the patch from a running VCS cluster:
1. Make the VCS configuration writable. On any system, type:
# haconf -makerw
2. Freeze the service groups. On any system, type:
# hagrp -freeze <service_group> -persistent
3. Save the configuration file (main.cf) with the groups frozen.
On any system, type:
# haconf -dump -makero
4. Stop VCS. On any system, type:
# hastop -all -force
5. Uninstall the patch by copying back the old/saved agent framework library and ProxyAgent binary:
# cp /usr/lib/libvcsagfw.so.2.pre_e1668609 /usr/lib/libvcsagfw.so.2
# cp /opt/VRTSvcs/bin/Proxy/ProxyAgent.pre_e1668609 /opt/VRTSvcs/bin/Proxy/ProxyAgent
6. Restart VCS. On each system in the cluster, type:
# hastart
7. Verify all resources have been probed. On any system, type:
# hastatus -summary
8. Make the configuration writable and unfreeze all service groups.
On any system, type:
# haconf -makerw
# hagrp -unfreeze <service_group> -persistent
9. Save this change to the configuration file (main.cf). On any system, type:
# haconf -dump -makero