Intel® MPI Library Developer Reference for Windows* OS

ID 768734
Date 12/16/2022
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Give Feedback

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 \name of the executable file

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 <executable> with the single set of arguments. For example, the following command executes test.exe over the specified processes and hosts:

> mpiexec -f <hostfile> -n <# of processes> test.exe

where:

  • <# of processes> specifies the number of processes on which to run the test.exe executable

  • <hostfile> specifies a list of hosts on which to run the test.exe executable

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
NOTE:
You need to distinguish global options from local options. In a command-line syntax, place the local options after the global options.