Skip to content

Commit b74d86b

Browse files
committed
Merge modules on opening ports
1 parent bebfab9 commit b74d86b

10 files changed

+93
-118
lines changed

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ include::modules/ref_best-practices-for-optimizing-storage.adoc[leveloffset=+1]
2020
endif::[]
2121

2222
// Enabling Connections from {ProjectServer} and Clients to a {SmartProxyServer}
23-
include::modules/proc_enabling-connections-to-capsule.adoc[leveloffset=+1]
23+
include::modules/proc_opening-required-ports.adoc[leveloffset=+1]
2424

2525
ifdef::parent-context[:context: {parent-context}]
2626
ifndef::parent-context[:!context:]

guides/common/assembly_preparing-environment-for-project-server-installation.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
include::modules/con_preparing-environment-for-project-server-installation.adoc[]
44

5-
include::modules/proc_enabling-client-connections-to-project-server.adoc[leveloffset=+1]
5+
include::modules/proc_opening-required-ports.adoc[leveloffset=+1]
66

77
include::modules/proc_verifying-dns-resolution.adoc[leveloffset=+1]
88

guides/common/modules/proc_configuring-capsule-default-certificate.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ endif::[]
1414
* {SmartProxyServer} packages are installed.
1515
For more information, see xref:installing-{smart-proxy-context}-server-packages[].
1616
* The required ports are open.
17-
For more information, see xref:common/modules/proc_enabling-connections-to-capsule.adoc#enabling-connections-to-capsule_{context}[].
17+
For more information, see xref:common/modules/proc_opening-required-ports.adoc#opening-required-ports[].
1818

1919
.Procedure
2020

guides/common/modules/proc_deploying-a-custom-ssl-certificate-to-smart-proxy-server.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ For more information, see xref:Registering_Proxy_to_Server_{smart-proxy-context}
1515
* {SmartProxyServer} packages are installed.
1616
For more information, see xref:installing-{smart-proxy-context}-server-packages[].
1717
* The required ports are open.
18-
For more information, see xref:common/modules/proc_enabling-connections-to-capsule.adoc#enabling-connections-to-capsule_{context}[].
18+
For more information, see xref:common/modules/proc_opening-required-ports.adoc#opening-required-ports[].
1919

2020
.Procedure
2121
. On your {ProjectServer}, generate a certificate bundle:

guides/common/modules/proc_enabling-client-connections-to-project-server.adoc

Lines changed: 0 additions & 51 deletions
This file was deleted.

guides/common/modules/proc_enabling-connections-to-capsule.adoc

Lines changed: 0 additions & 48 deletions
This file was deleted.
Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
:_mod-docs-content-type: PROCEDURE
2+
3+
[id="opening-required-ports"]
4+
= Opening required ports
5+
6+
For the components of {Project} architecture to communicate, ensure that the required network ports are open and free on the base operating system.
7+
You must also ensure that the required network ports are open on any network-based firewalls.
8+
9+
[NOTE]
10+
====
11+
Some cloud solutions must be specifically configured to allow communications between machines because they isolate machines similarly to network-based firewalls.
12+
If you use an application-based firewall, ensure that the application-based firewall permits all applications that are listed in the tables and known to your firewall.
13+
If possible, disable the application checking and allow open port communication based on the protocol.
14+
====
15+
16+
ifndef::satellite,orcharhino[]
17+
If you do not use `firewall-cmd` to configure the Linux firewall, implement using the command of your choice.
18+
endif::[]
19+
20+
.Procedure
21+
. Optional: If you need to prevent the DHCP {SmartProxy} from pinging hosts to check for available IP addresses, disable DHCP IP address pinging:
22+
+
23+
[options="nowrap", subs="+quotes,attributes"]
24+
----
25+
# {foreman-installer} --foreman-proxy-dhcp-ping-free-ip false
26+
----
27+
+
28+
By default, a DHCP {SmartProxy} performs ICMP ping and TCP echo connection attempts to hosts in subnets with DHCP IPAM set to find out if an IP address considered for use is free.
29+
ifdef::katello,satellite,orcharhino[]
30+
ifeval::["{context}" == "{project-context}"]
31+
. Open the ports for clients on {ProjectServer}:
32+
endif::[]
33+
ifeval::["{context}" == "{smart-proxy-context}"]
34+
. Open the ports for clients on {SmartProxyServer}:
35+
endif::[]
36+
+
37+
[options="nowrap"]
38+
----
39+
# firewall-cmd \
40+
--add-port="8000/tcp" \
41+
--add-port="9090/tcp"
42+
----
43+
endif::[]
44+
ifeval::["{context}" == "{project-context}"]
45+
. Allow access to services on {ProjectServer}:
46+
endif::[]
47+
ifeval::["{context}" == "{smart-proxy-context}"]
48+
. Allow access to services on {SmartProxyServer}:
49+
endif::[]
50+
+
51+
[options="nowrap"]
52+
----
53+
# firewall-cmd \
54+
--add-service=dns \
55+
--add-service=dhcp \
56+
--add-service=tftp \
57+
--add-service=http \
58+
--add-service=https \
59+
ifndef::katello,satellite,orcharhino[]
60+
--add-service=foreman-proxy \
61+
endif::[]
62+
--add-service=puppetmaster
63+
----
64+
. Make the changes persistent:
65+
+
66+
[options="nowrap", subs="+quotes,verbatim,attributes"]
67+
----
68+
# firewall-cmd --runtime-to-permanent
69+
----
70+
71+
.Verification
72+
* Enter the following command:
73+
+
74+
[options="nowrap"]
75+
----
76+
# firewall-cmd --list-all
77+
----
78+
79+
.Additional resources
80+
* {PlanningDocURL}networking-in-a-{project-context}-deployment[Networking in a {Project} deployment]
81+
ifndef::foreman-deb[]
82+
* https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/configuring_firewalls_and_packet_filters/using-and-configuring-firewalld_firewall-packet-filters/9/html/configuring_firewalls_and_packet_filters/using-and-configuring-firewalld_firewall-packet-filters[Using and configuring firewalld in _{RHEL}{nbsp}9 Configuring firewalls and packet filters_]
83+
endif::[]

guides/common/modules/proc_registering-capsule-to-satellite-server.adoc

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,5 +18,10 @@ For more information on manifests and repositories, see {ContentManagementDocURL
1818
** Ensure HTTPS connection using client certificate authentication is possible between {SmartProxyServer} and {ProjectServer}.
1919
HTTP proxies between {SmartProxyServer} and {ProjectServer} are not supported.
2020
** You must configure the host and network-based firewalls accordingly.
21-
For more information, see xref:common/modules/proc_enabling-connections-to-capsule.adoc#enabling-connections-to-capsule_{context}[].
21+
ifeval::["{context}" == "load-balancing"]
22+
For more information, see {InstallingSmartProxyDocURL}opening-required-ports[Opening required ports in _{InstallingSmartProxyDocTitle}_].
23+
endif::[]
24+
ifeval::["{context}" == "installing-capsule-server"]
25+
For more information, see xref:common/modules/proc_opening-required-ports.adoc#opening-required-ports[].
26+
endif::[]
2227
include::snip_host-registration-steps.adoc[]

guides/common/modules/snip_firewalld.adoc

Lines changed: 0 additions & 3 deletions
This file was deleted.

guides/common/modules/snip_verify-firewall-settings.adoc

Lines changed: 0 additions & 11 deletions
This file was deleted.

0 commit comments

Comments
 (0)