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

S7700 and S9700 V200R011C10

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 Table Management Commands

IP Routing Table Management Commands

Command Support

For details about command support, see the description of each command. If no command support information is provided, all switch models support the command by default.

apply fib-policy

Function

The apply fib policy command configures an IPv4 FIB policy on an LPU.

The undo apply fib policy command deletes an IPv4 FIB policy from an LPU.

By default, no IPv4 FIB policy is configured.

Format

apply fib-policy { no-route | public | vpn-instance vpn-instance-name &<1-6> } slot slot-id

undo apply fib-policy { all | no-route | public | vpn-instance vpn-instance-name &<1-6> } slot slot-id

Parameters

Parameter Description Value
no-route Indicates that the LPU does not receive any IPv4 forwarding entry delivered by the MPU. -
public Indicates that the LPU receives IPv4 public forwarding entries delivered by the MPU. -
vpn-instance vpn-instance-name Displays information about the FIB table of a specified IPv4 VPN instance. The value must be an existing VPN instance name. You can specify a maximum of six VPN instance names each time you use the apply fib policy command. You can configure IPv4 FIB policies for a maximum of 16 VPN instances on each LPU. Ensure that VPN instances have been created before running the apply fib policy command.
slot slot-id Specifies the slot ID of an LPU on which an IPv4 FIB policy needs to be configured. -
all Deletes all IPv4 FIB policies configured on an LPU. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

When configuring a FIB policy, do not specify both of the following parameters on the same LPU:

  • no-route and public

  • no-route and vpn-instance

You can specify the two parameters public and vpn-instance on the same LPU.

After running the apply fib-policy command, update the FIB entries on the LPU to make the configuration take effect.

Example

# Configure the LPU in slot 2 to receive only IPv4 public forwarding entries delivered by the MPU.

<HUAWEI> system-view
[HUAWEI] apply fib-policy public slot 2
Related Topics

apply ipv6 fib-policy

Function

The apply ipv6 fib-policy command configures an IPv6 FIB policy on an LPU.

The undo apply ipv6 fib-policy command deletes an IPv6 FIB policy from a specified LPU.

By default, no IPv6 FIB policy is configured.

Format

apply ipv6 fib-policy { no-route | public | vpn-instance vpn-instance-name &<1-6> } slot slot-id

undo apply ipv6 fib-policy { all | no-route | public | vpn-instance vpn-instance-name &<1-6> } slot slot-id

Parameters

Parameter Description Value
no-route Indicates that the LPU does not receive any IPv6 forwarding entry delivered by the MPU. -
public Indicates that the LPU receives IPv6 public forwarding entries delivered by the MPU. -
vpn-instance vpn-instance-name Specifies the name of an IPv6 VPN instance. The value must be an existing VPN instance name. You can specify a maximum of six IPv6 VPN instance names each time you use the apply ipv6 fib-policy command. You can configure IPv6 FIB policies for a maximum of 16 VPN instances on each LPU. Ensure that VPN instances have been created before running the apply ipv6 fib-policy command.
slot slot-id Specifies the slot ID of an LPU on which an IPv6 FIB policy needs to be configured. -
all Deletes all IPv6 FIB policies configured on an LPU. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

When configuring a FIB policy, do not specify both of the following parameters on the same LPU:

  • no-route and public

  • no-route and vpn-instance

You can specify the two parameters public and vpn-instance on the same LPU.

After running the apply ipv6 fib-policy command, update the IPv6 FIB entries on the LPU to make the configuration take effect.

Example

# Configure the LPU in slot 2 to receive only IPv6 public forwarding entries delivered by the MPU.

<HUAWEI> system-view
[HUAWEI] apply ipv6 fib-policy public slot 2
Related Topics

display ecmp-profile

Function

The display ecmp-profile command displays the equal cost multipath (ECMP) profile configuration.

Format

display ecmp-profile [ profile-name ]

Parameters

Parameter

Description

Value

profile-name

Displays the configuration of a specified ECMP profile.

The value is a string of 1 to 31 case-sensitive characters without spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If no ECMP profile is configured, no information is displayed after the display ecmp-profile command is run.

After the display ecmp-profile command is run, you can view the ECMP profile name and ECMP load balancing mode.

Example

# Display the ECMP profile name and ECMP load balancing mode.

<HUAWEI> display ecmp-profile test
ECMP-profile: test
Packet    HashField
----------------------------------------------------------------
IPV4      sip         l4-sport    l4-dport    sport
Table 7-203  Description of the display ecmp-profile command output

Item

Description

ECMP-profile

ECMP profile name.

Packet

Packet type. Currently, only IPv4 packets are supported.

HashField

ECMP load balancing mode. You can perform ECMP load balancing based on one or the combination of the following information:
  • dip: indicates ECMP load balancing based on the destination IP address.
  • l4-dport: indicates ECMP load balancing based on the transport-layer destination port number.
  • l4-sport: indicates ECMP load balancing based on the transport-layer source port number.
  • protocol: indicates ECMP load balancing based on the protocol number.
  • sip: indicates ECMP load balancing based on the source IP address.
  • sport: indicates ECMP load balancing based on the physical-layer source port.
  • vlan: indicates ECMP load balancing based on the VLAN ID.

To set the local discriminator, run the ipv4 field (ECMP profile view) command.

Related Topics

display fib ecmp resource

Function

The display fib ecmp resource command displays the equal cost multipath (ECMP) resource usage.

Format

display fib ecmp resource slot slot-id

Parameters

Parameter

Description

Value

slot-id

Displays the ECMP resource usage of a specified LPU.

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

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Because ECMP resources are not distributed continuously, remaining ECMP resources are not just total resources minus used resources, but determined by the distribution of resources at the lower layer. Resources at the lower layer are distributed according to available entries.

Example

# Display the ECMP profile name and ECMP load balancing mode.

<HUAWEI> display fib ecmp resource slot 1
Total ecmp resource:
 If all ecmps contain 32 nexthops, ecmp number:            64
 If all ecmps contain 16 nexthops, ecmp number:            128
 If all ecmps contain  8 nexthops, ecmp number:            256
 If all ecmps contain  4 nexthops, ecmp number:            512
 If all ecmps contain  2 nexthops, ecmp number:            1024

 Used ecmp resource:
 Number of used ecmp contains 32 nexthops:                 0
 Number of used ecmp contains 16 nexthops:                 0
 Number of used ecmp contains  8 nexthops:                 0
 Number of used ecmp contains  4 nexthops:                 0
 Number of used ecmp contains  2 nexthops:                 0

 Free ecmp resource:
 Number of free ecmp contains 32 nexthops:                 64
 Number of free ecmp contains 16 nexthops:                 128
 Number of free ecmp contains  8 nexthops:                 256
 Number of free ecmp contains  4 nexthops:                 512
 Number of free ecmp contains  2 nexthops:                 1024
Table 7-204  Description of the display fib ecmp resource command

Item

Description

Total ecmp resource

Total number of ECMP resources.

Used ecmp resource

Number of ECMP resources in use.

Free ecmp resource

Number of available ECMP resources.

display fib

Function

The display fib command displays information about the FIB table.

Format

display fib [ slot-id ] [ vpn-instance vpn-instance-name ] [ verbose ]

Parameters

Parameter Description Value
slot-id

Displays information about the FIB table with a specified slot 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 must be an existing VPN instance name.
verbose Displays detailed information about the FIB table. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display 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 fib
Route Flags: G - Gateway Route, H - Host Route,    U - Up Route                 
             S - Static Route,  D - Dynamic Route, B - Black Hole Route         
             L - Vlink Route
--------------------------------------------------------------------------------
 FIB Table:                                                                     
 Total number of Routes : 17                                                    
                                                                                
Destination/Mask   Nexthop         Flag  TimeStamp     Interface      TunnelID  
10.1.2.255/32      127.0.0.1       HU    t[1271813]    InLoop0        0x0       
10.1.2.3/32        127.0.0.1       HU    t[1271813]    InLoop0        0x0       
192.168.150.255/32 127.0.0.1       HU    t[132]        InLoop0        0x0       
192.168.150.203/32 127.0.0.1       HU    t[132]        InLoop0        0x0       
10.10.10.2/32      127.0.0.1       HU    t[42]         InLoop0        0x0       
10.10.10.9/32      127.0.0.1       HU    t[42]         InLoop0        0x0       
255.255.255.255/32 127.0.0.1       HU    t[38]         InLoop0        0x0       
127.255.255.255/32 127.0.0.1       HU    t[38]         InLoop0        0x0       
127.0.0.1/32       127.0.0.1       HU    t[38]         InLoop0        0x0       
10.22.2.1/32       127.0.0.1       HU    t[1219720]    InLoop0        0x0       
10.22.2.255/32     127.0.0.1       HU    t[1219720]    InLoop0        0x0       
127.0.0.0/8        127.0.0.1       U     t[38]         InLoop0        0x0       
192.168.150.0/24   192.168.150.203 U     t[132]        Eth0/0/0       0x0       
10.0.0.0/8         192.168.150.1   GSU   t[132]        Eth0/0/0       0x0       
172.16.2.0/24      10.2.2.1        U     t[1219720]    Vlanif22       0x0       
10.1.2.0/24        10.1.2.3        U     t[1271813]    Vlanif10       0x0       
10.11.1.0/24       192.168.150.1   GSU   t[1271813]    Eth0/0/0       0x0 

# Display information starting from the line that contains 169.254.0.0

<HUAWEI> display fib | begin 10.254.0.0
Destination/Mask  Nexthop   Flag  TimeStamp  Interface   TunnelID
10.254.0.0/16    10.2.1.1   U     t[0]       Vlanif10     0x0
10.12.0.0/16     10.2.1.1   U     t[0]       Vlanif10     0x0
127.0.0.0/8      127.0.0.1  U     t[0]       InLoop0      0x0

# Display all lines that contain Vlanif10.

<HUAWEI> display fib | include Vlanif10
Destination/Mask  Nexthop   Flag  TimeStamp  Interface  TunnelID
10.254.0.0/16    10.2.1.1   U     t[0]       Vlanif10    0x0
10.12.0.0/16     10.2.1.1   U     t[0]       Vlanif10    0x0

# Display all lines that do not include 10.1.2.0.

<HUAWEI> display fib | exclude 10.1.2.0 
                                                                                
Destination/Mask   Nexthop         Flag  TimeStamp     Interface      TunnelID  
10.1.2.255/32      127.0.0.1       HU    t[1271813]    InLoop0        0x0       
10.1.2.3/32        127.0.0.1       HU    t[1271813]    InLoop0        0x0       
192.168.150.255/32 127.0.0.1       HU    t[132]        InLoop0        0x0       
192.168.150.203/32 127.0.0.1       HU    t[132]        InLoop0        0x0       
10.10.10.2/32      127.0.0.1       HU    t[42]         InLoop0        0x0       
10.10.10.9/32      127.0.0.1       HU    t[42]         InLoop0        0x0       
255.255.255.255/32 127.0.0.1       HU    t[38]         InLoop0        0x0       
127.255.255.255/32 127.0.0.1       HU    t[38]         InLoop0        0x0       
127.0.0.1/32       127.0.0.1       HU    t[38]         InLoop0        0x0       
10.22.2.1/32       127.0.0.1       HU    t[1219720]    InLoop0        0x0       
10.22.2.255/32     127.0.0.1       HU    t[1219720]    InLoop0        0x0       
127.0.0.0/8        127.0.0.1       U     t[38]         InLoop0        0x0       
192.168.150.0/24   192.168.150.203 U     t[132]        Eth0/0/0       0x0       
10.0.0.0/8         192.168.150.1   GSU   t[132]        Eth0/0/0       0x0       
172.16.2.0/24      10.2.2.1        U     t[1219720]    Vlanif22       0x0       
10.11.1.0/24       192.168.150.1   GSU   t[1271813]    Eth0/0/0       0x0       
Table 7-205  Description of the display fib command output

Item

Description

Route Flags

Flag of a route.

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.

  • L: indicates a Vlink route.

TimeStamp

Timestamp, which indicates the time equal to FIB entry generation time minus system startup time.

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. If the value is not 0x0, packets matching the entry are forwarded through the MPLS tunnel. If the value is 0x0, packets matching the entry are not forwarded through the MPLS tunnel.

# Display detailed information about the FIB table.

<HUAWEI> display fib verbose
Route Flags: G - Gateway Route, H - Host Route,    U - Up Route                 
             S - Static Route,  D - Dynamic Route, B - Black Hole Route         
             L - Vlink Route
------------------------------------------------------------------------------  
 FIB Table:                                                                     
 Total number of Routes : 3                                                     
                                                                                
 Destination: 127.0.0.1           Mask     : 255.255.255.255                    
 Nexthop    : 127.0.0.1           OutIf    : InLoopBack0                        
 LocalAddr  : 127.0.0.1           LocalMask: 0.0.0.0                            
 Flags      : HU                  Age      : 354280sec                          
 ATIndex    : 0                   Slot     : 0                                  
 LspFwdFlag : 0                   LspToken : 0x0                                
 InLabel    : NULL                OriginAs : 0                                  
 BGPNextHop : 0.0.0.0             PeerAs   : 0                                  
 QosInfo    : 0x0                 OriginQos: 0x0                                
 NexthopBak : 0.0.0.0             OutIfBak : [No Intf]                          
 LspTokenBak: 0x0                 InLabelBak : NULL                             
 LspToken_ForInLabelBak : 0x0                                                   
 EntryRefCount : 0                                                              
 VlanId : 0x0                                                                   
 BgpKey : 0                                                                     
 BgpKeyBak : 0                                                                  
 LspType         : 0              Label_ForLspTokenBak   : 0                    
 MplsMtu         : 0              Gateway_ForLspTokenBak : 0.0.0.0              
 NextToken       : 0x0            IfIndex_ForLspTokenBak : 0                    
 Label_NextToken : 0              Label : 0                                     
 LspBfdState     : 0                                                            
                                                                                
 Destination: 127.255.255.255     Mask     : 255.255.255.255                    
 Nexthop    : 127.0.0.1           OutIf    : InLoopBack0                        
 LocalAddr  : 127.0.0.1           LocalMask: 0.0.0.0                            
 Flags      : HU                  Age      : 354280sec                          
 ATIndex    : 0                   Slot     : 0                                  
 LspFwdFlag : 0                   LspToken : 0x0                                
 InLabel    : NULL                OriginAs : 0                                  
 BGPNextHop : 0.0.0.0             PeerAs   : 0                                  
 QosInfo    : 0x0                 OriginQos: 0x0                                
 NexthopBak : 0.0.0.0             OutIfBak : [No Intf]                          
 LspTokenBak: 0x0                 InLabelBak : NULL                             
 LspToken_ForInLabelBak : 0x0                                                   
 EntryRefCount : 0                                                              
 VlanId : 0x0                                                                   
 BgpKey : 0                                                                     
 BgpKeyBak : 0                                                                  
 LspType         : 0              Label_ForLspTokenBak   : 0                    
 MplsMtu         : 0              Gateway_ForLspTokenBak : 0.0.0.0              
 NextToken       : 0x0            IfIndex_ForLspTokenBak : 0                    
 Label_NextToken : 0              Label : 0                                     
 LspBfdState     : 0                                                            
                                                                                
 Destination: 255.255.255.255     Mask     : 255.255.255.255                    
 Nexthop    : 127.0.0.1           OutIf    : InLoopBack0                        
 LocalAddr  : 127.0.0.1           LocalMask: 0.0.0.0                            
 Flags      : HU                  Age      : 354280sec                          
 ATIndex    : 0                   Slot     : 0                                  
 LspFwdFlag : 0                   LspToken : 0x0                                
 InLabel    : NULL                OriginAs : 0                                  
 BGPNextHop : 0.0.0.0             PeerAs   : 0                                  
 QosInfo    : 0x0                 OriginQos: 0x0                                
 NexthopBak : 0.0.0.0             OutIfBak : [No Intf]                          
 LspTokenBak: 0x0                 InLabelBak : NULL                             
 LspToken_ForInLabelBak : 0x0                                                   
 EntryRefCount : 0                                                              
 VlanId : 0x0                                                                   
 BgpKey : 0                                                                     
 BgpKeyBak : 0                                                                  
 LspType         : 0              Label_ForLspTokenBak   : 0                    
 MplsMtu         : 0              Gateway_ForLspTokenBak : 0.0.0.0              
 NextToken       : 0x0            IfIndex_ForLspTokenBak : 0                    
 Label_NextToken : 0              Label : 0                                     
 LspBfdState     : 0   
Table 7-206  Description of the display fib verbose command output

Item

Description

Destination

Destination address.

Mask

Mask.

Nexthop

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.
  • L: indicates a Vlink route.

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.

InLabel

Inner tag of a VPN LSP.

OriginAs

Original AS number.

BGPNextHop

Address of the BGP next hop.

PeerAs

Neighbor AS number.

QosInfo

QoS information.

OriginQos

Original QoS information.

NexthopBak

Backup of the next hop.

OutIfBak

Backup of the outbound interface.

LspTokenBak

Backup of the LSP ID.

InLabelBak

Backup of the VPN LSP inner label.

LspToken_ForInLabelBak

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

VlanId

VLAN ID.

BgpKey

Key value of the BGP route.

BgpKeyBak

Backup key value of the BGP route.

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.

OutIfSpeed(Kbits/sec)

Bandwidth of the outbound interface, in kbit/s.

NOTE:
This field is displayed only when global UCMP is enabled and the outbound interface supports UCMP.

display fib acl

Function

The display fib acl command displays information about FIB entries that match a specified ACL rule.

Format

display fib [ vpn-instance vpn-instance-name ] acl acl-number [ verbose ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays information about the FIB table of a specified VPN instance. The value must be an existing VPN instance name.
acl-number Displays information about the FIB table with a specified ACL rule. The value is an integer that ranges from 2000 to 2999.
verbose Displays detailed information about the FIB table. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display fib acl command to check information about FIB entries that match a specified ACL rule.

Example

# Display FIB entries that match an ACL rule.

<HUAWEI> display fib acl 2010
Route Entry matched by access-list 2010
 Summary Counts: 1
Destination/Mask Nexthop  Flag TimeStamp Interface     TunnelID
127.0.0.0/8     127.0.0.1 U    t[0]      InLoop0       0x0
Table 7-207  Description of the display fib acl command output

Item

Description

Route Entry matched by access-list

FIB entries that match an ACL rule.

Summary Counts

Total number of the FIB entries.

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: indicates a static route.

  • D: indicates a dynamic route.

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

  • T: indicates ingress TOKEN_SETBYLSPM nodes.

TimeStamp

Timestamp, which indicates the lifetime of an entry, in seconds.

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. If the value is not 0, packets matching the entry are forwarded through the MPLS tunnel. If the value is 0, packets matching the entry are not forwarded through the MPLS tunnel.

display fib interface

Function

The display fib interface command displays information about FIB entries with a specified outbound interface.

Format

display fib [ vpn-instance vpn-instance-name ] interface interface-type interface-number

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays information about the FIB table of a specified VPN instance. The value must be an existing VPN instance name.
interface-type interface-number Specifies the type and number of the outbound interface to a specified destination address. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display fib interface command to check information about FIB entries with a specified outbound interface.

Example

# Display FIB entries with a specified outbound interface.

<HUAWEI> display fib interface vlanif10
Destination/Mask   Nexthop    Flag TimeStamp   Interface        TunnelID
10.1.1.0/24        10.1.1.2    U    t[115]     Vlanif10           0x0
Table 7-208  Description of the display fib interface 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, 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: indicates a static route.

  • D: indicates a dynamic route.

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

TimeStamp

Timestamp, which indicates the lifetime of an entry, in seconds.

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. If the value is not 0, packets matching the entry are forwarded through the MPLS tunnel. If the value is 0, packets matching the entry are not forwarded through the MPLS tunnel.

display fib ip-prefix

Function

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

Format

display fib [ vpn-instance vpn-instance-name ] ip-prefix prefix-name [ verbose ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays the FIB table of a specified VPN instance. The value must be an existing VPN instance name.
prefix-name Specifies the name of an IP prefix list. The value is a string of 1 to 169 characters.
verbose Displays detailed information about the FIB table. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The command displays FIB entries that match a specified IP prefix list.

If 0 FIB entries match, the command output displays that zero FIB entries match.

If the name of an IP prefix list is not found, all FIB entries are displayed.

Example

# Display FIB entries matching the IP prefix list abc0.

<HUAWEI> display fib ip-prefix abc0
Route Entry matched by prefix-list abc0
 Summary Counts: 4
Destination/Mask  Nexthop  Flag  TimeStamp  Interface   TunnelID
127.0.0.0/8      127.0.0.1 U     t[0]       InLoop0       0x0
127.0.0.1/32     127.0.0.1 U     t[0]       InLoop0       0x0
172.16.0.0/8     10.1.1.1  SU    t[0]       Vlanif10      0x0
172.16.0.0/15    10.1.1.1  SU    t[0]       Vlanif10      0x0
Table 7-209  Description of the display fib ip-prefix 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, 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: indicates a static route.

  • D: indicates a dynamic route.

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

TimeStamp

Timestamp, which indicates the lifetime of an entry, in seconds.

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. If the value is not 0, packets matching the entry are forwarded through the MPLS tunnel. If the value is 0, packets matching the entry are not forwarded through the MPLS tunnel.

display fib longer

Function

The display fib longer command displays FIB entries that match a specified parameter.

The display fib [ slot-id ] destination-address command displays FIB entries that match a specified destination IP address. If the specified destination IP address matches an FIB entry in the natural mask range, all the subnets are displayed. Otherwise, FIB entries are displayed based on the longest matching principle.

The display fib [ slot-id ] destination-address destination-mask command displays FIB entries that accurately match the destination address and mask.

The display fib [ slot-id ] destination-address longer command displays all FIB entries that match destination IP addresses in the natural mask range.

The display fib [ slot-id ] destination-address destination-mask longer command displays all FIB entries that match destination IP addresses in a specified mask range.

The display fib [ slot-id ] destination-address1 destination-mask1 destination-address2 destination-mask2 command displays FIB entries that match destination IP addresses in the range of destination-address1 destination-mask1 to destination-address2 destination-mask2.

If slot-id is specified, FIB entries on the specified LPU are displayed.

Format

display fib [ slot-id ] [ vpn-instance vpn-instance-name ] destination-address1 [ destination-mask1 ] [ longer ] [ verbose ]

display fib [ slot-id ] [ vpn-instance vpn-instance-name ] destination-address1 destination-mask1 destination-address2 destination-mask2 [ verbose ]

Parameters

Parameter Description Value
slot-id Displays information about the FIB table with a specified slot 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 must be an existing VPN instance name.
destination-address1 Indicates destination IP address 1. The value is in dotted decimal notation.
destination-mask1 Indicates subnet mask 1. The value is in dotted decimal notation or an integer that ranges from 0 to 32.
destination-address2 Indicates destination IP address 2. The value is in dotted decimal notation.
destination-mask2 Indicates subnet mask 2. The value is in dotted decimal notation or an integer that ranges from 0 to 32.
longer

Displays FIB entries matching a specified network segment or mask.

-

verbose

Displays detailed information about the FIB table.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display fib longer command to check FIB entries that match a specified condition.

Example

# Display FIB entries that match destination address 172.16.0.0 in the natural mask range or based on the longest match principle.

<HUAWEI> display fib 172.16.0.0
  Route Entry Count: 1 
Destination/Mask  Nexthop  Flag  TimeStamp  Interface  TunnelID
172.16.0.0/16     10.1.1.1 U     t[0]       Vlanif10     0x0

# Display the FIB entries with the destination addresses in the range of 72.16.0.0/16 to 172.16.0.6/16.

<HUAWEI> display fib 172.16.0.0 255.255.0.0 172.16.0.6 255.255.0.0
  Route Entry Count: 1 
Destination/Mask  Nexthop  Flag  TimeStamp  Interface  TunnelID
172.16.0.1/8      10.1.1.1  U     t[0]       Vlanif10     0x0
Table 7-210  Description of the display fib longer 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, 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: indicates a static route.

  • D: indicates a dynamic route.

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

TimeStamp

Timestamp, which indicates the lifetime of an entry, in seconds.

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. If the value is not 0, packets matching the entry are forwarded through the tunnel. If the value is 0, packets matching the entry are not forwarded through the tunnel.

display fib next-hop

Function

The display fib next-hop command displays FIB entries that match a specified next-hop IP address.

Format

display fib [ vpn-instance vpn-instance-name ] next-hop ip-address

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays information about the FIB table of a specified VPN instance. The value must be an existing VPN instance name.
ip-address Specifies the next-hop IP address. The value is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display fib next-hop command to check FIB entries that match a specified next-hop IP address.

Example

# Display FIB entries that match a specified next-hop IP address.

<HUAWEI> display fib next-hop 10.1.1.1
Destination/Mask   Nexthop         Flag TimeStamp     Interface      TunnelID
10.1.1.1/32        10.1.1.1        HU   t[115]        Vlanif10         0x0
Table 7-211  Description of the display fib next-hop 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, 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: indicates a static route.

  • D: indicates a dynamic route.

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

TimeStamp

Timestamp, which indicates the lifetime of an entry, in seconds.

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. If the value is not 0, packets matching the entry are forwarded through the MPLS tunnel. If the value is 0, packets matching the entry are not forwarded through the MPLS tunnel.

display fib statistics

Function

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

Format

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

Parameters

Parameter Description Value
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 an IPv4 VPN instance. The value must be an existing VPN instance name.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display fib statistics command to check the total number of IPv4 FIB entries.

Example

# Display the total number of IPv4 FIB entries.

<HUAWEI> display fib statistics
Route Entry Count : 30
Route Prefix Count : 30 
# Display the total number of FIB entries of the IPv4 VPN instance vpna.
<HUAWEI> display fib vpn-instance vpna statistics
Route Entry Count : 1                                                           
Route Prefix Count : 1                         
Table 7-212  Description of the display fib statistics command output

Item

Description

Route Entry Count

Total number of FIB entries.

Route Prefix Count

Total number of route prefix entries.

display fib statistics all

Function

The display fib statistics all command displays IPv4 FIB entry statistics.

Format

display fib [ slot-id ] statistics all

Parameters

Parameter Description Value
slot-id Specifies the slot ID of the LPU on which IPv4 FIB entry statistics are displayed. The value is an integer and the value range depends on the device configuration.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When running the display fib statistics all command, you can view the IPv4 FIB route prefix capacity and the number of IPv4 FIB forwarding entries on the device.

  • If the slot ID is specified, you can view the IPv4 FIB route prefix capacity and the number of IPv4 FIB forwarding entries on the specified LPU.

  • If the slot ID is not specified, you can view statistics about all IPv4 FIB entries on the MPU.

Example

# Display statistics about IPv4 FIB entries on the LPU in slot 2.

<HUAWEI> display fib 2 statistics all
IPv4 FIB Route Prefix Capacity : 320000
IPv4 FIB Total Route Prefix Count :2 ; Entry Count : 2
IPv4 FIB Public Route Prefix Count :2 ; Entry Count : 2
IPv4 FIB VPN-instance vpna Route Prefix Count :0 ; Entry Count : 0
Table 7-213  Description of the display fib statistics all command output

Item

Description

IPv4 FIB Route Prefix Capacity:

IPv4 FIB route prefix capacity on the local LPU.

IPv4 FIB Total Route Prefix Count: Entry Count:

Total number of IPv4 FIB route prefixes and forwarding entries on the local LPU.

IPv4 FIB Public Route Prefix Count: Entry Count:

Total number of IPv4 route prefixes and forwarding entries on a public network.

IPv4 FIB VPN-instance vpna Route Prefix Count: Entry Count:

Total number of route prefixes and forwarding entries of IPv4 VPN instance vpna.

Related Topics

display fib-policy

Function

The display fib-policy command displays IPv4 FIB policies.

Format

display fib-policy slot slot-id

Parameters

Parameter Description Value
slot slot-id Specifies the slot ID of an LPU on which IPv4 FIB policies need to be displayed. The value is an integer and the value range depends on the device configuration.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display fib-policy command displays policies configured on the LPU. If no policy is configured on the LPU, the command output shows that no policy is configured.

Example

# Display IPv4 FIB policies on the LPU in slot 2.

<HUAWEI> display fib-policy slot 2
  FIB policy:
    public route
    VPN route: vpna
Table 7-214  Description of the display fib-policy command output

Item

Description

FIB policy

IPv4 FIB policies on the local LPU. The following information can be displayed:
  • Have not configed FIB policy: indicates that no IPv4 FIB policy is configured on the LPU.

  • public route: indicates that the IPv4 public policy is configured on the LPU.

  • VPN route: indicates that the IPv4 VPN forwarding policy is configured on the LPU.

  • Have configured no-route FIB policy: indicates that the LPU does not receive any IPv4 forwarding entries sent by the MPU.

Related Topics

display fib overload state

Function

The display fib overload state command displays the current working status and overload mode of the IPv4 FIB module on an LPU.

Format

display fib overload state slot slot-id

Parameters

Parameter Description Value
slot slot-id Specifies the slot ID of an LPU on which information about the IPv4 FIB module needs to be displayed. The value is an integer and the value range depends on the device configuration.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display fib overload state command displays current working status and overload mode of the IPv4 FIB module on an LPU.

The IPv4 FIB module works in normal state, overload suspension state, or overload forwarding state. The overload mode includes overload suspension and overload forwarding.

If the number of IPv4 FIB route prefixes on the LPU exceeds the route prefix capacity, the LPU works in overload mode.

Example

# Display current working status and overload mode of the IPv4 FIB module on the LPU in slot 2.

<HUAWEI> display fib overload state slot 2
  Overload mode:
    Overload suspend mode.
  Overload state:
    Normal state.
Table 7-215  Description of the display fib overload state command output

Item

Description

Overload mode:

Overload mode of the IPv4 FIB module on the local LPU:
  • Overload suspend mode: indicates the overload suspension mode.
  • Overload forward mode: indicates the overload forwarding mode.

Overload state:

Current working status of the IPv4 FIB module on the local LPU:
  • Normal state: indicates that the module works normally.
  • Overload suspend state: indicates that the module works in overload suspension mode.
  • Overload forward state: indicates that the module works in overload forwarding mode.

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 ] [ verbose ]

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

display ip routing-table [ vpn-instance vpn-instance-name ] ip-address { mask | mask-length } nexthop nexthop-address [ verbose ]

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

display ip routing-table [ vpn-instance vpn-instance-name ] acl { acl-number | acl-name } [ verbose ]

display ip routing-table [ vpn-instance vpn-instance-name ] ip-prefix ip-prefix-name [ 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 must be an existing VPN instance name.
verbose Displays detailed information about active routes and inactive routes. If this keyword is not specified, only brief information about active routes is displayed. -
ip-address Displays the routes with the specified destination address. The value is in dotted decimal notation.
nexthop nexthop-address Displays the routes with the specified next-hop 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.
acl acl-number Displays the routes that match the ACL with the specified ACL number. If the specified ACL does not exist, information about all active routes is displayed. The value is an integer that ranges from 2000 to 2999.
acl acl-name Displays the routes that match the ACL with the specified ACL name. If the specified ACL does not exist, information about all active routes is displayed. The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter.
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, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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 that longest match the 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 routes that match the IP address specified by the destination address and the natural mask 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
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Tables: Public
         Destinations : 5        Routes : 5        

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
      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
  192.168.150.0/24  Direct  0    0           D   192.168.150.22  Vlanif4094
 192.168.150.22/32  Direct  0    0           D   127.0.0.1       Vlanif4094
Table 7-216  Description of the display ip routing-table command output

Item

Description

Route Flags

Flag of a route:
  • R: indicates that the route is an iterated route.

  • D: indicates that the route is delivered to the FIB table.

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 through 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
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Table: vpn1
         Destinations : 3        Routes : 3

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.5.5.0/24  Static 60   0          RD  10.1.1.2        Vlanif10
Table 7-217  Description of the display ip routing-table vpn-instance command output

Item

Description

Route Flags

Route flag:
  • R: indicates an iterated route.

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

Routing Tables: 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 through which the next hop is reachable.

# Display brief information about the current routing table. Route 10.2.2.2/32 is a static route with next hop 10.1.1.1. This route is an iterated route and has two outbound interfaces because 10.1.1.1 has two outbound interfaces.

<HUAWEI> display ip routing-table
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Tables: Public
         Destinations : 6        Routes : 7

   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    10.10.0.2  Vlanif100
       10.2.2.2/32   Static  60   0     RD   10.1.1.1    NULL0
                     Static  60   0     RD   10.1.1.1    Vlanif100
      10.10.0.0/24   Direct   0   0      D    10.10.0.1  Vlanif100
      10.10.0.1/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

# Display detailed information about the IPv4 routing table.

<HUAWEI> display ip routing-table verbose
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Tables: Public
         Destinations : 5        Routes : 5


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: 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                                  
Table 7-218  Description of the display ip routing-table verbose command output

Item

Description

Route Flags

Flag of a route:
  • R: indicates that the route is an iterated route.

  • D: indicates that the route is delivered to the FIB table.

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

Label allocated by MPLS.

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 the maximum number of 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 must be an existing 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        -            -          9          5               
Prefix        Default        -            -          9          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            Simply-Alert   5000           -            4223      5
Prefix           Alert-Percent  1000           800          760       5
-----------------------------------------------------------------------------------
VPN Instance Name: vpn2
Route            Alert-Percent  2000           1000         823       5
Prefix           Default        -              -            760       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            Simply-Alert    5000           -          4223       5
Prefix           Alert-Percent   1000           800        760        5
Table 7-219  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. The value is set by using the limit-log-interval command.

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 ] protocol protocol [ inactive | verbose ]

Parameters

Parameter Description Value
vpn-instance-name Specifies the name of an VPN instance of an enabled IPv4 address family. The value must be an existing VPN instance name.
protocol Displays routing information of a specified routing protocol.

The value may be bgp, direct, isis, ospf, rip, static, or unr. The specific value varies depending on the routing protocol supported by the device.

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
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Public routing table : Direct
         Destinations : 4        Routes : 4  

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

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
      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

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

Item

Description

Route Flags

Flag of a route:
  • R: indicates that the route is an iterated route.

  • D: indicates that the route is delivered to the FIB table.

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 detailed information about all OSPF routes.

<HUAWEI> display ip routing-table protocol ospf verbose
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Tables: Public
         Destinations : 3        Routes : 3


Destination: 192.168.1.1/32
     Protocol: OSPF            Process ID: 1
   Preference: 10                    Cost: 1
      NextHop: 10.11.1.1        Neighbour: 0.0.0.0
        State: Active Adv             Age: 21h23m44s
          Tag: 0                 Priority: medium
        Label: NULL               QoSInfo: 0x0
   IndirectID: 0x0
 RelayNextHop: 0.0.0.0          Interface: Vlanif100
     TunnelID: 0x0                  Flags:  D

Destination: 192.168.2.1/32
     Protocol: OSPF            Process ID: 1
   Preference: 10                    Cost: 1
      NextHop: 10.11.1.1        Neighbour: 0.0.0.0
        State: Active Adv             Age: 21h23m44s
          Tag: 0                 Priority: medium
        Label: NULL               QoSInfo: 0x0
   IndirectID: 0x0
 RelayNextHop: 0.0.0.0          Interface: Vlanif100
     TunnelID: 0x0                  Flags:  D

Destination: 192.168.3.1/32
     Protocol: OSPF            Process ID: 1
   Preference: 10                    Cost: 1
      NextHop: 10.11.1.1        Neighbour: 0.0.0.0
        State: Active Adv             Age: 21h23m44s
          Tag: 0                 Priority: medium
        Label: NULL               QoSInfo: 0x0
   IndirectID: 0x0
 RelayNextHop: 0.0.0.0          Interface: Vlanif100
     TunnelID: 0x0                  Flags:  D
Table 7-221  Description of the display ip routing-table protocol verbose command output

Item

Description

Routing Tables: Public

The routing table is a public routing table.

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

Routing protocol 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

Label allocated by MPLS.

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 all the direct routes of the VPN instance named vpn1.

<HUAWEI> display ip routing-table vpn-instance vpn1 protocol direct
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
vpn4 routing table : Direct
         Destinations : 2           Routes : 2

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

Destination/Mask    Proto  Pre  Cost     Flags NextHop         Interface

       10.1.1.0/24  Direct 0    0          D  10.1.1.1         Vlanif30
       10.1.1.1/32  Direct 0    0           D  127.0.0.1       Vlanif30

Direct routing table status : <Inactive>
         Destinations : 0           Routes : 0
Table 7-222  Description of the display ip routing-table vpn-instance protocol command output

Item

Description

Active

Active routes.

Inactive

Iinactive 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 | all-vpn-instance ] 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 must be an existing VPN instance name.
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. -

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
Proto   total   active  added      deleted     freed
        routes  routes  routes     routes      routes
DIRECT   6        6      42          36         36
STATIC   3        3      21          18         18
RIP      0        0       0           0          0
OSPF     0        0       0           0          0
IS-IS    0        0       0           0          0
BGP      0        0       0           0          0
UNR      0        0       0           0          0
Total    9        9      63          54         54
Table 7-223  Description of the display ip routing-table statistics command output

Item

Description

Summary Prefixes

Total number of prefixes in the current routing table.

Proto

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 statistics about routes in routing tables of all VPN instances.
<HUAWEI> display ip routing-table all-vpn-instance statistics
Summary prefixes: 9
Proto   total   active  added      deleted     freed
        routes  routes  routes     routes      routes
DIRECT   6        6      42          36         36
STATIC   3        3      21          18         18
RIP      0        0       0           0          0
OSPF     0        0       0           0          0
IS-IS    0        0       0           0          0
BGP      0        0       0           0          0
UNR      0        0       0           0          0
Total    9        9      63          54         54

display ip routing-table time-range

Function

The display ip routing-table time-range command displays information about routes generated in a specified time range in an IP routing table.

Format

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays information about routes generated in a specified time range in the IP routing table of the specified VPN instance. If you do not specify this parameter, the display ip routing-table time-range command displays information about routes generated in a specified time range in the public IP routing table.

The value must be an existing VPN instance name.

min-age Specifies the end time of the period when routes are generated.
The value is in xxdxxhxxmxxs format.
  • d indicates days. The value is an integer that ranges from 0 to 10000.
  • h indicates hours. The value is an integer that ranges from 0 to 23.
  • m indicates minutes. The value is an integer that ranges from 0 to 59.
  • s indicates seconds. The value is an integer that ranges from 0 to 59.
For example, you can enter 5d4h30m20s to specify 5 days, 4 hours, 30 minutes, and 20 seconds.
NOTE:

If the value of d is 10000, the values of h, m, and s can only be 0.

max-age Specifies the start time of the period when routes are generated.
The value is in xxdxxhxxmxxs format.
  • d indicates days. The value is an integer that ranges from 0 to 10000.
  • h indicates hours. The value is an integer that ranges from 0 to 23.
  • m indicates minutes. The value is an integer that ranges from 0 to 59.
  • s indicates seconds. The value is an integer that ranges from 0 to 59.
For example, you can enter 5d4h30m20s to specify 5 days, 4 hours, 30 minutes, and 20 seconds.
NOTE:

If the value of d is 10000, the values of h, m, and s can only be 0.

verbose Displays detailed information about active and inactive routes. If you do not specify this parameter, the display ip routing-table time-range command displays only brief information about active routes. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

If route flapping occurs on a network, you can run the display ip routing-table time-range command and specify a small time range for the command. You can then find the flapping route rapidly and accelerate fault location.

Precautions

max-age must be larger than min-age. Otherwise, the display ip routing-table time-range command does not display any information.

If max-age is larger than min-age but no route was generated within this time range, the display ip routing-table time-range command displays only the table heading.

Example

# Display information about public network routes generated in the last 20 minutes.

<HUAWEI> display ip routing-table time-range 0 20m
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Tables: Public
         Destinations : 2        Routes : 2

Destination/Mask    Proto   Pre  Cost      Flags NextHop         Interface

       10.3.3.3/32  Direct  0    0           D   127.0.0.1       LoopBack1
       10.4.4.0/24  Static  60   0           D   0.0.0.0         NULL0

Table 7-224  Description of the display ip routing-table time-range command output

Item

Description

Route Flags

Route flags:
  • R: The route is an iterated route.

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

Routing Tables: Public

The routing table is a public routing table.

Destinations

Number of destination networks and hosts.

Routes

Number of routes.

Destination/Mask

Address and mask length of the destination network and host.

Proto

Protocol used to learn routes.

Pre

Route preference.

Cost

Route cost.

Flags

Route flags in the heading of the routing table.

NextHop

Next hop.

Interface

Outbound interface in a route with a reachable next hop.

# Display detailed information about public network routes generated in the last 20 minutes.

<HUAWEI> display ip routing-table time-range 0 20m verbose
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Tables: Public
         Destinations : 3        Routes : 3


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

Destination: 10.4.4.0/24
     Protocol: Static           Process ID: 0
   Preference: 60                     Cost: 0
      NextHop: 0.0.0.0           Neighbour: 0.0.0.0
        State: Active Adv              Age: 00h01m38s
          Tag: 0                  Priority: medium
        Label: NULL                QoSInfo: 0x0
   IndirectID: 0x0
 RelayNextHop: 0.0.0.0           Interface: NULL0
     TunnelID: 0x0                   Flags:  D

Destination: 10.4.4.4/32
     Protocol: Static           Process ID: 0
   Preference: 60                     Cost: 0
      NextHop: 10.4.4.0          Neighbour: 0.0.0.0
        State: Invalid Adv Relied      Age: 00h01m38s
          Tag: 0                  Priority: medium
        Label: NULL                QoSInfo: 0x0
   IndirectID: 0x80000002
 RelayNextHop: 0.0.0.0           Interface: NULL0
     TunnelID: 0x0                   Flags: R
Table 7-225  Description of the display ip routing-table time-range verbose command output

Item

Description

Process ID

Process ID of the routing protocol.

Preference

Route preference.

Cost

Route cost.

NextHop

Next hop.

Neighbour

IP address of a neighbor. 0.0.0.0 indicates that the route is generated by a local device.

State

Route status:
  • Active: an active route

  • Invalid: an invalid route

  • Inactive: an inactive route

  • NoAdv: a route that cannot be advertised

  • Adv: a route that can be advertised

  • Del: a route to be deleted

  • Relied: a route that is iterated to the next hop and outbound interface or a tunnel

  • Stale: a route with the Stale flag and used in GR

Age

Time after the route is generated.

Tag

Administrative tag of the route. The value is an integer that ranges from 0 to 4294967295.

Priority

Convergence priority of the route:

  • low: The convergence priority of a route is low.

  • medium: The convergence priority of a route is medium.

  • high: The convergence priority of a route is high.

  • critical: The convergence priority of a route is critical.

Label

Label allocated by MPLS.

QoSInfo

QoS information. 0x0 indicates QoS information is empty.

IndirectID

ID of the indirect next hop.

RelayNextHop

Iterated next hop.

Interface

Iterated outbound interface.

Tunnel ID

Tunnel ID:
  • The value 0x0 indicates that the route does not use a tunnel or the tunnel fails to be set up.
  • If the value is not 0x0, the route is iterated to a tunnel.

Flags

Route flags in the heading of the routing table.

display ipv6 fib

Function

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

Format

display ipv6 fib [ slot-id ] statistics [ all ]

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

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

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

Parameters

Parameter Description Value
slot-id Specifies the slot ID of the working LPU. -
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 statistics of FIB entries. -
all Displays all FIB entries. -
vpn-instance vpn-instance-name Displays FIB entries of the specified VPN instance. The value must be an existing 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

You can run the display ipv6 fib command to check IPv6 FIB entries on the device.

Example

# Display all FIB entries on the MPU.
<HUAWEI> display ipv6 fib
 IPv6 FIB Table:
 Total number of Routes : 1

Destination:  ::1                                     PrefixLength : 128
Nexthop    :  ::1                                     Flag         : HU
Interface  :  InLoopBack0                             Tunnel ID    : 0x0
TimeStamp  :  2008-11-03 13:47:52 
Table 7-226  Description of the display ipv6 fib command output

Item

Description

Total number of Routes

Number of IPv6 routes.

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

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.

TimeStamp

Time taken to generate a route in the FIB table.

Interface

Outbound interface through which packets are forwarded.

display ipv6 fib-policy

Function

The display ipv6 fib-policy command displays the IPv6 FIB policy.

Format

display ipv6 fib-policy slot slot-id

Parameters

Parameter Description Value
slot slot-id Specifies the slot ID of an LPU to which the IPv6 FIB policy is applied. The value is an integer and the value range depends on the device configuration.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display ipv6 fib-policy command displays policies configured on the LPU. If policies are not configured on the LPU, the command output shows that no policy is configured.

Example

# Display IPv6 FIB policies on the LPU in slot 2.

<HUAWEI> display ipv6 fib-policy slot 2
  FIB policy:
    public route
    VPN route: vpna
Table 7-227  Description of the display ipv6 fib-policy command output

Item

Description

FIB policy

IPv6 FIB policies on the local LPU. The following information can be displayed:
  • Have not configured FIB policy: indicates that no IPv6 FIB policy is configured on the LPU.

  • public route: indicates that the IPv6 public policy is configured on the LPU.

  • VPN route: indicates that IPv6 VPN forwarding policies are configured on the LPU.

  • Have configured no-route FIB policy: indicates that the LPU does not receive any IPv6 forwarding entries sent by the MPU.

Related Topics

display ipv6 fib overload state

Function

The display ipv6 fib overload state command displays current working status and overload mode of the IPv6 FIB module on an LPU.

Format

display ipv6 fib overload state slot slot-id

Parameters

Parameter Description Value
slot slot-id Specifies the slot ID of an LPU on which information about the IPv6 FIB module needs to be displayed. The value is an integer and the value range depends on the device configuration.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display ipv6 fib overload state command displays current working status and overload mode of the IPv6 FIB module on the LPU.

The IPv6 FIB module works in normal state, overload suspension state, or overload forwarding state. The overload mode includes overload suspension and forwarding.

If the number of IPv6 FIB route prefixes on the LPU exceeds the maximum value, the LPU works in overload mode.

Example

# Display current working status and overload mode of the IPv6 FIB module on the LPU in slot 2.

<HUAWEI> display ipv6 fib overload state slot 2
  Overload mode:
    Overload suspend mode.
  Overload state:
    Normal state.
Table 7-228  Description of the display ipv6 fib overload state command output

Item

Description

Overload mode:

Overload mode of the IPv6 FIB module:
  • Overload suspend mode: indicates the overload suspension mode.

  • Overload forward mode: indicates the overload forwarding mode.

Overload state:

Current working status of the IPv6 FIB module on the local LPU:
  • Normal state: indicates that the module works normally.

  • Overload suspend state: indicates that the module works in overload suspension mode.

  • Overload forward state: indicates that the module works in overload forwarding mode.

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 ] [ verbose | brief ]

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

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

display ipv6 routing-table [ vpn-instance vpn-instance-name ] acl { acl6-number | acl6-name } [ verbose | brief ]

display ipv6 routing-table [ vpn-instance vpn-instance-name ] ipv6-prefix ipv6-prefix-name [ verbose | 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 must be an existing VPN instance name.
verbose Displays detailed information about all the routes in the current routing table, including active and inactive routes. -
brief Displays brief information about active routes in the current routing table. -
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.
acl acl6-number Displays the routes that match the ACL6 with the specified ACL number. If the specified ACL6 does not exist, information about all active routes is displayed. The value is an integer that ranges from 2000 to 2999.
acl acl6-name Displays the routes that match the ACL6 with the specified ACL name. If the specified ACL6 does not exist, information about all active routes is displayed. The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter.
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, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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
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 7-229  Description of the display ipv6 routing-table command output

Item

Description

Routing Tables : 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
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
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : InLoopBack0                     Flags        : D

 Destination  : FC00:0:0:1::1                   PrefixLength : 128
 NextHop      : FC00:0:0:2::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
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : NULL0                           Flags        : RD
Table 7-230  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.

Age

Time a route is generated.

# Display brief information about the active routes that match ACL6 2000.

<HUAWEI> display ipv6 routing-table acl 2000
Routes Matched by Access list  2000  :
Summary Count : 2

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

 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 brief information about the routes with the specified IPv6 destination address.

<HUAWEI> display ipv6 routing-table fc00:0:0:111::1 64
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
Routing Table :
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 brief information about the active routes that match IPv6 prefix list abc2.

<HUAWEI> display ipv6 routing-table ipv6-prefix abc2
Routes Matched by Prefix-list abc2 :
Summary Count: 3

 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::1                 Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : Vlanif20                        Flags        : D

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

display ipv6 routing-table limit

Function

The display ipv6 routing-table limit command displays limits on the numbers of 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 must be an existing 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 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
----------------------------------------------------------------------------------
IPv6 VPN Instance Name: VPN1
Route            Simply-Alert   5000           -            4223      5
Prefix           Alert-Percent  1000           800          760       5
-----------------------------------------------------------------------------------
IPv6 VPN Instance Name: VPN2
Route            Alert-Percent  2000           1000         823       5
Prefix           Default        -              -            760       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
IPv6 VPN Instance Name: vpn1
Limit-Object     Limit-Type      Upper-Limit    Warning    Current    Log-Interval
Route            Simply-Alert    5000           -          4223       5
Prefix           Alert-Percent   1000           800        760        5

# 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        -            -          1          5               
Prefix        Default        -            -          1          5
Table 7-231  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 ] protocol protocol [ inactive | verbose | brief ]

Parameters

Parameter Description Value
vpn-instance-name Specifies the name of a VPN instance of an enabled IPv6 address family. The value must be an existing VPN instance name.
protocol Displays routing information of a specified routing protocol.

The value may be bgp, direct, isis, ospfv3, ripng, static, or unr. The specific value varies depending on the routing protocol supported by the device.

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. -
brief Displays brief information about active and inactive routes. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display ipv6 routing-table protocol command to check routing information about a specified IPv6 routing protocol.

Example

# Display brief information about all IPv6 direct routes.

<HUAWEI> display ipv6 routing-table protocol direct
Public Routing Table : Direct
Summary Count : 2

Direct Routing Table's 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's Status : < Inactive >
Summary Count : 0 
Table 7-232  Description of the display ipv6 routing-table protocol command output

Item

Description

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

  • unr: user network route

Summary Count

Number of prefixes of routes.

Direct Routing Table's 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 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 | all-vpn-instance ] 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 must be an existing 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. -

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 : 0
Protocol   route       active      added       deleted     freed
DIRECT     0           0           0           0           0          
STATIC     0           0           0           0           0          
RIPng      0           0           0           0           0          
OSPFv3     0           0           0           0           0          
IS-IS      0           0           0           0           0          
BGP        0           0           0           0           0          
UNR        0           0           0           0           0          
Total      0           0           0           0           0 
Table 7-233  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:

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.

freed

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

display ipv6 routing-table time-range

Function

The display ipv6 routing-table time-range command displays information about routes generated in a specified time range in an IPv6 routing table.

Format

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays information about routes generated in a specified time range in the IPv6 routing table of the specified VPN instance. If this parameter is not specified, the display ipv6 routing-table time-range command displays information about routes generated in a specified time range in the public IPv6 routing table.

The value must be an existing VPN instance name.

min-age Specifies the end time of the period when routes are generated.
The value is in xxdxxhxxmxxs format.
  • d indicates days. The value is an integer that ranges from 0 to 10000.
  • h indicates hours. The value is an integer that ranges from 0 to 23.
  • m indicates minutes. The value is an integer that ranges from 0 to 59.
  • s indicates seconds. The value is an integer that ranges from 0 to 59.
For example, enter 5d4h30m20s to specify 5 days, 4 hours, 30 minutes, and 20 seconds.
NOTE:

If the value of d is 10000, the values of h, m, and s can only be 0.

max-age Specifies the start time of the period when routes are generated.
The value is in xxdxxhxxmxxs format.
  • d indicates days. The value is an integer that ranges from 0 to 10000.
  • h indicates hours. The value is an integer that ranges from 0 to 23.
  • m indicates minutes. The value is an integer that ranges from 0 to 59.
  • s indicates seconds. The value is an integer that ranges from 0 to 59.
For example, enter 5d4h30m20s to specify 5 days, 4 hours, 30 minutes, and 20 seconds.
NOTE:

If the value of d is 10000, the values of h, m, and s can only be 0.

verbose Displays detailed information about active and inactive routes. If this parameter is not specified, the display ipv6 routing-table time-range command displays only brief information about active routes. -
brief Displays brief information about active and inactive routes. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

If route flapping occurs on a network, to find the flapping route rapidly and accelerate fault location, run the display ipv6 routing-table time-range command and specify a small time range.

Precautions

max-age must be larger than min-age. Otherwise, the display ipv6 routing-table time-range command does not display any information.

If max-age is larger than min-age but no route is generated within this time range, the display ipv6 routing-table time-range command displays only the table heading.

Example

# Display information about public network IPv6 routes generated in the last 2 hours, 20 minutes, and 10 seconds.

<Switch> display ipv6 routing-table time-range 0 2h20m10s
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:1::1                   PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Cost         : 0                               Protocol     : Direct
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : LoopBack2                       Flags        : D

 Destination  : FC00:0:0:1::2                   PrefixLength : 128
 NextHop      : ::                              Preference   : 60
 Cost         : 0                               Protocol     : Static
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : NULL0                           Flags        : D

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

Table 7-234  Description of the display ipv6 routing-table time-range command output

Item

Description

Routing Tables: Public

The routing table is a public routing table.

Destinations

Number of destination networks or hosts.

Routes

Number of routes.

Destination

IP addresses of the destination network or host.

PrefixLength

Prefix length of a route.

NextHop

Next-hop IPv6 address.

Preference

Route preference.

Cost

Route cost.

Protocol

Name of the routing protocol.

RelayNextHop

Iterated next hop.

TunnelID

Tunnel ID:
  • The value 0x0 indicates that the route does not use a tunnel or the tunnel fails to be set up.
  • If the value is not 0x0, the route is iterated to a tunnel.

Interface

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

Flags

Route flag:
  • R: The route is an iterated route.

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

# Display detailed information about public network routes generated in the last 20 minutes.

<Switch> display ipv6 routing-table time-range 0 20m verbose
Routing Table : Public
         Destinations : 4        Routes : 5

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

 Destination  : FC00:0:0:1::1                   PrefixLength : 128
 NextHop      : ::1                             Preference   : 0
 Neighbour    : ::                              ProcessID    : 0
 Label        : NULL                            Protocol     : Direct
 State        : Active Adv                      Cost         : 0
 Entry ID     : 262552100                       EntryFlags   : 0x80010040
 Reference Cnt: 2                               Tag          : 0
 Priority     : high                            Age          : 101sec
 IndirectID   : 0x0
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : LoopBack2                       Flags        : D

 Destination  : FC00:0:0:1::1                   PrefixLength : 128
 NextHop      : FC00:0:0:1::2                   Preference   : 60
 Neighbour    : ::                              ProcessID    : 0
 Label        : NULL                            Protocol     : Static
 State        : Inactive Adv Relied             Cost         : 0
 Entry ID     : 262551716                       EntryFlags   : 0x20140
 Reference Cnt: 2                               Tag          : 0
 Priority     : medium                          Age          : 7668sec
 IndirectID   : 0x80000001
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : NULL0                           Flags        : R

 Destination  : FC00:0:0:1::2                   PrefixLength : 128
 NextHop      : ::                              Preference   : 60
 Neighbour    : ::                              ProcessID    : 0
 Label        : NULL                            Protocol     : Static
 State        : Active Adv                      Cost         : 0
 Entry ID     : 262551844                       EntryFlags   : 0x80000040
 Reference Cnt: 2                               Tag          : 0
 Priority     : medium                          Age          : 7670sec
 IndirectID   : 0x0
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : NULL0                           Flags        : D

 Destination  : FE80::                          PrefixLength : 10
 NextHop      : ::                              Preference   : 0
 Neighbour    : ::                              ProcessID    : 0
 Label        : NULL                            Protocol     : Direct
 State        : Active NoAdv                    Cost         : 0
 Entry ID     : 262551972                       EntryFlags   : 0x80010010
 Reference Cnt: 2                               Tag          : 0
 Priority     : high                            Age          : 104sec
 IndirectID   : 0x0
 RelayNextHop : ::                              TunnelID     : 0x0
 Interface    : NULL0                           Flags        : D

Table 7-235  Description of the display ipv6 routing-table time-range verbose command output

Item

Description

Neighbour

IP address of a neighboring interface. :: indicates that the route is generated by a local device.

ProcessID

Process ID of the routing protocol.

Label

Label carried in a route.

State

Status of the route:

  • Active: an active route

  • Invalid: an invalid route

  • Inactive: an inactive route

  • NoAdv: a route that cannot be advertised

  • Adv: a route that can be advertised

  • Del: a route to be deleted

  • Relied: a route that is iterated to the next hop and outbound interface or a tunnel

  • Stale: a route with the Stale flag and used in GR

Entry ID

ID of a route in the routing table.

EntryFlags

Flag of a route.

Reference Cnt

Number of times the route is referenced.

Tag

Administrative tag of the route. The value is an integer that ranges from 0 to 4294967295.

Priority

Convergence priority of the route:

  • low

  • medium

  • high

  • critical

IndirectID

ID of the indirect next hop.

Age

Time when the route is generated.

display out-interface

Function

The display out-interface command displays the outbound interface and instant statistics of the packets that contain the specified quintuple information.

NOTE:

X series cards do not support this command.

Format

display out-interface sip source-ip-address dip destination-ip-address [ sport source-port dport destination-port [ protocol { protocol-number | gre | icmp | igmp | ip | ipinip | ospf | tcp | udp } ] ]

Parameters

Parameter

Description

Value

sip source-ip-address

Specifies the source IP address.

The value is in dotted decimal notation.

dip destination-ip-address

Specifies the destination IP address.

The value is in dotted decimal notation.

sport source-port

Specifies the source port number.

The value is an integer that ranges from 0 to 65535.

dport destination-port

Specifies the destination port number.

The value is an integer that ranges from 0 to 65535.

protocol { protocol-number | gre | icmp | igmp | ip | ipinip | ospf | tcp | udp }

Specifies the protocol number or type.
  • protocol-number specifies the protocol number.

  • The protocol type can be GRE, ICMP, IGMP, IP, IPINIP, OSPF, TCP, or UDP.

The value of protocol-number is an integer that ranges from 1 to 255.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If packets with no specified quintuple information carried pass through interfaces, no information is displayed on the device.

If packets with the specified quintuple information carried pass through interfaces, the information about the outbound interface and statistics on packets is displayed on the device.

NOTE:
After the collect forward-path command configures the device to collect inbound and outbound interfaces and traffic information about packets with 5-tuple information, there is no information in the display out-interface command output. The display out-interface command displays inbound and outbound interfaces and traffic information about packets with 5-tuple information only when the collect forward-path command is not used or the collect forward-path command configuration is canceled.

Example

# Check the outbound interface of and statistics on the packets with the source IP address being 10.0.1.1 and the destination IP address being 10.1.1.2.
<HUAWEI> display out-interface sip 10.0.1.1 dip 10.1.1.2
Out interface   : GigabitEthernet1/0/1
Passed packets  : 74
Passed bytes    : 7844
Discard packets : 0
Discard bytes   : 0 
Table 7-236  Description of the display out-interface command output

Item

Description

Out Interface

Outbound interface through which packets are forwarded.

Passed packets

Number of forwarded packets.

Passed bytes

Total bytes of forwarded packets.

Discard packets

Number of discarded packets.

Discard bytes

Total bytes of discarded packets.

display rm bfd-session

Function

The display rm bfd-session command displays the BFD session configuration in routing management (RM).

Format

display rm bfd-session [ vpn-instance vpn-instance-name ] [ destination destination-address ] [ source source-address ] [ interface interface-type interface-number ] [ protocol { bgp | isis-l1 | isis-l2 | isis-l1l2 | ospf | rip | pim } ]

display rm bfd-session all

Parameters

Parameter Description Value
all Displays all the BFD session configurations in RM, including the BFD session configurations of the public and private networks. If all is not specified, only the BFD session configuration on the public network is displayed. -
vpn-instance vpn-instance-name Displays the configurations of BFD sessions of the specified VPN instance in RM. The value must be an existing VPN instance name.
destination destination-address Displays the configurations of BFD sessions with the specified destination address in RM. The value is in dotted decimal notation.
source source-address Displays the configurations of BFD sessions with the specified source address in RM. The value is in dotted decimal notation.
interface interface-type interface-number Displays the configurations of BFD sessions with the specified outbound interface type and number in RM. -
protocol Displays the configurations of BFD sessions of the specified routing protocol in RM:
  • bgp: BGP

  • isis-l1: IS-IS Level-1

  • isis-l2: IS-IS Level-2

  • isis-l1l2: IS-IS Level-1-2

  • ospf: OSPF

  • rip: RIP

  • pim: PIM

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to view the configuration of BFD sessions dynamically created by routing protocols. The command output includes the global BFD status, number of BFD sessions, and BFD session configuration, such as VPN instance, destination address, source address, interface, and status.

Example

# Display the BFD configuration in RM.

<HUAWEI> display rm bfd-session vpn-instance vrf1 destination 10.8.1.2 source 10.8.1.1 interface Vlanif10
BFD Global Status: ON
BFD Session Total Number: 1

BFD Session: 1
  Interface: Vlanif10    VRF Name: vrf1
  Destination     Source          Session-State Create-State
  10.8.1.2        10.8.1.1        Up            Established
  Route-Protocol  Rx-Interval(ms) Tx-Interval(ms) Multiplier
  BGP             1000            1000            5
Table 7-237  Description of the display rm bfd-session command output

Item

Description

BFD Global Status

Global BFD status:
  • ON: BFD is enabled globally.

  • OFF: BFD is disabled globally.

To set the global BFD status, run the bfd command.

BFD Session Total Number

Total number of BFD sessions.

BFD Session

Number of the BFD session.

Interface

Local physical interface bound to the BFD session.

VRF Name

Name of a VPN instance to which the BFD session is bound to.

Destination

Peer IP address bound to the BFD session.

Source

Source IP address bound to the BFD session.

Session-State

Status of the BFD session:
  • AdminDown: indicates that the BFD session is in AdminDown state when the shutdown (BFD session view) command is run.

  • Down: indicates that the BFD session in Down state.

  • Init: indicates that the BFD session is in Init state.

  • Up: indicates that the BFD session is in Up state.

Create-State

BFD session setup status in RM:
  • Creating: indicates that the routing protocol notifies RM of the session, but RM does not instruct BFD to set up a session.

  • Established: indicates that RM notifies BFD to set up a BFD session. You can view the Session-State field to check whether a BFD session is set up.

Route-Protocol

Routing protocol enabled with BFD:
  • BGP

  • IS-IS Level-1

  • IS-IS Level-2

  • IS-IS Level-1-2

  • OSPF

  • RIP

  • PIM

Rx-Interval(ms)

Configured receiving interval, in milliseconds.

Tx-Interval(ms)

Configured sending interval, in milliseconds.

Multiplier

Configured local detection multiplier.

display rm interface

Function

The display rm interface command displays routing management (RM) information on an interface.

Format

display rm interface [ interface-type interface-number ]

display rm interface [ vpn-instance vpn-instance-name ] [ ip-address ip-address ]

Parameters

Parameter Description Value
interface-type interface-number Displays RM information on the specified interface. -
vpn-instance vpn-instance-name Displays RM information on the interface of the specified VPN instance. The value must be an existing VPN instance name.
ip-address ip-address Displays RM information on the interface with the specified destination address. The value is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to view IPv4 RM information on an interface, including information about physical and logical interfaces of the interface. This information helps locate routing problems.

Example

# Display RM information on interfaces.

<HUAWEI> display rm interface

Name: InLoopBack0                                                               
Physical IF Info:                                                               
 IfnetIndex: 0x1                                                                
 State: UP LOOP MULT                                                            
 Slot: 0(Logic Slot: 9)                                                         
 IntType: 26, PriLog: 1, MTU: 1500, Reference Count: 7                           
 Bandwidth: 0, 0                                                                
 Baudrate: 0, 0                                                                 
 Delay: 0, Reliability: 0, Load: 0                                              

 LDP-ISIS sync capability: disabled                                             
 LDP-OSPF sync capability: disabled                                             
 InstanceID: 0, Instance Name: Public                                           
 Age: 75455sec                                                                  
Logical IF Info:                                                                
 IfnetIndex: 0x1, PhyIndex: 1 Logical Index : 1,                                
 Dest: 127.0.0.1, Mask: 255.0.0.0                                               
 State: UP LOOP PRM MULT , Reference Count 6                                    
 Age: 75455sec                                                                  
                                                                                
Name: NULL0                                                                     
Physical IF Info:                                                               
 IfnetIndex: 0x2                                                                
 State: UP NBMA MULT                                                            
 Slot: 0(Logic Slot: 9)                                                         
 IntType: 27, PriLog: 2, MTU: 1500, Reference Count 1                           
 Bandwidth: 0, 0                                                                
 Baudrate: 0, 0                                                                 
 Delay: 0, Reliability: 0, Load: 0                                              

 LDP-ISIS sync capability: disabled                                             
 LDP-OSPF sync capability: disabled                                             
 InstanceID: 0, Instance Name: Public                                           
 Age: 75455sec                                                                  
Logical IF Info:                                                                
 IfnetIndex: 0x2, PhyIndex: 2 Logical Index : 2,                                
 Dest: 0.0.0.0, Mask: 255.255.255.255                                           
 State: UP PRM NBMA MULT , Reference Count: 0                                    
 Age: 75456sec                                                                  
                                                                                
Name:  Ethernet0/0/0                                                                 
Physical IF Info:                                                               
 IfnetIndex: 0x4                                                                
 State: UP BCA MULT OSI                                                         
 Hardware Address: 0018-1111-2123                                               
 Slot: 0(Logic Slot: 9)                                                         
 IntType: 1, PriLog: 6, MTU: 1500, Reference Count: 4                            
 Bandwidth: 0, 0                                                                
 Baudrate: 0, 0                                                                 
 Delay: 0, Reliability: 0, Load: 0                                              

 LDP-ISIS sync capability: disabled                                             
 LDP-OSPF sync capability: disabled                                             
 InstanceID: 0, Instance Name: Public                                           
 Age: 75423sec                                                                  
                                                                                

# Display RM information on VLANIF100.

<HUAWEI> display rm interface vlanif 100
Name: vlanif100
Physical IF Info:
 IfnetIndex: 0x6
 State: DOWN P2P MULT
 Slot: 0(Logic Slot: 1)
 IntType: 3, PriLog: 0, MTU: 1500, Reference Count: 1
 Bandwidth: 0, 64000
 Baudrate: 0, 64000
 Delay: 0, Reliability: 0, Load: 0
 LDP-ISIS sync capability: disabled
 LDP-OSPF sync capability: disabled
 InstanceID: 0, Instance Name: Public
 Age: 1236sec
Table 7-238  Description of the display rm interface command output

Item

Description

Name

Name of the interface.

Physical IF Info

Physical interface information.

IfnetIndex

Network segment index of the interface.

State

Current interface status.

Hardware Address

MAC address of the interface.

Slot

Slot ID of the interface.

IntType

Type of the interface.

PriLog

Index of the primary logical interface.

MTU

Maximum transmission unit (MTU) of the interface.

Reference Count

Number of times the interface is referenced.

Bandwidth

Bandwidth of the interface.

Baudrate

Baud rate of the interface.

Delay

Link delay.

Reliability

Link reliability.

Load

Link load.

LDP-ISIS sync capability

Whether synchronization between LDP and IS-IS is enabled:
  • enabled: indicates that synchronization is enabled.
  • disabled: indicates that synchronization is disabled.

LDP-OSPF sync capability

Whether synchronization between LDP and OSPF is enabled:
  • enabled: indicates that synchronization is enabled.
  • disabled: indicates that synchronization is disabled.

InstanceID

Instance ID.

Instance Name

Instance name.

Logical IF Info

Logical interface information.

PhyIndex

Physical interface index.

Logical Index

Logical interface index.

Dest

Destination address.

Mask

Mask of the destination address.

Age

Lifetime of the displayed information.

display rm ipv6 bfd-session

Function

The display rm ipv6 bfd-session command displays the configurations of BFD sessions in Route Management (RM).

Format

display rm ipv6 bfd-session [ all | [ [ vpn-instance vpn-instance-name ] [ destination destination-address ] [ source source-address ] [ interface interface-type interface-number ] [ protocol { bgp | isis-l1 | isis-l2 | isis-l1l2 | ospfv3 | pim } ] ] ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value must be an existing VPN instance name.
destination destination-address Specifies the remote destination address. -
source source-address Specifies the local source address. -
interface interface-type interface-number Specifies the type and number of an outbound interface. -
protocol Indicates a routing protocol.
  • bgp: indicates the Border Gateway Protocol (BGP).

  • isis-l1: indicates IS-IS Level-1.

  • isis-l2: indicates IS-IS Level-2.

  • Isis-l1l2: indicates IS-IS Level-1-2.

  • ospfv3: indicates the Open Shortest Path First (OSPF) version 3 protocol.

  • pim: indicates the Protocol Independent Multicast (PIM) protocol.

-
all Displays all the configurations of BFD sessions in RM, including the BFD sessions of the public network and VPN. If all is not specified, only the configurations of BFD sessions in the public network are displayed. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use the command to view the BFD sessions that are dynamically created by the routing protocol. The configurations include the global status of BFD, number of BFD sessions, and VPN instance, destination address, source address, interface, and session status of each BFD session. To modify the parameters of a BFD session, refer to the bfd all-interfaces, ospfv3 bfd, isis ipv6 bfd, and peer bfd.

Example

# Display the configurations of BFD sessions in RM.

<HUAWEI> display rm ipv6 bfd-session vpn-instance a destination fc00:0:0::1 source fc00:0:0::2 interface GigabitEthernet1/0/1

BFD Global Status: ON
RM IPv6 BFD Session Total Number: 1
Destination: fc00:0:0::1
Source     : fc00:0:0::2
  Session-State      Local-Discr      Interface             VPN-Name   
  Up                 8192             GigabitEthernet1/0/1  a
  Route-Protocol     Rx-Interval(ms)  Tx-Interval(ms)       Multiplier
  BGP                1000             1000                  7
Table 7-239  Description of the display rm ipv6 bfd-session command output

Item

Description

BFD Global Status

Global status of BFD:
  • On: indicates that BFD is enabled globally.

  • Off: indicates that BFD is disabled globally.

RM IPv6 BFD Session Total Number

Total number of BFD sessions.

Destination

Destination IP address bound to the BFD session.

Source

Source IP address bound to the BFD session.

Session-State

Current status of a BFD session:
  • AdmDown: If the shutdown (BFD session view) command is used, the BFD session enters the AdmDown state.

  • Down: the BFD session is in the Down state.

  • Init: the BFD session is in the Init state.

  • Up: the BFD session is in the Up state.

Local-Discr

Local discriminator of the BFD session.
  • If the value is 0, it indicates that the RM is notified of the need to set up of a BFD session, but the RM has not instructed BFD to set up the session.

  • If the value is not 0, it indicates that RM has instructed BFD to set up a BFD session. If you need to learn the establishment of the BFD session, you can view the Session-State.

Interface

Local physical interface bound to the BFD session.

Route-Protocol

Routing protocol enabled with BFD:
  • BGP

  • IS-IS Level-1

  • IS-IS Level-2

  • IS-IS Level-1-2

  • OSPFv3

  • PIM

Rx-Interval (ms)

Configured receiving interval in milliseconds.

Tx-Interval (ms)

Configured sending interval in milliseconds.

Multiplier

Configured local detection multiplier.

VPN-Name

Name of the VPN instance.

display rm ipv6 interface

Function

The display rm ipv6 interface command displays IPv6 routing management (RM) information on an interface.

Format

display rm ipv6 interface [ interface-type interface-number ]

display rm ipv6 interface [ vpn-instance vpn-instance-name ] [ ipv6-address ipv6-address ]

Parameters

Parameter Description Value
interface-type interface-number Displays IPv6 RM information on the specified interface. -
vpn-instance vpn-instance-name Displays IPv6 RM information in a specified VPN instance. The value must be an existing VPN instance name.
ipv6-address ipv6-address Displays IPv6 RM information with the specified destination IPv6 address. The value is a 32-digit hexadecimal number, in the X:X:X:X:X:X:X:X format.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to view IPv6 RM information on an interface, including information about physical and logical interfaces of the interface. This information helps locate routing problems.

Example

# Display IPv6 RM information on all interfaces.

<HUAWEI> display rm ipv6 interface

Name: InLoopBack0
Physical IF Info:
 IfnetIndex: 0x1
 State: UP LOOP MULT
 Slot: 0(Logic Slot: 0)
 IntType: 26, PriLog: 1, MTU: 1500, Ref: 1
 Bandwidth: 0, 0
 Baudrate: 0, 0
 Delay: 0, Reliability: 0, Load: 0
 Age: 1635sec

Logical IF Info:
 IfnetIndex: 0x1, PhyIndex: 1, LogiIndex: 1
 Dest: ::1, Mask: 128
 State: UP LOOP PRM MULT , Ref 1
 Age: 1635sec

Name: NULL0
Physical IF Info:
 IfnetIndex: 0x2
 State: UP NBMA MULT
 Slot: 0(Logic Slot: 0)
 IntType: 27, PriLog: 2, MTU: 1500, Ref: 0
 Bandwidth: 0, 0
 Baudrate: 0, 0
 Delay: 0, Reliability: 0, Load: 0
 Age: 1635sec

Logical IF Info:
 IfnetIndex: 0x2, PhyIndex: 2, LogiIndex: 2
 Dest: ::, Mask: 128
 State: UP PRM NBMA MULT , Ref: 0
 Age: 1635sec
Table 7-240  Description of the display rm ipv6 interface command output

Item

Description

Name

Name of an interface.

Physical IF Info

Physical interface information.

IfnetIndex

Network segment index of the interface.

State

Interface status.

IntType

Interface type.

Slot

Slot ID.

PriLog

Index of the primary logical interface.

MTU

Maximum transmission unit (MTU) of the interface.

Ref

Number of times the interface is referenced.

Bandwidth

Bandwidth of the interface.

Baudrate

Baud rate of the interface.

Delay

Link delay.

Reliability

Link reliability.

Load

Link load.

Age

Lifetime of the displayed information.

Logical IF Info

Logical interface information.

PhyIndex

Physical index.

LogiIndex

Logical index.

Dest

Destination IPv6 address.

Mask

Prefix length of the destination IPv6 address.

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 must be an existing VPN instance name.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Some dynamic routing protocols require a router ID to uniquely identify a device. If no router ID is specified when these routing protocols are enabled, the system router ID is used by default. You can run the display router id command to check the system router ID.

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 route resource

Function

The display route resource command displays the total number of IPv4 and IPv6 route prefixes in the IP routing table on the device.

Format

display route resource

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display route resource command displays the total number of IPv4 and IPv6 route prefixes in the IP routing table on the device.

Example

# Display the total number of IPv4 and IPv6 route prefixes in the IP routing table on the device.

<HUAWEI> display route resource
 Total number of IPv4 Prefixes: 16
 Total number of IPv6 Prefixes: 13
Table 7-241  Description of the display route resource command output

Item

Description

Total number of IPv4 Prefixes

Current number of IPv4 route prefixes.

Total number of IPv6 Prefixes

Current number of IPv6 route prefixes.

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

1: Monitoring level

Usage Guidelines

You can run the display snmp-agent trap feature-name fib all command to view all trap messages of the FIB module.

Example

# Display all trap messages of the FIB module.

<HUAWEI>display snmp-agent trap feature-name fib all
------------------------------------------------------------------------------  
Feature name: FIB                                                               
Trap number : 12                                                                
------------------------------------------------------------------------------  
Trap name                       Default switch status   Current switch status   
hwBoardFwdResLackResume         off                     off                     
hwBoardFwdResLack               off                     off                     
hwWholeFwdResLackResume         off                     off                     
hwWholeFwdResLack               off                     off                     
hwBoardFwdResThresholdExceedResume                                              
                                off                     off                     
hwBoardFwdResThresholdExceed    off                     off                     
hwWholeFwdResThresholdExceedResume                                              
                                off                     off                     
hwWholeFwdResThresholdExceed    off                     off                     
hwFIBOverloadSuspend            on                      on                      
hwFIBOverloadSusResume          on                      on                      
hwFIBOverloadForward            on                      on                      
hwFIBOverloadFwResume           on                      on 
Table 7-242  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:
  • hwboardfwdreslackresume: alarm of when the board forwarding engine resources were resumed. This trap is a non-excessive one.
  • hwboardfwdreslack: alarm of when the board forwarding engine resources were overloaded. This trap is a non-excessive one.
  • hwwholefwdreslackresume: alarm of when the whole device forwarding engine resources were resumed. This trap is a non-excessive one.
  • hwwholefwdreslack: alarm of when the whole device forwarding engine resources were overloaded. This trap is a non-excessive one.
  • hwboardfwdresthresholdexceedresume: alarm of when the board forwarding engine resources fell below the threshold. This trap is a non-excessive one.
  • hwboardfwdresthresholdexceed: alarm of when the board forwarding engine resources exceeded the threshold. This trap is a non-excessive one.
  • hwwholefwdresthresholdexceedresume: alarm of when the whole device forwarding engine resources fell below the threshold. This trap is a non-excessive one.
  • hwwholefwdresthresholdexceed: alarm of when the whole device forwarding engine resources exceeded the threshold. This trap is a non-excessive one.
  • hwfiboverloadforward: alarm of when the interface board is in the overload forwarding state because the FIB module is overload. It is a non-excessive trap.
  • hwfiboverloadfwresume: alarm of when the interface board changes from the overload forwarding state to the normal state. It is a non-excessive trap.
  • hwfiboverloadsuspend: alarm of when the interface board is in the overload suspension state because the FIB module is overload. It is a non-excessive trap.
  • hwfiboverloadsusresume: alarm of when the interface board changes from the overload suspension state to the normal state. It is a non-excessive trap.

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 l3mb all

Function

The display snmp-agent trap feature-name l3mb all command displays the status of all the traps related to the L3MB module.

Format

display snmp-agent trap feature-name l3mb all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display snmp-agent trap feature-name l3mb all command to view the status of all the traps related to the L3MB module.

You can run the snmp-agent trap enable feature-name l3mb command to change the status of the traps related to the L3MB module.

Example

# Display the status of all traps related to the L3MB module.

<HUAWEI> display snmp-agent trap feature-name l3mb all
------------------------------------------------------------------------------  
Feature name: L3MB                                                              
Trap number : 6                                                                 
------------------------------------------------------------------------------  
Trap name                       Default switch status   Current switch status   
hwBoardL3FwdResLack             on                      on                      
hwBoardL3FwdResLackResume       on                      on                      
hwBoardL3ACLResLack             on                      on
hwBoardServiceFailed            on                      on
hwBoardIPv6ACLResLack           on                      on
hwFwdEntryConflict              on                      on                      
hwFwdEntryConflictResume        on                      on
hwBoardL3NDResLack              on                      on
Table 7-243  Description of the display snmp-agent trap feature-name l3mb all command output

Item

Description

Feature name

Name of the module to which a trap belongs.

Trap number

Number of traps.

Trap name

Name of a trap of the L3MB module:

  • hwBoardL3FwdResLack: The Layer 3 resource usage reaches or exceeds the upper threshold.
  • hwBoardL3FwdResLackResume: The Layer 3 resource usage falls below the lower threshold.
  • hwBoardL3ACLResLack: The Layer 3 service is abnormal because ACL resources are insufficient.
  • hwBoardServiceFailed: The card fails to run globally delivered commands because Layer 2 user entry resources on the card are insufficient.
  • hwBoardIPv6ACLResLack: The IPv6 service is abnormal because ACL resources are insufficient.
  • hwFwdEntryConflict: The switch detected an anomaly when periodically checking l3-forward-entries.
  • hwFwdEntryConflictResume: The switch detected that l3-forward-entries return to normal.
  • hwBoardL3NDResLack: ND entries fail to be saved because of a hash conflict.

Default switch status

Default status of the trap function:

  • on: The trap function is enabled by default.
  • off: The trap function is disabled by default.

Current switch status

Current status of the trap function:

  • on: The trap function is enabled.
  • off: 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

1: Monitoring 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 : 21        
------------------------------------------------------------------------------
Trap name                       Default switch status   Current switch status 
RM_MIB_TRAP_TNLGROUP_UP         off                     off                 
RM_MIB_TRAP_TNLGROUP_DOWN       off                     off                 
hwIpv4PrefixExceedClear         off                     off                 
hwIpv4PrefixExceed              off                     off                 
hwIpv4PrefixThresholdExceedClear
                                off                     off                 
hwIpv4PrefixThresholdExceed     off                     off                 
hwPublicIpv4PrefixExceedClear   off                     off                 
hwPublicIpv4PrefixExceed        off                     off                 
hwPublicIpv4PrefixThresholdExceedClear
                                off                     off                 
hwPublicIpv4PrefixThresholdExceed
                                off                     off                 
hwIpv6PrefixExceedClear         off                     off                 
hwIpv6PrefixExceed              off                     off                 
hwIpv6PrefixThresholdExceedClear
                                off                     off                 
hwIpv6PrefixThresholdExceed     off                     off                 
hwPublicIpv6PrefixExceedClear   off                     off                 
hwPublicIpv6PrefixExceed        off                     off                 
hwPublicIpv6PrefixThresholdExceedClear
                                off                     off                 
hwPublicIpv6PrefixThresholdExceed
                                off                     off                 
hwL3vpnIpv6PrefixExceedClear    off                     off                 
hwL3vpnIpv6PrefixExceed         off                     off                 
hwL3vpnIpv6PrefixThresholdExceed
                                off                     off
Table 7-244  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, including:

  • RM_MIB_TRAP_TNLGROUP_UP: tunnel group reachable
  • RM_MIB_TRAP_TNLGROUP_DOWN: tunnel group unreachable
  • hwIpv4PrefixExceedClear: whether the clear alarm function in case the number of IPv4 route prefixes falls below that supported by the system
  • hwIpv4PrefixExceed: whether the alarm function in case the number of IPv4 route prefixes exceeds that supported by the system
  • hwIpv4PrefixThresholdExceedClear: whether the clear alarm function in case the number of IPv4 route prefixes falls below the clear alarm threshold
  • hwIpv4PrefixThresholdExceed: whether the alarm function in case the number of IPv4 route prefixes exceeds the alarm threshold
  • hwPublicIpv4PrefixExceedClear: whether the clear alarm function in case the number of IPv4 public route prefixes falls below that supported by the system
  • hwPublicIpv4PrefixExceed: whether the alarm function in case the number of IPv4 public route prefixes exceeds that supported by the system
  • hwPublicIpv4PrefixThresholdExceedClear: whether the clear alarm function in case the number of IPv4 public route prefixes falls below the clear alarm threshold
  • hwPublicIpv4PrefixThresholdExceed: whether the alarm function in case the number of IPv4 public route prefixes exceeds the alarm threshold
  • hwIpv6PrefixExceedClear: whether the clear alarm function in case the number of IPv6 route prefixes falls below that supported by the system
  • hwIpv6PrefixExceed: whether the alarm function in case the number of IPv6 route prefixes exceeds that supported by the system
  • hwIpv6PrefixThresholdExceedClear: whether the clear alarm function in case the number of IPv6 route prefixes falls below the clear alarm threshold
  • hwIpv6PrefixThresholdExceed: whether the alarm function in case the number of IPv6 route prefixes exceeds the alarm threshold
  • hwPublicIpv6PrefixExceedClear: whether the clear alarm function in case the number of IPv6 public route prefixes falls below that supported by the system
  • hwPublicIpv6PrefixExceed: whether the alarm function in case the number of IPv6 public route prefixes exceeds that supported by the system
  • hwPublicIpv6PrefixThresholdExceedClear: whether the clear alarm function in case the number of IPv6 public route prefixes falls below the clear alarm threshold
  • hwPublicIpv6PrefixThresholdExceed: whether the alarm function in case the number of IPv6 public route prefixes exceeds the alarm threshold
  • hwL3vpnIpv6PrefixExceedClear: whether the alarm function in case the number of IPv6 route prefixes in the VPN instance exceeds the maximum number that is allowed
  • hwL3vpnIpv6PrefixExceed: whether the alarm function in case the number of IPv6 route prefixes in the VPN instance exceeds the maximum number that is allowed
  • hwL3vpnIpv6PrefixThresholdExceed: whether the alarm function in case the number of IPv6 route prefixes in the VPN instance exceeds the alarm threshold

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-balance

Function

The ecmp load-balance command sets the ECMP load balancing mode.

The undo ecmp load-balance command deletes the configured ECMP load balancing mode.

By default, ECMP load balancing is performed on packets based on the source IP address, destination IP address, transport-layer source port number and destination port number.

Format

ecmp load-balance sip [ dip ] [ port ]

undo ecmp load-balance sip [ dip ] [ port ]

Parameters

Parameter

Description

Value

sip

Configures ECMP load balancing based on the source IP address.

-

dip

Configures ECMP load balancing based on the destination IP address.

-

port

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

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

If you run the ecmp load-balance command in the system view multiple times, only the latest configuration takes effect.

Example

# Configure ECMP load balancing based on the source IP address.

<HUAWEI> system-view
[HUAWEI] ecmp load-balance sip

ecmp load-balance enhanced profile

Function

The ecmp load-balance enhanced profile command sets enhanced ECMP load balancing and applies the ECMP profile.

The undo ecmp load-balance enhanced profile command restores the default configuration.

By default, no ECMP profile is used, and ECMP load balancing is performed on packets based on the source IP address, destination IP address, transport-layer source port number and destination port number.

Format

ecmp load-balance enhanced profile profile-name

undo ecmp load-balance enhanced profile profile-name

Parameters

Parameter

Description

Value

profile-name

Specifies the name of an ECMP profile.

The value is a string of 1 to 31 case-sensitive characters without spaces.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When multiple paths to the same destination are available on the network, you can perform ECMP load balancing among these paths to reduce the load on a link. Compared with common ECMP load balancing, enhanced ECMP load balancing provides more load balancing modes. After an ECMP profile is created, you can run the ipv4 field command to set load balancing modes.

Prerequisites

Before applying an ECMP profile, run the ecmp-profile command to create the ECMP profile. Otherwise, the following information is displayed on the S7700 and S9700:

Error: The ECMP profile profile-name does not exist.

Precautions

Only one ECMP profile can be configured on each device.

If you run the ecmp load-balance enhanced profile and ecmp load-balance commands on the same interface, the command that you run later takes effect.

Example

# Configure enhanced ECMP load balancing.

<HUAWEI> system-view
[HUAWEI] ecmp load-balance enhanced profile test

System Response

None

ecmp-profile

Function

The ecmp-profile command creates an ECMP profile and displays the ECMP profile view.

The undo ecmp-profile command deletes an ECMP profile.

By default, no ECMP profile is created.

Format

ecmp-profile profile-name

undo ecmp-profile profile-name

Parameters

Parameter

Description

Value

profile-name

Specifies the name of an ECMP profile.

The value is a string of 1 to 31 case-sensitive characters without spaces.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

A maximum of one ECMP profile can be configured on each device. If an ECMP profile has been applied, you must run the undo ecmp load-balance enhanced profile and undo ecmp-profile commands to cancel the ECMP profile before configuring a new ECMP profile.

Example

# Create an ECMP profile test, and enter the ECMP profile view.

<HUAWEI> system-view
[HUAWEI] ecmp-profile test
[HUAWEI-ecmp-profile-test]

# Deleted the used ECMP profile test.

<HUAWEI> system-view
[HUAWEI] undo ecmp load-balance enhanced profile test
[HUAWEI] undo ecmp-profile test

ecmp local-preference disable

Function

The ecmp local-preference disable command disables ECMP local preferential forwarding.

The undo ecmp local-preference disable command disables ECMP local preferential forwarding.

By default, ECMP local preferential forwarding is enabled.

Format

ecmp local-preference disable

undo ecmp local-preference disable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, you can use an Eth-Trunk or equal-cost routes to implement traffic load balancing. In a CSS, when an inter-chassis Eth-Trunk is unavailable, you can use equal-cost routes for traffic load balancing. Because traffic will be forwarded between member switches, during a CSS switchover, traffic switching depends on route convergence, some traffic will be lost. In this case, use ECMP local preferential forwarding to improve route convergence performance during a CSS switchover and reduce traffic loss. In ECMP local preferential forwarding, traffic reaching the local switch is preferentially forwarded through a local interface. If the local outbound interface fails, traffic is forwarded through an interface on another member switch.

In Figure 7-2, SwitchA and SwitchB set up a CSS and implement ECMP load balancing with upstream devices. If local preferential forwarding is not configured, traffic reaching SwitchA is load balanced based on ECMP, and some traffic is forwarded through CSS cables and sent out from a physical interface on SwitchB. If local preferential forwarding is configured, traffic reaching SwitchA is forwarded through a local physical interface instead of a physical interface on SwitchB.

Figure 7-2  ECMP local preferential forwarding

Configuration Impact

After ECMP local preferential forwarding is enabled in a CSS, traffic entering from the local device is preferentially forwarded through a local interface. Therefore, even load balancing of the traffic cannot be guaranteed. To address this issue, run the ecmp local-preference disable command to disable ECMP local preferential forwarding.

Precautions

  • Only a CSS supports ECMP local preferential forwarding.

  • If the system software of a switch is upgraded to V200R010C00 or later, the ecmp local-preference disable configuration is automatically generated.

  • Enabling or disabling ECMP local preferential forwarding takes effect immediately for newly added routes and takes effect for existing routes only after these routes are re-advertised.

  • ECMP local preferential forwarding does not take effect in the following scenarios:

    • No ARP entry for the next hop of a route is found.

    • The next hop of a route is a blackhole.

    • The next-hop outbound interface of a route is an Eth-Trunk interface.

Example

# Disable ECMP local preferential forwarding.

<HUAWEI> system-view
[HUAWEI] ecmp local-preference disable

fib regularly-refresh

Function

The fib regularly-refresh command configures the entire FIB entry update interval, FIB entry update interval per cycle, and the number of FIB entries updated per cycle.

The undo fib regularly-refresh command restores the default entire FIB entry update interval, FIB entry update interval per cycle, and the number of FIB entries updated per cycle.

By default, the entire FIB entry update interval is 1 minute, the FIB entry update interval per cycle is 1 second, and the number of FIB entries updated per cycle is 50.

Format

fib regularly-refresh { interval interval [ entry-number entry-number ] | entry-number entry-number | cycle-interval cycle-interval }

undo fib regularly-refresh { interval interval [ entry-number entry-number ] | entry-number entry-number | cycle-interval cycle-interval }

Parameters

Parameter Description Value
interval interval Specifies an interval at which FIB entries are refreshed. The value is an integer ranging from 1 to 300, in seconds.
entry-number entry-number Specifies the number of FIB entries refreshed per circle. The value is an integer ranging from 20 to 2000.
cycle-interval cycle-interval Specifies the entire interval at which FIB entries are updated.

The value is an integer ranging from 1 to 1440, in minutes.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Regular FIB entry refreshing occupies system resources, including CPU and memory resources. A longer interval and smaller number result in less impact on other services. You can flexibly configure the interval and number based on system resources.

To allow underlying data to be forwarded in real-time and effective ways, you can configure a device to update FIB entries in cycles. The cycle-interval parameter specifies the interval for FIB entry update per cycle. Note that the cycle-interval, interval, and entry-number parameters together determine the FIB entry update process. As an example, assume that a device has 500 FIB entries.
  • If the three parameters use default values, the 500 FIB entries are updated in 10 cycles (with 50 FIB entries updated in each cycle), and the entry update can be completed within 10s (1s for each cycle). The device stays idle from 10s to 1 minute (entire FIB entry update interval).
  • If interval is set to 10s and cycle-interval and entry-number keep their default values, the 500 IPv6 FIB entries are still updated in 10 cycles, taking a total of 100s. In this case, the update period exceeds 1 minute, and then device cycles update from the next minute (a total of 2 minutes at this point). That is, the device updates IPv6 FIB entries at an interval of 2 minutes.

Prerequisites

Regular FIB entry refreshing has been enabled using the undo fib regularly-refresh disable command in the system view.

Example

# Set an interval at which FIB entries are refreshed to 5 seconds and the number of FIB entries refreshed per circle to 200.

<HUAWEI> system-view
[HUAWEI] fib regularly-refresh interval 5 entry-number 200

fib regularly-refresh disable

Function

The fib regularly-refresh disable command disables the FIB entry update function.

The undo fib regularly-refresh disable command enables the FIB entry update function.

By default, the FIB entry update function is enabled.

Format

fib regularly-refresh disable

undo fib regularly-refresh disable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, a device starts FIB entry update 30 minutes after a device is powered on, and the update is performed regularly at an interval of 1 minute. Updating FIB entries occupy system resources. To avoid a high CPU usage within a short period, run the fib regularly-refresh { interval interval [ entry-number entry-number ] | entry-number entry-number | cycle-interval cycle-interval } command to set the entire FIB entry update interval or the FIB entry update interval per cycle to a larger value or reduce the number of FIB entries updated per cycle. If the CPU usage problem still persists, run the fib regularly-refresh disable command to disable the FIB entry update function.

Precautions

Disabling the FIB entry update function may cause a failure to rectify certain hardware faults in time. Exercise caution when running the fib regularly-refresh disable command.

Example

# Disable the FIB from being refreshed.

<HUAWEI> system-view
[HUAWEI] fib regularly-refresh disable

fib threshold-alarm

Function

The fib threshold-alarm command enables the alarm function for IPv4 route prefix usage and sets the alarm threshold.

The undo fib threshold-alarm command restores the default alarm threshold.

By default, the alarm function for IPv4 route prefix usage is enabled. The upper alarm threshold is 85% and the lower alarm threhold is 75%.

Format

fib threshold-alarm upper-limit upper-limit-value lower-limit lower-limit-value

undo fib threshold-alarm

Parameters

Parameter Description Value
upper-limit upper-limit-value Sets the upper alarm threshold for IPv4 route prefix usage. The value is an integer that ranges from 1 to 100, in percentage.
lower-limit lower-limit-value Sets the lower alarm threshold for IPv4 route prefix usage. The value is an integer that ranges from 1 to 100, in percentage.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Overload of the IPv4 route prefix usage will cause entries unable to be delivered and result in a forwarding failure.
  • When the upper alarm threshold for IPv4 route prefix usage is smaller than 100%, an alarm is generated when the resource usage exceeds the upper alarm threshold or reaches 100%.
  • When the upper alarm threshold for IPv4 route prefix usage is set to 100%, an alarm is generated when the resource usage reaches 100%.

Precautions

The upper alarm threshold for the IPv4 route prefix usage must be larger than or equal to the lower alarm threshold.

Example

# Enable the alarm function for IPv4 route prefix usage and set the upper and lower alarm thresholds to 85% and 60% respectively.

<HUAWEI> system-view
[HUAWEI] fib threshold-alarm upper-limit 85 lower-limit 60

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 route-policy route-policy-name

undo ip frr [ all ]

Parameters

Parameter Description Value
route-policy route-policy-name Enables IP FRR for public routes matching the specified route-policy. The name is a string of 1 to 40 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all Disables IP FRR for all public and private routes. If this parameter is not specified, IP FRR is disabled for all public routes. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

With the development of the network, services such as audio, online video,and finance have more requirements for real time. Generally, active/standby links are deployed on the network to ensure service stability.

However, under traditional forwarding modes, when multiple routes to the same destination exist, switch selects the optimal route, which is delivered to FIB table to direct data forwarding. When the optimal link is faulty, switch waits for the completion of route convergence, then selects another optimal route, and then deliver the route to the FIB table. Then the service is recovered. This process leads to a long-time service interruption and cannot meet service requirements.

Using the ip frr command, you can enable IP FRR of the public network. IP FRR can specify a backup next hop and a backup interface and set backup forwarding information for IPv4 routes. When the active link is faulty, the system can switch the traffic immediately to the backup link. This process is irrelevant to route convergence and therefore services are interrupted for short time.

Pre-configuration Tasks

The ip frr command should be used with the apply backup-interface command and the apply backup-nexthop command. It is recommended to use the route-policy command to create Route-Policy at first, in which the apply backup-interface command and the apply backup-nexthop command are used to set a backup outbound interface and a backup next hop for IPv4 route of the public network.

Precautions

Only one policy can be used at one time. New configuration will replace the previous one if another policy is configured. Configuration in the system view and that in the VPN instance IPv4 address family view will not interfere each other.

Using the undo ip frr all command, IP FRR of all the public network and the private networks is disabled. Use it with caution.

Example

# Specify a backup outbound interface and a backup next hop in route-policy ip_frr_rp and enable IP FRR for public routes in the system view.

<HUAWEI> system-view
[HUAWEI] route-policy ip_frr_rp permit node 10
[HUAWEI-route-policy] apply backup-interface vlanif 100
[HUAWEI-route-policy] apply backup-nexthop 192.168.20.2
[HUAWEI-route-policy] quit
[HUAWEI] ip frr route-policy ip_frr_rp 

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.

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.

  • If the number of IPv4 public route prefixes exceeds the value calculated from number x alert-percent/100, an alarm (RM_1.3.6.1.4.1.2011.5.25.145.19.1.3 hwPublicIpv4PrefixThresholdExceed) is generated.
  • If the number of IPv4 public route prefixes exceeds number, an alarm (RM_1.3.6.1.4.1.2011.5.25.145.19.1.1 hwPublicIpv4PrefixExceed) is generated.
  • If the number of IPv4 public route prefixes falls below the value calculated from (number x (alert-percent – 5))/100, a clear alarm (RM_1.3.6.1.4.1.2011.5.25.145.19.1.4 hwPublicIpv4PrefixThresholdExceedClear) is generated.
  • If the number of IPv4 public route prefixes exceeds number, a clear alarm (RM_1.3.6.1.4.1.2011.5.25.145.19.1.2 hwPublicIpv4PrefixExceedClear) is generated.

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.
  • The snmp-agent trap enable feature-name rm command must have been run so that alarms can be generated.

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 log-interval

Function

The ip prefix-limit log-interval command configures an interval at which logs are generated after the number of IPv4 public route prefixes exceeds the limit.

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

By default, the system generates logs at an interval of 5s after the number of IPv4 public route prefixes exceeds the limit.

Format

ip prefix-limit log-interval interval

undo ip prefix-limit log-interval

Parameters

Parameter Description Value
interval Specifies an interval at which logs are generated after the number of IPv4 public route prefixes exceeds the limit. The value is an integer ranging from 1 to 60, in seconds.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The system generates logs at an interval of 5s after the number of IPv4 public route prefixes exceeds the limit. You can run the ip prefix-limit log-interval command to set a larger value for the interval to decrease the frequency at which these logs are generated.

The maximum number of IPv4 public route prefixes supported by the routing table can be adjusted using the ip prefix-limit command.

Precautions

If a log is generated to record the event that the number of IPv4 public route prefixes reaches the limit, no more routes can be added to the routing table, and subsequent routes are discarded.

Example

# Set the interval at which logs are generated after the number of IPv4 public route prefixes exceeds the limit to 30s.

<HUAWEI> system-view
[HUAWEI] ip prefix-limit log-interval 30
Related Topics

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%.

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

ip route prefix-priority-scheduler

Function

The ip route prefix-priority-scheduler command sets the priority-based scheduling weight of IPv4 routes.

The undo ip route prefix-priority-scheduler command restores the default priority-based scheduling weight of IPv4 routes.

By default, the priority-based scheduling weight of IPv4 routes is 8:4:2:1.

Format

ip route prefix-priority-scheduler critical-weight high-weight medium-weight low-weight

undo ip route prefix-priority-scheduler

Parameters

Parameter Description Value
critical-weight Sets the scheduling weight of a critical queue. The value is an integer that ranges from 1 to 10.
high-weight Sets the scheduling weight of a high queue. The value is an integer that ranges from 1 to 10.
medium-weight Sets the scheduling weight of a medium queue. The value is an integer that ranges from 1 to 10.
low-weight Sets the scheduling weight of a low queue. The value is an integer that ranges from 1 to 10.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The integration of network services urgently requires differentiated services. Routes for key services, such as Voice over IP (VoIP), video conferences, and multicast services, need to be converged rapidly, while routes for common services can be converged relatively slowly. In this case, the system needs to converge routes based on their convergence priorities to improve network reliability.

Different routes can be set with different convergence priorities, which can be critical, high, medium, and low listed in descending order. Critical is the highest convergence priority; low is the lowest convergence priority. The system converges routes based on the convergence priorities and convergence rules, that is, schedules the convergence of routes of different convergence priorities in proportion, to guide service forwarding.

When the system is processing a large number of high-priority routes, low-priority routes may fail to be processed for a long time. In this case, to prevent system performance from being affected, run the ip route prefix-priority-scheduler command to adjust the priority-based scheduling weight of IPv4 routes.

Follow-up Procedure

In most cases, convergence priorities of routes are determined by route types. On an OSPF network, you can run the prefix-priority (OSPF) command to adjust the convergence priority of OSPF routes. On an IS-IS network, you can run the prefix-priority (IS-IS) command to adjust the convergence priority of IS-IS routes.

Example

# Set the priority-based scheduling weight of IPv4 routes to 10:2:1:1.

<HUAWEI> system-view
[HUAWEI] ip route prefix-priority-scheduler 10 2 1 1

ipv4 field (ECMP profile view)

Function

The ipv4 field command sets the load balancing mode of IPv4 packets in an ECMP profile.

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

By default, enhanced ECMP load balancing is performed on IPv4 packets based on the source IP address and destination IP address.

Format

ipv4 field { sip | dip | vlan | l4-sport | l4-dport | protocol | sport } *

undo ipv4 field { sip | dip | vlan | l4-sport | l4-dport | protocol | sport } *

Parameters

Parameter

Description

Value

sip

Configures ECMP load balancing based on the source IP address.

-

dip

Configures ECMP load balancing based on the destination IP address.

-

vlan

Configures ECMP load balancing based on the VLAN ID.

-

l4-sport

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

-

l4-dport

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

-

protocol

Configures ECMP load balancing based on the protocol number.

-

sport

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

-

Views

ECMP profile view

Default Level

2: Configuration level

Usage Guidelines

If an ECMP profile has been used, the ECMP load balancing mode configured using the ipv4 field command immediately takes effect, and no new ECMP profile needs to be used.

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

Example

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

<HUAWEI> system-view
[HUAWEI] ecmp-profile test
[HUAWEI-ecmp-profile-test] ipv4 field sip protocol

System Response

None

Related Topics

ipv6 fib-loadbalance-type hash-based

Function

The ipv6 fib-loadbalance-type hash-based command configures packets sent from a specified source to a specified destination to be forwarded using the same route.

The undo ipv6 fib-loadbalance-type hash-based command restores the default configuration.

By default, flow-based load balancing is used.

Format

ipv6 fib-loadbalance-type hash-based

undo ipv6 fib-loadbalance-type hash-based

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

This command configures packets sent from a specified source to a specified destination to be forwarded using the same route.

Example

# Configure packets sent from a specified source to a specified destination to be forwarded using the same route.

<HUAWEI> system-view
[HUAWEI] ipv6 fib-loadbalance-type hash-based

ipv6 fib regularly-refresh

Function

The ipv6 fib regularly-refresh command configures the entire IPv6 FIB entry update interval, IPv6 FIB entry update interval per cycle, and the number of IPv6 FIB entries updated per cycle.

The undo ipv6 fib regularly-refresh command restores the default entire IPv6 FIB entry update interval, IPv6 FIB entry update interval per cycle, and the number of IPv6 FIB entries updated per cycle.

By default, the entire IPv6 FIB entry update interval is 1 minute, the IPv6 FIB entry update interval per cycle is 1 second, and the number of IPv6 FIB entries updated per cycle is 50.

Format

ipv6 fib regularly-refresh { interval interval | entry-number entry-number | cycle-interval cycle-interval }

undo ipv6 fib regularly-refresh { interval interval | entry-number entry-number | cycle-interval cycle-interval }

Parameters

Parameter Description Value
interval interval Specifies an interval at which IPv6 FIB entries are refreshed. The value is an integer ranging from 1 to 300, in seconds.
entry-number entry-number Specifies the number of IPv6 FIB entries refreshed per circle. The value is an integer ranging from 20 to 2000.
cycle-interval cycle-interval Specifies the entire interval at which IPv6 FIB entries are updated.

The value is an integer ranging from 1 to 1440, in minutes.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Regular IPv6 FIB entry refreshing occupies system resources, including CPU and memory resources. A longer interval and smaller number result in less impact on other services. You can flexibly configure the interval and number based on system resources.

To allow underlying data to be forwarded in real-time and effective ways, you can configure a device to update IPv6 FIB entries in cycles. The cycle-interval parameter specifies the interval for IPv6 FIB entry update per cycle. Note that the cycle-interval, interval, and entry-number parameters together determine the IPv6 FIB entry update process. As an example, assume that a device has 500 IPv6 FIB entries.
  • If the three parameters use default values, the 500 IPv6 FIB entries are updated in 10 cycles (with 50 IPv6 FIB entries updated in each cycle), and the entry update can be completed within 10s (1s for each cycle). The device stays idle from 10s to 1 minute (entire FIB entry update interval).
  • If interval is set to 10s and cycle-interval and entry-number keep their default values, the 500 IPv6 FIB entries are still updated in 10 cycles, taking a total of 100s. In this case, the update period exceeds 1 minute, and then device cycles update from the next minute (a total of 2 minutes at this point). That is, the device updates IPv6 FIB entries at an interval of 2 minutes.

Prerequisites

IPv6 FIB 24-hour refresh has been enabled. By default, this function has been enabled. If not, run the undo ipv6 fib regularly-refresh disable command in the system view to enable it.

Example

# Set an interval at which IPv6 FIB entries are refreshed to 5 seconds and the number of FIB entries refreshed per circle to 200.

<HUAWEI> system-view
[HUAWEI] fib regularly-refresh interval 5 entry-number 200

ipv6 fib regularly-refresh disable

Function

The ipv6 fib regularly-refresh disable command disables IPv6 FIB regularly refresh.

The undo ipv6 fib regularly-refresh disable command enables IPv6 FIB regularly refresh.

By default, IPv6 FIB regularly refresh is enabled.

Format

ipv6 fib regularly-refresh disable

undo ipv6 fib regularly-refresh disable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

During peak hours, refreshing the IPv6 FIB can cause over-high CPU usage and affect service reliability. To resolve this problem, run the ipv6 fib regularly-refresh disable command to disable IPv6 FIB regularly refresh. After the CPU usage restores to a normal state, run the undo ipv6 fib regularly-refresh disable command to restore IPv6 FIB regularly refresh.

Precautions

Disabling IPv6 FIB regularly refresh may prevent the rectification of certain hardware forwarding entry faults. Exercise caution when running the ipv6 fib regularly-refresh disable command.

Example

# Disable IPv6 FIB regularly refresh.

<HUAWEI> system-view
[HUAWEI] ipv6 fib regularly-refresh disable
Warning: This operation will disable the function of the FIB regularly refresh,Confirm?[Y/N]:y
Info: The function of the FIB regularly refresh is disabled.

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.

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.

  • If the number of IPv6 public route prefixes exceeds the value calculated from number x alert-percent/100, an alarm (RM_1.3.6.1.4.1.2011.5.25.145.19.2.3 hwPublicIpv6PrefixThresholdExceed) is generated.
  • If the number of IPv6 public route prefixes exceeds number, an alarm (RM_1.3.6.1.4.1.2011.5.25.145.19.2.1 hwPublicIpv6PrefixExceed) is generated.
  • If the number of IPv6 public route prefixes falls below the value calculated from number x alert-percent/100, a clear alarm (RM_1.3.6.1.4.1.2011.5.25.145.19.2.4 hwPublicIpv6PrefixThresholdExceedClear) is generated.
  • If the number of IPv6 public route prefixes exceeds number, a clear alarm (RM_1.3.6.1.4.1.2011.5.25.145.19.2.2 hwPublicIpv6PrefixExceedClear) is generated.

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.
  • The snmp-agent trap enable feature-name rm command must have been run so that alarms can be generated.

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 log-interval

Function

The ipv6 prefix-limit log-interval command configures an interval at which logs are generated after the number of IPv6 public route prefixes exceeds the limit.

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

By default, the system generates logs at an interval of 5s after the number of IPv6 public route prefixes exceeds the limit.

Format

ipv6 prefix-limit log-interval interval

undo ipv6 prefix-limit log-interval

Parameters

Parameter Description Value
interval Specifies an interval at which logs are generated after the number of IPv6 public route prefixes exceeds the limit. The value is an integer ranging from 1 to 60, in seconds.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The system generates logs at an interval of 5s after the number of IPv6 public route prefixes exceeds the limit. You can run the ip prefix-limit log-interval command to set a larger value for the interval to decrease the frequency at which these logs are generated.

The maximum number of IPv6 public route prefixes supported by the routing table can be adjusted using the ipv6 prefix-limit command.

Precautions

If a log is generated to record the event that the number of IPv6 public route prefixes reaches the limit, no more routes can be added to the routing table, and subsequent routes are discarded.

Example

# Set the interval at which logs are generated after the number of IPv6 public route prefixes exceeds the limit to 30s.

<HUAWEI> system-view
[HUAWEI] ipv6 prefix-limit log-interval 30
Related Topics

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%.

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

ipv6 route prefix-priority-scheduler

Function

The ipv6 route prefix-priority-scheduler command sets the priority-based scheduling weight of IPv6 routes.

The undo ipv6 route prefix-priority-scheduler command restores the default priority-based scheduling weight of IPv6 routes.

By default, the priority-based scheduling weight of IPv6 routes is 8:4:2:1.

Format

ipv6 route prefix-priority-scheduler critical-weight high-weight medium-weight low-weight

undo ipv6 route prefix-priority-scheduler

Parameters

Parameter Description Value
critical-weight Sets the scheduling weight of a critical queue. The value is an integer that ranges from 1 to 10.
high-weight Sets the scheduling weight of a high queue. The value is an integer that ranges from 1 to 10.
medium-weight Sets the scheduling weight of a medium queue. The value is an integer that ranges from 1 to 10.
low-weight Sets the scheduling weight of a low queue. The value is an integer that ranges from 1 to 10.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The integration of network services urgently requires differentiated services. IPv6 routes for key services, such as Voice over IP (VoIP), video conferences, and multicast services, need to be converged rapidly, while routes for common services can be converged relatively slowly. In this case, the system needs to converge IPv6 routes based on their convergence priorities to improve network reliability.

Different IPv6 routes can be set with different convergence priorities, which can be critical, high, medium, and low listed in descending order. Critical is the highest convergence priority; low is the lowest convergence priority. The system converges IPv6 routes based on the convergence priorities and convergence rules, that is, schedules the convergence of IPv6 routes of different convergence priorities in proportion, to guide service forwarding.

When the system is processing a large number of high-priority IPv6 routes, low-priority IPv6 routes may fail to be processed for a long time. In this case, to prevent system performance from being affected, run the ipv6 route prefix-priority-scheduler command to adjust the priority-based scheduling weight of IPv6 routes.

Follow-up Procedure

In most cases, convergence priorities of IPv6 routes are determined by route types. On an ISISv6 network, run the ipv6 prefix-priority (IS-IS) command to adjust the convergence of ISISv6 routes.

Example

# Set the priority-based scheduling weight of IPv6 routes to 10:2:1:1 (critical:high:medium:low).

<HUAWEI> system-view
[HUAWEI] ipv6 route prefix-priority-scheduler 10 2 1 1

l3-forward-entry aging

Function

The l3-forward-entry aging enable command enables the l3-forward-entry aging function.

The undo l3-forward-entry aging enable command disables the l3-forward-entry aging function.

By default, the l3-forward-entry aging function is disabled.

Format

l3-forward-entry aging enable

undo l3-forward-entry aging enable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

The l3-forward-entry aging enable command must be used together with the l3-forward-entry regularly-check command. After the l3-forward-entry aging function is enabled, the system reads the periodic l3-forward-entry check result everyday between 2 am and 5 am. When residual Layer 3 forwarding entries exist for more than 48 hours, the system triggers resource recycling and entry deletion.

Example

# Enable the l3-forward-entry aging function.

<HUAWEI> system-view
[HUAWEI] l3-forward-entry aging enable

# Disable the l3-forward-entry aging function.

<HUAWEI> system-view
[HUAWEI] undo l3-forward-entry aging enable

l3-forward-entry regularly-check

Function

The l3-forward-entry regularly-check command enables periodic l3-forward-entry check and sets the periodic l3-forward-entry check interval, scanning time for each round of check, and number of entries checked in each round of check.

The undo l3-forward-entry regularly-check command restores the default settings of periodic l3-forward-entry check.

By default, periodic l3-forward-entry check is enabled, the periodic l3-forward-entry check interval is 1 minutes, the scanning time for each round of check is 1 second, and the number of entries checked in each round of check is 200.

Format

l3-forward-entry regularly-check { enable | cycle-interval cycle-interval-value | interval interval-value | entry-number number }

undo l3-forward-entry regularly-check { enable | cycle-interval | interval | entry-number }

Parameters

Parameter Description Value
cycle-interval cycle-interval-value

Sets the periodic l3-forward-entry check interval.

The value is an integer that ranges from 1 to 1440, in minutes.

interval interval-value

Sets the scanning time for each round of l3-forward-entry check.

The value is an integer that ranges from 1 to 300, in seconds.

entry-number number

Sets the number of entries checked in each round of check.

The value is an integer that ranges from 20 to 2000.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After periodic l3-forward-entry check is configured, the device periodically checks l3-forward-entries to ensure realtime and valid bottom-layer forwarded data and records the check result. The check result can help locate problems of Layer 3 forwarding software resource leak and residual Layer 3 forwarding hardware entries.

The three parameters, cycle-interval, interval, and entry-number, together determine the periodic l3-forward-entry check process. For example, the device has a total of 2,000 l3-forward-entries:
  • If the three parameters use their default values, that is, 2,000 entries need to be checked in 10 rounds of check and can be checked within 10 seconds (with the scanning time of each round of check as 1 second), the system is idle during the period between 10 seconds to 1 minutes (periodic check interval).
  • If cycle-interval is set to 1 minute, interval is set to 10 seconds, and entry-number uses the default value, 2,000 entries still need to be updated for 10 rounds of check, and a total of 100 seconds is required to finish updating these entries. Then the update time will exceed 1 minute, so the device needs to start periodic update within the next 1 minute. In this situation, periodic update is performed at an interval of 2 minutes.

Precautions

Periodic l3-forward-entry check occupies system resources, including CPU and memory resources. A longer check interval and fewer entries indicate a smaller impact on other services. You can flexibly configure the l3-forward-entry check interval and number of checked entries based on system resources.

Example

# Enable periodic l3-forward-entry check.

<HUAWEI> system-view
[HUAWEI] l3-forward-entry regularly-check enable

# Set the periodic l3-forward-entry check interval to 10 minutes.

<HUAWEI> system-view
[HUAWEI] l3-forward-entry regularly-check cycle-interval 10

# Set the scanning time for each round of l3-forward-entry check to 5 seconds.

<HUAWEI> system-view
[HUAWEI] l3-forward-entry regularly-check interval 5

# Set the number of entries checked in each round of check to 500.

<HUAWEI> system-view
[HUAWEI] l3-forward-entry regularly-check entry-number 500

# Disable periodic l3-forward-entry check.

<HUAWEI> system-view
[HUAWEI] undo l3-forward-entry regularly-check enable

recover fib overload forward

Function

The recover fib overload forward command restores the IPv4 FIB module on an LPU from the overload forwarding state to the normal working state.

Format

recover fib overload forward slot slot-id

Parameters

Parameter Description Value
slot slot-id Specifies the slot ID of an LPU whose IPv4 FIB module needs to be restored to the normal working state from the overload forwarding state. The value is determined based on the device configuration.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The IPv4 FIB module restores to the normal working state after the overload forwarding recovery is performed.

The preceding operations do not affect data and entry forwarding. Only the LPU returns to the normal working state.

Follow-up Procedure

After the recover fib overload forward command is executed, you must refresh the LPU to make the configuration take effect.

Example

# Restore the IPv4 FIB module on the LPU in slot 2 from the overload forwarding state to the normal working state.

<HUAWEI> system-view
[HUAWEI] recover fib overload forward slot 2

recover fib overload suspend

Function

The recover fib overload suspend command restores the IPv4 FIB and IPv6 FIB modules on an LPU from the overload suspension state to the normal working state.

Format

recover fib overload suspend slot slot-id

Parameters

Parameter Description Value
slot slot-id Specifies the slot ID of an LPU whose IPv4 FIB module or IPv6 FIB module needs to be restored to the normal working state from the overload forwarding state. The value is determined based on the device configuration.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

When an LPU is in overload suspension state, the physical status of interfaces on the LPU becomes FIB overload down, and the overload state of the LPU becomes Overload suspend state. The LPU returns to normal working state after the overload suspension recovery is performed on the LPU.

After the LPU is restored from the overload suspension state, the IPv4 FIB and IPv6 FIB modules returns to the normal working state.

After the recover fib overload suspend command is executed on the LPU, you must refresh the IPv4 FIB and IPv6 FIB modules respectively to make the configuration take effect.

The preceding operations do not affect data and entry forwarding. Only the LPU returns to the normal working state.

If the LPU is not in the overload suspension state, the command output displays that the LPU is not in the overload suspension state.

Example

# Restore the LPU in slot 2 from the overload suspension state to the normal working state.

<HUAWEI> system-view
[HUAWEI] recover fib overload suspend slot 2

recover ipv6 fib overload forward

Function

The recover ipv6 fib overload forward command restores the IPv6 FIB module from the overload forwarding state to the normal working state.

Format

recover ipv6 fib overload forward slot slot-id

Parameters

Parameter Description Value
slot slot-id Specifies the slot ID of an LPU whose IPv6 FIB module needs to be configured with overload forwarding recovery. The value is determined based on the device configuration.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The IPv6 FIB module restores to the normal working state after the overload forwarding recovery is performed.

The preceding operations do not affect data and entry forwarding. Only the LPU returns to the normal working state.

Follow-up Procedure

After the recover ipv6 fib overload forward command is executed, you must refresh the LPU to make the configuration take effect.

Example

# Restore the IPv6 FIB module on the LPU in slot 2 from the overload forwarding state to the normal working state.

<HUAWEI> system-view
[HUAWEI] recover ipv6 fib overload forward slot 2

refresh fib

Function

The refresh fib command delivers IPv4 FIB policies and forwarding entries.

Format

refresh fib slot slot-id

Parameters

Parameter Description Value
slot slot-id Specifies the slot ID of an LPUa switch that needs to update IPv4 FIB policies. The value is determined based on the device configuration.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the IPv4 FIB policy changes, you must run the refresh fib command to update the LPU to make the configuration take effect.

After the refresh fib command is executed, you can view the FIB table to check whether the update succeeds.

Precautions

If the FIB module is in overload state and the LPU works in overload suspension mode, the IPv4 and IPv6 modules need to be updated.

Example

# Refresh IPv4 FIB module on the LPU in slot 2.

<HUAWEI> system-view
[HUAWEI] refresh fib slot 2

refresh ipv6 fib

Function

The refresh ipv6 fib command delivers IPv6 FIB policies and forwarding entries.

Format

refresh ipv6 fib slot slot-id

Parameters

Parameter Description Value
slot slot-id Specifies the slot ID of an LPUa switch that needs to update IPv6 FIB policies. The value is determined based on the device configuration.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

After the IPv6 FIB policy changes, you must run the refresh ipv6 fib command to update the LPU to make the configuration take effect.

After the refresh ipv6 fib command is executed, you can view the FIB table to check whether the update succeeds.

NOTE:

If the FIB module is in overload state and the LPU works in overload suspension mode, the IPv4 and IPv6 modules need to be updated.

Example

# Update the IPv6 FIB module on the LPU in slot 2.

<HUAWEI> system-view
[HUAWEI] refresh ipv6 fib slot 2

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 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 must be an existing 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 the following keywords. For details, see the routing protocols supported by the device: direct, bgp, isis, ospf, rip, , static , and unr. -
all-vpn-instance Clears the statistics in the IPv4 routing tables of all VPN instances. -

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 [ vpn-instance vpn-instance-name ] statistics protocol { all | protocol }

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of an IPv6 VPN instance. The value must be an existing 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.

The value may be bgp, direct, isis, ospfv3, ripng, static, or unr. The specific value varies depending on the routing protocol supported by the device.

all-vpn-instance Clears the statistics in the IPv6 routing tables of all VPN instances. -

Views

User view

Default Level

2: Configuration 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 selects a router ID based on IP addresses of current interfaces. The IP addresses of loopback interfaces and non-loopback interfaces are sequenced in descending order. Among these IP addresses, the second largest one is selected as the router ID. If a router ID conflict occurs on a device, the conflicting IP address will be removed from the preceding sequence.
    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

The IP address of the interface whose configuration is restored the first is used as the router ID after the restart.

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.

By default, the trap function is enabled for the hwfiboverloadforward, hwfiboverloadfwresume, hwfiboverloadsuspend and hwfiboverloadsusresume, the other is disabled.

Format

snmp-agent trap enable feature-name fib [ trap-name { hwboardfwdreslackresume | hwboardfwdreslack | hwwholefwdreslackresume | hwwholefwdreslack | hwboardfwdresthresholdexceedresume | hwboardfwdresthresholdexceed | hwwholefwdresthresholdexceedresume | hwwholefwdresthresholdexceed | hwfiboverloadforward | hwfiboverloadfwresume | hwfiboverloadsuspend | hwfiboverloadsusresume } ]

undo snmp-agent trap enable feature-name fib [ trap-name { hwboardfwdreslackresume | hwboardfwdreslack | hwwholefwdreslackresume | hwwholefwdreslack | hwboardfwdresthresholdexceedresume | hwboardfwdresthresholdexceed | hwwholefwdresthresholdexceedresume | hwwholefwdresthresholdexceed | hwfiboverloadforward | hwfiboverloadfwresume | hwfiboverloadsuspend | hwfiboverloadsusresume } ]

Parameters

Parameter Description Value
trap-name Enables the traps of FIB events of specified types. -
hwboardfwdreslackresume

Enables the device to send trap when the board forwarding engine resources were resumed. This trap is a non-excessive one.

-
hwboardfwdreslack

Enables the device to send trap when the board forwarding engine resources were overloaded. This trap is a non-excessive one.

-
hwwholefwdreslackresume

Enables the device to send trap when the whole device forwarding engine resources were resumed. This trap is a non-excessive one.

-
hwwholefwdreslack

Enables the device to send trap when the whole device forwarding engine resources were overloaded. This trap is a non-excessive one.

-
hwboardfwdresthresholdexceedresume

Enables the device to send trap when the board forwarding engine resources fell below the threshold. This trap is a non-excessive one.

-
hwboardfwdresthresholdexceed

Enables the device to send trap when the board forwarding engine resources exceeded the threshold. This trap is a non-excessive one.

-
hwwholefwdresthresholdexceedresume

Enables the device to send trap when the whole device forwarding engine resources fell below the threshold. This trap is a non-excessive one.

-
hwwholefwdresthresholdexceed

Enables the device to send trap when the whole device forwarding engine resources exceeded the threshold. This trap is a non-excessive one.

-
hwfiboverloadforward

Enables the device to send trap when the interface board is in the overload forwarding state. This trap is a non-excessive one.

-
hwfiboverloadfwresume

Indicates the trap in the case that the interface board changes from the overload forwarding state to the normal state. This trap is a non-excessive one.

-
hwfiboverloadsuspend

Enables the device to send trap when the interface board is in the overload suspension state. This trap is a non-excessive one.

-
hwfiboverloadsusresume

Enables the device to send trap when the interface board changes from the overload suspension state to the normal state. This trap is a non-excessive one.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

If you do not specify trap-name, all traps of the FIB module will be enabled.

Example

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

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

snmp-agent trap enable feature-name l3mb

Function

The snmp-agent trap enable feature-name l3mb command enables the trap function for the L3MB module.

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

By default, the trap function is enabled for the L3MB module.

Format

snmp-agent trap enable feature-name l3mb [ trap-name { hwboardipv6aclreslack | hwboardl3aclreslack | hwboardl3fwdreslack | hwboardl3fwdreslackresume | hwboardl3ndreslack | hwboardservicefailed hwfwdentryconflict | hwfwdentryconflictresume } ]

undo snmp-agent trap enable feature-name l3mb [ trap-name { hwboardipv6aclreslack | hwboardl3aclreslack | hwboardl3fwdreslack | hwboardl3fwdreslackresume | hwboardl3ndreslack | hwboardservicefailed | hwfwdentryconflict | hwfwdentryconflictresume } ]

Parameters

Parameter Description Value
trap-name Indicates the trap function for a specified event. -
hwboardipv6aclreslack Indicates the trap that the IPv6 service is abnormal because ACL resources are insufficient. -
hwboardl3aclreslack Indicates the trap that the Layer 3 service is abnormal because ACL resources are insufficient. -
hwboardl3fwdreslack Indicates the trap that the Layer 3 resource usage reaches or exceeds the upper threshold. -
hwboardl3fwdreslackresume Indicates the trap that when the Layer 3 resource usage falls below the lower threshold. -
hwboardl3ndreslack Indicates the trap that ND entries fail to be saved because of a hash conflict. -
hwfwdentryconflict Indicates the trap that the switch detected an anomaly when periodically checking l3-forward-entries. -
hwfwdentryconflictresume Indicates the trap that the switch detected that l3-forward-entries return to normal. -
hwboardservicefailed Indicates the trap that the card fails to run globally delivered commands because Layer 2 user entry resources on the card are insufficient. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To enable the trap function for one or more events, you can specify trap-name.

Example

# Enable the system to generate a trap when the Layer 3 resource usage reaches or exceeds the upper threshold.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name l3mb trap-name hwboardl3fwdreslack

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.

By default, the alarm function for the RM module is disabled.

Format

snmp-agent trap enable feature-name rm [ trap-name { rm_mib_trap_tnlgroup_down | rm_mib_trap_tnlgroup_up | hwipv4prefixexceed | hwipv4prefixexceedclear | hwipv4prefixthresholdexceed | hwipv4prefixthresholdexceedclear | hwipv6prefixexceed | hwipv6prefixexceedclear | hwipv6prefixthresholdexceed | hwipv6prefixthresholdexceedclear | hwl3vpnipv6prefixexceed | hwl3vpnipv6prefixexceedclear | hwl3vpnipv6prefixthresholdexceed | hwpublicipv4prefixexceed | hwpublicipv4prefixexceedclear | hwpublicipv4prefixthresholdexceed | hwpublicipv4prefixthresholdexceedclear | hwpublicipv6prefixexceed | hwpublicipv6prefixexceedclear | hwpublicipv6prefixthresholdexceed | hwpublicipv6prefixthresholdexceedclear } ]

undo snmp-agent trap enable feature-name rm [ trap-name { rm_mib_trap_tnlgroup_down | rm_mib_trap_tnlgroup_up | hwipv4prefixexceed | hwipv4prefixexceedclear | hwipv4prefixthresholdexceed | hwipv4prefixthresholdexceedclear | hwipv6prefixexceed | hwipv6prefixexceedclear | hwipv6prefixthresholdexceed | hwipv6prefixthresholdexceedclear | hwl3vpnipv6prefixexceed | hwl3vpnipv6prefixexceedclear | hwl3vpnipv6prefixthresholdexceed | hwpublicipv4prefixexceed | hwpublicipv4prefixexceedclear | hwpublicipv4prefixthresholdexceed | hwpublicipv4prefixthresholdexceedclear | hwpublicipv6prefixexceed | hwpublicipv6prefixexceedclear | hwpublicipv6prefixthresholdexceed | hwpublicipv6prefixthresholdexceedclear } ]

Parameters

Parameter Description Value
trap-name Enables the alarm function for specific events. -
rm_mib_trap_tnlgroup_down Enables the alarm function for the tunnel group unreachable event. -
rm_mib_trap_tnlgroup_up Enables the alarm function for the tunnel group reachable event. -
hwipv4prefixexceed

Enables the alarm function in case the number of IPv4 route prefixes exceeds that supported by the system.

-
hwipv4prefixexceedclear

Enables the clear alarm function in case the number of IPv4 route prefixes falls below that supported by the system.

-
hwipv4prefixthresholdexceed

Enables the alarm function in case the number of IPv4 route prefixes exceeds the alarm threshold.

-
hwipv4prefixthresholdexceedclear

Enables the clear alarm function in case the number of IPv4 route prefixes falls below the clear alarm threshold.

-
hwipv6prefixexceed

Enables the alarm function in case the number of IPv6 route prefixes exceeds that supported by the system.

-
hwipv6prefixexceedclear

Enables the clear alarm function in case the number of IPv6 route prefixes falls below that supported by the system.

-
hwipv6prefixthresholdexceed

Enables the alarm function in case the number of IPv6 route prefixes exceeds the alarm threshold.

-
hwipv6prefixthresholdexceedclear

Enables the clear alarm function in case the number of IPv6 route prefixes falls below the clear alarm threshold.

-
hwl3vpnipv6prefixexceed

Enables the alarm function in case the number of IPv6 route prefixes in the VPN instance exceeds the maximum number that is allowed.

-
hwl3vpnipv6prefixexceedclear

Enables the clear alarm function in case the number of IPv6 route prefixes in the VPN instance falls below the maximum number that is allowed.

-
hwl3vpnipv6prefixthresholdexceed

Enables the alarm function in case the number of IPv6 route prefixes in the VPN instance exceeds the alarm threshold.

-
hwpublicipv4prefixexceed

Enables the alarm function in case the number of IPv4 public route prefixes exceeds that supported by the system.

-
hwpublicipv4prefixexceedclear

Enables the clear alarm function in case the number of IPv4 public route prefixes falls below that supported by the system.

-
hwpublicipv4prefixthresholdexceed

Enables the alarm function in case the number of IPv4 public route prefixes exceeds the alarm threshold.

-
hwpublicipv4prefixthresholdexceedclear

Enables the clear alarm function in case the number of IPv4 public route prefixes falls below the clear alarm threshold.

-
hwpublicipv6prefixexceed

Enables the alarm function in case the number of IPv6 public route prefixes exceeds that supported by the system.

-
hwpublicipv6prefixexceedclear

Enables the clear alarm function in case the number of IPv6 public route prefixes falls below that supported by the system.

-
hwpublicipv6prefixthresholdexceed

Enables the alarm function in case the number of IPv6 public route prefixes exceeds the alarm threshold.

-
hwpublicipv6prefixthresholdexceedclear

Enables the clear alarm function in case the number of IPv6 public route prefixes falls below the clear alarm threshold.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Guidelines

The snmp-agent trap enable feature-name rm command enables the alarm function to monitor the tunnel group status. To enable the alarm function for one or more specific events on the RM module, set trap-name in the command.

Follow-up Procedure

You can run the display snmp-agent trap feature-name rm all command to view the alarms related to the RM module.

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 rm_mib_trap_tnlgroup_up
Translation
Download
Updated: 2019-10-18

Document ID: EDOC1000178288

Views: 26622

Downloads: 109

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