Skip to content

Commit

Permalink
Sync develop branch
Browse files Browse the repository at this point in the history
  • Loading branch information
samjwu committed Aug 2, 2024
2 parents 2220811 + cd0ba16 commit e3843f4
Show file tree
Hide file tree
Showing 116 changed files with 14,053 additions and 135 deletions.
3 changes: 3 additions & 0 deletions .github/workflows/promote_develop_install_into_mainline.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
name: Promote develop-install into mainline
on:
workflow_dispatch:
3 changes: 3 additions & 0 deletions .github/workflows/promote_develop_to_external.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
name: Promote develop to external
on:
workflow_dispatch:
3 changes: 3 additions & 0 deletions .github/workflows/promote_mainline_into_develop.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
name: Promote mainline into develop
on:
workflow_dispatch:
15 changes: 14 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,6 +1,16 @@
.venv
.vscode
build
# Ignore build directories we create
/**build**/
# Ignore any offline installer packages we create
*.run
# Ignore the build binary of the rocm offline installer UI
rocm_offline_ui
# Ignore any packages we download when running the actual .run offline installer.
*/packages/*
*/installer-package/*



# documentation artifacts
_build/
Expand All @@ -11,3 +21,6 @@ _toc.yml
docBin/
_doxygen/
_readthedocs/

# macos specific things
.DS_Store
32 changes: 31 additions & 1 deletion .wordlist.txt
Original file line number Diff line number Diff line change
@@ -1,3 +1,33 @@
ARI
BARs
br
Broadcom
CTest
DHCP
dkms
dmesg
fw
FW
FWDEV
hostname
hotplug
IFWI
IIO
IRQs
MACVTAP
MSRs
pci
PLX
preconfigured
Repo
rocHPL
ROCmVersionWithoutCommas
SBR
SMCi
SVM
SuperMicro
TensorFlowVersion
dkms
vCPU
vfio
VFIO
vhost
6 changes: 6 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,3 +28,9 @@ You can also use [PDM](https://pdm-project.org/latest/#installation) to manage t
* To build the docs, use: `pdm run inv build`

Now you can open `docs/_build/html/index.html` in your browser.

## ROCm Offline Installer Creator (Linux)

This repository contains tools for installing ROCm on Linux including the ROCm Offline Installer
Creator. Use this tool to create an offline installation of ROCm.
[Offline Installer Creator](https://github.com/ROCm/rocm-install-on-linux-internal/tree/develop/src/offline-installer).
20 changes: 10 additions & 10 deletions docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,11 @@
# https://www.sphinx-doc.org/en/master/usage/configuration.html

# ROCm version numbers
rocm_version = '6.1.2'
rocm_multi_versions = '6.1.2 6.1.1'
rocm_directory_version = '6.1.2' # in 6.0 rocm was located in /opt/rocm-6.0.0
amdgpu_version = '6.1.2' # directory in https://repo.radeon.com/rocm/apt/ and https://repo.radeon.com/amdgpu-install/
amdgpu_install_version = '6.1.60102-1' # version in https://repo.radeon.com/amdgpu-install/6.0.2/ubuntu/jammy/
rocm_version = '6.2'
rocm_multi_versions = '6.2.0 6.1.2'
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/

latex_engine = "xelatex"
latex_elements = {
Expand All @@ -24,17 +24,17 @@
project = "ROCm installation on Linux"
author = "Advanced Micro Devices, Inc."
copyright = "Copyright (c) 2024 Advanced Micro Devices, Inc. All rights reserved."
version = "6.1.2"
release = "6.1.2"
version = "6.2.0"
release = "6.2.0"
setting_all_article_info = True
all_article_info_os = ["linux"]
all_article_info_author = ""

# Supported linux version numbers
ubuntu_version_numbers = [('22.04', 'jammy'), ('20.04', 'focal')]
ubuntu_version_numbers = [('24.04', 'noble'), ('22.04', 'jammy'), ('20.04', 'focal')]
rhel_release_version_numbers = ['9', '8']
rhel_version_numbers = ['9.4', '9.3', '9.2', '8.9', '8.8']
sles_version_numbers = ['15.5', '15.4']
rhel_version_numbers = ['9.4', '9.3', '8.10', '8.9']
sles_version_numbers = ['15.6', '15.5']
ol_release_version_numbers = ['8']
ol_version_numbers = [('8', '8.8')]

Expand Down
Binary file added docs/data/how-to/mi300-passthrough/vfio-image.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
19 changes: 0 additions & 19 deletions docs/how-to/spack.rst
Original file line number Diff line number Diff line change
Expand Up @@ -66,25 +66,6 @@ Installing prerequisites for Spack
zypper install gcc-fortran
zypper install gcc-c++
.. tab-item:: CentOS
:sync: CentOS

.. code-block:: shell
# Install some essential utilities:
yum update
yum install make
yum install patch bash tar yum install gzip unzip bzip2 xz file gnupg2 git gawk
yum group install "Development Tools"
yum install vim
# Install Python:
yum install python3
pip3 install --upgrade pip
# Install compilers:
yum install gcc
yum install gcc-gfortran
yum install gcc-c++
Building ROCm components using Spack
===================================================

Expand Down
2 changes: 1 addition & 1 deletion docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -47,4 +47,4 @@ The documentation is structured as follows:
* :doc:`reference/3rd-party-support-matrix`
* :doc:`Troubleshooting <reference/install-faq>`
* :doc:`reference/user-kernel-space-compat-matrix`


4 changes: 1 addition & 3 deletions docs/install/3rd-party/pytorch-install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -79,8 +79,6 @@ wheels command, you must select 'Linux', 'Python', 'pip', and 'ROCm' in the matr
- `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>`_
* - CentOS 7
- `rocm/dev-centos-7 <https://hub.docker.com/r/rocm/dev-centos-7>`_

b. Pull the selected image.

Expand Down Expand Up @@ -286,7 +284,7 @@ maintainers and installs all the required dependencies, including:
Where:

* ``<os-version>`` = ``ubuntu20.04`` (or ``focal``), ``ubuntu22.04`` (or ``jammy``), ``centos7.5``, or ``centos9``
* ``<rocm-version>`` = ``5.7``, ``6.0``, or ``6.1``
* ``<rocm-version>`` = ``6.0``, ``6.1``, or ``6.2``
* ``<python-version>`` = ``3.8`` - ``3.11``

To verify that your image was successfully created, run:
Expand Down
2 changes: 2 additions & 0 deletions docs/install/3rd-party/tensorflow-install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ development.

* - ROCm version
- TensorFlow version
* - 6.2.x
- 2.14.1, 2.15.1, 2.16.1
* - 6.1.x
- 2.13.1, 2.14.0, 2.15.0
* - 6.0.x
Expand Down
8 changes: 1 addition & 7 deletions docs/install/amdgpu-install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -56,13 +56,7 @@ Red Hat Enterprise Linux
.. code-block:: bash
:substitutions:
sudo yum install https://repo.radeon.com/amdgpu-install/|amdgpu_version|/rhel/{{ os_version }}/amdgpu-install-|amdgpu_install_version|.el{{ os_major }}.noarch.rpm
{% if os_version == '9.4' %}
.. note::

RHEL 9.4 is only supported on AMD Instinct MI300A.
{% endif %}
sudo yum install https://repo.radeon.com/amdgpu-install/|amdgpu_version|/el/{{ os_version }}/amdgpu-install-|amdgpu_install_version|.el{{ os_major }}.noarch.rpm
{% endfor %}

SUSE Linux Enterprise
Expand Down
14 changes: 12 additions & 2 deletions docs/install/install-overview.rst
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Installation methods

* :ref:`package_manager_versus_amdgpu`
* :ref:`Multi version installation (Optional) <multi-version-install-overview>`

* :ref:`ROCM Offline Installer Creator <rocm-offline-installer-creator>`

.. _package_manager_versus_amdgpu:

Expand Down Expand Up @@ -58,4 +58,14 @@ Multi version installation (Optional)
===========================================================

A select few users may want to install multiple versions of ROCm. Multi version installation covers situations where you need multiple versions of ROCm on the same machine.
Follow :doc:`installing multiple ROCm versions<../install/native-install/multi-version-install>` for instructions.
Follow :doc:`installing multiple ROCm versions<../install/native-install/multi-version-install>` for instructions.

.. _rocm-offline-installer-creator:

ROCm Offline Installer Creator
===========================================================

The ROCm Offline Installer Creator creates an
installation package for a preconfigured setup of ROCm, the AMDGPU driver, or a combination
of the two on a target system without network or internet access.
See :doc:`ROCm Offline Installer Creator <../install/rocm-offline-installer>` for instructions.
13 changes: 6 additions & 7 deletions docs/install/native-install/includes/rhel-multi-install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,14 +17,14 @@
sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/$ver/rhel/{{ os_version }}/main/x86_64/
baseurl=https://repo.radeon.com/amdgpu/$ver/el/{{ os_version }}/main/x86_64/
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
done
sudo yum clean all
sudo dnf clean all
{% endfor %}
.. _rhel-multi-register-rocm:
Expand All @@ -45,15 +45,14 @@
sudo tee --append /etc/yum.repos.d/rocm.repo <<EOF
[ROCm-$ver]
name=ROCm|rocm_version|
baseurl=https://repo.radeon.com/rocm/rhel{{ os_release }}/$ver/main
baseurl=https://repo.radeon.com/rocm/el{{ os_release }}/$ver/main
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
done
sudo yum clean all
sudo dnf clean all
{% endfor %}
3. Install ROCm.
Expand All @@ -62,7 +61,7 @@
.. code-block:: bash
sudo yum install amdgpu-dkms
sudo dnf install amdgpu-dkms
sudo reboot
b. Install the registered ROCm packages.
Expand All @@ -71,7 +70,7 @@
:substitutions:
for ver in |rocm_multi_versions|; do
sudo yum install rocm$ver
sudo dnf install rocm$ver
done
4. Complete the :doc:`../post-install`.
Expand Down
4 changes: 2 additions & 2 deletions docs/install/native-install/install-rocm-template.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,14 @@ Install kernel driver

.. code-block:: bash
sudo yum install amdgpu-dkms
sudo dnf install amdgpu-dkms
sudo reboot
Install ROCm packages
----------------------------------------------------------------------------------------------------------

.. code-block:: bash
sudo yum install rocm
sudo dnf install rocm
Complete the :doc:`../post-install`.
14 changes: 4 additions & 10 deletions docs/install/native-install/rhel.rst
Original file line number Diff line number Diff line change
Expand Up @@ -29,18 +29,13 @@ Register kernel-mode driver
sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/|rocm_version|/rhel/{{ os_version }}/main/x86_64/
baseurl=https://repo.radeon.com/amdgpu/|rocm_version|/el/{{ os_version }}/main/x86_64/
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo yum clean all
{% if os_version == '9.4' %}
.. note::
RHEL 9.4 is supported only on AMD Instinct MI300A.
{% endif %}
sudo dnf clean all
{% endfor %}
.. _rhel-register-rocm:
Expand All @@ -61,14 +56,13 @@ Register ROCm packages
sudo tee --append /etc/yum.repos.d/rocm.repo <<EOF
[ROCm-|rocm_version|]
name=ROCm|rocm_version|
baseurl=https://repo.radeon.com/rocm/rhel{{ os_release }}/|rocm_version|/main
baseurl=https://repo.radeon.com/rocm/el{{ os_release }}/|rocm_version|/main
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo yum clean all
sudo dnf clean all
{% endfor %}
.. _rhel-install:
Expand Down
12 changes: 6 additions & 6 deletions docs/install/native-install/uninstall-rocm-template.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,26 +9,26 @@ Uninstall specific meta packages
# sudo apt autoremove <package-name>
# For example:
sudo yum remove rocm
sudo dnf remove rocm
# Or for version specific packages:
sudo yum remove rocm|rocm_version|
sudo dnf remove rocm|rocm_version|
Uninstall ROCm packages
----------------------------------------------------------------------------------------------------------

.. code-block:: bash
:substitutions:
sudo yum remove rocm-core
sudo dnf remove rocm-core
# Or for version specific packages:
sudo yum remove rocm-core|rocm_version|
sudo dnf remove rocm-core|rocm_version|
Uninstall kernel-mode driver
----------------------------------------------------------------------------------------------------------

.. code-block:: bash
sudo yum remove amdgpu-dkms
sudo dnf remove amdgpu-dkms
Remove ROCm and AMDGPU repositories
----------------------------------------------------------------------------------------------------------
Expand All @@ -41,7 +41,7 @@ Remove ROCm and AMDGPU repositories
# Clear the cache and clean the system.
sudo rm -rf /var/cache/yum
sudo yum clean all
sudo dnf clean all
# Restart the system.
sudo reboot
2 changes: 1 addition & 1 deletion docs/install/post-install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ Post-installation instructions
.. code-block:: bash
sudo yum list installed
sudo dnf list installed
.. tab-item:: SLES
Expand Down
Loading

0 comments on commit e3843f4

Please sign in to comment.