On-Demand Routing Commands

Cisco IOS IP Routing: ODR Command Reference

March 2011 IRD-3
 On-Demand Routing Commands
router odr

router odr
To configure an On-Demand Routing (ODR) process on a Cisco router, use the router odr command in
global configuration mode. To disable the ODR process, use the no form of this command.

router odr

no router odr

Syntax Description This command has no arguments or keywords

Defaults No default behavior or values

Command Modes Global configuration

Command History Release Modification

11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support
in a specific 12.2SX release of this train depends on your feature set,
platform, and platform hardware.

Usage Guidelines The router odr command is used to configure a router as an ODR hub router to dynamically accept
routes from stub peers. ODR provides IP routing with minimal configuration requirements. The
overhead of dynamic routing protocol is avoided without incurring the configuration and management
overhead of static routing.
The ODR process maintains a routing table, which is populated with information learned from ODR stub
peers. Cisco Discovery Protocol (CDP) must be enabled on the hub router and stub peers. ODR timing
values should be tuned based the number of peers and the speed of the links in your network. Route
filtering should be applied consistently.

Examples In the following example, an ODR process is enabled, a distribution list is configured to filter routes
learned from ODR stub peers, and redistribution statement is configured under the Open Shortest Path
First (OSPF) routing process:
Router(config)# access-list 101 permit ip host 10.0.0.1 192.168.1.0 0.0.0.255
Router(config)# access-list 101 permit ip 10.0.10.2 255.0.0.0 192.168.2.0 0.0.0.255
Router(config)# router odr
Router(config-router)# distribute-list 101 in
Router(config-router)# exit
Router(config-router)# router ospf 1
Router(config-router)# redistribute odr subnets

Cisco IOS IP Routing: ODR Command Reference

IRD-4 March 2011
 On-Demand Routing Commands
router odr

Related Commands Command Description

cdp timer Specifies how often the Cisco IOS software sends CDP updates,
distance (IP) Defines an administrative distance.
distribute-list in (IP) Filters networks received in updates.
distribute-list out (IP) Suppresses networks from being advertised in updates.
maximum-paths Controls the maximum number of parallel routes an IP routing protocol can
support.
timers basic (ODR) Adjusts ODR network timers.

Cisco IOS IP Routing: ODR Command Reference

March 2011 IRD-5
 On-Demand Routing Commands
timers basic (ODR)

timers basic (ODR)

To adjust On-Demand Routing (ODR) network timers, use the timers basic command in router
configuration mode. To restore default ODR timer values, use the no form of this command.

timers basic update invalid holddown flush [sleeptime]

no timers basic

Syntax Description update Rate (in seconds) at which updates are sent. This is the fundamental timing
parameter of the ODR routing protocol.
invalid Interval of time (in seconds) after which a route is declared invalid; it should
be at least three times the value of the update argument. A route becomes
invalid when there is an absence of updates that refresh the route. The route
then enters holddown. The route is marked inaccessible and advertised as
unreachable. However, the route is still used for forwarding packets.
holddown Interval (in seconds) during which routing information regarding better paths
is suppressed. It should be at least three times the value of the update
argument. A route enters into a holddown state when an update packet is
received that indicates the route is unreachable. The route is marked
inaccessible and advertised as unreachable. However, the route is still used for
forwarding packets. When holddown expires, routes advertised by other
sources are accepted and the route is no longer inaccessible.
flush Amount of time (in seconds) that must pass before the route is removed from
the routing table; the interval specified must be at least the sum of the invalid
and holddown arguments. If it is less than this sum, the proper holddown
interval cannot elapse, which results in a new route being accepted before the
holddown interval expires.
sleeptime (Optional) Interval (in milliseconds) for postponing routing updates in the
event of a flash update. The sleeptime value should be less than the update
time. If the sleeptime is greater than the update time, routing tables will
become unsynchronized.

Defaults ODR uses the following default values if this command is not configured or if the no form of this
command is entered:
update: 90 seconds
invalid: 270 seconds
holddown: 280 seconds
flush: 630 seconds
sleeptime: 0 milliseconds

Command Modes Router configuration

Cisco IOS IP Routing: ODR Command Reference

IRD-6 March 2011
 On-Demand Routing Commands
timers basic (ODR)

Command History Release Modification

10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support
in a specific 12.2SX release of this train depends on your feature set,
platform, and platform hardware.

Usage Guidelines The basic timing parameters for ODR are adjustable. Because this routing protocol is executing a
distributed, asynchronous routing algorithm, it is important that these timers be the same for all routers
and access servers in the network.

Note The current and default timer values are displayed in the output of the show ip protocols EXEC
command. The relationships of the various timers should be preserved as described in the syntax
description table.

Examples In the following example, updates are configured to be broadcast every 5 seconds. If a reply is not
received from a peer within 15 seconds, the route is declared unusable. Further information the dead peer
is suppressed for an additional 15 seconds. At the end of the suppression period, the route is flushed from
the routing table.
Router(config)# router odr
Router(config-router)# timers basic 5 15 15 30
Router(config-router)# end

Note When configuring a short update period, you run the risk of congesting slow-speed serial lines; however,
this is less of a concern on high-speed links, such as Fast Ethernet, Gigabit Ethernet, and T1-rate serial
links. Also, if you have many routes in your updates, you can cause the routers to spend an excessive
amount of time processing updates.

Related Commands Command Description

cdp timer Specifies how often the Cisco IOS software sends CDP updates,
router odr Configures an ODR process on a Cisco router.

Cisco IOS IP Routing: ODR Command Reference

March 2011 IRD-7
 On-Demand Routing Commands
timers basic (ODR)

Cisco IOS IP Routing: ODR Command Reference

IRD-8 March 2011