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

Article Number: GPU-641

​​​​​​​​​​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.9 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 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 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.20-445420.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.20-445420
./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

Installing the Optional ROCm Component with Red Hat 7.3

This AMDGPU-Pro driver package incorporates the ROCm component that can be optionally installed for running Compute/OpenCL applications. You can install the component by issuing the following command

sudo yum install -y rocm-amdgpu-pro

Configuring the Optional ROCm Component with Red Hat 7.3

The LLVM_BIN environment variable needs to be set prior to running ROCm applications.

To set it temporarily when running an individual ROCm command, such as clinfo, use:

env LLVM_BIN=/opt/amdgpu-pro/bin /opt/amdgpu-pro/bin/clinfo

To set it permanently for all bash and other sh-like shell users, you can use the following command:

echo 'export LLVM_BIN=/opt/amdgpu-pro/bin' | sudo tee /etc/profile.d/amdgpu-pro.sh

See the Ubuntu Environment Variables Community Help for more information.

To set it permanently for all csh users, you can use the following command:

echo 'setenv LLVM_BIN /opt/amdgpu-pro/bin' | sudo tee /etc/profile.d/amdgpu-pro.csh


Footnotes