TotalView Users Guide - CI Wiki

Debugging Cray XT Applications
The TV::server_launch_string variable is used for both Cray XT3 and Linux x86-64.
This means that if you will also be using this TotalView installation on other linuxx86-64
machines, you should not set the TV::server_launch_string variable in your
global .tvdrc.
Using TotalView
As part of launching an application on a compute node, TotalView will
launch a server program on your login node using ssh. As with any ssh session,
authentication is required. We recommend that you enable ssh without
a pass phrase.
TotalView is typically run interactively. If your site has not designated any
compute nodes for interactive processing, use the PBS Pro qsub -I interactive
mode. This mode is described in the Cray XT3 Programming Environment
User’s Guide.
If TotalView is installed on your system, use the following command to load
it into your user environment:
module load xt-totalview
You can now use the following command to start the CLI:
totalviewcli yod [-a argument_list] application_name
Here’s the command that starts the GUI:
totalviewcli yod [-a argument_list] application_name
The following example shows how you can debug a program named a.out:
% qsub -I -l size=4
qsub: waiting for job 14448.nid00003 to start
qsub: job 14448.nid00003 ready
DISPLAY is user1:0.0
Linux perch 2.4.21-0-sles9-ss-lustre #2 Fri Apr 29
17:14:15 PDT 2005 x86_64 x86_64 x86_64 GNU/Linux
/ufs/home/users/user1
% module load xt-totalview
% cd working_directory
% totalview yod -a -sz 4 a.out
Cray XT CNL
Cray XT CNL applications are similar to those on Cray XT Catamount. The
primary difference is that CNL applications are launched using aprun rather
than yod.
Most, perhaps all, programs are launched using a batch queueing system
such as PBS, Moab, and so on. While this is independent from TotalView,
you will need to do queue up for an interactive session. For example:
qsub -I -sz=size
146 Chapter 7: Setting Up Parallel Debugging Sessions