IBM Tivoli Monitoring Summarization and Pruning Agent (6.3.0-TIV-ITM-FP0007-IJ03951

Download Description

(C) Copyright International Business Machines Corporation 2018.
          All rights reserved.


Date: Tue Mar  6 04:57:07 PM 2018

Interim Fix Name: 6.3.0-TIV-ITM-FP0007-IJ03951

Based on IBM(R) Tivoli(R) Monitoring, Version 6.3.0: Fix Pack 07


Contents:

1.0 General description
2.0 Problems fixed
3.0 Architecture and prerequisites
4.0 Image directory contents
5.0 Installation instructions
6.0 Additional Installation information
7.0 Known problems and workarounds
8.0 Additional product information
9.0 Notices

1.0 General description
=======================
This is a  Summarization and Pruning agent interim fix for ITM
Tivoli Monitoring, Version 6.3.0 Fix Pack 07.  The Summarization
and Pruning agent is also include with IBM Cloud Application
Performance Management Private.
This interim fix is provided as a temporary solution until an
official maintenance release is made available.

IMPORTANT NOTE: When performing any future code updates or maintenance,
it is critical that you validate that the APAR(s) from any previous
interim fixes are contained in the maintenance package you are
installing to avoid any code regressions. If there are any questions,
please contact L2 for support.


2.0 Problems fixed
==================
The following problems are addressed by this interim fix.

 2.1 APARs
 ---------

IJ03951
SUMMARIZATION AND PRUNING AGENT ENCOUNTERS DEADLOCKS.

IJ04032
ITM 6.3 FP7 SY AGENT FAILS TO PRUNE SUMMARIZED TABLES

IJ02036
REMOVE UNUSED TABLES FROM THE WAREHOUSE.

IJ01519
ABSTRACT: SY AGENT SHOWING TEPS DISCONNECTED STATUS

IV76613
WEEKLY DATA SUMMARIZATION IS INCORRECT

IV80325
REMOVE DELETION OF PARTITIONS FROM KSY TO RESOLVE DB2 ISSUE.

IV86928
KSY AGENT CANNOT CONNECT TO TEPS

IV89511
KSY AGENT CREATES PARTITIONS FOR REMOVED ATTRIBUTES

IV95343
AGTIME RESULTS IN TWO LAT_WRITETIME COLUMNS

IV96437
KSY DOES NOT CREATE PARTITIONS

218521
Enable TEPSDataProvider tracing from the Schema Tool


 2.2 Defects:
 ------------
 None.

 2.3 Enhancements:
 -----------------
 None.

 2.4 Superseded fixes:
 ---------------------
 None.

 2.5 APARS and defects included from superseded fixes
 ----------------------------------------------------    
 None.

 2.6 Files modified or added in this patch
 ----------------------------------------------------    

 lx8266
lx8266/bin/ksy.jar
lx8266/sy/bin/ksy610

 ls3266
ls3266/bin/ksy.jar
ls3266/sy/bin/ksy610

 aix536
aix536/bin/ksy.jar
aix536/sy/bin/ksy610
 wix64
TMAITM6\ksy.jar
TMAITM6_x64\ksy610.exe



3.0 Platforms and prerequisites
==================================
This interim fix is supported on the following platforms:


 lx8266      Linux Intel 2.6 kernel (64 bit all supported distributions)
 ls3266      Linux zSeries 2.6 kernel (64 bit all supported distributions)
 aix536      AIX 5.3 or later (64 bit)
 wix64       Windows 2003 or later (64 bit)

 The following link is for the Tivoli operating system and application
 support matrix. Please refer to this matrix for the latest
 certification information.

 http://www.ibm.com/software/sysmgmt/products/support/Tivoli_Supported_Platforms.html

 3.1 Prerequisites for this interim fix
 --------------------------------------
 
 This interim fix is intended to be applied to this level of software:
IBM Tivoli Monitoring, Version 6.3.0 Fix Pack 07
IBM Cloud Application Performance Management Base Private, Version 8.1.4.0
IBM Cloud Application Performance Management Advanced Private, Version 8.1.4.0


4.0 Files provided and Image contents
============================
- 6.3.0-TIV-ITM-FP0007-IJ03951.README - This README file
- 6.3.0-TIV-ITM-FP0007-IJ03951.tar - For extracting patch files using tar utility
- 6.3.0-TIV-ITM-FP0007-IJ03951.zip - For extracting patch files using unzip utility

  Extracting either of the above bundles (tar or zip) creates the following
  directory and patch files:

6.3.0-TIV-ITM-FP0007-IJ03951
|-- itmpatch.exe
|-- ksy_aix536_tema_ij03951.tar
|-- ksy_ls3266_tema_ij03951.tar
|-- ksy_lx8266_tema_ij03951.tar
|-- ksy_wix64_tema_ij03951.cab
|-- patchtool
`-- provpatch


                     
5.0 Installation instructions
=============================

 5.1 Before installing the interim fix
 -------------------------------------
 
 5.1.1 Assign CANDLEHOME environment variable (UNIX/LINUX ONLY)
 
 Before installing this interim fix on Unix systems, make sure that the
 environment variable $CANDLEHOME is set to the IBM Tivoli Monitoring
 installation directory or <install_dir>/sy  for the IBM Cloud APM server.

 Note: The directory /opt/IBM/ITM is the default installation directory
       for IBM Tivoli Monitoring.

   For example:
   > CANDLEHOME=/opt/IBM/ITM
   > export CANDLEHOME
 
 
 5.1.2 Determine the architecture of the target system.
 
 You need to determine the install architecture of the target system so that
 you can select the correct patch file(s) to apply to the system. To do this
 execute the following command for each patch component in the terminal
 window on your target system.
 Note: <pc> is the product code from the above listed patch file(s):

     k<pc>_<arch>_<component>_<apar>.<tar or cab>
 
 For Windows:
 
 kincinfo -t <pc>  
 
 
 For Linux and Unix:
 
 $CANDLEHOME/bin/cinfo -t <pc>
 
 Record the architecture information that is listed under the PLAT column which
 appears in the output.
 
 In the following example, the architecture information column lists WINNT as
 the architecture for the UE Product Code.
 
 C:\>kincinfo -t ue
 ************* Tuesday, May 24, 2011 3:38:15 PM **************
 User       : username              Group     : NA
 Host Name  : IBM-56C968D408C       Installer : Ver: 062205000
 CandleHome : C:\IBM\ITM
 Installitm : C:\IBM\ITM\InstallITM
 *************************************************************
 ...Product Inventory
 
 
 PC  PRODUCT DESC                                   PLAT   VER          BUILD         INSTALL DATE
 
 UE  Tivoli Enterprise Services User Interface Ext  WINNT  06.30.07.00  <DATENAME>        <YYYYMMDD> <TIME>

 5.1.3 Stopping affected IBM Tivoli Monitoring components

 The patch installation process will automatically stop most affected
 agent components. However you will have to manually stop the TEMS and the TEPS
 (product codes ms and cq respectively).  Note on Windows systems you will also
 need to stop the "Manage Tivoli Enterprise Monitoring Services" application if
 running.  Once the update is complete, components that were executing prior to
 this patch installation should be restarted with the exception of TEMS(ms) and
 TEPS(cq) which have to be manually started.
       
 5.1.4 Backup files to be modified
 
 For each patch applied, the patch installation will backup
 affected files as follows:

ksy_lx8266_tema_ij03951.tar     $CANDLEHOME/InstallITM/prov/06300700/ksy_lx8266_tema_pre-ij03951.tar
ksy_ls3266_tema_ij03951.tar     $CANDLEHOME/InstallITM/prov/06300700/ksy_ls3266_tema_pre-ij03951.tar
ksy_aix536_tema_ij03951.tar     $CANDLEHOME/InstallITM/prov/06300700/ksy_aix536_tema_pre-ij03951.tar
ksy_wix64_tema_ij03951.cab      %CANDLE_HOME%\InstallITM\prov\06300700\ksy_wix64_tema_pre-ij03951.cab
   
 5.1.5 Patch Installation Requirements

 This patch should be applied to the following entities of your IBM Tivoli
 Monitoring or IBM Cloud Application Performance Management Private environment.


Summarization and Pruning Agent


 Note: See "Required order of installation or upgrade of IBM Tivoli
       Monitoring component products" for general rules:

       "http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/advanced/searchView.jsp?searchWord=Required order of installation or upgrade of IBM Tivoli Monitoring"

 5.1.6 Additional information

 - The prerequisites listed under section 3.1 entitled 'Prerequisites
   for this interim fix' must be installed before this interim fix
   can be installed.

 5.2 Local interim fix installation
 ----------------------------------
 1. Transfer the appropriate archive file:
    6.3.0-TIV-ITM-FP0007-IJ03951.tar or 6.3.0-TIV-ITM-FP0007-IJ03951.zip
    to a temporary directory on the system that contains the code to be
    updated.  For the purpose of this README, the symbol <TEMP> represents
    the fully qualified path to this directory.
    Note: On Windows, this includes the drive letter.

 2. Expand the archive file using the tar command on UNIX systems or
    an unzip utility on Windows systems.  This creates a directory
    structure that contains fixes for all of the supported platforms.
   
 3. Use the provpatch(or itmpatch.exe for windows) command to install the interim fix for each platform.
    For more information on the provpatch(itmpatch) command, see section 6.1.      

    On a UNIX/Linux systems, if the provisional was expanded to <TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951,
    the install command for each <pc> and applicable platform would be:

<TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951/provpatch -h $CANDLEHOME
-i <TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951/ksy_lx8266_tema_ij03951.tar

<TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951/provpatch -h $CANDLEHOME
-i <TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951/ksy_ls3266_tema_ij03951.tar

<TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951/provpatch -h $CANDLEHOME
-i <TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951/ksy_aix536_tema_ij03951.tar

    On a Windows system, if the provisional was expanded to <TEMP>\6.3.0-TIV-ITM-FP0007-IJ03951,
    the install commands would be:

<TEMP>\6.3.0-TIV-ITM-FP0007-IJ03951\itmpatch -h %CANDLE_HOME%
-i <TEMP>\6.3.0-TIV-ITM-FP0007-IJ03951\ksy_wix64_tema_ij03951.cab
   

 5.3 Verifying the update
 ------------------------
 If the patch installs successfully, provpatch(itmpatch) should return the following
 message:

 "Command completed successfully"

 Finally, if the version of IBM Tivoli monitoring you are using supports it,
 (ITM 6.2.1 FP2 or later, ITM 6.2.2 FP1 or later) you can run the cinfo
 command with the -z option, which should print out the following messages
 On a UNIX/Linux systems, where $CANDLEHOME is the IBM Tivoli Monitoring
 installation directory.

 $CANDLEHOME/bin/cinfo -i -z

 will print one (or more) of the following:

   sy      Summarization and Pruning Agent
            lx8266  Version: 06.30.07.00
                            Patch: 6.3.0-TIV-ITM-FP0007  APARs:IJ03951,IJ04032,IJ02036,IJ01519,IV76613,IV80325,IV86928,IV89511,IV95343,IV96437,218521

   sy      Summarization and Pruning Agent
            ls3266  Version: 06.30.07.00
                            Patch: 6.3.0-TIV-ITM-FP0007  APARs:IJ03951,IJ04032,IJ02036,IJ01519,IV76613,IV80325,IV86928,IV89511,IV95343,IV96437,218521

   sy      Summarization and Pruning Agent
            aix536  Version: 06.30.07.00
                            Patch: 6.3.0-TIV-ITM-FP0007  APARs:IJ03951,IJ04032,IJ02036,IJ01519,IV76613,IV80325,IV86928,IV89511,IV95343,IV96437,218521    
 On a windows system.

 kincinfo -i -z

 will print one (or more) of the following:

   SY      Summarization and Pruning Agent
             WIX64  Version: 06.30.07.00 Build: d8032a
                       Patch: 6.3.0-TIV-ITM-FP0007  APARs:IJ03951,IJ04032,IJ02036,IJ01519,IV76613,IV80325,IV86928,IV89511,IV95343,IV96437,218521

 5.4 Remote interim fix installation (if applicable)
 ---------------------------------------------------

 Note: This section is only applicable if Descriptor Files (filenames which
 include the ".dsc" extension) accompany this interim fix and you are installing
 the interim fix for IBM Tivoli Monitoring.

 1. Transfer the appropriate archive file (6.3.0-TIV-ITM-FP0007-IJ03951.tar
    or .zip) to a temporary directory on the system that contains the
    code to be updated.  For the purpose of this README, the
    symbol <TEMP> represents the fully qualified path to this
    directory. Note: On Windows, this includes the drive letter.

 2. Expand the archive file using the tar command on UNIX systems or
    an unzip utility on Windows systems.  This creates a directory
    structure that contains fixes for all of the supported platforms.

 3. Add the patch to the TEMS Depot by executing the following command
   
    For Unix and Linux packages

    cd <TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951/unix

    For Windows packages

    cd <TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951

    tacmd addbundles -i . -n

 4. Record the "Version" number that is displayed as output from executing
    the addbundles command in step 3 above.

    Example:

Type         : Component
Product Code : tf
Deployable   : True
Version      : 063007065      <=== Record this value
Description  : 6.3.0-TIV-ITM-FP0007-IJ03951
Host Type    : aix523
Host Version : aix523,aix533
Prerequisites:

 5. Distribute the patch to the target machines requiring this patch by
    executing the following command on the HUB TEMS for Unix Systems

    $CANDLEHOME/bin/tacmd updateframework -n <Managed System Node Name:KUX> -v XXXXXXXXX

    and for Linux Systems

    $CANDLEHOME/bin/tacmd updateframework -n <Managed System Node Name:LZ> -v XXXXXXXXX

    and for Windows Systems

    %Candle_Home%/bin/tacmd updateframework -n <Managed System Node Name:NT> -v XXXXXXXXXX

    Note: You must be have previously issued the command to log onto the HUB TEMS
          prior to executing the above commands.
    Note: Where XXXXXXXXX is the Version value recorded from step 4 above.


6.0  Additional installation information
========================================


 6.1 Additional information on using provpatch(itmpatch) command
 ----------------------------------------------------
 The provpatch(itmpatch) command has the following syntax.

 Usage: <provpatch|itmpatch> -h <installation home> [OPTIONS]

 (provpatch|itmpatch) -h <installation home>
          -t { <patch_file_directory> | <patch_file> }
         
 <provpatch|itmpatch> -h <installation home>
          -i { <patch_file_directory> | <patch_file> }

 where

 -h  Specifies the IBM Tivoli Monitoring installation directory
 -i  Specifies the path to the directory or patch file to be installed
 -t  Generates a report of the actions to be taken by the patch

 For example, on a UNIX system:
 - To preview the interim fix installation, use the "-t" option:
   > <TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951/provpatch -h <CANDLEHOME> -t <TEMP>
   
 - To install the interim fix, use the "-i" option:
   > <TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951/provpatch -h <CANDLEHOME> -i <TEMP>
   
 where:  
 <CANDLEHOME> is the fully qualified IBM Tivoli Monitoring installation
 directory. On Windows, this must include the drive letter.
 <TEMP> represents the fully qualified directory specification, where
 the interim fix is located. On Windows, this must include the drive letter.

 6.2 Uninstalling the patch
 ---------------------------


 To uninstall the patch on UNIX/Linux systems, stop all affected components then
 execute the following commands for each applicable system:

<TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951/provpatch -h $CANDLEHOME
-i $CANDLEHOME/InstallITM/prov/06300700/ksy_lx8266_tema_pre-ij03951.tar

<TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951/provpatch -h $CANDLEHOME
-i $CANDLEHOME/InstallITM/prov/06300700/ksy_ls3266_tema_pre-ij03951.tar

<TEMP>/6.3.0-TIV-ITM-FP0007-IJ03951/provpatch -h $CANDLEHOME
-i $CANDLEHOME/InstallITM/prov/06300700/ksy_aix536_tema_pre-ij03951.tar

 To uninstall the patch on a Windows system, stop all affected components then
 execute the following commands for each applicable system:

<TEMP>\6.3.0-TIV-ITM-FP0007-IJ03951\itmpatch -h %CANDLE_HOME%
-i %CANDLE_HOME%\InstallITM\prov\06300700\ksy_wix64_tema_pre-ij03951.cab

7.0 Known problems and workarounds
==================================
None.
             
8.0 Additional product information
==================================
None.

9.0 Notices
===========
This information was developed for products and services offered in the United
States. IBM may not offer the products, services, or features discussed in this
document in other countries. Consult your local IBM representative for information
on the products and services currently available in your area. Any reference to
an IBM product, program, or service is not intended to state or imply that only
that IBM product, program, or service may be used. Any functionally equivalent
product, program, or service that does not infringe any IBM intellectual property
right may be used instead. However, it is the user's responsibility to evaluate
and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not grant you
any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION
"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING,   BUT NOT LIMITED TO,   THE IMPLIED WARRANTIES OF
NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Some states do not allow disclaimer of express or implied warranties in
certain transactions, therefore, this statement may not apply to you.

Trademarks and service marks
------------------------------------
IBM, the IBM logo, and ibm.com(R) are trademarks or registered trademarks
of International Business Machines Corp., registered in many jurisdictions
worldwide. Other product and service names might be trademarks of IBM or
other companies. A current list of IBM(R) trademarks is available on the
Web at "Copyright and trademark information" at
www.ibm.com/legal/copytrade.shtml.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks
of Microsoft Corporation in the United States, other countries, or
both.

Java and all Java-based trademarks are trademarks of Sun Microsystems,
Inc. in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States
and other countries.

Linux is a registered trademark of Linus Torvalds in the United States,
other countries, or both.

Other company, product, or service names may be trademarks or service
marks of others.