TotalView

TotalView is a source- and machine-level debugger with support for Fortran, C, C++, OpenMP, MPI, and threads.

Installed on: Pople and BigBen.

Pople version

Usage

1. Compile your code using the -g option. Instructions for the various compilers are found in the pople document.


2. Start an interactive job. Be sure to set up an X-11 connection when you start the interactive job.

   qsub -X -I -l ncpus=x -l walltime=xx:xx -q debug

3. Load the Totalview module.

   module load totalview

4. Start Totalview.

   totalview ./executable

BigBen version 7.1.0

Our TotalView license allows for 3 concurrent TotalView users. Two of those users can use up to 4 processors, and the third can use up to 32 processors.

Usage

1. Make sure that you have an X-server running on your machine. Then login to bigben using ssh, having turned on X-forwarding and allowed multiple X windows to appear on your machine.


2. Compile your code with the -g and the -O0 options.

   ftn -o hellompi -g -O0 hellompi.f90
   

3. Decide how many processors you need.

   The default is to allow up to 4 processors. If you want to use more than 4, you must change this setting. To do this, use TotalView to edit your ~/.totalview/preferences6.tvd file. Follow these steps:

   % module load totalview
   % totalview
   

   Click on the "Cancel" button in the "New Program" window. In the "Etnus TotalView ..." window, select File->Preferences. In the "Preferences" window that pops up, click on the "Launch Strings" tab. Edit the "Command" string. The default is

   %C %R -n "%B/tvdsvr%K -working_directory %D -callback %L -set_pw %P
   -verbosity %V %F -nodes_allowed 4"
   

   Change it to:

   %C %R -n "%B/tvdsvr%K -working_directory %D -callback %L -set_pw %P 
   -verbosity %V %F -nodes_allowed 32"
   

   Click "OK" in the Preferences window and then exit TotalView.



4. Start an interactive job.

   qsub -I -l size=numprocs -l walltime=walltime
   

5. When you get an interactive prompt, set your DISPLAY variable:

   setenv DISPLAY $PBS_O_DISPLAY
   

6. Load the TotalView module.

   module load totalview
   

7. Start TotalView.

   totalview yod -a ./hellompi
   

   If you want to pass other arguments to yod, put them after the -a option.

8. When the TotalView window titled "yod" appears, click on the "Go" button (the button with the green arrow). When asked "Process yod is a parallel job. Do you want to stop the job now?" click "Yes". If you are asked in your terminal's stdout output if you want to continue connecting, answer "Yes". You will then be able to set breakpoints in your program.

See also:

• Other TotalView documentation is available at the Etnus Web site.
• Other software installed at PSC.
• Other installed at PSC.