diff --git a/docs/configuration/interfaces/geneve.rst b/docs/configuration/interfaces/geneve.rst index e9d2d52b28..d8b05a390a 100644 --- a/docs/configuration/interfaces/geneve.rst +++ b/docs/configuration/interfaces/geneve.rst @@ -1,28 +1,32 @@ -:lastproofread: 2023-01-20 +:lastproofread: 2026-02-02 .. _geneve-interface: ###### -GENEVE +Geneve ###### -:abbr:`GENEVE (Generic Network Virtualization Encapsulation)` supports all of -the capabilities of :abbr:`VXLAN (Virtual Extensible LAN)`, :abbr:`NVGRE -(Network Virtualization using Generic Routing Encapsulation)`, and :abbr:`STT -(Stateless Transport Tunneling)` and was designed to overcome their perceived -limitations. Many believe GENEVE could eventually replace these earlier formats -entirely. +:abbr:`Geneve (Generic Network Virtualization Encapsulation)` interfaces +operate as virtual network ports. Administrators can apply standard network +configurations on them, such as IP addressing, bridging, or firewall rules, +just as they would on physical Ethernet ports. -GENEVE is designed to support network virtualization use cases, where tunnels -are typically established to act as a backplane between the virtual switches -residing in hypervisors, physical switches, or middleboxes or other appliances. -An arbitrary IP network can be used as an underlay through Clos networks - A -technique for composing network fabrics larger than a single switch while -maintaining non-blocking bandwidth across connection points. ECMP is used to -divide traffic across the multiple links and switches that constitute the -fabric. Sometimes termed "leaf and spine" or "fat tree" topologies. +To transport data across the network, they utilize the Geneve encapsulation protocol. This +protocol encapsulates Layer 2 Ethernet frames originating from endpoints such +as virtual machines, containers, or physical servers inside UDP packets. It +unifies the features of earlier encapsulation protocols, including VXLAN, +NVGRE, and STT, and addresses their limitations, such as fixed header +structures and a lack of metadata support. Because of its extensibility, Geneve +may eventually replace those older protocols. -Geneve Header: +Geneve tunnels are used to connect virtual switches residing within +hypervisors, physical switches, middleboxes, and other network appliances. + +Geneve tunnels operate over any standard IP network. In larger deployments, +the underlying network (underlay) is often built using a **Clos** topology, +also known as a *leaf-and-spine* or *fat-tree* topology. + +Geneve header: .. code-block:: none @@ -69,24 +73,29 @@ Common interface configuration :var0: geneve :var1: gnv0 -GENEVE options +Geneve options ============== .. cfgcmd:: set interfaces geneve gnv0 remote
- Configure GENEVE tunnel far end/remote tunnel endpoint. + Configure the remote endpoint IP address for the Geneve tunnel. .. cfgcmd:: set interfaces geneve gnv0 vni