Fix Readme
Abstract
Readme file for: Response Time Monitoring Agent for IBM Application Performance Management 8.1.4.0 Interim Fix 8
Product/Component Release: 8.1.4.0
Update Name: 8.1.4.0-IBM-APM-RT-AGENT-IF0008
Fix ID: 8.1.4.0-IBM-APM-RT-AGENT-IF0008
Publication Date: 19 Dec 2019
Last modified date: 19 Dec 2019
Content
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 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 s390 | ||
| AIX pSeries | ||
| Windows |
Prerequisites and co-requisites
General description
This is an interim fix 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.19.12.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 is intended to 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. APM server patch 8.1.4.0-IBM-APM-SERVER-IF0008 or higher is required to applied to APM server before install 8.1.4.0-IBM-APM-RT-AGENT-IF0008 to WRT agent.
2. It's suggested to apply 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-IF0003 or higher for Monitoring Agent for HTTP Server if the WRT agent enables IBM HTTP Server Response Time module.
Known issues
None
Known limitations
None
Installation information
Prior to installation
Installing
Installing the agent interim fix
- 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-IF0008.tar
- If the agent is installed on xLinux, download 8.1.4.0-IBM-APM-RT-AGENT-XLINUX-IF0008.tar
- If the agent is installed on zLinux, download 8.1.4.0-IBM-APM-RT-AGENT-ZLINUX-IF0008.tar
- If the agent is installed on Windows, download 8.1.4.0-IBM-APM-RT-AGENT-WIN64-IF0008.zip
-
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
- 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.4.0-IBM-APM-RT-AGENT-XLINUX-IF0008.tar - Enter the created directory
- 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.19.12.00.
On Linux or AIX:
- Ensure that the <APM-AGENT-HOME>/bin/cinfo -t output for the Response Time Monitoring agent is '08.19.12.00'.
- The agent interim fix installation logs are written to the <APM-AGENT-HOME>/logs/ directory.
On Windows:
- Ensure that version number 08.19.12.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, please 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 detailed 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-IF0008.tar)= 86af58ac80b9ddcfbeb2cc2872a326516b24b409efc80b750dfd038761677928
SHA256(8.1.4.0-IBM-APM-RT-AGENT-XLINUX-IF0008.tar)= 01975fd1139e23044f298dda9e1e29e182ca193f35204f4c199ef42d12f1148d
SHA256(8.1.4.0-IBM-APM-RT-AGENT-ZLINUX-IF0008.tar)= a4871b3d7098a6dffff27ce645f7ec4d279af9ba44b6ef5adf0d5e8763bfc2dc
SHA256(8.1.4.0-IBM-APM-RT-AGENT-WIN64-IF0008.zip)= 5a5d13281e7fbe290908b80464160af6183dc22aae25dcccded4d0b44be0ec97
Image Contents
The following files implement this fix:
- 8.1.4.0-IBM-APM-RT-AGENT-IF0008.readme.html - This README file
- 8.1.4.0-IBM-APM-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.4.0-IBM-APM-RT-AGENT-AIX-IF0008/
|-- apmpatch.sh
|-- patches
|-- patch.properties
- 8.1.4.0-IBM-APM-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.4.0-IBM-APM-RT-AGENT-XLINUX-IF0008/
|-- apmpatch.sh
|-- patches
|-- patch.properties
- 8.1.4.0-IBM-APM-RT-AGENT-ZLINUX-IF0008.tar - For extracting patch files use the tar utility.
Extracting the above bundle (.tar) creates the following directory and patch files:
8.1.4.0-IBM-APM-RT-AGENT-ZLINUX-IF0008/
|-- apmpatch.sh
|-- patches
|-- patch.properties
- 8.1.4.0-IBM-APM-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.4.0-IBM-APM-RT-AGENT-WIN64-IF0008/
|-- apmpatch.bat
|-- patches
|-- patch.properties
New Features
- 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 groupwidget
- 139804: T - WRT - Change existing "Worst by User - Top 5" groupwidget to "Worst by User - Top 20" groupwidget
List of fixes
The following problems are addressed by this interim fix.
- None
- 140262: [81410_GVT] "User" is hard code 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
- 31346: Check in mock/ translated files for APM8.1.4.0.1- RT
Enhancements included from previous interim fixes:
- 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
- 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:
- 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 finishtime lead 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 / TT online help does not define good vs. 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: Can not 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 should be translated
- 129127: on prem - v8.1.4 IF2- ResponseTimeAgentTab/RTAgentPropServlet
- 126864: [APM814_WRT] WRT Dashboard show 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
Document change history
| Version | Date | Description of change |
| 1.0 | 19 Dec 2019 | Initial Version |
Was this topic helpful?
Document Information
Modified date:
22 December 2019
UID
ibm11137376