Intel® MPI Library Developer Reference for Windows* OS

ID 768734
Date 3/31/2023
Public

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

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.