IBM Support

Response Time Monitoring Agent for IBM Application Performance Management 8.1.3.0 Interim Fix 8 Readme

Fix Readme


Abstract

Readme file for: 8.1.3.0-IBM-IPM-RT-AGENT-IF0008
Product/Component Release: 8.1.3.0
Update Name: 8.1.3.0-IBM-IPM-RT-AGENT-IF0008
Fix ID: 8.1.3.0-IBM-IPM-RT-AGENT-IF0008
Publication Date: 23 Mar 2020
Last modified date: 23 Mar 2020

Content

Download location
Prerequisites and co-requisites
Known issues
Known limitations
Installation information
Installing
Troubleshooting installation problems from the Support site
Additional information
New Features
List of fixes
Document change history

Download location

1. To download this update, you must first login to IBM Fix Central (http://www.ibm.com/support/fixcentral/).

2. There are three download options on Fix Central: Download Director, FTPS/SFTP and Using your browser (HTTPS). If you want to download individual packages, you need choose FTPS/SFTP or HTTPS, since Download Director will download all.

Below is a list of components, platforms, and fix names that apply to this Readme file.

Product / Component Name Platform Fix
IBM Performance Management Response Time Monitoring agent Linux x86_64
AIX pSeries
Windows

  

Prerequisites and co-requisites

General description 

This is an interim fix for the Response Time Monitoring agent provided with the Performance Management version 8.1.2.0/8.1.3.0 family of products and the IBM Performance Management on Cloud family of products. It upgrades the Response Time Monitoring agent to version 08.13.01.07

Platforms and prerequisites 

The Response Time Monitoring agent is supported on the platforms documented here.

The interim fix for the Response Time Monitoring agent is intended to be applied to the Response Time Monitoring agent which is provided with:

IBM Monitoring, Versions 8.1.2.0 and 8.1.3.0
IBM Application Performance Monitoring, Versions 8.1.2.0 and 8.1.3.0
IBM Application Performance Monitoring Advanced, Versions 8.1.2.0 and 8.1.3.0
IBM Performance Management on Cloud

Known issues

None

Known limitations

None

Installation information

Prior to installation

The Response Time Monitoring agent must be installed before applying the interim fix.

  

Installing

Installing the agent interim fix

  1. Download the patch bundle from Fix Central for each OS type where your agent is installed:  
    • If the agent is installed on AIX, download 8.1.3.0-IBM-IPM-RT-AGENT-AIX-IF0008.tar
    • If the agent is installed on Linux, download 8.1.3.0-IBM-IPM-RT-AGENT-XLINUX-IF0008.tar
    • If the agent is installed on Windows, download 8.1.3.0-IBM-IPM-RT-AGENT-WIN64-IF0008.zip
  2. If you are installing the patch on AIX as a non-root user, you must clear unused shared libraries from the kernel and library memory before you install the patch by following these steps:

    • Stop the Response Time Monitoring agent
    • Login as root, and run the slibclean command
    • Login as the non-root user who installed the agent and continue with the patch installation
  3. Unpack the patch bundle on each computer system where the agent is already installed by using the tar utility on Linux/AIX or unzip on Windows.
    e.g.
    tar -xf 8.1.3.0-IBM-IPM-RT-AGENT-XLINUX-IF0008.tar
  4. Enter the created directory 
     
  5. Run the apmpatch.sh/bat tool as the same user who installed the agent: 

    Linux/AIX:
    ./apmpatch.sh [<APM-AGENT-HOME>] 

    Widnows:
    ./apmpatch.bat <APM-AGENT-HOME> 

    where the <APM-AGENT-HOME> value specifies the directory where the agent is installed. This value is a required parameter for Windows. However, for Linux and AIX, it only needs to be provided if the agent is installed in a non-default directory.
 

Performing the necessary tasks after installation

A successful installation modifies the Response Time Monitoring Agent version to 08.13.01.07.

On Linux or AIX:
- Ensure that the <APM-AGENT-HOME>/bin/cinfo -t output for the Response Time Monitoring agent is '08.13.01.07'.
- The agent interim fix installation logs are written to the <APM-AGENT-HOME>/logs/ directory.

On Windows:
- Ensure that version number 08.13.01.07 is displayed for the Response Time Monitoring agent on the Performance Management window.
- The agent interim fix installation logs are written to the <APM-AGENT-HOME>\INSTALLITM\ directory.

Uninstalling if necessary

This agent maintenance package cannot be rolled back. If necessary you can uninstall and reinstall the monitoring agent and patches.

For detailed instructions to uninstall monitoring agents, please refer to the IBM Performance Management guide, here: 
https://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.3/com.ibm.pm.doc/install/uninstall_agents.htm 

Troubleshooting installation problems from the Support site

For more detailed information, refer to the Troubleshooting and support Guide: 
http://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.3/com.ibm.pm.doc/install/trouble_intro.htm  

Additional information

The Secure Hash Algorithm 256 (SHA256) checksum of the image is as follows:
SHA256(8.1.3.0-IBM-IPM-RT-AGENT-AIX-IF0008.tar)= 4ebaaa504b96251600a3c557d1284e6d84da76334691062108527cfba7093649

SHA256(8.1.3.0-IBM-IPM-RT-AGENT-XLINUX-IF0008.tar)= 5c86ee36ed3d085b70e5a43168756e2f5db02fcb0e6b0663557452ab0f17dd7e

SHA256(8.1.3.0-IBM-IPM-RT-AGENT-WIN64-IF0008.zip)= cd9ebbbf4ee25e0aeb07656e23f6abad62db37782d51595e438abacf3507b40d

Image Contents 

The following files implement this fix:

- 8.1.3.0-IBM-IPM-RT-AGENT-IF0008.readme.html - This README file

- 8.1.3.0-IBM-IPM-RT-AGENT-AIX-IF0008.tar - For extracting patch files use the tar utility.

Extracting the above bundle (.tar) creates the following directory and patch files:

8.1.3.0-IBM-IPM-RT-AGENT-AIX-IF0008/
|-- apmpatch.sh
|-- patches
|-- patch.properties
 
- 8.1.3.0-IBM-IPM-RT-AGENT-XLINUX-IF0008.tar - For extracting patch files use the tar utility.

Extracting the above bundle (.tar) creates the following directory and patch files:

8.1.3.0-IBM-IPM-RT-AGENT-XLINUX-IF0008/
|-- apmpatch.sh
|-- patches
|-- patch.properties
 
- 8.1.3.0-IBM-IPM-RT-AGENT-WIN64-IF0008.zip - For extracting patch files use the tar utility.

Extracting the above bundle (.zip) creates the following directory and patch files:

8.1.3.0-IBM-IPM-RT-AGENT-WIN64-IF0008/
|-- apmpatch.bat
|-- patches
|-- patch.properties
 

New Features

  • None

List of fixes

The following problems are addressed by this interim fix.

APARs 
  • 141227: D - WRT - IJ22072 ClientTime memory leak issue in TS002765697 for v8.1.3
 
Agent defects: 
  • 140995: D - PSIRT ADV0021246 SQLite Vulnerabilities CVE-2019-19925, CVE-2019-19645, CVE-2019-19603, CVE-2019-19924, CVE-2019-19923, CVE-2019-19880, CVE-2019-19646, CVE-2019-19926 8.1.3.x

Enhancements included from previous interim fixes: 
  • None

APARs and defects included in previous interim fixes: 
  • 140472: D - PSIRT ALERT: 18003 Open Source SQLite Vulnerabilities CVE-2019-16168 8.1.3.x
  • 138365: D - PSIRT ALERT: 16663 Open Source SQLite Vulnerabilities CVE-2019-8457 8.1.3.x
  • 137258: D - PSIRT ALERT: 14951 Open Source SQLite Vulnerabilities CVE-2018-20346- 8.1.3.x
  • 132565: D - PSIRT ALERT: 11534 Open Source SQLite Vulnerabilities CVE-2018-8740 - 8.1.3.x
  • 125220: D - PSIRT ALERT: 9137 Open Source SQLite Vulnerabilities CVE-2017-10989 - 8.1.3.x
  • 110342: Include updated version of Xerces
  • 109995: Fix a SQL Lite vulnerability
  • 101156: (CVE-2016-0729) Open Source Apache Xerces-C XML parser vulnerabilities.

 

Document change history

Version Date Description of change
1.0 23 Mar 2020 Initial Version

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSVJUL","label":"IBM Application Performance Management"},"Component":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.1.3.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
29 March 2020

UID

ibm16115864