7.1.1 release updates (#727)

yugang-amd · web-flow · commit 61c871635bb6 · 2025-11-26T09:41:50.000-05:00
* version updates

* add notes about uninstalling amdgpu-dkms

* rewording

* add RHEL 10.1 &amp; 9.7

* more rewording

* More updates

* tweak for consistency

* remove RHEL 9.7/10.1 from multi-version install

* modify condition to include 10.1

* update udev rules and smi outputs
diff --git a/docs/conf.py b/docs/conf.py
@@ -5,15 +5,15 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
 # ROCm version numbers
-rocm_version = '7.1'
+rocm_version = '7.1.1'
 rocm_major_version = '7.0'
-rocm_multi_versions = '7.1 7.0.2' # in 6.3, the folder names on repo.radeon.com use 6.3 for minor releases
-rocm_multi_versions_package_versions = '7.1.0 7.0.2' # however, in multi, the packages use 6.3.0
-rocm_directory_version = '7.1.0' # in 6.0 rocm was located in /opt/rocm-6.0.0
-amdgpu_version = '7.1' # directory in https://repo.radeon.com/rocm/apt/ and https://repo.radeon.com/amdgpu-install/
-amdgpu_install_version = '7.1.70100-1' # version in https://repo.radeon.com/amdgpu-install/6.0.2/ubuntu/jammy/
-udev_version = '30.20.0.0-2238411'
-udev_amdgpu_version = '30.20'
+rocm_multi_versions = '7.1.1 7.0.2' # in 6.3, the folder names on repo.radeon.com use 6.3 for minor releases
+rocm_multi_versions_package_versions = '7.1.1 7.0.2' # however, in multi, the packages use 6.3.0
+rocm_directory_version = '7.1.1' # in 6.0 rocm was located in /opt/rocm-6.0.0
+amdgpu_version = '7.1.1' # directory in https://repo.radeon.com/rocm/apt/ and https://repo.radeon.com/amdgpu-install/
+amdgpu_install_version = '7.1.1.70101-1' # version in https://repo.radeon.com/amdgpu-install/6.0.2/ubuntu/jammy/
+udev_version = '30.20.1.0-2255209'
+udev_amdgpu_version = '30.20.1'
 
 
 latex_engine = "xelatex"
@@ -41,6 +41,7 @@
 debian_udev_versions = [('13', 'noble', '24.04'), ('12', 'jammy', '22.04')]
 rhel_release_version_numbers = ['10', '9', '8']
 rhel_version_numbers = ['10.1', '10.0', '9.7', '9.6', '9.4', '8.10']
+rhel_multi_versions = ['10.0', '9.6', '9.4', '8.10']
 sles_version_numbers = ['15.7']
 ol_release_version_numbers = ['10', '9', '8']
 ol_version_numbers = ['10.0', '9.6', '8.10']
@@ -99,6 +100,7 @@
     "sles_version_numbers" : sles_version_numbers,
     "rhel_release_version_numbers" : rhel_release_version_numbers,
     "rhel_version_numbers" : rhel_version_numbers,
+    "rhel_multi_versions" : rhel_multi_versions,
     "ol_release_version_numbers" : ol_release_version_numbers,
     "ol_version_numbers" : ol_version_numbers,
     "azl_version_numbers": azl_version_numbers,
diff --git a/docs/install/install-methods/multi-version-install/multi-version-install-debian.rst b/docs/install/install-methods/multi-version-install/multi-version-install-debian.rst
@@ -10,7 +10,7 @@ Debian multi-version installation
 
 .. caution::
 
-    Ensure that the :doc:`/install/prerequisites` are met before installing.
+    Ensure that the :doc:`/install/prerequisites` are met.
 
 
 .. _debian-multi-register-rocm:
diff --git a/docs/install/install-methods/multi-version-install/multi-version-install-ol.rst b/docs/install/install-methods/multi-version-install/multi-version-install-ol.rst
@@ -10,7 +10,7 @@ Oracle Linux multi-version installation
 
 .. caution::
 
-    Ensure that the :doc:`/install/prerequisites` are met before installing.
+    Ensure that the :doc:`/install/prerequisites` are met.
 
 
 .. _ol-multi-register-rocm:
diff --git a/docs/install/install-methods/multi-version-install/multi-version-install-rhel.rst b/docs/install/install-methods/multi-version-install/multi-version-install-rhel.rst
@@ -10,7 +10,7 @@ Red Hat Enterprise Linux multi-version installation
 
 .. caution::
 
-    Ensure that the :doc:`/install/prerequisites` are met before installing.
+    Ensure that the :doc:`/install/prerequisites` are met.
 
 .. _rhel-multi-register-rocm:
 
@@ -20,7 +20,7 @@ Registering ROCm repositories
 .. datatemplate:nodata::
 
    .. tab-set::
-      {% for os_version in config.html_context['rhel_version_numbers'] %}
+      {% for os_version in config.html_context['rhel_multi_versions'] %}
       {% set os_major, _  = os_version.split('.') %}
       .. tab-item:: RHEL {{ os_version }}
             :sync: rhel-{{ os_version }}
diff --git a/docs/install/install-methods/multi-version-install/multi-version-install-rl.rst b/docs/install/install-methods/multi-version-install/multi-version-install-rl.rst
@@ -10,7 +10,7 @@ Rocky Linux multi-version installation
 
 .. caution::
 
-    Ensure that the :doc:`/install/prerequisites` are met before installing.
+    Ensure that the :doc:`/install/prerequisites` are met.
 
 .. _rl-multi-register-rocm:
 
diff --git a/docs/install/install-methods/multi-version-install/multi-version-install-sles.rst b/docs/install/install-methods/multi-version-install/multi-version-install-sles.rst
@@ -10,7 +10,7 @@ SUSE Linux Enterprise Server multi-version installation
 
 .. caution::
 
-    Ensure that the :doc:`/install/prerequisites` are met before installing.
+    Ensure that the :doc:`/install/prerequisites` are met.
 
 .. _sles-multi-register-rocm:
 
diff --git a/docs/install/install-methods/multi-version-install/multi-version-install-ubuntu.rst b/docs/install/install-methods/multi-version-install/multi-version-install-ubuntu.rst
@@ -10,7 +10,7 @@ Ubuntu multi-version installation
 
 .. caution::
 
-    Ensure that the :doc:`/install/prerequisites` are met before installing.
+    Ensure that the :doc:`/install/prerequisites` are met.
 
 .. _ubuntu-multi-register-rocm:
 
diff --git a/docs/install/install-methods/package-manager/package-manager-debian.rst b/docs/install/install-methods/package-manager/package-manager-debian.rst
@@ -8,7 +8,7 @@ Debian native installation
 
 .. caution::
 
-    Ensure that the :doc:`/install/prerequisites` are met before installing.
+    Ensure that the :doc:`/install/prerequisites` are met.
 
 .. Note::
 
diff --git a/docs/install/install-methods/package-manager/package-manager-ol.rst b/docs/install/install-methods/package-manager/package-manager-ol.rst
@@ -9,7 +9,7 @@ Oracle Linux native installation
 
 .. caution::
 
-    Ensure that the :doc:`/install/prerequisites` are met before installing.
+    Ensure that the :doc:`/install/prerequisites` are met.
 
 .. Note::
 
diff --git a/docs/install/install-methods/package-manager/package-manager-rhel.rst b/docs/install/install-methods/package-manager/package-manager-rhel.rst
@@ -9,7 +9,7 @@ Red Hat Enterprise Linux native installation
 
 .. caution::
 
-    Ensure that the :doc:`/install/prerequisites` are met before installing.
+    Ensure that the :doc:`/install/prerequisites` are met.
 
 .. Note::
 
@@ -43,7 +43,7 @@ Registering ROCm repositories
 
                 [amdgraphics]
                 name=AMD Graphics |rocm_directory_version| repository
-                {% if os_major == '9' -%}
+                {% if os_major == '9' or os_version == '10.1' -%}
                 baseurl=https://repo.radeon.com/graphics/|rocm_version|/el/{{ os_version }}/main/x86_64/
                 {%- else -%}
                 baseurl=https://repo.radeon.com/graphics/|rocm_version|/el/{{ os_major }}/main/x86_64/
diff --git a/docs/install/install-methods/package-manager/package-manager-rl.rst b/docs/install/install-methods/package-manager/package-manager-rl.rst
@@ -9,7 +9,7 @@ Rocky Linux native installation
 
 .. caution::
 
-    Ensure that the :doc:`/install/prerequisites` are met before installing.
+    Ensure that the :doc:`/install/prerequisites` are met.
 
 .. Note::
 
diff --git a/docs/install/install-methods/package-manager/package-manager-sles.rst b/docs/install/install-methods/package-manager/package-manager-sles.rst
@@ -9,7 +9,7 @@ SUSE Linux Enterprise Server native installation
 
 .. caution::
 
-    Ensure that the :doc:`/install/prerequisites` are met before installing.
+    Ensure that the :doc:`/install/prerequisites` are met.
 
 .. Note::
 
diff --git a/docs/install/install-methods/package-manager/package-manager-ubuntu.rst b/docs/install/install-methods/package-manager/package-manager-ubuntu.rst
@@ -8,7 +8,7 @@ Ubuntu native installation
 
 .. caution::
 
-    Ensure that the :doc:`/install/prerequisites` are met before installing.
+    Ensure that the :doc:`/install/prerequisites` are met.
 
 .. Note::
 
diff --git a/docs/install/post-install.rst b/docs/install/post-install.rst
@@ -220,7 +220,7 @@ Use the following ROCm tools to verify that installation was successful:
 
       .. code-block:: bash
 
-          AMDSMI Tool: 26.1.0+5df6c765 | AMDSMI Library version: 26.1.0 | ROCm version: 7.1.0 | amdgpu version: 6.16.6 | amd_hsmp version: N/A
+          AMDSMI Tool: 26.2.0+021c61fc | AMDSMI Library version: 26.2.0 | ROCm version: 7.1.1 | amdgpu version: 6.16.6 | amd_hsmp version: N/A
 
 Troubleshooting
 =====================================================
diff --git a/docs/install/prerequisites.rst b/docs/install/prerequisites.rst
@@ -83,7 +83,7 @@ your operating system to ensure you're able to download and install packages.
                     .. code-block:: shell
                         :substitutions:
 
-                        {% if os_version == '10.0' -%}
+                        {% if os_version == '10.0' or '10.1' -%}
                         subscription-manager register --username <username> --password <password>
                         {%- else -%}
                         subscription-manager register --username <username> --password <password>
@@ -544,7 +544,7 @@ To set up udev rules, install the package using the following instructions speci
                    .. code-block:: bash
                        :substitutions:
 
-                       {% if os_major == '9' -%}
+                       {% if os_major == '9' or os_version == '10.1' -%}
                        sudo dnf install https://repo.radeon.com/amdgpu/|udev_amdgpu_version|/el/{{ os_version }}/main/x86_64/amdgpu-insecure-instinct-udev-rules-|udev_version|.el{{ os_major }}.noarch.rpm
                        {%- else -%}
                        sudo dnf install https://repo.radeon.com/amdgpu/|udev_amdgpu_version|/el/{{ os_major }}/main/x86_64/amdgpu-insecure-instinct-udev-rules-|udev_version|.el{{ os_major }}.noarch.rpm
diff --git a/docs/install/quick-start.rst b/docs/install/quick-start.rst
@@ -81,7 +81,7 @@ ROCm installation
                    .. code-block:: bash
                        :substitutions:
 
-                       {% if os_major == '9' -%}
+                       {% if os_major == '9' or os_version == '10.1' -%}
                        sudo dnf install https://repo.radeon.com/amdgpu-install/|amdgpu_version|/rhel/{{ os_version }}/amdgpu-install-|amdgpu_install_version|.el{{ os_major }}.noarch.rpm
                        {%- else -%}
                        sudo dnf install https://repo.radeon.com/amdgpu-install/|amdgpu_version|/rhel/{{ os_major }}/amdgpu-install-|amdgpu_install_version|.el{{ os_major }}.noarch.rpm
@@ -192,6 +192,10 @@ AMDGPU driver installation
                 .. tab-item:: {{ os_version }}
                    :sync: {{ os_version }}
 
+                   .. caution::
+
+                      Remove any AMDGPU driver from a previous installation by following uninstallation steps in `AMD GPU Driver documentation <https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/package-manager/package-manager-ubuntu.html#uninstalling>`_.
+
                    .. code-block:: bash
                        :substitutions:
 
@@ -212,6 +216,10 @@ AMDGPU driver installation
                 .. tab-item:: {{ os_version }}
                    :sync: {{ os_version }}
 
+                   .. caution::
+
+                      Remove any AMDGPU driver from a previous installation by following uninstallation steps in `AMD GPU Driver documentation <https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/package-manager/package-manager-debian.html#uninstalling>`_. 
+
                    .. code-block:: bash
                        :substitutions:
 
@@ -233,12 +241,16 @@ AMDGPU driver installation
                 .. tab-item:: {{ os_version }}
                    :sync: {{ os_version }}
 
+                   .. caution::
+
+                      Remove any AMDGPU driver from a previous installation by following uninstallation steps in `AMD GPU Driver documentation <https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/package-manager/package-manager-rhel.html#uninstalling>`_. 
+                   
                    Before installing AMDGPU driver on RHEL, :ref:`register and update your Enterprise Linux <register-enterprise-linux>`.
 
                    .. code-block:: bash
                        :substitutions:
 
-                       {% if os_major == '9' -%}
+                       {% if os_major == '9' or os_version == '10.1' -%}
                        sudo dnf install https://repo.radeon.com/amdgpu-install/|amdgpu_version|/rhel/{{ os_version }}/amdgpu-install-|amdgpu_install_version|.el{{ os_major }}.noarch.rpm
                        {%- else -%}
                        sudo dnf install https://repo.radeon.com/amdgpu-install/|amdgpu_version|/rhel/{{ os_major }}/amdgpu-install-|amdgpu_install_version|.el{{ os_major }}.noarch.rpm
@@ -263,6 +275,10 @@ AMDGPU driver installation
                 .. tab-item:: {{ os_version }}
                    :sync: {{ os_version }}
 
+                   .. caution::
+
+                      Remove any AMDGPU driver from a previous installation by following uninstallation steps in `AMD GPU Driver documentation <https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/package-manager/package-manager-ol.html#uninstalling>`_.
+                      
                    Before installing AMDGPU driver on OL, :ref:`update your Enterprise Linux <update-enterprise-linux>`.
 
                    .. code-block:: bash
@@ -287,6 +303,10 @@ AMDGPU driver installation
                 {% for os_version in config.html_context['sles_version_numbers'] %}
                 .. tab-item:: {{ os_version }}
 
+                   .. caution::
+
+                      Remove any AMDGPU driver from a previous installation by following uninstallation steps in `AMD GPU Driver documentation <https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/package-manager/package-manager-sles.html#uninstalling>`_. 
+                   
                    Before installing AMDGPU driver on SLES, :ref:`register and update your Enterprise Linux <register-enterprise-linux>`.
 
                    .. code-block:: bash
@@ -312,6 +332,10 @@ AMDGPU driver installation
                 {% set os_major, _  = os_version.split('.') %}
                 .. tab-item:: {{ os_version }}
 
+                   .. caution::
+
+                      Remove any AMDGPU driver from a previous installation by following uninstallation steps in `AMD GPU Driver documentation <https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/package-manager/package-manager-rl.html#uninstalling>`_. 
+
                    .. code-block:: bash
                        :substitutions:
 
