Skip to content

Commit d9b6c9c

Browse files
aneta-petrovabangelicmaximiliankolb
authored
Review OS requirements (#4203)
* Review OS prerequisites and move them * Review quickstart system prerequisites --------- Co-authored-by: Brian Angelica <[email protected]> Co-authored-by: Maximilian Kolb <[email protected]>
1 parent 568876d commit d9b6c9c

File tree

5 files changed

+55
-31
lines changed

5 files changed

+55
-31
lines changed

‎guides/common/assembly_planning-project-server-installation.adoc‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22

33
include::modules/con_planning-project-server-installation.adoc[]
44

5+
include::modules/ref_operating-system-requirements.adoc[leveloffset=+1]
6+
57
include::modules/ref_system-requirements.adoc[leveloffset=+1]
68

79
include::modules/ref_storage-requirements.adoc[leveloffset=+1]
@@ -10,8 +12,6 @@ ifdef::katello,orcharhino,satellite[]
1012
include::modules/ref_best-practices-for-optimizing-storage.adoc[leveloffset=+1]
1113
endif::[]
1214

13-
include::modules/ref_supported-operating-systems.adoc[leveloffset=+1]
14-
1515
include::modules/ref_port-and-firewall-requirements.adoc[leveloffset=+1]
1616

1717
include::modules/con_aws-requirements.adoc[leveloffset=+1]

‎guides/common/assembly_preparing-environment-for-capsule-installation.adoc‎

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ ifdef::context[:parent-context: {context}]
77

88
Review the following prerequisites before you install {SmartProxyServer}.
99

10+
include::modules/ref_operating-system-requirements.adoc[leveloffset=+1]
11+
1012
// System Requirements
1113
include::modules/ref_system-requirements.adoc[leveloffset=+1]
1214

@@ -17,9 +19,6 @@ include::modules/ref_capsule-storage-requirements.adoc[leveloffset=+1]
1719
include::modules/ref_best-practices-for-optimizing-storage.adoc[leveloffset=+1]
1820
endif::[]
1921

20-
// Supported Operating Systems
21-
include::modules/ref_supported-operating-systems.adoc[leveloffset=+1]
22-
2322
// Port and Firewall Requirements
2423
include::modules/ref_smart-proxy-port-and-firewall-requirements.adoc[leveloffset=+1]
2524

‎guides/common/modules/ref_supported-operating-systems.adoc‎ renamed to ‎guides/common/modules/ref_operating-system-requirements.adoc‎

Lines changed: 22 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,40 @@
11
:_mod-docs-content-type: REFERENCE
22

3-
[id="supported-operating-systems_{context}"]
4-
= Supported operating systems
3+
[id="operating-system-requirements"]
4+
= Operating system requirements
55

6-
ifdef::satellite[]
7-
You can install the operating system from a disc, local ISO image, Kickstart, or any other method that Red{nbsp}Hat supports.
8-
Red{nbsp}Hat {ProductName} is supported on the latest version of {RHEL} 9 that is available at the time when {ProductName} is installed.
9-
Previous versions of {RHEL} including EUS or z-stream are not supported.
6+
ifdef::foreman-deb[]
7+
The following operating systems are supported for deploying {Project}:
8+
9+
* Debian 12 (Bookworm) (amd64)
10+
* Ubuntu 22.04 (Jammy) (amd64)
1011
endif::[]
12+
ifndef::foreman-deb[]
13+
The following operating system is supported for deploying {Project}:
1114

12-
The following operating systems are supported by the installer, have packages, and are tested for deploying {Project}:
15+
* {EL} 9 (x86_64)
16+
endif::[]
1317

14-
.Operating systems supported by {foreman-installer}
15-
|====
16-
| Operating System | Architecture | Notes
1718
ifdef::foreman-el,katello,orcharhino[]
18-
| {PlanningDocURL}Enterprise_Linux[{EL}] 9 | x86_64 only | EPEL is not supported.
19-
endif::[]
20-
ifdef::satellite[]
21-
| {RHEL} 9 | x86_64 only |
19+
Installing {Project} on a system with Extra Packages for Enterprise Linux (EPEL) is not supported.
2220
endif::[]
23-
ifdef::foreman-deb[]
24-
| Debian 12 (Bookworm) | amd64 |
25-
| Ubuntu 22.04 (Jammy) | amd64 |
26-
endif::[]
27-
|====
2821

2922
ifdef::satellite[]
23+
You can install the operating system from a disc, local ISO image, Kickstart, or any other method that Red{nbsp}Hat supports.
24+
25+
Red{nbsp}Hat {ProductName} is supported on the latest version of {RHEL} 9 available at the time of installation.
26+
Previous versions of {RHEL} including EUS or z-stream are not supported.
27+
3028
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.
3129
This restriction includes hardening and other non-Red{nbsp}Hat security software.
3230
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.
31+
endif::[]
3332

3433
ifeval::["{context}" == "{smart-proxy-context}"]
3534
Do not register {SmartProxyServer} to the Red{nbsp}Hat Content Delivery Network (CDN).
3635
endif::[]
36+
37+
ifdef::foreman-el,katello,orcharhino[]
38+
.Additional resources
39+
* {PlanningDocURL}Enterprise_Linux[Glossary term for {EL}]
3740
endif::[]

‎guides/common/modules/ref_system-requirements-quickstart.adoc‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
:_mod-docs-content-type: REFERENCE
2+
3+
[id="system-requirements"]
4+
= System requirements
5+
6+
// The requirements in this section must match the full requirements in the installation guide.
7+
The following list shows the most critical requirements common for most scenarios.
8+
For a full list, see {InstallingServerDocURL}[_{InstallingServerDocTitle}_].
9+
10+
ifdef::foreman-deb[]
11+
* The following operating systems are supported for deploying {Project}:
12+
endif::[]
13+
ifndef::foreman-deb[]
14+
* The following operating system is supported for deploying {Project}:
15+
endif::[]
16+
+
17+
ifndef::foreman-deb[]
18+
** {EL} 9 (x86_64)
19+
endif::[]
20+
ifdef::foreman-deb[]
21+
** Debian 12 (Bookworm) (amd64)
22+
** Ubuntu 22.04 (Jammy) (amd64)
23+
endif::[]
24+
ifdef::foreman-el,katello,orcharhino[]
25+
* Installing {Project} on a system with Extra Packages for Enterprise Linux (EPEL) is not supported.
26+
endif::[]
27+
* Install {ProductName} on a freshly provisioned system that serves no other function except to run {ProductName}.
28+
* Ensure the system has at least {project-minimum-memory} of memory.

‎guides/doc-Quickstart/master.adoc‎

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,7 @@ include::common/header.adoc[]
1010
This guide describes the quickest way to get a {ProjectServer} up and running.
1111
For a full installation guide, see {InstallingServerDocURL}[_{InstallingServerDocTitle}_].
1212

13-
include::common/modules/ref_supported-operating-systems.adoc[leveloffset=+1]
14-
15-
The installation requires {project-minimum-memory} of memory.
16-
For more information, see {InstallingServerDocURL}system-requirements_{project-context}[System Requirements].
17-
18-
The Foreman installer uses Puppet to install Foreman.
19-
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.
13+
include::common/modules/ref_system-requirements-quickstart.adoc[leveloffset=+1]
2014

2115
include::common/modules/con_configuring-repositories.adoc[leveloffset=+1]
2216

0 commit comments

Comments
 (0)