-
Cisco IOS XR Routing Command Reference, Release 3.6
-
Preface
-
BGP Commands on Cisco IOS XR Software
-
EIGRP Commands on Cisco IOS XR Software
-
IS-IS Commands on Cisco IOS XR Software
-
OSPF Commands on Cisco IOS XR Software
-
OSPFv3 Commands on Cisco IOS XR Software
-
RIB Commands on Cisco IOS XR Software
-
RIP Commands on Cisco IOS XR Software
-
Routing Policy Commands on Cisco IOS XR Software
-
Static Routing Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
EIGRP Commands on Cisco IOS XR Software
EIGRP Commands on Cisco IOS XR Software
This chapter describes the commands used to configure and monitor the Enhanced Interior Gateway Routing Protocol (EIGRP).
For detailed information about EIGRP concepts, configuration tasks, and examples, see Implementing EIGRP on Cisco IOS XR Software in Cisco IOS XR Routing Configuration Guide.
address-family (EIGRP)
To enable an IPv4 or IPv6 address family under Enhanced Interior Gateway Routing Protocol (EIGRP), use the address-family command in the appropriate mode. To remove the address family from the EIGRP configuration, use the no form of this command.
address-family {ipv4 | ipv6}
no address-family {ipv4 | ipv6}
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Router configuration
VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the address-family ipv4 command to configure IPv4 address family sessions in EIGRP and the address-family ipv6 command to configure IPv6 address family sessions in EIGRP.
EIGRP Virtual Private Networks (VPNs) can be configured under IPv4 and IPv6 address family configuration modes after first entering VRF configuration mode. All commands in address family configuration mode can be configured in VRF address families except the autonomous-system and maximum-prefix commands.
Task ID
Examples
The following example shows how to configure a IPv4 VRF address family session after defining the VRF named vrf1:
RP/0/RP0/CPU0:router(config)# router eigrp 1RP/0/RP0/CPU0:router(config-eigrp)# vrf vrf1RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# default-metric 1000 100 255 1 1500RP/0/RP0/CPU0:router(config-eigrp-vrf-af)#Related Commands
Configures an EIGRP routing process to run within a VRF.
Limits the number of prefixes that are accepted under an address family by EIGRP.
auto-summary (EIGRP)
To allow automatic summarization of subnet routes into network-level routes for an Enhanced Interior Gateway Routing Protocol (EIGRP) process, use the auto-summary command in the appropriate configuration mode. To disable this function and send subprefix routing information across classful network boundaries, use the no form of this command.
auto-summary
no auto-summary
Syntax Description
This command has no arguments or keywords.
Defaults
The behavior of this command is disabled by default. (The software sends subnet routing information across classful network boundaries.)
Command Modes
IPv4 Address family configuration
IPv4 VRF address family configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Route summarization reduces the amount of routing information in the routing tables. Use the auto-summary command to allow the software to create summary subprefixes to the classful network boundary when crossing classful network boundaries.
EIGRP summary routes are given an administrative distance value of 5. You cannot configure this value.
Task ID
Examples
The following example shows how to enable automatic summarization for EIGRP 1:
RP/0/RP0/CPU0:router(config)# router eigrp 1RP/0/RP0/CPU0:router(config-eigrp)# vrf vpn-1RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# auto-summaryRelated Commands
autonomous-system
To configure an Enhanced Interior Gateway Routing Protocol (EIGRP) routing process to run within a VPN routing and forwarding instance (VRF), use the autonomous-system command in IPv4 VRF address family configuration mode.
autonomous-system as-number
no autonomous-system as-number
Syntax Description
Defaults
No default behavior or values
Command Modes
IPv4 VRF address family configuration
IPv6 VRF address family configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the autonomous-system command in IPv4 or IPv6 VRF address family configuration mode.
Task ID
Examples
The following example shows how to configure autonomous system 101 under VRF VPN-1:
RP/0/RP0/CPU0:router(config)# router eigrp 1RP/0/RP0/CPU0:router(config-eigrp)# vrf vpn-1RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# autonomous-system 101Related Commands
bandwidth-percent (EIGRP)
To configure the percentage of bandwidth that may be used by EIGRP on an interface, use the bandwidth-percent command in interface configuration mode. To restore the default value, use the no form of this command.
bandwidth-percent percent
no bandwidth-percent
Syntax Description
Defaults
percent: 50
Command Modes
Interface configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
EIGRP uses up to 50 percent of the bandwidth of a link, as defined by the bandwidth interface configuration command. This command may be used if some other fraction of the bandwidth is desired. Values greater than 100 percent may be configured. The configuration option may be useful if the bandwidth is set artificially low for other reasons.
Task ID
Examples
The following example shows how to configure EIGRP to use up to 75 percent (42 kbps) of an interface in autonomous system 209:
RP/0/RP0/CPU0:router(config)# router eigrp 1RP/0/RP0/CPU0:router(config-eigrp)# address-family ipv4RP/0/RP0/CPU0:router(config-eigrp-af)# router-id 10.1.1.1RP/0/RP0/CPU0:router(config-eigrp-af)# interface POS 0/1/0/0RP/0/RP0/CPU0:router(config-eigrp-af-if)# bandwidth-percent 75Related Commands
clear eigrp neighbors
To remove and re-establish Enhanced Interior Gateway Routing Protocol (EIGRP) neighbor entries from the appropriate table, use the clear eigrp neighbors command in EXEC mode.
clear eigrp [as-number] [vrf {vrf | all}] [ipv4 | ipv6] neighbors [ip-address | interface-type interface-instance] [soft]
Syntax Description
Defaults
When no autonomous system number or VRF instance is specified, all EIGRP neighbor entries are cleared from the table.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear all EIGRP VRF entries for neighbor Gigabit Ethernet interface 0/5/0/0:
RP/0/RP0/CPU0:router# clear eigrp vrf customer_1 neighbors GigabitEthernet 0/5/0/0Related Commands
Displays information about interfaces configured for EIGRP.
Displays the neighbors discovered by EIGRP.
clear eigrp topology
To remove and relearn Enhanced Interior Gateway Routing Protocol (EIGRP) topology entries from the appropriate table, use the clear eigrp topology command in EXEC mode.
clear eigrp [as-number] [vrf {vrf | all}] [ipv4 | ipv6] topology {prefix mask | prefix/length}
Syntax Description
Defaults
No EIGRP topology entries are cleared.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear EIGRP topology entries for a specific route:
RP/0/RP0/CPU0:router# clear eigrp topology 10.1.0.0/8Related Commands
default-information
To control the candidate default routing information for an Enhanced Interior Gateway Routing Protocol (EIGRP), use the default-information command in the appropriate configuration mode. To suppress EIGRP candidate default information in incoming or outgoing updates, use the no form of this command.
default-information allowed {in | out} [route-policy name]
no default-information allowed {in | out}[ route-policy name]
Syntax Description
Defaults
Default routing information is not accepted or flagged.
Command Modes
Address family configuration
IPv4 VRF address family configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to configure inbound default routes specified with route policy acme to be accepted by an EIGRP peer in autonomous system 1:
RP/0/RP0/CPU0:router(config)# router eigrp 1RP/0/RP0/CPU0:router(config-eigrp)# vrf vrf1RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# default-information accept in route-policy acmedefault-metric (EIGRP)
To set metrics for an Enhanced Interior Gateway Routing Protocol (EIGRP), use the default-metric command in the appropriate configuration mode. To remove the metric value and restore the default state, use the no form of this command.
default-metric bandwidth delay reliability loading mtu
no default-metric
Syntax Description
Defaults
No default values
Command Modes
IPv4 address family configuration
IPv6 address family configuration
IPv4 VRF address family configuration
IPv6 VRF address family configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the default-metric command to provide default metric values while redistributing a protocol into EIGRP.
Metric defaults have been carefully set to work for a wide variety of networks. Take great care when changing these values.
Task ID
Examples
The following example shows how to take redistributed Routing Information Protocol (RIP) metrics and translate them into EIGRP metrics with values as follows: bandwidth = 1000, delay = 100, reliability = 250, loading = 100, and MTU = 1500.
RP/0/RP0/CPU0:router(config)# router eigrp 1RP/0/RP0/CPU0:router(config-eigrp)# vrf vrf1RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# redistribute ripRP/0/RP0/CPU0:router(config-eigrp-vrf-af)# default-metric 1000 100 250 100 1500Related Commands
redistribute
Redistributes routes from one routing domain into another routing domain.
distance (EIGRP)
To allow the use of two administrative distances—internal and external—that could provide a better route to a node, use the distance command in the appropriate configuration mode. To reset these values to their defaults, use the no form of this command.
distance internal-distance external-distance
no distance
Syntax Description
Defaults
internal-distance: 90
external-distance: 170Command Modes
IPv4 address family configuration
IPv6 address family configuration
IPv4 VRF address family configuration
IPv6 VRF address family configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
An administrative distance is a rating of the trustworthiness of a routing information source, such as an individual router or a group of routers. Numerically, an administrative distance is an integer from 0 to 255. In general, the higher the value, the lower the trust rating. An administrative distance of 255 means the routing information source cannot be trusted at all and should be ignored.
Use the distance command if another protocol is known to provide a better route to a node than was actually learned through the external Enhanced Interior Gateway Routing Protocol (EIGRP) or some internal routes should be preferred by EIGRP.
To display the default administrative distance for a specified routing process, use the show protocols EXEC command.
Task ID
Examples
The following example shows how to set the administrative distance of all EIGRP 1 internal routes (within vrf vpn-1) to 80 and all EIGRP external routes to 130:
RP/0/RP0/CPU0:router(config)# router eigrp 1RP/0/RP0/CPU0:router(config-eigrp)# vrf vrf1RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# distance 80 130Related Commands
Displays information about the Enhanced Interior Gateway Routing Protocol (EIGRP) running on the router.
hello-interval (EIGRP)
To configure the hello interval for an interface, use the hello-interval command in interface configuration mode. To restore the default value, use the no form of this command.
hello-interval seconds
no hello-interval
Syntax Description
Defaults
For low-speed, nonbroadcast multiaccess (NBMA) networks: 60 seconds
For all other networks: 5 secondsCommand Modes
Interface configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to set the hello interval to 0 to 10 seconds for the interface:
RP/0/RP0/CPU0:router(config)# router eigrp 1RP/0/RP0/CPU0:router(config-eigrp)# address-family ipv4RP/0/RP0/CPU0:router(config-eigrp)# router-id 10.1.1.1RP/0/RP0/CPU0:router(config-eigrp-af)# interface POS 0/1/0/0RP/0/RP0/CPU0:router(config-eigrp-af-if)# hello-interval 10hold-time (EIGRP)
To configure the hold time for an interface, use the hold-time command in interface configuration mode. To restore the default value, use the no form of this command.
hold-time seconds
no hold-time
Syntax Description
Defaults
Three times the default hello interval time of 15 seconds.
Command Modes
Interface configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
On very congested and large networks, the default hold time might not be sufficient time for all routers to receive hello packets from their neighbors. In this case, you may want to increase the hold time.
We recommend that the hold time be at least three times the hello interval. If a router does not receive a hello packet within the specified hold time, routes through this router are considered unavailable.
Increasing the hold time delays route convergence across the network.
To ensure nonstop forwarding during RP failovers, we recommend that the hold time be increased to 30 seconds.
Task ID
Examples
The following example shows how to set the hold time to 0 to 40 seconds for the interface:
RP/0/RP0/CPU0:router(config)# router eigrp 1RP/0/RP0/CPU0:router(config-eigrp)# address-family ipv4RP/0/RP0/CPU0:router(config-eigrp)# router-id 10.1.1.1RP/0/RP0/CPU0:router(config-eigrp-af)# interface POS 0/1/0/0RP/0/RP0/CPU0:router(config-eigrp-af-if)# hold-time 40Related Commands
bandwidth (interface)
Sets a bandwidth value for an interface.
Configures the hello interval for the EIGRP routing process designated by an autonomous system number.
interface (EIGRP)
To define the interfaces on which the Enhanced Interior Gateway Routing Protocol (EIGRP) routing protocol runs, use the interface command in the appropriate configuration mode. To disable EIGRP routing for interfaces, use the no form of this command.
interface type instance
no interface type instance
Syntax Description
Defaults
When you do not specify this command in configuration mode, EIGRP routing for interfaces is not enabled.
Command Modes
IPv4 address family configuration
IPv6 address family configuration
IPv4 VRF address family configuration
IPv6 VRF address family configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the interface command to associate a specific interface with an EIGRP process. The interface remains associated with the process even when the IPv4 address of the interface changes.
This command places the router in interface configuration mode, from which you can configure interface-specific settings. Commands configured under this mode (such as the hello-interval command) are automatically bound to that interface.
Task ID
Examples
The following example shows how to enter interface configuration mode for EIGRP process 1 and set the hello interval to 10 seconds for the Packet-over-SONET/SDH (POS) interface 0/1/0/0:
RP/0/RP0/CPU0:router(config)# router eigrp 1RP/0/RP0/CPU0:router(config-eigrp)# address-family ipv4RP/0/RP0/CPU0:router(config-eigrp)# router-id 10.1.1.1RP/0/RP0/CPU0:router(config-eigrp-af)# interface POS 0/1/0/0RP/0/RP0/CPU0:router(config-eigrp-af-if)# hello-interval 10log-neighbor-changes
To enable the logging of changes in Enhanced Interior Gateway Routing Protocol (EIGRP) neighbor adjacencies, use the log-neighbor-changes command in the appropriate configuration mode. To disable the logging of changes in EIGRP neighbor adjacencies, use the no form of this command.
log-neighbor-changes
no log-neighbor-changes
Syntax Description
This command has no arguments or keywords.
Defaults
Adjacency changes are not logged.
Command Modes
IPv4 address family configuration
IPv6 address family configuration
IPv4 VRF address family configuration
IPv6 VRF address family configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the log-neighbor-changes command to log neighbor adjacency changes, monitor the stability of the routing system, and help detect problems. Logging is disabled by default. To disable the logging of neighbor adjacency changes, use the no form of this command.
Task ID
Examples
The following example shows how to enable logging of neighbor changes for EIGRP 1:
RP/0/RP0/CPU0:router(config)# router eigrp 1RP/0/RP0/CPU0:router(config-eigrp)# address-family ipv6RP/0/RP0/CPU0:router(config-eigrp-af)# log-neighbor-changeslog-neighbor-warnings
To enable the logging of Enhanced Interior Gateway Routing Protocol (EIGRP) neighbor warning messages, use the log-neighbor-warnings command in the appropriate configuration mode. To disable the logging of EIGRP neighbor warning messages, use the no form of this command.
log-neighbor-warnings
no log-neighbor-warnings
Syntax Description
This command has no arguments or keywords.
Defaults
Neighbor warning messages are not logged.
Command Modes
IPv4 address family configuration
IPv6 address family configuration
IPv4 VRF address family configuration
IPv6 VRF address family configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the log-neighbor-warnings command to disable and enable neighbor warning messages. When neighbor warning messages occur, they are not logged by default.
Task ID
Examples
The following example shows how to configure log neighbor warning messages for EIGRP process 20:
RP/0/RP0/CPU0:router(config)# router eigrp 20RP/0/RP0/CPU0:router(config-eigrp) vrf vrf1RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# log-neighbor-warningsmaximum-paths (EIGRP)
To control the maximum number of parallel routes that the Enhanced Interior Gateway Routing Protocol (EIGRP) can support, use the maximum-paths command in the appropriate configuration mode. To remove the maximum-paths command from the configuration file and restore the system to its default condition with respect to the routing protocol, use the no form of this command.
maximum-paths maximum
no maximum- paths
Syntax Description
maximum
Maximum number of parallel routes that EIGRP can install in a routing table. Range is from 1 to 32 routes.
Defaults
maximum: 4
Command Modes
IPv4 address family configuration
IPv6 address family configuration
IPv4 VRF address family configuration
IPv6 VRF address family configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the maximum-paths command to allow the EIGRP protocol to install multiple paths into the routing table for each prefix. Multiple paths are installed for both internal and external routes that are learned in the same autonomous system and that are equal cost (according to the EIGRP best path algorithm).
For the Cisco CRS-1, the maximum path range is 1 to 32, and 1 to 16 for the Cisco XR 12000 Series Router.
Task ID
Examples
The following example shows how to allow a maximum of 10 paths to a destination:
RP/0/RP0/CPU0:router(config)# router eigrp 1RP/0/RP0/CPU0:router(config-eigrp) vrf vrf1RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# maximum-paths 10maximum-prefix (EIGRP)
To limit the number of prefixes that are accepted under a VRF address family by Enhanced Interior Gateway Routing Protocol (EIGRP), use the maximum-prefix command in IPv4 VRF address family configuration mode. To disable this function, use the no form of this command.
maximum-prefix maximum [threshold] [dampened] [reset-time minutes] [restart minutes] [restart-count number] [warning-only]
no maximum-prefix maximum [threshold] [dampened] [reset-time minutes] [restart minutes] [restart-count number] [warning-only]
Syntax Description
Defaults
threshold: 75 percent
dampened: False
reset-time: 15 minutes
restart: 5 minutes
Physical interface instance. Naming notation is rack/slot/module/port and a slash mark between values is required as part of the notation.
