Installation Guide
Installation Guide V4.6 (all releases)

The TPTP V4.6 Release Builds (4.6.0, 4.6.1, 4.6.2) list the TPTP packages and dependencies available for download. You can install TPTP plug-ins manually or through the Eclipse Update Manager. Additionally, the stand-alone Agent Controller should be downloaded if you want to profile Java applications on a remote machine; see the instructions below for installing the Agent Controller on a remote machine. The stand-alone Agent Controller is not required for local application profiling, except on the IPF platform. IA32 and EM64T installs will include an Integrated Agent Controller (IAC), which can be used for local profiling; this is the default option for profiling if the stand-alone Agent Controller is not installed and running. Before starting, please ensure that you are using a supported combination of JRE and operating system: TPTP V4.6 OS and JRE support.

Note: It may be necessary to start the workspace with the -clean option after a configuration change.
After the first time you start Eclipse, it caches the loaded plugin settings. If you changed the install of your Eclipse shell (e.g. added additional dependencies, replaced jar files, etc.) and these changes conflict with the cached settings of Eclipse, the cached ones will be used. To ensure Eclipse uses the latest configuration, start your workbench with the -clean option.

Installing TPTP

  1. Installing TPTP prerequisites
  2. Installing TPTP with one of the following techniques, either:
  3. Installing TPTP Profiling for Web Applications using the Eclipse Update Manager
  4. Upgrading TPTP
  5. Downloading and installing the Agent Controller
  6. Optional: Installing Native Logging
  7. Optional: Technology Preview components

1.0 Installing TPTP prerequisites

Note: If installing from the Galileo update site (see Option 1 below), required dependencies will be installed automatically by the Eclipse Update Manager. Therefore, it is not necessary to manually install the prerequisites if using that method.

To install TPTP prerequisites: 

  1. Download and install the prerequisites listed under Requirements (4.6.0, 4.6.1, 4.6.2) 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, or the Eclipse dropins directory.
Alternatively, some Eclipse components may be installed using the Eclipse Update Manager. For more details, see the documentation provided by the component.

2.0 Installing TPTP

Note: TPTP plug-ins for Eclipse can be installed via the Eclipse Update Manager (Equinox p2 beginning in Eclipse 3.4). Other deliverables of the TPTP project that are not plug-ins, such as the stand-alone offerings and Agent Controller, cannot be installed using the Update Manager. If required, these must be installed seperately. For example, follow the instructions in the Installing Agent Controller and Installing Native Logging sections to install these components.

Install TPTP using one of the four options below:
Option 1: Installing TPTP from the Galileo update site using the Eclipse Update Manager
Use this option for convenience or if you are new to Eclipse and want the Update Manager to install the files into the correct locations. The Galileo update site provides an easy way to install TPTP and its dependencies. This is usually the preferred installation method, as the required dependencies are installed automatically. Step-by-Step instructions to install TPTP using the Galileo update site (http://download.eclipse.org/releases/galileo) are available on the TPTP wiki page.
Option 2: Installing TPTP from the TPTP update site using the Eclipse Update Manager
This option can be used as an alternative to Option 1 if you want to use the Update Manager. This option lets you choose the specific version of TPTP to install or upgrade to, however, you must first install the required prerequisites.

To install TPTP packages from the TPTP update site using the Eclipse Update Manager:
  1. From the menu in Eclipse, select Help > Install New Software...
  2. Enter the TPTP update site URL (http://download.eclipse.org/tptp/updates) in the Work with field.
  3. Select the version of TPTP to install, or select a newer version to upgrade to.
  4. Click Next, and follow the instructions to complete the installation. Restart Eclipse when prompted.
Option 3: Installing TPTP packages manually
Use this option if you are comfortable setting up TPTP from a zip file. This option is faster for more advanced Eclipse developers. With this option, you must first install the required prerequisites.

To install TPTP packages manually:
  1. Download the desired TPTP Runtime or SDK (4.6.0, 4.6.1, 4.6.2) packages (Platform, Monitoring Tools, Testing Tools, Tracing and Profiling Tools, or All), by clicking a Runtime or SDK link as appropriate. Download the Runtime package if you just wish to use TPTP and not extend it. Otherwise, download the the SDK package. The Runtime package is a subset of the SDK package.

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

    Choose a specialized environment if you want to test, monitor, or 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, or the Eclipse dropins directory.
    Note: If installing on Windows Vista, see bug 166292 and bug 225738 regarding the Windows ZIP extraction utility file name length restriction.
Option 4: Installing TPTP using the All-in-One Package
An All-in-One package is available on the TPTP download page for Windows and Linux IA32. This is a quick way to get started with TPTP. Simply download and unzip the package. The TPTP all-in-one package contains a base Eclipse with all TPTP plugins and their dependencies, except the TPTP-WTP (required for Profile on Server) and TPTP-BIRT (required for BIRT Reporting) integration features.

3.0 Installing TPTP Profiling for Web Applications using the Eclipse Update Manager

TPTP Profiling for Web Applications (i.e. Profile on Server) can be installed by following the instructions below:
  1. In the Eclipse Update Manager (using the Galileo or TPTP update site), expand the TPTP options and select TPTP Profiling for Web Applications from the repository.
  2. Expand the Web, XML, and Java EE Development entry in the Galileo update site and select the Eclipse Web Developer Tools option.
  3. Click Next, and follow the instructions to complete the installation. Restart Eclipse when prompted.

4.0 Upgrading TPTP

When upgrading from a previous version to a newer version, it is recommended that you install TPTP and the required dependencies into a new directory. In the new installation you can point to your existing workspace. If the upgrade is a maintenance release, you can follow the instructions on upgrading from the TPTP update site above. Alternatively, in Eclipse you can select Help > Check for Updates. To upgrade TPTP stand-alone offerings, install the new version into a seperate directory.

5.0 Downloading and installing the Agent Controller

Download the Agent Controller (4.6.0, 4.6.1, 4.6.2), 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 or EM64T platforms, only needing to profile a Java application locally and/or to run a TPTP Test locally do not need to install this stand-alone 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 runtime package contains the Agent Controller to be executed as a stand-alone application, remotely or locally. The SDK package contains 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 the Agent Controller. Download the Runtime zip if you just wish to use the Agent Controller and not extend it, otherwise select both the Runtime and SDK.
  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.

6.0 Optional: Downloading and installing Native Logging

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

7.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.6.0, 4.6.1, 4.6.2).

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.6.0, 4.6.1, 4.6.2).

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 Build-to-Manage Toolkit for .NET (4.6.0, 4.6.1, 4.6.2).

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