Allinea MAP/DDT

Version System A System B System C
22.0 (default) + + +
21.0 + + +
20.0.2 + + +
19.1.3 + + +
19.0.3 + + +
18.0.1 + + +
7.0 + + +

+ ： Available for all users.
AU ： Available for academic users only.
KU ： Available for Kyoto University members only.
― ： Not available.

Modules software package dynamically adjusts the environment settings for using applications, by using the module command. It also makes changing the environment settings easy when switching between different versions of applications. For details, see Modules ．

Version Module File
22.0 allinea_forge/21.0
21.0 allinea_forge/21.0
20.0.2 allinea_forge/20.0.2
19.1.3 allinea_forge/19.1.3
19.0.3 allinea_forge/19.0.3
18.0.1 allinea_forge/18.0.1
7.0 allinea_forge/7.0

You can see the list of module files available by using the module avail command.

Allinea MAP / DDT is a GUI-based powerful profiler / debugger and supports various compiler environments. MAP is a profiler　and DDT is a debugger.

MAP

  • Support for parallel applications
  • Display performance bottleneck at source line level　
  • Intuitive grasp of bottleneck by visual expression　

DDT

  • Support for parallel applications
  • Memory debugging
  • Reverse debugging
  • Debugging by visual representation(program, variables, and MPI interprocess communication)

Set up the environment by using the module command. (The module file you want is loaded.)

$ module load allinea_forge

Then, load the MAP library module by the following command.

module load map-link-static

If you compile your program to be analyzed with dynamic linking, type the following command instead of the above.

module load map-link-dynamic

When you type either command, .map-libs is created in your home directory.

Compile the target program with the debug option.　

Example: Compiling the source program “test.c” with Intel compiler

cc test.c -qopenmp -g -O3

  • Starting settings screen

Execute the following command in Exceed onDemand and the settings screen of MAP will start up. For details of the xrun command, see Interactive processing.

xrun [qsub submittion options] -map  [option][filename [corefile]] [ -a [args]]

Example： analyzes the hybrid parallel behavior (2 processes and 2 threads) of a.out 

xrun -A p=2:t=2:c=2 -map ./a.out

The settings for parallization is already set with the -A option you specified in xrun command. Complete the necessary settings and click on [Run], and the following screen will be displayed and program execution will start.

  • Analysis of program

Execution of the program in the MAP continues until the end of the program. Enter "Stop and Analyze" when stopping halfway. When the program ends or stops halfway, analysis starts and the screen of the analysis result shown below is displayed.

To use MAP from the command line, execute with --profile option. With the -np option, you can specify the process parallel number of the program to be debugged. For other options, see Maker manual.

Example：Execute with tssrun　　　

tssrun -map --profile -np 4

Example：Execute with job script　

*　Contents of the job script

# sample.sh
#!/bin/bash

#QSUB -q gr19999a
#QSUB -ug gr19999
#QSUB -A p=4:t=1:c=1:m=1G
#QSUB -j oe

map --profile -np 4 aprun -n $QSUB_PROCS -d $QSUB_THREADS -N $QSUB_PPN ./a.out
  • submit command of job script 
qsub sample.sh

Set up the environment by using the module command. (The module file you want is loaded.)

$ module load allinea_forge

Compile the target program with the debug option.　

Example: Compiling the source program “test.c” with gcc.

mpicc test.c -o -g -O3

  • Starting welcome screen

Execute the following command in Exceed onDemand and the welcome screen of MAP / DDT will start up. For details of the xrun command, see Interactive processing.

xrun -map  [option][filename [corefile]] [ -a [args]]

Example：

xrun -map ./a.out

  • Analysis of program

If you select "Allinea MAP" -> "Profile" on the welcome screen, the profiler setting dialog opens.

In the Application field, enter the name of the program you want to debug with the full path.

To debug the MPI program, set the parallel number of the target program in the "MPI" and "OpenMP" columns.

Complete the necessary settings and click on [Run], and the following screen will be displayed and program execution will start.

Execution of the program in the MAP continues until the end of the program. Enter "Stop and Analyze" when stopping halfway. When the program ends or stops halfway, analysis starts and the screen of the analysis result shown below is displayed.

To use MAP from the command line, execute with --profile option. With the -np option, you can specify the process parallel number of the program to be debugged. For other options, see Maker manual.

Example：Execute with tssrun　　　

tssrun -map --profile -np 4

Example：Execute with job script　

  • Contents of the job script
# sample.sh
#!/bin/bash

#QSUB -q gr19999b
#QSUB -ug gr19999
#QSUB -A p=4:t=1:c=1:m=1G
#QSUB -j oe

map -np 4 --profile ./a.out
  • submit command of job script 
qsub sample.sh

Set up the environment by using the module command. (The module file you want is loaded.)

$ module load allinea_forge

Compile the target program with the debug option.　

Example: Compiling the source program “test.c” with intel compiler.

cc test.c -o -g -O3

  • Start up of settings screen

Execute the following command in Exceed onDemand and the settings screen of DDT will start up. For details of the xrun command, see Interactive processing.

xrun [qsub submittion options] -ddt  [option][filename [corefile]] [ -a [args]]

Example： debugs the parallel behavior (4 processes) of a.out 

xrun -A p=4:c=1:t=1 -ddt ./a.out
  • Debugging programs

The settings for parallization is already set with the -A option you specified in xrun command. Complete the necessary settings and click　on [Run], and the following screen will be displayed and the program can be debugged.

Set up the environment by using the module command. (The module file you want is loaded.)

$ module load allinea_forge

Compile the target program with the debug option.　

Example: Compiling the source program “test.c” with gcc.(Dynamic link)

mpicc test.c -o -g -O3

  • Start　up of welcome screen　

Execute the following command in Exceed onDemand and the welcome screen of MAP / DDT will start up. For details of the xrun command, see Interactive processing.

xrun -ddt  [option][filename [corefile]] [ -a [args]]

Example：

xrun -ddt ./a.out

  • Debugging programs

If you select "Allinea DDT" -> "Run" on the welcome screen, the debugger setting dialog opens.

In the Application field, enter the name of the program you want to debug with the full path.

To debug the MPI program, set the parallel number of the target program in the "MPI" and "OpenMP" fields.

Complete the necessary settings and click　on [Run], and the following screen will be displayed and the program can be debugged.

Allinea Forge User guide

Arm Forge

Copyright © Academic Center for Computing and Media Studies, Kyoto University, All Rights Reserved.