Setup and Validation

Configuring Environment

Once omnitrace is installed, source the setup-env.sh script to prefix the PATH, LD_LIBRARY_PATH, etc. environment variables:

source /opt/omnitrace/share/omnitrace/setup-env.sh

Alternatively, if environment modules are supported, add the <prefix>/share/modulefiles directory to MODULEPATH:

module use /opt/omnitrace/share/modulefiles

Alternatively, the above line can be added to the ${HOME}/.modulerc file.

Once omnitrace is in the MODULEPATH, omnitrace can be loaded via module load omnitrace/<VERSION> and unloaded via module unload omnitrace/<VERSION>, e.g.:

module load omnitrace/1.0.0
module unload omnitrace/1.0.0

You may need to also add the path to the ROCm libraries to LD_LIBRARY_PATH, e.g. export LD_LIBRARY_PATH=/opt/rocm/lib:${LD_LIBRARY_PATH}

Validating Environment Configuration

If all the following commands execute successfully with output, then you are ready to use omnitrace:

which omnitrace
which omnitrace-avail
which omnitrace-sample
omnitrace-instrument --help
omnitrace-avail --all
omnitrace-sample --help

# if built with python support
which omnitrace-python
omnitrace-python --help