This utility tunes the Intel® MPI Library to the cluster configuration using the Autotuning functionality.
Syntax
mpitune_fast <options>
Arguments
Options | Description |
---|---|
-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: the 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. |
-pd PERF_RESULTS_DIR, --perf_results_dir PERF_RESULTS_DIR | Set a custom directory for validation performance results. Default: performance_results_<timestamp>. |
-ppn <n> | Specify the number of processes per node. This can be a comma-delimited set of values to set up several launches. |
-val [VALIDATE], --validate [VALIDATE] | Run the tuning file validation cycle. To validate the existing tuning file, set --validate <path_to_tuning_file>. |
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>
mpitune_fast supports Slurm and LSF workload managers. It automatically defines job allocated hosts and performs launches.
The following MPI options are available within the utility:
Options | Description |
---|---|
-f <filename> | Specify a file containing host names. |
-hosts HOSTS, --hosts HOSTS | Set the host names, delimited by commas. Example: --hosts host1,host2 |
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 Library Developer Guide
For available configuration options, refer to mpitune Configuration Options.