mirror of
https://github.com/ROCm/ROCm.git
synced 2026-02-04 03:15:28 -05:00
213 lines
4.9 KiB
Markdown
213 lines
4.9 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}`linux-support`.
|
|
|
|
**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}`linux-support`.
|
|
|
|
## 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
|
|
:sync: 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
|
|
:sync: SLES
|
|
|
|
Add the perl languages repository.
|
|
|
|
::::{tab-set}
|
|
:::{tab-item} SLES 15.4
|
|
:sync: SLES-15.4
|
|
|
|
```shell
|
|
zypper addrepo https://download.opensuse.org/repositories/devel:languages:perl/SLE_15_SP4/devel:languages:perl.repo
|
|
```
|
|
|
|
:::
|
|
:::{tab-item} SLES 15.5
|
|
:sync: SLES-15.5
|
|
|
|
```shell
|
|
zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/perl/15.5/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
|
|
```
|
|
|
|
:::
|
|
::::
|
|
|
|
(linux_group_permissions)=
|
|
|
|
## 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
|
|
```
|