mirror of
https://github.com/ROCm/ROCm.git
synced 2026-02-04 19:35:02 -05:00
a42fae5140
* 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
133 lines
3.4 KiB
Markdown
133 lines
3.4 KiB
Markdown
# 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:
|
|
|
|
1. To obtain the Linux distribution information, type the following command on
|
|
your system from the Command Line Interface (CLI):
|
|
|
|
```shell
|
|
uname -m && cat /etc/*release
|
|
```
|
|
|
|
2. 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:
|
|
|
|
```shell
|
|
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:
|
|
|
|
1. To check the kernel version of your Linux system, type the following command:
|
|
|
|
```shell
|
|
uname -srmv
|
|
```
|
|
|
|
**Example:** The output of the command above lists the kernel version in the
|
|
following format:
|
|
|
|
```output
|
|
Linux 5.15.0-46-generic #44~20.04.5-Ubuntu SMP Fri Jun 24 13:27:29 UTC 2022 x86_64
|
|
```
|
|
|
|
2. 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)`][DKMS-wiki] 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.
|
|
|
|
[DKMS-wiki]: https://en.wikipedia.org/wiki/Dynamic_Kernel_Module_Support
|
|
|
|
To install for the currently active kernel run the command corresponding
|
|
to your distribution.
|
|
|
|
::::{tab-set}
|
|
:::{tab-item} Ubuntu
|
|
:sync: ubuntu
|
|
|
|
```shell
|
|
sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)"
|
|
```
|
|
|
|
:::
|
|
|
|
:::{tab-item} Red Hat Enterprise Linux
|
|
:sync: RHEL
|
|
|
|
```shell
|
|
sudo yum install kernel-headers kernel-devel
|
|
```
|
|
|
|
:::
|
|
|
|
:::{tab-item} SUSE Linux Enterprise Server
|
|
:sync: SLES
|
|
|
|
```shell
|
|
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.
|
|
|
|
1. To check the groups in your system, issue the following command:
|
|
|
|
```shell
|
|
groups
|
|
```
|
|
|
|
2. Add yourself to the `render` and `video` group using the command:
|
|
|
|
```shell
|
|
sudo usermod -a -G render,video $LOGNAME
|
|
```
|
|
|
|
To add all future users to the `video` and `render` groups by default, run
|
|
the following commands:
|
|
|
|
```shell
|
|
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
|
|
```
|