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/8.4.0-0

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 -lnodes=8:ppn=4,walltime=1:00:00 -A ABC123 -X -qdebug
The -X option is required, as it tells PBS to forward any X11 traffic from the compute nodes back to the login node. The X11 traffic will then be forwarded from the login node across your ssh connection to your workstation.

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

totalview mpirun -a -np 32 ./a.out

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 Other
8.6.0-2
v