Installing or Uninstalling AMDGPU¶
Table of Contents
Installing the All-Open Variant¶
Run the following command to install the All-Open variant:
$ ./amdgpu-install -y
Note
The -y
option installs non-interactively. See
Using the amdgpu-install script for more
information.
Reboot the target system after running amdgpu-install
.
Installing the Pro Variant¶
Refer to the following table to understand how to install a combination of Pro components:
Command | Installed Components |
$ ./amdgpu-pro-install -y |
|
$ ./amdgpu-pro-install -y --opencl=rocr,legacy |
|
$ ./amdgpu-pro-install -y --opencl=rocr,legacy --headless |
|
Reboot the target system after running amdgpu-pro-install
.
For more information, refer to the following sections to understand how to install individual components.
OpenGL (Default Component)¶
OpenGL is a default component of the Pro variant.
Note
Unless a headless installation is requested, OpenGL is installed.
OpenCL (Optional Component)¶
OpenCL is an optional component of the Pro variant and is installed only if it is specifically requested.
Two different implementations of OpenCL (legacy and ROCr) are provided. Either of these implementations or both of them can be installed on the target system.
To use the ROCr implementation of OpenCL, the running user might need
additional permissions depending on OS policy. If clinfo
or any openCL
application does not work, check ownership and permissions of the render
nodes:
ls -l /dev/dri/render*
If the render nodes are owned by group render but not readable and writable by all users, consider adding the current user to the render group:
sudo usermod -a -G render $LOGNAME
If you are an administrator, $LOGNAME
can be replaced by any valid
username.
Alternatively, if the render nodes are owned by the video group but not readable and writable by all users, consider adding the current user to the video group:
sudo usermod -a -G video $LOGNAME
Different Linux distributions have different ownership and permission policies for render nodes. In addition, your organization may have its own policies that override the distribution defaults. If unsure, consult the documentation for your distribution or your organization.
In some scenarios, it may be desirable to install only the OpenCL portion
of the Pro variant (omitting the OpenGL portion), which can be accomplished
by adding the --headless
option. The typical use case is headless compute.
Vulkan (Default Component)¶
Vulkan is a default component of the Pro variant.
Note
Unless a headless installation is requested, Vulkan is installed.
PX Platform Support (Ubuntu only)¶
Note
PX is deprecated in the latest version of the AMDGPU Graphics Stack. The All-Open variant with PRIME GPU offloading is recommend for all mobile variants with hybrid graphics, which allows GPU workloads to be offloaded to a discrete GPU on demand.
For PX (PowerExpress) platform support, use the --px
option as shown in
the following command:
$ ./amdgpu--pro-install --px
Uninstalling the AMDGPU Graphics Stack¶
To remove all components of the stack, run the uninstall script from anywhere in the system.
Based on whether you installed the All-Open or Pro components, run one of the following commands:
# Use this for All-Open components $ amdgpu-uninstall # Use this for Pro components $ amdgpu-pro-uninstall
After uninstalling the components, reboot the target system.