Installation prerequisites

Installation prerequisites#

Before installing the driver, complete the following prerequisites.

  1. Confirm the system has a supported Linux version.

    • To obtain the Linux distribution information, use the following command:

      uname -m && cat /etc/*release

    • Confirm that your Linux distribution matches a supported distribution.

      Example: Running the preceding command on an Ubuntu system produces the following output:

      x86_64
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=20.04
DISTRIB_CODENAME=focal
DISTRIB_DESCRIPTION="Ubuntu 20.04.5 LTS"

  1. Verify the kernel version.

    • To check the kernel version of your Linux system, type the following command:

      uname -srmv

      Example: The preceding command 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 your kernel version matches the system requirements, as listed in Supported operating systems.

Register your Enterprise Linux#

If you’re using Red Hat Enterprise Linux (RHEL) or SUSE Linux Enterprise Server (SLES), register your operating system to ensure you’re able to download and install packages.

There is no registration required for Ubuntu.

There is no registration required for Debian.

Typically you can register by following the step-by-step user interface. If you need to register by command line, use the following commands:

subscription-manager register --username <username> --password <password>
subscription-manager attach --auto

More details about registering for RHEL

There is no registration required for Oracle Linux.

Typically you can register by following the step-by-step user interface. If you need to register by command line, use the following commands:

sudo SUSEConnect -r <REGCODE>

More details about registering for SLES

There is no registration required for Azure Linux.

Update your Enterprise Linux#

If you are using Red Hat Enterprise Linux (RHEL) or SUSE Linux Enterprise Servers (SLES), or Oracle Linux, it is recommended that you update your operating system to the latest packages from the Linux distribution. This is a requirement for newer hardware on older versions of RHEL, SLES or OL.

There is no update required for Ubuntu.

There is no update required for Debian.

sudo dnf update --releasever=9.5 --exclude=\*release\*

sudo dnf update --releasever=9.4 --exclude=\*release\*

sudo dnf update --releasever=8.10 --exclude=\*release\*

sudo dnf update --releasever=9.5 --exclude=\*release\*

sudo dnf update --releasever=8.10 --exclude=\*release\*

sudo zypper update

There is no update required for Azure Linux.

Important

To apply all settings, reboot your system.

Kernel headers#

The driver package uses Dynamic Kernel Module Support (DKMS) 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.

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

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

sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" "kernel-devel-matched-$(uname -r)"

sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)"

sudo dnf install "kernel-uek-devel-$(uname -r)"

sudo zypper install kernel-default-devel

sudo tdnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)"
Contents