Getting the Tuning Fork Code

Prerequisites

1. Tuning Fork requires Java 5.0 (or later) to be installed and on your path. To confirm this, use "java -version".
2. Tuning Fork requires exactly Eclipse 3.3.2 (neither earlier not later versions will work!). We hope to upgrade to a later release, but the dependence on a particular release at any given point in time may persist.
3. You'll need an Eclipse plugin to support svn. We use subclipse. The simplest way to install subclipse if you don't already have it is to use the standard Eclipse Software Update process (Help->Software Updates->Find and Install). The subclipse 1.2.x update site URL is http://subclipse.tigris.org/update_1.2.x. You do not need the optional integration plugins, only the basic (required) subclipse plugin is needed.

Checking Out the Source Code

The code lives under tfroot/trunk in the svn repository. Do not simply check out this directory tree!.

Tuning Fork is consists of a number of projects. We manage them using Eclipse's built-in project set support. To get the code, you will first checkout a project containing a project set file (TuningFork.psf) then tell Eclipse that you want to import the project set. In more detail the steps are:

1. In the SVN Repository Exploring perspective, create a new repository location: https://tuningforkvp.svn.sourceforge.net/svnroot/tuningforkvp
2. In the tree view of our svn repository, navigate to tfroot/trunk/ProjectSets/TuningFork and checkout this directory as a project in your workspace.
3. Switch to the Java perspective.
4. Select the Stable.psf file in the TuningFork project, right click, and select Import.
5. You should see a wizard to import Stable.psf as a Team Project Set.
   
6. Selecting Next, then Finish should result in all the projects in Stable.psf being checked out into your eclipse workspace.
7. Optionally, you may repeat the import steps with the Unstable.psf file to checkout additional projects that are still highly experimental and/or only partially functional.

Running Tuning Fork

After you have TuningFork checked out, you probably want to run it. The simplest way to do this is to open the Java perspective, then open the project com.ibm.tuningfork.rcpapp in the package explorer. Double click on the file called TuningFork.product to open it in the Editor. At the bottom left of the "Overview" pane there will be a link called "Launch the product". If you click on this link, it should run TuningFork as an Eclipse Application.