Totalview® User Guide : PART IV Advanced Tools and Customization : Chapter 20 Setting Up Parallel Debugging Sessions : Debugging Cray XT Applications : Cray XT Catamount : Using TotalView with your Cray XT System
Using TotalView with your Cray XT System
As part of launching an application on a compute node, TotalView launches 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 typically runs 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