Intel® MPI Library Developer Reference for Linux* OS

Download PDF
ID 768732
Date 11/07/2023
Public

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

Document Table of Contents
Document Table of Contents x
Intel® MPI Library Developer Reference for Linux* OS
Intel® MPI Library Developer Reference for Linux* OS x
Introduction Command Reference Environment Variable Reference Miscellaneous Notices and Disclaimers
Introduction x
Introducing Intel® MPI Library What's New Notational Conventions Related Information
Command Reference x
Compiler Commands mpirun mpiexec.hydra cpuinfo impi_info mpitune_fast
Compiler Commands x
Compilation Command Options
mpiexec.hydra x
Global Hydra Options Local Hydra Options gtool Options
Environment Variable Reference x
Compilation Environment Variables Hydra Environment Variables I_MPI_ADJUST Family Environment Variables Tuning Environment Variables Process Pinning GPU Support Environment Variables for Fabrics Control Environment Variables for Memory Policy Control Environment Variables for Asynchronous Progress Control Environment Variables for Multi-EP Other Environment Variables
Tuning Environment Variables x
Autotuning
Autotuning x
I_MPI_TUNING_AUTO Family Environment Variables
Process Pinning x
Environment Variables for Process Pinning Interoperability with OpenMP* API
GPU Support x
GPU Pinning GPU Buffers Support
Environment Variables for Fabrics Control x
Communication Fabrics Control Shared Memory Control OFI*-capable Network Fabrics Control
Miscellaneous x
Java* Bindings for MPI-2 Routines
Intel® MPI Library Developer Reference for Linux* OS

mpiexec.hydra

Launches an MPI job using the Hydra process manager.

Syntax

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

or

mpiexec.hydra<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> ./a.out or path/ name of the executable file

Description

Use the mpiexec.hydra 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 a.out over the specified processes and hosts: 

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

where:

  • <# of processes> specifies the number of processes on which to run the a.out executable

  • <hostfile> specifies a list of hosts on which to run the a.out 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.hydra -f <hostfile> -env <VAR1> <VAL1> -n 2 ./a.out : \
-env <VAR2> <VAL2> -n 2 ./b.out
NOTE:
You need to distinguish global options from local options. In a command-line syntax, place the local options after the global options.
Parent topic: Command Reference
Level Two Title