Installing ROCprofiler-SDK

Installing ROCprofiler-SDK#

This document provides information required to install ROCprofiler-SDK from source.

Supported systems#

ROCprofiler-SDK is supported only on Linux. The following distributions are tested:

Ubuntu 20.04
Ubuntu 22.04
Ubuntu 24.04
OpenSUSE 15.5
OpenSUSE 15.6
Red Hat 8.8
Red Hat 8.9
Red Hat 8.10
Red Hat 9.2
Red Hat 9.3
Red Hat 9.4

ROCprofiler-SDK might operate as expected on other Linux distributions, but has not been tested.

Identifying the operating system#

To identify the Linux distribution and version, see the /etc/os-release and /usr/lib/os-release files:

$ cat /etc/os-release
NAME="Ubuntu"
VERSION="20.04.4 LTS (Focal Fossa)"
ID=ubuntu
...
VERSION_ID="20.04"
...

The relevant fields are ID and the VERSION_ID.

Build requirements#

To build ROCprofiler-SDK, install CMake as explained in the following section.

Install CMake#

Install CMake version 3.21 (or later).

Note

If the CMake installed on the system is too old, you can install a new version using various methods. One of the easiest options is to use PyPi (Python’s pip).

/usr/local/bin/python -m pip install --user 'cmake==3.22.0'
export PATH=${HOME}/.local/bin:${PATH}

Building ROCprofiler-SDK from source#

git clone https://github.com/ROCm/rocprofiler-sdk.git rocprofiler-sdk-source
cmake                                         \
    -B rocprofiler-sdk-build                \
    -D ROCPROFILER_BUILD_TESTS=ON           \
    -D ROCPROFILER_BUILD_SAMPLES=ON         \
    -D CMAKE_INSTALL_PREFIX=/opt/rocm       \
    rocprofiler-sdk-source

cmake --build rocprofiler-sdk-build --target all --parallel 8