Date:2012-June-21

OS: Solaris, Windows 

Etrack Incidents: 2769722, 2750086, 2780427 

Errors/Problems Fixed:[
   Unified Agents are in Critical State in CommandCentral Storage Console(e2769722)
   ConnectionProtocol attribute value is null for some of the Unified Agents HBAs(e2750086)
   Unable to unconfigure and remove Unified Agents from CommandCentral Console(e2780427)

]

Install/Uninstall Instructions:
===========================================================================
Instructions to apply the hotfix
===========================================================================


A - Overview of the HotFix
---------------------------------------------------------------------------

   1. Apply the HotFix (VRTSccs-F520032769722) on 5.3RU3 CommandCentral Storage Management Servers and 5.2RU3 Control Hosts having 
      VRTSsfmh package version 4.1.

          VRTSsfmh build version on Windows Servers - 4.01.0119
          VRTSsfmh build version on Solaris Servers - 4.1.119.0 	  

      Upgrade VRTSsfmh package on CommandCentral Storage Management Server and Control Hosts to 4.1 if they are at lower level and
      then apply this HotFix.

   2. This hotfix is having two below patches and both should be applied on CommandCentral Management Server and Control Hosts.
          - VRTSccs-F520032769722.tar.gz   	  
          - 2769722-ccs-vom-01.sfa
	
   3. Steps to deploy patch 'VRTSccs-F520032769722.tar.gz' are mentioned in SECTION 'B' and SECTION 'C'.

   4. Steps to deply patch '2769722-ccs-vom-01.sfa' are mentioned in SECTION 'D'.
	  		  
   
 Supported operating systems include:

  - Solaris 8, 9, and 10
  - Windows Server 2000, 2003, and 2008


B - Deploying the patch 'VRTSccs-F520032769722.tar.gz' from Windows Management Server
-------------------------------------------------------------------------------------

The examples in the following procedure assume that you installed 
CommandCentral on a 32-bit host in the default installation directory.

1. Copy ccs-win-5.2RU3HF520032769722w-patches.zip to a temporary location. For
   example,   to C:\Temp

2. After extracting the hotfix,   the below three files will be available.
    - patches
    - patches\2769722-ccs-vom-01.sfa
    - patches\VRTSccs-F520032769722.tar.gz
    - README  (this file)

3. To apply the update on the Management Server, do following:
    
   - Go to the CommandCentral HAL bin directory:

       "C:\Program Files\VERITAS\CommandCentral Storage\HAL\bin"
    
   - Run the following command:

       perl LocalUpgrade.pl "C:\Temp\patches\VRTSccs-F520032769722.tar.gz"

4. To verify the installation, check the installation logs on the Management 
Server as follows:
     
   - Go to the CommandCentral Storage HAL Data directory.

       "C:\Program Files\VERITAS\CommandCentral Storage Data\Data\HAL\maint\
\VRTSccs-F520032769722\output"
    
   - Check if there are any errors in the stderr.txt file.
     
   - Check the detailed logs of the hotfix application in the stdout.txt file.


5. To push the update to Control Hosts(having array and switch explorers), 
run the following commands from the Management Server:

   - Go to the HAL bin directory:

       "C:\Program Files\VERITAS\CommandCentral Storage\HAL\bin"
   
   - Type the following command:

       halsecurity login

       You may have to provide the password for the 'admin' account which you 
use to log in to the Console. The default password for this account is 
'password' (without single quotes).
   
    - To get a list of all Control Hosts in a text file, run the following 
command:
	
       perl CHMGetManagedHosts.pl -f C:\Temp\mhs.txt

       The text file includes the list of all hosts.
               
    - Edit this file to keep only the names of those hosts that you want to 
update.
   
    - To deploy the update to the hosts listed in C:\Temp\mhs.txt, run the 
following command:

       perl PushUpgrade.pl -u "C:\Temp\patches\VRTSccs-F520032769722.tar.gz" -H 
C:\Temp\mhs.txt

6. To verify the installation, check the install logs on the relevant managed 
hosts as follows:
   
    - Go to the CommandCentral HAL Data directory:

       For Windows hosts:
         
        "C:\Program Files\VERITAS\CommandCentral Storage Data\Data\HAL\maint\
\VRTSccs-F520032769722\output"
  
       For UNIX hosts:

     /var/VRTSccs/data/VRTShal/maint/\VRTSccs-F520032769722/output  
  
    - Check if there are any errors in the stderr.txt file.
  
    - Check the detailed logs of the hotfix application in the stdout.txt file.

7. Verify the updated version as follows:
 
    - Open cc_version.txt from the following directory:
   
        For Windows:

         "C:\Program Files\VERITAS\CommandCentral Storage\Version"
        
        For UNIX:

         /opt/VRTS/version/
 
    - Check the FIXID. It should look like this

         FIXID=F520032769722
         DATE=Wed Jun 20 15:11:34 2012
         DESCRIPTION=CC Storage 5.2RU3 Hotfix for Management Server and Control Hosts discovering Unified Agents


    

C - Deploying the patch 'VRTSccs-F520032769722.tar.gz' from a Solaris Management Server
-----------------------------------------------------------------------------------------

The examples in the following procedure assume that you installed
CommandCentral on a 32-bit host in the default installation directory.

1. Copy the file ccs-sol_sparc-5.2RU3HF520032769722u-patches.tar.gz to a
   temporary location. For example,   to /tmp and unpack it.

2. After extracting the hotfix,   the below three files will be available.
    - patches
    - patches\2769722-ccs-vom-01.sfa
    - patches\VRTSccs-F520032769722.tar.gz
    - README  (this file)

3. To apply the update on the Management Server, do following:
  
   - Go to the HAL bin directory:

       /opt/VRTSccs/VRTShal/bin
  
   - Type the following command:

       ./perl LocalUpgrade.pl /tmp/patches/VRTSccs-F520032769722.tar.gz

4. To verify the installation, check the installation logs on the Management 
Server as follows:
 
    - Go to the CommandCentral Storage HAL Data directory:

      /var/VRTSccs/data/VRTShal/maint/VRTSccs-F520032769722/output
 
    - Check if there are any errors in the stderr.txt file.

    - Check the detailed logs of the hotfix application in the stdout.txt file.

5. To push the update to Control Hosts(having array and switch explorers), run the following commands from the 
Management Server: 
 
    - Go to the HAL bin directory:

       /opt/VRTSccs/VRTShal/bin
 
    - Type the following command:

       ./halsecurity login

       You may have to provide the password for the 'admin' account which you 
use to log in to the Console. The default password for this account is 
'password' (without single quotes).
 
    - To get a list of all Control Hosts in a text file, run the following 
command:
	
        ./perl CHMGetManagedHosts.pl -f /tmp/mhs.txt

        The text file includes the list of all hosts and the Management 
Server. 

    - Edit mhs.txt to keep only the names of those hosts that you want to 
update
 
    - To deploy the update to the hosts listed in /tmp/mhs.txt, run the 
following command:

        ./perl PushUpgrade.pl -u /tmp/patches/VRTSccs-F520032769722.tar.gz -H 
/tmp/mhs.txt

6. To verify the installation, check the install logs on relevant control 
hosts:

    - Go to the CommandCentral HAL Data directory:

        For Windows hosts:

         "C:\Program Files\VERITAS\CommandCentral Storage Data\Data\HAL\maint\
VRTSccs-F520032769722\output"
 
        For UNIX hosts:

      /var/VRTSccs/data/VRTShal/maint/VRTSccsF520032769722/output  
 
    - Check if there are any errors in the stderr.txt file.
 
    - Check the detailed logs of the hotfix application in the stdout.txt file.

7. Verify the updated version as follows:

     - Open the cc_version.txt file from the following directory:
     
        For Windows hosts:

         "C:\Program Files\VERITAS\CommandCentral Storage\Version"
        
        For UNIX hosts:

         /opt/VRTS/version/

     - Check the FIXID. It should look like this
         
         FIXID=F520032769722
         DATE=Wed Jun 20 15:11:34 2012
         DESCRIPTION=CC Storage 5.2RU3 Hotfix for Management Server and Control Hosts discovering Unified Agents




D - Deploying the patch '2769722-ccs-vom-01.sfa' on CommandCentral Management Server and Control Hosts
------------------------------------------------------------------------------------------------------
The examples in the following procedure assume that you installed 
CommandCentral on a 32-bit host in the default installation directory.

    - Steps to apply patch on Windows Management Server and Control Hosts

       1. Copy patch '2769722-ccs-vom-01.sfa' to a temporary location on Management Server and Control Hosts. 
          For example,   to C:\Temp

       2. Make sure that xprtld process is running in Task Manager.

       3. Installation commands
        	cd C:\Program Files\VERITAS\VRTSsfmh\bin
	        C:\Program Files\VERITAS\VRTSsfmh\bin>perl.exe vomadm hotfix --install C:\Temp\2769722-ccs-vom-01.sfa

       4. After installation, verify that xprtlc.dll is updated in bin dir and xprtld is running
		
 
    - Steps to apply patch on Solaris Management Server and Control Hosts

       1. Copy patch '2769722-ccs-vom-01.sfa' to a temporary location on Management Server and Control Hosts. 
          For example,   to \tmp

       2. Make sure that xprtld process is running by executing 'ps -ef | grep xprtld'.

       3. Installation commands
        	cd /opt/VRTSsfmh/bin/
	        /opt/VRTSsfmh/bin/>./perl vomadm hotfix --install tmp\2769722-ccs-vom-01.sfa

       4. After installation, verify that xprtlc is updated in bin dir and xprtld is running



Additional Notes:
==================
 Apply the HotFix (VRTSccs-F520032769722) on 5.3RU3 CommandCentral Storage Management Servers and 5.2RU3 Control Hosts having 
 VRTSsfmh package version 4.1.

     VRTSsfmh build version on Windows Servers - 4.01.0119
     VRTSsfmh build version on Solaris Servers - 4.1.119.0 	  

 Upgrade VRTSsfmh package on CommandCentral Storage Management Server and Control Hosts to 4.1 if they are at lower level and
 then apply this HotFix.
-