Topology Awareness Application Tuning

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.

I_MPI_TUNE_RANK_PLACEMENT

Syntax

--rank-placement [<value>] or -rp [<value>]

or

I_MPI_TUNE_RANK_PLACEMENT=<value>

Arguments

<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

Description

If you set I_MPI_TUNE_RANK_PLACEMENT to enable, the mpitune wrapper executes alternate topology tool (mpitune_rank_placement).

Example

$ 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.

Note

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

Syntax

--application-statistics [<value>] or -s [<value>]

or

I_MPI_TUNE_APPLICATION_STATICSTICS=<value>

Arguments

<value>

Path to the native Intel MPI statistics file level 1 or higher. This setting is only applicable together with --rank-placement option

Description

To pass the Intel MPI statistics file to mpitune (mpitune_rank_placement), it reduces the tuning time.

Example

$ mpitune -rp -s <path to statistics file>

I_MPI_TUNE_APPLICATION_COMMUNICATION_GRAPH

Syntax

--application-communication-graph [<value>] or -acg [<value>]

or

I_MPI_TUNE_APPLICATION_COMMUNICATION_GRAPH=<value>

Arguments

<value>

Path to the ACG file. This setting is only applicable together with --rank-placement option

Description

To pass the ACG file to mpitune (mpitune_rank_placement), it reduces the tuning time.

Example

$ mpitune -rp -acg <path to acg_file>

I_MPI_TUNE_HARDWARE_TOPOLOGY_GRAPH

Syntax

--hardware-topology-graph [<value>] or -htg [<value>]

or

I_MPI_TUNE_HARDWARE_TOPOLOGY_GRAPH=<value>

Arguments

<value>

Path to the file with the description of hardware topology graph. This setting is only applicable together with --rank-placement option

Description

To pass the HTG file to mpitune (mpitune_rank_placement), it reduces the tuning time.

Example

$ mpitune -rp -acg <path to acg_file> -htg <path to htg_file>