Use address-family dedicated to create the BGP dedicated address family and enter its view, or enter the view of the existing BGP dedicated address family.

Use undo address-family dedicated to remove the BGP dedicated address family and all its configurations.

Syntax

address-family dedicated

undo address-family dedicated

Default

No BGP dedicated address family exists.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

Configurations made in BGP dedicated address family view apply only to the BGP dedicated routes.

Examples

# In BGP instance view, create the BGP dedicated address family and enter its view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family dedicated

[Sysname-bgp-default-dedicated]

Use address-family ipv4 to create the BGP IPv4 unicast address family, BGP-VPN IPv4 unicast address family, BGP IPv4 RT filter address family, or BGP IPv4 multicast address family, and enter its view, or enter the view of the existing address family.

Use undo address-family ipv4 to remove the BGP IPv4 unicast address family, BGP-VPN IPv4 unicast address family, BGP IPv4 RT filter address family, or BGP IPv4 multicast address family, and all its configurations.

Syntax

In BGP instance view:

address-family ipv4 [ multicast | rtfilter | unicast ]

undo address-family ipv4 [ multicast | rtfilter | unicast ]

In BGP-VPN instance view:

address-family ipv4 [ unicast ]

undo address-family ipv4 [ unicast ]

Default

No BGP IPv4 unicast address family, BGP-VPN IPv4 unicast address family, BGP IPv4 RT filter address family, or BGP IPv4 multicast address family exists.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Parameters

multicast: Specifies the IPv4 multicast address family.

rtfilter: Specifies the BGP IPv4 RT filter address family.

unicast: Specifies the IPv4 unicast address family. If this command is executed with the unicast keyword in BGP instance view, it places you into BGP IPv4 unicast address family view. If this command is executed with the unicast keyword in BGP-VPN instance view, it places you into BGP-VPN IPv4 unicast address family view.

Usage guidelines

Configurations made in BGP IPv4 unicast address family view apply only to the BGP IPv4 unicast routes and peers of the public network.

Configurations made in BGP-VPN IPv4 unicast address family view apply only to the BGP IPv4 unicast routes and peers of the specified VPN instance.

Configurations made in BGP IPv4 multicast address family view apply only to the BGP IPv4 multicast routes and peers.

Configurations made in BGP IPv4 RT filter address family view apply only to the BGP IPv4 RT filter routes and peers.

By default, the unicast keyword is used if you do not specify the multicast, rtfilter, or unicast keyword.

Examples

# In BGP instance view, create the BGP IPv4 unicast address family and enter its view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4]

address-family ipv6

Use address-family ipv6 to create the BGP IPv6 unicast address family, BGP-VPN IPv6 unicast address family, or BGP IPv6 multicast address family, and enter its view, or enter the view of the existing address family.

Use undo address-family ipv6 to remove the BGP IPv6 unicast address family, BGP-VPN IPv6 unicast address family, or BGP IPv6 multicast address family, and all its configurations.

Syntax

In BGP instance view:

address-family ipv6 [ multicast | unicast ]

undo address-family ipv6 [ multicast | unicast ]

In BGP-VPN instance view:

address-family ipv6 [ unicast ]

undo address-family ipv6 [ unicast ]

Default

No BGP IPv6 unicast address family, BGP-VPN IPv6 unicast address family, or BGP IPv6 multicast address family exists.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Parameters

unicast: Specifies the IPv6 unicast address family. If this command is executed with the unicast keyword in BGP instance view, it places you into BGP IPv6 unicast address family view. If this command is executed with the unicast keyword in BGP-VPN instance view, it places you into BGP-VPN IPv6 unicast address family view.

multicast: Specifies the IPv6 multicast address family.

Usage guidelines

Configurations made in BGP IPv6 unicast address family view apply only to the BGP IPv6 unicast routes and peers of the public network.

Configurations made in BGP-VPN IPv6 unicast address family view apply only to the BGP IPv6 unicast routes and peers of the specified VPN instance.

Configurations made in BGP IPv6 multicast address family view apply only to the BGP IPv6 multicast routes and peers.

By default, the unicast keyword is used if neither the multicast keyword nor the unicast keyword is specified.

Examples

# In BGP instance view, create the BGP IPv6 unicast address family and enter its view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv6 unicast

[Sysname-bgp-default-ipv6]

address-family link-state

Use address-family link-state to create the BGP LS address family and enter its view, or enter the view of the existing address family.

Use undo address-family link-state to remove the BGP LS address family and all its configurations.

Syntax

address-family link-state

undo address-family link-state

Default

No BGP LS address family exists.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

Configurations made in BGP LS address family view apply only to the BGP LS routes and peers of the public network.

Examples

# In BGP instance view, create the BGP LS address family and enter its view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family link-state

[Sysname-bgp-default-ls]

advertise-rib-active

Use advertise-rib-active to enable BGP to advertise only the optimal BGP routes in the IP routing table.

Use undo advertise-rib-active to restore the default.

Syntax

advertise-rib-active

undo advertise-rib-active

Default

In BGP instance view, BGP advertises optimal routes in the BGP routing table, regardless of whether they are optimal in the IP routing table. In other views, the setting is the same as that in BGP instance view.

Views

BGP instance view

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

Predefined user roles

network-admin

Usage guidelines

The advertise-rib-active command does not apply to the following routes:

· Routes redistributed by the import-route command.

· Routes advertised by the network command.

· Default routes redistributed by the default-route imported command.

· VPNv4 routes.

· VPNv6 routes.

· IPv4 multicast routes.

· IPv6 multicast routes.

This command takes effect only on the routes generated after you execute this command. To apply this command to existing routes, use the reset bgp command to reset BGP sessions.

The setting in BGP unicast address family view applies when it is different from that in BGP instance view.

This command is mutually exclusive with the routing-table bgp-rib-only command.

Examples

# In BGP instance view, enable BGP to advertise optimal routes in the IP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] advertise-rib-active

aggregate

Use aggregate to create a summary route in the BGP routing table.

Use undo aggregate to remove a summary route.

Syntax

In BGP IPv4 unicast address family view/BGP-VPN IPv4 unicast address family view/BGP IPv4 multicast address family view:

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

undo aggregate ipv4-address { mask-length | mask }

In BGP IPv6 unicast address family view/BGP-VPN IPv6 unicast address family view/BGP IPv6 multicast address family view:

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

undo aggregate ipv6-address prefix-length

Default

No summary routes are configured.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

ipv4-address: Specifies an IPv4 summary address.

mask-length: Specifies a mask length for the IPv4 summary address, in the range of 0 to 32.

mask: Specifies a mask for the IPv4 summary address, in dotted decimal notation.

ipv6-address: Specifies an IPv6 summary address.

prefix-length: Specifies a prefix length for the IPv6 summary address, in the range of 0 to 128.

as-set: Enables the AS_PATH attribute of the summary route to contain the AS path information for all summarized routes. The AS_PATH attribute is of the AS_SET type that requires no sequence when arranging AS numbers. If you do not specify this keyword, the AS_PATH attribute of the summary route contains only the AS number of the local router.

attribute-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters, to set attributes for the summary route.

detail-suppressed: Advertises only the summary route. If you do not specify this keyword, BGP advertises both the summary route and the more specific routes.

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

suppress-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters, to filter more specific routes to be advertised. Routes permitted by the specified routing policy are not advertised. Routes denied by the specified routing policy are advertised.

Usage guidelines

This command creates a summary route. If the BGP routing table has routes whose destination addresses fall within the specified network, the summary route is added to the BGP routing table. For example, if two routes 10.1.1.0/24 and 10.1.2.0/24 exist in the BGP routing table, configuring the aggregate 10.1.0.0 16 command creates a summary route 10.1.0.0/16.

As from Release 6635, you can use this command for type 2 and type 5 BGP EVPN routes that have the same RD as that of the current VPN instance in BGP-VPN IPv4/IPv6 unicast address family view. For example, two type 5 routes 10.1.1.0/24 and 10.1.2.0/24 exist in the BGP EVPN routing table. Configuring the aggregate 10.1.0.0 16 command in BGP-VPN IPv4 unicast address family view creates a type 5 EVPN summary route 10.1.0.0/16. If you specify the detail-suppressed keyword, BGP does not advertise the detailed routes.

If the summarized routes have different ORIGIN attributes, the summary route selects the ORIGIN attribute in the sequence of INCOMPLETE, EGP, and IGP. For example, if the ORIGIN attributes of the summarized routes include INCOMPLETE and IGP, the ORIGIN attribute of the summary route is INCOMPLETE.

The COMMUNITY attribute of the summary route includes all the COMMUNITY (or extended community) attribute values if the routes have the following details:

· Summarized routes have different COMMUNITY (or extended community) attribute values.

· The summary route does not have the ATOMIC_AGGREGATE attribute.

Table 1 Functions of the keywords

Keywords	Function
as-set	Enables the summary route to carry the AS path information for all summarized routes. This feature can help avoid routing loops. However, if many routes are summarized and are changed frequently, do not specify this keyword. This configuration causes the summary route to flap with the more specific routes.
attribute-policy	Sets attributes except the AS-PATH attribute for the summary route. The peer route-policy command can achieve the same purpose. The attribute-policy and as-set keywords are mutually exclusive when they are used to modify the AS_PATH attribute for the summary route. Modifying the AS_PATH attribute of the summary route might cause routing loops.
detail-suppressed	Disables advertisement of all more specific routes. To disable advertisement of some more specific routes, use the suppress-policy keyword or the peer filter-policy command.
origin-policy	Summarizes only routes matching a routing policy. If the destination address of a route falls within the summary network but does not match the routing policy, the route is not summarized. It is not controlled by the detail-suppressed and suppress-policy keywords. There is no need to configure apply clauses for the routing policy applied by the origin-policy keyword because they do not take effect.
suppress-policy	Disables advertisement of some more specific routes filtered by a routing policy. The routing policy uses if-match clauses to filter routes. There is no need to configure apply clauses for the routing policy applied by the suppress-policy keyword because they do not take effect.

‌

Examples

# In BGP IPv4 unicast address family view, create summary route 1.1.0.0/16 in the BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] aggregate 1.1.0.0 255.255.0.0

Related commands

display bgp routing-table ipv4 multicast

display bgp routing-table ipv4 unicast

display bgp routing-table ipv6 multicast

display bgp routing-table ipv6 unicast

summary automatic

balance

Use balance to enable load balancing and set the maximum number of BGP ECMP routes for load balancing.

Use undo balance to disable load balancing.

Syntax

balance [ ebgp | eibgp | ibgp ] number

undo balance [ ebgp | eibgp | ibgp ]

Default

Load balancing is disabled.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

ebgp: Enables load balancing over EBGP routes.

eibgp: Enables load balancing between EBGP and IBGP routes.

ibgp: Enables load balancing over IBGP routes.

number: Specifies the maximum number of BGP ECMP routes for load balancing. When it is set to 1, load balancing is disabled. The value range for this argument varies by ECMP mode as follows:

· Normal mode/Enhanced mode: 1 to 128.

· Compressed mode: 1 to 32.

· Other modes: 1 to 64.

You can use the ecmp mode command to configure the ECMP mode.

Usage guidelines

Unlike IGP, BGP has no explicit metric for making load balancing decision. Instead, it implements load balancing by modifying route selection rules.

If multiple BGP routes destined for a network meet the following conditions, the device selects the specified number of routes for load balancing:

BGP uses the following load balancing criteria to determine load balanced routes:

· The routes have the same ORIGIN, LOCAL_PREF, and MED attributes.

· The routes meet the following requirements on the AS_PATH attribute:

¡ If the balance as-path-neglect command is configured, the routes can have different AS_PATH attributes.

¡ If only the balance as-path-relax command is configured, the routes can have different AS_PATH attributes, but the length of the AS_PATH attributes must be the same.

¡ If neither the balance as-path-neglect nor the balance as-path-relax command is configured, the routes must have the same AS_PATH attribute.

· The next hops of the routes meet the following requirements on IGP metrics:

¡ If the bestroute igp-metric-ignore command is not configured, the next hops of the routes must have the same IGP metric value.

¡ If the bestroute igp-metric-ignore command is configured, the next hops of the routes can have different IGP metric values.

· The routes have the same MPLS label assignment status (labeled or not labeled).

If you do not specify the ibgp, eibgp, or ebgp keyword, this command enables load balancing over EBGP routes and IBGP routes, but not between EBGP and IBGP routes.

The configuration of the balance eibgp number command can be removed only by executing the undo balance eibgp command.

After you execute the balance eibgp number command, the balance [ ebgp | ibgp ] number command cannot be executed; and vice versa.

Examples

# In BGP IPv4 unicast address family view, enable load balancing and set the maximum number of BGP ECMP routes used for load balancing to 2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] balance 2

Related commands

balance as-path-neglect

balance as-path-relax

bestroute igp-metric-ignore

balance as-path-neglect

Use balance as-path-neglect to enable BGP to ignore the AS_PATH attribute when it implements load balancing.

Use undo balance as-path-neglect to restore the default.

Syntax

balance as-path-neglect

undo balance as-path-neglect

Default

BGP does not ignore the AS_PATH attribute when it implements load balancing.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Usage guidelines

For BGP to implement load balancing over routes with different AS_PATH attributes, you must use this command together with the balance command.

After this command is executed, BGP ignores the AS_PATH attributes in the routes for load balancing and changes the attributes of the advertised routes to those of the optimal route. The operations might cause routing loops. Therefore, use this command with caution.

Examples

# In BGP IPv4 unicast address family view, enable BGP to ignore the AS_PATH attribute when it implements load balancing.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] balance as-path-neglect

Related commands

balance

balance as-path-relax

Use balance as-path-relax to enable load balancing for routes that have different AS_PATH attributes of the same length.

Use undo balance as-path-relax to restore the default.

Syntax

balance as-path-relax [ ebgp | ibgp ]

undo balance as-path-relax [ ebgp | ibgp ]

Default

BGP cannot perform load balancing for routes that have different AS_PATH attributes of the same length.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

ebgp: Enables load balancing for EBGP routes that have different AS_PATH attributes of the same length.

ibgp: Enables load balancing for IBGP routes that have different AS_PATH attributes of the same length.

Usage guidelines

For BGP to perform load balancing for routes with different AS_PATH attributes of the same length, you must use this command together with the balance command.

If you configure both the balance as-path-relax and balance as-path-neglect commands, the balance as-path-neglect command takes effect.

If you do not specify the ibgp or ebgp keyword when you execute this command, the following rules apply:

· BGP performs load balancing for EBGP routes that have different AS_PATH attributes of the same length.

· BGP performs load balancing for IBGP routes that have different AS_PATH attributes of the same length.

· BGP does not perform load balancing between EBGP and IBGP routes that have different AS_PATH attributes of the same length.

After this command is executed, BGP ignores the AS_PATH attributes in the routes for load balancing and changes the attributes of the advertised routes to those of the optimal route. This might cause routing loops. Therefore, use this command with caution.

Examples

# In BGP IPv4 unicast address family view, enable load balancing for EBGP routes that have different AS_PATH attributes of the same length.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] balance as-path-relax ebgp

bestroute as-path-neglect

Use bestroute as-path-neglect to configure BGP to ignore the AS_PATH attribute during optimal route selection.

Use undo bestroute as-path-neglect to restore the default.

Syntax

bestroute as-path-neglect

undo bestroute as-path-neglect

Default

BGP considers the AS_PATH attribute during optimal route selection.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Examples

# In BGP instance view, ignore AS_PATH during optimal route selection.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bestroute as-path-neglect

bestroute compare-med

Use bestroute compare-med to enable MED comparison for routes on a per-AS basis.

Use undo bestroute compare-med to restore the default.

Syntax

bestroute compare-med

undo bestroute compare-med

Default

MED comparison for routes on a per-AS basis is disabled.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Usage guidelines

By default, BGP does not compare MEDs for routes from the same AS. When a router learns a new route, it compares the route with the optimal route in its BGP routing table. If the new route is more optimal, it becomes the optimal route in the BGP routing table. In this way, route learning sequence might affect optimal route selection.

To solve the selection problem, the router puts routes received from the same AS into a group when the bestroute compare-med command is configured. The router then selects the route with the lowest MED from the same group, and compares routes from different groups.

Examples

# In BGP instance view, enable MED comparison for routes on a per-AS basis.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bestroute compare-med

bestroute igp-metric-ignore

Use bestroute igp-metric-ignore to configure BGP to ignore IGP metrics during optimal route selection.

Use undo bestroute igp-metric-ignore to restore the default.

Syntax

bestroute igp-metric-ignore

undo bestroute igp-metric-ignore

Default

BGP considers IGP metrics during optimal route selection, and selects the route with the smallest IGP metric as the optimal route.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Examples

# In BGP instance view, ignore IGP metrics during optimal route selection.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bestroute igp-metric-ignore

bestroute med-confederation

Use bestroute med-confederation to enable MED comparison for routes received from confederation peers.

Use undo bestroute med-confederation to restore the default.

Syntax

bestroute med-confederation

undo bestroute med-confederation

Default

MED comparison is disabled for routes received from confederation peers.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Usage guidelines

This command enables BGP to compare the MEDs of routes received from confederation peers. However, if a route from a confederation peer has an AS number that does not belong to the confederation, BGP does not compare the route with other routes. For example, a confederation has three AS numbers 65006, 65007, and 65009. BGP receives three routes from different confederation peers. The AS_PATH attributes of these routes are 65006 65009, 65007 65009, and 65008 65009, and the MED values of them are 2, 3, and 1. Because the third route's AS_PATH attribute contains AS number 65008, which does not belong to the confederation, BGP does not compare it with other routes. As a result, the first route becomes the optimal route.

Examples

# In BGP instance view, enable MED comparison for routes received from confederation peers.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bestroute med-confederation

bestroute ipv6-nexthop

Use bestroute ipv6-nexthop to enable BGP to prefer routes with an IPv6 next hop during optimal route selection.

Use undo bestroute ipv6-nexthop to restore the default.

Syntax

bestroute ipv6-nexthop

undo bestroute ipv6-nexthop

Default

BGP prefers routes with an IPv4 next hop during optimal route selection.

Views

BGP EVPN address family view

Predefined user roles

network-admin

Usage guidelines

Execute this command for the VXLAN packets in an EVPN network to be forwarded through IPv6 routes when both IPv4 and IPv6 routes exist.

Examples

# In BGP EVPN address family view, enable BGP to prefer routes with an IPv6 next hop during optimal route selection.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family l2vpn evpn

[Sysname-bgp-default-evpn] bestroute ipv6-nexthop

bestroute origin-as-validation

Use bestroute origin-as-validation to apply the BGP RPKI validation state to optimal route selection.

Use undo bestroute origin-as-validation to restore the default.

Syntax

bestroute origin-as-validation [ allow-invalid ]

undo bestroute origin-as-validation

Default

BGP ignores the BGP RPKI validation state during optimal route selection.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP VPNv4 address family view

BGP VPNv6 address family view

Predefined user roles

network-admin

Parameters

allow-invalid: Allows routes with a validation state of Invalid to participate in optimal route selection. If you do not specify this keyword, routes with a validation state of Invalid cannot participate in optimal route selection.

Usage guidelines

If multiple routes to the same destination are available, BGP first discards routes with unreachable next hops, and then selects the optimal route according to the following rules:

· Routes with a BGP RPKI validation state of Valid takes precedence over routes with a validation state of Not-found or Invalid.

· Routes with a BGP RPKI validation state of Not-found takes precedence over routes with a validation state of Invalid.

· Routes without a BGP RPKI validation state have the same priority as routes with a BGP RPKI validation state of Not-found.

Examples

# In BGP IPv4 unicast address family view, apply the BGP RPKI validation state to optimal route selection.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] bestroute origin-as-validation

bestroute router-id-ignore

Use bestroute router-id-ignore to configure BGP to ignore router IDs during optimal route selection.

Use undo bestroute router-id-ignore to restore the default.

Syntax

bestroute router-id-ignore

undo bestroute router-id-ignore

Default

By default, BGP compares router IDs during optimal route selection. If multiple routes to the same destination are available, BGP selects the route with the smallest router ID as the optimal route.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Examples

# In BGP instance view, configure BGP to ignore router IDs during optimal route selection.

<Sysname> system-view

[Sysname] bgp 1

[Sysname-bgp-default] bestroute router-id-ignore

Related commands

bestroute as-path-neglect

bestroute igp-metric-ignore

bgp

Use bgp to enable a BGP instance and enter its view.

Use undo bgp to disable a BGP instance.

Syntax

bgp as-number [ instance instance-name ]

undo bgp [ as-number [ instance instance-name ] ]

Default

BGP is disabled and no BGP instances exist.

Views

System view

Predefined user roles

network-admin

Parameters

as-number: Specifies a local AS by its number in the range of 1 to 4294967295.

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command enables the BGP instance default.

Usage guidelines

A router supports 4-byte AS number.

A BGP router can run multiple BGP processes. Each BGP process corresponds to a BGP instance. BGP maintains an independent routing table for each BGP instance.

You can create multiple public address families for a BGP instance. However, each public address family (except for public IPv4 unicast address family, public IPv6 unicast address family, public VPNv4 address family, and public VPNv6 address family) can belong to only one BGP instance.

You can create multiple VPN instances for a BGP instance, and each VPN instance can have multiple address families. A VPN instance can belong to only one BGP instance.

You cannot specify the same peer for the same address family of different BGP instances.

The IPv4 and IPv6 multicast address families must belong to the same BGP instance.

Different BGP instances can have the same AS number but cannot have the same name.

Examples

# Enable BGP instance default, set the local AS number to 100, and enter BGP instance view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default]

bgp apply-policy on-startup duration

Use bgp apply-policy on-startup duration to specify the period after reboot within which the startup policy is effective.

Use undo bgp apply-policy on-startup duration to restore the default.

Syntax

bgp apply-policy on-startup duration seconds

undo bgp apply-policy on-startup duration

Default

The startup policy does not take effect.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

seconds: Specifies the period after reboot within which the startup policy is effective, in the range of 0 to 3600 seconds. The number of 0 indicates that the startup policy is effective permanently.

Usage guidelines

This command allows BGP to send route updates with the attribute values specified in the startup policy within the specified period after reboot. Then, BGP can forward traffic through other devices to avoid traffic loss caused by reboot.

Examples

# In BGP instance view, set the period after reboot to 100 seconds within which the startup policy is effective.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bgp apply-policy on-startup duration 100

Related commands

bgp policy on-startup med

Use bgp policy on-startup med to set the MED attribute value in the startup policy.

Use undo bgp policy on-startup med to restore the default.

Syntax

bgp policy on-startup med med-value

undo bgp policy on-startup med

Default

The MED attribute value in the startup policy is 4294967295.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

med-value: Specifies the MED attribute value in the startup policy, in the range of 0 to 4294967295.

Usage guidelines

After you configure this command, BGP uses the specified MED attribute value to send route updates within the specified period after reboot.

Examples

# In BGP instance view, set the MED attribute value in the startup policy to 100.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bgp policy on-startup med 100

Related commands

bgp apply-policy on-startup

bgp update-delay on-startup

Use bgp update-delay on-startup to configure BGP to delay sending route updates when it restores after a device reboot.

Use undo bgp update-delay on-startup to restore the default.

Syntax

bgp update-delay on-startup seconds

undo bgp update-delay on-startup

Default

BGP sends route updates immediately to BGP peers in established state when it restores after a device reboot.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

seconds: Specifies the delay time in the range of 0 to 3600 seconds. The value of 0 indicates that BGP does not send any route updates after the device reboots.

Usage guidelines

With this feature enabled, BGP delays sending route updates when it restores after a device reboot. During the delay time, BGP learns all routes from other neighbors, and then selects the optimal route. After the delay time elapses, BGP will advertise the optimal route. Using this feature can reduce traffic loss caused by device reboot.

Examples

# In BGP instance view, configure BGP to delay sending route updates when it restores after a device reboot, and set the delay time to 100 seconds.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bgp update-delay on-startup 100

Related commands

bgp update-delay on-startup prefix-list

Use bgp update-delay on-startup prefix-list to configure BGP to immediately send route updates for routes that match an IPv4 prefix list.

Use undo bgp update-delay on-startup prefix-list to restore the default.

Syntax

bgp update-delay on-startup prefix-list ipv4-prefix-list-name

undo bgp update-delay on-startup prefix-list

Default

No IPv4 prefix list is specified to filter routes.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

ipv4-prefix-list-name: Specifies an IPv4 prefix list by its name, a case-sensitive string of 1 to 63 characters.

Usage guidelines

After the bgp update-delay on-startup command is configured, BGP delays sending updates for all routes when it restores after a device reboot. For BGP to immediately send updates for the specified routes, execute the bgp update-delay on-startup prefix-list command.

Examples

# In BGP instance view, configure BGP to send updates 100 seconds after it restores from a device reboot, and immediately send updates for routes that match IPv4 prefix list aaa.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bgp update-delay on-startup 100

[Sysname-bgp-default] bgp update-delay on-startup prefix-list aaa

Related commands

bgp update-delay on-startup

bgp update-delay on-startup ipv6-prefix-list

Use bgp update-delay on-startup ipv6-prefix-list to configure BGP to immediately send route updates for routes that match an IPv6 prefix list.

Use undo bgp update-delay on-startup ipv6-prefix-list to restore the default.

Syntax

bgp update-delay on-startup ipv6-prefix-list ipv6-prefix-list-name

undo bgp update-delay on-startup ipv6-prefix-list

Default

No IPv6 prefix list is specified to filter routes.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

ipv6-prefix-list-name: Specifies an IPv6 prefix list by its name, a case-sensitive string of 1 to 63 characters.

Usage guidelines

Examples

# In BGP instance view, configure BGP to send updates 100 seconds after it restores from a device reboot, and immediately send updates for routes that match IPv6 prefix list bbb.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bgp update-delay on-startup 100

[Sysname-bgp-default] bgp update-delay on-startup ipv6-prefix-list bbb

Related commands

bgp update-delay on-startup

bgp update-delay wait-other-protocol

Use bgp update-delay wait-other-protocol to configure the time that BGP must wait for other protocols to complete GR or NSR after BGP completes GR or NSR.

Use undo bgp update-delay wait-other-protocol to restore the default.

NOTE:

This command is supported only in Release 6635 and later.

Syntax

bgp update-delay wait-other-protocol seconds

undo bgp update-delay wait-other-protocol

Default

After BGP completes GR or NSR, it must wait a maximum of 300 seconds for other protocols to complete GR or NSR.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

seconds: Specifies the time that BGP must wait for other protocols to complete GR or NSR after BGP completes GR or NSR. The value range is 60 to 1200 seconds.

Usage guidelines

After BGP completes GR or NSR, it advertises the updated routes. If the routes rely on other protocols, for example, redistributed OSPF routes, BGP starts a wait timer for the other protocols to complete GR or NSR. This ensures that incorrect and unreachable routes are not advertised. When the following conditions exist, BGP might advertise incomplete routes after completing GR or NSR:

· The routes rely on other protocols.

· BGP maintains a large amount of routing information. In this case, BGP and the protocols take a long time to complete GR or NSR.

For BGP to correctly advertise the routes after BGP and the protocols complete GR or NSR, set a larger wait timer for BGP.

Examples

# Configure BGP to wait a maximum of 600 seconds for other protocols to complete GR or NSR after BGP completes GR or NSR.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bgp update-delay wait-other-protocol 600

Related commands

bgp update-delay on-startup

bmp server

Use bmp server to create a BGP monitoring protocol (BMP) server and enter BMP server view.

Use undo bmp server to remove a BMP server and all its configurations.

Syntax

bmp server server-number

undo bmp server server-number

Default

No BMP servers exist.

Views

System view

Predefined user roles

network-admin

Parameters

server-number: Specifies a BMP server by its number in the range of 1 to 8.

Examples

# Create BMP server 5 and enter its view.

<Sysname> system-view

[Sysname] bmp server 5

[Sysname-bmpserver-5]

check-origin-validation

Use check-origin-validation to enable BGP RPKI validation.

Use undo check-origin-validation to disable BGP RPKI validation.

Syntax

check-origin-validation

undo check-origin-validation

Default

BGP RPKI validation is disabled.

Views

BGP RPKI view

Predefined user roles

network-admin

Usage guidelines

This command enables BGP to validate the prefix and origin AS number of a received route and place the route to one of the following validation states:

· Not-found—No ROA matches the prefix.

· Valid—One or multiple ROAs match both the prefix and origin AS number.

· Invalid—One or multiple ROAs match the prefix, but none of these ROAs matches the origin AS number.

You can configure a routing policy to filter routes based on the BGP RPKI validation state.

Examples

# Enable BGP RPKI validation.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] rpki

[Sysname-bgp-default-rpki] check-origin-validation

compare-different-as-med

Use compare-different-as-med to enable MED comparison for routes from peers in different ASs.

Use undo compare-different-as-med to restore the default.

Syntax

compare-different-as-med

undo compare-different-as-med

Default

MED comparison is disabled for routes from peers in different ASs.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Usage guidelines

If multiple routes to a destination exist, the route with the smallest MED is selected.

Do not use this command unless relevant ASs adopt the same IGP protocol and routing selection method.

Examples

# In BGP instance view, enable MED comparison for routes from peers in different ASs.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] compare-different-as-med

confederation id

Use confederation id to configure a confederation ID.

Use undo confederation id to restore the default.

Syntax

confederation id as-number

undo confederation id

Default

No confederation ID is configured.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

as-number: Specifies an AS number that identifies the confederation, in the range of 1 to 4294967295.

Usage guidelines

You can split an AS into several sub-ASs, and each sub-AS remains fully meshed. These sub-ASs form a confederation. Key path attributes of a route, such as the Next_HOP, MED, and LOCAL_PREF, are not discarded when crossing each sub-AS. The sub-ASs still look like one AS from the perspective of other ASs. The AS number is the confederation ID.

Confederation can ensure the integrity of the former AS, and solve the problem of too many IBGP connections in the AS.

Configure the same confederation ID for all routers in one confederation.

For a non-confederation BGP router that establishes a BGP connection to a router in a confederation, the confederation ID is the AS number of the router.

Examples

# Confederation 9 consists of four sub-ASs numbered 38, 39, 40 and 41. Peer 10.1.1.1 is a member of sub-AS 38. Peer 200.1.1.1 is a member outside of confederation 9, which belongs to AS 98. Confederation 9 looks like one AS (with AS number 9) from the perspective of peer 200.1.1.1. This example uses a router in sub-AS 41.

<Sysname> system-view

[Sysname] bgp 41

[Sysname-bgp-default] confederation id 9

[Sysname-bgp-default] confederation peer-as 38 39 40

[Sysname-bgp-default] group Confed38 external

[Sysname-bgp-default] peer Confed38 as-number 38

[Sysname-bgp-default] peer 10.1.1.1 group Confed38

[Sysname-bgp-default] group Remote98 external

[Sysname-bgp-default] peer Remote98 as-number 98

[Sysname-bgp-default] peer 200.1.1.1 group Remote98

Related commands

confederation nonstandard

confederation peer-as

confederation nonstandard

Use confederation nonstandard to enable compatibility with routers not compliant with RFC 3065 in the confederation.

Use undo confederation nonstandard to restore the default.

Syntax

confederation nonstandard

undo confederation nonstandard

Default

The device is compatible with only routers compliant with RFC 3065 in the confederation.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

Configure this command on all routers compliant with RFC 3065 to interact with those routers not compliant with RFC 3065 in the confederation.

Examples

# Confederation 100 consists of two sub-ASs, 64000 and 65000, and contains routers not compliant with RFC 3065. Enable compatibility with routers not compliant with RFC 3065 in the confederation.

<Sysname> system-view

[Sysname] bgp 64000

[Sysname-bgp-default] confederation id 100

[Sysname-bgp-default] confederation peer-as 65000

[Sysname-bgp-default] confederation nonstandard

Related commands

confederation id

confederation peer-as

Use confederation peer-as to specify confederation peer sub-ASs.

Use undo confederation peer-as to remove the specified confederation peer sub-ASs.

Syntax

confederation peer-as as-number-list

undo confederation peer-as [ as-number-list ]

Default

No confederation peer sub-ASs are specified.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

as-number-list: Specifies a sub-AS number list. A maximum of 32 sub-ASs can be configured in one command line. The expression is as-number-list = as-number &<1-32>. The as-number argument specifies a sub-AS number in the range of 1 to 4294967295, and &<1-32> indicates that a maximum of 32 numbers can be specified.

Usage guidelines

Before this configuration, use the confederation id command to specify the confederation ID for the sub-ASs.

If the undo confederation peer-as command is executed without the as-number-list argument, all confederation peer sub-ASs are removed.

Examples

# In BGP instance view, specify confederation peer sub-ASs 2000 and 2001.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] confederation id 10

[Sysname-bgp-default] confederation peer-as 2000 2001

Related commands

confederation id

confederation nonstandard

dampening

Use dampening to enable BGP route dampening.

Use undo dampening to restore the default.

Syntax

dampening [ half-life-reachable half-life-unreachable reuse suppress ceiling | route-policy route-policy-name ] *

undo dampening

Default

Route dampening is disabled.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

half-life-reachable: Specifies a half-life for active routes, in the range of 1 to 45 minutes. By default, the value is 15 minutes.

half-life-unreachable: Specifies a half-life for suppressed routes, in the range of 1 to 45 minutes. By default, the value is 15 minutes.

reuse: Specifies a reuse threshold value for suppressed routes, in the range of 1 to 20000. A suppressed route whose penalty value decreases under the value is reused. By default, the reuse value is 750. The reuse threshold must be less than the suppression threshold.

suppress: Specifies a suppression threshold in the range of 1 to 20000. The route with a penalty value greater than the threshold is suppressed. The default value is 2000.

ceiling: Specifies a ceiling penalty value in the range of 1001 to 20000. The value must be greater than the suppress value. By default, the value is 16000.

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

Usage guidelines

This command dampens only EBGP routes.

If an EBGP peer goes down after you configure this command, routes coming from the peer are dampened but not deleted.

Examples

# In BGP IPv4 unicast address family view, configure BGP route dampening. Set the half-life for both active and suppressed routes to 10 minutes, the reuse threshold to 1000, the suppression threshold to 2000, and the ceiling penalty to 10000.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] dampening 10 10 1000 2000 10000

Related commands

display bgp dampening parameter

default local-preference

Use default local-preference to configure a default local preference.

Use undo default local-preference to restore the default.

Syntax

default local-preference value

undo default local-preference

Default

The default local preference is 100.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

value: Specifies a default local preference in the range of 0 to 4294967295. A larger value represents a higher preference.

Usage guidelines

You can also use the apply local-preference command in a routing policy to configure the local preference for BGP routes. If no routing policy is configured, all BGP routes use the local preference set by the default local-preference command. If a routing policy is configured, BGP routes matching the routing policy use the local preference set by the apply local-preference command. Other BGP routes use the local preference set by the default local-preference command.

Examples

# In BGP IPv4 unicast address family view, set the default local preference to 180.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] default local-preference 180

Related commands

apply local-preference

route-policy

default med

Use default med to specify a default MED value.

Use undo default med to restore the default.

Syntax

default med med-value

undo default med

Default

The default MED value is 0.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

med-value: Specifies the default MED value in the range of 0 to 4294967295.

Usage guidelines

BGP selects a MED value in the following order:

1. MED set by the apply cost command.

2. MED set by the med keyword in the import-route command.

3. MED set by the default med command.

4. Original MED of a BGP route, or MED changed from the metric of a redistributed IGP route.

Examples

# In BGP IPv4 unicast address family view, set the default MED to 25.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] default med 25

Related commands

apply cost

import-route

route-policy

default-route imported

Use default-route imported to enable default route redistribution into the BGP routing table.

Use undo default-route imported to restore the default.

Syntax

default-route imported

undo default-route imported

Default

Default route redistribution into the BGP routing table is disabled.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Usage guidelines

By default, BGP does not redistribute default IGP routes. To redistribute default IGP routes into the BGP routing table, you must use the default-route imported command together with the import-route command.

Examples

# In BGP IPv4 unicast address family view, enable default route redistribution from OSPF process 1 into the BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] default-route imported

[Sysname-bgp-default-ipv4] import-route ospf 1

Related commands

import-route

default-route update-first

Use default-route update-first to configure BGP to send withdrawal messages of the default route prior to other routes.

Use undo default-route update-first to restore the default.

Syntax

default-route update-first

undo default-route update-first

Default

BGP does not send withdrawal messages of the default route prior to other routes.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

Typically a BGP router does not send withdrawal messages of the default route prior to other routes to its peers. If the peer relationship is down, the default route cannot be withdrawn first. Traffic interruption might occur. Use this command to configure BGP to send the withdrawal messages of the default route prior to other routes. This can reduce the traffic interruption time when the peer relationship is down.

Examples

# In BGP instance view, configure BGP to send withdrawal messages of the default route prior to other routes.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] default-route update-first

display bgp bmp server

Use display bgp bmp server to display BMP server information.

Syntax

display bgp [ instance instance-name ] bmp server server-number

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BMP server information for the default BGP instance.

server-number: Specifies a BMP server by its number in the range of 1 to 8.

Examples

# Display information about BMP server 1.

<Sysname> display bgp bmp server 1

BMP server number: 1

Server VPN instance name: vpna

Server address: 100.1.1.1 Server port: 6895

Client address: 100.1.1.2 Client port: 21452

BMP server state: Connected Up for 00h41m53s

TCP source interface has been configured

Message statistics:

Total messages sent: 15

INITIATION: 1

TERMINATION: 0

STATS-REPORT: 0

PEER-UP: 4

PEER-DOWN: 3

ROUTE-MON: 7

BMP monitor BGP peers:

10.1.1.1

Table 2 Command output

Field	Description
Server VPN instance name	Name of the VPN instance to which the BMP server belongs. If the VPN instance has been deleted, this field displays (Deleted). If the BMP server belongs to the public network, this field displays --.
Server address	IP address of the BMP server used by the TCP connection to the BMP client.
Server port	Port number of the BMP server used by the TCP connection to the BMP client.
Client address	IP address of the BMP client used by the TCP connection to the BMP server.
Client port	Port number of the BMP client used by the TCP connection to the BMP server.
BMP server current state	TCP connection status: · Connected. · Not connected.
Up for	Duration of the TCP connection.
TCP source interface has been configured	Source interface of TCP connections to the BMP server.
Total messages sent	Number of messages that BGP sends to the BMP server.
INITIATION	Number of initiation messages that BGP sends to the BMP server.
TERMINATION	Number of termination messages that BGP sends to the BMP server.
STATS-REPORT	Number of statistics messages that BGP sends to the BMP server.
PEER-UP	Number of peer-up messages that BGP sends to the BMP server.
PEER-DOWN	Number of peer-down messages that BGP sends to the BMP server.
ROUTE-MON	Number of route monitoring messages that BGP sends to the BMP server.
BMP monitor BGP peers	Peers that are monitored by the BMP server.

‌

Related commands

reset bgp bmp server statistics

display bgp dampening parameter

Use display bgp dampening parameter to display BGP route dampening parameters.

Syntax

display bgp [ instance instance-name ] dampening parameter { ipv4 | ipv6 } [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP route dampening parameters for the default BGP instance.

ipv4: Displays BGP IPv4 route dampening parameters.

ipv6: Displays BGP IPv6 route dampening parameters.

multicast: Displays BGP multicast route dampening parameters.

unicast: Displays BGP unicast route dampening parameters.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays BGP route dampening parameters for the public network.

Usage guidelines

By default, the unicast keyword is used if neither the multicast keyword nor the unicast keyword is specified.

Examples

# Display BGP IPv4 unicast route dampening parameters.

<Sysname> display bgp dampening parameter ipv4

Maximum suppression time (in seconds) : 3973

Ceiling value : 16000

Reuse value : 750

Half-life time for reachable routes (in seconds) : 900

Half-life time for unreachable routes (in seconds) : 900

Suppression threshold : 2000

Table 3 Command output

Field	Description
Maximum suppression time	Maximum time (in seconds) for the penalty value to decrease from the ceiling value to the reuse value.
Ceiling value	Penalty ceiling value.
Reuse value	Reuse threshold.

‌

Related commands

dampening

display bgp group

Use display bgp group to display BGP peer group information.

Syntax

display bgp [ instance instance-name ] group ipv4 [ mdt | multicast | rtfilter | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ group-name group-name ]

display bgp [ instance instance-name ] group ipv6 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ group-name group-name ]

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

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

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

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

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

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP peer group information for the default BGP instance.

ipv4: Displays IPv4 BGP peer group information.

ipv6: Displays IPv6 BGP peer group information.

link-state: Displays BGP LS peer group information.

mdt: Displays BGP MDT peer group information.

multicast: Displays BGP multicast peer group information.

rtfilter: Displays BGP IPv4 RT filter peer group information.

unicast: Displays BGP unicast peer group information.

vpnv4: Displays BGP VPNv4 peer group information.

l2vpn: Displays BGP L2VPN peer group information.

evpn: Displays BGP EVPN peer group information.

vpnv6: Displays BGP VPNv6 peer group information.

dedicate: Displays BGP dedicated peer group information.

group-name group-name: Specifies a BGP peer group by its name, a case-sensitive string of 1 to 47 characters. If you do not specify a group, this command displays brief information about all BGP peer groups for the specified address family.

Usage guidelines

By default, the unicast keyword is used if the unicast, multicast, and mdt keywords are not specified.

Examples

# Display brief information about all BGP IPv4 unicast peer groups.

BGP peer group: group1

Remote AS: 600

Type: external

Members:

1.1.1.10

BGP peer group: group2

Remote AS number: not specified

Type: external

Members:

2.2.2.2

# Display detailed information about BGP IPv4 unicast peer group group1.

<Sysname> display bgp group ipv4 group-name group1

BGP peer group: group1

Remote AS: 600

Type: external

Maximum number of prefixes allowed: 4294967295

Threshold: 75%

Configured hold time: 180 seconds

Keepalive time: 60 seconds

Minimum time between advertisements: 30 seconds

Peer preferred value: 0

Site-of-Origin: Not specified

Routing policy configured:

No routing policy is configured

Members:

* - Dynamically created peer

Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State

1.1.1.10 600 0 0 0 0 00:00:55 Established

# Display detailed information about BGP IPv6 unicast peer group group2.

<Sysname> display bgp group ipv6 group-name group2

BGP peer group: group2

Remote AS: 600

Type: external

Maximum number of prefixes allowed: 4294967295

Threshold: 75%

Configured hold time: 180 seconds

Keepalive time: 60 seconds

Minimum time between advertisements: 30 seconds

Peer preferred value: 0

IPsec profile name: profile001

Site-of-Origin: Not specified

Routing policy configured:

No routing policy is configured

Members:

* - Dynamically created peer

Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State

2::2 600 0 0 0 0 00:00:45 Established

3::3 600 0 0 0 0 00:00:40 Established

Table 4 Command output

Field	Description
BGP peer group	Name of the BGP peer group.
Remote AS	AS number of the peer group.
Type	Type of the peer groups: · external—EBGP peer group. · internal—IBGP peer group.
Maximum number of prefixes allowed	Maximum number of routes allowed to learn from the peer.
Threshold	Percentage of received routes from the peer to maximum routes allowed to learn from the peer. If the percentage is reached, the system generates a log message.
Configured hold time	Configured hold interval in seconds.
Keepalive time	Keepalive interval in seconds.
Minimum time between advertisements	Minimum route advertisement interval in seconds.
Peer preferred value	Preferred value specified for routes from the peer.
Site-of-Origin	SoO for the peer group.
Routing policy configured	Routing policy configured for the peer group. If you do not specify a routing policy, this field displays No routing policy is configured.
Members	Information about peers included in the peer group.
* - Dynamically created peer	An asterisk (*) before a peer address indicates that the peer is a dynamic peer.
Peer	IPv4 or IPv6 address of the peer.
AS	AS number of the peer.
MsgRcvd	Number of messages received.
MsgSent	Number of messages sent.
OutQ	Number of messages to be sent.
PrefRcv	For the IPv4, IPv6, VPNv4, and VPNv6 address families, this field displays the number of prefixes received from the peer. For the IPv4 MDT address family, this field displays the number of MDT messages received from the peer.
Up/Down	Lasting time of the current BGP session state.
State	Current state of the BGP session between the local router and the peer.
IPsec profile name	IPsec profile applied to the IPv6 BGP peer group.

‌

display bgp instance-info

Use display bgp instance-info to display information about all BGP instances.

Syntax

display bgp instance-info

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display information about all BGP instances.

<Sysname> display bgp instance-info

Total BGP instances: 3

BGP instance name AS

BGP1 100

BGP2 200

BGP3 300

Table 5 Command output

Field	Description
Total BGP instances	Number of BGP instances.
BGP instance name	BGP instance name.
AS	AS number of the BGP instance.

‌

display bgp link-state

Use display bgp link-state to display BGP LS information.

Syntax

display bgp [ instance instance-name ] link-state [ ls-prefix [ advertise-info ] | peer { ipv4-address | ipv6-address } { advertised | received } [ statistics ] | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP LS information for the default BGP instance.

advertise-info: Displays advertisement information for the specified LS prefix.

ls-prefix: Specifies an LS prefix. If you do not specify this argument, the command displays all BGP LS information.

ipv4-address: Specifies a peer by its IPv4 address.

ipv6-address: Specifies a peer by its IPv6 address.

advertised: Displays advertised LS information.

received: Displays received LS information.

statistics: Displays statistics about LS messages.

Usage guidelines

If you do not specify any parameters, this command displays brief BGP LS information.

Examples

# Display brief BGP LS information for the public network.

<Sysname> display bgp link-state

Total number of routes: 2

BGP local router ID is 1.1.2.1

Status codes: * - valid, > - best, d – dampened, h – history,

s – suppressed, S – stale, i - internal, e - external

a - additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Prefix codes: E link, V node, T IP reachable route, u/U unknown,

I Identifier, N local node, R remote node, L link, P prefix,

L1/L2 ISIS level-1/level-2, O OSPF, D direct, S static, B BGP

a area-ID, , l link-ID, t topology-ID, s ISO-ID,

c confed-ID/ASN, b bgp-identifier, r router-ID,

i if-address, n peer-address, o OSPF Route-type, p IP-prefix

d designated router address

* >e Network : [V][O][I0x0][N[c20][b1.1.1.2][a0.0.0.0][r1.1.1.2]]/376

NextHop : 1.1.1.2 LocPrf :

PrefVal : 0 OutLabel : NULL

MED :

Path/Ogn: 20i

* >e Network : [T][O][I0x0][N[c20][b1.1.1.2][a0.0.0.0][r1.1.1.2]][P[o0x1][p1.1.1.0/24]]/480

NextHop : 1.1.1.2 LocPrf :

PrefVal : 0 OutLabel : NULL

MED :

Path/Ogn: 20i

Table 6 Command output

Field	Description
Status codes	Status codes: · * – valid—Valid route. · > – best—Optimal route. · d - dampened—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – stale—Stale route. · i – internal—Internal route. · e – external—External route. · a - additional-path—Add-Path optimal route.
Prefix codes	Route status codes: · B – BGP. · E – link. · V – node. · T – IP reachable route. · u/U – unknown. · I – Identifier. · N – local node. · R – remote node. · L – link. · P – prefix. · L1/L2 – ISIS level-1/level-2. · O – OSPF. · D – direct. · S – static. · a – area-ID. · l – link-ID. · t – topology-ID. · s – ISO-ID. · c – confed-ID/ASN. · b – bgp-identifier. · r – router-ID. · i – if-address. · n – peer-address. · o – OSPF Route-type. · p – IP-prefix. · d – designated router address. · a - additional-path.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP. · e – EGP—Learned through EGP. · ? – incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.
Network	NLRI for the LS.
NextHop	Next hop IP address.
LocPrf	Local preference.
OutLabel	Outgoing label of the route.
MED	MED attribute.
Path/Ogn	AS_PATH and ORIGIN attributes of the route: · AS_PATH—Records the ASs the route has passed, which avoids routing loops. · ORIGIN—Identifies the origin of the route.

‌

# Display detailed BGP LS information with the specified LS prefix.

<Sysname> display bgp link-state [V][O][I0x0][N[c20][b1.1.1.2][a0.0.0.0][r1.1.1.2]]/376

BGP local router ID: 1.1.1.2

Local AS number: 20

Paths: 1 available, 1 best

BGP LS information of [V][O][I0x0][N[c20][b1.1.1.2][a0.0.0.0][r1.1.1.2]]/376:

Imported route.

Original nexthop: 0.0.0.0

OutLabel : NULL

RxPathID : 0x0

TxPathID : 0xffffffff

LS : Node flag bits: 30[EA]

AS-path : (null)

Origin : igp

Attribute value : pref-val 32768

State : valid, local, best

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

Table 7 Command output

Field	Description
Paths	Number of routes: · available—Number of valid routes. · best—Number of optimal routes.
BGP LS information of	NLRI prefix.
Original nexthop	Original next hop of the route. If the route was obtained from a BGP update message, the original next hop is the next hop IP address in the message.
LS	LS attribute: · Node flag bits—Node attribute in hexadecimal format: ¡ 10[A]—OSPF ABR bit. ¡ 30[E]—OSPF External bit. · Metric—Link or prefix cost.
RxPathID	Add-path ID of received routes.
TxPathID	Add-path ID of advertised routes.
AS-path	AS_PATH attribute of the route, which records the ASs the route has passed and avoids routing loops.
Attribute value	BGP path attributes: · MED—MED value. · localpref—Local preference value. · pref-val—Preferred value. · pre—Route preference.
State	Current state of the route: · valid. · internal. · external. · local. · synchronize. · best.
IP precedence	IP precedence in the range of 0 to 7. N/A indicates that the route does not support this field.
QoS local ID	QoS local ID in the range of 1 to 4095. N/A indicates that the route does not support this field.
Traffic index	Traffic index in the range of 1 to 64. N/A indicates that the route does not support this field.

‌

# Display advertisement information for the specified LS prefix.

<Sysname> display bgp link-state [E][B][I0x0][N[r1.1.1.2]][c65008][R[r44.33.22.11]][c65009]][L[i2.1.1.3][n1.1.1.3]]/536 advertise-info

BGP local router ID: 1.1.1.2

Local AS number: 65008

Paths: 1 best

BGP LS information of [E][B][I0x0][N[r1.1.1.2]][c65008][R[r44.33.22.11]][c65009]][L[i2.1.1.3][n1.1.1.3]]/536

(TxPathID:0):

Advertised to peers (1 in total):

10.1.1.2

LS attribute :

Peer node segment identifier : Flag c0[VL], Metric 0, Label 23001

Table 8 Command output

Field	Description
Paths	Number of routes: · available—Number of valid routes. · best—Number of optimal routes.
BGP LS information of	NLRI prefix.
Advertised to peers (1 in total)	Peers to which the information has been advertised, and the total number of such peers.
Peer node segment identifier	Peer node SID: · Flag c0[VL]: ¡ V—Value flag. If set, the SID carries a label value. ¡ L—Local flag. If set, the SID has local significance. · Metric—Link cost. · Label—Label value.
TxPathID	Add-path ID of advertised routes.

‌

display bgp network

Use display bgp network to display information about routes advertised by the network command and shortcut routes configured by the network short-cut command.

Syntax

display bgp [ instance instance-name ] network { ipv4 | ipv6 } [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays information for the default BGP instance.

ipv4: Displays IPv4 address family information.

ipv6: Displays IPv6 address family information.

multicast: Displays BGP multicast address family information.

unicast: Displays BGP unicast address family information.

Usage guidelines

By default, the unicast keyword is used if neither the multicast keyword nor the unicast keyword is specified.

Examples

# Display information about routes advertised by the network command and shortcut routes configured by the network short-cut command in the IPv4 unicast address family.

<Sysname> display bgp network ipv4

BGP local router ID: 192.168.1.135

Local AS number: 100

Network Mask Route-policy Short-cut

20.1.1.0 255.255.255.0 No

40.1.1.0 255.255.255.0 abc No

30.1.1.0 255.255.255.0 Yes

# Display information about routes advertised by the network command and shortcut routes configured by the network short-cut command in the IPv6 unicast address family.

<Sysname> display bgp network ipv6

BGP local router ID: 192.168.1.135

Local AS number: 100

Network PrefixLen Route-policy Short-cut

1:: 24 No

2:: 24 No

3:: 64 policy1 No

2:: 24 Yes

Table 9 Command output

Field	Description
Network	Destination network address of the routes advertised by the network command and the shortcut routes.
Mask	Mask of the destination network address.
PrefixLen	Prefix length of the destination network address.
Route-policy	Routing policy that is applied to the route.
Short-cut	Whether the route is a shortcut route: · Yes. · No.

‌

display bgp non-stop-routing status

Use display bgp non-stop-routing status to display BGP NSR status information.

Syntax

display bgp [ instance instance-name ] non-stop-routing status

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP NSR status information for the default BGP instance.

Examples

# Display BGP NSR status information.

<Sysname> display bgp non-stop-routing status

BGP NSR status: Not ready

Location of preferred standby process: -

TCP NSR status: Not ready

Table 10 Command output

Field	Description
BGP NSR status	BGP NSR status: · Ready—BGP NSR has backed up BGP neighbor and routing information from the active process to the standby process. In this state, BGP NSR can ensure continuous routing when an active/standby process switchover occurs. · Not ready—BGP NSR is backing up BGP neighbor and routing information from the active process to the standby process. If an active/standby process switchover occurs in this state, traffic is interrupted and the BGP session will be re-established. · Not configured—BGP NSR is disabled.
Location of preferred standby process	ID of the IRF member device where the preferred standby process resides. This field displays - if no standby processes exist.
TCP NSR status	TCP NSR status: · Ready—TCP NSR has backed up TCP connection information from the active process to the standby process. · Not ready—TCP NSR is backing up TCP connection information from the active process to the standby process.

‌

display bgp paths

Use display bgp paths to display BGP path attribute information.

Syntax

display bgp [ instance instance-name ] paths [ as-regular-expression ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP path attribute information for the default BGP instance.

as-regular-expression: Displays information about BGP path attributes whose AS_PATH attribute matches the specified regular expression. The as-regular-expression argument is a string of 1 to 256 characters. If you do not specify this argument, the command displays information about all BGP path attributes.

Examples

# Display information about all BGP path attributes.

<Sysname> display bgp paths

RefCount MED Path/Origin

3 0 ?

2 0 100i

3 0 100i

1 0 ?

Table 11 Command output

Field	Description
RefCount	Number of BGP routes with these path attributes.
MED	MULTI_EXIT_DISC attribute.
Path/Origin	AS_PATH and ORIGIN attributes of the route: · AS_PATH attribute—Records the ASs the route has passed, which avoids routing loops. · ORIGIN attribute—Identifies the origin of the route: ¡ i—Originated in the AS. The origin of routes advertised with the network command is IGP. ¡ e—Learned through EGP. ¡ ?—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.

‌

display bgp peer

Use display bgp peer to display BGP peer or peer group information.

Syntax

display bgp [ instance instance-name ] peer ipv4 [ mdt | multicast | rtfilter | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ ipv4-address mask-length | { ipv4-address | group-name group-name } log-info | [ ipv4-address ] verbose ]

display bgp [ instance instance-name ] peer ipv6 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ ipv6-address prefix-length | { ipv6-address | link-local-address interface interface-type interface-number | group-name group-name } log-info | [ ipv6-address | link-local-address interface interface-type interface-number ] verbose ]

display bgp [ instance instance-name ] peer ipv6 [ unicast ] [ ipv4-address mask-length | ipv4-address log-info | [ ipv4-address ] verbose ]

display bgp [ instance instance-name ] peer ipv4 [ unicast ] [ ipv6-address prefix-length | ipv6-address log-info | [ ipv6-address ] verbose ]

display bgp [ instance instance-name ] peer { ipv4 | ipv6 } [ unicast ] vpn-instance-all [ verbose ]

display bgp [ instance instance-name ] peer link-state [ ipv4-address mask-length | ipv6-address prefix-length | { ipv4-address | ipv6-address | group-name group-name } log-info | [ ipv4-address | ipv6-address ] verbose ]

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

display bgp [ instance instance-name ] peer l2vpn [ ipv4-address mask-length | { ipv4-address | group-name group-name } log-info | [ ipv4-address ] verbose ]

display bgp [ instance instance-name ] peer l2vpn evpn [ ipv4-address mask-length | ipv6-address prefix-length | { ipv4-address | ipv6-address | group-name group-name } log-info | [ ipv4-address | ipv6-address ] verbose ]

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

display bgp [ instance instance-name ] peer dedicated [ { ipv4-address mask-length | ipv6-address prefix-length } | { ipv4-address | ipv6-address | group-name group-name } log-info | [ ipv4-address | ipv6-address ] verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP peer or peer group information for the default BGP instance.

ipv4: Displays information about a BGP peer or peer group in IPv4 address family.

ipv6: Displays information about a BGP peer or peer group in IPv6 address family.

link-state: Displays BGP LS peer or peer group information.

vpnv4: Displays BGP VPNv4 peer or peer group information.

l2vpn: Displays BGP L2VPN peer or peer group information.

evpn: Displays BGP EVPN peer or peer group information.

vpnv6: Displays BGP VPNv6 peer or peer group information.

mdt: Displays BGP MDT peer or peer group information.

multicast: Displays BGP multicast peer or peer group information.

rtfilter: Displays BGP IPv4 RT filter peer or peer group information.

dedicated: Displays BGP dedicated peer or peer group information.

unicast: Displays BGP unicast peer or peer group information.

vpn-instance-all: Displays BGP peer or peer group information for all VPN instances.

ipv4-address mask-length: Specifies a subnet. The value range for the mask length is 0 to 32. If you specify a subnet, this command displays information about all dynamic peers in the subnet.

ipv4-address: Specifies a peer by its IPv4 address.

ipv6-address prefix-length: Specifies a subnet. The value range for the prefix length is 0 to 128. If you specify a subnet, this command displays information about all dynamic peers in the subnet.

ipv6-address: Specifies a peer by its IPv6 address.

link-local-address: Specifies a peer by its link-local address. This argument is not supported in multicast address family view.

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

group-name group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters.

log-info: Displays log information.

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

Usage guidelines

If you do not specify any parameters, this command displays brief information about all BGP peers for the specified address family.

By default, the unicast keyword is used if the unicast, multicast, and mdt keywords are not specified.

Examples

# Display brief information about all BGP IPv4 unicast peers.

<Sysname> display bgp peer ipv4

BGP local router ID: 192.168.100.1

Local AS number: 100

Total number of peers: 1 Peers in established state: 1

* - Dynamically created peer

^ - Peer created through link-local address

Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State

10.2.1.2 200 13 16 0 0 00:10:34 Established

# Display brief BGP IPv4 unicast peer information for all VPN instances.

<Sysname> display bgp peer ipv4 vpn-instance-all

Local AS number: 100

* - Dynamically created peer

^ - Peer created through link-local address

VPN instance: 1

BGP local router ID: 111.1.1.1

Total number of peers: 2 Peers in established state: 0

Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State

111.1.1.1 100 0 0 0 0 00:00:34 Connect

111.1.1.2 100 0 0 0 0 00:00:34 Connect

VPN instance: 2

BGP local router ID: 112.1.1.1

Total number of peers: 2 Peers in established state: 0

Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State

112.1.1.1 100 0 0 0 0 00:00:06 Idle

112.1.1.2 100 0 0 0 0 00:00:06 Idle

Table 12 Command output

Field	Description
* - Dynamically created peer	An asterisk (*) before a peer address indicates that the peer is a dynamic peer.
^ - Peer created through link-local address	A caret (^) before a peer address indicates that the peer is created by using a link-local address.
VPN instance	Name of the VPN instance to which the peer belongs.
Peer	IPv4 or IPv6 address of the peer.
AS	AS number of the peer.
MsgRcvd	Number of messages received.
MsgSent	Number of messages sent.
OutQ	Number of messages to be sent.
PrefRcv	For the IPv4, IPv6, VPNv4, and VPNv6 address families, this field displays the number of prefixes that have been received from the peer and added into the local BGP routing table. For the IPv4 MDT address family, this field displays the number of MDT messages received from the peer.
Up/Down	Lasting time of the current BGP session state.
State	Current state of the BGP session between the local router and the peer.

‌

# Display brief information about all dynamic peers in network 1.1.1.0/24.

<Sysname> display bgp peer ipv4 1.1.1.0 24

Type: EBGP link

Dynamic address range: 1.1.1.0 24

Configured: Active Hold Time: 3 sec Keepalive Time: 1 sec

Address family IPv4 Unicast: Configured

Maximum allowed prefix number: 100

Threshold: 75%

Minimum time between advertisements is 100 seconds

Optional capabilities:

Multi-protocol extended capability has been enabled

Route refresh capability has been enabled

Nexthop self has been configured

Keep-all-routes has been configured

Send community has been configured

Send extend community has been configured

Default route originating has been configured

Multi-hop ebgp has been enabled

Peer preferred value: 100

BFD: Enabled

Site-of-Origin: 1:1

Routing policy configured:

No import as-path-acl list

Export as-path-acl list is: 22

No import prefix list

Export prefix list is: p1

No import route policy

Export route policy is: p1

No import filter-policy

No export filter-policy

Dynamic peers:

1.1.1.3

# Display brief information about all dynamic peers in network 1::/64.

<Sysname> display bgp peer ipv6 1:: 64

Type: IBGP link

Dynamic address range: 1:: 64

Configured: Active Hold Time: 180 sec Keepalive Time: 60 sec

Address family IPv6 Unicast: Configured

Maximum allowed prefix number: 4294967295

Threshold: 75%

Minimum time between advertisements is 15 seconds

Optional capabilities:

Multi-protocol extended capability has been enabled

Route refresh capability has been enabled

Send community has been configured

Peer preferred value: 0

Site-of-Origin: Not specified

Routing policy configured:

No routing policy is configured

Dynamic peers:

1::1

Table 13 Command output

Field	Description
Type	BGP connection type between the local router and the dynamic peer: · IBGP link—IBGP connection. · EBGP link—EBGP connection.
Configured	Timers configured on the local router in seconds, including the hold time (Active Hold Time) and keepalive interval (Keepalive Time).
Address family IPv4 Unicast	IPv4 unicast address family capability.
Address family link-state	LS address family capability.
Address family IPv6 Unicast	IPv6 unicast address family capability.
Address family IPv4 Multicast	IPv4 multicast address family capability.
Address family IPv6 Multicast	IPv6 multicast address family capability.
Address family MDT	IPv4 MDT address family capability.
Address family Dedicated	Dedicated address family capability.
Maximum allowed prefix number	Maximum number of routes allowed to learn from the peer.
Threshold	Percentage of received routes from the peer to maximum routes allowed to learn from the peer. If the percentage is reached, the system generates alarm messages.
Minimum time between advertisements	Minimum route advertisement interval in seconds.
Optional capabilities	Optional capabilities supported by the local end.
Peer Preferred Value	Preferred value specified for the routes from the peer.
BFD	Whether BFD is enabled to detect the link to the BGP peers.
IPsec profile name	IPsec profile applied to the IPv6 BGP peer. This field is available only for the IPv6 unicast and IPv6 multicast address families.
Routing policy configured	Routing policy configured for the peer. If you do not specify a routing policy, this field displays No routing policy is configured.
Dynamic peers	IP addresses of dynamic peers.

‌

# Display detailed information about BGP 10.2.1.2 in IPv4 unicast address family.

<Sysname> display bgp peer ipv4 10.2.1.2 verbose

Peer: 10.2.1.2 Local: 192.168.100.1

Type: EBGP link

BGP version 4, remote router ID 192.168.100.2

BGP current state: Established, Up for 00h11m10s

BGP current event: RecvKeepalive

BGP last state: OpenConfirm

Port: Local - 179 Remote - 60672

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 route AS4 capability

Address family IPv4 Unicast: advertised and received

InQ updates: 0, OutQ updates: 0

NLRI statistics:

Rcvd: UnReach NLRI 0, Reach NLRI 0

Sent: UnReach NLRI 0, Reach NLRI 0

Message statistics:

Msg type Last rcvd time/ Current rcvd count/ History rcvd count/

Last sent time Current sent count History sent count

Open 10:38:50-2013.7.23 1 1

10:38:50-2013.7.23 1 1

Update 10:38:51-2013.7.23 1 1

10:38:51-2013.7.23 1 1

Notification - 0 0

- 0 0

Keepalive 10:38:50-2013.7.23 1 1

10:38:50-2013.7.23 1 1

RouteRefresh - 0 0

- 0 0

Total - 3 3

- 3 3

Maximum allowed prefix number: 4294967295

Threshold: 75%

Minimum time between advertisements is 30 seconds

Optional capabilities:

Multi-protocol extended capability has been enabled

Route refresh capability has been enabled

Peer Preferred Value: 0

GTSM has been enabled, and the maximum number of hops is 10

TCP-MSS configured value: 200

BFD: Enabled

Site-of-Origin: Not specified

Routing policy configured:

No routing policy is configured

# Display detailed information about BGP peer 2::2 in IPv4 unicast address family.

<Sysname> display bgp peer ipv4 2::2 verbose

Peer: 2::2 Local: 2.2.2.2

Type: EBGP link

BGP version 4, remote router ID 3.3.3.3

BGP current state: Established, Up for 00h24m31s

BGP current event: KATimerExpired

BGP last state: OpenConfirm

Port: Local - 179 Remote - 51971

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 extended nexthop encoding capability

Peer supports BGP route AS4 capability

Address family IPv4 Unicast: advertised and received

InQ updates: 0, OutQ updates: 0

NLRI statistics:

Rcvd: UnReach NLRI 0, Reach NLRI 1

Sent: UnReach NLRI 0, Reach NLRI 5

Message statistics:

Msg type Last rcvd time/ Current rcvd count/ History rcvd count/

Last sent time Current sent count History sent count

Open 15:45:52-2019.4.19 1 2

15:45:52-2019.4.19 1 2

Update 15:45:53-2019.4.19 2 4

15:45:52-2019.4.19 6 12

Notification 15:45:50-2019.4.19 0 1

- 0 0

Keepalive 16:09:25-2019.4.19 25 31

16:10:13-2019.4.19 30 36

RouteRefresh - 0 0

- 0 0

Total - 28 38

- 37 50

Maximum allowed prefix number: 4294967295

Threshold: 75%

Minimum time between advertisements is 30 seconds

Optional capabilities:

Multi-protocol extended capability has been enabled

Route refresh capability has been enabled

Extended nexthop encoding has been enabled

Peer preferred value: 0

Site-of-Origin: Not specified

Routing policy configured:

No routing policy is configured

# Display detailed information about BGP peer 1::2 in IPv6 unicast address family.

<Sysname> display bgp peer ipv6 1::2 verbose

Peer: 1::2 Local: 192.168.1.136

Type: EBGP link

Link-local interface: Twenty-FiveGigE1/0/1

BGP version 4, remote router ID 192.168.1.135

BGP current state: Established, Up for 00h05m48s

BGP current event: RecvKeepalive

BGP last state: OpenConfirm

Port: Local - 13184 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 route AS4 capability

Address family IPv6 Unicast: advertised and received

InQ updates: 0, OutQ updates: 0

NLRI statistics:

Rcvd: UnReach NLRI 0, Reach NLRI 0

Sent: UnReach NLRI 0, Reach NLRI 3

Message statistics:

Msg type Last rcvd time/ Current rcvd count/ History rcvd count/

Last sent time Current sent count History sent count

Open 18:59:15-2013.4.24 1 1

18:59:15-2013.4.24 1 2

Update - 0 0

18:59:16-2013.4.24 1 1

Notification - 0 0

18:59:15-2013.4.24 0 1

Keepalive 18:59:15-2013.4.24 1 1

18:59:15-2013.4.24 1 1

RouteRefresh - 0 0

- 0 0

Total - 2 2

- 3 5

Maximum allowed prefix number: 4294967295

Threshold: 75%

Minimum time between advertisements is 30 seconds

Optional capabilities:

Multi-protocol extended capability has been enabled

Route refresh capability has been enabled

Peer preferred value: 0

GTSM has been enabled, and the maximum number of hops is 10

TCP-MSS configured value: 200

BFD: Enabled

IPsec profile name: profile001

Site-of-Origin: Not specified

Routing policy configured:

No routing policy is configured

Table 14 Command output

Field	Description
Peer	IPv4 or IPv6 address of the peer.
Local	Local router ID.
VPN instance	Name of the VPN instance to which the peer belongs.
Type	BGP connection type between the local router and the peer: · IBGP link—IBGP connection. · EBGP link—EBGP connection.
Link-local interface	Interface used to establish the connection to a peer created by using a link-local address.
remote router ID	Router ID of the peer.
BGP current state	Current state of the BGP session between the local router and the peer.
Up for	Lasting time of the BGP session.
BGP current event	Current event of the BGP session between the local router and the peer.
BGP last state	Previous state of the BGP session.
Port	TCP port numbers of the local router and its peer.
Configured	Timers configured on the local router in seconds, including the hold time (Active Hold Time) and keepalive interval (Keepalive Time).
Received	Received timer (configured on the peer) in seconds, including the hold time (Active Hold Time).
Negotiated	Negotiated timers in seconds, including the hold time (Active Hold Time) and keepalive interval (Keepalive Time).
Peer optional capabilities	Optional capabilities supported by the peer.
Peer supports BGP route AS4 capability	The peer supports 4-byte AS number.
Peer supports BGP extended nexthop encoding capability	Peers in IPv4 unicast address family support extended next hop encoding capability.
Address family IPv4 Unicast	IPv4 unicast address family capability: routes of the address family can be advertised and received.
Address family LS	LS address family capability: routes of the address family can be advertised and received.
Address family IPv6 Unicast	IPv6 unicast address family capability: routes of the address family can be advertised and received.
Address family IPv4 Multicast	IPv4 multicast address family capability: routes of the address family can be advertised and received.
Address family IPv6 Multicast	IPv6 multicast address family capability: routes of the address family can be advertised and received.
Address family MDT	IPv4 MDT address family capability: routes of the address family can be advertised and received.
Address family Dedicated	Dedicated address family capability: routes of the address family can be advertised and received.
InQ updates	Number of received updates to be processed.
OutQ updates	Number of updates to be sent to the peer.
NLRI statistics	Number of the reachable and unreachable routes received from and sent to the peer after the BGP session is established.
Message statistics	BGP message statistics.
Msg type	BGP message type.
Last rcvd time/Last sent time	Time when the most recent BGP message was received from or sent to the peer.
Current rcvd count/Current sent count	Number of BGP messages received from or sent to the peer on the current BGP session.
History rcvd count/History sent count	Number of BGP messages received from or sent to the peer since the BGP peer relationship was established.
Total	Total number of received and sent messages.
Maximum allowed prefix number	Maximum number of routes allowed to learn from the peer.
Threshold	Percentage of received routes from the peer to maximum routes allowed to learn from the peer. If the percentage is reached, the system generates alarm messages.
Minimum time between advertisements	Minimum route advertisement interval in seconds.
Optional capabilities	Optional capabilities supported by the local end.
Extended Nexthop Encoding has been enabled	The local end supports the extended next hop encoding capability.
Peer Preferred Value	Preferred value specified for the routes from the peer.
GTSM has been enabled		GTSM is supported.
the maximum number of hops		Maximum number of hops to the specified peer.
TCP-MSS configured value		TCP maximum segment size used for TCP connection to the peer. This field is supported only in Release 6635 and later.
BFD	Whether BFD is enabled to detect the link to the BGP peer.
IPsec profile name	IPsec profile applied to the IPv6 BGP peer. This field is available only for the IPv6 unicast and IPv6 multicast address families.
Routing policy configured	Routing policy configured for the peer. If you do not specify a routing policy, this field displays No routing policy is configured.

‌

# Display log information for BGP IPv4 unicast peer 1.1.1.1.

<Sysname> display bgp peer ipv4 1.1.1.1 log-info

Peer : 1.1.1.1

Date Time State Notification

Error/SubError

06-Feb-2013 22:54:42 Down Send notification with error 6/4

Cease/Administrative Reset

# Display log information for BGP IPv6 unicast peer fe80::2.

<Sysname> display bgp peer ipv6 fe80::2 interface Twenty-FiveGige1/0/1 log-info

Peer : FE80::2 Interface: Twenty-FiveGigE1/0/1

Date Time State Notification

Error/SubError

11-Jun-2019 08:43:10 Down Send notification with error 6/4

Cease/Administrative Reset

Table 15 Command output

Field	Description
Peer	IPv4 or IPv6 address of the peer.
Interface	Interface type and number.
Date	Date on which the Notification was sent or received.
Time	Time at which the Notification was sent or received.
State	BGP session state: · Up—The BGP session is in Established state. · Down—The BGP session is down.
Notification Error/SubError	Error code of the Notification, indicating the cause of why the BGP session was down. · Error—Refers to the error code, which identifies the type of the Notification. · SubError—Refers to the error subcode of the Notification, which identifies the specific information about the reported error.

‌

display bgp peer received prefix-list

Use display bgp peer received prefix-list to display the ORF prefix information received by a peer.

Syntax

display bgp [ instance instance-name ] peer ipv4 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] ipv4-address received prefix-list

display bgp [ instance instance-name ] peer ipv6 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] ipv6-address received prefix-list

display bgp [ instance instance-name ] peer ipv6 [ unicast ] [ vpn-instance vpn-instance-name ] { ipv4-address | link-local-address interface interface-type interface-number } received prefix-list

display bgp [ instance instance-name ] peer ipv4 [ unicast ] ipv6-address received prefix-list

display bgp [ instance instance-name ] peer { vpnv4 | vpnv6 } ipv4-address received prefix-list

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays ORF prefix information for the default BGP instance.

ipv4: Displays BGP IPv4 peer information.

ipv6: Displays BGP IPv6 peer information.

vpnv4: Displays BGP VPNv4 peer information.

vpnv6: Displays BGP VPNv6 peer information.

multicast: Displays BGP multicast peer information.

unicast: Displays BGP unicast peer information.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify an instance, this command displays information for the public network.

ipv4-address: Specifies a peer by its IPv4 address.

ipv6-address: Specifies a peer by its IPv6 address.

link-local-address: Specifies a peer by its link-local address.

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

Examples

# Display the ORF prefix information received by peer 10.110.25.20.

<Sysname> display bgp peer ipv4 10.110.25.20 received prefix-list

ORF prefix list entries: 2

index: 10 prefix 1.1.1.0/24 ge 26 le 32

index: 20 prefix 2.1.1.0/24 ge 26 le 32

Table 16 Command output

Field	Description
ORF prefix list entries	Number of ORF prefixes.
index	Prefix index.
prefix	Prefix information.
ge	Greater than or equal to.
le	Less than or equal to.

‌

display bgp routing-table dampened

Use display bgp routing-table dampened to display dampened BGP routes.

Syntax

display bgp [ instance instance-name ] routing-table dampened { ipv4 | ipv6 } [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays dampened BGP routes for the default BGP instance.

ipv4: Displays dampened BGP IPv4 routes.

ipv6: Displays dampened BGP IPv6 routes.

multicast: Displays dampened BGP multicast routes.

unicast: Displays dampened BGP unicast routes.

Usage guidelines

By default, the unicast keyword is used if neither the multicast keyword nor the unicast keyword is specified.

Examples

# Display dampened BGP IPv4 unicast routes.

<Sysname> display bgp routing-table dampened ipv4

Total number of routes: 1

BGP local router ID is 192.168.1.135

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Network From Reuse Path/Ogn

de 20.1.1.0/24 10.1.1.2 00:56:27 100i

# Display dampened BGP IPv6 unicast routes.

<Sysname> display bgp routing-table dampened ipv6

Total number of routes: 2

BGP local router ID is 192.168.1.135

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

de Network : 2:: PrefixLen : 64

From : 10.1.1.1 Reuse : 00:39:49

Path/Ogn: 100i

de Network : 2:: PrefixLen : 64

From : 1::1 Reuse : 00:39:49

Path/Ogn: 100i

Table 17 Command output

Field	Description
Status codes	Status codes: · * – valid—Valid route. · > – best—Optimal route. · d – dampened—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – stale—Stale route. · i – internal—Internal route. · e – external—External route. · a – additional-path—Add-Path optimal route.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP. · e – EGP—Learned through EGP. · ?– incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.
Network	Destination network address.
From	IP address from which the route was received.
Reuse	Reuse time of the route.
Path/Ogn	AS_PATH and ORIGIN attributes of the route: · AS_PATH attribute—Records the ASs the route has passed, which avoids routing loops. · ORIGIN attribute—Identifies the origin of the route.

‌

Related commands

dampening

reset bgp dampening

display bgp routing-table dedicated

Use display bgp routing-table dedicated to display BGP dedicated routing information.

Syntax

display bgp [ instance instance-name ] routing-table dedicated [ peer { ipv4-address | ipv6-address } { advertised-routes | received-routes } [ statistics ] | [ route-type mac-ip ] [ { dedicated-route route-length | dedicated-prefix } [ advertise-info ] | ipv4-address | ipv6-address | mac-address ] | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

peer: Displays BGP dedicated routing information advertised to or received from the specified peer.

ipv4-address: Specifies a peer by its IPv4 address.

ipv6-address: Specifies a peer by its IPv6 address.

advertised-routes: Displays advertised BGP dedicated routing information.

received-routes: Displays received BGP dedicated routing information.

statistics: Displays BGP dedicated route statistics.

route-type: Displays BGP dedicated routes of the specified type. Only MAC/IP routes are supported in the current software version.

mac-ip: Displays MAC/IP routes.

dedicated-route route-length: Displays detailed information about the specified BGP dedicated route. The dedicated-route argument specifies the BGP dedicated routing information, in the range of 1 to 512 characters. The route-length argument specifies the length of the BGP dedicated routing information, in the range of 0 to 65535 bits.

dedicated-prefix: Displays detailed information about the specified BGP dedicated route. The dedicated-prefix argument is a case-insensitive string of 1 to 512 characters and specifies the routing information and routing information length of the dedicated route in dedicated-route/route-length format.

advertise-info: Displays advertisement information for BGP dedicated routes.

ipv4-address: Displays BGP dedicated routes that carry the specified IPv4 address.

ipv6-address: Displays BGP dedicated routes that carry the specified IPv6 address.

mac-address: Displays BGP dedicated routes that carry the specified MAC address.

Examples

# Display brief information about all BGP dedicated routes.

<Sysname> display bgp routing-table dedicated

BGP local router ID is 8.8.8.8

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Total number of routes: 2

* >e Network : [1][48][0011-0022-0033][32][11.22.33.44][3]/104

NextHop : 1.2.3.4 LocPrf : 100

PrefVal : 0

MED : 0

Path/Ogn: 200i

* >e Network : [1][48][0710-0101-3451][0][3]/72

NextHop : 1.2.3.9 LocPrf : 100

PrefVal : 0

MED : 0

Path/Ogn: 200i

Table 18 Command output

Field	Description
BGP local router ID	Local router ID.
Status codes	Status codes: · * – valid—Valid route. · > – best—Optimal route. · d - dampened—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – stale—Stale route. · i – internal—Internal route. · e – external—External route. · a - additional-path—Add-Path optimal route.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP. · e – EGP—Learned through EGP. · ?– incomplete—Unknown origin.
Total number of routes	Total number of BGP dedicated routes.
Network	BGP dedicated route/route length in [1][MACLength][MAC][IPAddressLength][IPAddress][OriginType] format: · 1—The route is a MAC/IP route and carries IPSG binding information. · MACLength—MAC address length. · MAC—MAC address. · IPAddressLength—IP address length. · IPAddress—IP address. · OriginType—IPSG binding source. Options include the following: ¡ 3—DHCP relay. ¡ 7—ND snooping. ¡ 8—DHCPv6 relay.
NextHop	Next hop IP address.
LocPrf	Local preference value.
PrefVal	Preferred value of the route.
MED	MED attribute.
Path/Ogn	AS_PATH and ORIGIN attributes of the route: · AS_PATH—Records the ASs the route has passed, which avoids routing loops. This field can display only 16 AS numbers. Exceeding AS numbers are omitted. You can view the omitted AS numbers by displaying the detailed route information. · ORIGIN—Identifies the origin of the route.

# Display detailed information about BGP dedicated route [1][48][0011-0022-0033][32][11.22.33.44][3]/120.

<Sysname> display bgp routing-table dedicated [1][48][0011-0022-0033][32][11.22.33.44][3]/120

BGP local router ID: 1.1.1.2

Local AS number: 100

Total number of routes: 1

Paths: 2 available, 1 best

BGP routing table information of [1][48][0011-0022-0033][32][11.22.33.44][3]/120:

From : 10.1.1.2 (192.168.56.17)

Rely nexthop : 10.1.1.2

Original nexthop: 10.1.1.2

OutLabel : NULL

RxPathID : 0x0

TxPathID : 0x0

AS-path : 200

Origin : egp

Attribute value : MED 0, pref-val 0

State : valid, external, best

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

Route type : MAC/IP route

MAC length : 48

MAC address : 0011-0022-0033

IP length : 32

IP address : 11.22.33.44

Origin type : DHCP relay agent

VLAN ID : 4096

Inner VLAN ID : 10

Origin router ID: 1.1.1.2

Table 19 Command output

Field	Description
BGP local router ID	Local router ID.
Local AS number	Local AS number.
Total number of routes	Total number of BGP dedicated routes.
Paths	Number of routes: · available—Number of valid routes. · best—Number of optimal routes.
BGP routing table information of [1][48][0011-0022-0033][32][11.22.33.44][3]/120	Detailed information about BGP dedicated route [1][48][0011-0022-0033][32][11.22.33.44][3]/120.
From	IP address of BGP peer that advertised the route.
Rely Nexthop	Next hop found by route recursion. If no next hop is found, this field displays not resolved.
Original nexthop	Original next hop of the route. If the route was obtained from a BGP UPDATE message, the original next hop is the next hop IP address in the message.
OutLabel	Outgoing label of the route. This field is not supported in BGP dedicated address family.
RxPathID	Add-path ID of received routes. This field is not supported in BGP dedicated address family.
TxPathID	Add-path ID of advertised routes. This field is not supported in BGP dedicated address family.
AS-path	AS_PATH attribute of the route.
Origin	Origin of the route: · igp—Originated in the AS. · egp—Learned through EGP. · incomplete—Unknown origin.
Attribute value	BGP path attributes: · MED—MED value. · localpref—Local preference value. · pref-val—Preferred value. · pre—Route preference.
State	Current state of the route: · valid. · internal. · external. · local. · best.
IP precedence	IP precedence in the range of 0 to 7. N/A indicates that the route does not support this field.
QoS local ID	QoS local ID in the range of 1 to 4095. N/A indicates that the route does not support this field.
Traffic index	Traffic index in the range of 1 to 64. N/A indicates that the route does not support this field.
Route Type	Route type. Only MAC/IP is supported in the current software version.
MAC Length	Length of the MAC address carried in the dedicated route.
MAC	MAC address carried in the dedicated route.
IPAddressLength	Length of the IP address carried in the dedicated route.
IPAddress	IP address carried in the dedicated route.
Origin type	IPSG binding origin: · ND snooping. · DHCP relay agent. · DHCPv6 relay agent.
VLAN ID	VLAN ID carried in the dedicated route.
Inner VLAN ID	Inner VLAN ID carried in the dedicated route. This field displays N/A if the route carries only one VLAN tag.
Origin router ID	ID of the router that generates the route.

# Display advertisement information about BGP dedicated route [1][48][0011-0022-0033][32][11.22.33.44][3]/120.

<Sysname> display bgp routing-table dedicated [1][48][0011-0022-0033][32][11.22.33.44][3]/120 advertise-info

BGP local router ID: 192.168.1.136

Local AS number: 100

Total number of routes: 1

Paths: 1 best

BGP routing table information of [1][48][0011-0022-0033][32][11.22.33.44]/104:

Advertised to peers (1 in total):

10.1.1.2

Table 20 Command output

Field	Description
BGP local router ID	Local router ID.
Local AS number	Local AS number.
Total number of routes	Total number of BGP dedicated routes.
Paths	Number of optimal routes to the destination.
BGP routing table information of [1][48][0011-0022-0033][32][11.22.33.44][3]/120	Advertisement information about BGP dedicated route [1][48][0011-0022-0033][32][11.22.33.44][3]/120.
Advertised to peers (1 in total)	Peers to which the route has been advertised.

# Display statistics for BGP dedicated routes advertised to peer 1::1.

<Sysname> display bgp routing-table dedicated peer 1::1 advertised-routes statistics

Advertised routes total: 1

# Display statistics for BGP dedicated routes received from peer 1::1.

<Sysname> display bgp routing-table dedicated peer 1::1 received-routes statistics

Received routes total: 1

Table 21 Command output

Field	Description
Advertised routes total	Total number of BGP dedicated routes advertised to the peer.
Received routes total	Total number of BGP dedicated routes received from the peer.

# Display BGP dedicated route statistics.

<Sysname> display bgp routing-table dedicated statistics

Total number of routes: 4

Table 22 Command output

Field	Description
Total number of routes	Total number of BGP dedicated routes.

‌

display bgp routing-table flap-info

Use display bgp routing-table flap-info to display BGP route flap statistics.

Syntax

display bgp [ instance instance-name ] routing-table flap-info ipv4 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ ipv4-address [ { mask-length | mask } [ longest-match ] ] | as-path-acl { as-path-acl-number | as-path-acl-name } ]

display bgp [ instance instance-name ] routing-table flap-info ipv6 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ ipv6-address prefix-length | as-path-acl { as-path-acl-number | as-path-acl-name } ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP route flap statistics for the default BGP instance.

ipv4: Displays BGP IPv4 route flap statistics.

ipv6: Displays BGP IPv6 route flap statistics.

multicast: Displays BGP multicast route flap statistics.

unicast: Displays BGP unicast route flap statistics.

ipv4-address: Specifies a destination network address.

mask-length: Specifies a mask length in the range of 0 to 32.

mask: Specifies a network mask in dotted decimal notation.

longest-match: Specifies longest match mode, which selects the longest matching route through the following steps:

1. ANDs the specified network address with the mask of each route.

2. Matches a route if the AND result is the same as the network address of the route and the mask of the route is shorter than or equal to the specified mask.

3. Selects the route with the longest mask among the matching routes.

ipv6-address prefix-length: Displays route flap statistics for BGP IPv6 routes that match the specified network address, and match the prefix length in the range of 0 to 128.

as-path-acl as-path-acl-number: Displays route flap statistics for BGP routes that match the AS path list specified by its number in the range of 1 to 256.

as-path-acl as-path-acl-name: Displays route flap statistics for BGP routes that match the AS path list specified by its name, a case-sensitive string of 1 to 51 characters. The AS path list name cannot contain only digits.

Usage guidelines

If you specify only the ipv4-address argument, the system ANDs the network address with the mask of a route. If the result matches the network address of the route, the command displays flap statistics of the route.

If you specify the ipv4-address mask or ipv4-address mask-length argument, and do not specify the longest-match keyword, the command displays flap statistics of the BGP IPv4 unicast or multicast route that matches both the specified destination network address and the mask (or mask length).

By default, the unicast keyword is used if neither the multicast keyword nor the unicast keyword is specified.

Examples

# Display BGP IPv4 unicast route flap statistics.

<Sysname> display bgp routing-table flap-info ipv4

Total number of routes: 1

BGP local router ID is 192.168.1.135

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Network From Flaps Duration Reuse Path/Ogn

de 20.1.1.0/24 10.1.1.2 1 00:02:36 00:53:58 100i

# Display BGP IPv6 unicast route flap statistics.

<Sysname> display bgp routing-table flap-info ipv6

Total number of routes: 2

BGP local router ID is 192.168.1.135

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

de Network : 2:: PrefixLen : 64

From : 10.1.1.1 Flaps : 5

Duration: 00:03:25 Reuse : 00:39:28

Path/Ogn: 100i

de Network : 2:: PrefixLen : 64

From : 1::1 Flaps : 5

Duration: 00:03:25 Reuse : 00:39:28

Path/Ogn: 100i

Table 23 Command output

Field	Description
Status codes	Status codes: · * – valid—Valid route. · > – best—Optimal route. · d – dampened—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – stale—Stale route. · i – internal—Internal route. · e – external—External route. · a – additional-path.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP. · e – EGP—Learned through EGP. · ?– incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.
Network	Destination network address.
From	Source IP address of the route.
Flaps	Number of routing flaps.
Duration	Duration time of the flap route.
Reuse	Reuse time of the route.
Path/Ogn	AS_PATH and ORIGIN attributes of the route: · AS_PATH attribute—Records the ASs the route has passed, which avoids routing loops. · ORIGIN attribute—Identifies the origin of the route.

‌

Related commands

dampening

reset bgp flap-info

display bgp routing-table ipv4 multicast

Use display bgp routing-table ipv4 multicast to display BGP IPv4 multicast routing information.

Syntax

display bgp [ instance instance-name ] routing-table ipv4 multicast [ ipv4-address [ { mask-length | mask } [ longest-match ] ] | ipv4-address [ mask-length | mask ] advertise-info | as-path-acl { as-path-acl-number | as-path-acl-name } | community-list { { basic-community-list-number | comm-list-name } [ whole-match ] | adv-community-list-number } | peer ipv4-address { advertised-routes | received-routes } [ ipv4-address [ mask-length | mask ] | statistics ] | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP IPv4 multicast routing information for the default BGP instance.

ipv4-address: Specifies a destination network address.

mask-length: Specifies a mask length in the range of 0 to 32.

mask: Specifies a network mask in dotted decimal notation.

longest-match: Specifies longest match mode, which selects the longest matching route through the following steps:

1. ANDs the specified network address with the mask of each route.

2. Matches a route if the AND result is the same as the network address of the route and the mask of the route is shorter than or equal to the specified mask.

3. Selects the route with the longest mask among the matching routes.

advertise-info: Displays advertisement information for BGP IPv4 multicast routes.

as-path-acl as-path-acl-number: Displays BGP IPv4 multicast routes that match the AS path list specified by its number in the range of 1 to 256.

as-path-acl as-path-acl-name: Displays BGP IPv4 multicast routes that match the AS path list specified by its name, a case-sensitive string of 1 to 51 characters. The AS path list name cannot contain only digits.

community-list: Displays BGP IPv4 multicast routes that match a community list.

basic-community-list-number: Specifies a basic community list by its number in the range of 1 to 99.

comm-list-name: Specifies a community list by its name, a case-sensitive string of 1 to 63 characters.

whole-match: Displays BGP IPv4 multicast routes exactly matching the specified community list. If you do not specify this keyword, the command displays BGP IPv4 multicast routes whose COMMUNITY attributes include the specified community list.

adv-community-list-number: Specifies an advanced community list by its number in the range of 100 to 199.

peer ipv4-address: Displays BGP IPv4 multicast routing information advertised to or received from the specified peer.

advertised-routes: Displays BGP IPv4 multicast routing information advertised to the specified peer.

received-routes: Displays BGP IPv4 multicast routing information received from the specified peer.

statistics: Displays routing statistics.

Usage guidelines

If you do not specify any parameters, this command displays brief information about all BGP IPv4 multicast routes.

If you specify the ipv4-address mask or ipv4-address mask-length argument and do not specify the longest-match keyword, this command displays information about the BGP IPv4 multicast route that matches both the specified destination network address and the mask (or mask length).

Examples

# Display brief information about all BGP IPv4 multicast routes.

<Sysname> display bgp routing-table ipv4 multicast

Total number of routes: 3

BGP local router ID is 192.168.1.62

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Network NextHop MED LocPrf PrefVal Path/Ogn

* > 5.5.5.5/32 127.0.0.1 0 32768 ?

* > 192.168.1.0 192.168.1.62 0 32768 ?

* > 192.168.1.62/32 127.0.0.1 0 32768 ?

# Display information about BGP IPv4 multicast routes that match AS path list 20.

<Sysname> display bgp routing-table ipv4 multicast as-path-acl 20

Total number of routes: 3

BGP local router ID is 192.168.1.62

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Network NextHop MED LocPrf PrefVal Path/Ogn

* > 5.5.5.5/32 127.0.0.1 0 32768 ?

* > 192.168.1.0 192.168.1.62 0 32768 ?

* > 192.168.1.62/32 127.0.0.1 0 32768 ?

# Display information about BGP IPv4 multicast routes that match BGP community list 100.

<Sysname> display bgp routing-table ipv4 multicast community-list 100

Total number of routes: 3

BGP local router ID is 192.168.1.62

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Network NextHop MED LocPrf PrefVal Path/Ogn

* > 5.5.5.5/32 127.0.0.1 0 32768 ?

* > 192.168.1.0 192.168.1.62 0 32768 ?

* > 192.168.1.62/32 127.0.0.1 0 32768 ?

# Display information about all BGP IPv4 multicast routes advertised to peer 192.168.1.139.

<Sysname> display bgp routing-table ipv4 multicast peer 192.168.1.139 advertised-routes

Total number of routes: 2

BGP local router ID is 192.168.1.62

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Network NextHop MED LocPrf Path/Ogn

* > 5.5.5.5/32 127.0.0.1 0 100 ?

* > 192.168.1.0 192.168.1.62 0 100 ?

# Display information about all BGP IPv4 multicast routes received from peer 192.168.1.139.

<Sysname> display bgp routing-table ipv4 multicast peer 192.168.1.139 received-routes

Total number of routes: 2

BGP local router ID is 192.168.1.62

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Network NextHop MED LocPrf PrefVal Path/Ogn

* >i 8.8.8.8/32 192.168.1.139 0 100 0 ?

* i 192.168.1.0 192.168.1.139 0 100 0 ?

Table 24 Command output

Field	Description
Status codes	Status codes: · * – valid—Valid route. · > – best—Optimal route. · d – dampened—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – stale—Stale route. · i – internal—Internal route. · e – external—External route. · a – additional-path—Add-Path optimal route.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP. · e – EGP—Learned through EGP. · ?– incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.
Network	Destination network address.
NextHop	Next hop IP address.
MED	MULTI_EXIT_DISC attribute.
LocPrf	Local preference value.
PrefVal	Preferred value of the route.
Path/Ogn	AS_PATH and ORIGIN attributes of the route: · AS_PATH—Records the ASs the route has passed. · ORIGIN—Identifies the origin of the route.

‌

# Display detailed information about BGP IPv4 multicast routes destined to network 5.5.5.5/32.

<Sysname> display bgp routing-table ipv4 multicast 5.5.5.5 32

BGP local router ID: 192.168.1.139

Local AS number: 100

Paths: 1 available, 1 best

BGP routing table information of 5.5.5.5/32:

From : 192.168.1.62 (192.168.1.62)

Rely nexthop : 192.168.1.62

Original nexthop: 192.168.1.62

OutLabel : NULL

RxPathID : 0x0

TxPathID : 0x0

AS-path : (null)

Origin : incomplete

Attribute value : MED 0, localpref 100, pref-val 0

State : valid, internal, best, delay

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

Table 25 Command output

Field	Description
Paths	Number of routes: · available—Number of valid routes. · best—Number of optimal routes.
From	IP address of BGP peer that advertised the route.
Rely Nexthop	Next hop found by route recursion. If no next hop is found, this field displays not resolved.
Original nexthop	Original next hop of the route. If the route was obtained from a BGP update message, the original next hop is the next hop IP address in the message.
OutLabel	Outgoing label of the route.
RxPathID	Add-Path ID of received routes.
TxPathID	Add-Path ID of advertised routes.
AS-path	AS_PATH attribute of the route.
Origin	Origin of the route: · igp—Originated in the AS. The origin of routes advertised with the network command is IGP. · egp—Learned through EGP. · incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.
Attribute value	BGP path attributes: · MED—MED value. · localpref—Local preference value. · pref-val—Preferred value. · pre—Route preference.
State	Current state of the route: · valid. · internal. · external. · local. · synchronize. · best. · delay—The route will be delayed for optimal route selection. This field is displayed only in the detailed command output.
IP precedence	IP precedence in the range of 0 to 7. N/A indicates that the route does not support this field.
QoS local ID	QoS local ID in the range of 1 to 4095. N/A indicates that the route does not support this field.
Traffic index	Traffic index in the range of 1 to 64. N/A indicates that the route does not support this field.

‌

# Display statistics for BGP IPv4 multicast routes advertised to peer 192.168.1.62.

<Sysname> display bgp routing-table ipv4 multicast peer 192.168.1.62 advertised-routes statistics

Advertised routes total: 2

# Display statistics for BGP IPv4 multicast routes received from peer 192.168.1.62.

<Sysname> display bgp routing-table ipv4 multicast peer 192.168.1.62 received-routes statistics

Received routes total: 2

Table 26 Command output

Field	Description
Advertised routes total	Total number of advertised routes.
Received routes total	Total number of received routes.

‌

# Display BGP IPv4 multicast route statistics.

<Sysname> display bgp routing-table ipv4 multicast statistics

Total number of routes: 5

Table 27 Command output

Field	Description
Total number of routes	Total number of routes.

‌

# Display advertisement information for the BGP IPv4 multicast route destined to network 8.8.8.8/32.

<Sysname> display bgp routing-table ipv4 multicast 8.8.8.8 32 advertise-info

BGP local router ID: 192.168.1.139

Local AS number: 100

Paths: 1 best

BGP routing table information of 8.8.8.8/32(TxPathID:0):

Advertised to peers (1 in total):

192.168.1.62

Table 28 Command output

Field	Description
BGP local router ID	Local BGP router ID.
Local AS number	Local AS number.
Paths	Number of optimal routes to the destination.
BGP routing table information of 8.8.8.8/32(TxPathID:0)	Advertisement information for network 8.8.8.8/32.
Advertised to peers (1 in total)	Peers to which the network has been advertised.

‌

Related commands

ip as-path

ip community-list

display bgp routing-table ipv4 rtfilter

Use display bgp routing-table ipv4 rtfilter to display BGP IPv4 RT filter routing information.

Syntax

display bgp [ instance instance-name ] routing-table ipv4 rtfilter [ default-rt [ advertise-info ] | [ origin-as as-number ] [ route-target [ advertise-info ] ] | peer ipv4-address { advertised-routes | received-routes } [ default-rt | [ origin-as as-number ] [ route-target ] | statistics ] | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP IPv4 RT filter routing information for the default BGP instance.

default-rt: Displays BGP IPv4 RT filter routing information for an all-zero RT.

origin-as as-number: Specifies an origin AS by its number.

route-target: Specifies an RT, a string of 3 to 21 characters.

An RT has the following formats:

· 16-bit AS number:32-bit user-defined number. For example, 101:3.

· 32-bit IP address:16-bit user-defined number. For example, 192.168.122.15:1.

· 32-bit AS number:16-bit user-defined number, where the minimum value of the AS number is 65536. For example, 65536:1.

advertise-info: Displays advertisement information for BGP IPv4 RT filter routes.

peer ipv4-address: Displays BGP IPv4 RT filter routing information advertised to or received from the specified peer.

advertised-routes: Displays BGP IPv4 RT filter routing information advertised to the specified peer.

received-routes: Displays BGP IPv4 RT filter routing information received from the specified peer.

statistics: Displays routing statistics.

Usage guidelines

If you do not specify any parameters, this command displays brief information about all BGP IPv4 RT filter routes.

Examples

# Display brief information about all BGP IPv4 RT filter routes.

<Sysname> display bgp routing-table ipv4 rtfilter

BGP local router ID is 192.168.1.136

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a - additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Total number of routes from all PEs: 2

Origin AS: 100

Total number of routes: 2

* >e Network : <100:1> PrefixLen : 96

NextHop : 1.1.1.2 LocPrf :

PrefVal : 0

MED :

Path/Ogn: 100i

* >e Network : <1.1.1.1:1> PrefixLen : 96

NextHop : 1.1.1.2 LocPrf :

PrefVal : 0

MED :

Path/Ogn: 100i

# Display information about BGP IPv4 RT filter routes that match origin AS 100.

<Sysname> display bgp routing-table ipv4 rtfilter origin-as 100

BGP local router ID is 192.168.1.136

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a - additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Origin AS: 100

Total number of routes: 2

* >e Network : <100:1> PrefixLen : 96

NextHop : 1.1.1.2 LocPrf :

PrefVal : 0

MED :

Path/Ogn: 100i

* >e Network : <1.1.1.1:1> PrefixLen : 96

NextHop : 1.1.1.2 LocPrf :

PrefVal : 0

MED :

Path/Ogn: 100i

# Display information about all public BGP IPv4 RT filter routes advertised to peer 10.2.1.2.

<Sysname> display bgp routing-table ipv4 rtfilter peer 10.2.1.2 advertised-routes

Total number of routes: 1

BGP local router ID is 192.168.1.136

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a - additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Origin AS: 100

Total number of routes: 1

* > Network : <100:1> PrefixLen : 96

NextHop : 1.1.1.2 LocPrf :

MED : 0

Path/Ogn: i

# Display information about all public BGP IPv4 RT filter routes received from peer 10.2.1.2.

<Sysname> display bgp routing-table ipv4 rtfilter peer 10.2.1.2 received-routes

Total number of routes: 1

BGP local router ID is 192.168.1.135

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a - additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Origin AS: 100

Total number of routes: 1

* >e Network : <100:1> PrefixLen : 96

NextHop : 10.1.1.1 LocPrf :

PrefVal : 0

MED : 0

Path/Ogn: 100i

Table 29 Command output

Field	Description
Origin AS	Origin AS of the RT filter routes.
Status codes	Status codes: · * – valid—Valid route. · > – best—Optimal route. · d – dampened—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – stale—Stale route. · i – internal—Internal route. · e – external—External route. · a - additional-path—Add-Path optimal route.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP. · e – EGP—Learned through EGP. · ?– incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.
Network	Destination network address.
NextHop	Next hop IP address.
MED	MULTI_EXIT_DISC attribute.
LocPrf	Local preference value.
PrefVal	Preferred value of the route.
Path/Ogn	AS_PATH and ORIGIN attributes of the route: · AS_PATH—Records the ASs the route has passed. · ORIGIN—Identifies the origin of the route.

‌

# Display detailed information about BGP IPv4 RT filter route 100:1.

<Sysname> display bgp routing-table ipv4 rtfilter 100:1

BGP local router ID: 192.168.100.1

Local AS number: 100

Origin AS: 100

Total number of routes: 1

Paths: 1 available, 1 best

BGP routing table information of <100:1>/96:

Imported route.

Original nexthop: 10.2.1.1

OutLabel : NULL

RxPathID : 0x0

TxPathID : 0x0

AS-path : (null)

Origin : igp

Attribute value : MED 0, pref-val 32768, pre 0

State : valid, local, best, delay

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

Table 30 Command output

Field	Description
Paths	Number of routes: · available—Number of valid routes. · best—Number of optimal routes.
Imported route	The BGP RT filter route is locally generated.
Original nexthop	Original next hop of the route. If the route was obtained from a BGP update message, the original next hop is the next hop IP address in the message.
OutLabel	Outgoing label of the route.
RxPathID	Add-Path ID of received routes.
TxPathID	Add-Path ID of advertised routes.
AS-path	AS_PATH attribute of the route.
Origin	Origin of the route: · igp—Originated in the AS. The origin of routes advertised with the network command is IGP. · egp—Learned through EGP. · incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.
Attribute value	BGP path attributes: · MED—MED value. · localpref—Local preference value. · pref-val—Preferred value. · pre—Route preference.
State	Current state of the route: · valid. · internal. · external. · local. · synchronize. · best. · delay—The route will be delayed for optimal route selection. This field is displayed only in the detailed command output.
From	IP address of BGP peer that advertised the route.
Rely Nexthop	Next hop found by route recursion. If no next hop is found, this field displays not resolved.
IP precedence	IP precedence in the range of 0 to 7. N/A indicates that the route does not support this field.
QoS local ID	QoS local ID in the range of 1 to 4095. N/A indicates that the route does not support this field.
Traffic index	Traffic index in the range of 1 to 64. N/A indicates that the route does not support this field.
Backup route	The route is a backup route.

‌

# Display statistics for BGP IPv4 RT filter routes advertised to peer 10.2.1.2.

<Sysname> display bgp routing-table ipv4 rtfilter peer 10.2.1.2 advertised-routes statistics

Advertised routes total: 2

# Display statistics for BGP IPv4 RT filter routes received from peer 10.2.1.2.

<Sysname> display bgp routing-table ipv4 rtfilter peer 10.2.1.2 received-routes statistics

Received routes total: 2

Table 31 Command output

Field	Description
Advertised routes total	Total number of advertised routes.
Received routes total	Total number of received routes.

‌

# Display BGP IPv4 RT filter route statistics.

<Sysname> display bgp routing-table ipv4 rtfilter statistics

Total number of routes from all PEs: 6

Origin AS: 100

Total number of routes: 2

Origin AS: 200

Total number of routes: 4

# Display advertisement information for the BGP IPv4 RT filter route 1.1.1.1:1/96.

<Sysname> display bgp routing-table ipv4 rtfilter 1.1.1.1:1 advertise-info

BGP local router ID: 192.168.100.1

Local AS number: 100

Paths: 1 best

Origin AS: 100

Total number of routes: 1

Paths: 1 best

BGP route-target filter information of <1.1.1.1:1>/96:

Advertised to VPN peers (1 in total):

1.1.1.2

Origin AS: 200

Total number of routes: 1

Paths: 1 best

BGP route-target filter information of <1.1.1.1:1>/96:

Advertised to VPN peers (1 in total):

1.1.1.2

Table 32 Command output

Field	Description
Paths	Number of optimal routes to the destination.
BGP route-target filter information of <1.1.1.1:1>/96	Information about BGP IPv4 RT filter route 1.1.1.1:1/96.
Advertised to VPN peers (1 in total)	Peers to which the network has been advertised.

‌

display bgp routing-table ipv4 unicast

Use display bgp routing-table ipv4 unicast to display BGP IPv4 unicast routing information.

Syntax

display bgp [ instance instance-name ] routing-table ipv4 [ unicast ] [ vpn-instance vpn-instance-name ] [ ipv4-address [ { mask-length | mask } [ longest-match ] ] | ipv4-address [ mask-length | mask ] advertise-info | as-path-acl { as-path-acl-number | as-path-acl-name } | community-list { { basic-community-list-number | comm-list-name } [ whole-match ] | adv-community-list-number } | peer { ipv4-address | ipv6-address } { advertised-routes | received-routes } [ ipv4-address [ mask-length | mask ] | statistics ] | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP IPv4 unicast routing information for the default BGP instance.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays the BGP IPv4 unicast routing information for the public network.

ipv4-address: Specifies a destination network address.

mask-length: Specifies a mask length in the range of 0 to 32.

mask: Specifies a network mask in dotted decimal notation.

longest-match: Specifies longest match mode, which selects the longest matching route through the following steps:

1. ANDs the specified network address with the mask of each route.

2. Matches a route if the AND result is the same as the network address of the route and the mask of the route is shorter than or equal to the specified mask.

3. Selects the route with the longest mask among the matching routes.

advertise-info: Displays advertisement information for BGP IPv4 unicast routes.

as-path-acl as-path-acl-number: Displays BGP IPv4 unicast routes that match the AS path list specified by its number in the range of 1 to 256.

as-path-acl as-path-acl-name: Displays BGP IPv4 unicast routes that match the AS path list specified by its name, a case-sensitive string of 1 to 51 characters. The AS path list name cannot contain only digits.

community-list: Displays BGP IPv4 unicast routes that match a community list.

basic-community-list-number: Specifies a basic community list by its number in the range of 1 to 99.

comm-list-name: Specifies a community list by its name, a case-sensitive string of 1 to 63 characters.

whole-match: Displays routes exactly matching the specified community list. If you do not specify this keyword, the command displays routes whose COMMUNITY attributes include the specified community list.

adv-community-list-number: Specifies an advanced community list by its number in the range of 100 to 199.

peer ipv4-address: Displays BGP IPv4 unicast routing information advertised to or received from the specified IPv4 peer.

peer ipv6-address: Displays BGP IPv4 unicast routing information advertised to or received from the specified IPv6 peer.

advertised-routes: Displays routing information advertised to the specified peer.

received-routes: Displays routing information received from the specified peer.

statistics: Displays routing statistics.

Usage guidelines

If you do not specify any parameters, this command displays brief information about all BGP IPv4 unicast routes.

If you specify the ipv4-address mask or ipv4-address mask-length argument and do not specify the longest-match keyword, this command displays information about the BGP IPv4 unicast route that matches both the specified destination network address and the mask (or mask length).

This command displays BGP IPv4 unicast routing information regardless of whether the unicast keyword is specified.

Examples

# Display brief information about all BGP IPv4 unicast routes.

<Sysname> display bgp routing-table ipv4

Total number of routes: 4

BGP local router ID is 192.168.100.1

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Network NextHop MED LocPrf PrefVal Path/Ogn

* > 10.2.1.0/24 10.2.1.1 0 0 i

e 10.2.1.2 0 0 4294967295

4294967294 4294967293 4294967292 4294967291 4294967290 4294967215 4294967225 4294967235 4294967245 4294967295 4294967294 4294967293 4294967292 4294967291 4294967290... i

* > 192.168.1.0 192.168.1.135 0 0 i

* e 10.2.1.2 0 0 200i

# Display information about BGP IPv4 unicast routes that match AS path list 1.

<Sysname> display bgp routing-table ipv4 as-path-acl 1

Total number of routes: 1

BGP local router ID is 2.2.2.2

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Network NextHop MED LocPrf PrefVal Path/Ogn

* >e 30.1.1.0/24 20.1.1.1 0 200i

# Display information about all public BGP IPv4 unicast routes advertised to peer 10.2.1.2.

<Sysname> display bgp routing-table ipv4 peer 10.2.1.2 advertised-routes

Total number of routes: 2

BGP local router ID is 192.168.100.1

Status codes: * - valid, > - best, d - damped, h - history,

s - suppressed, S - Stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Network NextHop MED LocPrf PrefVal Path/Ogn

* > 10.2.1.0/24 10.2.1.1 0 0 i

* > 192.168.1.0 192.168.1.135 0 0 i

# Display information about all public BGP IPv4 unicast routes received from peer 10.2.1.2.

<Sysname> display bgp routing-table ipv4 peer 10.2.1.2 received-routes

Total number of routes: 2

BGP local router ID is 192.168.100.1

Status codes: * - valid, > - best, d - damped, h - history,

s - suppressed, S - Stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

Network NextHop MED LocPrf PrefVal Path/Ogn

e 10.2.1.0/24 10.2.1.2 0 0 200i

* e 192.168.1.0 10.2.1.2 0 0 200i

Table 33 Command output

Field	Description
Status codes	Status codes: · * – valid—Valid route. · > – best—Optimal route. · d – dampened—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – stale—Stale route. · i – internal—Internal route. · e – external—External route. · a – additional-path—Add-Path optimal route.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP. · e – EGP—Learned through EGP. · ?– incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.
Network	Destination network address.
NextHop	Next hop IP address.
MED	MULTI_EXIT_DISC attribute.
LocPrf	Local preference value.
PrefVal	Preferred value of the route.
Path/Ogn	AS_PATH and ORIGIN attributes of the route: · AS_PATH—Records the ASs the route has passed, which avoids routing loops. This field can display only 16 AS numbers. Exceeding AS numbers are omitted. You can view the omitted AS numbers by displaying the detailed route information. · ORIGIN—Identifies the origin of the route.

‌

# Display detailed information about BGP IPv4 unicast routes destined to network 10.2.1.0/24.

<Sysname> display bgp routing-table ipv4 10.2.1.0 24

BGP local router ID: 192.168.100.1

Local AS number: 100

Paths: 2 available, 1 best

BGP routing table information of 10.2.1.0/24:

Imported route.

Original nexthop: 10.2.1.1

OutLabel : NULL

Ext-Community : <HostRoute>, <IP Mobility: Flag 0, SeqNum 3>

RxPathID : 0x0

TxPathID : 0x0

AS-path : (null)

Origin : igp

Attribute value : MED 0, pref-val 0, pre 0

State : valid, local, best, delay, bgp-rib-only

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

Tunnel policy : NULL

Rely tunnel IDs : N/A

From : 10.2.1.2 (192.168.100.2)

Rely nexthop : not resolved

Original nexthop: 10.2.1.2

OutLabel : NULL

RxPathID : 0x0

TxPathID : 0x0

AS-path : 200

Origin : igp

Attribute value : MED 0, pref-val 0, pre 255

State : external

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

Tunnel policy : NULL

Rely tunnel IDs : N/A

# Display detailed information about the BGP IPv4 unicast route destined to address 1.1.1.1/32.

<Sysname> display bgp routing-table ipv4 1.1.1.1 32

BGP local router ID: 192.168.100.1

Local AS number: 100

Paths: 2 available, 1 best

BGP routing table information of 1.1.1.1/32:

From : 10.2.1.1 (192.168.100.3)

Rely nexthop : 10.2.1.1

Original nexthop: 10.2.1.1

OutLabel : 16201

RxPathID : 0x0

TxPathID : 0x0

AS-path : (null)

Origin : igp

PrefixSID : Label index 201

Attribute value : MED 0, pref-val 0, pre 0

State : valid, local, best, delay

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

Tunnel policy : NULL

Rely tunnel IDs : N/A

Backup route.

From : 10.2.1.2 (192.168.100.2)

Rely nexthop : 10.2.1.2

Original nexthop: 10.2.1.2

OutLabel : NULL

RxPathID : 0x0

TxPathID : 0x0

AS-path : 200

Origin : igp

Attribute value : MED 0, pref-val 0, pre 255

State : external

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

Tunnel policy : NULL

Rely tunnel IDs : N/A

Table 34 Command output

Field	Description
Paths	Number of routes: · available—Number of valid routes. · best—Number of optimal routes.
Original nexthop	Original next hop of the route. If the route was obtained from a BGP update message, the original next hop is the next hop IP address in the message.
OutLabel	Outgoing label of the route.
RxPathID	Add-Path ID of received routes.
Ext-Community	Extended community attribute: · HostRoute—Host route. · IP Mobility—IP migration attribute. Flag indicates whether the IP address can be migrated. 1 indicates that the IP address cannot be migrated and 0 indicates that the IP address can be migrated. SeqNum represents the host migration serial number. The larger the serial number, the later the migration.
TxPathID	Add-Path ID of advertised routes.
AS-path	AS_PATH attribute of the route, which records the ASs the route has passed and avoids routing loops.
Origin	Origin of the route: · igp—Originated in the AS. The origin of routes advertised with the network command is IGP. · egp—Learned through EGP. · incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.
PrefixSID	Prefix SID: · Label index—Label index. · SRGB —SRGB range.
Attribute value	BGP path attributes: · MED—MED value. · localpref—Local preference value. · pref-val—Preferred value. · pre—Route preference.
State	Current state of the route: · valid. · internal. · external. · local. · synchronize. · best. · delay—The route will be delayed for optimal route selection. This field is displayed only in the detailed command output. · bgp-rib-only—The route will not be flushed to the routing table. This field is displayed only in the detailed command output.
From	IP address of the BGP peer that advertised the route.
Rely Nexthop	Next hop found by route recursion. If no next hop is found, this field displays not resolved.
IP precedence	IP precedence in the range of 0 to 7. N/A indicates that the route does not support this field.
QoS local ID	QoS local ID in the range of 1 to 4095. N/A indicates that the route does not support this field.
Traffic index	Traffic index in the range of 1 to 64. N/A indicates that the route does not support this field.
Tunnel policy	Tunnel policy that takes effect. NULL indicates that no tunnel policy takes effect.
Rely Tunnel IDs	Tunnel index IDs after route recursion. This field displays multiple tunnel index IDs if ECMP tunnels exist and displays N/A if no tunnels are found by route recursion.

‌

# Display statistics for public BGP IPv4 unicast routes advertised to peer 10.2.1.2.

<Sysname> display bgp routing-table ipv4 peer 10.2.1.2 advertised-routes statistics

Advertised routes total: 2

# Display statistics for public BGP IPv4 unicast routes received from peer 10.2.1.2.

<Sysname> display bgp routing-table ipv4 peer 10.2.1.2 received-routes statistics

Received routes total: 2

Table 35 Command output

Field	Description
Advertised routes total	Total number of advertised routes.
Received routes total	Total number of received routes.

‌

# Display BGP IPv4 unicast route statistics.

<Sysname> display bgp routing-table ipv4 statistics

Total number of routes: 4

Table 36 Command output

Field	Description
Total number of routes	Total number of routes.

‌

# Display advertisement information for the BGP IPv4 unicast route destined to network 10.2.1.0/24.

<Sysname> display bgp routing-table ipv4 10.2.1.0 24 advertise-info

BGP local router ID: 192.168.100.1

Local AS number: 100

Paths: 1 best

BGP routing table information of 10.2.1.0/24(TxPathID:0):

Advertised to peers (1 in total):

10.2.1.2

Table 37 Command output

Field	Description
BGP local router ID	Local BGP router ID.
Local AS number	Local AS number.
Paths	Number of optimal routes to the destination.
BGP routing table information of 10.2.1.0/24(TxPathID:0)	Advertisement information for network 10.2.1.0/24.
Advertised to peers (1 in total)	Peers to which the network has been advertised.

‌

Related commands

ip as-path

ip community-list

display bgp routing-table ipv6 multicast

Use display bgp routing-table ipv6 multicast to display BGP IPv6 multicast routing information.

Syntax

display bgp [ instance instance-name ] routing-table ipv6 multicast [ ipv6-address prefix-length [ advertise-info ] | as-path-acl { as-path-acl-number | as-path-acl-name } | community-list { { basic-community-list-number | comm-list-name } [ whole-match ] | adv-community-list-number } | peer ipv6-address { advertised-routes | received-routes } [ ipv6-address prefix-length | statistics ] | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP IPv6 multicast routing information for the default BGP instance.

ipv6-address prefix-length: Specifies the destination network address and prefix length. The value range for the prefix-length argument is 0 to 128. If you do not specify this argument, the command displays brief information about all BGP IPv6 multicast routing information.

advertise-info: Displays advertisement information for BGP IPv6 multicast routes. If you do not specify this keyword, the command displays the BGP IPv6 multicast routing table.

as-path-acl as-path-acl-number: Displays BGP IPv6 multicast routes that match the AS path list specified by its number in the range of 1 to 256.

as-path-acl as-path-acl-name: Displays BGP IPv6 multicast routes that match the AS path list specified by its name, a case-sensitive string of 1 to 51 characters. The AS path list name cannot contain only digits.

community-list: Displays BGP IPv6 multicast routes that match a community list.

basic-community-list-number: Specifies a basic community list by its number in the range of 1 to 99.

comm-list-name: Specifies a community list by its name, a case-sensitive string of 1 to 63 characters.

whole-match: Displays BGP IPv6 multicast routes exactly matching the specified community list. If you do not specify this keyword, the command displays BGP IPv6 multicast routes whose COMMUNITY attributes include the specified community list.

adv-community-list-number: Specifies an advanced community list by its number in the range of 100 to 199.

peer: Displays BGP IPv6 multicast routing information advertised to or received from the specified peer.

ipv6-address: Specifies the peer IPv6 address.

advertised-routes: Displays BGP IPv6 multicast routing information advertised to the specified peer.

received-routes: Displays BGP IPv6 multicast routing information received from the specified peer.

statistics: Displays routing statistics.

Examples

# Display brief information about all BGP IPv6 multicast routes.

<Sysname> display bgp routing-table ipv6 multicast

Total number of routes: 5

BGP local router ID is 192.168.1.139

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

* > Network : 1:: PrefixLen : 64

NextHop : :: LocPrf :

PrefVal : 32768 OutLabel : NULL

MED : 0

Path/Ogn: ?

* i Network : 1:: PrefixLen : 64

NextHop : 1::1 LocPrf : 100

PrefVal : 0 OutLabel : NULL

MED : 0

Path/Ogn: ?

* > Network : 1::2 PrefixLen : 128

NextHop : ::1 LocPrf :

PrefVal : 32768 OutLabel : NULL

MED : 0

Path/Ogn: ?

* > Network : 2::2 PrefixLen : 128

NextHop : ::1 LocPrf :

PrefVal : 32768 OutLabel : NULL

MED : 0

Path/Ogn: ?

* >i Network : 5::5 PrefixLen : 128

NextHop : 1::1 LocPrf : 100

PrefVal : 0 OutLabel : NULL

MED : 0

Path/Ogn: ?

# Display information about BGP IPv6 multicast routes that match AS path list 1.

<Sysname> display bgp routing-table ipv6 multicast as-path-acl 1

Total number of routes: 5

BGP local router ID is 192.168.1.139

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

* > Network : 1:: PrefixLen : 64

NextHop : :: LocPrf :

PrefVal : 32768 OutLabel : NULL

MED : 0

Path/Ogn: ?

* i Network : 1:: PrefixLen : 64

NextHop : 1::1 LocPrf : 100

PrefVal : 0 OutLabel : NULL

MED : 0

Path/Ogn: ?

* > Network : 1::2 PrefixLen : 128

NextHop : ::1 LocPrf :

PrefVal : 32768 OutLabel : NULL

MED : 0

Path/Ogn: ?

* > Network : 2::2 PrefixLen : 128

NextHop : ::1 LocPrf :

PrefVal : 32768 OutLabel : NULL

MED : 0

Path/Ogn: ?

* >i Network : 5::5 PrefixLen : 128

NextHop : 1::1 LocPrf : 100

PrefVal : 0 OutLabel : NULL

MED : 0

Path/Ogn: ?

# Display information about BGP IPv6 multicast routes that match BGP community list 100.

<Sysname> display bgp routing-table ipv6 multicast community-list 100

Total number of routes: 5

BGP local router ID is 192.168.1.139

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

* > Network : 1:: PrefixLen : 64

NextHop : :: LocPrf :

PrefVal : 32768 OutLabel : NULL

MED : 0

Path/Ogn: ?

* i Network : 1:: PrefixLen : 64

NextHop : 1::1 LocPrf : 100

PrefVal : 0 OutLabel : NULL

MED : 0

Path/Ogn: ?

* > Network : 1::2 PrefixLen : 128

NextHop : ::1 LocPrf :

PrefVal : 32768 OutLabel : NULL

MED : 0

Path/Ogn: ?

* > Network : 2::2 PrefixLen : 128

NextHop : ::1 LocPrf :

PrefVal : 32768 OutLabel : NULL

MED : 0

Path/Ogn: ?

* >i Network : 5::5 PrefixLen : 128

NextHop : 1::1 LocPrf : 100

PrefVal : 0 OutLabel : NULL

MED : 0

Path/Ogn: ?

# Display information about all BGP IPv6 multicast routes advertised to peer 1::1.

<Sysname> display bgp routing-table ipv6 multicast peer 1::1 advertised-routes

Total number of routes: 2

BGP local router ID is 192.168.1.139

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

* > Network : 1:: PrefixLen : 64

NextHop : :: LocPrf : 100

MED : 0 OutLabel : NULL

Path/Ogn: ?

* > Network : 2::2 PrefixLen : 128

NextHop : ::1 LocPrf : 100

MED : 0 OutLabel : NULL

Path/Ogn: ?

# Display information about all BGP IPv6 multicast routes received from peer 1::1.

<Sysname> display bgp routing-table ipv6 multicast peer 1::1 received-routes

Total number of routes: 2

BGP local router ID is 192.168.1.139

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

* i Network : 1:: PrefixLen : 64

NextHop : 1::1 LocPrf : 100

PrefVal : 0 OutLabel : NULL

MED : 0

Path/Ogn: ?

* >i Network : 5::5 PrefixLen : 128

NextHop : 1::1 LocPrf : 100

PrefVal : 0 OutLabel : NULL

MED : 0

Path/Ogn: ?

Table 38 Command output

Field	Description
Status codes	Status codes: · * – valid—Valid route. · > – best—Optimal route. · d – dampened—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – stale—Stale route. · i – internal—Internal route. · e – external—External route. · a – additional-path—Add-Path optimal route.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP. · e – EGP—Learned through EGP. · ?– incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.
Network	Destination network address.
PrefixLen	Prefix length of the destination network address.
NextHop	Next hop IP address.
LocPrf	Local preference value.
PrefVal	Preferred value of the route.
OutLabel	Outgoing label of the route.
MED	MULTI_EXIT_DISC attribute.
Path/Ogn	AS_PATH and ORIGIN attributes of the route: · AS_PATH—Records the ASs the route has passed, which avoids routing loops. · ORIGIN—Identifies the origin of the route.

‌

# Display detailed information about BGP IPv6 multicast routes destined to network 2::2/128.

<Sysname> display bgp routing-table ipv6 multicast 2::2 128

BGP local router ID: 192.168.1.139

Local AS number: 100

Paths: 1 available, 1 best

BGP routing table information of 2::2/128:

Imported route.

Original nexthop: ::1

OutLabel : NULL

RxPathID : 0x0

TxPathID : 0x0

AS-path : (null)

Origin : incomplete

Attribute value : MED 0, pref-val 32768

State : valid, local, best, delay

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

Table 39 Command output

Field	Description
Paths	Number of routes: · available—Number of valid routes. · best—Number of optimal routes.
Original nexthop	Original next hop of the route. If the route was obtained from a BGP update message, the original next hop is the next hop IP address in the message.
OutLabel	Outgoing label of the route.
RxPathID	Add-Path ID of received routes.
TxPathID	Add-Path ID of advertised routes.
AS-path	AS_PATH attribute of the route, which records the ASs the route has passed and avoids routing loops.
Origin	Origin of the route: · igp—Originated in the AS. The origin of routes advertised with the network command is IGP. · egp—Learned through EGP. · incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.
Attribute value	BGP path attributes: · MED—MED value. · localpref—Local preference value. · pref-val—Preferred value. · pre—Route preference.
State	Current state of the route: · valid. · internal. · external. · local. · synchronize. · best. · delay—The route will be delayed for optimal route selection. This field is displayed only in the detailed command output.
From	IP address of the BGP peer that advertised the route.
Rely Nexthop	Next hop found by route recursion. If no next hop is found, this field displays not resolved.
IP precedence	IP precedence in the range of 0 to 7. N/A indicates that the route does not support this field.
QoS local ID	QoS local ID in the range of 1 to 4095. N/A indicates that the route does not support this field.
Traffic index	Traffic index in the range of 1 to 64. N/A indicates that the route does not support this field.

‌

# Display advertisement information for BGP IPv6 multicast routes destined to network 2::2/128.

<Sysname> display bgp routing-table ipv6 multicast 2::2 128 advertise-info

BGP local router ID: 192.168.1.139

Local AS number: 100

Paths: 1 best

BGP routing table information of 2::2/128(TxPathID:0):

Advertised to peers (1 in total):

1::1

Table 40 Command output

Field	Description
BGP local router ID	Local BGP router ID.
Local AS number	Local AS number.
Paths	Number of optimal routes to the destination.
BGP routing table information of 2::2/128(TxPathID:0)	Advertisement information for network 2::2/128.
Advertised to peers (1 in total)	Peers to which the network has been advertised.

‌

# Display statistics for BGP IPv6 multicast routes advertised to peer 1::1.

<Sysname> display bgp routing-table ipv6 multicast peer 1::1 advertised-routes statistics

Advertised routes total: 2

# Display statistics for BGP IPv6 multicast routes received from peer 1::1.

<Sysname> display bgp routing-table ipv6 multicast peer 1::1 received-routes statistics

Received routes total: 2

Table 41 Command output

Field	Description
Advertised routes total	Total number of advertised routes.
Received routes total	Total number of received routes.

‌

# Display BGP IPv6 multicast route statistics.

<Sysname> display bgp routing-table ipv6 multicast statistics

Total number of routes: 5

Table 42 Command output

Field	Description
Total number of routes	Total number of routes.

‌

Related commands

ip as-path

ip community-list

display bgp routing-table ipv6 unicast

Use display bgp routing-table ipv6 unicast to display BGP IPv6 unicast routing information.

Syntax

display bgp [ instance instance-name ] routing-table ipv6 [ unicast ] [ vpn-instance vpn-instance-name ] [ ipv6-address prefix-length [ advertise-info ] | as-path-acl { as-path-acl-number | as-path-acl-name } | community-list { { basic-community-list-number | comm-list-name } [ whole-match ] | adv-community-list-number } | peer ipv6-address { advertised-routes | received-routes } [ ipv6-address prefix-length | statistics ] | statistics ]

display bgp [ instance instance-name ] routing-table ipv6 [ unicast ] peer { ipv4-address | link-local-address interface interface-type interface-number } { advertised-routes | received-routes } [ ipv6-address prefix-length | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP IPv6 unicast routing information for the default BGP instance.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays the BGP IPv6 unicast routing information for the public network.

advertise-info: Displays advertisement information for BGP IPv6 unicast routes. If you do not specify this keyword, the command displays the BGP IPv6 unicast routing table.

as-path-acl as-path-acl-number: Displays BGP IPv6 unicast routes that match the AS path list specified by its number in the range of 1 to 256.

as-path-acl as-path-acl-name: Displays BGP IPv6 unicast routes that match the AS path list specified by its name, a case-sensitive string of 1 to 51 characters. The AS path list name cannot contain only digits.

community-list: Displays BGP IPv6 unicast routes that match a community list.

basic-community-list-number: Specifies a basic community list by its number in the range of 1 to 99.

comm-list-name: Specifies a community list by its name, a case-sensitive string of 1 to 63 characters.

adv-community-list-number: Specifies an advanced community list by its number in the range of 100 to 199.

peer: Displays BGP IPv6 unicast routing information advertised to or received from the specified peer.

ipv4-address: Specifies the peer IPv4 address.

ipv6-address: Specifies the peer IPv6 address.

link-local-address: Specifies a peer by its link-local address.

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

advertised-routes: Displays routing information advertised to the specified peer.

received-routes: Displays routing information received from the specified peer.

statistics: Displays routing statistics.

Usage guidelines

This command displays BGP IPv6 unicast routing information regardless of whether the unicast keyword is specified.

Examples

# Display brief information about all BGP IPv6 unicast routes.

<Sysname> display bgp routing-table ipv6

Total number of routes: 1

BGP local router ID is 192.168.1.136

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

* >e Network : 3:: PrefixLen : 64

NextHop : 1::2 LocPrf :

PrefVal : 0 OutLabel : NULL

MED :

Path/Ogn: 4294967295 4294967294 4294967293 4294967292 4294967291 4294967290 4294967215 4294967225 4294967235 4294967245 4294967295 4294967294 4294967293 4294967292 4294967291 4294967290... i

# Display information about BGP IPv6 unicast routes that match AS path list 1.

<Sysname> display bgp routing-table ipv6 as-path-acl 1

Total number of routes: 2

BGP local router ID is 192.168.1.136

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

* >e Network : 2:: PrefixLen : 64

NextHop : 1::2 LocPrf :

PrefVal : 0 OutLabel : NULL

MED :

Path/Ogn: 100i

* >e Network : 3:: PrefixLen : 64

NextHop : 1::2 LocPrf :

PrefVal : 0 OutLabel : NULL

MED :

Path/Ogn: 100i

# Display information about BGP IPv6 unicast routes that match BGP community list 100.

<Sysname> display bgp routing-table ipv6 community-list 100

Total number of routes: 2

BGP local router ID is 192.168.1.136

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

* >e Network : 2:: PrefixLen : 64

NextHop : 1::2 LocPrf :

PrefVal : 0 OutLabel : NULL

MED :

Path/Ogn: 100i

* >e Network : 3:: PrefixLen : 64

NextHop : 1::2 LocPrf :

PrefVal : 0 OutLabel : NULL

MED :

Path/Ogn: 100i

# Display information about all BGP IPv6 unicast routes advertised to peer 1::1.

<Sysname> display bgp routing-table ipv6 peer 1::1 advertised-routes

Total number of routes: 1

BGP local router ID is 192.168.1.136

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

* > Network : 2:: PrefixLen : 64

NextHop : :: LocPrf :

MED : 0 OutLabel : NULL

Path/Ogn: i

# Display information about all BGP IPv6 unicast routes received from peer 1::1.

<Sysname> display bgp routing-table ipv6 peer 1::1 received-routes

Total number of routes: 1

BGP local router ID is 192.168.1.135

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a – additional-path

Origin: i - IGP, e - EGP, ? - incomplete

* >e Network : 2:: PrefixLen : 64

NextHop : ::FFFF:10.1.1.1 LocPrf :

PrefVal : 0 OutLabel : NULL

MED : 0

Path/Ogn: 100i

Table 43 Command output

Field	Description
Status codes	Status codes: · * – valid—Valid route. · > – best—Optimal route. · d – dampened—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – stale—Stale route. · i – internal—Internal route. · e – external—External route. · a – additional-path—Add-Path optimal route.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP. · e – EGP—Learned through EGP. · ?– incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.
Network	Destination network address.
PrefixLen	Prefix length of the destination network address.
NextHop	Next hop IPv6 address.
LocPrf	Local preference value.
PrefVal	Preferred value of the route.
OutLabel	Outgoing label of the route.
MED	MULTI_EXIT_DISC attribute.
Path/Ogn	AS_PATH and ORIGIN attributes of the route: · AS_PATH attribute—Records the ASs the route has passed, which avoids routing loops. This field can display only 16 AS numbers. Exceeding AS numbers are omitted. You can view the omitted AS numbers by displaying the detailed route information. · ORIGIN attribute—Identifies the origin of the route.

‌

# Display detailed information about BGP IPv6 unicast routes destined to network 2::/64.

<Sysname> display bgp routing-table ipv6 2:: 64

BGP local router ID: 192.168.1.135

Local AS number: 200

Paths: 2 available, 1 best

BGP routing table information of 2::/64:

From : 10.1.1.1 (192.168.1.136)

Relay nexthop : ::FFFF:10.1.1.1

Original nexthop: ::FFFF:10.1.1.1

OutLabel : NULL

Ext-Community : <HostRoute>, <IP Mobility: Flag 0, SeqNum 1>

RxPathID : 0x0

TxPathID : 0x0

AS-path : 100

Origin : igp

Attribute value : MED 0, pref-val 0

State : valid, external, best, delay, bgp-rib-only

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

Tunnel policy : NULL

Rely tunnel IDs : N/A

From : 1::1 (192.168.1.136)

Relay nexthop : 1::1

Original nexthop: 1::1

OutLabel : NULL

RxPathID : 0x0

TxPathID : 0x0

AS-path : 100

Origin : igp

Attribute value : MED 0, pref-val 0

State : valid, external

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

Tunnel policy : NULL

Rely tunnel IDs : N/A

Table 44 Command output

Field	Description
Paths	Number of routes: · available—Number of valid routes. · best—Number of optimal routes.
Original nexthop	Original next hop of the route. If the route was obtained from a BGP update message, the original next hop is the next hop IP address in the message.
OutLabel	Outgoing label of the route.
Ext-Community	Extended community attribute: · HostRoute—Host route. · IP Mobility—IP migration attribute. Flag indicates whether the IP address can be migrated. 1 indicates that the IP address cannot be migrated and 0 indicates that the IP address can be migrated. SeqNum represents the host migration serial number. The larger the serial number, the later the migration.
RxPathID	Add-Path ID of received routes.
TxPathID	Add-Path ID of advertised routes.
AS-path	AS_PATH attribute of the route, which records the ASs the route has passed and avoids routing loops.
Origin	Origin of the route: · igp—Originated in the AS. The origin of routes advertised with the network command is IGP. · egp—Learned through EGP. · incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.
Attribute value	BGP path attributes: · MED—MED value. · localpref—Local preference value. · pref-val—Preferred value. · pre—Route preference.
State	Current state of the route: · valid. · internal. · external. · local. · best. · delay—The route will be delayed for optimal route selection. This field is displayed only in the detailed command output. · bgp-rib-only—The route will not be flushed to the routing table. This field is displayed only in the detailed command output.
From	IP address of the BGP peer that advertised the route.
Relay Nexthop	Next hop found by route recursion. If no next hop is found, this field displays not resolved.
IP precedence	IP precedence in the range of 0 to 7. N/A indicates that the route does not support this field.
QoS local ID	QoS local ID in the range of 1 to 4095. N/A indicates that the route does not support this field.
Traffic index	Traffic index in the range of 1 to 64. N/A indicates that the route does not support this field.
Tag	Route tag. This field is supported only in Release 6635 and later.
Tunnel policy	Tunnel policy that takes effect. NULL indicates that no tunnel policy takes effect.
Rely Tunnel IDs	Tunnel index IDs after route recursion. This field displays multiple tunnel index IDs if ECMP tunnels exist and displays N/A if no tunnels are found by route recursion.

‌

# Display advertisement information for BGP IPv6 unicast routes destined to network 2::/64.

<Sysname> display bgp routing-table ipv6 2:: 64 advertise-info

BGP local router ID: 192.168.1.136

Local AS number: 100

Paths: 1 best

BGP routing table information of 2::/64(TxPathID:0):

Advertised to peers (2 in total):

10.1.1.2

1::2

Table 45 Command output

Field	Description
Paths	Number of optimal routes destined to the specified network.
BGP routing table information of 2::/64(TxPathID:0)	Advertisement information for BGP routes destined to network 2::/64.
Advertised to peers (2 in total)	Peers to which the route has been advertised, and the number of peers.

‌

# Display statistics for BGP IPv6 unicast routes advertised to peer 1::1.

<Sysname> display bgp routing-table ipv6 peer 1::1 advertised-routes statistics

Advertised routes total: 1

# Display statistics for BGP IPv6 unicast routes received from peer 1::1.

<Sysname> display bgp routing-table ipv6 peer 1::1 received-routes statistics

Received routes total: 1

Table 46 Command output

Field	Description
Advertised routes total	Total number of advertised routes.
Received routes total	Total number of received routes.

‌

# Display BGP IPv6 unicast route statistics.

<Sysname> display bgp routing-table ipv6 statistics

Total number of routes: 4

Table 47 Command output

Field	Description
Total number of routes	Total number of routes.

‌

Related commands

ip as-path

ip community-list

display bgp routing-table ipv6 unicast inlabel

Use display bgp routing-table ipv6 unicast inlabel to display incoming labels for BGP IPv6 unicast routes.

Syntax

display bgp [ instance instance-name ] routing-table ipv6 [ unicast ] inlabel

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays incoming labels of BGP IPv6 unicast routes in the default BGP instance.

Usage guidelines

This command displays incoming labels for BGP IPv6 unicast routes regardless of whether the unicast keyword is specified.

Examples

# Display incoming labels for all BGP IPv6 unicast routes.

<Sysname> display bgp routing-table ipv6 inlabel

Total number of routes: 2

BGP local router ID is 2.2.2.2

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a - additional-path

Origin: i - IGP, e - EGP, ? - incomplete

* > Network : 1::1 PrefixLen : 128

NextHop : 10::1 OutLabel : NULL

InLabel : 1279

* > Network : 10:: PrefixLen : 64

NextHop : :: OutLabel : NULL

InLabel : 1278

Table 48 Command output

Field	Description
Status codes	Status codes. For more information, see Table 43.
Origin	Origin of the route. For more information, see Table 43.
Network	Destination network address.
PrefixLen	Prefix length of the destination network address.
NextHop	Next hop IPv6 address.
OutLabel	Outgoing label of the IPv6 unicast route, which is assigned by the peer 6PE device.
InLabel	Incoming label of the IPv6 unicast route, which is assigned by the local 6PE device.

‌

display bgp routing-table ipv6 unicast outlabel

Use display bgp routing-table ipv6 unicast outlabel to display outgoing labels for BGP IPv6 unicast routes.

Syntax

display bgp [ instance instance-name ] routing-table ipv6 [ unicast ] outlabel

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command display outgoing labels of BGP IPv6 unicast routes in the default BGP instance.

Usage guidelines

This command displays outgoing labels for BGP IPv6 unicast routes regardless of whether the unicast keyword is specified.

Examples

# Display outgoing labels for all BGP IPv6 unicast routes.

<Sysname> display bgp routing-table ipv6 outlabel

Total number of routes: 2

BGP local router ID is 2.2.2.2

Status codes: * - valid, > - best, d - dampened, h - history

s - suppressed, S - stale, i - internal, e - external

a - additional-path

Origin: i - IGP, e - EGP, ? - incomplete

* >i Network : 4::4 PrefixLen : 128

NextHop : ::FFFF:3.3.3.3 OutLabel : 1279

* >i Network : 20:: PrefixLen : 64

NextHop : ::FFFF:3.3.3.3 OutLabel : 1278

Table 49 Command output

Field	Description
Status codes	Status codes. For more information, see Table 43.
Origin	Origin of the route. For more information, see Table 43.
Network	Destination network address.
PrefixLen	Prefix length of the destination network address.
NextHop	Next hop IPv6 address.
OutLabel	Outgoing label of the IPv6 unicast route, which is assigned by the peer 6PE device.

‌

display bgp rpki server

Use display bgp rpki server to display information about connections to RPKI servers.

Syntax

display bgp [ instance instance-name ] rpki server [ [ vpn-instance vpn-instance-name ] ipv4-address ]

display bgp [ instance instance-name ] rpki server [ [ vpn-instance vpn-instance-name ] ipv6-address ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays information for the public network.

ipv4-address: Specifies an RPKI server by its IPv4 address.

ipv6-address: Specifies an RPKI server by its IPv6 address.

Examples

# Display brief information about connections to RPKI servers.

<Sysname> display bgp rpki server

Server VPN-index Port State Time ROAs(IPv4/IPv6)

1.1.1.2 0 1234 Establish 00:05:51 1/0

2.2.2.2 0 1234 Establish 00:06:07 3/1

Table 50 Command output

Field	Description
Server	IP address of the RPKI server.
VPN-index	VPN index.
Port	Port number of the RPKI server.
State	Connection state: · Establish—BGP has established a connection to the RPKI server. · Connect—BGP is establishing a connection to the RPKI server. · Shutdown—BGP has not established a connection to the RPKI server.
Time	Duration of the current connection state.
ROAs(IPv4/IPv6)	Number of IPv4/IPv6 ROAs.

‌

# Display detailed information about the connection to RPKI server 2.2.2.1.

<Sysname> display bgp rpki server 2.2.2.1

RPKI Cache-Server 2.2.2.1

Port: TCP port 1234

Local addr: 2.2.2.2, Local port: 14342

Connect state: Establish

Total byte Rx: 72

Total byte Tx: 8

Session ID: 1

Serial number: 1

Last PDU type 7, Time: 00:00:15

Last disconnect reason: Response timer expired

Table 51 Command output

Field	Description
RPKI Cache-Server	IP address of the RPKI server.
Port	Port number of the RPKI server.
Local addr	Local IP address of the connection.
Local port	Local port number of the connection.
Connect state	Connection state: · Establish—BGP has established a connection to the RPKI server. · Connect—BGP is establishing a connection to the RPKI server. · Shutdown—BGP has not established a connection to the RPKI server.
Total byte Rx	Number of received bytes.
Total byte Tx	Number of sent bytes.
Session ID	Session ID assigned by the RPKI server.
Serial number	Serial number assigned by the RPKI server.
Last PDU Type	Type of the most recently received PDU.
Time	Duration of the current connection state.
Last disconnect reason	Reason for the most recent connection interruption: · Confingure reset—The port number used to establish the connection was changed or the reset bgp rpki server command was executed. · Receive error report PDU—Received error report packets from the server. · Response timer expired—No response was received within the response time from the RPKI server. · Receive error PDU—Received error packets. · TCP connect failed—The TCP connection was down. · Shutdown port—No port number was specified. · Not enough memory—The memory was insufficient. · Receive cache reset PDU—Received reset packets from the RPKI server.

‌

display bgp rpki table

Use display bgp rpki table to display the ROA information obtained from RPKI servers.

Syntax

display bgp [ instance instance-name ] rpki table ipv4 [ ipv4-address min min-length max max-length ]

display bgp [ instance instance-name ] rpki table ipv6 [ ipv6-address min min-length max max-length ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ipv4: Displays information about ROAs with IPv4 prefixes.

ipv4-address: Specifies an IPv4 prefix.

ipv6: Displays information about ROAs with IPv6 prefixes.

ipv6-address: Specifies an IPv6 prefix.

min-length: Specifies the minimum prefix length. The value range for this argument is 0 to 32 for IPv4 prefixes and 0 to 128 for IPv6 prefixes.

max-length: Specifies the maximum prefix length. The value range for this argument is 0 to 32 for IPv4 prefixes and 0 to 128 for IPv6 prefixes.

Examples

# Display brief information about ROAs with IPv4 prefixes.

<Sysname> display bgp rpki table ipv4

Total number of entries: 4

Status codes: S - stale, U - used

Network Mask-range Origin-AS Server Status

1.2.3.4 8-32 100 1.1.1.2 U

5.2.3.4 8-32 100 2.2.2.2 U

6.6.6.6 8-32 100 2.2.2.2 U

7.7.7.7 8-32 20 2.2.2.2 U

Table 52 Command output

Field	Description
Total number of entries	Total number of ROAs.
Network	Network address.
Mask-range	Mask or prefix length range.
Server	IP address of the RPKI server.
Status	ROA state: · U—The ROA is available. · S—The ROA is in aging state.

‌

# Display detailed information about ROAs with IPv4 prefixes.

<Sysname> display bgp rpki table ipv4 5.2.3.4 min 8 max 32

RPKI ROA entry for 5.2.3.4/8-32

Origin-AS: 100 from 2.2.2.1, used

Table 53 Command output

Field

Description

Origin-AS

ROA information:

· AS number.

· IP address of the RPKI server.

· ROA state:

¡ used—The ROA is available.

¡ stale—The ROA is in aging state.

‌

display bgp troubleshooting

Use display bgp troubleshooting to display information about BGP peer relationship down events.

Syntax

display bgp [ instance instance-name ] troubleshooting [ event-count ] [ reverse ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

event-count: Specifies the number of peer relationship down events to display, in the range of 1 to 1000. If you do not specify this argument, the command displays information about the earliest or most recent 20 events based on the configuration of the reverse keyword.

reverse: Displays peer relationship down events in chronological order. If you do not specify this keyword, the command displays peer relationship down events in reverse chronological order.

Usage guidelines

Configure this command to display information about BGP peer relationship down events, including the time, reason, and recommended action.

Examples

# Display reasons why BGP peer relationships went down.

<Sysname> display bgp troubleshooting

Total number: 1

Date Time Event description

-----------------------------------------------------------------------

2018-10-06 09:39:18 The BGP peer 10.1.1.1 went down because the

peer ignore command was configured manually.

Please check local BGP configuration.

-----------------------------------------------------------------------

Table 54 Command output

Field	Description
Total number	Total number of peer relationships that went down.
Date	Date (in YYYY-MM-DD format) on which a specific BGP peer relationship went down.
Time	Time (in HH:MM:SS format) when a specific BGP peer relationship went down.
Event description	Description for a specific peer down event. The description format is The BGP peer ip-address went down because peer-down-reason. Please treatment-suggestion. ip-address represents the IP address of the peer, peer-down-reason represents the down reason, and treatment-suggestion represents the recommended action to take.

‌

Related commands

maintenance-probe enable (Layer 3—IP Routing Command Reference)

display bgp update-group

Use display bgp update-group to display information about BGP update groups.

Syntax

display bgp [ instance instance-name ] update-group ipv4 [ mdt | multicast | rtfilter | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ ipv4-address ]

display bgp [ instance instance-name ] update-group ipv6 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ ipv6-address ]

display bgp [ instance instance-name ] update-group ipv6 [ unicast ] [ ipv4-address ]

display bgp [ instance instance-name ] update-group ipv4 [ unicast ] [ ipv6-address ]

display bgp [ instance instance-name ] update-group link-state [ ipv4-address | ipv6-address ]

display bgp [ instance instance-name ] update-group vpnv4 [ vpn-instance vpn-instance-name ] [ ipv4-address ]

display bgp [ instance instance-name ] update-group l2vpn [ ipv4-address ]

display bgp [ instance instance-name ] update-group l2vpn evpn [ ipv4-address | ipv6-address ]

display bgp [ instance instance-name ] update-group vpnv6 [ ipv4-address ]

display bgp [ instance instance-name ] update-group dedicated [ ipv4-address | ipv6-address ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP update group information for the default BGP instance.

ipv4: Displays BGP update group information for IPv4 address family.

ipv6: Displays BGP update group information for IPv6 address family.

link-state: Displays BGP update group information for LS address family.

vpnv4: Displays BGP update group information for VPNv4 address family.

l2vpn: Displays BGP update group information for L2VPN address family.

evpn: Displays BGP update group information for EVPN address family.

vpnv6: Displays BGP update group information for VPNv6 address family.

mdt: Displays BGP update group information for MDT address family.

multicast: Displays BGP update group information for multicast address family.

rtfilter: Displays BGP update group information for BGP IPv4 RT filter address family.

dedicated: Displays BGP update group information for BGP dedicated address family.

unicast: Displays BGP update group information for unicast address family.

vpn-instance vpn-instance-name: Displays BGP update group information for the MPLS L3VPN instance specified by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays update group information for the public network.

ipv4-address: Displays BGP update group information for the specified BGP peer.

ipv6-address: Displays BGP update group information for the specified IPv6 BGP peer.

Usage guidelines

The update group feature classifies BGP peers that have the same export policy into an update group. When BGP advertises routes to the peers in the update group, it uses the export policy to filter the routes and generates route updates for all the peers only once.

With this feature, BGP performs one-time policy filtering and encapsulation for a prefix before advertising the prefix to all the peers in the update group. For example, BGP advertises 1000 prefixes to 1000 peers that have the same export policy (in data centers for example). Without the update group feature, BGP matches the export policy 1000 × 1000 times. With the update group feature, BGP matches the export policy only 1000 × 1 times, improving encapsulation efficiency 1000 times.

If you do not specify any parameters, this command displays all update groups for the specified address family on the public network.

By default, the unicast keyword is used if the unicast, multicast, and mdt keywords are not specified.

Examples

# Display information about all BGP update groups for the IPv4 unicast address family.

<Sysname> display bgp update-group ipv4

Update-group ID: 0

Type: EBGP link

05-Layer 3-IP Routing Command Reference

BGP commands

address-family ipv6

bestroute med-confederation

bestroute origin-as-validation

check-origin-validation

confederation nonstandard

dampening

display bgp non-stop-routing status

display bgp peer

display bgp routing-table dedicated

display bgp routing-table ipv4 unicast

display bgp routing-table ipv6 multicast

display bgp routing-table ipv6 unicast