How-To Install/Uninstall AMD Radeon™ Software AMDGPU-PRO Driver for Linux® on a Red Hat System

Article Number: GPU-637

​​​​​​​​Installing the AMDGPU-Pro Driver

There are three simple steps involved in the installation of the AMDGPU-Pro Driver: Download, Extract, and Install.  The instructions to perform the installation are intended for a Red Hat 7.3 or Red Hat 6.8 installation and should take less than 10 minutes to complete.  Before installing the driver, a quick note on how to check if your system alre ady has AMDGPU-PRO installed. In addition, the recommended best practice is to bring the system up-to-date before starting the driver installation, with:

yum update

System Check

The easiest way to find out if you have AMDGPU-Pro already installed on your Red Hat System is via an RPM query.  Using the following command at a terminal will provide you with the version of the AMDGPU-Pro stack on your system, or if providing no output, informs you that there are no packages found:

rpm -qa | grep amdgpu-pro

Download

A direct link to download the Linux AMDGPU-Pro driver is given below and it is also available on the Driver Download Page. This file has a "tar.xz" extension which reflects a more-effective c ompression algorithm that (in most cases) creates a smaller archive than the more common gzip format.

NOTE: This file can also be located via the Driver Download Page by locating your card and selecting the Linux Driver link.

Extract

After the archive is downloaded, extract the contents to a temporary location from which you can install it. The example below assumes you have downloaded the archive to /tmp and will extract to the same location. If your file was downloaded into the ~/Downloads/ folder by default, you can also extract and install from there, and afterwards you can remove the install files.

cd /tmp
tar -Jxvf amdgpu-pro-17.10-414273.tar.xz

Pre-Install

The AMDGPU-Pro driver requires access to specific RPMs from Red Hat installation media as well as Extra Packages for Enterprise Linux (EPEL) for purposes of dependency resolution.  A script named amdgpu-pro-pre-install.sh​ ​will confirm that all required prerequisite files and repositories are available in order to successfully install the AMDGPU-Pro driver in the Red Hat environment.  It can be run as follows:

sh amdgpu-pro-preinstall.sh --check

This will check if the required repositories are available to ensure a smooth installation. If there are any warnings, the script can be executed again without any options to build the necessary repositories

sh amdgpu-pro-preinstall.sh

Note that an internet connection will be required if EPEL is not found and Red Hat installation media from a DVD, USB key or a mounted ISO will be required if the system does not have an active Red Hat Subscription.

Install

Once the archive is expanded on the local machine and the amdgpu-pro-preinstall script has successfully confirmed all prerequisites, run the extracted script (amdgpu-pro-install) to install the graphics stack.  

cd amdgpu-pro-17.10-414273
./amdgpu-pro-install -y

Uninstalling the AMD GPU-PRO Driver

If for any reason you wish to remove the AMDGPU-PRO graphics stack you can do this using the uninstallation script which was part of the installation and is present in your path. From the command prompt enter the following command:

amdgpu-pro-uninstall


Footnotes