Installing ROCprofiler-SDK#
This document provides information required to install ROCprofiler-SDK from source.
Supported systems#
ROCprofiler-SDK is supported on the Linux distributions specified in the system requirements.
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 --no-checkout --filter=blob:none https://github.com/ROCm/rocm-systems.git
cd rocm-systems
git sparse-checkout init --cone
git sparse-checkout set projects/rocprofiler-sdk
git checkout develop
cmake \
-B rocprofiler-sdk-build \
-DCMAKE_INSTALL_PREFIX=/opt/rocm \
-DCMAKE_PREFIX_PATH=/opt/rocm \
projects/rocprofiler-sdk
cmake --build rocprofiler-sdk-build --target all --parallel $(nproc)
Installing ROCprofiler-SDK#
To install ROCprofiler-SDK from the rocprofiler-sdk-build directory, run:
cmake --build rocprofiler-sdk-build --target install
Testing ROCprofiler-SDK#
To run the built tests, cd into the rocprofiler-sdk-build directory and run:
ctest --output-on-failure -O ctest.all.log
/usr/local/bin/python -m pip install -r requirements.txt
Install using package manager#
If you have ROCm version 6.2 or later installed, you can use the package manager to install a prebuilt copy of ROCprofiler-SDK.
$ sudo apt install rocprofiler-sdk
$ sudo dnf install rocprofiler-sdk