IBM Support

IBM Tivoli Composite Application Manager for Transactions Response Time 7.4.0.2 Interim Fix 12 Readme

Fix Readme


Abstract

Readme file for: 7.4.0.2-TIV-CAMRT-IF0012
Product/Component Release: 7.4.0.2
Update Name: 7.4.0.2-TIV-CAMRT-IF0012
Fix ID: 7.4.0.2-TIV-CAMRT-AIX-IF0012, 7.4.0.2-TIV-CAMRT-LINUX-IF0012, 7.4.0.2-TIV-CAMRT-WINDOWS-IF0012
Publication Date: 2 June2020
Last modified date: 2 June 2020

Content

Download location
Prerequisites and co-requisites
Installing
Performing the necessary tasks after installation
Uninstalling if necessary
Troubleshooting installation problems from the Support site
Additional information
New Features
List of fixes
Document change history
 

Download location

To download this update you must first login to IBM FixCentral (http://www.ibm.com/support/fixcentral/). Once logged in, you may select from the individual download packages.

Note - The image of Tivoli Integration Support and Rational Integration Support (RIS) are packaged in Windows image 7.4.0.2-TIV-CAMRT-WINDOWS-IF0012.zip.

Below is a list of components, platforms, and file names that apply to this Readme file.


 
  • Fix Download for AIX

Product / Component Name Platform Fix
Tivoli Composite Application Manager for Transactions Response Time AIX

 

  

  • Fix Download for Linux

Product / Component Name Platform Fix
Tivoli Composite Application Manager for Transactions Response Time Linux 7.4.0.2-TIV-CAMRT-LINUX-IF0012

 

  

 
  • Fix Download for Windows

Product / Component Name Platform Fix
Tivoli Composite Application Manager for Transactions Response Time Windows 7.4.0.2-TIV-CAMRT-WINDOWS-IF0012

  

 

Prerequisites and co-requisites

This upgrade needs to be applied to T3, T5 and T6 agents where the version of ITM framework (ax) on the agent is equal to or higher than v6.3 FP7. If this condition is not true, you MUST NOT apply this fixpack.

This interim fix contains upgrade for ITCAM for Robotic Response Time (T6) only. The fix supports Rational Performance Tester 10.0 version and Rational Functional Tester 10.0 version.

The upgrade may be applied to the following base versions.

  • 7.4.0.2
IF0012 is a cumulative upgrade, all updates in the following releases are included in this upgrade.
 
  • 7.4.0.2
  • 7.4.0.2 - IF0001
  • 7.4.0.2 - IF0003
  • 7.4.0.2 - IF0005
  • 7.4.0.2 - IF0006
  • 7.4.0.2 - IF0007
  • 7.4.0.2 - IF0009
  • 7.4.0.2 - IF0010

Note: After this upgrade is applied, the new revision level for Response Time agents will display as '07.40.02.12' in cinfo reports and the MTEMS GUI.

The Rational Integration Support (RIS) installer is contained in the Windows image of this ifix. RIS of this update supports RFT/RPT 10.0 script export. It requires T6 playback agent at minimum version of 7.4.0.2 ifix12 to run RFT/RPT 10.0 Rational scripts.
 
This ifix can be run under Windows Server 2016 STD OS system. It requires the minimum playback agent version of 7.4.0.2.12 to playback RPT/RFT 10.0 scripts with Windows Server 2016 STD.
 

Installing

Download the corresponding executable file bundle for your operating system or package:

  • AIX : 7.4.0.2-TIV-CAMRT-AIX-IF0012.tar
  • Linux : 7.4.0.2-TIV-CAMRT-Linux-IF0012.tar
  • Windows : 7.4.0.2-TIV-CAMRT-Windows-IF0012.zip

Installing the update on Windows TEMA
 
  1. Extract the 7.4.0.2-TIV-CAMRT-Windows-IF0012.zip file to a temporary directory (i.e. C:\temp\7.4.0.2-IF0012).
  2. USING THE WIZARD INSTALLATION GUI.
    a. Execute the setup.exe command to start the Installation Wizard. The setup.exe is located under the WINDOWS directory in the chosen temporary directory.
    For example:
    # C:\TEMP\7.4.0.2-IF0012\WINDOWS\setup.exe

    b. Follow the Installation Wizard panels by responding to each option that corresponds to the TEMA agent being upgraded.

    Default values are provided. It is possible to select or specify different options that must match the appropriate settings for your environment. Also, you may be required to fill in the values when a blank option is not permitted.

    NOTE: During the interactive installation, you can choose to add the TEMA to the TEMS depot so you can do remote installs for the platform you are adding into the depot.
  3. USING THE SILENT INSTALL CLI.
    a. Prepare the silent install file to configure appropriate values for the installation program to use while running the installation process.
    The silent installation configuration file is located under the Windows directory of the directory image. (i.e. C:\TEMP\7.4.0.2-IF0012\Windows\silent.txt)
    b. Edit the silent install file to provide appropriate values for the desired configuration. By default, all options are commented out, and the installer uses the values from the previous TEMA configuration.
    For additional information on the options for the silent installation of the TEMA agents, please consult the ITCAM for Transactions V7.4.0.1 Installation and Configuration Guide.
    Refer to the following chapter in the product documentation for further instructions on the use of the silent installation features for this maintenance package:
    Perform a silent install of a monitoring agent (Windows)
  4. REBOOT THE COMPUTER.
    After the installation of the upgrade of a TEMA in Windows, it is necessary to reboot the computer to allow the system to properly register the latest settings in the ITCAM, ITM and Operating System registries.
    In environments where the TEPS and RT TEMA agents coexist in the same ITM instance, the update for the TEMAs offers the option to restart the computer. Install the support packages for the TEPS first. Allow the TEPS to restart before restarting the computer as part of the TEMA update.

Installing the update on Unix/Linux TEMA
 
  1. Download the Unix/Linux upgrade package and extract it to a temporary directory (i.e. /tmp/7.4.0.2-IF0012).
  2. USING THE SCRIPT BASED INSTALLATION PROCEDURE.
    a. Execute the install.sh to start the Installation Wizard. The install.sh command is located directly under the main directory of the upgrade image.
    For example:
    # /tmp/7.4.0.2-IF0012/install.sh

    b. Follow the text wizard panels by responding to each option that corresponds to the TEMA agent to be upgraded.

    Default values are provided. You may select different options or you may be required to fill in the values when a blank option is not permitted.

    NOTE: During the interactive installation, respond "2" to the following option.
    Do you want to check prerequisites for the above components? [ 1=Yes, 2=No ; default is "1" ] ?

    c. After the Installation Wizard completes, you must configure your agents.
    This is done by issuing the ITM itmcmd command as follows:
    $ITM_HOME/bin/itmcmd config -A <AGENT_TYPE>
    Where <AGENT_TYPE> is t3, t5 or t6
    For example, to configure the Robotic Response Time agent (t6), issue:
    # $ITM_HOME/bin/itmcmd config -A t6
  3. USING THE SILENT INSTALL CLI.
    Prepare the silent install file to configure appropriate values for the installation program to use while running the installation process.
    Refer to the following section of the product documentation for additional information in using the silent installation in Unix/Linux environments:
    Perform a silent install and configuration for a monitoring agent (UNIX or Linux)

Installing application support for TEPS/TEMS

For each monitoring agent installed, you must install agent-specific application support on IBM Tivoli Monitoring components. You can choose to install application support on all components at one time, or you can install the application support on components separately. If installing components separately, the following order is recommended:
  1. Tivoli Enterprise Monitoring Server
  2. Tivoli Enterprise Portal Server
  3. Tivoli Enterprise Portal Desktop Client
  4. Tivoli Enterprise Portal Server Browser client (for Linux and UNIX Only)

The procedure for installing agent-specific application support on the components is similar to installing the monitoring agent. The main difference is to select the application support components required.

Note: When installing application support, any ITM components on the current machine is automatically stopped, including any TEMS or TEPS. Follow the Starting and stopping servers and agents guide to manually stop ITM agents and infrastructure. You should warn other users before beginning the installation.

For step by step application support installation information refer to the documentation:
Install application support for Linux and UNIX
Install application support for Windows system


Specific Installation Instructions for Agents

  • T3 AMC-APPLICATION MANAGEMENT CONSOLE (END USER DASHBOARD) AGENT
    After installing this maintenance package, the agent must be reconfigured using the MTEMS console or the CLI interface, so that necessary configuration changes are done and the agent processes can be initialized with the new settings.
    For example:
    <ITM_HOME>/bin/itmcmd config -A t3
  • T5 WRT-WEB RESPONSE TIME AGENT
    When upgrading T5 agents that are monitoring local instances of the IBM HTTP Server, it is necessary to stop the IHS process prior to the upgrade. For all other web server instances it is also recommended to stop the server prior to running the upgrade and reconfiguration of the T5 agent. It is not required to stop web servers when monitoring remote transactions.
    After installing this maintenance package, the agent must be reconfigured using the MTEMS console or the CLI interface. For example:
    <ITM_HOME>/bin/itmcmd config -A t5
  • T6 RRT-ROBOTIC RESPONSE TIME AGENT
    After installing this maintenance package, the agent must be reconfigured using the MTEMS console or the CLI interface, so that necessary configuration changes are done and the agent processes can be initialized with the new settings.
    For example:
    <ITM_HOME>/bin/itmcmd config -A t6
 
Rational Integration Support

This maintenance vehicle also provides an updated Rational Integration Support installer which must be installed on all RPT or RFT workbench installations that need to export scripts for monitoring. This installer automatically upgrades any previously installed Rational Integration Support packages. It can also be used to perform new installations.

For RPT/RFT installation instructions:
Installing integration support for Rational Performance Tester
Installing integration support for Rational Functional Tester
 

Performing the necessary tasks after installation

A successful installation modifies the Transactions Response Time version to 7.4.0.2 IFIX12. Ensure that the Version of all RT agents in the MTEMS is '07.40.02.12'.

On Windows: the installation logs are written to the following directory: ITM\InstallITM\

On Unix/Linux: the installation logs are written to the following directory: ITM/logs/

When RIS of IFIX 12 is applied on RPT/RFT,
Version: 7.4.0.2
Build id: 202005190041

The Version and Build id value information in Rational Performance Tester menu 'Help' -> 'About Rational Performance Tester' -> 'Rational Performance Tester Installation Details' -> 'Features' -> Provider 'IBM Tivoli',  Feature 'ITCAM for Transactions'

The Version and Build id value information in Rational Functional Tester menu 'Help' -> 'About Rational Functional Tester' -> 'Rational Functional Tester Installation Details' -> 'Features' -> Provider 'IBM Tivoli',  Feature 'ITCAM for Transactions'

 

Uninstalling if necessary

This maintenance package cannot be rolled back. The uninstallation instructions require that the TEMA agent be uninstalled and reinstalled.

Uninstalling the TEMA on Windows

  1. Go to the Windows Control Panel.
  2. Choose "Add or Remove Program".
  3. Click on the TEMA you want to uninstall, then choose "Change/Remove" to uninstall it.
  4. Or click on "IBM Tivoli Monitoring" then choose "Change/Remove". Uncheck the TEMA in a checkbox to uninstall the item.

Uninstalling the TEMA on Unix/Linux

  1. Issue the following command from the /IBM/ITM/bin directory:
    ./uninstall.sh
  2. Follow the instructions to uninstall the TEMA that you want to remove.
Uninstalling the RIS on Windows
 
  1. Go to the Windows Control Panel.
  2. Choose "Add or Remove Program".
  3. Click on the RIS item - "ITCAM for Transactions 7.4.0.2 Integration plug-in" you want to uninstall.
  4. Choose "Change/Remove" to uninstall it.
Uninstalling the RIS by uninstall.bat
 
  1. Issue the following command from the installation directory (default installation directory is C:\Program Files (x86)\IBM\SDP\rt_plugin_uninstall): uninstall.bat
  2. Follow the instructions to uninstall the RIS software that you want to remove.
 

Troubleshooting installation problems from the Support site

For more detailed information, refer to the Troubleshooting Guide:
https://www-01.ibm.com/support/knowledgecenter/SS5MD2_7.4.0.1/com.ibm.itcamt.doc/rt/TSG/rt_trouble_oview.html

Additional information

The Secure Hash Algorithm 256 (SHA256) checksum of the image is as follows:

7.4.0.2-TIV-CAMRT-AIX-IF0012.tar - 2BFAD6F3710E2678BF1EBD8CEA25B9724E7A39081BA7AAF1780CDF236C43B5FD

7.4.0.2-TIV-CAMRT-Linux-IF0012.tar - B02AD597EECC005D07B16A6FE090A777BD4A220371D734C7FF0D7DAE35CF2E1D

7.4.0.2-TIV-CAMRT-Windows-IF0012.zip - F04EF65362AACA9FC5AA1A3DCD77A0822A5F7F2C8B99A304F54DBB426B6D2F1A

New Features

  • RIS: support RFT 10.0 version script exporting
  • RIS: support RPT 10.0 version script exporting

List of fixes

The following problems are addressed by this interim fix.

APARs 
  • IJ22072 ClientTime memory leak issue in TS002765697
Agent defects: 
  • 31684 D - 7.4.0.2 - PSIRT ADV0021246 SQLite Vulnerabilities CVE-2019-19603, CVE-2019-19645, CVE-2019-19646, CVE-2019-19880, CVE-2019-19923, CVE-2019-19924, CVE-2019-19925, CVE-2019-19926
Enhancements included from previous interim fixes: 
  • RIS: support RFT 9.2/9.5 version script exporting
  • RIS: support RPT 9.2/9.5 version script exporting
  • T6 - Supports Rational Performance Tester version 9.1
  • 30645 kfcm120 allow support for multiple X-Forwarded-For headers
  • 29954 Port PacketRateFrameChecker from tx_dev to 7.4 maint
  • 28534 RFE67857 Add NTLM Secure Service Provider User Authentication Support for WRT
APARs and defects included in previous interim fixes: 
  • APARs
    • IJ16169 ITCAM4TX 7.4: CAN NOT EXPORT RPT 9.1 HTTP TEST SCRIPT TO AMC WHEN USING **ENCRYPTED** DATAPOOLS
    • IJ00026 PSIRT 9227 IBM SDK, Java Technology Edition Quarterly CPU - Jul 2017 - Includes Oracle Jul 2017 CPU
    • IV98604 CONTENT CAPTURE FAILED TO OPEN BY IE 11
    • IV94339 T3, T5, T6 APP SUPPORT INCORRECT VERSION, RESULTING IN "APPLICATION SUPPORT MISMATCH" REPORTED IN TEP
    • IV93911 T3/T5/T6 AGENT ON LINUX CRASHES AFTER UPGRADING ITM FROM 6.3 FP06 TO 6.3 FP07
    • IV93568 URL and Status_Code attributes in WRT Transaction Instance Table can occasionally miss match on HTTP pipelining
    • IV88234 WRT network timing calculations not processed correctly for HTTP transactions containing a 100-continue expectation
    • IV87235 WRT terminates when processing persistent HTTP connection containing multiple requests and missing packets
    • IV86304 AMCE 7401 SLOW WITH LARGE ZIP FILES IN THE RFT AND RPT RUNTIME FOLDERS IN THE KT1DEPOT
    • IV85027 T3 applications are offline when failed to connect to TEMS
    • IV84400 PSIRT 5154 CODE BLUE [SE-2012-01] Broken security fix in IBM Java
    • IV79637 KT6 Agent set wrong KT6_JAVA_HOME in Runtime Environment on Linux platform
    • IV79325 WRT TCP Sequencer uses wrong payload length when packets are truncated
    • IV78697 TEMS RECYCLE STOPS AMC STH FILE GENERATION
    • IV78532 kfcm120 on AIX can occasionally consume excessive kernel CPU resource without BPF optimization
    • IV78180 Some information is missing in VP Failure Event on TEP
    • IV77635 T3 NEEDS TO RETURN ALL DATA FOR HISTORY REQUEST
    • IV77457 RIS7401 install - wrong message of unsupported version for RFT 8.6 and RPT 8.6
    • IV76849 WRT does not support IP frames tagged by more than one 802.1Q VLAN tag
    • IV76483 CHUNKS THAT START WITH CRLF ARE NOT PROCESSED CORRECTLY BY WRT
    • IV76481 CHUNKED POSTS WITH 100 CONTINUE ARE NOT PARSED CORRECTLY BY WRT
    • IV76185 When Citrix Connection Failure Event or Citrix Create Window Failure Event happens, no Citrix Server Address shows in TEP Event record
    • IV76162 RPT script playback failed with error message Test virtual user setup failed. startStatus=-14
    • IV74161 When enable Content capture In Windows Platform, Content Capture zip files continue to generate without VP failure Event
    • IV73894 RIS: The VP added by ITCAM Test Editor has some problems, it will make the VP failure message be incorrect
    • IV72305 wfcrun32.exe must be restarted periodically, if not some unexpected VP failure will happen
  • Agent defects:
    • 85102 WRT stops showing data after 1 day running
    • 31660: D - PSIRT ALERT: 18003 Open Source SQLite Vulnerabilities CVE-2019-16168 - 7.4.0.2
    • 31610: D - PSIRT ALERT: 161901 Open Source SQLite Vulnerabilities CVE-2019-8457 - 7.4.0.2
    • 31583: D - PSIRT ALERT: 14951 Open Source SQLite Vulnerabilities CVE-2018-20346 - 7.4.0.2
    • 31537: Update Java Certificates for 7.4 on Nov 2018
    • 31438 D - PSIRT ALERT: 11534 Open Source SQLite Vulnerabilities CVE-2018-8740
    • 31397: TS000055529 Garbled text in "Information" RRT Agent Messages
    • 31246 D - PSIRT ALERT: 9137 Open Source SQLite Vulnerabilities CVE-2017-10989
    • 31022 PSIRT ALERT : 7621 zlib Vulnerabilities
    • 30922 PSIRT ALERT: 6888 Open Source SQLite Vulnerabilities
    • 30818 PSIRT ALERT: 5934 xerces-C Vulnerability & possible mitigation
    • 30644 Update ARM with newer version TRANS_5907 for xerces-c PSIRT
    • 30420 PSIRT 5417 Open Source Apache Xerces-C XML parser Vulnerabilities - CVE-2016-0729
    • 29817 T3 writes blank value to ORIGINNODE column when the AMC ISM table is being queried
    • 29758 RPT Citrix playbacks timeout after starting new playbacks
    • 29347 Make RRT work well when the installation directory contains SPACE
    • 28937 Fix buildWhereClause SQL insertion vulnerability in CTableManager
    • 28820 PSIRT 3528 IBM SDK, Java Technology Edition Quarterly CPU
    • 28813 WRT crash in CSpec_DecryptAESGCM()
    • 28390 kfcm120 segmentation fault on shutdown with incomplete SSL sessions
    • 25603 RIS: Default password incorrect when exporting a script using SSL
    • 20392 RIS: RFT Export of script inside folder fails

Document change history

Version Date Description of change
1.0 2 June2020 Initial Version

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS5MD2","label":"Tivoli Composite Application Manager for Transactions"},"ARM Category":[{"code":"a8m500000008i3OAAQ","label":"ITCAM-for-Transactions->Robotic Response Time RRT"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"7.4.x","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 June 2020

UID

ibm16218854