Intel® Trace Analyzer and Collector User and Reference Guide

ID 767272
Date 3/31/2023
Document Table of Contents

Allinea* Distributed Debugging Tool* (DDT*)

Configure the Allinea* Distributed Debugging Tool (DDT) to run a user application with the necessary Intel libraries pre-loaded.

Do the following:

  1. Go to the Run dialog box.

  2. Select the Session/Options menu.

  3. In the Session/Options menu, choose Intel MPI Library and the Submit through queue or configure own mpirun command option.

  4. In the Submit Command box enter without line breaks:

    $ mpirun -genv LD_PRELOAD -genv VT_DEADLOCK_TIMEOUT 20s -genv VT_DEADLOCK_WARNING 25s
    -n NUM_PROCS_TAG DDTPATH_TAG/bin/ddt-debugger
  5. You can leave other boxes empty. Click OK.

  6. To start the application, press the submit button on DDT's job launch dialog box.

  7. When the application is ready, select the Control/Add Breakpoint menu and add a breakpoint at the MessageCheckingBreakpoint function.

  8. Continue to run and debug your application as normal, the program will stop automatically at MessageCheckingBreakpoint when an MPI error is detected.

You can use the parallel stack browser to find the processes that are stopped and select any of these processes. The local variables in this function will identify the error type, the number of errors so far, and the error message.

You can also set a condition on this breakpoint from the Breakpoints tab, or Add Breakpoint menu, for example, to stop only after 20 errors are reported use a condition of reportnumber > 20.