Fix Readme
Abstract
Readme file for: Internet Service Monitoring Agent for IBM Application Performance Management 8.1.4.0 Interim Fix 2
Product / Component Release: 8.1.4.0
Update Name: 8.1.4.0-IBM-APM-ISM-AGENT-IF0002
Fix ID: 8.1.4.0-IBM-APM-ISM-AGENT-IF0002
Publication Date: 07 July 2022
Content
Download location
1. To download this update, you must first log in to IBM Fix Central (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 to 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.
| Product / Component Name | Platform | Fix |
| IBM Application Performance Management Internet Service Monitoring Agent | Linux x86_64 | |
| Windows |
Prerequisites and co-requisites
General description
This is an interim fix for the Monitoring agent for Internet Service Monitoring, provided with IBM Application Performance Management family of products, Version 8.1.4.0.
This interim fix upgrades the Internet Service Monitoring agent version to 08.22.07.00.
It provides the support for SHA 256, SHA 512, AES 256, AES 192 and other authentication and privacy protocols in the SNMP monitor.
Platforms and prerequisites
The Monitoring Agent for Internet Service Monitoring is supported on the platforms documented. here.
The interim fix for the Internet Service Monitoring agent is intended to be applied to the Monitoring Agent for Internet Service Monitoring version 08.20.12.00 or 08.22.01.00.
If you have an older version of ISM agent installed currently, then first you need to upgrade it to version 08.20.12.00 or 08.22.01.00.
Internet Service Monitoring version 08.20.12.00 is provided with:
IBM Cloud Application Performance Monitoring Base Extension, Version 8.1.4.0.14 or 8.1.4.0.15 or 8.1.4.0.16 or 8.1.4.0.17 or 8.1.4.0.18
Internet Service Monitoring version 08.22.01.00 is provided with:
Internet Service Monitoring Agent for IBM Application Performance Management 8.1.4.0 Interim Fix 1
Known issues
None
Known limitations
The problem:
SIP monitor is not modified with this interim fix.
The solution:
SIP monitor can be used from existing version of ISM agent on which patch is getting applied.
Installation information
Prior to installation
a. Run command prompt in administrator or root mode and go to
Windows: "<APM agent install directory>\APM\bin"
Linux: "<APM agent install directory>/apm/agent/bin"
b. To stop ISM agent, run command
Windows: "ism-agent.bat stop"
Linux: "./ism-agent.sh stop"
Installing
Installing the agent interim fix
- Download the patch bundle from Fix Central for each OS type where your agent is installed:
- If the agent is installed on Linux x86_64, download 8.1.4.0-IBM-APM-ISM-AGENT-XLINUX-IF0002.tar
- If the agent is installed on Windows, download 8.1.4.0-IBM-APM-ISM-AGENT-WIN64-IF0002.zip
- Unpack the patch bundle on each computer system where the agent is already installed by using the tar utility on Linux or unzip on Windows.
- e.g., tar -xf 8.1.4.0-IBM-APM-ISM-AGENT-XLINUX-IF0002.tar
- Enter the created directory
- Run the apmpatch.sh/bat tool as the same user who installed the agent:
Linux:
./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, it needs to be provided only if the agent is not installed in default directory.
Performing the necessary tasks after installation
A successful installation modifies the Internet Service Monitoring agent version to 08.22.07.00.
On Linux:
- Ensure that the <APM-AGENT-HOME>/bin/cinfo -t output for the Monitoring Agent for Internet Service Monitoring is '08.22.07.00'.
- The agent interim fix installation logs are written to the "<APM-AGENT-HOME>/logs/" directory.
On Windows:
- Ensure that version number 08.22.07.00 is displayed for the Monitoring Agent for Internet Service Monitoring on the Performance Management window.
- The agent interim fix installation logs are written to the "<APM-AGENT-HOME>\INSTALLITM\" directory.
Uninstalling if necessary
This agent maintenance package cannot be rolled back. If necessary, you can uninstall and reinstall the monitoring agent and patches.
For detailed instructions to uninstall monitoring agents, please refer to the IBM Performance Management guide, here:
https://www.ibm.com/docs/en/capmp/8.1.4?topic=agents-uninstalling-your
Troubleshooting installation problems from the Support site
For more detailed information, refer to the Troubleshooting and support Guide:
https://www.ibm.com/docs/en/capmp/8.1.4?topic=troubleshooting-support
Additional information
The Secure Hash Algorithm 256 (SHA256) checksum of the image is as follows:
SHA256(8.1.4.0-IBM-APM-ISM-AGENT-XLINUX-IF0002.tar)=b929c124da50ee304a5c9aa0cd97e18bde8e328cb6d51fdef3502445d9246d83
SHA256(8.1.4.0-IBM-APM-ISM-AGENT-WIN64-IF0002.zip)=6d00cb4d908f8e96ed61b510812a24ba188f8ef6b76338ffb3db6da1c53df173
Image Contents
The following files implement this fix:
- 8.1.4.0-IBM-APM-ISM-AGENT-IF0002.readme.html - This README file
- 8.1.4.0-IBM-APM-ISM-AGENT-XLINUX-IF0002.tar - For extracting patch files use the tar utility.
Extracting the linux bundle (.tar) creates the following directory and patch files:
8.1.4.0-IBM-APM-ISM-AGENT-XLINUX-IF0002/
|-- apmpatch.sh
|-- patches
|-- patch.properties
- 8.1.4.0-IBM-APM-ISM-AGENT-WIN64-IF0002.zip - For extracting patch files use the tar utility.
Extracting the windows bundle (.zip) creates the following directory and patch files:
8.1.4.0-IBM-APM-ISM-AGENT-WIN64-IF0002/
|-- apmpatch.bat
|-- patches
|-- patch.properties
New Features
List of fixes
The following new features are included in this interim fix.
https://automation-management.ideas.ibm.com/ideas/ITMAPM-I-32
- Support For SHA 256 and SHA 512 Authentication Protocols.
- Upgrade ISM agent to its latest version 8.1.4.0 IF02.
- Select any of the below authentication and privacy protocols in the SNMP monitor configuration window from the APM UI ISM configuration panel.
- None
- None
Enhancements, APARs and defects included from previous interim fixes:
Document change history
| Version | Date | Description of change |
| 1.0 | 07 July 2022 | Initial Version |
Product Synonym
APM
Was this topic helpful?
Document Information
Modified date:
07 July 2022
UID
ibm16598747