Blame view

Documentation/networking/vxlan.txt 1.97 KB
d342894c5   stephen hemminger   vxlan: virtual ex...
1
2
  Virtual eXtensible Local Area Networking documentation
  ======================================================
e8fed985d   Rick Jones   documentation: br...
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
  The VXLAN protocol is a tunnelling protocol designed to solve the
  problem of limited VLAN IDs (4096) in IEEE 802.1q.  With VXLAN the
  size of the identifier is expanded to 24 bits (16777216).
  
  VXLAN is described by IETF RFC 7348, and has been implemented by a
  number of vendors.  The protocol runs over UDP using a single
  destination port.  This document describes the Linux kernel tunnel
  device, there is also a separate implementation of VXLAN for
  Openvswitch.
  
  Unlike most tunnels, a VXLAN is a 1 to N network, not just point to
  point. A VXLAN device can learn the IP address of the other endpoint
  either dynamically in a manner similar to a learning bridge, or make
  use of statically-configured forwarding entries.
  
  The management of vxlan is done in a manner similar to its two closest
  neighbors GRE and VLAN. Configuring VXLAN requires the version of
  iproute2 that matches the kernel release where VXLAN was first merged
  upstream.
d342894c5   stephen hemminger   vxlan: virtual ex...
22
23
  
  1. Create vxlan device
e8fed985d   Rick Jones   documentation: br...
24
25
26
27
28
29
30
31
32
   # ip link add vxlan0 type vxlan id 42 group 239.1.1.1 dev eth1 dstport 4789
  
  This creates a new device named vxlan0.  The device uses the multicast
  group 239.1.1.1 over eth1 to handle traffic for which there is no
  entry in the forwarding table.  The destination port number is set to
  the IANA-assigned value of 4789.  The Linux implementation of VXLAN
  pre-dates the IANA's selection of a standard destination port number
  and uses the Linux-selected value by default to maintain backwards
  compatibility.
d342894c5   stephen hemminger   vxlan: virtual ex...
33
34
35
36
37
  
  2. Delete vxlan device
    # ip link delete vxlan0
  
  3. Show vxlan info
cc9b31016   Zhi Yong Wu   vxlan: fix comman...
38
    # ip -d link show vxlan0
d342894c5   stephen hemminger   vxlan: virtual ex...
39
40
41
42
43
44
45
46
  
  It is possible to create, destroy and display the vxlan
  forwarding table using the new bridge command.
  
  1. Create forwarding table entry
    # bridge fdb add to 00:17:42:8a:b4:05 dst 192.19.0.2 dev vxlan0
  
  2. Delete forwarding table entry
cc9b31016   Zhi Yong Wu   vxlan: fix comman...
47
    # bridge fdb delete 00:17:42:8a:b4:05 dev vxlan0
d342894c5   stephen hemminger   vxlan: virtual ex...
48
49
50
  
  3. Show forwarding table
    # bridge fdb show dev vxlan0