tunnel-show

This command is used to display the list of tunnels on the switch.

Syntax   tunnel-show

Defaults    

id

Displays the ID assigned to the tunnel.

scope local

Displays the scope for the tunnel. Only local scopes are supported.

name name-string

Displays the name of the tunnel.

type ip-in-ip|vxlan|nvgre

Displays the type of tunnel.

vnet vnet-name

Displays the name of the VNET.

vrouter-name vrouter-name

Displays the name of the vRouter service.

peer-vrouter-name vrouter- name

Displays the name of the vRouter service on the cluster peer.

local-ip ip-address

Displays the local IP address.

remote-ip ip-address

Displays the remote IP address.

router-if
vrouter-hw-if name 

Displays the router interface.

tunnel-if-name tunnel-if-name-string

Displays the router interface VNIC name.

next-hop ip-address

Displays the next hop IP address.

next-hop mac-address

Displays the next hop MAC address.

next-hop-vlan vlan-id

Displays the next hop VLAN ID.

remote-switch fabric-node-name 

Displays the remote switch for the tunnel.

vrid vrid-number

Displays the vRouter hardware ID.

tunnelID tunnelID-number

Displays the tunnel ID.

interface-mac
mac-address

Displays the MAC address of the tunnel interface.

interface-vnet vnet name

Displays the VNET name.

bd bridge-domain name

Displays the bridge domain name.

interface-vlan vlan-id

Displays the interface VLAN.

active yes|no

Displays the status of the tunnel.

state init|ok|error

Displays 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

Displays the state of the BFD session.D

peer-bfd-state unknown|admin-down|down|init|up|no-session|                  not-replicator-vtep

Displays the peer BFD session state.

error error-string 

Displays tunnel errors.

route-info route-info-string

Displays route information.

ecmp-group ecmp-group-number

Displays ECMP group information.

using-vxlan-loopback yes|no

Displays using VXLAN loopback.

ports port-list

Displays the port list.

nh-egress-id
nh-egress-id-number

Displays the nexthop port 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.

Formatting Options

format fields-to-display

Display output using a specific parameter. Use all to display all possible output.

parsable-delim character

Display output formatted for machine parsing using a specified delimiter.

sort-asc

Display output in ascending order.

sort-desc

Display output in descending order.

show dups

Display duplicate entries in the output.

layout vertical|horizontal

Format the output in a vertical or horizontal layout.

show-interval seconds-interval

Repeat the show command at a specified interval.

show-headers|
no-show-headers

Display column headers or not.

limit-output number

Limit the display output to a specific number of entries.

count-output

Display the number of entries in the output. This is useful with vRouter show commands.

unscaled

Display full values in the output instead of scaled approximate values.

raw-int-values

Display integer values instead of mapped values

sum-by

Aggregate output by specific parameters. If sum-by fields are specified, records that have the same value in sum-by fields are combined and displayed as one aggregate record. NOTE: This option is only available for show commands that collect statistics such as connection-stats-show.

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.

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

See Also   

tunnel-create

tunnel-delete