mirror of
https://github.com/ROCm/ROCm.git
synced 2026-02-04 11:25:03 -05:00
a471e8debe
The hip-devel package depends on perl modules not distributed by default on RHEL and SLES distriubutions, these can be installed from EPEL and the `devel:languages:perl` repository respectively. Ideally in the future these dependencies would be replaced with packages available from default repositories, but in the meanwhile this should be at least documented.
195 lines
4.7 KiB
Markdown
195 lines
4.7 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`.
|
|
|
|
## Additional package repositories
|
|
|
|
On some distributions the ROCm packages depend on packages outside the default
|
|
package repositories. These extra repositories need to be enabled before
|
|
installation. Follow the instructions below based on your distributions.
|
|
|
|
::::::{tab-set}
|
|
|
|
:::::{tab-item} Ubuntu
|
|
:sync: ubuntu
|
|
|
|
All packages are available in the default Ubuntu repositories, therefore
|
|
no additional repositories need to be added.
|
|
|
|
:::::
|
|
:::::{tab-item} Red Hat Enterprise Linux
|
|
:sync: RHEL
|
|
|
|
::::{rubric} 1. Add the EPEL repository
|
|
::::
|
|
|
|
::::{tab-set}
|
|
:::{tab-item} RHEL 8
|
|
:sync: RHEL-8
|
|
|
|
```shell
|
|
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
|
|
sudo rpm -ivh epel-release-latest-8.noarch.rpm
|
|
```
|
|
|
|
:::
|
|
:::{tab-item} RHEL 9
|
|
|
|
```shell
|
|
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
|
|
sudo rpm -ivh epel-release-latest-9.noarch.rpm
|
|
```
|
|
|
|
:::
|
|
::::
|
|
|
|
::::{rubric} 2. Enable the CodeReady Linux Builder repository
|
|
::::
|
|
|
|
Run the following command and follow the instructions.
|
|
|
|
```shell
|
|
sudo crb enable
|
|
```
|
|
|
|
:::::
|
|
:::::{tab-item} SUSE Linux Enterprise Server 15
|
|
|
|
Add the perl languages repository.
|
|
|
|
```shell
|
|
zypper addrepo https://download.opensuse.org/repositories/devel:languages:perl/SLE_15_SP4/devel:languages:perl.repo
|
|
```
|
|
|
|
:::::
|
|
::::::
|
|
|
|
## 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
|
|
```
|