Table Of Contents
EIGRP Commands on Cisco IOS XR Software
address-family (EIGRP)
auto-summary (EIGRP)
autonomous-system
bandwidth-percent (EIGRP)
clear eigrp neighbors
clear eigrp topology
default-information
default-metric (EIGRP)
distance (EIGRP)
hello-interval (EIGRP)
hold-time (EIGRP)
interface (EIGRP)
log-neighbor-changes
log-neighbor-warnings
maximum-paths (EIGRP)
maximum-prefix (EIGRP)
metric maximum-hops
metric weights
neighbor (EIGRP)
neighbor maximum-prefix
next-hop-self disable
passive-interface (EIGRP)
redistribute (EIGRP)
redistribute maximum-prefix
route-policy (EIGRP)
router eigrp
router-id (EIGRP)
show eigrp accounting
show eigrp interfaces
show eigrp neighbors
show eigrp topology
show eigrp traffic
show protocols (EIGRP)
site-of-origin (EIGRP)
split-horizon disable (EIGRP)
stub (EIGRP)
summary-address (EIGRP)
timers active-time
timers nsf route-hold (EIGRP)
variance
vrf (EIGRP)
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 configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
The ipv6 keyword was added.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
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 1
RP/0/RP0/CPU0:router(config-eigrp)# vrf vrf1
RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4
RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# default-metric 1000 100 255 1 1500
RP/0/RP0/CPU0:router(config-eigrp-vrf-af)#
Related Commands
Command
|
Description
|
autonomous-system
|
Configures an EIGRP routing process to run within a VRF.
|
maximum-prefix (EIGRP)
|
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 configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
No modification.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
Examples
The following example shows how to enable automatic summarization for EIGRP 1:
RP/0/RP0/CPU0:router(config)# router eigrp 1
RP/0/RP0/CPU0:router(config-eigrp)# vrf vpn-1
RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4
RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# auto-summary
Related 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
as-number
|
Autonomous system number of the EIGRP routing process. Range is from 1 to 65535.
|
Defaults
No default behavior or values
Command Modes
IPv4 VRF address family configuration
IPv6 VRF address family configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
This command was supported in IPv6 VRF address family configuration mode.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
Examples
The following example shows how to configure autonomous system 101 under VRF VPN-1:
RP/0/RP0/CPU0:router(config)# router eigrp 1
RP/0/RP0/CPU0:router(config-eigrp)# vrf vpn-1
RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4
RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# autonomous-system 101
Related Commands
Command
|
Description
|
vrf (EIGRP)
|
Defines a VRF instance and to enters VRF configuration mode.
|
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
percent
|
Percentage of bandwidth that EIGRP may use.
|
Defaults
percent: 50
Command Modes
Interface configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
No modification.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
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 1
RP/0/RP0/CPU0:router(config-eigrp)# address-family ipv4
RP/0/RP0/CPU0:router(config-eigrp-af)# router-id 10.1.1.1
RP/0/RP0/CPU0:router(config-eigrp-af)# interface POS 0/1/0/0
RP/0/RP0/CPU0:router(config-eigrp-af-if)# bandwidth-percent 75
Related Commands
Command
|
Description
|
bandwidth (interface)
|
Sets a bandwidth value for an interface.
|
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]
Syntax Description
as-number
|
(Optional) Autonomous system number. Range is from 1 to 65535.
|
vrf {vrf | all}
|
(Optional) Specifies a particular VPN routing and forwarding instance (VRF) or all VRF instances.
|
ipv4
|
(Optional) Specifies the IPv4 address family.
|
ipv6
|
(Optional) Specifies the IPv6 address family.
|
ip-address
|
(Optional) Address of the neighbor.
|
interface-type
|
(Optional) Interface type. For more information, use the question mark (?) online help function.
|
interface-instance
|
(Optional) Either a physical interface instance or a virtual interface instance.
Specifying these arguments removes the specified interface type from the neighbor table that all entries learned via this interface.
• Physical interface instance. Naming notation is rack/slot/module/port and a slash mark between values is required as part of the notation.
– rack: Chassis number of the rack.
– slot: Physical slot number of the line card.
– module: Module number. A physical layer interface module (PLIM) is always 0.
– port: Physical port number of the interface.
• Virtual interface instance. Number range varies depending on interface type.
For more information about the syntax for the router, use the question mark (?) online help function.
|
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
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
The ipv4 and ipv6 keywords were added.
The as-number and vrf argument and keyword were changed from required to optional.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
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/0
Related Commands
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
as-number
|
(Optional) Autonomous system number. Range is from 1 to 65535.
|
vrf {vrf | all}
|
(Optional) Specifies a particular VPN routing and forwarding instance (VRF) or all VRF instances.
|
ipv4
|
(Optional) Specifies the IPv4 address family.
|
ipv6
|
(Optional) Specifies the IPv6 address family.
|
prefix
|
IP prefix, which limits output to a specific route.
|
mask
|
IP address mask.
|
/length
|
Prefix length, which can be indicated as a slash (/) and number. For example, /8 indicates that the first eight bits in the IP prefix are network bits. If length is used, the slash is required.
|
Defaults
No EIGRP topology entries are cleared.
Command Modes
EXEC
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
The ipv4 and ipv6 keywords were added.
The as-number and vrf argument and keyword were changed from required to optional.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
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/8
Related 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
allowed
|
Specifies EIGRP to allow default routing information.
|
in
|
Specifies EIGRP to allow inbound default routing information.
|
out
|
Specifies EIGRP to allow outbound default routing information.
|
route-policy name
|
(Optional) Specifies a route policy.
|
Defaults
Default routing information is not accepted or flagged.
Command Modes
Address family configuration
IPv4 VRF address family configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
No modification.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
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 1
RP/0/RP0/CPU0:router(config-eigrp)# vrf vrf1
RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4
RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# default-information accept in route-policy acme
default-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
bandwidth
|
Minimum bandwidth of the route in kilobits per second. Range is 1 to 4294967295.
|
delay
|
Route delay in tens of microseconds. Delay is 1 or any positive number that is a multiple of 39.1 nanoseconds. Range is 1 to 4294967295.
|
reliability
|
Likelihood of successful packet transmission expressed as a number between 0 and 255. The value 255 means 100-percent reliability; 0 means no reliability.
|
loading
|
Effective bandwidth of the route expressed as a number from 1 to 255 (255 is 100-percent loading).
|
mtu
|
Minimum maximum transmission unit (MTU) size of the route in bytes. Range is from 1 to 65535.
|
Defaults
No default values
Command Modes
IPv4 address family configuration
IPv6 address family configuration
IPv4 VRF address family configuration
IPv6 VRF address family configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
This command was supported in IPv6 address family configuration mode and IPv6 VRF address family configuration mode.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
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 1
RP/0/RP0/CPU0:router(config-eigrp)# vrf vrf1
RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4
RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# redistribute rip
RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# default-metric 1000 100 250 100 1500
Related Commands
Command
|
Description
|
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
internal-distance
|
Administrative distance for EIGRP internal routes. Internal routes are those that are learned from another entity within the same autonomous system (AS). The distance can be a value from 1 to 255.
|
external-distance
|
Administrative distance for EIGRP external routes. External routes are those for which the best path is learned from a source external to the AS. The distance can be a value from 1 to 255.
|
Defaults
internal-distance: 90
external-distance: 170
Command Modes
IPv4 address family configuration
IPv6 address family configuration
IPv4 VRF address family configuration
IPv6 VRF address family configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
This command was supported in IPv6 address family configuration mode and IPv6 VRF address family configuration mode.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
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 1
RP/0/RP0/CPU0:router(config-eigrp)# vrf vrf1
RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4
RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# distance 80 130
Related Commands
Command
|
Description
|
show protocols (EIGRP)
|
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
seconds
|
Hello interval (in seconds). Range is from 1 to 65535.
|
Defaults
For low-speed, nonbroadcast multiaccess (NBMA) networks: 60 seconds
For all other networks: 5 seconds
Command Modes
Interface configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
No modification.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
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 1
RP/0/RP0/CPU0:router(config-eigrp)# address-family ipv4
RP/0/RP0/CPU0:router(config-eigrp)# router-id 10.1.1.1
RP/0/RP0/CPU0:router(config-eigrp-af)# interface POS 0/1/0/0
RP/0/RP0/CPU0:router(config-eigrp-af-if)# hello-interval 10
hold-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
seconds
|
Hold time (in seconds). Range is from 1 to 65535.
|
Defaults
Three times the default hello interval time of 15 seconds.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
No modification.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
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 1
RP/0/RP0/CPU0:router(config-eigrp)# address-family ipv4
RP/0/RP0/CPU0:router(config-eigrp)# router-id 10.1.1.1
RP/0/RP0/CPU0:router(config-eigrp-af)# interface POS 0/1/0/0
RP/0/RP0/CPU0:router(config-eigrp-af-if)# hold-time 40
Related Commands
Command
|
Description
|
bandwidth (interface)
|
Sets a bandwidth value for an interface.
|
hello-interval (EIGRP)
|
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
type
|
Interface type. For more information, use the question mark (?) online help function.
|
instance
|
Either a physical interface instance or a virtual interface instance:
• Physical interface instance. Naming notation is rack/slot/module/port and a slash mark between values is required as part of the notation.
– rack: Chassis number of the rack.
– slot: Physical slot number of the line card.
– module: Module number. A physical layer interface module (PLIM) is always 0.
– port: Physical port number of the interface.
• Virtual interface instance. Number range varies depending on interface type.
For more information about the syntax for the router, use the question mark (?) online help function.
|
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 configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
This command was supported in IPv6 address family configuration mode and IPv6 VRF address family configuration mode.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
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 1
RP/0/RP0/CPU0:router(config-eigrp)# address-family ipv4
RP/0/RP0/CPU0:router(config-eigrp)# router-id 10.1.1.1
RP/0/RP0/CPU0:router(config-eigrp-af)# interface POS 0/1/0/0
RP/0/RP0/CPU0:router(config-eigrp-af-if)# hello-interval 10
log-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 configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
This command was supported in IPv6 address family configuration mode and IPv6 VRF address family configuration mode.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
Examples
The following example shows how to enable logging of neighbor changes for EIGRP 1:
RP/0/RP0/CPU0:router(config)# router eigrp 1
RP/0/RP0/CPU0:router(config-eigrp)# address-family ipv6
RP/0/RP0/CPU0:router(config-eigrp-af)# log-neighbor-changes
log-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 configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
This command was supported in IPv6 address family configuration mode and IPv6 VRF address family configuration mode.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
Examples
The following example shows how to configure log neighbor warning messages for EIGRP process 20:
RP/0/RP0/CPU0:router(config)# router eigrp 20
RP/0/RP0/CPU0:router(config-eigrp) vrf vrf1
RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4
RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# log-neighbor-warnings
maximum-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 configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
This command was supported in IPv6 address family configuration mode and IPv6 VRF address family configuration mode.
|
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
Task ID
|
Operations
|
eigrp
|
read, write
|
Examples
The following example shows how to allow a maximum of 10 paths to a destination:
RP/0/RP0/CPU0:router(config)# router eigrp 1
RP/0/RP0/CPU0:router(config-eigrp) vrf vrf1
RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4
RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# maximum-paths 10
maximum-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
maximum
|
Maximum number of prefixes allowed under an address family. Range is from 1 to 4294967295.
Note The number of prefixes that can be configured is limited only by the available system resources on the router.
|
threshold
|
(Optional) Syslog warning messages are specified as a percentage of the maximum prefix limit that was exceeded. The prefix percentage number range is from 1 to 100. The default is 75 percent.
|
dampened
|
(Optional) A decay penalty is applied to the restart time period each time the maximum prefix limit is exceeded. The half-life for the decay penalty is 150% of the default or user-defined restart time value in minutes. This keyword is disabled by default.
|
reset-time minutes
|
(Optional) The restart count is reset to 0 after the default or user-defined reset time period has expired. The range of values that can be applied with the minutes argument is from 1 to 65535 minutes. The default reset-time period is 15 minutes.
|
restart minutes
|
(Optional) A time period when router adjacencies are not formed or when redistributed routes are not accepted from the RIB after the maximum prefix limit has been exceeded. The value for the minutes argument is from 1 to 65535 minutes. The default restart time period is 5 minutes.
|
restart-count number
|
(Optional) Number of times a peering session is automatically reestablished after the peering session is torn down or after the redistribute route is cleared and relearned when the maximum prefix exceeds limits. The default restart count limit is 3.
Caution  Once the restart count threshold is crossed, you need to use the clear route or clear eigrp neighbors command to reestablish normal peering and/or redistribution.
|
warning-only
|
(Optional) Configures the router to generate syslog messages only when the maximum prefix limit is reached, instead of terminating the peering session.
|
Defaults
threshold: 75 percent
dampened: False
reset-time: 15 minutes
restart: 5 minutes
restart-count: 3
warning-only: False
Command Modes
IPv4 VRF address family configuration
IPv6 VRF address family configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
No modification.
|
Release 3.5.0
|
This command was supported in IPv6 VRF address family configuration mode.
|
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-prefix command to limit the number of prefixes that are accepted from all sources. When the maximum prefix limit is exceeded, sessions with remote peers are torn down, all routes learned from remote peers and through redistribution are removed from the topology and routing tables, and redistribution and peering are suspended for the default or user-defined time period.
Task ID
Task ID
|
Operations
|
eigrp
|
read, write
|
Examples
The following example shows how to configure the maximum prefix limit for an EIGRP process, which includes routes learned through redistribution and routes learned through EIGRP peering sessions. The maximum limit is set to 50,000 prefixes. When the number of prefixes learned through redistribution reaches 37,500 (75 percent of 50,000), warning messages are displayed in the console. When the maximum prefix limit is exceeded, all peering sessions are reset, the topology and routing tables are cleared and redistributed routes and all peering sessions are placed in a penalty state.
RP/0/RP0/CPU0:router(config)# router eigrp 1
RP/0/RP0/CPU0:router(config-eigrp)# vrf vrf1
RP/0/RP0/CPU0:router(config-eigrp-vrf)# address-family ipv4
RP/0/RP0/CPU0:router(config-eigrp-vrf-af)# maximum-prefix 50000
Related Commands
Command
|
Description
|
clear eigrp neighbors
|
Deletes EIGRP VPN neighbor entries from the table.
|
clear route
|
Deletes routes from the IP routing table.
|
metric maximum-hops
To advertise as unreachable those Enhanced Interior Gateway Routing Protocol (EIGRP) routes with a hop count higher than is specified by the command, use the metric maximum-hops command in the appropriate configuration mode. To reset the value to the default, use the no form of this command.
metric maximum-hops {hops-number}
no metric maximum-hops
Syntax Description
hops-number
|
Maximum hop count. Range is from 1 to 255 hops.
|
Defaults
hops-number: 100
Command Modes
IPv4 address family configuration
IPv6 address family configuration
IPv4 VRF address family configuration
IPv6 VRF address family configuration
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
|
Release 3.4.0
|
The maximum hop count range was changed from 0 through 255 to 1 through 255.
|
Release 3.5.0
|
This command was supported in IPv6 address family configuration mode and IPv6 VRF address family configuration mode.
|