L Commands

l2-check-fix

It is possible for Layer 2 entries to go out of sync between what is present in the hardware and in software. This command checks the status of Layer 2 entries, logs the errors, and fixes them when possible.

Syntax   l2-check-fix

mac mac-address

Specifies the virtual router ID from 0 to 15.

vnet vnet-name

Specifies the IP address of the entry.

l2-net l2-net name

Specifies the Layer 2 network.

vlan vlan-id

Specifies the VLAN ID.

public-vlan vlan-id

Specify the public VLAN assigned to the vPort.

vxlan vxlan-id

Specify if you want to check and fix out of synch VXLANs IDs of vPorts.

sw-port port-number

Specify the software port.

sw-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|hsrp|invalid-vlan|owner-lost|cluster-link-down|vxlan-router

Specify the software state to check.

hw-port port-number

Specify the port number of the hardware.

hw-stateactive|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|hsrp|invalid-vlan|owner-lost|cluster-link-down| xlan-router

Specify the hardware state to check and fix.

fix-action

none|add-to-hardware|removefrom-hardware|fix-port-in-hardware|fix-tunnel-in-hardware|FAILED-add-to-hardware|FAILED-remove-from-hardware|FAILED-fix-port-in-hardware|FAILED-fix-tunnel-in-hardware|delete-port-mac|mark-port-mac

Specifies the action used to fix the entry.

Defaults   None

Access   CLI

History   

Version 2.4

Command introduced.

Version 2.4.1

The option, igmp-mac, user-flush, vxlan-loopback,router added to parameters sw-state and hw-state. The options, delete-port-mac and mark-port-mac added to the parameter fix-action. The parameter, public-vlan, also added.

Version 2.6.2

Additional parameters added to sw-state and hw-state.

Version 3.0.0

The parameter, l2-net, added.

Version 5.1.1

The options, invalid-vlan|owner-lost|cluster-link-down|vxlan-router, added to the parameters, sw-state, and hw-state.

Usage   Use this command to verify and fix Layer 2 entries that are out of sync in the Layer 2 table.

Examples  Use the following syntax to fix out of sync Layer 2 table entries.

CLI network-admin@switch > l2-check-fix vlan 25

l2-check-show

It is possible for Layer 2 entries to go out of sync between what is present in the hardware and in software. This command displays the status of Layer 2 entries.

Syntax   l2-check-show

mac mac-address

Displays if you want to check and fix out of synch MAC addresses of vPorts.

vnet vnet-name

Specify the name of the VNET.

vlan vlan-id

Displays if you want to check and fix out of synch VLANs addresses of vPorts.

l2-net l2-net name

Specifies the Layer 2 network.

public-vlan vlan-id

Specify the public VLAN assigned to the vPort

vxlan vxlan-id

Displays if you want to check and fix out of synch VXLANs addresses of vPorts.

sw-port port-number

Displays the port number of the software.

sw-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|hsrp|invalid-vlan|owner-lost|cluster-link-down|vxlan-router

Displays the software state to check.

hw-port port-number

Displays the port number of the hardware.

hw-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|hsrp|invalid-vlan|owner-lost|cluster-link-down|vxlan-router

Displays the hardware state to check and fix.

tunnel-name tunnel-name-string

Displays the tunnel name.

fix-action none|add-to-hardware|remove-from-hardware|fix-port-in-hardware|fix-tunnel-in-hardware|FAILED-add-to-hardware|FAILED-remove-from-hardware|
FAILED-fix-port-in-hardware|FAILED-fix-tunnel-in-hardware

Displays the type of fix action.

Defaults   None.

Access   CLI

History   

Version 2.4

Command introduced.

Version 2.4.1

The option, igmp-mac, user-flush, vxlan-loopback,
router added to parameters sw-state and hw-state. The options, delete-port-mac and mark-port-mac added to the parameter fix-action. The parameter, public-vlan, added.

Version 2.6.2

Additional parameters added to sw-state and hw-state.

Version 3.0.0

The parameter, l2-net, added.

Version 5.1.1

The options, invalid-vlan|owner-lost|cluster-link-down|vxlan-router, added to the parameters, sw-state, and hw-state.

Usage   Use this command to display Layer 2 table entries.

Examples  To display the Layer 2 entries and states, use the following command:

CLI network-admin@switch > l2-check-show vlan 25

l2-history-show

This command displays historical information about Layer 2 entries on the switch.

Syntax   l2-history-show

time date/time: yyyy-mm-ddThh:mm:ss

Specifies a point in time for displaying historical information.

start-time date/time: yyyy-mm-ddThh:mm:ss

Specifies the start time for Layer 2 history collection.

end-time date/time: yyyy-mm-ddThh:mm:ss

Specifies the end time for Layer 2 history collection.

duration duration: #d#h#m#s

Specifies the duration to collect the Layer 2 history.

interval duration: #d#h#m#s

Specifies the intervals that data is collected Layer 2 history.

since-start

Specifies to display all of the Layer 2 history since collection began on the fabric.

older than duration: yyyy-mm-ddThh:mm:ss

Specifies a point in tjme for displaying historical information.

within-last duration: yyyy-mm-ddThh:mm:ss

Specifies the start time for Layer 2 history collection.

log-type l2-save|l3-save|restart
|l2-modify|l2-delete|l3-modify|l3-delete

Filter output by the log type of each entry. The log-type column displays when a vPort is created, modified, saved, or deleted.

caller init|config|status|switch-cb|
cluster|gre|ARP|router|flow-cb|    vdp|vlag|port|inject|evict|vxlan|stats|vnm-vnic|adjacency|stp| trunk|intsw|ttl1|flood|flush|
retire|loop|dhcp|fabric|table| l3-age-out|vlan|l2-checker|igmp|
l2-age-out|port-mirror|    mac-move|cluster-status|cluster-status-delete|vxlan-routing|subnet|ND

Specifies the feature making the change for this entry.

last-caller init|config|status|switch-cb|cluster|gre|ARP|router| flow-cb|vdp|
vlag|port|inject|evict|vxlan|stats|vnm-vnic| adjacency|stp|trunk|intsw|
ttl1|flood|flush|retire|loop|dhcp|fabric|table|l3-age-out|vlan|l2-checker|igmp|l2-age-out|port-mirror|mac-move|cluster-status|cluster-status-delete|vxlan-routing|subnet|ND

Specifies the most recent caller for this entry.

reason activate|deactivate|port-move|ip-move|ip-remove|batch-move|retire|
break-loop|break-loop-timeout|create|modify|delete|policy|owner-status|
remove-node|port-flags|check-owner| trunk-port-add|trunk-port-remove|
move-router-if|age-out|hw-remove|
restart|undo|flush|update-vxlan-vlan|needs-peer-status|owner-lost|
owner-change|update-peer-only|   user-delete|done|vm-metadata|ND

Specifies the reason for history entry.

last-reason activate|deactivate|
port-move|ip-move|ip-remove| batch-move|retire|break-loop|
break-loop-timeout|create|modify| delete|policy|owner-status|
remove-node|port-flags|check-owner|trunk-port-add|trunk-port-remove|move-router-if|age-out| hw-remove|restart|
undo|flush|update-vxlan-vlan|needs-peer-status|owner-lost|owner-change|update-peer-only|   user-delete|done|vm-metadata|ND

Specifies the most recent reason for this entry.

changes owner|mac|ip|num-ips|config-intf|intf|ports|state|local-intf|local-ports|local-state|hostname|hypervisor|vm-id|vm-name|vm-flavor|vm-status
|memory|cpus|disk|os|config|
blocked-port|rem-switch|rem-intf|
rem-ports|peer-intf|peer-state|status|tunnel|create-time|last-seen|
vxlan-lru|hit|migrate|drops|hw-index|rt-if|hw-flags|ND

Specifies what changed in this entry.

count count-number

Filter output by the number of entries summed using the sum-by argument.

owner node name

 

mac mac-address

Filter output by the Filter output by MAC address.

vnet vnet-name 

Filter output by VNET name.

l2-net l2-net name

Specifies the Layer 2 network.

vlan vlan-id 

Filter output by the VLAN ID.

public-vlan vlan-id

Filter output by public VLAN.

vxlan vxlan-id

Filter output by the VXLAN ID.

ip ip-address 

Filter output by the IP address.

num-ips num-ips-number

Specify the number of IP addresses for the Layer 2 entry.

config-intf config-intf-number

Filter output by the configured interface of the Layer 2 entry.

intf intf-number

Filter output by the interface number. This is the port or trunk number of the Layer 2 entry.

ports port-list

Filter output by 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|pdate-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|cluster-link-down|                   vxlan-router

Filter output by the state of the Layer 2 entry.

svc-name svc-name-string

Filter output by service name.

hostname hostname-string

Filter output by the host name.

entity entity-string

Filter output by the VM or VM Kernel device name.

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

Filter by the vPort power status.

portgroup portgroup-string

Filter by the port group.

pg-vlans vlan-list

Filter by port group VLANs.

vswitch vswitch-string

Filter output by vSwitch name associated with VM MAC address.

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

Filter output by vSwitch type.

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

Filter output by VNIC type.

memory memory-number

Filter output by the amount of memory assigned to the VM.

cpus cpus-number

Filter output by the number of CPUs assigned to the VM.

disk disk-number

Filter output by the disk number where the VM is installed.

os os-string

Filter output by the OS installed on the VM.

config none|owner|ip|port|hostname|
hypervisor|vm-id|vm-name| vm-flavor|
memory|cpus|disk|os

Filter output by the configuration of the VM.

rem-switch node name

Filter output by the remote switch name.

rem-intf rem-intf-number 

Filter output by the remote interface number.

rem-ports port-list

Filter output by the remote ports.

peer-intf peer-intf-number 

Filter output by vPort peer interface.

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|peer-port-missing|peer-port-not-vlag|peer-port-not-orphaned|peer-port-not-cluster-link|sw-active|anycast|hsrp|invalid-vlan|owner-lost|cluster-link-down|                vxlan-router

Filter by the vPort peer state.

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|peer-port-missing|peer-port-not-vlag|peer-port-not-orphaned|peer-port-not-cluster-link|sw-active|anycast|hsrp|invalid-vlan|owner-lost|cluster-link-down|                vxlan-router

Filter by the vPort peer owner state.

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|congested|vxlan-loopback|vlan-up|vm-kernel|vm|pnic|vle-wait|phy-down|down|enabled|err-disabled|err-bpdu-guard|mac-violation| stp-bpdu-guard|stp-root-guard

Filter output by the status of the Layer 2 entry.

vtep-ip ip-address

Specifies the IP address of the remote VTEP.

tunnel tunnel-string

Filter output by the tunnel name.

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

Filter output by the time that the vPort was created.

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

Filter output by the time that the vPort was last seen on the fabric.

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

Filter output by the number of received hits.

hit hit-number

Filter output by the number of times that the vPort migrated on the fabric.

migrate migrate-number

Filter output by the number of drops on the fabric.

drops drops-number

Filter output by the time that the vPort was created.

hw-index hw-index-number

Filter output by the hardware index number.

rt-if rt-if-string

Filter by the router interface.

hw-flags invalid-vlan|invalid-port

Filter by hardware flags.

mc-index mc-index-number

Specifies the multicast group index in hardware.

Defaults   None

Access   CLI

History   

Version 2.3.2

Command introduced.

Version 2.4

The parameters, peer-, hw-index, and rf-if added.

Version 2.6.2

New parameters added. Some parameters removed, vm-id, hypervisor, vm-name, vm-flavor, and vm-status.

Version 3.1.0

The parameters, ND and vtep-ip, added.

Usage   Use this command to display history of Layer 2 entries.

Examples  To display Layer 2 information, use the following command:

CLI network-admin@switch > l2-history-show

time:                       09:02:33

log-type:                   l2-modify

caller:                     router

reason:                     activate,create

owner:                      pleaides24

mac:                        66:0e:94:f4:ec:6e

vlan:                       1

ip:                         192.168.16.24

ports:                      65

state:                      active,static

hostname:                   pleiades-tib

status:                     host

l2-net-port-add (deprecated)

l2-net-port-remove (deprecated)

l2-net-port-show (deprecated)

l2-setting-modify

This command modifies the Layer 2 settings in the configuration.

Syntax   l2-setting-modify

aging-time seconds

Configures the aging time in Layer 2. You can configure a value from 1 to 2000000. The default value is 300 seconds.

software-aging|
no-software-aging

Specify if you want to enable software aging or not. This is ON by default. This parameter controls how the aging of the L2 table entries is performed by Netvisor. When OFF, the aging is performed by the Ethernet switch ASIC. It is not recommended to change this setting.

l2-max-count l2-max-count-number

Specify the maximum count for Layer 2 entries.

l2-checker|no-l2-checker

Specify if you want to enable Layer 2 checker.

l2-checker-interval duration: #d#h#m#

Specify the interval between Layer 2 checks.

l3-arp-max-count l3-arp-max-count-number

Specify the number of maximum ARPs for Layer 3 entries.

Defaults   None.

Access   CLI

History   

Version 1.2

Command introduced.

Version 2.4

The parameters, software-aging, l2-checker and l2-checker-interval added.

Version 5.1.1

The parameter, l2-max-count, added.

Usage   Use this command to modify the Layer 2 aging time in seconds.

Examples  To modify the aging time to 360 seconds, use the following command:

CLI network-admin@switch > l2-setting-modify aging-time 360

l2-setting-show

This commands displays the Layer 2 settings in the configuration.

Syntax   l2-setting-show

Defaults   None.

Access   CLI

History   Command introduced in nvOS Version 1.2.1.

Usage   Use this command to display information about Layer 2 settings.

Examples  To display the Layer 2 settings, use the following command:

CLI network-admin@switch > l2-setting-show

switch:           Pleiades24

aging-time(s):    300

l2-max-count:     1300000

l2-cur-count:     36

l2-active-count:  13

l2-max-mem:       1.81G

l2-cur-mem:       32.6K

l3-arp-max-count: 1300000

l3-arp-cur-count: 7

l3-arp-max-mem:   624M

l3-arp-cur-mem:   2.13K

switch:           Pleiades25

aging-time(s):    300

l2-max-count:     1300000

l2-cur-count:     36

l2-active-count:  14

l2-max-mem:       1.81G

l2-cur-mem:       32.6K

l3-arp-max-count: 1300000

l3-arp-cur-count: 7

l3-arp-max-mem:   624M

l3-arp-cur-mem:   2.13K

l2-static-multicast-group-create

This command is used to create a Layer 2 static multicast group. Hosts join multicast groups either by sending an unsolicited IGMP join message or by sending an IGMP join message in response to a general query from a multicast router (the switch forwards general queries from multicast routers to all ports in a VLAN). When you specify group membership for a multicast group address statically, the static setting supersedes any IGMP snooping learning. Multicast group membership lists can consist of both static and IGMP snooping-learned settings.

Syntax   l2-static-multicast-group-create

group-mac mac-address

Specify a MAC address for the multicast group.

vlan vlan-id 

Specify a VLAN ID for the multicast group.

ports port-list

Specify a list of ports for the multicast group.

Defaults   None

Access   network-admin

History  Command introduced in Version 2.3.

Usage   Use this command to create a Layer 2 static multicast group.

Examples  To create a L2 static multicast group on MAC address, 0050.3e8d.6400, VLAN 25, and ports 10-12, use the following syntax:

CLI network-admin@switch > l2-static-multicast-group-create group-mac 0050.3e8d.6400 vlan 25 ports 10-12

l2-static-multicast-group-delete

This command is used to delete a Layer 2 static multicast group. Hosts join multicast groups either by sending an unsolicited IGMP join message or by sending an IGMP join message in response to a general query from a multicast router (the switch forwards general queries from multicast routers to all ports in a VLAN). When you specify group membership for a multicast group address statically, the static setting supersedes any IGMP snooping learning. Multicast group membership lists can consist of both static and IGMP snooping-learned settings.

Syntax   l2-static-multicast-group-create group-mac mac-address vlan vlan-id 

group-mac mac-address

Specify a MAC address for the multicast group.

vnet vnet-name

Specifies the IP address of the entry.

l2-net l2-net name

Specifies the Layer 2 network.

vlan vlan-id 

Specify a VLAN ID for the multicast group.

Defaults   None

Access   network-admin

History   

Version 2.3

Command introduced.

Version 3.0.0

The parameters, vnet and l2-net, added.

Usage   Use this command to delete a Layer 2 static multicast group.

Examples  To delete a L2 static multicast group on MAC address, 0050.3e8d.6400 and VLAN 25, use the following syntax:

CLI network-admin@switch > l2-static-multicast-group-delete group-mac 0050.3e8d.6400 vlan 25 ports 10-12

l2-static-multicast-group-show

This command is used to display information about a Layer 2 static multicast group. Hosts join multicast groups either by sending an unsolicited IGMP join message or by sending an IGMP join message in response to a general query from a multicast router (the switch forwards general queries from multicast routers to all ports in a VLAN). When you specify group membership for a multicast group address statically, the static setting supersedes any IGMP snooping learning. Multicast group membership lists can consist of both static and IGMP snooping-learned settings.

Syntax   l2-static-multicast-group-show

group-mac mac-address

Specify a MAC address for the multicast group.

vnet

Specifies VNETs.

l2-net l2-net name

Specifies the Layer 2 network.

vlan vlan-id 

Specify a VLAN ID for the multicast group.

ports port-list

Specify a list of ports for the multicast group.

Defaults   None

Access   network-admin

History   

Version 2.3

Command introduced.

Version 3.0.0

The parameters, vnet and l2-net, added.

Usage   Use this command to display a Layer 2 static multicast group.

Examples  To display a L2 static multicast group on MAC address, 0050.3e8d.6400, VLAN 25, and ports 10-12, use the following syntax:

CLI network-admin@switch > l2-static-multicast-group-show group-mac 0050.3e8d.6400 vlan 25 ports 10-12

l2-table-flush

This command is used to clear information about the Layer 2 settings.

Syntax   l2-table-flush [vlan vlan-id] [port port-list]

Specify either zero or both options:

mac mac-address

Specifies the MAC address.

vlan vlan-id

Specifies the VLAN identifier.

ports port-list

Specifies the port list.

Defaults   None

Access   CLI

History   Command introduced in nvOS Version 1.2.1.

Usage   Used to flush the Layer 2 information.

Examples  To flush the Layer 2 table information from VLAN 25, use the following command:

CLI network-admin@switch > l2-table-flush vlan 25

l2-table-show

To display Layer 2 flows in the forwarding table of the switch datapath, use this command.

Syntax   l2-table-show

owner node name

Specifies the node name for the L2 table.

mac mac-address

Specifies the source MAC address for the flow.

ip ip-address

Specifies the source IP address for the flow.

vnet vnet-name

Specifies the VNET name.

l2-net l2-net name

Specifies the Layer 2 network.

vlan vlan-id

Specifies the VLAN identifier for the flow.

public-vlan vlan-id

Specifies the public VLAN.

vxlan vxlan-id

Specifies the ID for the VXLAN.

ip ip-address

Specifies the IP address.

num-ips num-ips-number

Specifies the number of IP addresses.

config-intf config-intf-number

Specifies a configured interface number.

intf intf-number

Specifies the interface number.

ports port-list

Specifies the source port number for the flow.

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|hsrp|nvalid-vlan|owner-lost|cluster-link-down|vxlan-router

Specifies the state of the vPort.

svc-name svc-name-string

Specifies the service name.

hostname hostname-string

Specifies a hostname.

entity entity-string

Specifies theVM or VM Kernel device name.

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

Specifies the power status.

cpus cpus-number

Specifies the number of CPUs assigned to the VM.

disk disk-number

Specifies the number of disks assigned to the VM.

os os-string

Specifies the name of the operating system (OS) running on the VM.

portgroup portgroup-string

Specifies the port group associated with the VM MAC Address.

pg-vlans vlan-list

Specifies the VLANs associated with the port group.

vswitch vswitch-string

Specifies the vSwitch associated with the NIC.

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

Specifies the vSwitch type.

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

Specifies the vNIC type.

config none|switch|ip|port|
hostname|hypervisor|
vm-id|vm-name|vm-flavor|memory|cpus|disk|os

Displays the configuration on the host.

rem-switch node-name]

Specifies a remote switch.

rem-intf rem-intf-number

Specifies a remote switch interface.

rem-ports port-list

Specifies a remote switch port list.

peer-intf peer-intf-number 

Filter output by vPort peer interface.

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

Filter by the vPort peer state.

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

Filter by the vPort peer owner state.

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| congested|vxlan-loopback|vlan-up|vle|vle-wait|phy-down|down|    enabled|err-disabled|err-bpdu-guard|mac-violation| stp-bpdu-guard|stp-root-guard||defer-bringup-wait

Specifies the status of the entry.

vtep-ip ip-address

Specifies the IP address of the remote VTEP.

tunnel tunnel-string

Specifies a tunnel name if configured.

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

Specifies the date and time that the flow was inserted into the Layer 2 table.

last-time date/time: yyyy-mm-ddThh:mm:ss

Specifies the most recent date and time that a packet matched the flow.

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

Specifies the last received update time for a VXLAN.

hit number-of-hits

Specifies the number of packets that matched the flow.

migrate number-of-migrates

Specifies the number of different ports that received packets matching the flow.

drops number-of-drops

Specifies the number of packets matching the flow that were dropped.

hw-index hw-index-number

Specifies the hardware index number.

rt-if rt-if-string

Specifies the router interface.

hw-flags invalid-vlan|invalid-port

Specifies any vPort hardware flags.

mc-index mc-index-number 

Specifies the Layer 2 multicast group index in hardware.

Defaults   None

Access   CLI

History   

Version 1.2

Command introduced.

Version 2.1

The parameter, state, added.

Version 2.2

The parameters, switch-id, hostname, hypervisor, vm-id, vm-name, vm-flavor, memory, disk, os, and config added. The options, phy-up, up, disabled, hw-nat-loop, mirror-loop, mirror-to, linuse, 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, vdp, dhcp, dhcpsvr, blocked, no-BPDU, LACP-PDUs, vlag-active, vlag-blocked, stp-edge-p added to the parameter state. The options, active, retired, pending, recorded, aged-out-port-down, static, and software deprecated. The parameters, resolved-arp, and rt-if deprecated.

Version 2.2.4

The parameters, config-intf, rem-switch, rem-intf, and rem-ports, added.

Version 2.2.5

The parameters, vlag-active, vlag-blocked, stp-edge-port, deprecated. The parameters, l3-port and remote-l3-port, added.

Version 2.3

The parameters, vlag-active, vlag-blocked, stp-edge-port, added. The parameters vm-status, tunnel, and vxlan-lru added.

Version 2.4

The parameters, peer-, hw-index, and rf-if added.

Version 2.6.2

The parameters, ip, num-ip, svc-name, entity, power, portgroup, pg-vlans, vswitch, vs-type, vnic-type, and hw-flags added. The parameters, hypervisor, vm-id, vm-name, vm-flavor, vm-status, memory, and blocked-port, deprecated.

Version 3.1.0

The parameters, ND and vtep-ip, added.

Usage   Each switch has automatic safeguards to avoid forwarding loops in Layer 2 multipathing. This feature operates independently of Spanning Tree Protocol (STP) if STP is enabled. This command lists the Layer 2 flows in the forwarding table of the switch datapath. If there are ports in the blocked state may indicate the presence of loops in Layer 2 multipathing.

Examples  To display the Layer 2 table, use the following command:

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

switch:       pubdev02

mac:          02:08:20:38:00:c6

vlan:         4094

hostname:     pubdev02

create-time:  04-22,08:17:16

last-seen:    04-22,08:17:16

hit:          1

switch:       pubdev01

mac:          02:08:20:72:2d:ff

vlan:         4094

intf:         128

ports:        26,47-48

state:        active,static

hostname:     pubdev02

status:       PN-internal

last-seen:    05-19,15:10:12

switch:       pubdev02

mac:          02:08:20:72:2d:ff

vlan:         4094

intf:         65

ports:        65

state:        active

hostname:     pubdev02

status:       PN-internal

create-time:  04-22,08:53:08

last-seen:    05-19,15:03:08

hit:          1

switch:       pubdev03

mac:          02:08:20:72:2d:ff

vlan:         4094

intf:         128

ports:        45-48

state:        active,static

hostname:     pubdev02

status:       PN-internal

last-seen:    05-19,14:32:30

switch:       pubdev02

mac:          06:a0:00:03:00:1a

vlan:         1

intf:         26

ports:        26

state:        active

hostname:     pubdev01

status:       PN-switch,PN-fabric,PN-cluster

create-time:  04-22,08:42:19

last-seen:    11:17:47

hit:          4045

switch:       pubdev03

mac:          06:a0:00:03:00:2d

vlan:         1

intf:         45

ports:        45

state:        active

hostname:     pubdev01

status:       PN-switch,PN-fabric

create-time:  04-22,07:49:03

last-seen:    05-19,15:10:29

hit:          2

migrate:      10