Jump to: navigation, search

Difference between revisions of "PTP/environment setup"

(Build OpenMPI Proxy)
Line 10: Line 10:
* Eclipse 3.3.x
* Eclipse 3.3.x
* CDT 4.0.x
* CDT 4.0.x
* OpenMPI 1.2
* Open MPI 1.2
* gdb 6.3 or later (earlier versions may also work)
* gdb 6.3 or later (earlier versions may also work)

Revision as of 21:10, 15 January 2008

PTP Developer Environment Setup (PTP 2.0)

This page describes how to set up your environment in order to build PTP from the CVS projects and perhaps begin developing PTP. These are not the correct instructions if you just want to use PTP.


The following are the minimum requirements for developing PTP:

  • Java 1.5 or later (Note: for Linux, must be Sun or IBM's)
  • Eclipse 3.3.x
  • CDT 4.0.x
  • Open MPI 1.2
  • gdb 6.3 or later (earlier versions may also work)

The best environments for developing PTP are MacOS X 10.4 or later, or any recent version of Linux. Windows can be used to develop the Java components, but is not recommended.


Install Eclipse

Download and Install Eclipse 3.3

Install Features

PTP development requires CDT 4.0 and optionally RSE 2.0. RSE is is only required if you wish to use it for remote access. The preferred method for remote access is now to use the Remote Tools plugins that are part of PTP. It doesn't hurt to install RSE though.

Note: PLDT requires CDT 4.0.2 and as of 3 Jan 08, the Europa Discovery site only has 4.0.1. See below if you want CDT 4.0.2; get it from the CDT update site directly.

Install as follows:

  1. Launch Eclipse (as root if you installed Eclipse in a system directory)
  2. From the menu select: Help->Software Updates->Find and Install
  3. Select Search for new features to install, click Next
  4. Select Europa Discovery Site, click Finish
  5. Select a valid mirror, click Ok
  6. Expand Europa Discovery Site
  7. Select C and C++ Development
    Note: PLDT requires CDT 4.0.2 and as of 3 Jan 08, the Europa Discovery site only has 4.0.1. Skip this step and see below if you want CDT 4.0.2.
  8. Select Remote Access and Device Development->Remote System Explorer... if you wish to install RSE
  9. Click Next
  10. Read and check I accept click Next and Finish.
  11. Click Install All

If Europa Discovery site does not have CDT 4.0.2, you can get it from the CDT Update site directly via the following:

  1. From the menu select: Help->Software Updates->Find and Install
  2. Select Search for new features to install, click Next
  3. Select the New Remote Site button on the right.
  4. In the New Update Site dialog, enter
    Name: CDT update site
    URL: http://download.eclipse.org/tools/cdt/releases/europa, click OK
  5. Make sure it is checked, and click Finish.
  6. Select a valid mirror, click Ok
  7. Expand CDT update Site and at a minimum, check, under CDT Main Features, the first item" Eclipse C/C++ Development Tools... (there are also several useful optional features)
  8. Click Next
  9. Read and check I accept click Next and Finish.
  10. Click Install All

You will be prompted to restart your Eclipse workbench.

Access Eclipse CVS repository

Switch to the CVS perspective and create a new repository location:

  • Host: dev.eclipse.org
  • Repository path: /cvsroot/tools
  • User: <yourCommitterID> or anonymous
  • Password: <yourPW> or empty for anonymous access
  • Connection type: extssh for committer access, or pserver for anonymous access

After creating the repository location, expand it and expand HEAD. All the PTP content is under org.eclipse.ptp.

Checkout PTP Plugins

The easiest way to do this is to import using team project sets. The following table summarizes the available sets in the releng/ptp_project_sets project:

Project Set Contents Committer Access Anonymous Access
Core PTP Plugins (required) ptp-2.0-committer.psf ptp-2.0-anonymous.psf
Resource Manager Plugins (required) ptp-rms-2.0-committer.psf ptp-rms-2.0-anonymous.psf
Remote Tools Plugins (optional) ptp-remotetools-2.0-committer.psf ptp-remotetools-2.0-anonymous.psf
RSE Support Plugins (optional) ptp-rse-2.0-committer.psf ptp-rse-2.0-anonymous.psf
Parallel Language Development Tools (optional) ptp-pldt-2.0-committer.psf ptp-pldt-2.0-anonymous.psf

Use the files in the Committer Access column if you are a committer. Otherwise, use the files in the Anonymous Access column. At a minimum you will need the Core PTP Plugins and the Resource Manager Plugins. You will also need either (or both of) the Remote Tools Plugins or the RSE Support Plugins (assuming you installed RSE). If you are working on the PLDT (or want to run it from your runtime workbench) then download this project set file also.

You can download the files directly from the above links, but the simplest way is to do the following:

  1. In the CVS repository, Under org.eclipse.ptp, open releng and check out the ptp_project_sets project.
  2. Switch to the Plug-in Development perspective.
  3. In the ptp_project_sets project, expand either the 'anonymous' or 'committer' folder.
  4. For each project set you wish to populate, right click on the file and select Import Project Set ...

You should now have all the plug-ins in your workspace.

Build Open MPI Proxy

  1. Follow Open MPI build directions as listed in PTP Release Notes
  2. Follow the same directions to build your proxy plugin (sh BUILD for your platform); make sure it is the one in your workspace directory. The instructions are interpreted here:
    • Be sure to export this environment variable before compiling: LD_LIBRARY_PATH=/usr/local/lib
    • Locate the plug-in project org.eclipse.ptp.os.arch in your workspace, where os and arch correspond to your operating system and architecture respectively. Open a command shell and change to this directory.
    • Run the command: sh BUILD
    • You should at least have executables ptp_orte_proxy and sdm in your org.eclipse.ptp.os.arch project. You may need to Refresh (F5) the project to see it from the workbench.

Create an eclipse application launch configuration

Create a launch configuration to launch and run PTP as usual.

This might include : Click on org.eclipse.ptp.core, Right click on Run As ... and choose Eclipse Application .... [TBD]


  • Eclipse Downloads [1]
  • CDT Downloads Page [2]
  • CVS Howto [3]
  • PTP Release Notes [4]