IBM Tivoli Composite Application Manager for Transactions Response Time 7.4 Interim Fix 06 README Tivoli Composite Application Manager for Transactions 7.4.0.2 7.4.0.2-TIV-CAMRT-IF0006 Readme

The information included in this document is published at product release time. For the latest updates on this release please refer to the on-line document. To download this update you must first login to IBM FixCentral. Once logged in, you may select from the individual download packages.
http://www.ibm.com/eserver/support/fixes/

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

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 upgrade for the ITCAM for Transactions Response Time and may be applied to the following base versions.

• 7.4.0.2

This upgrade is a cumulative fix for the ITCAM for Transactions Response Time agents (T3, T5, T6). Any updates in the following releases will be included in this upgrade.

• 7.4.0.2
• 7.4.0.2 - IF0001
• 7.4.0.2 - IF0003

The Rational Integration Support (RIS) installer is contained in the Windows image of this ifix. RIS of this update supports RFT/RPT 9.2 and 9.5 script export. It requires T6 playback agent at minimum version of 7.4.0.2 base to run 9.2/9.5 Rational scripts.

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

This ifix can be run under Windows Server 2016 STD OS system. It requires the minimum playback agent version of 7.4.0.2 to playback RPT scripts and 7.4.0.2 IFIX03 to playback RFT 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-IF0006.tar
• Linux : 7.4.0.2-TIV-CAMRT-Linux-IF0006.tar
• Windows : 7.4.0.2-TIV-CAMRT-Windows-IF0006.zip

1. Extract the 7.4.0.2-TIV-CAMRT-Windows-IF0006.zip file to a temporary directory (i.e. C:\temp\7.4.0.2-IF0006).
   
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-IF0006\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-IF0006\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. The silent install file describes each option.
   For additional information on the options for the silent installation of the TEMA agents, please consult the ITCAMfTransactions V7.4 User 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.
   

1. Download the Linux upgrade package and extract it to a temporary directory (i.e. /tmp/7.4.0.2-IF0006).
   
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-IF0006/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 itmcmd ITM 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)
   

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 ITM services 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 ITM services 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 ITM services 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


Performing the necessary tasks after installation

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

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 06 is applied on RPT/RFT, reboot Windows OS system,
Version: 7.4.0.2
Builde id: 201906172226

The Version and Build id value information in Rational Performance/Functional Tester menu 'Help' -> 'About Rational Performance/Functional Tester' -> 'Rational Performance/Functional Tester Installation Details' -> 'Features' -> Provider 'IBM Tivoli'

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

Uninstalling if necessary

This maintenance package for T3, T5 and T6 playback agent 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.
4. Choose "Change/Remove" to uninstall it.

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.

1. Go to the Windows Control Panel.
2. Choose "Add or Remove Program".
3. Click on the RIS item - "ITCAM for Transactions 7.4 Integration plug-in" you want to uninstall.
4. Choose "Change/Remove" to uninstall it.

1. Issue the following command from the installer directory:
   uninstall.bat
2. Follow the instructions to uninstall the RIS software that you want to remove.

The Secure Hash Algorithm 1 (SHA1) checksum of the images are as follows:

7.4.0.2-TIV-CAMRT-AIX-IF0006.tar - 0D8048A6C347ADD8341B39D2F25DF3E7EE78D64D
7.4.0.2-TIV-CAMRT-Linux-IF0006.tar - 5437390CD0AFA3F6FE5FB186701350965CA13F11
7.4.0.2-TIV-CAMRT-Windows-IF0006.zip - DB61F71C3F7F02605458278084E920741C1DC611

A) New Features:

The following new features are included in ITCAM for Transactions - Response Time 7.4.0.2 Interim Fix 06:
RIS: support RFT 9.5 version script exporting
RIS: support RPT 9.5 version script exporting
RIS: support RFT 9.2 version script exporting
RIS: support RPT 9.2 version script exporting


B) APAR Content:
IJ16169 ITCAM4TX 7.4: CAN NOT EXPORT RPT 9.1 HTTP TEST SCRIPT TO AMC WHEN USING **ENCRYPTED** DATAPOOLS.

C) Additional Non APAR Defects:
PMR 31397 TS000055529 - Garbled text in "Information" RRT Agent Messages

D) Enhancements
N/A