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

Article Number: GPU-643

​​​​​​​​​​​​​​Notice
This driver is not compatible with Ubuntu 16.04.3 HWE.  Please refer to this advisory for details.

Installing the AMDGPU-PRO Driver

There are four simple steps involved in the installation of the AMDGPU-Pro Driver: Download, Extract, Install and Configure.  The instructions to perform the installation are intended for an Ubuntu installation of 16.04.2, 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 apt update
sudo apt dist-upgrade
sudo reboot

System Check
The easiest way to find out if you have AMDGPU-Pro already installed on your Ubuntu System is to query the Debian package manager. 

Using the following command at a terminal will provide you with the version of the AMDGPU-Pro stack on your system, or inform you that there are no packages found:

dpkg -l 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 ca​n 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

Install
Once the archive is expanded on the local machine, run the included script (amdgpu-pro-install) to install the graphics stack.  During the installation you will be required to provide sudo access, and also to provide two confirmations to:

  1. Install the packages, and
  2. Allow installation of "unverified" packages from the AMDGPU-PRO archive.


The script will use the package manager to install the components of the graphics stack, with a short delay during the DKMS (Dynamic Kernel Module Support) installation. From the directory where you extracted the archive, issue the following command:

cd amdgpu-pro-17.20-445420​
./amdgpu-pro-install -y
sudo reboot​


After this you can restart your machine to launch using the new graphics stack.

Configure
Ensure that your user account is a member of the "video" group prior to using the vulkan driver. You can find which groups you are a member of with the following command:
 
groups
          
To add yourself to the video group you will need the sudo password and can use the following command:

sudo usermod -a -G video $LOGNAME 

You will need to log out and in again to activate this change.
 
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

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 apt install -y rocm-amdgpu-pro

Configuring the Optional ROCm Component

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