Fix Readme
Abstract
Readme file for: IBM Application Performance Management 8.1.4.0 core framework IF12 (8.1.4.0-IBM-APM-CORE-FRAMEWORK-IF0012)
Update Name/Fix ID: 8.1.4.0-IBM-APM-CORE-FRAMEWORK-IF0012
This Core Framework patch works for both APM and ICAM.
This iFix fixes RTC defect 138331, and more importantly includes a minor fix needed to support History and Warehouse statements in private situations for ICAM. Work with ICAM 2019.2.1-IBM-ICAM-SERVER-IF0002 together.
Content
Download location
IMPORTANT NOTE: To download this update, you must first login to IBM Fix Central using the link below . 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.
Server Side Fix Download for Linux
Product / Component Name | Platform | Fix |
IBM Application Performance Management | Linux x86_64 | 8.1.4.0-IBM-APM-CORE-FRAMEWORK-SERVER-IF0012 |
Agent Side Fix Download for AIX
Product / Component Name | Platform | Fix |
IBM Application Performance Management | AIX pSeries |
Agent Side Fix Download for Linux
Product / Component Name | Platform | Fix |
IBM Application Performance Management | Linux ppc64le | 8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0012 |
IBM Application Performance Management | Linux ppc64 | 8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUX-IF0012 |
IBM Application Performance Management | Linux x86_64 | 8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0012 |
IBM Application Performance Management | Linux s390x | 8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0012 |
Agent Side Fix Download for Solaris
Product / Component Name | Platform | Fix |
IBM Application Performance Management | Solaris Sparc |
Product / Component Name | Platform | Fix |
IBM Application Performance Management | Windows | 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0012 |
IBM Application Performance Management | Windows |
Prerequisites and co-requisites
General description
This interim fix works for both APM and ICAM.
This iFix fixes RTC defect 138331, and more importantly includes a minor fix needed to support History and Warehouse statements in private situations for ICAM. Work with ICAM 2019.2.1-IBM-ICAM-SERVER-IF0002 together.
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
This iFix works with ICAM 2019.2.1-IBM-ICAM-SERVER-IF0002 together
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
None
Known limitations
None
Installation information
Prior to installation
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
- Download the patch bundle 8.1.4.0-IBM-APM-CORE-FRAMEWORK-SERVER-IF0012 file.
- Unpack it
- Enter the created directory.
- Run the apmpatch.sh tool:
./apmpatch.sh
- 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
- 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
Note: The agent must already be installed before applying the agent side patch. It will be restarted as part of applying the patch.
- 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-IF0012.tar
- If the agent is installed on Linux for Power Systems (Big Endian), download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUX-IF0012.tar
- If the agent is installed on Linux for Power Systems (Little Endian), download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0012.tar
- If the agent is installed on Linux for System x, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0012.tar
- If the agent is installed on Linux for System z, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0012.tar
- If the agent is installed on Solaris, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS-IF0012.tar
- If the agent is installed on Windows 32-bit, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0012.zip
- If the agent is installed on Windows 64-bit, download 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN64-IF0012.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 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
- 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-IF0012.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 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 6.40.00.09, gs version to 08.00.50.88 and the JR to 08.05.35.00.
On Linux or AIX:
- Ensure that the <APM-AGENT-HOME>/bin/cinfo -t output for the ax agent version is '06.40.00.09', gs version is 08.00.50.88 and jr version is 08.05.35.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.09, gs version is 08.00.50.88 and the jvm component version is 08.05.35.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 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
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 1 (SHA256) checksum of the images are as follows:
SHA256(8.1.4.0-IBM-APM-CORE-FRAMEWORK-AIX-IF0012.tar) = 4822b978d288353477fcc6fd220d7efd777025bdec682695ba42d3279b163613
SHA256(8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS-IF0012.tar) = 261baa6fc1680e2cac454f03f282cf71c4a31aa0ab3d59cf3f77d3dc93054b35
SHA256(8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0012.zip) = ffd0aa6d868418df4daa488f9f9a47f8a361115771b3f6cd6aab7b296afa62a6
SHA256(8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN64-IF0012.zip) = 023a626354c413dda0bb20c5dda828df2be84157fe9d63d8069ba865229761d3
SHA256(8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0012.tar) = 281b108d92ed8a99df09ff4ea4967135ede7dc851f9ab069f6a467915875738e
SHA256(8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUX-IF0012.tar) = a34e70d74026805b74e9b1dfd331ae50dbb3ca81d75af61b6af71b7477783fba
SHA256(8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0012.tar) = e5b5f7297f8760935794b70d4659a1ffd7499af949d52a2125909b08a6fce643
SHA256(8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0012.tar) = 2b5fdc51363ad33b862886cbc2914d5f3a80755ba323b69f62ea0b34dc26468b
SHA256(8.1.4.0-IBM-APM-CORE-FRAMEWORK-SERVER-IF0012.tar) = 0803c07177b55c77ba8c829d35b5c49fcee5f29a92ef1639acf27b952c8c9481
Image Contents
The following files implement this fix.
- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-IF0012.readme.html - This README file
- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-AIX-IF0012.tar
Extracting the above bundle (.tar) creates the following directory and patch files:
8.1.4.0-IBM-APM-CORE-FRAMEWORK-AIX-IF0012/
|-- apmpatch.sh
|-- patches
|-- patch.properties
- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0012.zip
Extracting the above bundle (.zip) creates the following directory and patch files:
8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN32-IF0012/
|-- apmpatch.bat
|-- patches
|-- patch.properties
- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN64-IF0012.zip
Extracting the above bundle (.zip) creates the following directory and patch files:
8.1.4.0-IBM-APM-CORE-FRAMEWORK-WIN64-IF0012/
|-- apmpatch.bat
|-- patches
|-- patch.properties
- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0012.tar
Extracting the above bundle (.tar) creates the following directory and patch files:
8.1.4.0-IBM-APM-CORE-FRAMEWORK-PLINUXLE-IF0012/
|-- apmpatch.sh
|-- patches
|-- patch.properties
- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS-IF0012.tar
Extracting the above bundle (.tar) creates the following directory and patch files:
8.1.4.0-IBM-APM-CORE-FRAMEWORK-SOLARIS-IF0012/
|-- apmpatch.sh
|-- patches
|-- patch.properties
- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0012.tar
Extracting the above bundle (.tar) creates the following directory and patch files:
8.1.4.0-IBM-APM-CORE-FRAMEWORK-XLINUX-IF0012/
|-- apmpatch.sh
|-- patches
|-- patch.properties
- 8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0012.tar
Extracting the above bundle (.tar) creates the following directory and patch files:
8.1.4.0-IBM-APM-CORE-FRAMEWORK-ZLINUX-IF0012/
|-- apmpatch.sh
|-- patches
|-- patch.properties
- 8.1.4.0-IBM-APM-SERVER-IF0012.tar
Extracting the above bundle (.tar) creates the following directory and patch files:
8.1.4.0-IBM-APM-SERVER-IF0012/
|-- apmpatch_functions
|-- apmpatch.bat
|-- apmpatch_prefix
|-- msg
|-- nls_replace
|-- patches
|-- patch.properties
New Features
List of fixes
The following problems are addressed by this interim fix.
APARs
- None
Defects:
- 1138331: Upcoming hotfix and includes a fix for RTC defect
-
Git#10037: Support History and Warehouse statements in private situations
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
Document change history
Version | Date | Description of change |
1.0 | 25 July 2019 | Initial Version |
Was this topic helpful?
Document Information
Modified date:
02 August 2019
UID
ibm10960390