IBM Support

Readme - IBM Cloud Application Performance Management Hybrid Gateway version 8.1.4.0 Interim Fix 16

Fix Readme


Abstract

This article includes a list of APARs, defects fixed with this release and has information related to Prerequisites, Installation, Upgrade, and Release highlights.

Content

Release details

Product name IBM Cloud Application Performance Management Hybrid Gateway Version 8.1.4.0
Release name IBM Cloud Application Performance Management Hybrid Gateway Version 8.1.4.0 Interim Fix 16
Build ID 8.1.4.0-IBM-APM-GATEWAY-IF0016
Release date 4th August 2025

APARs fixed

Following is the list of APARs and defects fixed with this release.

  • None
IBM Cloud Application Performance Management Hybrid Gateway  defects
  • ITMAGT-157: Story: IF18: As an APM Server developer, I want to upgrade the APM server Hybrid Gateway Liberty version from 24.0.0.12 to 25.0.0.5 so that vulnerabilities get fixed.
  • ITMAGT-158: Story: IF18: As an APM Server developer, I want to upgrade the APM Server Hybrid Gateway Java version from 8.0.8.35 to 8.0.8.45 so that vulnerabilities get fixed.

Superseded interim fixes APAR and defects

  • 126951: Uplift IBM® SDK, Java Technology Edition to 8.0.4 FP10 to address security vulnerabilities.
  • 129462: Uplift IBM SDK, Java Technology Edition to Version 8.0.5.5 for security fixes.
  • 130401: Apply IBM WebSphere Liberty APAR PI94351 for Missing Secure Attribute in Encrypted Session (SSL) Cookie oidcclient/redirect/rpoed.
  • 131154: Apply IBM WebSphere Liberty APAR PI88642 for a security vulnerability.
  • 131593: Uplift IBM SDK, Java Technology Edition to Version 8.0.5.5 for security fixes.
  • 131901: Apply IBM WebSphere Liberty APAR PI94763 fix for security vulnerability and an additional fix in Apache Commons.
  • 133532: Uplift IBM SDK, Java Technology Edition to Version 8.0.5.16 for security fixes.
  • 134654: Uplift IBM SDK, Java Technology Edition to Version 8.0.5.21 for security fixes.
  • 135609: Uplift IBM SDK, Java Technology Edition to Version ​8.0.5.25 for security fixes.
  • 136452: Uplift IBM WebSphere Liberty to Version 19.0.0.2 for security fixes.
  • 137193: Apply IBM WebSphere Liberty APAR  PH07036 fix.
  • 137355: Apply IBM WebSphere Liberty APAR PH03640 fix.
  • 137567: Apply IBM WebSphere Liberty APAR PH13269 fix.
  • 137773: Uplift IBM SDK, Java Technology Edition to IBM SDK, Java Technology Edition 8.0.5.35 for security fixes.
  • 139759: Uplift IBM WebSphere Liberty to Version 19.0.0.12  for security fixes.
  • 139847: Uplift Netty for security fixes.
  • 140831: Apply IBM WebSphere Liberty APAR PH19528 fix for Liberty 19.0.0.12.
  • 140832: Uplift Java to Version 8.0.6.5 for security fixes.
  • 140834: Apply IBM WebSphere Liberty APAR PH19989 fix for IBM WebSphere Liberty 19.0.0.12.
  • 142766: Uplift to IBM SDK, Java Technology Edition 8.0.6.15.
  • 143515: Uplift to IBM SDK, Java Technology Edition 8.0.6.26.
  • 145261: Uplift IBM WebSphere Liberty to 21.0.0.9 + PH39418.
  • 145452: IBM Cloud APM connection failure.
  • 145758: Uplift IBM WebSphere Liberty to Version 22.0.0.3 for security fixes.
  • 145759: Uplift IBM SDK, Java Technology Edition to Version 8.0.7.10 for security fixes.
  • 145795: Security vulnerability in Apache log4j.
  • 146295: Uplift IBM SDK, Java Technology Edition 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 IBM WebSphere Liberty customization.
  • 146502: Uplift IBM WebSphere Liberty to Version 22.0.0.3 for security fixes.
  • 146417: ITM Pure events were open in APM even when the situation was stopped and cleared from the TEP GUI.
  • 147324: After uninstalling Hybrid Gateway, the liberty profile is not deleted, and needs to be manually deleted.
  • 147313: PSIRT fixes for IBM® WebSphere® Liberty Server being used by APM Hybrid Gateway Server
  • 147314: PSIRT fixes for IBM SDK, Java Technology Edition, being used by APM Hybrid Gateway Server.
  • 147451: As an APM server developer, I want to upgrade the IBM WebSphere Liberty Server Version for the hybrid gateway from 23.0.0.5 to the latest available Version 23.0.0.9 so that vulnerabilities get fixed.
  • 147473: As an APM server developer, I want to upgrade the IBM SDK, Java Technology Edition Version for the hybrid gateway from 8.08.5 to 8.0.8.10  so that vulnerabilities get fixed.
  • 147538: As an APM Server developer, I want to upgrade the APM Server Hybrid Gateway IBM SDK, Java Technology Edition Version from 8.0.8.10 to 8.0.8.15 so that vulnerabilities get fixed.
  • 147539: As an APM Server developer, I want to upgrade the APM server Hybrid Gateway IBM WebSphere Liberty Version from 23.0.0.9 to the latest available Version 23.0.0.11 so that vulnerabilities get fixed.
  • 148040: US: IF16: As an APM Server developer, I want to upgrade the APM server Hybrid Gateway IBM WebSphere Liberty Version from 23.0.0.11 to 23.0.0.12 so that vulnerabilities get fixed.
  • 148042: US: IF16: As an APM Server developer, I want to upgrade the APM Server Hybrid Gateway IBM SDK, Java Technology Edition Version from 8.0.8.15 to 8.0.8.20 Version so that vulnerabilities get fixed.
  • 148113: US: As an APM Server developer, I want to upgrade the APM server Hybrid Gateway IBM WebSphere Liberty component to the IFPH60199 patch so that Fyre VMs vulnerabilities get fixed.
  • 148291: Story: IF17: As an APM Server developer, I want to upgrade the APM server Hybrid Gateway IBM WebSphere Liberty Version from 23.0.0.12 to 24.0.0.12 so that vulnerabilities get fixed.
  • 148293: Story: IF17: As an APM Server developer, I want to upgrade the APM Server Hybrid Gateway IBM SDK, Java Technology Edition Version from 8.0.8.20 to 8.0.8.35 Version so that vulnerabilities get fixed.

Superseded component patches

  • NA

Release highlights

Following is the list of the new features and enhancements for this release.

New features

  • Uplift IBM SDK, Java Technology Edition Version from 8.0.8.35 to 8.0.8.45.
  • Uplift IBM WebSphere Liberty Version from 24.0.0.12 to 25.0.0.5.

Enhancements

  • NA

Superseded enhancements

  • NA

Prerequisites

Following is the list of the prerequisites.

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

  • Check the support matrix documented in the System requirements topic.

Pre-installation tasks

  • The IBM Cloud Application Performance Management Hybrid Gateway component Version 8.1.4.0 must be installed and running before applying the interim fix.
  • Ensure the unzip command is installed on the computer system where the IBM Cloud Application Performance Management Hybrid Gateway is installed before installing the interim fix.
  • This interim fix backs up the /opt/ibm/wlp directory. You must ensure that you have enough disk space to back up that directory structure before installing the interim fix. If sufficient disk space is not available, then the IBM WebSphere Liberty component patch will not install, but the other component patches will install. You must run the hgpatch.sh again to install the IBM WebSphere Liberty patch after you have sufficient disk space.
  • You can reduce the amount of disk space required for the backup of the {apm_install_dir}/wlp directory by performing the following cleanup tasks before installing the interim fix.
    • Delete all the {hybrid_gateway_install_dir}/wlp-backup-{wlp_patch_number} directories if they exist, to free up the disk space. Replace {wlp_patch_number} with the numeric WLP patch numbers. These directories were created by the previous Cloud APM server interim fix installations and are not needed if you are installing the latest interim fix. 
      Example of WLP directories: wlp-backup-15, wlp-backup-14, wlp-backup-13, wlp-backup-12, wlp-backup-11, wlp-backup-10 and so on.
    • Delete the files that start with javacore, heapdump or core in the following directory.
      /opt/ibm/wlp/usr/servers/hybridgateway/
    • Delete the files that start with trace_ and messages_ in the following directories.
      /opt/ibm/wlp/usr/servers/hybridgateway/logs

Download details

Following are the download details for this release.

  1. Go to the Fix Central download link: 8.1.4.0-IBM-APM-GATEWAY-IF0016.
  2. In the Select fixes page, ensure that the release is selected, and click Continue.
  3. In the Download options page, select an appropriate option from the Select download options.
  4. Ensure you select Include prerequisites and co-requisite fixes (you can select the ones you need later) and click Continue.
  5. Depending upon the Operating system on which your agent is installed, click the appropriate download link.

Additional information

The Secure Hash Algorithm 1 (SHA1) checksum of the image follows.

  • SHA1(8.1.4.0-IBM-APM-GATEWAY-IF0016.tar) = 7988679d8350b76268adc3ef6dc7fcbb2866a093

The image contains the following files.

  • This readme file
  • 8.1.4.0-IBM-APM-GATEWAY-IF0016.tar file
Extracting the TAR file creates the following directory and patch files.

Linux

|-- apmpatch_functions
|-- hgpatch.sh
|-- msg
|-- nls_replace
|-- patches
|-- patch.properties

Installation instructions

Proceed as follows to install the agent.

  1. Extract the patch bundle on each computer machine where the agent is already installed by using the appropriate utility depending on your Operating system.

    Example
    8.1.4.0-IBM-APM-GATEWAY-IF0016.tar

  2. Open the extracted folder.
  3. Run the hgpatch script file.

    Linux

    cd 8.1.4.0-IBM-APM-GATEWAY-IF0016
./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 had 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.

Post-installation tasks

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

  • Starting in IBM WebSphere Liberty 24.0.0.3, verbose garbage collection logging is enabled by default when you use IBM SDK, Java Technology Edition, or IBM Semeru Runtimes as your Java implementation. Up to 10 verbosegc.XXX.log rolling log files are created in your log directory, with 1024 GC cycles per file, where XXX represents the sequence number of the log file. Custom configurations take precedence over the default behavior. 

  • The verbosegc logs get generated in the IBM WebSphere Liberty components (hybridgateway).
    Note: To disable the verbose garbage collection logs, delete existing verbosegc logs and add VERBOSEGC=false property to the server.env file in each IBM WebSphere Liberty component and restart the respective service.
    For more information, see the following links.

Known issues

None

Known limitations

None

Uninstallation instructions

Files modified by the interim fix are backed up during the installation. If you encounter an issue with the interim fix and need to roll it back, then contact IBM support for assistance. For more information, see Uninstalling the Hybrid Gateway topic.

Troubleshooting installation problems

For more information, see Troubleshooting and support topic.

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSVJUL","label":"IBM Application Performance Management"},"Component":"","Platform":[{"code":"PF016","label":"Linux"}],"Version":"8.1.4","Edition":"","Line of Business":{"code":"LOB77","label":"Automation Platform"}}]

Document Information

Modified date:
01 August 2025

UID

ibm17239735

Page Feedback