-
Notifications
You must be signed in to change notification settings - Fork 1.8k
OSDOCS-14356-New: Added bond best practices info to networking docs #93160
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -220,7 +220,20 @@ ifndef::ibm-z-kvm[] | |
[discrete] | ||
=== Bonding multiple network interfaces to a single interface | ||
|
||
Optional: You can bond multiple network interfaces to a single interface by using the `bond=` option. Refer to the following examples: | ||
As an optional configuration, you can bond multiple network interfaces to a single interface by using the `bond=` option. To apply this configuration to your cluster, complete the procedure steps for each node that runs on your cluster. | ||
|
||
[IMPORTANT] | ||
==== | ||
A bonding mode specifies the policy for how bond interfaces are used during network transmission. If your network configuration includes an Open vSwitch (OVS) interface and you enabled `active-backup` bond mode, you must specify a Media Access Control (MAC) address failover. This configuration prevents node communication issues with the bond interfaces, such as `eno1f0` and `eno2f0`. | ||
The following list details supported values for the `fail_over_mac` parameter: | ||
* `0`: Specifies the `none` value and this is the default value that disables MAC address failover so that all nodes receive the same MAC address as the bond interface. With this setting, packets might be sent to inactive nodes. | ||
* `1`: Specifies the `active` value and sets the MAC address of the primary bond interface to always remain the same as active nodes. If during a failover, the MAC address of a node changes, the MAC address of the bond interface changes to match the new MAC address of the node. | ||
* `2`: Specifies the `follow` value so that during a failover, an active node gets the MAC address of the bond interface and a formerly active node receives the MAC address of the newly active node. | ||
==== | ||
|
||
.Procedure | ||
|
||
* The syntax for configuring a bonded interface is: `bond=<name>[:<network_interfaces>][:options]` | ||
+ | ||
|
@@ -235,7 +248,7 @@ information for the bonded interface. | |
[source,terminal] | ||
---- | ||
bond=bond0:em1,em2:mode=active-backup | ||
ip=bond0:dhcp | ||
fail_over_mac=1 | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. This is an unsupported value for fail_over_mac. Also, this won't work as written. It needs to be part of the colon-separated list on the bond= line. That said, the default value is 0, which is what we recommend anyway, so I'm not sure we even need to explicitly include this option. |
||
---- | ||
|
||
** To configure the bonded interface to use a static IP address, enter the specific IP address you want and related information. For example: | ||
|
@@ -266,7 +279,6 @@ Optional: You can configure VLANs on bonded interfaces by using the `vlan=` para | |
|
||
[source,terminal] | ||
---- | ||
ip=bond0.100:dhcp | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Why are these lines being removed? |
||
bond=bond0:em1,em2:mode=active-backup | ||
vlan=bond0.100:bond0 | ||
---- | ||
|
@@ -287,9 +299,9 @@ ifndef::ibm-z[] | |
[discrete] | ||
=== Bonding multiple SR-IOV network interfaces to a dual port NIC interface | ||
|
||
Optional: You can bond multiple SR-IOV network interfaces to a dual port NIC interface by using the `bond=` option. | ||
As an optional configuration, you can bond multiple SR-IOV network interfaces to a dual port NIC interface by using the `bond=` option. | ||
|
||
On each node, you must perform the following tasks: | ||
.Procedure | ||
|
||
ifndef::installing-ibm-power[] | ||
. Create the SR-IOV virtual functions (VFs) following the guidance in link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/configuring_and_managing_virtualization/managing-virtual-devices_configuring-and-managing-virtualization#managing-sr-iov-devices_managing-virtual-devices[Managing SR-IOV devices]. Follow the procedure in the "Attaching SR-IOV networking devices to virtual machines" section. | ||
|
@@ -313,7 +325,6 @@ The following examples illustrate the syntax you must use: | |
[source,terminal] | ||
---- | ||
bond=bond0:eno1f0,eno2f0:mode=active-backup | ||
ip=bond0:dhcp | ||
---- | ||
|
||
** To configure the bonded interface to use a static IP address, enter the specific IP address you want and related information. For example: | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -8,6 +8,11 @@ | |
|
||
You can create multiple interfaces in the same node network configuration policy. These interfaces can reference each other, allowing you to build and deploy a network configuration by using a single policy manifest. | ||
|
||
[IMPORTANT] | ||
==== | ||
If multiple interfaces use the same default configuration, a single Network Manager connection profile activates on multiple interfaces simultaneously and this causes connections to have the same universally unique identifier (UUID). To avoid this issue, ensure that each interface has a specific configuration that is different to the default configuration. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 🤖 [error] RedHat.TermsErrors: Use 'different from' rather than 'different to'. For more information, see RedHat.TermsErrors. |
||
==== | ||
|
||
The following example YAML file creates a bond that is named `bond10` across two NICs and VLAN that is named `bond10.103` that connects to the bond. | ||
|
||
[source,yaml] | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm not sure what our doc guidelines say, but to me this change indicates that a DHCP server is mandatory, which is contradicted by the next point in this note.