From 670ffb1fa0773a0a2e0ed637858fc1a4b7cf378a Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Tue, 23 Sep 2025 12:43:59 -0400 Subject: [PATCH 01/20] 7.0.2 release updates --- docs/conf.py | 14 +++++++------- .../package-manager/package-manager-ol.rst | 6 +++--- .../package-manager/package-manager-rhel.rst | 6 +++--- docs/install/detailed-install/prerequisites.rst | 6 +++--- 4 files changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index cce80e8..3a8e9f6 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -9,9 +9,9 @@ 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." @@ -20,11 +20,11 @@ # 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'] +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'] diff --git a/docs/install/detailed-install/package-manager/package-manager-ol.rst b/docs/install/detailed-install/package-manager/package-manager-ol.rst index 9f3a30d..63cb01e 100644 --- a/docs/install/detailed-install/package-manager/package-manager-ol.rst +++ b/docs/install/detailed-install/package-manager/package-manager-ol.rst @@ -32,10 +32,10 @@ Register kernel-mode driver sudo tee /etc/yum.repos.d/amdgpu.repo < Date: Tue, 23 Sep 2025 15:55:23 -0400 Subject: [PATCH 02/20] sync up tabs --- docs/install/detailed-install/prerequisites.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index 59e804c..50020b2 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -137,6 +137,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: @@ -152,6 +153,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: @@ -166,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['sles_version_numbers'] %} .. tab-item:: {{ os_version }} + :sync: {{ os_version }} .. code-block:: bash @@ -225,6 +228,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 @@ -245,6 +249,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 @@ -260,6 +265,7 @@ To install for the currently active kernel run the command corresponding to your {% for os_version in config.html_context['sles_version_numbers'] %} .. tab-item:: {{ os_version }} + :sync: {{ os_version }} .. code-block:: shell @@ -282,6 +288,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 From dfa70abae713a03ca4685f5af011533112af1a7c Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Tue, 23 Sep 2025 15:58:49 -0400 Subject: [PATCH 03/20] remove unnecessary sync functions --- docs/install/detailed-install/prerequisites.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index 50020b2..eecabd3 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -168,7 +168,6 @@ This is a requirement for newer hardware on older versions of RHEL, SLES, OL, or {% for os_version in config.html_context['sles_version_numbers'] %} .. tab-item:: {{ os_version }} - :sync: {{ os_version }} .. code-block:: bash @@ -265,7 +264,6 @@ To install for the currently active kernel run the command corresponding to your {% for os_version in config.html_context['sles_version_numbers'] %} .. tab-item:: {{ os_version }} - :sync: {{ os_version }} .. code-block:: shell From 8af3e5a649d168c1eec087477e27a3a82b79d7f7 Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Thu, 25 Sep 2025 10:02:48 -0400 Subject: [PATCH 04/20] remove code identifier --- docs/install/detailed-install/prerequisites.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index eecabd3..d0ef7b6 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -20,7 +20,7 @@ Before installing the driver, complete the following prerequisites. **Example:** Running the preceding command on an Ubuntu system produces the following output: - .. code-block:: shell + .. code-block:: x86_64 DISTRIB_ID=Ubuntu @@ -40,7 +40,7 @@ Before installing the driver, complete the following prerequisites. **Example:** The preceding command lists the kernel version in the following format: - .. code-block:: shell + .. code-block:: Linux 6.8.0-50-generic #51-Ubuntu SMP PREEMPT_DYNAMIC Sat Nov 9 17:58:29 UTC 2024 x86_64 From e21b0a465aa57e489bab443267a61ea0b90a8bde Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Thu, 25 Sep 2025 10:07:45 -0400 Subject: [PATCH 05/20] remove more code identifiers --- .../detailed-install/prerequisites.rst | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index d0ef7b6..26fc7c9 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -12,7 +12,7 @@ Before installing the driver, complete the following prerequisites. * To obtain the Linux distribution information, use the following command: - .. code-block:: shell + .. code-block:: uname -m && cat /etc/*release @@ -34,7 +34,7 @@ Before installing the driver, complete the following prerequisites. * To check the kernel version of your Linux system, type the following command: - .. code-block:: shell + .. code-block:: uname -srmv @@ -72,7 +72,7 @@ your operating system to ensure you're able to download and install packages. 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 + .. code-block:: subscription-manager register --username --password subscription-manager attach --auto @@ -90,7 +90,7 @@ your operating system to ensure you're able to download and install packages. 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 + .. code-block:: sudo SUSEConnect -r @@ -139,7 +139,7 @@ This is a requirement for newer hardware on older versions of RHEL, SLES, OL, or .. tab-item:: {{ os_version }} :sync: {{ os_version }} - .. code-block:: bash + .. code-block:: :substitutions: sudo dnf update --releasever={{ os_version }} --exclude=\*release\* @@ -155,7 +155,7 @@ This is a requirement for newer hardware on older versions of RHEL, SLES, OL, or .. tab-item:: {{ os_version }} :sync: {{ os_version }} - .. code-block:: bash + .. code-block:: :substitutions: sudo dnf update --releasever={{ os_version }} --exclude=\*release\* @@ -169,7 +169,7 @@ This is a requirement for newer hardware on older versions of RHEL, SLES, OL, or {% for os_version in config.html_context['sles_version_numbers'] %} .. tab-item:: {{ os_version }} - .. code-block:: bash + .. code-block:: sudo zypper update {% endfor %} @@ -205,14 +205,14 @@ To install for the currently active kernel run the command corresponding to your .. tab-item:: Ubuntu :sync: ubuntu-tab - .. code-block:: shell + .. code-block:: sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)" .. tab-item:: Debian :sync: debian-tab - .. code-block:: shell + .. code-block:: sudo apt install "linux-headers-$(uname -r)" @@ -229,7 +229,7 @@ To install for the currently active kernel run the command corresponding to your .. tab-item:: {{ os_version }} :sync: {{ os_version }} - .. code-block:: shell + .. code-block:: {% if os_major == '8' -%} sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" @@ -250,7 +250,7 @@ To install for the currently active kernel run the command corresponding to your .. tab-item:: {{ os_version }} :sync: {{ os_version }} - .. code-block:: shell + .. code-block:: sudo dnf install "kernel-uek-devel-$(uname -r)" {% endfor %} @@ -265,7 +265,7 @@ To install for the currently active kernel run the command corresponding to your {% for os_version in config.html_context['sles_version_numbers'] %} .. tab-item:: {{ os_version }} - .. code-block:: shell + .. code-block:: sudo zypper install kernel-default-devel {% endfor %} @@ -288,7 +288,7 @@ To install for the currently active kernel run the command corresponding to your .. tab-item:: {{ os_version }} :sync: {{ os_version }} - .. code-block:: shell + .. code-block:: sudo dnf install "kernel-headers" "kernel-devel" "kernel-devel-matched" {% endfor %} From a89f6c796db24cb054f98d6fe07a25a06d9b2610 Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Thu, 25 Sep 2025 15:00:08 -0400 Subject: [PATCH 06/20] remove code identifier from post install --- docs/install/detailed-install/post-install.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/install/detailed-install/post-install.rst b/docs/install/detailed-install/post-install.rst index 5e2f119..6e6b9c5 100644 --- a/docs/install/detailed-install/post-install.rst +++ b/docs/install/detailed-install/post-install.rst @@ -59,7 +59,7 @@ Use the following command to check the installation of the AMD GPU Driver (amdgp **Sample output for Ubuntu 24.04:** -.. code-block:: bash +.. code-block:: amdgpu/6.14.14-2204008.24.04, 6.14.0-29-generic, x86_64: installed From 9a9646410a9063ccd19cfb29351b2a0a6856e6c5 Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Mon, 29 Sep 2025 14:36:01 -0400 Subject: [PATCH 07/20] move sample output into tabs --- .../install/detailed-install/post-install.rst | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/install/detailed-install/post-install.rst b/docs/install/detailed-install/post-install.rst index 6e6b9c5..ed77ca3 100644 --- a/docs/install/detailed-install/post-install.rst +++ b/docs/install/detailed-install/post-install.rst @@ -21,6 +21,19 @@ 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:: + + amdgpu/6.14.14-2204008.24.04, 6.14.0-29-generic, x86_64: installed + + - ``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 + .. tab-item:: Debian .. code-block:: bash @@ -57,19 +70,6 @@ Use the following command to check the installation of the AMD GPU Driver (amdgp modinfo amdgpu | grep -w "version:" -**Sample output for Ubuntu 24.04:** - -.. code-block:: - - amdgpu/6.14.14-2204008.24.04, 6.14.0-29-generic, x86_64: installed - -- ``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 - .. _other_resources: Additional software for user space From 56bbe3b2a982bdb4de69fdc1c7ee0fec69e83f67 Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Thu, 2 Oct 2025 08:40:20 -0400 Subject: [PATCH 08/20] add Debian 13 --- docs/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index 3a8e9f6..5a1952b 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -19,7 +19,7 @@ # Supported linux version numbers ubuntu_version_numbers = [('24.04', 'noble'), ('22.04', 'jammy')] -debian_version_numbers = [('12', 'jammy')] +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'] From 8c2d8c21b419559601be93dca2da740370ca95a7 Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Thu, 2 Oct 2025 09:07:37 -0400 Subject: [PATCH 09/20] add dynamic samples for dkms status output --- .../install/detailed-install/post-install.rst | 78 ++++++++++++++++++- 1 file changed, 75 insertions(+), 3 deletions(-) diff --git a/docs/install/detailed-install/post-install.rst b/docs/install/detailed-install/post-install.rst index ed77ca3..fa2e05b 100644 --- a/docs/install/detailed-install/post-install.rst +++ b/docs/install/detailed-install/post-install.rst @@ -25,13 +25,13 @@ Use the following command to check the installation of the AMD GPU Driver (amdgp .. code-block:: - amdgpu/6.14.14-2204008.24.04, 6.14.0-29-generic, x86_64: installed + 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 - - ``2204008``: amdgpu driver build number + - ``2222715``: amdgpu driver build number - ``24.04``: distro version - - ``6.14.0-29-generic``: kernel version of dkms build + - ``6.14.0-32-generic``: kernel version of dkms build - ``installed``: dkms status; ``installed`` indicates successful installation of the amdgpu driver .. tab-item:: Debian @@ -40,36 +40,108 @@ Use the following command to check the installation of the AMD GPU Driver (amdgp sudo dkms status + **Sample output for Debian 12:** + + .. code-block:: + + 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 + - ``24.04``: distro version + - ``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:: + + 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:: + + 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:: + + 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:: + + 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 AZL 3.0:** + + .. code-block:: + + version: 6.8.5 + + - ``6.8.5``: amdgpu driver version + .. _other_resources: Additional software for user space From 7302d995ae2d7b643964b0c72fdf1f78b69cea7f Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Thu, 2 Oct 2025 13:17:10 -0400 Subject: [PATCH 10/20] remove redundant outputs --- docs/install/detailed-install/post-install.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/install/detailed-install/post-install.rst b/docs/install/detailed-install/post-install.rst index fa2e05b..55d6697 100644 --- a/docs/install/detailed-install/post-install.rst +++ b/docs/install/detailed-install/post-install.rst @@ -49,7 +49,6 @@ Use the following command to check the installation of the AMD GPU Driver (amdgp - ``amdgpu``: dkms module name - ``6.14.14``: amdgpu driver version - ``2222715``: amdgpu driver build number - - ``24.04``: distro version - ``6.1.0-40-amd64``: kernel version of dkms build - ``installed``: dkms status; ``installed`` indicates successful installation of the amdgpu driver From 46140185e93c8a059cb69fa99905f71b3616d592 Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Tue, 7 Oct 2025 10:39:49 -0400 Subject: [PATCH 11/20] Update Kernel headers install commands for Debian --- .../detailed-install/prerequisites.rst | 20 +++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index 26fc7c9..f102d8e 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -212,9 +212,25 @@ To install for the currently active kernel run the command corresponding to your .. tab-item:: Debian :sync: debian-tab - .. code-block:: + .. datatemplate:nodata:: + + .. tab-set:: - sudo apt install "linux-headers-$(uname -r)" + {% for os_version in config.html_context['debian_version_numbers'] %} + {% set os_major, _ = os_version.split('.') %} + + .. tab-item:: {{ os_version }} + :sync: {{ os_version }} + + .. code-block:: + + {% if os_major == '12' -%} + sudo apt install "linux-headers-$(uname -r)" + {%- else -%} + sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)" + {%- endif %} + + {% endfor %} .. tab-item:: Red Hat Enterprise Linux :sync: rhel-tab From 2d2bf99d318fbaba557068331b1d07104ce1f729 Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Tue, 7 Oct 2025 10:50:33 -0400 Subject: [PATCH 12/20] fix tab display --- docs/install/detailed-install/prerequisites.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index f102d8e..7e7bb05 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -216,7 +216,7 @@ To install for the currently active kernel run the command corresponding to your .. tab-set:: - {% for os_version in config.html_context['debian_version_numbers'] %} + {% for (os_version, os_release) in config.html_context['debian_version_numbers'] %} {% set os_major, _ = os_version.split('.') %} .. tab-item:: {{ os_version }} From b2f77d04f65ee2e89a7f8933cdf9a773341a9438 Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Tue, 7 Oct 2025 10:54:07 -0400 Subject: [PATCH 13/20] more fixes --- docs/install/detailed-install/prerequisites.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index 7e7bb05..9c1ed22 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -217,14 +217,13 @@ To install for the currently active kernel run the command corresponding to your .. tab-set:: {% for (os_version, os_release) in config.html_context['debian_version_numbers'] %} - {% set os_major, _ = os_version.split('.') %} .. tab-item:: {{ os_version }} :sync: {{ os_version }} .. code-block:: - {% if os_major == '12' -%} + {% if os_version == '12' -%} sudo apt install "linux-headers-$(uname -r)" {%- else -%} sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)" From e783932b00232adde291616b1b0adf189f951c1d Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Tue, 7 Oct 2025 15:26:50 -0400 Subject: [PATCH 14/20] fix Ubuntu command for registering kernel-mode driver --- .../detailed-install/package-manager/package-manager-ubuntu.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/install/detailed-install/package-manager/package-manager-ubuntu.rst b/docs/install/detailed-install/package-manager/package-manager-ubuntu.rst index c2ca8d0..bcd992d 100644 --- a/docs/install/detailed-install/package-manager/package-manager-ubuntu.rst +++ b/docs/install/detailed-install/package-manager/package-manager-ubuntu.rst @@ -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 %} From a4137968777fc37532b49db01c27ec051e0b6f88 Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Wed, 8 Oct 2025 12:16:59 -0400 Subject: [PATCH 15/20] Revert Debian kernel headers install changes --- .../detailed-install/prerequisites.rst | 19 ++----------------- 1 file changed, 2 insertions(+), 17 deletions(-) diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index 9c1ed22..26fc7c9 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -212,24 +212,9 @@ To install for the currently active kernel run the command corresponding to your .. tab-item:: Debian :sync: debian-tab - .. datatemplate:nodata:: - - .. tab-set:: - - {% for (os_version, os_release) in config.html_context['debian_version_numbers'] %} - - .. tab-item:: {{ os_version }} - :sync: {{ os_version }} - - .. code-block:: - - {% if os_version == '12' -%} - sudo apt install "linux-headers-$(uname -r)" - {%- else -%} - sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)" - {%- endif %} + .. code-block:: - {% endfor %} + sudo apt install "linux-headers-$(uname -r)" .. tab-item:: Red Hat Enterprise Linux :sync: rhel-tab From bb620b1a4bae5866a9143a940642c29583c0080b Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Wed, 8 Oct 2025 15:29:30 -0400 Subject: [PATCH 16/20] revert removing code identifiers --- .../install/detailed-install/post-install.rst | 14 ++++----- .../detailed-install/prerequisites.rst | 30 +++++++++---------- 2 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/install/detailed-install/post-install.rst b/docs/install/detailed-install/post-install.rst index 55d6697..8923f7f 100644 --- a/docs/install/detailed-install/post-install.rst +++ b/docs/install/detailed-install/post-install.rst @@ -23,7 +23,7 @@ Use the following command to check the installation of the AMD GPU Driver (amdgp **Sample output for Ubuntu 24.04:** - .. code-block:: + .. code-block:: bash amdgpu/6.14.14-2222715.24.04, 6.14.0-32-generic, x86_64: installed @@ -42,7 +42,7 @@ Use the following command to check the installation of the AMD GPU Driver (amdgp **Sample output for Debian 12:** - .. code-block:: + .. code-block:: bash amdgpu/6.14.14-2222715.22.04, 6.1.0-40-amd64, x86_64: installed @@ -60,7 +60,7 @@ Use the following command to check the installation of the AMD GPU Driver (amdgp **Sample output for RHEL 10.0:** - .. code-block:: + .. 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) @@ -79,7 +79,7 @@ Use the following command to check the installation of the AMD GPU Driver (amdgp **Sample output for OL 10.0:** - .. code-block:: + .. 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) @@ -98,7 +98,7 @@ Use the following command to check the installation of the AMD GPU Driver (amdgp **Sample output for Rocky 9.6:** - .. code-block:: + .. code-block:: bash amdgpu/6.14.14-2222715.el9, 5.14.0-570.42.2.el9_6.x86_64, x86_64: installed @@ -117,7 +117,7 @@ Use the following command to check the installation of the AMD GPU Driver (amdgp **Sample output for SLES 15.7:** - .. code-block:: + .. code-block:: bash amdgpu/6.14.14-2222715, 6.4.0-150700.53.16-default, x86_64: installed (original_module exists) @@ -135,7 +135,7 @@ Use the following command to check the installation of the AMD GPU Driver (amdgp **Sample output for AZL 3.0:** - .. code-block:: + .. code-block:: bash version: 6.8.5 diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index 26fc7c9..eecabd3 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -12,7 +12,7 @@ Before installing the driver, complete the following prerequisites. * To obtain the Linux distribution information, use the following command: - .. code-block:: + .. code-block:: shell uname -m && cat /etc/*release @@ -20,7 +20,7 @@ Before installing the driver, complete the following prerequisites. **Example:** Running the preceding command on an Ubuntu system produces the following output: - .. code-block:: + .. code-block:: shell x86_64 DISTRIB_ID=Ubuntu @@ -34,13 +34,13 @@ Before installing the driver, complete the following prerequisites. * To check the kernel version of your Linux system, type the following command: - .. code-block:: + .. code-block:: shell uname -srmv **Example:** The preceding command lists the kernel version in the following format: - .. code-block:: + .. code-block:: shell Linux 6.8.0-50-generic #51-Ubuntu SMP PREEMPT_DYNAMIC Sat Nov 9 17:58:29 UTC 2024 x86_64 @@ -72,7 +72,7 @@ your operating system to ensure you're able to download and install packages. 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:: + .. code-block:: shell subscription-manager register --username --password subscription-manager attach --auto @@ -90,7 +90,7 @@ your operating system to ensure you're able to download and install packages. 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:: + .. code-block:: shell sudo SUSEConnect -r @@ -139,7 +139,7 @@ This is a requirement for newer hardware on older versions of RHEL, SLES, OL, or .. tab-item:: {{ os_version }} :sync: {{ os_version }} - .. code-block:: + .. code-block:: bash :substitutions: sudo dnf update --releasever={{ os_version }} --exclude=\*release\* @@ -155,7 +155,7 @@ This is a requirement for newer hardware on older versions of RHEL, SLES, OL, or .. tab-item:: {{ os_version }} :sync: {{ os_version }} - .. code-block:: + .. code-block:: bash :substitutions: sudo dnf update --releasever={{ os_version }} --exclude=\*release\* @@ -169,7 +169,7 @@ This is a requirement for newer hardware on older versions of RHEL, SLES, OL, or {% for os_version in config.html_context['sles_version_numbers'] %} .. tab-item:: {{ os_version }} - .. code-block:: + .. code-block:: bash sudo zypper update {% endfor %} @@ -205,14 +205,14 @@ To install for the currently active kernel run the command corresponding to your .. tab-item:: Ubuntu :sync: ubuntu-tab - .. code-block:: + .. code-block:: shell sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)" .. tab-item:: Debian :sync: debian-tab - .. code-block:: + .. code-block:: shell sudo apt install "linux-headers-$(uname -r)" @@ -229,7 +229,7 @@ To install for the currently active kernel run the command corresponding to your .. tab-item:: {{ os_version }} :sync: {{ os_version }} - .. code-block:: + .. code-block:: shell {% if os_major == '8' -%} sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" @@ -250,7 +250,7 @@ To install for the currently active kernel run the command corresponding to your .. tab-item:: {{ os_version }} :sync: {{ os_version }} - .. code-block:: + .. code-block:: shell sudo dnf install "kernel-uek-devel-$(uname -r)" {% endfor %} @@ -265,7 +265,7 @@ To install for the currently active kernel run the command corresponding to your {% for os_version in config.html_context['sles_version_numbers'] %} .. tab-item:: {{ os_version }} - .. code-block:: + .. code-block:: shell sudo zypper install kernel-default-devel {% endfor %} @@ -288,7 +288,7 @@ To install for the currently active kernel run the command corresponding to your .. tab-item:: {{ os_version }} :sync: {{ os_version }} - .. code-block:: + .. code-block:: shell sudo dnf install "kernel-headers" "kernel-devel" "kernel-devel-matched" {% endfor %} From c94b4c6d4871785df1803fa7a8134e5a155ff9d4 Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Thu, 9 Oct 2025 11:04:35 -0400 Subject: [PATCH 17/20] OS version specific commands for RHEL registration --- .../detailed-install/prerequisites.rst | 81 +++++++++++-------- 1 file changed, 48 insertions(+), 33 deletions(-) diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index eecabd3..634f13c 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -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 + + .. tab-set:: - subscription-manager register --username --password - subscription-manager attach --auto + {% for os_version in config.html_context['rhel_version_numbers'] %} + .. tab-item:: {{ os_version }} + :sync: {{ os_version }} - More details about `registering for RHEL `_ + Typically you can register by following the step-by-step user interface. + If you need to register by command line, use the following commands: - .. tab-item:: Oracle Linux - :sync: ol-tab + .. code-block:: shell + :substitutions: - There is no registration required for Oracle Linux. + {% if os_version == '10.0' -%} + subscription-manager register --username --password + {%- else -%} + subscription-manager register --username --password + subscription-manager attach --auto + {%- endif %} - .. tab-item:: SUSE Linux Enterprise Server - :sync: sle-tab + More details about `registering for RHEL `_ - 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 + {% endfor %} - sudo SUSEConnect -r + .. tab-item:: Oracle Linux + :sync: ol-tab - More details about `registering for SLES `_ + There is no registration required for Oracle Linux. - .. tab-item:: Azure Linux - :sync: azl-tab + .. tab-item:: SUSE Linux Enterprise Server + :sync: sle-tab - There is no registration required for Azure Linux. + 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:: Rocky Linux - :sync: rl-tab + sudo SUSEConnect -r + + More details about `registering for SLES `_ + + .. 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. + There is no registration required for Rocky Linux. .. _update-enterprise-linux: From 4c34f44d7c28b0d9edf734e39dcd2f059838ee7b Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Thu, 9 Oct 2025 11:13:20 -0400 Subject: [PATCH 18/20] test removing conditions --- docs/install/detailed-install/prerequisites.rst | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index 634f13c..c5a8fb9 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -83,12 +83,8 @@ your operating system to ensure you're able to download and install packages. .. code-block:: shell :substitutions: - {% if os_version == '10.0' -%} - subscription-manager register --username --password - {%- else -%} subscription-manager register --username --password subscription-manager attach --auto - {%- endif %} More details about `registering for RHEL `_ From 134d8d350549044514ff75fa473e1eef00a00a05 Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Thu, 9 Oct 2025 11:16:44 -0400 Subject: [PATCH 19/20] Revert "test removing conditions" This reverts commit 4c34f44d7c28b0d9edf734e39dcd2f059838ee7b. --- docs/install/detailed-install/prerequisites.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index c5a8fb9..634f13c 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -83,8 +83,12 @@ your operating system to ensure you're able to download and install packages. .. code-block:: shell :substitutions: + {% if os_version == '10.0' -%} + subscription-manager register --username --password + {%- else -%} subscription-manager register --username --password subscription-manager attach --auto + {%- endif %} More details about `registering for RHEL `_ From 02ce3e4213b6fa38b33a00bd041fe8fc357f61ce Mon Sep 17 00:00:00 2001 From: yugang-amd Date: Thu, 9 Oct 2025 20:05:46 -0400 Subject: [PATCH 20/20] update example output --- docs/install/detailed-install/prerequisites.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index 634f13c..82a0967 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -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: