Developer Reference

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

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.