DDT is a debugger for C, C++ and Fortran 90 threaded and parallel codes.

DDT's GUI runs on Bridges.  To use it, you must first install and configure the Allinea DDT client on your local machine.   Once the client is installed and configured, you can run DDT on Bridges.

No matter which compiler you use, you must compile your code with the -g option to produce debug information.  



Usage on Bridges

Install and configure the Allinea DDT client

  1. Download the appropriate client for your local machine from http://www.allinea.com/developer-tools/debug-allinea-ddt/download#remote-client.  
  2. Run the installer.  When it completes successfully, start up the Allinea DDT client on your local machine.
  3. Under Options, from the Remote Launch drop-down menu select Configure.  

    A Configure Remote Connections window opens.

  4. Choose Add.

    A Remote Launch Settings window will open.

  5. Enter these settings:
    • For Host Name: your-username@bridges.psc.edu
    • For Remote Installation Directory:
      • For DDT version 7.0, enter /opt/packages/allinea-7.0/forge
      • For DDT version 6.0.2, enter /opt/packages/allinea/forge

    Click OK.  The Remote Launch Settings window will close.

  6. In the Configure Remote Connections window, click Close.

    The  Remote Launch drop-down menu will now have a connection named your-username@bridges.psc.edu.

Configure your Bridges environment

You must have the DDT module loaded for you automatically on login. Otherwise, the Allinea client will fail.

To do this, edit your .bashrc file (if you use bash) or your .cshrc file (if you use csh) and add this line:

module load ddt

This will load the default DDT module. You can see all versions of DDT available by typing

module avail ddt

See more on modules for information on loading non-default versions of DDT.


Running DDT on Bridges 

When you have the Allinea DDT client installed and configured on your local machine, and have set configured your Bridges environment to load the DDT module for you automatically, follow these steps to run DDT on Bridges:

  1. Open a connection from your Allinea DDT client to Bridges

    Start the Allinea DDT client on your local machine.

    1. From the remote Launch drop-down, select the connection for your-usename@bridges.psc.edu.  A Connect to Remote Host window will open.
    2. Enter your PSC password when prompted.

      The Connect to Remote Host window will close.  If the connection is successful, you will see “Licence Serial: 10028” in the lower left of the Allinea DDT client window,  meaning it found the license and is talking to the server on Bridges.

  2. Run and debug your executable.
    1. Click on RUN  to run and debug your program.  A window labeled "Run (queue submission mode)" pops up.
    2. Enter the path to your executable in the Application input field.   Note that it must already be compiled; DDT will not compile it for  you.

      DDT should automatically detect if you are using MPI, OpenMP, CUDA, and fill in some details for you.

    3. Set the queue parameters.

      Click Submit to queue

      The first time you use Allinea DDT, you must configure the queue submissions.

      1. Click Configure, and in the Job Submission Settings window that opens click on the file folder icon in the template file input field.

        In the Choose Queue Template File window that opens, choose the template file 'slurm.qtf'. Click Open and the Choose Queue Template window closes; click OK in the Job Submission Settings window and it will close.

      2. Click Parameters and set the queue name to be one of RM, LM or GPU.  You can also change the clock time limit if you choose.

      You can change the queue configuration for any subsequent job.

    4. Click Submit in the Run (queue submission mode) window.

      A debugging window will open. If there are not enough resources available to run your job, a window showing the partition and your job in it will open. Once your job begins, you can debug your program.


User Information

Connect to PSC systems:
Technical questions:

Send mail to remarks@psc.edu or call the PSC hotline: 412-268-6350.