blob: 8ea33d461819ceb1d5beb4d51882961ee033a555 [file] [log] [blame]
<html>
<head>
<title>Launching Parallel Programs</title>
</head>
<body>
<h1 id="top">The old way to launch parallel programs</h1>
<p>
<h2 id="launch">Launching the MPI program with external program</h2>
<p>To run the program without using the PTP Runtime
or PTP Debugger, you can launch the 'mpirun' invocation
directly from eclipse.
<p>Set up the launch configuration for launching the
MPI program by configuring for "external tools."
Under the External tools menu
<img src="images/extToolsIcon.gif" border="1">, select External Tools
<p><img src="images/extToolsMenu.gif">
<p>In the External Tools dialog, under Configurations, select Program
and select the "New" button.
<br><img src="images/extToolsDlg.gif">
<p>Fill in the information to run 'mpirun' for example.
<br><img src="images/extToolsDlg2.gif">
<br>
Use the buttons to fill in variables that point to locations
within your eclipse project, as shown above.
Click the "Run" button to execute it.
Output will be shown in the console window.
<br><img src="images/extToolsRunMPI.gif">
<h2 id="launch2">Launching the MPI program with the run configuration dialog</h2>
<ul>
<li>Open the run configuration dialog (Run...)
<li>Create a new C/C++ Local Application (or Local Application)
<li>Choose the project
<li>Enter the <i>full path</i> of the <code>mpirun</code> (or <code>mpiexec</code>)
command in the C/C++ Application (or Application) field
<li>Select the Arguments tab
<li>Enter the <code>mpirun</code> (or <code>mpiexec</code>)
arguments and the name of the executable
<li>Select Apply and then Run
</ul>
<p>Limitations of the old way:
<ul>
<li>No indication of job or process status
<li>Cannot easily interact with a job scheduler
<li>Must have MPI installed on local machine
<li>No access to individual stdout of processes
<li>No ability to debug program
</ul>
<p>Now proceed to <a href="02pLaunchConfig.html">launching your parallel program with the
PTP Runtime</a>
Perspective.
</a>.
<p><a href="#top">Back to Top</a> | <a href="toc.html">Back to Table of Contents</a>
</body>
</html>