Allinea: DDT

Starting Allinea DDT

Allinea DDT can be started both locally, inside the cluster, and remotely, from a laptop or PC.

• Starting locally

1. Connect to server with X forwarding enabled (ssh -X).
2. Go in Allinea DDT installation path and run ./ddt (/cm/local/allinea/bin/ for the Boston head node).

• Starting remotely

1. Download Allinea tools from their website (http://www.allinea.com/products/downloads/download-allinea-ddt-and-allinea-map).
2. Untar and run the installer file.
3. Open Allinea DDT and at the Remote Launch menu open the settings and enter the hostname (username@ip_address) and the Allinea installation directory on the server.
4. (Optional) Test the connection by pressing the Test Remote Launch button. (Might be prompted to provide the password, in order to connect to the server). If everything works out, the message "Remote Launch test completed successfully." will appear at the top left corner of the testing window.
5. Press Ok and it will be ready to use.

Type of application

In order to start a debugging job for a (parallel) application:

1. Press the Run button. In the next window:
2. Fill the "Äpplication" field with the exact path of the executable to be run
   • If the application needs command line arguments or stdin input, these can be provided in the "Arguments" and "stdin file" fields, respectively.

MPI applications

1. Provide the number of processes
2. Define MPI implementation. In order to do that:
   • Click the "Change" button
   • Choose between different MPI libraries
   • Define the exact path, on the server, of the mpirun command of the chosen MPI library
   • Click Ok
3. Click Run

Different MPI libraries need different settings. First of all be sure that the application is compiled with the mpicc command of the corresponding library.

• OpenMPI 1.8.1 compiled with Intel compiler: Load the intel/compiler/64/14.0/2013_sp1.3.174 module from the same terminal as DDT is run, otherwise an error message will appear stating that the libimf.so shared library cannot be found.
• OpenMPI 1.8.1 compiled with GCC: Just follow the above steps. No other changes must be made.
• MVAPICH2 2.0b compiled with Intel compiler: Load the mvapich2/intel/63/2.0b and intel/compiler/64/14.0/2013_sp1.3.174 modules from the same terminal as DDT is run, otherwise missing shared libraries error messages will appear.
• MVAPICH2 2.0b compiled with GCC: Load the mvapich2/intel/63/2.0b module from the same terminal as DDT is run.
• Intel MPI 4.1.3: Load the intel/compiler/64/14.0/2013_sp1.3.174 and intel-mpi/64/4.1.3/049 modules from the same terminal as DDT is run.
• MPICH 3.1 compiled with GCC: Load the mpich/ge/gcc/64/3.1 module from the same terminal as DDT is run.

Debug the application

After DDT starts the application, all the processes/threads will stop at the first statement of the main function.

Running steps

There are several ways to continue with the application workflow:

• Play/Continue
  Error creating thumbnail: File missing
   : Run the application until the end or until it reaches a breakpoint.
• Step into
  Error creating thumbnail: File missing
   : Step to the next command in the code.
• Step over
  Error creating thumbnail: File missing
   : Step to the next command in the current function (does not enter called functions).
• Step out
  Error creating thumbnail: File missing
   : Step out of the current function (does not work for main).
• Run to line
  Error creating thumbnail: File missing
   : Run the application until it reaches a given line number.

The application can be paused at any point by pressing the Pause button.

Breakpoints

To set a breakpoint, either press the Add Breakpoint button (

Error creating thumbnail: File missing

), which will open an Edit Breakpoint window, or press the white dot on the left of the required line. After the breakpoint is set, a red dot will appear on the left of the corresponding line.

All the breakpoints can be seen in the Breakpoints tab, on the bottom left corner of the window. To edit the settings of a breakpoint, either right clock on it and click edit (from within the Breakpoints tab) or directly edit its settings, changing the values of the corresponding columns.

Variables

The variable tabs can be seen on the right side of the window.

• The Locals tab includes all the local variables of the current function, along with their values.
• The Current Line tab includes all the variables of the current code line, along with their values.
• To constantly view the value of a variable, right click on it and press Add to Evaluations. It will then appear in the Evaluation tab, on the bottom right corner of the window and its value will automatically change as the application goes on.
• A watchpoint can be added to any variable, by right clicking on it and pressing Add Watchpoint. It will then appear in the Watchpoints tab, on the bottom left part of the window, and every time the value of that variable changes a notification will appear on the screen.