08-Layer 3—IP Routing Command Reference

HomeSupportResource CenterReference GuidesCommand ReferencesH3C MSR810[830][2600][3600] Routers Command Reference(V7)-R6728-6W10008-Layer 3—IP Routing Command Reference
06-EIGRP commands
Title Size Download
06-EIGRP commands 159.39 KB

EIGRP commands

The following compatibility matrixes show the support of hardware platforms for EIGRP:

 

Hardware

EIGRP compatibility

MSR810, MSR810-W, MSR810-W-DB, MSR810-LM, MSR810-W-LM, MSR810-10-PoE, MSR810-LM-HK, MSR810-W-LM-HK, MSR810-LM-CNDE-SJK, MSR810-CNDE-SJK

Yes

MSR810-LMS, MSR810-LUS

No

MSR810-LMS-EA, MSR810-LME

Yes

MSR1004S-5G

Yes

MSR2600-6-X1, MSR2600-10-X1, MSR2600-15-X1

Yes

MSR 2630

Yes

MSR3600-28, MSR3600-51

Yes

MSR3600-28-SI, MSR3600-51-SI

No

MSR3600-28-X1, MSR3600-28-X1-DP, MSR3600-51-X1, MSR3600-51-X1-DP

Yes

MSR3610-I-DP, MSR3610-IE-DP, MSR3610-IE-ES, MSR3610-IE-EAD, MSR-EAD-AK770, MSR3610-I-IG, MSR3610-IE-IG

Yes

MSR3610-X1, MSR3610-X1-DP, MSR3610-X1-DC, MSR3610-X1-DP-DC, MSR3620-X1, MSR3640-X1

Yes

MSR 3610, MSR 3620, MSR 3620-DP, MSR 3640, MSR 3660

Yes

MSR3610-G, MSR3620-G

Yes

MSR3640-X1-HI

Yes

Hardware

EIGRP compatibility

MSR810-W-WiNet, MSR810-LM-WiNet

Yes

MSR830-4LM-WiNet

Yes

MSR830-5BEI-WiNet, MSR830-6EI-WiNet, MSR830-10BEI-WiNet

Yes

MSR830-6BHI-WiNet, MSR830-10BHI-WiNet

Yes

MSR2600-6-WiNet, MSR2600-10-X1-WiNet

Yes

MSR2630-WiNet

Yes

MSR3600-28-WiNet

Yes

MSR3610-X1-WiNet

Yes

MSR3610-WiNet, MSR3620-10-WiNet, MSR3620-DP-WiNet, MSR3620-WiNet, MSR3660-WiNet

Yes

Hardware

EIGRP compatibility

MSR2630-XS

Yes

MSR3600-28-XS

Yes

MSR3610-XS

Yes

MSR3620-XS

Yes

MSR3610-I-XS

Yes

MSR3610-IE-XS

Yes

MSR2630-XS

Yes

MSR3620-X1-XS

Yes

MSR3640-XS

Yes

MSR3660-XS

Yes

Hardware

EIGRP compatibility

MSR810-LM-GL

Yes

MSR810-W-LM-GL

Yes

MSR830-6EI-GL

Yes

MSR830-10EI-GL

Yes

MSR830-6HI-GL

Yes

MSR830-10HI-GL

Yes

MSR1004S-5G-GL

Yes

MSR2600-6-X1-GL

Yes

MSR3600-28-SI-GL

No

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.

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 for this argument varies by device model.

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

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.

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

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

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