Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Parallel Tools Platform FAQ"
(→Q: How do use PTP to connect to a remote system via an intermediate system (2 hops)) |
(→Q: How do use PTP to connect to a remote system via an intermediate system (2 hops)) |
||
Line 124: | Line 124: | ||
See this bug: https://bugs.eclipse.org/bugs/show_bug.cgi?id=293720 | See this bug: https://bugs.eclipse.org/bugs/show_bug.cgi?id=293720 | ||
− | == Q: How do use PTP to connect to a remote system via an intermediate | + | == Q: How do use PTP to connect to a remote system via an intermediate host (multi hop) == |
You would first create the tunnel using a command such as: | You would first create the tunnel using a command such as: |
Revision as of 04:56, 23 September 2011
Contents
- 1 Q: How do I download PTP?
- 2 Q: What version of Eclipse and CDT do I need?
- 3 Q: What version of MPI do I need to run PTP?
- 4 Q: What platforms and runtimes are supported by PTP now?
- 5 Q: How do I install Open MPI?
- 6 Q: How do I build PTP myself?
- 7 Q: How do I ask questions about PTP?
- 8 Q: How do find out more about PTP?
- 9 Q: What's the most recent version of PTP?
- 10 Q: How do I install the most recent released version of PTP?
- 11 Q: I want to live a bit on the bleeding edge. How do I install a more recent PTP build, e.g. to get a bug fix ?
- 12 Q: When I launch a parallel job how do I stop it from building everything in my workspace ?
- 13 Q: How do I customize the new (JAXB) Configurable Resource Manager?
- 14 Q: How do I enable the Eclipse menu icons to show in Linux with GTK?
- 15 Q: How do use PTP to connect to a remote system via an intermediate host (multi hop)
Q: How do I download PTP?
PTP can now (as of 5.0, June 2011) be installed in two ways:
- from the all-in-one package "Eclipse IDE for Parallel Application Developers" on the Eclipse downloads page
- or installed into an existing eclipse via the Eclipse Installation Manager (Help > Install new software...).
See the PTP download page; check regularly there for new releases, too. The current released version of PTP is 5.0.x.
See the PTP 5.0 release notes for detailed instructions on how to install PTP.
Q: What version of Eclipse and CDT do I need?
PTP 5.0 is designed to work with Eclipse 3.7.x (Indigo) and CDT 8.0.x.
PTP 4.0 is designed to work with Eclipse 3.6.x (Helios) and CDT 7.0.x.
PTP 3.0 is designed to work with Eclipse 3.5.x (Galileo) and CDT 6.0.2.
Q: What version of MPI do I need to run PTP?
PTP supports the following MPI runtimes:
- Open MPI 1.2.x, 1.3.x, or 1.4.x
- MPICH2 1.0.6p1
- IBM's Parallel Environment (PE)
The most recent OpenMPI (1.4.x) is recommended for PTP 4.0.x and 5.0.x, although it may work with older releases.
For the Parallel Language Development Tools only, there should be no difference between the different versions of MPI, such as OpenMPI and LamMPI. You just need to configure your project to be built using mpicc rather than gcc (for MPI releases that require that; most do), and to specify the include path to the MPI header files. This should be described in the PLDT help.
Q: What platforms and runtimes are supported by PTP now?
The current release of PTP runs on Linux, MacOS X, and Windows. PTP only supports target systems running Linux, MacOS X, and some kinds of Unix (e.g. AIX).
The Parallel Language Development Tools will run anywhere Eclipse 3.6 and CDT 7.0 will run. It simply requires any version of MPI (specifically, its header files) to aid in the search for MPI artifacts. And an OpenMP header file, if OpenMP analysis is needed.
The Remote Development Tools can be used on Linux, MacOS X, and Windows.
Q: How do I install Open MPI?
You may already have it installed. Try running the following command and check the output:
ompi_info
If this doesn't work, download the latest version from the Open MPI site.
Unpack the distribution and run the commands (note that you may have to add extra options to configure to suit your local site - see the Open MPI help documentation for more information):
./configure --prefix=/path/to/your/ompi/install make make install
At this point it's a good idea to run a small mpi program to test you have installed Open MPI correctly.
mpicc -o testMPI testMPI.c mpirun -np 2 testMPI
Q: How do I build PTP myself?
See the PTP Environment Setup instructions
Q: How do I ask questions about PTP?
Subscribe to the PTP Mailing lists, especially ptp-user, and ask questions there. This is an excellent place to ask new-user questions. The ptp-user list is watched by most of our PTP developers as well as many users, and you can share in their experience. See http://www.eclipse.org/ptp/mailing_lists.php
Q: How do find out more about PTP?
- Read the PTP Help documentation from the PTP Website or download it and read the help within your PTP installation.
- Download slides from previous PTP tutorials
- Ask questions on the mailing lists: See http://www.eclipse.org/ptp/mailing_lists.php
Q: What's the most recent version of PTP?
The current released version is 5.0.x.
See the announcements on http://eclipse.org/ptp which should indicate the latest release number. As of Sep 2011 this is 5.0.1.
The most accurate latest release number is whatever is found on the update site at http://download.eclipse.org/tools/ptp/updates/indigo.
Q: How do I install the most recent released version of PTP?
There are two update sites:
- The Indigo update site http://download.eclipse.org/releases/indigo contains all the Eclipse projects (as of Sep 2011 it contains PTP 5.0.1)
- The PTP-specific update site http://download.eclipse.org/tools/ptp/updates/indigo may have a more recent release
- Update Sites
- The Indigo update site (http://download.eclipse.org/releases/indigo) contains the last release of PTP that was built into the Eclipse general update site. Eclipse Indigo updates are released only in September and February. This update site (a.k.a. software repository) is enabled by default when you install Eclipse Indigo (a.k.a. 3.7).
- Help > Install New Software.... and install PTP from there
- Help > Check for Updates will find the updates for all your installed features that are found there.
- PTP maintains its own PTP-specific update site with the most recent release of PTP. Bug fix releases can be more frequent than Helios'.
You must enable the PTP-specific update site before the updates will be found.- Enable the PTP-specific update site
- Help > Install new software...
- Click Available Software Sites link
- Enable/check the PTP site:
- http://download.eclipse.org/tools/ptp/updates/indigo
- If you had this checked before, and a release happened recently, hit the 'Reload' button while this site is selected. Or if things just don't seem to be refreshing correctly: It can't hurt!
- Choose OK and then Cancel to return to the Eclipse workbench, and ...
- Now do the update
- Select Help > Check for updates
- Follow prompts like a normal installation
- Select Help > Check for updates
- Enable the PTP-specific update site
Q: I want to live a bit on the bleeding edge. How do I install a more recent PTP build, e.g. to get a bug fix ?
Go to the PTP builds page and find the page for your release (e.g. if you have 4.0.x, find the page with the largest value of x) and download the archive file (ptp-master-xxx) then use that in the Help > Install New Software... dialog.
Q: When I launch a parallel job how do I stop it from building everything in my workspace ?
Open Preferences (Window > Preferences or on a Mac, Eclipse > Preferences), Open Run/Debug / Launching Under "General Options" on that page, Uncheck "Build (if required) before launching"
Q: How do I customize the new (JAXB) Configurable Resource Manager?
A detailed guide to the XML Schema for the new Configurable Resource Manager, along with an introductory tutorial slide-set demonstrating some simple modifications to an existing XML definition, are now available at PTP/resource-managers.
See this bug: https://bugs.eclipse.org/bugs/show_bug.cgi?id=293720
Q: How do use PTP to connect to a remote system via an intermediate host (multi hop)
You would first create the tunnel using a command such as:
ssh -L 22222:<target-host>:22 <intermediate-host>
where <intermediate-host> is the host name of the intermediate system and <target-host> is the host name of the target system. The first port number (22222) can be any port number greater than 1024 that is not already being used. The second port number must be 22. Once a connection is established to <intermediate-host>, you will need to leave this session connected while you're using PTP.
Next, when you configure a new resource manager, create a new connection (using Remote Tools) and specify the host name as 'localhost'. Click on the 'Advanced' button, and change the port number from 22 to the number you specified in the command above.
Use this same connection when configuring a remote or synchronized project.