The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter describes the Cisco NX-OS Enhanced Interior Gateway Routing Protocol (EIGRP) commands that begin with I.
To enable authentication for the Enhanced Interior Gateway Routing Protocol (EIGRP) packets and to specify the set of keys that can be used on an interface, use the ip authentication key-chain eigrp command. To prevent authentication, use the no form of this command.
ip authentication key-chain eigrp instance-tag name-of-chain
no ip authentication key-chain eigrp instance-tag name-of-chain
instance-tag |
Name of the EIGRP instance. The instance-tag can be any case-sensitive, alphanumeric string up to 20 characters. |
name-of-chain |
Group of keys that are valid. |
No authentication is provided for EIGRP packets.
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
You must set the authentication mode using the ip authentication mode eigrp command in interface configuration mode. You must separately configure a key chain using the key-chain command to complete the authentication configuration for an interface.
This command requires the LAN Base Services license.
This example shows how to configure the interface to accept and send any key that belongs to the key-chain trees:
switch(config)# router eigrp 209
switch(config-router)# interface ethernet 1/2
switch(config-if)# no switchport
switch(config-if)# ip authentication key-chain eigrp 209 trees
switch(config-if)#
To specify the type of authentication used in the Enhanced Interior Gateway Routing Protocol (EIGRP) packets, use the ip authentication mode eigrp command. To remove authentication, use the no form of this command.
ip authentication mode eigrp instance-tag md5
no ip authentication mode eigrp instance-tag md5
instance-tag |
Name of the EIGRP instance. The instance-tag can be any case-sensitive, alphanumeric string up to 20 characters. |
md5 |
Specifies Message Digest 5 (MD5) authentication. |
None
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
This command requires the LAN Base Services license.
This example shows how to configure the interface to use MD5 authentication:
switch(config)# router eigrp 209
switch(config-router)# interface ethernet 1/2
switch(config-if)# no switchport
switch(config-if)# ip authentication mode eigrp 209 md5
switch(config-if)#
To configure the bandwidth metric on an Enhanced Interior Gateway Routing Protocol (EIGRP) interface, use the ip bandwidth eigrp command. To restore the default, use the no form of this command.
ip bandwidth eigrp instance-tag bandwidth
no ip bandwidth eigrp
instance-tag |
Name of the EIGRP instance. The instance-tag can be any case-sensitive, alphanumeric string up to 20 characters. |
bandwidth |
Bandwidth value. The range is from 1 to 2,560,000,000 kilobits. |
None
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
This command requires the LAN Base Services license.
This example shows how to configure EIGRP to use a bandwidth metric of 10000 in autonomous system 209:
switch(config)# router eigrp 209
switch(config-router)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# ip bandwidth eigrp 209 10000
|
|
---|---|
ip bandwidth-percent eigrp |
Sets the percent of the interface bandwidth that EIGRP can use. |
show ip eigrp |
Displays EIGRP information. |
To configure the percentage of bandwidth that may be used by the Enhanced Interior Gateway Routing Protocol (EIGRP) on an interface, use the ip bandwidth-percent eigrp command. To restore the default, use the no form of this command.
ip bandwidth-percent eigrp instance-tag percent
no ip bandwidth-percent eigrp
instance-tag |
Name of the EIGRP instance. The instance-tag can be any case-sensitive, alphanumeric string up to 20 characters. |
percent |
Percentage of bandwidth that EIGRP may use. |
percent: 50
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
EIGRP uses up to 50 percent of the bandwidth of a link, as defined by the ip bandwidth interface configuration command. Use the ip bandwidth-percent command to change this default percent.
This command requires the LAN Base Services license.
This example shows how to configure EIGRP to use up to 75 percent of an interface in autonomous system 209:
switch(config)# router eigrp 209
switch(config-router)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# ip bandwidth-percent eigrp 209 75
switch(config-if)#
|
|
---|---|
ip bandwidth eigrp |
Sets the EIGRP bandwidth value for an interface. |
show ip eigrp |
Displays EIGRP information. |
To configure the throughput delay for the Enhanced Interior Gateway Routing Protocol (EIGRP) on an interface, use the ip delay eigrp command. To restore the default, use the no form of this command.
ip delay eigrp instance-tag seconds
no ip delay eigrp instance-tag
100 (10-microsecond units)
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
You configure the throughput delay on an interface in 10-microsecond units. For example, if you set the ip delay eigrp command to 100, the throughput delay is 1000 microseconds.
This command requires the LAN Base Services license.
This example shows how to set the delay to 400 microseconds for the interface:
switch(config)# router eigrp 1
switch(config-router)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# ip delay eigrp 1 40
To configure a distribution list for the Enhanced Interior Gateway Routing Protocol (EIGRP) on an interface, use the ip distribute-list eigrp command. To restore the default, use the no form of this command.
ip distribute-list eigrp instance-tag {prefix-list list-name | route-map map-name} {in | out}
no ip distribute-list eigrp instance-tag {prefix-list list-name | route-map map-name} {in | out}
None
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
Use the ip distribute-list eigrp command to configure a route filter policy on an interface. You must configure the named route map or prefix list to complete this configuration.
This command requires the LAN Base Services license.
This example shows how to configure a route map for all EIGRP routes coming into the interface:
switch(config)# router eigrp 209
switch(config-router)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# ip distribute-list eigrp 209 route-map InputFilter in
switch(config-if)#
|
|
---|---|
prefix-list |
Configures a prefix list. |
route-map |
Configures a route map. |
show ip eigrp |
Displays EIGRP information |
To shut down the Enhanced Interior Gateway Routing Protocol (EIGRP) on an interface, use the ip eigrp shutdown command. To restore the default, use the no form of this command.
ip eigrp instance-tag shutdown
no ip eigrp instance-tag shutdown
instance-tag |
Name of the EIGRP instance. The instance-tag can be any case-sensitive, alphanumeric string up to 20 characters. |
None
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
Use the ip eigrp shutdown command to shut down the interface for EIGRP and prevent EIGRP adjacency for the interface for maintenance purposes. The network address for the interface does not show up in the EIGRP topology table.
Use the ip passive-interface eigrp command to prevent EIGRP adjacency but keep the network address in the topology table.
This command requires the LAN Base Services license.
This example shows how to disable EIGRP on an interface:
switch(config)# router eigrp 201
switch(config-router)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# ip eigrp 201 shutdown
|
|
---|---|
ip passive-interface eigrp |
Configures an instance of EIGRP. |
router eigrp |
Configures an instance of EIGRP. |
To configure the Enhanced Interior Gateway Routing Protocol (EIGRP) hello interval for an interface, use the ip hello-interval eigrp command. To restore the default, use the no form of this command.
ip hello-interval eigrp instance-tag seconds
no ip hello-interval eigrp instance-tag
instance-tag |
Name of the EIGRP instance. The instance-tag can be any case-sensitive, alphanumeric string up to 20 characters. |
seconds |
Hello interval (in seconds). The range is from 1 to 65535. |
5 seconds
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
This command requires the LAN Base Services license.
This example shows how to set the hello interval to 10 seconds for the interface:
switch(config)# router eigrp 1
switch(config-router)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# ip hello-interval eigrp 1 10
switch(config-if)#
|
|
---|---|
copy running-config startup-config |
Saves the configuration changes to the startup configuration file. |
show ip eigrp |
Displays EIGRP information. |
To configure the hold time for an Enhanced Interior Gateway Routing Protocol (EIGRP) interface, use the ip hold-time eigrp command. To restore the default, use the no form of this command.
ip hold-time eigrp instance-tag seconds
no ip hold-time eigrp instance-tag
instance-tag |
Name of the EIGRP instance. The instance-tag can be any case-sensitive, alphanumeric string up to 20 characters. |
seconds |
Hold time (in seconds). The range is from 1 to 65535. |
15 seconds
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
Use the ip hold-time eigrp command to increase the default hold time on very congested and large networks.
We recommend that you configure the hold time to 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.
This command requires the LAN Base Services license.
This example shows how to set the hold time to 40 seconds for the interface:
switch(config)# router eigrp 209
switch(config-router)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# ip hold-time eigrp 209 40
To instruct the Enhanced Interior Gateway Routing Protocol (EIGRP) process to use the local IP address as the next-hop address when advertising these routes, use the ip next-hop-self eigrp command. To use the received next-hop value, use the no form of this command.
ip next-hop-self eigrp instance-tag
no ip next-hop-self eigrp instance-tag
instance-tag |
Name of the EIGRP instance. The instance-tag can be any case-sensitive, alphanumeric string up to 20 characters. |
EIGRP always sets the IP next-hop value to be itself.
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
EIGRP, by default, sets the IP next-hop value to be itself for routes that it is advertising, even when advertising those routes on the same interface from which the router learned them. To change this default, you must use the no ip next-hop-self eigrp command to instruct EIGRP to use the received next-hop value when advertising these routes.
This example shows how to change the default IP next-hop value and instruct EIGRP to use the received next-hop value:
switch(config)# router eigrp 209
switch(config-router)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# no ip next-hop-self eigrp 209
|
|
---|---|
copy running-config startup-config |
Saves the configuration changes to the startup configuration file. |
show ip eigrp |
Displays EIGRP information. |
To configure an offset list for the Enhanced Interior Gateway Routing Protocol (EIGRP) on an interface, use the ip offset-list eigrp command. To restore the default, use the no form of this command.
ip offset-list eigrp instance-tag {prefix-list list-name | route-map map-name} {in | out} offset
no ip offset-list eigrp instance-tag {prefix-list list-name | route-map map-name} {in | out} offset
None
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
Cisco Nexus 6000 adds the configured offset value to any routes that match the configure prefix list or route map. You must configure the named route map or prefix list to complete this configuration.
This command requires the LAN Base Services license.
This example shows how to configure an offset list filter to add 20 to the metric for EIGRP routes coming into the interface that match the route map OffsetFilter:
switch(config)# router eigrp 209
switch(config-router)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# ip offset-list eigrp 209 route-map OffsetFilter in 20
switch(config-if)#
|
|
---|---|
prefix-list |
Configures a prefix list. |
route-map |
Configures a route map. |
show ip eigrp |
Displays EIGRP information. |
To suppress all routing updates on an Enhanced Interior Gateway Routing Protocol (EIGRP) interface, use the ip passive-interface eigrp command. To reenable the sending of routing updates, use the no form of this command.
ip passive-interface eigrp instance-tag
no ip passive-interface eigrp instance-tag
instance-tag |
Name of the EIGRP instance. The name can be any case-sensitive, alphanumeric string up to 20 characters. |
Routing updates are sent on the interface.
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
Use the ip passive-interface eigrp command to stop all routing updates on an interface and suppress the formation of EIGRP adjacencies. The network address for the interface remains in the EIGRP topology table.
This command requires the LAN Base Services license.
This example shows how to stop EIGRP routing updates on ethernet 2/1:
switch(config)# router eigrp 201
switch(config-router)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# ip passive-interface eigrp 201
switch(config-if)#
To configure a static route, use the ip route command. To remove the static route, use the no form of this command.
ip route ip-prefix/mask {[interface] next-hop} [preference] [tag id]
no ip route ip-prefix/mask {[interface] next-hop} [preference] [tag id]
None
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
Static routes have a default administrative distance of 1. If you want a dynamic routing protocol to take precidence over a static route, you must configure the static route preference argument to be greater than the administrative distance of the dynamic routing protocol. For example, routes derived with the Enhanced Interior Gateway Routing Protocol (EIGRP) have a default administrative distance of 100. To have a static route that would be overridden by an EIGRP dynamic route, you should specify an administrative distance greater than 100.
This example shows how to create a static route for destinations with the IP address prefix 192.168.1.1/32, reachable through the next-hop address 10.0.0.2:
switch(config)# ip route 192.168.1.1/32 10.0.0.2
This example shows how to assign a tag to the previous example so that you can configure a route map that can match on this static route:
switch(config)# ip route 192.168.1.1/32 10.0.0.2 tag 5
This example shows how to choose a preference of 110. In this case, packets for prefix 10.0.0.0 are routed to a router at 172.31.3.4 if dynamic route information with an administrative distance less than 110 is not available.
switch# configure terminal
switch(config)# ip route 10.0.0.0/8 172.31.3.4 110
switch(config)#
|
|
---|---|
show vrf |
Displays the VRF configuration information. |
To specify the Enhanced Interior Gateway Routing Protocol (EIGRP) instance for an interface, use the ip router eigrp command. To return to the default, use the no form of this command.
ip router eigrp instance-tag
no ip router eigrp instance-tag
instance-tag |
Name of the EIGRP instance. The instance-tag can be any case-sensitive, alphanumeric string up to 20 characters. |
None
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
Before you use this command, make sure that you enable EIGRP on the switch.
This command requires the LAN Base Services license.
This example shows how to set the EIGRP instance for an interface:
switch(config)# interface ethernet 1/2
switch(config-if)# no switchport
switch(config-if)# ip router eigrp Base
switch(config-if)#
To enable split horizon for an Enhanced Interior Gateway Routing Protocol (EIGRP) process, use the ip split-horizon eigrp command. To disable split horizon, use the no form of this command.
ip split-horizon eigrp instance-tag
no ip split-horizon eigrp instance-tag
instance-tag |
Name of the EIGRP instance. The instance-tag can be any case-sensitive, alphanumeric string up to 20 characters. |
Enabled
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
Use the no ip split-horizon eigrp command to disable split horizon on an interface.
This command requires the LAN Base Services license.
This example shows how to disable split horizon an an Ethernet link:
switch(config)# router eigrp 209
switch(config-router)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# no ip split-horizon eigrp 209
switch(config-if)#
|
|
---|---|
copy running-config startup-config |
Saves the configuration changes to the startup configuration file. |
show ip eigrp |
Displays EIGRP information. |
To configure a summary aggregate address for the specified Enhanced Interior Gateway Routing Protocol (EIGRP) interface, use the ip summary-address eigrp command. To disable a configuration, use the no form of this command.
ip summary-address eigrp instance-tag {ip-address/length | ip-address mask} [admin-distance | leak-map map-name]
no ip summary-address eigrp instance-tag {ip-address/length | ip-address mask}
An administrative distance of 5 is applied to EIGRP summary routes.
No summary addresses are predefined.
Interface configuration mode
|
|
---|---|
6.0(2)N1(1) |
This command was introduced. |
Use the ip summary-address eigrp command to configure interface-level address summarization. EIGRP summary routes are given an administrative distance of 5.
This command requires the LAN Base Services license.
This example shows how to configure an administrative distance of 95 on an EIGRP interface for the 192.168.0.0/16 summary address:
switch(config)# router eigrp 209
switch(config-router)# interface ethernet 2/1
switch(config-if)# no switchport
switch(config-if)# ip summary-address eigrp 209 192.168.0.0/16 95
switch(config-if)#
|
|
---|---|
copy running-config startup-config |
Saves the configuration changes to the startup configuration file. |
show ip eigrp interfaces |
Displays EIGRP interface-related information. |