Displaying VXLAN Information
You can display information on VXLAN
gateways, connections, and tunnels.
- To display information on the VXLAN running
configuration, enter the
show running-config overlay-gatewaycommand.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 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. - To display brief information on all
VXLAN gateways, enter the
show overlay-gatewaycommand. To display brief information about a specific VXLAN gateway, enter theshow overlay-gatewaycommand 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. - To display detailed information for a
particular overlay gateway, enter the
show overlay-gatewaycommand, 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
- To display information on a particular
VLAN, enter the
show overlay-gatewaycommand 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. - To display information on a particular
VNI, enter the
show overlay-gatewaycommand 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. - To display information on a remote site,
enter the
show overlay-gatewaycommand 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. - To display information on MAC addresses
learned from a particular remote site, enter the
show mac-address vxlan gwcommand 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. - To display MAC address information for a
particular VNI, enter the
show mac-address vxlan vnicommand 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 theshow overlay-gateway sanjose vni 25838command (refer to Step 5) shows that the VNI is associated with local VLAN 101. - To display MAC address information for a
particular VLAN, enter the
show mac-address vlancommand 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. - To display information for all remote
sites, enter the
show overlay-gatewaycommand, specifying the name of the gateway, with the site and all keywords.device(config-overlay-gw-gt-1)# show overlay-gateway gt-1 site all 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 # SiteName IP-Address Status Ext-Vlans - -------- ---------- ------ --------- 1 mm1-site 20.20.20.1 Up (100) 2 mm2-site 70.70.70.1 Up (100)
The example shows that two remote sites are configured for the overlay gateway gt-1. The status of the VXLAN tunnel for each one is up. Both sites are mapped to the same VLAN. - To display network counters for a site,
enter the
show overlay-gatewaycommand followed by the name of the gateway, specifying the site keyword followed by the site name, with the network-counters keyword.device# show overlay-gateway 1 site mm2-site network-counters ------ The Network Counter Stats ------ InUcastPkts: 15 InUcastBytes: 2670 InMcastPkts: 0 InMcastBytes: 0 InBcastPkts: 0 InBcastBytes: 0 OutKnownUcastPkts: 7 OutKnownUcastBytes: 1246 OutBumPkts : 8 OutBumBytes : 1424 Bum Traffic consists Unknown Ucast, Mcast, Bcast Traffic - To display VLAN VNI mapping information
for a given range of VLANs for an overlay gateway, enter the
show overlay-gatewaycommand along with the name of the gateway, using the vlan and to keywords to specify the range of VLANs.device# show overlay-gateway v1 vlan 200 to 204 Overlay Gateway Name : v1 Type : layer2-extension Source IP Interface : loopback 1 (vrf: default-vrf, IP address: 10.10.10.1) Total Mapped Vlans : 5 Total Sites : 1 # VLAN-ID VN-ID VFI Access-Port Extended-Site Cross-Connect - ------- ----- --- ----------- ------------- -------------- 1 200 20200 200 1 1 DISABLED 2 201 20201 201 1 1 DISABLED 3 202 20202 202 1 1 DISABLED 4 203 20203 203 1 1 DISABLED 5 204 20204 204 1 1 DISABLED
- To display the counters for a VNI
associated with the VXLAN tunnel, enter the
show overlay-gatewaycommand followed by the name of the gateway, followed by the vnid keyword and value to specify a VNI and the counters keyword.device# show overlay-gateway 1 vnid 30000 counters ------ The VNI Counter Stats ------ InUcastPkts: 30 InUcastBytes: 4590 InMcastPkts: 0 InMcastBytes: 0 InBcastPkts: 0 InBcastBytes: 0 OutKnownUcastPkts: 38 OutKnownUcastBytes: 4590 OutBumPkts : 0 OutBumBytes : 0 Bum Traffic consists Unknown Ucast, Mcast, Bcast Traffic - To display the access counters for an
Ethernet port associated with the VLAN mapped in the VXLAN tunnel, enter the
show overlay-gatewaycommand with the gateway name, followed by the vnid keyword and value to specify a VNI, the port number in the form ethernet unit/slot/port, and the access-counters keyword.device# show overlay-gateway 1 vnid 30000 ethernet 2/1/17 access-counters ------ The Access Counter Stats ------ InUcastPkts: 15 InUcastBytes: 1920 InMcastPkts: 0 InMcastBytes: 0 InBcastPkts: 0 InBcastBytes: 0 OutKnownUcastPkts: 23 OutKnownUcastBytes: 1920 OutBumPkts : 0 OutBumBytes : 0 Bum Traffic consists Unknown Ucast, Mcast, Bcast Traffic - To display the access counters for a LAG
interface associated with the VLAN mapped in the VXLAN tunnel, enter the
show overlay-gatewaycommand with the gateway name, followed by the vnid keyword and value to specify a VNI, the lag keyword and ID, and the access-counters keyword.device# show overlay-gateway 1 vnid 30000 lag 2 access-counters ------ The Access Counter Stats ------ InUcastPkts: 15 InUcastBytes: 1920 InMcastPkts: 0 InMcastBytes: 0 InBcastPkts: 0 InBcastBytes: 0 OutKnownUcastPkts: 30 OutKnownUcastBytes: 3840 OutBumPkts : 0 OutBumBytes : 0 Bum Traffic consists Unknown Ucast, Mcast, Bcast Traffic