IBM Support

IBM Application Performance Management 8.1.4.0 8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-IF0003 Readme

Readme file for: Synthetic Playback Agent for IBM Cloud Application Performance Management 8.1.4.0 Interim Fix 3
Product/Component Release: 8.1.4.0
Update Name: 8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-IF0003
Fix ID: 8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0003
Publication Date: 16 April 2018
Last modified date: 16 April 2018

Download location

IMPORTANT NOTE: To download this update, you must first login to IBM Fix Central. 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.

Fix Download for Linux

Product/Component Name: Platform: Fix:
IBM Application Performance Management Linux
8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0003

Prerequisites and co-requisites

General description
This is an interim fix for the Synthetic Playback Agent provided with IBM Cloud Application Performance Management family of products, Version 8.1.4.0.
It includes fixes for the Synthetic Playback Agent and upgrades the data collector from version 01.00.05.00, 01.00.05.01 or 01.00.05.02 to 01.00.05.03.
The files for previous Synthetic Playback Agent must exist before you can apply this patch.

Platforms and prerequisites
The Synthetic Playback Agent is supported on the platforms documented here.

The interim fix for the Synthetic Playback Agent is intended to be applied to the Synthetic Playback Agent version 01.00.05.00, 01.00.05.01 or 01.00.05.02 which is provided with:

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

The Synthetic Playback Agent version 01.00.05.00, 01.00.05.01 or 01.00.05.02 must be installed before applying the interim fix.
The files for previous Synthetic Playback data collector must exist before you can apply this patch. It will be restarted as part of applying the patch.

Installing

Installing the interim fix

  1. Download the patch bundle from Fix Central:
    • Download 8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0003.tar

  2. "Use the command `firefox -version` to check the version. If it is not version ESR 52.x.0, update Firefox ESR to version 52.x.0. Versions other than ESR 52 are not supported. Only Firefox ESR flavor is supported with SN agent using 814 IF2"
  3. Unpack the patch bundle on each computer system where the data collector is already installed by using the tar utility
  4. Enter the created directory

  5. Please stop agent instances first, then run the apmpatch.sh tool:
    Run the apmpatch.sh script to apply the patch:

    Linux:
    ./apmpatch.sh [<APM agent install directory>]


    Notes: the <APM agent install directory> parameter only needs to be provided if the agent is installed in a non-default directory.

Performing the necessary tasks after installation of the interim fix

A successful installation modifies the Synthetic Playback Agent version to 01.00.05.03
Run the <agent-home>/agent/bin/cinfo -i command and verify that the km agent version is 01.00.05.03

Run the command crontab -l and get below output :
* * * * * sh /opt/packages/ff-killer.sh

There is a dependency between the Synthetic Playback agent interim fix and the Cloud APM 8.1.4.0 Server Interim Fix 4 or a later interim fix. It is recommended that you install the latest Cloud APM server interim fix after you update your playback agents.

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

Uninstalling if necessary

This 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 Application Performance Management guide, here:
http://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/com.ibm.pm.doc/install/uninstall_agents.htm

Additional information

The Secure Hash Algorithm 1 (SHA1) checksum of the image is as follows:
SHA1(8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0003.tar)= 91a82b28a6522a94a32572222636247b62afb139

Image Contents
The following files implement this fix.
- 8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-README-IF0003.readme.html - This README file

- 8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0003.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-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0003/
|-- apmpatch.sh
|-- patches
|-- patch.properties

New Features

The following changes are included in Synthetic Playback Agent interim fix:

  • None


List of fixes

The following problems are addressed by this interim fix.

APARs

  • None
Agent defects:
  • 132308: include the script ff-killer.sh into the patch


Enhancements:
  • None

APARS and defects from superseded agent interim fixes:
  • 129371: Support Firefox 52.x ESR
  • 131008: make synthetic agent 8.14 to be GDPR compliant


Document change history


Version Date Description of change
1.0 17 April 2018 Initial Version

Document information

More support for: IBM Application Performance Management

Reference #: 00003839

Modified date: 19 April 2018