Radeon Software for Linux Installation

Article Number: AMDGPU-INSTALLATION

The amdgpu-pro Graphics stack is recommended for use with Radeon Pro graphics products. Use of amdgpu is recommended for all other products. Note that the instructions below are intended for use with systems running Ubuntu or RedHat/CentOS. They have been tested on Ubuntu 16.04.4 and a mix of RedHat 7.4, RedHat 7.3, CentOS 6.9 and SLED 12.

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-18.10-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-18.10-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

Installation Instructions for amdgpu All Open Graphics Stack

Install

  1. Install the All Open Graphics stack:
    ./amdgpu-install -y
  2. Reboot

 

Uninstall

  1. Removal of all components is accomplished by simply running the uninstall script from anywhere in the system:
    amdgpu-uninstall
  2. Reboot

Installation Instructions for amdgpu Pro Graphics Stack

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

  1. Install the Complete Graphics and Compute stack
    ./amdgpu-pro-install -y --opencl=pal
  1. Reboot

Vega10 and newer cards (when using the 18.Q1.1 Enterprise driver)

  1. Install the Complete Graphics and Compute stack
    ./amdgpu-pro-install -y --opencl=rocm
  2. Reboot

Pre Vega10

  1. Install the Complete Graphics and Compute stack
    ./amdgpu-pro-install -y --opencl=legacy
  2. Reboot

 

Uninstall

  1. Removal of all components is accomplished by simply running the uninstall script from anywhere in the system:
    amdgpu-pro-uninstall
  2. 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 below. 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:

--help | -h                      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=pal                    Install PAL OpenCL support

--opencl=rocm                 Install ROCm OpenCL support

--opencl=legacy,pal Install both legacy and PAL OpenCL support

--headless                       Headless installation (only OpenCL support)

--compute                           (DEPRECATED) Equal to --opencl=legacy --headless

Notes:

    • 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 & pal) are provided and can be installed side-by-side on the target system. Some examples below:

amdgpu-install --opencl=legacy

amdgpu-install --opencl=pal

amdgpu-install --opencl=legacy,pal

amdgpu-install --opencl=rocm (for the enterprise driver)

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.

Application Configuration Notes

Configure Mesa Multimedia Environment

This step is a temporary requirement for running multimedia applications with either variant.

export VDPAU_DRIVER_PATH=/opt/amdgpu/lib/x86_64-linux-gnu/vdpau
export VDPAU_DRIVER=radeonsi

Installation of LunarG Vulkan SDK

    • Add yourself to the video group
      sudo usermod -a -G video $LOGNAME

    • Log out and in again to activate the change.
    • Create a base directory (eg. ~/Downloads/vulkan)

      cd ~/Downloads
      mkdir vulkan
      cd vulkan
      export VULKAN_BASE=$HOME/Downloads/vulkan

    • Download installer from https://vulkan.lunarg.com/sdk/home#linux to the $VULKAN_BASE directory (eg. 1.0.70.0)

      ~/Downloads/vulkan/vulkansdk-linux-x86_64-1.0.70.0.run

    • Extract

      export VULKAN_VER=1.0.37.0
      chmod ugo+x vulkansdk-linux-x86_64-${VULKAN_VER}.run
      ./vulkansdk-linux-x86_64-${VULKAN_VER}.run

    • Setup environment

      export VULKAN_SDK=$VULKAN_BASE/VulkanSDK/$VULKAN_VER/x86_64
      export PATH=$PATH:$VULKAN_SDK/bin
      export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$VULKAN_SDK/lib
      export VK_LAYER_PATH=$VULKAN_SDK/etc/explicit_layer.d

    • Quick installation verification

      vulkaninfo | head

How to submit a bug report

  1. Create a destination folder so that you can easily pick up the files once you have gathered them. An example might be to use the date and add a number at the end if you gather many in a single day (eg.  first case on 13th September)
    LOGDIR=~/LOGS/20170913-1
    mkdir -p $LOGDIR
    cd $LOGDIR

  2. Gather Basic Configuration Details
    sudo lshw -c cpu | grep product >> basic.conf
    lspci -nn | grep "VGA\|Display" >> basic.conf
    sudo dmidecode -t BIOS | grep Version >> basic.conf
    lsb_release -sd >> basic.conf
    uname -a >> basic.conf
    dkms status | grep "amdgpu\|radeon" >> basic.conf

  3. More Detailed Log Files
    dkms status > dkms.status.log
    lsmod | grep amdgpu > lsmod.amdgpu.log
    dmesg > dmesg.log
    cp /var/log/Xorg.0.log .
    type -p dpkg && dpkg -l > package.log
    type -p rpm && rpm -qa > package.log

  4. Your Log directory should now contain the following list of files to be attached to the bug report
            1. basic.conf
            2. dkms.status.log
            3. lsmod.amdgpu.log
            4. dmesg.log
            5. Xorg.0.log
            6. package.log

  5. Add the following log files for a deeper investigation
    lspci -vnn > lspci.vnn.log
    lspci -nn > lspci.nn.log
    sudo dmidecode > dmidecode.log
    uname -a > uname.a.log
    lsinitramfs /boot/initrd.img-`uname -r` > lsinitramfs.log
    sudo lshw > lshw.log
    modinfo amdgpu > modinfo.amdgpu.log
    glxinfo > glxinfo.log


How to Capture the output of all your commands to file

    • Begin Capture
      script /tmp/install-log.txt

    • Run all the commands you wish capture (example: install all open base driver)
      sudo apt install amdgpu

    • End the Capture Session
      exit



Footnotes