Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Cherrypick fix into 6.2.0 #321

Closed
wants to merge 25 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
2b33f06
Merge pull request #250 from ROCm/develop
peterjunpark Aug 6, 2024
242a9b8
Update 6.2.0 docs (#255)
samjwu Aug 8, 2024
080b61d
Docker image support matrix for 6.2 (#258)
peterjunpark Aug 9, 2024
48a9e98
Updated build from source instructions to resolve issue #259 (#260)
AMD-melliott Aug 12, 2024
27b5ef8
build(deps): Bump sphinx-substitution-extensions in /docs/sphinx (#253)
dependabot[bot] Aug 7, 2024
7cf54a8
build(deps): Bump rocm-docs-core from 1.6.1 to 1.6.2 in /docs/sphinx …
dependabot[bot] Aug 7, 2024
1dc4dfb
Merge branch 'develop' into docs/6.2.0
peterjunpark Aug 12, 2024
151b48b
Merge pull request #265 from peterjunpark/docs/6.2.0
peterjunpark Aug 12, 2024
01569fa
Merge pull request #267 from ROCm/develop
peterjunpark Aug 13, 2024
2cbc5ec
UCC 1.3. should be used with ROCm 6.1 onward (#251)
edgargabriel Aug 15, 2024
54c5d1f
build(deps): Bump rocm-docs-core from 1.6.2 to 1.7.0 in /docs/sphinx …
dependabot[bot] Aug 15, 2024
cdf416a
build(deps): Bump rocm-docs-core from 1.7.0 to 1.7.1 in /docs/sphinx …
dependabot[bot] Aug 20, 2024
f7d552b
Fix broken link in Ubuntu 20.04 tab of Docker support matrix
amd-jnovotny Aug 22, 2024
b0329fb
add update commands in quick start for RHEL and SLES (#269)
yhuiYH Aug 22, 2024
5cb62c2
Updated the support matrix to show the minor versions of TensorFlow. …
spolifroni-amd Aug 28, 2024
aab3fcf
Update to ROCm6.2 pytorch nightly wheels (#229) (#281)
spolifroni-amd Aug 29, 2024
12380cd
Merge pull request #283 from spolifroni-amd/spolifroni-amd/cp-pytorch…
spolifroni-amd Aug 29, 2024
d180fa1
DisableIGP added to prerequisites and remove 24.04 multi-version inst…
yhuiYH Aug 29, 2024
6734408
update PyTorch install to use 24.04
yhuiYH Aug 28, 2024
8da30f0
Updated Pre-Req Section (#287)
pramenku Sep 10, 2024
26093e2
Highlight prerequisites line on amdgpu-install page (#306)
alexxu-amd Oct 1, 2024
5c837b3
Update Virtualization support versions (#307)
yhuiYH Oct 2, 2024
8adbd32
remove unnecessary template file (#312)
alexxu-amd Oct 1, 2024
442f9fc
Add tensorflow wheel versioning note (#303)
harkgill-amd Oct 1, 2024
cdf4b41
build(deps): Bump rocm-docs-core from 1.7.1 to 1.8.2 in /docs/sphinx …
dependabot[bot] Oct 2, 2024
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
3 changes: 2 additions & 1 deletion .wordlist.txt
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ FWDEV
hostname
hotplug
IFWI
IGP
IIO
IRQs
MACVTAP
Expand All @@ -21,7 +22,7 @@ PLX
preconfigured
Repo
rocHPL
ROCmVersionWithoutCommas
ROCmVersion
SBR
SMCi
SVM
Expand Down
6 changes: 3 additions & 3 deletions docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -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/
Expand Down Expand Up @@ -40,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'
Expand All @@ -66,6 +65,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}
Expand Down
18 changes: 9 additions & 9 deletions docs/install/3rd-party/pytorch-install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://hub.docker.com/r/rocm/dev-ubuntu-20.04>`_
* - Ubuntu 22.04
- `rocm/dev-ubuntu-22.04 <https://hub.docker.com/r/rocm/dev-ubuntu-22.04>`_
* - Ubuntu 24.04
- `rocm/dev-ubuntu-24.04 <https://hub.docker.com/r/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.

Expand All @@ -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.

Expand Down
3 changes: 1 addition & 2 deletions docs/install/3rd-party/tensorflow-install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand Down
4 changes: 3 additions & 1 deletion docs/install/amdgpu-install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
--------------------------------------------------------------------
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
17 changes: 16 additions & 1 deletion docs/install/native-install/includes/ubuntu-multi-install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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}}

Expand All @@ -21,6 +24,8 @@
| sudo tee /etc/apt/sources.list.d/amdgpu.list
done
sudo apt update

{% endif %}
{% endfor %}

.. _ubuntu-multi-register-rocm:
Expand All @@ -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}}

Expand All @@ -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.
Expand All @@ -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,
Expand Down
20 changes: 0 additions & 20 deletions docs/install/native-install/install-rocm-template.rst

This file was deleted.

75 changes: 71 additions & 4 deletions docs/install/native-install/rhel.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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
4 changes: 4 additions & 0 deletions docs/install/native-install/sles.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
8 changes: 5 additions & 3 deletions docs/install/native-install/ubuntu.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -166,5 +170,3 @@ Remove ROCm and AMDGPU repositories

# Restart the system.
sudo reboot


Loading
Loading