- Infos im HLRS Wiki sind nicht rechtsverbindlich und ohne Gewähr -
- Information contained in the HLRS Wiki is not legally binding and HLRS is not responsible for any damages that might result from its use -

MpiP: Difference between revisions

From HLRS Platforms
Jump to navigationJump to search
(Initial page describing basics of using the mpiP profiling tool on HLRS systems)
 
Line 20: Line 20:
}}
}}
which will set the '$MPIP_HOME' variable to the latest mpiP installation path.
which will set the '$MPIP_HOME' variable to the latest mpiP installation path.
The tools mpiP needs to be _attached_ to you application through the "LD_PRELOAD" mechanism. On Hawk in most cases it is sufficient to use the provided wrapper script as
{{Command|command= mpirun $MPIP_HOME/../share/trace-mpiP.sh <your_app and options>}}
This will create one or two files with file extension `.mpiP` in the folder. Those files include a consice performance report (`*.1.mpiP`) and an extensive performance report (`*.2.mpiP`), respectively.


The behaviour of mpiP is controlled by options provided via the `MPIP` environment variable.
The behaviour of mpiP is controlled by options provided via the `MPIP` environment variable.
See the mpiP documentation for a detailed description of all options.
See the mpiP documentation for a detailed description of all options. The wrapper on Hawk sets sensible defaults already. You may copy the wrapper script and adapt it to your needs if necessary.
 
A good starting point is the following:
 
{{Command|command=export MPIP="-t 10.0 -k 2"}}
 
Finally run your application with the mpiP profiling library preloaded:
 
{{Command|command=LD_PRELOAD=$MPIP_HOME/lib/libmpiP.so mpirun <your_app and options>}}
 
This will create a single file with file extension `.mpiP` in the folder including the profiling data.


== See also ==
== See also ==

Revision as of 16:43, 16 March 2023

The mpiP library is a light-weight profiling library for MPI applications.

To record an MPI profile, simply run the program with the mpiP library preloaded.

Developer: LLNL
Platforms: Hazel Hen
Category: Performance Analyzer
License: BSD
Website: mpiP homepage


Note, this page is outdated

Introduction

Usage

First load the related software module

module load mpip

which will set the '$MPIP_HOME' variable to the latest mpiP installation path.

The tools mpiP needs to be _attached_ to you application through the "LD_PRELOAD" mechanism. On Hawk in most cases it is sufficient to use the provided wrapper script as

mpirun $MPIP_HOME/../share/trace-mpiP.sh <your_app and options>

This will create one or two files with file extension `.mpiP` in the folder. Those files include a consice performance report (`*.1.mpiP`) and an extensive performance report (`*.2.mpiP`), respectively.

The behaviour of mpiP is controlled by options provided via the `MPIP` environment variable. See the mpiP documentation for a detailed description of all options. The wrapper on Hawk sets sensible defaults already. You may copy the wrapper script and adapt it to your needs if necessary.

See also

External Links