180 lines
5.1 KiB
Markdown
Executable File
180 lines
5.1 KiB
Markdown
Executable File
---
|
||
page-title: "Prerequisites"
|
||
url: https://docs.amd.com/bundle/ROCm-Installation-Guide-v5.4.3/page/Prerequisites.html
|
||
date: "2023-04-23 18:20:19"
|
||
---
|
||
## Prerequisites
|
||
|
||
You must perform the following steps before installing ROCm and check if the system meets all the requirements to proceed with the installation.
|
||
|
||
Follow these steps:
|
||
|
||
1. Confirm the system has a supported Linux distribution version.
|
||
|
||
2. Confirm the system has a ROCm-capable GPU.
|
||
|
||
3. Confirm the system has all the required tools and packages installed.
|
||
|
||
## Confirm the System Has a Supported Linux Distribution Version
|
||
|
||
The ROCm installation is supported only on specific Linux distributions and kernel versions.
|
||
|
||
NOTE:
|
||
|
||
ROCm installation is not supported on 32-bit operating systems.
|
||
|
||
### Check the Linux Distribution and Kernel Version on Your System
|
||
|
||
This section discusses obtaining information about the Linux distribution and kernel version.
|
||
|
||
#### Linux Distribution Information
|
||
|
||
Verify the Linux distribution using the following steps:
|
||
|
||
1. To obtain the Linux distribution information, type the following command on your system from the Command Line Interface (CLI):
|
||
|
||
**2.** Confirm that the obtained Linux distribution information matches with [System Requirements.](https://docs.amd.com/bundle/ROCm-Installation-Guide-v5.4.3/page/Introduction_to_ROCm_Installation_Guide_for_Linux.html#d4616e529)
|
||
|
||
**E****xample****:** Running the command above on an Ubuntu system results in the following output:
|
||
|
||
#### Kernel Information
|
||
|
||
Verify the kernel version using the following steps:
|
||
|
||
1. To check the kernel version of your Linux system, type the following command:
|
||
|
||
2. Confirm that the obtained kernel version information matches with [System Requirements.](https://docs.amd.com/bundle/ROCm-Installation-Guide-v5.4.3/page/Introduction_to_ROCm_Installation_Guide_for_Linux.html#d4616e529)
|
||
|
||
**Example:** The output of the command above lists the kernel version in the following format:
|
||
|
||
## Confirm the System has a ROCm-Capable GPU
|
||
|
||
The ROCm platform is designed to support the following GPUs:
|
||
|
||
**Table 2****.** **GPU** **S****upport for** **ROCm** **P****rogramming** **M****odels**
|
||
|
||
**Classification**
|
||
|
||
**GPU Name**
|
||
|
||
**GFX** **ID**
|
||
|
||
**Product Id**
|
||
|
||
**GFX9 GPUs**
|
||
|
||
AMD Radeon Instinct™ MI50
|
||
|
||
gfx906
|
||
|
||
Vega 20
|
||
|
||
AMD Radeon Instinct™ MI60
|
||
|
||
AMD Radeon™ VII
|
||
|
||
AMD Radeon™ Pro VII
|
||
|
||
**RDNA GPUs**
|
||
|
||
AMD Radeon™ Pro W6800
|
||
|
||
gfx1030
|
||
|
||
Navi 21 GL-XL
|
||
|
||
AMD Radeon™ Pro V620
|
||
|
||
Navi 21 GL-XE
|
||
|
||
**CDNA GPUs**
|
||
|
||
AMD Instinct™ MI100
|
||
|
||
gfx908
|
||
|
||
Arcturus
|
||
|
||
AMD Instinct™ MI200
|
||
|
||
gfx90a
|
||
|
||
Aldebaran
|
||
|
||
### Verify Your System Has a ROCm-Capable GPU
|
||
|
||
To verify that your system has a ROCm-capable GPU, use these steps:
|
||
|
||
1. Enter the following command from the Command Line Interface (CLI):
|
||
|
||
The command displays the details of detected GPUs on the system in the following format in the case of AMD Instinct™ MI200:
|
||
|
||
2. Verify from the output that the listed product names match with the Product Id given in the table above.
|
||
|
||
## Confirm the System Has All the Required Tools and Packages Installed
|
||
|
||
To check if the required tools and packages are available on the system, refer the following sections.
|
||
|
||
### Required Packages
|
||
|
||
Verify if the wget, gnupg2, gawk and curl packages are available on your system using the following command based on your OS distribution:
|
||
|
||
**U****buntu****/D****ebian**
|
||
|
||
**RHEL**
|
||
|
||
**SLES/O****pen****SUSE**
|
||
|
||
If the wget, gnupg2, gawk and curl packages are not available on your system, install using the following commands based on your OS distribution:
|
||
|
||
**U****buntu****/D****ebian**
|
||
|
||
**RHEL**
|
||
|
||
**SLES/O****pen****SUSE**
|
||
|
||
### Register the System to the Subscription Manager
|
||
|
||
**RHEL v8.x/9.x**
|
||
|
||
To register RHEL v8.x/9.x system to the subscription manager, refer to the following documentation:
|
||
|
||
[https://access.redhat.com/solutions/253273](https://access.redhat.com/solutions/253273)
|
||
|
||
**SLES** **15** **SP****4**
|
||
|
||
To register SLES 15 SP4 system, refer to the following documentation:
|
||
|
||
[https://documentation.suse.com/sles/12-SP5/single-html/SLES-smt/index.html](https://documentation.suse.com/sles/12-SP5/single-html/SLES-smt/index.html)
|
||
|
||
### Enable Additional Repositories
|
||
|
||
Use the following commands to get the required tools and packages.
|
||
|
||
**RHEL** **v****8.x**
|
||
|
||
Install the EPEL repository and enable the CodeReady Linux Builder repository on RHEL v8.x using the commands below:
|
||
|
||
**RHEL** **v9****.x**
|
||
|
||
Use the following command to download and install EPEL from [https://dl.fedoraproject.org](https://dl.fedoraproject.org/) for RHEL v9.x:
|
||
|
||
**SLES** **15** **SP4**
|
||
|
||
Add the perl repository using the following commands:
|
||
|
||
### Setting Permissions for Groups
|
||
|
||
This section provides steps to add any current user to a video group to access GPU resources.
|
||
|
||
1. To check the groups in your system, issue the following command:
|
||
|
||
2. Add yourself to the render or video group using the following instruction:
|
||
|
||
3. Use of the video group is recommended for all ROCm-supported operating systems.
|
||
|
||
NOTE:
|
||
|
||
render group is required only for Ubuntu v20.04.
|
||
|
||
To add future users to the video and render groups, run the following command: |