document workarounds for cilium/flannel and calico

spectrocloud · Jan 3, 2024 · b97e2a7 · b97e2a7
1 parent 339001f
commit b97e2a7
Showing 1 changed file with 15 additions and 4 deletions.
diff --git a/docs/docs-content/clusters/edge/networking/vxlan-overlay.md b/docs/docs-content/clusters/edge/networking/vxlan-overlay.md
@@ -36,7 +36,18 @@ The Analytics team of a manufacturing company is deploying an Edge host to their
 
 * At least one Edge host registered with your Palette account.
 * Your cluster profile must have K3s as its Kubernetes distribution. 
-* All Edge hosts must be on the same network. You may provision your own virtual network to connect Edge hosts that are on different physical networks, but all Edge hosts to be included in the cluster must be on the same network before cluster creation.
+* All Edge hosts must be on the same Layer-2 network.
+* If your Edge hosts are using virtual ethernet adapters and you are using either Cilium or Flannel as your network adapter, ensure that you add the following commands in the **user-data** file at the boot stage.
+  ```yaml {2-6}
+  stages:
+    boot:
+        - name: "Disable UDP segmentation"
+        commands:
+            - ethtool -K ens160 tx-udp_tnl-segmentation off
+            - ethtool -K ens160 tx-udp_tnl-csum-segmentation off
+  ```
+  This is related to a bug in VMWare's VMXNET3 adapter, which is widely used in different virtual machine management services, including VMWare vSphere and Hyper-V. 
+
 
 ## Enable Overlay Network
 
@@ -73,16 +84,16 @@ You will not be able to change the network overlay configurations after the clus
     <Tabs>
     <TabItem value="calico" label="Calico">
 
-    In the Calico pack YAML file default template, uncomment `manifests.calico.env.calicoNode.IP_AUTODETECTION_METHOD` and set its value to `interface=scbr-100`. 
-    ```yaml {11}
+    In the Calico pack YAML file default template, uncomment `FELIX_IPV6SUPPORT` and set its value to `scbr-100` and uncomment `manifests.calico.env.calicoNode.IP_AUTODETECTION_METHOD` and set its value to `interface=scbr-100`.  
+    ```yaml {8,11}
     manifests:
         calico:
             ...
             env:
             # Additional env variables for calico-node
             calicoNode:
                 #IPV6: "autodetect"
-                #FELIX_IPV6SUPPORT: "true"
+                FELIX_IPV6SUPPORT: "scbr-100"
                 #CALICO_IPV6POOL_NAT_OUTGOING: "true"
                 #CALICO_IPV4POOL_CIDR: "192.168.0.0/16"
                 IP_AUTODETECTION_METHOD: "interface=scbr-100"