Job Startup Commands

mpiexec

Syntax

mpiexec <g-options> <l-options> <executable>

or

mpiexec <g-options> <l-options> <executable1> : \

<l-options> <executable2>

or

mpiexec -configfile <file>

Arguments

<g-options>

Global options that apply to all MPI processes

<l-options>

Local options that apply to a single arg-set

<executable>

./a.out or path/name of the executable file

<file>

File with command-line options

Description

Use the first command-line syntax to start all MPI processes of the <executable> with the single arg-set. For example, the following command executes a.out over the specified <# of processes>:

$ mpiexec -n <# of processes> ./a.out

Use the second command-line syntax to start several MPI programs or the same MPI program with different argument sets. For example, the following command runs each given executable on a different host:

$ mpiexec -n 2 -host host1 ./a.out : \

-n 2 -host host2 ./b.out

Use the third command-line syntax to read the command line from specified <file>. For a command with a single arg-set, the entire command should be specified on a single line in <file>. For a command with multiple arg-sets, each arg-set should be specified on a single, separate line in <file>. Global options should always appear at the beginning of the first line in <file>.

MPD daemons must already be running in order for mpiexec to succeed.

Note

If there is no "." in the PATH environment variable on all nodes in the cluster, specify <executable> as ./a.out rather than a.out.