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:

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 option of 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.