Intel® MPI Library Reference Manual for Linux* OS
This section describes how to use the mpitune utility to perform the topology awareness application tuning. If you want to perform this tuning in the dynamic method, see the description of -use-app-topology and I_MPI_HYDRA_USE_APP_TOPOLOGY.
--rank-placement [<value>] or -rp [<value>]
or
I_MPI_TUNE_RANK_PLACEMENT=<value>
<value> |
Binary indicator |
enable | yes | on | 1 |
Switch the mpitune utility to the topology tuning tool. This value is only applicable for the application tuning mode. For example, when you define the --application option or application communication graph (ACG) and optionally hardware topology graph (HTG) are passed by additional options -acg and -htg |
disable | no | off | 0 |
Switch off the topology tuning tool. This is the default value |
If you set I_MPI_TUNE_RANK_PLACEMENT to enable, the mpitune wrapper executes alternate topology tool (mpitune_rank_placement).
$ mpitune --application \“mpirun … \” --rank-placement
$ mpitune --application \“mpirun … \” --rank-placement enable
$ mpitune --application \“mpirun … \” -rp -acg <path to acg_file> -htg <path to htg_file>
The result is a host file and a configuration file with the record for automatic usage of the host file.
If you use the --help option and the --rank-placement option together, the help message of mpitune_rank_placement is printed.
I_MPI_TUNE_APPLICATION_STATISTICS
--application-statistics [<value>] or -s [<value>]
or
I_MPI_TUNE_APPLICATION_STATICSTICS=<value>
<value> |
Path to the native Intel MPI statistics file level 1 or higher. This setting is only applicable together with --rank-placement option |
To pass the Intel MPI statistics file to mpitune (mpitune_rank_placement), it reduces the tuning time.
$ mpitune -rp -s <path to statistics file>
I_MPI_TUNE_APPLICATION_COMMUNICATION_GRAPH
--application-communication-graph [<value>] or -acg [<value>]
or
I_MPI_TUNE_APPLICATION_COMMUNICATION_GRAPH=<value>
<value> |
Path to the ACG file. This setting is only applicable together with --rank-placement option |
To pass the ACG file to mpitune (mpitune_rank_placement), it reduces the tuning time.
$ mpitune -rp -acg <path to acg_file>
I_MPI_TUNE_HARDWARE_TOPOLOGY_GRAPH
--hardware-topology-graph [<value>] or -htg [<value>]
or
I_MPI_TUNE_HARDWARE_TOPOLOGY_GRAPH=<value>
<value> |
Path to the file with the description of hardware topology graph. This setting is only applicable together with --rank-placement option |
To pass the HTG file to mpitune (mpitune_rank_placement), it reduces the tuning time.
$ mpitune -rp -acg <path to acg_file> -htg <path to htg_file>