Readme file for: Synthetic Playback Agent for IBM Cloud Application Performance Management 22.214.171.124 Interim Fix 6
Product/Component Release: 8.1.4
Update Name: 126.96.36.199-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-IF0006
Fix ID: 188.8.131.52-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0006
Publication Date: 22 April 2019
Last modified date: 22 April 2019
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".
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|
|IBM Cloud APM Synthetic Playback agent||Linux x86_64|
Prerequisites and co-requisites
This is an interim fix for the Synthetic Playback Agent provided with IBM Cloud Application Performance Management family of products, Version 184.108.40.206.
It includes fixes for the Synthetic Playback Agent and upgrades the agent from version 01.00.05.00, 01.00.05.01, 01.00.05.02 , 01.00.05.03, or 01.00.05.05 to 01.00.05.06.
The Synthetic Playback Agent must already be installed before you can apply this interim fix.
Platforms and prerequisites
The Synthetic Playback Agent is supported on the platforms documented here.
Prerequisites for this interim fix
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, 01.00.05.02, 01.00.05.03 or 01.00.05.05 which is provided with:
IBM Cloud Application Performance Monitoring Base Private, Version 220.127.116.11
IBM Cloud Application Performance Monitoring Advanced Private, Version 18.104.22.168.
IBM Cloud Application Performance Monitoring Base, Version 22.214.171.124
IBM Cloud Application Performance Monitoring Advanced, Version 126.96.36.199.
The Selenium IDE commands are not very consistent with them on SN IF06, so some of the commands can work well on IDE but can't be supported on SN IF06
Here is the table of comparison for commands between IDE 3.5.X and SN IF06
Work on IDE (Yes or No)Work on SN IF06(Yes or No)
assert not checked Yes Yes assert confirmation Yes Yes assert editable Yes Yes assert not editable Yes Yes assert element present Yes Yes assert element not present Yes Yes assert prompt Yes Yes assert selected value Yes Yes assert not selected value Yes Yes assert selected label Yes Yes assert text Yes Yes assert not text Yes Yes assert title Yes Yes assert value Yes Yes choose cancel on next confirmation Yes Yes choose cancel on next prompt Yes Yes choose ok on next confirmation Yes Yes click Yes Yes click at Yes Yes check Yes Yes close Yes Yes debugger Yes No do Yes Yes double click Yes Yes double click at Yes Yes drag and drop to object Yes Yes echo Yes Yes else Yes Yes else if Yes Yes end Yes Yes execute script Yes Yes execute async script Yes No edit content Yes Yes if Yes Yes mouse down Yes No mouse down at Yes Yes mouse move at Yes Yes mouse out Yes Yes mouse over Yes Yes mouse up at Yes Yes open Yes Yes pause Yes Yes remove selection Yes Yes repeat if Yes Yes run Yes No run script Yes Yes select Yes Yes select frame Yes Yes select window Yes Yes send keys Yes Yes set speed Yes Yes set window size yes yes store Yes Yes store attribute Yes Yes store text Yes Yes store value Yes Yes store title Yes Yes store window handle yes No store xpath count Yes Yes submit Yes Yes times Yes Yes type Yes Yes uncheck Yes Yes verify Yes Yes verify checked Yes Yes verify not checked Yes Yes verify editable Yes Yes verify not editable Yes Yes verify element present Yes Yes verify element not present Yes Yes vefify selected value Yes Yes verify not selected value Yes Yes verify text Yes Yes verify not text Yes Yes verify title Yes Yes verify value Yes Yes verify selected label Yes Yes wait for element editable Yes Yes wait for element not editable Yes Yes wait for element not present Yes Yes wait for element not visible Yes Yes wait for element present Yes Yes wait for element visible Yes Yes webdriver anwser on visible prompt Yes No webdriver choose cancel on visible confirmation Yes No webdriver choose cancel on visible prompt Yes No webdriver choose ok on visible confirmation Yes No while Yes Yes
Prior to installation
The agent is restarted as part of applying the patch.
Installing the IBM Cloud Application Performance Management Server update
- Download the patch bundle from Fix Central:
- Download 188.8.131.52-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0006.tar
Use the command `firefox -version` to check the version. If the version is not 60.5.1ESR, update Firefox to version 60.5.1ESR. Versions other than 60.5.1ESR are not supported.
- Unpack the patch bundle on each computer system where the data collector is already installed by using the tar utility
- Enter the created directory
- Please stop agent instances first, then run the apmpatch.sh tool:
Run the apmpatch.sh script to apply the patch:
./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
A successful installation modifies the Synthetic Playback Agent version to 01.00.05.06
Run the <agent-home>/agent/bin/cinfo -i command and verify that the km agent version is 01.00.05.06
Run the command /opt/firefox/firefox -v get below output:
Mozilla Firefox 60.5.1
There is a dependency between the Synthetic Playback agent interim fix and the Cloud APM 184.108.40.206 Server Interim Fix 8 or a later interim fix. It is recommended that you install the latest Cloud APM server interim fix after you update your playback agents so that you can use Selenium .side scripts.
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:
Troubleshooting installation problems from the Support site
For more detailed information, refer to the Troubleshooting and support Guide:
The Secure Hash Algorithm 1 (SHA1) checksum of the image is as follows:
he following files implement this fix.
- 220.127.116.11-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-README-IF0006.readme.html - This README file
- 18.104.22.168-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0006.tar - For extracting patch files use the tar utility.
Extracting the above bundle (.tar) creates the following directory and patch files:
- wait for element editable
- wait for element not editable
- wait for element present
- wait for element not present
- wait for element visible
- wait for element not visible
List of fixes
The following problems are addressed by this interim fix.
Enhancements included from previous interim fixes:
APARs and defects included in previous interim fixes:
Document change history
|Version||Date||Description of change|
|1.0||19 April 2019||Initial Version|
08 May 2019