|
Using the Totalview Debugger at NERSCIntroductionThe Totalview is an X Windows-based graphical parallel debugger. Typically a code is compiled for debugging by adding the -g compiler option when building a code. The code can then be run under totalview to step through the program, set break points, examine variables, etc., while viewing the source code. Totalview can also be used to examine core files and attach to running programs. TotalView DocumentationTotalview Technologies provides a documentation web site. Additional instructions specific to NERSC platforms are described below. Hopper and FranklinNERSC has a license to debug applications using up to 512 cores on Hopper and Franklin. If you need to debug an application on more than 512 cores please email the consultants at consult@nersc.gov.
BassiFirst load the totalview module: % module load totalview The first time you load the module an SSH key will be automatically created; this may take up to a minute or so. The key is used internally to launch totalview on batch nodes. Serial codesA serial code with an executable named program.x can be debugged with the following command. % totalview ./program.x <-a optional program args> Parallel programsParallel programs can be debugged interactively using the command line: % totalview poe -a ./program.x <optional program args> -nodes num_nodes -tasks num_tasks Once totalview starts, click on "Go" and totalview will tell you that "poe" is a parallel job and ask if you want to stop the parallel program. Answer "Yes" and you will be positioned at the beginning of your code. You can then set break points, etc. Refer to the Totalview Technologies documentation web site to learn how to use totalview. Batch scriptsYou can also run totalview in a batch script. Assuming you have used SSH to connect to Bassi and enabled X authentication forwarding (often the default, otherwise enabled with the -X flag on most UNIX systems), the totalview window will open on your display once the batch jobs starts. Obviously, this is not useful if you submit to a batch queue that has a long wait time (and unpredictable start time). LicensesThe license for Bassi supports debugging parallel codes using up to 64 tasks. JacquardPlease see the Jacquard totalview page. LicensesTotalview on Jacquard supports debugging parallel programs using up to 32 tasks. |
![]() |
Page last modified: Fri, 05 Feb 2010 01:25:30 GMT Page URL: http://www.nersc.gov/nusers/systems/franklin/software/totalview.php Web contact: webmaster@nersc.gov Computing questions: consult@nersc.gov Privacy and Security Notice |
![]() |