This command takes effect for only the routes generated after you execute this command. To make this command take effect for the routes generated before you execute this command, use the reset bgp command to reset BGP sessions.

Examples

# Enable BGP to advertise optimal routes in the IP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] 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 instance view/BGP-VPN IPv4 unicast instance view:

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

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

In BGP IPv6 unicast instance 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 route is configured.

Views

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

Predefined user roles

network-admin

mdc-admin

Parameters

ip-address: Specifies a summary address.

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

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

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 of all summarized routes. The AS_PATH attribute is of the AS_SET type that requires no sequence when arranging AS numbers. If this keyword is not specified, 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 this keyword is not specified, 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.

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.

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.

If the summarized routes have different COMMUNITY attributes, the summary route that does not have the ATOMIC_AGGREGATE attribute carries all the COMMUNITY attributes.

Table 1 Functions of the keywords

Keywords	Function
as-set	Enables the summary route to carry the AS path information of 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 because 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.
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 satisfying 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, and is not controlled by the detail-suppressed and suppress-policy keywords. There is no need to configure apply clauses for the routing policy referenced 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 referenced by the suppress-policy keyword because they do not take effect.

Examples

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

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] aggregate 1.1.0.0 255.255.0.0

# In BGP IPv4 unicast instance view, create a summary route 1.1.0.0/16 in the BGP routing table. Specify the AS_PATH attribute for the summary route to contain the AS path information of all summarized routes, and advertise only the summary route.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] aggregate 1.1.0.0 255.255.0.0 as-set detail-suppressed

# In BGP IPv4 unicast instance view, create a summary route 1.1.0.0/16 in the BGP routing table, and set the COMMUNITY attribute of the summary route to INTERNET.

<Sysname> system-view

[Sysname] route-policy commu permit node 0

[Sysname-route-policy-commu-0] apply community internet

[Sysname-route-policy-commu-0] quit

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] aggregate 1.1.0.0 255.255.0.0 attribute-policy commu

# In BGP IPv4 unicast instance view, create a summary route 1.1.0.0/16 in the BGP routing table, and configure BGP to not summarize route 1.1.1.0/24.

<Sysname> system-view

[Sysname] ip prefix-list spert deny 1.1.1.0 24

[Sysname] ip prefix-list spert permit 0.0.0.0 0 less-equal 32

[Sysname] route-policy srcrt permit node 0

[Sysname-route-policy-srcrt-0] if-match ip address prefix-list spert

[Sysname-route-policy-srcrt-0] quit

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] aggregate 1.1.0.0 255.255.0.0 origin-policy srcrt

# In BGP IPv4 unicast instance view, create a summary route 1.1.0.0/16 in the BGP routing table, and disable BGP to advertise the specific route 1.1.1.0/24.

<Sysname> system-view

[Sysname] ip prefix-list spert deny 1.1.1.0 24

[Sysname] ip prefix-list spert permit 0.0.0.0 0 less-equal 32

[Sysname] route-policy suprt permit node 0

[Sysname-route-policy-suprt-0] if-match ip address prefix-list spert

[Sysname-route-policy-suprt-0] quit

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] aggregate 1.1.0.0 255.255.0.0 suppress-policy suprt

# In BGP-VPN IPv4 unicast instance view, create a summary route 1.1.0.0/16 in BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

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

# In BGP IPv6 unicast instance view, create a summary route 12::/64 in the IPv6 BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-ipv6] aggregate 12:: 64

Related commands

· display bgp routing-table ipv4 unicast

· display bgp routing-table ipv6 unicast

· summary automatic

balance

Use balance to specify the maximum number of BGP ECMP routes for load balancing.

Use undo balance to disable load balancing.

Syntax

balance number

undo balance

Default

Load balancing is not enabled.

Views

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

Predefined user roles

network-admin

mdc-admin

Parameters

number: Specifies the maximum number of BGP ECMP routes, in the range of 1 to 32. When it is set to 1, load balancing is disabled.

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 have the same AS_PATH, ORIGIN, LOCAL_PREF, and MED attributes, you can use the balance command to implement load balancing over these routes.

Examples

# In BGP IPv4 unicast instance view, enable load balancing and specify the maximum number of BGP ECMP routes used for load balancing as 2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] balance 2

# In BGP-VPN IPv6 unicast instance view, enable load balancing and specify the maximum number of BGP ECMP routes for load balancing as 2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] balance 2

bestroute as-path-neglect

Use bestroute as-path-neglect to configure BGP to not consider the AS_PATH during best route selection.

Use undo bestroute as-path-neglect to configure BGP to consider the AS_PATH during best route selection.

Syntax

bestroute as-path-neglect

undo bestroute as-path-neglect

Default

BGP considers the AS_PATH during best route selection.

Views

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

Predefined user roles

network-admin

mdc-admin

Examples

# In BGP IPv4 unicast instance view, ignore AS_PATH in route selection.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

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

# In BGP-VPN IPv6 unicast instance view, ignore AS_PATH in route selection.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] 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 IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP IPv6 unicast instance view

Predefined user roles

network-admin

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

With the bestroute compare-med command configured, the router puts routes received from the same AS into a group. The router then selects the route with the lowest MED from the same group, and compares routes from different groups. This mechanism avoids the above-mentioned problem.

If the bestroute compare-med and balance commands are configured at the same time, the balance command does not take effect.

Examples

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

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] bestroute compare-med

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

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] bestroute compare-med

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

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] bestroute compare-med

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 IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP IPv6 unicast instance view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

This command enables BGP to compare the MEDs of routes received from confederation peers. However, if a route received 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 that 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 IPv4 unicast instance view, enable MED comparison for routes received from confederation peers.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] bestroute med-confederation

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

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] bestroute med-confederation

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

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] bestroute med-confederation

bgp

Use bgp to enable BGP and enter the BGP view.

Use undo bgp to disable BGP.

Syntax

bgp as-number

undo bgp [ as-number ]

Default

BGP is not enabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

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

Usage guidelines

A router can reside in only one AS, so the router can run only one BGP process.

A router supports 4-byte AS number.

Examples

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

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp]

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 disable the comparison.

Syntax

compare-different-as-med

undo compare-different-as-med

Default

The comparison is disabled.

Views

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

Predefined user roles

network-admin

mdc-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 IPv4 unicast instance view, enable MED comparison for routes from peers in different ASs.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

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

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

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] compare-different-as-med

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

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

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

confederation id

Use confederation id to configure a confederation ID.

Use undo confederation id to remove the specified confederation ID.

Syntax

confederation id as-number

undo confederation id

Default

No confederation ID is configured.

Views

BGP view

Predefined user roles

network-admin

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

On a member outside of a confederation, to establish a BGP connection to a specific router in that confederation, specify the AS number of the router as the confederation ID.

Examples

# Confederation 9 consists of four sub-ASs numbered 38, 39, 40 and 41. The peer 10.1.1.1 is a member of sub-AS 38. The 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 the peer 200.1.1.1. This example uses a router in sub-AS 41.

<Sysname> system-view

[Sysname] bgp 41

[Sysname-bgp] confederation id 9

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

[Sysname-bgp] group Confed38 external

[Sysname-bgp] peer Confed38 as-number 38

[Sysname-bgp] peer 10.1.1.1 group Confed38

[Sysname-bgp] group Remote98 external

[Sysname-bgp] peer Remote98 as-number 98

[Sysname-bgp] 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 view

Predefined user roles

network-admin

mdc-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 comprises 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] confederation id 100

[Sysname-bgp] confederation peer-as 65000

[Sysname-bgp] confederation nonstandard

Related commands

· confederation id

· confederation peer-as

confederation peer-as

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

Use undo confederation peer-as to remove 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 view

Predefined user roles

network-admin

mdc-admin

Parameters

as-number-list: Specifies a sub-AS number list. Up to 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 up to 32 numbers can be specified.

Usage guidelines

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

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

Examples

# Specify confederation peer sub-ASs 2000 and 2001.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] confederation id 10

[Sysname-bgp] confederation peer-as 2000 2001

Related commands

· confederation id

· confederation nonstandard

dampening

Use dampening to enable BGP route dampening.

Use undo dampening to disable route dampening.

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 instance view, BGP-VPN IPv4 unicast instance view, BGP IPv6 unicast instance view, BGP-VPN IPv6 unicast instance view

Predefined user roles

network-admin

mdc-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 value must be less than the suppression threshold value.

suppress: Specifies a suppression threshold in the range of 1 to 20000. The route with a penalty value higher 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 bigger 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

The command dampens only EBGP routes.

Examples

# In BGP IPv4 unicast instance view, configure BGP route dampening.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

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

# In BGP-VPN IPv4 unicast instance view, configure BGP route dampening.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

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

# In BGP IPv6 unicast instance view, configure BGP route dampening.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] dampening 10 10 1000 2000 10000

# In BGP-VPN IPv6 unicast instance view, configure BGP route dampening.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] dampening 10 10 1000 2000 10000

Related commands

· display bgp dampening parameter ipv4 unicast

· display bgp dampening parameter ipv6 unicast

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 instance view, BGP-VPN IPv4 unicast instance view, BGP IPv6 unicast instance view, BGP-VPN IPv6 unicast instance view

Predefined user roles

network-admin

mdc-admin

Parameters

value: Specifies a default local preference in the range of 0 to 4294967295. The larger the value, the higher the 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, and other BGP routes use the local preference set by the default local-preference command.

Examples

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

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

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

# In BGP-VPN IPv6 unicast instance view, set the default local preference to 180.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] 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 instance view, BGP-VPN IPv4 unicast instance view, BGP IPv6 unicast instance view, BGP-VPN IPv6 unicast instance view

Predefined user roles

network-admin

mdc-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 instance view, configure the default MED as 25.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] default med 25

# In BGP-VPN IPv6 unicast instance view, configure the default MED as 25.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] 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 is not enabled.

Views

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

Predefined user roles

network-admin

mdc-admin

Usage guidelines

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

Examples

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

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] default-route imported

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

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

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

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

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

# In BGP IPv6 unicast instance view, enable default route redistribution from OSPFv3 process 1 into the IPv6 BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] default-route imported

[Sysname-bgp-ipv6] import-route ospfv3 1

# In BGP-VPN IPv6 unicast instance view, enable default route redistribution from OSPFv3 process 1 into the IPv6 BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] default-route imported

[Sysname-bgp-ipv6-vpn1] import-route ospfv3 1

Related commands

import-route

display bgp dampening parameter ipv4 unicast

Use display bgp dampening parameter ipv4 unicast to display BGP IPv4 unicast route dampening parameters.

Syntax

display bgp dampening parameter ipv4 [ unicast ] [ vpn-instance vpn-instance-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If no VPN is specified, the command displays BGP IPv4 unicast route dampening parameters for the public network.

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display BGP IPv4 unicast route dampening parameters for the public network.

<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 2 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 dampening parameter ipv6 unicast

Use display bgp dampening parameter ipv6 unicast to display BGP IPv6 unicast route dampening parameters.

Syntax

display bgp dampening parameter ipv6 [ unicast ] [ vpn-instance vpn-instance-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If no VPN is specified, the command displays BGP IPv6 unicast route dampening parameters for the public network.

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display BGP IPv6 unicast route dampening parameters for the public network.

<Sysname> display bgp dampening parameter ipv6

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

Use display bgp group ipv4 unicast to display BGP IPv4 unicast peer group information.

Syntax

display bgp group ipv4 [ unicast ] [ vpn-instance vpn-instance-name ] [ group-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

group-name: Specifies a BGP IPv4 unicast peer group by its name, a case-sensitive string of 1 to 47 characters. If no group is specified, this command displays brief information about all BGP IPv4 unicast peer groups.

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display brief information about all BGP IPv4 unicast peer groups for the public network.

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 for the public network.

<Sysname> display bgp group ipv4 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

Routing policy configured:

No routing policy is configured

Members:

Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State

1.1.1.10 600 0 0 0 0 00:00:55 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—IBGP peer group. · internal—EBGP 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 alarm messages.
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.
Routing policy configured	Routing policy configured for the peer group. If no routing policy is specified, this field displays "No routing policy is configured."
Members	Information about peers included in the peer group.
Peer	IP 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	Number of prefixes received.
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 bgp group ipv6 unicast

Use display bgp group ipv6 unicast to display BGP IPv6 unicast peer group information.

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

group-name: Specifies a BGP IPv6 unicast peer group by its name, a case-sensitive string of 1 to 47 characters. If no group is specified, this command displays brief information about all BGP IPv6 unicast peer groups.

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display brief information about all BGP IPv6 unicast peer groups for the public network.

<Sysname> display bgp group ipv6

BGP peer group: abc

Remote AS number: not specified

Type: external

Members:

1::1

BGP peer group: group1

Remote AS: 600

Type: external

Members:

2::2

3::3

# Display detailed information about BGP IPv6 unicast peer group group1 for the public network.

<Sysname> display bgp group ipv6 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

Routing policy configured:

No routing policy is configured

Members:

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 5 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—IBGP peer group. · internal—EBGP 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 alarm messages.
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 the routes from the peer.
Routing policy configured	Routing policy configured for the peer group. If no routing policy is specified, this field displays "No routing policy is configured."
Members	Information of the peers included in the peer group.
Peer	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	Number of prefixes received.
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 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 network { ipv4 | ipv6 } [ unicast ] [ vpn-instance vpn-instance-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

ipv4: Displays IPv4 address family information.

ipv6: Displays IPv6 address family information.

unicast: Displays IPv4 or IPv6 unicast address family information regardless of whether this keyword is specified or not.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If no VPN is specified, the command displays routing information for the public network.

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 for the public network.

<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 for the public network.

<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

# 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 in VPN instance vpn1.

<Sysname> display bgp network ipv4 vpn-instance vpn1

BGP local router ID: 192.168.1.135

Local AS number: 100

Network Mask Route-policy Short-cut

50.1.1.0 255.255.255.0 No

40.1.1.0 255.255.255.0 Yes

Table 6 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	Indicates whether the route is a shortcut route: · Yes · No

display bgp paths

Use display bgp paths to display BGP path attribute information.

Syntax

display bgp paths [ as-regular-expression ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

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. Without this argument, this 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 7 Command output

Field	Description
RefCount	Number of BGP routes with these path attributes.
MED	MED attribute value.
Path/Origin	AS_PATH and ORIGIN attributes of the route: · AS_PATH attribute—Records the ASs the route has passed to avoid routing loops. · ORIGIN attribute—Identifies the origin of the route: ¡ i—Originated in the AS. The origin of summary routes and 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 ipv4 unicast

Use display bgp peer ipv4 unicast to display BGP IPv4 unicast peer or peer group information.

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

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

ip-address: Specifies a peer by its IP address.

log-info: Displays log information.

verbose: Displays detailed information.

Usage guidelines

If no parameter is specified, this command displays brief information about all BGP IPv4 unicast peers.

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display brief information about all BGP IPv4 unicast peers for the public network.

<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

Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State

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

Table 8 Command output

Field	Description
Peer	IP 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	Number of prefixes received.
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 detailed information about BGP IPv4 unicast peer 10.2.1.2 for the public network.

<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 support BGP multi-protocol extended

Peer support BGP route refresh capability

Peer support BGP route AS4 capability

Address family IPv4 Unicast: advertised and received

Received: Total 13 messages, Update messages 0

Sent: Total 16 messages, Update messages 0

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

BFD: Enabled

Routing policy configured:

No routing policy is configured

Table 9 Command output

Field	Description
Peer	IP address of the peer.
Local	Local router ID.
Type	BGP connection type between the local router and the peer: · IBGP link—IBGP connection. · EBGP link—EBGP connection.
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 holdtime (Active Hold Time) and keepalive interval (Keepalive Time).
Received	Received timer (configured on the peer) in seconds, including the holdtime (Active Hold Time).
Negotiated	Negotiated timers in seconds, including the holdtime (Active Hold Time) and keepalive interval (Keepalive Time).
Peer optional capabilities	Optional capabilities supported by the peer.
Peer support BGP route AS4 capability	The peer supports 4-byte AS number.
Address family IPv4 Unicast	IPv4 unicast address family capability: Routes of the address family can be advertised and received.
Received	Total numbers of received messages and updates.
Sent	Total numbers of sent messages and updates.
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	Indicates whether BFD is enabled to detect the link to the BGP peer.
Routing policy configured	Routing policy configured for the peer. If no routing policy is specified, this field displays "No routing policy is configured."

# Display log information about BGP IPv4 unicast peer 1.1.1.1 for the public network.

<Sysname> display bgp peer ipv4 1.1.1.1 log-info

Peer : 1.1.1.1

Date Time State Notification

Error/SubError

10-Jul-2008 15:46:17 Down Send Notification with Error 1/1

Message Header Error/Connection Not Synchronized

10-Jul-2008 09:23:00 Up

10-Jul-2008 07:46:17 Down Receive Notification with Error 3/2

UPDATE Message Error/Unsupported optional Parameter

10-Jul-2008 06:23:00 Up

10-Jul-2008 05:46:17 Down Send Notification with Error 6/4

Cease/Administrative Reset

Table 10 Command output

Field	Description
Peer	IP address of the peer.
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 is 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 ipv6 unicast

Use display bgp peer ipv6 unicast to display BGP IPv6 unicast peer or peer group information.

Syntax

display bgp peer ipv6 [ unicast ] [ group-name log-info | ip-address { log-info | verbose } | ipv6-address { log-info | verbose } | verbose ]

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

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

ip-address: Specifies a peer by its IP address.

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

log-info: Displays log information.

verbose: Displays detailed information.

Usage guidelines

If no parameter is specified, the command displays brief information about all BGP IPv6 unicast peers.

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display brief information about all BGP IPv6 unicast peers for the public network.

<Sysname> display bgp peer ipv6

BGP local router ID: 192.168.1.135

Local AS number: 100

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

Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State

1.1.1.1 600 0 0 0 0 01:08:19 Connect

1.1.1.10 600 0 0 0 0 00:03:21 Connect

1::1 600 9 9 0 0 00:05:12 Established

3::3 600 0 0 0 0 00:03:16 Connect

Table 11 Command output

Field	Description
Peer	IP 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	Number of prefixes received.
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 detailed information about BGP IPv6 unicast peer 1::2 for the public network.

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

Peer: 1::2 Local: 192.168.1.136

Type: EBGP link

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 support BGP multi-protocol extended

Peer support BGP route refresh capability

Peer support BGP route AS4 capability

Address family IPv6 Unicast: advertised and received

Received: Total 9 messages, Update messages 1

Sent: Total 10 messages, Update messages 1

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

BFD: Enabled

Routing policy configured:

No routing policy is configured

Table 12 Command output

Field	Description
Peer	IP address of the peer.
Local	Local router ID.
Type	BGP connection type between the local router and the peer: · IBGP link—IBGP connection. · EBGP link—EBGP connection.
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	Timer configured on the local router in seconds, including the holdtime (Active Hold Time) and keepalive interval (Keepalive Time).
Received	Received timer (configured on the peer) in seconds, including the holdtime (Active Hold Time).
Negotiated	Negotiated timer in seconds, including the holdtime (Active Hold Time) and keepalive interval (Keepalive Time).
Peer optional capabilities	Optional capabilities supported by the peer.
Peer support BGP route AS4 capability	The peer supports 4-byte AS number.
Address family IPv6 Unicast	IPv6 unicast address family capability: Routes of the address family can be advertised and received.
Received	Total numbers of received messages and updates.
Sent	Total numbers of sent messages and updates.
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	Indicates whether BFD is enabled to detect the link to the specified BGP peer.
Routing policy configured	Routing policy configured for the peer. If no routing policy is specified, this field displays "No routing policy is configured."

# Display log information about BGP IPv6 unicast peer 1::2 for the public network.

<Sysname> display bgp peer ipv6 1::2 log-info

Peer : 1::2

Date Time State Notification

Error/SubError

22-Nov-2011 09:31:12 Up

Table 13 Command output

Field	Description
Peer	IP address of the peer.
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 is 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 routing-table dampened ipv4 unicast

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

Syntax

display bgp routing-table dampened ipv4 [ unicast ] [ vpn-instance vpn-instance-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If no VPN is specified, the command displays dampened BGP IPv4 unicast routes for the public network.

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

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

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

Table 14 Command output

Field	Description
Status codes	Status codes: · * – valid—Valid route. · > – best—Best route. · d – damped—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – Stale—Stale route. · i – internal—Internal route. · e – external—External route.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of summary routes and 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 to avoid routing loops. · ORIGIN attribute—Identifies the origin of the route.

Related commands

· dampening

· reset bgp dampening ipv4 unicast

display bgp routing-table dampened ipv6 unicast

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

Syntax

display bgp routing-table dampened ipv6 [ unicast ] [ vpn-instance vpn-instance-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# 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

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 15 Command output

Field	Description
Status codes	Status codes: · * – valid—Valid route. · > – best—Best route. · d – damped—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – Stale—Stale route. · i – internal—Internal route. · e – external—External route.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of summary routes and 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 to avoid routing loops. · ORIGIN attribute—Identifies the origin of the route.

Related commands

· dampening

· reset bgp dampening ipv6 unicast

display bgp routing-table flap-info ipv4 unicast

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

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

network-address: Specifies a destination network address.

mask: Specifies a network mask, in dotted decimal notation.

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

longest-match: Displays the routing entries selected through the following steps:

1. AND the specified network address with the specified mask.

2. Display the route with the longest mask among the matching routes that have a mask shorter than or equal to the specified mask.

as-path-acl as-path-acl-number: Specifies an AS path list by its number in the range of 1 to 256 to filter BGP IPv4 unicast route flap statistics.

Usage guidelines

When you execute the display bgp routing-table flap-info ipv4 unicast command:

· If the network-address, mask, and mask-length arguments are not specified, the command displays flap statistics of all BGP IPv4 unicast routes for the public network or the specified VPN.

· If only the network-address argument is specified, 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 the network-address mask or network-address mask-length argument is specified, and the longest-match keyword is not specified, the command displays flap statistics of the BGP IPv4 unicast route that matches both the specified destination network address and the mask (or mask length).

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display BGP IPv4 unicast route flap statistics for the public network.

<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

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

Table 16 Command output

Field	Description
Status codes	Status codes: · * – valid—Valid route. · > – best—Best route. · d – damped—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – Stale—Stale route. · i – internal—Internal route. · e – external—External route.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of summary routes and 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 to avoid routing loops. · ORIGIN attribute—Identifies the origin of the route.

Related commands

· dampening

· reset bgp flap-info ipv4 unicast

display bgp routing-table flap-info ipv6 unicast

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

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

network-address prefix-length: Specifies the destination network address and prefix length. The value range for the prefix-length argument is 0 to 128.

as-path-acl as-path-acl-number: Specifies an AS path list by its number in the range of 1 to 256 to filter BGP IPv6 unicast route flap statistics.

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

When you execute the display bgp routing-table flap-info ipv6 unicast command without specifying any argument, the command displays flap statistics of all BGP IPv6 unicast routes for the public network.

Examples

# Display BGP IPv6 unicast route flap statistics for the public network.

<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

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 17 Command output

Field	Description
Status codes	Status codes: · * – valid—Valid route. · > – best—Best route. · d – damped—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – Stale—Stale route. · i – internal—Internal route. · e – external—External route.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of summary routes and 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.
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 to avoid routing loops. · ORIGIN attribute—Identifies the origin of the route.

Related commands

· dampening

· reset bgp flap-info ipv6 unicast

display bgp routing-table ipv4 unicast

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

Syntax

display bgp routing-table ipv4 [ unicast ] [ vpn-instance vpn-instance-name ] [ network-address [ { mask | mask-length } [ longest-match ] ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

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

network-address: Specifies a destination network address.

mask: Specifies a network mask, in dotted decimal notation.

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

longest-match: Displays the routing entries selected through the following steps:

1. AND the specified network address with the specified mask.

2. Display the route with the longest mask among the matching routes that have a mask shorter than or equal to the specified mask.

Usage guidelines

· If the network-address, mask, and mask-length arguments are not specified, the command displays brief information about all BGP IPv4 unicast routes.

· If the network-address mask or network-address mask-length argument is specified and the longest-match keyword is not specified, the command displays detailed information about the BGP IPv4 unicast route that matches both the specified destination network address and the mask (or mask length).

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display brief information about all BGP IPv4 unicast routes for the public network.

<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 - damped, h - history,

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

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

> 192.168.1.0 192.168.1.135 0 0 i

* e 10.2.1.2 0 0 200i

Table 18 Command output

Field	Description
Status codes	Status codes: · * – valid—Valid route. · > – best—Best route. · d – damped—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – Stale—Stale route. · i – internal—Internal route. · e – external—External route.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of summary routes and 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 to avoid routing loops. · ORIGIN—Identifies the origin of the route.

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

<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

AS-path : (null)

Origin : igp

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

State : valid, local, best,

From : 10.2.1.2 (192.168.100.2)

Relay nexthop : not resolved

Original nexthop: 10.2.1.2

OutLabel : NULL

AS-path : 200

Origin : igp

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

State : external,

Table 19 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 is received from a BGP update message, the original next hop is the next hop IP address in the message.
OutLabel	Outgoing label of the route.
AS-path	AS_PATH attribute of the route, which records the ASs the route has passed to avoid routing loops.
Origin	Origin of the route: · igp—Originated in the AS. The origin of summary routes and 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.
From	IP address of 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."

display bgp routing-table ipv4 unicast advertise-info

Use display bgp routing-table ipv4 unicast advertise-info to display advertisement information for BGP IPv4 unicast routes.

Syntax

display bgp routing-table ipv4 [ unicast ] [ vpn-instance vpn-instance-name ] network-address [ mask | mask-length ] advertise-info

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If no VPN is specified, the command displays advertisement information of BGP IPv4 unicast routes for the public network.

network-address: Specifies a destination network address.

mask: Specifies a network mask, in dotted decimal notation.

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

Usage guidelines

· If the mask and mask-length arguments are not specified, the system ANDs the specified network address with the mask of a route. If the result matches the network address of the route, the command displays advertisement information for the route.

· If the mask or mask-length argument is specified, the command displays advertisement information for the BGP IPv4 unicast route that matches both the specified destination network address and the mask (or mask length).

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

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

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

Advertised to peers (1 in total):

10.2.1.2

Table 20 Command output

Field	Description
Paths	Number of optimal routes destined to the specified network.
BGP routing table information of 10.2.1.0/24	Advertisement information of BGP routes destined to network 10.2.1.0/24.
Advertised to peers (1 in total)	Peers to which the route has been advertised and the number of peers.

display bgp routing-table ipv4 unicast as-path-acl

Use display bgp routing-table ipv4 unicast as-path-acl to display BGP IPv4 unicast routes permitted by an AS path list.

Syntax

display bgp routing-table ipv4 [ unicast ] [ vpn-instance vpn-instance-name ] as-path-acl as-path-acl-number

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

as-path-acl-number: Specifies an AS path list by its number in the range of 1 to 256.

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display BGP routes permitted by 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

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

For command output, see Table 18.

Related commands

ip as-path

display bgp routing-table ipv4 unicast community-list

Use display bgp routing-table ipv4 unicast community-list to display BGP IPv4 unicast routing information matching the specified BGP community list.

Syntax

display bgp routing-table ipv4 [ unicast ] [ vpn-instance vpn-instance-name ] community-list { { basic-community-list-number | comm-list-name } [ whole-match ] | adv-community-list-number }

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

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 string of 1 to 63 characters.

whole-match: Displays routes exactly matching the specified community list. Without this keyword, the command displays routes whose COMMUNITY attributes comprise the specified community list.

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

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display BGP routing information matching BGP community list 100.

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

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

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

For command output, see Table 18.

Related commands

ip community-list

display bgp routing-table ipv4 unicast peer

Use display bgp routing-table ipv4 unicast peer to display BGP IPv4 unicast routing information advertised to or received from the specified BGP peer.

Syntax

display bgp routing-table ipv4 [ unicast ] [ vpn-instance vpn-instance-name ] peer ip-address { advertised-routes | received-routes } [ network-address [ mask | mask-length ] | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

ip-address: Specifies a peer by its IP address.

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

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

network-address: Specifies the IP address of the destination network.

mask: Specifies the mask of the destination network, in dotted decimal notation.

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

statistics: Displays route statistics.

Usage guidelines

· If the network-address, mask, and mask-length arguments are not specified, the command displays all BGP IPv4 unicast routing information advertised to or received from the specified BGP peer.

· If the network-address mask or network-address mask-length argument is specified, the command displays information about the route that matches both the specified destination network address and the mask (or mask length).

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display all BGP IPv4 unicast routing information advertised to BGP peer 10.2.1.2 for the public network.

<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

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 all BGP IPv4 unicast routing information received from BGP peer 10.2.1.2 for the public network.

<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

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

For command output, see Table 18.

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

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

Advertised routes total: 2

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

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

Received routes total: 2

Table 21 Command output

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

display bgp routing-table ipv4 unicast statistics

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

Syntax

display bgp routing-table ipv4 [ unicast ] [ vpn-instance vpn-instance-name ] statistics

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display statistics of BGP IPv4 unicast routes for the public network.

<Sysname> display bgp routing-table ipv4 statistics

Total number of routes: 4

display bgp routing-table ipv6 unicast

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

Syntax

display bgp routing-table ipv6 [ unicast ] [ vpn-instance vpn-instance-name ] [ network-address prefix-length | advertise-info ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

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

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

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

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display brief information about all BGP IPv6 unicast routes for the public network.

<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

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

>e Network : 3:: PrefixLen : 64

NextHop : 1::2 LocPrf :

PrefVal : 0 OutLabel : NULL

MED :

Path/Ogn: 100i

Table 22 Command output

Field	Description
Status codes	Status codes: · * – valid—Valid route. · > – best—Best route. · d – damped—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – Stale—Stale route. · i – internal—Internal route. · e – external—External route.
Origin	Origin of the route: · i – IGP—Originated in the AS. The origin of summary routes and 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 to avoid routing loops. · ORIGIN attribute—Identifies the origin of the route.

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

<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

AS-path : 100

Origin : igp

Attribute value : MED 0, pref-val 0

State : valid, external, best,

From : 1::1 (192.168.1.136)

Relay nexthop : 1::1

Original nexthop: 1::1

OutLabel : NULL

AS-path : 100

Origin : igp

Attribute value : MED 0, pref-val 0

State : valid, external,

Table 23 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 is received from a BGP update message, the original next hop is the next hop IP address in the message.
OutLabel	Outgoing label of the route.
AS-path	AS_PATH attribute of the route, which records the ASs the route has passed to avoid routing loops.
Origin	Origin of the route: · igp—Originated in the AS. The origin of summary routes and 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.
From	IP address of 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."

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

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

Advertised to peers (2 in total):

10.1.1.2

1::2

Table 24 Command output

Field	Description
Paths	Number of optimal routes destined to the specified network.
BGP routing table information of 2::/64	Advertisement information of 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 bgp routing-table ipv6 unicast as-path-acl

Use display bgp routing-table ipv6 unicast as-path-acl to display BGP IPv6 unicast routes permitted by an AS path list.

Syntax

display bgp routing-table ipv6 [ unicast ] [ vpn-instance vpn-instance-name ] as-path-acl as-path-acl-number

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

as-path-acl-number: Specifies an AS path list by its number in the range of 1 to 256.

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display BGP IPv6 unicast routes permitted by 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

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

For command output, see Table 22.

Related commands

ip as-path

display bgp routing-table ipv6 unicast community-list

Use display bgp routing-table ipv6 unicast community-list to display BGP IPv6 unicast routing information matching a specified BGP community list.

Syntax

display bgp routing-table ipv6 [ unicast ] [ vpn-instance vpn-instance-name ] community-list { { basic-community-list-number | comm-list-name } [ whole-match ] | adv-community-list-number }

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

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. Without this keyword, this command displays routes whose COMMUNITY attributes comprise the specified community list.

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

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display BGP IPv6 unicast routing information matching 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

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

For command output, see Table 22.

Related commands

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 routing information.

Syntax

display bgp routing-table ipv6 [ unicast ] inlabel

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display incoming labels for all BGP IPv6 unicast routing information.

<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

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 25 Command output

Field	Description
Status codes	Status codes. For more information, see Table 22.
Origin	Origin of the route. For more information, see Table 22.
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 routing information.

Syntax

display bgp routing-table ipv6 [ unicast ] outlabel

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display outgoing labels for all BGP IPv6 unicast routing information.

<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

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 26 Command output

Field	Description
Status codes	Status codes. For more information, see Table 22.
Origin	Origin of the route. For more information, see Table 22.
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 routing-table ipv6 unicast peer

Use display bgp routing-table ipv6 unicast peer to display BGP IPv6 unicast routing information advertised to or received from the specified BGP peer.

Syntax

display bgp routing-table ipv6 [ unicast ] peer { ip-address | ipv6-address } { advertised-routes | received-routes } [ network-address prefix-length | statistics ]

display bgp routing-table ipv6 [ unicast ] vpn-instance vpn-instance-name peer ipv6-address { advertised-routes | received-routes } [ network-address prefix-length | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

ip-address: Specifies the IP address of a peer.

ipv6-address: Specifies the IPv6 address of a peer.

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

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

statistics: Displays route statistics.

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display all BGP IPv6 unicast routing information advertised to BGP 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

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

> Network : 2:: PrefixLen : 64

NextHop : :: LocPrf :

MED : 0 OutLabel : NULL

Path/Ogn: i

# Display all BGP IPv6 unicast routing information received from BGP 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

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

For command output, see Table 22.

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

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

Advertised routes total: 1

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

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

Received routes total: 1

Table 27 Command output

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

display bgp routing-table ipv6 unicast statistics

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

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Display statistics of BGP IPv6 unicast routes.

<Sysname> display bgp routing-table ipv6 statistics

Total number of routes: 4

ebgp-interface-sensitive

Use ebgp-interface-sensitive to enable quick reestablishment of direct EBGP sessions.

Use undo ebgp-interface-sensitive to disable the function.

Syntax

ebgp-interface-sensitive

undo ebgp-interface-sensitive

Default

Quick reestablishment of direct EBGP sessions is enabled.

Views

BGP view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

This command enables BGP to quickly handle direct EBGP link failures. When a direct link to an EBGP peer fails, BGP tears down the session and reestablishes a session to the peer immediately. If the function is not enabled, the router does not tear down the session until the holdtime expires. However, disabling this function can prevent routing flaps from affecting EBGP session state.

This command applies to only direct EBGP sessions.

Examples

# Enable quick reestablishment of direct EBGP sessions.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ebgp-interface-sensitive

filter-policy export

Use filter-policy export to filter outbound routes by using a specified filter.

Use undo filter-policy export to cancel filtering of outbound routes.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view:

filter-policy { acl-number | prefix-list prefix-list-name } export [ protocol process-id ]

undo filter-policy { acl-number | prefix-list prefix-list-name } export [ protocol process-id ]

In BGP IPv6 unicast instance view/BGP-VPN IPv6 unicast instance view/BGP VPNv6 instance view:

filter-policy { acl6-number | prefix-list ipv6-prefix-name } export [ protocol process-id ]

undo filter-policy { acl6-number | prefix-list ipv6-prefix-name } export [ protocol process-id ]

Default

No outbound routing information is filtered.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP IPv6 unicast instance view, BGP-VPN IPv6 unicast instance view, BGP VPNv6 instance view

Predefined user roles

network-admin

mdc-admin

Parameters

acl-number: Specifies an ACL by its number in the range of 2000 to 3999 to match routes by destination.

acl6-number: Specifies an ACL6 by its number in the range of 2000 to 3999 to match routes by destination.

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

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

protocol: Filters routes redistributed from the routing protocol. In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view, it can be direct, isis, ospf, rip, or static. In BGP IPv6 unicast instance view/BGP-VPN IPv6 unicast instance view/BGP VPNv6 instance view, it can be direct, isisv6, ospfv3, ripng, or static.

process-id: Specifies a routing protocol by its ID in the range of 1 to 65535. In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view, it is available only when the protocol is isis, ospf, or rip. In BGP IPv6 unicast instance view/BGP-VPN IPv6 unicast instance view/BGP VPNv6 instance view, it is available only when the protocol is isisv6, ospfv3, or ripng.

Usage guidelines

If a protocol is specified, this command filters only routes redistributed from the specified protocol. If no protocol is specified, this command filters all redistributed routes, including routes redistributed from IGP and injected by the network command.

If you use a basic ACL (with a number from 2000 to 2999) configured with the rule [ rule-id ] { deny | permit } source source-address source-wildcard command, the command matches routes whose destination addresses match the source-address source-wildcard argument without matching the masks of the destination addresses.

To use an advanced ACL (with a number from 3000 to 3999) in the command, configure the ACL using one of the following steps:

· To deny/permit a route with the specified destination, use the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard command.

· To deny/permit a route with the specified destination and mask, use the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard destination dest-addr dest-wildcard command to deny/permit a route with the specified destination and mask.

The source keyword specifies the destination address of a route and the destination keyword specifies the subnet mask of the destination. The subnet mask must be contiguous. Otherwise, the configuration does not take effect.

Examples

# In BGP IPv4 unicast instance view, use ACL 2000 to filter outbound BGP routes.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] filter-policy 2000 export

# In BGP-VPN IPv6 unicast instance view, use ACL6 2000 to filter outbound BGP routes.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] filter-policy 2000 export

# Configure ACL 3000 to permit only route 113.0.0.0/16 to pass, and use ACL 3000 to filter outbound routes.

<Sysname> system-view

[Sysname] acl number 3000

[Sysname-acl-adv-3000] rule 10 permit ip source 113.0.0.0 0 destination 255.255.0.0 0

[Sysname-acl-adv-3000] rule 100 deny ip

[Sysname-acl-adv-3000] quit

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] filter-policy 3000 export

Related commands

· filter-policy import

· peer as-path-acl

· peer filter-policy

· peer prefix-list

· peer route-policy

filter-policy import

Use filter-policy import to filter inbound routing information by using a specified filter.

Use undo filter-policy import to cancel filtering inbound routing information.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view:

filter-policy { acl-number | prefix-list prefix-list-name } import

undo filter-policy { acl-number | prefix-list prefix-list-name } import

In BGP IPv6 unicast instance view/BGP-VPN IPv6 unicast instance view/BGP VPNv6 instance view:

filter-policy { acl6-number | prefix-list ipv6-prefix-name } import

undo filter-policy { acl6-number | prefix-list ipv6-prefix-name } import

Default

No inbound routing information is filtered.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP IPv6 unicast instance view, BGP-VPN IPv6 unicast instance view, BGP VPNv6 instance view

Predefined user roles

network-admin

mdc-admin

Parameters

acl-number: Specifies an ACL by its number in the range of 2000 to 3999 to match routes by destination.

acl6-number: Specifies an ACL6 by its number in the range of 2000 to 3999 to match routes by destination.

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

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

Usage guidelines

If you use a basic ACL (with a number from 2000 to 2999) configured with the rule [ rule-id ] { deny | permit } source source-address source-wildcard command, the command matches routes whose destination network addresses match the source-address source-wildcard argument without matching the masks of the destination addresses.

To use an advanced ACL (with a number from 3000 to 3999) in the command, configure the ACL using one of the following steps:

· To deny/permit a route with the specified destination, use the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard command.

· To deny/permit a route with the specified destination and mask, use the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard destination dest-addr dest-wildcard command.

Examples

# In BGP IPv4 unicast instance view, use ACL 2000 to filter inbound BGP routes.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] filter-policy 2000 import

# In BGP-VPN IPv6 unicast instance view, use ACL6 2000 to filter inbound BGP routes.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] filter-policy 2000 import

# Configure ACL6 3000 to permit only route 113.0.0.0/16 to pass, and use ACL 3000 to filter inbound routes.

<Sysname> system-view

[Sysname] acl number 3000

[Sysname-acl-adv-3000] rule 10 permit ip source 113.0.0.0 0 destination 255.255.0.0 0

[Sysname-acl-adv-3000] rule 100 deny ip

[Sysname-acl-adv-3000] quit

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] filter-policy 3000 import

Related commands

· filter-policy export

· peer as-path-acl

· peer filter-policy

· peer prefix-list

· peer route-policy

graceful-restart

Use graceful-restart to enable BGP Graceful Restart capability.

Use undo graceful-restart to disable BGP Graceful Restart capability.

Syntax

graceful-restart

undo graceful-restart

Default

BGP Graceful Restart capability is disabled.

Views

BGP view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

Graceful Restart (GR) ensures continuous forwarding when BGP restarts or an active/standby switchover occurs.

BGP peers exchange Open messages containing GR information. If both parties have GR capability, they establish a GR-capable session.

After you execute this command, the device reestablishes BGP sessions.

Examples

# Enable Graceful Restart capability for BGP process 100.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] graceful-restart

Related commands

· graceful-restart timer restart

· graceful-restart timer wait-for-rib

graceful-restart timer restart

Use graceful-restart timer restart to configure the GR timer.

Use undo graceful-restart timer restart to restore the default.

Syntax

graceful-restart timer restart timer

undo graceful-restart timer restart

Default

The GR timer is 150 seconds.

Views

BGP view

Predefined user roles

network-admin

mdc-admin

Parameters

timer: Specifies the GR time in the range of 3 to 600 seconds.

Usage guidelines

The GR Restarter sends the GR timer to the GR Helper in an Open message. When the GR Helper detects that an active/standby switchover or a BGP restart occurs on the GR Restarter, the GR Helper marks all routes learned from the GR Restarter as stale and starts the GR timer. If no BGP session is established before the GR timer expires, the GR Helper removes the stale routes.

Before you configure this command, enable the BGP GR capability.

To apply a new GR timer, you must reestablish BGP sessions.

Examples

# Configure the GR timer as 300 seconds.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] graceful-restart

[Sysname-bgp] graceful-restart timer restart 300

Related commands

· graceful-restart

· graceful-restart timer wait-for-rib

graceful-restart timer wait-for-rib

Use graceful-restart timer wait-for-rib to configure the time to wait for the End-of-RIB marker.

Use undo graceful-restart timer wait-for-rib to restore the default.

Syntax

graceful-restart timer wait-for-rib timer

undo graceful-restart timer wait-for-rib

Default

The time to wait for the End-of-RIB marker is 180 seconds.

Views

BGP view

Predefined user roles

network-admin

mdc-admin

Parameters

timer: Specifies the time to wait for the End-of-RIB marker, in the range of 3 to 300 seconds.

Usage guidelines

BGP uses this timer to control the time to receive updates from the peer. The timer is not advertised to the peer.

After the GR Restarter and GR Helper reestablish a BGP session, they start this timer. If they do not complete route exchange before the timer expires, the GR Restarter does not receive new routes but updates its routing table and forwarding table with learned BGP routes, and the GR Helper removes the stale routes.

This command controls the routing convergence speed. A smaller timer value means faster routing convergence but possibly results in incomplete routing information.

Before configuring this command, you must enable the BGP GR capability.

Examples

# Set the time to wait for the End-of-RIB marker on the local end to 100 seconds.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] graceful-restart

[Sysname-bgp] graceful-restart timer wait-for-rib 100

Related commands

· graceful-restart

· graceful-restart timer restart

group

Use group to create a peer group.

Use undo group to delete a peer group.

Syntax

group group-name [ external | internal ]

undo group group-name

Default

No peer group is created.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

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

external: Creates an EBGP peer group.

internal: Creates an IBGP peer group.

Usage guidelines

In a large-scale network, many peers can use the same route selection policy. You can configure a peer group and add these peers into this group. In this way, peers can share the same policy as the peer group. When the policy of the group is modified, the modification also applies to peers in it.

If the internal or external keyword is not specified, the command creates an IBGP peer group.

If you perform configurations on a peer group and peers of the peer group, the last configuration takes effect.

After you create a peer group, you must use the peer enable command to enable BGP to exchange routing information with the specified peer group.

Examples

# In BGP view, create an EBGP peer group test with AS number 200, and add EBGP peers 10.1.1.1 and 10.1.2.1 into the group.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test external

[Sysname-bgp] peer test as-number 200

[Sysname-bgp] peer 10.1.1.1 group test

[Sysname-bgp] peer 10.1.2.1 group test

# In BGP-VPN view, create an EBGP peer group test with AS number 200, and add EBGP peers 10.1.1.1 and 10.1.2.1 into the group.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] group test external

[Sysname-bgp-vpn1] peer test as-number 200

[Sysname-bgp-vpn1] peer 10.1.1.1 group test

[Sysname-bgp-vpn1] peer 10.1.2.1 group test

# In BGP view, create an EBGP peer group test with AS number 200, and add EBGP peers 1::1 and 1::2 into the group.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test external

[Sysname-bgp] peer test as-number 200

[Sysname-bgp] peer 1::1 group test

[Sysname-bgp] peer 1::2 group test

# In BGP-VPN view, create an EBGP peer group test with AS number 200, and add EBGP peers 1::1 and 1::2 into the group.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] group test external

[Sysname-bgp-vpn1] peer test as-number 200

[Sysname-bgp-vpn1] peer 1::1 group test

[Sysname-bgp-vpn1] peer 1::2 group test

Related commands

· display bgp group ipv4 unicast

· display bgp group ipv6 unicast

· peer enable

· peer group

ignore-first-as

Use ignore-first-as to configure BGP to ignore the first AS number of EBGP route updates.

Use undo ignore-first-as to restore the default.

Syntax

ignore-first-as

undo ignore-first-as

Default

BGP checks the first AS number of a received EBGP route update. If the first AS number is not that of the BGP peer, the BGP router discards the route update.

Views

BGP view

Predefined user roles

network-admin

mdc-admin

Examples

# Configure BGP to ignore the first AS number of EBGP route updates.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ignore-first-as

import-route

Use import-route to enable BGP to redistribute routes from an IGP protocol.

Use undo import-route to disable route redistribution from an IGP protocol.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view:

import-route protocol [ { process-id | all-processes } [ med med-value | route-policy route-policy-name ] * ]

undo import-route protocol [ process-id | all-processes ]

In BGP IPv6 unicast instance view/BGP-VPN IPv6 unicast instance view:

import-route protocol [ process-id [ med med-value | route-policy route-policy-name ] * ]

undo import-route protocol [ process-id ]

Default

BGP does not redistribute IGP routes.

Views

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

Predefined user roles

network-admin

mdc-admin

Parameters

protocol: Redistributes routes from a specified IGP protocol. In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view, it can be direct, isis, ospf, rip, or static. In BGP IPv6 unicast instance view/BGP-VPN IPv6 unicast instance view, it can be direct, isisv6, ospfv3, ripng, or static.

process-id: Specifies a process by its ID in the range of 1 to 65535. The default is 1. In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view, it is available only when the protocol is isis, ospf, or rip. In BGP IPv6 unicast instance view/BGP-VPN IPv6 unicast instance view, it is available only when the protocol is isisv6, ospfv3, or ripng.

all-processes: Redistributes routes from all the processes of the specified IGP protocol. This keyword takes effect only when the protocol is isis, ospf, or rip.

med med-value: Specifies a MED value for redistributed routes, in the range of 0 to 4294967295. If no MED is specified, the metric of a redistributed route is used as its MED.

route-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters, to filter redistributed routes or set route attributes for redistributed routes.

Usage guidelines

The import-route command cannot redistribute default IGP routes. To redistribute default IGP routes, use the default-route imported command together with the import-route command.

Only active routes can be redistributed. You can use the display ip routing-table protocol or display ipv6 routing-table protocol command to view route state information.

The ORIGIN attribute of routes redistributed by the import-route command is INCOMPLETE.

Examples

# In BGP IPv4 unicast instance view, redistribute routes from RIP process 1, and set the MED value for redistributed routes to 100.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] import-route rip 1 med 100

# In BGP-VPN IPv4 unicast instance view, redistribute routes from RIP process 1, and reference a routing policy imprt to exclude route 1.1.1.0/24 from route redistribution.

<Sysname> system-view

[Sysname] ip prefix-list imprt deny 1.1.1.0 24

[Sysname] ip prefix-list imprt permit 0.0.0.0 0 less-equal 32

[Sysname] route-policy imprt permit node 0

[Sysname-route-policy-imprt-0] if-match ip address prefix-list imprt

[Sysname-route-policy-imprt-0] quit

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] import-route rip 1 route-policy imprt

# In BGP IPv6 unicast instance view, redistribute routes from RIP process 1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] import-route ripng

# In BGP-VPN IPv6 unicast instance view, redistribute routes from RIP process 1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] import-route ripng

Related commands

· display ip routing-table protocol

· display ipv6 routing-table protocol

ip vpn-instance (BGP view)

Use ip vpn-instance to enter BGP-VPN view.

Use undo ip vpn-instance to remove all configurations in BGP-VPN view.

Syntax

ip vpn-instance vpn-instance-name

undo ip vpn-instance vpn-instance-name

Views

BGP view

Predefined user roles

network-admin

mdc-admin

Parameters

vpn-instance-name: Specifies a VPN instance by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

After you create a BGP peer in BGP-VPN view, the BGP routes learned from the peer are added into the routing table of the specified VPN instance.

This command and all commands in BGP-VPN view are usually executed on provider edge (PE) or Multi-VPN-Instance CE (MCE) devices to add routes learned from different sites into different VPN instances.

Before you execute this command, use the ip vpn-instance command to create the VPN instance in system view, and use the route-distinguisher command to configure a route distinguisher (RD) for the VPN instance.

Examples

# Enter BGP-VPN view of VPN instance vpn1.

<Sysname> system-view

[Sysname] ip vpn-instance vpn1

[Sysname-vpn-instance-vpn1] route-distinguisher 100:1

[Sysname-vpn-instance-vpn1] quit

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1]

Related commands

· ip vpn-instance (system-view) (MPLS Command reference)

· route-distinguisher (MPLS Command reference)

ipv4-family

Use ipv4-family to create and enter BGP IPv4 unicast instance view or BGP-VPN IPv4 unicast instance view.

Use undo ipv4-family to remove all configurations in BGP IPv4 unicast instance view or BGP-VPN IPv4 unicast instance view.

Syntax

ipv4-family [ unicast ]

undo ipv4-family [ unicast ]

Default

The BGP IPv4 unicast instance view or the BGP-VPN IPv4 unicast instance view is not created.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

unicast: Specifies the IPv4 unicast instance view. The IPv4 unicast instance view is specified for the command regardless of whether the unicast keyword is specified.

Usage guidelines

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

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

Examples

# In BGP view, create and enter BGP IPv4 unicast instance view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4]

# In BGP-VPN view, create and enter BGP-VPN IPv4 unicast instance view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1]

ipv6-family

Use ipv6-family to create and enter BGP IPv6 unicast instance view or BGP-VPN IPv6 unicast instance view.

Use undo ipv6-family to remove all configurations in BGP IPv6 unicast instance view or BGP-VPN IPv6 unicast instance view.

Syntax

ipv6-family [ unicast ]

undo ipv6-family [ unicast ]

Default

The BGP IPv6 unicast instance view or BGP-VPN IPv6 unicast instance view is not created.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

unicast: Specifies the IPv6 unicast instance view. The IPv6 unicast instance view is specified for the command regardless of whether the unicast keyword is specified.

Usage guidelines

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

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

Examples

# In BGP view, create and enter BGP IPv6 unicast instance view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6]

# In BGP-VPN view, create and enter BGP-VPN IPv6 unicast instance view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1]

log-peer-change

Use log-peer-change to enable the logging of session state changes globally.

Use undo log-peer-change to disable the function.

Syntax

log-peer-change

undo log-peer-change

Default

Logging of session state changes is enabled globally.

Views

BGP view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

After you execute the log-peer-change command, BGP logs session establishment and disconnection events. To view the log information, use the display bgp ipv4 peer log-info command.

If you disable the logging of session state changes globally, the display bgp ipv4 peer log-info command does not show relevant log information.

Examples

# Enable the logging of session state changes globally.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] log-peer-change

Related commands

display bgp peer ipv4 unicast

network

Use network to inject a network to the BGP routing table.

Use undo network to remove the configuration.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view:

network ip-address [ mask | mask-length ] [ route-policy route-policy-name ]

undo network ip-address [ mask | mask-length ]

In BGP IPv6 unicast instance view/BGP-VPN IPv6 unicast instance view:

network ipv6-address prefix-length [ route-policy route-policy-name ]

undo network ipv6-address prefix-length

Default

BGP does not advertise any local network.

Views

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

Predefined user roles

network-admin

mdc-admin

Parameters

ip-address: Specifies an IPv4 network address. If the mask or mask-length is not specified, natural mask is used.

mask: Specifies a mask in dotted decimal notation.

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

ipv6-address: Specifies an IPv6 network address.

prefix-length: Specifies a prefix length in the range of 0 to 128.

route-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters, to filter routes or set the route attributes.

Usage guidelines

· The network to be injected must be available and active in the local IP routing table.

· The ORIGIN attribute of the route injected with the network command is IGP.

· When you execute the undo network command, you must specify the same mask or mask length/prefix length that you specified for the network command. Otherwise, the configuration cannot be removed.

Examples

# In BGP IPv4 unicast instance view, inject local network 10.0.0.0/16 to the BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] network 10.0.0.0 255.255.0.0

# In BGP-VPN IPv4 unicast instance view, inject local network 10.0.0.0/16 to the BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] network 10.0.0.0 255.255.0.0

# In BGP IPv6 unicast instance view, inject local network 2002::/64 to the IPv6 BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] network 2002:: 64

# In BGP-VPN IPv6 unicast instance view, inject local network 2002::/64 to the IPv6 BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] network 2002:: 64

network short-cut

Use network short-cut to increase the preference for a received EBGP route. This EBGP route is called shortcut route.

Use undo network short-cut to cancel the configuration.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view:

network ip-address [ mask | mask-length ] short-cut

undo network ip-address [ mask | mask-length ] short-cut

In BGP IPv6 unicast instance view/BGP-VPN IPv6 unicast instance view:

network ipv6-address prefix-length short-cut

undo network ipv6-address prefix-length short-cut

Default

A received EBGP route has a preference of 255.

Views

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

Predefined user roles

network-admin

mdc-admin

Parameters

ip-address: Specifies an IPv4 network address. If the mask or mask-length is not specified, natural mask is used.

mask: Specifies a mask of the network address in dotted decimal notation.

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

ipv6-address: Specifies an IPv6 network address.

prefix-length: Specifies a prefix length in the range of 0 to 128.

Usage guidelines

Different routing protocols might find different routes to the same destination. However, not all of those routes are optimal. For route selection, routing protocols, direct routes, and static routes are assigned different preferences. The route with the highest preference is preferred.

By default, the preference of an EBGP route is lower than a local route. If a device has an EBGP route and a local route to reach the same destination, the device does not select the EBGP route. You can use the network shortcut command to configure the EBGP route to have the same preference as the local route so the EBGP route is more likely to become the optimal route.

You can use the preference command to modify the preferences for external and local BGP routes.

Examples

# In BGP IPv4 unicast instance view, increase the preference of EBGP route 10.0.0.0/16.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] network 10.0.0.0 255.255.0.0 short-cut

# In BGP-VPN IPv6 unicast instance view, increase the preference of EBGP route 10::/16.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] network 10:: 16 short-cut

Related commands

preference

peer advertise-community

Use peer advertise-community to advertise the COMMUNITY attribute to a peer or peer group.

Use undo peer advertise-community to disable the COMMUNITY attribute advertisement to a peer or peer group.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view:

peer { group-name | ip-address } advertise-community

undo peer { group-name | ip-address } advertise-community

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } advertise-community

undo peer { group-name | ip-address | ipv6-address } advertise-community

Default

No COMMUNITY attribute is advertised to any peer or peer group.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP IPv6 unicast instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

The COMMUNITY attribute is a group of specific data carried in update messages. A route can carry one or more COMMUNITY attribute values (each is represented by a 4-byte integer). The receiving router processes the route (for example, determining whether to advertise the route and the scope for advertising the route) based on the COMMUNITY attribute values.

After you execute the peer advertise-community command, routing updates advertised to the peer carry the COMMUNITY attribute.

After you execute the undo peer advertise-community command, BGP, upon receiving a route with the COMMUNITY attribute, removes the COMMUNITY attribute before sending the route to the peer or peer group.

Examples

# In BGP IPv4 unicast instance view, advertise the COMMUNITY attribute to peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer test advertise-community

# In BGP-VPN IPv4 unicast instance view, advertise the COMMUNITY attribute to peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] peer test advertise-community

# In BGP IPv6 unicast instance view, advertise the COMMUNITY attribute to peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] peer test advertise-community

Related commands

· apply community

· if-match community

· ip community-list

peer advertise-ext-community

Use peer advertise-ext-community to advertise the extended community attribute to a peer or peer group.

Use undo peer advertise-ext-community to disable the extended community attribute advertisement to a peer or peer group.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view:

peer { group-name | ip-address } advertise-ext-community

undo peer { group-name | ip-address } advertise-ext-community

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } advertise-ext-community

undo peer { group-name | ip-address | ipv6-address } advertise-ext-community

Default

No extended community attribute is advertised to a peer or peer group.

Views

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

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

To satisfy increasing user demands, BGP defines a new attribute—extended community attribute. The extended community attribute has the following advantages over the COMMUNITY attribute:

· The extended community attribute has an 8-byte length.

· The extended community attribute supports various types. You can select an extended community attribute type as needed to implement route filtering and control. This simplifies configuration and management.

After you execute the peer advertise-ext-community command, route updates sent to the peer or peer group carry the extended community attribute.

After you execute the undo peer advertise-ext-community command, BGP, upon receiving a route with the extended community attribute, removes the extended community attribute before sending the route to the peer or peer group.

Examples

# In BGP IPv4 unicast instance view, advertise the extended community attribute to peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer test advertise-ext-community

# In BGP-VPN IPv4 unicast instance view, advertise the extended community attribute to peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] peer test advertise-ext-community

# In BGP IPv6 unicast instance view, advertise the extended community attribute to peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] peer test advertise-ext-community

Related commands

· apply extcommunity

· if-match extcommunity

· ip extcommunity-list

peer allow-as-loop

Use peer allow-as-loop to allow a local AS number to exist in the AS_PATH attribute of routes from a peer or peer group, and to configure the number of times the local AS number can appear.

Use undo peer allow-as-loop to restore the default.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view:

peer { group-name | ip-address } allow-as-loop [ number ]

undo peer { group-name | ip-address } allow-as-loop

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } allow-as-loop [ number ]

undo peer { group-name | ip-address | ipv6-address } allow-as-loop

In BGP VPN IPv6 unicast instance view:

peer { group-name | ipv6-address } allow-as-loop [ number ]

undo peer { group-name | ipv6-address } allow-as-loop

Default

The local AS number is not allowed to exist in the AS_PATH attribute of routes from a peer or peer group.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP-VPNv4 instance view, BGP IPv6 unicast instance view, BGP-VPN IPv6 unicast instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

number: Specifies the number of times for which the local AS number can appear, in the range of 1 to 10. The default number is 1. If the number of times for which the local AS number appears in a route is more than the specified number, BGP considers that a routing loop occurs and discards the route.

Usage guidelines

By default, BGP does not receive routes that contain the local AS number in the AS_PATH attribute to avoid routing loops. However, in certain network environments (a Hub&Spoke network in MPLS L3VPN, for example), the AS_PATH attribute of a route from a peer must be allowed to contain the local AS number. Otherwise, the route cannot be advertised correctly.

Examples

# In BGP IPv4 unicast instance view, configure the number of times the local AS number can appear in AS_PATH attribute of routes from peer group test as 2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer test allow-as-loop 2

# In BGP VPNv4 instance view, configure the number of times the local AS number can appear in AS_PATH attribute of routes from peer group test as 2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast vpnv4

[Sysname-bgp-vpnv4] peer test allow-as-loop 2

# In BGP-VPN IPv6 unicast instance view, configure the number of times the local AS number can appear in AS_PATH attribute of routes from peer group test as 2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] peer test allow-as-loop 2

peer as-number (for a BGP peer)

Use peer as-number to create a BGP peer and specify its AS number.

Use undo peer to delete a BGP peer.

Syntax

peer { ip-address | ipv6-address } as-number as-number

undo peer { ip-address | ipv6-address }

Default

No BGP peer is created.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

ip-address: Specifies the IP address of a peer.

ipv6-address: Specifies the IPv6 address of a peer.

as-number: Specifies an AS number for the peer, in the range of 1 to 4294967295. If the AS numbers of the peer and the local router are the same, the peer is an IBGP peer. If they are different, the peer is an EBGP peer.

Usage guidelines

You can also create a peer and add it to a peer group by using the peer group command.

To modify the AS number of a peer, do not execute the peer as-number command repeatedly. Instead, you must first delete the peer and configure it again.

After you create a peer, you must use the peer enable command to enable BGP to exchange routing information with the specified peer.

Examples

# In BGP view, create BGP peer 1.1.1.1 and specify its AS number as 100.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 1.1.1.1 as-number 100

# In BGP-VPN view, create BGP peer 1::1 and specify its AS number as 100.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer 1::1 as-number 100

Related commands

· display bgp peer ipv4 unicast

· display bgp peer ipv6 unicast

· peer enable

· peer group

peer as-number (for a BGP peer group)

Use peer as-number to specify an AS number for a peer group.

Use undo peer as-number to delete the AS number of a peer group.

Syntax

peer group-name as-number as-number

undo peer group-name as-number

Default

No AS number is specified for a peer group.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a name for a peer group, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

as-number: Specifies an AS number for a peer group, in the range of 1 to 4294967295.

Usage guidelines

· This command applies to only a peer group with no peers in it.

· When you specify an AS number for a peer group and want to add peers to it, make sure the AS number of the peers is the same as the peer group.

· If you have specified no AS number for a peer group, peers added to it can use their own AS numbers.

Examples

# In BGP view, specify the AS number for peer group test as 100.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer test as-number 100

# In BGP-VPN view, specify the AS number for peer group test as 100.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer test as-number 100

Related commands

peer group

peer as-path-acl

Use peer as-path-acl to specify an AS path list to filter routes incoming from or outgoing to a peer/peer group.

Use undo peer as-path-acl to remove the configuration.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view:

peer { group-name | ip-address } as-path-acl as-path-acl-number { export | import }

undo peer { group-name | ip-address } as-path-acl as-path-acl-number { export | import }

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } as-path-acl as-path-acl-number { export | import }

undo peer { group-name | ip-address | ipv6-address } as-path-acl as-path-acl-number { export | import }

Default

No AS path list is specified for filtering.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP-VPNv4 instance view, BGP IPv6 unicast instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IPv4 address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

as-path-acl-number: Specifies an AS path list by its number in the range of 1 to 256.

export: Filters outgoing routes.

import: Filters incoming routes.

Usage guidelines

The specified AS path list must have been created with the ip as-path command in system view. Otherwise, all routes can pass the AS path list.

Examples

# In BGP IPv4 unicast instance view, specify the AS path list 1 to filter routes outgoing to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer test as-path-acl 1 export

# In BGP-VPN IPv4 unicast instance view, specify the AS path list 1 to filter routes outgoing to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] peer test as-path-acl 1 export

# In BGP IPv6 unicast instance view, specify the AS path list 1 to filter routes outgoing to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] peer test as-path-acl 1 export

Related commands

· filter-policy export

· filter-policy import

· ip as-path

· peer filter-policy

· peer prefix-list

· peer route-policy

peer bfd

Use peer bfd to enable BFD for the link to a BGP peer.

Use undo peer bfd to restore the default.

Syntax

peer { ip-address | ipv6-address } bfd

undo peer { ip-address | ipv6-address } bfd

Default

BFD is disabled.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

BFD helps speed up BGP routing convergence upon link failures. However, if you have enabled GR, use BFD with caution because BFD might detect a failure before the system performs GR, resulting in GR failure. If you have enabled both BFD and GR for BGP, do not disable BFD during a GR process to avoid GR failure.

Examples

# In BGP view, enable BFD for the link to BGP peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 1.1.1.1 bfd

# In BGP view, enable BFD for the link to BGP peer 1::1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 1::1 bfd

# In BGP-VPN view, enable BFD for the link to BGP peer 2.2.2.2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer 2.2.2.2 bfd

# In BGP-VPN view, enable BFD for the link to BGP peer 2::2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer 2::2 bfd

Related commands

· display bgp peer ipv4 unicast

· display bgp peer ipv6 unicast

· display bfd session (High Availability Command Reference)

peer capability-advertise conventional

Use peer capability-advertise conventional to disable BGP multi-protocol extension and route refresh for a peer or peer group.

Use undo peer capability-advertise conventional to enable BGP multi-protocol extension and route refresh for a peer or peer group.

Syntax

peer { group-name | ip-address | ipv6-address } capability-advertise conventional

undo peer { group-name | ip-address | ipv6-address } capability-advertise conventional

Default

BGP multi-protocol extension and route refresh are enabled.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

The route refresh function enables BGP to send and receive Route-refresh messages and implement BGP session soft-reset.

The multi-protocol extension function enables BGP to advertise and receive routing information for various protocols (for example, IPv6 routing information).

If both the peer capability-advertise conventional and peer capability-advertise route-refresh commands are executed, the last configuration takes effect.

Examples

# In BGP view, disable multi-protocol extension and route refresh for peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 1.1.1.1 as-number 100

[Sysname-bgp] peer 1.1.1.1 capability-advertise conventional

# In BGP-VPN view, disable multi-protocol extension and route refresh for peer 1::1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer 1::1 as-number 100

[Sysname-bgp-vpn1] peer 1::1 capability-advertise conventional

Related commands

· display bgp peer ipv4 unicast

· display bgp peer ipv6 unicast

· peer capability-advertise route-refresh

peer capability-advertise route-refresh

Use peer capability-advertise route-refresh to enable BGP route refresh for a specified peer or peer group.

Use undo peer capability-advertise route-refresh to disable the function.

Syntax

peer { group-name | ip-address | ipv6-address } capability-advertise route-refresh

undo peer { group-name | ip-address | ipv6-address } capability-advertise route-refresh

Default

BGP route refresh is enabled.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

The route refresh function enables BGP to send and receive Route-refresh messages.

BGP uses the route refresh function to implement BGP session soft-reset. After a policy is modified, the router advertises a Route-refresh message to the peers. The peers resend their routing information to the router. After receiving the routing information, the router filters the routing information by using the new policy. This method allows you to refresh the BGP routing table and apply the new route selection policy without tearing down BGP sessions.

BGP route refresh requires that both the local router and the peer support route refresh.

If both the peer capability-advertise route-refresh and peer capability-advertise conventional commands are executed, the last configuration takes effect.

Examples

# In BGP view, enable BGP route refresh for peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 1.1.1.1 as-number 100

[Sysname-bgp] peer 1.1.1.1 capability-advertise route-refresh

# In BGP-VPN view, enable BGP route refresh for peer 1::1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer 1::1 as-number 200

[Sysname-bgp-vpn1] peer 1::1 capability-advertise route-refresh

Related commands

· display bgp peer ipv4 unicast

· display bgp peer ipv6 unicast

· peer capability-advertise conventional

· peer keep-all-routes

· refresh bgp ipv4 unicast

· refresh bgp ipv6 unicast

peer capability-advertise suppress-4-byte-as

Use peer capability-advertise suppress-4-byte-as to enable 4-byte AS number suppression.

Use undo peer capability-advertise suppress-4-byte-as to disable the function.

Syntax

peer { group-name | ip-address | ipv6-address } capability-advertise suppress-4-byte-as

undo peer { group-name | ip-address | ipv6-address } capability-advertise suppress-4-byte-as

Default

The 4-byte AS number suppression function is disabled.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

BGP supports 4-byte AS numbers. The 4-byte AS number occupies four bytes, in the range of 1 to 4294967295. By default, a device sends an Open message to the peer device for session establishment. The Open message indicates that the device supports 4-byte AS numbers. If the peer device does not support 4-byte AS numbers (supports only 2-byte AS numbers), the session cannot be established. To resolve this issue, enable the 4-byte AS number suppression function. The device then sends an Open message to inform the peer that it does not support 4-byte AS numbers, so the BGP session can be established.

If the peer device supports 4-byte AS numbers, do not enable the 4-byte AS number suppression function. Otherwise, the BGP session cannot be established.

Examples

# In BGP view, enable 4-byte AS number suppression for peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 1.1.1.1 as-number 100

[Sysname-bgp] peer 1.1.1.1 capability-advertise suppress-4-byte-as

# In BGP-VPN instance view, enable 4-byte AS number suppression for peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer 1.1.1.1 as-number 200

[Sysname-bgp-vpn1] peer 1.1.1.1 capability-advertise suppress-4-byte-as

Related commands

· display bgp peer ipv4 unicast

· display bgp peer ipv6 unicast

peer connect-interface

Use peer connect-interface to specify a source interface (IP address/IPv6 address) for establishing TCP connections to a peer or peer group.

Use undo peer connect-interface to restore the default.

Syntax

peer { group-name | ip-address | ipv6-address } connect-interface interface-type interface-number

undo peer { group-name | ip-address | ipv6-address } connect-interface

Default

BGP uses the output interface (IP address/IPv6 address) of the best route destined for the BGP peer or peer group as the source interface for establishing a TCP connection to the peer or peer group.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

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

Usage guidelines

If the peer's IP address/IPv6 address belongs to an interface indirectly connected to the local router, specify that interface as the source interface for TCP connections on the peer. For example, interface A on the local end is directly connected to interface B on the peer. When you execute the peer x.x.x.x as-number as-number command on the local end to specify the BGP peer, and x.x.x.x is not the IP address of interface B, use the peer connect-interface command on the peer to specify the interface whose IP address is x.x.x.x as the source interface for establishing a TCP connection.

If a BGP router has multiple links to a peer, and the source interface fails, BGP has to reestablish TCP connections, causing network oscillation. To improve link availability, H3C recommends that you use a loopback interface as the source interface.

To establish multiple BGP sessions between two routers, specify the source interface for establishing TCP connections to each peer on the local router. Otherwise, the local BGP router might fail to establish TCP connections to a peer when using the outbound interface of the best route to the peer as the source interface.

The source interfaces on the local router and the peer must be reachable.

To specify an indirectly connected interface (except loopback interfaces) on an EBGP peer as the source interface, use the peer ebgp-max-hop command to allow the establishment of an EBGP session to the indirectly connected peer.

If an interface has multiple IP addresses, use the primary IP address for establishing TCP connections. If an interface has multiple IPv6 addresses, select an IPv6 address as defined in RFC 3484 for establishing TCP connections.

Examples

# In BGP view, specify loopback 0 as the source interface for TCP connections to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer test connect-interface loopback 0

# In BGP-VPN view, specify loopback 0 as the source interface for TCP connections to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer test connect-interface loopback 0

Related commands

peer ebgp-max-hop

peer default-route-advertise

Use peer default-route-advertise to advertise a default route to a peer or peer group.

Use undo peer default-route-advertise to disable default route advertisement to a peer or peer group.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view:

peer { group-name | ip-address } default-route-advertise [ route-policy route-policy-name ]

undo peer { group-name | ip-address } default-route-advertise [ route-policy route-policy-name ]

In BGP VPNv4 instance view:

peer { group-name | ip-address } default-route-advertise vpn-instance vpn-instance-name

undo peer { group-name | ip-address } default-route-advertise vpn-instance vpn-instance-name

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } default-route-advertise [ route-policy route-policy-name ]

undo peer { group-name | ip-address | ipv6-address } default-route-advertise [ route-policy route-policy-name ]

Default

No default route is advertised to a peer or peer group.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP IPv6 unicast instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

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

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

The peer default-route-advertise command enables the router to send a default route with the next hop being itself to the peer or peer group regardless of whether the default route exists in the routing table.

Examples

# In BGP IPv4 unicast instance view, advertise a default route to peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer test default-route-advertise

# In BGP-VPN IPv4 unicast instance view, advertise a default route to peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] peer test default-route-advertise

# In BGP IPv6 unicast instance view, advertise a default route to peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] peer test default-route-advertise

peer description

Use peer description to configure a description for a peer or peer group.

Use undo peer description to remove the description for a peer or peer group.

Syntax

peer { group-name | ip-address| ipv6-address } description description-text

undo peer { group-name | ip-address| ipv6-address } description

Default

No description information is configured for a peer or peer group.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

description-text: Specifies a description for a peer or peer group, a case-sensitive string of 1 to 79 characters.

Examples

# In BGP view, configure a description for the peer group test as ISP1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer test description ISP1

# In BGP-VPN view, configure a description for the peer group test as ISP1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer test description ISP1

peer ebgp-max-hop

Use peer ebgp-max-hop to enable BGP to establish an EBGP session to an indirectly-connected peer or peer group and specify the maximum hop count.

Use undo peer ebgp-max-hop to restore the default.

Syntax

peer { group-name | ip-address | ipv6-address } ebgp-max-hop [ hop-count ]

undo peer { group-name | ip-address | ipv6-address } ebgp-max-hop

Default

BGP does not establish an EBGP session to an indirectly-connected peer or peer group.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

hop-count: Specifies the maximum number of hop counts, in the range of 1 to 255. The default is 64.

Usage guidelines

EBGP peers must be directly connected. If not, use the peer ebgp-max-hop command to establish an EBGP session over multiple hops between two peers. If direct EBGP peers use loopback interfaces to establish a BGP session, you do not need to configure the peer ebgp-max-hop command.

Examples

# In BGP view, enable BGP to establish EBGP sessions to an indirectly-connected EBGP peer group test, and specify the maximum hop count as 64 (default).

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer test ebgp-max-hop

# In BGP-VPN view, enable BGP to establish EBGP sessions to an indirectly-connected EBGP peer group test, and specify the maximum hop count as 64 (default).

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer test ebgp-max-hop

peer enable

Use peer enable to enable BGP to exchange routing information for an address family with a peer or peer group.

Use undo peer enable to disable BGP from exchanging routing information for an address family with a peer or peer group.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view/BGP-VPN VPNv4 instance view/BGP VPNv6 instance view:

peer { group-name | ip-address } enable

undo peer { group-name | ip-address } enable

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } enable

undo peer { group-name | ip-address | ipv6-address } enable

In BGP-VPN IPv6 unicast instance view:

peer { group-name | ipv6-address } enable

undo peer { group-name | ipv6-address } enable

Default

BGP cannot exchange routing information with a peer or peer group.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP-VPNv4 instance view, BGP-VPN VPNv4 instance view, BGP IPv6 unicast instance view, BGP-VPN IPv6 unicast instance view, BGP-VPNv6 instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

Executing the peer enable command in different views enables BGP to exchange routing information for the corresponding address families with the specified peer.

· In BGP IPv4 unicast instance view, the command enables the capability to exchange IPv4 unicast routing information, and adds the learned routes to the BGP routing table of the public network.

· In BGP-VPN IPv4 unicast instance view, the command enables the capability to exchange IPv4 unicast routing information, and adds the learned routes to the BGP routing table of the specified VPN instance.

· In BGP VPNv4 instance view, the command enables the capability to exchange VPNv4 routing information. In an MPLS L3VPN network, execute the command on PE devices in BGP VPNv4 instance view.

· In BGP-VPN VPNv4 instance view, the command enables the capability to exchange VPNv4 routing information. In a nested VPN network, execute this command on ISP PE devices in BGP-VPN VPNv4 instance view to enable the PE devices to exchange BGP VPNv4 routing information with ISP CEs, and add the VPNv4 routes learned by the PE devices to the routing table of the specified VPN instance.

· In BGP IPv6 unicast instance view, the command enables the capability to exchange IPv6 unicast routing information, and adds the learned routes to the IPv6 BGP routing table of the public network.

· In BGP-VPN IPv6 unicast instance view, the command enables the capability to exchange IPv6 unicast routing information, and adds the learned routes to the IPv6 BGP routing table of the specified VPN instance.

· In BGP VPNv6 instance view, the command enables the capability to exchange VPNv6 routing information. In an IPv6 MPLS L3VPN network, execute the command on PE devices in BGP VPNv6 instance view.

The undo peer enable command disables BGP to exchange routing information for the corresponding address family with the peer.

Examples

# In BGP IPv4 unicast instance view, enable BGP to exchange IPv4 unicast routing information with peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer 1.1.1.1 enable

# In BGP-VPN IPv4 unicast instance view, enable BGP to exchange IPv4 unicast routing information with peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] peer 1.1.1.1 enable

# In BGP IPv6 unicast instance view, enable BGP to exchange IPv6 unicast routing information with peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] peer 1.1.1.1 enable

# In BGP-VPN IPv6 unicast instance view, enable BGP to exchange IPv6 unicast routing information with peer 1::1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] peer 1::1 enable

Related commands

· display bgp peer ipv4 unicast

· display bgp peer ipv6 unicast

peer fake-as

Use peer fake-as to advertise a fake AS number to a peer or peer group.

Use undo peer fake-as to restore the default.

Syntax

peer { group-name | ip-address | ipv6-address } fake-as as-number

undo peer { group-name | ip-address | ipv6-address } fake-as

Default

No fake local AS number is advertised to a peer or peer group.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

as-number: Specifies a fake AS number in the range of 1 to 4294967295.

Usage guidelines

After you move a BGP router from an AS to another AS (from AS 2 to AS 3 for example), you have to modify the AS number of the router on all its EBGP peers. To avoid such modifications, you can configure the router to advertise a fake AS number 2 to its EBGP peers so that the EBGP peers still think that Router A is in AS 2.

The peer fake-as command is only applicable to EBGP peers or peer groups.

If you execute the peer fake-as command on the local router, specify the local router's AS number on the peer as the fake local AS number specified in the command.

Examples

# In BGP view, advertise a fake AS number of 200 to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer test fake-as 200

# In BGP-VPN view, advertise a fake AS number of 200 to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer test fake-as 200

peer filter-policy

Use peer filter-policy to filter routes advertised to or received from a peer or peer group by using an ACL.

Use undo peer filter-policy to remove the configuration.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view:

peer { group-name | ip-address } filter-policy acl-number { export | import }

undo peer { group-name | ip-address } filter-policy [ acl-number ] { export | import }

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } filter-policy acl6-number { export | import }

undo peer { group-name | ip-address | ipv6-address } filter-policy acl6-number { export | import }

In BGP-VPN IPv6 unicast instance view:

peer { group-name | ipv6-address } filter-policy acl6-number { export | import }

undo peer { group-name | ipv6-address } filter-policy acl6-number { export | import }

In BGP VPNv6 instance view:

peer { group-name | ip-address } filter-policy acl6-number { export | import }

undo peer { group-name | ip-address } filter-policy acl6-number { export | import }

Default

No ACL-based filtering is configured.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP IPv6 unicast instance view, BGP-VPN IPv6 unicast instance view, BGP VPNv6 instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

acl-number: Specifies an ACL by its number in the range of 2000 to 3999.

acl6-number: Specifies an IPv6 ACL by its number in the range of 2000 to 3999.

export: Filters routes advertised to the peer/peer group.

import: Filters routes received from the peer/peer group.

Usage guidelines

The specified ACL referenced by the peer filter-policy command must have been created with the acl command in system view. Otherwise, all routes can pass the ACL.

If you use a basic ACL (with a number from 2000 to 2999) configured with the rule [ rule-id ] { deny | permit } source source-address source-wildcard command, the command matches whose destination network addresses match the source-address source-wildcard argument without matching the masks of the destination addresses.

If you want to use an advanced ACL (with a number from 3000 to 3999) in the command, the ACL should be configured with the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard command to deny/permit a route with the specified destination, or with the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard destination dest-addr dest-wildcard command to deny/permit a route with the specified destination and mask. The source keyword specifies the destination address of a route and the destination keyword specifies the subnet mask of the destination. The subnet mask must be contiguous. Otherwise, the configuration does not take effect.

Examples

# In BGP IPv4 unicast instance view, apply ACL 2000 to filter routes advertised to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer test filter-policy 2000 export

# In BGP-VPN IPv6 unicast instance view, apply ACL6 2000 to filter routes advertised to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] peer test filter-policy 2000 export

Related commands

· acl (ACL and QoS Command Reference)

· filter-policy export

· filter-policy import

· peer as-path-acl

· peer prefix-list

· peer route-policy

peer group

Use peer group to add a peer to a peer group.

Use undo peer group to delete a specified peer from a peer group.

Syntax

peer { ip-address | ipv6-address } group group-name [ as-number as-number ]

undo peer { ip-address | ipv6-address } group group-name

Default

No peer exists in a peer group.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

ip-address: Specifies a peer by its IP address.

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

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

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

Usage guidelines

You can add a peer to a peer group in the following ways:

· Use the peer as-number command to create a peer and specify its AS number, and then use the peer group command to add the peer to the peer group.

¡ You can specify the as-number keyword for the peer group command. The AS number must be the same as the AS number specified in the peer as-number command.

¡ If you have specified the AS number of the peer group with the peer as-number command, the peer to be added must have the same AS number as the peer group.

¡ To add a peer to an IBGP peer group, the peer must be an IBGP peer.

· Use the peer group command to create a peer and add it to the peer group.

¡ If you have specified the AS number of the peer group with the peer as-number command, you do not need to specify the as-number keyword when you execute the peer group command, because the AS number of the peer is the same as the peer group. To specify the as-number keyword for the peer group command, make sure that the AS number is the same as the peer group.

¡ If no AS number is specified for an EBGP peer group, specify the as-number keyword when you execute the peer group command.

¡ If no AS number is specified for an IBGP peer group, you do not need to specify the as-number keyword when you execute the peer group command, because the AS number of the IBGP peer group is the local AS number. To specify the as-number keyword for the peer group command, make sure that the AS number is the same as the local AS number.

If you have specified the AS number of a peer group with the peer as-number command, only the peers with the same AS number can be added to the peer group. All peers in the group share the same AS number. If you have not specified the AS number for a peer group, peers added to it can use their own AS numbers.

After you add a peer to a peer group, you must use the peer enable command to enable BGP to exchange routing information with the peer group.

Examples

# In BGP view, add peer 10.1.1.1 to the EBGP peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test external

[Sysname-bgp] peer 10.1.1.1 group test as-number 2004

# In BGP-VPN view, add peer 10.1.1.1 to the EBGP peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] group test external

[Sysname-bgp-vpn1] peer 10.1.1.1 group test as-number 2004

# In BGP view, add peer 1::1 to the EBGP peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test external

[Sysname-bgp] peer 1::1 group test as-number 2004

# In BGP-VPN view, add peer 1::1 to the EBGP peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] group test external

[Sysname-bgp-vpn1] peer 1::1 group test as-number 2004

Related commands

· group

· peer as-number

· peer enable

peer ignore

Use peer ignore to disable BGP session establishment with a peer or peer group.

Use undo peer ignore to restore the default.

Syntax

peer { group-name | ip-address | ipv6-address } ignore

undo peer { group-name | ip-address | ipv6-address } ignore

Default

BGP can establish a session to a peer or peer group.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

This command enables you to temporarily tear down the BGP session to a specific peer or peer group so that you can perform network upgrade and maintenance without needing to delete and reconfigure the peer or peer group. To recover the session, execute the undo peer ignore command.

If a session has been established to a peer, executing the peer ignore command for the peer tears down the session and clears all related routing information.

If sessions have been established to a peer group, executing the peer ignore command for the peer group disables the sessions to all peers in the group and clears all related routing information.

Examples

# In BGP view, disable session establishment with peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 1.1.1.1 ignore

# In BGP-VPN view, disable session establishment with peer 1::1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer 1::1 ignore

peer ignore-originatorid

Use peer ignore-originatorid to ignore the ORIGINATOR_ID attribute of BGP routes.

Use undo peer ignore-originatorid to restore the default.

Syntax

peer { group-name | ip-address | ipv6-address } ignore-originatorid

undo peer { group-name | ip-address | ipv6-address } ignore-originatorid

Default

A BGP router does not ignore the ORIGINATOR_ID attribute of BGP routes.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

After receiving a route from a peer, the route reflector adds the ORIGINATOR_ID attribute to the route and then reflects the route. The ORIGINATOR_ID identifies the router ID of the originating peer. When a BGP router receives the route, it compares the ORIGINATOR_ID of the route with the local router ID. If they are the same, the BGP router discards the route to avoid routing loops.

In some special networks, a BGP router must ignore the ORIGINATOR_ID attribute so it can learn the routes in which the ORIGINATOR_ID is the same as the local router ID. For example, when different VPN instances on the same PE need to exchange the VPN routes through IBGP and one VPN instance is configured as the route reflector, you must execute this command to ignore the ORIGINATOR_ID attribute of BGP routes.

After this command is executed, the CLUSTER_LIST attribute of BGP routes is also ignored.

Use this command only when necessary. If routing loops cannot be avoided in the network, do not execute this command.

Examples

# In BGP view, configure the device to ignore the ORIGINATOR_ID attribute of BGP routes received from peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 1.1.1.1 ignore-originatorid

# In BGP-VPN view, configure the device to ignore the ORIGINATOR_ID attribute of BGP routes received from peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer 1.1.1.1 ignore-originatorid

peer keep-all-routes

Use peer keep-all-routes to save all route updates from a peer or peer group, regardless of whether the routes have passed the configured routing policy.

Use undo peer keep-all-routes to restore the default.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view:

peer { group-name | ip-address } keep-all-routes

undo peer { group-name | ip-address } keep-all-routes

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } keep-all-routes

undo peer { group-name | ip-address | ipv6-address } keep-all-routes

Default

Route updates from a peer or peer group are not saved.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP IPv6 unicast instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

To implement BGP session soft-reset when the local router and a peer or peer group do not support the route refresh function, use the peer keep-all-routes command to save all route updates received from the peer or peer group. After modifying the route selection policy, filter all saved routes with the new policy to refresh the routing table. This method avoids tearing down BGP sessions.

Examples

# In BGP IPv4 unicast instance view, save all route updates from peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer 1.1.1.1 keep-all-routes

# In BGP-VPN IPv4 unicast instance view, save all route updates from peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] peer 1.1.1.1 keep-all-routes

# In BGP IPv6 unicast instance view, save all route updates from peer 1::1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] peer 1::1 keep-all-routes

Related commands

· peer capability-advertise route-refresh

· refresh bgp ipv4 unicast

· refresh bgp ipv6 unicast

peer label-route-capability

Use peer label-route-capability to enable BGP to exchange labeled routes with a peer or peer group.

Use undo peer label-route-capability to disable BGP from exchanging labeled routes with a peer or peer group.

Syntax

peer { group-name | ip-address } label-route-capability

undo peer { group-name | ip-address } label-route-capability

Default

BGP cannot exchange labeled routes with a peer or peer group.

Views

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

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

Usage guidelines

In an inter-AS VPN Option C network, you must execute the peer label-route-capability command in BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view to enable the local router and the peer to assign labels to BGP IPv4 routes and exchange the labeled routes for establishing the inter-AS public network LSPs.

In a 6PE network, you must execute the peer label-route-capability command in BGP IPv6 unicast instance view to enable the local router and the peer to assign labels to BGP IPv6 routes and exchange the labeled routes for forwarding IPv6 packets over an IPv4 network.

Examples

# In BGP IPv4 unicast instance view, enable BGP to exchange labeled IPv4 routes with peer 2.2.2.2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family

[Sysname-bgp-ipv4] peer 2.2.2.2 label-route-capability

# In BGP-VPN IPv4 unicast instance view, enable BGP to exchange labeled IPv4 routes with peer 2.2.2.2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] peer 2.2.2.2 label-route-capability

# In BGP IPv6 unicast instance view, enable BGP to exchange labeled IPv6 routes with peer 2.2.2.2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-ipv6] peer 2.2.2.2 label-route-capability

peer low-memory-exempt

Use peer low-memory-exempt to configure BGP to protect EBGP peer or peer group when the memory usage reaches level 2 threshold.

Use undo peer low-memory-exempt to restore the default.

Syntax

peer { group-name | ip-address | ipv6-address } low-memory-exempt

undo peer { group-name | ip-address | ipv6-address } low-memory-exempt

Default

When the memory usage reaches level 2 threshold, BGP tears down an EBGP session to release memory resources periodically.

Views

BGP view, BGP-VPN instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

Memory usage includes the following levels of thresholds: normal, level 1, level 2, and level 3. When level 2 threshold is reached, BGP tears down an EBGP session to release memory resources periodically until the memory usage is exempt from level 2 threshold. You can use this command to avoid tearing down the BGP session with a specific EBGP peer when memory usage reaches level 2 threshold.

For more information about thresholds, see Fundamentals Configuration Guide.

Examples

# In BGP view, configure BGP to protect EBGP peer 1.1.1.1 when the memory usage reaches level 2 threshold.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 1.1.1.1 as-number 200

[Sysname-bgp] peer 1.1.1.1 low-memory-exempt

# In BGP-VPN instance view, configure BGP to protect EBGP peer 1.1.1.1 when the memory usage reaches level 2 threshold.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer 1.1.1.1 as-number 200

[Sysname-bgp-vpn1] peer 1.1.1.1 low-memory-exempt

peer next-hop-local

Use peer next-hop-local to specify a router as the next hop for routes sent to a peer or peer group.

Use undo peer next-hop-local to restore the default.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view:

peer { group-name | ip-address } next-hop-local

undo peer { group-name | ip-address } next-hop-local

In BGP IPv6 unicast instance view:

peer { group-name | ipv6-address } next-hop-local

undo peer { group-name | ipv6-address } next-hop-local

Default

The router sets itself as the next hop for routes sent to an EBGP peer or peer group, but does not set itself as the next hop for routes sent to an IBGP peer or peer group.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP IPv6 unicast instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

To make sure that an IBGP peer can find the next hop, you can use this command to specify the router as the next hop for routes sent to the IBGP peer.

Examples

# In BGP IPv4 unicast instance view, specify the router as the next hop for routes sent to peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer test next-hop-local

# In BGP-VPN IPv4 unicast instance view, specify the router as the next hop for routes sent to peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] peer test next-hop-local

# In BGP IPv6 unicast instance view, specify the router as the next hop for routes sent to peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] peer test next-hop-local

peer password

Use peer password to enable MD5 authentication for a BGP peer or peer group.

Use undo peer password to remove MD5 authentication for the BGP peer or peer group.

Syntax

peer { group-name | ip-address | ipv6-address } password { cipher | simple } password

undo peer { group-name | ip-address | ipv6-address } password

Default

MD5 authentication is disabled.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

cipher: Sets a ciphertext password.

simple: Sets a plaintext password.

password: Specifies a password, a case-sensitive string of 33 to 137 characters in cipher text, or 1 to 80 characters in plain text.

Usage guidelines

You can enable MD5 authentication to enhance security in the following ways:

· Perform MD5 authentication when establishing TCP connections. Only the two parties that have the same password configured can establish TCP connections.

· Perform MD5 calculation on TCP packets to avoid modification to the encapsulated BGP packets.

For secrecy, all passwords, including passwords configured in plain text, are saved in cipher text.

Examples

# In BGP view, perform MD5 authentication on the TCP connection between the local router 10.1.100.1 and the peer router 10.1.100.2, and set the plaintext authentication password to aabbcc.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 10.1.100.2 password simple aabbcc

# Perform similar configuration on the peer.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 10.1.100.1 password simple aabbcc

# In BGP-VPN view, perform MD5 authentication on the TCP connection between the local router 10.1.100.1 and the peer router 10.1.100.2, and set the plaintext authentication password to aabbcc.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer 10.1.100.2 password simple aabbcc

# Perform similar configuration on the peer.

<Sysname> system-view

[Sysname] bgp 200

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer 10.1.100.1 password simple aabbcc

peer preferred-value

Use peer preferred-value to specify a preferred value for routes received from a peer or peer group.

Use undo peer preferred-value to restore the default.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view/BGP VPNv6 instance view:

peer { group-name | ip-address } preferred-value value

undo peer { group-name | ip-address } preferred-value

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } preferred-value value

undo peer { group-name | ip-address | ipv6-address } preferred-value

In BGP-VPN IPv6 unicast instance view:

peer { group-name | ipv6-address } preferred-value value

undo peer { group-name | ipv6-address } preferred-value

Default

The preferred value is 0.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP-VPNv4 instance view, BGP IPv6 unicast instance view, BGP-VPN IPv6 unicast instance view, BGP-VPNv6 instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

value: Specifies the preferred value in the range of 0 to 65535.

Usage guidelines

If multiple routes that have the same destination are learned from different peers, you can specify different preferred values for the routes as needed to control BGP path selection. The one with the greatest preferred value is selected as the optimal route to the destination.

The preferred value is used for route selection on the local router and is not advertised to the peer. It has only local significance.

You can also use the apply preferred-value command in a routing policy to configure the preferred value for BGP routes. If both the peer preferred-value and apply preferred-value commands are configured, the apply preferred-value command applies. If the preferred value set by the apply preferred-value command is 0 or no routing policy is configured, the peer preferred-value command applies.

Examples

# In BGP IPv4 unicast instance view, specify the preferred value as 50 for routes from peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer 1.1.1.1 preferred-value 50

# In BGP VPNv4 instance view, specify the preferred value as 50 for routes from peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family vpnv4

[Sysname-bgp-vpnv4] peer 1.1.1.1 preferred-value 50

# In BGP-VPN IPv6 unicast instance view, specify the preferred value as 50 for routes from peer 1::1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] peer 1::1 preferred-value 50

Related commands

· apply preferred-value

· route-policy

peer prefix-list

Use peer prefix-list to reference a prefix list to filter routes received from or advertised to a peer or peer group.

Use undo peer prefix-list to remove the configuration.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view:

peer { group-name | ip-address } prefix-list prefix-list-name { export | import }

undo peer { group-name | ip-address } prefix-list prefix-list-name { export | import }

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } prefix-list ipv6-prefix-name { export | import }

undo peer { group-name | ip-address | ipv6-address } prefix-list ipv6-prefix-name { export | import }

In BGP-VPN IPv6 unicast instance view:

peer { group-name | ipv6-address } prefix-list ipv6-prefix-name { export | import }

undo peer { group-name | ipv6-address } prefix-list ipv6-prefix-name { export | import }

In BGP VPNv6 instance view:

peer { group-name | ip-address } prefix-list ipv6-prefix-name { export | import }

undo peer { group-name | ip-address } prefix-list ipv6-prefix-name { export | import }

Default

No prefix list based filtering is configured.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP IPv6 unicast instance view, BGP-VPN IPv6 unicast instance view, BGP VPNv6 instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IPv4 address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

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

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

export: Applies the filter to routes advertised to the specified peer/peer group.

import: Applies the filter to routes received from the specified peer/peer group.

Usage guidelines

The specified IPv4 prefix list or IPv6 prefix list must have been created with the ip prefix-list or ipv6 prefix-list command in system view. Otherwise, all routes can pass the IPv4/IPv6 prefix list.

Examples

# In BGP IPv4 unicast instance view, use the IPv4 prefix list list1 to filter routes advertised to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer test prefix-list list1 export

# In BGP-VPN IPv6 unicast instance view, use the IPv6 prefix list list1 to filter routes advertised to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] peer test prefix-list list1 export

Related commands

· filter-policy export

· filter-policy import

· ip prefix-list

· ipv6 prefix-list

· peer as-path-acl

· peer filter-policy

· peer route-policy

peer public-as-only

Use peer public-as-only to remove private AS numbers in BGP updates sent to an EBGP peer or peer group.

Use undo peer public-as-only to restore the default.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view/BGP VPNv6 instance view:

peer { group-name | ip-address } public-as-only

undo peer { group-name | ip-address } public-as-only

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } public-as-only

undo peer { group-name | ip-address | ipv6-address } public-as-only

In BGP-VPN IPv6 unicast instance view:

peer { group-name | ipv6-address } public-as-only

undo peer { group-name | ipv6-address } public-as-only

Default

BGP updates sent to an EBGP peer or peer group can carry both public and private AS numbers.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP IPv6 unicast instance view, BGP-VPN IPv6 unicast instance view, BGP VPNv6 instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

Private AS numbers are typically used in test networks, and need not be transmitted in public networks. The range of private AS numbers is from 64512 to 65535.

After you execute the command, you can get the following results:

· If the AS_PATH attribute of a BGP update carries only private AS numbers, the device removes the AS numbers before sending the update to the EBGP peer or peer group.

· If the AS_PATH attribute carries both public and private AS numbers, the command does not take effect. The device sends the BGP update to the EBGP peer or peer group without removing the private AS numbers.

· If the AS_PATH attribute carries AS numbers of the peer or peer group, the command does not take effect. The device sends the BGP update to the peer or peer group without removing the private AS numbers.

This command is only applicable to an EBGP peer or peer group.

Examples

# In BGP IPv4 unicast instance view, remove private AS numbers in BGP updates sent to EBGP peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer test public-as-only

# In BGP VPNv4 instance view, remove private AS numbers in BGP updates sent to EBGP peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family vpnv4

[Sysname-bgp-vpnv4] peer test public-as-only

# In BGP-VPN IPv6 unicast instance view, remove private AS numbers in BGP updates sent to EBGP peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] peer test public-as-only

peer reflect-client

Use peer reflect-client to configure the device as a route reflector and specify a peer or peer group as a client.

Use undo peer reflect-client to restore the default.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view/BGP VPNv6 instance view:

peer { group-name | ip-address } reflect-client

undo peer { group-name | ip-address } reflect-client

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } reflect-client

undo peer { group-name | ip-address | ipv6-address } reflect-client

Default

Neither the route reflector nor the client is configured.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP IPv6 unicast instance view, BGP VPNv6 instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

Using route reflectors can solve the issue brought by too many IBGP connections. In an AS, a router acts as a route reflector, and other routers act as clients connecting to the route reflector. The route reflector forwards the routing information received from a client to other clients. In this way, all clients can receive routing information from one another without establishing BGP sessions.

Examples

# In BGP IPv4 unicast instance view, configure the local device as a route reflector and specify the IBGP peer group test as a client.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer test reflect-client

# In BGP VPNv4 instance view, configure the local device as a route reflector and specify the IBGP peer group test as a client.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family vpnv4

[Sysname-bgp-vpnv4] peer test reflect-client

# In BGP-VPN IPv6 unicast instance view, configure the local device as a route reflector and specify the IBGP peer group test as a client.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] peer test reflect-client

Related commands

· reflect between-clients

· reflector cluster-id

peer route-limit

Use peer route-limit to specify the maximum number of routes that can be received from a peer or peer group.

Use undo peer route-limit to restore the default.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view/BGP VPNv6 instance view:

peer { group-name | ip-address } route-limit prefix-number [ { alert-only | reconnect reconnect-time } | percentage-value ] *

undo peer { group-name | ip-address } route-limit

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } route-limit prefix-number [ { alert-only | reconnect reconnect-time } | percentage-value ] *

undo peer { group-name | ip-address | ipv6-address } route-limit

Default

The number of routes that can be received from a peer or peer group is not limited.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP IPv6 unicast instance view, BGP VPNv6 instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

prefix-number: Specifies the number of routes that can be received from the peer or peer group, in the range of 1 to 4294967295. If the alert-only and reconnect keywords are not specified, and the number of routes received from the peer or peer group reaches the prefix-number, the router will tear down the connection to the peer or peer group.

alert-only: If the number of routes received from the peer or peer group reaches the prefix-number, the router displays an alarm message instead of tearing down the connection to the peer or peer group.

reconnect reconnect-time: Specifies a reconnect time, after which, the router re-establishes a connection to the peer or peer group when the number of routes received from the peer or peer group reaches the prefix-number. The value range for the reconnect-time argument is 1 to 65535 seconds.

percentage-value: Specifies the threshold value for the router to display an alarm message (the router displays an alarm message when the ratio of the number of received routes to the prefix-number exceeds the percentage value). The value range for this argument is 1 to 100, and the default is 75.

Examples

# In BGP IPv4 unicast instance view, specify the maximum number of routes that can be received from peer 1.1.1.1 to 10000, and configure the router to tear down the connection to the peer if the number is exceeded.

<Sysname> system-view

[Sysname] bgp 109

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer 1.1.1.1 route-limit 10000

# In BGP-VPN IPv4 unicast instance view, specify the maximum number of routes that can be received from peer 1.1.1.1 to 10000, and configure the router to tear down the connection to the peer if the number is exceeded.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] peer 1.1.1.1 route-limit 10000

# In BGP IPv6 unicast instance view, specify the maximum number of routes that can be received from peer 1::1 to 10000, and configure the router to tear down the connection to the peer if the number is exceeded.

<Sysname> system-view

[Sysname] bgp 109

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] peer 1::1 route-limit 10000

peer route-policy

Use peer route-policy to apply a routing policy to routes incoming from or outgoing to a peer or peer group.

Use undo peer route-policy to remove the configuration.

Syntax

In BGP IPv4 unicast instance view/BGP-VPN IPv4 unicast instance view/BGP VPNv4 instance view/BGP VPNv6 instance view:

peer { group-name | ip-address } route-policy route-policy-name { export | import }

undo peer { group-name | ip-address } route-policy route-policy-name { export | import }

In BGP-VPN VPNv4 instance view:

peer { group-name | ip-address } route-policy route-policy-name import

undo peer { group-name | ip-address } route-policy route-policy-name import

In BGP IPv6 unicast instance view:

peer { group-name | ip-address | ipv6-address } route-policy route-policy-name { export | import }

undo peer { group-name | ip-address | ipv6-address } route-policy route-policy-name { export | import }

In BGP-VPN IPv6 unicast instance view:

peer { group-name | ipv6-address } route-policy route-policy-name { export | import }

undo peer { group-name | ipv6-address } route-policy route-policy-name { export | import }

Default

No routing policy is applied to routes from/to the peer or peer group.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP-VPN VPNv4 instance view, BGP IPv6 unicast instance view, BGP-VPN IPv6 unicast instance view, BGP VPNv6 instance view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

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

export: Applies the routing policy to routes outgoing to the peer or peer group.

import: Applies the routing policy to routes incoming from the peer or peer group.

Usage guidelines

The specified routing policy must have been configured with the route-policy command in system view. Otherwise, all routes can pass the routing policy.

The if-match interface command, if configured for the referenced routing policy, does not take effect for routes.

Examples

# In BGP IPv4 unicast instance view, apply routing policy test-policy to routes outgoing to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] peer test route-policy test-policy export

# In BGP-VPN IPv6 unicast instance view, apply the routing policy test-policy to routes outgoing to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] peer test route-policy test-policy export

Related commands

· filter-policy export

· filter-policy import

· peer as-path-acl

· peer filter-policy

· peer prefix-list

· route-policy

peer route-update-interval

Use peer route-update-interval to specify an interval for sending the same update to a peer or peer group.

Use undo peer route-update-interval to restore the default.

Syntax

peer { group-name | ip-address | ipv6-address } route-update-interval interval

undo peer { group-name | ip-address | ipv6-address } route-update-interval

Default

The interval for sending the same update to an IBGP peer is 15 seconds and the interval for sending the same update to an EBGP peer is 30 seconds.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

interval: Specifies a minimum interval for sending the same update message. The range is 0 to 600 seconds.

Usage guidelines

A BGP router sends an update message to its peers when a route is changed. If the route changes frequently, the BGP router sends many updates for the route, resulting in routing flaps. By configuring the interval for sending the same update to a peer or peer group, you can avoid such routing flaps.

Examples

# In BGP view, specify the interval for sending the same update to peer group test as 10 seconds.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer test as-number 100

[Sysname-bgp] peer test route-update-interval 10

# In BGP-VPN view, specify the interval for sending the same update to peer group test as 10 seconds.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer test route-update-interval 10

peer substitute-as

Use peer substitute-as to replace the AS number of a peer or peer group in the AS_PATH attribute with the local AS number.

Use undo peer substitute-as to restore the default.

Syntax

peer { group-name | ip-address | ipv6-address } substitute-as

undo peer { group-name | ip-address | ipv6-address } substitute-as

Default

The AS number of a peer or peer group in the AS_PATH attribute is not replaced.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

Usage guidelines

In MPLS L3VPN, if EBGP is used between PE and CE, sites in different geographical areas must have different AS numbers assigned to ensure correct route advertisement. If different CEs use the same AS number, you must configure the relevant PE to replace the AS number of the CE as its own AS number to ensure correct advertisement of private network routes.

Examples

# In BGP view, substitute the local AS number for the AS number of peer 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 1.1.1.1 substitute-as

# In BGP-VPN view, substitute the local AS number for the AS number of peer 1::1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer 1::1 substitute-as

peer timer

Use peer timer to configure a keepalive interval and holdtime for a peer or peer group.

Use undo peer timer to restore the default.

Syntax

peer { group-name | ip-address | ipv6-address } timer keepalive keepalive hold holdtime

undo peer { group-name | ip-address | ipv6-address } timer

Default

The keepalive interval is 60 seconds, and the holdtime is 180 seconds.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ip-address: Specifies a peer by its IP address. The peer must have been created.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

keepalive keepalive: Sets a keepalive interval in the range of 0 to 21845 seconds.

hold holdtime: Sets a holdtime in the range of 3 to 65535 seconds.

Usage guidelines

After establishing a BGP session, two routers send keepalive messages at the specified keepalive interval to each other to keep the session.

If a router receives no keepalive or update message from the peer within the holdtime, it tears down the session.

The timers configured with this command are preferred to the timers configured with the timer command.

If the holdtime settings on the local and peer routers are different, the smaller one is used.

If the holdtime is configured as 0, no keepalive message will be sent to the peer, and the peer session will never time out. If the keepalive interval is configured as 0 and the negotiated holdtime is not 0, one third of the holdtime is taken as the interval for sending keepalive messages. If neither the holdtime nor the keepalive interval is configured as 0, the actual keepalive interval is the smaller one between one third of the holdtime and the keepalive interval.

After this command is executed, the peer session is closed at once, and a new session to the peer is negotiated by using the configured holdtime.

Examples

# In BGP view, configure the keepalive interval and holdtime for peer group test as 60s and 180s.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer test timer keepalive 60 hold 180

# In BGP-VPN view, configure the keepalive interval and holdtime interval for peer group test as 60s and 180s.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer test timer keepalive 60 hold 180

# In BGP view, configure both the keepalive interval and holdtime for peer group test as 0 seconds, indicating the session will never time out.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer test timer keepalive 0 hold 0

# In BGP-VPN view, configure both the keepalive interval and holdtime for peer group test as 0 seconds, indicating the session will never time out.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] peer test timer keepalive 0 hold 0

Related commands

· display bgp peer ipv4 unicast

· display bgp peer ipv6 unicast

· timer

preference

Use preference to configure preferences for BGP routes.

Use undo preference to restore the default.

Syntax

preference { external-preference internal-preference local-preference | route-policy route-policy-name }

undo preference

Default

The preferences of external, internal, and local BGP routes are 255, 255, and 130.

Views

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

Predefined user roles

network-admin

mdc-admin

Parameters

external-preference: Specifies a preference for EBGP routes, in the range of 1 to 255.

internal-preference: Specifies a preference for IBGP routes, in the range of 1 to 255.

local-preference: Specifies a preference for local routes, in the range of 1 to 255.

route-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters, to set the route preference for matching routes. Routes not matching the routing policy use the default preference.

Usage guidelines

Configuring the preferences for BGP routes changes the possibility for the routes to become the optimal route.

To reference a routing policy to set the preference, you must configure the preference with the apply preference command in the routing policy in advance. Otherwise, all matching routes use the default preference.

Examples

# In BGP IPv4 unicast instance view, configure preferences for EBGP, IBGP, and local routes as 20, 20, and 200.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] preference 20 20 200

# In BGP IPv4 unicast instance view, configure the preference for BGP route 1.1.1.0/24 as 200.

<Sysname> system-view

[Sysname] ip prefix-list route permit 1.1.1.0 24

[Sysname] route-policy prefer permit node 0

[Sysname-route-policy-prefer-0] if-match ip address prefix-list route

[Sysname-route-policy-prefer-0] apply preference 200

[Sysname-route-policy-prefer-0] quit

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] preference route-policy prefer

# In BGP-VPN IPv6 unicast instance view, configure preferences for EBGP, IBGP, and local routes as 20, 20, and 200.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv6-family unicast

[Sysname-bgp-ipv6-vpn1] preference 20 20 200

reflect between-clients

Use reflect between-clients to enable route reflection between clients.

Use undo reflect between-clients to disable this function.

Syntax

reflect between-clients

undo reflect between-clients

Default

Route reflection between clients is enabled.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP IPv6 unicast instance view, BGP VPNv6 instance view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

When a route reflector is configured, and the clients of a route reflector are fully meshed, route reflection is unnecessary because it consumes more bandwidth resources. You can use the undo reflect between-clients command to disable route reflection instead of modifying network configuration or changing network topology.

After route reflection is disabled between clients, routes can still be reflected between a client and a non-client.

Examples

# In BGP IPv4 unicast instance view, disable route reflection between clients.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] undo reflect between-clients

# In BGP VPNv4 instance view, disable route reflection between clients.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family vpnv4

[Sysname-bgp-vpnv4] undo reflect between-clients

# In BGP-VPN IPv4 unicast instance view, disable route reflection between clients.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] undo reflect between-clients

# In BGP IPv6 unicast instance view, disable route reflection between clients.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family unicast

[Sysname-bgp-ipv6] undo reflect between-clients

Related commands

· peer reflect-client

· reflector cluster-id

reflector cluster-id

Use reflector cluster-id to configure the cluster ID for a route reflector.

Use undo reflector cluster-id to restore the default.

Syntax

reflector cluster-id { cluster-id | ip-address }

undo reflector cluster-id

Default

A route reflector uses its router ID as the cluster ID.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view, BGP VPNv4 instance view, BGP IPv6 unicast instance view, BGP VPNv6 instance view

Predefined user roles

network-admin

mdc-admin

Parameters

cluster-id: Specifies the cluster ID in the format of an integer, in the range of 1 to 4294967295.

ip-address: Specifies the cluster ID in the format of an IPv4 address in dotted decimal notation.

Usage guidelines

The route reflector and clients form a cluster. Typically a cluster has one route reflector. The ID of the route reflector is the cluster ID.

You can configure more than one route reflector in a cluster to improve network reliability and prevent a single point of failure. Use this command to configure the same cluster ID for all route reflectors in the cluster to avoid routing loops.

Do not configure the router ID of a client as the cluster ID.

Examples

# In BGP IPv4 unicast instance view, configure the cluster ID on the local router (a reflector in the cluster) as 80.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] reflector cluster-id 80

# In BGP VPNv4 instance view, configure the cluster ID on the local router (a reflector in the cluster) as 80.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family vpnv4

[Sysname-bgp-vpnv4] reflector cluster-id 80

# In BGP-VPN IPv4 unicast instance view, configure the cluster ID on the local router (a reflector in the cluster) as 80.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] reflector cluster-id 80

# In BGP IPv6 unicast instance view, configure the cluster ID on the local router (a reflector in the cluster) as 80.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] reflector cluster-id 80

Related commands

· peer reflect-client

· reflect between-clients

refresh bgp ipv4 unicast

Use refresh bgp ipv4 unicast to manually soft-reset BGP sessions for the IPv4 unicast address family.

Syntax

refresh bgp { ip-address | all | external | group group-name | internal } { export | import } ipv4 [ unicast ] [ vpn-instance vpn-instance-name ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

ip-address: Soft-resets the BGP session to the specified peer. The ip-address argument refers to the IP address of a peer.

all: Soft-resets all BGP sessions.

external: Soft-resets all EBGP sessions.

group group-name: Soft-resets the BGP sessions to the peers of the specified peer group. The group-name argument refers to the name of a peer group, a case-sensitive string of 1 to 47 characters.

internal: Soft-resets all IBGP sessions.

export: Performs outbound soft-reset (filters routes advertised to the specified peer or peer group by using the new configuration).

import: Performs inbound soft-reset (filters routes received from the specified peer or peer group by using the new configuration).

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If no VPN is specified, this command performs manual soft-reset on BGP sessions for the public network IPv4 unicast address family.

Usage guidelines

After the route selection policy is modified, execute this command with the export keyword to enable the local router to filter routing information based on the new policy and send the matching routes to the BGP peer. If you execute this command with the import keyword, you enable the local router to advertise a route-refresh message to the peer and the peer resends its routing information to the router. After receiving the routing information, the router filters the routing information by using the new policy.

This command requires that both the local router and the peer support route refresh.

If the peer keep-all-routes command is configured, the refresh bgp ipv4 unicast import command does not take effect.

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Manually soft-reset all BGP sessions for the IPv4 unicast address family.

<Sysname> refresh bgp ipv4 all

Related commands

· peer capability-advertise route-refresh

· peer keep-all-routes

refresh bgp ipv6 unicast

Use refresh bgp ipv6 unicast to manually soft-reset BGP sessions for the IPv6 unicast address family.

Syntax

refresh bgp { ipv6-address | all | external | group group-name | internal } { export | import } ipv6 [ unicast ] [ vpn-instance vpn-instance-name ]

refresh bgp ip-address { export | import } ipv6 [ unicast ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

ipv6-address: Soft-resets the BGP session to the specified peer. The ipv6-address argument refers to the IPv6 address of a peer.

ip-address: Soft-resets the BGP session to the specified peer. The ip-address argument refers to the IP address of a peer.

all: Soft-resets all BGP sessions.

external: Soft-resets all EBGP sessions.

group group-name: Soft-resets the BGP sessions to the peers of the specified peer group. The group-name argument refers to the name of a peer group, a case-sensitive string of 1 to 47 characters.

internal: Soft-resets all IBGP sessions.

export: Performs outbound soft-reset (filters routes advertised to the specified peer or peer group by using the new configuration).

import: Performs inbound soft-reset (filters routes received from the specified peer or peer group by using the new configuration).

Usage guidelines

This command requires that both the local router and the peer support route refresh.

If the peer keep-all-routes command is configured, the refresh bgp ipv6 unicast import command does not take effect.

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Manually soft-reset all BGP sessions for the IPv6 unicast address family.

<Sysname> refresh bgp all ipv6

Related commands

· peer capability-advertise route-refresh

· peer keep-all-routes

reset bgp all

Use reset bgp all to reset all BGP sessions.

Syntax

reset bgp all

Views

User view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

To validate a new route selection policy, use this command to reset BGP sessions. BGP re-establishes the BGP sessions, advertises routes, and applies the new policy to routes. This operation breaks down BGP sessions for a short while.

Examples

# Reset all BGP sessions.

<Sysname> reset bgp all

reset bgp dampening ipv4 unicast

Use reset bgp dampening ipv4 unicast to clear BGP IPv4 unicast route dampening information and release the suppressed BGP IPv4 unicast routes.

Syntax

reset bgp dampening ipv4 [ unicast ] [ vpn-instance vpn-instance-name ] [ network-address [ mask | mask-length ] ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If no VPN is specified, this command clears BGP IPv4 unicast route dampening information for the public network, and releases the suppressed BGP IPv4 unicast routes.

network-address: Specifies a destination network address.

mask: Specifies a network mask, in dotted decimal notation.

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

Usage guidelines

When you execute the reset bgp dampening ipv4 unicast command:

· If the network-address, mask, and mask-length arguments are not specified, the command clears all BGP IPv4 unicast route dampening information of the public network or the specified VPN, and releases all suppressed BGP IPv4 unicast routes.

· If the network-address mask or network-address mask-length argument is specified, the command clears dampening information of the BGP IPv4 unicast route that matches both the specified destination network address and the mask (or mask length), and releases the suppressed route.

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Clear damping information of BGP IPv4 unicast route 20.1.0.0/16 for the public network, and release the suppressed route.

<Sysname> reset bgp dampening ipv4 20.1.0.0 255.255.0.0

Related commands

· dampening

· display bgp routing-table dampened ipv4 unicast

reset bgp dampening ipv6 unicast

Use reset bgp dampening ipv6 unicast to clear BGP IPv6 unicast route dampening information and release suppressed BGP IPv6 unicast routes.

Syntax

reset bgp dampening ipv6 [ unicast ] [ vpn-instance vpn-instance-name ] [ network-address prefix-length ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If no VPN is specified, this command clears BGP IPv6 unicast route dampening information for the public network, and releases the suppressed BGP IPv6 unicast routes.

network-address prefix-length: Specifies a destination network address and prefix length. The value range for the prefix-length argument is 0 to 128. If this argument is not specified, the command clears all BGP IPv6 unicast route dampening information, and releases all suppressed BGP IPv6 unicast routes.

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Clear damping information of BGP IPv6 unicast route 2345::/16 for the public network, and release the suppressed route.

<Sysname> reset bgp dampening ipv6 2345:: 16

Related commands

· dampening

· display bgp routing-table dampened ipv6 unicast

reset bgp flap-info ipv4 unicast

Use reset bgp flap-info ipv4 unicast to clear the flap statistics of BGP IPv4 unicast routes.

Syntax

reset bgp flap-info ipv4 [ unicast ] [ vpn-instance vpn-instance-name ] [ network-address [ mask | mask-length ] | as-path-acl as-path-acl-number | peer peer-address ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If no VPN is specified, this command clears the flap statistics of the BGP IPv4 unicast routes for the public network.

network-address: Specifies a destination network address.

mask: Specifies a network mask, in dotted decimal notation.

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

as-path-acl as-path-acl-number: Specifies an AS path list by its number in the range of 1 to 256, to filter BGP IPv4 unicast route flap statistics.

peer peer-address: Clears flap statistics of BGP IPv4 unicast routes learned from the specified BGP peer.

Usage guidelines

When you execute the reset bgp flap-info ipv4 unicast command:

· If the network-address, mask, and mask-length arguments are not specified, the command clears the flap statistics of all BGP IPv4 unicast routes for the public network or the specified VPN.

· If the network-address mask or network-address mask-length argument is specified, the command clears the flap statistics of the BGP IPv4 unicast route that matches both the specified destination network address and the mask (or mask length).

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Clear the flap statistics of BGP IPv4 unicast route 20.1.0.0/16 for the public network.

<Sysname> reset bgp flap-info ipv4 20.1.0.0 16

# Clear the flap statistics for the public network BGP IPv4 unicast routes learned from peer 1.1.1.1.

<Sysname> reset bgp flap-info ipv4 peer 1.1.1.1

Related commands

· dampening

· display bgp routing-table flap-info ipv4 unicast

reset bgp flap-info ipv6 unicast

Use reset bgp flap-info ipv6 unicast to clear the flap statistics of BGP IPv6 unicast routes.

Syntax

reset bgp flap-info ipv6 [ unicast ] [ vpn-instance vpn-instance-name ] [ network-address prefix-length | as-path-acl as-path-acl-number | peer ipv6-address ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

network-address prefix-length: Specifies the destination network address and prefix length. The value range for the prefix-length argument is 0 to 128. If this argument is not specified, the command clears the flap statistics of all BGP IPv6 unicast routes.

as-path-acl as-path-acl-number: Specifies an AS path list number in the range of 1 to 256 to filter BGP IPv6 unicast route flap statistics.

peer ipv6-address: Clears flap statistics of BGP IPv6 unicast routes learned from the specified BGP peer.

Usage guidelines

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Clear the flap statistics of BGP IPv6 unicast route 2345::/16 for the public network.

<Sysname> reset bgp flap-info ipv6 2345:: 16

# Clear the flap statistics for the public network BGP IPv6 unicast routes learned from peer 1::1.

<Sysname> reset bgp flap-info ipv6 peer 1::1

Related commands

· dampening

· display bgp routing-table flap-info ipv6 unicast

reset bgp ipv4 unicast

Use reset bgp ipv4 unicast to reset BGP sessions for the IPv4 unicast address family.

Syntax

reset bgp { as-number | ip-address | all | external | group group-name | internal } ipv4 [ unicast ] [ vpn-instance vpn-instance-name ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

as-number: Resets BGP sessions to peers in the AS.

ip-address: Specifies the IP address of a peer with which to reset the session.

all: Resets all BGP sessions of IPv4 unicast address family.

external: Resets all the EBGP sessions of IPv4 unicast address family.

group group-name: Resets sessions with peers in the specified BGP peer group.

internal: Resets all the IBGP sessions of IPv4 unicast address family.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If no VPN is specified, this command resets the BGP sessions for IPv4 unicast address family for the public network.

Usage guidelines

To apply a newly configured route selection policy, you must use this command to reset BGP sessions. BGP re-establishes the BGP sessions, advertises routes, and applies the new policy to routes. This operation breaks down BGP sessions for a short while.

The command with the unicast keyword has the same effect as that without the unicast keyword.

Examples

# Reset all BGP sessions for IPv4 unicast address family of the public network.

<Sysname> reset bgp all ipv4

reset bgp ipv6 unicast

Use reset bgp ipv6 unicast to reset BGP sessions for the IPv6 unicast address family.

Syntax

reset bgp { as-number | ipv6-address | all | external | group group-name | internal } ipv6 [ unicast ] [ vpn-instance vpn-instance-name ]

reset bgp ip-address ipv6 [ unicast ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

as-number: Resets BGP sessions to peers in the AS.

ipv6-address: Specifies the IPv6 address of a peer with which to reset the session.

ip-address: Specifies the IP address of a peer with which to reset the session.

all: Resets all BGP sessions of IPv6 unicast address family.

external: Resets all the EBGP sessions of IPv6 unicast address family.

group group-name: Resets sessions with peers in the specified BGP peer group.

internal: Resets all the IBGP sessions of IPv6 unicast address family.

Usage guidelines

To validate a newly configured route selection policy, you must use this command to reset BGP sessions. BGP re-establishes the BGP sessions, advertises routes, and applies the new policy to routes. This operation breaks down BGP sessions for a short while.

Examples

# Reset all BGP sessions for IPv6 unicast address family for the public network.

<Sysname> reset bgp all ipv6

router id

Use router id to configure a global router ID.

Use undo router id to remove the global router ID.

Syntax

router id router-id

undo router id

Default

No global router ID is configured.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

router-id: Specifies a router ID in IP address format.

Usage guidelines

Some routing protocols use a router ID to identify a device. You can configure a global router ID, which is used by routing protocols that have no router ID configured.

If no global router ID is configured, the highest loopback interface IP address, if any, is used as the router ID. If no loopback interface IP address is available, the highest physical interface IP address is used, regardless of the interface status.

During an active/standby switchover, the standby main processing unit (MPU) checks whether the previous router ID that is backed up before switchover is valid. If not, it selects a new router ID.

If the interface IP address that is selected as the router ID is removed or modified, a new router ID is selected. Other events, (the interface goes down; after a physical interface address is selected as the router ID, an IP address is configured for a loopback interface; a higher interface IP address is configured) will not trigger a router ID re-selection.

After a router ID is changed, use the reset command to make it effective.

Examples

# Configure a global router ID as 1.1.1.1.

<Sysname> system-view

[Sysname] router id 1.1.1.1

Related commands

router-id

Use router-id to specify a router ID.

Use undo router-id to remove the router ID.

Syntax

router-id router-id

undo router-id

Default

A BGP router uses the global router ID. You can execute the router id command in system view to configure the global router ID.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

router-id: Specifies a router ID in IP address format.

Usage guidelines

To run BGP protocol, a router must have a router ID, an unsigned 32-bit integer and the unique ID of the router in the AS.

To modify a router ID, execute the router-id command in BGP view, rather than the router id command in system view.

To enhance network reliability, you can specify the IP address of a local loopback interface as the router ID.

You can specify a router ID for each VPN instance on a device.

Examples

# In BGP view, configure router ID as 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] router-id 1.1.1.1

# In BGP-VPN view, configure router ID as 1.1.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] router-id 1.1.1.1

Related commands

router id

summary automatic

Use summary automatic to configure automatic route summarization for redistributed IGP subnet routes.

Use undo summary automatic to remove the configuration.

Syntax

summary automatic

undo summary automatic

Default

Automatic route summarization is not performed for redistributed IGP subnet routes.

Views

BGP IPv4 unicast instance view, BGP-VPN IPv4 unicast instance view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

After the summary automatic command is configured, BGP summarizes IGP subnets redistributed by the import-route command.

Automatic summary routes can be manually summarized, but cannot be added to the IP routing table.

Examples

# In BGP IPv4 unicast instance view, configure automatic route summarization for redistributed IGP subnet routes.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family unicast

[Sysname-bgp-ipv4] summary automatic

# In BGP-VPN IPv4 unicast instance view, configure automatic route summarization for redistributed IGP subnet routes.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] ipv4-family unicast

[Sysname-bgp-ipv4-vpn1] summary automatic

Related commands

· aggregate

· import-route

timer

Use timer to configure a BGP keepalive interval and holdtime.

Use undo timer to restore the default.

Syntax

timer keepalive keepalive hold holdtime

undo timer

Default

The BGP keepalive interval and the holdtime are 60 seconds and 180 seconds.

Views

BGP view, BGP-VPN view

Predefined user roles

network-admin

mdc-admin

Parameters

keepalive keepalive: Configures a keepalive interval in the range of 0 to 21845 seconds.

hold holdtime: Configures a holdtime in seconds, whose value is 0 or in the range of 3 to 65535.

Usage guidelines

After establishing a BGP session, two routers send keepalive messages at the specified keepalive interval to each other to keep the session.

If a router receives no keepalive or update message from the peer within the holdtime, it tears down the session.

Use the timer command to configure the keepalive interval and holdtime for all BGP peers. Use the peer timer command to configure the keepalive interval and holdtime for a peer or peer group. If both commands are configured, the intervals configured by the peer timer command have higher priority.

If the holdtime settings on the local and peer routers are different, the smaller one is used.

The timer command takes effect for only new BGP sessions.

After the timer command is executed, no peer session is closed at once. The configured holdtime is used for negotiation in session reestablishment (for example, when you reset the BGP session).

Examples

# In BGP view, configure the keepalive interval and holdtime as 60s and 180s.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] timer keepalive 60 hold 180

# In BGP-VPN view, configure the keepalive interval and holdtime as 60s and 180s.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] timer keepalive 60 hold 180

# In BGP view, configure both the keepalive interval and holdtime as 0 seconds, indicating the sessions will never time out.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] timer keepalive 0 hold 0

# In BGP-VPN view, configure both the keepalive interval and holdtime as 0 seconds for BGP sessions in vpn1, indicating the sessions will never time out.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ip vpn-instance vpn1

[Sysname-bgp-vpn1] timer keepalive 0 hold 0

Related commands

· display bgp peer ipv4 unicast

· display bgp peer ipv6 unicast

· peer timer

06-Layer 3 - IP Routing Command Reference

BGP commands

advertise-rib-active

confederation nonstandard

dampening

display bgp dampening parameter ipv4 unicast

display bgp peer ipv4 unicast

display bgp routing-table ipv4 unicast

display bgp routing-table ipv4 unicast advertise-info

display bgp routing-table ipv6 unicast

filter-policy export

peer advertise-ext-community

peer allow-as-loop

peer as-path-acl

peer default-route-advertise

peer ebgp-max-hop

peer enable

peer group

peer reflect-client

refresh bgp ipv4 unicast

reset bgp dampening ipv4 unicast

reset bgp flap-info ipv4 unicast

reset bgp ipv4 unicast

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us