vport-show

This command is used to display information about virtual ports on a fabric. Virtual ports track switch information across nodes on the fabric.


 

Informational Note:  The output fields for hypervisor and VM information is not automatically populated. In future releases, this information is gathered using a multicast communication across the fabric.

Syntax   vport-show

owner node name 

Displays the owner name.

mac mac-address

Displays the MAC address of the vPort.

vnet vnet-name

Displays the VNET name.

Specify up to two of the following options:

vlan vlan-id

Displays a VLAN from 0 to 4095.

public-vlan vlan-id

Displays the ID of the public VLAN.

vxlan vxlan-id

Displays a VXLAN from 0 to 16777215.

ip ip-address

DisplaysDisplays an IP address.

num-ips num-ips-number

Displays the number of IP addresses for the vPort.

Displays any of the following options:

config-intf config-intf-number

Displays the configuration interface number.

ports port-list

Displays the list of ports.

state active|static|vrrp|tunnel|software|needs-peer-status|port-mac|hit|ageout-check|moving|loop-probe|local-tunnel|igmp-mac|user-flush|vxlan-loopback|router|update-peer-only|active-state-mismatch|peer-port-missing|peer-port-not-vlag|peer-port-not-orphaned|peer-port-not-cluster-link|
sw-active|anycast|hsrp|
invalid-vlan|owner-lost

Displays the vPort state.

svc-name svc-name-string

Displays the name of the vCenter connection service.

hostname hostname-string

Displays the hypervisor or switch host name.

entity entity-string

Displays the VM or KVM device name.

power none|powered-off|powered-on|
standby|suspended|unknown

Displays the vPort entry status.

cpus cpus-number

Displays the number of CPUs assigned to the VM.

os os-string

Displays an operating system, such as CentOS or Ubuntu, on the VM.

portgroup portgroup-string

Displays the port group name associated with the VM MAC address.

pg-vlans vlan-list

Displays the VLANs assigned to a port group.

vswitch vswitch-string

Displays the name of the virtual switch associated with a NIC.

vs-type none|host-vs|distributed-vs|
unknown

Displays the type of virtual switch.

vnic-type untagged|tagged|trunked|vm-mgmt|vm-kernel|vMotion|vSAN|FTL|    rep|p-NFC|r-NFC|mgmt|unknown

Displays the type of vNIC associated with the VM or VM-Kernel.

config none|owner|ip|port|hostname|entity|cpus|os

Displays the configuration type for the virtual switch.

rem-switch node name

Displays the name of the remote switch.

rem-intf rem-intf-number

Displays the remote interface number.

rem-ports port-list

Displays the remote switch ports.

peer-intf peer-intf-number

Displays the peer interface number.

peer-state active|static|vrrp|tunnel|software|needs-peer-status|port-mac|hit|ageout-check|moving|loop-probe|local-tunnel|igmp-mac|user-flush|vxlan-loopback|router|update-peer-only|active-state-mismatch|peerport-missing|peer-port-not-vlag|peer-port-not orphaned|peer-port-not-cluster-links|sw-active|anycast|
hsrp||invalid-vlan|
owner-lost

Displays the state of the peer vPorts.

peer-owner-state active|static|vrrp|tunnel|software|needs-peer-status|port-mac|hit|ageout-check|moving|loop-probe|local-tunnel|igmp-mac|user-flush|vxlan-loopback|router|update-peer-only|active-state-mismatch|peerport-missing|peer-port-not-vlag|peer-port-not orphaned|peer-port-not-cluster-links|sw-active|anycast|
hsrp|invalid-vlan|owner-lost

Displays the state of the peer owner vPorts.

status phy-up|up|disabled|hw-nat-loop|mirror-loop|mirror-to|inuse|   PN-switch|PN-fabric|PN-other|PN-cluster|PN-internal|PN-hypervisor|PN-guest|snmp-host|host|uplink|drop-pkts|no-pktin|no-fwd|no-flood|STP-BPDUs|LLDP|trunk|l3-port|remote-l3-port|vdp|dhcp|dhcpsvr|blocked|no-BPDU|LACP-PDUs|vlag-active|vlag-blocked|
stp-edge-port|LACP-wait|
LACP-fallback|adjacency-wait|
adjacency-check|vlag-wait|multicast-router|host-disabled|loop|vxlan-loopback|vlan-up|vle|vle-wait|phy-down|down|enabled|err-bpdu-guard|mac-violation|stp-bpdu-guard|stp-root-guard

Displays the vPort status.

tunnel tunnel-string

Displays the vPort tunnel.

create-time date/time: yyyy-mm-ddTHH:mm:ss

Displays the vPort create time.

last-seen date/time: yyyy-mm-ddTHH:mm:ss

Displays the last time the vPorts was seen.

vxlan-lru date/time: yyyy-mm-ddTHH:mm:ss

Displays the time and date of the VXLAN LRU.

hit hit-number

Displays the number of hits.

migrate migrate-number

Displays the number of times the entry migrated.

drops drops-number

Displays the number of dropped packets.

hw-index hw-index-number

Displays the hardware index number.

rt-if rt-if-string

Displays the router interface.

hw-flags invalid-vlan|invalid-port

Displays hardware flags.

Displays

Syntax   

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 2.2

Command introduced.

Version 2.2.6

The parameters, stp-edge-port|LACP-wait| adjacency-wait|adjacency-check|vlag-wait|multicast-router, added.

Version 2.3

The parameters, num-ips and vm-status, added.

Version 2.4.1

The parameter, public-vlan, added.

Version 2.6.2

The parameter, svc-name, power, entity, portgroup, pg-vlans, vswitch, vs-type, and vnic-type, added.

The parameters, hypervisor, vm-id, vm-name, vm-flavor, vm-status, memory, deprecated.

Version 3.0.0

The options, anycast, invalid-vlan, and owner-lost, added to state, peer-state, and peer-owner-state.

Usage   Use this command to display vPort information on the switch. vPorts are mirrored across the fabric so that every switch knows about all the L2 entries on the fabric. This is useful for troubleshooting connections across the fabric.

Examples  To display vPorts, use the following syntax:

CLI network-admin@switch > vport-show format all layout vertical

mac:          66:0e:94:21:64:74

vlan:         103

config-intf:  70

config:       port

switch-id:    pleiades24

mac:          00:00:5e:00:01:0a

vlan:         107

config:       switch

rem-switch:   pleiades25

switch-id:    pleiades25

mac:          66:0e:94:21:a9:6c

vlan:         100

ip:           192.168.11.4

intf:         65

ports:        65

state:        active

hostname:     pleiades25

status:       PN-internal

create-time:  09-10,15:17:47

last-seen:    09-15,10:55:22

hit:          2

migrate:      1

switch-id:    pleiades24

mac:          66:0e:94:21:64:74

vlan:         100

ip:           192.168.100.12

intf:         65

ports:        65

hostname:     pleiades24

status:       PN-internal

create-time:  09-10,15:17:48

last-seen:    09-10,15:17:48

hit:          1

switch-id:    pleiades24