IBM Support

IBM Application Performance Management 8.1.4.0-IBM-APM-GATEWAY-IF0012 Readme

Fix Readme


Abstract

Readme file for: Hybrid Gateway for IBM Cloud Application Performance Management Version 8.1.4.0 Interim Fix 12
Product/Component Release: 8.1.4
Update Name: 8.1.4.0-IBM-APM-GATEWAY-IF0012
Fix ID: 8.1.4.0-IBM-APM-GATEWAY-IF0012
Publication Date: 31 August 2023
Last modified date: 31 August 2023

This is a cumulative interim fix for the Hybrid Gateway component provided with IBM Cloud Application Performance Management Version 8.1.4.0 products.

Content

Download location
Prerequisites and co-requisites
Known issues
Known limitations
Installation information
Installing
Troubleshooting installation problems from the Support site
Additional information
New Features
List of fixes
Document change history

Download location

IMPORTANT NOTE: To download this update, you must first login to IBM Fix Central by using the link below. Once logged in, you can select from the individual download packages. When selecting the fixes, ensure that the download options are set to "Include requisites: Yes". 
http://www.ibm.com/support/fixcentral/

Fix Download for Linux

Below is a list of components, platforms, and file names that apply to this Readme file.

Product / Component Name Platform Fix
Hybrid Gateway for IBM Cloud APM v8.1.4.0 Linux x86_64 8.1.4.0-IBM-APM-GATEWAY-IF0012

Prerequisites and co-requisites

General description 

This is an interim fix for the Hybrid Gateway component that is provided with IBM Cloud Application Performance Management Version 8.1.4.0 products. 

Platforms and prerequisites 
This interim fix is supported on the IBM Cloud Application Performance Management Hybrid Gateway platforms documented here.

Prerequisites for this interim fix 

This interim fix is intended to be applied to the following version of Hybrid Gateway software:

IBM Cloud Application Performance Management Hybrid Gateway version 8.1.4.0

Note: To determine the version of your Hybrid Gateway, see the /opt/ibm/hybridgateway/version_proxy.properties file on the computer system where the Hybrid Gateway is installed. 

Known issues

None

Known limitations

None

Installation information

Prior to installation

1. The IBM Cloud Application Performance Management Hybrid Gateway component version 8.1.4.0 must be installed and running before applying the interim fix.
2.  The unzip command must also be installed before installing the interim fix.
3. This interim fix backs up the /opt/ibm/wlp directory. You must ensure that you have enough disk space to backup that directory structure before installing the interim fix. If sufficient disk space is not available, then the Liberty component patch will not install but the other component patches will install. Then you must run the hgpatch.sh again to install the Liberty patch after you have sufficient disk space.

You can reduce the amount of disk space required for the backup of the /opt/ibm/wlp directory by performing the following cleanup activity before installing the interim fix:

  • Delete the /opt/ibm/wlp-backup-04 directory if it exists to free up disk space. This directory was created by a earlier Cloud APM Hybrid Gateway interim fix installer and is not needed if you are installing the latest interim fix. 
  • Delete the /opt/ibm/wlp-backup-08 directory if it exists to free up disk space. This directory was created by a earlier Cloud APM Hybrid Gateway interim fix installer and is not needed if you are installing the latest interim fix. 
  • Delete the /opt/ibm/wlp-backup-09 directory if it exists to free up disk space. This directory was created by a previous Cloud APM Hybrid Gateway interim fix installer and is not needed if you are installing the latest interim fix. 
  • Delete the /opt/ibm/wlp-backup-10 directory if it exists to free up disk space. This directory was created by a previous Cloud APM Hybrid Gateway interim fix installer and is not needed if you are installing the latest interim fix. 
  • Delete the /opt/ibm/wlp-backup-11 directory if it exists to free up disk space. This directory was created by a previous Cloud APM Hybrid Gateway interim fix installer and is not needed if you are installing the latest interim fix. 
  • Delete files that start with javacore, heapdump or core in the  /opt/ibm/wlp/usr/servers/hybridgateway/ directory.
  • Delete files that start with trace_ and messages_ in the /opt/ibm/wlp/usr/servers/hybridgateway/logs directory.

Installing

Installing the IBM Cloud Application Performance Management Hybrid Gateway update

1. Download 8.1.4.0-IBM-APM-GATEWAY-IF0012.tar from IBM Fix Central to a temporary directory (For example, /tmp/if12-patch) on the computer where you installed the Hybrid Gateway. 

2. Change your current directory to the download location.

For example, cd /tmp/if12-patch

3. Expand the archive file by using the tar command:
For example, tar -xf 8.1.4.0-IBM-APM-GATEWAY-IF0012.tar 

4. Run the script, hgpatch.sh:
cd 8.1.4.0-IBM-APM-GATEWAY-IF0012
./hgpatch.sh 

Notes: 

  • If Hybrid Gateway services need to be stopped for the patch to be applied, you will be asked to confirm whether you want to install the patch.
  • When hgpatch.sh is complete, a summary is displayed showing the number of fixes that were installed, the number of fixes that were not installed because they have previously been installed, and the number of fixes that failed to install. If any fixes failed to install, more information can be found in the hgpatch.log file in the logs directory,
    For example, /opt/ibm/hybridgateway/logs/hgpatch.log
  • A record of each fix applied can be found in the /opt/ibm/hybridgateway/fixes directory. Do not modify this directory or its contents. It is needed if other fixes are applied in the future.

Performing the necessary tasks after installation

The Hybrid Gateway interim fix installation logs are written to the /opt/ibm/hybridgateway/logs/hgpatch.log file.

 After you have verified that the Cloud APM Hybrid Gateway is working with the new interim fix,  you can delete the /opt/ibm/wlp-backup-12 directory to free up disk space.

Uninstalling if necessary

Files modified by the interim fix are backed up during the installation. If you encounter an issue with the interim fix and need to back it out, then contact IBM support for assistance.

For detailed instructions to uninstall the hybrid gateway, refer to the IBM Cloud Application Performance Management guide at: 
https://www.ibm.com/docs/en/capmp/8.1.4?topic=gateway-uninstalling-hybrid

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 1 (SHA1) checksum of the image is as follows:
SHA1(8.1.4.0-IBM-APM-GATEWAY-IF0012.tar) = 2b222745e6da9c1bbdd5f8305354f8307588b708

Image Contents 

The following files implement this fix:
- 8.1.4.0-IBM-APM-GATEWAY-IF0012.tar - For extracting the patch files use the tar utility.
Extracting the above bundle (.tar) creates the following directory and patch files:

8.1.4.0-IBM-APM-GATEWAY-IF0012/
|-- apmpatch_functions
|-- hgpatch.sh
|-- msg
|-- nls_replace
|-- patches
|-- patch.properties

New Features

The following changes are included in IBM Cloud Application Performance Management Hybrid Gateway Interim Fix 12:

  • Uplift Java and Liberty

List of fixes

The following problems are addressed by this interim fix.

APARs 

None

IBM Cloud Application Performance Management Hybrid Gateway  defects: 
  • 147324: After uninstalling Hybrid Gateway, liberty profile is not deleting and need to manually delete it.
  • 147313: PSIRT fixes for IBM WebSphere Liberty Server being used by APM Hybrid Gateway Server
  • 147314: PSIRT fixes for IBM Java  being used by APM Hybrid Gateway Server
Enhancements included from previous interim fixes: 
None

APARs and defects included in Hybrid Gateway previous interim fixes: 
  • 126951: Uplift Java to 8.0.4 FP10 to address security vulnerabilities
  • 129462: Uplift Java to version 8.0.5.5 for security fixes
  • 130401: Apply Liberty APAR PI94351 for Missing Secure Attribute in Encrypted Session (SSL) Cookie oidcclient/redirect/rpoed
  • 131154: Apply Liberty APAR PI88642 for a security vulnerability
  • 131593: Uplift Java to version 8.0.5.5 for security fixes
  • 131901: Apply Liberty APAR PI94763 fix for security vulnerability and an additional fix in Apache Commons
  • 133532: Uplift Java to version 8.0.5.16 for security fixes.
  • 134654: Uplift Java to version 8.0.5.21 for security fixes
  • 135609: Uplift Java to version ​8.0.5.25 for security fixes
  • 136452: Uplift Liberty to version 19.0.0.2 for security fixes
  • 137193: Apply Liberty APAR  PH07036 fix
  • 137355: Apply Liberty APAR PH03640 fix
  • 137567: Apply Liberty APAR PH13269 fix
  • 137773: Uplift Java to Java 8.0.5.35 for security fixes
  • 139759: Uplift Liberty to version 19.0.0.12  for security fixes
  • 139847: Uplift netty for security fixes
  • 140831: Apply Liberty APAR PH19528 fix for Liberty 19.0.0.12
  • 140832: Uplift Java to version 8.0.6.5 for security fixes
  • 140834: Apply Liberty APAR PH19989 fix for Liberty 19.0.0.12
  • 142766: Uplift to Java 8.0.6.15
  • 143515: Uplift to Java 8.0.6.26
  • 145261: Uplift Liberty to 21.0.0.9 + PH39418
  • 145452: IBM Cloud APM connection failure
  • 145758: Uplift Liberty to version 22.0.0.3 for security fixes
  • 145759: Uplift Java to version 8.0.7.10 for security fixes
  • 145795: Security vulnerability in Apache log4j
  • 146295: Uplift Java to version 8.0.7.10 for security fixes
  • 146293: Update IF13 SVT Hybrid Gateway 8.1.4 IF10 upgrade to IF11 fails to redeploy the LTPA service.
  • 144890: APM hung IF upgrade loses Liberty customization
  • 146502: Uplift Liberty to version 22.0.0.3 for security fixes
  • 146417: ITM Pure events open in APM even when situation was stopped and cleared from TEP GUI

Document change history

Version Date Description of change
1.0 24 August 2023 Initial Version

 

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSVJUL","label":"IBM Application Performance Management"},"Component":"","Platform":[{"code":"PF016","label":"Linux"}],"Version":"8.1.4","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
27 November 2023

UID

ibm17028711

Page Feedback