To enter address-family configuration mode to configure an Enhanced Interior Gateway Routing Protocol (EIGRP) routing instance, use the
address-family (EIGRP) command in router configuration mode. To remove the address-family from the EIGRP configuration, use the
no form of this command.
Selects the IPV6 protocol address-family. IPv6 is supported only in EIGRP named configurations.
multicast
(Optional) Specifies the multicast address-family. This keyword is available only in EIGRP named IPv4 configurations.
unicast
(Optional) Specifies the unicast address-family.
autonomous-systemautonomous-system-number
(Optional) Specifies the autonomous system number. This keyword/argument pair is required for EIGRP named configurations.
vrfvrf-name
(Optional) Specifies the name of the VRF. This keyword/argument pair is required for EIGRP AS configurations.
Command Default
No EIGRP process is running.
Command Modes
Router configuration (config-router)
Command History
Release
Modification
12.0(22)S
This command was introduced.
12.2(15)T
This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(18)S
This command was integrated into Cisco IOS Release 12.2(18)S.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
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.
15.0(1)M
This command was modified. The
autonomous-system keyword is required for named configurations.
12.2(33)SRE
This command was modified. The
autonomous-system keyword is required for named configurations.
12.2(33)XNE
This command was modified. The
autonomous-system keyword is required for named configurations.
Cisco IOS XE Release 2.5
This command was modified. The
autonomous-system keyword is required for named configurations.
12.2(33)SXI4
This command was modified. The
autonomous-system keyword is required for named configurations.
Usage Guidelines
The
address-family (EIGRP) command is used to configure IPv4 or IPv6 address-family sessions under EIGRP. To leave address-family configuration mode without removing the address family configuration, use theexit-address-family command.
EIGRPAutonomous-SystemConfiguration
Use the
routereigrpnumber command to configure an EIGRP autonomous-system (AS) configuration.
In this configuration, EIGRP VPNs can be configured only under IPv4 address-family configuration mode. A virtual routing and forwarding instance (VRF) and route distinguisher must be defined before the address family session can be created.
It is recommended that you configure an autonomous-system number when the address-family is configured, either by entering theaddress-family command or the
autonomous-systemcommand.
EIGRPNamedConfiguration
Use the
routereigrpvirtual-name command to configure an EIGRP named configuration.
In this configuration, EIGRP VPNs can be configured in IPv4 and IPv6 named configurations. A virtual routing and forwarding instance (VRF) and a route distinguisher may or may not be used to create the address-family.
If a VRF is not used in creating the address-family, the EIGRP VPN instance assumes the default route distinguisher and will communicate with the default route distinguisher of other routers in the same network.
EIGRP VPNs can be configured under EIGRP named configurations. A virtual routing and forwarding instance (VRF) and route distinguisher must be defined before the address-family session can be created.
A single EIGRP routing process can support multiple VRFs. The number of VRFs that can be configured is limited only by available system resources on the router, which is determined by the number of VRFs, running processes, and available memory. However, only a single VRF can be supported by each VPN, and redistribution between different VRFs is not supported.
MPLS VPN support between PE and CE routers is configured only on PE routers that provide VPN services over the service provider backbone. The customer site does not require any changes to equipment or configurations to support the EIGRP VPN. A metric must be configured for routes to be advertised to the CE router. The metric can be configured using the
redistribute(IP) command or configured with the
default-metric (EIGRP) command.
Examples
The following example configures an IPv4 address-family session for the VRF named RED in Cisco IOS releases prior to Cisco IOS Release 15.0(1)M, 12.2(33)SRE, 12.2(33)XNE and Cisco IOS XE Release 2.5:
The following examples configure a single VRF named VRF-RED in Cisco IOS Release 15.0(1)M, 12.2(33)SRE, 12.2(33)XNE and Cisco IOS XE Release 2.5 and later releases:
The following example configures a non-VRF address-family in Cisco IOS Release 15.0(1)M, 12.2(33)SRE, 12.2(33)XNE and Cisco IOS XE Release 2.5, and later releases:
Configures the autonomous-system number for an EIGRP routing process to run within a VRF instance.
default-metric(EIGRP)
Sets metrics for EIGRP.
exit-address-family
Exits address-family configuration mode.
network(EIGRP)
Specifies a list of networks for the EIGRP routing process.
redistribute(IP)
Redistributes routes from one routing domain into another routing domain.
af-interface
To enter address-family interface configuration mode and to configure interface-specific Enhanced Interior Gateway Routing Protocol (EIGRP) commands, use the
af-interfacecommand in address-family configuration mode. To reset the address-family interface setting to factory values, use the
no form of this command.
no af-interface
{ default | interface-typeinterface -number }
Syntax Description
default
Specifies the default address-family interface configuration mode. Commands applied under this mode affect all interfaces used by this address-family instance.
interface-typeinterface-number
Interface type and number of the interface that the address-family submode commands will affect.
Command Default
Address-family interface configuration mode is not entered.
Command Modes
Address-family configuration (config-router-af)
Command History
Release
Modification
15.0(1)M
This command was introduced.
12.2(33)SRE
This command was integrated into Cisco IOS Release 12.2(33)SRE.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
Usage Guidelines
The
af-interfacedefault command is useful for defining user defaults to apply to EIGRP interfaces that belong to an address-family when EIGRP is configured using the named method. For example, authentication mode is disabled by default, and you can enable MD5 authentication for all EIGRP interfaces in the address-family using address-family interface configuration mode and then selectively override the new default setting using different address-family interface configuration commands.
Note
Use the
af-interfacedefault command with caution, because some default settings can be different depending on the interface type. For example, the default hello-interval is 5 seconds for most interfaces but is 60 seconds for slow NBMA interfaces, and changing the hello-interval in address-family interface configuration mode will affect all interfaces.
Examples
The following example shows how to enter address-family interface configuration mode and to configure EIGRP interface-specific commands:
Enters address-family configuration mode to configure an EIGRP routing instance.
exit-address-family
Exits address-family configuration mode.
authentication key-chain (EIGRP)
To specify an authentication key chain for Enhanced Interior Gateway Routing Protocol (EIGRP), use the authenticationkey-chain (EIGRP) command in address-family interface configuration mode or service-family interface configuration mode. To remove the authentication key-chain, use the no form of this command.
This command was integrated into Cisco IOS Release 12.2(33)SRE.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
12.2(33)SXI4
This command was integrated into Cisco IOS Release 12.2(33)SXI4.
Usage Guidelines
The key-chain command has no effect until the authenticationmodemd5command is configured.
Only one authentication key chain is applied to EIGRP at one time. That is, if you configure a second authenticationkey-chain command, the first is overridden.
Examples
The following example configures EIGRP to apply authentication to address-family autonomous system 1 and identifies a key chain named SITE1:
Specifies the type of authentication used in EIGRP address-family packets for the EIGRP instance.
keychain
Defines an authentication key chain needed to enable authentication for routing protocols.
routereigrp
Configures the EIGRP address-family process.
authentication mode (EIGRP)
To specify the type of authentication used in Enhanced Interior Gateway Routing Protocol (EIGRP) address-family or service-family packets for an EIGRP instance, use the
authenticationmode command in address family interface configuration mode or service family interface configuration mode. To disable a configured authentication type, use the
no form of this command.
Indicates that there is no password encryption. 0 is the default.
7
Indicates that there is an explicit password encryption.
password
Password string to be used with SHA authentication. The string can contain 1 to 32 characters including white spaces; however, the first character cannot be a number.
No authentication mode is provided for EIGRP packets.
Command Modes
Address family interface configuration (config-router-af-interface)
Service family interface configuration (config-router-sf-interface)
Command History
Release
Modification
15.0(1)M
This command was introduced.
12.2(33)SRE
This command was integrated into Cisco IOS Release 12.2(33)SRE.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
12.2(33)SXI4
This command was integrated into Cisco IOS Release 12.2(33)SXI4.
15.1(2)S
This command was modified. The
hmac-sha-256 keyword and the
encryption-type and
password arguments were added.
Cisco IOS XE Release 3.3S
This command was modified. The
hmac-sha-256 keyword and the
encryption-type and
password arguments were added.
15.2(1)T
This command was modified. The
hmac-sha-256 keyword and the
encryption-type and
password arguments were added.
15.1(1)SY
This command was integrated into Cisco IOS Release 15.1(1)SY.
Usage Guidelines
You can configure authentication to prevent unapproved sources from introducing unauthorized or false service messages.
When the
authenticationmode(EIGRP)command is used in conjunction with the
authenticationkey-chain command, an MD5 keyed digest is added to each EIGRP packet.
To configure basic HMAC-SHA-256 authentication, use the
authenticationmodehmac-sha-256 command on each interface of each router that should use authentication.
Examples
The following example shows how to configure the interface to use MD5 authentication in address-family packets:
Enters address family configuration mode to configure an EIGRP routing instance.
af-interface
Enters address family interface configuration mode to configure interface-specific EIGRP commands.
authenticationkey-chain
Specifies the type of authentication used in EIGRP address-family or service-family packets for the EIGRP instance.
keychain
Defines an authentication key chain needed to enable authentication for routing protocols.
routereigrp
Configures an EIGRP routing process.
autonomous-system (EIGRP)
To configure the autonomous-system number for an Enhanced Interior Gateway Routing Protocol (EIGRP) routing process to run within a VPN routing and forwarding (VRF) instance, use the autonomous-system command in address-family configuration mode. To remove the autonomous-system for an EIGRP routing process from within a VPN VRF instance, use the no form of this command.
autonomous-systemautonomous-system-number
noautonomous-systemautonomous-system-number
Syntax Description
autonomous-system-number
Autonomous system number of the EIGRP routing process.
Command Default
The autonomous-system number is not configured.
Command Modes
Address-family configuration (config-router-af)
Command History
Release
Modification
12.0(22)S
This command was introduced.
12.2(15)T
This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(18)S
This command was integrated into Cisco IOS Release 12.2(18)S.
12.2(27)SBC
The command was integrated into Cisco IOS Release 12.2(27)SBC.
15.0(1)M
This command was modified. This command can now be configured as a keyword of the address-family(EIGRP) command. This command can still be configured as a separate command in address-family configuration mode.
12.2(33)SRE
This command was modified. This command can now be configured as a keyword of the address-family(EIGRP) command. This command can still be configured as a separate command in address-family configuration mode.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
12.2(33)SXI4
The command was integrated into Cisco IOS Release 12.2(33)SXI4.
Usage Guidelines
This standalone autonomous-system command is not available in EIGRP named configurations. This command is present only in EIGRP autonomous-system (AS) configurations.
When configuring an EIGRP process, you must configure an autonomous-system value. You can configure an autonomous-system value using the standalone autonomous-system(EIGRP) command in address-family configuration mode or by configuring the address-familycommand in router configuration mode with the autonomous-system-number argument, or both.
Once configured, the standaloneautonomous-system command can optionally be removed, but only if the autonomous-systemargument is also configured on theaddress-family command.
Once configured, theautonomous-system-number argument on the address-family command cannot be removed without also removing the address-family itself.
Examples
The following example shows how to configure an EIGRP routing process within a VRF with the autonomous system configured by the autonomous-system command in address-family configuration mode:
The following example shows how to configure an EIGRP address family within a VRF with the autonomous system configured by the address-familyautonomous-system-number command in router configuration mode:
Enters address-family configuration mode to configure an EIGRP routing instance.
router eigrp
Configures the EIGRP address-family process.
auto-summary (EIGRP)
To allow automatic summarization of subnet routes into network-level routes, use the auto-summary command in router configuration mode or address-family topology configuration mode. Todisable this function and send subprefix routing information across classful network boundaries, use the no form of this command.
auto-summary
noauto-summary
Syntax Description
This command has no arguments or keywords.
Cisco IOS Release 15.0(1)M, 12.2(33)SRE, 12.2(33)XNE, Cisco IOS XE Release 2.5, Cisco IOS Release 12.2(33)SXI4 and Later Releases
The behavior of this command is enabled by default (the software does not send subprefix routing information across classful network boundaries).
The behavior of this command is disabled by default (the software sends subprefix routing information across classful network boundaries).
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.
15.0(1)M
This command was modified. Address-family topology configuration mode was added. The default behavior was changed to disabled.
12.2(33)SRE
This command was modified. Address-family topology configuration mode was added. The default behavior was changed to disabled.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
12.2(33)SXI4
This command was modified. Address-family topology configuration mode was added. The default behavior was changed to disabled.
Usage Guidelines
To allow the software to create summary subprefixes to the classful network boundary when crossing classful network boundaries, use the auto-summary command.
Enhanced Interior Gateway Routing Protocol (EIGRP) summary routes are given an administrative distance value of 5. You cannot configure this value.
Examples
The following example enables automatic summarization for EIGRP process 109:
Enters address-family configuration mode to configure an EIGRP routing instance.
ipsummary-addresseigrp
Configures a summary aggregate address for a specified interface.
routereigrp
Configures the EIGRP address-family process.
topology(EIGRP)
Configures an EIGRP process to route IP traffic under the specified topology instance and enters router address-family topology configuration mode.
bandwidth-percent
To configure the percentage of bandwidth that may be used by an Enhanced Interior Gateway Routing Protocol (EIGRP) address family or service family on an interface, use the bandwidth-percentcommand in address-family interface configuration mode or service-family interface configuration mode. To restore the default value, use the no form of this command.
bandwidth-percentmaximum-bandwidth-percentage
nobandwidth-percent
Syntax Description
maximum-bandwidth-percentage
Percent of configured bandwidth that EIGRP may use to send packets. Valid range is 1 to 999999. The default is 50 percent.
Command Default
EIGRP limits bandwidth usage to 50 percent of the configured interface bandwidth.
This command was integrated into Cisco IOS Release 12.2(33)SRE.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
12.2(33)SXI4
This command was integrated into Cisco IOS Release 12.2(33)SXI4.
Usage Guidelines
Use the bandwidth-percent command to configure a different percentage of bandwidth for use by EIGRP than specified for the link by using the bandwidthinterfacecommand. Values greater than 100 percent may be configured. This option might be useful if the link bandwidth is set artificially low for other reasons. The default bandwidth percent uses 50 percent of the configured bandwidth of the link.
Examples
The following example uses up to 75 percent (42 kbps) of a 56-kbps serial link for address-family autonomous system 4453:
Enters address-family configuration mode to configure an EIGRP routing instance.
af-interface
Enters address-family interface configuration mode to configure interface-specific EIGRP commands.
routereigrp
Configures the EIGRP address-family process.
service-family
Configures VRF metrics for an EIGRP service-family.
sf-interface
Configures interface-specific commands for an EIGRP service-family.
default-information
To accept exterior or default routing information into Enhanced Interior Gateway Routing Protocol (EIGRP) processes, use the default-information command in router configuration mode or address-family topology configuration mode. To suppress exterior or default routing information in inbound or outbound updates, use the noform of this command.
default-information
{ allowed
{ in | out } | in | out }
[ acl-number | acl-name ]
nodefault-information
{ allowed
{ in | out } | in | out }
Cisco IOS Release 15.0(1)M, 12.2(33)SRE, 12.2(33)XNE, Cisco IOS XE Release 2.5 and Later Releases
default-information
{ in | out }
[ acl-number | acl-name ]
nodefault-information
{ in | out }
[ acl-number | acl-name ]
Syntax Description
allowed
Configures EIGRP to accept default routing information.
in
Configures EIGRP to accept exterior or default routing information.
out
Configures EIGRP to advertise external routing information.
acl-number
(Optional) Standard access list number from 1 to 99 or an expanded standard access list from 1300 to 1999.
acl-name
(Optional) Named standard access list.
Command Default
Exterior routes are always accepted and default information is passed between EIGRP processes when redistribution occurs.
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.
15.0(1)M
This command was modified. Address-family topology configuration mode was added. The allowed keyword was removed.
12.2(33)SRE
This command was modified. Address-family topology configuration mode was added. The allowed keyword was removed.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
Usage Guidelines
The default network of 0.0.0.0 used by Routing Information Protocol (RIP) can be redistributed by EIGRP.
Examples
The following example allows exterior or default routes to be received by the EIGRP process in autonomous system 23:
Router(config)#router eigrp 23
Router(config-router)# default-information in
The following example allows EIGRP exterior or default routes to be received by the EIGRP process in autonomous system 4473 in Cisco IOS Release 15.0(1)M, 12.2(33)SRE, 12.2(33)XNE, Cisco IOS XE Release 2.5 and later releases:
Router(config)# router eigrp virtual-name
Router(config-router)# address-family ipv4 autonomous-system 4473
Router(config-router-af)#topology base
Router(config-router-af-topology)# default-information in
Related Commands
Command
Description
address-family(EIGRP)
Enters address-family configuration mode to configure an EIGRP routing instance.
routereigrp
Configures the EIGRP address-family process.
topology(EIGRP)
Configures an EIGRP process to route IP traffic under the specified topology instance and enters router address-family topology configuration mode.
default-metric (EIGRP)
To set metrics for Enhanced Interior Gateway Routing Protocol (EIGRP), use the default-metric command in router configuration mode or address-family topology configuration mode. To remove the metric value and restore the default state
, use the no form of this command.
Minimum bandwidth of the route in kilobytes per second. It can be from 1 to 4294967295.
delay
Route delay in tens of microseconds. It can be 1 or any positive number that is a multiple of 39.1 nanoseconds.
reliability
Likelihood of successful packet transmission expressed as a number from 0 through 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
The smallest allowed value for the maximum transmission unit (MTU), expressed in bytes. It can be from 1 to 65535.
Command Default
Only connected routes can be redistributed without a default metric. The metric of redistributed connected routes is set to 0.
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB.
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.
15.0(1)M
This command was modified. Address-family topology configuration mode was added. This command must be entered in address-family topology configuration mode when EIGRP is configured with a named router configuration.
12.2(33)SRE
This command was modified. Address-family topology configuration mode was added. This command must be entered in address-family topology configuration mode when EIGRP is configured with a named router configuration.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
Usage Guidelines
You must use a default metric to redistribute a protocol into EIGRP, unless you use the redistributecommand.
Metric defaults have been carefully set to work for a wide variety of networks. Take great care when changing these values.
Default metrics are supported only when you are redistributing from EIGRP or static routes.
Examples
The following example shows how the redistributed Routing Information Protocol (RIP) metrics are translated into EIGRP metrics with values as follows: bandwidth = 1000, delay = 100, reliability = 250, loading = 100, and MTU = 1500:
The following example shows how the redistributed EIGRP service family 6473 metrics are translated into EIGRP metric with values as follows: bandwidth = 1000, delay = 100, reliability = 250, loading = 100, and MTU = 1500.
Enters address-family configuration mode to configure an EIGRP routing instance.
af-interface
Enters address-family interface configuration mode to configure interface-specific EIGRP commands.
ipv6routereigrp
Configures the EIGRP
IPv6
routing process.
redistribute(IP)
Redistributes routes from one routing domain into another routing domain.
redistribute(IPv6)
Redistributes IPv6 routes from one routing domain into another routing domain.
router eigrp
Configures the EIGRP address-family process.
topology (EIGRP)
Configures an EIGRP process to route IP traffic under the specified topology instance and enters router address-family topology configuration mode.
distance (IPv6 EIGRP)
To allow the use of two administrative distances--internal and external--that could be a better route to a node, use the
distancecommand in router configuration mode. To reset these values to their defaults, use the
no form of this command.
distanceinternal-distanceexternal-distance
nodistance
Syntax Description
internal-distance
Administrative distance for Enhanced Internal Gateway Routing Protocol (EIGRP) for IPv6 internal routes. Internal routes are those that are learned from another entity within the same autonomous system. The distance can be a value from 1 to 255.
external-distance
Administrative distance for EIGRP for IPv6 external routes. External routes are those for which the best path is learned from a neighbor external to the autonomous system. The distance can be a value from 1 to 255.
Command Default
internal-distance: 90external-distance: 170
Command Modes
Router configuration
Command History
Release
Modification
12.4(6)T
This command was introduced.
12.2(33)SRB
This command was integrated into Cisco IOS Release 12.2(33)SRB.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
Usage Guidelines
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
distancecommand if another protocol is known to be able to provide a better route to a node than was actually learned via external EIGRP for IPv6, or if some internal routes should be preferred by EIGRP for IPv6.
The table below lists the default administrative distances.
Table 1 Default Administrative Distances
Route Source
Default Distance
Connected interface
0
Static route
1
EIGRP summary route
5
External Border Gateway Protocol (BGP)
20
Internal EIGRP
90
Open Shortest Path First (OSPF)
110
Intermediate System-to-Intermediate System (IS-IS)
115
Routing Information Protocol (RIP)
120
Exterior Gateway Protocol (EGP)
140
EIGRP external route
170
Internal BGP
200
Unknown
255
Examples
The following example sets the internal distance to 95 and the external distance to 165:
distance 95 165
eigrp event-log-size
To set the size of the Enhanced Interior Gateway Routing Protocol (EIGRP) event log, use the eigrpevent-log-size command in router configuration mode or address-family topology configuration mode. To reset the size of the EIGRP event log to its default value, use the no form of this command.
eigrpevent-log-sizesize
noeigrpevent-log-size
Syntax Description
size
Size of the EIGRP event log; valid values are from 0 to half of the available memory on the system at the time of configuration. Default value is 500.
This command was introduced in Cisco IOS Release 12.2(18)SXF.
15.0(1)M
This command was modified. Address-family topology configuration mode was added.
12.2(33)SRE
This command was integrated into Cisco IOS Release 12.2(33)SRE.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
Usage Guidelines
When the configured size (number of lines) of the event log is exceeded, the last configured number of lines is retained, and the log becomes a rolling number of events with the most recent at the top of the log.
Examples
The following example shows how to set the size of the EIGRP event log to 5000010:
To enable the logging of changes in Enhanced Interior Gateway Routing Protocol (EIGRP) neighbor adjacencies, use the eigrplog-neighbor-changes command in router configuration mode, address-family configuration mode, or service-family configuration mode. To disable the logging of changes in EIGRP neighbor adjacencies, use the noform of thiscommand.
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.
15.0(1)M
This command was modified. Address-family configuration mode and service-family configuration mode were added.
12.2(33)SRE
This command was modified. Address-family configuration mode and service-family configuration mode were added.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
Usage Guidelines
This command enables the logging of neighbor adjacency changes to monitor the stability of the routing system and to help detect problems. Logging is enabled by default. To disable the logging of neighbor adjacency changes, use the no form of this command.
To enable the logging of changes for EIGRP address-family neighbor adjacencies, use the eigrplog-neighbor-changescommand in address-family configuration mode.
To enable the logging of changes for EIGRP service-family neighbor adjacencies, use theeigrplog-neighbor-changescommand in service-family configuration mode.
Examples
The following configuration disables logging of neighbor changes for EIGRP process 209:
Router(config)# router eigrp 209
Router(config-router)# no eigrp log-neighbor-changes
The following configuration enables logging of neighbor changes for EIGRP process 209:
Enters address-family configuration mode to configure an EIGRP routing instance.
exit-address-family
Exits address-family configuration mode.
exit-service-family
Exits service-family configuration mode.
routereigrp
Configures the EIGRP routing process.
service-family
Specifies service-family configuration mode.
eigrp log-neighbor-warnings
To enable the logging of Enhanced Interior Gateway Routing Protocol (EIGRP) neighbor warning messages, use the eigrplog-neighbor-warnings command in router configuration mode, address-family configuration mode, or service-family configuration mode. To disable the logging of EIGRP neighbor warning messages, use the noform of thiscommand.
eigrplog-neighbor-warnings [seconds]
noeigrplog-neighbor-warnings
Syntax Description
seconds
(Optional) The time interval (in seconds) between repeated neighbor warning messages. The range is from 1 to 65535. The default is 10.
Command Default
Neighbor warning messages are logged at 10-second intervals.
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.
15.0(1)M
This command was modified. Address-family and service-family configuration modes were added.
12.2(33)SRE
This command was modified. Address-family and service-family configuration modes were added.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
Usage Guidelines
When neighbor warning messages occur, they are logged by default. With this command, you can disable and enable neighbor warning messages, and you can configure the interval between repeated neighbor warning messages.
To enable the logging of warning messages for an EIGRP address family, use the eigrplog-neighbor-warnings command in address-family configuration mode.
To enable the logging of warning messages for an EIGRP service family, use theeigrplog-neighbor-warnings command in service-family configuration mode.
Examples
The following command will log neighbor warning messages for EIGRP process 209 and repeat the warning messages in 5-minute (300 seconds) intervals:
The following example logs neighbor warning messages for the service family with autonomous system number 4453 and repeats the warning messages in five-minute (300 second) intervals:
The following example logs neighbor warning messages for the address family with autonomous system number 4453 and repeats the warning messages in five-minute (300 second) intervals:
Enters address-family configuration mode to configure an EIGRP routing instance.
exit-address-family
Exits address-family configuration mode.
exit-service-family
Exits service-family configuration mode.
routereigrp
Configures the EIGRP routing process.
service-family
Specifies service-family configuration mode.
eigrp router-id
To set the router ID used by Enhanced Interior Gateway Routing Protocol (EIGRP) when communicating with its neighbors, use the eigrprouter-idcommand in router configuration mode, address-family configuration mode, or service-family configuration mode. To remove the configured router ID, use the noform of thiscommand.
eigrprouter-idrouter-id
noeigrprouter-id [router-id]
Syntax Description
router-id
EIGRP router ID in IP address format.
Command Default
EIGRP automatically selects an IP address to use as the router ID when an EIGRP process is started. The highest local IP address is selected and loopback interfaces are preferred. The router ID is not changed unless the EIGRP process is removed with the noroutereigrp command or if the router ID is manually configured with the eigrprouter-id command.
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.
15.0(1)M
This command was modified. Address-family configuration mode and service-family configuration mode were added.
12.2(33)SRE
This command was modified. Address-family configuration mode and service-family configuration mode were added.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
Usage Guidelines
The router ID is used to identify the originating router for external routes. If an external route is received with the local router ID, the route is discarded. The router ID can be configured with any IP address with two exceptions; 0.0.0.0 and 255.255.255.255 are not legal values and cannot be entered. A unique value should be configured for each router.
In EIGRP named IPv4, named IPv6, and Cisco Service Advertisement Framework (SAF) configurations, the router-id is also included for identifying internal routes and loop detection.
Examples
The following example configures 172.16.1.3 as a fixed router ID:
Enters address-family configuration mode to configure an EIGRP routing instance.
routereigrp
Configures the EIGRP routing process.
service-family
Specifies service-family configuration mode.
eigrp stub
To configure a router as a stub using the Enhanced Interior Gateway Routing Protocol (EIGRP), use the
eigrpstub command in address family configuration mode or router configuration mode. To disable the EIGRP stub routing feature, use the
no form of this command.
(Optional) Sets the router as a receive-only neighbor.
leak-mapname
(Optional) Allows dynamic prefixes based on a leak map.
connected
(Optional) Advertises connected routes.
static
(Optional) Advertises static routes.
summary
(Optional) Advertises summary routes.
redistributed
(Optional) Advertises redistributed routes from other protocols and autonomous systems.
Command Default
Stub routing is not enabled by default.
Command Modes
Address-family configuration (config-router-af)
Router configuration (config-router)
Command History
Release
Modification
12.0(7)T
This command was introduced.
12.0(15)S
This command was integrated into Cisco IOS Release 12.0(15)S.
12.2
This command was modified. The
redistributed keyword was added.
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.
15.0(1)M
This command was modified. Address family configuration mode was added to support EIGRP named configurations. The
leak-map keyword and
name argument were added.
12.2(33)SRE
This command was modified. Address family configuration mode was added to support EIGRP named configurations. The
leak-map keyword and
name argument were added.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
12.2(33)SXI4
This command was modified. Address family configuration mode was added to support EIGRP named configurations. The
leak-map keyword and
name argument were added.
Usage Guidelines
Use the
eigrpstub command to configure a router as a stub; this will allow the router to direct all IP traffic to a distribution router, unless stub leaking is configured on the router.
The
receive-only keyword will restrict the router from sharing any of its routes with any other router in the EIGRP autonomous system, and the
receive-only keyword will not permit any other option to be specified because it prevents any type of route from being advertised. The
connected,
static,
summary,
leak-map, and
redistributed keywords can be used in any combination but cannot be used with the
receive-only keyword. If any of these five keywords is used with the
eigrpstub command, only route types specified by the particular keywords will be advertised. Route types specified by the remaining keywords will not be advertised.
The
connected keyword permits the EIGRP stub routing feature to send connected routes. If the connected routes are not covered by a network statement, they may be redistributed using the
redistributeconnected command under the EIGRP process. This option is enabled by default.
The
static keyword permits the EIGRP stub routing feature to advertise static routes. If this option is not configured, EIGRP will not send any static routes, including internal static routes that normally would be automatically redistributed. It will still be necessary to redistribute static routes with the
redistributestatic command.
The
summary keyword permits the EIGRP stub routing feature to advertise summary routes. Summary routes can be created manually using the
summary-address command or automatically at a major network border router using the
auto-summary command. This option is enabled by default.
The
redistributed keyword permits the EIGRP stub routing feature to advertise other routing protocols and autonomous systems. If this option is not configured, EIGRP will not advertise redistributed routes.
The
leak-map keyword permits the EIGRP stub routing feature to reference a leak map that identifies routes that are allowed to be advertised on an EIGRP stub router that would normally have been suppressed.
Examples
In the following example, the
eigrpstub command is used to configure the router as a stub that advertises connected and summary routes:
In the following named configuration example, the
eigrpstub command is used to configure the router as a stub that advertises routes learned from a directly connected client:
In the following example, the
eigrpstub command is issued with the
connected and
static keywords to configure the router as a stub that advertises connected and static routes (sending summary routes will not be permitted):
In the following named configuration example, the
eigrpstub command is issued with the
connected and
static keywords to configure the router as a stub that advertises connected and static routes (sending summary routes will not be permitted):
In the following example, the
eigrpstub command is issued with the
receive-only keyword to configure the router as a receive-only neighbor (connected, summary, and static routes will not be sent):
In the following named configuration example, the
eigrpstub command is issued with the
receive-only keyword to configure the router as a receive-only neighbor (connected, summary, and static routes will not be sent):
In the following example, the
eigrpstub command is issued with the
redistributed keyword to configure the router to advertise other protocols and autonomous systems:
In the following named configuration example, the
eigrpstub command is issued with the
redistributed keyword to configure the router to advertise other protocols and autonomous systems:
In the following example, the
eigrpstub command is issued with the
leak-mapname keyword-argument pair to configure the router to reference a leak map that identifies routes that would normally have been suppressed:
In the following named configuration example, the
eigrpstub command is issued with the
leak-mapname keyword-argument pair to configure the router to reference a leak map that identifies routes that would normally have been suppressed:
Enters address-family configuration mode to configure an EIGRP routing instance.
af-interface
Enters address-family interface configuration mode to configure interface-specific EIGRP commands.
routereigrp
Configures the EIGRP address-family process.
hello-interval
To configure the hello interval for the Enhanced Interior Gateway Routing Protocol (EIGRP) address-family or service-family configurations, use the hello-interval command in address-family interface configuration mode or service-family interface configuration mode. To configure the default hello interval, use the no form of this command.
hello-intervalseconds
nohello-interval
Syntax Description
seconds
Hello interval in seconds. The range is 1 to 65535. The default is 60 for low-speed nonbroadcast multiaccess (NBMA) networks, and 5 for all other networks.
Command Default
The EIGRP hello interval is 60 seconds for low-speed NBMA networks and 5 seconds for all other networks.
This command was integrated into Cisco IOS Release 12.2(33)SRE.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
12.2(33)SXI4
This command was integrated into Cisco IOS Release 12.2(33)SXI4.
Usage Guidelines
The 60-second default applies only to low-speed, NBMA media. Low speed is considered a rate of T1 or slower, as specified by the bandwidth command in interface configuration mode.
For the purposes of EIGRP, Frame Relay and Switched Multimegabit Data Service (SMDS) networks are considered to be NBMA if the interface has not been configured to use physical multicasting. Otherwise, Frame Relay and SMDS networks are not considered to be NBMA.
Examples
The following example configures a 10-second hello interval for address-family Ethernet interface 0/0:
Enters address-family configuration mode to configure an EIGRP routing instance.
af-interface
Enters address-family interface configuration mode to configure interface-specific EIGRP commands.
hold-time
Configures the hold time for EIGRP address-family or service-family configurations.
routereigrp
Configures the EIGRP address-family process.
service-family
Specifies service-family configuration mode.
sf-interface
Configures interface-specific commands under a service family.
hold-time
To configure the hold time for Enhanced Interior Gateway Routing Protocol (EIGRP) address-family or service-family configurations, use the hold-time command in address-family interface configuration mode or service-family interface configuration mode. To configure the default hold time, use the no form of this command.
hold-timeseconds
nohold-time
Syntax Description
seconds
Interval, in seconds, before a neighbor is considered down. Valid range is 1 to 65535 seconds (approximately 18 hours). The default is 180 seconds for low-speed nonbroadcast multiaccess (NBMA) networks and 15 seconds for all other networks.
Command Default
The EIGRP hold time is 180 seconds for NBMA networks and 15 seconds for all other networks.
This command was integrated into Cisco IOS Release 12.2(33)SRE.
12.2(33)XNE
This command was integrated into Cisco IOS Release 12.2(33)XNE.
Cisco IOS XE Release 2.5
This command was integrated into Cisco IOS XE Release 2.5.
12.2(33)SXI4
This command was integrated into Cisco IOS Release 12.2(33)SXI4.
Usage Guidelines
On very congested and large networks, the default hold time may not be sufficient for all routers and access servers to receive hello packets from neighbors. In this case, increase the hold time duration. The hold time should be at least three times the hello interval. If a router does not receive a hello packet within the specified hold time, services through this router are considered unavailable. Increasing the hold time will delay route convergence across the network.
Examples
The following example sets a 50-second hold time for address-family Ethernet interface 0/0: