Tutorial: Analyzing MPI Applications with Intel® Trace Analyzer and Intel® VTune™ Amplifier XE

  • 9.1
  • 08/07/2015
  • Public Content
Contents

Prerequisites


This section describes the steps you need to do before you start using the Intel® Trace Analyzer and Collector and Intel® VTune™ Amplifier XE.
Required Software
To perform all the steps described in this tutorial, you will need the following software installed on your system:
  • Intel® compilers
  • Intel® MPI Library
  • Intel® Trace Analyzer and Collector
  • Intel® VTune™ Amplifier XE
All of these products are installed as part of Intel® Parallel Studio XE Cluster Edition.
Setting Up the Environment Variables
Linux* OS:
Set the required environment variables by sourcing the
psxevars.c[sh]
 script available at
<install-dir>/parallel_studio_xe_<version>.x.xxx/bin
, where
<install-dir>
 is the Intel® Parallel Studio XE Cluster Edition installation directory. For example:

$ source psxevars.sh
Windows* OS:
Open the command prompt from
Start > Intel Parallel Studio XE
version
 > Compiler and Performance Libraries > Intel 64 Visual Studio
version
 environment
. This will set all required environment variables and you will be ready to trace your applications.
Creating Trace Files
To trace the
poisson
 application, go to
<install-dir>/examples/poisson
 and copy its contents into your working directory, then trace the application:
Linux* OS:
  1. Compile the application running the
    make
     command. Adjust the
    Makefile
    , if necessary.
  2. Run the application with the
    -trace
     optionof
    mpirun
    :
    
$ mpirun -n 4 -trace ./poisson
Windows* OS:
  1. Compile all components of the
    poisson
     application from the compiler command prompt with the
    -trace
     option. Use the
    -Zi
     option to compile the application in debug mode. The basic command line for Fortran programs is:
    > mpiifort -trace -Zi myApp.f90
  2. Run the application to generate a tracefile:
    > mpiexec -n 4 myApp.exe
For your convenience, this tutorial comes with a set of trace files available at
<install-dir>/examples/traces
.
OS X*:
On OS X* Intel® Trace Collector is unavailable, therefore you cannot trace applications on this OS. Generate a tracefile on a Linux* or Windows* machine, or use the generated tracefiles from
<install-dir>/examples/traces
.
Once you have the trace data available for the
poisson
 application, you are ready to start the analysis.

Product and Performance Information

1

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