tunnel-show
This command is used to display the list of tunnels on the switch.
Syntax tunnel-show
id |
The ID assigned to the tunnel. |
scope local |
The scope for the tunnel. Only local scopes are supported. |
name name-string |
Name of the tunnel. |
type ip-in-ip|vxlan|nvgre |
The type of tunnel. |
vnet vnet-name |
The vNET name. |
vrouter-name vrouter-name |
Name of the vRouter service. |
peer-vrouter-name vrouter-name |
Name of the vRouter service on the cluster peer. |
local-ip ip-address |
The local IP address. |
remote-ip ip-address |
The remote IP address. |
router-if vrouter-hw-if-name |
The router interface. |
tunnel-if-name tunnel-if-name-string |
The router interface VNIC name. |
next-hop ip-address |
The next hop IP address. |
next-hop-mac mac-address |
The next hop MAC address. |
next_hop_vnet vlan-id |
The next hop VLAN ID. |
nexthop-bd bridge-domain |
The next hop bridge domain. |
nexthop-vlan 0..4095 |
The next hop VLAN. |
remote-switch fabric-node-name |
The remote switch for the tunnel. |
vrid vrid-number |
The vRouter hardware ID. |
tunnelID tunnelID-number |
The tunnel ID. |
interface-mac mac-address |
The MAC address of the tunnel interface. |
interface-vnet vnet name |
The vNET name. |
bd bridge-domain |
The bridge domain name. |
interface-vlan vlan-id |
The interface VLAN. |
active yes|no |
The status of the tunnel. |
state init|ok|error |
The state of the tunnel. |
bfd|no-bfd |
Displays if BFD is configured. |
bfd-state unknown|admin-down|down|init|up|no-session|not-replicator-vtep |
The state of the BFD session. |
peer-bfd-state unknown|admin-down|down|init|up|no-session|not-replicator-vtep |
The peer BFD session state. |
error error-string |
The tunnel errors. |
route-info route-info-string |
The route information. |
ecmp-group ecmp-group-number |
The ECMP group information. |
using-vxlan-loopback yes|no |
Displays using VXLAN loopback. |
ports port-list |
The port list. |
nh-egress-id nh-egress-id-number |
The nexthop port egress ID. |
flood-nh-ip ip-address |
Flood next hop IP address. |
flood-nh-vlan 0..4095 |
Flood next hop VLAN ID. |
flood-nh-port flood-nh-port-number |
Flood next hop port number. |
flood-nh-mac mac-address |
Flood next hop MAC address. |
flood-nh-egress-id flood-nh-egress-id-number |
Flood next hop hardware egress ID. |
auto-tunnel auto|static |
Displays if the tunnel is automatic or static. |
ecmp-nexthops|no-ecmp-nexthops |
Filter single or multiple route entries per nexthops. |
flood-nexthop|no-flood-nexthop |
Displays tunnels with either flood-nexthop or with no-flood-nexthop configured. |
mac-learning|no-mac-learning |
Displays tunnels with either MAC learning enabled or MAC learning disabled. |
Defaults None.
Access CLI
History
Version 1.2 |
Command introduced. |
Version 2.2.2 |
The parameter type added. |
Version 2.2.3 |
The parameter router-if replaced name-string with vrouter-hw-if name option. |
Version 2.3.1 |
The parameter active added. |
Version 2.4 |
The option, cluster added to scope. The parameters vrouter-name, and peer-vrouter-name, state, error, route-info, and ecmp-group added. |
Version 2.5 |
The parameter vnet added. |
Version 3.0.0 |
The parameter vrouter-if deprecated. The parameter bfd added. |
Version 6.0.0 |
The parameter mac-learning added. |
Usage Tunnels are used to encapsulate unsupported protocols on a network. Use this command to display a list of tunnels on a fabric.
Examples To display a list of all tunnels on a switch, use the following command:
CLI (network-admin@switch) > tunnel-show