mpiexec.hydra
Launches an MPI job using the Hydra process manager.
Syntax
mpiexec
<g-options> <l-options> <executable>
or
mpiexec
<g-options> <l-options> <executable1>
:
<l-options> <executable2>
Arguments
<g-options> | Global options that apply to all MPI processes
|
<l-options> | Local options that apply to a single argument set
|
<executable> | <name>.exe or
path
of the executable file
\ name |
Description
Use the
mpiexec
utility to run MPI applications using the Hydra process manager.
Use the first short command-line syntax to start all MPI processes of the
with the single set of arguments. For example, the following command executes
<executable>
test.exe
over the specified processes and hosts:
> mpiexec -f <hostfile> -n <# of processes> test.exe
where:
- specifies the number of processes on which to run the<# of processes>executabletest.exe
- specifies a list of hosts on which to run the<hostfile>test.exeexecutable
Use the second long command-line syntax to set different argument sets for different MPI program runs. For example, the following command executes two different binaries with different argument sets:
> mpiexec -f <hostfile> -env <VAR1> <VAL1> -n 2 prog1.exe : ^ -env <VAR2> <VAL2> -n 2 prog2.exe
You need to distinguish global options from local options. In a command-line syntax, place the local options after the global options.