From bfafad618362e1cf2374235e258d7a468a41c3aa Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 20 Aug 2024 12:08:03 -0600 Subject: [PATCH 1/8] build(deps): Bump rocm-docs-core from 1.7.0 to 1.7.1 in /docs/sphinx (#270) Bumps [rocm-docs-core](https://github.com/ROCm/rocm-docs-core) from 1.7.0 to 1.7.1. - [Release notes](https://github.com/ROCm/rocm-docs-core/releases) - [Changelog](https://github.com/ROCm/rocm-docs-core/blob/develop/CHANGELOG.md) - [Commits](https://github.com/ROCm/rocm-docs-core/compare/v1.7.0...v1.7.1) --- updated-dependencies: - dependency-name: rocm-docs-core dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- docs/sphinx/requirements.in | 2 +- docs/sphinx/requirements.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sphinx/requirements.in b/docs/sphinx/requirements.in index ac57b2da..22f16687 100644 --- a/docs/sphinx/requirements.in +++ b/docs/sphinx/requirements.in @@ -1,3 +1,3 @@ -rocm-docs-core==1.7.0 +rocm-docs-core==1.7.1 Sphinx-Substitution-Extensions==2024.8.6 sphinxcontrib.datatemplates==0.11.0 diff --git a/docs/sphinx/requirements.txt b/docs/sphinx/requirements.txt index c9251206..a6c13fdd 100644 --- 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.0 +rocm-docs-core==1.7.1 # via -r requirements.in smmap==5.0.1 # via gitdb From 6fb8ec0fb63bf15d25df1cda153da7f43863cd55 Mon Sep 17 00:00:00 2001 From: Jeffrey Novotny Date: Thu, 22 Aug 2024 10:50:23 -0400 Subject: [PATCH 2/8] Fix broken link in Ubuntu 20.04 tab of Docker support matrix --- docs/reference/docker-image-support-matrix.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/reference/docker-image-support-matrix.rst b/docs/reference/docker-image-support-matrix.rst index 2d0f53c8..f8400d7f 100644 --- a/docs/reference/docker-image-support-matrix.rst +++ b/docs/reference/docker-image-support-matrix.rst @@ -102,8 +102,8 @@ The following Docker image tags and associated inventories are validated for ROC * `ROCm 6.2 `_ * `Python 3.9 `_ * `PyTorch 2.2.1 `_ - * `Apex 1.2.0 `_ - * `torchvision 0.17.1 `_ + * `Apex 1.2.0 `_ + * `torchvision 0.17.1 `_ * `TensorBoard 2.13.0 `_ * `MAGMA `_ * `UCX 1.10.0 `_ @@ -121,7 +121,7 @@ The following Docker image tags and associated inventories are validated for ROC * `ROCm 6.2 `_ * `Python 3.9 `_ * `PyTorch 2.1.2 `_ - * `Apex 1.1.0 `_ + * `Apex 1.1.0 `_ * `torchvision 0.16.1 `_ * `TensorBoard 2.13.0 `_ * `MAGMA `_ @@ -140,8 +140,8 @@ The following Docker image tags and associated inventories are validated for ROC * `ROCm 6.2 `_ * `Python 3.9 `_ * `PyTorch 1.13.1 `_ - * `Apex 1.0.0 `_ - * `torchvision 0.14.0 `_ + * `Apex 1.0.0 `_ + * `torchvision 0.14.0 `_ * `TensorBoard 2.17.0 `_ * `MAGMA `_ * `UCX 1.10.0 `_ From 125b2afa8db2b87dbf239941f89e17d95ae49946 Mon Sep 17 00:00:00 2001 From: Young Hui - AMD <145490163+yhuiYH@users.noreply.github.com> Date: Thu, 22 Aug 2024 13:02:47 -0400 Subject: [PATCH 3/8] add update commands in quick start for RHEL and SLES (#269) --- docs/install/quick-start.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/install/quick-start.rst b/docs/install/quick-start.rst index 76330d89..e6ef8989 100644 --- a/docs/install/quick-start.rst +++ b/docs/install/quick-start.rst @@ -54,6 +54,7 @@ For more in-depth installation instructions, refer to :ref:`detailed-install-ove .. code-block:: bash :substitutions: + sudo dnf update wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-{{ os_major }}.noarch.rpm sudo rpm -ivh epel-release-latest-{{ os_major }}.noarch.rpm sudo dnf install dnf-plugin-config-manager @@ -77,6 +78,7 @@ For more in-depth installation instructions, refer to :ref:`detailed-install-ove .. code-block:: bash :substitutions: + sudo zypper update sudo zypper addrepo https://download.opensuse.org/repositories/devel:languages:perl/{{ os_version}}/devel:languages:perl.repo sudo zypper addrepo https://download.opensuse.org/repositories/Education/{{ os_version }}/ Education sudo zypper install kernel-default-devel From ad2b9aa67118afcb6bdb64d5ff6fba47be24a4d0 Mon Sep 17 00:00:00 2001 From: spolifroni-amd Date: Mon, 26 Aug 2024 14:53:36 -0400 Subject: [PATCH 4/8] Updated the support matrix to show the minor versions of TensorFlow. (#191) (#273) --- docs/reference/3rd-party-support-matrix.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/reference/3rd-party-support-matrix.rst b/docs/reference/3rd-party-support-matrix.rst index 2e57e47a..616106d4 100644 --- a/docs/reference/3rd-party-support-matrix.rst +++ b/docs/reference/3rd-party-support-matrix.rst @@ -25,15 +25,15 @@ TensorFlow. For TensorFlow the exact version follows the ``.< * - 6.2.x - 1.13, 2.0, 2.1, 2.2, 2.3 - - 2.14, 2.15, 2.16 + - 2.14.1, 2.15.1, 2.16.1 * - 6.1.x - 1.13, 2.0, 2.1 - - 2.13, 2.14, 2.15 + - 2.13.1, 2.14.0, 2.15.0 * - 6.0.x - 1.13, 2.0, 2.1 - - 2.12, 2.13, 2.14 + - 2.12.1, 2.13.1, 2.14.0 * - 5.7.x - 1.12.1, 1.13, 2.0, 2.1 From e235bb108eda470ebd2bc87916e443d1ccef8cc9 Mon Sep 17 00:00:00 2001 From: spolifroni-amd Date: Thu, 29 Aug 2024 13:22:41 -0400 Subject: [PATCH 5/8] Update to ROCm6.2 pytorch nightly wheels (#229) (#281) Co-authored-by: Jithun Nair <37884920+jithunnair-amd@users.noreply.github.com> --- docs/install/3rd-party/pytorch-install.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/install/3rd-party/pytorch-install.rst b/docs/install/3rd-party/pytorch-install.rst index 84106bb9..2126462e 100644 --- a/docs/install/3rd-party/pytorch-install.rst +++ b/docs/install/3rd-party/pytorch-install.rst @@ -128,12 +128,12 @@ wheels command, you must select 'Linux', 'Python', 'pip', and 'ROCm' in the matr .. note:: - The following command uses the ROCm 6.1 PyTorch wheel. If you want a different version of ROCm, + The following command uses the ROCm 6.2 PyTorch wheel. If you want a different version of ROCm, modify the command accordingly. .. code-block:: bash - pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm6.1/ + pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm6.2/ 4. (Optional) Use MIOpen kdb files with ROCm PyTorch wheels. From d60c60ab6019fcc15e7eb7c481ba62db0366b0ac Mon Sep 17 00:00:00 2001 From: Young Hui - AMD <145490163+yhuiYH@users.noreply.github.com> Date: Thu, 29 Aug 2024 17:23:39 -0400 Subject: [PATCH 6/8] DisableIGP added to prerequisites and remove 24.04 multi-version install instructions (#279) * add DisableIGP comment in prerequisites * expand prerequisites to tabs for Registering your enterprise linux * workaround for Ubuntu 24.04 multiversion, to limit and not mention 6.1.2 because noble not supported on 6.1.2 * multi version needs to differentiate from repo.radeon.com folder path, and actual package version * Adding to wordlist * fix tabs * fix tabs again * remove 24.04 mutli-version because we don't have multiple packages supported on 24.04 yet * text update, thanks Harry * fix Ubuntu typo --- .wordlist.txt | 1 + docs/conf.py | 4 +- .../includes/rhel-multi-install.rst | 2 +- .../includes/sles-multi-install.rst | 2 +- .../includes/ubuntu-multi-install.rst | 17 ++++++- docs/install/prerequisites.rst | 51 +++++++++++++++---- 6 files changed, 62 insertions(+), 15 deletions(-) diff --git a/.wordlist.txt b/.wordlist.txt index 6aa50166..a6ae293e 100644 --- a/.wordlist.txt +++ b/.wordlist.txt @@ -12,6 +12,7 @@ FWDEV hostname hotplug IFWI +IGP IIO IRQs MACVTAP diff --git a/docs/conf.py b/docs/conf.py index 551af023..a577866b 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -6,7 +6,8 @@ # ROCm version numbers rocm_version = '6.2' -rocm_multi_versions = '6.2.0 6.1.2' +rocm_multi_versions = '6.2 6.1.2' # in 6.2, the folder names on repo.radeon.com use 6.2 for minor releases +rocm_multi_versions_package_versions = '6.2.0 6.1.2' # however, in multi, the packages use 6.2.0 rocm_directory_version = '6.2.0' # in 6.0 rocm was located in /opt/rocm-6.0.0 amdgpu_version = '6.2' # directory in https://repo.radeon.com/rocm/apt/ and https://repo.radeon.com/amdgpu-install/ amdgpu_install_version = '6.2.60200-1' # version in https://repo.radeon.com/amdgpu-install/6.0.2/ubuntu/jammy/ @@ -66,6 +67,7 @@ rst_prolog = f""" .. |rocm_version| replace:: {rocm_version} .. |rocm_multi_versions| replace:: {rocm_multi_versions} +.. |rocm_multi_versions_package_versions| replace:: {rocm_multi_versions_package_versions} .. |amdgpu_version| replace:: {amdgpu_version} .. |rocm_directory_version| replace:: {rocm_directory_version} .. |amdgpu_install_version| replace:: {amdgpu_install_version} diff --git a/docs/install/native-install/includes/rhel-multi-install.rst b/docs/install/native-install/includes/rhel-multi-install.rst index 5530ce20..df2f946a 100644 --- a/docs/install/native-install/includes/rhel-multi-install.rst +++ b/docs/install/native-install/includes/rhel-multi-install.rst @@ -69,7 +69,7 @@ .. code-block:: bash :substitutions: - for ver in |rocm_multi_versions|; do + for ver in |rocm_multi_versions_package_versions|; do sudo dnf install rocm$ver done diff --git a/docs/install/native-install/includes/sles-multi-install.rst b/docs/install/native-install/includes/sles-multi-install.rst index cb00bc0e..ae73f1a3 100644 --- a/docs/install/native-install/includes/sles-multi-install.rst +++ b/docs/install/native-install/includes/sles-multi-install.rst @@ -34,7 +34,7 @@ .. code-block:: bash :substitutions: - for ver in |rocm_multi_versions|; do + for ver in |rocm_multi_versions_package_versions|; do sudo zypper --gpg-auto-import-keys install rocm$ver done diff --git a/docs/install/native-install/includes/ubuntu-multi-install.rst b/docs/install/native-install/includes/ubuntu-multi-install.rst index 18fe8073..b759767f 100644 --- a/docs/install/native-install/includes/ubuntu-multi-install.rst +++ b/docs/install/native-install/includes/ubuntu-multi-install.rst @@ -10,6 +10,9 @@ .. tab-set:: {% for (os_version, os_release) in config.html_context['ubuntu_version_numbers'] %} + {% if os_version == '24.04' %} + + {% else %} .. tab-item:: Ubuntu {{ os_version }} :sync: ubuntu-{{ os_version}} @@ -21,6 +24,8 @@ | sudo tee /etc/apt/sources.list.d/amdgpu.list done sudo apt update + + {% endif %} {% endfor %} .. _ubuntu-multi-register-rocm: @@ -33,6 +38,9 @@ .. tab-set:: {% for (os_version, os_release) in config.html_context['ubuntu_version_numbers'] %} + {% if os_version == '24.04' %} + + {% else %} .. tab-item:: Ubuntu {{ os_version }} :sync: ubuntu-{{ os_version}} @@ -46,6 +54,7 @@ echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' \ | sudo tee /etc/apt/preferences.d/rocm-pin-600 sudo apt update + {% endif %} {% endfor %} 4. Install ROCm. @@ -62,12 +71,18 @@ .. code-block:: bash :substitutions: - for ver in |rocm_multi_versions|; do + for ver in |rocm_multi_versions_package_versions|; do sudo apt install rocm$ver done 5. Complete the :doc:`../post-install`. +.. note:: + + Since Ubuntu 24.04 is newly supported with ROCm 6.2, we only have one package to + install on Ubuntu 24.04. As a result, multi-version support is not available for + Ubuntu 24.04 as there are no additional versions at this time. + .. tip:: For a single-version installation of the latest ROCm version on Ubuntu, diff --git a/docs/install/prerequisites.rst b/docs/install/prerequisites.rst index 8f18dcb1..8cc7ee7d 100644 --- a/docs/install/prerequisites.rst +++ b/docs/install/prerequisites.rst @@ -67,13 +67,23 @@ 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 + .. datatemplate:nodata:: + + .. tab-set:: + + {% for os_release in config.html_context['rhel_release_version_numbers'] %} + + .. tab-item:: RHEL {{ os_release }} + + .. code-block:: shell - subscription-manager register --username --password - subscription-manager attach --auto - subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms + subscription-manager register --username --password + subscription-manager attach --auto + subscription-manager repos --enable codeready-builder-for-rhel-{{ os_release }}-x86_64-rpms - More details about `registering for RHEL `_ + {% endfor %} + + More details about `registering for RHEL `_ .. tab-item:: SUSE Linux Enterprise Server :sync: sle-tab @@ -81,14 +91,25 @@ 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 + .. datatemplate:nodata:: + + .. tab-set:: - SUSEConnect -r - SUSEConnect -p sle-module-desktop-application/15.4/x86_64 - SUSEConnect -p sle-module-development-tools/15.4/x86_64 - SUSEConnect -p PackageHub/15.4/x86_64 + {% for os_version in config.html_context['sles_version_numbers'] %} + {% set os_release, os_sp = os_version.split('.') %} + + .. tab-item:: SLES {{ os_version }} + + .. code-block:: shell + + SUSEConnect -r + SUSEConnect -p sle-module-desktop-application/{{ os_version }}/x86_64 + SUSEConnect -p sle-module-development-tools/{{ os_version }}/x86_64 + SUSEConnect -p PackageHub/{{ os_version }}/x86_64 - More details about `registering for SLES `_ + {% endfor %} + + More details about `registering for SLES `_ Additional package repositories @@ -220,3 +241,11 @@ recommend using the video group for all ROCm-supported operating systems. .. tip:: On systems with multiple users, if ROCm is installed system wide, each individual user should be added to the ``render`` and ``video`` groups. + +Disable integrated graphics (IGP), if applicable +================================================================ + +ROCm doesn't currently support integrated graphics. Should your system have an +AMD IGP installed, disable it in the BIOS prior to using ROCm. If the driver can +enumerate the IGP, the ROCm runtime may crash the system, even if told to omit +it via `HIP_VISIBLE_DEVICES `_. From 38ac29f10a254ebf3f344dfc9967ce7cdbbf4f49 Mon Sep 17 00:00:00 2001 From: Young Hui Date: Wed, 28 Aug 2024 18:18:36 -0400 Subject: [PATCH 7/8] update PyTorch install to use 24.04 --- docs/install/3rd-party/pytorch-install.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/install/3rd-party/pytorch-install.rst b/docs/install/3rd-party/pytorch-install.rst index 2126462e..75183c70 100644 --- a/docs/install/3rd-party/pytorch-install.rst +++ b/docs/install/3rd-party/pytorch-install.rst @@ -75,38 +75,38 @@ wheels command, you must select 'Linux', 'Python', 'pip', and 'ROCm' in the matr * - Base OS - Docker Image - * - Ubuntu 20.04 - - `rocm/dev-ubuntu-20.04 `_ * - Ubuntu 22.04 - `rocm/dev-ubuntu-22.04 `_ + * - Ubuntu 24.04 + - `rocm/dev-ubuntu-24.04 `_ b. Pull the selected image. .. code-block:: bash - docker pull rocm/dev-ubuntu-20.04:latest + docker pull rocm/dev-ubuntu-22.04:latest c. Start a Docker container using the downloaded image. .. code-block:: bash - docker run -it --device=/dev/kfd --device=/dev/dri --group-add video rocm/dev-ubuntu-20.04:latest + docker run -it --device=/dev/kfd --device=/dev/dri --group-add video rocm/dev-ubuntu-22.04:latest **Option 2:** Select a base OS Docker image (Check :ref:`system-requirements`) - Pull selected base OS image (Ubuntu 20.04 for example) + Pull selected base OS image (Ubuntu 22.04 for example) .. code-block:: bash - docker pull ubuntu:20.04 + docker pull ubuntu:22.04 Start a Docker container using the downloaded image .. code-block:: bash - docker run -it --device=/dev/kfd --device=/dev/dri --group-add video ubuntu:20.04 + docker run -it --device=/dev/kfd --device=/dev/dri --group-add video ubuntu:22.04 Install ROCm using the directions in the :ref:`rocm-install-overview` section. From f11a30be21dcd1d708568418bb6022f746e0c1a9 Mon Sep 17 00:00:00 2001 From: pramenku <7664080+pramenku@users.noreply.github.com> Date: Tue, 10 Sep 2024 18:49:32 +0530 Subject: [PATCH 8/8] CP PR#287 to develop (#288) --- docs/install/prerequisites.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/install/prerequisites.rst b/docs/install/prerequisites.rst index 8cc7ee7d..a79c56f7 100644 --- a/docs/install/prerequisites.rst +++ b/docs/install/prerequisites.rst @@ -79,7 +79,6 @@ your operating system to ensure you're able to download and install packages. subscription-manager register --username --password subscription-manager attach --auto - subscription-manager repos --enable codeready-builder-for-rhel-{{ os_release }}-x86_64-rpms {% endfor %} @@ -103,7 +102,7 @@ your operating system to ensure you're able to download and install packages. .. code-block:: shell SUSEConnect -r - SUSEConnect -p sle-module-desktop-application/{{ os_version }}/x86_64 + SUSEConnect -p sle-module-desktop-applications/{{ os_version }}/x86_64 SUSEConnect -p sle-module-development-tools/{{ os_version }}/x86_64 SUSEConnect -p PackageHub/{{ os_version }}/x86_64