mirror of https://github.com/ROCm/ROCm.git synced 2026-02-04 19:35:02 -05:00

Files

Mészáros Gergely a42fae5140 Install fixes (#2228 )

* Remove install instructions for unsuported RHEL 8.8 and 9.2

Current ROCm release does not support these versions of RHEL

* Centralize disclaimers and perquisites for installation

- Move the single-version to multi-version diclaimer to the install
  overview page where single vs multi installs are discussed.
- Move the installation of kernel-headers and development packages
  to the install preparation page. Unify it mainly from the quick start
  content.

* s/Name/name/ in repository config files for RHEL

The repository name can be set as `name=><name>` instead of `Name`,
otherwise yum complains about the repo not having a name, e.g:
```output
Repository 'ROCm-5.3.3' is missing name in configuration, using id.
```

This is fixed with this commit.

* Clean up render/video group section on prerequisites

* Installation and Upgrade restructuring & fixes

- Fix the rocm package urls for RHEL in the install & upgrade guides
  - RHEL8 and 9 have different URLs, add a tab-set similar to ubuntu
    for them.
- Fix the package URL in the upgrade guide for SLES (previously pointed
  to the amdgpu url)
- Change the apt-signing key download and conversion to the method used
  in the quick start guide, which is the recommended by ubuntu maintainers
- Change the install steps from list items to rubrics with numbered entries
  which is more readable and matches the style in the quick start guide
- Do not pass `--append` to `tee` in the upgrade guide, because it is
  meant to overwrite.
- Split the one long tab-set to multiple tab-sets in the upgrade guide
  to improve readability

2023-06-08 09:17:51 -06:00

3.4 KiB

Raw Blame History

Installation Prerequisites (Linux)

You must perform the following steps before installing ROCm and check if the system meets all the requirements to proceed with the installation.

Confirm the System Has a Supported Linux Distribution Version

The ROCm installation is supported only on specific Linux distributions and kernel versions.

Check the Linux Distribution and Kernel Version on Your System

This section discusses obtaining information about the Linux distribution and kernel version.

Linux Distribution Information

Verify the Linux distribution using the following steps:

To obtain the Linux distribution information, type the following command on your system from the Command Line Interface (CLI):
```
uname -m && cat /etc/*release
```
Confirm that the obtained Linux distribution information matches with those listed in {ref}supported_distributions.

Example: Running the command above on an Ubuntu system results in the following output:
```
x86_64
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=20.04
DISTRIB_CODENAME=focal
DISTRIB_DESCRIPTION="Ubuntu 20.04.5 LTS"
```

(check-kernel-info)=

Kernel Information

Verify the kernel version using the following steps:

To check the kernel version of your Linux system, type the following command:
```
uname -srmv
```
Example: The output of the command above lists the kernel version in the following format:
```
Linux 5.15.0-46-generic #44~20.04.5-Ubuntu SMP Fri Jun 24 13:27:29 UTC 2022 x86_64
```
Confirm that the obtained kernel version information matches with system requirements as listed in {ref}supported_distributions.

Kernel headers and development packages

The driver package uses {abbr}DKMS (Dynamic Kernel Module Support) to build the amdgpu-dkms module (driver) for the installed kernels. This requires the Linux kernel headers and modules to be installed for each. Usually these are automatically installed with the kernel, but if you have multiple kernel versions or you have downloaded the kernel images and not the kernel meta-packages then they must be manually installed.

To install for the currently active kernel run the command corresponding to your distribution.

::::{tab-set} :::{tab-item} Ubuntu :sync: ubuntu

sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)"

:::

:::{tab-item} Red Hat Enterprise Linux :sync: RHEL

sudo yum install kernel-headers kernel-devel

:::

:::{tab-item} SUSE Linux Enterprise Server :sync: SLES

sudo zypper install kernel-default-devel

::: ::::

Setting Permissions for Groups

This section provides steps to add any current user to a video group to access GPU resources. Use of the video group is recommended for all ROCm-supported operating systems.

To check the groups in your system, issue the following command:
```
groups
```
Add yourself to the render and video group using the command:
```
sudo usermod -a -G render,video $LOGNAME
```

To add all future users to the video and render groups by default, run the following commands:

echo 'ADD_EXTRA_GROUPS=1' | sudo tee -a /etc/adduser.conf
echo 'EXTRA_GROUPS=video' | sudo tee -a /etc/adduser.conf
echo 'EXTRA_GROUPS=render' | sudo tee -a /etc/adduser.conf

3.4 KiB Raw Blame History