l3-check-fix

Print Page		Document Feedback		Support & Services		Pluribus Networks		LinkedIn		Facebook		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.