Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,22 +9,22 @@

version = "1.0.0"
rocm_version = '7.0'
rocm_directory_version = '7.0.1' # in 6.0 rocm was located in /opt/rocm-6.0.0
amdgpu_version = '7.0.1' # directory in https://repo.radeon.com/rocm/apt/ and https://repo.radeon.com/amdgpu-install/
amdgpu_url_version = '30.10.1'
rocm_directory_version = '7.0.2' # in 6.0 rocm was located in /opt/rocm-6.0.0
amdgpu_version = '7.0.2' # directory in https://repo.radeon.com/rocm/apt/ and https://repo.radeon.com/amdgpu-install/
amdgpu_url_version = '30.10.2'
release = version
html_title = project
author = "Advanced Micro Devices, Inc."
copyright = "Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved."

# Supported linux version numbers
ubuntu_version_numbers = [('24.04', 'noble'), ('22.04', 'jammy')]
debian_version_numbers = [('12', 'jammy')]
rhel_release_version_numbers = ['9', '8']
rhel_version_numbers = ['9.6', '9.4', '8.10']
debian_version_numbers = [('13', 'noble'), ('12', 'jammy')]
rhel_release_version_numbers = ['10', '9', '8']
rhel_version_numbers = ['10.0', '9.6', '9.4', '8.10']
sles_version_numbers = ['15.7']
ol_release_version_numbers = ['9', '8']
ol_version_numbers = ['9.6', '8.10']
ol_release_version_numbers = ['10', '9', '8']
ol_version_numbers = ['10.0', '9.6', '8.10']
azl_version_numbers = ['3.0']
rl_version_numbers = ['9.6']

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,10 +32,10 @@ Register kernel-mode driver
sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
{% if os_major == '10' -%}
baseurl=https://repo.radeon.com/amdgpu/|amdgpu_url_version|/el/{{ os_major }}/main/x86_64/
{%- else -%}
{% if os_major == '9' -%}
baseurl=https://repo.radeon.com/amdgpu/|amdgpu_url_version|/el/{{ os_version }}/main/x86_64/
{%- else -%}
baseurl=https://repo.radeon.com/amdgpu/|amdgpu_url_version|/el/{{ os_major }}/main/x86_64/
{%- endif %}
enabled=1
priority=50
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,10 +32,10 @@ Register kernel-mode driver
sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
{% if os_major == '10' -%}
baseurl=https://repo.radeon.com/amdgpu/|amdgpu_url_version|/el/{{ os_major }}/main/x86_64/
{%- else -%}
{% if os_major == '9' -%}
baseurl=https://repo.radeon.com/amdgpu/|amdgpu_url_version|/el/{{ os_version }}/main/x86_64/
{%- else -%}
baseurl=https://repo.radeon.com/amdgpu/|amdgpu_url_version|/el/{{ os_major }}/main/x86_64/
{%- endif %}
enabled=1
priority=50
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ Add the amdgpu repository for the driver.
:substitutions:

sudo tee /etc/apt/sources.list.d/amdgpu.list << EOF
deb [arch=amd64,i386 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/|amdgpu_url_version|/ubuntu {{ os_release }} main
deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/|amdgpu_url_version|/ubuntu {{ os_release }} main
EOF
sudo apt update
{% endfor %}
Expand Down
89 changes: 80 additions & 9 deletions docs/install/detailed-install/post-install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -21,54 +21,125 @@ Use the following command to check the installation of the AMD GPU Driver (amdgp

sudo dkms status

**Sample output for Ubuntu 24.04:**

.. code-block:: bash

amdgpu/6.14.14-2222715.24.04, 6.14.0-32-generic, x86_64: installed

- ``amdgpu``: dkms module name
- ``6.14.14``: amdgpu driver version
- ``2222715``: amdgpu driver build number
- ``24.04``: distro version
- ``6.14.0-32-generic``: kernel version of dkms build
- ``installed``: dkms status; ``installed`` indicates successful installation of the amdgpu driver

.. tab-item:: Debian

.. code-block:: bash

sudo dkms status

**Sample output for Debian 12:**

.. code-block:: bash

amdgpu/6.14.14-2222715.22.04, 6.1.0-40-amd64, x86_64: installed

- ``amdgpu``: dkms module name
- ``6.14.14``: amdgpu driver version
- ``2222715``: amdgpu driver build number
- ``6.1.0-40-amd64``: kernel version of dkms build
- ``installed``: dkms status; ``installed`` indicates successful installation of the amdgpu driver

.. tab-item:: RHEL

.. code-block:: bash

sudo dkms status

**Sample output for RHEL 10.0:**

.. code-block:: bash

amdgpu/6.14.14-2222715.el10, 6.12.0-55.34.1.el10_0.x86_64, x86_64: installed (Original modules exist)

- ``amdgpu``: dkms module name
- ``6.14.14``: amdgpu driver version
- ``2222715``: amdgpu driver build number
- ``el10``: distro version
- ``6.12.0-55.34.1.el10_0.x86_64``: kernel version of dkms build
- ``installed``: dkms status; ``installed`` indicates successful installation of the amdgpu driver

.. tab-item:: OL

.. code-block:: bash

sudo dkms status

**Sample output for OL 10.0:**

.. code-block:: bash

amdgpu/6.14.14-2222715.el10, 6.12.0-103.40.4.3.el10uek.x86_64, x86_64: installed (Original modules exist)

- ``amdgpu``: dkms module name
- ``6.14.14``: amdgpu driver version
- ``2222715``: amdgpu driver build number
- ``el10``: distro version
- ``6.12.0-103.40.4.3.el10uek.x86_64``: kernel version of dkms build
- ``installed``: dkms status; ``installed`` indicates successful installation of the amdgpu driver

.. tab-item:: Rocky

.. code-block:: bash

sudo dkms status

**Sample output for Rocky 9.6:**

.. code-block:: bash

amdgpu/6.14.14-2222715.el9, 5.14.0-570.42.2.el9_6.x86_64, x86_64: installed

- ``amdgpu``: dkms module name
- ``6.14.14``: amdgpu driver version
- ``2222715``: amdgpu driver build number
- ``el9``: distro version
- ``5.14.0-570.42.2.el9_6.x86_64``: kernel version of dkms build
- ``installed``: dkms status; ``installed`` indicates successful installation of the amdgpu driver

.. tab-item:: SLES

.. code-block:: bash

sudo dkms status

**Sample output for SLES 15.7:**

.. code-block:: bash

amdgpu/6.14.14-2222715, 6.4.0-150700.53.16-default, x86_64: installed (original_module exists)

- ``amdgpu``: dkms module name
- ``6.14.14``: amdgpu driver version
- ``2222715``: amdgpu driver build number
- ``6.4.0-150700.53.16-default``: kernel version of dkms build
- ``installed``: dkms status; ``installed`` indicates successful installation of the amdgpu driver

.. tab-item:: AZL

.. code-block:: bash

modinfo amdgpu | grep -w "version:"

**Sample output for Ubuntu 24.04:**
**Sample output for AZL 3.0:**

.. code-block:: bash
.. code-block:: bash

amdgpu/6.14.14-2204008.24.04, 6.14.0-29-generic, x86_64: installed
version: 6.8.5

- ``amdgpu``: dkms module name
- ``6.14.14``: amdgpu driver version
- ``2204008``: amdgpu driver build number
- ``24.04``: distro version
- ``6.14.0-29-generic``: kernel version of dkms build
- ``installed``: dkms status; ``installed`` indicates successful installation of the amdgpu driver
- ``6.8.5``: amdgpu driver version

.. _other_resources:

Expand Down
94 changes: 57 additions & 37 deletions docs/install/detailed-install/prerequisites.rst
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ Before installing the driver, complete the following prerequisites.
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=24.04
DISTRIB_CODENAME=noble
DISTRIB_DESCRIPTION="Ubuntu 24.04.2 LTS"
DISTRIB_DESCRIPTION="Ubuntu 24.04.3 LTS"

.. _verify_kernel_version:

Expand Down Expand Up @@ -54,57 +54,72 @@ Register your Enterprise Linux
If you're using Red Hat Enterprise Linux (RHEL) or SUSE Linux Enterprise Server (SLES), register
your operating system to ensure you're able to download and install packages.

.. tab-set::
.. datatemplate:nodata::

.. tab-item:: Ubuntu
:sync: ubuntu-tab
.. tab-set::

There is no registration required for Ubuntu.
.. tab-item:: Ubuntu
:sync: ubuntu-tab

.. tab-item:: Debian
:sync: debian-tab
There is no registration required for Ubuntu.

There is no registration required for Debian.
.. tab-item:: Debian
:sync: debian-tab

.. tab-item:: Red Hat Enterprise Linux
:sync: rhel-tab
There is no registration required for Debian.

Typically you can register by following the step-by-step user interface.
If you need to register by command line, use the following commands:

.. code-block:: shell
.. tab-item:: Red Hat Enterprise Linux
:sync: rhel-tab

subscription-manager register --username <username> --password <password>
subscription-manager attach --auto
.. tab-set::

More details about `registering for RHEL <https://access.redhat.com/solutions/253273>`_
{% for os_version in config.html_context['rhel_version_numbers'] %}
.. tab-item:: {{ os_version }}
:sync: {{ os_version }}

.. tab-item:: Oracle Linux
:sync: ol-tab
Typically you can register by following the step-by-step user interface.
If you need to register by command line, use the following commands:

There is no registration required for Oracle Linux.
.. code-block:: shell
:substitutions:

.. tab-item:: SUSE Linux Enterprise Server
:sync: sle-tab
{% if os_version == '10.0' -%}
subscription-manager register --username <username> --password <password>
{%- else -%}
subscription-manager register --username <username> --password <password>
subscription-manager attach --auto
{%- endif %}

Typically you can register by following the step-by-step user interface.
If you need to register by command line, use the following commands:

.. code-block:: shell
More details about `registering for RHEL <https://access.redhat.com/solutions/253273>`_

sudo SUSEConnect -r <REGCODE>
{% endfor %}

More details about `registering for SLES <https://www.suse.com/support/kb/doc/?id=000018564>`_
.. tab-item:: Oracle Linux
:sync: ol-tab

.. tab-item:: Azure Linux
:sync: azl-tab
There is no registration required for Oracle Linux.

There is no registration required for Azure Linux.
.. tab-item:: SUSE Linux Enterprise Server
:sync: sle-tab

.. tab-item:: Rocky Linux
:sync: rl-tab
Typically you can register by following the step-by-step user interface.
If you need to register by command line, use the following commands:

.. code-block:: shell

sudo SUSEConnect -r <REGCODE>

There is no registration required for Rocky Linux.
More details about `registering for SLES <https://www.suse.com/support/kb/doc/?id=000018564>`_

.. tab-item:: Azure Linux
:sync: azl-tab

There is no registration required for Azure Linux.

.. tab-item:: Rocky Linux
:sync: rl-tab

There is no registration required for Rocky Linux.

.. _update-enterprise-linux:

Expand Down Expand Up @@ -137,6 +152,7 @@ This is a requirement for newer hardware on older versions of RHEL, SLES, OL, or
{% for os_version in config.html_context['rhel_version_numbers'] %}
{% set os_major, _ = os_version.split('.') %}
.. tab-item:: {{ os_version }}
:sync: {{ os_version }}

.. code-block:: bash
:substitutions:
Expand All @@ -152,6 +168,7 @@ This is a requirement for newer hardware on older versions of RHEL, SLES, OL, or
{% for os_version in config.html_context['ol_version_numbers'] %}
{% set os_major, _ = os_version.split('.') %}
.. tab-item:: {{ os_version }}
:sync: {{ os_version }}

.. code-block:: bash
:substitutions:
Expand Down Expand Up @@ -225,13 +242,14 @@ To install for the currently active kernel run the command corresponding to your
{% set os_major, _ = os_version.split('.') %}

.. tab-item:: {{ os_version }}
:sync: {{ os_version }}

.. code-block:: shell

{% if os_major == '9' -%}
sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" "kernel-devel-matched-$(uname -r)"
{%- else -%}
{% if os_major == '8' -%}
sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)"
{%- else -%}
sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" "kernel-devel-matched-$(uname -r)"
{%- endif %}

{% endfor %}
Expand All @@ -245,6 +263,7 @@ To install for the currently active kernel run the command corresponding to your

{% for os_version in config.html_context['ol_version_numbers'] %}
.. tab-item:: {{ os_version }}
:sync: {{ os_version }}

.. code-block:: shell

Expand Down Expand Up @@ -282,6 +301,7 @@ To install for the currently active kernel run the command corresponding to your
{% set os_major, _ = os_version.split('.') %}

.. tab-item:: {{ os_version }}
:sync: {{ os_version }}

.. code-block:: shell

Expand Down