GettingStarted

Getting started with TAU

This is a short guide to using TAU. Download both PDT and TAU.

%>tar -xzf pdtoolkit-3.11
%>cd pdtoolkit
%>./configure
%>make all install
%>cd ..
%>tar -xzf tau2.16.5
%>cd tau2
%>./configure -pdt=[PDT directory] -mpiinc=[MPI include] -mpilib=[MPI library]
%>make clean install

After installation, executables are placed in a directory based on your platform like x86_64 replace this with your own platform. Let us add the bin directory to our path.

%>export PATH=[path to tau2]/tau2/x86_64/bin:$PATH

We can use TAU's compiler scripts which automatically link-in TAU's instrumentation libraries as well as the MPI libraries as well. But first we need to tell TAU which instrumentation library to use, we do this by setting the TAU_MAKEFILE environment variable. If you would like to set some options you can use the TAU_OPTIONS environment variable.

%>export TAU_MAKEFILE=[path to tau2]/tau2/x86_64/lib/Makefile.tau-mpi-pdt
%>tau_cxx.sh foo.cpp
%>mpirun -np 4 ./a.out

Afterwards we can view the performance data by:

%>pprof