a42fae5140
* Remove install instructions for unsuported RHEL 8.8 and 9.2
Current ROCm release does not support these versions of RHEL
* Centralize disclaimers and perquisites for installation
- Move the single-version to multi-version diclaimer to the install
overview page where single vs multi installs are discussed.
- Move the installation of kernel-headers and development packages
to the install preparation page. Unify it mainly from the quick start
content.
* s/Name/name/ in repository config files for RHEL
The repository name can be set as `name=><name>` instead of `Name`,
otherwise yum complains about the repo not having a name, e.g:
```output
Repository 'ROCm-5.3.3' is missing name in configuration, using id.
```
This is fixed with this commit.
* Clean up render/video group section on prerequisites
* Installation and Upgrade restructuring & fixes
- Fix the rocm package urls for RHEL in the install & upgrade guides
- RHEL8 and 9 have different URLs, add a tab-set similar to ubuntu
for them.
- Fix the package URL in the upgrade guide for SLES (previously pointed
to the amdgpu url)
- Change the apt-signing key download and conversion to the method used
in the quick start guide, which is the recommended by ubuntu maintainers
- Change the install steps from list items to rubrics with numbered entries
which is more readable and matches the style in the quick start guide
- Do not pass `--append` to `tee` in the upgrade guide, because it is
meant to overwrite.
- Split the one long tab-set to multiple tab-sets in the upgrade guide
to improve readability
5.5 KiB
Upgrade ROCm with the package manager
This section explains how to upgrade the existing AMDGPU driver and ROCm packages to the latest version using your OS's distributed package manager.
Package upgrade is applicable to single-version packages only. If the preference
is to install an updated version of the ROCm along with the currently
installed version, refer to the [](install) page.
Upgrade Steps
Update the AMDGPU repository
Execute the commands below based on your distribution to point the amdgpu
repository to the new release.
::::::{tab-set} :::::{tab-item} Ubuntu :sync: ubuntu
::::{tab-set} :::{tab-item} Ubuntu 20.04 :sync: ubuntu-20.04
# 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
::: :::{tab-item} Ubuntu 22.04 :sync: ubuntu-22.04
# 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
::: :::: ::::: :::::{tab-item} Red Hat Enterprise Linux :sync: RHEL
::::{tab-set} :::{tab-item} RHEL 8.6 :sync: RHEL-8.6 :sync: RHEL-8
sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/5.5.1/rhel/8.6/main/x86_64/
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo yum clean all
::: :::{tab-item} RHEL 8.7 :sync: RHEL-8.7 :sync: RHEL-8
sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/5.5.1/rhel/8.7/main/x86_64/
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo yum clean all
::: :::{tab-item} RHEL 9.1 :sync: RHEL-9.1 :sync: RHEL-9
sudo tee /etc/yum.repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/5.5.1/rhel/9.1/main/x86_64/
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo yum clean all
::: :::: ::::: :::::{tab-item} SUSE Linux Enterprise Server 15 :sync: SLES15
sudo tee /etc/zypp/repos.d/amdgpu.repo <<EOF
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/5.5.1/sle/15.4/main/x86_64
enabled=1
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo zypper ref
::::: ::::::
Upgrade the kernel-mode driver & reboot
Upgrade the kernel mode driver and reboot the system using the following commands based on your distribution:
::::{tab-set} :::{tab-item} Ubuntu :sync: ubuntu
sudo apt install amdgpu-dkms
sudo reboot
::: :::{tab-item} Red Hat Enterprise Linux :sync: RHEL
sudo yum install amdgpu-dkms
sudo reboot
::: :::{tab-item} SUSE Linux Enterprise Server 15 :sync: SLES15
sudo zypper --gpg-auto-import-keys install amdgpu-dkms
sudo reboot
::: ::::
Update the ROCm repository
Execute the commands below based on your distribution to point the rocm
repository to the new release.
::::::{tab-set} :::::{tab-item} Ubuntu :sync: ubuntu
::::{tab-set} :::{tab-item} Ubuntu 20.04 :sync: ubuntu-20.04
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.5.1 focal main" \
| sudo tee /etc/apt/sources.list.d/rocm.list
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
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/5.5.1 jammy main" \
| sudo tee /etc/apt/sources.list.d/rocm.list
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} Red Hat Enterprise Linux :sync: RHEL
::::{tab-set} :::{tab-item} RHEL 8 :sync: RHEL-8
sudo tee /etc/yum.repos.d/rocm.repo <<EOF
[ROCm-5.5.1]
name=ROCm5.5.1
baseurl=https://repo.radeon.com/rocm/rhel8/5.5.1/main
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo yum clean all
::: :::{tab-item} RHEL 9 :sync: RHEL-9
sudo tee /etc/yum.repos.d/rocm.repo <<EOF
[ROCm-5.5.1]
name=ROCm5.5.1
baseurl=https://repo.radeon.com/rocm/rhel9/5.5.1/main
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo yum clean all
::: :::: ::::: :::::{tab-item} SUSE Linux Enterprise Server 15 :sync: SLES15
sudo tee /etc/zypp/repos.d/rocm.repo <<EOF
[ROCm-5.5.1]
name=ROCm5.5.1
name=rocm
baseurl=https://repo.radeon.com/rocm/zyp/5.5.1/main
enabled=1
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo zypper ref
::::: ::::::
Upgrade the ROCm packages
Your packages can be upgraded now through their meta-packages, see the following example based on your distribution:
::::{tab-set} :::{tab-item} Ubuntu :sync: ubuntu
sudo apt install --only-upgrade rocm-hip-sdk
::: :::{tab-item} Red Hat Enterprise Linux :sync: RHEL
sudo yum update rocm-hip-sdk
::: :::{tab-item} Suse Linux Enterprise Server 15 :sync: SLES15
sudo zypper --gpg-auto-import-keys update rocm-hip-sdk
::: ::::
Verification Process
To verify if the upgrade is successful, refer to the
{ref}post-install-actions-linux given in the
Installation section.