IBM Support

8.1.4.0-IBM-APM-CORE-FRAMEWORK-IF0018

Fix Readme


Abstract

Readme file for: IBM Application Performance Management 8.1.4.0 core framework IF18 (8.1.4.0-IBM-APM-CORE-FRAMEWORK-IF0018)
Update Name/Fix ID: 8.1.4.0-IBM-APM-CORE-FRAMEWORK-IF0018
This Core Framework patch works for both APM (IBM Cloud Application Performance Management) and ICAM (IBM Cloud App Management) .
This iFix fixes 141941, 3904,5690, 5979 , 141275 , 7595 ,7707/7811/7957, 8158, 8272 issues.

Content

Download location
 

Download location

IMPORTANT NOTE:

1. To download this update, you must first login to IBM Fix Central using this link:  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.

Server Side Fix Download (APM only, ICAM doesn't need server side Fix)

Platform Fix
Linux x86_64 8.1.4.0-IBM-APM-CORE-FRAMEWORK-SERVER-IF0018




 

Agent Side Fix Download (For both APM and ICAM)

Platform Fix
AIX pSeries
Linux ppc64le
 8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0018
Linux ppc64 8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUX-IF0018
Linux x86_64 8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0018
Linux s390x 8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0018
Solaris Sparc 8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS-IF0018
Solaris X86 8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS_X86-IF0018
Windows 32bit
Window 64bit 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN64-IF0018




 

Prerequisites and co-requisites

General description 

This interim fix works for both APM (IBM Cloud Application Performance Management) and ICAM (IBM Cloud App Management) .

This iFix fixes 141941, 3904,5690, 5979 , 141275 , 7595 ,7707/7811/7957, 8158, 8272 issues.

Platforms and prerequisites 

APM: The agent core framework, and server core framework are supported on all agent and server platforms documented here.
ICAM: The agent core framework is supported on all agent platforms documented here.


Prerequisites for this interim fix 

This interim fix for the core framework is intended for the following:

APM:
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

ICAM:

Agent only,  IBM Cloud App Management version earlier than 2020.1.0(2020, March).

Since ICAM 2020.1.0 images already contain this fix.

Known issues

None

Known limitations

None

Installation information

Prior to installation

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

Installing

The server side 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.

The agent side core framework patch is to be installed on the computer systems where your monitoring agents are already installed.

  • 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.
  • If you need to apply the patch to already installed agents then follow the instructions for installing the agent patch on each agent system.

Installing the core framework server patch on the Performance Management server (APM only, ICAM doesn't need server side Fix)

  1. Download the patch bundle 8.1.4.0-IBM-APM-CORE-FRAMEWORK-SERVER-IF0018 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 Here we copy the content for you convenience.
    • 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 those 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 the agent patch on each agent system (Both APM & ICAM)

Note: The agent must already be installed before applying the agent side 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-IF0018.tar
    • If the agent is installed on Linux for Power Systems (Big Endian), download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUX-IF0018.tar
    • If the agent is installed on Linux for Power Systems (Little Endian), download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0018.tar
    • If the agent is installed on Linux for System x, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0018.tar
    • If the agent is installed on Linux for System z, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0018.tar
    • If the agent is installed on Solaris, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS-IF0018.tar
    • If the agent is installed on Solaris x86, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS_X86-IF0018.tar
    • If the agent is installed on Windows 32-bit, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0018.zip
    • If the agent is installed on Windows 64-bit, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN64-IF0018.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-IF0018.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.

Performing the necessary tasks after installation of agent core framework update

A successful installation modifies the agent core framework version to 06.40.00.16, gs version to 08.00.50.88 and the JR to 08.06.05.00.
On Linux or AIX:
- Ensure that the <APM-AGENT-HOME>/bin/cinfo -t output for the ax agent version is '06.40.00.16', gs version is 08.00.50.88 and jr version is 08.06.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 06.40.00.16, gs version is 08.00.50.88 and the jvm component version is 08.06.05.00.
- The agent interim fix installation logs are written to the <APM-AGENT-HOME>\INSTALLITM\ directory.

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 guide, here:

APM
http://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/com.ibm.pm.doc/install/uninstall_agents.htm

ICAM
https://www.ibm.com/support/knowledgecenter/SS8G7U_19.3.0/com.ibm.app.mgmt.doc/content/uninstall_agents.html

Troubleshooting installation problems from the Support site

For more detailed information, refer to the Troubleshooting and support Guide:

APM
http://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/com.ibm.pm.doc/install/trouble_intro.htm 

ICAM (Different versions are available if yours is not 2019.4.0)

Additional information

The Secure Hash Algorithm 1 (SHA256) checksum of the images are as follows:

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

    b8fa11e824b09ae96fb11ed07a1aa7bd0e5848fa57bd2afbcfe0c6781d103f11

    8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUX-IF0018.tar

    6447b16532e20e8acf139caae98f0c9f7e3d74af0f7007c885614de47866caa1

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

    070916c974bb0ffa37114a75a86e05f21d433e9135271f2a7da21fcda0b29477

    8.1.4.0-IBM-APM-CORE-FRAMEWORK-SERVER-IF0018.tar

    595d88e373e49e2d9011933a6c318770612a4e195f7b56b726e74704f5b01b1d

    8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS-IF0018.tar

    cec1bf6086c5604dd89cf02aa89f9c7320096a0c2c1d1d9f024dafd3fda5bc02

    8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS_X86-IF0018.tar

    fc9a31e6ceeafe4324584847ef7e56f7d753cd88eced37ed30b316059b0e4044

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

    f37d8d6cb8550fe5e2b191e551b05ac40cba859e8106ef485bd410184a35e3c8

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

    2f590553c8c81c318cde1ad15e54ac396fc6fcf22fc0ffdf5c40e607155325fa

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

    9f6bc1e76f438ffc47568c925ae17b805aa2adc15d903e2a78bb4f4a177c3baf

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

    72d31ae0a21fba6108a83fc836ea54e82290860da19214542adaf1c5868aa4a5

Image Contents 

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

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

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

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

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

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

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

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

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

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

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

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

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

- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS-IF0018.tar

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

8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS-IF0018/
|-- apmpatch.sh
|-- patches
|-- patch.properties

- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS_X86-IF0018.tar

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

8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS_X86-IF0018/
|-- apmpatch.sh
|-- patches
|-- patch.properties


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

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

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

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

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

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

- 8.1.4.0-IBM-APM-SERVER-IF0018.tar

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

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

New Features

None

 

List of fixes

The following problems are addressed by this interim fix.

APARs

  • None

Defects:

  • github 3904: trace reflex action command non-zero return code
github 5690: fix central config load list file name for ITM multi-instance agents
pull req 72: Suppress incorrect XML validation error message
github 5979: Unchanged subnode situations restarted multiple times on new private_situations.xml download
RTC 141275: fix thread handle leak when running Windows commands
github 7595:  remove trailing spaces before processing regex private sit. string
github 7707/7811/7957: agent crashes recycling thresholds
github 8158: pass prereq checking on Ubuntu 20.04
RTC 141941: Framework support for Ubuntu 20.04
github 8272: asfSubscription file getting corrupted

Enhancements:

  • None


Superseded fixes:

  • None


APARS and defects included from superseded fixes:

APARs:

  • IJ09774: APM DB2 AGENT FAILS TO START CORRECTLY AFTER REBOOT
  • IJ12656: missing klo_* EIF event slots
  • IJ12808: SUSE12, NO ITMAGENTS1.SERVICE AND ITMAGENTS2.SERVICE IN APM 8.1.4
  • 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
 

Defects:

   
  • 136805: Vulnerability on APM MQ monitoring agent
    137153: APM SaaS DB2 agent alerts can not be cleaned on APM console
  • 137660: Uplift JRE version to 8.0.5.35 in Agent Framework
    138139: Add support for RHEL8
    GIT#9752: close a timing window where its possible that an updated private situation is not downloaded to the agent
    GIT#7097: provide a workaround where no attribute group data is sent to the server because of a non-UTF8 character in one field
    GIT#9065: when connecting an ITM or SMA agent to ICAM in dual mode, continue to run any private situations defined in the ITM environment (typically this is done with autonomous agents) rather than private situations from ICAM. Also provide a configuration variable to instead run ICAM private situations and not ITM private situations
    GIT#7168: when connecting an ITM or SMA agent to ICAM, continue to download files from a centralized configuration server defined in the ITM environment
    GIT#10320: Fail is reported when upgrading agent on Windows because of the same version
    GIT#10460: AgentSVT-Script error when config icam agent instance on ubuntu 18
  • 129793: kqi crash when kqi start on zlinux.
    135941: Add agent support for solaris.
    136335: Add agent support for Windows Server 2019.
    136890: Wdev Threshold "Execute Command" execute at every interval instead of at first occurrence.
    137029: Uplift JRE version to 8.0.5.30 in Agent Framework.
  • GIT#5970: quicker agent configuration when switching agent to and from ICAM.
    GIT#6479: TEMA crashes intermittently when run in Agent Builder testing mode.
    GIT#6904: determine DB2 instance name without checking DB2INSTANCE.
    GIT#7252: agents hang processing cached data after long server outage.
  • 135420: Uplift JRE version to 8.0.5.25 in agent framework.
  • 135531: Failed to install APM Agents on SUSE 15 Platform
  • issue 6256: Windows 32-bit agent crashes
  • issue 6182: pdcollect haven't collected global.environment file in config directory
  • issue 6588: Configuration of fresh installed MQ/IIB agent failed on Windows
  • 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
  • 133713: Failed to detect the installed agent version on aix
  • 134218: Add call to ism-agent.bat while uninstalling agent through smai-agent.bat
  • 132196: After installing 8.1.4 IF03, service oslc failed to start
  • 134475: Uplift JRE version to 8.0.5.20 in agent framework
  • WF#2794: Improve messages in lz_asfActivity.log and *.LG0
  • WF#4203: Some agent threshold definitions not distributed correctly
  • 133634: Add support for pLinux Big Endian
  • Git#5217: TEMA update for Agent/Server communication in HTTPS
  • GIT#8665: TEMA Situations Sometimes Do Not Reach The Agent Because of A Timing Issue in Temaconfig
  • 1138331: Upcoming hotfix and includes a fix for RTC defect

  • Git#10037: Support History and Warehouse statements in private situations

  • 139188 - Uplift JRE version to 8.0.5.40 in Agent Framework
  • 139169 - Add agent support for solaris x86
  • Git#10647: In ICAM use extra-precise last modified time from HTTP header of downloaded private situations file from Central Configuration when requesting an updated copy
    Git#11104: Fix for defect where SQLite private situations are not saved when downloaded from Central Configuration.
    Git#11109: Fix for defect where updated ITM-defined private situations file starts running and reporting events to ICAM when only ICAM-defined private situations file should be running
    Git#10445: Event Summary does not show AND OR conditions clearly
    Git#10613: Support for private situation fullname - for long threshold names (part of epic 10413)
    Git#11640: start ICAM situations when switching ITM agents from dual to ICAM-only mode
    138077: fix some errors, possible agent crash, in situation with COUNT when zero rows pass filters
    Git#9849: clean up attribute substitution into reflex action command
    Git#11912: adjust threshold reflex command action to respect the "consecutive samples" setting
    Git#12216: Remove and no longer create Last-Modified directory from OS agent log_discovery directory
    Git#12227: Closed a window where an agent (in dual mode) might report ITM private situation events to ICAM server
  • 139475: RHEL 8 on pLinuxLE v81409 and ICAM v2019.3.0 DB2 agent did not point to APM Server and ICAM server
  • Git#12219: can configure endpoint agent with KDE_GATEWAY_SUBSTITUTION to support KDE_GATEWAY on ICAM & APM
  • Git#12703: support wild cards on private sit MISSING arguments
  • Git#10626: support *CHANGE in private situations
  • Git#10627: support *PCTCHANGE in private situations
  • 141196 - Uplift JRE version to 8.0.6.05 in Agent Framework
  • 140203: TEMA downloads but does not process private_situations.xml if there are many files in download list
Github 1775: allow TEMA to download any custom file using default IRA_LOCALCONFIG_DIR
Github 1818 (formerly 13669): do not cycle situations for thresholds that do not change

Document change history

Version Date Description of change
1.0 29 June 2020 Initial Version

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSVJUL","label":"IBM Application Performance Management"},"Component":"core framework","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS8G7U","label":"IBM Cloud App Management"},"Component":"core framework","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
30 June 2020

UID

ibm16241358

Page Feedback