Displaying VXLAN information

You can display information on VXLAN gateways, connections, and tunnels.
Use the following commands to view VXLAN information. Using these commands is optional, and they can be entered in any order. For more information on the full list of commands, refer to the RUCKUS FastIron Command Reference.
  1. To display information on the VXLAN running configuration, enter the show running-config overlay-gateway command. 
    device# show running-config overlay-gateway
overlay-gateway sanjose
 type layer2-extension
 ip interface loopback 1
 map vlan 101 to vni 25838
 map vlan 102 to vni 67924
 site denver
  ip address 2.2.2.2
  ip address 3.3.3.1 secondary index 2
  ip address 4.4.4.1 secondary index 3
  ip address 5.5.5.1 secondary index 5
  failure-detection keep-alive 10 retry 4
  extend vlan add 101
  extend vlan add 102
!
!
    The example displays the VXLAN running configuration for the overlay gateway sanjose. The example also shows that two VLANs are configured and extended to the remote site denver, which has a primary IP address of 2.2.2.2 and three secondary IP addresses. Information on failure detection is present because the option is enabled.
  2. To display brief information on all VXLAN gateways, enter the show overlay-gateway command. To display brief information about a specific VXLAN gateway, enter the show overlay-gateway command followed by the name of the gateway, as shown in the following example. 
    device# show overlay-gateway sanjose

Overlay Gateway Name    : sanjose
Type                    : layer2-extension
Source IP Interface     : loopback 1 (vrf: default-vrf, IP address: 7.7.7.7)
Total Mapped Vlans      : 2
Total Sites             : 1
    The example displays brief information for the overlay gateway sanjose. Information on the VRF and configured IP address is included.
  3. To display detailed information for a particular overlay gateway, enter the show overlay-gateway command, the name of the overlay gateway, and the detail keyword, as shown in the following example. 
    device# show overlay-gateway gt-1 detail

Overlay Gateway Name    : gt-1
Type                    : layer2-extension
Source IP Interface     : loopback 1 (vrf: default-vrf, IP address: 10.10.10.1)
Total Mapped Vlans      : 1
Total Sites             : 2
#    VLAN-ID VN-ID    VFI     Access-Port Extended-Site Cross-Connect
-    ------- -----    ---     ----------- ------------- -------------
1    100     10000    100         2            2        DISABLED

#    SiteName                Active IP-Address    Status     Monitoring   Connection Ext-Vlans
-    --------                -----------------    ------     ----------   ---------- ---------
1    mm1-site                20.20.20.1           Up         DISABLED     N/A        (100)
2    mm2-site                70.70.70.1           Up         DISABLED     N/A        (100)

    The example displays detailed output for the overlay gateway gt-1, including the following information:

    • For each mapped VLAN, the VNI and the Virtual Forwarding Instance (VFI) (the internal Layer 2 VPN identifier, which is the same as the VLAN identifier), along with the number of access (local) ports belonging to that VLAN and the number of sites to which this mapped VLAN is extended
    • For each site, details such as the site name, the site IP address, the status of the VXLAN tunnel to that site, and the VLANs that are extended to the site

  4. To display information on a particular VLAN, enter the show overlay-gateway command followed by the overlay gateway name, the vlan keyword, and the VLAN number, as shown in the following example. 
    device# show overlay-gateway sanjose vlan 101
Overlay Gateway Name    : sanjose
#    VLAN-ID    VN-ID    VFI     Access-Port Extended-Site
-    -------    -----    ---     ----------- -------------
1    101        25838    101     5           1
    For the mapped VLAN, the VNI and the Virtual Forwarding Instance (VFI) (the internal Layer 2 VPN identifier, which is the same as the VLAN identifier) are shown, along with the number of access (local) ports belonging to that VLAN and the number of sites to which this mapped VLAN is extended.
  5. To display information on a particular VNI, enter the show overlay-gateway command followed by the overlay gateway name, the vni keyword, and the VNI number, as shown in the following example. 
    device# show overlay-gateway sanjose vni 25838
Overlay Gateway Name    : sanjose
#    VN-ID      VLAN-ID  VFI     Access-Port Extended-Site
-    -----      -------  ---     ----------- -------------
1    25838      101      101     5           1


    device# show overlay-gateway sanjose vni 67924
Overlay Gateway Name    : sanjose
#    VN-ID      VLAN-ID  VFI     Access-Port Extended-Site
-    -----      -------  ---     ----------- -------------
1    67924      102      102     3           1
    The two examples of command output display information for the two VNIs configured for the overlay gateway sanjose. For the VNI, the VLAN and Virtual Forwarding Instance (VFI) (the internal Layer 2 VPN identifier, which is the same as the VLAN identifier) are shown, along with the number of access (local) ports belonging to the VLAN and the number of sites to which the mapped VLAN is extended.
  6. To display information on a remote site, enter the show overlay-gateway command followed by the overlay gateway name, the site keyword, and the name of the remote site, as shown in the following examples. 
    device# show overlay-gateway gt-1 site mm1-site
Overlay Gateway Site Name     : mm1-site
Active IP address             : 20.20.20.1
Status                        : Up
Monitoring                    : Disabled
Connection                    : N/A
Extended Vlans                :
   100

device# show overlay-gateway gt-1 site mm2-site
Overlay Gateway Site Name     : mm2-site
Active IP address             : 70.70.70.1
Status                        : Up
Monitoring                    : Disabled
Connection                    : N/A
Extended Vlans                :
   100
    The previous examples show output for a system in which failure detection (Monitoring) is disabled.
    device# show overlay-gateway sanjose site denver
Overlay Gateway Site Name     : denver
Active IP address             : 2.2.2.2
IP List                       : 3.3.3.1, 4.4.4.1, 5.5.5.1 

Status                        : Up
Monitoring                    : ENABLED
Connection                    : Alive
Extended Vlans                :
   101, 102
Total 2 Extended Vlan
    The previous example shows output for a system in which failure detection is enabled. The example displays the IP address for the remote site denver, the status of the VXLAN tunnel to that site, and the mapped VLANs that are extended to the site. 
    device# show overlay-gateway sanjose site denver
Overlay Gateway Site Name     : denver
IP address                    : 2.2.2.2
Status                        : Down(No Source Interface)
Monitoring                    : DISABLED
Connection                    : N/A
Extended Vlans                :
   101, 102
Total 2 Extended Vlan
    The previous example shows the remote site denver is down because no source interface has been configured for the remote site. 
    device# show overlay-gateway sanjose site denver
Overlay Gateway Site Name     : denver
IP address                    : 2.2.2.2
Status                        : Down(No Route to Destination)
Monitoring                    : DISABLED
Connection                    : N/A
Extended Vlans                :
   101, 102
Total 2 Extended Vlan
    The previous example shows the remote site denver is down because no route is available to the destination.
  7. To display information on MAC addresses learned from a particular remote site, enter the show mac-address vxlan gw command followed by the overlay gateway name, the site keyword and the remote site name, as shown in the following example. 
    device# show mac-address vxlan gw sanjose site denver
Total active entries from remote-site denver = 2
MAC-Address        VNI         Type         Port
000c.2900.0022     25838       Dynamic      VxL-2.2.2.2
000c.2900.0023     67924       Dynamic      VxL-2.2.2.2

    The example shows the MAC addresses learned for the site denver on the VXLAN overlay gateway sanjose. VNI information is displayed for the MAC address instead of the VLAN. The port information is the IP address of the site denver with the prefix "VxL-".

    Note: MAC addresses learned from the remote site are shown with the prefix "VxL-" followed by the IP address of the remote site.

    Note: The IP address for the VXLAN tunnel (remote site) and its configured extended VLANs are also displayed in the output for the basic show mac-address command.
  8. To display MAC address information for a particular VNI, enter the show mac-address vxlan vni command followed by the VNI number, as shown in the following example. 
    device# show mac-address vxlan vni 25838
Total active entries from VNI 25838 = 2
MAC-Address      VNI          Type          Port
000c.2900.0011   25838        Dynamic       1/1/48
000c.2900.0022   25838        Dynamic       VxL-2.2.2.2
    The example displays two MAC addresses for VNI 25838, one associated with port 1/1/48, which is the local VXLAN access port, and the other associated with the remote site (VxL-2.2.2.2). Previous output from the show overlay-gateway sanjose vni 25838 command (refer to Step 5) shows that the VNI is associated with local VLAN 101.
  9. To display MAC address information for a particular VLAN, enter the show mac-address vlan command followed by the VLAN number. 
    device# show mac-address vlan 101
Total active entries from VLAN 101 = 2
MAC-Address     Port         Type          VLAN
000c.2900.0011  1/1/48       Dynamic       101  
000c.2900.0022  VxL-2.2.2.2  Dynamic       101
    The example shows two MAC addresses associated with VLAN 101, one for the local VXLAN access port 1/1/48, and the other for the VXLAN remote site with the destination IP address 2.2.2.2.
    Note: The clear mac-address command can be used with all the parameters given in the show mac-address examples to clear old table entries. For example, the clear mac-address vlan 101 command clears the MAC address table entries for the VLAN.
Parent topic: VXLAN