Prerequisites


Removing existing installation

If the AMDGPU stack has been previously installed on the target system, it is highly recommended to uninstall prior to installing the upgraded stack. While upgrading the stack with the package manager will often work without issue, installing the stack on a clean system is recommended for best results.

See Uninstalling the AMDGPU stack for uninstall instructions.


Downloading the Installer Package

The AMDGPU stack is delivered as an installer package. Prior to installation, you must first obtain the installer package from your AMD Customer Engagement Representative, from the AMD web site, or from repo.radeon.com.

Download the installer package to the system (for example, to ~/Downloads), and install it using the package manager, which will make the installation script available on your system.


Configuring Access to the Distribution Repository (RHEL and SLE only)

AMDGPU stack depends on packages provided by the Linux distribution vendors.

The AMDGPU stack requires access to specific RPMs from Red Hat Enterprise Linux (RHEL) or SUSE Linux Enterprise (SLE) installation media for the purpose of dependency resolution. You must ensure one of the following:

  • Have a valid subscription and be connected to Internet during installation.
  • Mount an installation media (for example, DVD, USB key or ISO file). Media mounting instructions for Red Hat systems are provided at https://access.redhat.com/solutions/1355683. For SLE, use YaST to add the installation media as a new repository, see the SUSE documentation for details.

Note

It is assumed most customers have a subscription with access to online repositories or are using a Linux distribution which does not require a subscription and has online repositories enabled by default.


Update the Operating System

Before installing the AMDGPU stack, it’s recommended to update your system:

# For Ubuntu:
$ sudo apt-get update
$ sudo apt-get dist-upgrade
# For RHEL:
$ sudo yum update
# For SLE:
$ sudo zypper update

Installing the Installer Package

In the following commands, replace amdgpu-install-VERSION.{deb,rpm} with the actual file name of the downloaded installer package:

$ cd ~/Downloads
# For Ubuntu:
$ sudo apt-get install ./amdgpu-install-VERSION.deb
$ sudo apt-get update
# For RHEL:
$ sudo yum install ./amdgpu-install-VERSION.rpm
# For SLE:
$ sudo zypper install ./amdgpu-install-VERSION.rpm

Note

Installing “amdgpu-install” will add the installer and AMD related repositories to your system. The repositories will be accessible to the system package manager, which is in turn used by the installer.