Files
my-vault/00_Inbox/Clippings/2023/04/Prerequisites.md
T

180 lines
5.1 KiB
Markdown
Raw Normal View History

2026-01-05 13:03:55 +08:00
---
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: