diff --git a/guides/common/assembly_planning-project-server-installation.adoc b/guides/common/assembly_planning-project-server-installation.adoc index c6d1287cdca..006a9656ba5 100644 --- a/guides/common/assembly_planning-project-server-installation.adoc +++ b/guides/common/assembly_planning-project-server-installation.adoc @@ -2,6 +2,8 @@ include::modules/con_planning-project-server-installation.adoc[] +include::modules/ref_operating-system-requirements.adoc[leveloffset=+1] + include::modules/ref_system-requirements.adoc[leveloffset=+1] include::modules/ref_storage-requirements.adoc[leveloffset=+1] @@ -10,8 +12,6 @@ ifdef::katello,orcharhino,satellite[] include::modules/ref_best-practices-for-optimizing-storage.adoc[leveloffset=+1] endif::[] -include::modules/ref_supported-operating-systems.adoc[leveloffset=+1] - include::modules/ref_port-and-firewall-requirements.adoc[leveloffset=+1] include::modules/con_aws-requirements.adoc[leveloffset=+1] diff --git a/guides/common/assembly_preparing-environment-for-capsule-installation.adoc b/guides/common/assembly_preparing-environment-for-capsule-installation.adoc index 4a1d38ffde4..f06cec81ace 100644 --- a/guides/common/assembly_preparing-environment-for-capsule-installation.adoc +++ b/guides/common/assembly_preparing-environment-for-capsule-installation.adoc @@ -7,6 +7,8 @@ ifdef::context[:parent-context: {context}] Review the following prerequisites before you install {SmartProxyServer}. +include::modules/ref_operating-system-requirements.adoc[leveloffset=+1] + // System Requirements include::modules/ref_system-requirements.adoc[leveloffset=+1] @@ -17,9 +19,6 @@ include::modules/ref_capsule-storage-requirements.adoc[leveloffset=+1] include::modules/ref_best-practices-for-optimizing-storage.adoc[leveloffset=+1] endif::[] -// Supported Operating Systems -include::modules/ref_supported-operating-systems.adoc[leveloffset=+1] - // Port and Firewall Requirements include::modules/ref_smart-proxy-port-and-firewall-requirements.adoc[leveloffset=+1] diff --git a/guides/common/modules/ref_supported-operating-systems.adoc b/guides/common/modules/ref_operating-system-requirements.adoc similarity index 65% rename from guides/common/modules/ref_supported-operating-systems.adoc rename to guides/common/modules/ref_operating-system-requirements.adoc index 4a86cc3e10e..06ed65b63ec 100644 --- a/guides/common/modules/ref_supported-operating-systems.adoc +++ b/guides/common/modules/ref_operating-system-requirements.adoc @@ -1,37 +1,40 @@ :_mod-docs-content-type: REFERENCE -[id="supported-operating-systems_{context}"] -= Supported operating systems +[id="operating-system-requirements"] += Operating system requirements -ifdef::satellite[] -You can install the operating system from a disc, local ISO image, Kickstart, or any other method that Red{nbsp}Hat supports. -Red{nbsp}Hat {ProductName} is supported on the latest version of {RHEL} 9 that is available at the time when {ProductName} is installed. -Previous versions of {RHEL} including EUS or z-stream are not supported. +ifdef::foreman-deb[] +The following operating systems are supported for deploying {Project}: + +* Debian 12 (Bookworm) (amd64) +* Ubuntu 22.04 (Jammy) (amd64) endif::[] +ifndef::foreman-deb[] +The following operating system is supported for deploying {Project}: -The following operating systems are supported by the installer, have packages, and are tested for deploying {Project}: +* {EL} 9 (x86_64) +endif::[] -.Operating systems supported by {foreman-installer} -|==== -| Operating System | Architecture | Notes ifdef::foreman-el,katello,orcharhino[] -| {PlanningDocURL}Enterprise_Linux[{EL}] 9 | x86_64 only | EPEL is not supported. -endif::[] -ifdef::satellite[] -| {RHEL} 9 | x86_64 only | +Installing {Project} on a system with Extra Packages for Enterprise Linux (EPEL) is not supported. endif::[] -ifdef::foreman-deb[] -| Debian 12 (Bookworm) | amd64 | -| Ubuntu 22.04 (Jammy) | amd64 | -endif::[] -|==== ifdef::satellite[] +You can install the operating system from a disc, local ISO image, Kickstart, or any other method that Red{nbsp}Hat supports. + +Red{nbsp}Hat {ProductName} is supported on the latest version of {RHEL} 9 available at the time of installation. +Previous versions of {RHEL} including EUS or z-stream are not supported. + Red{nbsp}Hat {ProductName} requires a {RHEL} installation with the `@Base` package group with no other package-set modifications, and without third-party configurations or software not directly necessary for the direct operation of the server. This restriction includes hardening and other non-Red{nbsp}Hat security software. If you require such software in your infrastructure, install and verify a complete working {ProductName} first, then create a backup of the system before adding any non-Red{nbsp}Hat software. +endif::[] ifeval::["{context}" == "{smart-proxy-context}"] Do not register {SmartProxyServer} to the Red{nbsp}Hat Content Delivery Network (CDN). endif::[] + +ifdef::foreman-el,katello,orcharhino[] +.Additional resources +* {PlanningDocURL}Enterprise_Linux[Glossary term for {EL}] endif::[] diff --git a/guides/common/modules/ref_system-requirements-quickstart.adoc b/guides/common/modules/ref_system-requirements-quickstart.adoc new file mode 100644 index 00000000000..480d88704a8 --- /dev/null +++ b/guides/common/modules/ref_system-requirements-quickstart.adoc @@ -0,0 +1,28 @@ +:_mod-docs-content-type: REFERENCE + +[id="system-requirements"] += System requirements + +// The requirements in this section must match the full requirements in the installation guide. +The following list shows the most critical requirements common for most scenarios. +For a full list, see {InstallingServerDocURL}[_{InstallingServerDocTitle}_]. + +ifdef::foreman-deb[] +* The following operating systems are supported for deploying {Project}: +endif::[] +ifndef::foreman-deb[] +* The following operating system is supported for deploying {Project}: +endif::[] ++ +ifndef::foreman-deb[] +** {EL} 9 (x86_64) +endif::[] +ifdef::foreman-deb[] +** Debian 12 (Bookworm) (amd64) +** Ubuntu 22.04 (Jammy) (amd64) +endif::[] +ifdef::foreman-el,katello,orcharhino[] +* Installing {Project} on a system with Extra Packages for Enterprise Linux (EPEL) is not supported. +endif::[] +* Install {ProductName} on a freshly provisioned system that serves no other function except to run {ProductName}. +* Ensure the system has at least {project-minimum-memory} of memory. diff --git a/guides/doc-Quickstart/master.adoc b/guides/doc-Quickstart/master.adoc index 014f7c73813..ed80b81e2c0 100644 --- a/guides/doc-Quickstart/master.adoc +++ b/guides/doc-Quickstart/master.adoc @@ -13,13 +13,7 @@ It uses native operating system packaging (`.rpm` or `.deb` packages) and adds n Components include the Foreman web UI, Smart Proxy, a Puppet server, TFTP, DNS and DHCP servers. It is configurable and the Puppet modules can be read or run in "no-op" mode to see what changes it will make. -include::common/modules/ref_supported-operating-systems.adoc[leveloffset=+1] - -The installation requires {project-minimum-memory} of memory. -For more information, see {InstallingServerDocURL}system-requirements_{project-context}[System Requirements]. - -The Foreman installer uses Puppet to install Foreman. -This guide assumes that you have a newly installed operating system, on which the installer will setup Foreman, a Puppet server, and the Smart Proxy by default. +include::common/modules/ref_system-requirements-quickstart.adoc[leveloffset=+1] include::common/modules/con_configuring-repositories.adoc[leveloffset=+1]