ptp build
parallel tools platform subproject
PTP Build Procedure

There is also information near the bottom of this page about cleaning up old OpenMPI things between PTP invocations.

We have had several questions about building PTP from the CVS source. If you are downloading PTP from the downloads site, then stop reading, you don't need this. If, however, you want or need the latest PTP from CVS and want to build it yourself, keep reading.

  1. Download and build OpenMPI: See FAQ #6. Be sure to build --with-devel-headers.

     

  2. Set up to get to eclipse.org CVS via Eclipse.
    Create a new CVS repository location:
    • Connection type: pserver
    • User: anonymous
    • Password: (leave blank)
    • Host: dev.eclipse.org
    • Repository path: /cvsroot/tools
    • Use default port

    Now open up org.eclipse.ptp under /cvsroot/tools.

  3. Build orte_server (Open Run Time Environment server):
    1. Make sure you have the following PTP projects from CVS, in org.eclipse.ptp, under 'core' folder
      • org.eclipse.ptp.orte
      • org.eclipse.ptp.orte.OS.ARCH - to match your operating system and architecture, e.g. org.eclipse.ptp.orte.linux.x86
      • org.eclipse.ptp.proxy
      • org.eclipse.ptp.utils
        (get the others that are not other platforms too, if you want. You will need them later to build the Eclipse plug-ins.)
    2. Create and run an external command for 'configure' in the directory org.eclipse.ptp.orte (or change to this directory and run './configure' manually). This will configure all three directories.
    3. Run the 'all' make target for org.eclipse.ptp.orte (or change to this directory and run 'make all' manually). This will build the proxy and utils libraries and the orte_server executable.
    4. Create and run an external command for 'INSTALL' in the directory org.eclipse.ptp.orte (or change to this directory and run './INSTALL' manually). This will copy the executable to the appropriate location in org.eclipse.ptp.orte.OS.ARCH.
      Note: you will probably have to make it executable e.g. chmod +x INSTALL

  4. Build SDM (Scalable Debug Manager):
    1. Make sure you have the following projects from CVS, in org.eclipse.ptp, under 'debug' folder
      • org.eclipse.ptp.debug.sdm
      • org.eclipse.ptp.debug.sdm.orte.OS.ARCH
        (get the others that are not other platforms too, if you want. You will need them later to build the Eclipse plug-ins.)
    2. Create and run an external command for 'configure' in the directory org.eclipse.ptp.debug.sdm (or change to this directory and run './configure' manually). This will configure all three directories.
    3. Run the 'all' make target for org.eclipse.ptp.debug.sdm (or change to this directory and run 'make all' manually). This will build the proxy and utils libraries and the sdm executable.
    4. Create and run an external command for 'INSTALL'' in the directory org.eclipse.ptp.debug.sdm (or change to this directory and run './INSTALL' manually). This will copy the executable to the appropriate location in org.eclipse.ptp.debug.sdm.orte.OS.ARCH.
      Note: you will probably have to make it executable e.g. chmod +x INSTALL

  5. The rest of the story

    The above steps build the C projects that are part of PTP. Be sure to also check out the Java/PDE projects to build the Eclipse part of PTP. Projects to check out include:
    --core--

    • org.eclipse.ptp.core
    • org.eclipse.ptp.launch
    • org.eclipse.ptp.help
    • org.eclipse.ptp.ui

    --debug--
    • org.eclipse.ptp.debug.core
    • org.eclipse.ptp.debug.external.core
    • org.eclipse.ptp.debug.external.ui
    • org.eclipse.ptp.debug.ui

    --doc--
    • org.eclipse.ptp.help

    --tools-- (optional)
    • org.eclipse.ptp.mpi.core
    • org.eclipse.ptp.mpi.help

  6. Assuming everything builds successfully, then launch an Eclipse application with the above plug-ins included, proceed with a CDT project and create a source file, and launch a parallel application. See the PTP help for details on running.

  7. Instructions for killing old orte/ompi processes with cleanupOmpi
    Until we resolve some issues with OpenMPI, we suggest doing the following before each subsequent invocation of PTP, to kill old ompi things hanging around:
    $ cat cleanupOmpi.sh
    #!/bin/sh
    echo openMPI cleanup for PTP...
    echo killing orted processes
    killall -9 orted
    
    echo killing ompi_server processes
    killall -9 orte_server
    
    echo kill dsm or gdb processes if were debugging
    killall -9 sdm gdb
    
    echo Remove any directories starting with openmpi in /tmp
    rm -rf /tmp/openmpi*
    
    echo now try launching PTP again.
    

Updated 10 March 2006