Installation Guide
Installation Guide V4.2 (all releases)

The TPTP V4.2 Release Builds (4.2.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.2 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 Callisto Discovery Site to install TPTP. Follow these detailed instructions for the Callisto 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: 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.2.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.2.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.
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.2.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). The runtime packages contain the agent controller to be executed as a standalone application. 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 Agent Controller Getting Started Guide.  Be sure you have met the additional platform-specific requirements defined in the "Prerequisites" section of the Agent Controller Getting Started Guide before installing Agent Controller.

4.0 Optional: Downloading and installing Native Logging

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

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

The new technology Agent Controller has replaced the current remote agent controller infrastructure on Windows platforms to supply the TPTP data collection and communication infrastructure. Other platforms are slated to use the new infrastructure in later releases, but the new technology Agent Controller is also available as a separate download for TPTP consumers who may wish to look into extending TPTP in parallel with TPTP v4.2 (and later) releases.

Download the new technology Agent Controller (4.2.0):

  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.  You can alternatively select both the Runtime and SDK link 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 Getting started with the new technology Agent Controller .
  4. Read the Introduction to the new technology Agent Controller.
  5. Refer to the Decision Guide for Adopting New Technology Agent Controller in order to decide whether to use the original Agent Controller or the new technology Agent Controller for your application.

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:

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.2.0).

XRay

XRay is a profiler that is designed for profiling Eclipse applications. Download XRay (4.2.0).

Memory Manager

Memory Manager is a service that monitors Eclipse's memory consumption and that notifies listeners when memory is running low. In response these listeners can release caches, close database connections, release intermediate results, close editors, close perspectives, and do other things that save memory. The Memory Manager separates its listener infrastructure from the policy that determines when memory is low, and when to broadcast an event and determine what severity the event should have. A view is included to monitor current listeners and manually broadcast events for testing purposes. Download Memory Manager (4.2.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.2.0).

Code Coverage

The code coverage function in TPTP allows you to collect line coverage information as you run or profile your application. This information is useful to identify code not being exercised or, in the case of a JUnit run, shows how much of the code is covered by the existing test cases.


There are two scenarios covered by this function:

The classes you want to collect line level coverage are available in the workspace. (For example, you run a set of JUnit testcases and you want to get line coverage for the code you execute.) The feature covering this scenario can be downloaded from here. The code coverage can be initiated during a run of a launch configuration by selecting the Engage Code Coverage option in the Package Explorer view. In this case, while the application is running, line coverage is registered and then reported at the end of the application. The classes for which line coverage is reported should be in the workspace. Note: To collect line coverage, you only need the two plugins provided by the feature above. This feature does not depend on any other TPTP plugins and it does not require the Agent Controller technology.

The classes you wish to instrument are not available in the workspace and/or are on a remote machine. The feature covering this scenario can be downloaded from here. Use this feature if you want to collect line coverage for classes that are not available in the workspace or are running on a remote machine. For this scenario, use the Profile... button instead of the Run... for launching the application ( the application should be run in profiling mode ). To collect this type of information you should then select the Method and Line Code coverage option in the Profile launch configuration, on the Monitor tab. Note: This feature depends on the Agent Controller to be installed and running on the host where the instrumented application is run. It also depends on the TPTP Platform plugins and on the feature presented above. Download Code Coverage (4.2.0).

Managed Agent Explorer and Monitoring Instrumentation

The Managed Agent Explorer is a view that allows the user to manipulate managed resources by setting properties and invoking operations. Managed resources can be exposed through a variety of technologies, including JMX and Web Services Distributed Management (WSDM). The explorer is integrated into the standard TPTP tooling and utilizes the agent framework.

Monitoring instrumentation adds support to the TPTP collector framework to help instrument code using either CBE or JMX. Using the Profile view code can be selected to add instrumentation points for viewing. Since this is a preview technology there is limited number of JMX servers covered. Download Managed Agent Explorer and Monitoring Instrumentation (4.2.0).

Application Response Measurement

ARM instrumentation adds support to the TPTP collector framework to help instrument code using ARM. ARM measures application availability and performance. It collects response times and application-detected errors, with sampling used to lower data collection overhead. Download Application Response Measurement (v4.2.0).

New Java Profiler

The new Java Profiler in TPTP allows you to profile your applications running in Java 1.5 and higher Java virtual machines. This Java profiler supports the Java Virtual Machine Tooling Interface (JVMTI) that replaces the experimental Java Virtual Machine Profiling Interface (JVMPI). The JVMTI replaces the JVMPI (Java Virtual Machine Profiling Interface) and the JVMDI (Java Virtual Machine Debug Interface).

The JVMTI client adds the required launching capabilities that allow users to start a profiling session via the profile launch configuration. Download the New Java Profiler (4.2.0).

Copyright © 2006 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