IBM Support

Response Time Monitoring Agent for IBM Application Performance Management 8.1.4.0 interim fix 13 readme file

Fix Readme


Abstract

Readme file for Response Time Monitoring Agent for IBM Application Performance Management 8.1.4.0 interim fix 13
Product - Component Release: 8.1.4.0
Update Name: 8.1.4.0-IBM-APM-RT-AGENT-IF0013
Fix ID: 8.1.4.0-IBM-APM-RT-AGENT-IF0013
Publication Date: 26 August 2022
Last modified date: 26 August 2022

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 first log in to IBM Fix Central (http://www.ibm.com/support/fixcentral/).

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

Here is a list of components, platforms, and file names that apply to this readme file.

Product - Component Name Platform Fix
IBM Application Performance Management Response Time Monitoring agent Linux x86_64
Linux IBM Z
AIX POWER system
Windows

  

  

 

Prerequisites and co-requisites

General description 

This interim fix is for the Response Time Monitoring agent provided with the IBM Cloud Application Performance Management version 8.1.4.0 family of products. It upgrades the Response Time Monitoring agent to version 08.22.08.00.

Platforms and prerequisites 

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

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

IBM Cloud Application Performance Monitoring Base Private, Version 8.1.4.0
IBM Cloud Application Performance Monitoring Advanced Private, Version 8.1.4.0

IBM Cloud Application Performance Monitoring Base, Version 8.1.4.0
IBM Cloud Application Performance Monitoring Advanced, Version 8.1.4.0.

Note: 1. Application Performance Management server patch 8.1.4.0-IBM-APM-SERVER-IF0011 or higher is required on the APM server, before installing 8.1.4.0-IBM-APM-RT-AGENT-IF0011 or higher to the WRT agent.
2. If the WRT agent enables IBM HTTP Server Response Time module, it is recommended to apply 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-IF0005 or higher for the Monitoring Agent for HTTP Server.

Known issues

None

Known limitations

None

Installation information

Prior to installation

The Response Time Monitoring agent must be installed before you are 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.4.0-IBM-APM-RT-AGENT-AIX-IF0013.tar
    • If the agent is installed on Linux for System x, download 8.1.4.0-IBM-APM-RT-AGENT-XLINUX-IF0013.tar
    • If the agent is installed on Linux for System z, download 8.1.4.0-IBM-APM-RT-AGENT-ZLINUX-IF0013.tar
    • If the agent is installed on Windows, download 8.1.4.0-IBM-APM-RT-AGENT-WIN64-IF0013.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.
    For example
    tar -xf 8.1.4.0-IBM-APM-RT-AGENT-XLINUX-IF0013.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>] 

    Windows:
    .\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 needs to be provided only 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.22.08.00.

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

On Windows:
- Ensure that version number 08.22.08.00 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, refer to the IBM Performance Management guide, here: 
http://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/com.ibm.pm.doc/install/uninstall_agents.htm 

 

Troubleshooting installation problems from the Support site

For more information, refer to the troubleshooting and support guide: 
http://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/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.4.0-IBM-APM-RT-AGENT-AIX-IF0013.tar)= 7C45D0CBAE9639C460C6DA6274739E5EADFA68DCBC47474DCA10BAD6FD1D051D

SHA256(8.1.4.0-IBM-APM-RT-AGENT-XLINUX-IF0013.tar)= C9C66B92388B0FBCACA47C76B39328041AEE8EE6B5812F7615422E71FAB6708C

SHA256(8.1.4.0-IBM-APM-RT-AGENT-ZLINUX-IF0013.tar)= A9803DE23DDEF9B24D071A457854E4B6EB857D822BCEA5546CB759476F974C80

SHA256(8.1.4.0-IBM-APM-RT-AGENT-WIN64-IF0013.zip)= 2484321F132E601C74AAFA42189AFD5FF71EDF19B38BCDF94277CBB9C9A50912

Image Contents 

The following files implement this fix:

- 8.1.4.0-IBM-APM-RT-AGENT-IF0013.readme.html - This readme file

- 8.1.4.0-IBM-APM-RT-AGENT-AIX-IF0013.tar - For extracting patch files use the tar utility.
Extracting the bundle (.tar) creates the following directory and patch files:
8.1.4.0-IBM-APM-RT-AGENT-AIX-IF0013/
|-- apmpatch.sh
|-- patches
|-- patch.properties
 
- 8.1.4.0-IBM-APM-RT-AGENT-XLINUX-IF0013.tar - For extracting patch files use the tar utility.
Extracting the bundle (.tar) creates the following directory and patch files:
8.1.4.0-IBM-APM-RT-AGENT-XLINUX-IF0013/
|-- apmpatch.sh
|-- patches
|-- patch.properties
 
- 8.1.4.0-IBM-APM-RT-AGENT-ZLINUX-IF0013.tar - For extracting patch files use the tar utility.
Extracting the bundle (.tar) creates the following directory and patch files:
8.1.4.0-IBM-APM-RT-AGENT-ZLINUX-IF0013/
|-- apmpatch.sh
|-- patches
|-- patch.properties
 
- 8.1.4.0-IBM-APM-RT-AGENT-WIN64-IF0013.zip - For extracting patch files use the tar utility.
Extracting the bundle (.zip) creates the following directory and patch files:
8.1.4.0-IBM-APM-RT-AGENT-WIN64-IF0013/
|-- apmpatch.bat
|-- patches
|-- patch.properties
 

New Features

  • None

List of fixes

The following problems are addressed by this interim fix.

APARs 
  • None
 
Agent defects:
  • 146546: D - PSIRT PRD0003571 Open Source SQLite Vulnerabilities CVE-2021-45346 for 8.1.4
  • 146547: D - PSIRT PRD0003571 Open Source zlib Vulnerabilities CVE-2018-25032 - 8.1.4
  • 146548: T - RT - Add AIX 7.3, RHEL 9 and  Windows 2022 support

Enhancements included from previous interim fixes:
  • 144768: T - WRT - Add Windows 2019 support
  • 140276: T - WRT - Enable agent configuration in console when agent is configured in HTTP module mode
  • 140144: T - WRT - Update PII for Worst by User - Top 20 group widget
  • 139804: T - WRT - Change existing "Worst by User - Top 5" group widget to "Worst by User - Top 20" group widget
  • 139167: UTF8 string support of AAR transactionName
  • 139160: US - As a real user, I want the WRT agent to run on RHEL 8.x
  • 138683: RFE: Add new KT5AARIPTOUSERID property to save Client IP address in userID property of AAR
  • 136899: T - WRT - Add request status code attributes in asf definition

APARs and defects included in previous interim fixes: 
  • APARs
    • IJ22072: ClientTime memory leak issue in TS002765697
    • IJ17319: [TS002141436] RT AGENT FAIL TO SEND AN ASF ENVELOPE MESSAGE WHEN TRANSACTIONNAME CONTAIN UTF-8 CHARACTERS
    • IJ12192: APM 8.1.4 RT AGENT RECONFIGURATION OF TRACKING METHODS (USER/SESSION) FAILS "AGENT CONFIGURATION NOT AVAILABLE AT THIS TIME"
    • IJ08208: FAILED TO CHANGE THE VALUE FOR RESPONSE TIME AGENT AT AGENT CONFIGURATION IN APM UI
    • IJ05477: NO DATA DISPLAYED IN THE REQUESTS AND RESPONSE TIME WIDGET
  • Agent defects:
    • 144767: D - PSIRT PVR0265747 Open Source SQLite Vulnerabilities CVE-2021-20227 for 8.1.4.
    • 142871: D - PSIRT ADV0025370 Open Source SQLite Vulnerabilities CVE-2020-15358 for 8.1.4
    • 140557: 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.4.x
    • 140262: [81410_GVT] "User" is hard coded on Worst by User - Top 20" widget
    • 139684: D - PSIRT ALERT: 18003 Open Source SQLite Vulnerabilities CVE-2019-16168 8.1.4.x
    • 139440: D - WRT - Agent configuration cant exit on windows when enable configuration for configured agent by force
    • 138362: D - PSIRT ALERT: 161901 Open Source SQLite Vulnerabilities CVE-2019-8457 8.1.4.x
    • 138078: Add debug message in WebPluginProcessor::ProcessChannel for IIS RT module
    • 137673: Truncate the componentName to less than 64 char length
    • 137215: D - PSIRT ALERT: 14951 Open Source SQLite Vulnerabilities CVE-2018-20346- 8.1.4
    • 136700: Invalid finish time leads to get ERROR processing timestamp in AAR
    • 135579: D - Incorrect information shown in online help of End User Transactions dashboard
    • 135513: Update Java and MS Authenticode Certificates for 8.1.4.0.6
    • 134972: D-WRT: SDA does not work on windows platform
    • 134843: D-8140SVT: WRT agents not showing data in the ui
    • 134503: Update the 8140 doc to indicate that you can configure MongoDB to see Middleware Instance Details from more than 4 hours ago
    • 133883: D-8140SVT: WRT agent data gets out of sync by about 8 hours at times
    • 133047: Response time and TT online help does not define good versus slow response time and that it is not configurable
    • 132566: 11534 Open Source SQLite Vulnerabilities CVE-2018-8740 - 8.1.4.x
    • 130743: on-prem - v8.1.4 IF3- Cross-Site Request Forgery - /ResponseTimeAgentTab/*
    • 129673: Cannot read application for WRT
    • 129181: RT agent can't be installed on GVT Windows environment
    • 129142: New string in Agent Configuration's Response Time tab must be translated
    • 129127: on-prem - v8.1.4 IF2- ResponseTimeAgentTab/RTAgentPropServlet
    • 126864: [APM814_WRT] WRT Dashboard shows mock strings after product released
    • 124833: D - PSIRT ALERT: 9137 Open Source SQLite Vulnerabilities CVE-2017-10989 - 8.1.4
    • 31367: Check in translated files for APM8.1.4.0.2- RT config
    • 31346: Check in mock/ translated files for APM8.1.4.0.1- RT
    • 142278: D - PSIRT ADV0023757 Open Source SQLite Vulnerabilities CVE-2020-11656 CVE-2020-11655

Document change history

Version Date Description of change
1.0 18 August 2022 Initial Version

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSVJUL","label":"IBM Application Performance Management"},"ARM Category":[{"code":"a8m500000008b2VAAQ","label":"Response Time Monitoring"}],"Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions"}]

Document Information

Modified date:
26 August 2022

UID

ibm16613561

Page Feedback