Fundamental Layer 3 Commands

OcNOS-RON : Layer 3 Guide : Fundamental Layer 3 Command Reference : Fundamental Layer 3 Commands

This chapter describes the fundamental Layer 3 commands:

• automatic-router-id-selection enable

• clear ip route kernel

• clear ip route

• clear ip route vrf NAME

• clear router-id

• debug rib

• description

• fib retain

• ip route

• Ip route vrf <vrf-name>

• ip urpf enable

• ip urpf allow-default

• ip verify unicast source reachable-via

• ip vrf

• Ipv6 route

• maximum-paths

• max-static-routes

• router-id

• show debugging rib

• Show ip route track-table

• show ip rpf

• Show ipv6 route track-table

• show ipv6 rpf

• show router-id

• show running-config router

• show running-config router-id

• show running-config urpf

• show running-config vrf

• snmp restart rib

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 or the undebug 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|)

undebug all

undebug rib (all|)

undebug all rib

undebug rib events

undebug rib packet (recv|send|) (detail|)

undebug rib nsm

undebug rib bfd

undebug rib kernel

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 1-1 show the behavior of routes when ribd stops.

Table 1-1: 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.

Note: ECMP static route with one nexthop in local vrf and the other nexthop in inter vrf is not supported and IVRF static ECMP is not supported.

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}{<track <1-500>}

ip route A.B.C.D A.B.C.D (A.B.C.D|IFNAME){<1-255>|tag <0-4294967295>|description WORD}{<track <1-500>}

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 {<track <1-500>}

ip route vrf NAME A.B.C.D/M IFNAME {<1-255>|tag <0-4294967295>|description WORD} {<track <1-500>}

ip route vrf NAME A.B.C.D/M A.B.C.D IFNAME {<1-255>|tag <0-4294967295>|description WORD}{<track <1-500>}

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}{<track <1-500>}

no ip route A.B.C.D A.B.C.D (A.B.C.D|IFNAME){<1-255>|tag <0-4294967295>|description WORD} {<track <1-500>}

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}{<track <1-500>}

no ip route vrf NAME A.B.C.D/M A.B.C.D IFNAME {<1-255>|tag <0-4294967295>|description WORD}{<track <1-500>}

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

track

Tracking-id to ipv4 static route

<1-500>

Identifier for the tracked object

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.

The Track command is introduced in OcNOS-SP version 5.1.

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

(config)# ip route 40.1.1.0/24 eth1 track 10

(config-object-track)#commit

OcNOS(config)#no ip route 40.1.1.0/24 eth1 track 10

OcNOS(config)#commit

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

#configure terminal

OcNOS(config)#ip route vrf vrf1 20.2.2.0/24 xe1 global

OcNOS(config)#commit

OcNOS(config)#no ip route vrf vrf1 20.2.2.0/24 xe1 global track 10

OcNOS(config)#commit

Ip route vrf <vrf-name>

Use this command to configure a tracking-id to ipv4 static route in non-default vrf.

Use the no form of this command to delete the tracking id

Command Syntax

ip route vrf <vrf-name> A.B.C.D/M (A.B.C.D|IFNAME){<track <1-500>}

Parameters

vrf-name

Vrf name

A.B.C.D/M

Destination prefix with subnet in ipv4 format

A.B.C.D

Gateway address in ipv4 format

IFNAME

Gateway address in interface name format

<1-500>

Identifier for the tracked object

Command Mode

Configuration mode

Applicability

This command is in introduced in OcNOS-SP version 5.1.

Example

#configure terminal

OcNOS(config)# ip route vrf vrf1 40.1.1.0/24 eth1 track 10

OcNOS(config-object-track)#commit

OcNOS(config)#no ip route vrf vrf1 40.1.1.0/24 eth1 track 10

OcNOS(config)#commit

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 urpf allow-default

Use this command to enable default route check for uRPF mode.

Use no form of this command to disable default route check for uRPF mode.

Command Syntax

This command applies only to Qumran platforms.

ip urpf allow-default

no ip urpf allow-default

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 allow-default

(config)#no ip urpf allow-default

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 | rx )

no ip verify unicast source reachable-via

Parameters

any

Source is reachable via any interface

Source is reachable via an interface on which packet was received

Default

N/A

Command Mode

Interface mode

Applicability

This command was introduced in OcNOS SP Version 6.0

Examples

#configure terminal

(config)#interface xe1

(config-if)#ip verify unicast source reachable-via any

(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)#

Ipv6 route

Use this command to configure a tracking-id to ipv6 static route that is leaked to the non-default VRF.

Use the no form of this command to delete the tracking id

Command Syntax

ipv6 route X:X::X:X/M (X:X::X:X|IFNAME) {<track <1-500>}

ipv6 route vrf NAME X:X::X:X/M (X:X::X:X|IFNAME) global {<track <1-500>}

Parameters

X:X::X:X/M

Destination prefix with subnet in ipv6 format

X:X::X:X

Nexthop address in IPv6 format

IFNAME

Nexthop address in interface name format

vrf

VRF (Virtual Routing and Forwarding) instance

NAME

VRF name

global

Global table lookup (to support inter-VRF static route leaking)

track

Tracking-id to IPv4 static route

<1-500>

Identifier for the tracked object

Command Mode

Configuration mode

Applicability

This command is introduced in OcNOS-SP version 5.1.

Example

#configure terminal

OcNOS(config)# ipv6 route 5000::/64 3001::1 track 20

OcNOS(config-object-track)#commit

OcNOS(config)#no ipv6 route 5000::/64 3001::1 track 20

OcNOS(config)#commit

#configure terminal

OcNOS(config)# ipv6 route vrf vrf1 2002::0/64 xe1 global track 30

OcNOS(config)#commit

OcNOS(config)#no ipv6 route vrf vrf1 2002::0/64 xe1 global track 30

OcNOS(config)#commit

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 route track-table

Use this command to display ipv4 static routes that are associated to a tracking id across all vrfs.

Command Syntax

Show ip route track-table

Parameters

None

Default

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command is introduced in OcNOS-SP version 5.1.

Examples

OcNOS#show ip rou track-table

ip route 40.1.1.0 255.255.255.0 eth1 track 10 state is [up]

ip route 50.1.1.0 255.255.255.0 20.1.1.4 track 10 state is [up]

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 1-2 explains the output fields.

Table 1-2: 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 route track-table

Use this command to display ipv4 static routes that are associated to a tracking id across all vrfs.

Command Syntax

Show ipv6 route track-table

Parameters

None

Default

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command is introduced in OcNOS-SP version 5.1.

Examples

OcNOS# show ipv6 route track-table

ipv6 route 5000::/64 eth1 track 10 state is [up]

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 1-3 explains the output fields.

Table 1-3: 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 ldp

show running-config router ospf

show running-config router rip

show running-config router rsvp

show running-config router vrrp

Parameters

bgp

Display Border Gateway Protocol (BGP) information.

isis

Display Intermediate System to Intermediate System (IS-IS) information.

ldp

Display Label Distribution Protocol (LDP) information.

ospf

Display Open Shortest Path First (OSPF) information.

rip

Display Routing Information Protocol (RIP) information.

rsvp

Display Resource Reservation Protocol (RSVP) 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