Difference between revisions of "PTP/environment setup"

From Eclipsepedia

< PTP
Jump to: navigation, search
(Install Features)
(Build OpenMPI Proxy)
Line 97: Line 97:
  
 
# Follow OpenMPI build directions as listed in [http://www.eclipse.org/ptp/docs/releases/release-1.1.1.php PTP Release Notes]
 
# Follow OpenMPI build directions as listed in [http://www.eclipse.org/ptp/docs/releases/release-1.1.1.php PTP Release Notes]
# Follow the same directions to build your proxy plugin (sh BUILD for your platform), make sure it is the one in your workspace directory.
+
# 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: <code>LD_LIBRARY_PATH=/usr/local/lib</code>
+
#* Be sure to export this environment variable before compiling: <code>LD_LIBRARY_PATH=/usr/local/lib</code>
 +
#*Locate the plug-in project org.eclipse.ptp.<i>os.arch</i> in your workspace, where <i>os</i> and <i>arch</i> correspond to your operating system and architecture respectively. Open a command shell and change to this directory.
 +
#* Run the command: <code>sh BUILD</code>
  
 
== Create an eclipse application launch configuration ==
 
== Create an eclipse application launch configuration ==

Revision as of 15:36, 3 January 2008

Contents

PTP Developer Environment Setup (PTP 2.0)

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

Prerequisites

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
  • OpenMPI 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.

Setup

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.

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 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 development workspace) 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. Under org.eclipse.ptp, open releng and check out the ptp_project_sets project.
  2. Switch to the Plug-in Development perspective.
  3. For each project set you wish to populate, right click on the file in the ptp_project_sets project and select Import Project Set ...


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

Build OpenMPI Proxy

  1. Follow OpenMPI 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

Create an eclipse application launch configuration

Click on org.eclipse.ptp.core, Click on Run, Run as Eclipse Application

References

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