Debugging and Profiling Tools

Debugging and profiling tools help users inspect application behavior, identify errors, and analyze performance.

Allinea Forge

Pegasus provides Allinea Forge through the allinea module. The module includes the Forge interface, DDT debugger, and MAP profiler.

Check the available versions:

module avail allinea

Load the verified version:

module load allinea/7.0.6

Confirm the loaded module:

module list

Confirm the available commands:

which forge
which ddt
which map

Check the installed version:

forge --version
ddt --version
map --version

All three commands are provided by the same Allinea Forge 7.0.6 installation.

Note

Pegasus does not provide separate forge, ddt, or map module names. Load allinea/7.0.6 to make these commands available.

DDT

DDT is the debugger included with Allinea Forge.

After loading the module:

module load allinea/7.0.6
ddt --version

The verified executable is:

/share/opt/allinea/7.0.6/bin/ddt

MAP

MAP is the profiler included with Allinea Forge.

After loading the module:

module load allinea/7.0.6
map --version

The verified executable is:

/share/opt/allinea/7.0.6/bin/map

Performance Reports

Allinea Performance Reports is provided through a separate module:

module purge
module load allinea/7.0.6-PR

Confirm the executable:

which perf-report

The verified executable is:

/share/opt/allinea/7.0.6-PR/bin/perf-report

Important

allinea/7.0.6 and allinea/7.0.6-PR conflict with each other and should not be loaded at the same time. Purge or unload the current Allinea module before switching between Forge and Performance Reports.

Graphical Tools

Forge, DDT, and MAP provide graphical interfaces.

Caution

Graphical launching, X11 forwarding, remote-client configuration, and license behavior have not yet been verified for the current Pegasus environment. Do not add GUI launch instructions until those workflows are tested.