The TPTP V4.4 Release Builds (4.4.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.4 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
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:
- In the Update Dialog select Test and Performance and then click Select Required.
- All features of TPTP and their prerequisites will be selected. Click Next.
- Read the license agreement and accept or decline it. If you accept the license then you can click Next again.
- On the last page of the wizard click Finish to start the installation.
- Installing TPTP prerequisites
- Installing TPTP with one of the following techniques, either:
- Downloading and installing Agent Controller
- Optional: installing Native Logging
- Optional: Technology Preview components
1.0 Installing TPTP prerequisites
To install TPTP prerequisites:
- Download and install the prerequisites listed under Requirements (4.4.0) in the release build download page. The prerequisites include the Java runtime, Eclipse, and required Eclipse components.
- Unzip required Eclipse component packages to the Eclipse installation directory, for example, D:\eclipse.
2.0 Installing TPTPInstall TPTP either by Option 1 or Option 2:
- Use Option 1 if you are comfortable setting up TPTP from a .zip file. This option is faster for more advanced Eclipse developers.
- Use Option 2 for convenience or if you are new to Eclipse and want Update Manager to install the files into the correct locations.
2.0 Option 1: Installing TPTP packages manuallyBefore starting, ensure that you have followed the instructions in the Installing Agent Controller and Installing Native Logging.
To install TPTP packages manually:
- Download the desired TPTP Runtime and SDK (4.4.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.
- Select a convenient download mirror and save the zip file.
- Unzip the TPTP package into the Eclipse installation directory, for example, D:\eclipse.
2.0 Option 2: Installing TPTP packages with the Eclipse Update ManagerNote 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:
- From the Help menu in Eclipse, select Software Updates > Find and Install.
- Select the Search for new features to install radio button. Click Next.
- Add a new update site by clicking on New Remote Site.
- Enter the following name and URL and click OK:
- Name: TPTP Update site
- URL: http://eclipse.org/tptp/updates/site.xml
- Click Finish.
- In the "Search Results" dialog box, select the features to install. Then click Next.
- In the "Feature License" dialog box, accept the license and click Next.
- In the "Installation" dialog box, verify the features to be installed and change install location if necessary. Then click Finish.
- After you click Finish, you will be presented a confirmation about a digital signature. Click Install All.
- When done, restart your workbench.
3.0 Downloading and installing Agent ControllerDownload the Agent Controller (4.4.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.
- 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.
- Select a convenient download mirror and save the zip file.
- 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 LoggingOptionally, download and install Native Logging (4.4.0) packages, an implementation of Common Base Event v1.0.1 for use in C/C++ environment.
- 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.
- Select a convenient download mirror and save the zip file.
- To install Native Logging, unzip the zip file into a directory of your choice.
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.
Also available are Technology Preview components:
- API Recorder Framework
- Automated GUI Recording
- Memory Manager
- C/C++ Code Review Provider
- Code Coverage
- Build-to-Manage Toolkit for .NET
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.4.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.4.0).
XRay is a profiler that is designed for profiling Eclipse applications. Download XRay (4.4.0).
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.4.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.4.0).
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.4.0).
Build-to-Manage Toolkit for .NET
The 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.4.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