Installation Instructions for amdgpu Pro / amdgpu All Open Graphics Stacks

Article Number: AMDGPU-INSTALLATION

Installation Instructions for amdgpu All Open Graphics Stack

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.

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

  • RedHat Only Pre-Install
    • Note that 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 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

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.

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

  • RedHat Only Pre-Install
    • Note that 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

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

  • 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

Help

The install script includes brief builtin help. To view the help, run:

./amdgpu-install --help

The Pro variant would use

./amdgpu-pro-install --help'

 


Footnotes