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

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.

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.

None

None

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

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

The following problems are addressed by this interim fix.

APARs

• None

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

• None
  

• 129371: Support Firefox 52.x ESR
• 131008: make synthetic agent 8.14 to be GDPR compliant