IBM Tivoli Composite Application Manager for SOA V7.1.0
           
                     Interim Fix 0002 Readme

                        June 10, 2008

===================================================================
===================================================================

Contents

Section 1. General Description
Section 2. Defects Fixed
Section 3. Prerequisites
Section 4. Installation Instructions


====================================================================
====================================================================
Section 1. General Description
--------------------------------------

This I-fix contains a fix for customer reported problem, please note
this fix does not applies to environments where .NET, CICS or 
Message Broker is being monitored.


====================================================================
Section 2. Defects Fixed
--------------------------------------

APAR: IZ23781

ITCAM for SOA Agent crash when the Data Collector metrics log contains 
an elaborate fault record.
  
====================================================================
Section 3. Prerequisites
--------------------------------------

1. IBM Tivoli Composite Application Manager for SOA V7.1 IF0001

NOTE : IF0002 is a cumulative fix and should be applied after IF0001, but taking into
account that IF0001 is a multiple component fix, IF0002 can be complemented by the 
TEPS and DLA components from IF0001.

i.e.

- If ITCAM for SOA v7.1 IF0001 is already installed on the system.
   + Install ITCAM for SOA 7.1 IF0002 on top of current environment.
   
- If ITCAM for SOA v7.1 IF0002 is installed on the system and IF0001 needs to be installed.
   + Be cautious to just install the TEPS and DLA pieces contained in IF0001, if TEMA (Agent)
     piece from IF0001 is installed it will regress the fix provided in IF0002.


====================================================================
Section 4. Installation Instructions
------------------------------------

Use the following steps to install the update on the computer where the ITCAM for SOA agent is installed:

NOTE: Please ensure the base product and support files have been fully configured before applying this fix.


+ Extract the IF0002 main containers in a temporary directory.

i.e

Windows.

C:\TEMP

unzip 7.1.0-TIV-ITCAMSOA-IF0002.zip

This package contains the following packs to be used and applied as needed.



7.1.0-TIV-ITCAMSOA-Windows-IF0002.zip     603291
7.1.0-TIV-ITCAMSOA-Linux_Unix-IF0002.tar  645120



+ Install fix at the TEMA.



        1.Stop (disable) the Data Collector (WAS).
        
          Windows: From <itm_home>/TMAITM6/KD4/bin
           
          Linux/Unix: From <itm_home>/<platform_name>/d4/KD4/bin
            
          Execute:
 
          ./KD4configDC -disable -env 1 <WAS_HOME>

          Where <WAS_HOME> : This argument specifies the base installation directory for WebSphere Application Server. 
          The typical default value is "C:\Program Files\WebSphere\AppServer" (note that because this path name contains a
          blank space, the entire path is surrounded with quotation marks).       
          

        2.Backup affected file.

          From the <itm_home> directory, create a backup directory and copy the following
           currently installed files into the backup directory.

           Windows :
           
            <itm_home>TMAITM6\KD4\lib\kd4was61dcagent.jar
                                   
           Linux/Unix:
                                      
            <itm_home>/<platform_name>/d4/KD4/lib/kd4was61dcagent.jar
            

           Where:
           
           <itm_home> : Is the location where the  IBM Tivoli Monitoring product is installed. 
           <platform_name> : Is the Operating System specific directory created by  IBM Tivoli Monitoring
           The  <itm_home>/bin/cinfo -d command can be used to determine the platform name for the d4 product code.
           Please note that the platform names may vary depending on the  IBM Tivoli Monitoring level installed (6.1 or 6.2).



        3. Apply patch to the machine where the TEMA is running by extracting the new files and reconfigure as follows.
        

           
           Windows.
           
           Unzip the windows fixpack package 7.1.0-TIV-ITCAMSOA-Windows-IF0002.zip
 
           
           
           i.e.
           
           cd <itm_home>TMAITM6\ 
           unzip 7.1.0-TIV-ITCAMSOA-Windows-IF0002.zip
           
           

           Linux/Unix.                

           Untar the Linux/Unix package 7.1.0-TIV-ITCAMSOA-Linux_Unix-IF0002.tar

                      
           i.e.
           
           cd <itm_home>/<platform_name>/d4/ 
           tar -xvf 7.1.0-TIV-ITCAMSOA-Linux_Unix-IF0002.tar
           
           
        4. After completing the above steps, enable the Data Collector (WAS).
        
           Windows: From <itm_home>TMAITM6/KD4/bin
           
           Linux/Unix: From <itm_home>/<platform_name>/d4/KD4/bin
           
           Execute:
                
           ./KD4configDC -enable -env 1 <WAS_HOME>
           
           
           Where <WAS_HOME> : This argument specifies the base installation directory for WebSphere Application Server. 
           The typical default value is "C:\Program Files\WebSphere\AppServer" (note that because this path name contains a
           blank space, the entire path is surrounded with quotation marks).