From a471e8debee114809e4ef314167f0fe5d51d9c8d Mon Sep 17 00:00:00 2001
From: Gergely Meszaros <gergely@streamhpc.com>
Date: Thu, 8 Jun 2023 13:14:40 +0000
Subject: [PATCH] Add instructions for adding extra repositories in RHEL and
 SLES

The hip-devel package depends on perl modules not distributed by default
on RHEL and SLES distriubutions, these can be installed from EPEL and
the `devel:languages:perl` repository respectively.

Ideally in the future these dependencies would be replaced with packages
available from default repositories, but in the meanwhile this should
be at least documented.
---
 docs/deploy/linux/prerequisites.md | 62 ++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/docs/deploy/linux/prerequisites.md b/docs/deploy/linux/prerequisites.md
index e22ef9d9b..a1a4c07b0 100644
--- a/docs/deploy/linux/prerequisites.md
+++ b/docs/deploy/linux/prerequisites.md
@@ -59,6 +59,68 @@ Verify the kernel version using the following steps:
 2. Confirm that the obtained kernel version information matches with system
    requirements as listed in {ref}`supported_distributions`.
 
+## Additional package repositories
+
+On some distributions the ROCm packages depend on packages outside the default
+package repositories. These extra repositories need to be enabled before
+installation. Follow the instructions below based on your distributions.
+
+::::::{tab-set}
+
+:::::{tab-item} Ubuntu
+:sync: ubuntu
+
+All packages are available in the default Ubuntu repositories, therefore
+no additional repositories need to be added.
+
+:::::
+:::::{tab-item} Red Hat Enterprise Linux
+:sync: RHEL
+
+::::{rubric} 1. Add the EPEL repository
+::::
+
+::::{tab-set}
+:::{tab-item} RHEL 8
+:sync: RHEL-8
+
+```shell
+wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
+sudo rpm -ivh epel-release-latest-8.noarch.rpm
+```
+
+:::
+:::{tab-item} RHEL 9
+
+```shell
+wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
+sudo rpm -ivh epel-release-latest-9.noarch.rpm
+```
+
+:::
+::::
+
+::::{rubric} 2. Enable the CodeReady Linux Builder repository
+::::
+
+Run the following command and follow the instructions.
+
+```shell
+sudo crb enable
+```
+
+:::::
+:::::{tab-item} SUSE Linux Enterprise Server 15
+
+Add the perl languages repository.
+
+```shell
+zypper addrepo https://download.opensuse.org/repositories/devel:languages:perl/SLE_15_SP4/devel:languages:perl.repo
+```
+
+:::::
+::::::
+
 ## Kernel headers and development packages
 
 The driver package uses