TotalView Users Guide - CI Wiki

Debugging Sun MPI Applications
mapped memory by default for the xpmem module if Replay is enabled.
The environment variable, MPI_MEMMAP_OFF, is set to 1 in the TotalView
file parallel_support.tvd by adding the variable to the replay_env: specification
as follows: replay_env: MPI_MEMMAP_OFF=1.
If full memory mapping is required, you can set the startup environment
variable in the Startup Parameters dialog window (in the Arguments tab).
Add the following to the environment variables: MPI_MEMMAP_OFF=0.
Be aware that the default mapped memory size may prove to be too large
for ReplayEngine to deal with, and it could be quite slow. You can limit the
size of the mapped heap area by using the MPI_MAPPED_HEAP_SIZE environment
variable documented in the SGI documentation. After turning off
MEMMAP_OFF as described above, you can set the size (in bytes) in the
TotalView startup parameters.
For example:
MPI_MAPPED_HEAP_SIZE=1048576
SGI has a patch for an MPT/XPMEM issue. Without this patch, XPMEM can crash
the system if ReplayEngine is turned on. To get the XPMEM fix for the munmap problem,
either upgrade to ProPack 6 SP 4 or install SGI patch 10570 on top of ProPack 6
SP 3.
Debugging Sun MPI Applications
In many cases, you can bypass the procedure described in this section. For more information,
see “Debugging MPI Programs” on page 98.
TotalView can debug a Sun MPI program and can display Sun MPI message
queues. This section describes how to perform job startup and job attach operations.
To start a Sun MPI application, use the following procedure.
1 Type the following command:
totalview mprun [ totalview_args ] –a [ mpi_args ]
For example:
totalview mprun –g blue –a –np 4 /usr/bin/mpi/conn.x
CLI: totalviewcli mprun [ totalview_args ] –a [ mpi_args ]
When the TotalView Process Window appears, select the Go button.
CLI: dfocus p dgo
TotalView Users Guide: version 8.6 123