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

Article Number: GPU-638

​​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 CentOS 6.8 and 7.3 installation and should take less than 10 minutes to complete.  Before installing the driver, a quick note on how to check if your system already has AMDGPU-PRO installed. In addition, the recommended best practice is to bring the system up-to-date before starting the driver installation, with:

sudo yum update
sudo reboot

System Check
The easiest way to find out if you have AMDGPU-Pro already installed on your CentOS 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 compression 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-450821.tar.xz

Pre-Install
The AMDGPU-Pro driver requires access to specific RPMs from CentOS 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 Centos environment. It can be run as follows:

sudo 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

sudo sh amdgpu-pro-preinstall.sh

Note that an internet connection will be required if EPEL is not found as well as to download any Centos RPMs for purposes of dependency resolution.
         
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-450821
./amdgpu-pro-install -y
sudo reboot


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