No relevant resource is found in the selected language.

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

Reminder

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

upgrade

Command Reference

CloudEngine 8800, 7800, 6800, and 5800 V200R002C50

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

BGP Configuration Commands

NOTE:
  • Only the CE6850HI, CE6850U-HI, CE6851HI, CE6855HI, CE6856HI, CE6860EI, CE6870EI, CE6880EI, CE7850EI, CE7855EI, CE8850EI, and CE8860EI switches support BGP-VPNv4 address family view, BGP-VPNv6 address family view, BGP multi-instance view, and BGP multi-instance VPN instance IPv4 address family view.

  • Only the CE6850HI, CE6850U-HI, CE6851HI, CE6855HI, CE6856HI, CE6860EI, CE6870EI, CE6880EI, CE7850EI, CE7855EI, CE8850EI, and CE8860EI switches support multi-instance and instance parameter.

  • The CE5855EI does not support the BMP configuration.

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

active-route-advertise

Function

The active-route-advertise command enables BGP to advertise only the preferred routes in the IP routing table.

The undo active-route-advertise command restores the default setting.

By default, BGP advertises all preferred routes in the BGP routing table to neighbors.

Format

active-route-advertise

undo active-route-advertise

Parameters

None

Views

BGP view, BGP-IPv4 unicast address family view, BGP-VPN instance IPv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP advertises all preferred routes in the BGP routing table to neighbors. After the active-route-advertise is configured, only the routes preferred by BGP and also active at the routing management layer are advertised to neighbors.

Precautions

The active-route-advertise command and the routing-table rib-only command are mutually exclusive.

Example

# Enable BGP to advertise only the preferred routes in the IP routing table to neighbors.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] active-route-advertise

aggregate (BGP)

Function

The aggregate command creates an aggregated route in the BGP routing table.

The undo aggregate command deletes an aggregated route in the BGP routing table.

By default, no aggregated route is created in the BGP routing table.

Format

aggregate ipv4-address { mask | mask-length } [ as-set | attribute-policy route-policy-name1 | detail-suppressed | origin-policy route-policy-name2 | suppress-policy route-policy-name3 ] *

aggregate ipv6-address prefix-length [ as-set | attribute-policy route-policy-name1 | detail-suppressed | origin-policy route-policy-name2 | suppress-policy route-policy-name3 ] *

undo aggregate ipv4-address { mask | mask-length } [ as-set | attribute-policy route-policy-name1 | detail-suppressed | origin-policy route-policy-name2 | suppress-policy route-policy-name3 ] *

undo aggregate ipv6-address prefix-length [ as-set | attribute-policy route-policy-name1 | detail-suppressed | origin-policy route-policy-name2 | suppress-policy route-policy-name3 ] *

Parameters

Parameter Description Value
ipv4-address Specifies the IPv4 address of an aggregated route. The address is in dotted decimal notation.
mask Specifies the network mask of an aggregated route. The mask is in dotted decimal notation.
mask-length Specifies the network mask length of an aggregated route. The value is an integer that ranges from 0 to 32.
ipv6-address Specifies the IPv6 address of an aggregated route. The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
prefix-length Specifies the length of the prefix of an aggregated IPv6 route. The value is an integer that ranges from 0 to 128.
as-set Generates a route with the AS-SET. -
attribute-policy route-policy-name1 Specifies the name of an attribute policy for aggregated routes. The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
detail-suppressed Advertises only the aggregated route. -
origin-policy route-policy-name2 Specifies the name of a policy that allows route aggregation. The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
suppress-policy route-policy-name3 Specifies the name of a policy for suppressing the advertisement of specified routes. The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
NOTE:
  • ipv4-address is valid only in the BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP multi-instance VPN instance IPv4 address family view and BGP-VPN instance IPv4 address family view.

  • ipv6-address is valid only in the BGP-IPv6 unicast address family view and BGP-VPN instance IPv6 address family view.

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-VPN instance IPv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP route aggregation is classified into manual aggregation and automatic aggregation. The aggregate command can be used to configure manual aggregation. This command can aggregate routes in the local BGP routing table. Manually-aggregated routes take precedence over automatically aggregated routes.

If the specific member routes of an aggregated route have different Origin attributes, the Origin attribute of the aggregated route uses the value in the order of igp, egp, and incomplete. The aggregated route will carry the community attribute of every specific route.

The parameter as-set is used to create an aggregated route whose AS_Path attribute contains AS_Path information of specific routes. Exercise caution when using this parameter if many AS_Path attributes need to be aggregated because frequent changes in routes may cause route flapping.

The parameter detail-suppressed is used to suppress the advertisement of specific routes. After detail-suppressed is configured, only aggregated routes are advertised. Aggregated routes carry the atomic-aggregate attribute, not the community attributes of specific routes.

The parameter suppress-policy is used to suppress the advertisement of specified routes. The if-match clause of route-policy can be used to filter the routes to be suppressed. This means that only the routes matching the policy will be suppressed, and the other routes will still be advertised. The peer route-policy command can also be used to filter out the routes not to be advertised to peers.

After the parameter origin-policy is used, only the routes matching route-policy are aggregated.

The parameter attribute-policy is used to set attributes for an aggregated route. If the AS_Path attribute is set in the policy using the apply as-path command and as-set is set in the aggregate command, the AS_Path attribute in the policy does not take effect. The peer route-policy command can also be used to set attributes for an aggregated route.

Precautions

If the undo aggregate command is run, the system will match routes based on the configured parameter attribute-policy, origin-policy, suppress-policy, as-set, or detail-suppressed. If none of the parameters is not configured, the system will fail to execute the undo aggregate command.

Example

# Create an aggregated route. The path that is used to advertise this route is an AS-SET consisting of all aggregated paths.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] ipv4-family unicast
[*HUAWEI-bgp-af-ipv4] aggregate 172.16.0.0 255.255.0.0 as-set

as-notation plain

Function

The as-notation plain command configures a BGP 4-byte AS number to be displayed as an integer.

The undo as-notation plain command configures a BGP 4-byte AS number to be displayed in dotted notation.

By default, a BGP 4-byte AS number is displayed in dotted notation (that is, in the format of x.y).

Format

as-notation plain

undo as-notation plain

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, display commands such as the display bgp peer command display 4-byte AS numbers in dotted notation.

To display a 4-byte AS number as an integer, run the as-notation plain command. After the as-notation plain command is run, display commands display all 4-byte AS numbers as integers. These 4-byte AS numbers include:
  • Independent 4-byte AS number
  • 4-byte AS number in an extended community attribute
  • 4-byte AS number in a route distinguisher (RD)
  • 4-byte AS number in a VPN target (also called a route target)
  • 4-byte AS number in the Site-of-Origin attribute

Assume that a 4-byte AS number in dotted notation is x.y. Following is the conversion relationship between an integral 4-byte AS number and a 4-byte AS number in dotted notation:

Integral 4-byte AS number = x x 65536 + y

For example, if a 4-byte AS number in dotted notation is 2.3, the corresponding integral 4-byte AS number is 131075 (2 x 65536 + 3).

Precautions

After the as-notation plain command is run, the formats of 4-byte AS numbers in configuration information generated by the system do not change.
  • If integral 4-byte AS numbers are configured, 4-byte AS numbers in configuration information generated by the system are also displayed as integers.
  • If 4-byte AS numbers in dotted notation are configured, 4-byte AS numbers in configuration information generated by the system are also displayed in dotted notation.
Changing the format of 4-byte AS numbers will affect matching results of AS_Path regular expressions and extended community attribute filters. Therefore, if the system is using an AS_Path regular expression or an extended community attribute filter as an import or export policy, you must reconfigure an AS_Path regular expression using the ip as-path-filter command or an extended community attribute filter using the ip extcommunity-filter command after changing the format of 4-byte AS numbers. This reconfiguration ensures that routes match the import or export policy.
  • If integral 4-byte AS numbers are configured, you must change 4-byte AS numbers in AS_Path regular expressions and extended community attribute filters to integral 4-byte AS numbers.
  • If 4-byte AS numbers in dotted notation are configured, you must change 4-byte AS numbers in AS_Path regular expressions and extended community attribute filters to 4-byte AS numbers in dotted notation.

Example

# Configure a BGP 4-byte AS number to be displayed as an integer.

<HUAWEI> system-view
[~HUAWEI] as-notation plain
Warning: If the configuration takes effect, the regular expression of the filter for 4-byte AS path should be changed to the asplain format, otherwise match will fail. Continue? [Y/N]y

# Configure a BGP 4-byte AS number to be displayed in dotted notation.

<HUAWEI> system-view
[~HUAWEI] undo as-notation plain
Warning: If the configuration takes effect, the regular expression of the filter for 4-byte AS path should be changed to the asdot format, otherwise match will fail. Continue? [Y/N]y

as-path-limit

Function

The as-path-limit command sets the maximum number of AS numbers in the AS_Path attribute.

The undo as-path-limit command restores the default setting.

By default, the maximum number of AS numbers in the AS_Path attribute is 255.

Format

as-path-limit [ as-path-limit-num ]

undo as-path-limit

Parameters

Parameter Description Value
as-path-limit-num Specifies the maximum number of AS numbers in the AS_Path attribute.
NOTE:

The maximum value of as-path-limit-num for the 2-byte and 4-byte AS numbers is the same.

The value is an integer that ranges from 1 to 2000. By default, the value is 255.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

This command is used to restrict the maximum number of AS numbers in the AS_Path attribute only when the AS_Path attribute is reconstructed or the aggregated routes are generated.

Precautions

After the as-path-limit command is configured, a switch checks whether the number of AS numbers in the AS_Path attribute of the incoming route exceeds the maximum value. If the number of AS numbers exceeds the maximum value, the local switch will discard the route. Therefore, if the maximum number of AS numbers in the AS_Path attribute is set too small, routes will be lost.

Example

# Set the maximum number of AS numbers in the AS_Path attribute to 200.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] as-path-limit 200

auto-frr

Function

The auto-frr command enables BGP Auto FRR.

The undo auto-frr command disables BGP Auto FRR.

By default, BGP Auto FRR is disabled.

Format

auto-frr

undo auto-frr

Parameters

None

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv4 address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

This function is applicable to networks that require a low packet loss rate and a short delay.

Using BGP Auto FRR together with BFD is recommended. They can rapidly detect a link fault and switch traffic to a standby link if a fault occurs.

Precautions

If both the ip frr command and the auto-frr command are configured, the ip frr command takes precedence over the auto-frr command. If a route fails to match the routing policy specified in the ip frr command, the auto-frr command takes effect.

Example

# Enable BGP Auto FRR for unicast routes.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] auto-frr
# Enable Auto FRR in the BGP-VPN instance IPv6 address family view so that both VPNv6 FRR and VPN IPv6 FRR can be enabled.
<HUAWEI> system-view
[~HUAWEI] ip vpn-instance vpnb
[*HUAWEI-vpn-instance-vpnb] ipv6-family 
[*HUAWEI-vpn-instance-vpnb-af-ipv6] route-distinguisher 100:2 
[*HUAWEI-vpn-instance-vpnb-af-ipv6] quit
[*HUAWEI-vpn-instance-vpnb] quit
[*HUAWEI] bgp 100
[*HUAWEI-bgp] ipv6-family vpn-instance vpnb
[*HUAWEI-bgp6-vpnb] auto-frr

bestroute add-path

Function

The bestroute add-path command enables BGP ADD-PATH and configures the number of routes that the device can select.

The undo bestroute add-path command restores the default configurations.

By default, BGP ADD-PATH is not enabled.

Format

bestroute add-path path-number path-number

undo bestroute add-path

Parameters

Parameter Description Value
path-number path-number Specifies the number of routes that the device can select. The value is an integer that ranges from 2 to 64.

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv6 unicast address family view, BGP-VPNv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a scenario with an RR and clients, if the RR has multiple routes to the same destination (with the same prefix), the RR selects an optimal route from these routes and then sends only the optimal route to its clients. Therefore, the clients have only one route to the destination. If a link along this route fails, route convergence takes a long time, which cannot meet the requirements for high reliability. To address this issue, deploy the BGP ADD-PATH feature on the RR. With BGP ADD-PATH, the RR can send two or more routes with the same prefix to a specified IBGP peer. These routes can back up each other or load-balance traffic, which ensures high reliability in data transmission.

Follow-up Procedure

  • Run the peer capability-advertise add-path send command to enable the RR to send ADD-PATH routes to a specified IBGP peer.

  • Run the peer advertise add-path command to configure the number of routes that the RR can send to a specified IBGP peer.

Precautions

  • The bestroute add-path command is run on RRs in most cases although it can be configured on any router. After the command is run, the RR can select two to six routes.

  • The type (labeled or common) of ADD-PATH routes is the same as that of the optimal route.

  • You need to run the peer capability-advertise add-path receive command on the IBGP peer so that the IBGP peer can receive ADD-PATH routes from the specified RR.

Example

# Set the number of routes that the device can select to 6.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] bestroute add-path path-number 6

bestroute as-path-ignore

Function

The bestroute as-path-ignore command configures BGP to ignore the AS_Path attribute when it selects the optimal route.

The undo bestroute as-path-ignore command restores the default configuration.

By default, BGP uses the AS_Path attribute as one of route selection rules.

Format

bestroute as-path-ignore

undo bestroute as-path-ignore

Parameters

None

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-VPN instance IPv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the bestroute as-path-ignore command is used, BGP does not compare the AS path lengths of routes. By default, the route with the shortest AS path is preferred.

Precautions

After the bestroute as-path-ignore command is run, the AS_Path attribute is not used as one of the BGP route selection rules.

Example

# Configure BGP to ignore the AS_Path attribute when selecting the optimal route.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] ipv4-family unicast
[*HUAWEI-bgp-af-ipv4] bestroute as-path-ignore

bestroute igp-metric-ignore

Function

The bestroute igp-metric-ignore command configures BGP to ignore the metric value of the next-hop IGP route when selecting the optimal route.

The undo bestroute igp-metric-ignore command restores the default setting.

By default, BGP selects a route with the smallest metric value of the next-hop IGP route as the optimal route.

Format

bestroute igp-metric-ignore

undo bestroute igp-metric-ignore

Parameters

None

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-VPN instance IPv4 address family view, BGP-VPNv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a BGP network, the BGP device always receives multiple routes with the same prefix but to different paths from neighbors. BGP must select the optimal route to the prefix to guide packet forwarding. By default, BGP compares the next-hop IGP route metric values of these routes and selects the route with the smallest metric value as the optimal route.

To customize route selection policies, you can run the bestroute igp-metric-ignore command to configure BGP to ignore the metric value of the next-hop IGP route when selecting the optimal route.

Example

# Configure BGP to ignore the IGP metric when selecting the optimal route.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] ipv4-family unicast
[*HUAWEI-bgp-af-ipv4] bestroute igp-metric-ignore

bestroute med-confederation (BGP)

Function

The bestroute med-confederation command enables BGP to compare the Multi Exit Discriminator (MED) values of routes in a confederation when BGP selects the optimal route.

The undo bestroute med-confederation command restores the default settings.

By default, BGP compares the MED values of the routes that are from the same AS only.

Format

bestroute med-confederation

undo bestroute med-confederation

Parameters

None

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP compares only MED values of routes from the same AS, not including sub-ASs in a confederation. To enable BGP to compare MED values of routes in a confederation when selecting the optimal route, run the bestroute med-confederation command.

After the bestroute med-confederation command is configured, BGP compares MED values only when AS_Path does not contain the external AS (AS that is not in the confederation) number. Otherwise, BGP does not compare MED values.

For example, ASs 65000, 65001, 65002, and 65004 belong the same confederation. Routes to the same destination are listed as follows:

  • path1: AS_Path=65000 65004, med=2

  • path2: AS_Path=65001 65004, med=3

  • path3: AS_Path=65002 65004, med=4

  • path4: AS_Path=65003 65004, med=1

After the bestroute med-confederation command is run, the AS_Path attributes of paths 1, 2, and 3 does not contain the numbers of ASs that belong to other confederations. Therefore, when selecting routes based on MED values, BGP compares the MED values of paths 1, 2, and 3 only. This is because the AS_Path attribute of path 4 contains the number of an AS that does not belong to this confederation.

Example

# Configure BGP to compare the MED values of routes only in the confederation when selecting the optimal route.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] ipv4-family unicast
[*HUAWEI-bgp-af-ipv4] bestroute med-confederation

bestroute med-none-as-maximum

Function

The bestroute med-none-as-maximum command configures BGP to assign the maximum Multi Exit Discriminator (MED), 4294967295, to a route without an MED in route selection.

The undo bestroute med-none-as-maximum command restores the default configuration.

By default, BGP assigns 0 to a route without an MED in route selection.

Format

bestroute med-none-as-maximum

undo bestroute med-none-as-maximum

Parameters

None

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-VPN instance IPv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The bestroute med-none-as-maximum command takes effect in BGP route selection and is used only when no MED is in the route attributes. When the MED is lost, the MED uses the maximum value 4294967295 if the bestroute med-none-as-maximum command is used. Otherwise, the MED uses the default value 0, which may cause a failure to select the optimal route.

Example

# Configure BGP to assign the maximum MED of 4294967295 to a route without an MED in route selection.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] ipv4-family unicast
[*HUAWEI-bgp-af-ipv4] bestroute med-none-as-maximum

bestroute med-plus-igp

Function

The bestroute med-plus-igp command enables BGP to use the sum of MED multiplied by a MED multiplier and IGP cost multiplied by an IGP cost multiplier to select routes when MED is required to determine the optimal route.

The undo bestroute med-plus-igp command restores the default configuration.

By default, the MED and IGP cost of each route are used as separate route selection criteria.

Format

bestroute med-plus-igp [ igp-multiplier igp-multiplier | med-multiplier med-multiplier ] *

undo bestroute med-plus-igp [ igp-multiplier igp-multiplier | med-multiplier med-multiplier ] *

Parameters

Parameter Description Value
igp-multiplier igp-multiplier Specifies an IGP cost multiplier. The value is an integer that ranges from 1 to 1000. The default value is 1.
med-multiplier med-multiplier Specifies a MED multiplier. The value is an integer that ranges from 1 to 1000. The default value is 1.

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv6 unicast address family view, BGP-IPv4 multicast address family view,BGP-VPNv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-VPN instance IPv4 address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

By default, the MED and IGP cost of each route are used as separate route selection criteria. To enable BGP to use the sum of MED multiplied by a MED multiplier and IGP cost multiplied by an IGP cost multiplier to select routes when MED is required to determine the optimal route, run the bestroute med-plus-igp command. If you need two routes with different MEDs and IGP costs to balance traffic, ensure that the sum of MED multiplied by the MED multiplier and IGP cost multiplied by the IGP cost multiplier is the same between the two routes.

By default, if routes carry no MED, 0 is used as the MED.

Example

# Enable BGP to use the sum of MED multiplied by an MED multiplier and IGP cost multiplied by an IGP cost multiplier to select routes when MED is required to determine the optimal route.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] bestroute med-plus-igp

bestroute nexthop-resolved

Function

The bestroute nexthop-resolved command configures the condition of the route selection for next hop iteration.

The undo bestroute nexthop-resolved command restores the default configuration.

By default, labeled BGP IPv4 routes participate in route selection only when their next hops are iterated to IP addresses.

NOTE:

Only the CE6810LI supports this command.

Format

bestroute nexthop-resolved { ip | tunnel }

undo bestroute nexthop-resolved [ tunnel inherit-ip-cost ]

Parameters

Parameter Description Value
ip Allows labeled routes that are iterated to IP addresses to participate in route selection. -
tunnel Allows labeled routes that are iterated to MPLS tunnels to participate in route selection. -
inherit-ip-cost Allows the labeled routes that are iterated to IP addresses to inherit the cost values of corresponding IP routes during route selection. -

Views

BGP view, BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, labeled BGP IPv4 unicast routes that are iterated to IP address.participate in route selection. In non-RR networking, or RR networking where the BGP next hop is changed, BGP needs to check whether there is an LSP destined for the next hop. If such an LSP is not found, BGP needs to establish an LSP. If the default setting is adopted, a labeled BGP IPv4 unicast route may be selected prior to LSP establishment. As a result, services are incorrectly switched before LSP establishment, packet loss may occur, which affects service stability. The bestroute nexthop-resolved tunnel command can be run to allow route selection only after the labeled BGP IPv4 route is iterated to an LSP.

Precautions

The bestroute nexthop-resolved ip and bestroute nexthop-resolved tunnel commands are mutually exclusive.

Example

# In the BGP IPv4 unicast view, configure labeled BGP IPv4 unicast routes that are iterated to LSP tunnels to participate in route selection.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] ipv4-family unicast
[*HUAWEI-bgp-af-ipv4] bestroute nexthop-resolved tunnel

# In the BGP VPNv4 view, configure BGP VPNv4 routes that are iterated to LSP tunnels to participate in route selection.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] ipv4-family vpnv4
[*HUAWEI-bgp-af-vpnv4] bestroute nexthop-resolved tunnel

bestroute router-id-ignore

Function

The bestroute router-id-ignore command configures BGP to ignore the router ID when selecting the optimal route.

The undo bestroute router-id-ignore command restores the default configuration.

By default, BGP uses the router ID as one of route selection rules.

Format

bestroute router-id-ignore

undo bestroute router-id-ignore

Parameters

None

Views

BGP view, BGP-IPv4 unicast address family view, BGP-VPN instance IPv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view, BGP-IPv4 multicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When receiving multiple routes with the same prefix from multiple peers, BGP needs to select an optimal route from these routes. Configuring BGP not to compare the router IDs contained in routes when selecting the optimal route can prevent unnecessary route switching.

Example

# Configure BGP not to compare the router IDs contained in routes when selecting the optimal route.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] ipv4-family unicast
[*HUAWEI-bgp-af-ipv4] bestroute router-id-ignore

bestroute routerid-prior-clusterlist

Function

The bestroute routerid-prior-clusterlist command enables Router ID to take precedence over Cluster_List during BGP route selection.

The undo bestroute routerid-prior-clusterlist command restores the default configurations.

By default, Cluster_List takes precedence over Router ID during BGP route selection.

Format

bestroute routerid-prior-clusterlist

undo bestroute routerid-prior-clusterlist

Parameters

None

Views

Usage Scenario

BGP view, BGP-IPv4 unicast address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv4 address family view, BGP-VPN instance IPv6 address family view, BGP-IPv4 multicast address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-VPNv4 address family view

Configuration Impact

If each route carries an Originator_ID, the Originator_IDs rather than router IDs are compared during route selection. The route with the smallest Originator_ID is preferred. Therefore, after the <cmdname bestroute routerid-prior-clusterlist</cmdname> command is run, the Originator_ID takes precedence over the Cluster-List during BGP optimal route selection.

Default Level

2: Configuration level

Usage Guidelines

On a BGP network, after a router receives multiple routes with the same prefix but different paths from different peers, the router needs to select an optimal route from these routes to forward packets. By default, Cluster_List takes precedence over Router ID during BGP route selection. To enable Router ID to take precedence over Cluster_List during BGP route selection, run the bestroute routerid-prior-clusterlist command.

Example

# Enable Router ID to take precedence over Cluster_List during BGP route selection.

<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] bestroute routerid-prior-clusterlist

bgp

Function

The bgp command enables BGP and displays the BGP view.

The undo bgp command disables BGP.

By default, BGP is disabled.

Format

bgp { as-number-plain | as-number-dot } [ instance instance-name ]

undo bgp [ as-number-plain | as-number-dot ]

undo bgp { as-number-plain | as-number-dot } instance instance-name

Parameters

Parameter Description Value
as-number-plain Specifies the number of the AS, in integer format. The value is an integer that ranges from 1 to 4294967295.
as-number-dot Specifies the number of the AS, in dotted notation. The value is in the x.y format. Here, "x" and "y" are integers that range from 1 to 65535 and 0 to 65535 respectively.
instance instance-name Specifies the name of a BGP instance.
The value of instance-name can be an integer 1 or a string of 1 to 31 case-sensitive characters without spaces. The string can contain spaces if it is enclosed with double quotation marks (").
NOTE:
Each device can have only one BGP instance specified.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP is an inter-AS dynamic routing protocol. BGP running within an AS is called Internal BGP (IBGP), and BGP running between ASs is called External BGP (EBGP).

Whether to apply BGP to routing information transmission between ASs depends on the following conditions:

  • If at least one of the following conditions is met, BGP can be used:

    • An AS allows data packets to pass through on their way to another AS.

    • Multiple connections to external ISPs and the Internet exist in ASs.

    • Data flows entering or leaving ASs must be controlled.

  • If one of the following conditions is met, BGP does not need to be used:

    • Users are connected to only one ISP network.

    • The ISP does not need to provide Internet access services for users.

    • ASs adopt default routes between each other.

Precautions

After the bgp command is run, BGP is enabled.

Each device can run in at most two ASs, one of which must have a BGP instance name specified.

Exercise caution when using the undo bgp command because it will delete all BGP configurations on a device.

Example

# Enable BGP and enter the BGP view.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp]

bmp

Function

The bmp command starts BMP and then displays the BMP view or displays the BMP view directly.

The undo bmp command deletes all BMP configurations.

By default, BMP is disabled in the system.

Format

bmp

undo bmp

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

The BGP Monitoring Protocol (BMP) is designed to monitor BGP running status, such as BGP peer relationship establishment and termination and route updates. If you want to connect a device to a monitoring server, run the bmp command on the device to start BMP and perform configurations in the displayed BMP view.

Example

# Start BMP and enter the BMP view.

<HUAWEI> system-view
[~HUAWEI] bmp

check-first-as

Function

The check-first-as command enables the function to check the first AS number in the AS_Path list that is carried in the Update message sent by the EBGP peer.

The undo check-first-as command disables the function.

By default, BGP checks the first AS number in the AS_Path list that is carried in the Update message sent by the EBGP peer. If only the first AS number indicates the AS where the EBGP peer locates, the Update message is accepted. Otherwise, the Update message is denied, and the EBGP connection goes Down.

Format

check-first-as

undo check-first-as

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP checks the first AS number in the AS_Path list that is carried in the Update message sent by the EBGP peer. If only the first AS number indicates the AS where the EBGP peer locates, the Update message is accepted. Otherwise, the Update message is denied, and the EBGP connection goes Down.

Precautions

  • After the undo check-first-as command is configured, loops have a greater chance to occur. Therefore, use the command with caution.

Follow-up Procedure

After the configuration is complete, run the refresh bgp command if you want to check the received routes again.

Example

# Check the first AS number in the AS_Path list that is carried in the Update message sent by the EBGP peer.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] check-first-as
Related Topics

compare-different-as-med

Function

The compare-different-as-med command enables BGP to compare the MEDs in the routes of peers in different ASs.

The undo compare-different-as-med command restores the default configuration.

By default, BGP does not compare the MEDs in the routes of peers in different ASs.

Format

compare-different-as-med

undo compare-different-as-med

Parameters

None

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-VPN instance IPv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The command is used to control the MEDs to change the policy of BGP route selection. If the compare-different-as-med command is run, BGP will compare the MEDs of the routes from different ASs. If there are multiple reachable paths to the same destination, BGP prefers the route with the smallest MED.

Precautions

Do not use this command unless different ASs use the same IGP and route selection mode.

Example

# Enable BGP to compare the MEDs in the routes of peers in different ASs.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] ipv4-family unicast
[*HUAWEI-bgp-af-ipv4] compare-different-as-med

confederation id

Function

The confederation id command configures a BGP confederation and specifies a confederation ID for the BGP confederation.

The undo confederation id command removes the specified BGP confederation.

By default, no BGP confederation is configured.

Format

confederation id { as-number-plain | as-number-dot }

undo confederation id

Parameters

Parameter Description Value
as-number-plain Specifies the number of the AS, in integer format. The value is an integer that ranges from 1 to 4294967295.
as-number-dot Specifies the number of the AS, in dotted notation. The value is in the format of x.y, where x and y are integers that range from 1 to 65535 and from 0 to 65535, respectively.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A large AS may contain a huge number of fully meshed IBGP peer relationships. In this situation, configure a confederation.

Divide the AS into multiple small sub-ASs and group them into a confederation. Then establish EBGP connections between sub-ASs and establish fully meshed IBGP connections within the same sub-AS. Some key attributes of routes, such as the next hop, MED, and local preference are not discarded when these routes pass through sub-ASs. This can reduce the number of fully meshed IBGP peer relationships in an AS and keep the integrity of the original AS.

Precautions

The confederation ID is equal to the AS number. An external AS must specify the confederation ID when specifying the AS number of the peer. All the sub-ASs in the same confederation must be configured with the same confederation ID that must be different from the number of any sub-AS.

Example

# Configure a confederation ID. An AS is divided into sub-ASs 65001, 65002, 65003, and 65004, and their confederation ID is 9. Peer 10.2.3.4 is a member of the AS confederation. Peer 10.4.5.6 is a member outside the AS confederation. For the external members, confederation 9 is a complete AS.

<HUAWEI> system-view
[~HUAWEI] bgp 65001
[*HUAWEI-bgp] confederation id 9
[*HUAWEI-bgp] confederation peer-as 65002 65003 65004 
[*HUAWEI-bgp] peer 10.2.3.4 as-number 65002
[*HUAWEI-bgp] peer 10.4.5.6 as-number 65005
Related Topics

confederation nonstandard

Function

The confederation nonstandard command configures standard devices (in RFC 3065) in a confederation to communicate with nonstandard devices.

The undo confederation nonstandard command configures standard devices in a confederation to communicate only with standard devices.

By default, only standard devices in a confederation can communicate with each other.

Format

confederation nonstandard

undo confederation nonstandard

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To communicate with nonstandard devices, configure this command on all switchs in a confederation.

Precautions

After the confederation ID is configured, running the confederation nonstandard command will disconnect the sessions between a router and its IBGP peers as well as its confederation EBGP peers. Then, new connections are reestablished.

Example

# Enable the switch to communicate with nonstandard routers. The AS 100 contains two sub-ASs, 64000 and 65000.

<HUAWEI> system-view
[~HUAWEI] bgp 64000
[*HUAWEI-bgp] confederation id 100
[*HUAWEI-bgp] confederation peer-as 65000
[*HUAWEI-bgp] confederation nonstandard

confederation peer-as

Function

The confederation peer-as command configures the number of each sub-AS of the same confederation.

The undo confederation peer-as command removes the specified sub-AS from the confederation.

By default, no sub-AS number of the confederation is configured.

Format

confederation peer-as { as-number-plain | as-number-dot } &<1-32>

undo confederation peer-as { as-number-plain | as-number-dot } &<1-32>

Parameters

Parameter Description Value
as-number-plain Specifies the number of the AS, in integer format. The value is an integer that ranges from 1 to 4294967295.
as-number-dot Specifies the number of the AS, in dotted notation. The value is in the format of x.y, where x and y are integers that range from 1 to 65535 and from 0 to 65535, respectively.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A large AS may contain a huge number of fully meshed IBGP peer relationships. In this situation, configure a confederation.

Prerequisites

The confederation id command specifies the confederation ID of each sub-AS. If the confederation ID is not configured, this configuration is invalid.

Precautions

The sub-ASs configured in this command belong to the same confederation, and each sub-AS uses fully meshed network.

The old speaker with a 2-byte AS number and the new speaker with a 4-byte AS number cannot exist in the same confederation. AS4_Path does not support the confederation. If a 2-byte AS number and a 4-byte AS number co-exist in the same confederation, routing loops may occur, and the sub-AS numbers in the confederation may be transmitted out of the confederation.

If a confederation ID is configured and the command is run, all the TCP connections of the BGP peer relationships established using the sub-AS numbers specified in the command are torn down, and the BGP peer relationships are reestablished. Therefore, exercise caution when running this command.

Example

# Configure sub-ASs for the confederation.

<HUAWEI> system-view
[~HUAWEI] bgp 1090
[*HUAWEI-bgp] confederation id 100
[*HUAWEI-bgp] confederation peer-as 1091 1092 1093
Related Topics

dampening

Function

The dampening command enables BGP route flap suppression and modifies BGP route flap suppression parameters.

The undo dampening command restores the default configuration.

By default, BGP route flap suppression is disabled.

Format

dampening [ half-life-reach reuse suppress ceiling | route-policy route-policy-name ] * [ update-standard ]

undo dampening

Parameters

Parameter Description Value
half-life-reach Specifies the half life of a reachable route. The value is an integer that ranges from 1 to 45, in minutes. The default value is 15.
reuse Specifies the threshold for the route to be unsuppressed. If the penalty of the route falls below the threshold, the route is reused. The value is an integer that ranges from 1 to 20000. The default value is 750.
suppress Specifies the threshold for the route to be suppressed. If the penalty value of the route exceeds the threshold, the route is not used. The value is an integer that ranges from 1 to 20000, which must be greater than the value of reuse. The default value is 2000.
ceiling Specifies the penalty ceiling. The value is an integer that ranges from 1001 to 20000. The configured value must be greater than that of suppress. The default value is 16000.
route-policy route-policy-name Specifies the name of a route-policy. The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
update-standard Specifies that BGP adds a penalty value (500) to the route carried in the packet when the switch receives an Update packet. -

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP route flap dampening measures the stability of a route by using a penalty value. The greater the penalty value, the less stable the route. Each time route flapping occurs (the switch receives a Withdraw), BGP adds a penalty value to the route carried in the packet. If a route changes from active to inactive, the penalty value increases by 1000. If a route is updated when it is active, the penalty value increases by 500.

When the penalty value of the route exceeds the suppression threshold, the route is suppressed. The switch does not add the route to the IP routing table or advertise any Update packet to other BGP peers. If the route is marked with the d flag, the last packet received by the switch is an Update packet; if the route is marked with the h flag, the last packet received by the switch is a Withdraw packet. After the penalty value reaches a certain limit, it does not increase any more. The limit is called the penalty ceiling.

After the route is suppressed for a certain period, the penalty value is reduced by half. If the penalty value of a route marked with the d flag decreases to the reuse threshold, the d flag is removed, and the route becomes available and is selected preferentially. After that, the route can be added to the IP routing table and used to send Update packets to other BGP peers. If the penalty value of a route marked with the h flag decreases to 0, the route is deleted from the BGP routing table.

After BGP route dampening is configured, any parameter in the command can be used to dampen flapping routes. You can adjust the parameters as required. To increase the dampening time of flapping routes, perform any of the following operation (to reduce the dampening time, perform otherwise):
  • Increase ceiling.
  • Increase half-life-reach.
  • Reduce reuse.

Precautions

If the dampening command is run multiple times, the latest configuration overrides the previous one.

After the dampening command is run, the system suppresses unstable routes. This means that the system does not add unstable routes to the BGP routing table or advertise them to other BGP peers.

Note the following items when configuring BGP route flap dampening:

  • The value of suppress must be greater than that of reuse and smaller than that of ceiling.

  • If MaxSuppressTime obtained by using the formula of MaxSuppressTime = half-life-reach x 60 x (ln(ceiling/reuse)/ln(2)) is smaller than 1, suppression cannot be performed. You need to ensure that the value of MaxSuppressTime is equal to or greater than 1. This means that the value of ceiling/reuse must be great enough.

NOTE:

The dampening command is valid only for EBGP routes.

Example

# Enable EBGP route dampening and modify EBGP route damping parameters.

<HUAWEI> system-view
[HUAWEI] bgp 100
[*HUAWEI-bgp] ipv4-family unicast
[*HUAWEI-bgp-af-ipv4] dampening 10 1000 2000 5000

default ipv4-unicast

Function

The default ipv4-unicast command enables the IPv4 unicast address family for BGP peers by default.

The undo default ipv4-unicast command disables the IPv4 unicast address family for BGP peers by default.

By default, the IPv4 unicast address family is enabled for BGP peers.

Format

default ipv4-unicast

undo default ipv4-unicast

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the IPv4 unicast address family needs to be enabled by default for created BGP peers, the default ipv4-unicast command can be used to configure the default address family of BGP to the IPv4 unicast address family.

If the IPv4 unicast address family does not need to be enabled by default for created BGP peers, the undo default ipv4-unicast command can be used to disable the IPv4 unicast address family for all peers.

Precautions

After the undo default ipv4-unicast command is run, the peer enable command needs to be run if the created BGP peer needs to be enabled with the IPv4 unicast address family.

Example

# Disable the IPv4 unicast address family for all peers.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] undo default ipv4-unicast

default local-preference

Function

The default local-preference command sets the default local preference for BGP routes.

The undo default local-preference command restores the default configuration.

By default, the local preference for BGP routes is 100.

Format

default local-preference local-preference

undo default local-preference

Parameters

Parameter Description Value
local-preference Specifies the local preference for BGP routes. The greater the value, the higher the preference. The value is an integer that ranges from 0 to 4294967295.

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-VPN instance IPv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The Local_Pref attribute is used to determine an optimal route for traffic before traffic leaves an AS. When the switch that runs BGP has multiple routes to the same destination, the switch selects the route with the highest local preference as the optimal route.

Precautions

If the switch is already configured with a default local preference for BGP routes, the configuration of a new default local preference will override the previous configuration.

The local preference is exchanged only between IBGP peers and is not advertised to other ASs.

Example

# Set the default local preference for BGP routes to 200.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] ipv4-family unicast 
[*HUAWEI-bgp-af-ipv4] default local-preference 200

default med

Function

The default med command sets the default multi-exit-discriminator (MED) for BGP routes.

The undo default med command restores the default configuration.

By default, the MED is 0.

Format

default med med

undo default med

Parameters

Parameter Description Value
med Specifies the MED for BGP routes. The value is an integer that ranges from 0 to 4294967295.

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-VPN instance IPv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The default med command is valid only for the routes imported by using the import-route (BGP) command and the routes summarized by BGP on the local device.

The default med command sets the default MED and controls route selection for the traffic entering an AS. If the other attributes of routes to the same destination are the same, BGP will select the route with the smallest MED as the optimal route.

Precautions

If a default MED is configured on a device, configuring a new default MED will override the previous configuration and the new default MED will overwrite the previous one.

The MED is transmitted between two neighboring ASs only. Devices in an AS do not advertise the received MED to peers in other ASs.

Example

# Set the default MED of a BGP route to 10.

<HUAWEI> system-view
[~HUAWEI] bgp 1
[*HUAWEI-bgp] ipv4-family unicast 
[*HUAWEI-bgp-af-ipv4] default med 10

default-route imported

Function

The default-route imported command enables BGP to add the default route to the BGP routing table.

The undo default-route imported command disables BGP from adding the default route to the BGP routing table.

By default, BGP does not add the default route to the BGP routing table.

Format

default-route imported

undo default-route imported

Parameters

None

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-VPN instance IPv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a default route of other routing protocols is added to the BGP routing table, packets can be transmitted over the default route when no matched routing entry is found in the routing table, preventing packet loss.

Precautions

To import default routes, you need to run both the default-route imported command and the import-route (BGP) command. If only the import-route (BGP) command is used, default routes cannot be imported. In addition, the default-route imported command is used to import only the default routes that exist in the local routing table.

When a device needs to advertise default routes to a peer (group) and no default route exists in the local routing table, the peer default-route-advertise command needs to be used.

Example

# Import default routes to the BGP routing table.

<HUAWEI> system-view
[~HUAWEI] bgp 1
[*HUAWEI-bgp] ipv4-family unicast
[*HUAWEI-bgp-af-ipv4] default-route imported
[*HUAWEI-bgp-af-ipv4] import-route ospf 1

deterministic-med (BGP)

Function

The deterministic-med command enables the BGP deterministic-MED function so that routes with the same leftmost AS number are first compared during route selection.

The undo deterministic-med command disables the BGP deterministic-MED function so that routes are compared against each other according to the sequence in which they are received.

By default, the BGP deterministic-MED function is disabled.

Format

deterministic-med

undo deterministic-med

Parameters

None

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-VPN instance IPv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

After the BGP deterministic-MED function is enabled, when an optimal route is to be selected from routes that are received from different ASs and carry the same prefix, routes are first grouped based on the leftmost AS number in the AS_Path attribute. Routes with the same leftmost AS number are grouped together, and after comparison, an optimal route is selected for the group. The group optimal route is then compared with optimal routes from other groups to determine the final optimal route. This mode of route selection ensures that the sequence in which routes are received is irrelevant to the route selection result.

If the BGP deterministic-MED function is disabled, routes are compared against each other according to the sequence in which they are received. In this manner, the sequence in which routes are received is relevant to the result of route selection.

For example: Assume that the following BGP routes are available on the switch.
  • Route A1: AS(PATH) 12, med 100, igp metric 13, internal, rid 4.4.4.4

  • Route A2: AS(PATH) 12, med 150, igp metric 11, internal, rid 5.5.5.5

  • Route B: AS(PATH) 3, med 0, igp metric 12, internal, rid 6.6.6.6

If Route A1, Route A2, and Route B are received in turn, Route A1 and Route A2 are first compared. The leftmost AS number of Route A1 is the same as the leftmost AS number of Route A2, and therefore Route A1 is selected because its MED is smaller. After that, Route A1 and Route B are compared. Because the leftmost AS numbers of the two routes are different, the optimal route cannot be selected by comparing the MEDs of the two routes unless the compare-different-as-med command is configured. As a result, Route B is selected because its IGP metric is smaller.

If Route A2, Route B, and Route A1 are received in turn, Route A2 and Route B are first compared. Because leftmost AS number of Route A2 is different from the leftmost AS number of Route B, the optimal route cannot be selected by comparing the MEDs of the two routes unless the compare-different-as-med command is configured. As a result, Route A2 is selected because its IGP metric is smaller. After that, Route A2 and Route A1 are compared. The leftmost AS number of Route A1 is the same as the leftmost AS number of Route A2, and therefore Route A1 is selected because its MED is smaller.

Judging from the preceding route selection procedure, when the BGP deterministic-MED function is disabled, the sequence in which routes are received is relevant to the result of route selection. After the BGP deterministic-MED function is enabled, the sequence in which routes are received is no longer relevant to the result of route selection. Route A1 and Route A2 have the same leftmost AS number, Route A1 and Route A2 are compared first regardless of the sequence in which routes are received.

Example

# Enable the deterministic-MED function in the BGP view.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] deterministic-med

display bgp bfd session

Function

The display bgp bfd session command displays information about BFD sessions between BGP peers.

Format

display bgp bfd session { [ vpnv4 vpn-instance vpn-instance-name ] peer ipv4-address | all }

display bgp instance instance-name bfd session { peer ipv4-address | all }

display bgp instance instance-name bfd session vpnv4 vpn-instance vpn-instance-name peer ipv4-address

Parameters

Parameter Description Value
vpnv4 vpn-instance vpn-instance-name Displays information about the BFD session between BGP peers with the specified IPv4 VPN instance name. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
instance instance-name Specifies the name of a BGP instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
peer ipv4-address Displays information about the BFD session of the BGP peer with the specified IPv4 address. The value is in dotted decimal notation.
all Displays all BFD sessions between BGP peers. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The BFD session set up by BGP helps BGP quickly discover faults between BGP peers and informs BGP to recalculate routes for packet forwarding.

Run the display bgp bfd session command to display information about the BFD session set up by BGP in the following situations:
  • Check whether the BFD session is successfully set up or view detailed information about the BFD session that is successfully configured.
  • Check whether the BFD session set up by BGP is successfully deleted after running the undo peer bfd enable command.
  • Verify the configuration after running the undo peer bfd block command to prevent a peer from inheriting the BFD function of the peer group.
  • Verify the configuration after running the peer bfd command to set BFD parameters.

The information about the BFD session of a specified BGP peer can be displayed by specifying different parameters.

  • Run the display bgp bfd session vpnv4 vpn-instance vpn-instance-name peer ipv4-address command to display information about the BFD session of a specified BGP peer in a specified VRF.

  • Run the display bgp bfd session peer ipv4-address command to display information about the BFD session of a specified BGP peer on the public network.
  • Run the display bgp bfd session all command to display information about the BFD sessions of all BGP peers.

Prerequisites

The BFD session has been set up using the peer bfd enable command. If the BFD session has not been set up by BGP, no information is displayed after running the display bgp bfd session command.

Example

# Display all BFD sessions between BGP peers.

<HUAWEI> display bgp bfd session all
--------------------------------------------------------------------------------
  Local_Address      Peer_Address       Interface                               
  10.1.1.2           10.1.1.1           Vlanif222                               
  Tx-interval(ms)    Rx-interval(ms)    Multiplier  Session-State               
  0                  0                  0           Unknown                     
Wtr-interval(m)        
0                      
                                                                                
--------------------------------------------------------------------------------
Table 9-124  Description of the display bgp bfd session command output

Item

Description

Local_Address

Local address

Peer_Address

Peer address

Interface

Interface on which the BFD session is set up

NOTE:

Information about the interface on which the BFD session is set up only when the directly connected interface is used to set up the EBGP neighbor relationship. In other cases, information about the interface is displayed as Unknown.

Tx-interval (ms)

Interval for sending BFD packets, in milliseconds

Rx-interval (ms)

Interval for receiving BFD packets, in milliseconds

Multiplier

Local detection multiple

Session-State

BFD status
  • Admin down: The BFD session is closed on the local end.

  • BFD global disable: BFD is disabled globally.

  • BFD session number exceed: The number of BFD sessions exceeds the maximum limit.

  • Detect down: BFD detects a link status fault and interrupts the connection.

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

  • Neighbor down: The peer end detects that the BFD session goes Down and informs the local end of the change, and the local end then sets the neighbor status to Down.

  • Receive admin down: The BFD session is closed on the peer end (for example, the BFD session is disabled on the peer end).

  • Up: The BFD session is set up.

Wtr-interval(m)

WTR time of the BFD session, in minutes

display bgp error discard

Function

The display bgp error discard command displays the information about the discarded error BGP packets.

Format

display bgp error discard [ [ vpn-instance vpn-instance-name ] peer { ipv4-address | ipv6-address } ]

display bgp instance instance-name error discard vpn-instance vpn-instance-name peer ipv4-address

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays the BGP errors of a specified VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
peer Displays errors on a specified peer. -
ipv4-address Displays errors on a peer with the specified IPv4 address. It is in dotted decimal notation.
ipv6-address Displays errors on a peer with the specified IPv6 address. The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
instance instance-name Displays the BGP errors of a specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

When a BGP fault occurs, the display bgp error discard command can be run to check the information about discarded error packets. The errors include cluster ID conflicts and the threshold overflow of AS_Path attributes.

By specifying the peer parameter, you can check the information about the error packets discarded by a specified BGP peer.

Example

# Display information about discarded BGP error packets.

<HUAWEI> display bgp error discard
BGP discard Info Counts:                                                        
 Routes received with cluster ID loop            : 0                            
 Routes received with As path count over limit   : 0                            
 Routes advertised with As path count over limit : 0                            
 Routes received with As loop                    : 0                            
 Routes received with Zero RD(0:0)               : 0                            
 Routes received with no prefix                  : 0                            
                                                                                
BGP discard info:(IPv4 Unicast)                                                 
 Routes received with cluster ID loop            : 0                            
 Routes received with As path count over limit   : 0                            
 Routes advertised with As path count over limit : 0                            
 Routes received with As loop                    : 0                            
 Routes received with Zero RD(0:0)               : 0                            
                                                                                
No discard record.                                                              
Table 9-125  Description of the display bgp error discard command output

Item

Description

BGP discard Info Counts

Number of discarded BGP routes

Routes received with cluster ID loop

Number of discarded BGP routes with a duplicate cluster ID

Routes received with As path count over limit

Number of received BGP routes discarded due to the number of AS_Paths exceeding the upper threshold

Routes advertised with As path count over limit

Number of sent BGP routes discarded due to the number of AS_Paths exceeding the upper threshold

Routes received with As loop

Number of routes discarded because the AS_Path list carried by the routes contains the local AS number

Routes received with Zero RD(0:0)

Number of routes discarded because the RD carried by the routes is 0:0

Routes received with no prefix

Number of routes discarded because the route has no prefix

No discard record

No record about packet discarding

display bgp graceful-restart status

Function

The display bgp graceful-restart status command displays the GR information about a BGP speaker.

Format

display bgp [ instance instance-name ] graceful-restart status

Parameters

Parameter Description Value
instance instance-name Specifies the name of a BGP instance.
The value of instance-name can be an integer 1 or a string of 1 to 31 case-sensitive characters without spaces. The string can contain spaces if it is enclosed with double quotation marks (").
NOTE:
Each device can have only one BGP instance specified.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display bgp graceful-restart status command to check the GR information about a BGP speaker, such as the GR capability and time parameters.

Example

# Display the GR information about a BGP speaker.

<HUAWEI> display bgp graceful-restart status
-------------------- BGP SYSTEM GR STATUS -------------
 GR is configured, TimerValues (RESTARTER: 150, EOR:600)
-------------------------------------------------------
IPv4-UNC (_public_)
Peers:
   10.1.1.2
    GR capability is not negotiated
     Peer state: Active
     GR state: false
Table 9-126  Description of the display bgp graceful-restart status command output

Item

Description

GR is configured

The GR capability of a BGP speaker is enabled.

If the GR capability is disabled, the command output shows GR is not configured.

TimerValues

Timer values.

RESTARTER

Time of waiting for a peer relationship to be reestablished, in seconds.

EOR

Time of waiting for End-Of-RIB, in seconds.

IPv4-UNC (_public_)

Public unicast address family.

GR capability is not negotiated

GR capability is not negotiated with a peer.

Peer state

Status of the peer.
  • Idle: indicates that BGP denies any connection request. This is the initial status of BGP.

  • Active: indicates that BGP tries to set up a TCP connection. This is the intermediate status of BGP.

  • Established: indicates that BGP peers can exchange Update, Notification, and Keepalive messages.

  • Connect: indicates that BGP is waiting for the complete setup of the TCP connection before performing further actions.

  • OpenSent: indicates that BGP is waiting for an Open message from the peer.

  • OpenConfirm: indicates that BGP is waiting for a Notification message and a Keepalive message.

GR state

Status of the peer:
  • true: The peer is in the GR state.
  • false: The peer is not in the GR state.

display bgp group

Function

The display bgp group command displays information about BGP peer groups.

Format

display bgp [ instance instance-name ] group [ group-name ]

display bgp [ instance instance-name ] vpnv4 { all | vpn-instance vpn-instance-name } group [ group-name ]

display bgp ipv6 group [ group-name ]

display bgp vpnv6 { all | vpn-instance vpn-instance-name } group [ group-name ]

display bgp [ instance instance-name ] evpn group [ group-name ]

Parameters

Parameter Description Value
group-name Specifies the name of a peer group. The name is a string of 1 to 47 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
instance instance-name Specifies the name of a BGP instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
vpnv4 Displays information about BGP VPNv4 peer groups. -
all Displays information about all BGP VPNv4 peer groups. -
vpn-instance vpn-instance-name Displays information about BGP peer groups in a specified VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
ipv6 Displays information about IPv6 peer groups. -
vpnv6 Displays information about BGP VPNv6 peer groups. -
evpn Displays information about BGP EVPN peer groups. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

Configuring BGP peer groups simplifies BGP network configuration and improves the route advertisement efficiency.

The display bgp group command displays information about the peer group, including peers in the peer group and configuration information about the peer group. The display bgp group command is used in the following scenarios:
  • Verify the configuration after running the group command to configure the peer group.
  • Verify the configuration after running the peer group command to add a peer to the peer group.
  • Verify the configuration after running the undo peer group command to delete a peer from the peer group.
  • Verify the configuration after modifying the configuration of the peer group.

Precautions

BGP has multiple address families, each of which is configured independently. Information about peer groups in address families can be displayed by specifying different parameters.

If no parameter is specified, the display bgp group command displays default information about peer groups in the IPv4 unicast address family.

Example

# Display information about a peer group named my-peer.

<HUAWEI> display bgp group my-peer

 BGP peer-group: my-peer
 Remote AS: 200
 Authentication type configured: None
 Group's BFD has been enabled
 Type : internal
 Maximum allowed route limit: 8000
 Threshold: 75%
 Configured hold timer value: 180
 Keepalive timer value: 60
 Minimum route advertisement interval is 15 seconds
 listen-only has been configured
 PeerSession Members:
   10.2.2.2

 Peer Preferred Value: 0
 No routing policy is configured
 Peer Members:
  Peer             V    AS  MsgRcvd  MsgSent  OutQ  Up/Down       State PrefRcv
  10.2.2.2         4   200        0        0     0 00:00:47      Active       0
Table 9-127  Description of the display bgp group command output

Item

Description

BGP peer-group

Indicates the name of a BGP peer group.

Remote AS

Indicates the number of the AS where a peer group resides.

Authentication type configured

Indicates the configured BGP authentication type:
  • MD5

  • None: indicates that no BGP authentication is configured.

Group's BFD has been enabled

Indicates that BFD has been enabled for a peer group.

Type

Indicates the type of a peer group:
  • internal: indicates that the peer group is an IBGP peer group.

  • external: indicates that the peer group is an EBGP peer group.

Configured hold timer value

Indicates the value of the Hold timer.

Keepalive timer value

Indicates the value of the Keepalive timer.

Minimum route advertisement interval

Indicates the minimum interval between route advertisements.

listen-only has been configured

Indicates that the peer or peer group only detects connection requests, and does not initiate any connection.

PeerSession Members

Indicates peers that set up sessions.

Maximum allowed route limit

Indicates the maximum number of allowed BGP routes.

Threshold

Indicates the threshold for the quantity of received BGP routes (in percentage) out of the maximum number of routes that can be received.

Peer Preferred Value

Indicates the preferred value of a peer.

Peer Members

Indicates that the following information is about peers.

Peer

Indicates the IP address of a peer.

V

Indicates the BGP version.

AS

Indicates the number of the AS where a member of a peer group resides.

MsgRcvd

Indicates the number of received messages.

MsgSent

Indicates the number of sent messages.

OutQ

Indicates the number of messages to be sent to peers.

Up/Down

Indicates the period of time during which a BGP session keeps the current state.

State

Indicates the BGP state mechanism:
  • Idle: indicates that BGP denies any request of entering. This is the initiatory status of BGP.

    Upon receiving a Start event, BGP initiates a TCP connection to the remote BGP peer, starts the ConnectRetry Timer with the initial value, detects a TCP connection initiated by the remote BGP peer, and changes its state to Connect.

  • Idle(Admin): indicates that the peer relationship is shut down initiatively and no attempt is made to establish the neighbor relationship.

    If the peer ignore command is configured or the peer is set to the Down state through the MIB, the neighbor is in the Idle (Admin) state.

  • Idle(Ovlmt): indicates that the peer relationship is interrupted because the number of routes exceeds the upper threshold.

    After a BGP peer relationship is interrupted due to the running of the peer route-limit command, the status of the BGP peer relationship is displayed as Idle(Ovlmt). If the reset bgp command is not run, the BGP peer relationship will not be reestablished.

  • Connect: indicates that BGP waits for the TCP connection to be set up before it determines whether to perform other operations.
    • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.

    • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to detect a TCP connection initiated by the remote peer, and changes its state to Active.

    • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value, initiates a TCP connection to the remote BGP peer, and stays in the Connect state.

  • Active: indicates that BGP tries to set up a TCP connection. This is the intermediate status of BGP.
    • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.

    • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value and changes its state to Connect.

    • If BGP initiates a TCP connection with an unknown IP address, the TCP connection fails. When this occurs, BGP restarts the ConnectRetry Timer with the initial value and stays in the Active state.

  • OpenSent: indicates that BGP has sent one Open message to its peer and waits for an Open message from the peer.
    • If there are no errors in the Open message received, BGP changes its state to OpenConfirm.

    • If there are errors in the Open message received, BGP sends a Notification message to the remote peer and changes its state to Idle.

    • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to detect a TCP connection initiated by the remote peer, and changes its state to Active.

  • OpenConfirm: indicates that BGP waits for a Notification message or a Keepalive message.
    • If BGP receives a Notification message, or the TCP connection fails, BGP changes its state to Idle.

    • If BGP receives a Keepalive message, BGP changes its state to Established.

  • Established: indicates that BGP peers can exchange Update, Notification and Keepalive packets.
    • If BGP receives an Update or a Keepalive message, its state stays in Established.

    • If BGP receives a Notification message, BGP changes its state to Idle.

PrefRcv

Indicates the number of route prefixes received by the local peer from the remote peer.

# Display information about all BGP VPNv4 peer groups.

<HUAWEI> display bgp vpnv4 all group
Group in VPNV4:
 
 BGP peer-group: aa
 Remote AS number isn't specified
 Type : external
 PeerSession Members:
   10.3.3.3
 
 Peer Members:
   10.3.3.3
 ***********************

 BGP peer-group: bb
 Remote AS 100
 Type : internal
 PeerSession Members:
  NONE

 Peer Members:
   10.4.4.4
 
Group in VPN-Instance:
 
 BGP peer-group: cc
 Remote AS number isn't specified
 VPN-Instance(IPv4-family): vpn1
 
 Type : external
 PeerSession Members:
   10.2.2.1

 Peer Members:
   10.2.2.1
Table 9-128  Description of the display bgp vpnv4 all group command output

Item

Description

Group in VPNV4

Displays information about all BGP peer groups in the VPNv4 address family view.

Remote AS number isn't specified

Indicates that this item is displayed when the peer group is a mixed EBGP peer group.

Group in VPN-Instance

Displays information about peer groups in a VPN instance.

VPN-Instance

Indicates the name of a VPN instance.

# Display information about a BGP VPNv4 peer group named rr1.

<HUAWEI> display bgp vpnv4 all group rr1
Group in VPNV4:
 No such a peer-group 

Group in VPN-Instance:

 BGP peer-group: rr1
 Remote AS number isn't specified
 VPN-Instance: 1

 Type : external 
 Configured hold timer value: 180
 Keepalive timer value: 60
 Minimum route advertisement interval is 30 seconds
 PeerSession Members:
  NONE 

 Peer Preferred Value: 0
 No routing policy is configured
 Peer Members:
  No Peer Exists
Related Topics

display bgp ipv6 bfd session

Function

The display bgp ipv6 bfd session command displays information about BFD sessions between BGP peers.

Format

display bgp ipv6 bfd session { [ vpnv6 vpn-instance vpn-instance-name ] peer ipv6-address | all }

Parameters

Parameter Description Value
vpnv6 Displays information about the BFD sessions of a VPNv6 instance. -
vpn-instance vpn-instance-name Specifies the name of an VPN instance of an enabled IPv6 address family. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
peer ipv6-address Specifies the IPv6 address of a peer. -
all Displays all BFD sessions between BGP peers. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The peer bfd and peer bfd enable commands can be used to change the parameters of BFD sessions between BGP peers.

Example

# Display all BFD sessions between BGP peers.

<HUAWEI> display bgp ipv6 bfd session all
--------------------------------------------------------------------------------
  Local_Address  : FC00:0:0:100::1
  Peer_Address   : FC00:0:0:100::2
  Tx-interval(ms): 10          Rx-interval(ms): 10
  Multiplier     : 3           Interface      : 10GE1/0/1
  Session-State  : Up
  Wtr-interval(m): 10
--------------------------------------------------------------------------------
Table 9-129  Description of the display bgp ipv6 bfd session command output

Item

Description

Local_Address

Indicates the local address.

Peer_Address

Indicates the peer address.

Tx-interval(ms)

Indicates the interval for sending BFD packets, in milliseconds.

Rx-interval(ms)

Indicates the interval for receiving BFD packets, in milliseconds.

Multiplier

Indicates the remote detection multiplier.

Interface

Indicates the interface used to set up the BFD session.
NOTE:

Information about the interface is displayed only when the EBGP peer relationship is set up between it and its directly-connected interface. In other cases, the interface information is displayed as Unknown.

Session-State

Indicates the BFD status, which can be one of the following:
  • BFD global disable

  • BFD session number exceed

  • Detect down

  • Init

  • Receive admin down

  • Up

Wtr-interval(m)

WTR time of the BFD session, in minutes.

display bgp ipv6 routing-table

Function

The display bgp ipv6 routing-table command displays BGP IPv6 routes.

NOTE:
CE6810LI does not support this command.

Format

display bgp ipv6 routing-table

display bgp ipv6 routing-table ipv6-address [ prefix-length ] [ as-path | community-list | ext-community | cluster-list | advertised-peer ]

display bgp ipv6 routing-table as-path-filter { as-path-filter-number | as-path-filter-name }

display bgp ipv6 routing-table community [ community-number | aa:nn | internet | no-advertise | no-export | no-export-subconfed ] &<1-33> [ whole-match ]

display bgp ipv6 routing-table community-filter { { community-filter-name | basic-community-filter-number } [ whole-match ] | advanced-community-filter-number }

display bgp ipv6 routing-table different-origin-as

display bgp ipv6 routing-table regular-expression as-regular-expression

display bgp ipv6 routing-table peer { ipv6-address | ipv4-address } { advertised-routes | received-routes [ active ] } [ statistics ]

display bgp ipv6 routing-table peer ipv4-address received-routes dest-ipv6-address [ prefix-length [ original-attributes ] ]

display bgp ipv6 routing-table peer { ipv4-address | ipv6-address } advertised-routes network [ prefix-length ] [ as-path | community-list | ext-community | advertised-peer | cluster-list ]

display bgp ipv6 routing-table time-range start-time end-time

display bgp ipv6 routing-table peer { ipv6-address } { accepted-routes | not-accepted-routes }

Parameters

Parameter Description Value
network Specifies the network address in IPv6 address format. -
ipv6-address Specifies the IPv6 address of the peer. The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
prefix-length Specifies the length of the prefix. The value is an integer that ranges from 0 to 128.
as-path Displays the AS_Path attribute contained in a route. -
community-list Displays the community attribute contained in a route. -
ext-community Displays the extended community attribute contained in a route. -
cluster-list Displays the cluster list contained in a route. -
advertised-peer Displays the list of the peers for which a route is destined. -
as-path-filter Displays the routes that match the specified filter. -
as-path-filter-number Specifies the number of the matching AS-Path filter. It is an integer that ranges from 1 to 256.
as-path-filter-name Specifies the name of the matching AS-Path filter. The name is a string of 1 to 51 characters without any space. It is case-sensitive. When double quotation marks are used around the string, spaces are allowed in the string.
community Displays the routing information of the specified BGP community attribute in the routing table. -
community-number Specifies the community number. The value is an integer that ranges from 0 to 4294967295.
aa:nn Specifies the community attribute number. Both aa and nn are integers ranging from 0 to 65535.
internet Displays the BGP routes with Internet community attribute. -
no-advertise Displays the BGP routes with No-Advertise community attribute. -
no-export Displays the BGP routes with the No-Export community attribute. -
no-export-subconfed Displays the BGP routes with the No-Export-Subconfed community attribute. -
whole-match Indicates the exact matching. -
community-filter Displays the routes that match the specified BGP community filter. -
community-filter-name Specifies the name of the community filter. The name is a string of 1 to 51 characters. The string cannot be all numbers.
basic-community-filter-number Specifies the number of a basic community filter. The value is an integer that ranges from 1 to 99.
advanced-community-filter-number Specifies the number of an advanced community filter. The value is an integer that ranges from 100 to 199.
different-origin-as Displays routes that have the same destination address but different source ASs. -
peer Displays the routing information for the specified BGP peer. -
ipv4-address Specifies the IPv4 address of the peer. The value is in dotted decimal notation.
advertised-routes Displays the routes advertised to the specified peer. -
dest-ipv6-address Specifies the destination IPv6 address. The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
received-routes Displays the routes received from the specified peer. -
active Displays the active routes received from the specified peer. -
statistics Displays statistics about the BGP4+ public network routes advertised to or received from a specified peer. -
original-attributes Displays the original attributes of a public route from a specified BGP peer before the route is filtered by the local import policy. To display such attributes, the peer keep-all-routes command must have been run. -
regular-expression as-regular-expression Specifies the matched AS regular expression. The value is a string of 1 to 80 characters.
time-range start-time end-time Displays BGP4+ public network routes that flap within the specified time period. For example, the value 0d0h5m0s of start-time indicates five minutes before the current time. The value 0d0h10m0s of end-time indicates 10 minutes before the current time. All BGP4+ public network routes with the Keepalive time in the range of 5 to 10 minutes are displayed.
The formats of start-time and end-time both are xxdxxhxxmxxs.
  • The d indicates days. The value is an integer that ranges from 0 to 10000.
  • The h indicates hours. The value is an integer that ranges from 0 to 23.
  • The m indicates minutes. The value is an integer that ranges from 0 to 59.
  • The s indicates seconds. The value is an integer that ranges from 0 to 59.
accepted-routes Displays routes accepted by routing policy. -
not-accepted-routes Displays routes not accepted by routing policy.
NOTE:

Information about the routes that fail to match the route-policy can be displayed only after the keep-all-routes or peer keep-all-routes command is configured.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can specify different parameters to view the specific routing information.

Example

# Display BGP+ routes.

<HUAWEI> display bgp ipv6 routing-table
 BGP Local router ID is 10.1.1.1                                                
 Status codes: * - valid, > - best, d - damped, h - history,                    
               i - internal, s - suppressed, S - Stale                          
 Origin      : i - IGP, e - EGP, ? - incomplete                                 
                                                                                
                                                                                
 Total Number of Routes: 1                                                      
 *>     Network  : FC00:0:0:5::                             PrefixLen : 64      
        NextHop  : ::                                       LocPrf    :         
        MED      : 0                                        PrefVal   : 0       
        Label    :                                                              
        Path/Ogn :  i                                                           
Table 9-130  Description of the display bgp ipv6 routing-table command output

Item

Description

BGP Local router ID

Indicates the router ID of the local BGP device.

Network

Indicates the network address in the BGP routing table.

PrefixLen

Indicates the prefix length.

NextHop

Indicates the next-hop address of the packet.

LocPrf

Indicates the local preference.

MED

Indicates the MED of the route.

PrefVal

Indicates the preferred value.

Label

Indicates the label value.

Path/Ogn

Indicates the AS_Path number and the Origin attribute.

display bgp ipv6 routing-table statistics

Function

The display bgp ipv6 routing-table statistics command displays statistics about BGP IPv6 routes.

Format

display bgp ipv6 routing-table statistics

display bgp ipv6 routing-table statistics as-path-filter { as-path-filter-number | as-path-filter-name }

display bgp ipv6 routing-table statistics community [ community-number | aa:nn | internet | no-advertise | no-export | no-export-subconfed ] &<1-33> [ whole-match ]

display bgp ipv6 routing-table statistics community-filter { { community-filter-name | basic-community-filter-number } [ whole-match ] | advanced-community-filter-number }

display bgp ipv6 routing-table peer { ipv6-address | ipv4-address } { advertised-routes | received-routes [ active ] } statistics

display bgp ipv6 routing-table statistics dampened

display bgp ipv6 routing-table statistics active

Parameters

Parameter Description Value
as-path-filter Displays the routes that match the specified filter. -
as-path-filter-number Specifies the number of the matching AS-Path filter. The value is an integer that ranges from 1 to 256.
as-path-filter-name Specifies the name of the matching AS-Path filter. The as-path-filter-number must already exist.
community Displays the routing information of the specified BGP community attribute in the routing table. -
community-number Specifies the community number. The value is an integer that ranges from 0 to 4294967295.
aa:nn Specifies the community attribute number. Both aa and nn are integers ranging from 0 to 65535.
internet Displays the BGP routes with Internet community attribute. -
no-advertise Displays the BGP routes with the No-Advertise community attribute. -
no-export Displays the BGP routes with the No-Export community attribute. -
no-export-subconfed Displays the BGP routes with the No-Export-Subconfed community attribute. -
whole-match Indicates exact matching. -
community-filter Displays the routing information that matches the specified BGP community filter. -
community-filter-name Specifies the name of the community filter. The community-filter-name must already exist.
basic-community-filter-number Specifies the number of a basic community filter. The value is an integer that ranges from 1 to 99.
advanced-community-filter-number Specifies the number of an advanced community filter. The value is an integer that ranges from 100 to 199.
peer Displays the routing information for the specified BGP peer. -
ipv6-address Specifies the IPv6 address of the peer. The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
ipv4-address Specifies the IPv4 address of the peer. The value is in dotted decimal notation.
advertised-routes Displays the routes advertised to the specified peer. -
received-routes Displays the routes received from the specified peer. -
active Displays the active routes received from the specified peer. -
dampened Displays the statistics of BGP dampened routes. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display statistics about BGP4+ routes.

<HUAWEI> display bgp ipv6 routing-table statistics
Total Number of Routes: 0
 Total Number of Prefix Advertised to RM : 0
 Total Number of Active Route : 0
 Total Number of Best Routes: 0
 Total Number of Best-external Routes: 0
 Total Number of Community Routes: 0
 Total Number of Different-origin-as Routes: 0
 Total Number of Dampened Routes: 0

# Display statistics about dampened BGP4+ routes.

<HUAWEI> display bgp ipv6 routing-table statistics dampened
 Total Number of Routes: 0

# Display statistics about active BGP4+ routes.

<HUAWEI> display bgp ipv6 routing-table statistics active
Total Number of Prefix Advertised to RM : 2
Total Number of Active Route : 2
Table 9-131  Description of the display bgp ipv6 routing-table statistics command output

Item

Description

Total Number of Routes

Total number of routes in the routing table.

Total Number of Prefix Advertised to RM

Total number of routes delivered to RM.

Total Number of Active Route

Number of active routes.

Total Number of Best Routes

Number of best routes.

Total Number of Best-external Routes

Number of best-external routes.

Total Number of Community Routes

Number of routes carrying the specified BGP community attribute in the routing table.

Total Number of Different-origin-as Routes

Number of routes that have the same destination address but different source AS numbers.

Total Number of Dampened Routes

Number of dampened BGP routes.

display bgp multicast group

Function

The display bgp multicast group command displays the information about an MBGP peer group.

Format

display bgp multicast group [ group-name ]

Parameters

Parameter Description Value
group-name Specifies the name of a peer group. The name is a string of 1 to 47 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If the peer group is specified, the detailed information on the specified peer group is displayed.

If the peer group is not specified, the information on all MBGP peer groups is displayed.

Example

# Display the information about peer group my-peer.

<HUAWEI> display bgp multicast group my-peer
BGP peer-group: my-peer
 Remote AS 1
 Type : external
 Configured hold timer value: 180
 Keepalive timer value: 60
 Connect-retry timer value: 32
 Minimum route advertisement interval is 30 seconds
 PeerSession Members:
   172.16.14.1
 Peer Preferred Value: 0
 No routing policy is configured
 Peer Members:
  Peer         V  AS  MsgRcvd  MsgSent  OutQ   Up/Down    State   PrefRcv
  172.16.14.1  4   1      43      29     0    00:03:03   Established   21
Table 9-132  Description of the display bgp multicast group command output

Item

Description

BGP peer-group: my-peer

Peer group: name of the group

Remote AS

The number of the AS where the peer resides

Type

Indicates the types of peers:
  • iternal: The type of the peer group is IBGP

  • external: The type of the peer group is EBGP

Configured hold timer value

Value of the holdtime timer

Keepalive timer value

Value of the Keepalive timer

Connect-retry timer value

Value of the Connect-retry timer

Minimum route advertisement interval

Shortest interval for advertising routes

PeerSession Members

Indicates peers that set up session connections

Peer Preferred Value

Preferred value of peers

Peer

IP address of the peer

V

MBGP version

AS

The number of the AS where the peer reside

MsgRcvd

Number of messages received

MsgSent

Number of messages sent

OutQ

Number of messages to be sent to the peer

Up/Down

Time during which the MBGP session is in the current state

State

Indicates the MBGP state mechanism:
  • Idle: indicates that MBGP denies the connection request. This is the initiate status of MBGP.

  • Active: indicates that MBGP tries to set up TCP connection. This is the intermediate status of MBGP.

  • Established: In the status, MBGP peers can exchange Update, Notification and Keepalive packets.

  • Connect: indicates that MBGP performs other actions after the TCP connection is set up.

  • OpenSent: indicates that MBGP waits for an Open message from the peer.

  • OpenConfirm: indicates that MBGP wait for a Notification message or a Keepalive message.

PrefRcv

The number of prefixes received by the local peer from the remote peer

display bgp multicast network

Function

The display bgp multicast network command displays the routes to be advertised by MBGP through the network command.

Format

display bgp multicast network

Parameters

None.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

This command is used to display all the configurations of the network (BGP) command in the IPv4 multicast address family view. Routes can be imported and then advertised by MBGP only when the route prefix satisfies the following conditions:
  • It is specified in the network command.

  • It already exists in the IP routing table.

  • It is active.

Example

# Display the routing information of a network segment advertised by MBGP.

<HUAWEI> display bgp multicast network
  BGP Local Router ID is 10.2.2.9                                                
  Local AS Number is 100(Multicast)                                             
  Network          Mask            Route-policy                                 
                                                                                
  10.1.1.1         255.255.255.0                                              
  10.2.2.2         255.255.255.0                                              
Table 9-133  Description of the display bgp multicast network command output

Item

Description

BGP Local Router ID

ID of the local MBGP router

Local AS Number

Number of the local AS

Network

Network address locally advertised

Mask

Mask of the network address

Route-policy

Used routing policy

Related Topics

display bgp multicast peer

Function

The display bgp multicast peer command displays the information about a specified MBGP peer. If peer-address is not specified, the information about all MBGP peers is displayed.

Format

display bgp multicast peer [ [ peer-address ] verbose | peer-address { statistics | verbose } ]

Parameters

Parameter Description Value
peer-address Specifies the address of an MBGP peer. The address is in dotted decimal notation.
verbose Specifies the detailed information about an MBGP peer. -
statistics Specifies the statistics about an MBGP peer. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None.

Example

# Display the information about all MBGP peers.

<HUAWEI> display bgp multicast peer
 
 BGP local router ID : 10.13.13.9
 Local AS number : 1
 Total number of peers : 1                 Peers in established state : 1
 
  Peer            V    AS  MsgRcvd  MsgSent  OutQ  Up/Down       State PrefRcv
 
  10.2.1.2        4     2       36       37     0 00:15:35 Established      24
Table 9-134  Description of the display bgp multicast peer command output

Item

Description

BGP local router ID

ID of the local MBGP Router

Local AS number

Local AS number

Total number of peers

Total number of peers

Peers in established state

Number of peers in established state

Peer

IP address of peers

V

MBGP version of peers

AS

AS number

MsgRcvd

Number of messages received

MsgSent

Number of messages sent

OutQ

Messages to be sent to the specified peers

Up/Down

Period during which the MBGP session is in the current state

State

Status of the peers

PrefRcv

Indicates the number of prefixes received by the local peer from the remote peer

Related Topics

display bgp multicast routing-table

Function

The display bgp multicast routing-table command displays the MBGP routing information of a specified network in the MBGP routing table.

Format

display bgp multicast routing-table [ ip-address [ mask-length [ longer-prefixes ] | mask [ longer-prefixes ] ] ]

display bgp multicast routing-table ip-address [mask | mask-length ] { as-path | community-list | ext-community | cluster-list | advertised-peer }

Parameters

Parameter Description Value
ip-address Specifies an IPv4 address. The address is in dotted decimal notation.
mask-length Specifies the mask length of the IPv4 address. The value is an integer that ranges from 0 to 32.
mask Specifies the mask of the IPv4 address. The value is in dotted decimal notation.
longer-prefixes Matches routes whose masks are shorter than the specified mask length. -
as-path Specifies the as-path of the route that will be displayed. -
community-list Specifies the community list of the route which will be displayed. -
ext-community Specifies the extended community list of the route which will be displayed. -
cluster-list Specifies the cluster list of the route which will be displayed. -
advertised-peer Specifies the advertised peer list of the route which will be displayed. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If ip-address is not specified, this command will display all the information in the MBGP routing table.

Example

# Display MBGP routing information.

<HUAWEI> display bgp multicast routing-table
 
 BGP local router ID is 10.13.13.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 Total Number of Routes: 14
      Network            NextHop        MED        LocPrf    PrefVal Path/Ogn
 
 *>   10.1.2.0/24        10.2.1.2                              0      2?
 *>   10.1.13.0/24       0.0.0.0         0                     0      ?
 *>   10.1.13.2/32       0.0.0.0         0                     0      ?
 *>   10.2.1.0/24        0.0.0.0         0                     0      ?
 *>   10.2.1.0/24        10.2.1.2        0                     0      2?
 *>   10.2.1.1/32        0.0.0.0         0                     0      ?
 *>   10.2.13.0/24       0.0.0.0         0                     0      ?
 *>   10.2.13.1/32       0.0.0.0         0                     0      ?
 *>   10.2.13.2/32       0.0.0.0         0                     0      ?

# Display as-path information of MBGP route 10.1.1.0.

<HUAWEI> display bgp multicast routing-table 10.1.1.0 as-path
 BGP routing table entry information of 10.1.1.0/24:
 From: 10.1.1.1
 AS-path 100

# Display advertised-peer information of MBGP route 10.1.1.0.

<HUAWEI> display bgp multicast routing-table 10.1.1.0 advertised-peer
 BGP routing table entry information of 10.1.1.0/24:
 Aggregated route.
 Advertised to such 1 peers:
     172.16.1.2

# Display community-list information of MBGP route 10.1.1.0.

<HUAWEI> display bgp multicast routing-table 10.1.1.0 community-list
BGP routing table entry information of 10.1.1.0/24:
 Aggregated route.
 Community: <200:1>, <300:1>

# Display ext-community information of MBGP route 10.1.1.1.

<HUAWEI> display bgp multicast routing-table 10.1.1.1 ext-community
 Routes of Route Distinguisher(1:2):
 BGP routing table entry information of 10.1.1.1/32:
 From: 172.16.1.2
 Ext-Community: RT <100 : 2>

# Display cluster-list information of MBGP route 10.1.1.1.

<HUAWEI> display bgp multicast routing-table 10.1.1.1 cluster-list
BGP routing table entry information of 10.1.1.1/32:
 From: 172.16.1.1
 Cluster list: 192.168.1.1
Table 9-135  Description of the display bgp multicast routing-table command output

Item

Description

BGP local router ID

BGP local router ID.

Status codes

Status of a routing entry.

Total Number of Routes

Total number of routes in the routing table.

Network

Indicates the network address in the MBGP routing table.

NextHop

Indicates the next-hop address for the packet.

MED

Indicates the MED of the route.

LocPrf

Indicates the local preference.

PrefVal

Indicates the preferred value.

Path/Ogn

Indicates the AS_Path number and the Origin attribute.

BGP routing table entry information of

Information about entries in the routing table.

Aggregated route

Aggregated route.

Advertised to such 1 peers

Routes advertised to the specified peer.

Routes of Route Distinguisher

Routes of Route Distinguisher.

Community

Indicates the community attribute of the route.

AS-path

Indicates the as-path attribute of the route.

Ext-Community

Indicates the extended community attribute of the route.

Cluster list

Indicates the cluster list of the route.

display bgp multicast routing-table as-path-filter

Function

The display bgp multicast routing-table as-path-filter command displays the routing information that matches the filtering list.

Format

display bgp multicast routing-table as-path-filter { as-path-filter-number | as-path-filter-name }

Parameters

Parameter Description Value
as-path-filter-number Specifies the number of the matched AS Path filtering list. The value is an integer that ranges from 1 to 256.
as-path-filter-name Specifies the name of the matched AS Path filtering list. The name of the matched AS Path filtering list must already exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None.

Example

# Display routing information that match the AS-path filtering list 1.

<HUAWEI> display bgp multicast routing-table as-path-filter 1
BGP local router ID is 10.14.14.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 Total Number of Routes: 15
      Network            NextHop        MED        LocPrf    PrefVal Path/Ogn
 *>i  10.1.13.0/24       10.2.1.1        0          100        0      1?
 *>i  10.2.1.0/24        10.2.1.1        0          100        0      1?
 *>i  10.2.13.0/24       10.2.1.1        0          100        0      1?
 *>i  10.2.13.1/32       10.2.1.1        0          100        0      1?
Table 9-136  Description of the display bgp multicast routing-table as-path-filter command output

Item

Description

BGP local router ID

BGP local router ID

Network

Network address in the MBGP routing table

NextHop

Next hop address for forwarding packet

MED

Multi-Exit discriminator

LocPrf

Local preference

PrefVal

Preferred value of protocols

Path/Ogn

AS_Path and the Origin attribute

display bgp multicast routing-table cidr

Function

The display bgp multicast routing-table cidr command displays the routing information of classless inter-domain routing (CIDR).

Format

display bgp multicast routing-table cidr

Parameters

None.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None.

Example

# Display the information about CIDR.

<HUAWEI> display bgp multicast routing-table cidr
 BGP Local router ID is 10.13.13.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 Total Number of Routes: 9
      Network            NextHop        MED        LocPrf    PrefVal Path/Ogn
 *>   10.1.2.0/24        10.2.1.2                              0      2?
 *>   10.2.1.0/24        10.2.1.2        0                     0      2?
 *>   10.7.1.0/24        10.2.1.2                              0      2?
 *>   10.7.1.1/32        10.2.1.2                              0      2?
 *>   10.7.1.2/32        10.2.1.2        0                     0      2?
 *>   10.11.12.0/24      10.2.1.2        0                     0      2?
 *>   10.11.12.1/32      10.2.1.2        0                     0      2?
      
Table 9-137  Description of the display bgp multicast routing-table cidr command output

Item

Description

BGP Local router ID

BGP local router ID

Status codes

Status of a routing entry.

Total Number of Routes

Total number of routes in the routing table.

Network

Network address in the MBGP routing table

NextHop

Next hop address for forwarding packet

MED

Multi-Exit discriminator

LocPrf

Local preference

PrefVal

Preferred value of protocols

Path/Ogn

Displays the AS path and the Origin attribute

display bgp multicast routing-table community

Function

The display bgp multicast routing-table community command displays the routing information of a specified MBGP community.

Format

display bgp multicast routing-table community [ aa:nn | community-number | internet | no-advertise | no-export | no-export-subconfed ] &<1-33> [ whole-match ]

Parameters

Parameter Description Value
aa:nn Specifies the MBGP community number. You can specify a maximum of 13 MBGP communities. Both aa and nn are integers ranging from 0 to 65535.
community-number Specifies the MBGP community number. You can specify a maximum of 13 community numbers. The value is an integer that ranges from 0 to 4294967295.
internet Displays the MBGP routes with the Internet community attribute. The Internet community attribute indicates the matching routes sent to all remote peers. -
no-advertise Displays MBGP routes with the no-advertise community attribute. The no-advertise community attribute indicates that the matching routes are not sent to any peer. -
no-export Indicates MBGP routes with the no-export community attribute. The no-expert community attribute indicates that the matching routes are not advertised to other ASs but to other sub-ASs in the confederation. -
no-export-subconfed Displays MBGP routes with the no-export-subconfed community attribute. The no-export-subconfed community attribute indicates that the matching routes are not advertised outside the local AS. -
whole-match Indicates exact matching. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None.

Example

# Display MBGP routing information of Community 100:100.

<HUAWEI> display bgp multicast routing-table community 100:100
 BGP local router ID is 10.12.12.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 Total Number of Routes: 1
      Network          NextHop      MED    LocPrf    PrefVal    Community
 *>   10.1.1.0/24     10.2.1.1     0                 0         <100:100>        

# Display MBGP routing information with the internet community attribute or that of Community 100:100.

<HUAWEI> display bgp multicast routing-table community 100:100 internet
 BGP local router ID is 10.12.12.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete

 Total Number of Routes: 5
      Network         NextHop      MED      LocPrf    PrefVal   Community

 *>   10.1.1.1/32     10.1.1.2     0                   0        <100:100>,internet
 *>   10.3.3.3/32     10.2.1.1     0                   0        <100:100>,internet
 *>   10.1.1.0/24     10.2.1.1     0                   0        <100:100>,internet
 *>   10.2.13.0/24    10.2.1.1     0                   0        <100:100>,internet
Table 9-138  Description of the display bgp multicast routing-table community command output

Item

Description

BGP local router ID

BGP local router ID

Status codes

Status of a routing entry.

Total Number of Routes

Total number of routes in the routing table.

Network

Network address in the MBGP routing table

NextHop

Next hop address for forwarding packets

MED

Multi-Exit discriminator

LocPrf

Local preference

PrefVal

Preferred value of protocols

Community

Community attribute

display bgp multicast routing-table community-filter

Function

The display bgp multicast routing-table community-filter command displays the multicast routing information that matches a specified MBGP community list.

Format

display bgp multicast routing-table community-filter { { community-filter-name | basic-community-filter-number } [ whole-match ] | advanced-community-filter-number }

Parameters

Parameter Description Value
basic-community-filter-number Specifies the number of a basic community filter. The value is an integer that ranges from 1 to 99.
advanced-community-filter-number Specifies the number of an advanced community filter. The value is an integer that ranges from 100 to 199.
community-filter-name Specifies the name of the community filter. The name of the community filter must already exist.
whole-match Indicates the exact matching. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None.

Example

# Display the routing information the matches a specified MBGP community list.

<HUAWEI> display bgp multicast routing-table community-filter 1
BGP local router ID is 10.12.12.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 Total Number of Routes: 1
      Network            NextHop        MED        LocPrf    PrefVal    Community
 *>   10.10.10.0/24      10.2.1.1        0                     0        <100:100>
Table 9-139  Description of the display bgp multicast routing-table community-filter command output

Item

Description

BGP local router ID

BGP local router ID

Network

Network address in the MBGP routing table

NextHop

Next hop address of the packet

MED

Multi-Exit discriminator

LocPrf

Local preference

PrefVal

Preferred value

Community

community attribute

display bgp multicast routing-table dampened

Function

The display bgp multicast routing-table dampened command displays the dampened MBGP routes.

Format

display bgp multicast routing-table [ statistics ] dampened

Parameters

Parameter Description Value
statistics Displays the statistics of dampened routes. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None.

Example

# Display the dampened routes of MBGP.

<HUAWEI> display bgp multicast routing-table dampened
 BGP local router ID is 10.12.12.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 Total Number of Routes: 1
     Network            From              Reuse     Path/Ogn
 d   10.1.0.0/16        10.2.1.1          00:45:05  1?
Table 9-140  Description of the display bgp multicast routing-table dampened command output

Item

Description

BGP local router ID

BGP local router ID

Network

Network address in the MBGP routing table

From

IP address of MBGP peer from which the route is received

Reuse

Reuse value

Path/Ogn

AS-Path number and the attributes of Origin

Related Topics

display bgp multicast routing-table dampening parameter

Function

The display bgp multicast routing-table dampening parameter command displays the information about the MBGP dampening parameters.

Format

display bgp multicast routing-table dampening parameter

Parameters

None.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None.

Example

# Display the MBGP dampening parameters.

<HUAWEI> display bgp multicast routing-table dampening parameter
 Maximum Suppress Time(in second) : 3973
 Ceiling Value                    : 16000
 Reuse Value                      : 750
 HalfLife Time(in second)         : 900
 Suppress-Limit                   : 2000
Table 9-141  Description of the display bgp multicast routing-table dampening parameter command output

Item

Description

Maximum Suppress Time (in second)

Maximum suppression time (in second)

Ceiling Value

Ceiling value of the penalty

Reuse Value

Threshold for routes leaving the suppression state

HalfLife Time (in second)

Half life time of the reachable route

Suppress-Limit

Threshold for routes entering the suppression state

Related Topics

display bgp multicast routing-table different-origin-as

Function

The display bgp multicast routing-table different-origin-as command displays the routes with the same destination but different source AS numbers.

Format

display bgp multicast routing-table different-origin-as

Parameters

None.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None.

Example

# Displays the routes with the same destination but different source AS numbers.

<HUAWEI> display bgp multicast routing-table different-origin-as
BGP local router ID is 10.13.13.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 Total Number of Routes: 8
      Network            NextHop        MED     LocPrf    PrefVal Path/Ogn
 *>   10.2.1.0/24        10.2.1.2        0                   0        2?
 *>                      0.0.0.0         0                   0        ?
 *>   10.2.0.0/16        10.2.1.2                            0        2?
 *>                      0.0.0.0         0                   0        ?
 *>   192.168.14.0       10.2.1.2                            0        2?
 *>                      0.0.0.0         0                   0        ?
 *>   192.168.14.1/32    10.2.1.2                            0        2?
 *>                      0.0.0.0         0                   0        ?
Table 9-142  Description of the display bgp multicast routing-table different-origin-as command output

Item

Description

BGP local router ID

BGP local router ID

Network

Network address in the MBGP routing table

NextHop

Next hop address for forwarding packet

MED

Multi-Exit discriminator

LocPrf

Local preference

PrefVal

Preferred value of protocols

Path/Ogn

Displays the AS path and the Origin attribute

display bgp multicast routing-table flap-info

Function

The display bgp multicast routing-table flap-info command displays the information about MBGP route flapping.

Format

display bgp multicast routing-table flap-info [ ip-address [ mask [ longer-match ] | mask-length [ longer-match ] ] | as-path-filter { as-path-filter-number | as-path-filter-name } ]

display bgp multicast routing-table flap-info regular-expression as-regular-expression

Parameters

Parameter Description Value
ip-address Specifies an IPv4 network address. The address is in dotted decimal notation.
mask Specifies the mask of an IPv4 network address. The address is in dotted decimal notation.
mask-length Specifies the mask length of the IPv4 network address. The value is an integer that ranges from 0 to 32.
longer-match Indicates the longest prefix matching rules. -
regular-expression as-regular-expression Displays the statistics of route flapping that matches the AS_Path regular expression. as-regular-expression specifies the AS path regular expression. The value is a string of 1 to 80 characters.
as-path-filter as-path-filter-number Displays the statistics of the route flapping for the specified AS path list. as-path-filter-number indicates the matched AS path list number. The value is an integer that ranges from 1 to 256.
as-path-filter as-path-filter-name Displays the statistics of the route flapping for the specified AS path list. as-path-filter-number indicates the matched AS path list name. The value is a string of 1 to 51 case-sensitive characters without spaces. 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

None.

Example

# Display the information about the route flapping of MBGP.

<HUAWEI> display bgp multicast routing-table flap-info
BGP Local router ID is 10.12.12.9
 Status codes: * - valid, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
       Network            From            Flaps  Duration     Reuse  Path/Ogn
 *>   10.1.1.0/24         10.2.1.1        1      00:00:29            1?
Table 9-143  Description of the display bgp multicast routing-table flap-info command output

Item

Description

BGP Local router ID

BGP local router ID

Network

Network address in the MBGP routing table

From

IP address of MBGP peer from which the route is received

Flaps

Count of route flapping

Duration

Duration of the route flapping

Reuse

Reuse value

Path/Ogn

AS-Path number and the attributes of Origin

display bgp multicast routing-table peer

Function

The display bgp multicast routing-table peer command displays the routes received from or sent to a specified MBGP peer.

Format

display bgp multicast routing-table peer peer-address { advertised-routes | received-routes [ active ] } [ statistics ]

display bgp multicast routing-table peer peer-address received-routes network [ { mask | mask-length } [ original-attributes ] ]

display bgp multicast routing-table peer peer-address { accepted-routes | not-accepted-routes }

Parameters

Parameter Description Value
peer-address Specifies the address of an MBGP peer. The address is in dotted decimal notation.
advertised-routes Indicates the routes sent to a specified peer. -
received-routes Indicates the routes received from a specified peer. -
active Displays the active routes received from the specified peer. -
statistics Indicates the statistics of the multicast routing table. -
network Specifies the IPv4 network address. It is in dotted decimal notation.
mask Specifies the mask. -
mask-length Specifies the length of the mask. -
original-attributes Displays the original attributes of a public route from a specified BGP peer before the route is filtered by the local import policy. To display such attributes, the peer keep-all-routes command must have been run. -
accepted-routes Displays routes accepted by the routing policy. -
not-accepted-routes Displays routes not accepted by the routing policy.
NOTE:

Information about the routes that fail to match the route-policy can be displayed only after the keep-all-routes or peer keep-all-routes command is configured.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None.

Example

# Display the routes sent to multicast peer 10.10.1.11.

<HUAWEI> display bgp multicast routing-table peer 10.10.1.11 advertised-routes
 BGP local router ID is 10.12.12.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 Total Number of Routes: 9
      Network            NextHop        MED        LocPrf    PrefVal Path/Ogn
 *>i  10.1.2.0/24        10.7.1.2        0          100        0      ?
 *>   10.2.1.0/24        0.0.0.0         0                     0      ?
 *>   10.7.1.0/24        0.0.0.0         0                     0      ?
 *>i  10.7.1.0/24        10.7.1.2        0          100        0      ?
 *>i  10.7.1.1/32        10.7.1.2        0          100        0      ?
 *>   10.7.1.2/32        0.0.0.0         0                     0      ?
 *>   10.10.1.0/24       0.0.0.0         0                     0      ?
Table 9-144  Description of the display bgp multicast routing-table peer command output

Item

Description

BGP local router ID

BGP local router ID

Total Number of Routes

Total Number of Routes

Network

Network address in the MBGP routing table

NextHop

Next hop address for forwarding packet

MED

Multi-Exit discriminator

LocPrf

Local preference

PrefVal

Preferred value of protocols

Path/Ogn

Displays the AS path and the Origin attribute

display bgp multicast routing-table regular-expression

Function

The display bgp multicast routing-table regular-expression command displays the routes that match the specified AS_Path regular expression.

Format

display bgp multicast routing-table regular-expression as-regular-expression

Parameters

Parameter Description Value
as-regular-expression Specifies the AS_Path regular expression. The value is a string of 1 to 80 characters.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display the routes that match the AS_Path regular expression 2.

<HUAWEI> display bgp multicast routing-table regular-expression 2
BGP local router ID is 10.13.13.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 Total Number of Routes: 13
      Network            NextHop        MED     LocPrf    PrefVal Path/Ogn
 *>   10.1.2.0/24        10.2.1.2                              0      2?
 *>   10.2.1.0/24        10.2.1.2        0                     0      2?
 *>   10.7.1.0/24        10.2.1.2                              0      2?
 *>   10.7.1.1/32        10.2.1.2                              0      2?
 *>   10.7.1.2/32        10.2.1.2        0                     0      2?
 *>   10.11.12.0/24      10.2.1.2        0                     0      2?
 *>   10.11.12.1/32      10.2.1.2        0                     0      2?
Table 9-145  Description of the display bgp multicast routing-table regular-expression command output

Item

Description

BGP local router ID

BGP local router ID

Network

Indicates the network address in the MBGP routing table.

NextHop

Indicates the next-hop address for the packet.

MED

Indicates the MED of the route.

LocPrf

Indicates the local preference.

PrefVal

Indicates the preferred value.

Path/Ogn

Indicates the AS_Path number and the Origin attribute.

display bgp multicast routing-table statistics

Function

The display bgp multicast routing-table statistics command displays the statistics of the MBGP routes.

Format

display bgp multicast routing-table statistics [ active ]

Parameters

Parameter Description Value
active Displays the number of active routes. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display statistics about routes in the MBGP routing table.

<HUAWEI> display bgp multicast routing-table statistics
Total Number of Routes: 50
Table 9-146  Description of the display bgp multicast routing-table statistics command output

Item

Description

Total Number of Routes

Indicates the total number of routes in the MBGP routing table.

# Display statistics about active routes in the MBGP routing table.

<HUAWEI> display bgp multicast routing-table statistics active
Total Number of Prefix Advertised to RM : 2
Total Number of Active Route : 2
Table 9-147  Description of the display bgp multicast routing-table statistics active command output

Item

Description

Total Number of Prefix Advertised to RM

Total number of routes delivered to RM in the MBGP routing table.

Total Number of Active Route

Indicates the total number of active routes in the MBGP routing table.

display bgp multicast update-peer-group

Function

The display bgp multicast update-peer-group command displays information about MBGP update-groups.

Format

display bgp multicast update-peer-group [ index update-group-index ]

Parameters

Parameter Description Value
index update-group-index Specifies the index of an update-group. The value is an integer that ranges from 0 to 65535.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If the index of an update-group is specified, the command will display detailed information about the specified update-group.

Example

# Display information about MBGP update-groups.

<HUAWEI> display bgp multicast update-peer-group
 The Multicast instance's update peer group number : 1
 BGP Version : 4

 Group ID : 0
 Group Type : external
 Addr Family : IPv4-MLC
 AdvMinTimeVal : 30
 Total Peers : 1
 Leader Peer : 192.168.1.2
 Peers List : 192.168.1.2
Table 9-148  Description of the display bgp multicast update-peer-group command output

Item

Description

The Multicast instance's update peer group number

Indicates the number of update-groups in the instance.

BGP Version

Indicates the BGP version.

Group ID

Indicates the ID of the update-group.

Group Type

Indicates the type of the update-group, which can be one of the following:

  • external: indicates an EBGP update-group.

  • internal: indicates an IBGP update-group.

  • external-confed: indicates an EBGP update-group in the confederation.

  • internal-confed: indicates an IBGP update-group in the confederation.

  • unknown: indicates an update-group of an unknown type.

Addr Family

Indicates the address family.

AdvMinTimeVal

Indicates the minimum interval for sending Update packets with the same route prefix.

Total Peers

Indicates the total number of peers in an update-group.

Leader Peer

Indicates the representative of an update-group.

Peers List

Indicates a list of peers.

display bgp network

Function

The display bgp network command displays the routes imported into the BGP routing table by using the network command.

Format

display bgp network

display bgp [ instance instance-name ] vpnv4 { all | vpn-instance vpn-instance-name } network

display bgp ipv6 network

display bgp vpnv6 { all | vpn-instance vpn-instance-name } network

Parameters

Parameter Description Value
instance instance-name Displays the routes of a specified BGP multi-instance that are advertised using the network command. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
vpnv4 Displays the VPNv4 routes that are advertised by using the network command. -
vpnv6 Displays the VPNv6 routes that are advertised by using the network command. -
all Displays all the VPNv4 routes that are advertised by using the network command. -
vpn-instance vpn-instance-name Displays the routes of a specified VPN instance that are advertised by using the network command. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
ipv6 Displays the IPv6 routes advertised by BGP. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

BGP cannot discover routes by itself. Run the network (BGP) command and the import-route (BGP) command to import routes from other protocols, such as IGP routes or static routes, to the BGP routing table.

The display bgp network command displays the routing information advertised by BGP through the network (BGP) command.

Precautions

BGP has multiple address families and the routing information about each address family is isolated from each other. The routing information about address families advertised by BGP through the network (BGP) command can be displayed by specifying different parameters.

If no parameter is specified, the display bgp network command displays the routing information about the IPv4 unicast address family advertised by BGP through the network (BGP) command.

Example

# Display information about routes that are imported using the network command.

<HUAWEI> display bgp network 
BGP Local Router ID is 10.1.1.9
Local AS Number is 10(Public)
 
Network          Mask            Route-policy
10.2.0.0          255.255.0.0
10.4.4.0          255.255.255.0
Table 9-149  Description of the display bgp network command output

Item

Description

BGP Local Router ID

Indicates the ID of the local BGP device. The ID is in the same format as an IPv4 address.

Local AS Number

Indicates the local AS number.

Network

Indicates the locally-advertised network address.

Mask

Indicates the mask of the network address.

Route-policy

Indicates the used routing policy.

# Display information about BGP VPNv4 routes that are imported using the network command.
<HUAWEI> display bgp vpnv4 all network
  BGP Local Router ID is 10.2.2.9
  Local AS Number is 100
  Route Distinguisher: 100:1 (vpn1)
  Network          Mask            Route-policy

  10.4.4.4         255.255.255.255
  Route Distinguisher: 100:2 (vpn2)
  Network          Mask            Route-policy

  10.5.5.5         255.255.255.255
Table 9-150  Description of the display bgp vpnv4 all network command output

Item

Description

Route Distinguisher

Indicates the route distinguisher.

display bgp peer

Function

The display bgp peer command displays information about BGP peers.

Format

display bgp [ instance instance-name ] [ vpnv4 vpn-instance vpn-instance-name ] peer [ { group-name | ipv4-address } log-info | [ ipv4-address ] verbose ]

display bgp [ instance instance-name ] vpnv4 all peer [ [ ipv4-address ] verbose ]

display bgp ipv6 peer [ verbose ]

display bgp ipv6 peer ipv4-address verbose

display bgp ipv6 peer ipv6-address { log-info | verbose }

display bgp vpnv6 all peer [ [ ipv4-address ] verbose ]

display bgp vpnv6 vpn-instance vpn-instance-name peer [ { group-name | ipv6-address } log-info | [ ipv6-address ] verbose ]

Parameters

Parameter Description Value
instance instance-name Indicates to display information about peers in a specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
ipv4-address Specifies the IPv4 address of a peer to be displayed. It is in dotted decimal notation.
group-name Specifies the name of a peer group. The name is a string of 1 to 47 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
log-info Indicates to display log information of the specified peer. -
verbose Indicates to display detailed peer information. -
vpnv4 Indicates to display information about peers in a VPNv4 instance. -
all Indicates to display information about peers in all VPNv4 instances. -
ipv6-address Specifies the IPv6 address of a peer to be displayed. The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
vpnv6 Indicates to display BGP VPNv6 peer information. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp peer command displays information about a BGP peer. You can implement the following operations based on the command output:
  • To check the status of BGP connections
  • To check information about a BGP peer
  • To check whether a BGP peer is successfully configured using the peer as-number command
  • To check whether a BGP peer is successfully deleted using the undo peer as-number command

Precautions

BGP has multiple address families. By default, the display bgp peer command displays information about BGP peers in IPv4 unicast address family only. If you want to view information about BGP peers in another address family, you need to specify its address family parameter.

To view detailed information about a BGP peer, such as information about BGP timers, the number of sent and received routes, capacities supported, the number of sent and received BGP messages, and enabled functions, specify verbose in the command.

If log-info is specified in the command, log information about a BGP peer is displayed, including information about BGP peer flapping.

Example

# Display peer information.

<HUAWEI> display bgp peer
 BGP Local router ID : 10.2.3.4
 local AS number : 10
 Total number of peers : 2                 
 Peers in established state : 1

  Peer        V    AS  MsgRcvd  MsgSent  OutQ  Up/Down       State PrefRcv
  10.1.1.1    4   100        0        0     0 00:00:07        Idle       0
  10.2.5.6    4   200       32       35     0 00:17:49 Established       0

Table 9-151  Description of the display bgp peer command output

Item

Description

BGP Local router ID

Indicates the ID of the BGP local router.

local AS number

Indicates the local AS number.

Total number of peers

Indicates the number of peers.

Peers in established state

Indicates the number of peers in established state.

Peer

Indicates the IP address of the peer.

V

Indicates the BGP version used on the peer.

AS

Indicates the AS number.

MsgRcvd

Indicates the number of received messages.

MsgSent

Indicates the number of sent messages.

OutQ

Indicates the message to be sent to the specified peer.

Up/Down

Indicates the period of time during which a BGP session keeps the current state.

State

Status of the peer:
  • Idle: indicates that BGP denies any request of entering. This is the initiatory status of BGP.

    Upon receiving a Start event, BGP initiates a TCP connection to the remote BGP peer, starts the ConnectRetry Timer with the initial value, detects a TCP connection initiated by the remote BGP peer, and changes its state to Connect.

  • Idle(Admin): indicates that the peer relationship is shut down initiatively and no attempt is made to establish the peer relationship.

    If the peer ignore command is configured or the peer is set to the Down state through the MIB, the neighbor is in the Idle (Admin) state.

  • Idle(Ovlmt): indicates that the peer relationship is interrupted because the number of routes exceeds the upper threshold.

    After a BGP peer relationship is interrupted due to the running of the peer route-limit command, the status of the BGP peer relationship is displayed as Idle(Ovlmt). If the reset bgp command is not run, the BGP peer relationship will not be reestablished.

  • Connect: indicates that BGP waits for the TCP connection to be set up before it determines whether to perform other operations.
    • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.

    • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to detect a TCP connection initiated by the remote peer, and changes its state to Active.

    • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value, initiates a TCP connection to the remote BGP peer, and stays in the Connect state.

  • Active: indicates that BGP tries to set up a TCP connection. This is the intermediate status of BGP.
    • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.

    • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value and changes its state to Connect.

    • If BGP initiates a TCP connection with an unknown IP address, the TCP connection fails. When this occurs, BGP restarts the ConnectRetry Timer with the initial value and stays in the Active state.

  • OpenSent: indicates that BGP has sent one Open message to its peer and waits for an Open message from the peer.
    • If there are no errors in the Open message received, BGP changes its state to OpenConfirm.

    • If there are errors in the Open message received, BGP sends a Notification message to the remote peer and changes its state to Idle.

    • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to detect a TCP connection initiated by the remote peer, and changes its state to Active.

  • OpenConfirm: indicates that BGP waits for a Notification message or a Keepalive message.
    • If BGP receives a Notification message, or the TCP connection fails, BGP changes its state to Idle.

    • If BGP receives a Keepalive message, BGP changes its state to Established.

  • Established: indicates that BGP peers can exchange Update, Notification and Keepalive packets.
    • If BGP receives an Update or a Keepalive message, its state stays in Established.

    • If BGP receives a Notification message, BGP changes its state to Idle.

  • No neg: The address family is not enabled for the BGP peer. In this state, Update messages can be exchanged in other address families whose capabilities have been successfully negotiated. If the address family is enabled for the BGP peer, the local BGP peer receives a Notification message, and the peer relationship is disconnected. Then, the BGP peer changes to the Idle state and re-establishes the peer relationship.

PrefRcv

Indicates the number of route prefixes sent from the peer.

# Display detailed information about the peer 10.2.2.9.

<HUAWEI> display bgp peer 10.2.2.9 verbose
 BGP Peer is 10.2.2.9,  remote AS 100
 Type: IBGP link
 BGP version 4, Remote router ID 10.2.2.9
 Update-group ID: 1 
 BGP current state: Established, Up for 00h57m53s
 BGP current event: RecvKeepalive
 BGP last state: Established
 BGP Peer Up count: 1
 Received total routes: 0
 Received active routes total: 0
 Advertised total routes: 2
 Port: Local - 42796        Remote - 179
 Configured: Active Hold Time: 180 sec   Keepalive Time:60 sec
 Received  : Active Hold Time: 180 sec
 Negotiated: Active Hold Time: 180 sec   Keepalive Time:60 sec
 Peer optional capabilities:
  Peer supports bgp multi-protocol extension
  Peer supports bgp route refresh capability
 Peer supports bgp 4-byte-as capability
  Address family IPv4 Unicast: advertised and received
 Received:
                  Total                          60
                  Update messages                1
                  Open messages                  1
                  KeepAlive messages             58
                  Notification messages          0
                  Refresh messages               0
 Sent:
                  Total                          61
                  Update messages                2
                  Open messages                  1
                  KeepAlive messages             58
                  Notification messages          0
                  Refresh messages               0
 Authentication type configured: None
  Last keepalive received:2011-05-24 08:48:36
 Minimum route advertisement interval is 15 seconds
 Optional capabilities:
 Route refresh capability has been enabled
 Listen-only has been configured
 Send best-external has been configured
 Add-path number : 3
 Peer Preferred Value: 0 
 Routing policy configured:
 Peer's BFD has been enabled
 No routing policy is configured
 TCP-MSS configured value: 200
Table 9-152  Description of the display bgp peer verbose command output

Item

Description

Type

Indicates the BGP link type, which can be IBGP or EBGP.

BGP version

Indicates the BGP version.

Remote router ID

Indicates the router ID of the peer.

Update-group ID

Indicates the ID of the update-group to which the peer belongs.

BGP current state

Current state of BGP:
  • Idle: indicates that BGP denies any request of entering. This is the initiatory status of BGP.

    Upon receiving a Start event, BGP initiates a TCP connection to the remote BGP peer, starts the ConnectRetry Timer with the initial value, detects a TCP connection initiated by the remote BGP peer, and changes its state to Connect.

  • Idle(Admin): indicates that the peer relationship is shut down initiatively and no attempt is made to establish the peer relationship.

    If the peer ignore command is configured or the peer is set to the Down state through the MIB, the neighbor is in the Idle (Admin) state.

  • Idle(Ovlmt): indicates that the peer relationship is interrupted because the number of routes exceeds the upper threshold.

    After a BGP peer relationship is interrupted due to the running of the peer route-limit command, the status of the BGP peer relationship is displayed as Idle(Ovlmt). If the reset bgp command is not run, the BGP peer relationship will not be reestablished.

  • Connect: indicates that BGP waits for the TCP connection to be set up before it determines whether to perform other operations.
    • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.

    • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to detect a TCP connection initiated by the remote peer, and changes its state to Active.

    • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value, initiates a TCP connection to the remote BGP peer, and stays in the Connect state.

  • Active: indicates that BGP tries to set up a TCP connection. This is the intermediate status of BGP.
    • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.

    • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value and changes its state to Connect.

    • If BGP initiates a TCP connection with an unknown IP address, the TCP connection fails. When this occurs, BGP restarts the ConnectRetry Timer with the initial value and stays in the Active state.

  • OpenSent: indicates that BGP has sent one Open message to its peer and waits for an Open message from the peer.
    • If there are no errors in the Open message received, BGP changes its state to OpenConfirm.

    • If there are errors in the Open message received, BGP sends a Notification message to the remote peer and changes its state to Idle.

    • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to detect a TCP connection initiated by the remote peer, and changes its state to Active.

  • OpenConfirm: indicates that BGP waits for a Notification message or a Keepalive message.
    • If BGP receives a Notification message, or the TCP connection fails, BGP changes its state to Idle.

    • If BGP receives a Keepalive message, BGP changes its state to Established.

  • Established: indicates that BGP peers can exchange Update, Notification and Keepalive packets.
    • If BGP receives an Update or a Keepalive message, its state stays in Established.

    • If BGP receives a Notification message, BGP changes its state to Idle.

  • No neg: The address family is not enabled for the BGP peer. In this state, Update messages can be exchanged in other address families whose capabilities have been successfully negotiated. If the address family is enabled for the BGP peer, the local BGP peer receives a Notification message, and the peer relationship is disconnected. Then, the BGP peer changes to the Idle state and re-establishes the peer relationship.

BGP current event

Indicates the current BGP event.

BGP last state

Indicates the last BGP status, which may be Idle, Connect, Active, OpenSent, OpenConfirm, or Established.

BGP Peer Up count

Indicates the flapping count of a BGP peer in a specified period of time.

Received total routes

Indicates the number of received route prefixes.

Received active routes total

Indicates the number of received active route prefixes.

Advertised total routes

Indicates the number of sent route prefixes.

Port

Indicates the port number.
  • Local: indicates the local port number, which is always 179. BGP uses TCP at the transport layer.

  • Remote: indicates the port number used on the peer.

Configured

Indicates locally configured timers.
  • Active Hold Time: indicates the hold time. If BGP does not receive any Keepalive message from the peer in the hold time, BGP considers that the peer is Down and then instructs other peers to remove the routes that are sent from the peer.

  • Keep Alive Time: indicates the interval for sending Keepalive messages to the peer. BGP peers send Keepalive messages to each other periodically to maintain their relationships.

Received : Active Hold Time

Indicates the hold time on the peer.

Negotiated : Active Hold Time

Indicates the hold time agreed between the BGP peers after capability negotiation.

Address family IPv4 Unicast

Indicates the IPv4 unicast address family.

Received

Indicates the number of packets received from a peer.
  • Total: indicates the total number of messages received from a peer.

  • Update messages: indicates the number of Update messages received from a peer.

  • Open messages: indicates the number of Open messages received from a peer.

  • KeepAlive messages: indicates the number of Keepalive messages received from a peer.

  • Notification messages: indicates the number of Notification messages received from a peer.

  • Refresh messages: indicates the number of route-refresh messages received from a peer.

Sent

Indicates the number of messages sent to a peer.
  • Total: indicates the total number of messages sent to a peer.

  • Update messages: indicates the number of Update messages sent to a peer.

  • Open messages: indicates the number of Open messages sent to a peer.

  • KeepAlive messages: indicates the number of Keepalive messages sent to a peer.

  • Notification messages: indicates the number of Notification messages sent to a peer.

  • Refresh messages: indicates the number of route-refresh messages sent to a peer.

Authentication type configured

Indicates the authentication type configured.

Last keepalive received

Indicates the time when the Keepalive packet is received last time. It can be in the following formats:
  • YYYY/MM/DD HH:MM:SS

  • YYYY/MM/DD HH:MM:SS UTC±HH:MM DST

  • YYYY/MM/DD HH:MM:SS UTC±HH:MM

  • YYYY/MM/DD HH:MM:SS DST

UTC±HH:MM indicates that a time zone is set through the clock timezone command; DST indicates that the daylight saving time is set through the clock daylight-saving-time command.

Last keepalive sent

Indicates the time when the Keepalive packet is sent last time. It can be in the following formats:
  • YYYY/MM/DD HH:MM:SS

  • YYYY/MM/DD HH:MM:SS UTC±HH:MM DST

  • YYYY/MM/DD HH:MM:SS UTC±HH:MM

  • YYYY/MM/DD HH:MM:SS DST

UTC±HH:MM indicates that a time zone is set through the clock timezone command; DST indicates that the daylight saving time is set through the clock daylight-saving-time command.

Last update received

Indicates the time when the Update packet is received last time. It can be in the following formats:
  • YYYY/MM/DD HH:MM:SS

  • YYYY/MM/DD HH:MM:SS UTC±HH:MM DST

  • YYYY/MM/DD HH:MM:SS UTC±HH:MM

  • YYYY/MM/DD HH:MM:SS DST

UTC±HH:MM indicates that a time zone is set through the clock timezone command; DST indicates that the daylight saving time is set through the clock daylight-saving-time command.

Last update sent

Indicates the time when the Update packet is sent last time. It can be in the following formats:
  • YYYY/MM/DD HH:MM:SS

  • YYYY/MM/DD HH:MM:SS UTC±HH:MM DST

  • YYYY/MM/DD HH:MM:SS UTC±HH:MM

  • YYYY/MM/DD HH:MM:SS DST

UTC±HH:MM indicates that a time zone is set through the clock timezone command; DST indicates that the daylight saving time is set through the clock daylight-saving-time command.

Minimum route advertisement interval is 15 seconds

Indicates the minimum interval between route advertisements.
  • The minimum interval for advertising EBGP routes is 30 seconds.

  • The minimum interval for advertising IBGP routes is 15 seconds.

Optional capabilities

(Optional) Indicates the peer-supported capabilities.

Route refresh capability has been enabled

Indicates that route refreshing has been enabled.

4-byte-as capability has been enabled

Indicates that the 4-byte AS number capability is enabled.

Listen-only has been configured

Indicates that only connection requests are snooped and no connections will be initiated proactively.

Peer Preferred Value

Indicates the preferred value of the peer.

Routing policy configured

Indicates the configured routing policy.

Peer's BFD has been enabled

Indicates that BFP has been enabled on the peer.

TCP-MSS configured value

The TCP MSS value has been configured for TCP connection establishment.

# Display log information on BGP peer 10.1.1.2.
<HUAWEI> display bgp peer 10.1.1.2 log-info
Peer : 10.1.1.2 
 Date/Time     : 2011/13/06 11:53:21
 State         : Up
 Date/Time     : 2011/13/06 11:53:09
 State         : Down
 Error Code    : 6(CEASE)
 Error Subcode : 4(Administrative Reset)
 Notification  : Receive Notification
 Date/Time     : 2011/13/06 10:34:05
 State         : Up
Table 9-153  Description of the display bgp peer 10.1.1.2 log-info command output

Item

Description.

Error Code

Error code.

Error Subcode

Error subcode.

Notification

Notification packet sent or received by a peer.

Related Topics

display bgp peer orf ip-prefix

Function

The display bgp peer orf ip-prefix command displays the prefix-based Outbound Routes Filter (ORF) received by a device from a specified peer.

Format

display bgp peer ipv4-address orf ip-prefix

Parameters

Parameter Description Value
ipv4-address Specifies the IPv4 address of a peer. It is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After a device successfully negotiates the ORF capability with its peer, this command can be used to display information about the prefix-based ORF received from the peer.

Example

# Display the prefix-based ORF received by a device from a peer at 10.1.1.2.

<HUAWEI> display bgp peer 10.1.1.2 orf ip-prefix
Total number of ip-prefix received: 1
 Index  Action  Prefix           MaskLen  MinLen  MaxLen
 10     Permit  10.4.4.0         24       32      32
Table 9-154  Description of the display bgp peer orf ip-prefix command output

Item

Description

Index

Indicates the index of an IP prefix list.

Action

Indicates the action associated with an IP prefix list, which can be one of the following:

  • deny
  • permit

Prefix

Indicates an IP prefix.

MaskLen

Indicates the mask length of an IP prefix.

MinLen

Indicates the minimum mask length of an IP prefix.

MaxLen

Indicates the maximum mask length of an IP prefix.

display bgp peer statistics

Function

The display bgp peer statistics command displays statistics about routes from a specified peer.

Format

display bgp ipv6 peer { ipv4-address | ipv6-address } statistics

display bgp [ multicast ] peer ipv4-address statistics

display bgp [ instance instance-name ] vpnv4 { all | vpn-instance vpn-instance-name } peer ipv4-address statistics

display bgp vpnv6 all peer ipv4-address statistics

display bgp vpnv6 vpn-instance vpn-instance-name peer ipv6-address statistics

Parameters

Parameter Description Value
ipv6 Displays statistics about routes from a specified peer in the IPv6 unicast address family. -
ipv4-address Specifies the IPv4 address of a peer. The value is in dotted decimal notation.
ipv6-address Specifies the IPv6 address of a peer. The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
multicast Displays statistics about routes from a specified peer in the IPv4 multicast address family. -
vpnv4 Displays statistics about routes from a specified BGP VPNv4 peer. -
instance instance-name Displays statistics about routes from a specified peer in a specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
vpnv6 Displays statistics about routes from a specified BGP VPNv6 peer. -
all Indicates all VPN instances. -
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

On a network with a monitoring server, routers send packets to the monitoring server to report BGP running statistics for monitoring. You can run the display bgp peer statistics command to check the statistics about routes from a specified peer.

Example

# Display statistics about routes from peer 10.2.2.9.

<HUAWEI> display bgp peer 10.2.2.9 statistics

Peer 172.16.4.2, IPv4 Unicast                              
   Number of prefixes rejected by inbound policy         : 0
   Number of (known) duplicate prefix advertisements     : 0
   Number of (known) duplicate withdraws                 : 0
   Number of updates invalidated due to CLUSTER_LIST loop: 0
   Number of updates invalidated due to AS_PATH loop     : 0
   Number of updates invalidated due to ORIGINATOR_ID    : 0
   Number of updates invalidated due to AS_CONFED loop   : 0
   Number of routes in Adj-RIBs-In (pre-policy)          : 0
   Number of routes in Adj-RIBs-In (post-policy)         : 6
   Number of best routes in Loc-RIB                      : 2      
Table 9-155  Description of the display bgp peer statistics command output

Item

Description

Number of prefixes rejected by inbound policy Number of routes that are filtered out by the import policy
Number of (known) duplicate prefix advertisements Number of times that a route is re-advertised
Number of (known) duplicate withdraws Number of times that a route is re-deleted
Number of updates invalidated due to CLUSTER_LIST loop Number of routes that are invalid because their Cluster_Lists contain the local cluster ID
Number of updates invalidated due to AS_PATH loop Number of routes that are invalid because their AS_Paths contain the local AS number
Number of updates invalidated due to ORIGINATOR_ID Number of routes that are invalid because their Originator_IDs are the same as the local router ID
Number of updates invalidated due to AS_CONFED loop Number of routes that are invalid because their AS_Paths contain the AS number of the local confederation
Number of routes in Adj-RIBs-In (pre-policy) Number of all received routes
Number of routes in Adj-RIBs-In (post-policy) Number of accepted routes
Number of best routes in Loc-RIB Number of optimal routes in the routing table

display bgp router-id

Function

The display bgp router-id command displays the router IDs. Each router ID can identify only one device in an AS.

Format

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

Parameters

Parameter Description Value
instance instance-name Displays the router IDs of a device in a specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
vpn-instance vpn-instance-name Specifies the ID of a device in a specified VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display bgp router-id to check the IDs of a device on the public network and in the VPN instance.

Example

# Display the ID of a device on the public network.

<HUAWEI> display bgp router-id
BGP RouterID:10.2.2.2

# Display the ID of a device in the VPN instance.

<HUAWEI> display bgp router-id vpn-instance vrf1
 VPN-Instance Name                RouterID
 vrf1                             10.3.3.3    
Table 9-156  Description of the display bgp router-id vpn-instance vpn-instance-name command output
Item Description
BGP RouterID ID of a device on the public network
VPN-Instance Name Name of a VPN instance
RouterID ID of a device

display bgp routing-table

Function

The display bgp routing-table command displays information about BGP routes. Information about specified routes can be displayed by specifying different parameters.

Format

display bgp routing-table [ ipv4-address [ { mask | mask-length } [ longer-prefixes ] ] ]

display bgp routing-table network [ mask | mask-length ] [ as-path | community-list | ext-community | cluster-list | advertised-peer ]

display bgp routing-table [ as-path-filter { as-path-filter-number | as-path-filter-name } | cidr | different-origin-as ]

display bgp routing-table regular-expression as-regular-expression

display bgp routing-table community-filter { { community-filter-name | basic-community-filter-number } [ whole-match ] | advanced-community-filter-number }

display bgp routing-table community [ community-number | aa:nn | internet | no-advertise | no-export | no-export-subconfed ] &<1-33> [ whole-match ]

display bgp routing-table peer ipv4-address advertised-routes ipv4-address [ mask [ longer-prefixes ] | mask-length [ longer-prefixes ] ]

display bgp routing-table peer ipv4-address advertised-routes ipv4-address [ mask | mask-length ] [ advertised-peer | as-path | cluster-list | community-list | ext-community ]

display bgp routing-table peer ipv4-address received-routes ipv4-address [ { mask | mask-length } [ original-attributes ] ]

display bgp routing-table time-range start-time end-time

display bgp routing-table peer ipv4-address { advertised-routes | received-routes [ active ] } [ statistics ]

display bgp routing-table peer ipv4-address { accepted-routes | not-accepted-routes }

Parameters

Parameter Description Value
ipv4-address Specifies an IPv4 network address. The value is in dotted decimal notation.
mask | mask-length Specifies a mask in dotted decimal notation or the mask length. -
longer-prefixes Matches any route whose prefix mask is longer than the specified length. -
network Specifies an IPv4 network address. -
as-path Displays the AS_Path attribute contained in a route. -
community-list Displays the community attribute contained in a route. -
ext-community Displays the extended community contained in a route. -
cluster-list Displays the cluster list contained in a route. -
advertised-peer Displays the list of the peers for which a route is destined. -
as-path-filter Displays the routes that match a specified filter. -
as-path-filter-number Specifies the number of the matching AS-Path filter. It is an integer that ranges from 1 to 256.
as-path-filter-name Specifies the name of the matching AS-Path filter. The name is a string of 1 to 51 characters without any space. It is case-sensitive. When double quotation marks are used around the string, spaces are allowed in the string.
cidr Displays Classless InterDomain Routing (CIDR) information. -
different-origin-as Displays routes that have the same destination address but different source AS numbers. -
regular-expression as-regular-expression Specifies the regular expression used to match the AS_Path information. The value is a string of 1 to 80 characters.
community-filter Displays the routes that match a specified BGP community filter. -
community-filter-name Specifies the name of a community filter. The name is a string of 1 to 51 characters. The string cannot be all numbers.
basic-community-filter-number Specifies the number of a basic community filter. The value is an integer that ranges from 1 to 99.
whole-match Indicates exact matching. -
advanced-community-filter-number Specifies the number of an advanced community filter. The value is an integer that ranges from 100 to 199.
community Displays the routes carrying the specified BGP community attribute in the routing table. -
community-number Specifies the community number. -
aa:nn Specifies the community number. -
internet Displays the matching routes that can be sent to any peer. -
no-advertise Displays the BGP routes carrying the No-Advertise community attribute. -
no-export Displays the BGP routes carrying the No-Export community attribute. -
no-export-subconfed Displays the BGP routes carrying the No-Export-Subconfed community attribute. -
peer ipv4-address Displays routes of a specified peer. -
advertised-routes Displays the routes advertised to a specified peer. -
received-routes Displays the routes received from a specified peer. -
original-attributes Displays the original attributes of a public route from a specified BGP peer before the route is filtered by the local import policy. To display such attributes, the peer keep-all-routes command must have been run. -
time-range start-time end-time Displays BGP public network routes that flap within the specified time period. For example, the value 0d0h5m0s of start-time indicates 5 minutes before the current time. The value 0d0h10m0s of end-time indicates 10 minutes before the current time. All BGP public network routes with the Keepalive time in the range of 5 to 10 minutes are displayed.
The formats of start-time and end-time both are xxdxxhxxmxxs.
  • The d indicates days. The value is an integer that ranges from 0 to 10000.
  • The h indicates hours. The value is an integer that ranges from 0 to 23.
  • The m indicates minutes. The value is an integer that ranges from 0 to 59.
  • The s indicates seconds. The value is an integer that ranges from 0 to 59.
active Displays the active routes received from a specified peer. -
statistics Displays statistics about the routes advertised to or learned from a specified peer. -
accepted-routes Displays routes accepted by routing policy. -
not-accepted-routes Displays routes not accepted by routing policy.
NOTE:

Information about the routes that fail to match the route-policy can be displayed only after the keep-all-routes or peer keep-all-routes command is configured.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

Information about specified routes can be displayed by specifying different parameters.

The display bgp routing-table command is used to display active and inactive BGP routes on the public network.

Example

# Display all BGP routing information.

<HUAWEI> display bgp routing-table
 BGP Local router ID is 10.1.1.1                                                
 Status codes: * - valid, > - best, d - damped, h - history,                    
               i - internal, s - suppressed, S - Stale                          
 Origin      : i - IGP, e - EGP, ? - incomplete                                 
                                                                                
                                                                                
 Total Number of Routes: 1                                                      
        Network            NextHop        MED        LocPrf    PrefVal Path/Ogn 
 *>     10.2.2.2/32        0.0.0.0         0                     0       i      

# Display routes with the community attribute.

<HUAWEI> display bgp routing-table community
 BGP Local router ID is 10.1.1.1                                                
 Status codes: * - valid, > - best, d - damped, h - history,                    
               i - internal, s - suppressed, S - Stale                          
 Origin      : i - IGP, e - EGP, ? - incomplete                                 
                                                                                
 Total Number of Routes: 1                                                      
       Network            NextHop        MED        LocPrf    PrefVal Community 
 *>    10.2.2.2/32        0.0.0.0         0                     0      <3:3>   
Table 9-157  Description of the display bgp routing-table command output

Item

Description

BGP Local router ID

Indicates the router ID of the local BGP device.

Network

Indicates the network address in the BGP routing table.

NextHop

Indicates the next-hop address for the packet.

MED

Indicates the MED of the route.

LocPrf

Indicates the local preference.

PrefVal

Indicates the preferred value.

Path/Ogn

Indicates the AS_Path number and the origin attribute.

Community

Indicates the community attribute information.

# Display the detailed information of the specified routes.

<HUAWEI> display bgp routing-table 10.1.1.1
 BGP Local router ID : 10.1.1.1                                                 
 Local AS number : 200                                                          
 Paths:   1 available, 1 best, 1 select, 0 best-external, 0 add-path            
 BGP routing table entry information of 10.2.2.2/32:                             
 Network route.                                                                 
 From: 0.0.0.0 (0.0.0.0)                                                        
 Route Duration: 0d00h48m24s                                                    
 Direct Out-interface: LoopBack0                                                
 Original nexthop: 127.0.0.1                                                    
 Qos information : 0x0                                                          
 AS-path Nil, origin igp, MED 0, pref-val 0, valid, local, best, select, pre 0  
 Advertised to such 1 peers:                                                    
    10.1.1.2                                                                    
Table 9-158  Description of the display bgp routing-table command output

Item

Description

Local AS number

Local AS number

Paths

Indicates the route selection result

BGP routing table entry information of

Routing entry information

Network route

Routes imported to BGP using the network command.

From

IP address of an advertising device

Route Duration

Route duration

Direct Out-interface

Indicates the directly-connected interface

Original nexthop

Original next hop

Qos information

QoS information

AS-path

AS_Path attribute

Nil indicates that the attribute value is null.

origin

Origin attribute of a BGP route:
  • IGP: indicates that the origin attribute of a route added to the BGP routing table by using the network command is IGP.
  • EGP: indicates that the origin attribute of a route obtained by using EGP is EGP.
  • Incomplete: indicates that the origin attribute of a route whose source is unknown is Incomplete. For example, the origin attribute of the routes imported by using the import-route command is Incomplete.

MED

MED of a route.

The MED is used to identify the optimal route for traffic entering an AS. The route with the smallest MED is selected as the optimal route if the other attributes of the routes are the same.

pref-val

Preferred value

valid

Valid route

local

Local route

best

Optimal route

select

Preferred route

pre

BGP route preference

Advertised to such 1 peers

The BGP route has been advertised to one peer

display bgp routing-table dampened

Function

The display bgp routing-table dampened command displays BGP dampened routes.

Format

display bgp [ instance instance-name ] [ vpnv4 vpn-instance vpn-instance-name ] routing-table [ statistics ] dampened

display bgp ipv6 routing-table [ statistics ] dampened

display bgp vpnv6 vpn-instance vpn-instance-name routing-table dampened

Parameters

Parameter Description Value
instance instance-name Displays the BGP route dampening of a specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
vpnv4 Displays the BGP routes of a VPNv4 instance. -
vpn-instance vpn-instance-name Displays the BGP route dampening that specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
statistics Displays the statistics of dampened routes. -
ipv6 Displays all dampened IPv6 routes. -
vpnv6 Displays the BGP routes of a VPNv6 instance. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If the length of the destination address mask of an IPv4 route is the same as that of its natural mask, the mask length is not displayed after the command is run.

Example

# Display BGP dampened routes.

<HUAWEI> display bgp routing-table dampened
 BGP Local router ID is 10.1.41.102
 Status codes: * - valid, > - best, d - damped, h - history,
               i - internal, s - suppressed, S - Stale
 Origin      : i - IGP, e - EGP, ? - incomplete

 Total Number of Routes: 8
     Network            From              Reuse     Path/Origin
  d  10.6.244.0/23      10.10.41.247      01:06:25  65534 4837 174 11096 6356i
  d  10.17.79.0/24      10.10.41.247      01:06:25  65534 837 3356 23504 29777i
  d  10.17.110.0/24     10.10.41.247      01:06:25  65534 837 3356 23504 29777i
  d  10.57.144.0/20     10.10.41.247      01:06:25  65534 4837 10026 9924 18429,18429i
  d  10.76.216.0/24     10.10.41.247      01:06:25  65534 4837 701 26959i
  d  10.78.142.0/24     10.10.41.247      01:06:25  65534 4837 701 26959i
  d  10.115.136.0/23    10.10.41.247      01:06:25  65534 4837 701 26956i
  d  10.243.170.0/24    10.10.41.247      01:06:25  65534 4837 701 26959i
Table 9-159  Description of the display bgp routing-table dampened command output

Item

Description

Network

Indicates the network address in the BGP routing table.

From

Indicates the IP address of the peer that receives the routes.

Reuse

Indicates the reuse value (in seconds).

Path/Origin

Indicates the AS_Path number and the Origin attribute.

# Display IPv6 dampened routes in the BGP routing table.

<HUAWEI> display bgp ipv6 routing-table dampened
 BGP Local router ID is 10.0.0.2
 Status codes: * - valid, > - best, d - damped, h - history,
               i - internal, s - suppressed, S - Stale,
 Origin      : i - IGP, e - EGP, ? - incomplete

 Total Number of Routes: 4
  d  Network : FC00:0:0:1::                              PrefixLen : 48
     From    : FC00:0:0:6::1                             Reuse     : 01:06:26
     Path/Ogn: 65001?

  d  Network : FC00:0:0:2::                              PrefixLen : 48
     From    : FC00:0:0:6::1                             Reuse     : 01:06:26
     Path/Ogn: 65001?

  d  Network : FC00:0:0:3::                              PrefixLen : 48
     From    : FC00:0:0:6::1                             Reuse     : 01:06:26
     Path/Ogn: 65001?

  d  Network : FC00:0:0:4::                              PrefixLen : 48
     From    : FC00:0:0:6::1                             Reuse     : 01:06:26
     Path/Ogn: 65001?
Related Topics

display bgp routing-table dampening parameter

Function

The display bgp routing-table dampening parameter command displays configured BGP route dampening parameters.

Format

display bgp [ [ instance instance-name ] vpnv4 vpn-instance vpn-instance-name ] routing-table dampening parameter

display bgp ipv6 routing-table dampening parameter

display bgp vpnv6 vpn-instance vpn-instance-name routing-table dampening parameter

Parameters

Parameter Description Value
instance instance-name Displays the BGP route dampening parameters of a specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
vpnv4 Displays the BGP route dampening parameters of a VPNv4 instance. -
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
ipv6 Displays configured BGP4+ route dampening parameters. -
vpnv6 Displays the BGP route dampening parameters of a VPNv6 instance. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display BGP route dampening parameters.

<HUAWEI> display bgp routing-table dampening parameter
 Maximum Suppress Time(in second) : 3973
 Ceiling Value                    : 16000
 Reuse Value                      : 750
 HalfLife Time(in second)         : 900
 Suppress-Limit                   : 2000
Table 9-160  Description of the display bgp routing-table dampening parameter command output

Item

Description

Maximum Suppress Time (in second)

Indicates the maximum time taken for route suppression, in seconds.

Ceiling Value

Indicates the penalty ceiling.

Reuse Value

Indicates the threshold for a route to be unsuppressed.

HalfLife Time(in second)

Indicates the half life of a reachable route, in seconds.

Suppress-Limit

Indicates the threshold for a route to be suppressed.

# Display BGP4+ route dampening parameters.

<HUAWEI> display bgp ipv6 routing-table dampening parameter
 Maximum Suppress Time(in second) : 3069
 Ceiling Value                    : 16000
 Reuse Value                      : 750
 HalfLife Time(in  second)        : 900
 Suppress-Limit                   : 2000
Related Topics

display bgp routing-table flap-info

Function

The display bgp routing-table flap-info command displays statistics about BGP route flapping.

Format

display bgp [ instance instance-name ] [ vpnv4 vpn-instance vpn-instance-name ] routing-table flap-info [ regular-expression as-regular-expression ]

display bgp [ instance instance-name ] [ vpnv4 vpn-instance vpn-instance-name ] routing-table flap-info [ as-path-filter { as-path-filter-number | as-path-filter-name } | network-address [ { mask | mask-length } [ longer-match ] ] ]

display bgp ipv6 routing-table flap-info [ regular-expression as-regular-expression ]

display bgp ipv6 routing-table flap-info [ as-path-filter { as-path-filter-number | as-path-filter-name } | network-address [ prefix-length [ longer-match ] ] ]

Parameters

Parameter Description Value
instance instance-name Displays statistics about route flapping of a specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
vpnv4 Displays statistics about route flapping of a VPNv4 instance. -
vpn-instance vpn-instance-name Displays statistics about route flapping of a specified VPN instance. The VPN must already exist.
regular-expression as-regular-expression Displays statistics about the flapping routes that match the AS_Path regular expression. The value is a string of 1 to 80 characters.
as-path-filter as-path-filter-number Displays statistics about the flapping routes that match the number of an AS_Path filter. It is an integer that ranges from 1 to 256.
as-path-filter as-path-filter-name Displays statistics about the flapping routes that match the name of an AS_Path filter. The name is a string of 1 to 51 case-sensitive characters without any spaces.
NOTE:
When double quotation marks are used around the string, spaces are allowed in the string.
network-address Displays statistics about route flapping of a specified network address. -
mask Displays statistics about route flapping of a specified network mask. It is in dotted decimal notation.
mask-length Displays statistics about route flapping of a specified network mask length. The value is an integer that ranges from 0 to 32.
prefix-length Specifies the prefix length. The value is an integer that ranges from 0 to 128.
longer-match Matches a route with a longer prefix. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display statistics about BGP route flapping.

<HUAWEI> display bgp routing-table flap-info
 BGP Local router ID is 10.20.200.201
 Status codes: * - valid, > - best, d - damped, h - history,
               i - internal, s - suppressed,
 Origin      : i - IGP, e - EGP, ? - incomplete

Total Number of Routes: 7
     Network         From            Flaps  Duration     Reuse  Path/Ogn

 d  10.10.1.0       10.20.200.200   5      00:00:36  00:40:47  600i
 *>  10.10.1.0       10.20.200.202   1      00:04:07            100?
 d  10.10.2.0       10.20.200.200   5      00:00:36  00:40:47  600i
 *>  10.10.2.0       10.20.200.202   1      00:04:07            100?
 d  10.10.3.0       10.20.200.200   5      00:00:36  00:40:47  600i
 d  10.10.4.0       10.20.200.200   5      00:00:36  00:40:47  600i
 d  10.10.5.0       10.20.200.200   5      00:00:36  00:40:47  600i
Table 9-161  Description of the display bgp routing-table flap command output

Item

Description

Network

Indicates the network address in the BGP routing table.

From

Indicates the IP address of the peer that receives the routes.

Flaps

Indicates the total number of times of route flapping.

Duration

Indicates the total time length of flapping.

Reuse

Indicates the reuse value.

Path/Ogn

Indicates the AS_Path number and the Origin attribute.

# Display statistics about BGP4+ route flapping.

<HUAWEI> display bgp ipv6 routing-table flap-info
 BGP Local router ID is 10.53.53.53
 Status codes: * - valid, > - best, d - damped, h - history,
               i - internal, s - suppressed, S - Stale
 Origin      : i - IGP, e - EGP, ? - incomplete

 Total Number of Routes: 3
  d  Network : FC00:0:0:1::                              PrefixLen : 96
     From    : FC00:0:0:4::1                             Flaps     : 8
     Duration: 00:02:11                                  Reuse     : 00:49:21
     Path/Ogn: 100?

  d  Network : FC00:0:0:2::                              PrefixLen : 128
     From    : FC00:0:0:4::1                             Flaps     : 5
     Duration: 00:00:18                                  Reuse     : 00:41:06
     Path/Ogn: 100?

  d  Network : FC00:0:0:3::                              PrefixLen : 128
     From    : FC00:0:0:4::1                             Flaps     : 5
     Duration: 00:00:18                                  Reuse     : 00:41:06
     Path/Ogn: 100?

display bgp routing-table label

Function

The display bgp routing-table label command displays labeled routes in the BGP routing table.

Format

display bgp instance instance-name vpnv4 { all | vpn-instance vpn-instance-name } routing-table label

display bgp vpnv4 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table label

Parameters

Parameter Description Value
instance instance-name Displays the labeled routes of a specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
vpnv4 Displays VPNv4 labeled routes. -
all Displays the labeled routes of all VPN instances. -
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
route-distinguisher route-distinguisher Displays the BGP routes with the specified RD.
The RD formats are divided into the following types:
  • 2-byte AS number:4-byte user-defined number, for example, 101:3. An AS number ranges from 0 to 65535. A user-defined number ranges from 0 to 4294967295. The AS number and the user-defined number cannot be 0s at the same time. That is, an RD cannot be 0:0.
  • Integral 4-byte AS number:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0:0.
  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, wherex and y are integers that range from 0 to 65535 and from 0 to 65535, respectively. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0.0:0.
  • IPv4-address:2-byte user-defined number, for example, 192.168.122.15:1. An IP address ranges from 0.0.0.0 to 255.255.255.255. A user-defined number ranges from 0 to 65535.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None.

Example

# Display BGP labeled routes of all VPN instances.

<HUAWEI> display bgp vpnv4 all routing-table label
 BGP Local router ID is 10.1.1.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete

 Total number of routes from all PE: 3
 Route Distinguisher: 100:1

        Network           NextHop           In/Out Label
 *>i    10.22.22.22       10.3.3.9          NULL/1036

 Route Distinguisher: 100:4

        Network           NextHop           In/Out Label
 *>     10.1.2.0          10.1.2.1          1037/NULL
 *>     10.11.11.11       127.0.0.1         1038/NULL

 VPN-Instance vpn1, router ID 1.1.1.9:
 Total Number of Routes: 1

        Network           NextHop           In/Out Label
 *>i    10.22.22.22       10.3.3.9          NULL/1036

 VPN-Instance vpn2, router ID 10.1.1.9:
 Total Number of Routes: 0
Table 9-162  Description of the display bgp vpnv4 all routing-table label command output

Item

Description

Network

Network address in the BGP routing table.

NextHop

IP address of the reachable next hop.

In/Out Label

Incoming label and outgoing label.

display bgp routing-table relay-nexthop interface

Function

The display bgp routing-table relay-nexthop interface command displays information about the iteration of routes to a specified IP address.

Format

display bgp routing-table ipv4-address [ mask-length | mask ] relay-nexthop interface

Parameters

Parameter Description Value
ipv4-address Specifies an IPv4 address. -
mask-length Specifies the mask length of an IPv4 address. -
mask Specifies the mask of an IPv4 address. The value is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Supernet routes are not delivered to the RM module. As a result, information about iteration of supernet routes is not displayed in the IP routing table. To check information about the iteration of supernet routes, run the display bgp routing-table relay-nexthop interface command. If the supernet routes are iterated to IP routes and tunnels, information about both the IP routes and tunnels is displayed.

Example

# Display information about the iteration of routes to 6.6.6.6.

<HUAWEI> display bgp routing-table 6.6.6.6 relay-nexthop interface

 BGP routing table entry information of 6.6.6.6/32:
 From: 192.168.2.2 (192.168.1.2)
 Relay Type: Route Relay
 Relay Nexthop: 192.168.3.2
 Original nexthop: 6.6.6.6
 Relay Out Interface: 10GE1/0/3

 From: 192.168.2.2 (192.168.1.2)
 Relay Type: Route Relay
 Relay Nexthop: 192.168.4.2
 Original nexthop: 6.6.6.6
 Relay Out Interface: 10GE4/0/5

 From: 192.168.5.2 (192.168.1.2)
 Relay Type: Tunnel Relay
 Original nexthop: 6.6.6.6
 TunnelID:       0x0000000001004c4b42
 Relay Out Interface: 10GE1/0/3
 Relay Out Interface: 10GE4/0/5 
Table 9-163  Description of the display bgp routing-table relay-nexthop interface command output

Item

Description

From

IP address of the peer from which the route is received

Relay Type

Iteration type

Relay Nexthop

Next hop to which the route is iterated

Original nexthop

Original next hop of the route

Relay Out Interface

Outbound interface used in the iteration

TunnelID

Tunnel ID

display bgp routing-table statistics

Function

The display bgp routing-table statistics command displays statistics about BGP routes.

Format

display bgp routing-table statistics

display bgp routing-table statistics as-path-filter { as-path-filter-number | as-path-filter-name }

display bgp routing-table statistics cidr

display bgp routing-table statistics community [ community-number | aa:nn | internet | no-advertise | no-export | no-export-subconfed ] &<1-33> [ whole-match ]

display bgp routing-table statistics community-filter { { community-filter-name | basic-community-filter-number } [ whole-match ] | advanced-community-filter-number }

display bgp [ instance instance-name ] routing-table statistics dampened

display bgp routing-table statistics different-origin-as

display bgp routing-table statistics active

display bgp routing-table statistics regular-expression as-regular-expression

display bgp routing-table peer ipv4-address { advertised-routes | received-routes [ active ] } statistics

Parameters

Parameter Description Value
as-path-filter as-path-filter-number Displays the routes that match the specified the number of the matching AS-Path filter. It is an integer that ranges from 1 to 256.
as-path-filter as-path-filter-name Displays the routes that match the specified the name of the matching AS-Path filter. The name is a string of 1 to 51 characters without any space. It is case-sensitive. When double quotation marks are used around the string, spaces are allowed in the string.
cidr Displays CIDR information. -
community Displays the routes carrying the specified BGP community attribute in the routing table. -
community-number Specifies the community number. The value is an integer that ranges from 0 to 4294967295.
aa:nn Specifies the community attribute number. Both aa and nn are integers ranging from 0 to 65535.
internet Displays the matching routes that can be sent to any peer. -
no-advertise Displays the BGP routes carrying the No-Advertise community attribute. -
no-export Displays the BGP routes carrying the No-Export community attribute. -
no-export-subconfed Displays the BGP routes carrying the No-Export-Subconfed community attribute. -
whole-match Indicates exact matching. -
community-filter Displays the routes that match a specified BGP community filter. -
basic-community-filter-number Specifies the number of a basic community filter. The value is an integer that ranges from 1 to 99.
advanced-community-filter-number Specifies the number of an advanced community filter. The value is an integer that ranges from 100 to 199.
community-filter-name Specifies the name of a community filter. The name is a string of 1 to 51 characters. The string cannot be all numbers.
instance instance-name Displays the routes of a specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
dampened Displays the statistics of BGP dampened roues. -
different-origin-as Displays routes that have the same destination address but different source AS numbers. -
regular-expression as-regular-expression Specifies the regular expression used to match the AS_Path information. The value is a string of 1 to 80 characters.
peer ipv4-address Displays the routing information for the specified BGP peer. It is in dotted decimal notation.
advertised-routes Displays the routes advertised to the specified peer. -
received-routes Displays the routes received from the specified peer. -
active Specifies the number of active routes. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display bgp routing-table statistics command is used to display statistics about BGP routes on the public network.

The display bgp routing-table statistics as-path-filter command is used to display statistics about the BGP routes that match the specified AS_Path filter on the public network.

The display bgp routing-table statistics cidr command is used to display statistics about the BGP CIDR information of the public network.

The display bgp routing-table statistics community command is used to display statistics about the BGP routes carrying the specified community attribute on the public network.

The display bgp routing-table statistics community-filter command is used to display statistics about the BGP routes that match the specified community filter on the public network.

The display bgp routing-table statistics dampened command is used to display statistics about BGP dampened routes on the public network.

The display bgp routing-table statistics different-origin-as command is used to display statistics about the BGP routes with the same destination address but different source AS numbers on the public network.

The display bgp routing-table statistics regular-expression command is used to display statistics about the BGP routes whose AS_Path information matches the AS_Path regular expression on the public network.

Example

# Display route statistics.

<HUAWEI> display bgp routing-table statistics
 Total Number of Routes: 4
 Total Number of Prefix Advertised to RM : 0
 Total Number of Active Route : 0
 Total Number of Best Routes: 1
 Total Number of Best-external Routes: 0
 Total Number of Cidr Routes: 1
 Total Number of Community Routes: 0
 Total Number of Different-origin-as Routes: 0
 Total Number of Dampened Routes: 0
Table 9-164  Description of the display bgp routing-table statistics command output

Item

Description

Total Number of Routes

Total number of routes in the routing table

Total Number of Prefix Advertised to RM

Total number of routes delivered to RM

Total Number of Active Route

Number of active routes

Total Number of Best Routes

Number of best routes

Total Number of Best-external Routes

Number of best-external routes

Total Number of Cidr Routes

Number of CIDR routes.

Total Number of Community Routes

Number of routes carrying the specified BGP community attribute in the routing table.

Total Number of Different-origin-as Routes

Number of routes that have the same destination address but different source AS numbers.

Total Number of Dampened Routes

Number of dampened BGP routes.

display bgp slow-peer

Function

The display bgp slow-peer command displays information about slow BGP peers.

Format

display bgp [ ipv6 | multicast | evpn ] slow-peer

display bgp [ instance instance-name ] vpnv4 [ vpn-instance vpn-instance-name ] slow-peer

display bgp vpnv6 [ vpn-instance vpn-instance-name ] slow-peer

Parameters

Parameter Description Value
ipv6 Displays information about slow BGP peers in the BGP-IPv6 unicast address family. -
multicast Displays information about slow BGP peers in the BGP-IPv4 multicast address family. -
evpn Displays information about slow BGP peers in the BGP-EVPN address family. -
vpnv4 Displays information about slow BGP peers in the BGP-VPNv4 address family. -
instance instance-name Displays information about slow BGP peers in the specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
vpnv6 Displays information about slow BGP peers in the BGP-VPNv6 address family. -
vpn-instance vpn-instance-name Displays information about slow BGP peers in the specified VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check information about slow BGP peers, run the display bgp slow-peer command. The information includes the time when a peer began to be identified as a slow peer, the time when a peer last exited from the slow peer state, the number of times a peer has been identified as a slow peer, and the remaining time for a peer to exit from the slow peer state.

Precautions

BGP has multiple address families and sub-address families. If no address family parameter is specified in the display bgp slow-peer command, information about slow BGP peers in the BGP-IPv4 unicast address family is displayed. To check slow peer information about a desired address family, specify the address family parameter in the command.

Example

# Display information about slow BGP peers in the BGP-IPv4 unicast address family.
<HUAWEI> display bgp slow-peer
 Total number of peers : 2                 
 Switchback detection timer: Remaining 3581 Second(s)
 Peer            LastSlowEndTime              SlowStartTime                SlowCount 
 1.1.1.1         2016-04-10 20:41:33+00:00    2016-04-12 00:02:33+00:00    3 
 2.2.2.1         2016-04-11 23:02:40+00:00    2016-04-12 00:02:40+00:00    5
Table 9-165  Description of the display bgp slow-peer command output

Item

Description

Total number of peers

Number of existing slow BGP peers

Switchback detection timer

Remaining time for a peer to exit from the slow peer state

Peer

IP address of a slow peer

LastSlowEndTime

Time when a peer last exited from the slow peer state

SlowStartTime

Time when a peer began to be identified as a slow peer

SlowCount

Number of times a peer has been identified as a slow peer

display bgp troubleshooting

Function

The display bgp troubleshooting command displays the cause of BGP peer relationship disconnection or flapping.

Format

display bgp troubleshooting

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If a BGP peer relationship is disconnected or flaps, the device automatically records the cause, including information about the routes, CPU usage, ping operations, and alarms. To check the cause, run the display bgp troubleshooting command, which helps troubleshooting.

Example

# Display the cause of BGP peer relationship disconnection or flapping.

<HUAWEI> display bgp troubleshooting
Total counts: 2 
--------------------------------------------------------------------------------  
Sequence   Time                      Event Description 
-------------------------------------------------------------------------------- 

1          2015-12-17 16:17:59+08:00 The BGP peer 10.1.1.1 went Down because the 
                                      peer ignore command was configured manuall 
                                     y. Please check local BGP configurations.   
2          2015-12-17 16:16:57+08:00 The BGP peer 10.1.1.1 went Down because the 
                                      BGP instance was reset manually. Please ch 
                                     eck the opearion record.                    
-------------------------------------------------------------------------------- 
Table 9-166  Description of the display bgp troubleshooting command output
Item Description
Total counts

Number of BGP peer relationship disconnection times. The maximum value is 5.

Sequence

Sequence number of a record. The maximum value is 5, indicating that a maximum of five records can be recorded.

Time

Time when a BGP peer relationship was disconnected.

Event Description

Description of the event that a BGP peer relationship was disconnected.

display bgp update-peer-group

Function

The display bgp update-group command displays information about update-groups. By setting index in the command displays detailed information about a specified update-group. If no address family is specified, information about the update-group of the IPv4 unicast address family is displayed by default.

Format

display bgp ipv6 update-peer-group [ index update-group-index ]

display bgp vpnv6 { all | vpn-instance vpn-instance-name } update-peer-group [ index update-group-index ]

display bgp [ instance instance-name ] [ vpnv4 { all | vpn-instance vpn-instance-name } ] update-peer-group [ index update-group-index ]

display bgp [ instance instance-name ] evpn update-peer-group [ index update-group-index ]

Parameters

Parameter Description Value
index update-group-index Specifies the index of an update-group. The value is an integer that ranges from 0 to 65535.
ipv6 Displays information about the BGP update-groups of IPv6 routes. -
vpn-instance vpn-instance-name Displays information about the update-groups of a specified VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
vpnv6 Displays information about the BGP update-groups of a VPNv6 instance. -
vpnv4 Displays information about the BGP update-groups of a VPNv4 instance. -
evpn Displays information about EVPN BGP update-groups. -
instance instance-name Displays information about the update-groups of a specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
all Displays information about all the update-groups in a VPNv4 address family. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display bgp update-peer-group command is used to display information about all the update-groups in the IPv4 unicast address family on the public network.

The display bgp update-peer-group index command is used to display information about the update-group matching a specified index in the IPv4 unicast address family on the public network.

The display bgp vpnv4 all update-peer-group command is used to display information about all the update-groups in the VPNv4 unicast address family.

The display bgp vpnv4 all update-peer-group index command is used to display information about the update-group matching a specified index in the VPNv4 unicast address family on the public network.

The display bgp vpnv4 vpn-instance update-peer-group command is used to display information about the update-groups in the IPv4 unicast address family in a specified VRF.

The display bgp vpnv4 vpn-instance update-peer-group index command is used to display information about the update-group matching a specified index in the IPv4 unicast address family in a specified VRF.

Example

# Display information about the update-groups in a certain address family.

<HUAWEI> display bgp update-peer-group
 The Public instance's update peer group number : 1
 Keep buffer update peer group number : 0
 BGP Version : 4
 distribute-instance: pd1
 Update peer group number :1 
 Group ID : 0 
 Group Type : external 
 Addr Family : IPv4-UNC 
 AdvMinTimeVal : 30 
 Total Peers : 1 
 Leader Peer : 192.168.1.2 
 Peers List : 192.168.1.2 
 
 distribute-instance: pd2 
 Update peer group number :1 
 Group ID : 0 
 Group Type : external 
 Addr Family : IPv4-UNC 
 AdvMinTimeVal : 30 
 Total Peers : 1 
 Leader Peer : 192.168.2.2 
 Peers List : 192.168.2.2
Table 9-167  Description of the display bgp update-peer-group command output

Item

Description

The Public instance's update peer group number

Number of update-groups in the instance.

Keep buffer update peer group number

Number of packets in update-groups saved in the batch buffer.

BGP Version

Indicates the BGP version.

distribute-instance

Indicates the name of the distribute instance.

Update peer group number

Number of packets in update-groups.

Group ID

Indicates the ID of the update-group.

Group Type

Indicates the type of the update-group, which can be one of the following:
  • external: indicates that this is an EBGP peer group.
  • internal: indicates that this is an IBGP peer group.
  • unknown: indicates that the type is unknown.

Addr Family

Indicates the address family.

AdvMinTimeVal

Indicates the minimum interval for sending Update packets with the same route prefix.

Total Peers

Indicates the total number of peers in an update-group.

Leader Peer

Indicates the representative of an update-group.

Peers List

Indicates a list of peers.

# Display information about the update-group with a specified index.

<HUAWEI> display bgp update-peer-group index 0
 Group ID : 0
 BGP Version : 4
 Group Type : external
 Addr Family : IPv4-UNC
 AdvMinTimeVal : 30
 Total Peers : 1
  Leader Peer : 192.168.1.2

 Total format packet number : 3
 Total send packet number : 3
 Total replicate packet number : 0
 The replication percentages(%) : 0

 Peers List : 192.168.1.2
Table 9-168  Description of the display bgp update-peer-group index command output
Item Description
Total format packet number Indicates the total number of formatted packets.
Total send packet number Indicates the total number of sent packets.
Total replicate packet number Indicates the total number of replicate packets, which equals the total number of sent packets minus the total number of formatted packets.
The replication percentages(%) Indicates the replication percentage, which is obtained with the formula: (Total number of sent packet - Total number of formatted packets) x 100/Total number of formatted packets.

display bgp vpnv4 brief

Function

The display bgp vpnv4 brief command displays brief information about VPNv4 and VPN instances (IPv4 address family).

Format

display bgp [ instance instance-name ] vpnv4 { all | vpn-instance vpn-instance-name } brief

Parameters

Parameter Description Value
instance instance-name Displays information about VPNv4 and VPN instances (IPv4 address family) in a specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
all Displays information about all VPNv4 and VPN instances (IPv4 address family). -
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After the display bgp vpnv4 brief command is used to display information about VPNv4 and VPN instances (IPv4 address family), the VPN instances are displayed and arranged alphabetically by name.

Example

# Display brief information about VPNv4 instances and all VPN instances (IPv4 address family).

<HUAWEI> display bgp vpnv4 all brief

VPNV4 :
  Rd Num              Peer Num            Route Num
  0                   1                   0

VPN-Instance(IPv4-family):
  VPN-Instance Name   Peer Num            Route Num
  vrf0                   0                   0
  vrf1                   0                   0
  vrf11                  0                   0
  vrf12                  0                   0
  vrf13                  0                   0
  vrf14                  0                   0
  vrf2                   0                   20
  vrf3                   0                   20
  vrf4                   0                   24
  vrf5                   0                   24
  vrf6                   0                   0
  vrf7                   0                   0
  vrf8                   0                   20
Table 9-169  Description of the display bgp vpnv4 brief command output

Item

Description

Rd Num

Indicates the number of RDs.

Peer Num

Indicates the number of peers.

Route Num

Indicates the number of routes.

VPN-Instance Name

Indicates the name of a VPN instance.

display bgp vpnv4 routing-table

Function

The display bgp vpnv4 routing-table command displays BGP routes of VPNv4 address family and the private networks.

Format

display bgp [ instance instance-name ] vpnv4 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table [ as-path-filter { as-path-filter-number | as-path-filter-name } | cidr | different-origin-as ]

display bgp [ instance instance-name ] vpnv4 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table regular-expression as-regular-expression

display bgp [ instance instance-name ] vpnv4 route-distinguisher route-distinguisher routing-table ipv4-address [ mask | mask-length ]

display bgp [ instance instance-name ] vpnv4 { all | vpn-instance vpn-instance-name } routing-table ipv4-address [ mask [ longer-prefixes ] | mask-length [ longer-prefixes ] ]

display bgp [ instance instance-name ] vpnv4 { all | vpn-instance vpn-instance-name } routing-table ipv4-address [ mask | mask-length ] [ advertised-peer | as-path | cluster-list | community-list | ext-community ]

display bgp [ instance instance-name ] vpnv4 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table community-filter { { community-filter-name | basic-community-filter-number } [ whole-match ] | advanced-community-filter-number }

display bgp [ instance instance-name ] vpnv4 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table community [ community-number | aa:nn | internet | no-advertise | no-export | no-export-subconfed ] * &<1-33> [ whole-match ]

display bgp [ instance instance-name ] vpnv4 { all | vpn-instance vpn-instance-name } routing-table peer ipv4-address { advertised-routes | received-routes [ active ] } [ statistics ]

display bgp [ instance instance-name ] vpnv4 { all | vpn-instance vpn-instance-name } routing-table peer ipv4-address advertised-routes network [ mask [ longer-prefixes ] | mask-length [ longer-prefixes ] ]

display bgp [ instance instance-name ] vpnv4 { all | vpn-instance vpn-instance-name } routing-table peer ipv4-address advertised-routes network [ mask | mask-length ] [ advertised-peer | as-path | cluster-list | community-list | ext-community ]

display bgp [ instance instance-name ] vpnv4 { all | vpn-instance vpn-instance-name } routing-table time-range start-time end-time

display bgp [ instance instance-name ] vpnv4 { all | vpn-instance vpn-instance-name } routing-table peer ipv4-address received-routes network [ { mask | mask-length } [ original-attributes ] ]

display bgp vpnv4 route-distinguisher route-distinguisher routing-table time-range start-time end-time

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table peer ipv4-address { accepted-routes | not-accepted-routes }

Parameters

Parameter Description Value
all Displays all BGP VPNv4 routes. -
instance instance-name Displays the routes of a specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
route-distinguisher route-distinguisher Displays the BGP routes with the specified RD.
The RD formats are divided into the following types:
  • 2-byte AS number:4-byte user-defined number, for example, 101:3. An AS number ranges from 0 to 65535. A user-defined number ranges from 0 to 4294967295. The AS number and the user-defined number cannot be 0s at the same time. That is, an RD cannot be 0:0.

  • Integral 4-byte AS number:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0:0.

  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535 and from 0 to 65535, respectively. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0.0:0.

  • IPv4-address:2-byte user-defined number, for example, 192.168.122.15:1. An IP address ranges from 0.0.0.0 to 255.255.255.255. A user-defined number ranges from 0 to 65535.

vpn-instance vpn-instance-name Displays the BGP routes of a specified VPN instance. The VPN must already exist.
as-path-filter Displays the routes that match the specified filter. -
as-path-filter-number Specifies the number of the matching AS-Path filter. It is an integer that ranges from 1 to 256.
as-path-filter-name Specifies the name of the matching AS-Path filter. The name is a string of 1 to 51 characters without any space. It is case-sensitive. The value cannot contain only numerals.
cidr Displays CIDR information. -
different-origin-as Displays the routes that have the same destination address but different source AS numbers. -
regular-expression as-regular-expression Specifies the regular expression used to match the AS_Path information. The value is a string of 1 to 80 characters.
ipv4-address Specifies the destination address. -
mask Specifies a mask in dotted decimal notation. The value is in dotted decimal notation.
mask-length Specifies the the mask length. The value is an integer that ranges from 0 to 32.
peer ipv4-address Displays routes of a specified peer. -
advertised-routes Displays the routes advertised to a specified peer. -
network Specifies an IPv4 network address. The value is in dotted decimal notation.
longer-prefixes Matches any route whose prefix mask is longer than the specified length. -
received-routes Displays the routes received from a specified peer. -
active Displays the active routes received from a specified peer. -
statistics Displays statistics about the routes advertised to or received from a specified peer. -
community-filter Displays the routes that match a specified BGP community filter. -
community-filter-name Specifies the name of a community filter. The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.
basic-community-filter-number Specifies the number of a basic community filter. The value is an integer that ranges from 1 to 99.
whole-match Indicates exact matching. -
advanced-community-filter-number Specifies the number of an advanced community filter. The value is an integer that ranges from 100 to 199.
community Displays the routes carrying the specified BGP community attribute in the routing table. -
community-number Specifies the number of a community. -
aa:nn Specifies the community number. Both aa and nn are integers ranging from 0 to 65535.
internet Displays the matching routes that can be sent to any peer. -
no-advertise Displays the BGP routes carrying the No-Advertise community attribute. -
no-export Displays the BGP routes carrying the No-Export community attribute. -
no-export-subconfed Displays the BGP routes carrying the No-Export-Subconfed community attribute. -
advertised-peer Displays the list of the peers for which a route is destined. -
as-path Displays the AS_Path attribute contained in a route. -
cluster-list Displays the cluster list contained in a route. -
community-list Displays the community attribute contained in a route. -
ext-community Displays the extended community contained in a route. -
time-range start-time end-time

Displays BGP VPNv4 routes that flap within the specified time period. For example, the value 0d0h5m0s of start-time indicates 5 five minutes before the current time. The value 0d0h10m0s of end-time indicates 10 minutes before the current time. All BGP VPNv4 routes with the Keepalive time in the range of 5 to 10 minutes are displayed.

The formats of start-time and end-time both are xxdxxhxxmxxs.
  • The d indicates days. The value is an integer that ranges from 0 to 10000.
  • The h indicates hours. The value is an integer that ranges from 0 to 23.
  • The m indicates minutes. The value is an integer that ranges from 0 to 59.
  • The s indicates seconds. The value is an integer that ranges from 0 to 59.
original-attributes Displays the original attributes of a BGP route from a specified BGP peer before the route is filtered by the local import policy. To display such attributes, the peer keep-all-routes command must have been run. -
accepted-routes Displays routes accepted by routing policy. -
not-accepted-routes Displays routes not accepted by routing policy.
NOTE:

Information about the routes that fail to match the route-policy can be displayed only after the keep-all-routes or peer keep-all-routes command is configured.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can specify different parameters to view the specific routing information.

When BGP routing table is displayed, if the length of the destination address mask of an IPv4 route is the same as that of its natural mask, the mask length is not displayed.

Example

# Display all the BGP routing information of the VPN instance named vpn1.

<HUAWEI> display bgp vpnv4 vpn-instance vpn1 routing-table
                                                                                
 BGP local router ID is 10.1.1.1                                                
 Status codes: * - valid, > - best, d - damped, h - history,
               i - internal, s - suppressed, S - Stale            
 Origin      : i - IGP, e - EGP, ? - incomplete                        
                                                                                
                                                                                
 VPN-Instance vpn1, Router ID 10.1.1.1:                                         
 Total Number of Routes: 1                                                      
        Network            NextHop        MED        LocPrf    PrefVal Path/Ogn 
 *>     10.2.2.0/24        0.0.0.0         0                     0       i      

# Display all the BGP VPNv4 routing information.

<HUAWEI> display bgp vpnv4 all routing-table
 BGP local router ID is 10.1.1.1                                                
 Status codes: * - valid, > - best, d - damped, h - history,                    
               i - internal, s - suppressed, S - Stale                          
 Origin      : i - IGP, e - EGP, ? - incomplete                                 
                                                                                
                                                                                
 Total number of routes from all PE: 1                                          
 Route Distinguisher: 3:5                                                       
                                                                                
        Network            NextHop        MED        LocPrf    PrefVal Path/Ogn 
 *>     10.2.2.0/24        0.0.0.0         0                     0       i      
                                                                                
 VPN-Instance vpn1, Router ID 10.1.1.1:                                         
 Total Number of Routes: 1                                                      
        Network            NextHop        MED        LocPrf    PrefVal Path/Ogn 
 *>     10.2.2.0/24        0.0.0.0         0                     0       i      
Table 9-170  Description of the display bgp vpnv4 routing-table command output

Item

Description

BGP local router ID

ID of the local BGP device.

Network

Network address in the BGP routing table.

NextHop

Next Hop address through which the packet has to be sent.

MED

MED of the route.

LocPrf

Local preference.

PrefVal

Preferred value.

Path/Ogn

AS_Path number and the origin attribute.

# Display information about a specified VPNv4 route.

<HUAWEI> display bgp vpnv4 all routing-table 192.168.2.0
 BGP local router ID : 10.1.1.1                                                 
 Local AS number : 200                                                          
                                                                                
 Total routes of Route Distinguisher(3:5): 1                                    
 BGP routing table entry information of 10.2.2.0/24:                             
 Network route.                                                                 
 From: 0.0.0.0 (0.0.0.0)                                                        
 Route Duration: 0d00h14m27s                                                    
 Direct Out-interface: LoopBack0                                                
 Original nexthop: 10.2.2.2                                                      
 Qos information : 0x0                                                          
 AS-path Nil, origin igp, MED 0, pref-val 0, valid, local, best, select, pre 255
 Advertised to such 1 peers:                                                    
    10.1.1.2                                                                    
                                                                                
 VPN-Instance vpn1, Router ID 10.1.1.1:                                         
 Total Number of Routes: 1                                                      
 BGP routing table entry information of 10.2.2.0/24:                             
 Network route.                                                                 
 From: 0.0.0.0 (0.0.0.0)                                                        
 Route Duration: 0d00h14m27s                                                    
 Direct Out-interface: LoopBack0                                                
 Original nexthop: 10.2.2.2                                                      
 Qos information : 0x0                                                          
 AS-path Nil, origin igp, MED 0, pref-val 0, valid, local, best, select, pre 0  
 Not advertised to any peer yet                                                 
Table 9-171  Description of the display bgp vpnv4 routing-table command output
Item Description
Local AS number Local AS number.
Total routes of Route Distinguisher Total number of VPNv4 routes with a specified RD.
BGP routing table entry information of x.x.x.x/x The following information is about a specified BGP routing entry.

Network route

Routes imported to BGP using the network command.

From IP address of the route originator.
Route Duration Route duration.
Direct Out-interface Direct outbound interface.
Original nexthop Original next hop.
Qos information QoS information.
AS-path AS_Path attribute.
origin Origin attribute of the BGP route.

The value can be IGP (for example, the routes imported into the BGP routing table by using the network (BGP) command), EGP (the routes obtained by EGP), or Incomplete (the routes whose origin cannot be identified, for example, the routes imported into the BGP routing table by using the import-route (BGP) command).

MED MED of a route.

The MED is used to determine the optimal route for the traffic entering an AS. The route with the smallest MED is selected as the optimal route if the other attributes of the routes are the same.

local Local route.
pref-val Preferred value.
valid Valid BGP route.
external The BGP route is learned from the EBGP peer.
internal The BGP route is learned from the IBGP peer.
best The BGP route is the optimal route.
select The BGP route is a preferred route.
pre 255 The preference of the BGP route is 255.
Advertised to such 1 peers The BGP route has been advertised to one peer.
Not advertised to any peer yet The BGP route has not been advertised to any peer.
VPN-Instance vpn1, Router ID 10.1.1.1 The VPN instance is vpn1, the Route ID is 10.1.1.1.

Total Number of Routes

Number of routes in VPN instance vpn1.

display bgp vpnv4 routing-table statistics

Function

The display bgp vpnv4 routing-table statistics command displays statistics about BGP VPNv4 routes.

Format

display bgp [ instance instance-name ] vpnv4 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table statistics [ as-path-filter { as-path-filter-number | as-path-filter-name } | cidr | different-origin-as ]

display bgp [ instance instance-name ] vpnv4 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table statistics regular-expression as-regular-expression

display bgp [ instance instance-name ] vpnv4 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table statistics community [ community-number | aa:nn ] [ internet | no-advertise | no-export | no-export-subconfed ] * &<1-33> [ whole-match ]

display bgp [ instance instance-name ] vpnv4 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table statistics community-filter { { community-filter-name | basic-community-filter-number } [ whole-match ] | advanced-community-filter-number }

display bgp [ instance instance-name ] vpnv4 vpn-instance vpn-instance-name routing-table statistics dampened

display bgp [ instance instance-name ] vpnv4 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table statistics [ active | best ]

display bgp [ instance instance-name ] vpnv4 { all | vpn-instance vpn-instance-name } routing-table peer ipv4-address { advertised-routes | received-routes [ active ] } statistics

Parameters

Parameter Description Value
all Displays all the statistics of the BGP routes for VPNv4. -
instance instance-name Displays the routes of a specified BGP multi-instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
route-distinguisher route-distinguisher Displays statistics about the BGP routes with a specified RD.
The RD formats are divided into the following types:
  • 2-byte AS number:4-byte user-defined number, for example, 101:3. An AS number ranges from 0 to 65535. A user-defined number ranges from 0 to 4294967295. The AS number and the user-defined number cannot be 0s at the same time. That is, an RD cannot be 0:0.

  • Integral 4-byte AS number:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0:0.

  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535 and from 0 to 65535, respectively. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0.0:0.

  • IPv4-address:2-byte user-defined number, for example, 192.168.122.15:1. An IP address ranges from 0.0.0.0 to 255.255.255.255. A user-defined number ranges from 0 to 65535.

vpn-instance vpn-instance-name Displays statistics about the BGP routes of a specified VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
as-path-filter Displays the routes that match the specified filter. -
as-path-filter-number Specifies the number of the matching AS-Path filter. The value is an integer that ranges from 1 to 256.
as-path-filter-name Specifies the name of the matching AS-Path filter. The name is a string of 1 to 51 case-sensitive characters without spaces. The string cannot be all numerals.
cidr Displays CIDR statistics. -
different-origin-as Displays statistics about the routes that have the same destination address but different source AS numbers. -
regular-expression as-regular-expression Specifies the regular expression used to match the AS_Path information. The value is a string of 1 to 80 characters.
community Displays statistics about the routes carrying the specified BGP community attribute in the routing table. -
community-number Specifies the community number. The value is an integer that ranges from 0 to 4294967295.
aa:nn Specifies a community attribute value. Both aa and nn are integers ranging from 0 to 65535.
internet Displays statistics about the matching routes that can be sent to any peer. -
no-advertise Displays statistics about the BGP routes carrying the No-Advertise community attribute. -
no-export Displays statistics about the BGP routes carrying the No-Export community attribute. -
no-export-subconfed Displays statistics about the BGP routes carrying the No-Export-Subconfed community attribute. -
whole-match Indicates exact matching. -
community-filter Displays statistics about the routes that match a specified BGP community filter. -
basic-community-filter-number Specifies the number of a basic community filter. The value is an integer that ranges from 1 to 99.
advanced-community-filter-number Specifies the number of an advanced community filter. The value is an integer that ranges from 100 to 199.
community-filter-name Specifies the name of a community filter. The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.
dampened Displays the statistics of BGP dampened routes. -
active Displays the summary of active routes. -
best Displays the number of the optimal and best-external routes. -
peer ipv4-address Displays statistics about routes of a specified peer. It is in dotted decimal notation.
advertised-routes Displays statistics about the routes advertised to a specified peer. -
received-routes Displays statistics about the routes received from a specified peer. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display statistics about VPNv4 routes.
<HUAWEI> display bgp vpnv4 all routing-table statistics

Total Number of Routes from All PE: 1
 Total Number of Best Routes from All PE: 1
 Total Number of Best-external Routes from All PE: 0
 Total Number of Cidr Routes: 1
 Total Number of Community Routes: 0
 Total Number of Different-origin-as Routes: 0
 Total Number of Dampened Routes: 0

 VPN-Instance vrf1, Router ID 0.0.0.0:

 Total Number of Routes: 1
 Total Number of Prefix Advertised to RM : 0
 Total Number of Active Route : 0
 Total Number of Best Routes: 1
 Total Number of Cidr Routes: 1
 Total Number of Community Routes: 0
 Total Number of Different-origin-as Routes: 0
 Total Number of Dampened Routes: 0 

# Display statistics about the VPNv4 routes with the specified RD.

<HUAWEI> display bgp vpnv4 route-distinguisher 100:1 routing-table statistics
                                                                                
 Route Distinguisher: 100:1                                                     
                                                                                
                                                                                
 Total Number of Routes: 2                                                      
                                                                                
 VPN-Instance vpn1, Router ID 10.1.1.9:                                          
                                                                                
 Total Number of Routes: 2

# Display statistics about active VPNv4 routes.

<HUAWEI> display bgp vpnv4 all routing-table statistics active

 Total Number of Routes from all PE: 2                                                                                              
                                                                                                                                    
 VPN-Instance vpn1, router ID 10.1.1.9:                                                                                            
                                                                                                                                    
 Total Number of Prefix Advertised to RM : 0                                                                                        
 Total Number of Active Route : 0              
Table 9-172  Description of the display bgp vpnv4 routing-table statistics command output

Item

Description

Total Number of Routes from all PE

Total number of VPNv4 routes.

Total Number of Routes

Total number of routes of the VPN instance.

Total Number of Prefix Advertised to RM

Total number of routes delivered to RM.

Total Number of Active Route

Number of active routes.

Total Number of Best Routes

Number of best routes.

Total Number of Best-external Routes

Number of best-external routes.

Total Number of Cidr Routes

Number of CIDR routes.

Total Number of Community Routes

Number of routes carrying the specified BGP community attribute in the routing table.

Total Number of Different-origin-as Routes

Number of routes that have the same destination address but different source AS numbers.

Total Number of Dampened Routes

Number of dampened BGP routes.

Route Distinguisher

RD of the VPN instance IPv4 address family.

VPN-Instance vpn1

Indicating the name of VPN instance is vpn1.

Router ID 10.1.1.9

Indicating the router ID is 10.1.1.9.

display bgp vpnv6 brief

Function

The display bgp vpnv6 brief command displays brief information about VPNv6 and VPN instances (IPv6 address family).

Format

display bgp vpnv6 { all | vpn-instance vpn-instance-name } brief

Parameters

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

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After the display bgp vpnv6 brief command is used to display information about VPNv6 and VPN instances (IPv6 address family), the VPN instances are displayed and arranged alphabetically by name.

Example

# Display brief information about VPNv6 and VPN instances (IPv6 address family).

<HUAWEI> display bgp vpnv6 all brief

VPNV6:
  Rd Num               Peer Num            Route Num
    2                    1                   2

VPN-Instance(IPv6-family):
  VPN-Instance Name   Peer Num            Route Num
    vrf0                 1                   2
    vrf1                 0                   0
    vrf11                0                   0
    vrf12                0                   0
    vrf13                0                   0
    vrf14                0                   0
    vrf2                 0                   20
    vrf3                 0                   20
    vrf4                 0                   24
    vrf5                 0                   24
    vrf6                 0                   0
Table 9-173  Description of the display bgp vpnv6 all brief command output

Item

Description

Rd Num

Number of RDs.

Peer Num

Number of peers.

Route Num

Number of routes.

VPN-Instance Name

Name of a VPN instance.

display bgp vpnv6 routing-table

Function

The display bgp vpnv6 routing-table command displays BGP VPNv6 routes.

Format

display bgp vpnv6 { all | vpn-instance vpn-instance-name | route-distinguisher route-distinguisher } routing-table [ ipv6-address [ prefix-length ] ]

display bgp vpnv6 { all | vpn-instance vpn-instance-name | route-distinguisher route-distinguisher } routing-table as-path-filter { as-path-filter-number | as-path-filter-name }

display bgp vpnv6 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table community [ community-number | aa:nn | internet | no-advertise | no-export | no-export-subconfed ] &<1-33> [ whole-match ]

display bgp vpnv6 { all | vpn-instance vpn-instance-name | route-distinguisher route-distinguisher } routing-table community-filter { { community-filter-name | basic-community-filter-number } [ whole-match ] | advanced-community-filter-number }

display bgp vpnv6 { all | vpn-instance vpn-instance-name | route-distinguisher route-distinguisher } routing-table different-origin-as

display bgp vpnv6 { all | vpn-instance vpn-instance-name | route-distinguisher route-distinguisher } routing-table regular-expression as-regular-expression

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table ipv6-address [ prefix-length ] [ advertised-peer | as-path | cluster-list | community-list | ext-community ]

display bgp vpnv6 all routing-table peer ipv4-address { advertised-routes [ dest-ipv6-address [ prefix-length ] ] [ advertised-peer | as-path | cluster-list | community-list | ext-community ] | received-routes [ active ] }

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer ipv6-address { advertised-routes [ dest-ipv6-address [ prefix-length ] [ advertised-peer | as-path | cluster-list | community-list | ext-community ] ] | received-routes [ active ] }

display bgp vpnv6 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table time-range start-time end-time

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table peer ipv4-address received-routes dest-ipv6-address [ prefix-length [ original-attributes ] ]

display bgp vpnv6 all routing-table peer ipv4-address { accepted-routes | not-accepted-routes }

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer ipv6-address { accepted-routes | not-accepted-routes }

Parameters

Parameter Description Value
all Displays statistics about all BGP VPNv6 routes. -
vpn-instance vpn-instance-name Displays the BGP routes of a specified an IPv6 address family-enabled VPN instance on the local end. The VPN instance must already exist.
route-distinguisher route-distinguisher Displays the BGP routes with the specified RD.

The RD formats are divided into the following types:

  • 2-byte AS number:4-byte user-defined number, for example, 101:3. An AS number ranges from 0 to 65535. A user-defined number ranges from 0 to 4294967295. The AS number and the user-defined number cannot be 0s at the same time. That is, an RD cannot be 0:0.

  • Integral 4-byte AS number:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0:0.

  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535 and from 0 to 65535, respectively. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0.0:0.

  • IPv4-address:2-byte user-defined number, for example, 192.168.122.15:1. An IP address ranges from 0.0.0.0 to 255.255.255.255. A user-defined number ranges from 0 to 65535.

ipv4-address Specifies the IPv4 address of a peer to be displayed. It is in dotted decimal notation.
ipv6-address Specifies the IPv6 address of a peer to be displayed. 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 address. -
as-path-filter Displays the routes that match the specified filter. -
as-path-filter-number Specifies the number of the matching AS-Path filter. It is an integer that ranges from 1 to 256.
as-path-filter-name Specifies the name of the matching AS-Path filter. The name is a string of 1 to 51 case-sensitive characters without spaces. The string cannot be all numerals. When double quotation marks are used around the string, spaces are allowed in the string.
community Displays the routes carrying the specified BGP community attribute in the routing table. -
community-number Specifies the community number. -
aa:nn Specifies the community number. -
internet Displays the BGP routes carrying the Internet community attribute. -
no-advertise Displays the BGP routes carrying the No-Advertise community attribute. -
no-export Displays the BGP routes carrying the No-Export community attribute. -
no-export-subconfed Displays the BGP routes carrying the No-Export-Subconfed community attribute. -
whole-match Indicates exact matching. -
community-filter Displays the routes that match a specified BGP community filter. -
community-filter-name Specifies the name of a community filter. -
basic-community-filter-number Specifies the number of a basic community filter. -
advanced-community-filter-number Specifies the number of an advanced community filter. -
different-origin-as Displays the routes that have the same destination address but different source AS numbers. -
regular-expression as-regular-expression Specifies the regular expression used to match the AS_Path information. The value is a string of 1 to 80 characters.
peer ipv6-address Displays the BGP routes of a specified peer. -
advertised-routes Displays the routes advertised to a specified peer. -
dest-ipv6-address Specifies the destination IPv6 address. -
received-routes Displays the routes received from a specified peer. -
active Displays the active routes received from a specified peer. -
advertised-peer Displays the list of the peers for which a route is destined. -
as-path Displays the AS_Path attribute contained in a route. -
cluster-list Displays the cluster list contained in a route. -
community-list Displays the community attribute contained in a route. -
ext-community Displays the extended community contained in a route. -
time-range start-time end-time Displays BGP VPNv6 routes that flap within the specified time period. For example, the value 0d0h5m0s of start-time indicates 5 minutes before the current time. The value 0d0h10m0s of end-time indicates 10 minutes before the current time. All BGP VPNv6 routes with the Keepalive time in the range of 5 to 10 minutes are displayed.
The formats of start-time and end-time both are xxdxxhxxmxxs.
  • The d indicates days. The value is an integer that ranges from 0 to 10000.
  • The h indicates hours. The value is an integer that ranges from 0 to 23.
  • The m indicates minutes. The value is an integer that ranges from 0 to 59.
  • The s indicates seconds. The value is an integer that ranges from 0 to 59.
original-attributes Displays the original attributes of a BGP route from a specified BGP peer before the route is filtered by the local import policy. To display such attributes, the peer keep-all-routes command must have been run. -
accepted-routes Displays routes accepted by routing policy. -
not-accepted-routes Displays routes not accepted by routing policy.
NOTE:

Information about the routes that fail to match the route-policy can be displayed only after the keep-all-routes or peer keep-all-routes command is configured.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Information about specified routes can be displayed by specifying different parameters.

Example

# Display all BGP VPNv6 routes.

<HUAWEI> display bgp vpnv6 all routing-table
                                                                                
                                                                                
 BGP Local router ID is 10.1.1.1                                                 
 Status codes: * - valid, > - best, d - damped, h - history,                                 
               i - internal, s - suppressed, S - Stale            
 Origin      : i - IGP, e - EGP, ? - incomplete                        
                                                                                
                                                                                
 Total number of routes from all PE: 3                                          
 Route Distinguisher: 100:1                                                     
                                                                                
                                                                                
 *>i Network  : FC00:0:0:1::                             PrefixLen : 64         
     NextHop  : FC00:0:0:2::1                            LocPrf    :            
     MED      : 0                                        PrefVal   : 0          
     Label    : NULL                                                            
     Path/Ogn :  ?                                                              
 *>  Network  : FC00:0:0:1::                             PrefixLen : 64         
     NextHop  : ::                                       LocPrf    :            
     MED      : 0                                        PrefVal   : 0          
     Label    : NULL                                                            
     Path/Ogn :  ?                                                              
 *>  Network  : FE80::                                   PrefixLen : 10         
     NextHop  : ::                                       LocPrf    :            
     MED      : 0                                        PrefVal   : 0          
     Label    : NULL                                                            
     Path/Ogn :  ?                                                              
                                                                                
 VPN-Instance whm1 :                                                            
                                                                                
 Total Number of Routes: 3                                                      
 *>  Network  : FC00:0:0:3::                             PrefixLen : 64         
     NextHop  : ::                                       LocPrf    :            
     MED      : 0                                        PrefVal   : 0          
     Label    : NULL                                                            
     Path/Ogn :  ?                                                              
 *>  Network  : FC00:0:0:4::                             PrefixLen : 128        
     NextHop  : ::                                       LocPrf    :            
     MED      : 0                                        PrefVal   : 0          
     Label    : NULL                                                            
     Path/Ogn :  ?                                                              
 *>  Network  : FE80::                                   PrefixLen : 10         
     NextHop  : ::                                       LocPrf    :            
     MED      : 0                                        PrefVal   : 0          
     Label    : NULL                                                            
     Path/Ogn :  ?                                                              
Table 9-174  Description of the display bgp vpnv6 all routing-table command output

Item

Description

BGP Local router ID

ID of the local BGP router. The ID is in the same format as an IPv4 address.

Total number of routes from all PE

Total number of BGP VPNv6 routes received by the switch from its peer PEs.

Network

Destination network or host address of the route.

PrefixLen

Prefix length of the destination network or host address of the route.

NextHop

IPv6 address of the next hop.

LocPrf

Local preference of the BGP route. The default value is 100.

MED

MED of the route. The default value is 0.

PrefVal

Preferred value of the route.

Label

Label carried by the data packet destined for the destination network or host address of the route.

Path/Ogn

AS_Path number and Origin attribute of the route.

# Display the routes of an IPv6 address family-enabled VPN instance named vpn1 on the local device.

<HUAWEI> display bgp vpnv6 vpn-instance vpn1 routing-table

 BGP Local router ID is 10.1.1.9
 Status codes: * - valid, > - best, d - damped,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete


 Total Number of Routes: 2
 *>i Network  : FC00:0:0:1::                             PrefixLen : 64
     NextHop  : FC00:0:0:3::1                            LocPrf    :
     MED      : 0                                        PrefVal   : 0
     Label    :
     Path/Ogn : 65410  ?
 *>i Network  : FC00:0:0:1::                             PrefixLen : 64
     NextHop  : FC00:0:0:2::1                            LocPrf    : 100
     MED      : 0                                        PrefVal   : 0
     Label    : 1037/NULL
     Path/Ogn : ?

# Display the BGP routes with a specified destination address of an IPv6 address family-enabled VPN instance.

<HUAWEI> display bgp vpnv6 vpn-instance vrf1 routing-table fc00:0:0:1::
                                                                                
 BGP Local router ID : 10.1.1.1                                                  
 Local AS number : 100                                                          
 Paths:   2 available, 1 best, 1 select                                         
 BGP routing table entry information of FC00:0:0:1::/64:                              
 Imported route.                                                                
 From: :: (0.0.0.0)                                                             
 Route Duration: 1d03h46m24s                                                    
 Direct Out-interface: Vlanif100                                                
 Original nexthop: ::                                                           
 AS-path Nil, origin incomplete, MED 0, pref-val 0, valid, local, best, select, 
pre 0                                                                           
 Advertised to such 1 peers:                                                    
    FC00:0:0:2::2                                                                     
 BGP routing table entry information of 2001:db8::/64:                              
 From: FC00:0:0:1::1 (10.10.10.10)                                                    
 Route Duration: 02h39m43s                                                      
 Direct Out-interface: Vlanif100                                                
 Original nexthop: FC00:0:0:1::1                                                      
 AS-path 65410, origin incomplete, MED 0, pref-val 0, external, pre 255         
 Not advertised to any peer yet                                                 

# Display all BGP VPNv6 routes whose AS_Path attribute contains 65420.

<HUAWEI> display bgp vpnv6 vpn-instance vpn1 routing-table as-path-filter 1

 BGP Local router ID is 10.1.1.9
 Status codes: * - valid, > - best, d - damped, h - history,
               i - internal, s - suppressed, S - Stale
 Origin      : i - IGP, e - EGP, ? - incomplete


 VPN-Instance vpn1 :

 Total Number of Routes: 1
     Network  : FC00:0:0:1::                             PrefixLen : 64
     NextHop  : FC00:0:0:2::2                            LocPrf    :
     MED      : 0                                        PrefVal   : 0
     Label    :
     Path/Ogn : 65420  ?
Table 9-175  Description of the display bgp vpnv6 routing-table command output
Item Description
Local AS number Local AS number.
Paths The route selection result.
BGP routing table entry information of The following information is about a specified BGP routing entry.

Imported route

Routes imported to BGP using the import-route (BGP) command.

From IP address of the route originator.
Route Duration Route duration.
Direct Out-interface Direct outbound interface.
Original nexthop Original next hop.
AS-path AS_Path attribute.
origin Origin attribute of the BGP route.

The value can be IGP (for example, the routes imported into the BGP routing table by using the network (BGP) command), EGP (the routes obtained by EGP), or Incomplete (the routes whose origin cannot be identified, for example, the routes imported into the BGP routing table by using the import-route (BGP) command).

pref-val Preferred value.
valid Valid BGP route.
local Local route.
best The BGP route is the optimal route.
select The BGP route is a preferred route.
pre The preference of the BGP route.
Advertised to such 1 peers The BGP route has been advertised to one peer.
Not advertised to any peer yet The BGP route has not been advertised to any peer.
external The BGP route is learned from the EBGP peer.
internal The BGP route is learned from the IBGP peer.
VPN-Instance vpn1 The VPN instance is vpn1.

Total Number of Routes

Number of routes in VPN instance vpn1.

display bgp vpnv6 routing-table statistics

Function

The display bgp vpnv6 routing-table statistics command displays statistics about BGP VPNv6 routes.

Format

display bgp vpnv6 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table statistics [ as-path-filter { as-path-filter-number | as-path-filter-name } | different-origin-as ]

display bgp vpnv6 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table statistics regular-expression as-regular-expression

display bgp vpnv6 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table statistics community [ community-number | aa:nn | internet | no-advertise | no-export | no-export-subconfed ] &<1-33> [ whole-match ]

display bgp vpnv6 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table statistics community-filter { { community-filter-name | basic-community-filter-number } [ whole-match ] | advanced-community-filter-number }

display bgp vpnv6 all routing-table peer ipv4-address { advertised-routes | received-routes [ active ] } statistics

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer ipv6-address { advertised-routes | received-routes [ active ] } statistics

display bgp vpnv6 { all | route-distinguisher route-distinguisher | vpn-instance vpn-instance-name } routing-table statistics active

Parameters

Parameter Description Value
all Displays statistics about all BGP VPNv6 routes. -
route-distinguisher route-distinguisher Displays the BGP routes with the specified RD.
The RD formats are divided into the following types:
  • 2-byte AS number:4-byte user-defined number, for example, 101:3. An AS number ranges from 0 to 65535. A user-defined number ranges from 0 to 4294967295. The AS number and the user-defined number cannot be 0s at the same time. That is, an RD cannot be 0:0.

  • Integral 4-byte AS number:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0:0.

  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535 and from 0 to 65535, respectively. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0.0:0.

  • IPv4-address:2-byte user-defined number, for example, 192.168.122.15:1. An IP address ranges from 0.0.0.0 to 255.255.255.255. A user-defined number ranges from 0 to 65535.

vpn-instance vpn-instance-name Displays statistics about the BGP routes of a specified VPN instance. The VPN must already exist.
as-path-filter Displays the routes that match the specified filter. -
as-path-filter-number Specifies the number of the matching AS-Path filter. The value is an integer that ranges from 1 to 256.
as-path-filter-name Specifies the name of the matching AS-Path filter. The name is a string of 1 to 51 case-sensitive characters without spaces. The string cannot be all numerals.When double quotation marks are used around the string, spaces are allowed in the string.
different-origin-as Displays statistics about the routes that have the same destination address but different source AS numbers. -
regular-expression as-regular-expression Specifies the regular expression used to match the AS_Path information. The value is a string of 1 to 80 characters.
community Displays statistics about the routes carrying the specified BGP community attribute in the routing table. -
community-number Specifies the community number. The value is an integer that ranges from 0 to 4294967295.
aa:nn Specifies the community number. Both aa and nn are integers ranging from 0 to 65535.
internet Displays statistics about the BGP routes carrying the Internet community attribute. -
no-advertise Displays statistics about the BGP routes carrying the No-Advertise community attribute. -
no-export Displays statistics about the BGP routes carrying the No-Export community attribute. -
no-export-subconfed Displays statistics about the BGP routes carrying the No-Export-Subconfed community attribute. -
whole-match Indicates exact matching. -
community-filter Displays statistics about the routes that match a specified BGP community filter. -
community-filter-name Specifies the name of a community filter. The name is a string of 1 to 51 characters without any space. It is case-sensitive.
basic-community-filter-number Specifies the number of a basic community filter. The value is an integer that ranges from 1 to 99.
advanced-community-filter-number Specifies the number of an advanced community filter. The value is an integer that ranges from 100 to 199.
peer ipv6-address Displays statistics about the BGP routes of a specified peer. -
peer ipv4-address Displays the routing information for the specified BGP peer. -
advertised-routes Displays statistics about the routes advertised to a specified peer. -
received-routes Displays statistics about the routes received from a specified peer. -
active Specifies the number of active routes. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display statistics about BGP VPNv6 routes on the local device.
<HUAWEI> display bgp vpnv6 all routing-table statistics

Total Number of Routes from All PE: 1
 Total Number of Best Routes from All PE: 1
 Total Number of Best-external Routes from All PE: 0
 Total Number of Community Routes: 0
 Total Number of Different-origin-as Routes: 0
 Total Number of Dampened Routes: 0

 VPN-Instance vrf1, Router ID 0.0.0.0:

 Total Number of Routes: 1
 Total Number of Prefix Advertised to RM : 0
 Total Number of Active Route : 0
 Total Number of Best Routes: 1
 Total Number of Community Routes: 0
 Total Number of Different-origin-as Routes: 0
 Total Number of Dampened Routes: 0

# Display statistics about the routes of an IPv6 address family-enabled VPN instance named vpn1 on the local device.

<HUAWEI> display bgp vpnv6 vpn-instance vpn1 routing-table statistics

 Total Number of Routes: 5

# Display statistics about the BGP VPNv6 routes received from peer 10.1.1.1.

<HUAWEI> display bgp vpnv6 all routing-table peer 10.1.1.1 received-routes statistics
  Received routes total: 1

# Display statistics about the VPN-IPv6 routes that have the Internet community attribute and specified RD on the local device.

<HUAWEI> display bgp vpnv6 route-distinguisher 100:1 routing-table statistics community internet

 Total Number of Routes from all PE: 1

 VPN-Instance vpn1 :

 Total Number of Routes: 2

# Display statistics about the BGP VPNv6 routes that match a specified community filter on the local device.

<HUAWEI> display bgp vpnv6 all routing-table statistics community-filter 1

 Total Number of Routes from all PE: 1

 VPN-Instance vpn1 :

 Total Number of Routes: 2

# Display statistics about the BGP VPNv6 routes that match a specified AS_Path regular expression.

<HUAWEI> display bgp vpnv6 all routing-table statistics regular-expression 65420*

 Total Number of Routes from all PE: 1

 VPN-Instance vpn1 :

 Total Number of Routes: 1

# Display statistics of BGP routes sent by the local device to peer 2001:db8::1 of the IPv6 VPN instance named vpn1.

<HUAWEI> display bgp vpnv6 vpn-instance vpn1 routing-table peer 2001:db8::1 received-routes statistics
  Received routes total: 2

# Display statistics about the IPv6 routes sent by the local device to peer 2001:db8::1 in a VPN instance named vpn1.

<HUAWEI> display bgp vpnv6 vpn-instance vpn1 routing-table peer 2001:db8::1 advertised-routes statistics
  Advertised routes total: 2

  Default originated : 0
Table 9-176  Description of the display bgp vpnv6 routing-table statistics command output
Item Description

Total Number of Routes from all PE

Total number of VPNv6 routes

VPN-Instance vrf1 Indicating the name of VPN instance is vrf1
Router ID 0.0.0.0 Indicating the router ID is 0.0.0.0

Total Number of Routes

Total number of VPNv6 routes with a specified RD

Total Number of Prefix Advertised to RM

Total number of routes delivered to RM

Total Number of Active Route

Number of active routes

Total Number of Best Routes

Number of best routes

Total Number of Best-external Routes

Number of best-external routes

Total Number of Community Routes

Number of routes carrying the specified BGP community attribute in the routing table

Total Number of Different-origin-as Routes

Number of routes that have the same destination address but different source AS numbers

Total Number of Dampened Routes

Number of dampened BGP routes

Received routes total

Number of BGP VPNv6 routes received from a specified peer

Advertised routes total

Number of BGP VPNv6 routes sent to a specified peer

display bmp session

Function

The display bmp session command displays configurations about a BMP session.

Format

display bmp session

display bmp session { ipv4-address | ipv6-address } verbose

Parameters

Parameter Description Value
ipv4-address Specifies the IPv4 address used for the BMP session. The value is in dotted decimal notation.
ipv6-address Specifies the IPv6 address used for the BMP session. The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
verbose Displays detailed session information. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To check configurations about a BMP session, you can run the display bmp session command. The command output helps you locate the problem and determine whether the BMP session is properly configured.

Example

# Display configurations about the BMP session with 10.1.1.1 as the session address.

<HUAWEI> display bmp session 10.1.1.1 verbose

  BMP session 10.1.1.1, port 0      
    Current state: Down (Reason: Tcp Fail), Age: 02m14s 
    VPN-instance name: _public_       
    Local address: 0.0.0.0, Local port: 0    
    Route Mode: post-policy           
    Statistics timeout: 3600(s)             
    ConnectRetry Timer Remainder: 116(s)  
    Statistics-report Timer Remainder: 805(s)  
Table 9-177  Description of the display bmp session verbose command output

Item

Description

port

Server port number.

Current state

Status of the BMP session:
  • Down
  • Up

Age

Age timer of the BMP session.

VPN-instance name

VPN instance to which the BMP session belongs.

Local address

Local IP address.

Local port

Local port number.

Route Mode

Statistics about all received routes or only accepted routes are sent to the monitoring server:
  • pre-policy: statistics about all received routes to the monitoring server.
  • post-policy: statistics about only accepted routes to the monitoring server.

Statistics timeout

Interval at which the router sends BGP running statistics to the monitoring server, in seconds.

ConnectRetry Timer Remainder

Period after which a connection is reestablished, in seconds.

Statistics-report Timer Remainder

Period after which the router sends BGP running statistics to a monitoring server, in seconds.

display default-parameter bgp

Function

The display default-parameter bgp command displays default configurations in BGP initialization.

Format

display default-parameter bgp

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display default configurations in BGP initialization.

<HUAWEI> display default-parameter bgp
 BGP version               : 4                                             
 EBGP preference           : 255                                           
 IBGP preference           : 255                                           
 Local preference          : 255                                           
 BGP connect-retry         : 32s                                           
 BGP holdtime              : 180s                                          
 BGP keepAlive             : 60s                                           
 EBGP route-update-interval: 30s                                           
 IBGP route-update-interval: 15s                                           
 Default local-preference  : 100                                           
 Default MED               : 0                                             
 IPv4-family unicast       : enable                                        
 EBGP-interface-sensitive  : enable                                        
 IBGP-interface-sensitive  : disable                                       
 Reflect between-clients   : enable                                        
 Check-first-as            : enable                                        
 Synchronization           : disable                                       
  Nexthop-resolved rules    :                                               
     IPv4-family           : unicast(ip)                                   
                             label-route(ip)                               
                             multicast(ip)                                 
                             vpn-instance(tunnel)                          
                             vpnv4(ip)                                     
     IPv6-family           : unicast(ip)                                   
                             vpn-instance(tunnel)                          
                             vpnv6(ip)                                     
                             6PE(tunnel)                                   
                                                                           
 
Table 9-178  Description of the display default-parameter bgp command output

Item

Description

BGP version

BGP version number.

EBGP preference

EBGP route preference.

IBGP preference

IBGP route preference.

Local preference

Local route preference.

BGP connect-retry

BGP ConnectRetry interval.

BGP holdtime

BGP holdtime interval.

BGP keepAlive

BGP keepalive interval.

EBGP route-update-interval

Minimum interval for sending EBGP Update messages.

IBGP route-update-interval

Minimum interval for sending IBGP Update messages.

Default local-preference

Local preference of a BGP route.

Default MED

MED of a BGP route.

IPv4-family unicast

BGP-IPv4 unicast address family view.

EBGP-interface-sensitive

The BGP session between the directly connected peer and an interface is deleted immediately when the interface becomes Down.

IBGP-interface-sensitive

The IBGP session between the directly connected peer and an interface is deleted immediately when the interface becomes Down.

Reflect between-clients

Route reflection between clients.

Check-first-as

The first AS number in the AS_Path list that is carried in the Update message sent by the EBGP peer is checked.

Synchronization

Synchronization between IBGP and IGP.

Nexthop-resolved rules

Default iteration mode of preferred routes.

display default-parameter bmp

Function

The display default-parameter bmp command displays default BMP configurations.

Format

display default-parameter bmp

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To check the default interval at which the router sends BGP running statistics to the monitoring server and whether statistics about all received routes or only accepted routes are sent to the monitoring server, run the display default-parameter bmp command.

Example

# Display default BMP configurations.

<HUAWEI> display default-parameter bmp
 statistics-timer          : 3600  
 route-mode                : post-policy 
Table 9-179  Description of the display default-parameter bmp command output

Item

Description

statistics-timer Interval at which the router sends BGP running statistics to the monitoring server, in seconds
route-mode Whether statistics about all received routes or only accepted routes are sent to the monitoring server

display mbgp routing-table

Function

The display mbgp routing-table command displays MBGP routes.

Format

display mbgp routing-table [ ipv4-address [ mask | mask-length ] [ longer-match ] ] [ verbose ]

Parameters

Parameter Description Value
ipv4-address Specifies the destination IP address in dotted decimal notation. -
mask | mask-length Specifies mask in dotted decimal notation or mask-length. -
longer-match Displays the routes with the specified destination address and mask. -
verbose Displays detailed information about active and inactive routes. If the parameter verbose is not specified, detailed information about active routes is displayed. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can specify different parameters to view the specific routing information.

Example

# Display information about all MBGP routes.

<HUAWEI> display mbgp routing-table
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Tables: MBGP
         Destinations : 1        Routes : 1
 
Destination/Mask  Proto  Pre  Cost  Flags  NextHop  Interface
 
  10.5.5.1/32     MBGP   255     0     R   10.1.1.1  Vlanif10
Table 9-180  Description of the display mbgp routing-table command output

Item

Description

Route Flags

Indicates the route flag:

  • R: indicates an iterated route.

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

Routing Tables: MBGP

Indicates an MBGP routing table.

Destinations

Indicates the total number of destination networks or hosts.

Routes

Indicates the total number of routes.

Destination/Mask

Indicates the address and mask length of the destination network or host.

Proto

Indicates the protocol through which routes are learned.

Pre

Indicates the preference.

Cost

Indicates the route cost.

Flags

Indicates the route flag, that is, Route Flags in the header of the routing table.

NextHop

Indicates the next hop.

Interface

Indicates the outbound interface through which the next hop is reachable.

# Display the detailed information of the specified routes.

<HUAWEI> display mbgp routing-table 192.168.1.1 verbose
Routing Table : MBGP
Summary Count : 1

  Destination: 10.5.5.1/32
     Protocol: MBGP              Process ID: 0
   Preference: 255                     Cost: 0
      NextHop: 10.1.1.1           Neighbour: 0.0.0.0
        State: Active Adv GotQ          Age: 00h43m25s
          Tag: 0                   Priority: 0
        Label: NULL                 QoSInfo: 0x0
 RelayNextHop: 0.0.0.0            Interface: Vlanif 10
     TunnelID: 0x0                    Flags: R
Table 9-181  Description of the display mbgp routing-table verbose command output

Item

Description

Destination

Indicates the address and mask length of the destination network or host.

Protocol

Indicates the routing protocol.

Process ID

Indicates the process ID of the routing protocol.

Preference

Indicates the preference of the route.

Cost

Indicates the route cost.

NextHop

Indicates the next hop.

Neighbour

Indicates the neighbor.

State

Indicates the status of routes:

  • Active: indicates active routes.

  • Invalid: indicates invalid routes.

  • Inactive: indicates inactive routes.

  • NoAdv: indicates the routes that cannot be advertised.

  • Adv: indicates the routes that can be advertised.

  • Del: indicates the routes to be deleted.

  • GotQ: indicates the route that finds the next hop and outbound interface or the route that finds the tunnel.

  • WaitQ: indicates the route that does not find the next hop or outbound interface or the route that does not find the tunnel.

  • Stale: indicates the routes with the stale flag. The routes are used in GR.

Age

Indicates the lifetime of the route.

Tag

Indicates the administrative tag for routes.

Priority

Indicates the priority.

Label

Indicates the allocated MPLS label.

QoSInfo

Indicates QoS information.

RelayNextHop

Indicates the relay next hop.

Interface

Indicates the name of an iterated outbound interface.

Tunnel ID

Indicates the tunnel ID.

Flags

Indicates the route flag, that is, Route Flags in the header of the routing table.

display mbgp routing-table statistics

Function

The display mbgp routing-table statistics command displays the statistics of the MBGP routes.

Format

display mbgp routing-table statistics

Parameters

None.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Route statistics include:
  • Total number of routes that are added or deleted by the protocol
  • Number of active routes or inactive routes that are labeled for deletion but are not actually deleted

Example

# Display statistics of the MBGP routing table.

<HUAWEI> display mbgp routing-table statistics
Proto     total      active      added        deleted      freed
          routes     routes      routes       routes       routes
MBGP      6          4           10           0            0
Table 9-182  Description of the display mbgp routing-table statistics command output

Item

Description

Proto

Routing protocol

total routes

Total number of routes in the routing table

active routes

Number of active routes in the routing table

added routes

Number of active and inactive routes added in the routing table

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 snmp-agent trap feature-name bgp all

Function

The display snmp-agent trap feature-name bgp all command displays all the traps related to the BGP module.

Format

display snmp-agent trap feature-name bgp all

Parameters

None

Views

All views

Default Level

3: Management level

Usage Guidelines

Usage Scenario

The display snmp-agent trap feature-name bgp all command is used to display the status of all the traps related to the BGP module.

To change the status of the traps related to the BGP module, run the snmp-agent trap enable feature-name bgp command.

Example

# Display all the traps related to the BGP module.

<HUAWEI>display snmp-agent trap feature-name bgp all
------------------------------------------------------------------------------  
Feature name: BGP                                                               
Trap number : 8  
------------------------------------------------------------------------------  
Trap name                      Default switch status   Current switch status    
bgpBackwardTransNotification   off                     off                      
bgpBackwardTransition          off                     off                      
bgpEstablished                 off                     off                      
bgpEstablishedNotification     off                     off                      
hwBgpPeerRouteExceed           off                     off                      
hwBgpPeerRouteExceedClear      off                     off                      
hwBgpPeerRouteNumThresholdClear                                                 
                               off                     off                      
hwBgpPeerRouteNumThresholdExceed                                                
                               off                     off                      
   
Table 9-183  Description of the display snmp-agent trap feature-name bgp 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 BGP module:

  • bgpBackwardTransNotification: indicates the disconnection of BGP neighbors.
  • bgpBackwardTransition: indicates the disconnection of BGP neighbors.
  • bgpEstablished: indicates that the BGP neighbor has entered the Established state.
  • bgpEstablishedNotification: indicates that the BGP neighbor has entered the Established state.
  • hwBgpPeerRouteExceed: indicates that the number of routes of BGP neighbors exceeds the alarm threshold.
  • hwBgpPeerRouteExceedClear: indicates that the number of routes of BGP neighbors falls below the alarm threshold.
  • hwBgpPeerRouteNumThresholdClear: indicates that the number of routes of BGP neighbors falls below the alarm threshold.
  • hwBgpPeerRouteNumThresholdExceed: indicates that the number of routes of BGP neighbors exceeds the alarm threshold.

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 system osnode-group

Function

The display system osnode-group command displays information about all operating systems on a PS.

Format

display system osnode-group

Parameters

None

Views

All views

Default Level

3: Management level

Usage Guidelines

Usage Scenario

Before creating distributed service instances, you can run the display system osnode-group command to view information about all operating systems on a PS.

The relationships between board groups and operating system groups are described as follows:

  • If each board in a board group has only one operating system, the board group contains an operating system group.
  • If each board in a board group has multiple operating systems, the board group contains multiple operating system groups.
  • Operating system groups are automatically generated based on board groups, and are used to bear services.

Example

# Display information about operating system groups.

<HUAWEI> display system osnode-group
HA Osnode Group Information 
--------------------------------------------------------------------------------
OS-group             OS-node    Board-id         Deploy-state      Active-state
--------------------------------------------------------------------------------
OSG-MMB-BG1-1        273        17               available         active
OSG-MMB-BG1-1        274        18               available         active
--------------------------------------------------------------------------------
Table 9-184  Description of the display system osnode-group command output

Item

Description

OS-group

Name of an operating system group

OS-node

ID of an operating system node

Board-id

Slot number of the board where the operating system node resides

Deploy-state

Status of the services on the operating system node:

  • unavailable: It is unavailable when a board is reset or removed.
  • available: It is available when the board has been registered.

Active-state

Status of the operating system node:

  • inactive: The cold Slave Main Board (SMB) and the unavailable MB are in the Inactive state.
  • active: The Master Main Board (MMB) and the hot SMB are in the Active state.

ebgp-interface-sensitive

Function

The ebgp-interface-sensitive command immediately resets a BGP session on an interface that is directly connected to an external peer when the interface goes Down.

The undo ebgp-interface-sensitive command disables the function.

By default, this function is enabled.

Format

ebgp-interface-sensitive

undo ebgp-interface-sensitive

Parameters

None

Views

BGP view, BGP-IPv4 unicast address family view, BGP-VPN instance IPv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the ebgp-interface-sensitive command is not configured, the system does not immediately select the sub-optimal route for packet transmission when an interface goes Down. Instead, the system waits for a period of time (defaulting to 180 seconds) before checking whether another interface can be used to send packets to the same destination address. This will interrupt services for a period of time. If the ebgp-interface-sensitive command is run, BGP can quickly detect EBGP link faults and use another interface to establish a BGP peer relationship with the remote peer.

When the interface used for a BGP connection alternates between Up and Down states, running the undo ebgp-interface-sensitive command can prevent the repeated reestablishment and deletion of the BGP session in the event of route flapping. This reduces the use of network bandwidth.

Precautions

If the interface used for a BGP connection alternates between Up and Down states, it would be better not to run the ebgp-interface-sensitive command to prevent route flapping.

Example

# Enable the function that automatically resets a BGP session.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] ebgp-interface-sensitive

ext-community-change enable

Function

The ext-community-change enable command enables a device to change extended community attributes based on a Route-Policy.

The undo ext-community-change enable command disables a device from changing extended community attributes based on a Route-Policy.

By default, extended community attributes cannot be changed based on a Route-Policy.

Format

ext-community-change enable

undo ext-community-change enable

Parameters

None

Views

BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-VPN instance IPv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP prevents a device from changing extended community attributes from a peer or peer group based on an import policy or changing extended community attributes to be advertised to a peer or peer group based on an export policy. To enable a device to change extended community attributes from a peer or peer group based on an import policy and change extended community attributes to be advertised to a peer or peer group based on an export policy before advertising them, run the ext-community-change enable command.

Precautions

  • The ext-community-change enable and peer route-policy import commands must both be run so that the device can change extended community attributes from a peer or peer group based on an import policy.

  • The ext-community-change enable command must be run with either of the following commands so that the extended community attributes changed based on an export policy can be advertised to a peer or peer group.

Example

# Enable the device to change extended community attributes of the BGP routes receiverd from peer 10.1.1.1 based on a Route-Policy named policy1.

<HUAWEI> system-view
[~HUAWEI] route-policy policy1 permit node 10
[*HUAWEI-route-policy] if-match as-path-filter 2
[*HUAWEI-route-policy] apply extcommunity rt 10.1.1.1:1 additive
[*HUAWEI-route-policy] quit
[*HUAWEI] bgp 100
[*HUAWEI-bgp] ipv4-family unicast
[*HUAWEI-bgp-af-ipv4] ext-community-change enable
[*HUAWEI-bgp-af-ipv4] peer 10.1.1.1 route-policy policy1 import

filter-policy export (BGP)

Function

The filter-policy export command configures a device to filter the routes to be advertised. BGP advertises only the routes that pass filtering.

The undo filter-policy export command restores the default configuration.

By default, the routes to be advertised are not filtered.

Format

filter-policy { acl-number | acl-name acl-name | ip-prefix ip-prefix-name } export [ protocol [ process-id ] ]

filter-policy { acl6-number | acl6-name acl6-name | ipv6-prefix ipv6-prefix-name } export [ protocol [ process-id ] ]

undo filter-policy export [ protocol [ process-id ] ]

undo filter-policy { acl-number | acl-name acl-name | ip-prefix ip-prefix-name } export [ protocol [ process-id ] ]

undo filter-policy { acl6-number | acl6-name acl6-name | ipv6-prefix ipv6-prefix-name } export [ protocol [ process-id ] ]

Parameters

Parameter Description Value
acl-number Specifies the number of a basic ACL. The value is an integer that ranges from 2000 to 2999.
acl-name acl-name Specifies the name of a named ACL. The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).
ip-prefix ip-prefix-name Specifies the name of an IPv4 prefix list. The name is a string of 1 to 169 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
protocol Specifies the name of a routing protocol. The BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP multi-instance VPN instance IPv4 address family view, and BGP-VPN instance IPv4 address family view support direct, isis, ospf, rip, and static. The BGP-IPv6 unicast address family view and BGP-VPN instance IPv6 address family view support direct, isis, ospfv3, ripng, static.
process-id Specifies the number of a process that needs to perform matching. If protocol is direct or static, no process ID is required. The value is an integer that ranges from 1 to 4294967295.
acl6-number Specifies the number of a basic ACL6. The value is an integer that ranges from 2000 to 2999.
acl6-name acl6-name Specifies the name of a named ACL6. The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).
ipv6-prefix ipv6-prefix-name Specifies the name of an IPv6 prefix list. The name is a string of 1 to 169 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string.
NOTE:
  • protocol [ process-id ] is valid only in the BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-VPN instance IPv4 address family view, BGP multi-instance VPN instance IPv4 address family view, BGP-IPv6 unicast address family view and BGP-VPN instance IPv6 address family view.

  • acl-name acl-name, acl-number, and ip-prefix ip-prefix-name are valid only in the BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP multi-instance VPN instance IPv4 address family view, and BGP-VPN instance IPv4 address family view.

  • acl6-name acl6-name, acl6-number, and ipv6-prefix