User Guide

  • 2022.2
  • 08/08/2022
  • Public Content

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
    dialog box.
  2. Select the
  3. In the
    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
  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
  8. Continue to run and debug your application as normal, the program will stop automatically at
    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

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at