IBM Support

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

Fix Readme


Abstract

Readme file for 7.4.0.2-TIV-CAMRT-IF0023
Product - Component Release: 7.4.0.2
Update Name: 7.4.0.2-TIV-CAMRT-IF0023
Fix ID: 7.4.0.2-TIV-CAMRT-AIX-IF0023, 7.4.0.2-TIV-CAMRT-LINUX-IF0023, 7.4.0.2-TIV-CAMRT-SOLARIS-IF0023, 7.4.0.2-TIV-CAMRT-WINDOWS-IF0023
Date: January 03, 2024
Last modified date: January 24, 2024

Content

Contents:
-------------

1.0 Download location

==================

To download this fix, you must first log in to IBM Fix Central. When logged in, you can select from the individual download packages.

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

Note - The Rational Integration Support (RIS) image is packaged in Windows image, 7.4.0.2-TIV-CAMRT-WINDOWS-IF0023.zip.

Here 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 7.4.0.2-TIV-CAMRT-AIX-IF0023

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-IF0023

Fix Download for Solaris

Product / Component Name Platform Fix
Tivoli Composite Application Manager for Transactions Response Time Solaris 7.4.0.2-TIV-CAMRT-SOLARIS-IF0023
 

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-IF0023

2.0 Prerequisites and corequisites

===========================

This fix needs to be applied to T3, T5, and T6 agents where the version of ITM framework ('AX') on the agent is equal to or later than v6.3 FP7 SP6. If this condition is not true, then you must not apply this fix pack.

From 7.4.0.2 - IF0016, the IBM Tivoli Composite Application Manager (ITCAM) for Transactions Response Time agents for Windows will support Windows 2012 and later versions only.

Since the release of Windows 10 Version 1803 and Windows Server 2019, RFT playbacks are supported to playback on T6 agents only, which run as a process. This technote provides more information relating to this requirement and instructions to enable running the T6 agent as a process.

The fix can be applied to the following base versions:

  • 7.4.0.1 (Includes all 7.4.0.1 updates) and 7.4.0.2
IF0021 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
  • 7.4.0.2 - IF0012
  • 7.4.0.2 - IF0013
  • 7.4.0.2 - IF0014
  • 7.4.0.2 - IF0015
  • 7.4.0.2 - IF0016
  • 7.4.0.2 - IF0018
  • 7.4.0.2 - IF0020
  • 7.4.0.2 - IF0021

Note: After you apply this fix, the cinfo reports and MTEMS GUI display the Response Time agents version as “07.40.02.23”.

The Rational Integration Support (RIS) installer is also included in the Windows image of this interim fix. The packaged RIS supports RPT/RFT 10.5.4 script export. To run RPT/RFT 10.5.4 Rational scripts, ensure that T6 playback agent version 7.4.0.2.23 or later is installed on your machine.

3.0 Installing

===========

Download any of the following file based on your operating system or package:

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

Installing the fix on Windows Tivoli Enterprise Monitoring Agent (TEMA)
 
  1. Extract the 7.4.0.2-TIV-CAMRT-Windows-IF0023.zip file to a temporary directory. For example: C:\temp\7.4.0.2-IF0023.
     
  2. You can install the fix either by using the installation wizard or by using CLI for silent installation:
  • USING THE WIZARD INSTALLATION GUI
    a. Run the setup.exe command to start the Installation Wizard. The setup.exe is located in the WINDOWS directory in the temporary directory.
    For example:
    # C:\TEMP\7.4.0.2-IF0023\WINDOWS\setup.exe

    b. Follow the instructions on the Installation Wizard panels and respond to each option that corresponds to TEMA agent upgrade.

    Default values are provided. You can select or specify different options based on your environment settings. On some panels where you cannot leave any field blank, you need to provide appropriate values.
    Note: During the installation, you can choose to add TEMA to TEMS depot to enable remote installations on the platform that you are adding to the depot.
 
  • USING THE SILENT INSTALLATION CLI
    a. Prepare the silent installation file to configure appropriate values for the installation program. These values will be used while running the installation process.
    The silent installation configuration file is located in the Windows directory of the directory image. For example, C:\TEMP\7.4.0.2-IF0023\Windows\silent.txt

    b. Edit the silent installation file to provide appropriate values for the required configuration. By default, all options are commented out, and the installer uses the values from the previous TEMA configuration.
    For more information about the silent installation options available for TEMA agent, refer to 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 silent installation features for this maintenance package:
    Perform a silent installation of a monitoring agent (Windows)
3. Restart the computer.
    When you restart the computer, the system registers the latest settings in the ITCAM, ITM, and   Operating System registries.
    In environments where TEPS and RT TEMA agents coexist on the same ITM instance, when you update TEMA, an option to restart the computer is displayed. You must install the support packages for TEPS first, then restart TEPS, before restarting the computer as part of the TEMA update.
 
Installing the fix on Unix - Linux TEMA
 
  1. Download the Unix - Linux upgrade package and extract it to a temporary directory. For example, /tmp/7.4.0.2-IF0023
     
  2. You can install the fix either by using the installation wizard or by using CLI for silent installation:
  • USING THE SCRIPT BASED INSTALLATION PROCEDURE
    a. Run the install.sh to start the Installation Wizard. The install.sh command is located directly in the root directory of the upgrade image.
    For example:
    # /tmp/7.4.0.2-IF0023/install.sh

    b. Follow the instructions on the Installation Wizard panels and respond to each option that corresponds to TEMA agent upgrade.

    Default values are provided. You can select or specify different options based on your environment settings. On some panels where you cannot leave any field blank, you need to provide appropriate values.

    Note: During the interactive installation, enter "2" when the following query appears:
    Do you want to check prerequisites for the above components? [ 1=Yes, 2=No ; default is "1" ] ?

    c. After the installation is done, you must configure your agents.
    This is done by running 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), run the following command:
    # $ITM_HOME/bin/itmcmd config -A t6
 
  • USING THE SILENT INSTALLATION CLI
    Prepare the silent installation file to configure appropriate values for the installation program. These values will be used while running the installation process.
    Refer to the following section of the product documentation for additional information about using the silent installation in Unix/Linux environments:
    Perform a silent installation and configuration for a monitoring agent (UNIX or Linux)
 
Installing application support for TEPS and TEMS

For each monitoring agent that you install, 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 you plan to install the application support on components separately, then ensure that you install agent-specific application support on the components in the following order:
  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 to install agent-specific application support on the components is similar to installing the monitoring agent. The main difference is to select the required application support components.

Note: When installing application support, any ITM components on the current machine are automatically stopped, including any TEMS or TEPS. 

Refer to the Starting and stopping servers and agents topic to manually stop ITM agents and infrastructure. Ensure that you inform other users before starting the installation.

For information about the step by step application support installation, see the following 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 you install this maintenance package, you must reconfigure the agent to initialize the agent processes with the new settings. You can reconfigure the agent either by using the MTEMS console or CLI.
    For example:
    <ITM_HOME>/bin/itmcmd config -A t3
  • T5 WRT-WEB RESPONSE TIME AGENT
    When you upgrade T5 agents that are monitoring local instances of the IBM HTTP Server, you must stop the IHS process before the upgrade. For all other web server instances, it is a good practice to stop the server before running the upgrade and reconfiguring the T5 agent. It is not required to stop web servers when monitoring remote transactions.
    After installing this maintenance package, you must reconfigure the agent by 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, you must reconfigure the agent to initialize the agent processes with the new settings. You can reconfigure the agent by using the MTEMS console or the CLI interface.
    For example:
    <ITM_HOME>/bin/itmcmd config -A t6
 
Rational Integration Support
 
This fix also provides an updated Rational Integration Support (RIS) installer which must be installed on all RPT or RFT workbench installations that need to export scripts for monitoring. The RIS installer automatically upgrades any previously installed Rational Integration Support packages. It can also be used to perform new installations.

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

Supported versions of RPT and RFT

RPT
  • RPT 9.2.0.*
  • RPT 9.5.0.*
  • RPT 10.0.0.*
  • RPT 10.2.3.*
  • RPT 10.5.1.*
  • RPT 10.5.4.*

RFT

  • RFT 9.2.0.*
  • RFT 9.5.0.*
  • RFT 10.0.0.*
  • RFT 10.2.3.*
  • RPT 10.5.1.*
  • RPT 10.5.4.*
 

4.0 Verifying the installation

======================
To ensure that you have successfully installed the fix, you must check the Transactions Response Time version. All the RT agents in MTEMS display their version as 07.40.02.23.
 
You can check the installation logs for the version numbers.
 

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/

You must also check the version and build number of RIS on RPT or RFT.

The RIS version and build ID must be displayed as follows:
Version: 7.4.0.2
Build ID: 202312010125

Ensure a successful verification by rebooting the Windows server after installing RPT and RIS, as the feature 'IBM Tivoli' may only be listed under RPT -> Help RPT after the reboot.

To check the RIS build ID and version, navigate to the following location in Rational Performance Tester:  Help -> About Rational Performance Tester -> Rational Performance Tester Installation Details -> Features -> Provider 'IBM Tivoli', Feature 'ITCAM for Transactions'

To check the RIS build ID and version, navigate to the following location in Rational Functional Tester:   Help -> About Rational Functional Tester -> Rational Functional Tester Installation Details -> Features -> Provider 'IBM Tivoli', Feature 'ITCAM for Transactions'

5.0 Uninstalling

=============

This maintenance package cannot be rolled back. You must uninstall TEMA agent, and then reinstall the agent.

Uninstalling the TEMA on Windows

  1. Go to the Windows Control Panel.
  2. Choose Add or Remove Program.
  3. To uninstall TEMA, complete any one of the following steps:
  • Click the TEMA that you want to uninstall, and then select Change/Remove.
  • Click IBM Tivoli Monitoring, and then choose Change/Remove. Clear the TEMA checkbox to uninstall the item.
 

Uninstalling the TEMA on Unix - Linux

  1. Run the following command from the /IBM/ITM/bin directory:
    ./uninstall.sh
  2. Complete the script instructions to uninstall TEMA.
 

6.0 Troubleshooting installation problems from the Support site

=================================================

For 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

 

7.0 Additional information

====================

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

  • 7.4.0.2-TIV-CAMRT-AIX-IF0023.tar - 73d61e5bc54620dd75ff8fa69bd674bd5bcafca4
  • 7.4.0.2-TIV-CAMRT-Linux-IF0023.tar - 8b6b2c3fdc177cf4e9650d7a2814a172dde05419
  • 7.4.0.2-TIV-CAMRT-Solaris-IF0023.tar - cea9c57721aae8bca747e0b4e94b04a8117247cc
  • 7.4.0.2-TIV-CAMRT-Windows-IF0023.zip - f48b8f049f767029d428d3c6f8c77202c65407f9
 

8.0 New Features

==============
  • RIS: Support RPT 10.5.4 version script exporting
  • RIS: Support RFT 10.5.4 version script exporting

9.0 List of fixes

============

The following problems are addressed by this interim fix.

APARs 
None
Agent defects
None
Enhancements included from the earlier interim fixes: 
  • RIS: Support RFT 10.0 version script exporting
  • RIS: Support RPT 10.0 version script exporting
  • RIS: Support RFT 9.2/9.5 version script exporting
  • RIS: Support RPT 9.2/9.5 version script exporting
  • RIS: Support RFT 10.2.3 version script exporting
  • RIS: Support RPT 10.2.3 version script exporting
  • RIS: Support RFT 10.5.1 version script exporting
  • RIS: Support RPT 10.5.1 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 from the earlier interim fixes: 
APARs
  • IJ30325: ITCAM4Tx 7.4 Response Time agents (t3,t5,t6) don't start on Windows with ITM 6.3.0.7 SP6
  • IJ26104 PSIRT ADV0023757 open source SQLite Vulnerabilities CVE-2020-11656 CVE-2020-11655
  • IJ22072 Client Time memory leak issue in TS002765697
  • IJ16169 ITCAM4TX 7.4: Cannot 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
  • 31788 D - PSIRT ADV0025370 open source SQLite Vulnerabilities CVE-2020-15358 for 7.4.0.2
  • 31736 D - PSIRT ADV0023757 open source SQLite Vulnerabilities CVE-2020-11656 CVE-2020-11655 for 7.4.0.2
  • 31683 D - 7.4.0.1 - 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
  • 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 time out 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
  • 31870: D - PSIRT PVR0265747 open source SQLite Vulnerabilities CVE-2021-20227 for 7.4.0.2
  • 32007: D - PSIRT PRD0333951 Open Source SQLite Vulnerabilities CVE-2021-45346 for 7.4.0.2
  • 32008: D - PSIRT PRD0347267 Open Source zlib Vulnerabilities CVE-2018-25032 - 7.4.0.2

10.0 Document change history

========================
Version Date Description of Change
1.0 3 January 2024 Initial Version
2.0 24 January 2024 Updated the Build ID

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS5MD2","label":"Tivoli Composite Application Manager for Transactions"},"ARM Category":[{"code":"a8m500000008i3OAAQ","label":"ITCAM-for-Transactions-\u003ERobotic Response Time RRT"}],"Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.4.0"}]

Document Information

Modified date:
25 January 2024

UID

ibm17082689

Page Feedback