Totalview

Category: Tools-Debugger

Description

The TotalView debugger is a tool that lets you debug, analyze, and tune the performance of complex serial, multiprocessor, and multithreaded programs. It can be executed either as a GUI (by using the totalview executable) or from a command-line interface (by using the totalviewcli executable).

Since the TotalView GUI is an X-Window application, your system must be set up to allow and run X11 traffic. It is best to tunnel the X11 traffic through the SSH connection. To do this, your SSH connection needs to allow X11 forwarding. This can be accomplished by adding the line ForwardX11 yes to your SSH config file or by using the -X option to SSH.

Use

Load an appropriate TotalView module. For example,

module load totalview

TotalView can be used in a number of ways. To debug an existing core file (and not a currently running parallel process), you can launch TotalView with the command:

totalview a.out core

If you want to use TotalView to start your job and monitor it as it runs, you must take some additional steps. Because parallel jobs cannot be launched directly from the login nodes, you will need to launch TotalView from within a batch job. The easiest way to do this is to start an interactive batch job as follows:

qsub -I -lsize=32,walltime=1:00:00 -A ABC123 -V -qdebug
Make sure to use -V as an option to qsub because it will import your current environment (including the DISPLAY variable for the X-Window connection).

Once your job starts, you can launch TotalView from the command line. The following example starts TotalView on 32 compute cores:

totalview aprun -a -n32 ./a.out

It is also possible to connect to an already-running job. To do this, you need to:

For more information, see the documentation on the TotalView Technologies website.

Support

This package has the following support level : Supported

Available Versions

Version Available Builds
pgi gnu pathscale Other
8.6.0-1
v