diff --git a/docs/deploy/linux/install_overview.md b/docs/deploy/linux/install_overview.md index 17d243074..848eb1254 100644 --- a/docs/deploy/linux/install_overview.md +++ b/docs/deploy/linux/install_overview.md @@ -50,6 +50,12 @@ The multi-version installation refers to the following: ability to support multiple versions of packages simultaneously. - Use of versioned ROCm meta-packages. +```{attention} +ROCm packages that were previously installed from a single-version installation +must be removed before proceeding with the multi-version installation to avoid +conflicts. +``` + ```{note} Multiversion install is not available for the kernel driver module, also referred to as AMDGPU. ``` diff --git a/docs/deploy/linux/installer/install.md b/docs/deploy/linux/installer/install.md index 9229d28e7..91ab4652b 100644 --- a/docs/deploy/linux/installer/install.md +++ b/docs/deploy/linux/installer/install.md @@ -41,6 +41,7 @@ sudo apt install ./amdgpu-install_5.5.50501-1_all.deb ::::{tab-set} :::{tab-item} RHEL 8.6 :sync: RHEL-8.6 +:sync: RHEL-8 ```shell sudo yum install https://repo.radeon.com/amdgpu-install/5.5.1/rhel/8.6/amdgpu-install-5.5.50501-1.el8.noarch.rpm @@ -49,35 +50,21 @@ sudo yum install https://repo.radeon.com/amdgpu-install/5.5.1/rhel/8.6/amdgpu-in ::: :::{tab-item} RHEL 8.7 :sync: RHEL-8.7 +:sync: RHEL-8 ```shell sudo yum install https://repo.radeon.com/amdgpu-install/5.5.1/rhel/8.7/amdgpu-install-5.5.50501-1.el8.noarch.rpm ``` -::: -:::{tab-item} RHEL 8.8 -:sync: RHEL-8.8 - -```shell -sudo yum install https://repo.radeon.com/amdgpu-install/5.5.1/rhel/8.8/amdgpu-install-5.5.50501-1.el8.noarch.rpm -``` - ::: :::{tab-item} RHEL 9.1 :sync: RHEL-9.1 +:sync: RHEL-9 ```shell sudo yum install https://repo.radeon.com/amdgpu-install/5.5.1/rhel/9.1/amdgpu-install-5.5.50501-1.el8.noarch.rpm ``` -::: -:::{tab-item} RHEL 9.2 -:sync: RHEL-9.2 - -```shell -sudo yum install https://repo.radeon.com/amdgpu-install/5.5.1/rhel/9.2/amdgpu-install-5.5.50501-1.el8.noarch.rpm -``` - ::: :::: ::::: @@ -172,12 +159,6 @@ the latest release of ROCm that you wish to install. simultaneously, you are required to download the installer from the latest ROCm release v5.5.1. -```{attention} -ROCm packages that were previously installed from a single-version installation -must be removed before proceeding with the multi-version installation to avoid -conflicts. -``` - ### Add Required Repositories You must add the ROCm repositories manually for all ROCm releases @@ -220,12 +201,16 @@ sudo apt update :::::{tab-item} Red Hat Enterprise Linux :sync: RHEL +::::{tab-set} +:::{tab-item} RHEL 8 +:sync: RHEL-8 + ```shell for ver in 5.3.3 5.4.3; do sudo tee --append /etc/yum.repos.d/rocm.repo < /dev/null +``` -**Example:** If the system is running the Linux kernel version -`5.15.0-41-generic`, you must install the identical versions of Linux-headers -and development packages. Refer to {ref}`check-kernel-info` on to how to check -the system's kernel version. +```{note} +The GPG key may change; ensure it is updated when installing a new release. If +the key signature verification fails while updating, re-add the key from the +ROCm to the apt repository as mentioned above. The current `rocm.gpg.key` is not +available in a standard key ring distribution but has the following SHA1 sum +hash: `73f5d8100de6048aa38a8b84cd9a87f05177d208 rocm.gpg.key` +``` -To check the `kernel-headers` and `linux-modules-extra` package versions, -follow these steps: - -1. For the Ubuntu/Debian environment, execute the following command to verify - the kernel headers and development packages are installed with the - respective versions: - - ```shell - sudo dpkg -l | grep linux-headers - ``` - - The command indicates if there are Linux headers installed as shown below: - - ```none - ii linux-headers-5.15.0-41-generic 5.15.0-41.44~20.04.1 amd64 Linux kernel headers for version 5.15.0 on 64 bit x86 SMP - ``` - -2. Execute the following command to check whether the development packages are - installed: - - ```shell - sudo dpkg -l | grep linux-modules-extra - ``` - - The command mentioned above lists the installed `linux-modules-extra` - packages like the output below: - - ```none - ii linux-modules-extra-5.15.0-41-generic 5.15.0-41.44~20.04.1 amd64 Linux kernel extra modules for version 5.15.0 on 64 bit x86 SMP - ``` - -3. If the supported version installation of Linux headers and development - packages are not installed on the system, execute the following command - to install the packages: - - ```shell - sudo apt install linux-headers-`uname -r` linux-modules-extra-`uname -r` - ``` - -::::{rubric} Adding the AMDGPU and ROCm Stack Repositories +::::{rubric} 2. Add the AMDGPU Repository and Install the Kernel-mode Driver :::: -1. Add GPG Key for AMDGPU and ROCm Stack +```{tip} +If you have a version of the kernel-mode driver installed, you may skip this +section. +``` - Add the GPG key for AMDGPU and ROCm repositories. For Debian-based systems - like Ubuntu, configure the Debian ROCm repository as follows: +To add the AMDGPU repository, follow these steps: - ```shell - curl -fsSL https://repo.radeon.com/rocm/rocm.gpg.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/rocm-keyring.gpg - ``` +::::{tab-set} +:::{tab-item} Ubuntu 20.04 +:sync: ubuntu-20.04 - ```{note} - The GPG key may change; ensure it is updated when installing a new release. If - the key signature verification fails while updating, re-add the key from the - ROCm to the apt repository as mentioned above. The current `rocm.gpg.key` is not - available in a standard key ring distribution but has the following SHA1 sum - hash: `73f5d8100de6048aa38a8b84cd9a87f05177d208 rocm.gpg.key` - ``` +```shell +# amdgpu repository for focal +echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.5.1/ubuntu focal main' \ + | sudo tee /etc/apt/sources.list.d/amdgpu.list +sudo apt update +``` -2. Add the AMDGPU Repository and Install the Kernel-mode Driver +::: +:::{tab-item} Ubuntu 22.04 +:sync: ubuntu-22.04 - ```{attention} - If you have a version of the kernel-mode driver installed, you may skip this - section. - ``` +```shell +# amdgpu repository for jammy +echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/5.5.1/ubuntu jammy main' \ + | sudo tee /etc/apt/sources.list.d/amdgpu.list +sudo apt update +``` - To add the AMDGPU repository, follow these steps: +::: +:::: - ::::{tab-set} - :::{tab-item} Ubuntu 20.04 - :sync: ubuntu-20.04 +Install the kernel mode driver and reboot the system using the following +commands: - ```shell - echo 'deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/rocm-keyring.gpg] https://repo.radeon.com/amdgpu/5.5.1/ubuntu focal main' | sudo tee /etc/apt/sources.list.d/amdgpu.list - sudo apt update - ``` +```shell +sudo apt install amdgpu-dkms +sudo reboot +``` - ::: - :::{tab-item} Ubuntu 22.04 - :sync: ubuntu-22.04 +::::{rubric} 3. Add the ROCm Repository +:::: - ```shell - echo 'deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/rocm-keyring.gpg] https://repo.radeon.com/amdgpu/5.5.1/ubuntu jammy main' | sudo tee /etc/apt/sources.list.d/amdgpu.list - sudo apt update - ``` +To add the ROCm repository, use the following steps: - ::: - :::: +::::{tab-set} +:::{tab-item} Ubuntu 20.04 +:sync: ubuntu-20.04 - Install the kernel mode driver and reboot the system using the following - commands: +```shell +# ROCm repositories for focal +for ver in 5.3.3 5.4.3 5.5.1; do +echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/$ver focal main" \ + | sudo tee --append /etc/apt/sources.list.d/rocm.list +done +echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' \ + | sudo tee /etc/apt/preferences.d/rocm-pin-600 +sudo apt update +``` - ```shell - sudo apt install amdgpu-dkms - sudo reboot - ``` +::: +:::{tab-item} Ubuntu 22.04 +:sync: ubuntu-22.04 -3. Add the ROCm Repository and Install Meta-packages +```shell +# ROCm repositories for jammy +for ver in 5.3.3 5.4.3 5.5.1; do +echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/$ver jammy main" \ + | sudo tee --append /etc/apt/sources.list.d/rocm.list +done +echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' \ + | sudo tee /etc/apt/preferences.d/rocm-pin-600 +sudo apt update +``` - To add the ROCm repository, use the following steps: +::: +:::: - ::::{tab-set} - :::{tab-item} Ubuntu 20.04 - :sync: ubuntu-20.04 +::::{rubric} 4. Install packages +:::: - ```shell - for ver in 5.3.3 5.5.1; do - echo "deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/rocm-keyring.gpg] https://repo.radeon.com/rocm/apt/$ver focal main" | sudo tee /etc/apt/sources.list.d/rocm.list - done - echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' | sudo tee /etc/apt/preferences.d/rocm-pin-600 - sudo apt update - ``` - - ::: - :::{tab-item} Ubuntu 22.04 - :sync: ubuntu-22.04 - - ```shell - for ver in 5.3.3 5.5.1; do - echo "deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/rocm-keyring.gpg] https://repo.radeon.com/rocm/apt/$ver jammy main" | sudo tee --append /etc/apt/sources.list.d/rocm.list - done - echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' | sudo tee /etc/apt/preferences.d/rocm-pin-600 - sudo apt update - ``` - - ::: - :::: - - Install packages of your choice in a single-version ROCm install or - in a multi-version ROCm install fashion. For more information on what - single/multi-version installations are, refer to {ref}`installation-types`. - For a comprehensive list of meta-packages, refer to - {ref}`meta-package-desc`. +Install packages of your choice in a single-version ROCm install or +in a multi-version ROCm install fashion. For more information on what +single/multi-version installations are, refer to {ref}`installation-types`. +For a comprehensive list of meta-packages, refer to +{ref}`meta-package-desc`. - Sample Single-version installation @@ -176,12 +135,6 @@ follow these steps: - Sample Multi-version installation - ```{important} - If the existing ROCm release contains non-versioned ROCm packages, you must - uninstall those packages before proceeding to the multi-version installation - to avoid conflicts. - ``` - ```shell sudo apt install rocm-hip-sdk5.5.1 rocm-hip-sdk5.3.3 ``` @@ -190,145 +143,135 @@ follow these steps: :::::{tab-item} Red Hat Enterprise Linux :sync: RHEL -::::{rubric} Installation of Kernel Headers and Development Packages +::::{rubric} 1. Add the AMDGPU Stack Repository and Install the Kernel-mode Driver :::: -The ROCm installation requires that you install the kernel headers and -`linux-modules-extra` package with the correct version corresponding to the -kernel's version. +```{tip} +If you have a version of the kernel-mode driver installed, you may skip this +section. +``` -**Example:** If the system is running Linux kernel version -`3.10.0-1160.el7.x86_64`, you must install the identical versions of kernel -headers and development packages. Refer to {ref}`check-kernel-info` on to how to -check the system's kernel version. +::::{tab-set} +:::{tab-item} RHEL 8.6 +:sync: RHEL-8.6 +:sync: RHEL-8 -To check the kernel headers and `linux-modules-extra` package versions, -follow these steps: +```shell +sudo tee /etc/yum.repos.d/amdgpu.repo <