AllineaMAPbanner

Configure and run MAP profiler using a Graphical User Interface

After you launched MAP in Pegasus2 interactive queue, or from a remote client and established connection with the cluster, choose the “Allinea MAP” from the “Available Tools” menu in the bottom of the welcome screen.


MAP1

 

If you have already ran the MAP using command-line options and created your profile file, choose “Load Profile Data File”, and choose your *.map file to view. No further configuration is needed.

If you launch MAP to run and profile your program, proceed with “Profile” (“Profile a program“):

  • In the next window, “Run (queue submission mode)”, choose the program name and location, program arguments (if needed), input file (if needed), working directory on Pegasus2 cluster, number of processors, and check the “MPI” box for your parallel job.MAP2
  • Check “Submit to Queue” option.
  • Set the environmental variable MAP_MPI_WRAPPER depending on the MPI implementation.
    If you are using Intel MPI impi, set

    MAP_MPI_WRAPPER=/share/opt/allinea/wrapper/libmap-sampler-MAP-IMPI.so

    If you are using openmpi/1.7.5 with Intel ifort and icc compilers, set

    MAP_MPI_WRAPPER=/share/opt/allinea/wrapper/libmap-sampler-MAP-openmpi_1.7.5.so 
  • In “Implementation” choose “Change” to further customize the launch MAP options. The software will attempt to guess the MPI implementation you used to compile your program; verify that this is correct:MAP3

 

  • Proceed to the second item in the menu on the left-hand-side, “Job Submission“, and provide the submission template file lsf.qtf (as shown), specify number of processes, and processes per node, as follows:MAP4
    You may modify the submission template file lsf.qtf as needed, save it to your location and provide it in the “Job Submission options. Refer to the User’s Guide, Chapters 24.2 – 24.3 and Appendix F. Queue Template Script Syntax.

 

  • Modify the Queue parameters as needed:MAP5

 

  • Click “OK“, and “Submit” in “Run (queue submission mode)” window. Wait for the job to enter the queue, processes to connect, and job to run and finish. Examine your run. Check your profiling data and statistics: choose metrics to view, input/output, timing in specific routines or execution commands, etc. (see User’s Guide Chapters 18-22 or explore on your own):MAP6

 

  • You could also view “Input/Output”, “Project Files”, “Parallel Stack View” in a separate window by undocking them from the main window:MAP7

Happy profiling!

Debugging and Profiling with AllineaTools

DDT – Distributed Debugging Tool

MAP – MPI Profiling

PerformanceReports – MPI profiling summary

MAP: configure and run

AllineaTools (DDT + MAP) User’s Guide. Version 4.2.1-37994

HPC Documentation

HPC Home