#127 Rewrite quickstart
Merged 2 years ago by carlwgeorge. Opened 2 years ago by carlwgeorge.
carlwgeorge/epel quickstart-refresh  into  main

file modified
+54 -21
@@ -10,41 +10,74 @@ 

  

  == Quickstart

  

- * https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm[epel-release-latest-7]

+ We offer release packages containing our repository configuration files and public package signing keys.

+ Use the version that corresponds to the major version of your operating system.

+ 

+ * https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm[epel-release-latest-9]

  * https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm[epel-release-latest-8]

+ * https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm[epel-release-latest-7]

+ 

+ If you are using CentOS Stream, we also recommend installing the corresponding epel-next-release package.

+ 

+ * https://dl.fedoraproject.org/pub/epel/epel-next-release-latest-9.noarch.rpm[epel-next-release-latest-9]

+ * https://dl.fedoraproject.org/pub/epel/epel-next-release-latest-8.noarch.rpm[epel-next-release-latest-8]

+ 

+ For convenience some distributions include these release packages in their default repositories,

+ allowing you to install them by name without the full URL.

+ 

+ Some EPEL packages depend on packages from repositories that are not enabled by default.

+ Take note of the additional repositories being enabled in the following instructions.

+ 

+ === EL9

+ 

+ ==== CentOS Stream 9

  

- You may retrieve signed binary configuration files from one the above

- two links (varying by the major release number of the installation

- target machine). They may be automatically installed by root thus:

+ ....

+ dnf config-manager --set-enabled crb

+ dnf install \

+     https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm \

+     https://dl.fedoraproject.org/pub/epel/epel-next-release-latest-9.noarch.rpm

+ ....

  

- * RHEL/CentOS 7:

+ === EL8

  

- `# yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm`

+ ==== CentOS Stream 8

  

- * on RHEL 7 it is recommended to also enable the optional, extras, and

- HA repositories since EPEL packages may depend on packages from these

- repositories:

+ ....

+ dnf config-manager --set-enabled powertools

+ dnf install epel-release epel-next-release

+ ....

  

- `# subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms"  --enable "rhel-ha-for-rhel-*-server-rpms"`

+ ==== RHEL 8

  

- * RHEL/CentOS 8:

+ ....

+ subscription-manager repos --enable codeready-builder-for-rhel-8-$(arch)-rpms

+ dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

+ ....

  

- `# yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm`

+ ==== CentOS Linux 8, AlmaLinux 8, Rocky Linux 8

  

- * CentOS Stream 8:

+ ....

+ dnf config-manager --set-enabled powertools

+ dnf install epel-release

+ ....

  

- `# dnf install epel-release`

+ === EL7

  

- * on RHEL 8 it is required to also enable the

- codeready-builder-for-rhel-8-*-rpms repository since EPEL packages may

- depend on packages from it:

+ ==== RHEL 7

  

- `# subscription-manager repos --enable "codeready-builder-for-rhel-8-$(arch)-rpms"`

+ ....

+ subscription-manager repos --enable rhel-*-optional-rpms \

+                            --enable rhel-*-extras-rpms \

+                            --enable rhel-ha-for-rhel-*-server-rpms

+ yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

+ ....

  

- * on CentOS 8 it is recommended to also enable the powertools repository

- since EPEL packages may depend on packages from it:

+ ==== CentOS 7

  

- `# dnf config-manager --set-enabled powertools`

+ ....

+ yum install epel-release

+ ....

  

  [[what_is_extra_packages_for_enterprise_linux_or_epel]]

  == What is Extra Packages for Enterprise Linux (or EPEL)?

  • Mention epel-next-release
  • Clarify that some distros include release packages in their default repos
  • List necessary commands together for each distro for easier copy/paste
  • Explicitly mention AlmaLinux and Rocky Linux

I like it. It is clear, up to date, and I believe easier to read.

I forgot to mention, the epel-next-release symlink this references does not exist yet. I've opened an issue with releng to get that created.

https://pagure.io/releng/issue/10354

We should probably not merge this until that is resolved.

rebased onto 0c19148

2 years ago

Pull-Request has been merged by carlwgeorge

2 years ago
Metadata