Installation Guide
Installation Guide V4.1 (all releases)

The TPTP V4.1 Release Builds (4.1.0 | 4.1.0.1) lists the TPTP packages, prerequisites, and dependencies available for download. You can install TPTP packages manually or through the Eclipse Update Manager. Before starting, please ensure that you are using a supported combination of JRE and operating system: TPTP V4.1 OS and JRE support.

Installing TPTP

  1. Installing TPTP prerequisites
  2. Installing TPTP with one of the following techniques, either:
  3. Downloading and installing Agent Controller
  4. Optional: installing Native Logging
  5. Optional: installing new technology Agent Controller (for TPTP consumers)
  6. Optional: Technology Preview components

1.0 Installing TPTP prerequisites

To install TPTP prerequisites: 

  1. Download and install the prerequisites listed under Requirements (4.1.0 | 4.1.0.1) in the release build download page. The prerequisites include the Java runtime, Eclipse, and required Eclipse components.
  2. Unzip required Eclipse component packages to the Eclipse installation directory, for example, D:\eclipse.

2.0 Installing TPTP

Install TPTP either by Option 1 or Option 2:
2.0 Option 1: Installing TPTP packages manually
Before starting, ensure that you have followed the instructions in the Installing Agent Controller and Installing Native Logging.

To install TPTP packages manually:
  1. Download the desired TPTP Runtime and SDK (4.1.0 | 4.1.0.1) packages (Platform, Monitoring Tools, Testing Tools, Tracing and Profiling Tools, or All), by clicking a Runtime or SDK link as appropriate. Download either:
    • The Runtime zip if you wish to use TPTP and not extend it
    • Both the Runtime and the SDK (source) zip if you wish to extend TPTP

    Whether Runtime or SDK, default to downloading All unless you want a specialized TPTP environment.

    Choose a specialized environment if you want to test, or to monitor, or to profile, but do not need all three types of functionality. In this case, download Platform and the specialized environment (Monitoring Tools, Testing Tools, or Tracing and Profiling Tools). Platform is a prerequisite for monitoring, testing, tracing and profiling.

  2. Select a convenient download mirror and save the zip file.
  3. Unzip the TPTP package into the Eclipse installation directory, for example, D:\eclipse.
2.0 Option 2: Installing TPTP packages with the Eclipse Update Manager
Note that the Agent Controller and the Native Logging components cannot be installed by the Eclipse Update Manager. Instead, follow the instructions in the Installing Agent Controller and Installing Native Logging.

To install TPTP packages using the Eclipse Update Manager:
  1. From the Help menu in Eclipse, select Software Updates > Find and Install.
  2. Select the Search for new features to install radio button. Click Next.
  3. Add a new update site by clicking on New Remote Site.
  4. Enter the following name and URL and click OK:
    • Name: TPTP Update site
    • URL: http://eclipse.org/tptp/updates/site.xml
  5. Click Finish.
  6. In the "Search Results" dialog box, select the features to install. Then click Next.
  7. In the "Feature License" dialog box, accept the license and click Next.
  8. In the "Installation" dialog box, verify the features to be installed and change install location if necessary. Then click Finish.
  9. After you click Finish, you will be presented a confirmation about a digital signature. Click Install All.
  10. When done, restart your workbench.

3.0 Downloading and installing Agent Controller

Download the Agent Controller (4.1.0 | 4.1.0.1), a daemon process that enables client applications to launch host processes and interact with agents that coexist within host processes.
  1. Click the Runtime or SDK link next to the platforms on which you want to run Agent Controller. Download the Runtime zip if you wish to use TPTP and not extend it, or select both the Runtime and SDK (source) if you wish to extend TPTP.
  2. Select a convenient download mirror and save the zip file.
  3. To install the Agent Controller, unzip the zip file into a directory of your choice (e.g.  c:\raserver). For information on setting up and running Agent Controller, see the Agent Controller Getting Started Guide.

4.0 Optional: Downloading and installing Native Logging

Optionally, download and install Native Logging (4.1.0 | 4.1.0.1) packages, an implementation of Common Base Event v1.0.1 for use in C/C++ environment.
  1. Click the Runtime or SDK link next to Native Logging on the download page. Download the Runtime zip if you wish to use TPTP and not extend it, or select Runtime and SDK (source) if you wish to extend TPTP.
  2. Select a convenient download mirror and save the zip file.
  3. To install Native Logging, unzip the zip file into a directory of your choice.

5.0 Optional download for TPTP consumers: installing new technology Agent Controller

New technology Agent Controller represents the future direction for TPTP data collection and communication infrastructure, replacing the current remote agent controller infrastructure. The TPTP tooling in v4.1 (profiling, testing, and monitoring) does not exploit this new implementation yet, and for that reason it is recommended that only consumers of TPTP download new technology Agent Controller in TPTP v4.1. It is provided as a public separate download for TPTP consumers who may wish to look into extending TPTP in parallel with TPTP v4.2.

To get started with new technology Agent Controller (4.1.0 | 4.1.0.1):

  1. Click the SDK link for the desired platform.
  2. Select a convenient download mirror and save the zip file.
  3. Unzip the zip file into a directory of your choice (e.g.  c:\agentc).
  4. Install, set up, and run new technology Agent Controller following the instructions in the Getting Started with new technology Agent Controller document.
  5. Read the introduction to the new technology Agent Controller.

6.0 Optional: Technology preview components

Also available are Technology Preview components: the Choreography Engine, and the Automated GUI Recorder.

To get started with the Technology Preview Choreography Engine (4.1.0 | 4.1.0.1):

  1. Click the download link.
  2. Select a convenient download mirror and save the zip file.
  3. Unzip the downloaded file in the Eclipse installation directory.

The Technology Preview Automated GUI Recorder allows users to record GUI actions in the Eclipse platform and play them back to verify the functionality of their product. It enables Eclipse developers to automate regression tests that often require many people to perform repetitive tasks to verify basic functionalities. To get started with the Technology Preview Automated GUI Recorder (4.1.0 | 4.1.0.1), please refer to the Automated GUI Recorder user's guide.

Copyright © 2005 IBM Corporation, Intel corporation, and others.
All rights reserved. This program and the accompanying materials
are made available under the terms of the Eclipse Public License v1.0
which is available at http://www.eclipse.org/legal/epl-v10.html