Drop running on EL 8 support

Foreman 3.13 has dropped support for EL 8. Biggest changes are the removal of DNF modularity and upgrading from EL 8 to EL 9.
theforeman · Dec 4, 2024 · d3595a3 · d3595a3
1 parent 55e6fa5
commit d3595a3
Show file tree

Hide file tree

Showing 50 changed files with 37 additions and 982 deletions.
diff --git a/guides/common/assembly_troubleshoot-dnf-modules.adoc b/guides/common/assembly_troubleshoot-dnf-modules.adoc
diff --git a/guides/common/assembly_upgrading-to-rhel9.adoc b/guides/common/assembly_upgrading-to-rhel9.adoc
diff --git a/guides/common/attributes-foreman-el.adoc b/guides/common/attributes-foreman-el.adoc
@@ -1,7 +1,3 @@
-// Overrides for foreman-el build
-:dnf-module: foreman:el8
-:dnf-module-utils: {dnf-module}
-
 // Some documents are not ready for stable releases, but can be published on nightly
 ifeval::["{DocState}" != "nightly"]
 :HideDocumentOnStable:

diff --git a/guides/common/attributes-katello.adoc b/guides/common/attributes-katello.adoc
@@ -1,8 +1,6 @@
 // Overrides for katello build
 :client-content-apt:
 :client-content-zypper:
-:dnf-module: katello:el8
-:dnf-module-utils: {dnf-module}
 :foreman-installer-package: foreman-installer-katello
 :installer-log-file: /var/log/foreman-installer/katello.log
 :installer-scenario-smartproxy: foreman-installer --scenario foreman-proxy-content

diff --git a/guides/common/attributes-orcharhino.adoc b/guides/common/attributes-orcharhino.adoc
@@ -33,8 +33,6 @@
 :customrpm: custom RPM
 :customrpmtitle: Custom RPM
 :customssl: custom SSL
-:dnf-module: orcharhino:el8
-:dnf-module-utils: {dnf-module}
 :foreman-example-com: orcharhino.example.com
 :installer-log-file: /var/log/foreman-installer/katello.log
 :installer-scenario-smartproxy: foreman-installer --scenario foreman-proxy-content

diff --git a/guides/common/attributes-satellite.adoc b/guides/common/attributes-satellite.adoc
@@ -167,5 +167,3 @@
 :project-client-name: Red Hat Satellite Client 6
 :project-client-RHEL7-url: {RepoRHEL7ServerSatelliteToolsProjectVersion}
 :project-client-RHEL8-url: {RepoRHEL8ServerSatelliteToolsProjectVersion}
-:dnf-module: satellite:el8
-:dnf-module-utils: satellite-utils:el8
diff --git a/guides/common/modules/con_backing-up-server-and-proxy.adoc b/guides/common/modules/con_backing-up-server-and-proxy.adoc
@@ -26,7 +26,7 @@ You must encrypt or move the backup to a secure location to minimize the risk of
 .Conventional backup methods
 You can also use conventional backup methods.
 ifndef::orcharhino,foreman-deb[]
-For more information, see {RHELDocsBaseURL}8/html-single/configuring_basic_system_settings/index#assembly_recovering-and-restoring-a-system_configuring-basic-system-settings[Recovering and restoring a system] in _{RHEL}{nbsp}8 Configuring basic system settings_.
+For more information, see {RHELDocsBaseURL}9/html-single/configuring_basic_system_settings/index#assembly_recovering-and-restoring-a-system_configuring-basic-system-settings[Recovering and restoring a system] in _{RHEL}{nbsp}9 Configuring basic system settings_.
 endif::[]
 
 [NOTE]

diff --git a/guides/common/modules/con_configuring-kerberos-sso-with-freeipa-in-project.adoc b/guides/common/modules/con_configuring-kerberos-sso-with-freeipa-in-project.adoc
@@ -15,5 +15,5 @@ If cross-forest trust is configured between {FreeIPA} and Active{nbsp}Directory,
 When cross-forest trust is configured between {FreeIPA} and Active{nbsp}Directory, Active{nbsp}Directory users can log in to {Project} with their user principal name (UPN) and password.
 
 ifndef::orcharhino[]
-For information about {FreeIPA}, including its cross-forest trust functionality, see link:{RHELDocsBaseURL}8/html/planning_identity_management/index[{RHEL}{nbsp}8 _Planning Identity Management_] and link:{RHELDocsBaseURL}8/html/installing_identity_management/index[{RHEL}{nbsp}8 _Installing Identity Management_].
+For information about {FreeIPA}, including its cross-forest trust functionality, see link:{RHELDocsBaseURL}9/html/planning_identity_management/index[{RHEL}{nbsp}9 _Planning Identity Management_] and link:{RHELDocsBaseURL}9/html/installing_identity_management/index[{RHEL}{nbsp}9 _Installing Identity Management_].
 endif::[]
diff --git a/guides/common/modules/con_projectserver-operating-system.adoc b/guides/common/modules/con_projectserver-operating-system.adoc
@@ -1,7 +1,7 @@
 [id="ProjectServer-Operating-System_{context}"]
 = {ProjectServer} operating system
 
-{Project} has packages for {EL} 8 and 9, Debian 11, Debian 12 and Ubuntu 22.04.
+{Project} has packages for {EL} 9, Debian 11, Debian 12 and Ubuntu 22.04.
 Katello plugin packages, which provide content management capabilities, are only available for {EL}.
 
 {Team} only packages {Project} for x86_64.
diff --git a/guides/common/modules/con_troubleshooting-dnf-modules.adoc b/guides/common/modules/con_troubleshooting-dnf-modules.adoc
diff --git a/guides/common/modules/con_troubleshooting-postgresql.adoc b/guides/common/modules/con_troubleshooting-postgresql.adoc
diff --git a/guides/common/modules/con_upgrade-paths.adoc b/guides/common/modules/con_upgrade-paths.adoc
@@ -14,24 +14,12 @@ endif::[]
 ifndef::foreman-deb[]
 . Upgrade your {ProjectServer}:
 .. Upgrade your {ProjectServer} to {ProjectVersion}.
-.. Optional: Upgrade the operating system on your {ProjectServer} to {EL}{nbsp}9.
-+
-[NOTE]
-====
-Although upgrading the operating system of your {ProjectServer} to {EL}{nbsp}9 is optional, you will need to do it before you can upgrade to the next {Project} version after {ProjectVersion}.
-====
 +
 ifdef::satellite[]
 .. Synchronize the new {ProjectVersion} repositories.
 endif::[]
 . Upgrade your {SmartProxyServers}:
 .. Upgrade all {SmartProxyServers} to {ProjectVersion}.
-.. Optional: Upgrade the operating system on your {SmartProxyServers} to {EL}{nbsp}9.
-+
-[NOTE]
-====
-Although upgrading the operating system of your {SmartProxyServers} to {EL}{nbsp}9 is optional, you will need to do it before you can upgrade to the next {Project} version after {ProjectVersion}.
-====
 endif::[]
 
 ifdef::foreman-deb[]

diff --git a/guides/common/modules/con_upgrading-el-on-project-or-proxy.adoc b/guides/common/modules/con_upgrading-el-on-project-or-proxy.adoc
diff --git a/guides/common/modules/proc_cloning_satellite_server.adoc b/guides/common/modules/proc_cloning_satellite_server.adoc
@@ -32,8 +32,8 @@ Ensure that you understand the following terms:
 
 To clone {ProjectServer}, ensure that you have the following resources available:
 
-* A minimal install of {EL} 8 to become the target server.
-Do not install {EL} 8 software groups or third-party applications.
+* A minimal install of {EL} 9 to become the target server.
+Do not install {EL} 9 software groups or third-party applications.
 Ensure that your server complies with all the required specifications.
 For more information, see {InstallingServerDocURL}Preparing_your_Environment_for_Installation_{project-context}[Preparing your Environment for Installation] in _{InstallingServerDocTitle}_.
 * A backup of your {ProjectServer} that you make using the `{foreman-maintain} backup` script.
@@ -143,7 +143,6 @@ If you copy to a different folder, update the `backup_dir` variable in the `/etc
 You can either mount the shared storage or copy the backup files to the `/backup/` folder on the target server.
 . Power off the source server.
 . Register your instance to the Red Hat Customer Portal and enable only the required repositories:
-** If the target server runs {RHEL}{nbsp}9, enter the following commands:
 +
 [options="nowrap" subs="quotes,attributes"]
 ----
@@ -153,17 +152,6 @@ You can either mount the shared storage or copy the backup files to the `/backup
 --enable={RepoRHEL9BaseOS} \
 --enable={RepoRHEL9ServerSatelliteMaintenanceProjectVersion}
 ----
-** If the target server runs {RHEL}{nbsp}8, enter the following commands:
-+
-[options="nowrap" subs="quotes,attributes"]
-----
-# subscription-manager register
-# subscription-manager repos --disable=*
-# subscription-manager repos --enable={RepoRHEL8AppStream} \
---enable={RepoRHEL8BaseOS} \
---enable={RepoRHEL8ServerSatelliteMaintenanceProjectVersion}
-# dnf module enable satellite-maintenance:el8
-----
 +
 . Install the `satellite-clone` package:
 +

diff --git a/...n/modules/proc_configuring-dynamic-dns-update-with-gss-tsig-authentication.adoc b/...n/modules/proc_configuring-dynamic-dns-update-with-gss-tsig-authentication.adoc
@@ -8,7 +8,7 @@ To configure the IdM server to use the GSS-TSIG technology, you must install the
 
 * You must ensure the IdM server is deployed and the host-based firewall is configured correctly.
 ifdef::satellite[]
-For more information, see {RHELDocsBaseURL}9/html/installing_identity_management/preparing-the-system-for-ipa-server-installation_installing-identity-management#port-requirements-for-idm_preparing-the-system-for-ipa-server-installation[Port requirements for IdM] in _{RHEL}{nbsp}9 Installing Identity Management_ or {RHELDocsBaseURL}8/html/installing_identity_management/preparing-the-system-for-ipa-server-installation_installing-identity-management#port-requirements-for-idm_preparing-the-system-for-ipa-server-installation[Port requirements for IdM] in _{RHEL}{nbsp}8 Installing Identity Management_.
+For more information, see {RHELDocsBaseURL}9/html/installing_identity_management/preparing-the-system-for-ipa-server-installation_installing-identity-management#port-requirements-for-idm_preparing-the-system-for-ipa-server-installation[Port requirements for IdM] in _{RHEL}{nbsp}9 Installing Identity Management_.
 endif::[]
 * You must contact the IdM server administrator to ensure that you obtain an account on the IdM server with permissions to create zones on the IdM server.
 * You should create a backup of the answer file.

diff --git a/...figuring-host-based-access-control-for-freeipa-users-logging-in-to-project.adoc b/...figuring-host-based-access-control-for-freeipa-users-logging-in-to-project.adoc
@@ -13,7 +13,7 @@ By configuring a HBAC rule in the {FreeIPA} domain, you can ensure {Project} doe
 .Procedure
 . On the {FreeIPA} server, configure HBAC control.
 ifndef::orcharhino[]
-For more information, see {RHELDocsBaseURL}9/html/managing_idm_users_groups_hosts_and_access_control_rules/configuring-host-based-access-control-rules_managing-users-groups-hosts[_{RHEL}{nbsp}9 Managing IdM users, groups, hosts, and access control rules_] or {RHELDocsBaseURL}8/html/managing_idm_users_groups_hosts_and_access_control_rules/configuring-host-based-access-control-rules_managing-users-groups-hosts[_{RHEL}{nbsp}8 Managing IdM users, groups, hosts, and access control rules_].
+For more information, see {RHELDocsBaseURL}9/html/managing_idm_users_groups_hosts_and_access_control_rules/configuring-host-based-access-control-rules_managing-users-groups-hosts[_{RHEL}{nbsp}9 Managing IdM users, groups, hosts, and access control rules_].
 endif::[]
 .. Create a HBAC service for {ProjectServer}.
 .. Create a new HBAC rule to define the required access control.

diff --git a/guides/common/modules/proc_configuring-logging-type-and-layout.adoc b/guides/common/modules/proc_configuring-logging-type-and-layout.adoc
@@ -51,5 +51,5 @@ For example:
 ifdef::satellite[]
 
 .Additional resources
-For more information about Journal, see {RHELDocsBaseURL}8/html-single/configuring_basic_system_settings/index#viewing-logs-using-the-command-line_assembly_troubleshooting-problems-using-log-files[Viewing logs using the command line] in _{RHEL}{nbsp}8 Configuring basic system settings_.
+For more information about Journal, see {RHELDocsBaseURL}9/html-single/configuring_basic_system_settings/index#viewing-logs-using-the-command-line_assembly_troubleshooting-problems-using-log-files[Viewing logs using the command line] in _{RHEL}{nbsp}9 Configuring basic system settings_.
 endif::[]
diff --git a/guides/common/modules/proc_configuring-repositories-foreman-el.adoc b/guides/common/modules/proc_configuring-repositories-foreman-el.adoc
@@ -1,41 +1,9 @@
 .Procedure
 
-[tabs]
-=====
-{EL} 9::
-+
 :distribution: el
 :distribution-major-version: 9
 :package-manager: dnf
 
 include::proc_configuring-repositories-el.adoc[]
 
-{EL} 8::
-+
-:distribution: el
-:distribution-major-version: 8
-:package-manager: dnf
-
-include::proc_configuring-repositories-el.adoc[]
-
-. Enable the DNF modules:
-+
-[options="nowrap" subs="+quotes,verbatim,attributes"]
-----
-# dnf module enable {dnf-module}
-----
-+
-[NOTE]
-====
-If there is any warning about conflicts with Ruby or PostgreSQL while enabling `{dnf-module}` module, see
-ifeval::["{context}" == "{project-context}"]
-xref:troubleshooting-dnf-modules_{context}[].
-endif::[]
-ifeval::["{context}" != "{project-context}"]
-{InstallingServerDocURL}troubleshooting-dnf-modules_{project-context}[Troubleshooting DNF modules] in _{InstallingServerDocTitle}_.
-endif::[]
-For more information about modules and lifecycle streams on {RHEL} 8, see https://access.redhat.com/support/policy/updates/rhel-app-streams-life-cycle[{RHEL} Application Streams Lifecycle].
-====
-=====
-
 include::snip_verification-enabled-repolist.adoc[]
diff --git a/guides/common/modules/proc_configuring-repositories-proxy.adoc b/guides/common/modules/proc_configuring-repositories-proxy.adoc
@@ -1,21 +1,11 @@
 [id="configuring-repositories-proxy_{context}"]
 = Configuring repositories
-:dnf-module: satellite-capsule:el8
-:package-manager: dnf
 
 .Prerequisite
 * If you are installing {ProductName} as a virtual machine hosted on {oVirt}, you must also enable the *Red{nbsp}Hat Common* repository and then install {oVirt} guest agents and drivers.
 For more information, see {RHDocsBaseURL}red_hat_virtualization/4.4/html/virtual_machine_management_guide/installing_guest_agents_and_drivers_linux_linux_vm#Installing_the_Guest_Agents_and_Drivers_on_Red_Hat_Enterprise_Linux[Installing the Guest Agents and Drivers on {RHEL}] in the _Virtual Machine Management Guide_.
 
 .Procedure
-Select the operating system and version you are installing on:
-
-* xref:#repositories-{smart-proxy-context}-rhel-9[{RHEL} 9]
-* xref:#repositories-{smart-proxy-context}-rhel-8[{RHEL} 8]
-
-[id="repositories-{smart-proxy-context}-rhel-9"]
-== {RHEL} 9
-
 . Disable all repositories:
 +
 [options="nowrap"]
@@ -35,36 +25,3 @@ Select the operating system and version you are installing on:
 ----
 
 include::snip_verification-enabled-repolist.adoc[]
-
-[id="repositories-{smart-proxy-context}-rhel-8"]
-== {RHEL} 8
-
-. Disable all repositories:
-+
-[options="nowrap"]
-----
-# subscription-manager repos --disable "*"
-----
-. Enable the following repositories:
-+
-[options="nowrap" subs="+quotes,attributes"]
-----
-# subscription-manager repos \
---enable={RepoRHEL8BaseOS} \
---enable={RepoRHEL8AppStream} \
---enable={RepoRHEL8ServerSatelliteCapsuleProjectVersion} \
---enable={RepoRHEL8ServerSatelliteMaintenanceProjectVersion}
-----
-
-. Enable the module:
-+
-[options="nowrap", subs="+quotes,verbatim,attributes"]
-----
-# dnf module enable {dnf-module}
-----
-
-include::snip_verification-enabled-repolist.adoc[]
-
-.Additional Resources
-* If there is any warning about conflicts with Ruby or PostgreSQL while enabling `{dnf-module}` module, see xref:troubleshooting-dnf-modules_{context}[Troubleshooting DNF modules].
-* For more information about modules and lifecycle streams on {RHEL}{nbsp}8, see https://access.redhat.com/support/policy/updates/rhel-app-streams-life-cycle[{RHEL}{nbsp}8 Application Streams Lifecycle].
diff --git a/guides/common/modules/proc_configuring-repositories-satellite.adoc b/guides/common/modules/proc_configuring-repositories-satellite.adoc
@@ -1,11 +1,4 @@
 .Procedure
-Select the operating system and version you are installing on:
-
-* xref:#repositories-el-9[{EL} 9]
-* xref:#repositories-el-8[{EL} 8]
-
-[id="repositories-el-9"]
-== {EL} 9
 
 . Disable all repositories:
 +
@@ -26,45 +19,3 @@ Select the operating system and version you are installing on:
 ----
 
 include::snip_verification-enabled-repolist.adoc[]
-
-[id="repositories-el-8"]
-== {EL} 8
-
-. Disable all repositories:
-+
-[options="nowrap"]
-----
-# subscription-manager repos --disable "*"
-----
-+
-. Enable the following repositories:
-+
-[options="nowrap" subs="+quotes,attributes"]
-----
-# subscription-manager repos \
---enable={RepoRHEL8BaseOS} \
---enable={RepoRHEL8AppStream} \
---enable={RepoRHEL8ServerSatelliteServerProjectVersion} \
---enable={RepoRHEL8ServerSatelliteMaintenanceProjectVersion}
-----
-
-. Enable the DNF modules:
-+
-[options="nowrap" subs="+quotes,verbatim,attributes"]
-----
-# dnf module enable {dnf-module}
-----
-+
-[NOTE]
-====
-If there is any warning about conflicts with Ruby or PostgreSQL while enabling `{dnf-module}` module, see
-ifeval::["{context}" == "{project-context}"]
-xref:troubleshooting-dnf-modules_{context}[].
-endif::[]
-ifeval::["{context}" != "{project-context}"]
-{InstallingServerDocURL}troubleshooting-dnf-modules_{project-context}[Troubleshooting DNF modules] in _{InstallingServerDocTitle}_.
-endif::[]
-For more information about modules and lifecycle streams on {RHEL} 8, see https://access.redhat.com/support/policy/updates/rhel-app-streams-life-cycle[{RHEL} Application Streams Lifecycle].
-====
-
-include::snip_verification-enabled-repolist.adoc[]