Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.
Some article numbers may have changed. If this isn't what you're looking for, try searching all articles. Search articles

Article Number: 000146178


Installing and Configuring AMDGPU-PRO in RHEL 6.9/7.3 and Up

Summary: This article describes the installation and configuration of the AMD-GPU driver for use in Red Hat Linux to enable HDMI audio.

Article Content


Symptoms

The open source AMDGPU driver does not support (currently) HDMI audio. Installing the following "hybrid" AMDGPU-PRO driver from AMD will resolve this issue.
Upgrades to RHEL/CentOS 7.4 won't be supported in this release – the recommended best practice is to hold off distribution upgrades until a supported version of AMDGPU-PRO is released.

AMDGPU-PRO only works in the 64-bit versions of RHEL 6.9/7.3 and CentOS 6.9/7.3 and up, and only with the following video cards:

  • Radeon™ RX Vega Series Graphics AMD Radeon Pro WX-series
  • Radeon Vega Frontier Edition AMD FirePro™ W9100
  • Radeon RX 550/560/570/580 Series Graphics AMD FirePro W8100
  • AMD Radeon RX 460/470/480 Graphics AMD FirePro W7100
  • AMD Radeon Pro Duo AMD FirePro™ W5100
  • AMD Radeon R9 Fury/Fury X/Nano Graphics AMD FirePro W4300
  • AMD Radeon R9 380/380X/390/390X Graphics AMD FirePro W4100
  • AMD Radeon R9 285/290/290X Graphics AMD FirePro W2100
  • AMD Radeon R7 240/250/250X/260/260X/350 AMD FirePro W600
  • AMD Radeon HD7700/7800/8500/8600 AMD FirePro S-Series
  • AMD Radeon R9 360 Graphics AMD Radeon Pro WX 9100
  • AMD Radeon R5 340

To determine what video card is installed in the system, run the following in terminal (ctrl+alt+t):
  • $ lspci -k | grep -EA2 'VGA|3D'

To determine if the driver is already installed, run the following in terminal (ctrl+alt+t) :

  • rpm -qa | grep amdgpu-pro

 

Installing the AMDGPU-PRO Driver

  1. Run the following in terminal:
    1. $ su root (use the password that you setup for your root account)
    2. yum update -y (to fully update your system's packages)
      • Reboot
    3. rpm -qa | grep amdgpu-pro (checks to see if the AMDGPU-PRO driver is already installed. If it produces an output, please see the removal steps at the end of this guide. Remove the old package before continuing on.)
  2. Download the newest AMDGPU-PRO driver from here - https://support.amd.com/en-us/download/workstation?os=Linux+x86_64#
Note: You will want to obtain the driver "Radeon Pro Software Enterprise Edition for RHEL 7.4 / CentOS 7.4"
  1.  Once the file is downloaded, run the following in terminal:
    • tar -Jxvf amdgpu-pro*/
    • cd amdgpu*

 

Configure The AMD-PRO Driver For Use

  1. Preinstallation:

    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-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 or CentOS environment.

    It can be run in terminal as follows:

    1. sh amdgpu-pro-preinstall.sh --check (Checks availability of the required repositories to ensure a smooth installation. If there are any warnings, the script can be executed again without any options to build the necessary repositories)
    2. sh amdgpu-pro-preinstall.sh
  2. Installation:

    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.

    1. cd amdgpu-pro*
    2. ./amdgpu-pro-install --compute
      NOTE: the 'compute' command has two dashes with no spaces
    3. reboot
  3. Configure:

    1. Group Changes:
      1. 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
      2. To add yourself to the video group, you will need the sudo password and can use the following command:
        • usermod -a -G video $LOGNAME
  4. GRUB changes:
    RHEL
    1. Edit /etc/default/grub as root and modify GRUB_CMDLINE_LINUX in order to add:
      • amdgpu.vm_fragment_size=9
    2. Update grub and reboot as root – to do that, find grub.cfg in your system, e.g:
      • On UEFI-based machines: grub2-mkconfig -o /boot/efi/EFI/redhat/grub.cfg;
      • On BIOS-based machines: grub2-mkconfig -o /boot/grub2/grub.cfg;
    3. Reboot
     
    CentOS
    1. Edit /etc/default/grub as root and modify GRUB_CMDLINE_LINUX in order to add:
      • amdgpu.vm_fragment_size=9
    2. Update grub and reboot as root – to do that, find grub.cfg in your system, e.g:
      • On UEFI-based machines: grub2-mkconfig -o /boot/efi/EFI/redhat/grub.cfg;
      • On BIOS-based machines: grub2-mkconfig -o /boot/grub2/grub.cfg;
    3. Reboot
 
  • Verify Functionality:

    Run the following in terminal (ctrl+alt+t):

    1. lspci -k | grep -EA3 'VGA|3D|Display'  (This command will indicate the video card installed and the kerneled driver in use. If working, you should see it say "amdgpu.")
    2. yum install mesa-utils (This installs a package used for the next steps.)
    3. glxinfo | grep OpenGL (This is another check to demonstrate if the AMD card is seen and working.)
    4. glxinfo | grep "direct rendering" (If it says yes, then your AMD card is working and not using the processor for graphics.)
 

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
 

Optional ROCm Component


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
 

Cause

No cause associated.

Resolution

No resolution associated.

Article Properties


Affected Product

Red Hat Enterprise Linux Version 6, Red Hat Enterprise Linux Version 7, Red Hat Enterprise Linux Version 8

Last Published Date

10 Dec 2021

Version

4

Article Type

Solution