IBM Support

IBM Cloud Application Performance Management 8.1.4.0 core framework Interim Fix 2 README IBM Application Performance Management 8.1.4.0 8.1.4.0-IBM-APM-CORE-FRAMEWORK-APM-IF0002 Readme

Readme file for: 8.1.4.0-IBM-APM-CORE-FRAMEWORK-APM-IF0002
Product/Component Release: 8.1.4.0
Update Name: 8.1.4.0-IBM-APM-CORE-FRAMEWORK-APM-IF0002
Fix ID: 8.1.4.0-IBM-APM-CORE-FRAMEWORK-AIX-IF0002, 8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0002, 8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0002, 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0002, 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN64-IF0002, 8.1.4.0-IBM-APM-SERVER-CORE-FRAMEWORK-IF0002, 8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0002
Publication Date: 26 January 2018
Last modified date: 26 January 2018

Download location

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.

Fix Download for AIX

Product/Component Name: Platform: Fix:
IBM Application Performance Management AIX pSeries
8.1.4.0-IBM-APM-CORE-FRAMEWORK-AIX-IF0002

Fix Download for Linux

Product/Component Name: Platform: Fix:
IBM Application Performance Management Linux ppc64le
8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0002
IBM Application Performance Management Linux x86_64
8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0002
IBM Application Performance Management Linux x86_64
8.1.4.0-IBM-APM-SERVER-CORE-FRAMEWORK-IF0002
IBM Application Performance Management Linux s390x
8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0002

Fix Download for Windows

Product/Component Name: Platform: Fix:
IBM Application Performance Management Windows
8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0002
IBM Application Performance Management Windows
8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN64-IF0002

Prerequisites and co-requisites

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 agent core framework used by all monitoring agents to upgrade from version 06.35.14.00 or 06.35.14.01 to 06.35.14.02.
- the server core framework directory to upgrade the AgentFrameworks directory from version 06.35.14.00 or 06.35.14.01 to 06.35.14.02.

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

Known issues

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

Known limitations

None

Installation information

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.

Installing the agent patch on each agent system
Note: The agent must already be installed before applying the patch. It will be restarted as part of applying the 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-IF0002.tar
    • If the agent is installed on Linux for Power Systems (Little Endian), download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0002.tar
    • If the agent is installed on Linux for System x, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0002.tar
    • If the agent is installed on Linux for System z, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0002.tar
    • If the agent is installed on Windows 32-bit, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0002.zip
    • If the agent is installed on Windows 64-bit, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN64-IF0002.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-IF0002.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.


Installing the core framework server patch on the Performance Management server

  1. Download the patch bundle 8.1.4.0-IBM-APM-SERVER-IF0002.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

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

A successful installation modifies the agent core framework version to 6.35.14.02 and the JR to 08.05.05.00.
On Linux or AIX:
- Ensure that the <APM-AGENT-HOME>/bin/cinfo -t output for the ax agent version is '06.35.14.02' and jr version is 08.05.05.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 06351402 and the jvm component version is 08.05.05.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

Additional information

The Secure Hash Algorithm 1 (SHA1) checksum of the images are as follows:
SHA1(8.1.4.0-IBM-APM-CORE-FRAMEWORK-AIX-IF0002.tar) = 914f9356af441696911061140a3723b51d5cc34e
SHA1(8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0002.zip) = 934fe18c8ea589a3a29dcaff90eae80657305c39
SHA1(8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN64-IF0002.zip) = 8e5cab24de35af5d54ab9fe5c5a291d4d61ff8e6
SHA1(8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0002.tar) = 3cff48a401da7c9db28e5dc5093e64a9f80e7f68
SHA1(8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0002.tar) = a809e090322216d8de3f0b3ddd88c56bab4aa3b4
SHA1(8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0002.tar) = 8f69ce3c038fff8f75af492e4f85602d040411da
SHA1(8.1.4.0-IBM-APM-SERVER-IF0002.tar) = 653db8098b94831cc825b55f5e013833834844fa

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- 8.1.4.0-IBM-APM-SERVER-IF0002.tar

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

8.1.4.0-IBM-APM-SERVER-IF0002/
|-- 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 2:

  • Defect fixes and other stability improvements


List of fixes

The following problems are addressed by this interim fix.

APARs

  • 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
Defects:
  • 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


Enhancements:
  • None

Superseded fixes:
  • None

APARS and defects included from superseded fixes:
APARs
  • IV98883: The agent2server.sh may start agents using the wrong user id.
Defects:
  • 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)



Document change history


Version Date Description of change
1.0 26 Jan 2018 Initial Version

Document information

More support for: IBM Application Performance Management

Reference #: 00003677

Modified date: 28 January 2018