Difference between revisions of "GettingStarted"

From Tau Wiki
Jump to: navigation, search
(Getting started with TAU)
(Getting started with TAU)
Line 4: Line 4:
  
 
<pre>
 
<pre>
%>tar -xzf pdtoolkit-3.11
+
%> tar -xzf pdtoolkit-3.11
%>cd pdtoolkit
+
%> cd pdtoolkit
%>./configure
+
%> ./configure
%>make all install
+
%> make all install
%>cd ..
+
%> cd ..
%>tar -xzf tau2.16.5
+
%> tar -xzf tau2.16.5
%>cd tau2
+
%> cd tau2
%>./configure -pdt=[PDT directory] -mpiinc=[MPI include] -mpilib=[MPI library]
+
%> ./configure -pdt=[PDT directory] -mpiinc=[MPI include] -mpilib=[MPI library]
%>make clean install
+
%> make clean install
 
</pre>
 
</pre>
  
Line 18: Line 18:
  
 
<pre>
 
<pre>
%>export PATH=[path to tau2]/tau2/x86_64/bin:$PATH
+
%> export PATH=[path to tau2]/tau2/x86_64/bin:$PATH
 
</pre>
 
</pre>
  
Line 24: Line 24:
  
 
<pre>
 
<pre>
%>export TAU_MAKEFILE=[path to tau2]/tau2/x86_64/lib/Makefile.tau-mpi-pdt
+
%> export TAU_MAKEFILE=[path to tau2]/tau2/x86_64/lib/Makefile.tau-mpi-pdt
%>tau_cxx.sh foo.cpp
+
%> tau_cxx.sh foo.cpp
%>mpirun -np 4 ./a.out
+
%> mpirun -np 4 ./a.out
 
</pre>
 
</pre>
  
 
Afterwards we can view the performance data by:
 
Afterwards we can view the performance data by:
 
<pre>
 
<pre>
%>pprof
+
%> pprof
 
</pre>
 
</pre>

Revision as of 23:00, 20 September 2007

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