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.