From fe13d443629dfd412da983d600c525f0adeb2ee4 Mon Sep 17 00:00:00 2001 From: Dan Winship Date: Mon, 1 Feb 2021 13:07:32 -0500 Subject: [PATCH] Clarify that you should almost never manually override the MTU - https://bugzilla.redhat.com/show_bug.cgi?id=1877570 Co-authored-by: Dan Winship Co-authored-by: Cody Hoag --- modules/nw-operator-cr.adoc | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/modules/nw-operator-cr.adoc b/modules/nw-operator-cr.adoc index 8086b50959..0326520967 100644 --- a/modules/nw-operator-cr.adoc +++ b/modules/nw-operator-cr.adoc @@ -121,10 +121,11 @@ configuration. are `Multitenant`, `Subnet`, or `NetworkPolicy`. The default value is `NetworkPolicy`. -<4> The maximum transmission unit (MTU) for the VXLAN overlay network. This -value is normally configured automatically, but if the nodes in your cluster do -not all use the same MTU, then you must set this explicitly to 50 less than the -smallest node MTU value. +<4> The maximum transmission unit (MTU) for the VXLAN overlay network. This is detected automatically based on the MTU of the primary network interface. You do not normally need to override the detected MTU. ++ +If the auto-detected value is not what you expected it to be, confirm that the MTU on the primary network interface on your nodes is correct. You cannot use this option to change the MTU value of the primary network interface on the nodes. ++ +If your cluster requires different MTU values for different nodes, you must set this value to `50` less than the lowest MTU value in your cluster. For example, if some nodes in your cluster have an MTU of `9001`, and some have an MTU of `1500`, you must set this value to `1450`. <5> The port to use for all VXLAN packets. The default value is `4789`. If you are running in a virtualized environment with existing nodes that are part of @@ -193,10 +194,11 @@ ifdef::operator[] endif::operator[] ifndef::operator[] -<3> The MTU for the Geneve (Generic Network Virtualization Encapsulation) -overlay network. This value is normally configured automatically, but if the -nodes in your cluster do not all use the same MTU, then you must set this -explicitly to 100 less than the smallest node MTU value. +<3> The maximum transmission unit (MTU) for the Geneve (Generic Network Virtualization Encapsulation) overlay network. This is detected automatically based on the MTU of the primary network interface. You do not normally need to override the detected MTU. ++ +If the auto-detected value is not what you expected it to be, confirm that the MTU on the primary network interface on your nodes is correct. You cannot use this option to change the MTU value of the primary network interface on the nodes. ++ +If your cluster requires different MTU values for different nodes, you must set this value to `100` less than the lowest MTU value in your cluster. For example, if some nodes in your cluster have an MTU of `9001`, and some have an MTU of `1500`, you must set this value to `1400`. endif::operator[] ifdef::operator[]