show overlay-gateway

Displays information for all overlay gateways, a specific gateway, a VLAN, VXLAN Network Identifier (VNI), or remote site.
Syntax
show overlay-gateway [ gateway-name ]
show overlay-gateway gateway-name detail
show overlay-gateway gateway-name site site-name [ network-counters ]
show overlay-gateway gateway-name site all
show overlay-gateway gateway-name vlan vlan-id to vlan-id
show overlay-gateway gateway-name vnid vxlan-network-identifier [ counters | ethernet unit/slot/port access-counters | lag lag-id access-counters ]
Parameters
gateway-name
Specifies the VXLAN gateway name for which information is displayed.
detail
Displays more extensive information for the overlay gateway or gateways.
site site-name
Displays information for the remote site specified.
network-counters
Specifies network counters accosicated with the site.
all
Displays information for all sites (VXLAN tunnels) configured for the gateway.
vlan vlan-id
Displays information for the designated extended VLAN.
to vlan-id
Displays information for a specified range of VLANs.
vnid vxlan-network-identifier
Displays information for the designated VXLAN Network Identifier (VNI).
counters
Specifies Virtual Forwarding Instance (VFI) counters associated with this site.
ethernet unit/slot/port
Specifies an Ethernet interface.
access-counters
Specifies access counters associated with the site.
lag lag-id
Specifies a link aggregation group (LAG) interface.
Modes

User EXEC mode

The show overlay-gateway command set displays the following information:

Output field Description
Overlay Gateway Name Name configured for the overlay gateway
Type Type of gateway (Layer 2 extension)
Source IP interface Loopback interface number, VRF used, and local IPv4 address of the source VEP
Total Mapped Vlans Number of VLANs mapped to the VNI associated with the overlay gateway name
Total Sites Number of tunnels associated with the overlay gateway
Total Overlay Gateways Number of overlay gateways configured in the network
VLAN-ID VLAN number for a VLAN extended over the overlay gateway
VN-ID VXLAN Network Identifier associated with the VLAN
VFI Layer 2 VPN identifier in the hardware (should match the VLAN ID)
Access-Port Total number of local ports belonging to the mapped VLAN
Extended-Site Number of remote sites to which the mapped VLAN is extended
SiteName Name of the remote site
IP-Address IP address of the remote site
Status Status of the remote site (Up or Down)
Monitoring Failure-detection configuration (Enabled/Disabled)
Connection Status of connection to remote VXLAN site. The status is Alive if the remote end is responding to keep-alive messages. The status is N/A if Monitoring is disabled.
Ext-Vlans Mapped VLANs that are extended to the remote site
Examples

The following example shows sample output for the show overlay-gateway command. Only the overlay gateway sanjose is configured.

device# show overlay-gateway

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

Total 1 Overlay Gateways

The following example provides details on the overlay-gateway gt-1. The output includes a list of VLANS, their associated VNIs, VFIs, access ports, and VXLAN tunnels. The names of the remote sites are given, along with the remote IP address, its status, the failure-detection status (Monitoring disabled in this case), and the connected extended VLANs at the remote end.

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 following example displays information for overlay gateway sanjose VLAN 101 and VLAN 102.

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

device# show overlay-gateway sanjose vlan 102
Overlay Gateway Name    : sanjose
#    VLAN-ID    VN-ID    VFI     Access-Port Extended-Site
-    -------    -----    ---     ----------- -------------
1    102        67924    102     3           1

The following example displays information for two VNIs on the same overlay gateway.

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 following example displays information for remote site mm1-site, which is up. Monitoring is enabled, which means failure-detection is configured. The connection is alive, which means the remote VXLAN tunnel endpoint is responding to keep-alive messages.

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                    : Enabled
Connection                    : Alive
Extended Vlans                :
   100

Total 1 Extended Vlan

The following example displays information for the remote site sanjose, which is down because no source interface is configured.

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 following example shows information for the same remote site, which is down because there is no route to the destination.

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 following example shows information about an overlay gateway, including VLAN-to-VNI mapping information for a given 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

The following example displays information for all remote sites.

device# 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 following example displays the network counters for a site.

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

The following example displays the counters for a VNI associated with the VXLAN tunnel

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

The following example displays the access counters for an Ethernet port associated with the VLAN mapped in the VXLAN tunnel.

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

The following example displays the access counters for a LAG interface associated with the VLAN mapped in the VXLAN tunnel.

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
History
Release version Command history
08.0.70 The command was introduced.
09.0.10b The command output was modified so that information can be displayed for all sites and for a range of VLANs. Information can be displayed for network counters associated with a site. Information can be displayed for counters and access counters.
09.0.10d The following changes were introduced in the 09.0.10 release stream: The command output was modified so that information about VLAN-to-VNI mapping information for a given range of VLANs is displayed. The command output was modified so that information for all remote sites can also be displayed. The command output was modified to show the status of failure-detection on the VXLAN tunnel.
10.0.10 The following changes were introduced in the 10.0.10 release: The command output was modified so that information about VLAN-to-VNI mapping information for a given range of VLANs is displayed. The command output was modified so that information for all remote sites can also be displayed. The command output was modified to show the status of failure-detection on the VXLAN tunnel.