Difference between revisions of "PTP/environment setup"

From Eclipsepedia

< PTP
Jump to: navigation, search
(Install Features)
(23 intermediate revisions by 2 users not shown)
Line 1: Line 1:
= PTP Developer Environment Setup (PTP 2.0) =
+
These pages describe how to set up your environment in order to build PTP from the CVS projects and perhaps begin developing PTP.  
  
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.'''
+
'''These are not the correct instructions if you just want to use PTP.'''
  
== Prerequisites ==
+
* [[PTP/environment_setup_70 | Setup an Eclipse Environment for development of PTP 7.0.x for Kepler (Eclipse 4.3/CDT 8.2)]] - using Git
 
+
* [[PTP/environment_setup_60 | Setup an Eclipse Environment for development of PTP 6.0.x for Juno (Eclipse 4.2/CDT 8.1)]] - using Git
The following are the minimum requirements for developing PTP:
+
* [[PTP/environment_setup_50 | Setup an Eclipse Environment for development of PTP 5.0.x for Indigo (Eclipse 3.7/CDT 8.0)]]
 
+
* [[PTP/environment_setup_40 | Setup an Eclipse Environment for development of PTP 4.0.x for Helios (Eclipse 3.6/CDT 7.0)]]
* Java 1.5 or later (Note: for Linux, must be Sun or IBM's)
+
* [[PTP/environment_setup_30 | Setup an Eclipse Environment for development of PTP 3.0.x for Galileo (Eclipse 3.5/CDT 6.0)]]
* Eclipse 3.3.x
+
* [[PTP/environment_setup_21 | Setup an Eclipse Environment for development of PTP 2.1.x for Ganymede (Eclipse 3.4/CDT 5.0)]]
* CDT 4.0.x
+
* [[PTP/environment_setup_20 | Setup an Eclipse Environment for development of PTP 2.0.x for Europa (Eclipse 3.3/CDT 4.0)]]
* 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 ===
+
 
+
[http://www.eclipse.org/downloads/ 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:
+
 
+
# Launch Eclipse (as root if you installed Eclipse in a system directory)
+
# From the menu select: '''Help->Software Updates->Find and Install'''
+
# Select '''Search for new features to install''', click Next
+
# Select '''Europa Discovery Site''', click Finish
+
# Select a valid mirror, click Ok
+
# Expand '''Europa Discovery Site'''
+
# Select '''C and C++ Development''' <br>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.
+
# Select '''Remote Access and Device Development->Remote System Explorer...''' if you wish to install RSE
+
# Click Next
+
# Read and check '''I accept''' click Next and Finish.
+
# 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:
+
# From the menu select: '''Help->Software Updates->Find and Install'''
+
# Select '''Search for new features to install''', click Next
+
# Select the '''New Remote Site''' button on the right.
+
# In the '''New Update Site''' dialog, enter <br>Name: CDT update site<br>URL:  http://download.eclipse.org/tools/cdt/releases/europa, click OK
+
# Make sure it is checked, and click Finish.
+
# Select a valid mirror, click Ok
+
# 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)
+
# Click Next
+
# Read and check '''I accept''' click Next and Finish.
+
# 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:
+
 
+
{| border="1" callpadding="2"
+
! Project Set Contents !! Committer Access !! Anonymous Access
+
|-
+
| Core PTP Plugins (required) || [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.ptp/releng/ptp_project_sets/committer/ptp-2.0-committer.psf?cvsroot=Tools_Project ptp-2.0-committer.psf] ||  [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.ptp/releng/ptp_project_sets/anonymous/ptp-2.0-anonymous.psf?cvsroot=Tools_Project ptp-2.0-anonymous.psf]
+
|-
+
| Resource Manager Plugins (required) || [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.ptp/releng/ptp_project_sets/committer/ptp-rms-2.0-committer.psf?cvsroot=Tools_Project ptp-rms-2.0-committer.psf] ||  [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.ptp/releng/ptp_project_sets/anonymous/ptp-rms-2.0-anonymous.psf?cvsroot=Tools_Project ptp-rms-2.0-anonymous.psf]
+
|-
+
| Remote Tools Plugins (optional) || [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.ptp/releng/ptp_project_sets/committer/ptp-remotetools-2.0-committer.psf?cvsroot=Tools_Project ptp-remotetools-2.0-committer.psf] ||  [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.ptp/releng/ptp_project_sets/anonymous/ptp-remotetools-2.0-anonymous.psf?cvsroot=Tools_Project ptp-remotetools-2.0-anonymous.psf]
+
|-
+
| RSE Support Plugins (optional) || [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.ptp/releng/ptp_project_sets/committer/ptp-rse-2.0-committer.psf?cvsroot=Tools_Project ptp-rse-2.0-committer.psf] ||  [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.ptp/releng/ptp_project_sets/anonymous/ptp-rse-2.0-anonymous.psf?cvsroot=Tools_Project ptp-rse-2.0-anonymous.psf]
+
|-
+
| Parallel Language Development Tools (optional) || [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.ptp/releng/ptp_project_sets/committer/ptp-pldt-2.0-committer.psf?cvsroot=Tools_Project ptp-pldt-2.0-committer.psf] ||  [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.ptp/releng/ptp_project_sets/anonymous/ptp-pldt-2.0-anonymous.psf?cvsroot=Tools_Project 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:
+
 
+
# Under '''org.eclipse.ptp''', open '''releng''' and check out the '''ptp_project_sets''' project. <br>
+
# Switch to the '''Plug-in Development''' perspective.
+
# In the '''ptp_project_sets''' project, expand either the 'anonymous' or 'committer' folder.
+
# 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 OpenMPI Proxy ==
+
 
+
# 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.  The instructions are interpreted here:
+
#* 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>
+
#* You should at least have  executables <code>ptp_orte_proxy</code> and <code>sdm</code> in  your org.eclipse.ptp.<i>os.arch</i> project.  You may need to Refresh (F5) the project to see it from the workbench.
+
 
+
== Create an eclipse application launch configuration ==
+
 
+
Click on '''org.eclipse.ptp.core''', Right click on Run As ... and choose '''Eclipse Application'''
+
 
+
== References ==
+
* Eclipse Downloads [http://www.eclipse.org/downloads/]
+
* CDT Downloads Page [http://www.eclipse.org/cdt/downloads.php]
+
* CVS Howto [http://wiki.eclipse.org/CVS_Howto]
+
* PTP Release Notes [http://www.eclipse.org/ptp/docs/releases/release-1.1.1.php]
+

Revision as of 17:06, 6 February 2013

These pages describe 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.