PTP/release notes/2.0

Currently under construction ...

Prerequisites

• OS: Linux or Mac OS X 10.4.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.*
• 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

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, etc. If you plan to do Java or Eclipse development, get the Eclipse SDK. If you just want C/C++ (or Fortran via Photran) then the Platform runtime Binary only is smaller and less complex. Note that there isn't a prebuilt "Eclipse for C/C++ development" that has CDT 4.0.2 - the Spring Europa maintenance release should have one for 4.0.3.

If you plan to install PTP from the update site, you can do it at this point also.

(Note: need a list of the components of PTP, what is required, what is optional, etc.: PTP, PLDT, Remote Tools, IBMPE, IBMLL, RSE, 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 installation

If you didn't install PTP from the update site while installing CDT, Install it from the update site now, or Download the PTP plug-in and unzip (or un-tar) into the same directory into which Eclipse has been installed. Do the same with the PLDT download as well, if you want the development tools.

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 ".