Intel® Advisor Help

About Analyzing MPI Workloads

Intel® Advisor allows you to analyze parallel tasks running on a cluster, so you can examine your MPI application for opportunities of adding vectorization or threading parallelism. Use the Intel® MPI gtool with mpirun to invoke the advixe-cl command and spawn MPI processes across the cluster.

MPI analysis can be performed only through the command line interface, but the result can be viewed through the standalone GUI, as well as the command line.

Tips

Consider the following when running collections for an MPI application:

MPI Implementations Support

You can use the Intel Advisor with the Intel® MPI Library and other MPI implementations, but be aware of the following details:

Intel® MPI Command Syntax

Use the -gtool option of mpirun with Intel® MPI Library 5.0.2 and higher:

$ mpirun –gtool “advixe-cl -collect <analysis_type> -project-dir <project_PATH>:<ranks_set>” -n <N> <application_name> [myApplication_options]

where:

For detailed syntax, refer to the Intel® MPI Library Reference Manual.

Note

The above examples use the mpirun command, as opposed to mpiexec or mpiexec.hydra, where real-world commands might use the mpiexec* command. mpirun is a higher-level command that dispatches to mpiexec or mpiexec.hydra, depending on the current default and specified options. All the listed examples work for the mpiexec* commands as well as the mpirun command.

Generic MPI Command Syntax

Use mpirun with the advixe-cl command to spawn processes across the cluster and collect data about the application.

Each process has a rank associated with it. This rank is used to identify the result data.

To collect performance or dependencies data for an MPI program with Intel Advisor, the general form of the mpirun command is:

$ mpirun -n <N> advixe-cl -project-dir <project_PATH> -collect <analysis_type> -search-dir src:r=<sources_PATH> -- myApplication [myApplication_options]

where:

Viewing Results via Intel® Advisor

As a result of collection, Intel Advisor creates a number of result directories in the directory specified with -project-dir. The nested result directories are named as rank.0, rank.1, ... rank.n, where the numeric suffix n corresponds to the MPI process rank.

To view the collected results for a specific rank, you can either open a result project file (*.advixeproj) that resides in the -project-dir via the Intel Advisor GUI, or run the Intel Advisor CLI report:

$ advixe-cl -report <analysis_type> -project-dir <project_PATH>:<ranks> 

You can view only one rank's results at a time.

Additional MPI Resources

For more details on analyzing MPI applications, see the Intel MPI Library and online MPI documentation on the Intel® Developer Zone at http://software.intel.com/en-US/articles/intel-mpi-library-documentation/

Other Intel® Developer Zone online resources that discuss usage of the Intel® Parallel Studio XE Cluster Edition with the Intel MPI Library:

Hybrid applications: Intel MPI Library and OpenMP* on the Intel Developer Zone at http://software.intel.com/en-US/articles/hybrid-applications-intelmpi-openmp/

See Also