Cherrypick fix into 6.2.0 (#322)

* Highlight prerequisites line on amdgpu-install page (#306) * highlight prerequisites block * change note block to important block * unifying native-install variants * unify titles; add prereq important blocks for native install * remove install-rocm-template.rst * bring the note to the top * Update Virtualization support versions (#307) * update Hypervisor versions * fix RHEL version, and add EXSi details * remove unnecessary template file (#312) * Add tensorflow wheel versioning note (#303) * build(deps): Bump rocm-docs-core from 1.7.1 to 1.8.2 in /docs/sphinx (#300) Bumps [rocm-docs-core](https://github.com/ROCm/rocm-docs-core) from 1.7.1 to 1.8.2. - [Release notes](https://github.com/ROCm/rocm-docs-core/releases) - [Changelog](https://github.com/ROCm/rocm-docs-core/blob/v1.8.2/CHANGELOG.md) - [Commits](ROCm/rocm-docs-core@v1.7.1...v1.8.2) --- updated-dependencies: - dependency-name: rocm-docs-core dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --------- Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: Young Hui - AMD <[email protected]> Co-authored-by: harkgill-amd <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
ROCm · Oct 3, 2024 · a77f910 · a77f910
1 parent 8da30f0
commit a77f910
Show file tree

Hide file tree

Showing 13 changed files with 96 additions and 89 deletions.
diff --git a/.wordlist.txt b/.wordlist.txt
@@ -22,7 +22,7 @@ PLX
 preconfigured
 Repo
 rocHPL
-ROCmVersionWithoutCommas
+ROCmVersion
 SBR
 SMCi
 SVM

diff --git a/docs/conf.py b/docs/conf.py
@@ -41,8 +41,6 @@
 
 exclude_patterns = [
     'temp', 
-    'install/native-install/install-rocm-template.rst', 
-    'install/native-install/uninstall-rocm-template.rst',
     'install/native-install/includes/rhel-multi-install.rst',
     'install/native-install/includes/sles-multi-install.rst',
     'install/native-install/includes/ubuntu-multi-install.rst'

diff --git a/docs/install/3rd-party/tensorflow-install.rst b/docs/install/3rd-party/tensorflow-install.rst
@@ -87,8 +87,7 @@ To install TensorFlow using the wheels package, use the following command.
 
 .. note::
 
-   For details on ``tensorflow-rocm`` wheels and ROCm version compatibility, refer to
-   `<https://github.com/ROCm/tensorflow-upstream/blob/develop-upstream/rocm_docs/tensorflow-rocm-release.md>`__.
+   Prior to ROCm 6.1, ``[wheel-version]`` followed the ``<TensorFlowVersion>.<ROCmVersion>`` format.
 
 .. _test-tensorflow-installation:
 

diff --git a/docs/install/amdgpu-install.rst b/docs/install/amdgpu-install.rst
@@ -22,7 +22,9 @@ Installation
 
 Installation of ``amdgpu-install`` differs slightly depending on the OS and its package manager.
 
-Make sure that the :doc:`/install/prerequisites` are met before installing.
+.. important::
+
+    Make sure that the :doc:`/install/prerequisites` are met before installing.
 
 Ubuntu
 --------------------------------------------------------------------

diff --git a/docs/install/native-install/install-rocm-template.rst b/docs/install/native-install/install-rocm-template.rst
diff --git a/docs/install/native-install/rhel.rst b/docs/install/native-install/rhel.rst
@@ -7,9 +7,13 @@
 Red Hat Enterprise Linux native installation
 **********************************************************************************************
 
+.. important::
+
+    Make sure that the :doc:`/install/prerequisites` are met before installing.
+
 .. _rhel-register-repo:
 
-Register repositories
+Registering ROCm repositories
 =====================================================
 
 Register kernel-mode driver
@@ -67,11 +71,29 @@ Register ROCm packages
 
 .. _rhel-install:
 
-.. include:: install-rocm-template.rst
+Installing
+=====================================================
+
+Install kernel driver
+----------------------------------------------------------------------------------------------------------
+
+.. code-block:: bash
+
+    sudo dnf install amdgpu-dkms
+    sudo reboot
+
+Install ROCm packages
+----------------------------------------------------------------------------------------------------------
+
+.. code-block:: bash
+
+    sudo dnf install rocm
+
+Complete the :doc:`../post-install`.
 
 .. _rhel-upgrade:
 
-Upgrade
+Upgrading
 =====================================================
 
 To upgrade an existing ROCm installation to a newer version, follow the steps in
@@ -84,5 +106,50 @@ To upgrade an existing ROCm installation to a newer version, follow the steps in
 
 .. _rhel-uninstall:
 
-.. include:: uninstall-rocm-template.rst
+Uninstalling
+=====================================================
+
+Uninstall specific meta packages
+---------------------------------------------------------------------------
+
+.. code-block:: bash
+    :substitutions:
+
+    # sudo apt autoremove <package-name>
+    # For example:
+    sudo dnf remove rocm
+    # Or for version specific packages:
+    sudo dnf remove rocm|rocm_version|
+
+Uninstall ROCm packages
+---------------------------------------------------------------------------
+
+.. code-block:: bash
+    :substitutions:
+
+    sudo dnf remove rocm-core
+    # Or for version specific packages:
+    sudo dnf remove rocm-core|rocm_version|
+
+Uninstall kernel-mode driver
+---------------------------------------------------------------------------
+
+.. code-block:: bash
+
+    sudo dnf remove amdgpu-dkms
+
+Remove ROCm and AMDGPU repositories
+---------------------------------------------------------------------------
+
+.. code-block:: bash
+
+    # Remove the repositories.
+    sudo rm /etc/yum.repos.d/rocm.list
+    sudo rm /etc/yum.repos.d/amdgpu.list
+
+    # Clear the cache and clean the system.
+    sudo rm -rf /var/cache/yum
+    sudo dnf clean all
 
+    # Restart the system.
+    sudo reboot
diff --git a/docs/install/native-install/sles.rst b/docs/install/native-install/sles.rst
@@ -7,6 +7,10 @@
 SUSE Linux Enterprise native installation
 *********************************************************************************************
 
+.. important::
+
+    Make sure that the :doc:`/install/prerequisites` are met before installing.
+
 .. _sles-register-rocm:
 
 Registering ROCm repositories

diff --git a/docs/install/native-install/ubuntu.rst b/docs/install/native-install/ubuntu.rst
@@ -6,9 +6,13 @@
 Ubuntu native installation
 ****************************************************************************
 
+.. important::
+
+    Make sure that the :doc:`/install/prerequisites` are met before installing.
+
 .. _ubuntu-register-repo:
 
-Registering repositories
+Registering ROCm repositories
 =================================================
 
 .. _ubuntu-package-key:
@@ -166,5 +170,3 @@ Remove ROCm and AMDGPU repositories
 
     # Restart the system.
     sudo reboot
-
-
diff --git a/docs/install/native-install/uninstall-rocm-template.rst b/docs/install/native-install/uninstall-rocm-template.rst
diff --git a/docs/reference/3rd-party-support-matrix.rst b/docs/reference/3rd-party-support-matrix.rst
@@ -13,8 +13,7 @@ ROCm™ supports a variety of third-party libraries and frameworks. The supporte
 Deep learning
 ================================================
 
-ROCm releases support the most recent and two prior releases of PyTorch and
-TensorFlow. For TensorFlow the exact version follows the ``<TensorFlowVersion>.<ROCmVersionWithoutCommas>`` format.
+ROCm releases support the most recent and two prior releases of PyTorch and TensorFlow.
 
 .. list-table::
     :header-rows: 1

diff --git a/docs/reference/system-requirements.rst b/docs/reference/system-requirements.rst
@@ -1,5 +1,5 @@
 .. meta::
-  :description: Linux GPU and OS support
+  :description: System requirements for AMD ROCm
   :keywords: Linux support, ROCm distributions, system requirements, supported GPUs,  Instinct,
     Radeon PRO, Radeon, AMD, ROCm
 
@@ -9,6 +9,10 @@
 System requirements (Linux)
 **************************************************************************************
 
+.. |br| raw:: html
+
+   <br>
+
 Supported GPUs
 =============================================
 
@@ -106,12 +110,11 @@ Virtualization support
 ROCm supports virtualization for select GPUs only as shown below.
 
 .. csv-table::
-    :widths: 50, 25, 25, 50
+    :widths: 20, 20, 20, 40
     :header: "Hypervisor", "Version", "GPU", "Validated guest OS (kernel)"
 
-    "VMWare", "ESXI 8", "MI250", "Ubuntu 20.04 (5.15 [HWE])"
-    "VMWare", "ESXI 8", "MI210", "Ubuntu 20.04 (5.15 [HWE]), SLES 15 SP4 (5.14.21)"
-    "VMWare", "ESXI 7", "MI210", "Ubuntu 20.04 (5.15 [HWE]), SLES 15 SP4 (5.14.21)"
+    "VMWare", "ESXi 8.0.3", "MI210", "Ubuntu 22.04.4 (6.8 [HWE]), |br| SLES 15 SP5 (5.14.21), |br| RHEL 9.4 (5.14.0)"
+    "VMWare", "ESXi 7.0.3", "MI210", "Ubuntu 22.04.4 (6.8 [HWE]), |br| RHEL 9.4 (5.14.0)"
 
 CPU support
 =============================================

diff --git a/docs/sphinx/requirements.in b/docs/sphinx/requirements.in
@@ -1,3 +1,3 @@
-rocm-docs-core==1.7.1
+rocm-docs-core==1.8.2
 Sphinx-Substitution-Extensions==2024.8.6
 sphinxcontrib.datatemplates==0.11.0
diff --git a/docs/sphinx/requirements.txt b/docs/sphinx/requirements.txt
@@ -96,7 +96,7 @@ requests==2.31.0
     # via
     #   pygithub
     #   sphinx
-rocm-docs-core==1.7.1
+rocm-docs-core==1.8.2
     # via -r requirements.in
 smmap==5.0.1
     # via gitdb
-Original file line number
+Diff line change
@@ Expand Up / @@ -22,7 +22,7 @@ PLX @@
     preconfigured
     Repo
     rocHPL
-    ROCmVersionWithoutCommas
+    ROCmVersion
     SBR
     SMCi
     SVM
@@ Expand Down @@