The amdgpu-pro graphics stack is recommended for use with Radeon™ Pro graphics products. Use of amdgpu is recommended for all other products.
Note: The instructions below are intended for use with systems running Ubuntu or RedHat/CentOS. They have been tested on Ubuntu 16.04.3 and mix of RedHat 7.4, RedHat 7.3 and CentOS 6.9.
Installation Instructions for amdgpu All Open Graphics Stack
Preparation
- Download the amdgpu-pro tar archive containing the installation script (eg. to ~/Downloads).
- Extract the archive to a known location (Please replace the "NNNNNN" in the following commands with the actual build number of the downloaded file.)
cd ~/Downloads
tar -Jxvf amdgpu-pro-17.50-NNNNNN.tar.xz - Enter the directory where the downloaded archive was extracted (this is expected to be the same name as the archive file).
cd ~/Downloads/amdgpu-pro-17.50-NNNNNN
Install
- Install the All Open Graphics stack:
./amdgpu-install –y
- Reboot
Uninstall
- Removal of all components is accomplished by simply running the uninstall script from anywhere in the system.
amdgpu-uninstall
- Reboot
Installation Instructions for amdgpu-pro Graphics Stack
Preparation
- Download the amdgpu-pro tar archive containing the installation script (eg. to ~/Downloads).
- Extract the archive to a known location (Please replace the "NNNNNN" in the following commands with the actual build number of the downloaded file.)
cd ~/Downloads
tar -Jxvf amdgpu-pro-17.50-NNNNNN.tar.xz
- Enter the directory where the downloaded archive was extracted (this is expected to be the same name as the archive file).
cd ~/Downloads/amdgpu-pro-17.50-NNNNNN
Note (RedHat Only Pre-Install): An internet connection will be required if EPEL is not found and Red Hat or CentOS installation media from a DVD, USB key or a mounted ISO will be required if the system does not have an active Red Hat or CentOS Subscription.
The AMDGPU-Pro driver requires access to specific RPMs from Red Hat or CentOS installation media as well as Extra Packages for Enterprise Linux (EPEL) for purposes of dependency resolution. A script named amdgpu-pro-preinstall.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 or CentOS 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
Install
Within the Complete Graphics and Compute Stack, newer hardware will require a different OpenCL component to be installed. Please choose the correct install based on your installed Graphics product.
Vega10 and newer cards
- Install the Complete Graphics and Compute stack
./amdgpu-pro-install -y --opencl=rocm
- Reboot
Pre Vega10
- Install the Complete Graphics and Compute stack
./amdgpu-pro-install -y --opencl=legacy
- Reboot
Uninstall
- Removal of all components is accomplished by simply running the uninstall script from anywhere in the system:
amdgpu-pro-uninstall
- Reboot
amdgpu Graphics Stack Installation Options
The amdgpu Graphics Stack provides two scripts (amdgpu-install and amdgpu-pro-install) to help you install a coherent set of stack components. Both of these scripts support the same set of arguments, which will be detailed in this file. Although all the examples below show script invoked as amdgpu-install, the same arguments can be used with amdgpu-pro-install.
Option Summary
Here is presented the help provided directly from the script. It can be displayed on the command line by running the script with the -h or --help argument.
amdgpu-install -h
Options:
-h|--help | Display this help message |
--px | PX platform support |
--online | Force installation from an online repository |
--version=VERSION | Install the specified driver VERSION |
--pro | Install "pro" support (legacy OpenGL and Vulkan) |
--opencl=legacy | Install legacy OpenCL support |
--opencl=rocm | Install ROCm OpenCL support |
--opencl=legacy,rocm | Install both legacy and ROCm OpenCL support |
--headless | Headless installation (only OpenCL support) |
--compute | (DEPRECATED) Equal to --opencl=legacy --headless |
Unless the -h|--help option is given, 'apt-get' or 'aptitude' options may be present.
Unless headless installation is requested, OpenGL support will be installed.
When installing from an online repository, it is assumed the repository has been properly configured.
Installation of the specified version is always performed from an online repository.
Options
Non-Interactive Install
Using the argument -y informs the package management system to assume a yes answer for any interactive questions. This option allows the installation script to be itself embedded inside other automated scripts. Example usage:
amdgpu-install –y
OpenGL
OpenGL is an integral part of the Graphics Stack and unless headless installation is requested, OpenGL support will be installed.
OpenCL
OpenCL is an optional component of the Graphics Stack and is only installed if specifically requested. Two different implementations of OpenCL (legacy & rocm) are provided and can be installed side-by-side on the target system. Some examples below:
amdgpu-install --opencl=legacy
amdgpu-install --opencl=rocm
amdgpu-install --opencl=legacy,rocm
Vulkan
Vulkan support can be installed by using the --pro argument.:
amdgpu-install –pro
PX platform support
To enable PowerExpress support, use the px argument as follows:
amdgpu-install –px
Install from Server
--online Force installation from an online repository
--version=VERSION Install the specified driver VERSION
Headless Installation
--headless Headless installation (only OpenCL support)
Specific Package Management
More advanced functionality can be obtained by providing the installation script with arguments to pass through to the package management software of the operating system you are using. Users of Ubuntu and Redhat would use apt and yum respectively. For more information on these packages, see their man pages.
- Ubuntu/Debian : https://linux.die.net/man/8/apt
- Redhat/Fedora : https://linux.die.net/man/8/yum
Running OCL/Vulkan applications outside an X session
Ensure that your user account is a member of the "video" group prior to using the OCL/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 sudo privileges; you can issue the following command:
sudo usermod -a -G video $LOGNAME
You will need to log out and in again to activate this change.