derek.holloway
7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
78 lines
1.9 KiB
ReStructuredText
78 lines
1.9 KiB
ReStructuredText
.. meta::
|
|
:description: AQLprofile installation process
|
|
:keywords: AQLprofile, ROCm, install
|
|
|
|
******************
|
|
Install AQLprofile
|
|
******************
|
|
|
|
Learn how to build AQLprofile with a script or with CMake, then install the library with a command.
|
|
|
|
Prerequisites
|
|
=============
|
|
|
|
Before you begin, ensure these tools and dependencies are installed:
|
|
|
|
* ROCm stack
|
|
* ``rocm-llvm-dev`` (required to build tests)
|
|
|
|
|
|
Build AQLprofile
|
|
================
|
|
|
|
You can build AQLprofile using either the provided build script (recommended for most users) or by manually invoking CMake for custom builds.
|
|
|
|
|
|
Option 1: Use the build script (Recommended)
|
|
--------------------------------------------
|
|
|
|
This configures and builds the project with the default settings:
|
|
|
|
.. code:: bash
|
|
|
|
./build.sh
|
|
|
|
|
|
Option 2: Use CMake for custom builds
|
|
-------------------------------------
|
|
|
|
For more control over the build process, you can set the CMake options manually:
|
|
|
|
.. code:: bash
|
|
|
|
# Set the CMAKE_PREFIX_PATH to point to hsa-runtime includes path and hsa-runtime library path
|
|
export CMAKE_PREFIX_PATH=<path to hsa-runtime includes>:<path to hsa-runtime library>
|
|
# For example, if ROCm is installed at /opt/rocm:
|
|
# export CMAKE_PREFIX_PATH=/opt/rocm/lib:/opt/rocm/include/hsa
|
|
|
|
export CMAKE_BUILD_TYPE=<debug|release> # release by default
|
|
|
|
cd /path/to/aqlprofile
|
|
mkdir build
|
|
cd build
|
|
cmake ..
|
|
make -j
|
|
|
|
|
|
Enable debug tracing (Optional)
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
To enable debug tracing, set this environment variable before running CMake:
|
|
|
|
.. code:: bash
|
|
|
|
export CMAKE_DEBUG_TRACE=1
|
|
|
|
This enables verbose debug output of the command packets while this library executes.
|
|
|
|
|
|
Install the AQLprofile libraries
|
|
================================
|
|
|
|
Once your build is successful, install the AQLprofile libraries with:
|
|
|
|
.. code:: bash
|
|
|
|
cd build
|
|
sudo make install
|