* * README - VERITAS Cluster Server 5.0 (Sol/Sparc) - Patch 787222 * *

                       Patch Date: November 2006
                    
		    VCS 5.0GA+e787222 - Solaris (Sparc)
		    
		    
   This document provides information for:

   * FIXES AND ENHANCEMENTS INCLUDED IN THIS VCS PATCH 
   * FILES AFFECTED BY THIS VCS PATCH
   * INSTALLING THE VCS PATCH 
   * REMOVING THIS PATCH
  


BEFORE GETTING STARTED
----------------------

This patch is for VCS 5.0 on Sun Solaris Sparc systems. The patch fixes a
problem with VCS and Solaris Zones and hence concerns only Solaris 10 systems.
Note that the patch can be installed on pre-Solaris 10 systems on top of
VCS 5.0GA, but one does not need to, since it does not affect the behaviour of
VCS on pre-Solaris10 systems.
If you are running any VCS version below VCS 5.0GA, you will have to upgrade
to VCS 5.0GA before applying this patch.
If you are already running VCS 5.0GA, you can apply this point-patch directly
(guidelines below).

NOTE: This patch should only be applied on top of VCS 5.0GA. VCS 5.0MP1
obsoletes this patch. VCS 5.0MP1 can be applied on top of this patch as
VCS5.0MP1 would contain either the same or a newer version of the binary file
contained in this patch.
If VCS5.0MP1 is available, one can and should directly apply VCS5.0MP1 on top
of VCS5.0GA and does not need to apply this point-patch. As mentioned above, if
one has applied this point-patch on top of VCS5.0GA, one can safely apply
VCS5.0MP1 on top of this point-patch.

This patch contains a single binary file:
   
	libvcsagfw.so.2


FIXES AND ENHANCEMENTS INCLUDED IN THIS VCS PATCH
-------------------------------------------------

787222 cut usage reported in entry point output when zone-name is larger than 11 characters


FILES AFFECTED BY THIS VCS PATCH
--------------------------------

	/usr/lib/libvcsagfw.so.2
    

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 in /usr/lib/

      # cp /usr/lib/libvcsagfw.so.2 /usr/lib/libvcsagfw.so.2.pre787222

9. Install the patched agent framework library to /usr/lib/

      # cd <patch_location>
      # cp ./libvcsagfw.so.2 /usr/lib/libvcsagfw.so.2

12. Verify that the patch has installed and the old agent framework library
    is backed up.

      # ls -l /usr/lib/libvcsagfw.so.2*

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 over the old/saved agent framework library
    to /usr/lib/

      # cp /usr/lib/libvcsagfw.so.2.pre787222 /usr/lib/libvcsagfw.so.2
   
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