Configuring and validating the environment

Configuring and validating the environment#

After installing ROCm Systems Profiler, additional steps are required to set up and validate the environment.

Note

The following instructions use the installation path /opt/rocprofiler-systems. If ROCm Systems Profiler is installed elsewhere, substitute the actual installation path.

Configuring the environment#

After ROCm Systems Profiler is installed, source the setup-env.sh script to prefix the PATH, LD_LIBRARY_PATH, and other environment variables:

source /opt/rocprofiler-systems/share/rocprofiler-systems/setup-env.sh

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

module use /opt/rocprofiler-systems/share/modulefiles

Note

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

After ROCm Systems Profiler has been added to the MODULEPATH, it can be loaded using module load rocprofiler-systems/<VERSION> and unloaded using module unload rocprofiler-systems/<VERSION>.

module load rocprofiler-systems/1.0.0
module unload rocprofiler-systems/1.0.0

Note

You might also need to add the path to the ROCm libraries to LD_LIBRARY_PATH, for example, export LD_LIBRARY_PATH=/opt/rocm/lib:${LD_LIBRARY_PATH}

Validating the environment configuration#

If the following commands all run successfully with the expected output, then you are ready to use ROCm Systems Profiler:

which rocprof-sys
which rocprof-sys-avail
which rocprof-sys-sample
rocprof-sys-instrument --help
rocprof-sys-avail --all
rocprof-sys-sample --help

If ROCm Systems Profiler was built with Python support, validate these additional commands:

which rocprof-sys-python
rocprof-sys-python --help
Contents