IBM Performance Management 8.1.3.0 Interim Fix 3 README IBM Application Performance Management 8.1.3.0 8.1.3.0-IBM-IPM-RT-AGENT-IF0003 Readme

IMPORTANT NOTE: To download this update, you must first login to IBM Fix Central. Once logged in, you may select from the individual download packages. When selecting fixes, ensure your download options are set to "Include requisites: Yes".
http://www.ibm.com/support/fixcentral/

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

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.02

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

None

None

Prior to installation

The Response Time Monitoring agent must be installed before applying the agent 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-IF0003.tar
     
   • If the agent is installed on Linux, download 8.1.3.0-IBM-IPM-RT-AGENT-XLINUX-IF0003.tar
     
   • If the agent is installed on Windows, download 8.1.3.0-IBM-IPM-RT-AGENT-WIN64-IF0003.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-IF0003.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 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.02.
On Linux or AIX:
- Ensure that the <APM-AGENT-HOME>/bin/cinfo -t output for the Response Time Monitoring agent is '08.13.01.02'.
- The agent interim fix installation logs are written to the <APM-AGENT-HOME>/logs/ directory.

On Windows:
- Ensure that version number 08.13.01.02 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.

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

Uninstalling if necessary

This agent maintenance package cannot be rolled back. If necessary you can uninstall and reinstall the monitoring agent and all appropriate 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.3/com.ibm.pm.doc/install/uninstall_agents.htm

The Secure Hash Algorithm 1 (SHA1) checksum of each image image is as follows:
SHA1(8.1.3.0-IBM-IPM-RT-AGENT-AIX-IF0003.tar)= 2a35e207b62fa47d74e9f914b4f88489efecea81
SHA1(8.1.3.0-IBM-IPM-RT-AGENT-XLINUX-IF0003.tar)= dce0d1fee02ed29d6a678c0dbc00ac5cd957da1b
SHA1(8.1.3.0-IBM-IPM-RT-AGENT-WIN64-IF0003.zip)= b2a24549110a7219e88b8c3beb2e8f843b8093a4

Image Contents
The following files implement this fix:
- 8.1.3.0-IBM-IPM-RT-AGENT-IF0003.readme.html - This README file

- 8.1.3.0-IBM-IPM-RT-AGENT-AIX-IF0003.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-IF0003/
|-- apmpatch.sh
|-- patches
|-- patch.properties

- 8.1.3.0-IBM-IPM-RT-AGENT-XLINUX-IF0003.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-IF0003/
|-- apmpatch.sh
|-- patches
|-- patch.properties

- 8.1.3.0-IBM-IPM-RT-AGENT-WIN64-IF0003.zip - For extracting patch files use the Windows extract utility

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

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

New Features

The following changes are included in the IBM Response Time Monitoring agent for Performance Management 8.1.3.0 Interim Fix 03:

• Defect fixes and other stability improvements

The following problems are addressed by this interim fix.

APARs
None


Agent defects:
125220: D - PSIRT ALERT: 9137 Open Source SQLite Vulnerabilities CVE-2017-10989 - 8.1.3.x

Enhancements:
None

APARS and defects from superseded component patches and/or from component patches included in previous interim fixes:
101156: (CVE-2016-0729) Open Source Apache Xerces-C XML parser vulnerabilities.
109995: Fix a SQL Lite vulnerability
110342: Include updated version of Xerces