IBM Support

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

Fix Readme


Abstract

Readme file for: Hybrid Gateway for IBM Cloud Application Performance Management Version 8.1.4.0 Interim Fix 6
Product/Component Release: 8.1.4
Update Name: 8.1.4.0-IBM-APM-GATEWAY-IF0006
Fix ID: 8.1.4.0-IBM-APM-GATEWAY-IF0006
Publication Date: 25 March 2019
Last modified date: 25 March 2019


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 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/

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 http://www.ibm.com/support/fixcentral/swg/quickorder?product=ibm/Tivoli/IBM+Application+Performance+Management&function=fixid&fixids=8.1.4.0-IBM-APM-GATEWAY-IF0006

Prerequisites and co-requisites

General description 

This is an interim fix for the Hybrid Gateway component 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 level 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

The IBM Cloud Application Performance Management Hybrid Gateway component must be installed and running before applying the interim fix.

Installing

Installing the IBM Cloud Application Performance Management Hybrid Gateway update 
 

1. Download 8.1.4.0-IBM-APM-GATEWAY-IF0006.tar from IBM Fix Central to a temporary directory (e.g. /tmp/if06-patch) on the computer where you installed the Hybrid Gateway. 

2. Change your current directory to the download location, e.g.
cd /tmp/if06-patch 

3. Expand the archive file using the tar command 
e.g. tar -xf 8.1.4.0-IBM-APM-GATEWAY-IF0006.tar 

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

Notes: 

  • If Hybrid Gateway services need to be stopped for the patch to be applied, you will be asked to confirm that 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 file hgpatch.log in the logs directory,
      e.g. /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.

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, 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/integ_hybridgateway_uninstall.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 (SHA1) checksum of the image is as follows:
SHA1(8.1.4.0-IBM-APM-GATEWAY-IF0006.tar) = fd4476b427613704accd5d0f47258562e270553a

Image Contents 


The following files implement this fix:
- 8.1.4.0-IBM-APM-GATEWAY-IF0006.readme.html - This README file

- 8.1.4.0-IBM-APM-GATEWAY-IF0006.tar - For extracting 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-IF0006/
|-- 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 06:

  • Defect fixes and other stability improvements

 

List of fixes

The following problems are addressed by this interim fix.

APARs 

None

IBM Cloud Application Performance Management Hybrid Gateway  defects: 

  • 135609: Uplift Java to version ​8.0.5.25 for security fixes

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

Document change history

Version Date Description of change
1.0 25 March 2019 Initial Version

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"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:
25 March 2019

UID

ibm10874996