Upgrading your Transaction Tracking installation

Upgrade Transaction Tracking components to the latest release using an installer. The installer updates the Transaction Reporter, Transaction Collectors, and their IBM Tivoli Monitoring support files. Run the installer on each computer that has Transaction Tracking components installed.

Before you begin

For information about obtaining the latest version, see the Download information in the required version of ITCAM for Transactions.

Note: Ensure that you upgrade all of the following IBM Tivoli Composite Application Manager for Transactions components to the latest release on all relevant computers:
  • Transaction Collector
  • Transaction Reporter
  • Tivoli Enterprise Monitoring Server support
  • Tivoli Enterprise Portal Server support
  • Tivoli Enterprise Portal support
Also upgrade the required Data Collector plug-ins supported domains:
  • To upgrade from V7.2.0.0, use the upgrade (patch) installer.
  • To install a new version of a Data Collector plug-in, use the full (base) installer.
Important: For both Transaction Collector (TU) and Transaction Reporter (TO), any parameters that you have customized in to.ini or tu.ini revert to their default values when you upgrade your installation.  Ensure that you note your custom settings before you upgrade.
Tip: It is not always necessary to upgrade CICS TG Transaction Tracking. If CICS TG Transaction Tracking has not been updated and you attempt to upgrade it, you may receive the following message:
The required core product (base.v1773) is not installed. Please check 
your installation directory.
Installation failed.
Rollback complete.
This message indicates that CICS TG Transaction Tracking was not upgraded and that the existing installation will be used.

About this task

This procedure describes how to upgrade Transaction Tracking on Windows. The procedure is similar for the other operating systems and similar to the full installation.

Procedure

To upgrade Transaction Tracking for all components installed on a particular computer:

  1. Log on as a user with administrative privileges.
  2. If required, download and extract the required Transaction Tracking package.
  3. From the package or the DVD, double-click setup.exe to launch the installation wizard. The Welcome window is displayed.
  4. On the Welcome window, click Next. The Prerequisites window opens.
  5. The Prerequisites window displays information about the installation. It also displays the current and required GSKit and JRE versions if the installed versions are not compatible. Click Next to install the correct version of IBM® GSKit or IBM Java™.
  6. On the Software License Agreement window, read the agreement and click Accept.
  7. If you install to a computer that does not have other IBM Tivoli Monitoring components installed, the Choose Destination Location window with the default installation location opens. Change the location if required and click Next.
  8. If you install to a computer that does not have other IBM Tivoli Monitoring components installed, the User Data Encryption Key window is displayed. Enter your own unique encryption key or accept the default and click Next then click OK in the summary window..
    Note: You are only required to supply an encryption key if the IBM GSKit is not already installed on that computer. Use the same key across your enterprise.
  9. On the Select Features window, the components installed on the computer are selected. Ensure that you update all components to the latest version. Click Next.
  10. On the Agent Deployment window, select a component to deploy to a remote location using the IBM Tivoli Monitoring Server if required and click Next.
  11. On the Start Copying Files window, review the settings and if correct, click Next. Click Yes in the confirmation dialog box to start copying files. A Setup Status window informs you about the progress of the installation.
  12. On the Setup Type window, all configuration options are selected by default. If required, deselect the configuration options to delay configuration until after upgrade is complete. Click Next. If you select any configuration options the installer stops all Transaction Tracking services.
  13. On the Configuration Defaults for Connecting to a TEMS window, check the host name of the Tivoli Enterprise Monitoring Server and click Next.
  14. On the Configuration Defaults for Connecting to a TEMS summary window, check the information and click OK.
  15. If you are updating the Transaction Reporter, the Transaction Reporter Configuration window is displayed. Update the Transaction Reporter configuration details if required and click OK.
  16. If you are updating a Transaction Collector, the Transaction Collector Configuration window is displayed. Update the Transaction Collector configuration details if required and click OK.
  17. The selected components are installed, configured, and started. The InstallShield Wizard Complete window is displayed when installation is complete. Click Finish and read the readme file.

What to do next

After upgrading the following Tivoli Enterprise Management Agents on Windows or UNIX systems, reconfigure the agent to reestablish connection to Tivoli Enterprise Monitoring Server. Use the Manage Tivoli Enterprise Monitoring Services console or the command itmcmd config -A agent code. See Configuring Transaction Tracking for further information.
  • Transaction Collector (agent code: tu)
  • Transaction Reporter (agent code: to)
Distribute any new situations to the agents:
  1. In the Situation editor, select the situation that you want to distribute.
  2. In the Distribution tab, add the agents to which you want to distribute the agent to the Assigned list.
  3. Click OK to distribute the situation.

Update Transaction Tracking components installed on other computers to the latest version.

Ensure that you also upgrade Tivoli Enterprise Monitoring Server support, Tivoli Enterprise Portal Server support, Tivoli Enterprise Portal support.