Using the amdgpu-install
Script¶
Script Types¶
The AMDGPU stack offers the following script to help you install a coherent set of stack components:
amdgpu-install
This script supports a set of arguments that are explained in the following sections of this page.
Invoking the amdgpu-install
Script¶
Once you have installed the installer package, invoke the script as
amdgpu-install
from a terminal.
Note
Use of the -y
option is recommended to avoid prompts from the
package manager.
Scenarios¶
Specifying an OpenCL Implementation¶
There is currently only one OpenCL implementations available:
ROCr: Provides support for Vega 10 and newer hardware.
Note
To use the ROCr implementation of OpenCL, the running user might need additional permissions. Usually the user must be added to the “render” group or to the “video” group. See the notes in OpenCL (Optional Component) for more details.
OpenCL is installed using the --opencl
option, as follows:
Option |
Description |
|
Installs ROCr OpenCL. |
Specifying a Vulkan Implementation¶
There are two Vulkan implementations available:
AMDVLK: Provides open source Vulkan
PRO: Provides PRO vulkan (Proprietary, requires EULA acceptance)
You can either install one or both implementations.
Vulkan is installed using the --vulkan
option, as follows:
Option |
Description |
|
Installs open source Vulkan |
|
Installs PRO Vulkan (Proprietary) |
|
Installs both open and PRO Vulkan. |
Viewing Help or Usage Output¶
Executing the script with -h
or --help
argument provides the help or
usage output.
$ amdgpu-install -h
Installing Non-Interactively¶
Using the argument -y
informs the package management system to assume
the answer yes for any interactive question. The --accept-eula
option
will skip the first time install prompt for the user to accept the EULA.
These options allow the install script to embed itself inside other automated scripts.
Example:
$ amdgpu-install -y --accept-eula
Note
The --accept-eula
option is only required for proprietary
components, which require acceptance of the EULA. By using this option,
you are confirming that you have read and agreed to be bound by the terms
and conditions of the EULA (/usr/share/amdgpu-insall/AMDGPUPROEULA) for
use of AMD Proprietary components.
Adding Advanced Package Management Functionality¶
More advanced functionality can be obtained by providing the installation script with arguments to pass through to the package management software of the distribution you are using.
On Ubuntu, refer to the apt man page for more information.
On Red Hat, refer to yum man page for more information.