No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference

CloudEngine 8800, 7800, 6800, and 5800 V200R002C50

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
IP Routing Basic Configuration Commands

IP Routing Basic Configuration Commands

NOTE:

The CE6810LI does not support IPv4 or IPv6 Layer 3 forwarding. After the IPv4 or IPv6 function is enabled on an interface of the CE6810LI, the configured IPv4 or IPv6 address can only be used to manage the switch.

direct-route ip preference

Function

The direct-route ip preference command configures a priority for direct subnet routes on an interface.

The undo direct-route ip preference command restores the default configuration.

By default, the priority is 0.

NOTE:
Only the CE6850HI, CE6850U-HI, CE6851HI, CE6855HI, CE6856HI, CE6860EI, CE6870EI, CE6880EI, CE7850EI, CE7855EI , CE8850EI, and CE8860EI switches support this command.

Format

direct-route ip preference preference-value

undo direct-route ip preference

Parameters

Parameter Description Value
preference-value Sets a priority for direct subnet routes on an interface. The value is an integer ranging from 0 to 255.A smaller value indicates a higher preference.

Views

VLANIF interface view and VBDIF interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a priority for direct subnet routes on an interface, run the direct-route ip preference command. After the command is run and the interface is Up, the priority of direct subnet routes on the interface is changed to the configured preference-value. Modifying the direct route priority can redirect traffic of which no ARP entry is learned to another device on the same network segment as the local device.

Precautions

  • After the command is executed on an interface, the newly configured priority takes effect on all direct subnet routes on the interface.
  • After the command is executed, the priority of direct host routes remains unchanged.

Example

# Set the priority of direct subnet routes on the VBDIF10 interface to 10.

<HUAWEI> system-view
[~HUAWEI] interface vbdif 10
[*HUAWEI-Vbdif10] direct-route ip preference 10

# Set the priority of direct subnet routes on the VLANIF interface to 10.

<HUAWEI> system-view
[~HUAWEI] interface vlanif 200
[*HUAWEI-Vlanif200] direct-route ip preference 10

display ip fib

Function

The display ip fib command displays information about the FIB table.

Format

display ip fib slot slot-id [ vpn-instance vpn-instance-name ] [ ip-address [ mask | mask-length ] ] [ verbose ]

display ip fib slot slot-id all-vpn-instance [ verbose ]

Parameters

Parameter Description Value
slot slot-id

Displays information about the FIB table with a specified stack ID.

The value is an integer and the value range depends on the device configuration.
vpn-instance vpn-instance-name Displays information about the FIB table of a specified VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
ip-address Displays information about the FIB table with the specified destination address. The value is in dotted decimal notation.
mask Specifies the mask of the destination IP address. The value is in dotted decimal notation.
mask-length Specifies the mask length of the destination IP address. The value is an integer that ranges from 0 to 32.
all-vpn-instance Displays information about the FIB tables of all VPN instances. -
verbose Displays detailed information about the FIB table. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display ip fib command displays information about the FIB table. Each row represents a route.

NOTE:
If there are lots of routes, using wildcard (|, begin, exclude, include, regular-expression) to display information or details lasts a long time. You can press Ctrl+C to terminate information display.

Example

# Display brief information about the FIB table.

<HUAWEI> display ip fib slot 1
Route Flags: G - Gateway Route, H - Host Route,    U - Up Route                 
             S - Static Route,  D - Dynamic Route, B - Black Hole Route         
--------------------------------------------------------------------------------
 FIB Table: _public_                                                            
 Total number of Routes: 17                                                     
                                                                                
 Destination/Mask   Nexthop          Flag   Interface       TunnelID            
255.255.255.255/32  127.0.0.1        U      InLoopBack0      -                  
        0.0.0.0/0   192.168.80.1     GSU    MEth0/0/0        -                  
      127.0.0.0/8   127.0.0.1        U      InLoopBack0      -                  
       10.1.1.0/24  10.1.1.1         U      10GE4/0/4        -                  
     172.16.1.0/24  172.16.1.2       U      10GE4/0/6        -                  
   192.168.80.0/24  192.168.80.182   U      MEth0/0/0        -                  
   172.16.100.0/24  172.16.1.1       DGU    10GE4/0/6        -                  
      127.0.0.1/32  127.0.0.1        HU     InLoopBack0      -                  
       10.1.1.1/32  127.0.0.1        HU     10GE4/0/4        -                  
     172.16.1.2/32  127.0.0.1        HU     10GE4/0/6        -                  
       10.1.1.9/32  172.16.1.1       DGHU   10GE4/0/6        -                  
       10.2.2.9/32  127.0.0.1        HU     LoopBack1        -                  
 192.168.80.182/32  0.0.0.0          HU     MEth0/0/0        -                  
     10.1.1.255/32  127.0.0.1        U      10GE4/0/4        -                  
   172.16.1.255/32  127.0.0.1        U      10GE4/0/6        -                  
 192.168.80.255/32  0.0.0.0          U      MEth0/0/0        -                  
127.255.255.255/32  127.0.0.1        U      InLoopBack0      -                

# Display information starting from the line that contains 169.254.0.0

Table 9-193  Description of the display ip fib command output

Item

Description

Destination/Mask

Destination address or mask length.

Nexthop

Next hop.

Flag

Current flag, which is the combination of G, H, U, S, D, B and T.
  • G (gateway route): indicates that the next hop is a gateway.

  • H (host route): indicates that the route is a host route.

  • U (available route): indicates that the route status is Up.

  • S (static route): indicates that the route is manually configured.

  • D (dynamic route): indicates that the route is generated based on the routing algorithm.

  • B (blackhole route): indicates that the next hop is a null interface.

Interface

Outbound interface to the destination address.

TunnelID

Index of a forwarding entry. It is used in packet forwarding between the upstream and downstream boards.

# Display detailed information about the FIB table.

<HUAWEI> display ip fib slot 4 verbose
                                                                                                                                    
 FIB Table: _public_                                                                                                                
 Total number of Routes: 9                                                                                                          
                                                                                                                                    
 Destination:  0.0.0.0              Mask     :  0.0.0.0                                                                             
 NHP        :  0.0.0.0              OutIf    :  NULL0                                                                               
 LocalAddr  :  0.0.0.0              LocalMask:  0.0.0.0                                                                             
 Flags      :  BGSU                 Age      :  0                                                                                   
 ATIndex    :  0                    Slot     :                                                                                      
 LspFwdFlag :  0                    LspToken :  0x0                                                                                 
 OutLabel   :  0                    OriginAs :  0                                                                                   
 BGPNhp     :  0                    PeerAs   :  0                                                                                   
 QosInfo    :  0                    OriginQos:  0                                                                                   
 VlanID     :  0                                                                                                                    
 BGPKey     :  0                                                                                                                    
 BGPKeyBak  :  0                                                                                                                    
 NhpBak     :  0.0.0.0              OutIfBak   :  NULL0                                                                             
 LspTokenBak:  0x0                  OutLabelBak:  0                                                                                 
 LspToken_ForInLabelBak     : 0x0                                                                                                   
 Nexthop_ForLspTokenBak     : 0.0.0.0                                                                                               
 OutIf_ForLspTokenBak       : [No Intf]                                                                                             
 Nexthop_ForLspToken_ForInLabelBak   : 0.0.0.0                                                                                      
 OutIf_ForLspToken_ForInLabelBak     : [No Intf]                                                                                    
 LspType         : 0               Label_ForLspTokenBak   : 0x0                                                                     
 MplsMtu         : 0               Gateway_ForLspTokenBak : 0.0.0.0                                                                 
 NextToken       : 0               IfIndex_ForLspTokenBak : 0                                                                       
 Label_NextToken : 0               Label : 0                                                                                        
 LspBfdState     : 0                                                                                                                
...
Table 9-194  Description of the display fib verbose command output

Item

Description

Destination

Destination address.

Mask

Mask.

NHP

Next hop.

OutIf

Outbound interface.

LocalAddr

Local IP address.

LocalMask

Mask of the local IP address.

Flags

Current flag, which is the combination of G, H, U, S, D, and B.

  • G (gateway route): indicates that the next hop is a gateway.
  • H (host route): indicates that the route is a host route.
  • U (available route): indicates that the route status is Up.
  • S (static route): indicates that the route is manually configured.

  • D (dynamic route): indicates that the route is generated based on the routing algorithm.

  • B (blackhole route): indicates that the next hop is a null interface.

Age

Lifetime of a route, in seconds.

ATIndex

Index of the virtual link connecting the local end and the gateway.

Slot

Slot ID of the outbound interface.

LspFwdFlag

Forwarding flag of an LSP.

LspToken

Forwarding ID of an LSP.

OutLabel

Outer tag of a VPN LSP.

OriginAs

Original AS number.

BGPNhp

Address of the BGP next hop.

PeerAs

Neighbor AS number.

QosInfo

QoS information.

OriginQos

Original QoS information.

VlanID

VLAN ID.

BgpKey

Key value of the BGP route.

BgpKeyBak

Backup key value of the BGP route.

NhpBak

Backup of the next hop.

OutIfBak

Backup of the outbound interface.

LspTokenBak

Backup of the LSP ID.

OutLabelBak

Backup of the VPN LSP outer label.

LspToken_ForInLabelBak

LSP ID backup in the backup inner label of a VPN LSP.

Nexthop_ForLspTokenBak

Backup next hop of the LSP ID.

OutIf_ForLspTokenBak

Backup outbound interface of the LSP ID.

Nexthop_ForLspToken_ForInLabelBak

Backup next hop of backup LSP ID in the VPN LSP inner label.

OutIf_ForLspToken_ForInLabelBak

Backup outbound interface of backup LSP ID in the VPN LSP inner label.

LspType

LSP type.

Label_ForLspTokenBak

Backup label of the LSP.

MplsMtu

MTU of MPLS packets.

Gateway_ForLspTokenBak

Next hop of the backup LSP.

NextToken

Token of the tunnel.

IfIndex_ForLspTokenBak

Backup outbound interface of the LSP.

Label_NextToken

Label of the tunnel.

Label

Label of the current LSP.

LspBfdState

Status of the BFD session that detects an LSP.

display ip fib statistics

Function

The display ip fib statistics command displays the total number of IPv4 FIB entries.

Format

display ip fib slot slot-id [ vpn-instance vpn-instance-name | all-vpn-instance ] statistics

Parameters

Parameter Description Value
slot slot-id

Displays status information about a specified IPv4 FIB module.

The value is an integer and the value range depends on the device configuration.

vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-vpn-instance Displays the FIB tables of all VPN instances. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display the total number of IPv4 FIB entries.

<HUAWEI> display ip fib slot 2 statistics
Route Entry Count of VPN _public_  : 30
Table 9-195  Description of the display ip fib statistics command output

Item

Description

Route Entry Count of VPN _public_

Total number of FIB entries.

display ip routing-table

Function

The display ip routing-table command displays information about an IPv4 routing table.

Format

display ip routing-table [ vpn-instance vpn-instance-name ] [ table-name table-name ] [ time-range min-age max-age ] [ verbose ]

display ip routing-table [ vpn-instance vpn-instance-name ] [ table-name table-name ] ip-address [ mask | mask-length ] [ longer-match ] [ verbose ]

display ip routing-table [ vpn-instance vpn-instance-name ] [ table-name table-name ] ip-address1 { mask1 | mask-length1 } ip-address2 { mask2 | mask-length2 } [ verbose ]

display ip routing-table [ vpn-instance vpn-instance-name ] ip-prefix ip-prefix-name [ verbose ]

display ip routing-table all-routes

display ip routing-table all-vpn-instance [ verbose ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of an VPN instance of an enabled IPv4 address family. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.The VPN must already exist.
table-name table-name
Displays a routing table of a specified type:
  • localmt: local multi-topology routing table. If information about the routing table of an IPv4 VPN instance needs to be queried, only the localmt parameter is supported.

  • mbgp: multicast BGP routing table.

  • msr: multicast static routing table.

NOTE:

The CE6810LI support only the direct and static routing protocols.

-
verbose Displays detailed information about active routes and inactive routes. If this keyword is not specified, only brief information about active routes is displayed. -
time-range Displays routes that are generated within a specified period. -
min-age Specifies the start generation time. The value is a string of 1 to 15 characters, in the format of XXdXXhXXmXXs.
max-age Specifies the end generation time. The value is a string of 1 to 15 characters, in the format of XXdXXhXXmXXs.
ip-address Displays the routes with the specified destination address. The value is in dotted decimal notation.
longer-match Displays the routes with the specified destination address and mask. -
mask Specifies the mask of the destination IP address. The value is in dotted decimal notation.
mask-length Specifies the mask length of the destination IP address. The value is an integer that ranges from 0 to 32.
ip-address1 Specifies the start IP address in an IP address range. ip-address1 and ip-address2 determine an IP address range. Only the routes in the IP address range are displayed. The value is in dotted decimal notation.
ip-address2 Specifies the end IP address in an IP address range. ip-address1 and ip-address2 determine an IP address range. Only the routes in the IP address range are displayed. The value is in dotted decimal notation.
mask1 Specifies the subnet mask of the start IP address. The value is in dotted decimal notation.
mask-length1 Specifies the mask length of the start IP address. The value is an integer that ranges from 0 to 32.
mask2 Specifies the subnet mask of the end IP address. The value is in dotted decimal notation.
mask-length2 Specifies the mask length of the end IP address. The value is an integer that ranges from 0 to 32.
ip-prefix ip-prefix-name Displays the routes that match the specified IP prefix list. If the specified IP prefix list does not exist, information about all active routes is displayed. The name is a string of 1 to 169 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.The ip-prefix-name must already exist.
all-vpn-instance Specifies all VPN instances. -
all-routes Displays information about the IPv4 routes of public and all VPN instances. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If the verbose keyword is not specified in the display ip routing-table command, each line in the command output indicates a route, including the destination address, mask length, protocol, preference, cost, flag, next hop, and outbound interface of the route.

NOTE:

An iterated route is counted as one route regardless of how many outbound interfaces and next hops the route finds.

Matching rules vary with parameters in the command:

  • If the display ip routing-table ip-address command is used, the routes with the longest matched destination address are displayed.

  • If the display ip routing-table ip-address mask command is used, the routes that accurately match the destination address and mask are displayed.

  • If the display ip routing-table ip-address longer-match command is used, all the route emtries that all the route entries that match the destination IP addresses within the natural mask range are displayed.

  • If the display ip routing-table ip-address mask longer-match command is used, all the routes that match the IP address specified by the destination address and the input mask are displayed.

  • If the display ip routing-table ip-address1 mask1 ip-address2 mask2 command is used, the routes whose destination address ranges from ip-address1 mask1 to ip-address2 mask2 are displayed.

Example

# Display brief information about the current IPv4 routing table. The command output shows that there are two static routes with the same destination address 10.1.1.1/32 but different next hops.

<HUAWEI> display ip routing-table
Proto: Protocol        Pre: Preference
Route Flags: R - relay, D - download to fib, T - to vpn-instance, B - black hole route
------------------------------------------------------------------------------
Routing Table: _public_
         Destinations : 8        Routes : 9

   Destination/Mask  Proto  Pre  Cost  Flags   NextHop   Interface

        10.1.1.1/32   Static  60     0     D    0.0.0.0    NULL0
                     Static  60     0     D    192.168.0.2  Vlanif100
      192.168.0.0/24   Direct   0     0     D    192.168.0.1  Vlanif100
      192.168.0.1/32   Direct   0     0     D    127.0.0.1  Vlanif100
    192.168.0.255/32   Direct   0     0     D    127.0.0.1  Vlanif100
      127.0.0.0/8    Direct   0     0     D    127.0.0.1  InLoopBack0
      127.0.0.1/32   Direct   0     0     D    127.0.0.1  InLoopBack0
127.255.255.255/32   Direct   0     0     D    127.0.0.1  InLoopBack0
255.255.255.255/32   Direct   0     0     D    127.0.0.1  InLoopBack0
Table 9-196  Description of the display ip routing-table command output

Item

Description

Route Flags

Route flag:
  • R: indicates an iterated route.
  • D: indicates a route that is downloaded to the FIB.
  • T: indicates a route whose next hop belongs to a VPN instance.
  • B: indicates a black-hole route.

Routing Table: _Public_

The routing table is a public routing table. If the routing table is a private routing table, a private network name is displayed, for example, Routing Tables: ABC.

Destinations

Total number of destination networks or hosts.

Routes

Total number of routes.

Destination/Mask

Address and mask length of the destination network or host.

Proto

Routing protocol that learns a route.

Pre

Preference of a route.

Cost

Cost of a route.

Flags

Route flags in the heading of the routing table.

NextHop

Next-hop address of a route.

Interface

Outbound interface to which the next hop of a route is reachable.

# Display the summary of the routing table of the IPv4 VPN instance named vpn1.

<HUAWEI> display ip routing-table vpn-instance vpn1
Proto: Protocol        Pre: Preference
Route Flags: R - relay, D - download to fib, T - to vpn-instance, B - black hole route
------------------------------------------------------------------------------
Routing Table: vpn1
         Destinations : 5        Routes : 5

Destination/Mask    Proto  Pre  Cost     Flags NextHop         Interface

       10.1.1.0/24  Direct 0    0           D  10.1.1.1        Vlanif10
       10.1.1.1/32  Direct 0    0           D  127.0.0.1       Vlanif10
     10.1.1.255/32  Direct 0    0           D  127.0.0.1       Vlanif10
       10.5.5.0/24  Static 60   0          RD  10.1.1.2        Vlanif10
255.255.255.255/32  Direct 0    0           D  127.0.0.1       InLoopBack0
Table 9-197  Description of the display ip routing-table vpn-instance command output

Item

Description

Route Flags

Route flag:
  • R: indicates an iterated route.
  • D: indicates a route that is downloaded to the FIB.
  • T: indicates a route whose next hop belongs to a VPN instance.
  • B: indicates a black-hole route.

Routing Table: vpn1

VPN routing table named vpn1.

Destinations

Total number of destination networks or hosts.

Routes

Total number of routes.

Destination/Mask

Address and mask length of the destination network or host.

Proto

Routing protocol.

Pre

Preference.

Cost

Route cost.

Flags

Route flag, that is, Route Flags in the heading of the routing table.

NextHop

Next hop.

Interface

Outbound interface to which the next hop is reachable.

# Display detailed information about the IPv4 routing table.

<HUAWEI> display ip routing-table verbose
Route Flags: R - relay, D - download to fib, T - to vpn-instance, B - black hole route
------------------------------------------------------------------------------
Routing Table: _public_
         Destinations : 8        Routes : 8


Destination: 10.0.0.36/32
     Protocol: Direct           Process ID: 0
   Preference: 0                      Cost: 0
      NextHop: 127.0.0.1         Neighbour: 0.0.0.0
        State: Active Adv              Age: 01h03m56s
          Tag: 0                  Priority: high
        Label: NULL                QoSInfo: 0x0
   IndirectID: 0x0
 RelayNextHop: 0.0.0.0           Interface: InLoopBack0
     TunnelID: 0x0                   Flags:  D

Destination: 10.10.36.0/24
     Protocol: Direct           Process ID: 0
   Preference: 0                      Cost: 0
      NextHop: 10.10.36.2        Neighbour: 0.0.0.0
        State: Active Adv              Age: 00h26m36s
          Tag: 0                  Priority: high
        Label: NULL                QoSInfo: 0x0
   IndirectID: 0x0
 RelayNextHop: 0.0.0.0           Interface: Vlanif10
     TunnelID: 0x0                   Flags:  D

Destination: 10.10.36.2/32
     Protocol: Direct           Process ID: 0
   Preference: 0                      Cost: 0
      NextHop: 127.0.0.1         Neighbour: 0.0.0.0
        State: Active Adv              Age: 00h26m46s
          Tag: 0                  Priority: high
        Label: NULL                QoSInfo: 0x0
   IndirectID: 0x0
 RelayNextHop: 0.0.0.0           Interface: Vlanif10
     TunnelID: 0x0                   Flags:  D

Destination: 10.10.36.255/32
     Protocol: Direct           Process ID: 0
   Preference: 0                      Cost: 0
      NextHop: 127.0.0.1         Neighbour: 0.0.0.0
        State: Active Adv              Age: 00h26m46s
          Tag: 0                  Priority: high
        Label: NULL                QoSInfo: 0x0
   IndirectID: 0x0
 RelayNextHop: 0.0.0.0           Interface: Vlanif10
     TunnelID: 0x0                   Flags:  D

Destination: 127.0.0.0/8                                                        
     Protocol: Direct           Process ID: 0                                   
   Preference: 0                      Cost: 0                                   
      NextHop: 127.0.0.1         Neighbour: 0.0.0.0                             
        State: Active NoAdv            Age: 3d01h20m39s                         
          Tag: 0                  Priority: high                                
        Label: NULL                QoSInfo: 0x0                                 
   IndirectID: 0x0                                                              
 RelayNextHop: 0.0.0.0           Interface: InLoopBack0                         
     TunnelID: 0x0                   Flags:  D                                  
                                                                                
Destination: 127.0.0.1/32                                                       
     Protocol: Direct           Process ID: 0                                   
   Preference: 0                      Cost: 0                                   
      NextHop: 127.0.0.1         Neighbour: 0.0.0.0                             
        State: Active NoAdv            Age: 3d01h20m39s                         
          Tag: 0                  Priority: high                                
        Label: NULL                QoSInfo: 0x0                                 
   IndirectID: 0x0                                                              
 RelayNextHop: 0.0.0.0           Interface: InLoopBack0                         
     TunnelID: 0x0                   Flags:  D                                  
                                                                                
Destination: 127.255.255.255/32                                                 
     Protocol: Direct           Process ID: 0                                   
   Preference: 0                      Cost: 0                                   
      NextHop: 127.0.0.1         Neighbour: 0.0.0.0                             
        State: Active NoAdv            Age: 3d01h20m46s                         
          Tag: 0                  Priority: high                                
        Label: NULL                QoSInfo: 0x0                                 
   IndirectID: 0x0                                                              
 RelayNextHop: 0.0.0.0           Interface: InLoopBack0                         
     TunnelID: 0x0                   Flags:  D 

Destination: 255.255.255.255/32                                                 
     Protocol: Direct           Process ID: 0                                   
   Preference: 0                      Cost: 0                                   
      NextHop: 127.0.0.1         Neighbour: 0.0.0.0                             
        State: Active NoAdv            Age: 3d01h20m54s                         
          Tag: 0                  Priority: high                                
        Label: NULL                QoSInfo: 0x0                                 
   IndirectID: 0x0                                                              
 RelayNextHop: 0.0.0.0           Interface: InLoopBack0                         
     TunnelID: 0x0                   Flags:  D  
Table 9-198  Description of the display ip routing-table verbose command output

Item

Description

Route Flags

Route flag:
  • R: indicates an iterated route.
  • D: indicates a route that is downloaded to the FIB.
  • T: indicates a route whose next hop belongs to a VPN instance.
  • B: indicates a black-hole route.

Destinations

Total number of destination networks or hosts.

Routes

Total number of active routes and inactive routes.

Destination

Address and mask length of the destination network or host.

Protocol

Routing protocol of a route.

Process ID

Routing protocol process ID of a route.

Preference

Preference of a route.

Cost

Cost of a route.

NextHop

Next-hop address of a route.

Neighbour

Neighbor address of a route.

State

Status of a route:
  • Active: active route

  • Invalid: invalid route

  • Inactive: inactive route

  • NoAdv: route that cannot be advertised

  • Adv: route that can be advertised

  • Del: route to be deleted

  • Relied: route iterated to an outbound interface and a next hop or route iterated to a tunnel

  • Stale: route that is marked Stale and used in GR

Age

Lifetime of a route.

Tag

Routing management tag. The value is an integer that ranges from 0 to 4294967295.

Priority

Convergence priority of route:

  • low

  • medium

  • high

  • critical

Label

VPN label.

QoSInfo

QoS information. The value 0x0 indicates that QoS information is empty.

IndirectID

ID of indirect next hop.

RelayNextHop

Iterated next-hop address.

Interface

Outbound interface.

TunnelID

Tunnel ID.

Flags

Route flags in the heading of the routing table.

display ip routing-table limit

Function

The display ip routing-table limit command displays limits on the number of IPv4 routes and prefixes.

Format

display ip routing-table limit [ all-vpn-instance | vpn-instance vpn-instance-name ]

Parameters

Parameter Description Value
all-vpn-instance Indicates all IPv4 VPN instances. -
vpn-instance vpn-instance-name Specifies the name of a IPv4 VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The command displays limits on the number of IPv4 routes and prefixes.
  • The display ip routing-table limit command displays limits on the number of IPv4 public routes and prefixes.
  • The display ip routing-table limit all-vpn-instance command displays the limit on the number of routes and prefixes of all IPv4 VPN instances.
  • The display ip routing-table limit vpn-instance vpn-instance-name command displays the limit on the number of routes and prefixes of a specified IPv4 VPN instance.

Example

# Display the limits on the number of IPv4 public routes and prefixes.
<HUAWEI> display ip routing-table limit
_public_ Instance
Limit-Object Limit-Type     Upper-Limit  Warning    Current    Log-Interval
Route        Default        -            -          0          5           
Prefix       Default        -            -          0          5

# Display limits on the numbers of routes and prefixes of all IPv4 VPN instances.

<HUAWEI> display ip routing-table limit all-vpn-instance
Limit-Object Limit-Type     Upper-Limit  Warning    Current    Log-Interval     
----------------------------------------------------------------------------    
VPN Instance Name: vpn1                                                         
Route        Default        -            -          1          5                
Prefix       Alert-Percent  1000         800        1          5                
----------------------------------------------------------------------------    
VPN Instance Name: vpn2                                                         
Route        Default        -            -          1          5                
Prefix       Default        -            -          1          5                

# Display limits on the numbers of routes and prefixes of the IPv4 VPN instance named vpn1.

<HUAWEI> display ip routing-table limit vpn-instance vpn1
VPN Instance Name: vpn1                                                         
Limit-Object Limit-Type     Upper-Limit  Warning    Current    Log-Interval     
Route        Default        -            -          1          5                
Prefix       Alert-Percent  1000         800        1          5        
Table 9-199  Description of the display ip routing-table limit command output

Item

Description

Limit-Object

Object whose total number is limited:
  • Prefix

  • Route

Limit-Type

Limit type for the routes and prefixes in the routing table:
  • Simply-Alert: indicates that only alarms are generated when the number of routes or prefixes exceeds the upper limit.

  • Alert-Percent: indicates the percentage of the alarm threshold of routes.

  • Default: indicates that the number of routes or prefixes is not limited by default.

Upper-Limit

Upper limit of routes or prefixes in the current routing table.

Warning

Alarm threshold of routes or prefixes in the current routing table.

Current

Number of routes or prefixes in the current routing table.

Log-Interval

Frequency of displaying logs when the number of routes or prefixes in the current routing table exceeds the upper limit, in seconds.

The default value is 5s.

display ip routing-table protocol

Function

The display ip routing-table protocol command displays routing information about a specified routing protocol.

Format

display ip routing-table [ vpn-instance vpn-instance-name ] [ table-name table-name ] protocol protocol [ time-range min-age max-age ] [ inactive | verbose ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of an VPN instance of an enabled IPv4 address family. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.The VPN must already exist.
table-name table-name
Displays a routing table of a specified type:
  • localmt: local multi-topology routing table. If information about the routing table of an IPv4 VPN instance needs to be queried, only the localmt parameter is supported.

  • mbgp: indicates an MBGP routing table.

  • msr: indicates a multicast static routing table.

NOTE:

CE6810LI does not support table-name parameters.

-
protocol Displays routing information about the specified routing protocol:
  • direct: displays direct routes.

  • static: displays static routes.

  • bgp: displays BGP routes.

  • isis: displays IS-IS routes.

  • ospf: displays OSPF routes.

  • rip: displays RIP routes.

-
time-range Displays routes that are generated within a specified period. -
min-age Specifies the start generation time. The value is a string of characters, in the format of XXdXXhXXmXXs.
max-age Specifies the end generation time. The value is a string of characters, in the format of XXdXXhXXmXXs.
inactive Displays brief information about inactive routes only. -
verbose Displays detailed information about active routes and inactive routes. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If neither verbose nor inactive is specified, brief information about all the routes of each routing protocol is displayed.

Example

# Display brief information about all direct routes.

<HUAWEI> display ip routing-table protocol direct
Proto: Protocol        Pre: Preference
Route Flags: R - relay, D - download to fib, T - to vpn-instance, B - black hole route
------------------------------------------------------------------------------
_public_ Routing Table : Direct
         Destinations : 7        Routes : 7  

Direct routing table status : <Active>
         Destinations : 7        Routes : 7  

Destination/Mask    Proto   Pre  Cost      Flags NextHop         Interface

   10.137.216.0/23  Direct  0    0           D   10.137.217.210  Vlanif100
 10.137.217.210/32  Direct  0    0           D   127.0.0.1       Vlanif100
 10.137.217.255/32  Direct  0    0           D   127.0.0.1       Vlanif100
      127.0.0.0/8   Direct  0    0           D   127.0.0.1       InLoopBack0
      127.0.0.1/32  Direct  0    0           D   127.0.0.1       InLoopBack0
127.255.255.255/32  Direct  0    0           D   127.0.0.1       InLoopBack0
255.255.255.255/32  Direct  0    0           D   127.0.0.1       InLoopBack0

Direct routing table status : <Inactive>
         Destinations : 0        Routes : 0  
Table 9-200  Description of the display ip routing-table protocol command output

Item

Description

Route Flags

Route flag:
  • R: indicates an iterated route.
  • D: indicates a route that is downloaded to the FIB.
  • T: indicates a route whose next hop belongs to a VPN instance.
  • B: indicates a black-hole route.

_public_ Routing Table

Contents of a public routing table.

Direct routing table status

Status of direct routes:
  • Inactive: inactive routes in the routing table

  • Active: active routes in the routing table

Destinations

Total number of destination addresses.

Routes

Total number of routes in the routing table.

Destination/Mask

Destination address or mask length.

Proto

Routing protocol of a route.

Pre

Routing protocol preference of a route.

Cost

Cost of a route.

Flags

Route flags in the heading of the routing table.

Nexthop

Next-hop address of a route.

Interface

Outbound interface of a route.

display ip routing-table route-number

Function

The display ip routing-table route-number command displays the number of routes of a public network or a specified VPN instance in which the IPv4 address family is enabled.

Format

display ip routing-table [ vpn-instance vpn-instance-name ] [ table-name table-name ] route-number

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays the number of routes of the specified VPN instance in which the IPv4 address family is enabled. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
table-name table-name
Displays a routing table of a specified type:
  • localmt: local multi-topology routing table

  • mbgp: multicast BGP routing table

    This keyword is unavailable when the vpn-instance vpn-instance-name parameter is specified.

  • msr: multicast static routing table

    This keyword is unavailable when the vpn-instance vpn-instance-name parameter is specified.

NOTE:

CE6810LI does not support table-name parameter.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use the display ip routing-table route-number command to view the number of routes of a public network or a specified VPN instance in which the IPv4 address family is enabled.

Example

# Display the total number of routes in the local multi-topology routing table of VPN instance vpn1.

<HUAWEI> display ip routing-table vpn-instance vpn1 table-name localmt route-number
Total route number: 5
Table 9-201  Description of the display ip routing-table route-number command output

Item

Description

Total route number

Total number of routes.

display ip routing-table statistics

Function

The display ip routing-table statistics command displays statistics about routes in an IPv4 routing table.

Format

display ip routing-table [ vpn-instance vpn-instance-name ] [ table-name table-name ] statistics

display ip routing-table[ all-vpn-instance ] statistics

display ip routing-table all-routes statistics

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays statistics about routes in the routing table of a specified VPN instance. If neither vpn-instance vpn-instance-name nor all-vpn-instance is specified, statistics about routes in a public routing table are displayed. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
table-name table-name
Displays a routing table of a specified type:
  • localmt: local multi-topology routing table. If information about the routing table of an IPv4 VPN instance needs to be queried, only the localmt parameter is supported.

  • mbgp: multicast BGP routing table.

  • msr: multicast static routing table.

NOTE:

CE6810LI does not support table-name parameter.

-
all-vpn-instance Displays statistics about routes in the routing tables of all VPN instances. If neither vpn-instance vpn-instance-name nor all-vpn-instance is specified, statistics about routes in a public routing table are displayed. -
all-routes

Specifies all IPv4 routes.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Route statistics include:
  • Total number of routes that are added or deleted through routing protocols
  • Number of active or inactive routes that are labeled for deletion but are not deleted

Example

# Display statistics about routes in an IPv4 routing table.

<HUAWEI> display ip routing-table statistics
Summary Prefixes: 9
Protocol total    active  added      deleted
         routes   routes  routes     routes
DIRECT   6        6       42         36
STATIC   3        3       21         18
RIP      0        0       0          0
OSPF     0        0       0          0
IS-IS    0        0       0          0
BGP      0        0       0          0
Total    9        9       63         54
Table 9-202  Description of the display ip routing-table statistics command output

Item

Description

Summary Prefixes

Total number of prefixes in the current routing table.

Protocol

Routing protocol type

total routes

Total number of routes that a routing protocol learns in the routing table, including active and inactive routes.

active routes

Number of active routes that a routing protocol learns in the routing table.

added routes

Number of active and inactive routes that are added to the routing table through a routing protocol.

deleted routes

Number of routes to be deleted from the routing table.

freed routes

Number of routes that are permanently deleted from the routing table.

display ipv6 fib

Function

The display ipv6 fib command displays FIB entries on the device.

Format

display ipv6 fib slot slot-id [ vpn-instance vpn-instance-name ] [ ipv6-address [ prefix-length ] ] [ verbose ]

display ipv6 fib slot slot-id [ vpn-instance vpn-instance-name ] statistics

display ipv6 fib slot slot-id all-vpn-instance [ statistics | verbose ]

Parameters

Parameter Description Value
slot slot-id Specifies the stack ID. -
ipv6-address Specifies the prefix of an IPv6 address. The value is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.
statistics Displays the summary of FIB entries. -
all-vpn-instance Displays all FIB entries of all VPN instance. -
vpn-instance vpn-instance-name Displays FIB entries of the specified VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
prefix-length Specifies the prefix length of an IPv6 address. The value is an integer that ranges from 1 to 128.
verbose Displays detailed information about FIB entries. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display all FIB entries on slot 4.

<HUAWEI> display ipv6 fib slot 4
Route Flags: G - Gateway Route, H - Host Route,    U - Up Route                 
             S - Static Route,  D - Dynamic Route, B - Black Hole Route         
--------------------------------------------------------------------------------
FIB Table:_public_                                                              
Total number of Routes: 4                                                      
                                                                                
Destination :  FC00:0:0:2000::                             PrefixLength : 64    
NHP         :  FC00:0:0:2000::1                            Flag         : U     
Interface   :  10GE4/0/3                                   TunnelID     : -     
                                                                                
                                                                                
Destination :  FE80::                                      PrefixLength : 10    
NHP         :  ::                                          Flag         : BU    
Interface   :  NULL0                                       TunnelID     : -     
                                                                                
                                                                                
Destination :  ::FFFF:127.0.0.0                            PrefixLength : 104   
NHP         :  ::FFFF:127.0.0.1                            Flag         : U     
Interface   :  InLoopBack0                                 TunnelID     : -     
                                                                                
                                                                                
Destination :  FC00:0:0:2000::100                          PrefixLength : 128   
NHP         :  ::1                                         Flag         : HU    
Interface   :  NULL0                                       TunnelID     : -     
                                                                                
Table 9-203  Description of the display ipv6 fib command output

Item

Description

Destination

Destination IPv6 address of a route.

PrefixLength

Prefix length of the destination IPv6 address.

NHP

Next hop that forwards packets to the destination address.

Flag

Description of route characteristics using S/U/G/H/B/D:
  • S: static

  • U: Up

  • G: gateway

  • H: host

  • B. blackhole

  • D: dynamic

Interface

Outbound interface through which packets are forwarded.

Tunnel ID

ID of the tunnel. If packets are forwarded using IP forwarding, the tunnel ID of the packets is 0.

# Display detailed information about the IPv6 FIB table.

<HUAWEI> display ipv6 fib slot 1 fc00:0:0:2001:: verbose
Route Flags: G - Gateway Route, H - Host Route,    U - Up Route                 
             S - Static Route,  D - Dynamic Route, B - Black Hole Route         
--------------------------------------------------------------------------------
IPv6 FIB Table: _public_                                                        
Total number of Routes: 1                                                       
                                                                                
Destination  : FC00:0:0:2001::                          PrefixLength : 64       
                                                                                
Flag         : U                                                                
Nexthop      : FC00:0:0:2001::1                         Interface    : 10GE1/0/3
                                                                                
Tunnel ID    : -                                        Label        : 0        
                                                                                
BgpNexthop   : 0                                        OriginAs     : 0        
                                                                                
PeerAs       : 0                                                                
NexthopBak   : ::                                       InterfaceBak : NULL0    
                                                                                
Tunnel ID Bak: -                                        LabelBak     : 0        
                                                                                
BgpNexthopBak: 0                                        OriginAs     : 0        
                                                                                
PeerAs       : 0                                                                
Table 9-204  Description of the display ipv6 fib verbose command output

Item

Description

Destination

Destination IPv6 address of a route.

PrefixLength

Prefix length of the destination IPv6 address.

Nexthop

Next-hop router that forwards packets to the destination address.

Flag

Description of route characteristics using S/U/G/H/B/D:
  • S: static

  • U: Up

  • G: gateway

  • H: host

  • B. blackhole

  • D: dynamic

Interface

Outbound interface through which packets are forwarded.

Tunnel ID

ID of the tunnel. If packets are forwarded to the next hop using MPLS forwarding, the tunnel ID of the packets cannot be 0. If packets are forwarded using IP forwarding, the tunnel ID of the packets is 0.

Label

Private network label.

BgpNexthop

BGP next-hop address.

NexthopBak

Backup next hop.

InterfaceBak

Backup outbound interface.

Tunnel ID Bak

Backup tunnel ID.

LabelBak

Inner private network label.

BgpNexthopBak

Backup BGP next-hop address.

OriginAs

Original AS number.

PeerAs

Peer AS number.

display ipv6 routing-table

Function

The display ipv6 routing-table command displays information about an IPv6 routing table.

Format

display ipv6 routing-table [ vpn-instance vpn-instance-name ] [ table-name table-name ] [ time-range min-age max-age ] [ verbose ]

display ipv6 routing-table [ vpn-instance vpn-instance-name ] [ table-name table-name ] ipv6-address [ prefix-length ] [ longer-match ] [ verbose ]

display ipv6 routing-table [ vpn-instance vpn-instance-name ] [ table-name table-name ] ipv6-address1 [ prefix-length1 ] ipv6-address2 prefix-length2 [ verbose ]

display ipv6 routing-table [ vpn-instance vpn-instance-name ] ipv6-prefix ipv6-prefix-name [ verbose ]

display ipv6 routing-table all-routes

display ipv6 routing-table all-vpn-instance [ verbose ]

display ipv6 routing-table brief

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of a VPN instance of an enabled IPv6 address family. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.The VPN must already exist.
table-name table-name Specifies the name of a specified routing table. This parameter can be specified as localmt, indicating a local multi-topology routing table.
NOTE:

The CE6810LI does not support the table-name parameter.

-
verbose Displays detailed information about all the routes in the current routing table, including active and inactive routes. -
ipv6-address Displays the routes with the specified IPv6 destination address. The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
prefix-length Specifies the prefix length of an IPv6 destination address. The value is an integer that ranges from 0 to 128.
longer-match Displays the routes with the specified destination address and mask. -
ipv6-address1 Specifies the start IPv6 address in an IP address range. ipv6-address1 and ipv6-address2 determine an IP address range. Only the routes in the IP address range are displayed. The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
ipv6-address2 Specifies the end IPv6 address in an IP address range. ipv6-address1 and ipv6-address2 determine an IP address range. Only the routes in the IP address range are displayed. The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
prefix-length1 Specifies the mask length of the start IPv6 address. The value is an integer that ranges from 0 to 128.
prefix-length2 Specifies the mask length of the end IPv6 address. The value is an integer that ranges from 0 to 128.
ipv6-prefix ipv6-prefix-name Displays the routes that match the specified IPv6 prefix list. If the specified IPv6 prefix list does not exist, information about all active routes is displayed. The name is a string of 1 to 169 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
all-routes Displays information about the IPv6 routes of public and all VPN instances. -
time-range Displays routes that are generated within a specified period. -
min-age Specifies the start generation time. The value is a string of characters, in the format of XXdXXhXXmXXs.
max-age Specifies the end generation time. The value is a string of characters, in the format of XXdXXhXXmXXs.
all-vpn-instance Specifies all VPN instances. -
brief Displays brief information about active routes in the current routing table. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If the verbose keyword is not specified, the command output includes the destination address, prefix length, protocol type, preference, cost, next hop, outbound interface, tunnel ID, flag, and status of a route.

NOTE:

An iterated route is counted as one route regardless of how many outbound interfaces and next hops the route finds.

Example

# Display brief information about the current IPv6 routing table.

<HUAWEI> display ipv6 routing-table
Route Flags: R - relay, D - download to fib, B - black hole route 
---------------------------------------------------------------------------
Routing Table : _public_ 
         Destinations : 4        Routes : 4

 Destination  : ::1                             PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : InLoopBack0                     Flags        : D

 Destination  : FC00:0:0:112::                  PrefixLength : 64
 NextHop      : FC00:0:0:112::2                 Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : Vlanif10                        Flags        : D

 Destination  : FC00:0:0:112::2                 PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : Vlanif10                        Flags        : D

 Destination  : FE80::                          PrefixLength : 10
 NextHop      : ::                              Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : NULL0                           Flags        : D
Table 9-205  Description of the display ipv6 routing-table command output

Item

Description

Route Flags

Route flag:

  • R: indicates an iterated route.

  • D: indicates a route that is downloaded to the FIB.

  • B: indicates a black-hole rout

Routing Table : _public_

The routing table is a public routing table.

Destinations

Total number of destination networks or hosts.

Routes

Total number of routes.

Destination

IP address of the destination network or host of a route.

PrefixLength

Prefix length of a route.

NextHop

Next-hop IPv6 address of a route.

Preference

Preference of a route.

Cost

Cost of a route.

Protocol

Routing protocol of a route.

RelayNextHop

Iterated next-hop address.

TunnelID

Tunnel ID. The value 0x0 indicates that no tunnel is used or the tunnel fails to be established.

Interface

Outbound interface through which the next hop of a route can be reached.

Flags

Flag of a route:
  • R: The route is an iterated route.

  • D: The route is delivered to the FIB table.

# Display detailed information about the IPv6 routing table.

<HUAWEI> display ipv6 routing-table verbose
Route Flags: R - relay, D - download to fib, B - black hole route                                               
------------------------------------------------------------------------------                                             
Routing Table : _public_
         Destinations : 2        Routes : 2

 Destination  : ::1                             PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Neighbour    : ::                              ProcessID    : 0
 Label        : NULL                            Protocol     : Direct
 State        : Active NoAdv                    Cost         : 0
 Entry ID     : 1                               EntryFlags   : 0x80010050
 Reference Cnt: 1                               Tag          : 0
 Priority     : high                            Age          : 84410sec
 IndirectID   : 0x0                             Instance     : 
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : InLoopBack0                     Flags        : D

 Destination  : FC00:0:0:2001::1                PrefixLength : 128
 NextHop      : FC00:0:0:2002::2                Preference   : 60
 Neighbour    : ::                              ProcessID    : 0
 Label        : NULL                            Protocol     : Static
 State        : Active Adv Relied               Cost         : 0
 Entry ID     : 2                               EntryFlags   : 0x80020140
 Reference Cnt: 1                               Tag          : 0
 Priority     : high                            Age          : 79036sec
 IndirectID   : 0x80000001                      Instance     : 
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : NULL0                           Flags        : RD
Table 9-206  Description of the display ipv6 routing-table verbose command output

Item

Description

Neighbour

IPv6 address of a neighbor interface.

ProcessID

Routing protocol process ID of a route.

Label

Label carried in a route.

State

Status of a route:

  • Active: active route

  • Invalid: invalid route

  • Inactive: inactive route

  • NoAdv: route that cannot be advertised

  • Adv: route that can be advertised

  • Del: route to be deleted

  • Relied: route iterated to an outbound interface and a next hop or route iterated to a tunnel

  • Stale: route that is marked Stale and used in GR

Entry ID

ID of a routing entry in the routing table.

EntryFlags

Flag of a routing entry.

Reference Cnt

Number of times a route is referenced.

Tag

Routing management tag. The value is an integer that ranges from 0 to 4294967295.

Priority

Convergence priority of a route:

  • low

  • medium

  • high

  • critical

IndirectID

ID of indirect next hop.

Instance

Instance name of a route.

Age

Time when a route is generated.

# Display brief information about the routes with the specified IPv6 destination address.

<HUAWEI> display ipv6 routing-table fc00:0:0:111::1 64
Route Flags: R - relay, D - download to fib, B - black hole route 
---------------------------------------------------------------------------
Routing Table : _public_
Summary Count : 1

 Destination  : FC00:0:0:111::                  PrefixLength : 64
 NextHop      : FC00:0:0:111::2                 Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : Vlanif10                        Flags        : D

# Display the routes within the specified IPv6 address range.

<HUAWEI> display ipv6 routing-table fc00:0:0:111::1 64 fc00:0:0:111::2 128
Route Flags: R - relay, D - download to fib, B - black hole route 
---------------------------------------------------------------------------
Routing Table : _public_
Summary Count : 2

 Destination  : FC00:0:0:111::                  PrefixLength : 64
 NextHop      : FC00:0:0:111::2                 Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : Vlanif10                        Flags        : D

 Destination  : FC00:0:0:111::2                 PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : Vlanif10                        Flags        : D      

display ipv6 routing-table limit

Function

The display ipv6 routing-table limit command displays limits on the numbers of IPv6 routes and prefixes.

Format

display ipv6 routing-table limit [ all-vpn-instance | vpn-instance vpn-instance-name ]

Parameters

Parameter Description Value
all-vpn-instance Indicates all IPv6 VPN instances. -
vpn-instance vpn-instance-name Specifies the name of an IPv6 VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The command displays limits on the number of IPv6 routes and prefixes.
  • The display ipv6 routing-table limit command displays limits on the number of IPv6 public routes and prefixes.
  • The display ipv6 routing-table limit all-vpn-instance command displays the limit on the number of routes and prefixes of all IPv6 VPN instances.
  • The display ipv6 routing-table limit vpn-instance vpn-instance-name command displays the limit on the number of routes and prefixes of a specified IPv6 VPN instance.

Example

# Display the limits on the number of IPv6 public routes and prefixes.
<HUAWEI> display ipv6 routing-table limit
_public_ Instance                                                                                                                   
Limit-Object Limit-Type     Upper-Limit  Warning    Current    Log-Interval                                                         
Route        Default        -            -          -          -                                                                    
Prefix       Default        -            -          0          5    

# Display limits on the numbers of routes and prefixes of all IPv6 VPN instances.

<HUAWEI> display ipv6 routing-table limit all-vpn-instance
Limit-Object Limit-Type     Upper-Limit  Warning    Current    Log-Interval
----------------------------------------------------------------------------------
VPN Instance Name: VPN1
Route        Default        -            -          -          -                                                                    
Prefix       Default        -            -          0          5  
-----------------------------------------------------------------------------------
VPN Instance Name: VPN2
Route        Default        -            -          -          -                                                                    
Prefix       Simply-Alert   780          -          0          5 

# Display limits on the numbers of routes and prefixes of the IPv6 VPN instance named vpn1.

<HUAWEI> display ipv6 routing-table limit vpn-instance vpn1
VPN Instance Name: vpn1                                                                                                             
Limit-Object Limit-Type     Upper-Limit  Warning    Current    Log-Interval                                                         
Route        Default        -            -          -          -                                                                    
Prefix       Simply-Alert   770          -          0          5 
Table 9-207  Description of the display ipv6 routing-table limit command output

Item

Description

Limit-Object

Indicates the object whose total number is limited:
  • Prefix

  • Route

Limit-Type

Indicates the limit mode for the routes and prefixes in the current routing table:
  • Simply-Alert: indicates that only alarms are generated after the number of routes or prefixes exceeds the upper limit.

  • Alert-Percent: indicates the percentage of the alarm threshold of routes.

  • Default: indicates that the number of routes or prefixes is not limited by default.

Upper-Limit

Indicates the upper limit of routes or prefixes in the current routing table.

Warning

Indicates the alarm threshold of routes or prefixes in the current routing table.

Current

Indicates the number of routes or prefixes in the current routing table.

Log-Interval

Indicates the frequency of displaying logs when the number of routes or prefixes in the current routing table exceeds the upper limit, in seconds.

display ipv6 routing-table protocol

Function

The display ipv6 routing-table protocol command displays routing information about a specified IPv6 routing protocol.

Format

display ipv6 routing-table [ vpn-instance vpn-instance-name ] [ table-name table-name ] protocol protocol [ time-range min-age max-age ] [ inactive | verbose ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of a VPN instance of an enabled IPv6 address family. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.The VPN must already exist.
table-name table-name Specifies the name of a specified routing table. This parameter can be specified as localmt, indicating a local multi-topology routing table.
NOTE:

The CE6810LI does not support the table-name parameter.

-
protocol Displays routing information about the specified routing protocol:
  • direct: displays direct IPv6 routes.

  • static: displays static IPv6 routes.

  • bgp: displays BGP4+ routes.

  • ripng: displays RIPng routes.

  • isis: displays IS-IS IPv6 routes.

  • ospfv3: displays OSPFv3 routes.

NOTE:

The CE6810LI supports only the direct and static routing protocols.

-
inactive Displays information about inactive routes. If this parameter is not specified, information about all active and inactive routes is displayed. -
verbose Displays detailed information about active and inactive routes. If this keyword is not specified, only brief information about active routes is displayed. -
time-range Displays routes that are generated within a specified period. -
min-age Specifies the start generation time. The value is a string of characters, in the format of XXdXXhXXmXXs.
max-age Specifies the end generation time. The value is a string of characters, in the format of XXdXXhXXmXXs.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display brief information about all IPv6 direct routes.

<HUAWEI> display ipv6 routing-table protocol direct
Route Flags: R - relay, D - download to fib, B - black hole route                                               
----------------------------------------------------------------------------
_public_ Routing Table : Direct
Summary Count : 2

Direct routing table status  : < Active >
Summary Count : 2

 Destination  : ::1                             PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : InLoopBack0                     Flags        : D

 Destination  : FE80::                          PrefixLength : 10
 NextHop      : ::                              Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : NULL0                           Flags        : D

Direct routing table status  : < Inactive >
Summary Count : 0 
Table 9-208  Description of the display ipv6 routing-table protocol command output

Item

Description

Route Flags

Route flag:

  • R: indicates an iterated route.

  • D: indicates a route that is downloaded to the FIB.

  • B: indicates a black-hole rout

_public_ Routing Table

Contents of a public routing table:
  • Direct: direct IPv6 route

  • Static: static IPv6 route

  • bgp: BGP4+ route

  • ripng: RIPng route

  • isis: IS-IS IPv6 route

  • ospfv3: OSPFv3 route

Summary Count

Number of prefixes of routes.

Direct routing table status

Status of direct routes:
  • active: information about active routes
  • inactive: information about inactive routes

Destination

IP address of the destination network or host of a route.

PrefixLength

Prefix length of a route.

NextHop

Next-hop address of a route.

Preference

Routing protocol preference of a route.

Cost

Cost of a route.

Protocol

Routing protocol that learns a route.

RelayNextHop

Iterated next-hop address.

TunnelID

Tunnel ID. The value 0x0 indicates that no tunnel is used or the tunnel fails to be established.

Interface

Outbound interface through which the next hop of a route can be reached.

Flags

Flag of a route:
  • R: The route is an iterated route.

  • D: The route is delivered to the FIB table.

display ipv6 routing-table route-number

Function

The display ipv6 routing-table route-number command displays the number of routes on a public network or in a VPN instance enabled with an IPv6 address family.

Format

display ipv6 routing-table [ vpn-instance vpn-instance-name ] [ table-name table-name ] route-number

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays statistics about routes in the routing table of a specified VPN instance. If the vpn-instance-name is not specified, statistics about routes in a public routing table are displayed. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
table-name table-name Specifies the name of a specified routing table. This parameter can be specified as localmt, indicating a local multi-topology routing table.
NOTE:

CE6810LI does not support table-name parameters.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None.

Example

# Display statistics about routes.

<HUAWEI> display ipv6 routing-table route-number
    Total route number: 5
Table 9-209  Description of the display ip routing-table route-number command output

Item

Description

Total route number

Total number of routes.

display ipv6 routing-table statistics

Function

The display ipv6 routing-table statistics command displays statistics about routes in an IPv6 routing table.

Format

display ipv6 routing-table [ vpn-instance vpn-instance-name ] [ table-name table-name ] statistics

display ipv6 routing-table [ all-vpn-instance ] statistics

display ipv6 routing-table [ all-routes ] statistics

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays statistics about routes in the routing table of a specified VPN instance. If neither vpn-instance-name nor all-vpn-instance is specified, statistics about routes in a public routing table are displayed. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
all-vpn-instance Displays statistics about routes in the routing tables of all VPN instances. If neither vpn-instance-name nor all-vpn-instance is specified, statistics about routes in a public routing table are displayed. -
table-name table-name Specifies the name of a specified routing table. This parameter can be specified as localmt, indicating a local multi-topology routing table.
NOTE:

CE6810LI does not support table-name parameters.

-
all-routes

Specifies all IPv6 routes.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Route statistics include the total number of routes, number of added routes, and number of deleted routes.

Example

# Display statistics about routes in an IPv6 routing table.

<HUAWEI> display ipv6 routing-table statistics
Summary Prefixes : 15                                                                                                                
Protocol   route       active      added       deleted                                                                              
DIRECT     12          12          18          6
STATIC     0           0           0           0
RIPng      0           0           0           0
OSPFv3     0           0           0           0
IS-IS      4           3           4           0
BGP        0           0           0           0
Total      16          15          22          6                                                                                    
Table 9-210  Description of the display ipv6 routing-table statistics command output

Item

Description

Summary Prefixes

Total number of prefixes in the current routing table.

Protocol

Routing protocol type:
  • direct: direct IPv6 route

  • static: static IPv6 route

  • bgp: BGP4+ route

  • ripng: RIPng route

  • isis: IS-IS IPv6 route

  • ospfv3: OSPFv3 route

route

Total number of routes that a routing protocol learns in the routing table, including active and inactive routes.

active

Number of active routes of a routing protocol in the routing table.

added

Number of active and inactive routes that are added to the routing table through a routing protocol.

deleted

Number of routes that are deleted from the routing table.

display router id

Function

The display router id command displays the configured router ID.

Format

display router id [ vpn-instance vpn-instance-name ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays the configured router ID of the specified VPN instance. If this parameter is not specified, the configured router ID of the public network is displayed. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display the configured router ID.

<HUAWEI> display router id
RouterID:10.1.1.1

# Display the configured router ID of VPN instance vpna.

<HUAWEI> display router id vpn-instance vpna
RouterID:10.1.1.1

display snmp-agent trap feature-name fib all

Function

The display snmp-agent trap feature-name fib all command displays all trap messages of the FIB module.

Format

display snmp-agent trap feature-name fib all

Parameters

None

Views

All views

Default Level

3: Management level

Usage Guidelines

You can run the display snmp-agent trap feature-name fib all command to check status of all FIB traps. This status can be configured using the snmp-agent trap enable feature-name fib command.

Example

# Display all trap messages of the FIB module.

<HUAWEI>display snmp-agent trap feature-name fib all
------------------------------------------------------------------------------                                                      
Feature name: FIB                                                                                                                   
Trap number : 2                                                                                                                     
------------------------------------------------------------------------------                                                      
Trap name                      Default switch status   Current switch status                                                        
HwFwdDataSyncIncomplete        off                     off                                                                          
hwFwdDataSyncIncompleteResume  off                     off          
Table 9-211  Description of the display snmp-agent trap feature-name fib all command output

Item

Description

Feature name

Name of the module to which a trap message belongs.

Trap number

Number of trap messages.

Trap name

Name of a trap message of the FIB module.

Default switch status

Status of the default trap switch:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

Current switch status

Status of the current trap switch:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

display snmp-agent trap feature-name rm all

Function

The display snmp-agent trap feature-name rm all command displays all the alarms related to the Route Management (RM) module.

Format

display snmp-agent trap feature-name rm all

Parameters

None

Views

All views

Default Level

3: Management level

Usage Guidelines

Usage Scenario

The display snmp-agent trap feature-name rm all command displays the status of all the alarms related to the RM module.

Precautions

You can run the snmp-agent trap enable feature-name rm command to change the status of the alarms related to the RM module.

Example

# Display all alarms related to the RM module.

<HUAWEI>display snmp-agent trap feature-name rm all
------------------------------------------------------------------------------  
Feature name: RM   
Trap number : 10
------------------------------------------------------------------------------  
Trap name                      Default switch status   Current switch status    
hwIpv4PrefixExceed             on                      on                       
hwIpv4PrefixExceedClear        on                      on                       
...
Table 9-212  Description of the display snmp-agent trap feature-name rm all command output

Item

Description

Feature name

Name of the module to which alarms are related

Trap number

Number of alarms

Trap name

Names of the alarms related to the RM module

Default switch status

Default status of alarms, including:

  • on: enabled by default
  • off: disabled by default

Current switch status

Current status of alarms, including:

  • on: enabled
  • off: disabled

ecmp(load-balancing-profile view)

Function

The ecmp command sets the ECMP load balancing mode in a load balancing profile.

The undo ecmp command restores the default ECMP load balancing mode in a load balancing profile.

By default, ECMP load balancing is based on seed.

NOTE:

Only the CE6870EI supports this command.

Format

ecmp { src-interface | seed seed-data } *

undo ecmp [ src-interface | seed [ seed-data ] ] *

Parameters

Parameter

Description

Value

src-interface

Performs load balancing based on physical-layer source port numbers.

-

seed seed-data

Specifies the start hash value in the hash algorithm.

The value is an integer that ranges from 0 to 255. The default value is 1.

Views

Load-balancing-profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can use the ecmp command to set the load balancing mode of ECMP in a load balancing profile.

The undo ecmp command without any parameter specified restores the default configuration.

Example

# In the load balancing profile a, set the ECMP load balancing mode to src-interface.

<HUAWEI> system-view
[~HUAWEI] load-balance profile a
[*HUAWEI-load-balance-profile-a] ecmp src-interface

ecmp hash-mode

Function

The ecmp hash-mode command configures a hash algorithm for ECMP load balancing.

The undo ecmp hash-mode command restores the default hash algorithm for ECMP load balancing.

By default, the hash algorithm for ECMP load balancing is 2.

NOTE:

Only the CE6870EI supports this command.

Format

ecmp hash-mode hashmode-id

undo ecmp hash-mode [ hashmode-id ]

Parameters

Parameter

Description

Value

hashmode-id

Specifies the hash algorithm for ECMP load balancing.

The value is an integer that ranges from 1 to 13.

Views

Load balancing profile view

Default Level

2: Configuration level

Usage Guidelines

Different load balancing results will be achieved using different hash algorithms. You can select an appropriate value of hashmode-id according to the traffic model.

  • For Eth-Trunk, set hashmode-id to 1.
  • Packet-based load balancing applies to scenarios where the sequence of flows is insensitive. In this case, set hashmode-id to 3, 4, or 5.
  • When the destination IP address is variable, set hashmode-id to 1, 6, or 7.
  • When the destination MAC address and source IP address or source MAC address and source IP address are variable, set hashmode-id to 8.
  • When the source IP address is variable, set hashmode-id to 9.
  • When the source or destination MAC address is variable, set hashmode-id to 10.
  • For VXLAN packets, set hashmode-id to 12.

Other values of hashmode-id are used when incoming traffic is uneven. In this case, the default hash algorithm is recommended.

Example

# Set a hash algorithm for ECMP load balancing to 5.

<HUAWEI> system-view
[~HUAWEI] load-balance profile default
[*HUAWEI-load-balance-profile-default] ecmp hash-mode 5

ecmp local-preference enable

Function

The ecmp local-preference enable command enables the device to preferentially forward local traffic.

The undo ecmp local-preference enable command disables the device from preferentially forwarding local traffic.

By default, a device does not preferentially forward local traffic.

NOTE:

Only the CE6870EI supports this command.

Format

ecmp local-preference enable

undo ecmp local-preference enable

Parameters

None

Views

Load balancing profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a stack, to ensure reliable transmission, an inter-device interface is configured as the outbound interface of traffic for ECMP load balancing. When forwarding traffic, the stacked device may select the inter-device outbound interface based on the hash algorithm. This occupies bandwidth resources between devices and reduces traffic forwarding efficiency.

To solve the problem, run the ecmp local-preference enable command to enable the device to preferentially forward local traffic. Then traffic arriving at the local device is preferentially forwarded through the outbound interface of the local device. If there is no outbound interface on the local device, traffic is forwarded through the outbound interface on another device. This effectively saves inter-device bandwidth resources and improves traffic forwarding efficiency.

Precautions

Before configuring the device to preferential forward local traffic, ensure that the local outbound interface has sufficient bandwidth to forward local traffic; otherwise, traffic may be discarded.

This function is valid only for known unicast traffic but not for unknown unicast traffic.

Example

# Enable local traffic preferential forwarding in load balancing profile c1.

<HUAWEI> system-view
[~HUAWEI] load-balance profile cl
[*HUAWEI-load-balance-profile-cl] ecmp local-preference enable

ecmp universal-id

Function

The ecmp universal-id command configures the Hash algorithm offset of ECMP load balancing.

The undo ecmp universal-id command restores the default Hash algorithm offset of ECMP load balancing.

By default, the Hash algorithm offset of ECMP load balancing is 1.

NOTE:

Only the CE6870EI supports this command.

Format

ecmp universal-id universal-id

undo ecmp universal-id [ universal-id ]

Parameters

Parameter

Description

Value

universal-id

Sets the Hash algorithm offset of ECMP load balancing.

The value is an integer that ranges from 1 to 16.

Views

Load balancing profile view

Default Level

2: Configuration level

Usage Guidelines

If there are multiple equal-cost routes to the same destination, a device will select a forwarding path based on information such as IP address, MAC address, and port number of received packets. If four equal-cost routes to a destination IP address exist on the device, all traffic destined for the destination IP address will be evenly balanced among the four forwarding paths. Additionally, by default, the same forwarding path will be calculated for the same flow (with the same IP address, MAC address, and port number) through the Hash algorithm.

The Hash algorithm offset will affect the forwarding path calculated through the Hash algorithm. That is, if two devices have different Hash algorithm offsets, different outbound interfaces will be calculated for the same flow through the Hash algorithm on the two devices.

To forward the same flow along different paths on different devices, configure different Hash algorithm offsets on the devices.

Example

# Set the Hash algorithm offset of ECMP load balancing to 2.

<HUAWEI> system-view
[~HUAWEI] load-balance profile default
[*HUAWEI-load-balance-profile-default] ecmp universal-id 2

hashmode (ECMP View)

Function

The hashmode command configures a hash algorithm mode used in ECMP load balancing.

The undo hashmode command restores the default hash algorithm mode used in ECMP load balancing.

By default, the hash algorithm mode used in ECMP load balancing on the CE6880EI is 0, and that on non-CE6880EI switches is 4.

NOTE:

The CE6870EI does not support this command.

Format

hashmode hashmode-id

undo hashmode [ hashmode-id ]

Parameters

Parameter

Description

Value

hashmode-id

Specifies the hash algorithm used in ECMP load balancing.

The value is an integer. On the CE5810EI, the value range is 0 to 4; on the CE6880EI, the value is 0 or 1;on other models, the value range is 0 to 8.

Views

ECMP view

Default Level

2: Configuration level

Usage Guidelines

If different hash algorithms are used for traffic sent from an ECMP, different load balancing results are obtained. You can select an appropriate value of hashmode-id according to the traffic model.

On non-CE6880EI switches:
  • When configuring a method for a pair of flows hashing to the same interface, set hashmode-id to 5.
  • When the destination IP address is variable, set hashmode-id to 5 or 6.
  • When the source IP address is variable, set hashmode-id to 5 or 8.
  • When the destination port is variable, set hashmode-id to 0, 5, or 8.
  • When the source port is variable, set hashmode-id to 2, 5, or 8.
  • When the source IP address and destination IP address are variable, set hashmode-id to 0, 1, 2, 3, or 6.
Other values of hashmode-id are used when incoming traffic is uneven. In this case, the default hash algorithm is recommended.
NOTE:

Analyzing unidirectional traffic of two communication parties is not enough. A server needs to analyze traffic between the two communication parties so that the traffic information can be fully analyzed. In this case, the packets of the two communication parties need to be forwarded to the same server. The device is required to support the algorithm based on the same source and destination in the specific forwarding procedure. Identical source and destination indicate that bidirectional data packets of a network connection must be sent out from the same outbound interface.

On the CE6880EI, the hash algorithm mode defaults to 0. In scenarios that are insensitive to packet sequence, you are advised to set the hash algorithm mode to 1 for per-packet load balancing.

Example

# Set the hash algorithm mode used in ECMP load balancing to 2 on the CE8860EI.

<HUAWEI> system-view
[~HUAWEI] load-balance ecmp
[~HUAWEI-ecmp] hashmode 2

# Set the hash algorithm mode used in ECMP load balancing to 1 on the CE6880EI.

<HUAWEI> system-view
[~HUAWEI] load-balance ecmp
[~HUAWEI-ecmp] hashmode 1

ip (ECMP view)

Function

The ip command configures a load balancing mode for IP packets in ECMP.

The undo ip command deletes the configured load balancing mode.

By default, IP packets are load balanced based on src-ip, dst-ip, l4-src-port, and l4-dst-port.
NOTE:

Only the CE6880EI supports this command.

Format

ip { src-ip | dst-ip | vlan | l4-src-port | l4-dst-port | protocol | src-interface | dscp } *

undo ip [ src-ip | dst-ip | vlan | l4-src-port | l4-dst-port | protocol | src-interface | dscp ] *

Parameters

Parameter

Description

Value

src-ip

Performs load balancing based on the source IP address.

-

dst-ip

Performs load balancing based on the destination IP address.

-

vlan

Performs load balancing based on the VLAN ID.

-

l4-src-port

Performs load balancing based on the transport-layer source port.

-

l4-dst-port

Performs load balancing based on the transport-layer destination port.

-

protocol

Performs load balancing based on the protocol type.

-

src-interface

Performs load balancing based on the physical source port.

-

dscp

Performs load balancing based on the Differentiated Services CodePoint (DSCP).

-

Views

ECMP view

Default Level

2: Configuration level

Usage Guidelines

Precautions

If you run the ip command multiple times in the ECMP view, only the latest configuration takes effect.

Example

# Perform ECMP load balancing based on the source IP address and protocol number of IP packets.

<HUAWEI> system-view
[~HUAWEI] load-balance ecmp
[~HUAWEI-ecmp] ip src-ip protocol
Related Topics

ip frr (system view)

Function

The ip frr command enables IP FRR for public routes.

The undo ip frr command disables IP FRR for public routes.

By default, IP FRR is disabled for public routes.

Format

ip frr

undo ip frr

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When there are public routes generated by multiple routing protocols on a device, run the ip frr command on the device to enable IP FRR to immediately switch traffic among routes and ensure normal traffic forwarding if certain routes are faulty. The following example shows how IP FRR works:

Assume that there are two routes to the destination at 10.1.1.1 on a device. One is an OSPF route with preference 10, and the other is a static route with preference 60. When IP FRR is not enabled, the OSPF route is preferred. After IP FRR is enabled, IP FRR specifies the static route as the backup route of the OSPF route. Then the OSPF route functions as the primary route, and the static route functions as the backup route. When the OSPF route fails, the system immediately switches traffic to the static route to ensure normal traffic forwarding.

Precautions

After the ip frr command is run, the system automatically selects the inactive route as the backup of the active route.

A routing loop may occur after the ip frr command is used, because this command enables the routes generated by different routing protocols to back up each other. Therefore, exercise caution when you use the command.

Example

# Enable IP FRR for public routes in the system view.

<HUAWEI> system-view
[~HUAWEI] ip frr

ip prefix-limit

Function

The ip prefix-limit command configures a limit on the number of IPv4 public route prefixes.

The undo ip prefix-limit command restores the default configuration.

By default, the maximum number of IPv4 public route prefixes is not limited.

NOTE:

CE6810LI does not support this command.

Format

ip prefix-limit number { alert-percent [ route-unchanged ] | simply-alert }

undo ip prefix-limit

Parameters

Parameter Description Value
number

Specifies the maximum number of IPv4 public route prefixes.

The value is an integer, and the minimum value is 1. The maximum number is determined by the license file.
alert-percent

Specifies the percentage of the maximum number of IPv4 public route prefixes. If you specify alert-percent in the command, when the number of IPv4 public route prefixes exceeds the value calculated by (number x alert-percent) /100, an alarm is generated. Additional IPv4 public route prefixes can still be added to the routing table until the number of IPv4 public route prefixes reaches number. Subsequent route prefixes are discarded.

The value is an integer ranging from 1 to 100.
route-unchanged
Indicates that the routing table remains unchanged. If you decrease alert-percent after the number of IPv4 public route prefixes exceeds number, whether the routing table remains unchanged is determined by route-unchanged.
  • If you specify route-unchanged in the command, the routing table remains unchanged.

  • If you do not specify route-unchanged in the command, the system deletes the routes from the routing table and re-adds routes.

By default, the system deletes the routes from the routing table and re-adds routes.

-
simply-alert

Indicates the following function: If you specify simply-alert in the command, new IPv4 public route prefixes can still be added to the routing table and only an alarm is generated after the number of IPv4 public route prefixes exceeds number. However, when the total number of private and public route prefixes reaches the limit on the number of unicast route prefixes specified in the PAF file, subsequent IPv4 public route prefixes are discarded.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the switch imports a large number of routes, system performance may be affected when processing services because the routes consume a lot of system resources. To improve system security and reliability, you can run the ip prefix-limit command to configure a limit on the number of IPv4 public route prefixes. When the number of IPv4 public route prefixes exceeds the limit, an alarm is generated, prompting you to check whether unneeded IPv4 public route prefixes exist.

Configuration Impact

After the ip prefix-limit command is run, the switch may discard unneeded IPv4 public route prefixes.

Precautions

If you run the ip prefix-limit command for several times, the last configuration overrides previous configurations.

After the number of IPv4 public route prefixes exceeds the limit, note the following rules:
  • If you run the ip prefix-limit command to increase number or the undo ip prefix-limit command to delete the limit, the switch relearns IPv4 public route prefixes.
  • Direct and static routes can still be added to the IP routing table.

Example

# Configure simply-alert so that only an alarm is generated when the switch imports more than 10000 IPv4 public route prefixes.

<HUAWEI> system-view
[~HUAWEI] ip prefix-limit 10000 simply-alert

ip prefix-limit system threshold-alarm

Function

The ip prefix-limit system threshold-alarm command configures thresholds (one alarm threshold and one clear alarm threshold) for the number of IPv4 route prefixes on a device.

The undo ip prefix-limit system threshold-alarm command restores the default configuration.

By default, the alarm threshold for IPv4 route prefixes is 80%, and the clear alarm threshold for IPv4 route prefixes is 70%.

NOTE:

CE6810LI does not support this command.

Format

ip prefix-limit system threshold-alarm upper-limit upper-limit-value lower-limit lower-limit-value

undo ip prefix-limit system threshold-alarm

Parameters

Parameter Description Value
upper-limit upper-limit-value

Specifies the alarm threshold for the number of IPv4 route prefixes.

The value is an integer ranging from 1 to 100. If the value of upper-limit-value is 85, the alarm threshold is 85%.
NOTE:

Set a value less than or equal to 95 for upper-limit-value.

lower-limit lower-limit-value

Specifies the clear alarm threshold for the number of IPv4 route prefixes.

The value is an integer ranging from 1 to 100. If the value of lower-limit-value is 55, the clear alarm threshold is 55%.
NOTE:

lower-limit-value must be less than upper-limit-value. Set lower-limit-value to a value at least 10 less than upper-limit-value to prevent alarms from being frequently generated and cleared due to route flapping.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The number of IPv4 route prefixes that can be added to a routing table is limited. If the number exceeds the limit, new prefixes cannot be added to the routing table, which may interrupt services. To address this problem, configure an alarm threshold for the number of IPv4 route prefixes. The alarm informs users that an abnormality may exist and to take corrective actions.

You can run the ip prefix-limit system threshold-alarm command to configure the two thresholds based on the requirements of services.

  • When the number of IPv4 route prefixes reaches upper-limit-value, an alarm (RM_1.3.6.1.4.1.2011.5.25.145.10.3 hwIpv4PrefixThresholdExceed) is generated.

  • When the number of IPv4 route prefixes falls below lower-limit-value, a clear alarm (RM_1.3.6.1.4.1.2011.5.25.145.10.4hwIpv4PrefixThresholdExceedClear) is generated.

Precautions

The ip prefix-limit system threshold-alarm command can configure only two thresholds. An alarm is generated only when the following two conditions are met:
  • The alarm function is enabled for the routing management (RM) module using the snmp-agent trap enable feature-name rm command.
  • The number of IPv4 route prefixes on the device exceeds the alarm threshold.

Example

# Configure the alarm threshold for IPv4 route prefixes as 85% and the clear alarm threshold as 65%.

<HUAWEI> system-view
[~HUAWEI] ip prefix-limit system threshold-alarm upper-limit 85 lower-limit 65

ipv4 (ECMP view)

Function

The ipv4 command sets the load balancing mode of IPv4 packets, and TRILL packets in ECMP.

The undo ipv4 command deletes the configured load balancing mode of IPv4 packets.

By default, the load balancing mode of IPv4 packets, and TRILL packets in ECMP is as fallowed.
Table 9-213  Load balancing modes for different packets

Packets (on the Inbound Interface)

Default Load Balancing Mode

Configurable Load Balancing Mode

IPv4 packets src-ip, dst-ip, l4-src-port, and l4-dst-port

src-ip, dst-ip, l4-src-port, l4-dst-port, protocol, vlan, and src-interface

TRILL packets Non-IP packets are load balanced based on the inner src-mac, and dst-mac. IP packets are load balanced based on src-ip, dst-ip, l4-src-port, and l4-dst-port.

src-ip, dst-ip, l4-src-port, l4-dst-port

NOTE:

The CE6870EI and the CE6880EI do not support this command.

Format

ipv4 { src-ip | dst-ip | vlan | l4-src-port | l4-dst-port | protocol | src-interface } *

undo ipv4 [ src-ip | dst-ip | vlan | l4-src-port | l4-dst-port | protocol | src-interface ] *

Parameters

Parameter

Description

Value

src-ip

Configures ECMP load balancing based on the source IP address.

-

dst-ip

Configures ECMP load balancing based on the destination IP address.

-

vlan

Configures ECMP load balancing based on the VLAN ID.

-

l4-src-port

Configures ECMP load balancing based on the transport-layer source port.

-

l4-dst-port

Configures ECMP load balancing based on the transport-layer destination port.

-

protocol

Configures ECMP load balancing based on the protocol type.

-

src-interface

Configures ECMP load balancing based on the physical-layer source port.

-

Views

ECMP view

Default Level

2: Configuration level

Usage Guidelines

Precautions

If you run the ipv4 command multiple times in the ECMP view, only the latest configuration takes effect.

Per-flow load balancing is often performed on different packets in ECMP. If both per-packet load balancing and per-flow load balancing are configured on the switch, per-packet load balancing takes effect.

Example

# Perform ECMP load balancing on IPv4 packets based on the source IP address and protocol number.

<HUAWEI> system-view
[~HUAWEI] load-balance ecmp
[~HUAWEI-ecmp] ipv4 src-ip protocol
Related Topics

ipv6 (ECMP view)

Function

The ipv6 command configures the load balancing mode for IPv6 packets in equal-cost multi-path (ECMP).

The undo ipv6 command deletes the configured load balancing mode.

The following table lists the default and configurable load balancing modes of IPv6 packets.
Table 9-214  Load balancing modes of IPv6 packets

Packets (on the Inbound Interface)

Default Load Balancing Mode

Configurable Load Balancing Mode

IPv6 packets src-ipv6, dst-ipv6, l4-src-port, l4-dst-port

src-ipv6, dst-ipv6, l4-src-port, l4-dst-port, protocol, vlan, src-interface

NOTE:

This command is not supported on the CE6810LI, CE6870EI, and CE6880EI.

Format

ipv6 { src-ipv6 | dst-ipv6 | vlan | l4-src-port | l4-dst-port | protocol | src-interface } *

undo ipv6 [ src-ip | dst-ip | vlan | l4-src-port | l4-dst-port | protocol | src-interface ] *

Parameters

Parameter

Description

Value

src-ipv6

Performs load balancing based on the source IPv6 address.

-

dst-ipv6

Performs load balancing based on the destination IPv6 address.

-

vlan

Performs load balancing based on the VLAN ID.

-

l4-src-port

Performs load balancing based on the transport-layer source port.

-

l4-dst-port

Performs load balancing based on the transport-layer destination port.

-

protocol

Performs load balancing based on the protocol type.

-

src-interface

Performs load balancing based on the physical source port.

-

Views

ECMP view

Default Level

2: Configuration level

Usage Guidelines

Precautions

If you run the ipv6 command multiple times in the ECMP view, only the latest configuration takes effect.

Per-flow load balancing is often performed on different packets in ECMP. If both per-packet load balancing and per-flow load balancing are configured on the switch, per-packet load balancing takes effect.

If src-ipv6 and dst-ipv6 are specified for ECMP load balancing of IPv6 packets, the switch uses only the low 32 bits of the source and destination IPv6 addresses as the hash fields.

Example

# Perform ECMP load balancing based on the source IPv6 address and protocol number of IPv6 packets.

<HUAWEI> system-view
[~HUAWEI] load-balance ecmp
[~HUAWEI-ecmp] ipv6 src-ipv6 protocol
Related Topics

ipv6 frr (system view)

Function

The ipv6 frr command enables IPv6 FRR of the public network.

The undo ipv6 frr command disables IPv6 FRR of the public network.

By default, IPv6 FRR of the public network is not enabled.

NOTE:

CE6810LI does not support this command.

Format

ipv6 frr

undo ipv6 frr

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When there are public network routes generated by multiple types of routing protocols on a device, the ipv6 frr command can be used to enable IPv6 FRR to immediately switch traffic among routes and ensure the normal forwarding of traffic if certain routes are faulty.

Configuration Impact

When the ipv6 frr command is not run, the system only selects a group of optimal protocol routes as active routes. After the ipv6 frr command is run, the system selects a group of sub-optimal protocol routes as the backup of related active routes.

Precautions

A routing loop may occur after the ipv6 frr command is used, because the command is used to enable routes generated by different routing protocols to back up each other. Therefore, exercise caution when using the command.

Example

# Enable IPv6 FRR of the pubic network in the system view.

<HUAWEI> system-view
[~HUAWEI] ipv6 frr

ipv6 prefix-limit

Function

The ipv6 prefix-limit command configures a limit on the number of IPv6 public route prefixes.

The undo ipv6 prefix-limit command restores the default configuration.

By default, the maximum number of IPv6 public route prefixes is not limited.

NOTE:

CE6810LI does not support this command.

Format

ipv6 prefix-limit number { alert-percent [ route-unchanged ] | simply-alert }

undo ipv6 prefix-limit

Parameters

Parameter Description Value
number

Specifies the maximum number of IPv6 public route prefixes.

The value is an integer, and the minimum value is 1. The maximum number is determined by the license file.
alert-percent

Specifies the percentage of the maximum number of IPv6 public route prefixes. If you specify alert-percent in the command, when the number of IPv6 public route prefixes exceeds the value calculated by (number x alert-percent) /100, an alarm is generated. Additional IPv6 public route prefixes can still be added to the routing table until the number of IPv6 public route prefixes reaches number. Subsequent route prefixes are discarded.

The value is an integer ranging from 1 to 100.
route-unchanged
Indicates that the routing table remains unchanged. If you decrease alert-percent after the number of IPv6 public route prefixes exceeds number, whether the routing table remains unchanged is determined by route-unchanged.
  • If you specify route-unchanged in the command, the routing table remains unchanged.

  • If you do not specify route-unchanged in the command, the system deletes the routes from the routing table and re-adds routes.

By default, the system deletes the routes from the routing table and re-adds routes.

-
simply-alert

Indicates the following function: If you specify simply-alert in the command, new IPv6 public route prefixes can still be added to the routing table and only an alarm is generated after the number of IPv6 public route prefixes exceeds number. However, when the total number of private and public route prefixes reaches the limit on the number of unicast route prefixes specified in the PAF file, subsequent IPv6 public route prefixes are discarded.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the switch imports a large number of routes, system performance may be affected when processing services because the routes consume a lot of system resources. To improve system security and reliability, you can run the ipv6 prefix-limit command to configure a limit on the number of IPv6 public route prefixes. When the number of IPv6 public route prefixes exceeds the limit, an alarm is generated, prompting you to check whether unneeded IPv6 public route prefixes exist.

Configuration Impact

After the ipv6 prefix-limit command is run, the switch may discard unneeded IPv6 public route prefixes.

Precautions

If you run the ipv6 prefix-limit command for several times, the last configuration overrides previous configurations.

After the number of IPv6 public route prefixes exceeds the limit, note the following rules:
  • If you run the ipv6 prefix-limit command to increase number or the undo ipv6 prefix-limit command to delete the limit, the switch relearns IPv6 public route prefixes.
  • Direct and static routes can still be added to the IPv6 routing table.

Example

# Configure simply-alert so that only an alarm is generated when the switch imports more than 10000 IPv6 public route prefixes.

<HUAWEI> system-view
[~HUAWEI] ipv6 prefix-limit 10000 simply-alert

ipv6 prefix-limit system threshold-alarm

Function

The ipv6 prefix-limit system threshold-alarm command configures thresholds (one alarm threshold and one clear alarm threshold) for the number of IPv6 route prefixes on a device.

The undo ipv6 prefix-limit system threshold-alarm command restores the default configuration.

By default, the alarm threshold for IPv6 route prefixes is 80%, and the clear alarm threshold for IPv6 route prefixes is 70%.

NOTE:

CE6810LI does not support this command.

Format

ipv6 prefix-limit system threshold-alarm upper-limit upper-limit-value lower-limit lower-limit-value

undo ipv6 prefix-limit system threshold-alarm

Parameters

Parameter Description Value
upper-limit upper-limit-value

Specifies the alarm threshold for the number of IPv6 route prefixes.

The value is an integer ranging from 1 to 100. If the value of upper-limit-value is 85, the alarm threshold is 85%.
NOTE:

Set a value less than or equal to 95 for upper-limit-value.

lower-limit lower-limit-value

Specifies the clear alarm threshold for the number of IPv6 route prefixes.

The value is an integer ranging from 1 to 100. If the value of lower-limit-value is 55, the clear alarm threshold is 55%.
NOTE:

lower-limit-value must be less than upper-limit-value. Set lower-limit-value to a value at least 10 less than upper-limit-value to prevent alarms from being frequently generated and cleared due to route flapping.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The number of IPv6 route prefixes that can be added to a routing table is limited. If the number exceeds the limit, new prefixes cannot be added to the routing table, which may interrupt services. To address this problem, configure an alarm threshold for the number of IPv6 route prefixes. The alarm informs users that an abnormality may exist and to take corrective actions.

You can run the ipv6 prefix-limit system threshold-alarm command to configure the two thresholds based on the requirements of services.

  • When the number of IPv6 route prefixes reaches upper-limit-value, an alarm (RM_1.3.6.1.4.1.2011.5.25.145.11.3 hwIpv6PrefixThresholdExceed) is generated.

  • When the number of IPv6 route prefixes falls below lower-limit-value, a clear alarm (RM_1.3.6.1.4.1.2011.5.25.145.11.4 hwIpv6PrefixThresholdExceedClear) is generated.

Precautions

The ipv6 prefix-limit system threshold-alarm command can configure only two thresholds. An alarm is generated only when the following two conditions are met:
  • The alarm function is enabled for the routing management (RM) module using the snmp-agent trap enable feature-name rm command.
  • The number of IPv6 route prefixes on the device exceeds the alarm threshold.

Example

# Configure the alarm threshold for IPv6 route prefixes as 85% and the clear alarm threshold as 65%.

<HUAWEI> system-view
[~HUAWEI] ipv6 prefix-limit system threshold-alarm upper-limit 85 lower-limit 65

ip-tunnel (ECMP view)

Function

The ip-tunnel command configures a load balancing mode for GRE packets and 6over4 packets in ECMP.

The undo ip-tunnel command restores the default load balancing mode for GRE packets and 6over4 packets.

By default, non-IP packets are load balanced based on inner-src-ip, inner-dst-ip, inner-l4-sport, and inner-l4-dport; IP packets are load balanced based on src-ip, dst-ip, l4-src-port, and l4-dst-port.
NOTE:

Only the CE6880EI supports this command.

Format

ip-tunnel { inner-src-ip | inner-dst-ip | inner-l4-sport | inner-l4-dport } *

undo ip-tunnel [ inner-src-ip | inner-dst-ip | inner-l4-sport | inner-l4-dport ] *

Parameters

Parameter

Description

Value

inner-src-ip

Performs load balancing based on the inner source IP address.

-

inner-dst-ip

Performs load balancing based on the inner destination IP address.

-

inner-l4-sport

Performs load balancing based on the inner transport-layer source port.

-

inner-l4-dport

Performs load balancing based on the inner transport-layer destination port.

-

Views

ECMP view

Default Level

2: Configuration level

Usage Guidelines

Precautions

If you run the ip-tunnel command multiple times in the ECMP view, only the latest configuration takes effect.

Example

# Perform ECMP load balancing based on the source IP address and protocol number of GRE packets and 6over4 packets.

<HUAWEI> system-view
[~HUAWEI] load-balance ecmp
[~HUAWEI-ecmp] ip-tunnel inner-src-ip protocol
Related Topics

local-preference enable

Function

The local-preference enable command enables the device to preferentially forward local traffic.

The undo local-preference enable command disables the device from preferentially forwarding local traffic.

By default, a device does not preferentially forward local traffic.

NOTE:

The CE6870EI does not support this command.

Format

local-preference enable

undo local-preference enable

Parameters

None

Views

ECMP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a stack, to ensure reliable transmission, an inter-device interface is configured as the outbound interface of traffic for ECMP load balancing. When forwarding traffic, the stacked device may select the inter-device outbound interface based on the hash algorithm. This occupies bandwidth resources between devices and reduces traffic forwarding efficiency.

To solve the problem, run the local-preference enable command to enable the device to preferentially forward local traffic. Then traffic arriving at the local device is preferentially forwarded through the outbound interface of the local device. If there is no outbound interface on the local device, traffic is forwarded through the outbound interface on another device. This effectively saves inter-device bandwidth resources and improves traffic forwarding efficiency.

Precautions

Before configuring the device to preferential forward local traffic, ensure that the local outbound interface has sufficient bandwidth to forward local traffic; otherwise, traffic may be discarded.

This function is valid only for known unicast traffic but not for unknown unicast traffic.

Example

# Enable local traffic preferential forwarding.

<HUAWEI> system-view
[~HUAWEI] load-balance ecmp
[~HUAWEI-ecmp] local-preference enable

load-balance ecmp

Function

The load-balance ecmp command enables you to enter the ecmp view from the system view.

NOTE:

The CE6870EI does not support this command.

Format

load-balance ecmp

undo load-balance ecmp

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Before modifying the ECMP load balancing configuration, enter the ECMP view.

Example

# Enter the ecmp view.

<HUAWEI> system-view
[~HUAWEI] load-balance ecmp
[*HUAWEI-ecmp]

load-balance (ECMP View)

Function

The load-balance command configures random or round-robin per-packet load balancing in ECMP.

The undo load-balance command restores the default ECMP load balancing mode.

By default, random or round-robin per-packet load balancing is not configured in ECMP.

NOTE:

Only the CE8860EI, CE8850EI support this command.

Format

load-balance { random | round-robin }

undo load-balance { random | round-robin }

Parameters

Parameter

Description

Value

random

Configures random per-packet load balancing in ECMP.

-

round-robin

Configures round-robin per-packet load balancing in ECMP.

-

Views

ECMP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenarios

When traffic needs to be load balanced among different links using the hash algorithm, you can run the load-balance command to configure random or round-robin per-packet load balancing in ECMP, ensuring that traffic is load balanced among equal-cost routes and preventing link congestion.

The switch supports the following load balancing modes:

  • random mode: A route is randomly selected among multiple equal-cost routes to forward packets. When the IP address and MAC address of known unicast packets remain unchanged, configure random per-packet load balancing.
  • round-robin mode: Each equal-cost route, in turn, is used to forward packets. When known unicast packets have the similar length, configure round-robin per-packet load balancing.

Precautions

Both the random and round-robin modes cannot prevent packet mis-sequencing. To ensure packet sequencing, confirm that the device or terminal that receives traffic supports packet reassembly in case of packet mis-sequencing.

Example

# Configure random per-packet load balancing in ECMP.

<HUAWEI> system-view
[~HUAWEI] load-balance ecmp
[~HUAWEI-ecmp] load-balance random
Related Topics

load-balance ecmp stateful enable

Function

The load-balance ecmp stateful enable command enables the ECMP load balancing consistency function.

The undo load-balance ecmp stateful enable command disables the ECMP load balancing consistency function.

By default, the ECMP load balancing consistency function is disabled.

Format

load-balance ecmp stateful enable

undo load-balance ecmp stateful enable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a switch that participates in traffic load balancing becomes faulty, the number of equal-cost routes reduces, and so all traffic needs to be load balanced again using the hash algorithm. As a result, traffic forwarding paths may change. Requests of the same user may be sent to different servers, greatly affecting the services in which sessions need to be maintained. To prevent this problem, run the load-balance ecmp stateful enable command. This command enables the ECMP load balancing consistency function so that hash calculation is performed only for traffic on the faulty link, without affecting traffic on other normal links.

Prerequisites

To use ECMP load balancing consistency function, ensure that different destination addresses are reachable through the same or completely different equal-cost multiple paths.

Precautions

  • After enabling this function, do not change the configured load balancing hash algorithm, hash algorithm offset, and load balancing mode. Otherwise, this function may be unable to take effect.
  • This function may be unable to take effect when outbound ports of equal-cost links are intermittently disconnected.
  • Only the CE6810LI , CE5855EI, CE5850EI, and CE5810EI do not support this function.
  • The ECMP load balancing consistency function only takes effect only for common IPv4 traffic, but not for traffic transmitted over tunnels.
  • The ECMP load balancing consistency function is unable to take effect for IPv6 traffic.

Example

# Enable the ECMP load balancing consistency function.

<HUAWEI> system-view
[~HUAWEI] load-balance ecmp stateful enable

load-balance pppoe

Function

The load-balance pppoe command configures a load balancing mode for PPPoE packets.

The undo load-balance pppoe command deletes the load balancing mode of PPPoE packets or restores the default load balancing mode of PPPoE packets.

By default, PPPoE packets are load balanced as common Ethernet packets. By default, on the CE6870EI switch, PPPoE packets are load balanced based on src-mac, dst-mac, and vlan; on a non-CE6870EI switch, PPPoE packets are load balanced based on src-mac and dst-mac.

NOTE:

Only the CE6850HI, CE6850U-HI, CE6851HI, CE6855HI, CE6856HI, CE6860EI, CE6870EI, CE7850EI, CE7855EI, CE8850EI, and CE8860EI support this command.

Format

On a non-CE6870EI switch:

load-balance pppoe { session-id | l4-src-port { ppp-address-compression | ppp-protocol-compression | both | none } }

undo load-balance pppoe [ session-id | l4-src-port { ppp-address-compression | ppp-protocol-compression | both | none } ]

On the CE6870EI switch:

load-balance { eth-trunk | ecmp } pppoe { session-id | l4-src-port { ppp-address-compression | ppp-protocol-compression | both | none } }

undo load-balance { eth-trunk | ecmp } pppoe [ session-id | l4-src-port { ppp-address-compression | ppp-protocol-compression | both | none } ]

Parameters

Parameter

Description

Value

eth-trunk

Performs Eth-Trunk load balancing on PPPoE packets.

-

ecmp

Performs ECMP load balancing on PPPoE packets.

-

session-id

Load balances PPPoE packets based on the session ID.

-

l4-src-port

Load balances PPPoE packets based on the transport-layer source interface.

-

ppp-address-compression

Load balances PPPoE packets based on the PPP packets in which the address and control field are compressed.

-

ppp-protocol-compression

Load balances PPPoE packets based on the PPP packets in which the protocol field is compressed.

-

both

Load balances PPPoE packets based on the PPP packets in which the address and control field and protocol fields are compressed.

-

none

Load balances PPPoE packets based on the PPP packets in which the address and control field and protocol fields are not compressed.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, a CE switch processes received PPPoE packets as common Ethernet packets. In this situation, the switch can load balance the PPPoE packets based only on the source and destination MAC addresses of the packets. However, the destination MAC address is often a gateway MAC address, and the packets are actually load balanced based only on the source MAC address. As a result, the packets often cannot be evenly load balanced. To ensure that the packets are evenly load balanced, you can run the load-balance pppoe command. The configuration enables the switch to abstract inner information of the PPPoE packets for load balancing.

Precautions

  • If you run the load-balance pppoe command multiple times, only the latest configuration takes effect.

  • This command takes effect for both Eth-Trunk load balancing and ECMP load balancing.

  • Only non-encapsulated PPPoE packets on access switches can be load balanced.

Example

# Configure a CE8860EI switch to load balance PPPoE packets based on session-id.

<HUAWEI> system-view
[~HUAWEI] load-balance pppoe session-id 

mpls (ECMP view)

Function

The mpls command configures the load balancing mode of MPLS packets in equal-cost multi-path (ECMP).

The undo mpls command deletes the configured load balancing mode.

The following table lists the default and configurable load balancing modes of MPLS packets.
Table 9-215  Load balancing modes of MPLS packets

Packets (on the Inbound Interface)

Default Load Balancing Mode

Configurable Load Balancing Mode

MPLS packets

For IPv4 packets: src-ip, dst-ip

For IPv6 packets: src-ipv6, dst-ipv6

src-ip, dst-ip, src-ipv6, dst-ipv6, in-label, and out-label
NOTE:

Only the CE8860EI, CE8850EI, CE7855EI, CE7850EI, CE6860EI, CE6855HI, CE6856HI, CE6851HI, CE6850HI, and CE6850U-HI support this command.

Format

mpls { src-ip | dst-ip | src-ipv6 | dst-ipv6 | in-label | out-label } *

undo mpls { src-ip | dst-ip | src-ipv6 | dst-ipv6 | in-label | out-label }*

Parameters

Parameter

Description

Value

src-ip

Performs load balancing based on the source IP address.

-

dst-ip

Performs load balancing based on the destination IP address.

-

src-ipv6

Performs load balancing based on the source IPv6 address.

-

dst-ipv6

Performs load balancing based on the destination IPv6 address.

-

in-label

Performs load balancing based on the inner label.

-

out-label

Performs load balancing based on the outer label.

-

Views

ECMP view

Default Level

2: Configuration level

Usage Guidelines

Precautions

If you run the mpls command multiple times in the ECMP view, only the latest configuration takes effect.

Per-flow load balancing is often performed on different packets in ECMP. If both per-packet load balancing and per-flow load balancing are configured on the switch, per-packet load balancing takes effect.

If src-ipv6 and dst-ipv6 are specified for ECMP load balancing of MPLS IPv6 packets, the switch uses only the low 32 bits of the source and destination IPv6 addresses as the hash fields.

Example

# Perform ECMP load balancing based on the source IP address of IPv4 packets.

<HUAWEI> system-view
[~HUAWEI] load-balance ecmp
[~HUAWEI-ecmp] mpls src-ip 
Related Topics

reset ip routing-table statistics protocol

Function

The reset ip routing-table statistics protocol command clears route statistics in an IPv4 routing table.

Format

reset ip routing-table statistics protocol [ vpn-instance vpn-instance-name ] { all | protocol }

reset ip routing-table { all-vpn-instance | all-routes } statistics protocol { all | protocol }

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Clears route statistics in an IPv4 routing table of the specified VPN instance. If this parameter is not specified, route statistics in an IPv4 routing table of the public network are cleared. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
all Clear route statistics of all routing protocols in an IPv4 routing table. -
protocol Clears route statistics of the specified routing protocol in an IPv4 routing table. This parameter can be one of the following: direct, bgp, isis, ospf, rip, and static. -
all-vpn-instance Clears the statistics in the IPv4 routing tables of all VPN instances. -
all-routes All IPv4 routes. -

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can use this command to clear route statistics in an IPv4 routing table, including statistics about the routes added, deleted, and released by each routing protocol. Subsequently, the system can recollect route statistics of each routing protocol again to monitor route changes and locate network faults.

Precautions

IPv4 route statistics cannot be restored after being cleared. Exercise caution when you use this command.

Example

# Clear route statistics of all routing protocols in an IPv4 routing table.

<HUAWEI> reset ip routing-table statistics protocol all

reset ipv6 routing-table statistics protocol

Function

The reset ipv6 routing-table statistics protocol command clears route statistics in an IPv6 routing table.

Format

reset ipv6 routing-table [ all-vpn-instance | all-routes | vpn-instance vpn-instance-name ] statistics protocol { all | protocol }

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of an IPv6 VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
all Clear route statistics of all routing protocols in an IPv6 routing table. -
protocol Clears route statistics of the specified routing protocol in an IPv6 routing table. This parameter can be one of the following: bgp, direct, isis, ospfv3,ripng, and static. -
all-vpn-instance Clears the statistics in the IPv6 routing tables of all VPN instances. -
all-routes All IPv6 routes. -

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

You can use this command to clear route statistics of each routing protocol in an IPv6 routing table. Subsequently, the switch can recollect route statistics of each routing protocol to monitor route changes and locate network faults.

Precautions

IPv6 route statistics cannot be restored after being cleared. Exercise caution when you use this command.

Example

# Clear route statistics of all routing protocols in an IPv6 routing table.

<HUAWEI> reset ipv6 routing-table statistics protocol all

router id

Function

The router id command sets the router ID in RM.

The undo router id command deletes the configured router ID.

By default, the router ID in RM is 0.0.0.0 when no IPv4 interface address is configured.

Format

router id router-id

undo router id

Parameters

Parameter Description Value
router-id Sets a router ID in the IPv4 address format. The value is in dotted decimal notation.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Some dynamic routing protocols require that a router ID uniquely identify a device. If no router ID is specified when these protocols are started on a device, the router ID in RM is used by default.

The rules for selecting a router ID are as follows:

  1. If you set a router ID using the router id command, the configured router ID is used.

  2. If no router ID is set, the router ID is selected according to the following rules:

    • If loopback interfaces configured with IP addresses exist, the largest IP address among the IP addresses of the loopback interfaces is selected as the router ID.

    • If there is no loopback interface configured with an IP address, the highest IP address among the IP addresses of other interfaces is selected as the router ID, regardless of whether the interface is Up or Down.

    NOTE:
    The router ID is reselected only when the interface address that is selected as the router ID is deleted or changed. The router ID is not reselected in any of the following situations:
    • The interface is Down.
    • A loopback interface is configured when the IP address of a non-loopback interface is selected as the router ID.
    • A larger interface address is configured later.

    You can run the display router id command to view the router ID.

  3. Each VPN instance selects the router ID from the IP addresses of the interfaces in the VPN instance based on rules 1 and 2.

  4. When active and standby MPUs are installed, the system backs up the router ID set through the router id command and selects the router ID from IP addresses of interfaces. After the active/standby switchover is performed, the system checks the validity of the router ID selected from interface addresses. If the router ID is invalid, the system reselects a router ID.

After the router ID is changed, manually run the reset command for each routing protocol to make the new router ID take effect.

Precautions

NOTE:

To enhance network reliability, configure the address of a loopback interface as the router ID.

Example

# Set the router ID in RM to 10.10.10.1.

<HUAWEI> system-view
[~HUAWEI] router id 10.10.10.1
Related Topics

snmp-agent trap enable feature-name fib

Function

The snmp-agent trap enable feature-name fib command enables the trap function for the FIB module.

The undo snmp-agent trap enable feature-name fib command disables the trap function for the FIB module.

To view the trap name and trap function status of the FIB module, run the display snmp-agent trap feature-name fib all command.

Format

snmp-agent trap enable feature-name fib [ trap-name trap-name ]

undo snmp-agent trap enable feature-name fib [ trap-name trap-name ]

Parameters

Parameter Description Value
trap-name trap-name Specifies the name of a trap.

If this parameter is not specified, all the trap functions of the FIB module are enabled or disabled.

The value is an enumerated type.

To view the trap name of the FIB module, run the display snmp-agent trap feature-name fib all command.

Views

System view

Default Level

3: Management level

Usage Guidelines

To enable the NMS to easily manage the FIB module of the device, you can run the snmp-agent trap enable feature-name fib command to enables a FIB trap. The command configuration ensures that the traps generated during the device operation are sent to the NMS. Otherwise, FIB traps are not sent to the NMS.

Example

# Enables the trap in the case that thedevice changes from the overload forwarding state to the normal state.

<HUAWEI> system-view
[~HUAWEI] snmp-agent trap enable feature-name fib trap-name hwboardfwdreslack

snmp-agent trap enable feature-name rm

Function

The snmp-agent trap enable feature-name rm command enables the alarm function for the Route Management (RM) module.

The undo snmp-agent trap enable feature-name rm command disables the alarm function for the RM module.

To view the trap name and trap function status of the RM module, run the display snmp-agent trap feature-name rm all command.

Format

snmp-agent trap enable feature-name rm [ trap-name trap-name ]

undo snmp-agent trap enable feature-name rm [ trap-name trap-name ]

Parameters

Parameter Description Value
trap-name trap-name Specifies the name of a trap.

If this parameter is not specified, all the trap functions of the RM module are enabled or disabled.

The value is an enumerated type.

To view the trap name of the RM module, run the display snmp-agent trap feature-name rm all command.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To enable the NMS to easily manage the RM module of the device, you can run the snmp-agent trap enable feature-name rm command to enables a RM trap. The command configuration ensures that the traps generated during the device operation are sent to the NMS. Otherwise, RM traps are not sent to the NMS.

Example

# Enable the alarm function for the RM tunnel group reachable event.

<HUAWEI> system-view
[~HUAWEI] snmp-agent trap enable feature-name rm trap-name hwtunnelgroupup
Translation
Download
Updated: 2019-03-21

Document ID: EDOC1000166501

Views: 69564

Downloads: 374

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next