THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED "AS IS" WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

© 2012 Cisco Systems, Inc. All rights reserved.

Cisco IOS IP Routing: ODR Command Reference

- On-Demand Routing Commands

- router odr

- timers basic (ODR)

On-Demand Routing Commands

- router odr

- timers basic (ODR)

router odr

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

router odr commandrouter odr

no router odr

Syntax Description

This command has no arguments or keywords

Command Default

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.

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

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.

timers basic (ODR)

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

timers basic update invalid holddown flush [sleep-time]

no timers basic

Syntax Description

update

Rate (in seconds) at which updates are sent. The range is from 0 to 2147483.

invalid

Period of time (in seconds) after which a route is declared invalid. The range is from 0 to 2147483. The value of the invalid argument should be at least three times the value of the update argument.

holddown

Period of time (in seconds) during which routing information about better paths is suppressed. The range is from 0 to 2147483. The value of the holddown argument should be at least three times the value of the update argument.

flush

Period of time (in seconds) before the route is removed from the routing table. The range is from 0 to 2147483. The specified period of time must be at least the sum of the invalid and holddown arguments. If the specified period of time is less than this sum, the holddown interval will not elapse, which will result in a new route being accepted before the holddown interval expires.

sleep-time

(Optional) Period of time (in milliseconds) for postponing routing updates in the event of a flash update. The range is from 0 to 2147483647. The value of the sleep-time argument should be less than the value of the update argument. If the value of the sleep-time argument is higher than the value of the update argument, routing tables will become unsynchronized.

Command Default

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; and sleep-time: 0 milliseconds.

Command Modes

Router configuration (config-router)

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 ODR executes a distributed, asynchronous routing algorithm, these timers must 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 command. The relationships among the various timers should be preserved as described in the syntax description table.

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 invalid. Information about better paths is suppressed for an additional 15 seconds. At the end of the suppression period, the route is flushed from the routing table.

Device(config)# router odr

Device(config-router)# timers basic 5  15  15  30

Device(config-router)# end

Note

When you configure a short update period, you run the risk of congesting slow-speed serial lines, which is less of a concern on high-speed links, such as Fast Ethernet, Gigabit Ethernet, and T1-rate serial links.

Related Commands

Command

Description

cdp timer

Specifies how often the Cisco IOS software sends Cisco Discovery Protocol updates.

show ip protocols

Displays parameters and the current state of the active routing protocol process.