Skip to content

Commit 5f5d4ee

Browse files
committed
OCPBUGS-55288: Added note about bonded interface and node IP address issues
1 parent 3c45433 commit 5f5d4ee

File tree

1 file changed

+20
-15
lines changed

1 file changed

+20
-15
lines changed

modules/ipi-install-establishing-communication-between-subnets.adoc

Lines changed: 20 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,12 @@
88

99
In a typical {product-title} cluster setup, all nodes, including the control plane and compute nodes, reside in the same network. However, for edge computing scenarios, it can be beneficial to locate compute nodes closer to the edge. This often involves using different network segments or subnets for the remote nodes than the subnet used by the control plane and local compute nodes. Such a setup can reduce latency for the edge and allow for enhanced scalability.
1010

11-
Before installing {product-title}, you must configure the network properly to ensure that the edge subnets containing the remote nodes can reach the subnet containing the control plane nodes and receive traffic from the control plane too.
11+
Before installing {product-title}, you must configure the network properly to ensure that the edge subnets containing the remote nodes can reach the subnet containing the control plane nodes and receive traffic from the control plane too.
12+
13+
[IMPORTANT]
14+
====
15+
During cluster installation, assign permanent IP addresses to nodes in the network configuration of the `install-config.yaml` configuration file. If you do not do this, nodes might get assigned a temporary IP address that can impact how traffic reaches the nodes. For example, if a node has a temporary IP address assigned to it and you configured a bonded interface for a node, the bonded interface might receive a different IP address.
16+
====
1217

1318
You can run control plane nodes in the same subnet or multiple subnets by configuring a user-managed load balancer in place of the default load balancer. With a multiple subnet environment, you can reduce the risk of your {product-title} cluster from failing because of a hardware failure or a network outage. For more information, see "Services for a user-managed load balancer" and "Configuring a user-managed load balancer".
1419

@@ -33,21 +38,21 @@ In this procedure, the cluster spans two subnets:
3338
.Procedure
3439

3540
. Configure the first subnet to communicate with the second subnet:
36-
41+
+
3742
.. Log in as `root` to a control plane node by running the following command:
3843
+
3944
[source,terminal]
4045
----
4146
$ sudo su -
4247
----
43-
48+
+
4449
.. Get the name of the network interface by running the following command:
4550
+
4651
[source,terminal]
4752
----
4853
# nmcli dev status
4954
----
50-
55+
+
5156
.. Add a route to the second subnet (`192.168.0.0`) via the gateway by running the following command:
5257
+
5358
[source,terminal]
@@ -63,7 +68,7 @@ Replace `<interface_name>` with the interface name. Replace `<gateway>` with the
6368
----
6469
# nmcli connection modify eth0 +ipv4.routes "192.168.0.0/24 via 192.168.0.1"
6570
----
66-
71+
+
6772
.. Apply the changes by running the following command:
6873
+
6974
[source,terminal]
@@ -72,14 +77,14 @@ Replace `<interface_name>` with the interface name. Replace `<gateway>` with the
7277
----
7378
+
7479
Replace `<interface_name>` with the interface name.
75-
80+
+
7681
.. Verify the routing table to ensure the route has been added successfully:
7782
+
7883
[source,terminal]
7984
----
8085
# ip route
8186
----
82-
87+
+
8388
.. Repeat the previous steps for each control plane node in the first subnet.
8489
+
8590
[NOTE]
@@ -88,21 +93,21 @@ Adjust the commands to match your actual interface names and gateway.
8893
====
8994

9095
. Configure the second subnet to communicate with the first subnet:
91-
96+
+
9297
.. Log in as `root` to a remote compute node by running the following command:
9398
+
9499
[source,terminal]
95100
----
96101
$ sudo su -
97102
----
98-
103+
+
99104
.. Get the name of the network interface by running the following command:
100105
+
101106
[source,terminal]
102107
----
103108
# nmcli dev status
104109
----
105-
110+
+
106111
.. Add a route to the first subnet (`10.0.0.0`) via the gateway by running the following command:
107112
+
108113
[source,terminal]
@@ -118,7 +123,7 @@ Replace `<interface_name>` with the interface name. Replace `<gateway>` with the
118123
----
119124
# nmcli connection modify eth0 +ipv4.routes "10.0.0.0/24 via 10.0.0.1"
120125
----
121-
126+
+
122127
.. Apply the changes by running the following command:
123128
+
124129
[source,terminal]
@@ -127,14 +132,14 @@ Replace `<interface_name>` with the interface name. Replace `<gateway>` with the
127132
----
128133
+
129134
Replace `<interface_name>` with the interface name.
130-
135+
+
131136
.. Verify the routing table to ensure the route has been added successfully by running the following command:
132137
+
133138
[source,terminal]
134139
----
135140
# ip route
136141
----
137-
142+
+
138143
.. Repeat the previous steps for each compute node in the second subnet.
139144
+
140145
[NOTE]
@@ -143,7 +148,7 @@ Adjust the commands to match your actual interface names and gateway.
143148
====
144149

145150
. After you have configured the networks, test the connectivity to ensure the remote nodes can reach the control plane nodes and the control plane nodes can reach the remote nodes.
146-
151+
+
147152
.. From the control plane nodes in the first subnet, ping a remote node in the second subnet by running the following command:
148153
+
149154
[source,terminal]
@@ -152,7 +157,7 @@ $ ping <remote_node_ip_address>
152157
----
153158
+
154159
If the ping is successful, it means the control plane nodes in the first subnet can reach the remote nodes in the second subnet. If you do not receive a response, review the network configurations and repeat the procedure for the node.
155-
160+
+
156161
.. From the remote nodes in the second subnet, ping a control plane node in the first subnet by running the following command:
157162
+
158163
[source,terminal]

0 commit comments

Comments
 (0)