Installation Guide
Installation Guide V4.5 (all releases)

The TPTP V4.5 Release Builds (4.5.0) 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.5 OS and JRE support.

Note: Start the workspace with the -clean option after any configuration change.
After the first time you start eclipse, it caches the loaded plugin settings under eclipse/configuration/. If you changed the install of your eclipse shell (e.g. added additional dependencies, replace jar files etc.) and these changes conflict with the cached settings of eclipse, the cached ones will be used. Either use -clean or remove the plugin folders under eclipse/configuration/ (except the config.ini file), and try again.

Are you sure that you need to read this guide? There is a default for typical users...

Follow the instructions on the Europa Discovery Site to install TPTP. Follow these detailed instructions for the Europa Discovery Site for TPTP:
  1. In the Update Dialog select Test and Performance and then click Select Required.
  2. All features of TPTP and their prerequisites will be selected. Click Next.
  3. Read the license agreement and accept or decline it. If you accept the license then you can click Next again.
  4. On the last page of the wizard click Finish to start the installation.
TPTP will be installed on your system.

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: Technology Preview components

1.0 Installing TPTP prerequisites

To install TPTP prerequisites: 

  1. Download and install the prerequisites listed under Requirements (4.5.0) 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.5.0) 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.
    Note: If installing on Windows Vista into the dropins folder, see bug 166292 and bug 225738 regarding the Windows ZIP extraction utility file name length restriction.
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 with 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.5.0), a process that enables client applications to launch other applications locally or remotely and interact with agent processes that provide information services (e.g. collecting profiling data). Note that users, on Windows or Linux IA32 platforms, only needing to profile a Java application locally and/or to run a TPTP Test locally do not need to install this standalone Agent Controller on the local machine because it is already packaged in the TPTP Platform Runtime install image as the Integrated Agent Controller (IAC) and can be used from within the Eclipse Workbench. The following runtime packages contain the agent controller to be executed as a standalone application, remotely or locally. The SDK packages contain code and libraries for writing native agents for the agent controller.
  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 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 that is different from the Eclipse installation location. For information on setting up and running Agent Controller, see the Getting Started with Agent Controller document for your platform (Windows, Linux). Be sure you have met the additional platform-specific requirements defined in the "Prerequisites" section of the Getting Started with Agent Controller documentation before installing the Agent Controller. Also, the agent controller technology in this release contains a backwards compatibility layer, allowing it to replace the prior agent controller technology on Windows and Linux platforms and to interoperate with the prior agent controller technology on the other platforms supported in earlier versions of TPTP. Users should refer to the Decision Guide for Adopting New Technology Agent Controller for information on supported platforms, features and Application Programming Interfaces.

4.0 Optional: Downloading and installing Native Logging

Optionally, download and install Native Logging (4.5.0) 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.

6.0 Optional: stand-alone Generic Log Adapter

The Generic Log Adapter package is for running the Generic Log Adapter as a standalone application. For information on how to install this package refer to the Stand-alone Generic Log Adapter Installation Guide.

6.0 Optional: Technology preview components

Also available are Technology Preview components:

API Recorder Framework

TPTP's API Recorder allows users to record API invocations of local/remote Java applications based on user-defined filters (package/class/method/signature). Recordings may be converted into TPTP JUnit test suites for unit and regression testing of the recorded Java application. Please refer to the user guide for more details. This item is not required as part of TPTP's platform. Download API Recorder Framework (4.5.0).

Automated GUI Recording

TPTP's Automated GUI Recorder allows users to record and playback user interactions under the Eclipse platform. The purpose of the feature is to allow users to automate functional test cases for applications developed under the Eclipse environment. Please refer to the user guide for more details. This item is not required as part of TPTP's platform. Download Automated GUI Recording (4.5.0).

Build-to-Manage Toolkit for .NET

Build-to-Manage Toolkit for .NET allows users to instrument and/or build applications that can be managed by using TPTP's Managed Agent Explorer, which is a user interface that allows manipulation of managed resources by setting properties and invoking operations. Download uild-to-Manage Toolkit for .NET (4.5.0).

C/C++ Code Review Provider

The C/C++ Code Review Provider adds support to the TPTP static analysis framework to analyze source code for C and C++ languages. This feature which also requires CDT and adds some additional API to quickly create and manage C/C++ rules. Since this is a preview technology there is a limited set of example rules available however more rules will be added to the package as it evolves. Download C/C++ Code Review Provider (4.5.0).

Copyright © 2007, 2008 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