Download
Abstract
This interim fix updates the Summarization and Pruning Agent (SY) of IBM Tivoli Monitoring and IBM Cloud Application Performance Management Private with APAR fix IJ03951 as well
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.
Installation Instructions
Refer to the README file located in Fix Central for additional information.
Problems (APARS) fixed
Was this topic helpful?
Document Information
Modified date:
15 June 2018
UID
swg24044625