Table of Contents

Related Documents

14-EIGRP commands

Title	Size	Download
14-EIGRP commands	123.96 KB

EIGRP commands

address-family ipv4

Use address-family ipv4 to create the EIGRP IPv4 address family and enter its view, or enter the view of the existing address family.

Use undo address-family ipv4 to remove the EIGRP IPv4 address family and all its configurations.

Syntax

address-family ipv4

undo address-family ipv4

Default

No EIGRP IPv4 address family exists.

Views

EIGRP view

Predefined user roles

network-admin

Examples

# Create the EIGRP IPv4 address family and enter its view

<Sysname> system-view

[Sysname] eigrp 1

[Sysname-eigrp-1] address-family ipv4

[Sysname-eigrp-1-ipv4]

default-metric

Use default-metric to set the metrics for redistributed routes.

Use undo default-metric to restore the default.

Syntax

default-metric min-bandwidth total-delay reliability load mtu

undo default-metric

Default

The minimum bandwidth is 10000 Kbps, the total delay is 100 microseconds, the minimum reliability value is 255, the maximum load is 1, and the minimum MTU is 1500 bytes.

Views

EIGRP IPv4 address family view

Predefined user roles

network-admin

Parameters

min-bandwidth: Specifies the minimum bandwidth in the range of 1 to 4294967295 Kbps.

total-delay: Specifies the total delay in the range of 1 to 16777215 in 10 microseconds.

reliability: Specifies the minimum reliability value in the range of 1 to 255. A greater value means higher reliability. 1 means completely unreliable. 255 means completely reliable.

load: Specifies the maximum load in the range of 1 to 255. A smaller value means an idler link.

mtu: Specifies the minimum MTU in the range of 1 to 65535 bytes.

Usage guidelines

EIGRP calculates the composite metric for a route by using the configured metrics and the weights assigned to them. For information about how to calculate the composite route metric, see the metric weights command.

If you do not set the metrics in the import-route command, EIGRP uses the settings in the default-metric command for composite metric calculation.

Examples

# For EIGRP process 1, set the bandwidth, delay, reliability, load, and MTU metric values for redistributed routes to 111, 2220, 33, 44, and 555, respectively.

<Sysname> system-view

[Sysname] eigrp 1

[Sysname-eigrp-1] address-family ipv4

[Sysname-eigrp-1-ipv4] default-metric 111 222 33 44 555

Related commands

import-route

metric weights

discard-route

Use discard-route to configure discard route preferences.

Use undo discard-route to restore the default.

Syntax

discard-route { external external-preference | internal internal-preference } *

undo discard-route

Default

The preference is 5 for discard routes generated from automatic summarization for both internal and external routes.

Views

EIGRP IPv4 address family view

Predefined user roles

network-admin

Parameters

external external-preference: Specifies the preference for discard routes generated from automatic summarization for external routes, in the range of 1 to 255.

internal internal-preference: Specifies the preference for discard routes generated from automatic summarization for internal routes, in the range of 1 to 255.

Examples

# Configure the preference as 100 and 200 for discard routes generated from automatic summarization for external routes and internal routes, respectively.

<Sysname> system-view

[Sysname] eigrp 1

[Sysname-eigrp-1] address-family ipv4

[Sysname-eigrp-1-ipv4] discard-route external 100 internal 200

Related commands

summary automatic

display eigrp

Use display eigrp to display EIGRP configuration information.

Syntax

display eigrp [ eigrp-as ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535. If you do not specify this argument, the command displays configuration information for all EIGRP processes.

Examples

# Display configuration information for all EIGRP processes.

<Sysname> display eigrp

EIGRP protocol information for AS 1

Router ID: 192.168.10.1

Metric weights: K1 1, K2 0, K3 1, K4 0, K5 0

Active timer: 3 min

GR hold time: 240 sec

Preferences: internal 90, external 170

DSCP value: 48

Default metric:

Minimum bandwidth: 0 kbps

Total delay: 0 microseconds

Reliability: 0

Load : 0

Minimum MTU: 0

Max ECMP paths: 16

Table 1 Command output

Field	Description
Active timer	Convergence wait timer in seconds.
GR hold time	Aging timer for routes on a GR helper, in seconds.
Preferences	Internal and external EIGRP route preferences.
Default metric	Metrics for redistributed routes.
Minimum bandwidth	Minimum bandwidth in Kbps.
Total delay	Total delay in microseconds.
Reliability	Minimum reliability value.
Load	Maximum load value.
Minimum MTU	Minimum MTU in bytes.
Max ECMP paths	Maximum number of ECMP routes supported.

‌

display eigrp interface

Use display eigrp interface to display EIGRP interface information.

Syntax

display eigrp [ eigrp-as ] interface [ interface-type interface-number ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535. If you do not specify this argument, the command displays interface information for all EIGRP processes.

interface-type interface-number: Specifies an interface by its type and number. If you do not specify this argument, the command displays information for all interfaces.

verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.

Examples

# Display brief information for GigabitEthernet 1/0/1 in all EIGRP processes.

<Sysname> display eigrp interface gigabitethernet 1/0/1

EIGRP interface for AS 1

Interface State Hello-interval Hold-time Split-horizon

GE1/0/1 Down 20 80 Enabled

Table 2 Command output

Field	Description
Interface	Interface name.
State	Interface state: Up or Down.
Hello-interval	Hello interval in seconds.
Hold-time	Hold time in seconds.
Split-horizon	Split horizon status: Enabled or Disabled.

‌

# Display detailed information for GigabitEthernet 1/0/1 in all EIGRP processes.

<Sysname> display eigrp interface gigabitethernet 1/0/1 verbose

EIGRP interface for AS 1

Interface: 192.168.2.2 (GE1/0/1)

State: Down

Hello-interval: 5 sec

Hold-time: 15 sec

Split-horizon: Disabled

Multicasts: 0

Metric:

Bandwidth: 10000000 kbps

Delay: 50000 microseconds

Reliability: 255

Load: 255

MTU: 1500

Table 3 Command output

Field	Description
Interface	IP address and name for the interface.
State	Interface state: Up or Down.
Hello-interval	Hello interval in seconds.
Hold-time	Hold time in seconds.
Split-horizon	Split horizon status: Enabled or Disabled.
Multicasts	Number of EIGRP multicast packets to be sent.
Metric	EIGRP interface metrics.

‌

display eigrp peer

Use display eigrp peer to display EIGRP neighbor information.

Syntax

display eigrp [ eigrp-as ] peer [ interface interface-type interface-number ] [ neighbor-ip ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535. If you do not specify this argument, the command displays neighbor information for all EIGRP processes.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify this option, the command displays neighbor information for all interfaces.

neighbor-ip: Specifies an EIGRP neighbor by its IP address. If you do not specify this argument, the command displays information about all neighbors for the specified or all EIGRP processes.

verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.

Examples

# Display brief EIGRP neighbor information.

<Sysname> display eigrp peer

Brief EIGRP neighbor Information for AS 1

Address State Hold time Interface

192.168.10.2 Up 15 GE1/0/1

Table 4 Command output

Field	Description
Address	IP address of the neighbor.
State	Neighbor state: · Down—The neighbor relationship is in initial state. · Pending—The three-way handshake is not complete. · Up—The neighbor relationship is established.
Hold time	Hold time in seconds.
Interface	Interface that is connected to the neighbor.

‌

# Display detailed EIGRP neighbor information.

<Sysname> display eigrp peer verbose

EIGRP neighbor Information for AS 1

Neighbor address : 1.2.3.5

State : Up Interface : GE1/0/1

Hold time : 12s Version : 0.1/2.0

Seq Num : 2 Prefixes : 1

Unicasts: 0 Retries : 0

Uptime : 00:04:41

Table 5 Command output

Field	Description
Neighbor Address	IP address of the neighbor.
State	Neighbor state: · Down—The neighbor relationship is in initial state. · Pending—The three-way handshake is not complete. · Up—The neighbor relationship is established.
Interface	Interface that is connected to the neighbor.
Hold time	Hold time in seconds.
Version	EIGRP software version number/EIGRP TLV version number of the neighbor.
Seq Num	Sequence number of packets received from the neighbor.
Prefixes	Number of prefixes advertised by the neighbor.
Unicasts	Number of EIGRP unicast packets to be sent to the neighbor.
Retries	Number of packet retransmissions.
Uptime	Amount of time that the neighbor is in Up state.

‌

display eigrp peer statistics

Use display eigrp peer statistics to display EIGRP neighbor statistics.

Syntax

display eigrp [ eigrp-as ] peer statistics [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535. If you do not specify this argument, the command displays neighbor statistics for all EIGRP processes.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify this option, the command displays neighbor statistics for all interfaces.

Examples

# Display EIGRP neighbor statistics.

<Sysname> display eigrp 1 peer statistics

EIGRP As 1 with Router ID 5.5.5.5

Neighbor Statistics

Interface Down Pending Up Total

GE1/0/1 0 0 1 1

Total 0 0 1 1

Table 6 Command output

Field	Description
Interface	Interface name
Down	Number of neighbors in Down state.
Pending	Number of neighbors in Pending state.
Up	Number of neighbors in Up state.
Total	Total number of neighbors in all states.

‌

Related commands

display eigrp

display eigrp statistics

Use display eigrp statistics to display EIGRP statistics.

Syntax

display eigrp [ eigrp-as ] statistics [ error ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535. If you do not specify this argument, the command displays statistics for all EIGRP processes.

error: Displays error statistics. If you do not specify this keyword, the command displays EIGRP process statistics.

Examples

# Display all types of EIGRP statistics.

<Sysname> display eigrp statistics

EIGRP statistics for AS 1

Packet type Sent Received

HELLO 2142 1809

UPDATE 12 9

QUERY 0 0

REPLY 0 0

HELLO(ACK) 7 5

SIA-QUERY 0 0

SIA-REPLY 0 0

Route type Added Deleted

Internal 1 2

External 0 0

Table 7 Command output

Field	Description
Packet type	Packet type: · HELLO · UPDATE · QUERY · REPLY · HELLO(ACK) · SIA-QUERY · SIA-REPLY
Sent	Number of packets sent.
Received	Number of packets received.
Route type	Route type: Internal or External.
Added	Number or routes added to RIB.
Deleted	Number or routes deleted from RIB.

‌

# Display EIGRP error statistics.

<Sysname> display eigrp statistics error

EIGRP error statistics for AS 1

Packet dest errors : 0

Bad version : 0

Bad PktType : 0

Bad checksum : 0

Mismatched K value : 0

Table 8 Command output

Field	Description
Packet dest errors	Number of packets with wrong destinations.
Bad version	Number of packets with wrong version numbers.
Bad PktType	Number of packets with packet types.
Bad checksum	Number of packets with checksum errors.
Mismatched K value	Number of packets with mismatched K values.

‌

Related commands

display eigrp peer

display eigrp topology

Use display eigrp topology to display EIGRP topology table information.

Syntax

display eigrp [ eigrp-as ] topology [ ip-address { mask-length | mask } ] [ all-links | verbose ]

display eigrp [ eigrp-as ] topology statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535. If you do not specify this argument, the command displays topology table information for all EIGRP processes.

ip-address { mask-length | mask }: Specifies a route. The ip-address argument specifies the destination network. The mask-length argument specifies the mask length in the range of 0 to 32. The mask argument specifies the subnet mask in dotted decimal notation. If you do not specify a route, the command displays information about all routes.

all-links: Displays information about all paths, including feasible and unfeasible paths. If you do not specify this keyword, the command displays optimal path information.

verbose: Displays detailed information.

statistics: Displays statistics for the EIGRP topology table.

Usage guidelines

If you do not specify the all-links, verbose, or statistics keyword, the command displays topology table information for the specified or all EIGRP processes.

Examples

# Display brief EIGRP topology table information.

<Sysname> display eigrp topology

EIGRP topology for AS 1 with Router ID 10.0.0.1

Destination FD State Successor Out interface

10.0.0.0/8 409600 Passive 1.1.1.2 GE1/0/1

20.0.0.0/8 409600 Passive Direct GE1/0/2

Table 9 Command output

Field	Description
Destination	Destination network address.
FD	Feasible distance, that is, the lowest metric to the destination network.
State	Route state: Passive or Active.
Successor	Successor for the route: · IP address of the successor. · Direct—The route is a direct route. · Imported—The route is a redistributed route. · Summary—The route is a summary route.
Out interface	Output interface for the route.

‌

# Display detailed EIGRP topology table information.

<Sysname> display eigrp topology verbose

EIGRP topology for AS 1 with Router ID 10.0.0.1

Destination : 10.0.0.0/8 FD : 409600 State : Passive

Successor : 8.8.8.5

Type : Internal

Out interface : GE1/0/2

Originating router : 10.0.1.2

Nib ID : 0x0

CD/RD : 409600/128256

Metric :

Minimum bandwidth : 10000 kbps

Total delay : 6000 microseconds

Reliability : 255/255

Load : 1/255

Minimum MTU : 1500

Hop count : 1

Destination : 10.0.0.0/8 FD : 409600 State : Active

Active time : 00:02:41

Query origin : 0

Successor : 8.8.8.5

Type : External

Out interface : GE1/0/2

Originating router : 10.0.1.2

Nib ID : 0x0

CD/RD : 409600/128256

Metric :

Minimum bandwidth : 10000 kbps

Total delay : 6000 microseconds

Reliability : 255/255

Load : 1/255

Minimum MTU : 1500

Hop count : 1

External data :

AS number : 2

External protocol : OSPF

External metric : 11

Admin tag : -

Waiting peers reply:

10.0.1.2 on GigabitEthernet1/0/3

10.0.1.3 on GigabitEthernet1/0/3

10.0.1.4 on GigabitEthernet1/0/4

10.0.1.5 on GigabitEthernet1/0/4

Table 10 Command output

Field	Description
Destination	Destination network.
FD	Feasible distance, that is, the lowest metric to the destination network.
State	Route state: Passive or Active.
Active time	Amount of time that the route is in Active state.
Query origin	Query origin flag, indicating the sub state for the Active state. · 0—Active 0 state. · 1—Active 1 state. · 2—Active 2 state. · 3—Active 3 state.
Successor	Successor for the route: · IP address of the successor. · Direct—The route is a direct route. · Imported—The route is a redistributed route. · Summary—The route is a summary route.
Type	Route type: Internal or External.
Out interface	Output interface for the route.
Originating router	Router ID for the originating router.
Nib ID	Next hop ID assigned by route management.
CD/RD	Computed Distance/Reported Distance. Computed Distance (CD) is the total metric along the path through the neighbor to the destination network. Reported Distance (RD) is the metric to the destination network advertised by the neighbor.
Metric	Metric advertised by the neighbor.
Minimum bandwidth	Minimum bandwidth in Kbps.
Total delay	Total delay in microseconds.
Reliability	Minimum reliability value.
Load	Maximum load value.
Minimum MTU	Minimum MTU in bytes.
Hop count	Number of hops to the destination network.
External data	Data contained in the external route.
AS number	Process ID for the external routing protocol.
External protocol	External routing protocol.
External metric	Metric for the external routing protocol.
Admin tag	Tag for the external route.
Waiting peers reply	EIGRP neighbors from whom the local router is waiting for a reply, and the output interfaces corresponding to the neighbors.

‌

# Display information about all paths in the EIGRP topology table.

<Sysname> display eigrp topology all-links

EIGRP topology for AS 1 with Router ID 10.0.0.1

Flags: S - Successor F - Feasible successor

Destination : 10.0.0.0/8 FD : 409600 State : Passive

Link information:

Flag Peer Out interface Type CD RD

S 1.1.1.2 GE1/0/1 Internal 409600 128256

F 2.1.1.2 GE1/0/2 Internal 576000 213400

3.1.1.2 GE1/0/3 External 631000 510200

Table 11 Command output

Field	Description
Destination	Destination network.
FD	Feasible distance, that is, the lowest metric to the destination network.
State	Route state: Passive or Active.
Link information	Information about the paths related to the route.
Flag	Path flag: · S—Successor. The neighbor that provides the path is a successor. · F—Feasible successor. The neighbor that provides the path is a feasible successor.
Peer	IP address of the neighbor.
Out interface	Output interface for the route.
Type	Route type: Internal or External.
CD	Total metric along the path through the neighbor to the destination network.
RD	The metric to the destination network advertised by the neighbor.

‌

# Display statistics for the EIGRP topology table.

<Sysname> display eigrp topology statistics

EIGRP topology statistics for AS 65535 with Router ID 2.1.1.1

Destinations:

Active : 0

Passive : 256

Total : 256

Routes:

Learnt : 7

Direct : 7

Imported : 247

Summary : 0

Total : 261

Table 12 Command output

Field	Description
Destinations	Prefix statistics.
Active	Number of prefixes in Active state.
Passive	Number of prefixes in Passive state.
Total	Total number of prefixes.
Routes	Route statistics.
Learnt	Number of routes learned from neighbors.
Direct	Number of direct routes.
Imported	Number of redistributed routes.
Summary	Number of summary routes.
Total	Total number of routes.

‌

dscp

Use dscp to set the DSCP value for EIGRP packets.

Use undo dscp to restore the default.

Syntax

dscp dscp-value

undo dscp

Default

The DSCP value for EIGRP packets is 48.

Views

EIGRP IPv4 address family view

Predefined user roles

network-admin

Parameters

dscp-value: Specifies a DSCP value in the range of 0 to 63.

Examples

# Set the DSCP value to 63 for packets of EIGRP process 1 in EIGRP IPv4 address family view.

<Sysname> system-view

[Sysname] eigrp 1

[Sysname-eigrp-1] address-family ipv4

[Sysname-eigrp-1-ipv4] dscp 63

eigrp

Use eigrp to create an EIGRP process and enter EIGRP view.

Use undo eigrp to delete an EIGRP process.

Syntax

eigrp [ eigrp-as ] [ vpn-instance vpn-instance-name ]

undo eigrp eigrp-as

Default

No EIGRP process is created.

Views

System view

Predefined user roles

network-admin

Parameters

eigrp-as: Specifies an AS number (process ID) for the EIGRP process, in the range of 1 to 65535. The default value is 1.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the EIGRP process runs on the public network. Support for this option depends on the device model.

Examples

# Create EIGRP process 1 and enter EIGRP view.

<Sysname> system-view

[Sysname] eigrp 1

[Sysname-eigrp-1]

eigrp metric

Use eigrp metric to configure metrics for an interface.

Use undo eigrp metric to restore the default.

Syntax

eigrp eigrp-as metric { bandwidth bandwidth | delay delay | load load | reliability reliability } *

undo eigrp eigrp-as metric

Default

No metric is configured for an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535.

bandwidth: Specifies the bandwidth in the range of 1 to 4294967295 Kbps. The default value is the actual bandwidth of the interface.

delay: Specifies the delay in the range of 1 to 16777215 in 10 microseconds. The default value is 10000000/interface bandwidth.

load: Specifies the load in the range of 1 to 255. The default value is 255. A smaller value means an idler link.

reliability: Specifies the reliability value in the range of 1 to 255. The default value is 1. A smaller value means lower link reliability.

Usage guidelines

Examples

# On GigabitEthernet 1/0/1, configure the bandwidth, delay, load, and reliability values for EIGRP process 1 as 60, 100, 1, and 255, respectively.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] eigrp 1 metric bandwidth 60 delay 10 load 1 reliability 255

Related commands

metric weights

eigrp split-horizon

Use eigrp split-horizon to enable split horizon.

Use undo eigrp split-horizon to disable split horizon.

Syntax

eigrp eigrp-as split-horizon

undo eigrp eigrp-as split-horizon

Default

Split horizon is enabled.

Views

Interface view

Predefined user roles

network-admin

Parameters

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535.

Usage guidelines

The split horizon feature prevents routing loops. As a best practice, do not disable split horizon unless it is necessary.

On Non-Broadcast Multi-Access (NBMA) networks, such as Frame Relay and X.25 where multiple virtual circuits are configured on the primary and secondary interfaces, disable split horizon to ensure correct route advertisement.

Examples

# Enable split horizon for EIGRP process 1 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] eigrp 1 split-horizon

eigrp timer hello

Use eigrp timer hello to set the hello timer for an interface.

Use undo eigrp timer hello to restore the default.

Syntax

eigrp eigrp-as timer hello seconds

undo eigrp eigrp-as timer hello

Default

The hello timer is 60 seconds for NBMA networks and 5 seconds for other networks.

Views

Interface view

Predefined user roles

network-admin

Parameters

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535.

seconds: Specifies the hello timer in the range of 1 to 65535 seconds.

Usage guidelines

A smaller hello timer means a faster speed for detecting topology changes, which consumes more system resources. Set an appropriate hello timer based on your network condition.

As a best practice, set the hold timer to be at least three times the hello timer.

Examples

# Set the hello timer to 20 seconds for EIGRP process 1 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] eigrp 1 timer hello 20

Related commands

eigrp timer hold

Use eigrp timer hold to set the hold timer for an interface.

Use undo eigrp to restore the default.

Syntax

eigrp eigrp-as timer hold seconds

undo eigrp eigrp-as timer hold

Default

The hold timer is three times the hello timer.

Views

Interface view

Predefined user roles

network-admin

Parameters

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535.

seconds: Specifies the hold timer in the range of 1 to 65535 seconds.

Usage guidelines

The router advertises the hold timer to the neighbor. If the neighbor receives no Hello packets from the local router within the hold time, it determines that the local router is invalid.

As a best practice, set the hold timer to be at least three times the hello timer.

Examples

# Set the hold timer to 60 seconds for EIGRP process 1 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] eigrp 1 timer hold 60

Related commands

eigrp timer hello

import-route

Use import-route to enable an EIGRP process to redistribute routes from other EIGRP processes or other routing protocols.

Use undo import-route to remove the configuration.

Syntax

import-route bgp [ as-number ] [ allow-ibgp | metric min-bandwidth total-delay reliability load mtu | route-policy route-policy-name ] *

import-route { direct | static } [ metric min-bandwidth total-delay reliability load mtu | route-policy route-policy-name ] *

import-route eigrp [ eigrp-as | all-as ] [ allow-direct | metric min-bandwidth total-delay reliability load mtu | route-policy route-policy-name ] *

import-route { isis | ospf | rip } [ process-id | all-processes] [ allow-direct | metric min-bandwidth total-delay reliability load mtu | route-policy route-policy-name ] *

undo import-route { bgp | direct | eigrp [ eigrp-as | all-as ] | { isis | ospf | rip } [ process-id | all-processes ] | static }

Default

Route redistribution is disabled.

Views

EIGRP IPv4 address family view

Predefined user roles

network-admin

Parameters

bgp: Redistributes BGP routes.

direct: Redistributes direct routes.

static: Redistributes static routes.

eigrp: Redistributes EIGRP routes.

isis: Redistributes IS-IS routes.

rip: Redistributes RIP routes.

ospf: Redistributes OSPF routes.

as-number: Redistributes routes in an AS specified by its number in the range of 1 to 4294967295. If you do not specify this argument, the command redistributes all IPv4 EBGP routes. As a best practice, specify an AS number to prevent the system from redistributing excessive IPv4 EBGP routes.

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535. The default value is 1.

all-as: Specifies all EIGRP processes.

process-id: Specifies a process by its ID for IS-IS, OSPF, or RIP, in the range of 1 to 65535. The default value is 1.

all-processes: Redistributes routes from all the processes of IS-IS, OSPF, or RIP.

allow-ibgp: Redistributes IBGP routes.

allow-direct: Redistributes the networks of the local interfaces enabled with the EIGRP process. If you do not specify this keyword, the networks of the local interfaces are not redistributed.

metric: Configures metrics for redistributed routes.

min-bandwidth: Specifies the minimum bandwidth in the range of 1 to 4294967295 Kbps.

total-delay: Specifies the total delay in the range of 1 to 16777215 in 10 microseconds.

reliability: Specifies the minimum reliability value in the range of 1 to 255. A greater value means higher reliability. 1 means completely unreliable. 255 means completely reliable.

load: Specifies the maximum load in the range of 1 to 255. A smaller value means an idler link.

mtu: Specifies the minimum MTU in the range of 1 to 1500 bytes.

route-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters.

Usage guidelines

The import-route bgp command redistributes only EBGP routes. Because the import-route bgp allow-ibgp command redistributes both EBGP and IBGP routes and might cause routing loops, use it with caution.

Only active routes can be redistributed. To view route state information, use the display ip routing-table protocol command.

The undo import-route { isis | ospf | rip } all-processes command removes only the configuration made by the import-route { isis | ospf | rip } all-processes command. It does not remove the configuration made by the import-route { isis | ospf | rip } process-id command.

The undo import-route eigrp all-as command removes only the configuration made by the import-route eigrp all-as command. It does not remove the configuration made by the import-route eigrp eigrp-as command.

You can set the metric values used for composite route metric calculation in the import-route command. If you do not set the metric values, the settings in the default-metric command apply.

Examples

# Enable EIGRP process 100 to redistribute routes from OSPF process 10, and configure metrics for the redistributed routes.

<Sysname> system-view

[Sysname] eigrp 100

[Sysname-eigrp-100] address-family ipv4

[Sysname-eigrp-100-ipv4] import-route ospf 10 metric 100000 10 255 10 1500

Related commands

default-metric

display ip routing-table protocol

eigrp metric

maximum load-balancing

Use maximum load-balancing to set the maximum number of EIGRP ECMP routes.

Use undo maximum load-balancing to restore the default.

Syntax

maximum load-balancing number

undo maximum load-balancing

Default

The maximum number of EIGRP ECMP routes equals the maximum number of ECMP routes supported by the system.

Views

EIGRP IPv4 address family view

Predefined user roles

network-admin

Parameters

number: Specifies the maximum number of EIGRP ECMP routes. The value range for this argument is 1 to 32. Load sharing is not performed when the number is set to 1.

Usage guidelines

The value range for the number argument depends on the max-ecmp-num command. If you set the maximum number of ECMP routes to m by using the max-ecmp-num command and reboot the device, the number argument in the maximum load-balancing command is in the range of 1 to m.

Examples

# Set the maximum number of ECMP routes to 6 for EIGRP process 1.

<Sysname> system-view

[Sysname] eigrp 1

[Sysname-eigrp-1] address-family ipv4

[Sysname-eigrp-1-ipv4] maximum load-balancing 6

Related commands

max-ecmp-num

metric weights

Use metric weights to configure metric weights.

Use undo metric weights to restore the default.

Syntax

metric weights K1 K2 K3 K4 K5

undo metric weights

Default

The weights for metrics K1 through K5 are 1, 0, 1, 0, and 0, respectively.

Views

EIGRP IPv4 address family view

Predefined user roles

network-admin

Parameters

K1: Specifies the weight for K1, in the range of 0 to 255.

K2: Specifies the weight for K2, in the range of 0 to 255.

K3: Specifies the weight for K3, in the range of 1 to 255.

K4: Specifies the weight for K4, in the range of 0 to 255.

K5: Specifies the weight for K5, in the range of 0 to 255.

Usage guidelines

EIGRP calculates the composite route metric based on the following metrics:

· Bandwidth—Minimum interface bandwidth on the path from the local router to the destination network.

· Delay—Sum of all interface delays on the path from the local router to the destination network.

· Reliability—Minimum interface reliability value on the path from the local router to the destination network.

· Load—Maximum interface load value on the path from the local router to the destination network.

· MTU—Minimum interface MTU on the path from the local router to the destination network.

EIGRP assigns each metric a weight for calculating the composite route metric. The calculation formula uses coefficients (K values) that correspond to the metrics as follows:

· K1—Bandwidth.

· K2—Load.

· K3—Delay.

· K4—Reliability.

· K5—MTU.

EIGRP calculates the composite route metric as follows:

· If K5 is equal to 0, the following formula applies:

Metric 1 = 256 × [K1 × Bandwidth + (K2 × Bandwidth) / (256 - Load) + K3 × Delay]

· If K5 is not equal to 0, Metric 1 is multiplied by another coefficient as follows:

Metric 2 = Metric 1 × [K5 / (Reliability + K4)]

In the formula: Bandwidth = 10000000 / Minimum interface bandwidth on the path.

Examples

# For EIGRP process 1, configure the weights for metrics K1 through K5 as 11, 22, 33, 44, and 55, respectively.

<Sysname> system-view

[Sysname] eigrp 1

[Sysname-eigrp-1] address-family ipv4

[Sysname-eigrp-1-ipv4] metric weights 11 22 33 44 55

network

Use network to enable EIGRP on a network.

Use undo network to disable EIGRP on a network

Syntax

network network-address [ wildcard-mask ]

undo network network-address [ wildcard-mask ]

Default

EIGRP is disabled on a network.

Views

EIGRP IPv4 address family view

Predefined user roles

network-admin

Parameters

network-address: Specifies a network by its IP address. You can specify the IP addresses of networks where the local interfaces reside.

wildcard-mask: Specifies the wildcard mask of the IP address. For example, the wildcard mask of mask 255.0.0.0 is 0.255.255.255. If you do not specify this argument, the natural mask applies.

Usage guidelines

This command allows you to enable EIGRP for a network. After that, only the interface attached to the network runs EIGRP.

Examples

# Enable EIGRP process 1 for the network 129.100.0.0.

<Sysname> system-view

[Sysname] eigrp 1

[Sysname-eigrp-1] address-family ipv4

[Sysname-eigrp-1-ipv4] network 129.100.0.0

preference

Use preference to configure EIGRP route preferences.

Use undo preference to restore the default.

Syntax

preference internal-preference external-preference

undo preference

Default

The internal route preference is 90, and the external route preference is 170.

Views

EIGRP IPv4 address family view

Predefined user roles

network-admin

Parameters

internal-preference: Specifies the internal route preference in the range of 1 to 255. The smaller the value, the higher the preference.

external-preference: Specifies the external route preference in the range of 1 to 255. The smaller the value, the higher the preference.

Usage guidelines

Routing protocols each have a default preference. If they find multiple routes destined for the same network, the route found by the routing protocol with the highest preference is selected as the optimal route.

This command allows you to configure the preference for internal routes learned from the same EIGRP process, and for external routes learned from other EIGRP processes or routing protocols.

Examples

# Configure the internal route preference and external route preference for EIGRP process 1 as 100 and 190, respectively.

<Sysname> system-view

[Sysname] eigrp 1

[Sysname-eigrp-1] address-family ipv4

[Sysname-eigrp-1-ipv4] preference 100 190

reset eigrp peer

Use reset eigrp peer to clear EIGRP neighbor information.

Syntax

reset eigrp [ eigrp-as ] peer [ interface interface-type interface-number | ip-address ] *

Views

User view

Predefined user roles

network-admin

Parameters

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535. If you do not specify this argument, the command clears neighbor information for all EIGRP processes.

interface-type interface-number: Specifies an interface by its type and number.

ip-address: Specifies a neighbor by its IP address in dotted decimal notation.

Usage guidelines

If you do not specify the interface-type interface-number or ip-address argument, the command clears information about all neighbors for the specified or all EIGRP processes.

Examples

# Clear information about the neighbor with IP address 192.168.10.1 for EIGRP process 100.

<Sysname> reset eigrp 100 peer 192.168.10.1

reset eigrp process

Use reset eigrp process to restart the EIGRP IPv4 address family.

Syntax

reset eigrp [ eigrp-as ] process address-family ipv4

Views

User view

Predefined user roles

network-admin

Parameters

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535. If you do not specify this argument, the command restarts the IPv4 address family for all EIGRP processes.

address-family ipv4: Specifies the IPv4 unicast address family.

Usage guidelines

This command clears information for the IPv4 address family of the specified EIGRP process, including neighbor information and routing information. Executing the command will terminate and then reestablish the neighbor relationship.

Examples

# Restart the IPv4 address family for EIGRP process 100.

<Sysname> reset eigrp 100 process address-family ipv4

Reset EIGRP process? [Y/N]:y

reset eigrp statistics

Use reset eigrp statistics to clear EIGRP statistics.

Syntax

reset eigrp [ eigrp-as ] statistics

Views

User view

Predefined user roles

network-admin

Parameters

eigrp-as: Specifies an EIGRP process by its AS number in the range of 1 to 65535. If you do not specify this argument, the command clears statistics for all EIGRP processes.

Examples

# Clear statistics for EIGRP process 100.

<Sysname> reset eigrp 100 statistics

router-id

Use router-id to configure the router ID for an EIGRP process.

Use undo router-id to restore the default.

Syntax

router-id router-id

undo router-id

Default

No router ID is configured for an EIGRP process. The global router ID is used.

Views

EIGRP IPv4 address family view

Predefined user roles

network-admin

Parameters

router-id: Specifies the router ID in IPv4 address format. The router ID cannot be 0.0.0.0 or 255.255.255.255.

Usage guidelines

CAUTION:

Changing the router ID for an EIGRP process will reset the neighbor relationship.

‌

EIGRP uses a router ID to uniquely identify an advertising router in an autonomous system. If a router receives a route containing the router ID of the local router, it discards the route.

As a best practice, to enhance network availability, specify the IP address of a loopback interface as the router ID.

Examples

# Configure the router ID for EIGRP process 1 as 10.1.1.3.

<Sysname> system-view

[Sysname] eigrp 1

[Sysname-eigrp-1] address-family ipv4

[Sysname-eigrp-ipv4] router-id 10.1.1.3

summary automatic

Use summary automatic to enable automatic route summarization.

Use undo summary automatic to disable automatic route summarization.

Syntax

summary automatic

undo summary automatic

Default

Automatic route summarization is disabled.

Views

EIGRP IPv4 address family view

Predefined user roles

network-admin

Usage guidelines

This command summarizes contiguous networks into a single network with natural mask and advertises the network to neighbors. Route summarization reduces the number of exchanged routes and the routing table size, and improves network scalability and router performance.

To advertise the specific routes that have been summarized, use the undo summary automatic command.

Examples

# Enable automatic route summarization for the IPv4 address family of EIGRP process 1.

<Sysname> system-view

[Sysname] eigrp 1

[Sysname-eigrp-1] address-family ipv4

[Sysname-eigrp-1-ipv4] summary automatic

timers active-time

Use timers active-time to set the convergence wait timer.

Use undo timers active-time to restore the default.

Syntax

timers active-time { time-limit | disable }

undo timers active-time

Default

The convergence wait timer is 3 minutes.

Views

EIGRP IPv4 address family view

Predefined user roles

network-admin

Parameters

time-limit: Specifies the convergence wait timer in the range of 1 to 65535 minutes.

disable: Sets no time limit for route convergence.

Usage guidelines

If a route in the topology table enters the Active state and fails to be converged within the convergence wait time, it gets stuck in the active (SIA) state. The router no longer waits for replies from neighbors, and terminates the relationship with the neighbors that have not responded.

The disable keyword means setting no time limit for route convergence. Typically, as a best practice, do not specify this keyword.

Examples

# Set the convergence wait timer to 10 minutes for EIGRP process 1 in EIGRP IPv4 address family view.

<Sysname> system-view

[Sysname] eigrp 1

[Sysname-eigrp-1] address-family ipv4

[Sysname-eigrp-1-ipv4] timers active-time 10

timers graceful-restart purge-time

Use timers graceful-restart purge-time to set the aging timer for routes on the GR helper.

Use undo timers graceful-restart purge-time to restore the default.

Syntax

timers graceful-restart purge-time seconds

undo timers graceful-restart purge-time

Default

The aging timer is 240 seconds for routes on a GR helper.

Views

EIGRP IPv4 address family view

Predefined user roles

network-admin

Parameters

seconds: Specifies the aging timer in the range of 20 to 300 seconds.

Usage guidelines

During the graceful restart (GR) process, the GR restarter and GR helper exchange routing information. If route exchange is not completed when the specified aging timer expires, the GR helper (EIGRP router) quits the GR process. The GR helper updates the RIB entries based on the learned EIGRP routes and removes aged RIB entries.

Examples

# Set the aging timer to 100 seconds for routes on the GR helper in EIGRP process 1.

<Sysname> system-view

[Sysname] eigrp 1

[Sysname-eigrp-1] address-family ipv4

[Sysname-eigrp-1-ipv4] timers graceful-restart purge-time 100

08-Layer 3—IP Routing Command Reference

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us