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

This a basic configuration of TAU, there are many more options. TAU 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. 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 -c foo.cpp -o foo.o
%> tau_cxx.sh foo.o -o foo
%> mpirun -np 4 ./foo

If you run into any linker errors make sure that TAU is being built with the same compilers as your mpi implementation. Use the

Afterwards we can view the performance data by using pprof:

%> pprof