DDT and MAP

 

DDT is a debugger for C, C++ and Fortran 90 threaded and parallel codes, produced by Arm.  MAP is a scalable, low-overhead profiler for C, C++ and Fortran programs.  Both DDT and MAP are included in ARM Forge.

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

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

Documentation

Usage on Bridges

You must have a Forge client installed on your local machine. Be sure to get the latest client from Arm using the link below.

Uninstall old versions of the Forge client

If you have an older version of the Forge client installed, you must uninstall it before installing the new one.  Be sure the configuration files are removed also. Old configuration files are not overwritten when a new client is installed.  On a Windows system, the configuration files are stored by default in a folder under the Program Files folder.

Install and configure the client

The client and server versions of Forge must match.  Determine the version of the Forge server on Bridges by typing module avail ddt. The output shows that the current version is 19.0.

[user@br018]$ module avail ddt

------------------------- /opt/modulefiles --------------------------
ddt/19.0       

To install the Forge client, follow these steps:

  1. Download the appropriate client for your local machine from https://developer.arm.com/products/software-development-tools/hpc/downloads/download-arm-forge
  2. Run the installer.  When it completes successfully, start up the Forge 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, use /opt/packages/arm/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.

 

Running on Bridges 

When you have the Forge client installed and configured on your local machine, follow these steps to run DDT or MAP on Bridges:

  1. Open a connection from your Forge client to Bridges by starting the Forge 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.  When the connection is made successfully, you will see “Licence Serial: 10028” in the lower left of the Forge client window,  meaning it found the license and is talking to the server on Bridges.  This may take a minute to happen.

  2. Choose to use DDT or MAP from the left side of the window. 
  3. Run and debug or profile your executable.
    1. For DDT, click on RUN  to run and debug your program.    For MAP, click on PROFILE to profile your program.  A  Run (queue submission mode) window opens.
    2. Enter the path to your executable in the Application input field.   Note that it must already be compiled.

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

    3. Set the queue parameters. The first time you use DDT or MAP, you must configure the queue submissions. Check the box next to Submit to queue. 
      1. In the Submit to queue row, select the Configure tab. 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 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. In the Submit to queue row, select  the Parameters tab.  In the Queue parameters window that opens, set the queue name to be one of RM, RM-small, LM, or GPU.  You can also change the clock time limit if you choose. Click OK when done. The Queue parameters window will close.
    4. For MAP, choose which ranks to profile by checking the box next to Profile selected ranks.
    5. Click Submit in the Run (queue submission mode) window.

      A debugging or profiling 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. When resources are available your job will begin, and you can debug or profile your program.

 

 

 

User Information

Passwords
Connect to PSC systems:
Policies
Technical questions:

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