printPrint Page

feedbackDocument Feedback

supportSupport & Services

businessPluribus Networks

LinkedIn

facebookFacebook

Twitter

l3-check-fix

Layer 3 entries can become unsynchronized between the software table and the hardware table. When routes are modified while the routes are updating on the network, this can occur. Use this command to fix any unsynchronized Layer 3 table entries.

Syntax   l3-check-fix

vrid ID

Specifies the virtual router ID from 0 to 15.

ip ip-address

Specifies the IP address of the entry.

prelen length

Specifies the prefix length from 0 to 128.

vlan vlan-id

Specifies the VLAN ID.

mac mac-address

Specifies the MAC address.

fix-action none|add-host-to-hardware|remove-host-from-hardware| re-add-host-to-hardware|add-route-to-hardware|remove-route-from-hardware|re-add-route-to-hardware| none-hardware-only-route|none-cached-route| FAILED-add-host-to-hardware|FAILED-remove-host-from-hardware|FAILED-add-route-to-hardware|FAILED-remove-route-from-hardware

Specifies the action used to fix the entry.

Defaults   None

Access   CLI

History   Command introduced in Version 2.5.

Usage   Use this command to fix Layer 3 entries that are out of synch in the Layer 3 table.

Examples  Use the following syntax to fix out of synch Layer 3 table entries.

CLI network-admin@switch > l3-check-fix

l3-check-show

Layer 3 entries can become unsynchronized between the software table and the hardware table. This is useful when routes are modified while the routes are updating on the network. Use this command to fix any unsynchronized Layer 3 table entries.

Syntax   l3-check-show

vrid ID

Specifies the virtual router ID from 0 to 15.

ip ip-address

Specifies the IP address of the entry.

prelen length

Specifies the prefix length from 0 to 128.

vlan vlan-id

Specifies the VLAN ID.

mac mac-address

Specifies the MAC address.

fix-action none|add-host-to-hardware|remove-host-from-hardware| re-add-host-to-hardware|add-route-to-hardware|remove-route-from-hardware|re-add-route-to-hardware| none-hardware-only-route|none-cached-route| FAILED-add-host-to-hardware|FAILED-remove-host-from-hardware|FAILED-add-route-to-hardware|FAILED-remove-route-from-hardware

Specifies the action used to fix the entry.

Defaults   None

Access   CLI

History   Command introduced in Version 2.5.

Usage   Use this command to displays Layer 3 entries that are out of synch in the Layer 3 table.

Examples  Use the following syntax to display out of synch Layer 3 table entries.

CLI network-admin@switch > l3-check-show

Spine-1:    

Matched                     : 56

Fib host routes             : 14

Matched host routes         : 14

Fib only static routes      : 7

Rib local subnet routes     : 7

Fib local subnet routes     : 7

Spine-1: OK: 56

l3-history-show

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

Syntax   l3-history-show

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

Specifies a point in tjme for displaying historical information.

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

Specifies the start time for Layer 3 history collection.

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

Specifies the end time for Layer 3 history collection.

duration duration: #d#h#m#s

Specifies the duration to collect the Layer 3 history.

interval duration: #d#h#m#s

Specifies the intervals that data is collected Layer 3 history.

since-start

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

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

Specifies a point in tjme for displaying historical information.

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

Specifies the start time for Layer 3 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 Layer 3 entry 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

Specifies the feature that made 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

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

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

Specifies the most recent reason for this entry.

changes owner|mac|vnet|public-vlan|ip|num-ips|config-intf|intf|ports|    state|local-intf|local-ports|local-state|alt-owner| alt-owner-port|alt-owner-ports|alt-owner-state|svc-name| hostname|entity|power|cpus|os|portgroup|pg-vlans|vswitch| vs-type|vnic-type|config|rem-switch|rem-intf|rem-ports| peer-intf|peer-state|peer-owner-state|status|tunnel|create-time|last-seen|vxlan-lru|hit|migrate|drops|hw-index|rt-if|
hw-flags

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

Filter output by the owner.

mac mac-address

Filter output by MAC address.

vnet vnet-name

Filter output by the VNET name.

l2-net l2-net-name

Filter output by the Layer 2 network name.

vlan vlan-id 

Filter output by the VLAN ID.

public-vlan vlan-id

Filter output by the public VLAN ID.

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 3 entry.

config-intf config-intf-number

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

intf intf-number

Filter output by the interface number. This is the port or trunk number of the Layer 3 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|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

Filter output by the state of the Layer 3 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.

blocked-port port-list

Filter output by a list of ports to block for 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 the 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|pdate-peer-only|active-state-mismatch|peer-port-missing|peer-port-not-vlag| peer-port-not-orphaned|peer-port-not-cluster-link|sw-active| hsrp

Filter output 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|pdate-peer-only|active-state-mismatch|peer-port-missing|peer-port-not-vlag| peer-port-not-orphaned|peer-port-not-cluster-link|sw-active| hsrp

Filter output 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|vxlan-loopback|vlan-up|vle|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 3 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 Layer 3 entry was created.

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

Filter output by the time that the Layer 3 entry 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 Layer 3 entry 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 Layer 3 entry was created.

hw-index hw-index-number

Filter output by the hardware index number.

rt-if rt-if-string

Filter output by the router interface.

hw-flags invalid-vlan|invalid-port

Filter output by hardware flags.


Defaults   None

Access   CLI

History   

Version 2.3.2

Command introduced.

Version 2.4

The parameters, l2-checker|igmp|l2-age-out|port-mirror|mac-move added. The parameters, peer-, hw-index, and rt-if added.

Version 2.4.1

The parameters, vnet, public-vlan, and hw-flags added. The options, user-flush|vxlan-loopback|router, added to state, peer-state, and peer-owner-state. The option, cluster-status, added to caller and last-caller. The options, update-vxlan-vlan| needs-peer-status|owner-lost|owner-change added to reason and last-reason.

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 parameter, vtep-ip, added.

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

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

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

time:                       09:02:33

log-type:                   l3-modify

caller:                     ARP

reason:                     activate,create

owner:                      pleaides24

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

vlan:                       1

ip:                         192.168.16.24

state:                      active

l3-setting-modify

This command allows you to modify the Layer 3 settings.

Syntax   l3-setting-modify aging-time seconds

Specify one or more of the following options:

aging-time

Specifies the aging time between 0 to 2000000 seconds. Use 0 (zero) to disable aging time. The default aging time is 600 seconds.

convergence-time seconds

Specifies the unicast convergence time on bootup. This is a value from 0 to 3600 seconds.

l3-checker|
no-l3-checker

Enable or disable Layer 3 checking.

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

Specify the interval between Layer 3 checks.

l3-checker-fix|
no-l3-checker-fix

Specify if after checking Layer 3 entries to fix the incorrect entries.

Defaults   None

Access   CLI

Usage   Use this command to modify the Layer 3 setting.

Examples  To modify the Layer 3 aging-time setting, use the following command:

CLI network-admin@switch > l3-setting-modify aging-time 1000

CLI network-admin@switch > l3-setting-show format all

switch:        spine-1

aging-time(s): 1000

l3-setting-show

This command allows you to display the Layer 3 settings.

Syntax   l3-setting-show

Defaults   None

Access   CLI

Usage   Use this command to show the Layer 3 setting.

Examples  To display the Layer 3 setting, use the following command:

CLI network-admin@switch > l3-setting-show format all

switch:        spine-1

aging-time(s): 600

switch:        spine-2

aging-time(s): 600

From this output, you can see that the aging time is set to 600 seconds by default.

l3-table-show

This command allows you to display the Layer 3 table settings.

Syntax   l3-table-show

Specify one or more of the following options:

mac mac-address

Displays the MAC address.

ip ip-address

Displays the IP address.

vnet vnet-name

Displays the name of the VNET.

l2-net l2-net-name

Displays the name of the Layer 2 network.

vlan id5

Displays the VLAN ID.

public-vlan vlan-id

Specify the public VLAN assigned to the vPort

vxlan id

Displays the assigned VXLAN.

intf intf-number

Displays the interface.

rt-if rt-if-string

Displays the router interface.

hw-intf hw-intf-number

Displayss the interface programmed in hardware.

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

Displays the flags.

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|    hsrp

Displays the owner-state flags.

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|    hsrp

Displays the peer-state flags.

egress-id egress-id-number 

Displays the hardware egress ID.

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

Displays the time entry created.

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

Displays the last time seen on network.

hit hit-number

Displays the number of hits.

tunnel tunnel-string 

Displays the tunnel name.

Defaults   None

Access   CLI

History   

Version 2.4

Command introduced.

Version 2.4.1

The parameters, public-vlan, owner-state, peer-state and tunnel added. The options, user-flush|vxlan-loopback|router added to state, owner-state, and peer-state.

Version 2.6.2

The parameters, hw-intf and egress-id added. The options 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 added to state, owner-state, peer-state.

Version 3.0.0

The parameter, l2-net, added.

Usage   Use this command to show the Layer 3 table setting.

Examples  To display the Layer 3 table setting, use the following command:

CLI network-admin@switch > l3-table-show format all

switch:

spine1-1

mac:

c6:8f:66:55:fe:30

ip:

192.168.1.3

vlan:

1

vxlan:

0

intf:

128

rt-if:

 

state:

active

create-time:

10-06,15:58:02

last-seen:

09:06:44

hit:

1764

There is no routing interface (rt-if) value because there are no Layer 3 routes configured on the switch.