IBM Tivoli Composite Application Manager for SOA V7.1.0 Interim Fix 0003 Readme Feb 16, 2009 =================================================================== =================================================================== Contents Section 1. General Description Section 2. Defects Fixed Section 3. Prerequisites Section 4. Installation Instructions ==================================================================== Created/Revised by Creation/Update Summary of Changes -------------------------------------------------------------------- GC Feb-05-2009 Document created -------------------------------------------------------------------- GC Feb-16-2009 Add step to re-cycle server on data collector update. -------------------------------------------------------------------- ==================================================================== 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: IZ43416 WPS 6.1 SCA DATA COLLECTOR RECORDS METRICS THAT RESULT IN A LOOP-BACK IN THE OPERATIONAL FLOW WORKSPACES. ==================================================================== Section 3. Prerequisites -------------------------------------- 1. IBM Tivoli Composite Application Manager for SOA V7.1 IF0001 NOTE : IF0003 is a cumulative fix and should be applied after IF0001 and replaces the same components as IF0002, please take this into account and be aware that IF0001 is a multiple component fix and that IF0003 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 IF0003 on top of current environment. - If ITCAM for SOA v7.1 IF0003 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. - If ITCAM for SOA v7.1 IF0002 is installed on the system and IF0003 needs to be installed. + Just install IF0003 no additional task is needed. SPECIAL NOTE: If IF0003 is installed DO NOT install IF0002, this will regress the code to IF002 level. ==================================================================== 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 IF0003 main containers in a temporary directory. i.e Windows. C:\TEMP unzip 7.1.0-TIV-ITCAMSOA-IF0003.zip This package contains the following packs to be used and applied as needed. 7.1.0-TIV-ITCAMSOA-Windows-IF0003.zip 603372 7.1.0-TIV-ITCAMSOA-Linux_Unix-IF0003.tar 645120 + Install fix at the TEMA. 1. Stop the WPS / WESB / WAS application server as applicable. 2. Stop (disable) the Data Collector (WAS). Windows: From /TMAITM6/KD4/bin Linux/Unix: From //d4/KD4/bin Execute: ./KD4configDC -disable -env 1 Where : 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). 3. Backup affected file. From the directory, create a backup directory and copy the following currently installed files into the backup directory. Windows : TMAITM6\KD4\lib\kd4was61dcagent.jar Linux/Unix: //d4/KD4/lib/kd4was61dcagent.jar Where: : Is the location where the IBM Tivoli Monitoring product is installed. : Is the Operating System specific directory created by IBM Tivoli Monitoring The /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). 4. 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-IF0003.zip i.e. cd TMAITM6\ unzip 7.1.0-TIV-ITCAMSOA-Windows-IF0003.zip Linux/Unix. Untar the Linux/Unix package 7.1.0-TIV-ITCAMSOA-Linux_Unix-IF0003.tar i.e. cd //d4/ tar -xvf 7.1.0-TIV-ITCAMSOA-Linux_Unix-IF0003.tar 5. After completing the above steps, enable the Data Collector (WAS). Windows: From TMAITM6/KD4/bin Linux/Unix: From //d4/KD4/bin Execute: ./KD4configDC -enable -env 1 Where : 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). 6. Restart the WPS / WESB /WAS application server as applicable.