Debugging Tools

Steps to debug GEOSldas using applications such as Totalview or DDT :

1. Compile GEOSldas for debugging: parallel_build.csh -debug. This will build GEOSldas in ./build-Debug/ and install into ./install-Debug/.

2. Follow the README.md instructions to set up and run the experiment except for the final step (i.e., do not run sbatch lenkf.j). Instead, execute lenkf.j -debug, which will complete some preprocessing and then stop at the point where GEOSldas.x would normally be run.

3. Launch the debugging tool, e.g., totalview [PATH]/GEOSldas.x, using the GEOSldas.x executable from the -debug install directory of step 1.

4. Configure the debugger options, e.g., select the MPI stack that is encoded in the ./install-Debug/bin/g5_modules script.

NCCS Users:

Use the "module" command to "load" a recent version of the available debugging tools.

To use debugging tools at NCCS, you need to be on an interactive compute node, which can be obtained with the following command:

xalloc --ntasks=28 --time=01:00:00 --account=[NCCS_COMPUTATIONAL_PROJECT_NUMBER]

Configure the debugging run following the instructions for MPI. (See item 4 above.)

Note: Debuggers may run out of licenses if too many processors are used; 28 processors are recommended.