<!doctype html public "-//w3c//dtd html 4.0 transitional//en"><html><head><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>ptp 1.0 release notes</title><link rel="stylesheet" href="http://eclipse.org/default_style.css" type="text/css"></head><body text="#000000" bgcolor="#ffffff" link="#0000ee" vlink="#551a8b" alink="#ff0000"><table border=0 cellspacing=5 cellpadding=2 width="100%">  <tbody>    <tr>      <td width="69%" class="bannertext">        <font class="indextop style2">ptp 1.0 release notes </font><br>        <font class="indexsub">parallel tools platform subproject</font>      </td>      <td width="31%">        <div align="center">          <img src="http://eclipse.org/images/Idea.jpg" width="120" height="86" hspace="50" align="middle">        </div>      </td>    </tr>  </tbody></table><table border=0 cellspacing=5 cellpadding=2 width="100%">  <tr>    <td align=left valign=top bgcolor="#0080C0">      <b><font color="#FFFFFF" face="Arial,Helvetica"><a name="PTP"></a>Parallel Tools Platform </font></b></td>  </tr>  <tr>    <td align=left valign=top bgcolor="#FFFFFF"><p>Note: installation of the PTP component is not required if you just want to use the <a href="#MDT">MPI Development Tools</a> or <a href="#FDT">Fortran Development Tools </a>components. Please see the appropriate sections below for release notes on these components. </p>      <p>The main PTP components are split into three parts:</p>      <ul>        <li>a set of Eclipse plug-ins</li>        <li>an architecture-specific runtime plug-in</li>        <li>an architecture-specific debugger plug-in</li>      </ul>      <h2>Prerequisites</h2>      <ul>      <li>Java 1.4.2 or later</li>        <li>Eclipse 3.1.x</li>        <li>CDT 3.0.x</li>        <li>OpenMPI 1.0.2 (or greater) </li>      </ul>          <h2>Installation</h2>      <ol>        <li>Install           <a href="http://eclipse.org/downloads">Eclipse SDK 3.1.x</a>          and <a href="http://download.eclipse.org/tools/cdt/releases/eclipse3.1">CDT 3.0.x SDK</a> for your architecture.</li>        <li>Download, build and install <a href="http://www.open-mpi.org/software/ompi/v1.0/">OpenMPI 1.0.2</a>.           (Note: as of February 2006, this is still a "pending alpha" release          of OpenMPI 1.0.2, but it works fine for us.)          If you intend to build PTP from source, instead of downloading it pre-built          from the <a href="../../downloads.html">downloads</a> page,           make sure you supply the <code>--with-devel-headers</code> argument to the <code>configure</code> command.</li>        <li> Test your MPI installation by running a small MPI job.</li>        <li>Download PTP core and the runtime and debugger plug-ins that suit your architecture.</li>        <li>Unzip (or un-tar) into the same directory into which Eclipse has been installed.</li>        <li> Start Eclipse.  (You may need to use the &quot;-clean&quot; parameter to force it to recognize new features and plug-ins).</li>        <li>Open the PTP Runtime perspective (Window&gt;Open Perspective&gt;Other...). This should automatically select the Open MPI runtime preference and start the runtime service. If you have a problem here, please refer to the Troubleshooting section. </li>        <li>More details on using PTP can be found  in Help  &gt; Help Contents.  Click on &quot;PTP: Parallel Tools Platform &quot;. </li>      </ol>      <h2>Troubleshooting</h2>      <h3>        PTP session hangs in 'Refresh runtime system' dialog. </h3>      <p>This is usually one of the following things:            <ol>          <li>OpenMPI lock problem: (See also a <a href="../build.html#cleanupOmpi">handy shell script for doing this cleanup</a>)            <ul>              <li>Quit out of Eclipse </li>              <li>Check there are no orted, orte_server or sdm programs running with the 'ps ax' command.</li>              <li>If there are, kill them off.</li>              <li>Check for any directories in /tmp starting with 'openmpi-sessions-&lt;username&gt;' . Remove the directory and all it's contents.</li>              <li>Restart Eclipse</li>            </ul>        </li>        <li>Unable to locate OpenMPI libraries:          <ul>            <li>The orte_server is dynamically linked against the OpenMPI libraries, so needs to be able to locate your OpenMPI installation to run.</li>            <li>You can check this by manually running the orte_server. If you see anything other than the message &quot;<code>proxy_svr_connect returned.</code>&quot; then this is likely to be the problem.</li>            <li>On Linux, make sure the OpenMPI libraries are  located in /usr/local/lib, /usr/lib or /lib, or you have set your LD_LIBRARY_PATH correctly.</li>            <li>On Mac OS X, make sure the OpenMPI libraries are located in $(HOME)/lib, /usr/local/lib, /usr/lib or /lib, or you have set your DYLD_LIBRARY_PATH correctly. </li>          </ul>        </li>        <li>Window manager path problem:          <ul>            <li>The window manager and shell get their paths from different places. </li>            <li>If you are launching Eclipse using a window manager, you need to make sure that the OpenMPI installation is in the window manager path.</li>            <li>Even if you can use 'mpirun' successfully from a shell it does not necessary mean that the window manager path is correct.</li>            <li>Mac OS X:              <ul>                <li>The path is set by creating an environment.plist file in a directory called .MacOSX in your home directory. </li>                <li>The file should look like this, with [path_including_ompi_installation] replaced with the correct path:                  <pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;<br>&lt;!DOCTYPE plist PUBLIC &quot;-//Apple Computer//DTD PLIST 1.0//EN&quot; &quot;http://www.apple.com/DTDs/PropertyList-1.0.dtd&quot;&gt;<br>&lt;plist version=&quot;1.0&quot;&gt;<br>&lt;dict&gt;<br>        &lt;key&gt;PATH&lt;/key&gt;<br>        &lt;string&gt;[path_including_ompi_installation]&lt;/string&gt;<br>&lt;/dict&gt;<br>&lt;/plist&gt;</pre>                </li>              </ul>            </li>            <li>Linux/KDE:              <ul>                <li>Anybody know? </li>              </ul>            </li>            <li>Linux/Gnome:              <ul>                <li>Anybody know? <br>                </li>              </ul>            </li>          </ul>        </li>  </ol>  </tr>  <tr>    <td align=left valign=top bgcolor="#0080C0">      <p><b><font color="#FFFFFF" face="Arial,Helvetica"><a name="MDT"></a>MPI Development Tools </font></b></p>  </tr>  <tr>    <td align=left valign=top bgcolor="#FFFFFF"><p>The MPI Development Tools require an MPI installation to be available on the machine running Eclipse. Unlike PTP, any MPI installation should work (MPICH, LAM-MPI, etc.) The MPI Development Tools only requires access to the MPI header files to be able to recognize the MPI artifacts. </p>      <h2>Prerequisites</h2>      <ul>        <li>Eclipse 3.1.x</li>        <li>CDT 3.0.x</li>        <li>An MPI installation </li>      </ul>      <h2>Installation</h2>      <ol>        <li>Install Eclipse 3.1.x and CDT 3.0.x for your architecture.</li>        <li>Download the 'MPI Development Tools' distribution from from <a href="http://eclipse.org/ptp/downloads.html">here</a>.</li>        <li>Unzip (or un-tar) into same directory into which  Eclipse has been installed (or use the update site).</li>        <li>Start Eclipse.  (You may need to use the &quot;-clean&quot; parameter to force it to recognize new features and plug-ins).</li>        <li>You should see the two new &quot;MPI&quot; buttons in the toolbar.</li>        <li>Follow the instructions in Help  &gt; Help Contents.  Click on &quot;PTP MPI Tools&quot;.   </li>        <li>Setup and running instructions include a small sample C MPI file for testing.</li>    </ol></td>  </tr>  <tr>    <td align=left valign=top bgcolor="#0080C0">      <b><font color="#FFFFFF" face="Arial,Helvetica"><a name="FDT"></a>Fortran Development Tools </font></b></td>  </tr>  <tr>    <td align=left valign=top bgcolor="#FFFFFF">      <h2>Prerequisites</h2>      <ul>      <li>Eclipse 3.1.x</li>      <li>CDT 3.0</li>      </ul>      <h2>Installation</h2>      <ol>      <li>Install Eclipse 3.1.x and CDT 3.0 for your architecture.</li>      <li>Download the 'CDT with mixed-language projects' and 'Fortran Development Tools' distributions from <a href="http://eclipse.org/ptp/downloads.html">here</a>.</li>      <li>Unzip (or un-tar) into same directory into which  Eclipse has been installed (or use the update site).</li>      <li>Start Eclipse.  (You may need to use the &quot;-clean&quot; parameter to force it to recognize new features and plug-ins).</li>      </ol>        <h2>Notes</h2>      <p>The installation of the Fortran Development Tools will replace some of your existing CDT components. This adds support for mixed language projects (i.e. combining C, C++ and Fortran into a single project), and also introduces some changes necessary to support the FDT plug-ins. It is hoped that these changes will be included in a CDT release in the near future. </p>      </tr>  <tr>  <td align=left valign=top bgcolor="#FFFFFF">  </tr></table><p>&nbsp;</p></body></html>