Fix Readme
Abstract
Readme file for Synthetic Playback Agent for IBM Cloud Application Performance Management 8.1.4.0 Interim Fix 17
Product Release: 8.1.4
Update Name: 8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-IF0017
Fix ID: 8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-IF0017
Content
Download location
When you select fixes, ensure your download options are set to "Include prerequisites and co-requisite fixes."
http://www.ibm.com/support/fixcentral/
Fix Download for Linux
| Product Name | Platform | Fix |
| IBM Cloud APM Synthetic Playback Agent | Linux x86_64 |
Prerequisites and co-requisites
General description
This fix is an interim fix for Synthetic Playback Agent provided with IBM Cloud Application Performance Management family of products version 8.1.4.0
Platforms and prerequisites
The Synthetic Playback Agent is supported on the platforms documented here.
Prerequisites for this interim fix
The interim fix for Synthetic Playback Agent can be applied to any of the following Synthetic Playback Agent versions:
- 01.00.05.00
- 01.00.05.01
- 01.00.05.02
- 01.00.05.03
- 01.00.05.05
- 01.00.05.06
- 01.00.05.07
- 01.00.05.08
- 01.00.05.09
- 01.00.05.10
- 01.00.05.11
- 01.00.05.12
- 01.00.05.13
- 01.00.05.14
- 01.00.05.15
- 01.00.05.16
These Synthetic Playback Agent versions are provided with:
- IBM Cloud Application Performance Monitoring Advanced Private version 8.1.4.0
- IBM Cloud Application Performance Monitoring Advanced version 8.1.4.0
Ensure that Synthetic Playback Agent is already installed before you apply the interim fix.
Known limitations
-
SN agent can support latest IDE version, but several Selenium IDE commands do not work when used in playbacks on a Synthetic Agent.
-
This table highlights the differences between Selenium IDE 3.12 and SN agent IF17
| Commands | Works on IDE? | Works on Synthetic? |
|---|---|---|
| Add selection | Yes | No |
| Answer on next prompt | Yes | Yes |
| Assert | Yes | Yes |
| Assert alert | Yes | Yes |
| Assert checked | Yes | Yes |
| 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 |
| Check | 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 |
| Close | Yes | Yes |
| Debugger | Yes | No |
| Do | Yes | Yes |
| Double-click | Yes | Yes |
| Double-click at | Yes | Yes |
| Drag to object | Yes | Yes |
| Echo | Yes | Yes |
| Edit content | Yes | Yes |
| Else | Yes | Yes |
| Else if | Yes | Yes |
| End | Yes | Yes |
| Execute script | Yes | Yes |
| Execute async script | Yes | Yes |
| For each | Yes | Yes |
| If | Yes | Yes |
| Mouse down | Yes | Yes |
| Mouse down at | Yes | Yes |
| Mice 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 JSON | Yes | No |
| Store value | Yes | Yes |
| Store text | Yes | Yes |
| Store title | Yes | Yes |
| Store window handle | Yes | Yes |
| 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 |
| Verify selected value | Yes | Yes |
| Verify not selected value | Yes | Yes |
| Verify selected label | 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 answer 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 |
Installation information
Before installation
- 01.00.05.00
- 01.00.05.01
- 01.00.05.02
- 01.00.05.03
- 01.00.05.05
- 01.00.05.06
- 01.00.05.07
- 01.00.05.08
- 01.00.05.09
- 01.00.05.10
- 01.00.05.11
- 01.00.05.12
- 01.00.05.13
- 01.00.05.14
- 01.00.05.15
- 01.00.05.16
Installing
Installing IBM Cloud Application Performance Management Agent update
- [Optional] If you configured proxy for Synthetic Playback Agent with command "/$Candle_Home/lx8266/sn/bin/set_proxy.sh", then you need to back up the "/$Candle_Home/config/.sn.environment" before you apply this patch.
- Download the patch bundle from Fix Central:
- Download 8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0017.tar
-
On each server where Synthetic Playback Agent is already installed, use the command `firefox -version` to check the version. Check the table below to see supported list of Firefox ESR.
Supported Firefox ESR Version 102.5, 102.6, 102.7 - Stop Synthetic Playback Agent first, then create a folder and unpack the patch bundle to this folder by using the tar utility.
For example,
# $Candle_Home/bin/synthetic_playback-agent.sh stop
# mkdir /tmp/SN-8.1.4-IF17
# tar xvf 8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0016.tar -C /tmp/SN-8.1.4-IF17 - Change the current directory to the directory that includes this patch.
For example,
# cd /tmp/SN-8.1.4-IF17/8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0017/ - Run the apmpatch.sh tool to install this patch:
For example,
# ./apmpatch.sh [$Candle_Home]
Note:
If the agent is installed in a non-default directory, then you must provide [$Candle_Home] parameter.
The default $Candle_Home is /opt/ibm/apm/agent - [Optional] If you want to configure proxy for your Synthetic Playback Agent, then run the following commands:
# cd /$Candle_Home/lx8266/sn/bin
#./set_proxy.shEnter the agent installation path, default path is /opt/ibm/apm/agentAgent installation path is /opt/ibm/apm/agent
Input the number of proxy types:
1 manual proxy
2 no proxy
Select one of the proxy types to configure your Synthetic Playback Agent, input the necessary information to complete the configuration, and then restart Synthetic Playback Agent to make it effective.
Note: pac proxy and system proxy are not supported.
Performing the necessary tasks after installation
A successful installation modifies the Synthetic Playback Agent version to 01.00.05.17
Run <agent-home>/agent/bin/cinfo -i command and verify that the Synthetic Playback Agent version is 01.00.05.17
Run the command '/usr/bin/firefox -v' to view the output:
Mozilla Firefox 102.5.0esr
There is a dependency between Synthetic Playback Agent Interim Fix and Cloud APM 8.1.4.0 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, refer to the IBM Application Performance Management guide that is available at the following location:
http://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/com.ibm.pm.doc/install/uninstall_agents.htm
Troubleshooting installation problems from the Support site
For more 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 256 (SHA256) checksum of the image is as follows:
SHA256(8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0017.tar)= 6667e0b6eaec28ef66b1e255cfa321ba2fab3536c1c957f009a0ee5222c92000
Image Contents
The following files are included in this fix.
- 8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-README-IF0017.readme.html - This is a readme file
- 8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0017.tar - For extracting the patch files use the tar utility.
Extracting the bundle (.tar) creates the following directory and patch files:
Note: You can use the tar command to extract the .tar files:
# tar -xvf 8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0017.tar
8.1.4.0-IBM-APM-SYNTHETIC-PLAYBACK-AGENT-XLINUX-IF0017
|-- apmpatch.sh
|-- patches
|-- patch.properties
New Features
NoneList of fixes
The following CVE is addressed by this interim fix.
-CVEID: CVE-2022-42889
Description: Apache Commons Text could allow a remote attacker to execute arbitrary code on the system, caused by an insecure interpolation defaults flaw. By sending a specially crafted input, an attacker could exploit this vulnerability to execute arbitrary code on the system.
Affected Platforms: Apache Commons Text 1.9.0
Fix: Upgraded Apache Commons Text to 1.10.0
IBM Cloud Application Performance Management Synthetic Playback agent defects:
NoneEnhancements included from earlier interim fixes:
APARs and defects included in earlier interim fixes:
Document change history
| Version | Date | Description of Change |
|---|---|---|
| 1.0 | 16 Dec 2022 | Initial version |
| 1.1 | 14 Feb 2023 | Added Firefox 102.6 ESR Support |
| 1.2 | 10 Mar 2023 | Added Firefox 102.7 ESR Support |
Product Synonym
APM
Was this topic helpful?
Document Information
Modified date:
10 March 2023
UID
ibm16847849