Fundamental Layer 3 Commands
This chapter describes the fundamental Layer 3 commands:
automatic-router-id-selection enable
Use this command to assure that OcNOS selects the loopback IP address as the router-id each time the device is rebooted.
Use the no form of this command to remove this constraint.
Command Syntax
automatic-router-id-selection enable
no automatic-router-id-selection enable
Parameters
None
Default
No default value is specified
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#automatic-router-id-selection enable
(config)#
clear ip route kernel
Use this command to clear stale IPv4 routes from the RIB (Routing Information Base) and FIB (Forwarding Information Base).
Command Syntax
clear ip route kernel
clear ip kernel route
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#clear ip route kernel
clear ip route
Use this command to clear an all IPv4 routes or any specific prefix routes.
Command Syntax
clear ip route (*|A.B.C.D/M)
Parameters
*
Clears all routes
A.B.C.D/M
Prefix to be cleared
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#clear ip route *
#clear ip route 1.1.1.0/24
clear ip route vrf NAME
Use this command to clear all IPv4 VRF route or any specific prefix VRF route of any particular VRF name.
Command Syntax
clear ip route vrf NAME (*|A.B.C.D/M)
Parameters
NAME
VPN Routing or Forwarding instance name
*
Clears all routes
A.B.C.D/M
Prefix to be cleared
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#clear ip route vrf myVRF *
clear router-id
Use this command to clear the current Router-Id and trigger the Router-Id calculation again. The new Router-id is sent to all protocol modules.
• To clear only the router-id for the default VRF, enter clear router-id.
• To clear the router-id for a particular VRF, enter clear router-id vrf VRFNAME.
• To clear the router-id for all VRFs, enter clear router-id vrf.
Command Syntax
clear router-id (vrf (VRFNAME|))
Parameters
VRFNAME
VPN routing/forwarding instance name.
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#clear router-id
#clear router-id vrf
debug rib
Use this command to debug the ribd process.
Use the no form of this command to stop debugging.
Command Syntax
debug rib (all|)
debug rib events
debug rib packet (recv|send|) (detail|)
debug rib nsm
debug rib bfd
debug rib kernel
debug rib monitor
debug ip routing (add-route|delete-route|mod-route|
no debug all
no debug rib (all|)
no debug all rib
no debug rib events
no debug rib packet (recv|send|) (detail|)
no debug rib nsm
no debug rib bfd
no debug rib kernel
no debug rib monitor
no debug ip routing (add-route|delete-route|mod-route|)
Parameters
all
All debugging functions
events
Events
packet
Packet events
recv
Received packets
send
Sent packets
detail
Detailed information
nsm
NSM events
kernel
RIB kernel
monitor
Enable Monitor route netlink
bfd
BFD (Bidirectional Forwarding Detection) events
ip routing
IPv4 routing events
add-route
Add route events
delete-route
Delete route events
mod-route
Modify route events
Disabled
By default, debug command is disabled.
Command Mode
Privileged Exec mod
Applicability
This command was introduced before OcNOS version 1.3.
Example
#debug rib all
description
Use this command to assign a description to a Virtual Router instance.
Use the no parameter to remove a description.
Command Syntax
description LINE
no description
Parameters
LINE
Virtual Router description maximum 80 characters
Disabled
By default, description command is disabled
Command Mode
VR mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#virtual-router VR1
(config-vr)#description VR1 has been created for CLI testing
(config-vr)#exit
(config)#virtual-router VR1
(config-vr)#no description
(config-vr)#exit
fib retain
Use this command to set the retention time for stale routes in the Forwarding Information Base (FIB) when ribd restarts. The ribd process reads the FIB and treats previously self-installed routes as stale.
You can display stale routes by running the show ip route database command. All routes preceded by the symbol p are stale routes. When protocol modules restart, ribd overrides these stale routes with routes updated by the protocol modules.
Table 8 show the behavior of routes when
ribd stops.
Table 8: FIB retention
Command | Behavior |
|---|
fib retain | Does not clear routes from the FIB and retains stale routes for 60 seconds when restarted. |
fib retain forever | Does not clear routes and retains stale routes forever. |
fib retain time <1-65535> | Does not clear routes and retains stale routes for the specified seconds. |
no fib retain (default) | Cleans up routes in the FIB, but retains stale routes for 60 seconds when restarted. |
You can remove stale routes at any time with the
clear ip route kernel command.
Use the no form of this command to revert to default; that is, do not retain routes in the FIB when ribd stops.
Command Syntax
fib retain (forever|time <1-65535>|)
no fib retain (forever|time <1-65535>|)
Parameters
forever
Retain FIB forever
time
Retain FIB for a time after ribd restarts
<1-65535>
Retention time in seconds; if you omit this value, the default is 60 seconds
Default
Routes are cleared from the FIB when ribd stops. However, when ribd restarts, stale routes are retained for 60 seconds.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#fib retain time 180
ip route
Use this command to create an IPv4 static route.
Use the no form of this command to delete a static route.
Command Syntax
ip route A.B.C.D/M (A.B.C.D|IFNAME)
ip route A.B.C.D A.B.C.D (A.B.C.D|IFNAME)
ip route A.B.C.D/M (A.B.C.D|IFNAME){<1-255>|tag <0-4294967295>|description WORD}
ip route A.B.C.D A.B.C.D (A.B.C.D|IFNAME){<1-255>|tag <0-4294967295>|description WORD}
ip route vrf NAME A.B.C.D/M IFNAME
ip route vrf NAME A.B.C.D/M A.B.C.D IFNAME
ip route vrf NAME A.B.C.D/M A.B.C.D IFNAME global
ip route vrf NAME A.B.C.D/M IFNAME {<1-255>|tag <0-4294967295>|description WORD}
ip route vrf NAME A.B.C.D/M A.B.C.D IFNAME {<1-255>|tag <0-4294967295>|description WORD}
no ip route A.B.C.D/M (A.B.C.D|IFNAME|)
no ip route A.B.C.D A.B.C.D (A.B.C.D|IFNAME)
no ip route A.B.C.D/M (A.B.C.D|IFNAME){<1-255>|tag <0-4294967295>|description WORD}
no ip route A.B.C.D A.B.C.D (A.B.C.D|IFNAME){<1-255>|tag <0-4294967295>|description WORD}
no ip route vrf NAME A.B.C.D/M IFNAME
no ip route vrf NAME A.B.C.D/M A.B.C.D IFNAME
no ip route vrf NAME A.B.C.D/M IFNAME {<1-225>|tag <0-4294967295>|description WORD}
no ip route vrf NAME A.B.C.D/M A.B.C.D IFNAME {<1-255>|tag <0-4294967295>|description WORD}
Parameters
A.B.C.D/M
Subnet: IP destination prefix and a mask length
A.B.C.D A.B.C.D
Subnet: IP destination address and mask
A.B.C.D
Gateway nexthop IPv4 address
global
Global table lookup (to support inter-VRF static route leaking)
<1-255>
Administrative distance
IFNAME
Gateway nexthop interface name
description
Description of the static route maximum 80 character
tag
Tag used as a “match” value to control redistribution via route maps
<0-4294967295>
Tag value
vrf
VRF (Virtual Routing and Forwarding) instance
NAME
VRF name
Default
By default, no static IPv4 route configured
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3 and was updated in OcNOS version 1.3.4.
Examples
#configure terminal
(config)#ip route 192.168.3.0 255.255.255.0 2.2.2.2 128
(config)#ip route 1.1.1.0/24 eth0 32
(config)#ip route vrf new 1.1.1.1/1 1.1.1.1 eth1 description new tag 1
This example creates VRF static routes with the nexthops belonging to the default VRF. The nexthop gateway address can be the IFNAME network address or any other IP address reachable via IFNAME.
#show ip route vrf
Codes: K - kernel, C - connected, S - static, R - RIP, B - BGP
O - OSPF, IA - OSPF inter area
N1 - OSPF NSSA external type 1, N2 - OSPF NSSA external type 2
E1 - OSPF external type 1, E2 - OSPF external type 2
i - IS-IS, L1 - IS-IS level-1, L2 - IS-IS level-2, ia - IS-IS inter area,
v - vrf leaked
* - candidate default
IP Route Table for VRF "default"
C 10.12.19.0/24 is directly connected, eth0, 4d23h06m
C 11.1.1.0/24 is directly connected, eth4, 4d23h01m
C 13.13.13.0/31 is directly connected, eth3, 4d23h06m
C 50.5.5.0/24 is directly connected, eth3, 4d23h06m
C 100.100.100.0/24 is directly connected, lo, 4d23h06m
O 101.1.1.1/32 [110/11] via 11.1.1.2, eth4, 19:20:39
C 127.0.0.0/8 is directly connected, lo, 4d23h06m
Gateway of last resort is not set
(config)#ip route vrf vrf1 201.201.201.201/32 11.1.1.11 eth4 global
(config)#ip route vrf vrf1 202.202.202.202/32 101.1.1.1 eth4 global
#show ip route vrf vrf1 static
IP Route Table for VRF "vrf1"
S v201.201.201.201/32 [1/0] via 11.1.1.11, eth4, 00:00:44
S v202.202.202.202/32 [1/0] via 101.1.1.1, eth4 (recursive via 11.1.1.2), 00:00:17
Gateway of last resort is not set
ip urpf enable
Use this command to enable uRPF mode on the system.
Use the no form of the command to disable uRPF mode on this system.
Note: The configuration is applied only after a reboot.
Command Syntax
ip urpf enable
no ip urpf enable
Parameter
None
Default
By default, uRPF mode on the system is disabled.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#ip urpf enable
% System Reboot is required for new URPF configurations to take effect
(config)#no ip urpf enable
% System Reboot is required for new URPF configurations to take effect
ip verify unicast source reachable-via
Use this command to Configure Unicast Reverse Path Forwarding with source-specific reachability on the interface level.
Use the no form of the command to disable Unicast Reverse Path Forwarding with source-specific reachability on the interface level.
Command Syntax
ip verify unicast source reachable-via (any (allow-default|) | rx )
no ip verify unicast source reachable-via
Parameters
any
Source is reachable via any interface
rx
Source is reachable via an interface on which packet was received
allow-default
Loose Default Route Unicast Reverse Path Forwarding
Default
N/A
Command Mode
Interface mode
Applicability
This command was introduced in OcNOS Version 6.0.0.
Examples
#configure terminal
(config)#interface xe1
(config-if)#ip verify unicast source reachable-via any
(config-if)#ip verify unicast source reachable-via any allow-default
(config-if)#ip verify unicast source reachable-via rx
(config-if)#no ip verify unicast source reachable-via
ip vrf
This command creates a user-defined VRF (Virtual Routing and Forwarding) RIB (Routing Information Base), assigns a VRF identifier, and switches to VRF mode.
Use the no parameter with command to remove a VRF RIB.
Note: On configuration of user-defined VRF with ip vrf WORD CLI, lo.WORD interface configuration will not be displayed in show running-config even though lo.WORD interface, default IPv4 address and default IPv6 address are present in system. To display the interface lo.WORD, ip address 127.0.0.1/8 and ipv6 address ::1/128 configurations in show running configuration user needs to explicitly configure the same from CLI. This is due to a restriction with scaled VRF configurations in a single commit.
Command Syntax
ip vrf WORD
no ip vrf WORD
Parameter
WORD
VRF identifier
Default
By default, no user-defined VRFs exist, only the default VRF.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#ip vrf myVRF
(config-vrf)#
maximum-paths
Use this command to set the maximum number of paths to install in the FIB (Forwarding Information Base) for the ECMP (Equal-Cost MultiPath) feature.
Use the no parameter with this command to revert to default.
Note: If you change the number of paths from the default (8), you must save the running configuration and perform a reboot.
Command Syntax
maximum-paths <1-64>
no maximum-paths
Parameter
<1-64>
Maximum number of paths to install in the FIB
Default
By default, the maximum number of paths is 8.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#maximum-paths 5
max-static-routes
Use this command to set the maximum number of static routes.
Use the no parameter to disable this command.
Command Syntax
max-static-routes <1-4294967294>
no max-static-routes
Parameters
<1-4294967294>
Maximum number of static routes
Default
By default, max static routes value is 4294967294
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#max-static-routes 123
(config)#no max-static-routes
router-id
Use this command to add a router identifier for this system.
Use the no form of this command to disable this function.
Command Syntax
router-id A.B.C.D
no router-id (A.B.C.D)
Parameters
A.B.C.D
Router identifier in IP address format for this system.
Default
None
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#router-id 123.12.3.123
(config)#
show debugging rib
Use this command to display debug settings.
Command Syntax
show debugging rib
Parameters
None
Command Mode
Privileged Exec Mode and Exec Mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#show debugging rib
show ip rpf
Use this command to display reverse path forwarding (RPF) information for the specified source address.
Command Syntax
show ip rpf A.B.C.D
show ip rpf (vrf NAME|) A.B.C.D
Parameters
A.B.C.D
IP address of multicast source.
NAME
Virtual Routing and Forwarding name.
Default
None
Command Mode
Exec and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show ip rpf 10.10.10.50
RPF information for 10.10.10.50
RPF interface: eth0
RPF neighbor: 10.1.2.1
RPF route: 0.0.0.0/0
RPF type: unicast (kernel)
RPF recursion count: 0
Doing distance-preferred lookups across tables
Distance: 0
Metric: 0
#
Table 9 explains the output fields.
Table 9: show ip rpf output fields
Field | Description |
|---|
RPF Interface | Name of the RPF interface. |
RPF neighbor | Upstream RPF neighbor. |
RPF route | Route table in which the logical interface address is located. |
RPF type | Different type of RPF like multicast, unicast, MBGP, DVMRP, or static mroutes. |
RPF recursion count | Number of times that the router lookups its routing table more than once to find out the immediate next-hop and exiting interface. |
Distance | IP address of the remote side of the connection. Doing distance-preferred lookups across tables. |
Metric | Metrics are informational units that can be measured and compared. |
show ipv6 rpf
Use this command to display reverse path forwarding (RPF) information for the specified source address.
Command Syntax
show ipv6 rpf X:X::X:X
show ipv6 rpf (vrf NAME|) X:X::X:X
Parameters
X:X::X:X
IP address of multicast source.
NAME
Virtual Routing and Forwarding name.
Default
None
Command Mode
Exec and privileged exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show ipv6 rpf 10:10::10:50
RPF information for 10.10.10.50
RPF interface: eth0
RPF neighbor: 10.1.2.1
RPF route: 0.0.0.0/0
RPF type: unicast (kernel)
RPF recursion count: 0
Doing distance-preferred lookups across tables
Distance: 0
Metric: 0
#
Table 10 explains the output fields.
Table 10: show ipv6 rpf output fields
Field | Description |
|---|
RPF Interface | Name of the RPF interface. |
RPF neighbor | Upstream RPF neighbor. |
RPF route | Route table in which the logical interface address is located. |
RPF type | Different type of RPF like multicast, unicast, MBGP, DVMRP, or static mroutes. |
RPF recursion count | Number of times that the router lookups its routing table more than once to find out the immediate next-hop and exiting interface. |
Distance | IPv6 address of the remote side of the connection. Doing distance-preferred lookups across tables. |
Metric | Metrics are informational units that can be measured and compared. |
show router-id
Use this command to display the Router ID of the current system.
Command Syntax
show router-id
Parameters
None
Default
None
Command Mode
Privileged Exec mode and Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show router-id
Router ID: 10.55.0.2 (automatic)
show running-config router
Use this command to display the running system router configuration.
Command Syntax
show running-config router bgp
show running-config router isis
show running-config router ospf
show running-config router rip
show running-config router vrrp
Parameters
bgp
Display Border Gateway Protocol (BGP) information.
isis
Display Intermediate System to Intermediate System (IS-IS) information.
ospf
Display Open Shortest Path First (OSPF) information.
rip
Display Routing Information Protocol (RIP) information.
vrrp
Display Virtual Router Redundancy Protocol (VRRP) information.
Default
None
Command Mode
Privileged exec mode, configure mode, router-map mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
>enable
#show running-config router vrrp
!
router-id 3.3.3.3
!
show running-config router-id
Use this command to show the running system global router ID configuration.
Command Syntax
show running-config router-id
Parameters
None
Default
None
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
>enable
#show running-config router-id
!
router-id 3.3.3.3
!
show running-config urpf
Use this command to check uRPF status for this system.
Command Syntax
show running-config urpf
Parameters
None
Default
None
Command Mode
Exec mode and Privileged exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show running-config urpf
ip urpf enable
(config)#show running-config urpf
ip urpf enable
show running-config vrf
Use this command to show the running system status and configuration details for a specified VRF instance name.
Command Syntax
show running-config vrf WORD
Parameters
WORD
Virtual Routing and Forwarding name
Command Mode
Privileged exec mode, configure mode, router mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
>enable
#show running-config vrf xyz
!
ip vrf xyz
description vrf
router-id 11.11.11.11
snmp restart rib
Use this command to restart SNMP in Routing Information Base (RIB)
Command Syntax
snmp restart rib
Parameters
None
Default
By default, snmp restart command is disabled.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#config terminal
(config)#snmp restart rib