Revision as of 16:39, 14 January 2008

Currently under construction ...

Prerequisites

• OS: Linux or Mac OS X 10.4.x or 10.5.x (for PTP Core only; PLDT should run anywhere Eclipse runs, including Windows.)
• Java 1.5 or later (Note: for Linux, must be Sun or IBM's. See below.)
• Eclipse 3.3 (also known as Europa)
• CDT 4.0.2
• OpenMPI 1.2 (the earlier 1.0.2 version is also supported)
• gdb 6.3 or later (earlier versions may also work)

Installation

1.Java
2.OpenMPI
3.Eclipse&cdt
4.ptp
5.build ptp

Eclipse Installation

Java requirement: If you are using the Linux operating system, download and install either the Sun Java Runtime Environment or the IBM Java Runtime Environment. The version of Java that ships with Linux will not work with PTP. See the Trouble Shooting section for more information.

Install Eclipse 3.3.x (SDK or Platform Runtime Binary) and CDT 4.0.2 for your architecture.

See Installing Eclipse, CDT and PTP for detailed instructions on downloading Eclipse, installing CDT & PTP, etc.

OpenMPI

Download and unpack OpenMPI 1.2. If you download a pre-built binary for OpenMPI, you MUST obtain the developer version. If there is no developer version available, then you will need to build from source instead.

Configure, build and install OpenMPI (if necessary)

In the main OpenMPI source directory, run the configure command:

       ./configure --with-devel-headers

and any other options required for your installation.

Build and install OpenMPI using:

       make install

Note that if you install OpenMPI in a nonstandard location, you may need to build PTP differently. See the troubleshooting section below.

Test your MPI installation by running a small MPI job, e.g.

       mpicc test.c -o test
       mpirun -np 4 test

Make sure that your PATH and LD_LIBRARY_PATH point to appropriate places.

PTP Setup

Close Eclipse.

Locate the plug-in org.eclipse.ptp.os.arch_x.y.z in the plugins directory, where os and arch correspond to your operating system and architecture respectively, and x.y.z (if present) corresponds to the release version of that particular plugin, e.g. 2.0.x. Change to this directory. Run the command:

   sh BUILD

This should build and install the executables. If you see any errors here, please refer to the Trouble Shooting section below. If you installed OpenMPI in a non-standard location, see below also for an alternate build command.

Start Eclipse. (You may need to use the -clean parameter to force it to recognize new features and plug-ins).

Open the PTP Runtime perspective (Window>Open Perspective>Other...). The runtime service will start and you should see a machine and one or more nodes appear in the 'Machines View'. More details on using PTP can be found in Help>Help Contents. Click on "PTP: Parallel Tools Platform ".

Troubleshooting