IBM Tivoli Composite Application Manager for Transactions Transaction Tracking 7.4 Interim Fix 1 README Tivoli Composite Application Manager for Transactions 7.4.0.0 7.4.0.0-TIV-CAMTT-IF0001 Readme

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/support/fixcentral/

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

This upgrade for ITCAM for Transactions Transaction Tracking may be applied to the following base versions.

• 7.3.0.0
• 7.3.0.1
• 7.4.0.0

For up-to-date ITCAM for Transactions v7.4 software prerequisites, please visit:
Prerequisites for ITCAM for Transactions V7.4

For additional download packages or ITM support information, visit the ITM support portal at:
http://www.ibm.com/support/entry/portal/Overview/Software/Tivoli/Tivoli_Monitoring_V6

There are no known issues.

There are no known limitations.

For Windows installation, if you encounter the message "Another version of this product is already installed" follow the instructions in the following support document to diagnose and resolve the problem. Note that although this technote refers to ITM, the diagnosing and resolving steps are applicable to ITCAM for Transactions Transaction Tracking.
http://www-01.ibm.com/support/docview.wss?uid=swg21587068

Prior to installation

Check and be aware of all releases of ITCAM for Transactions:
http://www.ibm.com/developerworks/wikis/display/tivolidoccentral/Tivoli+Composite+Application+Manager+for+Transactions

This maintenance package is applied directly to the Tivoli Enterprise Management Agents (TEMAs). This package also includes required updates to the following ITM components:

• Tivoli Enterprise Management Servers (TEMS) in the ITM infrastructure, including any Remote TEMS or fail over TEMS configurations.
• Tivoli Enterprise Portal Server (TEPS).

You can install a TT agent either on a computer by itself or on a computer with an installed TEPS, TEMS, and/or portal. If you install a TT agent on a computer where the TEPS, TEMS and portal are already installed, the installer automatically stops the ITM agents and infrastructure (including TEMS and TEPS) running locally. If you install the TT agents on a computer by themselves, the ITM agents and infrastructure do not need to be stopped.

Installing

For latest information on installation, please visit:
http://publib.boulder.ibm.com/infocenter/tivihelp/v24r1/topic/com.ibm.itcamt.doc_7.4.0.0/tt/dita/concept/kto_tools_in.html

Installing Transaction Tracking
This maintenance package is applied directly to the Tivoli Enterprise Management Agent (TEMA).

On Windows systems, extract the files from the archive and double-click WINDOWS\setup.exe. Follow the prompts to install the update.

On UNIX systems, extract the installer from the archive using the tar -xvf <filename.tar> command. Then, execute the installer using the ./install.sh command. Follow the prompts to install the update.

For more information consult the following online documentation:
Installing Transaction Tracking on Windows systems
Installing Transaction Tracking on Unix systems


Installing application support for TEPS/TEMS
In addition to installing the Transaction Reporter and Aggregation agents, you must install support files for the IBM Tivoli Monitoring components that are used by Transaction Tracking. 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:
Installing support files

Performing the necessary tasks after installation

A successful installation sets the TT version to 7.4.0.0. Ensure that the version of the Transaction Tracking agents in the MTEMS is '07.40.00.01'.

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

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

For latest information on configuration, please visit:
http://publib.boulder.ibm.com/infocenter/tivihelp/v24r1/topic/com.ibm.itcamt.doc_7.4.0.0/tt/dita/concept/kto_tools_config.html

Troubleshooting installation problems from the Support site

For latest information on troubleshooting, please visit:
http://publib.boulder.ibm.com/infocenter/tivihelp/v24r1/topic/com.ibm.itcamt.doc_7.4.0.0/tt/dita/tsg/concept/kto_ts_oview.html

Uninstalling if necessary

For latest information on uninstallation, please visit:
http://publib.boulder.ibm.com/infocenter/tivihelp/v24r1/topic/com.ibm.itcamt.doc_7.4.0.0/tt/dita/concept/kto_tools_un.html

The Secure Hash Algorithm 1 (SHA1) checksum of the images are as follows:
SHA1(7.4.0.0-TIV-CAMTT-AIX-IF0001.tar)= b933566817e7665d777b113be1a8ced81ce55e63
SHA1(7.4.0.0-TIV-CAMTT-LINUX-IF0001.tar)= c0d1f05f8f705ce664d807b12cb7910fff43efb1
SHA1(7.4.0.0-TIV-CAMTT-SOLARIS-IF0001.tar)= 35cb42db2e584874d5eba07e6a4c6547d58febc7
SHA1(7.4.0.0-TIV-CAMTT-WINDOWS-IF0001.zip)= 61c86268d27c2dae539692134d687c46bd1edf21

New Features

The following new features are included in ITCAM for Transactions - Transaction Tracking 7.4 Interim Fix 1:

• Improvements to the Transaction Reporter to process ARM events with Vertical Context that contains:
  • ApplicationDefinition
  • TransactionDefinition
  • ProfileDefinition
• Integration with APMUI v7.7
  Changes to the Transaction Tracking application profile have been made for integration with APMUI v7.7:
  • Applications names have been moved into a parent application of "Default Application".
  • The profile changes are applied only for new install of the 7.4 Ifix1. Upgrading to the ifix will not apply the changes so to avoid removing your custom profiles.
  • These profile change are not compulsory for integration with APMUI v7.7 but should you wish to use this profile instead, here are the steps to do it:
    Note: The example assumes the default install path is /opt/IBM/ITM
    • Scenario 1: If your ITM TEMS have AMCE (T3) agent
      • Apply Transaction Tracking 7.4 IFix1
      • Uninstall Response Time AMCE (T3) agent
      • Remove kt1depot directory ( eg /opt/IBM/ITM/kt1depot )
      • Install Response Time AMCE (T3) 7.4 IFix1 - full install kit
      • Start the T3 agent /opt/IBM/ITM/bin/itmcmd agent start t3
      • The T3 agent will push out the new profile to all Transaction Tracking Collectors.
    • Scenario 2: No AMCE ( T3 ) agent
      • Apply Transaction Tracking 7.4 IFix1
      • Stop the Transaction Collector
        /opt/IBM/ITM/bin/itmcmd agent stop tu
      • Replace the TT Collector profile
        rename directory/opt/IBM/ITM/tmaitm6/camconfig/TU to back it up eg /opt/IBM/ITM/tmaitm6/camconfig/TU.save
        copy directory /opt/IBM/ITM//tu/tusupport/example_camconfig/TU to /opt/IBM/ITM/tmaitm6/camconfig/TU
      • Start the Transaction Collector
        /opt/IBM/ITM/bin/itmcmd agent start tu

A) APAR Content:

IV51833 TO data always unavailable in agent-less application

From superseded fixes:

N/A

B) Additional Non APAR Defects:

18617 TTDLA book file generated from TO does not have transactions data
18706 TT RDF missing oslc:serviceProvider for some objects
19042 TO ARM upgrade doesn't show AMCE profile attributes
19194 TT ARM Events that do not match profiles are being tracked
19227 D - APMUI: crtv:Application refers to invalid crtv:ComputerSystem
19353 RDF tool: connection detail parsing and path to todata
19415 D - APMUI: No utility provided for customer to generate base64 string for SCR password when use TO RDF tool
19430 D - APMUI: Transaction component is not meaningful in SCR
19480 "itcamfttdla_config.properties" has control-M characters in it
19454 Unable to add windows depot due to missing files
19455 D - APMUI: crtv:Application dependsOn non-exist serverAccessPoint in generated rdf file
19576 TT profile changes to enhance usability of IHS and WAS
19622 No Path data in the todata.rdf
19668 D - APMUI: no "All Client" in rdf
19810 SCR: should stop processing immediately if failed to connect SCR server
19814 SCR: Need to break up the sending of large RDF data
19960 TT post install script should not override existing profile
19963 Update kto_metrics.xml file to include servername for "All Clients" for agentless HTTP data

From superseded fixes:

N/A

C) Enhancements

18721 Preserve AMCE profile metadata in ARM

From superseded fixes:

N/A