IBM Cloud Application Performance Management 8.1.4.0 core framework Interim Fix 3 README IBM Application Performance Management 8.1.4.0 8.1.4.0-IBM-APM-CORE-FRAMEWORK-APM-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 IBM Cloud Application Performance Management family of products, Version 8.1.4.0 until the official maintenance release is made available.

It includes fixes for
- the IBM Monitoring Shared Libraries used by all monitoring agents to upgrade from version 06.35.14.00, 06.35.14.01 or 06.35.14.02 to 06.40.00.00 .
- the jre used by all monitoring agents to upgrade from version 08.02.00.00, 08.04.01.00, 08.04.05.00, 08.04.10.00 or 08.05.05.00 to 08.05.15.00 .
- the IBM GSKit Security Interface used by all monitoring agent to upgrade to 08.00.50.88
- the server core framework directory to upgrade the IBM Monitoring Shared Libraries in AgentFrameworks directory from version 06.35.14.00, 06.35.14.01 or 06.35.14.02 to 06.40.00.00.
- the server core framework directory to upgrade the jre in AgentFrameworks directory from 08.02.00.00 or 08.04.01.00 or 08.04.05.00 or 08.04.10.00 or 08.05.05.00 to 08.05.15.00.
- the server core framework directory to upgrade IBM GSKit Security Interface in AgentFramework directory to 08.00.50.88

It also enables supported agents to be connected to IBM Cloud App Management. See this [link] for more details of supported agents with IBM Cloud App Management.
https://ibm.biz/app-mgmt-and-apm

Platforms and prerequisites
The agent core framework, and server core framework are supported on all agent and server platforms documented here.

Prerequisites for this interim fix

The interim fix for the agent core framework is intended to be applied to computer systems where monitoring agents are installed for

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

The interim fix for the server core framework component is intended to be applied to any of the following levels of Performance Management server software

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

The SAP NetWeaver Java Stack Agent users also need to apply SAP NetWeaver Java Stack Agent 814 IF01 if they would like to apply 814 core framework IF03.

None

Prior to installation

Monitoring agents must be installed and running before applying the agent core framework interim fix.
Performance Management Server must be installed before applying the server core framework interim fix.

Installing

The agent core framework patch is to be installed on the computer systems where your monitoring agents are already installed. The server core framework patch is installed on the computer system where the Performance Management server is installed. The server core framework patch updates the core framework that is included in agent installation images.

• If you need to apply the patch to already installed agents then follow the instructions for installing the agent patch on each agent system.
• If you want to create new agent packages that contain the agent core framework fixes so that the fixes are included when you install new agents or upgrade agents then follow the instructions for installing the core framework server patch.

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-CORE-FRAMEWORK-AIX-IF0003.tar
     
   • If the agent is installed on Linux for Power Systems (Little Endian), download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0003.tar
     
   • If the agent is installed on Linux for System x, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0003.tar
     
   • If the agent is installed on Linux for System z, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0003.tar
     
   • If the agent is installed on Windows 32-bit, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0003.zip
     
   • If the agent is installed on Windows 64-bit, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-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 agent(s)
     
   • Login as root, and run the slibclean command
     
   • Login as the non-root user who installed the agent(s) 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.4.0-IBM-APM-CORE-FRAMEWORK-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 install directory>]
   
   Windows:
   ./apmpatch.bat <APM agent install directory>
   
   The <APM agent install directory> parameter only needs to be provided if the agent is installed in a non-default directory on Linux and AIX. However, it is a required parameter for Windows.. This value is a required parameter for Windows.
   

1. Download the patch bundle 8.1.4.0-IBM-APM-SERVER-IF0003.tar file.


2. Unpack it


3. Enter the created directory.
   


4. Run the apmpatch.sh tool:
   ./apmpatch.sh
   
   
5. Run the following scripts that are described at the following link in the APM 8.1.4 Knowledge Center:
   http://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/com.ibm.pm.doc/install/install_agent_preconfig.htm
   
   • Run the <apm-server-home>/make_configuration_packages.sh script if you have not already created the configuration information for the agent installation packages.
   • Run the <apm-server-home>/configure_agent_images.sh script. Pass <apm-server-home>/ccm/AgentFrameworks as the value of the -a option.
     Note: The configure_agent_images.sh script updates your agent packages to include the patched agent core framework in <apm-server-home>/ccm/AgentFrameworks


6. Either use the configured agent packages to install new agents with the patched agent core framework or use the agent packages to upgrade the core framework for already installed agents. See these APM 8.1.4 Knowledge Center topics for more details on installing agents and upgrading agents
   
   
   • Installing agents on AIX systems
     
   • Installing agents on Linux systems
     
   • Installing agents on Windows systems
     
   • Upgrading your agents
     

Performing the necessary tasks after installation of the agent core framework update

A successful installation modifies the agent core framework version to 06.40.00.00, gs version is 08.00.50.88
On Linux or AIX:
- Ensure that the <APM-AGENT-HOME>/bin/cinfo -t output for verify that the ax version is 06.40.00.00, gs version is 08.00.50.88, and the jr component version is 08.05.15.00.
- The agent interim fix installation logs are written to the <APM-AGENT-HOME>/logs/ directory.

On Windows:
- Ensure that the <APM-AGENT-HOME>\InstallITM\kincinfo -i command shows that the TEMA component version is 06.40.00.00, the gs component version is 08.00.50.88, and the JM component version is 08.05.15.00.
- 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.4/com.ibm.pm.doc/install/trouble_intro.htm

Uninstalling if necessary

This 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 Cloud Application Performance Management guide, here:
http://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/com.ibm.pm.doc/install/uninstall_agents.htm

The Secure Hash Algorithm 1 (SHA1) checksum of the images are as follows:
SHA1(8.1.4.0-IBM-APM-CORE-FRAMEWORK-AIX-IF0003.tar) = 93d1e4028fdb139dcc3fa1f11326175dcf0f4127
SHA1(8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0003.zip) = 1c4b75a2971df36524891fd3399cba980fa9ad6d
SHA1(8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN64-IF0003.zip) = 293b27b2ce58e48f87dc770734f812e79885fb8f
SHA1(8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0003.tar) = 18f36a5493baf1fba79212e13abed495b58eb2cc
SHA1(8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0003.tar) = b9c0d31c47022d818065ad3c5647a5bbbe43b8d1
SHA1(8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0003.tar) = 9792480e2167743d3970176ab71e8396557b0e0f
SHA1(8.1.4.0-IBM-APM-SERVER-IF0003.tar) = f87753dbd21a3c5a758fc7c954a9158102ad3dc9

Image Contents
The following files implement this fix.
- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-IF0003.readme.html - This README file

- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-AIX-IF0003.tar

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

8.1.4.0-IBM-APM-CORE-FRAMEWORK-AIX-IF0003/
|-- apmpatch.sh
|-- patches
|-- patch.properties

- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0003.zip

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

8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0003/
|-- apmpatch.bat
|-- patches
|-- patch.properties

- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN64-IF0003.zip

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

8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN64-IF0003/
|-- apmpatch.bat
|-- patches
|-- patch.properties

- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0003.tar

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

8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0003/
|-- apmpatch.sh
|-- patches
|-- patch.properties

- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0003.tar

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

8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0003/
|-- apmpatch.sh
|-- patches
|-- patch.properties

- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0003.tar

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

8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0003/
|-- apmpatch.sh
|-- patches
|-- patch.properties

- 8.1.4.0-IBM-APM-SERVER-IF0003.tar

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

8.1.4.0-IBM-APM-SERVER-IF0003/
|-- apmpatch_functions
|-- apmpatch.bat
|-- apmpatch_prefix
|-- msg
|-- nls_replace
|-- patches
|-- patch.properties

New Features

The following new features are included in IBM Cloud Application Performance Management 8.1.4.0 Core Framework Interim Fix 3:

• Defect fixes and other stability improvements

The following problems are addressed by this interim fix.

APARs

• IJ05691: The reported time in the kincinfo header may be off by one hour with Japanese loca

• 130857: Uplift GSKit to 8.0.50.88 for PSIRT 10679
• 131157: agent2server.sh -f option needs to copy all keyfiles to agent system
• 133230: Uplift JRE version to 8.0.5.15 for PSIRT 11819
• 133577: Include 32-bit JRE in agent framework for WIN32

• Enables supported agents to be connected to IBM Cloud App Management.
  

• None

• IV98883: The agent2server.sh may start agents using the wrong user id.
• IJ00965: Failed to stop agent during upgrade
• IJ00973: Fix the agent installation isuue caused by special characters validation
• IJ01900: Kcirunas.cfg file should not be over-written

• 114957: DB2 event missing details when sent to Alert Notification.
• 123708: If the agent downloads a bad event destination file then it stops sending events to the APM server.
• 124187: Fix lock handling of private situation files to prevent the agent from crashing and not updating the active private situation file if the agent detects a modified situation file when it is restarted.
• 124264: If the OS watchdog restarts a non-factory agent, the agent may download its threshold file to the wrong directory and will not trigger events.
• 125222: Uplift Java to 8.0.4.10
• 125424: Change extension pack license to agent license.
• 125602: Exchange agent is unable to re-point agent to the new MIN using agent2server.bat.
• 125688: No events generated for Websites (SLA subscription)
• 129633: Uplift JRE packaged by agent installer to 8.0.5.5
• 126719: Improve regular expression evaluation in APM situations
• 129757: Further improvements in regular expression evaluation
• 129793: Fix potential TEMA crash where TEMA referenced freed memory from a situation definition