Developer Reference

  • 2020 Update 2
  • 07/15/2020
  • Public Content

mpitune_fast

This utility tunes the Intel® MPI Library to the cluster configuration using the Autotuning functionality.

Syntax

mpitune_fast <options>

Arguments

<mpitune options>
Options
-c | --colls
Set custom collective operations to tune delimited by commas.
-d | --results_dir
Set custom directory for tuning results, host files and logs.
Default: current working directory.
-h | --help
Display the help message.
-n <n>
Specify the number of nodes. This can be a comma-delimited set of values to set up several launches.
-ppn <n>
Specify the number of processes per node. This can be a comma-delimited set of values to set up several launches.

Description

The
mpitune_fast
utility allows you to automatically set up the Intel® MPI Library and launch with Autotuning enabled and configured for your cluster configuration.
The tool iteratively launches the Intel® MPI Benchmarks utility with the proper autotuner environment and generates a
.dat
file with the tuning parameters for your cluster configuration.
After generation the tuning file, set it as I_MPI_TUNING_BIN:
$
export I_MPI_TUNING_BIN=./tuning_results.dat
$ mpiexec <
args
>

Workload Managers  Support

mpitune_fast
supports Slurm and LSF workload managers. It automatically defines job allocated hosts and performs launches.

MPI Options Support

The following MPI options are available within the utility:
<MPI options>
Options
-f <filename>
Specify a file containing host names.
Example (default launch):
$
mpitune_fast -f ./hostfile
Example (customized launch):
$ mpitune_fast -ppn 8,4,2,1 -f ./hostfile -c alltoall,allreduce,barrier

See Also

MPI Tuning
in the Intel® MPI Developer Guide
For available configuration options, refer to mpitune Configuration Options .

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804