VERITAS Storage Foundation (tm) 4.1 and 4.2 HA for Windows Private 304083 - Patch for Enterprise Agent NetBackup to use AgentFile and AgentDirectory attributes

Article:TECH43003  |  Created: 2006-01-08  |  Updated: 2006-01-08  |  Article URL http://www.symantec.com/docs/TECH43003
Article Type
Technical Solution


Environment

Issue



VERITAS Storage Foundation (tm) 4.1 and 4.2 HA for Windows Private 304083 - Patch for Enterprise Agent NetBackup to use AgentFile and AgentDirectory attributes

Solution



Last revised: 07/05/2005


CONTENTS
--------
1. HOTFIX OVERVIEW
  - Symptoms of the Issue
  - Resolution
2. INSTALLING THE PATCH
3. REMOVING THE VCS PATCH
3. DISCLAIMER


HOTFIX OVERVIEW
---------------
This hotfix for VERITAS Storage Foundation HA  4.1 and 4.2 RP1 for Windows provides a fix for the NetBackup 6.0 agent for VERITAS Cluster Server.


Symptoms of the Issue
---------------------

The NetBackup 6.0 agent for VERITAS Cluster Server is included in NetBackup 6.0  and is installed in the NetBackup directory. Due to the installation location,  the agent is not discovered by VERITAS Cluster Server.

Resolution
----------

The updated binaries HAD.exe and vcsagfw.dll add two new attributes, AgentFile and AgentDirectory. Configuring these attributes ensures that the NetBackup agent works with Storage Foundation HA 4.1 and 4.2 RP1.


EXTRACTING THE CLUSTER SERVER PATCH
-----------------------
1. Download the private patch file to a temporary location on your cluster node

2. Extract the files to a temporary location on your cluster node. See the table below to determine which file to extract:

---------------------------------------------------------------------
Storage Foundation-HA Version | Name of Private File to extract |
---------------------------------------------------------------------
|  4.1  |  Private_4_1_304083.zip  |
---------------------------------------------------------------------
|  4.2  |  Private_4_2_304083.zip  |
---------------------------------------------------------------------



INSTALLING THE CLUSTER SERVER PATCH
------------------------

Install the hotfix only on cluster nodes running Windows Server 2003

To apply the patch to a running Storage Foundation HA 4.1 or 4.2 RP1 cluster:

1. List the service groups in your cluster and their status. On any system, type:

       # hagrp -state

2. Offline the ClusterService service group if it is running.  On any system, type:

       # hagrp -offline ClusterService -sys <system>

3. Make the Cluster Server configuration writeable. On any system, type:

       # haconf -makerw

4. Freeze all service groups. On any system, type:

       # hagrp -freeze <service_group> -persistent

5. Save the configuration file (main.cf) with the groups frozen. On any system, type:

       # haconf -dump -makero

6. Shut down VERITAS Cluster Server. On any system, type:

       # hastop -all -force

7. Confirm that Cluster Server has shut down. On each system, type:

       # gabconfig -a

  Output resembles:

       GAB Port Memberships
       =====================================
       Port a gen 23dc0001 membership 01

  Note that the output shows no membership for port h.

8. Change directory to %VCS_HOME%/bin. VCS_HOME representing the Cluster Server installation directory, typically C:\Program Files\VERITAS\Cluster Server\.

9. Copy the original had.exe to another file:

       # copy had.exe had_ORIG.exe

10. Copy the original vcsagfw.dll to another file:

       # copy vcsagfw.dll vcsagfw_ORIG.dll

11. Copy the new had.exe over to %VCS_HOME%\bin:

       # copy C:\Patch\had.exe %VCS_HOME%\bin\

12. Copy the new vcsagfw.dll to %VCS_HOME%\bin:

       #copy C:\Patch\vcsagfw.dll %VCS_HOME%\bin\

13. Repeat steps 8-12 on each cluster node

14. Restart Cluster Server on each system in the cluster. On each system, type:

       # hastart

15. After Cluster Server has started on all systems, perform the following steps:

   a. Verify all resources have been probed. On any system, type:

       # hastatus -summary

   b. Unfreeze all service groups. On any system, type:

       # haconf -makerw

       # hagrp -unfreeze <service_group> -persistent

       # haconf -dump -makero

   c. Online the ClusterService service group, if necessary. On any system type:

       # hagrp -online ClusterService -sys <system>



REMOVING THE VERITAS CLUSTER SERVER PATCH
-------------------------

To remove the patch from a running Cluster Server cluster:

1. Repeat steps 1-7 for installing the patch on a running Cluster Server cluster

2. Change directory to %VCS_HOME%/bin. VCS_HOME represents the Cluster Server installation directory, typically C:\Program Files\VERITAS\Cluster Server\.

3. Copy the saved copy of the original had.exe back:

       # copy had_ORIG.exe had.exe

4. Copy the saved copy of the original vcsagfw.dll back:

       # copy vcsagfw_ORIG.dll vcsagfw.dll

5. Repeat steps 2-4 on each cluster node
 
6. Restart Cluster Server on each system in the cluster. On each system, type:

       # hastart

7. After Cluster Server has started on all systems, perform the following steps:

   a. Verify all resources have been probed. On any system, type:

       # hastatus -summary

   b. Unfreeze all service groups. On any system, type:

       # haconf -makerw

       # hagrp -unfreeze <service_group> -persistent

       # haconf -dump -makero

   c. Online the ClusterService service group, if necessary.  On any system type:

       # hagrp -online ClusterService -sys <system>




DISCLAIMER
----------
This hotfix is a supported fix that has not been fully regression tested and must be applied only to systems that are severely affected by the problem. For other situations, Symantec recommends that you wait for the next service pack that will contain this fix.

Contact Symantec Enterprise Technical Support for more information



Attachments

Patch_304083_278307.exe (3.8 MBytes)

Supplemental Materials

SourceETrack
Value304083


Legacy ID



278307


Article URL http://www.symantec.com/docs/TECH43003


Terms of use for this information are found in Legal Notices