CloudEngine S5700 V600R022C01 Command Reference

BGP Configuration Commands

BGP Configuration Commands

This feature is supported only by S6730-H-V2, S5732-H-V2, S5735I-S-V2, and S5735-S-V2 series.

active-route-advertise (BGP multi-instance VPN instance IPv4 address family view)

Function

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

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

By default, BGP advertises all selected routes in the BGP routing table to peers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

active-route-advertise

undo active-route-advertise

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Precautions

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

Example

# Enable BGP to advertise only the selected routes in the IP routing table to peers.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] active-route-advertise

active-route-advertise (BGP view)

Function

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

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

By default, BGP advertises all selected routes in the BGP routing table to peers.

Format

active-route-advertise

undo active-route-advertise

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Precautions

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

Example

# Enable BGP to advertise only the selected routes in the IP routing table to peers.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] active-route-advertise

active-route-advertise (BGP-IPv4 unicast address family view)

Function

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

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

By default, BGP advertises all selected routes in the BGP routing table to peers.

Format

active-route-advertise

undo active-route-advertise

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Precautions

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

Example

# Enable BGP to advertise only the selected routes in the IP routing table to peers.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] active-route-advertise

active-route-advertise (BGP-IPv6 unicast address family view)

Function

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

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

By default, BGP advertises all selected routes in the BGP routing table to peers.

Format

active-route-advertise

undo active-route-advertise

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Precautions

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

Example

# Enable BGP to advertise only the selected routes in the IP routing table to peers.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] active-route-advertise

active-route-advertise (BGP-VPN instance IPv4 address family view)

Function

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

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

By default, BGP advertises all selected routes in the BGP routing table to peers.

Format

active-route-advertise

undo active-route-advertise

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Precautions

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

Example

# Enable BGP to advertise only the selected routes in the IP routing table to peers.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] active-route-advertise

active-route-advertise (BGP-VPN instance IPv6 address family view)

Function

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

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

By default, BGP advertises all selected routes in the BGP routing table to peers.

Format

active-route-advertise

undo active-route-advertise

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Precautions

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

Example

# Enable BGP to advertise only the selected routes in the IP routing table to peers.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] active-route-advertise

advertise (BGP-VPN instance IPv4 address family view)

Function

The advertise valid-routes command configures a device to send only valid routes in a BGP VPN routing table to a BGP VPNv4/VPNv6 routing table.

The undo advertise valid-routes command restores the default configuration.

By default, a device sends all routes in a BGP VPN routing table to a BGP VPNv4 routing table.

Format

advertise valid-routes

undo advertise valid-routes

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the device advertises all routes in the BGP VPN routing table to the BGP VPNv4/VPNv6 routing table. For example, the supernet unicast routes are invalid, but VPNv4 and VPNv6 routing tables have such routes. In addition, forwarding entries are generated for such routes, and the routes are advertised to peers. You can run the advertise valid-routes command to configure a device to send only valid routes in a BGP VPN routing table to a BGP VPNv4/VPNv6 routing table.

Example

# Configure a device to send only valid routes in a BGP VPN routing table to a BGP VPNv4 routing table.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] vpn-target 100:1 both
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] advertise valid-routes

advertise (BGP-VPN instance IPv6 address family view)

Function

The advertise valid-routes command configures a device to send only valid routes in a BGP VPN routing table to a BGP VPNv4/VPNv6 routing table.

The undo advertise valid-routes command restores the default configuration.

By default, a device sends all routes in a BGP VPN routing table to a BGP VPNv4/VPNv6 routing table.

Format

advertise valid-routes

undo advertise valid-routes

Parameters

None

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the device advertises all routes in the BGP VPN routing table to the BGP VPNv4/VPNv6 routing table. For example, the supernet unicast routes are invalid, but VPNv4 and VPNv6 routing tables have such routes. In addition, forwarding entries are generated for such routes, and the routes are advertised to peers. You can run the advertise valid-routes command to configure a device to send only valid routes in a BGP VPN routing table to a BGP VPNv4/VPNv6 routing table.

Example

# Configure a device to send only valid routes in a BGP VPN routing table to a BGP VPNv4 routing table.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] advertise valid-routes

advertise bgp ipv4-family unicast lowest-priority enable

Function

The advertise bgp ipv4-family unicast lowest-priority enable command enables a device to reduce the preference of BGP routes to be advertised.

The undo advertise bgp ipv4-family unicast lowest-priority enable command restores the default configuration.

By default, BGP is disabled from setting the priorities of BGP routes to be advertised to the lowest.

Format

advertise bgp ipv4-family unicast lowest-priority enable

undo advertise bgp ipv4-family unicast lowest-priority enable

Parameters

None

Views

maintenance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the advertise bgp ipv4-family unicast lowest-priority enable command to forcibly adjust the BGP route priority to the lowest (the MED value is set to the maximum value and the Local_Pref value is set to the minimum value) so that service traffic is switched to the other device.

Precautions

The advertise bgp ipv4-family unicast lowest-priority enable command takes effect for all routes in the BGP-Ipv4 unicast and BGP-VPN instance Ipv4 address families.

If at least one of the advertise bgp ipv4-family unicast lowest-priority enable and advertise lowest-priority all-address-family peer-up commands is run, BGP can set the priorities of routes (to be advertised) in the preceding address families to the lowest when BGP peers in these address families go up from down.

After the advertise bgp ipv4-family unicast lowest-priority enable command is run, modifying the MED and Local_Pref attributes of BGP routes to be advertised through an export routing policy does not take effect.

Example

# Enable BGP to set the priorities of BGP routes to be advertised to the lowest.
<HUAWEI> system-view
[HUAWEI] maintenance
[HUAWEI-maintenance] advertise bgp ipv4-family unicast lowest-priority enable

advertise bgp ipv6-family unicast lowest-priority enable

Function

The advertise bgp ipv6-family unicast lowest-priority enable command enables BGP to set the priorities of BGP routes to be advertised to the lowest.

The undo advertise bgp ipv6-family unicast lowest-priority enable command restores the default configuration.

By default, BGP is disabled from setting the priorities of BGP routes to be advertised to the lowest.

Format

advertise bgp ipv6-family unicast lowest-priority enable

undo advertise bgp ipv6-family unicast lowest-priority enable

Parameters

None

Views

maintenance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the advertise bgp ipv6-family unicast lowest-priority enable command to forcibly adjust the BGP route priority to the lowest (the MED value is set to the maximum value and the Local_Pref value is set to the minimum value) so that service traffic is switched to the other device.

Precautions

The advertise bgp ipv6-family unicast lowest-priority enable command takes effect for all routes in the BGP-IPv6 unicast and BGP-VPN instance IPv6 address families.

If at least one of the advertise bgp ipv6-family unicast lowest-priority enable and advertise lowest-priority all-address-family peer-up commands is run, BGP can set the priorities of routes (to be advertised) in the preceding address families to the lowest when BGP peers in these address families go up from down.

After the advertise bgp ipv6-family unicast lowest-priority enable command is run, modifying the MED and Local_Pref attributes of BGP routes to be advertised through an export routing policy does not take effect.

Example

# Enable BGP to set the priorities of BGP routes to be advertised to the lowest.
<HUAWEI> system-view
[HUAWEI] maintenance
[HUAWEI-maintenance] advertise bgp ipv6-family unicast lowest-priority enable

advertise delay on-startup delay-time

Function

The advertise delay on-startup delay-time command configures a delay for BGP route advertisement after a device restart.

The undo advertise delay on-startup command restores the default configuration.

By default, BGP does not delay advertising routes after a device restart.

Format

advertise delay on-startup delay-time time-value

undo advertise delay on-startup [ delay-time time-value ]

Parameters

Parameter Description Value
delay-time time-value

Specifies a delay.

The value is an integer ranging from 1 to 864000, in seconds.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a device is restarted, routes on the device need to be advertised after a delay to prevent traffic loss during forwarding entry delivery. To solve this problem, run the advertise delay on-startup delay-time command before the device restarts to configure a BGP route advertisement delay after the device restarts. The command specifies how long the device must wait after a restart before it starts to advertise BGP routes. After forwarding entries are delivered, you can run the refresh bgp all export or reset bgp advertise delay on-startup command to enable the device to advertise BGP routes immediately.

Precautions

The advertise delay on-startup delay-time command takes effect only after the reboot command is executed and the configuration is saved.

If both this command and the advertise lowest-priority on-startup command are run, the latest configuration overrides the previous one.

This command and the advertise lowest-priority all-address-family peer-up delay command are mutually exclusive.

Example

# Configure a delay for BGP route advertisement after a device restart.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] advertise delay on-startup delay-time 100

advertise delay on-startup delay-time (BGP-IPv6 unicast address family view)

Function

The advertise delay on-startup delay-time command configures a delay for BGP4+ route advertisement after a device restart.

The undo advertise delay on-startup command restores the default configuration.

By default, BGP does not delay advertising routes after a device restart.

Format

advertise delay on-startup delay-time time-value

undo advertise delay on-startup [ delay-time time-value ]

Parameters

Parameter Description Value
delay-time time-value

Specifies a delay.

The value is an integer ranging from 1 to 864000, in seconds.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a device is restarted, routes on the device need to be advertised after a delay to prevent traffic loss during forwarding entry delivery. To solve this problem, run the advertise delay on-startup delay-time command before the device restarts to configure a BGP route advertisement delay after the device restarts. The command specifies how long the device must wait after a restart before it starts to advertise BGP4+ routes. After forwarding entries are delivered, you can run the refresh bgp all export, refresh bgp ipv6 all export, or reset bgp advertise delay on-startup command to enable the device to immediately advertise BGP4+ routes.

Precautions

The advertise delay on-startup delay-time command takes effect only after the reboot command is executed and the configuration is saved.

If both this command and the advertise lowest-priority on-startup command are run, the latest configuration overrides the previous one.

This command and the advertise lowest-priority all-address-family peer-up delay command are mutually exclusive.

Example

# Configure a delay for BGP4+ route advertisement after a device restart.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] advertise delay on-startup delay-time 100

advertise lowest-priority all-address-family peer-up

Function

The advertise lowest-priority all-address-family peer-up command configures BGP to minimize the priorities of the routes to be advertised to BGP peers when the peers go Up from Down.

The undo advertise lowest-priority all-address-family peer-up command restores the default configuration.

By default, the priorities of the BGP routes to be advertised remain unchanged.

Format

advertise lowest-priority all-address-family peer-up [ delay delay ]

undo advertise lowest-priority all-address-family peer-up [ delay delay ]

Parameters

Parameter Description Value
delay delay

Specifies a delay.

The value is an integer ranging from 1 to 864000, in seconds. The default value is 0.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the advertise lowest-priority all-address-family peer-up command is not run, BGP routes with unchanged priorities are advertised to peers when the peers go Up from Down. After the peers receive the routes, traffic may be switched back to the original paths. Consequently, lengthy packet loss may occur. To address this problem, run the advertise lowest-priority all-address-family peer-up command. After the command is run, routes advertised to the peers carry the lowest priorities (largest MED value and smallest Local_Pref value) until delay expires.

Precautions

If you run the advertise lowest-priority all-address-family peer-up delay command and then the advertise lowest-priority all-address-family peer-up command in sequence, the latest configuration overrides the previous one. That is, the delay time is cleared. The advertise lowest-priority all-address-family peer-up and advertise lowest-priority on-startup commands are mutually exclusive.

Example

# Configure BGP to minimize the priorities of the routes to be advertised to BGP peers when the peers go Up from Down in the BGP view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] advertise lowest-priority all-address-family peer-up

advertise lowest-priority all-address-family peer-up (BGP multi-instance view)

Function

The advertise lowest-priority all-address-family peer-up command configures BGP to minimize the priorities of the routes to be advertised to BGP peers when the peers go Up from Down.

The undo advertise lowest-priority all-address-family peer-up command restores the default configuration.

By default, the priorities of the BGP routes to be advertised remain unchanged.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

advertise lowest-priority all-address-family peer-up [ delay delay ]

undo advertise lowest-priority all-address-family peer-up [ delay delay ]

Parameters

Parameter Description Value
delay delay

Specifies a delay.

The value is an integer ranging from 1 to 864000, in seconds. The default value is 0.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the advertise lowest-priority all-address-family peer-up command is not run, BGP routes with unchanged priorities are advertised to peers when the peers go Up from Down. After the peers receive the routes, traffic may be switched back to the original paths. Consequently, lengthy packet loss may occur. To address this problem, run the advertise lowest-priority all-address-family peer-up command. After the command is run, routes advertised to the peers carry the lowest priorities (largest MED value and smallest Local_Pref value) until delay expires.

Precautions

If you run the advertise lowest-priority all-address-family peer-up delay command and then the advertise lowest-priority all-address-family peer-up command in sequence, the latest configuration overrides the previous one. That is, the delay time is cleared.

The advertise lowest-priority all-address-family peer-up and advertise lowest-priority on-startup commands are mutually exclusive.

Example

# Configure BGP to minimize the priorities of the routes to be advertised to BGP peers when the peers go Up from Down.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] advertise lowest-priority all-address-family peer-up

advertise lowest-priority on-startup

Function

The advertise lowest-priority on-startup command configures BGP to minimize the priorities of the BGP routes to be advertised.

The undo advertise lowest-priority on-startup command restores the default configuration.

By default, the priorities of the BGP routes to be advertised remain unchanged.

Format

advertise lowest-priority on-startup [ delay-time time-value ]

undo advertise lowest-priority on-startup [ delay-time time-value ]

Parameters

Parameter Description Value
delay-time time-value

Specifies a delay.

The value is an integer ranging from 1 to 864000, in seconds.

The default value is 0, indicating that the delay function is disabled.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a device restarts during ARP entry delivery, the route advertised by the device needs to have a low priority to prevent traffic loss.<br /> Before restarting the device, you can run the advertise lowest-priority on-startup command to set the lowest priority for the routes advertised to peers. That is, you can change the MED value to 4294967295 and the Local_Pref value to 0. As such, a BGP route advertised by the device has the lowest priority among routes of the the same type after the device restarts, preventing the BGP route from being preferentially selected. To restore the priorities of these BGP routes after ARP entries are delivered, run the reset bgp advertise lowest-priority on-startup command.

You can also run the advertise lowest-priority on-startup delay-time command before the device restarts to ensure that the priority of the routes advertised by the device is the lowest among the routes of the same type within the configured delay after the device restarts. ARP entries are delivered within the delay time. After the delay time expires, the priority of the routes advertised by the device is automatically restored. Within the delay, you can also run the reset bgp advertise lowest-priority on-startup command to restore the default priority of the routes to be advertised.

In addition, when advertising low-priority routes, you can run the undo undo advertise lowest-priority on-startup [delay-time ] command to restore the default priority of routes to be advertised, regardless of whether there is a delay.

Precautions

If the advertise lowest-priority on-startup command is run after BGP configurations are committed, the configuration of this command takes effect only after the reboot command is run. If the advertise lowest-priority on-startup command and BGP configurations are committed as a whole, the configuration of this command takes effect immediately.

This command and the advertise delay on-startup delay-time command overwrite each other.

This command and the advertise lowest-priority all-address-family peer-up delay command are mutually exclusive.

Example

# Configure BGP to change the priorities of the routes to be advertised to peers to the lowest priority.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] advertise lowest-priority on-startup

advertise lowest-priority on-startup(BGP-IPv6 unicast address family view)

Function

The advertise lowest-priority on-startup command configures BGP to minimize the priorities of the BGP routes to be advertised.

The undo advertise lowest-priority on-startup command restores the default configuration.

By default, the priorities of the BGP routes to be advertised remain unchanged.

Format

advertise lowest-priority on-startup [ delay-time time-value ]

undo advertise lowest-priority on-startup [ delay-time time-value ]

Parameters

Parameter Description Value
delay-time time-value

Specifies a delay.

The value is an integer ranging from 1 to 864000, in seconds.

The default value is 0, indicating that the delay function is disabled.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a device restarts during ARP entry delivery, the route advertised by the device needs to have a low priority to prevent traffic loss.<br /> Before restarting the device, you can run the advertise lowest-priority on-startup command to set the lowest priority for the routes advertised to peers. That is, you can change the MED value to 4294967295 and the Local_Pref value to 0. As such, a BGP route advertised by the device has the lowest priority among routes of the the same type after the device restarts, preventing the BGP route from being preferentially selected. To restore the priorities of these BGP routes after ARP entries are delivered, run the reset bgp advertise lowest-priority on-startup command.

You can also run the advertise lowest-priority on-startup delay-time command before the device restarts to ensure that the priority of the routes advertised by the device is the lowest among the routes of the same type within the configured delay after the device restarts. ARP entries are delivered within the delay time. After the delay time expires, the priority of the routes advertised by the device is automatically restored. Within the delay, you can also run the reset bgp advertise lowest-priority on-startup command to restore the default priority of the routes to be advertised.

In addition, when advertising low-priority routes, you can run the undo undo advertise lowest-priority on-startup [delay-time ] command to restore the default priority of routes to be advertised, regardless of whether there is a delay.

Precautions

If the advertise lowest-priority on-startup command is run after BGP configurations are committed, the configuration of this command takes effect only after the reboot command is run. If the advertise lowest-priority on-startup command and BGP configurations are committed as a whole, the configuration of this command takes effect immediately.

This command and the advertise delay on-startup delay-time command overwrite each other.

This command and the advertise lowest-priority all-address-family peer-up delay command are mutually exclusive.

Example

# Configure BGP to change the priorities of the routes to be advertised to peers to the lowest priority.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] advertise lowest-priority on-startup

aggregate (BGP multi-instance VPN instance IPv4 address family view) (policy)

Function

The aggregate command adds a summarized route to the BGP routing table. The outbound interface of the summarized route on the local Router is NULL 0. When receiving the summarized route, each of the other devices automatically adds its local outbound interface to the summarized route.

The undo aggregate command disables the function.

By default, no routes are summarized.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

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

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

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a summary route. The value is in dotted decimal notation.

The value is in the dotted decimal format.

mask-length

Specifies the network mask length of the summary route.

The value is an integer ranging from 1 to 32.

mask

Specifies the network mask of a summary route. The value is in dotted decimal notation.

It is in dotted decimal notation.

as-set

Generates a route carrying the AS-Set attribute.

-

detail-suppressed

Advertises only the summary route.

-

attribute-policy route-policy-name1

Specifies the name of a route-policy for setting attributes of a summary route.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

origin-policy route-policy-name2

Specifies the name of a route-policy that allows route summarization.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

suppress-policy route-policy-name3

Specifies the name of a route-policy for suppressing the advertisement of specified routes.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP route summarization is classified as manual route summarization or automatic route summarization. The aggregate command is used to implement manual route summarization, which takes precedence over automatic route summarization. The aggregate ipv4-address { mask | mask-length } command configures BGP to summarize specific routes in the local BGP routing table and then advertise all specific routes as well as the summary route. The generated summary route inherits the Origin attribute from the specific routes if they have the same Origin attribute. If the specific routes have different Origin attributes, the summary route selects one as its own from these Origin attributes in descending order of preference: incomplete > egp > igp. In addition, the summary route carries the atomic-aggregate attribute. Except the Origin and atomic-aggregate attributes, the summary route does not carry any other attributes of the specific routes.

To generate a summary route that can be used to detect a routing loop, you can specify the as-set parameter when running the aggregate command. The summary route inherits the attributes such as Origin, AS_Path (used for loop prevention), community, and large-community from the specific routes. The summary route also carries the community attributes of all its original specific routes. If the number of community attributes carried in the specific routes being summarized exceeds 255, route summarization stops, and the routes that fail to participate in summarization are still advertised as specific routes. Exercise caution to use this parameter if a large number of AS_Path lists are involved in route summarization. This is because frequent changes in the specific routes may cause route flapping.

If detail-suppressed is specified in the command, the summarized route is advertised, but specific routes are not. The summarized route carries the atomic-aggregate attribute, not the community attributes of specific routes.

If suppress-policy is specified in the command, specified routes are not advertised. The if-match clause of route-policy can be used to filter the routes, and only the routes matching the policy will be suppressed. The peer route-policy command can also be used to filter routes and prevent unwanted routes from being advertised to peers.

If origin-policy is specified in the command, only the routes matching route-policy are summarized.

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

Configuration Impact

If detail-suppressed is configured in the command, the advertisement of specific routes will be suppressed. If suppress-policy is configured in the command, the advertisement of the specific routes that match the policy will be suppressed.

Precautions

If the undo aggregate command is run, the system will match routes against the configured attribute-policy, origin-policy, suppress-policy, as-set, or detail-suppressed. If no parameter is configured, the system will fail to execute the undo aggregate command.

After a summary route is configured using the aggregate command and the summary route is leaked from the local VPN instance to another VPN instance, the summary route may be selected to guide traffic forwarding due to its high priority. As a result, traffic is dropped. To prevent this issue, plan a proper mask length for the summary route.

Example

# Create a summarized route carrying the AS_Path attribute that contains the AS_Path information of specific routes.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] aggregate 10.32.0.0 255.255.0.0 as-set

aggregate (BGP view)

Function

The aggregate command adds a summarized route to the BGP routing table. The outbound interface of the summarized route on the local Router is NULL 0. When receiving the summarized route, each of the other devices automatically adds its local outbound interface to the summarized route.

The undo aggregate command disables the function.

By default, no routes are summarized.

Format

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

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

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a summary route. The value is in dotted decimal notation.

The value is in dotted decimal notation.

mask-length

Specifies the network mask length of the summary route.

The value is an integer ranging from 1 to 32.

mask

Specifies the network mask of a summary route. The value is in dotted decimal notation.

The value is in dotted decimal notation.

as-set

Generates a route carrying the AS-Set attribute.

-

detail-suppressed

Advertises only the summary route.

-

attribute-policy route-policy-name1

Specifies the name of a route-policy for setting attributes of a summary route.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

origin-policy route-policy-name2

Specifies the name of the route-policy that allows route summarization.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

suppress-policy route-policy-name3

Specifies the name of the route-policy for suppressing the advertisement of specified routes.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP route summarization is classified as manual route summarization or automatic route summarization. The aggregate command is used to implement manual route summarization, which takes precedence over automatic route summarization. The aggregate ipv4-address { mask | mask-length } command configures BGP to summarize specific routes in the local BGP routing table and then advertise all specific routes as well as the summary route. The generated summary route inherits the Origin attribute from the specific routes if they have the same Origin attribute. If the specific routes have different Origin attributes, the summary route selects one as its own from these Origin attributes in descending order of preference: incomplete > egp > igp. In addition, the summary route carries the atomic-aggregate attribute. Except the Origin and atomic-aggregate attributes, the summary route does not carry any other attributes of the specific routes.

To generate a summary route that can be used to detect a routing loop, you can specify the as-set parameter when running the aggregate command. The summary route inherits the attributes such as Origin, AS_Path (used for loop prevention), community, and large-community from the specific routes. The summary route also carries the community attributes of all its original specific routes. If the number of community attributes carried in the specific routes being summarized exceeds 255, route summarization stops, and the routes that fail to participate in summarization are still advertised as specific routes. Exercise caution to use this parameter if a large number of AS_Path lists are involved in route summarization. This is because frequent changes in the specific routes may cause route flapping.

If detail-suppressed is specified in the command, the summarized route is advertised, but specific routes are not. The summarized route carries the atomic-aggregate attribute, not the community attributes of specific routes.

If suppress-policy is specified in the command, specified routes are not advertised. The if-match clause of route-policy can be used to filter the routes, and only the routes matching the policy will be suppressed. The peer route-policy command can also be used to filter routes and prevent unwanted routes from being advertised to peers.

If origin-policy is specified in the command, only the routes matching route-policy are summarized.

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

Configuration Impact

If detail-suppressed is configured in the command, the advertisement of specific routes will be suppressed. If suppress-policy is configured in the command, the advertisement of the specific routes that match the policy will be suppressed.

Precautions

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

After the aggregate command is run, the summary route that is leaked to a VPN instance may be preferentially selected to guide traffic forwarding because it has a higher priority. As a result, traffic is discarded. To prevent this problem, plan a proper mask length for the summary route.

When an origin-policy is applied to summary routes and the if-match route-type command is run to filter routes based on the route type, only the routes imported in import or network mode support route type-based filtering. Other types of routes (such as the routes learned from peers) do not support route type-based filtering.

Example

# Create a summarized route carrying the AS_Path attribute that contains the AS_Path information of specific routes.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] aggregate 10.32.0.0 255.255.0.0 as-set

aggregate (BGP-IPv4 unicast address family view)

Function

The aggregate command adds a summarized route to the BGP routing table. The outbound interface of the summarized route on the local Router is NULL 0. When receiving the summarized route, each of the other devices automatically adds its local outbound interface to the summarized route.

The undo aggregate command disables the function.

By default, no routes are summarized.

Format

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

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

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a summary route. The value is in dotted decimal notation.

The value is in the dotted decimal format.

mask-length

Specifies the network mask length of the summary route.

The value is an integer ranging from 1 to 32.

mask

Specifies the network mask of a summary route.

It is in dotted decimal notation.

as-set

Generates a route carrying the AS-Set attribute.

-

detail-suppressed

Advertises only the summary route.

-

attribute-policy route-policy-name1

Specifies the name of a route-policy for setting attributes of a summary route.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

origin-policy route-policy-name2

Specifies the name of the route-policy that allows route summarization.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

suppress-policy route-policy-name3

Specifies the name of a route-policy for suppressing the advertisement of specified routes.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP route summarization is classified as manual route summarization or automatic route summarization. The aggregate command is used to implement manual route summarization, which takes precedence over automatic route summarization. The aggregate ipv4-address { mask | mask-length } command configures BGP to summarize specific routes in the local BGP routing table and then advertise all specific routes as well as the summary route. The generated summary route inherits the Origin attribute from the specific routes if they have the same Origin attribute. If the specific routes have different Origin attributes, the summary route selects one as its own from these Origin attributes in descending order of preference: incomplete > egp > igp. In addition, the summary route carries the atomic-aggregate attribute. Except the Origin and atomic-aggregate attributes, the summary route does not carry any other attributes of the specific routes.

To generate a summary route that can be used to detect a routing loop, you can specify the as-set parameter when running the aggregate command. The summary route inherits the attributes such as Origin, AS_Path (used for loop prevention), community, and large-community from the specific routes. The summary route also carries the community attributes of all its original specific routes. If the number of community attributes carried in the specific routes being summarized exceeds 255, route summarization stops, and the routes that fail to participate in summarization are still advertised as specific routes. Exercise caution to use this parameter if a large number of AS_Path lists are involved in route summarization. This is because frequent changes in the specific routes may cause route flapping.

If detail-suppressed is specified in the command, the summarized route is advertised, but specific routes are not. The summarized route carries the atomic-aggregate attribute, not the community attributes of specific routes.

If suppress-policy is specified in the command, specified routes are not advertised. The if-match clause of route-policy can be used to filter the routes, and only the routes matching the policy will be suppressed. The peer route-policy command can also be used to filter routes and prevent unwanted routes from being advertised to peers.

If origin-policy is specified in the command, only the routes matching route-policy are summarized.

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

Configuration Impact

If detail-suppressed is configured in the command, the advertisement of specific routes will be suppressed. If suppress-policy is configured in the command, the advertisement of the specific routes that match the policy will be suppressed.

Precautions

If the undo aggregate command is run, the system will match routes against the configured attribute-policy, origin-policy, suppress-policy, as-set, or detail-suppressed. If no parameter is configured, the system will fail to execute the undo aggregate command.

After a summary route is configured using the aggregate command and the summary route is leaked from the local VPN instance to another VPN instance, the summary route may be selected to guide traffic forwarding due to its high priority. As a result, traffic is dropped. To prevent this issue, plan a proper mask length for the summary route.

Example

# Create a summarized route carrying the AS_Path attribute that contains the AS_Path information of specific routes.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] aggregate 10.32.0.0 255.255.0.0 as-set

aggregate (BGP-IPv6 unicast address family view)

Function

The aggregate command adds a summarized route to the BGP routing table. The outbound interface of the summarized route on the local Router is NULL 0. When receiving the summarized route, each of the other devices automatically adds its local outbound interface to the summarized route.

The undo aggregate command disables the function.

By default, no routes are summarized.

Format

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

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

Parameters

Parameter Description Value
ipv6-address

Specifies an IPv6 address of the summarized route.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

mask-length

Specifies the network mask length of the summary route.

The value is an integer ranging from 1 to 128.

as-set

Generates a route carrying the AS-Set attribute.

-

detail-suppressed

Advertises only the summary route.

-

attribute-policy route-policy-name1

Specifies the name of a route-policy for setting attributes of a summary route.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

origin-policy route-policy-name2

Specifies the name of the route-policy that allows route summarization.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

suppress-policy route-policy-name3

Specifies the name of the route-policy for suppressing the advertisement of specified routes.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP route summarization is classified as manual route summarization or automatic route summarization. The aggregate command is used to implement manual route summarization, which takes precedence over automatic route summarization. The aggregate ipv4-address { mask | mask-length } command configures BGP to summarize specific routes in the local BGP routing table and then advertise all specific routes as well as the summary route. The generated summary route inherits the Origin attribute from the specific routes if they have the same Origin attribute. If the specific routes have different Origin attributes, the summary route selects one as its own from these Origin attributes in descending order of preference: incomplete > egp > igp. In addition, the summary route carries the atomic-aggregate attribute. Except the Origin and atomic-aggregate attributes, the summary route does not carry any other attributes of the specific routes.

To generate a summary route that can be used to detect a routing loop, you can specify the as-set parameter when running the aggregate command. The summary route inherits the attributes such as Origin, AS_Path (used for loop prevention), community, and large-community from the specific routes. The summary route also carries the community attributes of all its original specific routes. If the number of community attributes carried in the specific routes being summarized exceeds 255, route summarization stops, and the routes that fail to participate in summarization are still advertised as specific routes. Exercise caution to use this parameter if a large number of AS_Path lists are involved in route summarization. This is because frequent changes in the specific routes may cause route flapping.

If detail-suppressed is specified in the command, the summarized route is advertised, but specific routes are not. The summarized route carries the atomic-aggregate attribute, not the community attributes of specific routes.

If suppress-policy is specified in the command, specified routes are not advertised. The if-match clause of route-policy can be used to filter the routes, and only the routes matching the policy will be suppressed. The peer route-policy command can also be used to filter routes and prevent unwanted routes from being advertised to peers.

If origin-policy is specified in the command, only the routes matching route-policy are summarized.

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

Configuration Impact

If detail-suppressed is configured in the command, the advertisement of specific routes will be suppressed. If suppress-policy is configured in the command, the advertisement of the specific routes that match the policy will be suppressed.

Precautions

If the undo aggregate command is run, the system will match routes against the configured attribute-policy, origin-policy, suppress-policy, as-set, or detail-suppressed. If no parameter is configured, the system will fail to execute the undo aggregate command.

After a summary route is configured using the aggregate command and the summary route is leaked from the local VPN instance to another VPN instance, the summary route may be selected to guide traffic forwarding due to its high priority. As a result, traffic is dropped. To prevent this issue, plan a proper mask length for the summary route.

Example

# Create a summarized route carrying the AS_Path attribute that contains the AS_Path information of specific routes.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] aggregate 2001:db8:1::1 64 as-set

aggregate (BGP-VPN instance IPv4 address family view)

Function

The aggregate command adds a summarized route to the BGP routing table. The outbound interface of the summarized route on the local Router is NULL 0. When receiving the summarized route, each of the other devices automatically adds its local outbound interface to the summarized route.

The undo aggregate command disables the function.

By default, no routes are summarized.

Format

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

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

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a summary route. The value is in dotted decimal notation.

It is in dotted decimal notation.

mask-length

Specifies the network mask length of the summary route.

The value is an integer ranging from 1 to 32.

mask

Specifies the network mask of a summary route. The value is in dotted decimal notation.

It is in dotted decimal notation.

as-set

Generates a route carrying the AS-Set attribute.

-

detail-suppressed

Advertises only the summary route.

-

attribute-policy route-policy-name1

Specifies the name of a route-policy for setting attributes of a summary route.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

origin-policy route-policy-name2

Specifies the name of the route-policy that allows route summarization.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

suppress-policy route-policy-name3

Specifies the name of the route-policy for suppressing the advertisement of specified routes.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP route summarization is classified as manual route summarization or automatic route summarization. The aggregate command is used to implement manual route summarization, which takes precedence over automatic route summarization. The aggregate ipv4-address { mask | mask-length } command configures BGP to summarize specific routes in the local BGP routing table and then advertise all specific routes as well as the summary route. The generated summary route inherits the Origin attribute from the specific routes if they have the same Origin attribute. If the specific routes have different Origin attributes, the summary route selects one as its own from these Origin attributes in descending order of preference: incomplete > egp > igp. In addition, the summary route carries the atomic-aggregate attribute. Except the Origin and atomic-aggregate attributes, the summary route does not carry any other attributes of the specific routes.

To generate a summary route that can be used to detect a routing loop, you can specify the as-set parameter when running the aggregate command. The summary route inherits the attributes such as Origin, AS_Path (used for loop prevention), community, and large-community from the specific routes. The summary route also carries the community attributes of all its original specific routes. If the number of community attributes carried in the specific routes being summarized exceeds 255, route summarization stops, and the routes that fail to participate in summarization are still advertised as specific routes. Exercise caution to use this parameter if a large number of AS_Path lists are involved in route summarization. This is because frequent changes in the specific routes may cause route flapping.

If detail-suppressed is specified in the command, the summarized route is advertised, but specific routes are not. The summarized route carries the atomic-aggregate attribute, not the community attributes of specific routes.

If suppress-policy is specified in the command, specified routes are not advertised. The if-match clause of route-policy can be used to filter the routes, and only the routes matching the policy will be suppressed. The peer route-policy command can also be used to filter routes and prevent unwanted routes from being advertised to peers.

If origin-policy is specified in the command, only the routes matching route-policy are summarized.

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

Configuration Impact

If detail-suppressed is configured in the command, the advertisement of specific routes will be suppressed. If suppress-policy is configured in the command, the advertisement of the specific routes that match the policy will be suppressed.

Precautions

If the undo aggregate command is run, the system will match routes against the configured attribute-policy, origin-policy, suppress-policy, as-set, or detail-suppressed. If no parameter is configured, the system will fail to execute the undo aggregate command.

After a summary route is configured using the aggregate command and the summary route is leaked from the local VPN instance to another VPN instance, the summary route may be selected to guide traffic forwarding due to its high priority. As a result, traffic is dropped. To prevent this issue, plan a proper mask length for the summary route.

Example

# Create a summarized route carrying the AS_Path attribute that contains the AS_Path information of specific routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] aggregate 10.32.0.0 255.255.0.0 as-set

aggregate (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The aggregate command adds a summarized route to the BGP routing table. The outbound interface of the summarized route on the local Router is NULL 0. When receiving the summarized route, each of the other devices automatically adds its local outbound interface to the summarized route.

The undo aggregate command disables the function.

By default, no routes are summarized.

Format

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

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

Parameters

Parameter Description Value
ipv6-address

Specifies an IPv6 address of the summarized route.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

mask-length

Specifies the network mask length of the summarized route.

The value is an integer ranging from 1 to 128.

as-set

Generates a route carrying AS-SET.

-

detail-suppressed

Advertises only the summarized route.

-

attribute-policy route-policy-name1

Specifies the name of an attribute route-policy for the summarized route.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

origin-policy route-policy-name2

Specifies the name of a route-policy that allows route summarization.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

suppress-policy route-policy-name3

Specifies the name of a route-policy for suppressing the advertisement of specified routes.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP route summarization is classified as manual route summarization or automatic route summarization. The aggregate command is used to implement manual route summarization, which takes precedence over automatic route summarization. The aggregate ipv4-address { mask | mask-length } command configures BGP to summarize specific routes in the local BGP routing table and then advertise all specific routes as well as the summary route. The generated summary route inherits the Origin attribute from the specific routes if they have the same Origin attribute. If the specific routes have different Origin attributes, the summary route selects one as its own from these Origin attributes in descending order of preference: incomplete > egp > igp. In addition, the summary route carries the atomic-aggregate attribute. Except the Origin and atomic-aggregate attributes, the summary route does not carry any other attributes of the specific routes.

To generate a summary route that can be used to detect a routing loop, you can specify the as-set parameter when running the aggregate command. The summary route inherits the attributes such as Origin, AS_Path (used for loop prevention), community, and large-community from the specific routes. The summary route also carries the community attributes of all its original specific routes. If the number of community attributes carried in the specific routes being summarized exceeds 255, route summarization stops, and the routes that fail to participate in summarization are still advertised as specific routes. Exercise caution to use this parameter if a large number of AS_Path lists are involved in route summarization. This is because frequent changes in the specific routes may cause route flapping.

If detail-suppressed is specified in the command, the summarized route is advertised, but specific routes are not. The summarized route carries the atomic-aggregate attribute, not the community attributes of specific routes.

If suppress-policy is specified in the command, specified routes are not advertised. The if-match clause of route-policy can be used to filter the routes, and only the routes matching the policy will be suppressed. The peer route-policy command can also be used to filter routes and prevent unwanted routes from being advertised to peers.

If origin-policy is specified in the command, only the routes matching route-policy are summarized.

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

Configuration Impact

If detail-suppressed is configured in the command, the advertisement of specific routes will be suppressed. If suppress-policy is configured in the command, the advertisement of the specific routes that match the policy will be suppressed.

Precautions

If the undo aggregate command is run, the system will match routes against the configured attribute-policy, origin-policy, suppress-policy, as-set, or detail-suppressed. If no parameter is configured, the system will fail to execute the undo aggregate command.

After a summary route is configured using the aggregate command and the summary route is leaked from the local VPN instance to another VPN instance, the summary route may be selected to guide traffic forwarding due to its high priority. As a result, traffic is dropped. To prevent this issue, plan a proper mask length for the summary route.

Example

# Create a summarized route carrying the AS_Path attribute that contains the AS_Path information of specific routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] aggregate 2001:db8:1::1 64 as-set

aggregate default-route

Function

The aggregate default-route command enables a BGP device to summarize the routes that match a specified IPv4 prefix list into a summary default route.

The undo aggregate default-route command restores the default configuration.

By default, BGP cannot summarize the routes that match a specified IPv4 prefix list into a summary default route.

Format

aggregate default-route origin-ip-prefix ip-prefix-name [ attribute-policy attribute-policy-name ]

undo aggregate default-route

undo aggregate default-route origin-ip-prefix ip-prefix-name [ attribute-policy attribute-policy-name ]

Parameters

Parameter Description Value
attribute-policy attribute-policy-name

Specifies the name of an attribute route-policy for the summary default route.

The value is a string ranging from 1 to 200.

origin-ip-prefix ip-prefix-name

Specifies the name of an IPv4 prefix list.

The value is a string of 1 to 169 characters and cannot contain spaces.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To prevent traffic that does not match the IPv4 prefix filter from being imported to the local device, run this command to configure the local device to advertise default routes to the peer device based on the IPv4 prefix filter. This saves bandwidth resources. For details, see Configuration > IP Routing > BGP Configuration > Configuring BGP to Summarize Default Routes.

Prerequisites

An IPv4 prefix list has been configured using the ip ip-prefix command.

Precautions

The number of entries in the IPv4 prefix list specified in the aggregate default-route command cannot exceed 200.

Example

# Enable a BGP device to summarize the routes that match an IPv4 prefix list into a summary default route.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix p1 index 10 permit 192.168.1.1 29
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] aggregate default-route origin-ip-prefix p1
# Enable a BGP device to summarize the routes that match an IPv4 prefix list into a summary default route and specify an attribute route-policy for the summary default route.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix prefix-a index 10 permit 192.168.1.0 24
[HUAWEI] route-policy policy1 permit node 10
[HUAWEI-route-policy] if-match ip-prefix prefix-a
[HUAWEI-route-policy] apply cost 100
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] aggregate default-route origin-ip-prefix prefix-a attribute-policy policy1

aggregate default-route (BGP multi-instance VPN instance IPv4 address family view)

Function

The aggregate default-route command enables a BGP device to summarize the routes that match a specified IPv4 prefix list into a summary default route.

The undo aggregate default-route command restores the default configuration.

By default, BGP cannot summarize the routes that match a specified IPv4 prefix list into a summary default route.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

aggregate default-route origin-ip-prefix ip-prefix-name [ attribute-policy attribute-policy-name ]

undo aggregate default-route

undo aggregate default-route origin-ip-prefix ip-prefix-name [ attribute-policy attribute-policy-name ]

Parameters

Parameter Description Value
attribute-policy attribute-policy-name

Specifies the name of an attribute route-policy for the summary default route.

The value is a string ranging from 1 to 200.

origin-ip-prefix ip-prefix-name

Specifies the name of an IPv4 prefix list.

The value is a string of 1 to 169 characters and cannot contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To prevent traffic that does not match the IPv4 prefix filter from being imported to the local device, run this command to configure the local device to advertise default routes to the peer device based on the IPv4 prefix filter. This saves bandwidth resources. For details, see Configuration - IP Routing - BGP Configuration - Configuring BGP to Summarize Default Routes.

Prerequisites

An IPv4 prefix list has been configured using the ip ip-prefix command.

Precautions

The number of entries in the IPv4 prefix list specified in the aggregate default-route command cannot exceed 200.

Example

# Enable a BGP device to summarize the routes that match an IPv4 prefix list into a summary default route and specify an attribute route-policy for the summary default route.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix prefix-a index 10 permit 192.168.1.1 24
[HUAWEI] route-policy policy1 permit node 10
[HUAWEI-route-policy] if-match ip-prefix prefix-a
[HUAWEI-route-policy] apply cost 100
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] router-id 1.1.1.9
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-instance-a-vpn1] aggregate default-route origin-ip-prefix prefix-a attribute-policy policy1
# Enable a BGP device to summarize the routes that match an IPv4 prefix list into a summary default route.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix p1 index 10 permit 192.168.1.1 29
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] router-id 1.1.1.9
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-instance-a-vpn1] aggregate default-route origin-ip-prefix p1

aggregate default-route (BGP-IPv6 unicast address family view)

Function

The aggregate default-route command enables a BGP device to summarize the routes that match a specified IPv6 prefix list into a summary default route.

The undo aggregate default-route command restores the default configuration.

By default, BGP cannot summarize the routes that match a specified IPv6 prefix list into a summary default route.

Format

aggregate default-route origin-ipv6-prefix ipv6-prefix-name [ attribute-policy attribute-policy-name ]

undo aggregate default-route

undo aggregate default-route origin-ipv6-prefix ipv6-prefix-name [ attribute-policy attribute-policy-name ]

Parameters

Parameter Description Value
attribute-policy attribute-policy-name

Specifies the name of an attribute route-policy for the summary default route.

The value is a string ranging from 1 to 200.

origin-ipv6-prefix ipv6-prefix-name

Specifies the name of an IPv6 prefix list.

The value is a string of 1 to 169 characters and cannot contain spaces.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To prevent traffic that does not match the IPv4 prefix filter from being imported to the local device, run the ipv4 prefix-filter default-route command to configure the local device to advertise default routes to the peer device based on the IPv4 prefix filter. This saves bandwidth resources. For details, see Configuration > IP Routing > BGP4+ Configuration > Configuring BGP4+ to Summarize Default Routes.

Prerequisites

An IPv6 prefix list has been configured using the ip ipv6-prefix command.

Precautions

The number of entries in the IPv6 prefix list specified in the aggregate default-route command cannot exceed 200.

Example

# Enable a BGP device to summarize the routes that match an IPv6 prefix list into a summary default route.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix prefix-a deny 2001:db8:: 32 less-equal 128
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] aggregate default-route origin-ipv6-prefix prefix-a
# Enable a BGP device to summarize the routes that match an IPv4 prefix list into a summary default route and specify an attribute route-policy for the summary default route.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix prefix-a deny 2001:db8:: 32 less-equal 128
[HUAWEI] route-policy policy1 permit node 10
[HUAWEI-route-policy] if-match ipv6 address prefix-list prefix-a
[HUAWEI-route-policy] apply cost 100
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] aggregate default-route origin-ipv6-prefix prefix-a attribute-policy policy1

aggregate default-route (BGP-VPN instance IPv4 address family view)

Function

The aggregate default-route command enables a BGP device to summarize the routes that match a specified IPv4 prefix list into a summary default route.

The undo aggregate default-route command restores the default configuration.

By default, BGP cannot summarize the routes that match a specified IPv4 prefix list into a summary default route.

Format

aggregate default-route origin-ip-prefix ip-prefix-name [ attribute-policy attribute-policy-name ]

undo aggregate default-route

undo aggregate default-route origin-ip-prefix ip-prefix-name [ attribute-policy attribute-policy-name ]

Parameters

Parameter Description Value
attribute-policy attribute-policy-name

Specifies the name of an attribute route-policy for the summary default route.

The value is a string of 1 to 200 characters.

origin-ip-prefix ip-prefix-name

Specifies the name of an IPv4 prefix list.

The value is a string of 1 to 169 characters and cannot contain spaces.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To prevent traffic that does not match the IPv4 prefix filter from being imported to the local device, run this command to configure the local device to advertise default routes to the peer device based on the IPv4 prefix filter. This saves bandwidth resources. For details, see Configuration > IP Routing > BGP Configuration > Configuring BGP to Summarize Default Routes.

Prerequisites

An IPv4 prefix list has been configured using the ip ip-prefix command.

Precautions

The number of entries in the IPv4 prefix list specified in the aggregate default-route command cannot exceed 200.

Example

# Enable a BGP device to summarize the routes that match an IPv4 prefix list into a summary default route and specify an attribute route-policy for the summary default route.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix prefix-a index 10 permit 192.168.1.1 24
[HUAWEI] route-policy policy1 permit node 10
[HUAWEI-route-policy] if-match ip-prefix prefix-a
[HUAWEI-route-policy] apply cost 100
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] aggregate default-route origin-ip-prefix prefix-a attribute-policy policy1
# Enable a BGP device to summarize the routes that match an IPv4 prefix list into a summary default route.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix p1 index 10 permit 192.168.1.1 29
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] aggregate default-route origin-ip-prefix p1

aggregate default-route (BGP-VPN instance IPv6 address family view)

Function

The aggregate default-route command enables a BGP device to summarize the routes that match a specified IPv6 prefix list into a summary default route.

The undo aggregate default-route command restores the default configuration.

By default, BGP cannot summarize the routes that match a specified IPv6 prefix list into a summary default route.

Format

aggregate default-route origin-ipv6-prefix ipv6-prefix-name [ attribute-policy attribute-policy-name ]

undo aggregate default-route

undo aggregate default-route origin-ipv6-prefix ipv6-prefix-name [ attribute-policy attribute-policy-name ]

Parameters

Parameter Description Value
attribute-policy attribute-policy-name

Specifies the name of an attribute route-policy for the summary default route.

The value is a string ranging from 1 to 200.

origin-ipv6-prefix ipv6-prefix-name

Specifies the name of an IPv6 prefix list.

The value is a string of 1 to 169 characters and cannot contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To prevent traffic that does not match the IPv4 prefix filter from being imported to the local device, run the ipv4 prefix-filter default-route command to configure the local device to advertise default routes to the peer device based on the IPv4 prefix filter. This saves bandwidth resources. For details, see Configuration > IP Routing > BGP4+ Configuration > Configuring BGP4+ to Summarize Default Routes.

Prerequisites

An IPv6 prefix list has been configured using the ip ipv6-prefix command.

Precautions

The number of entries in the IPv6 prefix list specified in the aggregate default-route command cannot exceed 200.

Example

# Enable a BGP device to summarize the routes that match an IPv4 prefix list into a summary default route and specify an attribute route-policy for the summary default route.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix prefix-a deny 2001:db8:: 32 less-equal 128
[HUAWEI] route-policy policy1 permit node 10
[HUAWEI-route-policy] if-match ipv6 address prefix-list prefix-a
[HUAWEI-route-policy] apply cost 100
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vrf1
[HUAWEI-bgp-vrf1] aggregate default-route origin-ipv6-prefix prefix-a attribute-policy policy1
# Enable a BGP device to summarize the routes that match an IPv6 prefix list into a summary default route.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix prefix-a deny 2001:db8:: 32 less-equal 128
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vrf1
[HUAWEI-bgp-vrf1] aggregate default-route origin-ipv6-prefix prefix-a

as-notation plain

Function

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

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

By default, BGP 4-byte AS numbers are displayed in dotted notation (in the format of x.y).

Format

as-notation plain

undo as-notation plain

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP 4-byte AS numbers are displayed in dotted notation. For example, 4-byte AS numbers in the output of a display command, such as the display bgp peer command, are displayed in dotted notation.

To display a 4-byte AS number as an integer, run the as-notation plain command. After the as-notation plain command is run, display commands display all 4-byte AS numbers as integers. These 4-byte AS numbers include:

  • 4-byte AS number that appears independently.
  • 4-byte AS number in an extended community attribute.
  • 4-byte AS number in a route distinguisher (RD).
  • 4-byte AS number in a VPN target (RT).
  • 4-byte AS number in the Site of Origin (SoO).

    A 4-byte AS number in integer format can be converted to a 4-byte AS number in dotted notation using the following formula: 4-byte AS number in integer format = x*65536 + y. For example, a dotted 4-byte AS number 2.3 corresponds to the following 4-byte AS number in integer format: 2*65536+3=131075.

Precautions

After the as-notation plain command is run:

  • If 4-byte AS numbers are configured to be displayed as an integer, 4-byte AS numbers in the configuration information generated by the system are also displayed as integers.
  • If 4-byte AS numbers are configured to be displayed in dotted notation, 4-byte AS numbers in the configuration information generated by the system are also displayed in dotted notation.

    If the system is using an AS_Path regular expression or an extended community attribute filter as an import or export policy, changing the format of 4-byte AS numbers does not allow the received routes to pass the policy, but affects the policy matching result of newly received routes. Therefore, you need to reconfigure an AS_Path regular expression using the ip as-path-filter command or an extended community attribute filter using the ip extcommunity-filter or ip extcommunity-list soo command after changing the format of 4-byte AS numbers. Otherwise, the policy cannot be matched as expected, causing network faults.
  • If 4-byte AS numbers are configured to be displayed as an integer, change 4-byte AS numbers in AS_Path regular expressions and extended community attribute filters to integral 4-byte AS numbers.
  • If 4-byte AS numbers are configured to be displayed in dotted notation, change 4-byte AS numbers in AS_Path regular expressions and extended community attribute filters to 4-byte AS numbers in dotted notation.

Example

# Configure BGP 4-byte AS numbers to be displayed as an integer.
<HUAWEI> system-view
[HUAWEI] as-notation plain

as-number (BGP multi-instance VPN instance IPv4 address family view)

Function

The as-number command configures an AS number for a VPN instance.

The undo as-number command restores the default setting.

By default, a VPN instance uses the AS number of BGP.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

as-number vrf-as [ no-prepend ]

undo as-number

undo as-number vrf-as no-prepend

Parameters

Parameter Description Value
vrf-as

Specifies a destination AS number.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x is an integer that ranges from 1 to 65535, and y is an integer ranging from 0 to 65535.

no-prepend

Indicates whether to prepend the AS number.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

During network transfer or service identification, if a device needs to be simulated as multiple BGP devices logically, you can run the as-number command to configure an AS number for each VPN instance.

After the as-number command is used:

  • BGP peer relationships in the VPN instance are established using the configured AS number.
  • The configured AS number is used to generate the aggregator attribute during route summarization.
  • When advertising routes to an EBGP peer, the local device adds the AS number configured in the VPN instance in the routes.

    If an AS number is configured for a VPN instance, the AS_Path attribute of the routes sent to VPNv4 carries the AS number configured for the VPN instance. If an AS number is configured for a VPN instance and no-prepend is specified after as-number, the AS_Path attribute of the route sent to VPNv4 does not carry the VPN instance's AS number.

Prerequisites

If a BGP peer or a BGP peer group has been configured in the VPN instance, delete the configuration of the BGP peer or peer group before configuring or deleting an AS number.

Precautions

If a VPN instance has been configured with an AS number, no confederation can be configured for the VPN instance. When configuring a confederation, you cannot configure an independent AS number for a VPN instance.

The AS number configured in the VPN instance view cannot be the same as the AS number configured in the BGP view.

In the YANG management mode of BGP, the configuration is not allowed. To configure an AS number for the VPN instance IPv4 address family, run the as-number ipv4 ipv4-as command in the BGP-VPN instance view.

Example

# Set the independent AS number of the VPN instance named vpna to 65001.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] as-number 65001

as-number (BGP-VPN instance IPv6 address family view)

Function

The as-number command configures an AS number for a VPN instance.

The undo as-number command restores the default setting.

By default, a VPN instance uses the AS number of BGP.

Format

as-number vrf-as [ no-prepend ]

undo as-number

undo as-number vrf-as no-prepend

Parameters

Parameter Description Value
vrf-as

Specifies a destination AS number.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x is an integer that ranges from 1 to 65535, and y is an integer ranging from 0 to 65535.

no-prepend

Indicates whether the AS number is prepended.

-

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

During network migration or service identification, if a physical device needs to be logically simulated as multiple BGP devices, you can run the as-number command to configure a unique AS number for each VPN instance.

After the as-number command is run:

  • Peers in a VPN instance use the configured AS number to establish a connection.
  • During route summarization, the configured AS number is used to generate the aggregator attribute.
  • Routes advertised to EBGP peers carry the AS number configured in the VPN instance.

If as-number is configured for a VPN instance, the AS_Path attribute of the route to be sent to the VPNv6 routing table carries as-number configured for the VPN instance.

If as-number is configured for a VPN instance and no-prepend is specified after as-number, the AS_Path attribute of the route to be sent to the VPNv6 routing table does not carry as-number configured for the VPN instance.

If no-prepend is not specified, the AS_Path attributes of VPN routes to be sent to VPNv6 carry the configured AS numbers. If no-prepend is specified, the AS_Path attributes of VPN routes to be sent to VPNv6 do not carry the configured AS numbers.

Prerequisites

If a BGP peer or a BGP peer group has been configured in the VPN instance, delete the configuration of the BGP peer or peer group before configuring or deleting an AS number.

Precautions

If a VPN instance has been configured with a separate AS number, no confederation can be configured for the VPN instance. When a confederation is configured, no separate AS number can be configured in the VPN instance.

The AS number configured in the VPN instance cannot be the same as the AS number configured in the BGP view.

When a 4-byte AS number is configured for BGP, OSPF does not support automatic tag-based loop prevention.

Example

# Set the independent AS number of the VPN instance named vpna to 65001.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] as-number 65001

as-number ipv4

Function

The as-number ipv4 command configures an independent AS number for an IPv4 peer of a VPN instance.

The undo as-number ipv4 command restores the default configuration.

The as-number ipv6 command configures an independent AS number for an IPv6 peer of a VPN instance.

The undo as-number ipv6 command restores the default configuration.

By default, a VPN instance uses the AS number of BGP.

Format

as-number ipv4 ipv4-as [ no-prepend ]

as-number ipv6 ipv6-as [ no-prepend ]

undo as-number ipv4 ipv4-as [ no-prepend ]

undo as-number ipv6 ipv6-as [ no-prepend ]

Parameters

Parameter Description Value
ipv4-as

Specifies the AS number of an IPv4 peer.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x is an integer that ranges from 1 to 65535, and y is an integer ranging from 0 to 65535.

no-prepend

Indicates whether the AS number is prepended.

-

ipv6-as

Specifies the AS number of an IPv6 peer.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x is an integer that ranges from 1 to 65535, and y is an integer ranging from 0 to 65535.

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To simulate a physical device as multiple logical BGP devices during network migration or service identification, run the as-number { ipv4 | ipv6 } command to configure a unique AS number for each VPN instance.

This command enables the system to generate an alarm in either of the following situations:

  • Peers in the VPN instance use the configured AS number to establish connections.
  • The configured AS number is used to generate the aggregator attribute during route summarization
  • When advertising routes to an EBGP peer, the local device adds the AS number configured in the VPN instance to the routes.

If an AS number is configured for a VPN instance, the AS_Path attribute of the route sent to VPNv4/VPNv6/EVPN carries the AS number configured for the VPN instance.

If as-number is configured for a VPN instance and no-prepend is specified after as-number, the AS_Path attribute of routes sent to VPNv4, VPNv6, or EVPN does not carry the VPN instance's as-number.

Prerequisites

If a BGP peer or a BGP peer group has been configured in the VPN instance, delete the configuration of the BGP peer or peer group before configuring or deleting an AS number.

Precautions

  1. If an independent VPN instance has been configured with an AS number, no confederation can be configured for the VPN instance. A VPN instance configured with BGP confederation cannot be configured with an AS number.
  2. The independent AS number configured in the VPN instance view cannot be the same as the AS number configured in the BGP view.
  3. The AS number of the BGP VPN instance address family cannot coexist with the AS number of the BGP VPN instance.
  4. If a peer or peer group exists, the AS number of the BGP VPN instance cannot be changed.
  5. After an AS number is configured for a BGP VPN instance, the peers in the BGP VPN instance view can be enabled only in the IPv4 or IPv6 address family of the VPN instance.

Example

# Set the independent AS number of the VPN instance named vpna to 65001.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 1:4
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 10:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-vpna] as-number ipv4 65001
[HUAWEI-bgp-instance-vpna] as-number ipv6 65001

as-number ipv4(BGP multi-instance VPN instance view)

Function

The as-number ipv4 command configures an independent AS number for an IPv4 peer of a VPN instance.

The undo as-number ipv4 command restores the default configuration.

The as-number ipv6 command configures an independent AS number for an IPv6 peer of a VPN instance.

The undo as-number ipv6 command restores the default configuration.

By default, a VPN instance uses the AS number of BGP.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

as-number ipv4 ipv4-as [ no-prepend ]

as-number ipv6 ipv6-as [ no-prepend ]

undo as-number ipv4 ipv4-as [ no-prepend ]

undo as-number ipv6 ipv6-as [ no-prepend ]

Parameters

Parameter Description Value
no-prepend

Indicates whether the AS number is prepended.

-

ipv6 ipv6-as

Specifies the AS number of an IPv6 peer.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x is an integer that ranges from 1 to 65535, and y is an integer ranging from 0 to 65535.

ipv4 ipv4-as

Specifies the AS number of an IPv4 peer.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x is an integer that ranges from 1 to 65535, and y is an integer ranging from 0 to 65535.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To simulate a physical device as multiple logical BGP devices during network migration or service identification, run the as-number { ipv4 | ipv6 } command to configure a unique AS number for each VPN instance.

This command enables the system to generate an alarm in either of the following situations:

  • Peers in the VPN instance use the configured AS number to establish connections.
  • The configured AS number is used to generate the aggregator attribute during route summarization.
  • When advertising routes to an EBGP peer, the local device carries the AS number configured in the VPN instance.

    If the as-number command is run without the no-prepend parameter specified, the AS_Path attribute of the VPN route sent to the VPNv4 or VPNv6 routing table carries the configured AS number.

    If no-prepend is specified, the AS_Path attribute of the VPN route sent to the VPNv4 or VPNv6 routing table does not carry the configured AS number.

Prerequisites

If a BGP peer or a BGP peer group has been configured in the VPN instance, delete the configuration of the BGP peer or peer group before configuring or deleting an AS number.

Precautions

  1. If an independent VPN instance has been configured with an AS number, no confederation can be configured for the VPN instance. A VPN instance configured with BGP confederation cannot be configured with an AS number.
  2. The independent AS number configured in the VPN instance view cannot be the same as the AS number configured in the BGP view.
  3. The AS number of the BGP VPN instance address family cannot coexist with the AS number of the BGP VPN instance.
  4. If a peer or peer group exists, the AS number of the BGP VPN instance cannot be changed.
  5. After an AS number is configured for a BGP VPN instance, the peers in the BGP VPN instance view can be enabled only in the IPv4 or IPv6 address family of the VPN instance.

Example

# Set the independent AS number of the VPN instance named vpna to 65001.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 1:4
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 10:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-a-instance-vpna] as-number ipv4 65001

as-number(BGP multi-instance VPN instance IPv6 address family view)

Function

The as-number command configures an AS number for a VPN instance.

The undo as-number command restores the default setting.

By default, a VPN instance uses the AS number of BGP.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

as-number vrf-as [ no-prepend ]

undo as-number

undo as-number vrf-as no-prepend

Parameters

Parameter Description Value
vrf-as

Specifies a destination AS number.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x is an integer that ranges from 1 to 65535, and y is an integer ranging from 0 to 65535.

no-prepend

Indicates whether to prepend the AS number.

-

Views

BGP multi-instance VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

During network transfer or service identification, you must simulate a device as multiple logical BGP devices. In this case, you can run the as-number command to configure an AS number for each VPN instance.

After the as-number command is used:

  • Peers in the VPN instance use the configured AS number to establish connections.
  • The configured AS number is used to generate the aggregator attribute during route aggregation.
  • When advertising routes to an EBGP (External Border Gateway Protocol) peer, the local device carries the AS number configured in the VPN instance.

If an AS number is configured for a VPN instance, the AS_Path attribute of the routes sent to the VPNv6 routing table carries the AS number configured for the VPN instance.

If as-number is configured for a VPN instance and no-prepend is specified after as-number, the AS_Path attribute of the route sent to the VPNv6 routing table does not carry the VPN instance's AS number.

Prerequisites

If a BGP peer or a BGP peer group has been configured in the VPN instance, delete the configuration of the BGP peer or peer group before configuring or deleting an AS number.

Precautions

If a VPN instance has been configured with an independent AS number, no confederation can be configured. When configuring a confederation, you cannot configure an independent AS number for a VPN instance.

The independent AS number configured in the VPN instance view cannot be the same as the AS number configured in the BGP view.

This command cannot be configured in the BGP YANG management mode. To configure an independent AS number for the VPN instance IPv6 address family, run the as-number ipv6 ipv6-as command in the BGP-VPN instance view.

Example

# Set the independent AS number of the VPN instance named vpna to 65001.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-instance-a-6-vpna] as-number 65001

as-number(BGP-VPN instance IPv4 address family view)

Function

The as-number command configures an AS number for a VPN instance.

The undo as-number command restores the default setting.

By default, a VPN instance uses the AS number of BGP.

Format

as-number vrf-as [ no-prepend ]

undo as-number

undo as-number vrf-as no-prepend

Parameters

Parameter Description Value
vrf-as

Specifies a destination AS number.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x is an integer that ranges from 1 to 65535, and y is an integer ranging from 0 to 65535.

no-prepend

Indicates whether the AS number is prepended.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

During network migration or service identification, if a physical device needs to be logically simulated as multiple BGP devices, you can run the as-number command to configure a unique AS number for each VPN instance.

After the as-number command is run:

  • Peers in a VPN instance use the configured AS number to establish a connection.
  • During route summarization, the configured independent AS number is used to generate the aggregator attribute.
  • Routes advertised to EBGP peers carry the AS number configured in the VPN instance.

If no-prepend is not specified, the AS_Path attributes of VPN routes sent to VPNv4 carry the configured AS number. If no-prepend is specified, the AS_Path attributes of VPN routes sent to VPNv4 do not carry the configured AS number.

Prerequisites

If a BGP peer or a BGP peer group has been configured in the VPN instance, delete the configuration of the BGP peer or peer group before configuring or deleting an AS number.

Precautions

If a VPN instance has been configured with a separate AS number, no confederation can be configured for the VPN instance. When configuring a confederation, you cannot configure a separate AS number in the VPN instance.

The AS number configured in a VPN instance must be different from the AS number configured in the BGP view.

This command cannot be configured in the YANG management mode of BGP. To configure a separate AS number for the VPN instance IPv4 address family, run the as-number ipv4 ipv4-as command in the BGP-VPN instance view.

When a 4-byte AS number is configured for BGP, OSPF does not support automatic tag-based loop prevention.

Example

# Set the AS number of the VPN instance named vpn1 to 65001.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] as-number 65001

as-path-limit

Function

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

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

By default, no limit is configured on the maximum number of AS numbers in the AS_Path attribute, but the maximum number of AS numbers carried in the AS_Path attribute is limited by the BGP message length.

Format

as-path-limit limit

as-path-limit

undo as-path-limit

Parameters

Parameter Description Value
limit

Specifies the maximum number of AS numbers in the AS_Path attribute.

The value is an integer ranging from 1 to 2000. The default value is 255.

The maximum value of limit for the 2-byte and 4-byte AS number is the same.

If limit is not specified, the maximum number of AS numbers in the AS_Path attribute is 255.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

This command is used to limit the maximum number of AS numbers in the AS_Path attribute only when the AS_Path attribute is reconstructed, routes are summarized to generate new routes, routes are newly learned from peers, or routes are advertised to peers.

Configuration Impact

After the as-path-limit command is configured, the device checks whether the number of AS numbers in the AS_Path attribute of the routes to be received or sent exceeds the upper limit. The learned routes are not checked. If the number of AS numbers exceeds the upper limit, the device discards the route. Therefore, if the maximum number of AS numbers in the AS_Path attribute is set too small, routes will be lost.

Example

# Set the maximum number of AS numbers in the AS_Path attribute to 200.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] as-path-limit 200

auto-frr (BGP view)

Function

The auto-frr command enables BGP Auto fast reroute (FRR).

The undo auto-frr command restores the default configuration.

By default, BGP Auto FRR is disabled.

Format

auto-frr

undo auto-frr

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

As networks continue to develop, services, such as voice, online video, and financial services, pose higher requirements for real-time transmission. Primary and backup links are typically deployed on a network to ensure the stability of these services. In traditional forwarding mode, the device selects the optimal route from multiple routes to the same destination and delivers the route to the FIB table to guide data forwarding. If the optimal route fails, the device must wait for route convergence to be completed, after which the device reselects an optimal route and delivers it to the FIB table to restore services. This process leads to long service interruption, resulting in a failure to meet service requirements.

After BGP Auto FRR is enabled on a device, the device selects the optimal route from the routes that are bound for the same destination network. In addition, the device automatically adds information about the suboptimal route to the backup forwarding entries of the optimal route. If the primary link fails, the device quickly switches traffic to the backup link. The switchover does not depend on route convergence and can be performed within sub-seconds, greatly reducing service interruption time. For BGP labeled routes, FRR is supported only on the ingress and transit nodes.

Example

# Enable BGP Auto FRR for unicast routes.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] auto-frr

auto-frr (BGP-IPv4 unicast address family view)

Function

The auto-frr command enables BGP Auto fast reroute (FRR).

The undo auto-frr command restores the default configuration.

By default, BGP Auto FRR is disabled.

Format

auto-frr

undo auto-frr

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

As networks continue to develop, services, such as voice, online video, and financial services, pose higher requirements for real-time transmission. Primary and backup links are typically deployed on a network to ensure the stability of these services. In traditional forwarding mode, the device selects the optimal route from multiple routes to the same destination and delivers the route to the FIB table to guide data forwarding. If the optimal route fails, the device must wait for route convergence to be completed, after which the device reselects an optimal route and delivers it to the FIB table to restore services. This process leads to long service interruption, resulting in a failure to meet service requirements.

After BGP Auto FRR is enabled on a device, the device selects the optimal route from the routes that are bound for the same destination network. In addition, the device automatically adds information about the suboptimal route to the backup forwarding entries of the optimal route. If the primary link fails, the device quickly switches traffic to the backup link. The switchover does not depend on route convergence and can be performed within sub-seconds, greatly reducing service interruption time. For BGP labeled routes, FRR is supported only on the ingress and transit nodes.

Example

# Enable BGP Auto FRR for unicast routes.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] auto-frr

auto-frr (BGP-IPv6 unicast address family view)

Function

The auto-frr command enables BGP Auto fast reroute (FRR).

The undo auto-frr command restores the default configuration.

By default, BGP Auto FRR is disabled.

Format

auto-frr

undo auto-frr

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

As networks evolve continuously, voice, on-line video, and financial services raise increasingly high requirements for real-time performance. Usually, primary and backup links are deployed on a network to ensure the stability of these services. In a traditional forwarding mode, a device selects a route out of several routes that are bound for the same destination network as the optimal route and delivers the route to the FIB table to guide data forwarding. If the optimal route fails, a device has to wait for route convergence to be completed before reselecting an optimal route. During this period, services are interrupted. After a device delivers the reselected optimal route to the FIB table, services are restored. Service interruption in this mode lasts a long time, which cannot meet services' requirements.

After BGP Auto FRR is enabled on a device, the device selects the optimal route from the routes that are bound for the same destination network. In addition, a device automatically adds information about the second optimal route to the backup forwarding entries of the optimal route. If the primary link fails, a device quickly switches traffic to the backup link. The switchover does not depend on route convergence. Therefore, the service interruption time is very short, reaching the sub-second level.

Example

# Enable Auto FRR in the BGP-IPv6 unicast address family view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] auto-frr

auto-frr (BGP-VPN instance IPv4 address family view)

Function

The auto-frr command enables BGP Auto fast reroute (FRR).

The undo auto-frr command restores the default configuration.

By default, BGP Auto FRR is disabled.

Format

auto-frr

undo auto-frr

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

As networks evolve continuously, voice, on-line video, and financial services raise increasingly high requirements for real-time performance. Usually, primary and backup links are deployed on a network to ensure the stability of these services. In a traditional forwarding mode, a device selects a route out of several routes that are bound for the same destination network as the optimal route and delivers the route to the FIB table to guide data forwarding. If the optimal route fails, a device has to wait for route convergence to be completed before reselecting an optimal route. During this period, services are interrupted. After a device delivers the reselected optimal route to the FIB table, services are restored. Service interruption in this mode lasts a long time, which cannot meet services' requirements.

After BGP Auto FRR is enabled on a device, the device selects the optimal route from the routes that are bound for the same destination network. In addition, a device automatically adds information about the second optimal route to the backup forwarding entries of the optimal route. If the primary link fails, a device quickly switches traffic to the backup link. The switchover does not depend on route convergence. Therefore, the service interruption time is very short, reaching the sub-second level.

Implementation Procedure

If both the ip frr and auto-frr commands are configured, the auto-frr command takes precedence over the ip frr command.

Precautions

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

Example

# Enable BGP Auto FRR in the BGP-VPN instance IPv4 address family view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] auto-frr

auto-frr (BGP-VPN instance IPv6 address family view)

Function

The auto-frr command enables BGP Auto fast reroute (FRR).

The undo auto-frr command restores the default configuration.

By default, BGP Auto FRR is disabled.

Format

auto-frr

undo auto-frr

Parameters

None

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

As networks evolve continuously, voice, on-line video, and financial services raise increasingly high requirements for real-time performance. Usually, primary and backup links are deployed on a network to ensure the stability of these services. In a traditional forwarding mode, a device selects a route out of several routes that are bound for the same destination network as the optimal route and delivers the route to the FIB table to guide data forwarding. If the optimal route fails, a device has to wait for route convergence to be completed before reselecting an optimal route. During this period, services are interrupted. After a device delivers the reselected optimal route to the FIB table, services are restored. Service interruption in this mode lasts a long time, which cannot meet services' requirements.

After BGP Auto FRR is enabled on a device, the device selects the optimal route from the routes that are bound for the same destination network. In addition, a device automatically adds information about the second optimal route to the backup forwarding entries of the optimal route. If the primary link fails, a device quickly switches traffic to the backup link. The switchover does not depend on route convergence. Therefore, the service interruption time is very short, reaching the sub-second level.

Example

# Enable Auto FRR.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] auto-frr

bestroute add-path (BGP-IPv4 unicast address family view)

Function

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

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

By default, BGP Add-Path is not enabled.

Format

bestroute add-path path-number path-number

undo bestroute add-path

Parameters

Parameter Description Value
path-number path-number

Specifies the number of routes that the device can select.

The value is an integer ranging from 2 to 64.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Follow-up Procedure

Run the peer capability-advertise add-path send command to enable the device to advertise Add-Path routes to a specified peer.

Run the peer advertise add-path command to specify the number of routes to be advertised to a peer.

Precautions

The bestroute add-path command can be configured and takes effect on any device, but it is mainly configured on an RR. After this command is run, BGP can select multiple routes.

The selected Add-Path routes may not work in load balancing mode. They can work in load balancing mode only when they meet load balancing conditions.

If the optimal route is a labeled route, only labeled routes are selected as Add-Path routes. If the optimal route is a common route, only common routes are selected as Add-Path routes.

To enable the device to accept the Add-Path routes received from the specified peer, you need to run the peer capability-advertise add-path receive command on the device.

BGP Add-Path advertises multiple routes with the same prefix. Therefore, in specific scenarios, two devices may select each other as the next hop, causing a traffic loop. Avoid such scenarios when deploying BGP Add-Path.

The bestroute add-path and deterministic-med commands are mutually exclusive. Do not run them together.

Example

# Set the number of routes that the device can select to 6.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] bestroute add-path path-number 6

bestroute add-path (BGP-IPv6 unicast address family view)

Function

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

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

By default, BGP Add-Path is not enabled.

Format

bestroute add-path path-number path-number

undo bestroute add-path

Parameters

Parameter Description Value
path-number path-number

Specifies the number of routes that the device can select.

The value is an integer that ranges from 2 to 64.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Follow-up Procedure

Run the peer capability-advertise add-path send command to enable the device to advertise Add-Path routes to a specified peer.

Run the peer advertise add-path command to specify the number of routes to be advertised to a peer.

Precautions

The bestroute add-path command can be configured and takes effect on any device, but it is mainly configured on an RR. After this command is run, BGP can select multiple routes.

The selected Add-Path routes may not work in load balancing mode. They can work in load balancing mode only when they meet load balancing conditions.

If the optimal route is a labeled route, only labeled routes are selected as Add-Path routes. If the optimal route is a common route, only common routes are selected as Add-Path routes.

To enable the device to accept the Add-Path routes received from the specified peer, you need to run the peer capability-advertise add-path receive command on the device.

BGP Add-Path advertises multiple routes with the same prefix. Therefore, in specific scenarios, two devices may select each other as the next hop, causing a traffic loop. Avoid such scenarios when deploying BGP Add-Path.

The bestroute add-path and deterministic-med commands are mutually exclusive. Do not run them together.

Example

# Set the number of routes that the device can select to 6.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] bestroute add-path path-number 6

bestroute as-path-ignore

Function

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

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

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

Format

bestroute as-path-ignore

undo bestroute as-path-ignore

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the bestroute as-path-ignore command is used, BGP does not compare the AS path attributes of routes (including the AS_Path length and content).

Configuration Impact

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

Example

# Configure BGP to ignore the AS_Path attribute when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] bestroute as-path-ignore

bestroute as-path-ignore (BGP multi-instance VPN instance IPv4 address family view)

Function

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

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

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

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

bestroute as-path-ignore

undo bestroute as-path-ignore

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the bestroute as-path-ignore command is used, BGP does not compare the AS path attributes of routes (including the AS_Path length and content).

Configuration Impact

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

Example

# Configure BGP to ignore the AS_Path attribute when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] bestroute as-path-ignore

bestroute as-path-ignore (BGP view)

Function

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

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

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

Format

bestroute as-path-ignore

undo bestroute as-path-ignore

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the bestroute as-path-ignore command is used, BGP does not compare the AS path attributes of routes (including the AS_Path length and content).

Configuration Impact

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

Example

# Configure BGP to ignore the AS_Path attribute when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] bestroute as-path-ignore

bestroute as-path-ignore (BGP-IPv4 unicast address family view)

Function

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

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

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

Format

bestroute as-path-ignore

undo bestroute as-path-ignore

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the bestroute as-path-ignore command is used, BGP does not compare the AS path attributes of routes (including the AS_Path length and content).

Configuration Impact

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

Example

# Configure BGP to ignore the AS_Path attribute when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] bestroute as-path-ignore

bestroute as-path-ignore (BGP-IPv6 unicast address family view)

Function

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

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

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

Format

bestroute as-path-ignore

undo bestroute as-path-ignore

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the bestroute as-path-ignore command is used, BGP does not compare the AS path attributes of routes (including the AS_Path length and content).

Configuration Impact

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

Example

# Configure BGP to ignore the AS_Path attribute when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] bestroute as-path-ignore

bestroute as-path-ignore (BGP-VPN instance IPv6 address family view)

Function

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

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

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

Format

bestroute as-path-ignore

undo bestroute as-path-ignore

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the bestroute as-path-ignore command is used, BGP does not compare the AS path attributes of routes (including the AS_Path length and content).

Configuration Impact

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

Example

# Configure BGP to ignore the AS_Path attribute when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] bestroute as-path-ignore

bestroute igp-metric-ignore (BGP multi-instance VPN instance IPv4 address family view)

Function

The bestroute igp-metric-ignore command configures BGP to ignore the IGP cost when selecting the optimal route.

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

By default, BGP uses the IGP cost as one of route selection rules.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

bestroute igp-metric-ignore

undo bestroute igp-metric-ignore

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a BGP network, a device often receives multiple routes with the same prefix but different paths from different peers. To forward traffic to that prefix address, BGP needs to select an optimal route from these routes. By default, BGP will compare the IGP costs of these routes to their BGP next hops and select a route with the smallest IGP cost.

The bestroute igp-metric-ignore command can be run to configure BGP to ignore the IGP costs in route selection.

Configuration Impact

After the bestroute igp-metric-ignore command is run, BGP does not compare the IGP costs of routes to BGP next hops.

Example

# Configure BGP to ignore the IGP cost when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] bestroute igp-metric-ignore

bestroute igp-metric-ignore (BGP view)

Function

The bestroute igp-metric-ignore command configures BGP to ignore the IGP cost when selecting the optimal route.

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

By default, BGP uses the IGP cost as one of route selection rules.

Format

bestroute igp-metric-ignore

undo bestroute igp-metric-ignore

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a BGP network, a device often receives multiple routes with the same prefix but different paths from different peers. To forward traffic to that prefix address, BGP needs to select an optimal route from these routes. By default, BGP will compare the IGP costs of these routes to their BGP next hops and select a route with the smallest IGP cost.

The bestroute igp-metric-ignore command can be run to configure BGP to ignore the IGP costs in route selection.

Configuration Impact

After the bestroute igp-metric-ignore command is run, BGP does not compare the IGP costs of routes to BGP next hops.

Example

# Configure BGP to ignore the IGP cost when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] bestroute igp-metric-ignore

bestroute igp-metric-ignore (BGP-IPv4 unicast address family view)

Function

The bestroute igp-metric-ignore command configures BGP to ignore the IGP cost when selecting the optimal route.

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

By default, BGP uses the IGP cost as one of route selection rules.

Format

bestroute igp-metric-ignore

undo bestroute igp-metric-ignore

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a BGP network, a device often receives multiple routes with the same prefix but different paths from different peers. To forward traffic to that prefix address, BGP needs to select an optimal route from these routes. By default, BGP will compare the IGP costs of these routes to their BGP next hops and select a route with the smallest IGP cost.

The bestroute igp-metric-ignore command can be run to configure BGP to ignore the IGP costs in route selection.

Configuration Impact

After the bestroute igp-metric-ignore command is run, BGP does not compare the IGP costs of routes to BGP next hops.

Example

# Configure BGP to ignore the IGP cost when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] bestroute igp-metric-ignore

bestroute igp-metric-ignore (BGP-IPv6 unicast address family view)

Function

The bestroute igp-metric-ignore command configures BGP to ignore the IGP cost when selecting the optimal route.

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

By default, BGP uses the IGP cost as one of route selection rules.

Format

bestroute igp-metric-ignore

undo bestroute igp-metric-ignore

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a BGP network, a device often receives multiple routes with the same prefix but different paths from different peers. To forward traffic to that prefix address, BGP needs to select an optimal route from these routes. By default, BGP will compare the IGP costs of these routes to their BGP next hops and select a route with the smallest IGP cost.

The bestroute igp-metric-ignore command can be run to configure BGP to ignore the IGP costs in route selection.

Configuration Impact

After the bestroute igp-metric-ignore command is run, BGP does not compare the IGP costs of routes to BGP next hops.

Example

# Configure BGP to ignore the IGP cost when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] bestroute igp-metric-ignore

bestroute igp-metric-ignore (BGP-VPN instance IPv4 address family view)

Function

The bestroute igp-metric-ignore command configures BGP to ignore the IGP cost when selecting the optimal route.

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

By default, BGP uses the IGP cost as one of route selection rules.

Format

bestroute igp-metric-ignore

undo bestroute igp-metric-ignore

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a BGP network, a device often receives multiple routes with the same prefix but different paths from different peers. To forward traffic to that prefix address, BGP needs to select an optimal route from these routes. By default, BGP will compare the IGP costs of these routes to their BGP next hops and select a route with the smallest IGP cost.

The bestroute igp-metric-ignore command can be run to configure BGP to ignore the IGP costs in route selection.

Configuration Impact

After the bestroute igp-metric-ignore command is run, BGP does not compare the IGP costs of routes to BGP next hops.

Example

# Configure BGP to ignore the IGP cost when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] bestroute igp-metric-ignore

bestroute igp-metric-ignore (BGP-VPN instance IPv6 address family view)

Function

The bestroute igp-metric-ignore command configures BGP to ignore the IGP cost when selecting the optimal route.

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

By default, BGP uses the IGP cost as one of route selection rules.

Format

bestroute igp-metric-ignore

undo bestroute igp-metric-ignore

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a BGP network, a device often receives multiple routes with the same prefix but different paths from different peers. To forward traffic to that prefix address, BGP needs to select an optimal route from these routes. By default, BGP will compare the IGP costs of these routes to their BGP next hops and select a route with the smallest IGP cost.

The bestroute igp-metric-ignore command can be run to configure BGP to ignore the IGP costs in route selection.

Configuration Impact

After the bestroute igp-metric-ignore command is run, BGP does not compare the IGP costs of routes to BGP next hops.

Example

# Configure BGP to ignore the IGP cost when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vrf1
[HUAWEI-vpn-instance-vrf1] ipv6-family
[HUAWEI-vpn-instance-vrf1-af-ipv6] quit
[HUAWEI-vpn-instance-vrf1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vrf1
[HUAWEI-bgp6-vrf1] bestroute igp-metric-ignore

bestroute med-confederation (BGP view)

Function

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

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

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

Format

bestroute med-confederation

undo bestroute med-confederation

Parameters

None

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP compares the MED values of only the routes that are learned from peers in the same AS (excluding confederation sub-ASs). To enable BGP to compare MED values of routes in a confederation when selecting the optimal route, run the bestroute med-confederation command.

Configuration Impact

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

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

  • path1: AS_Path=65000 65004, med=2
  • path2: AS_Path=65001 65004, med=3
  • path3: AS_Path=65002 65004, med=4
  • path4: AS_Path=65003 65004, med=1

    After the bestroute med-confederation command is run, the AS_Path attributes of paths 1, 2, and 3 does not contain external AS numbers. Therefore, when selecting routes based on MED values, BGP compares the MED values of paths 1, 2, and 3 only.

Example

# Configure BGP to compare the MED values of routes only in the confederation when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] bestroute med-confederation

bestroute med-confederation (BGP-IPv6 unicast address family view)

Function

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

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

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

Format

bestroute med-confederation

undo bestroute med-confederation

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP compares the MED values of only the routes that are learned from peers in the same AS (excluding confederation sub-ASs). To enable BGP to compare MED values of routes in a confederation when selecting the optimal route, run the bestroute med-confederation command.

Configuration Impact

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

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

  • path1: AS_Path=65000 65004, med=2
  • path2: AS_Path=65001 65004, med=3
  • path3: AS_Path=65002 65004, med=4
  • path4: AS_Path=65003 65004, med=1

    After the bestroute med-confederation command is run, the AS_Path attributes of paths 1, 2, and 3 does not contain external AS numbers. Therefore, when selecting routes based on MED values, BGP compares the MED values of paths 1, 2, and 3 only.

Example

# Configure BGP to compare the MED values of routes only in the confederation when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] bestroute med-confederation

bestroute med-none-as-maximum (BGP multi-instance VPN instance IPv4 address family view)

Function

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

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

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

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

bestroute med-none-as-maximum

undo bestroute med-none-as-maximum

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The bestroute med-none-as-maximum command takes effect during BGP route selection and is used only when no MED is carried by BGP routes. If no MED is carried and the bestroute med-none-as-maximum command is not run, the system cannot select the desired route as the optimal route.

Configuration Impact

During BGP route selection, if the bestroute med-none-as-maximum command is run, a route without MED is assigned the maximum MED (4294967295).

Example

# Configure BGP to assign the maximum MED (4294967295) to a route without MED in route selection.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] bestroute med-none-as-maximum

bestroute med-none-as-maximum (BGP view)

Function

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

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

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

Format

bestroute med-none-as-maximum

undo bestroute med-none-as-maximum

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The bestroute med-none-as-maximum command takes effect during BGP route selection and is used only when no MED is carried by BGP routes. If no MED is carried and the bestroute med-none-as-maximum command is not run, the system cannot select the desired route as the optimal route.

Configuration Impact

During BGP route selection, if the bestroute med-none-as-maximum command is run, a route without MED is assigned the maximum MED (4294967295).

Example

# Configure BGP to assign the maximum MED (4294967295) to a route without MED in route selection.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] bestroute med-none-as-maximum

bestroute med-none-as-maximum (BGP-IPv4 unicast address family view)

Function

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

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

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

Format

bestroute med-none-as-maximum

undo bestroute med-none-as-maximum

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The bestroute med-none-as-maximum command takes effect during BGP route selection and is used only when no MED is carried by BGP routes. If no MED is carried and the bestroute med-none-as-maximum command is not run, the system cannot select the desired route as the optimal route.

Configuration Impact

During BGP route selection, if the bestroute med-none-as-maximum command is run, a route without MED is assigned the maximum MED (4294967295).

Example

# Configure BGP to assign the maximum MED (4294967295) to a route without MED in route selection.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] bestroute med-none-as-maximum

bestroute med-none-as-maximum (BGP-IPv6 unicast address family view)

Function

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

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

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

Format

bestroute med-none-as-maximum

undo bestroute med-none-as-maximum

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The bestroute med-none-as-maximum command takes effect during BGP route selection and is used only when no MED is carried by BGP routes. If no MED is carried and the bestroute med-none-as-maximum command is not run, the system cannot select the desired route as the optimal route.

Configuration Impact

During BGP route selection, if the bestroute med-none-as-maximum command is run, a route without MED is assigned the maximum MED (4294967295).

Example

# Configure BGP to assign the maximum MED (4294967295) to a route without MED in route selection.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] bestroute med-none-as-maximum

bestroute med-none-as-maximum (BGP-VPN instance IPv4 address family view)

Function

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

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

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

Format

bestroute med-none-as-maximum

undo bestroute med-none-as-maximum

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The bestroute med-none-as-maximum command takes effect during BGP route selection and is used only when no MED is carried by BGP routes. If no MED is carried and the bestroute med-none-as-maximum command is not run, the system cannot select the desired route as the optimal route.

Configuration Impact

During BGP route selection, if the bestroute med-none-as-maximum command is run, a route without MED is assigned the maximum MED (4294967295).

Example

# Configure BGP to assign the maximum MED (4294967295) to a route without MED in route selection.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] bestroute med-none-as-maximum

bestroute med-none-as-maximum (BGP-VPN instance IPv6 address family view)

Function

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

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

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

Format

bestroute med-none-as-maximum

undo bestroute med-none-as-maximum

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The bestroute med-none-as-maximum command takes effect during BGP route selection and is used only when no MED is carried by BGP routes. If no MED is carried and the bestroute med-none-as-maximum command is not run, the system cannot select the desired route as the optimal route.

Configuration Impact

During BGP route selection, if the bestroute med-none-as-maximum command is run, a route without MED is assigned the maximum MED (4294967295).

Example

# Configure BGP to assign the maximum MED (4294967295) to a route without MED in route selection.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] bestroute med-none-as-maximum

bestroute med-plus-igp (BGP multi-instance VPN instance IPv4 address family view)

Function

The bestroute med-plus-igp command configures BGP to preferentially select the route with the smallest sum of MED multiplied by a MED multiplier and IGP cost multiplied by an IGP cost multiplier when BGP needs to compare MEDs to select the optimal route.

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

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

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

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

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

Parameters

Parameter Description Value
igp-multiplier igp-multiplier

Specifies an IGP cost multiplier.

The value is an integer ranging from 1 to 1000. The default value is 1.

med-multiplier med-multiplier

Specifies a MED multiplier.

The value is an integer ranging from 1 to 1000. The default value is 1.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, MED values and IGP metrics are used as separate BGP route selection criteria. After the bestroute med-plus-igp command is run, BGP preferentially selects the route with the smallest sum of the MED multiplied by a MED multiplier and the IGP cost multiplied by an IGP cost multiplier. If two routes have different MED values and IGP cost values and load balancing is required, you can run this command to ensure that the two routes have the same sum of the MED multiplied by a MED multiplier and the IGP cost multiplied by an IGP cost multiplier.

If a route does not have an MED value, the MED value 0 is used.

Example

# Enable BGP to use the sum of MED multiplied by an MED multiplier and IGP cost multiplied by an IGP cost multiplier to select routes when MED is required to determine the optimal route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] bestroute med-plus-igp

bestroute med-plus-igp (BGP-IPv4 unicast address family view)

Function

The bestroute med-plus-igp command configures BGP to preferentially select the route with the smallest sum of MED multiplied by a MED multiplier and IGP cost multiplied by an IGP cost multiplier when BGP needs to compare MEDs to select the optimal route.

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

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

Format

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

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

Parameters

Parameter Description Value
igp-multiplier igp-multiplier

Specifies an IGP cost multiplier.

The value is an integer ranging from 1 to 1000. The default value is 1.

med-multiplier med-multiplier

Specifies a MED multiplier.

The value is an integer ranging from 1 to 1000. The default value is 1.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, MED values and IGP metrics are used as separate BGP route selection criteria. After the bestroute med-plus-igp command is run, BGP preferentially selects the route with the smallest sum of the MED multiplied by a MED multiplier and the IGP cost multiplied by an IGP cost multiplier. If two routes have different MED values and IGP cost values and load balancing is required, you can run this command to ensure that the two routes have the same sum of the MED multiplied by a MED multiplier and the IGP cost multiplied by an IGP cost multiplier.

If a route does not have an MED value, the MED value 0 is used.

Example

# Enable BGP to use the sum of MED multiplied by an MED multiplier and IGP cost multiplied by an IGP cost multiplier to select routes when MED is required to determine the optimal route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] bestroute med-plus-igp

bestroute med-plus-igp (BGP-IPv6 unicast address family view)

Function

The bestroute med-plus-igp command configures BGP to preferentially select the route with the smallest sum of MED multiplied by a MED multiplier and IGP cost multiplied by an IGP cost multiplier when BGP needs to compare MEDs to select the optimal route.

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

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

Format

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

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

Parameters

Parameter Description Value
igp-multiplier igp-multiplier

Specifies an IGP cost multiplier.

The value is an integer ranging from 1 to 1000. The default value is 1.

med-multiplier med-multiplier

Specifies a MED multiplier.

The value is an integer ranging from 1 to 1000. The default value is 1.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, MED values and IGP metrics are used as separate BGP route selection criteria. After the bestroute med-plus-igp command is run, BGP preferentially selects the route with the smallest sum of the MED multiplied by a MED multiplier and the IGP cost multiplied by an IGP cost multiplier. If two routes have different MED values and IGP cost values and load balancing is required, you can run this command to ensure that the two routes have the same sum of the MED multiplied by a MED multiplier and the IGP cost multiplied by an IGP cost multiplier.

If a route does not have an MED value, the MED value 0 is used.

Example

# Enable BGP to use the sum of MED multiplied by an MED multiplier and IGP cost multiplied by an IGP cost multiplier to select routes when MED is required to determine the optimal route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] bestroute med-plus-igp

bestroute med-plus-igp (BGP-VPN instance IPv4 address family view)

Function

The bestroute med-plus-igp command configures BGP to preferentially select the route with the smallest sum of MED multiplied by a MED multiplier and IGP cost multiplied by an IGP cost multiplier when BGP needs to compare MEDs to select the optimal route.

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

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

Format

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

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

Parameters

Parameter Description Value
igp-multiplier igp-multiplier

Specifies an IGP cost multiplier.

The value is an integer ranging from 1 to 1000. The default value is 1.

med-multiplier med-multiplier

Specifies a MED multiplier.

The value is an integer ranging from 1 to 1000. The default value is 1.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, MED values and IGP metrics are used as separate BGP route selection criteria. After the bestroute med-plus-igp command is run, BGP preferentially selects the route with the smallest sum of the MED multiplied by a MED multiplier and the IGP cost multiplied by an IGP cost multiplier. If two routes have different MED values and IGP cost values and load balancing is required, you can run this command to ensure that the two routes have the same sum of the MED multiplied by a MED multiplier and the IGP cost multiplied by an IGP cost multiplier.

If a route does not have an MED value, the MED value 0 is used.

Example

# Enable BGP to use the sum of MED multiplied by an MED multiplier and IGP cost multiplied by an IGP cost multiplier to select routes when MED is required to determine the optimal route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] bestroute med-plus-igp

bestroute med-plus-igp (BGP-VPN instance IPv6 address family view)

Function

The bestroute med-plus-igp command configures BGP to preferentially select the route with the smallest sum of MED multiplied by a MED multiplier and IGP cost multiplied by an IGP cost multiplier when BGP needs to compare MEDs to select the optimal route.

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

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

Format

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

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

Parameters

Parameter Description Value
igp-multiplier igp-multiplier

Specifies an IGP cost multiplier.

The value is an integer ranging from 1 to 1000. The default value is 1.

med-multiplier med-multiplier

Specifies a MED multiplier.

The value is an integer ranging from 1 to 1000. The default value is 1.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, MED values and IGP metrics are used as separate BGP route selection criteria. After the bestroute med-plus-igp command is run, BGP preferentially selects the route with the smallest sum of the MED multiplied by a MED multiplier and the IGP cost multiplied by an IGP cost multiplier. If two routes have different MED values and IGP cost values and load balancing is required, you can run this command to ensure that the two routes have the same sum of the MED multiplied by a MED multiplier and the IGP cost multiplied by an IGP cost multiplier.

If a route does not have an MED value, the MED value 0 is used.

Example

# Enable BGP to use the sum of MED multiplied by an MED multiplier and IGP cost multiplied by an IGP cost multiplier to select routes when MED is required to determine the optimal route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] bestroute med-plus-igp

bestroute router-id-ignore (BGP multi-instance VPN instance IPv4 address family view)

Function

The bestroute router-id-ignore command prevents BGP from comparing router IDs when selecting the optimal route.

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

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

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

bestroute router-id-ignore

undo bestroute router-id-ignore

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When receiving multiple routes with the same prefix from different peers, BGP needs to select an optimal route from these routes. To prevent BGP from comparing the router IDs contained in routes when it selects the optimal route, run the bestroute router-id-ignore command.

Configuration Impact

When selecting the optimal route, BGP does not compare the router IDs and peer IP addresses contained in routes after the bestroute router-id-ignore command is run.

Example

# Prevent BGP from comparing router IDs and peer IP addresses contained in routes when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] bestroute router-id-ignore

bestroute router-id-ignore (BGP view)

Function

The bestroute router-id-ignore command prevents BGP from comparing router IDs when selecting the optimal route.

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

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

Format

bestroute router-id-ignore

undo bestroute router-id-ignore

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When receiving multiple routes with the same prefix from different peers, BGP needs to select an optimal route from these routes. To prevent BGP from comparing the router IDs contained in routes when it selects the optimal route, run the bestroute router-id-ignore command.

Configuration Impact

When selecting the optimal route, BGP does not compare the router IDs and peer IP addresses contained in routes after the bestroute router-id-ignore command is run.

Example

# Prevent BGP from comparing router IDs and peer IP addresses contained in routes when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] bestroute router-id-ignore

bestroute router-id-ignore (BGP-IPv4 unicast address family view)

Function

The bestroute router-id-ignore command prevents BGP from comparing router IDs when selecting the optimal route.

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

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

Format

bestroute router-id-ignore

undo bestroute router-id-ignore

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When receiving multiple routes with the same prefix from different peers, BGP needs to select an optimal route from these routes. To prevent BGP from comparing the router IDs contained in routes when it selects the optimal route, run the bestroute router-id-ignore command.

Configuration Impact

When selecting the optimal route, BGP does not compare the router IDs and peer IP addresses contained in routes after the bestroute router-id-ignore command is run.

Example

# Prevent BGP from comparing router IDs and peer IP addresses contained in routes when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] bestroute router-id-ignore

bestroute router-id-ignore (BGP-IPv6 unicast address family view)

Function

The bestroute router-id-ignore command prevents BGP from comparing router IDs when selecting the optimal route.

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

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

Format

bestroute router-id-ignore

undo bestroute router-id-ignore

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When receiving multiple routes with the same prefix from different peers, BGP needs to select an optimal route from these routes. To prevent BGP from comparing the router IDs contained in routes when it selects the optimal route, run the bestroute router-id-ignore command.

Configuration Impact

When selecting the optimal route, BGP does not compare the router IDs and peer IP addresses contained in routes after the bestroute router-id-ignore command is run.

Example

# Prevent BGP from comparing router IDs and peer IP addresses contained in routes when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] bestroute router-id-ignore

bestroute router-id-ignore (BGP-VPN instance IPv4 address family view)

Function

The bestroute router-id-ignore command prevents BGP from comparing router IDs when selecting the optimal route.

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

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

Format

bestroute router-id-ignore

undo bestroute router-id-ignore

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When receiving multiple routes with the same prefix from different peers, BGP needs to select an optimal route from these routes. To prevent BGP from comparing the router IDs contained in routes when it selects the optimal route, run the bestroute router-id-ignore command.

Configuration Impact

When selecting the optimal route, BGP does not compare the router IDs and peer IP addresses contained in routes after the bestroute router-id-ignore command is run.

Example

# Prevent BGP from comparing router IDs and peer IP addresses contained in routes when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] bestroute router-id-ignore

bestroute router-id-ignore (BGP-VPN instance IPv6 address family view)

Function

The bestroute router-id-ignore command prevents BGP from comparing router IDs when selecting the optimal route.

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

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

Format

bestroute router-id-ignore

undo bestroute router-id-ignore

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When receiving multiple routes with the same prefix from different peers, BGP needs to select an optimal route from these routes. To prevent BGP from comparing the router IDs contained in routes when it selects the optimal route, run the bestroute router-id-ignore command.

Configuration Impact

When selecting the optimal route, BGP does not compare the router IDs and peer IP addresses contained in routes after the bestroute router-id-ignore command is run.

Example

# Prevent BGP from comparing router IDs and peer IP addresses contained in routes when selecting the optimal route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] bestroute router-id-ignore

bestroute routerid-prior-clusterlist (BGP multi-instance VPN instance IPv4 address family view)

Function

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

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

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

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

bestroute routerid-prior-clusterlist

undo bestroute routerid-prior-clusterlist

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Precautions

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

Example

# Enable Router ID to take precedence over Cluster_List during BGP route selection.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] bestroute routerid-prior-clusterlist

bestroute routerid-prior-clusterlist (BGP view)

Function

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

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

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

Format

bestroute routerid-prior-clusterlist

undo bestroute routerid-prior-clusterlist

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Precautions

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

Example

# Enable Router ID to take precedence over Cluster_List during BGP route selection.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] bestroute routerid-prior-clusterlist

bestroute routerid-prior-clusterlist (BGP-IPv4 unicast address family view)

Function

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

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

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

Format

bestroute routerid-prior-clusterlist

undo bestroute routerid-prior-clusterlist

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Precautions

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

Example

# Enable Router ID to take precedence over Cluster_List during BGP route selection.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] bestroute routerid-prior-clusterlist

bestroute routerid-prior-clusterlist (BGP-IPv6 unicast address family view)

Function

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

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

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

Format

bestroute routerid-prior-clusterlist

undo bestroute routerid-prior-clusterlist

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Precautions

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

Example

# Enable Router ID to take precedence over Cluster_List during BGP route selection.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] bestroute routerid-prior-clusterlist

bestroute routerid-prior-clusterlist (BGP-VPN instance IPv4 address family view)

Function

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

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

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

Format

bestroute routerid-prior-clusterlist

undo bestroute routerid-prior-clusterlist

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Precautions

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

Example

# Enable Router ID to take precedence over Cluster_List during BGP route selection.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] bestroute routerid-prior-clusterlist

bestroute routerid-prior-clusterlist (BGP-VPN instance IPv6 address family view)

Function

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

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

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

Format

bestroute routerid-prior-clusterlist

undo bestroute routerid-prior-clusterlist

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Precautions

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

Example

# Enable Router ID to take precedence over Cluster_List during BGP route selection.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vrf1
[HUAWEI-vpn-instance-vrf1] ipv6-family
[HUAWEI-vpn-instance-vrf1-af-ipv6] quit
[HUAWEI-vpn-instance-vrf1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vrf1
[HUAWEI-bgp6-vrf1] bestroute routerid-prior-clusterlist

bgp

Function

The bgp command enables BGP and enter the BGP view or displays the BGP view directly.

The undo bgp command disables BGP.

By default, the BGP is disabled.

Format

bgp as-number

undo bgp [ as-number ]

Parameters

Parameter Description Value
as-number

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

BGP transmits routes between ASs; however, it may not be required in some situations.

  • BGP is used only when at least one of the following conditions is met:
  • An AS allows data packets to traverse it to reach other ASs.
  • An AS has multiple external connections to multiple ISPs and multiple connections to the Internet.
  • Data flows entering or leaving ASs must be controlled.
  • BGP does not need to be run in the following situations:
  • The user is connected to only one ISP.
  • The ISP does not need to provide Internet routes for users.
  • ASs are connected through default routes.

Configuration Impact

After the bgp command is run, BGP is enabled.

Follow-up Procedure

Run the peer as-number command to establish BGP peer relationships between devices on a BGP network.

Precautions

Each device runs in only one AS; therefore, each device can be specified with only one local AS number.

By default, an AS number must be specified in the undo bgp command. If you run the configuration prevent-misoperation disable command to disable the second interactive confirmation function during the undo command execution, you do not need to specify an AS number in the undo bgp command.

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

After configuring the data to be delivered, run the end-group command to terminate and commit the configuration in the current configuration template and exit the configuration template view.

If the configurations in the configuration template do not need to be applied, run the undo command-string command in the configuration template view to delete the configurations in the specified configuration template.

The change of the BGP AS number may affect the route calculation result of the local or remote OSPF private network process. The tag value of the LSA of an OSPF private network process is calculated based on the BGP AS number. If the BGP AS number configuration changes, the local tag value of the OSPF private network process and the tag value carried in the LSA advertised by the OSPF private network process change. After receiving the LSA, the local or remote OSPF private network process checks the tag value, if the local tag of an OSPF private network process is the same as the tag of a received LSA, the LSA does not participate in OSPF route calculation.

For security purposes, after the configuration re-authentication enable command is configured, you need to enter a password and pass the authentication before running the undo bgp command to make the configuration take effect.

Example

# Enable BGP and enter the BGP view.
<HUAWEI> system-view
[HUAWEI] bgp 100

bgp default ipv4-unicast-config disable

Function

The bgp default ipv4-unicast-config disable command disables the configuration of commands that belong to the IPv4 unicast address family in the BGP view.

The undo bgp default ipv4-unicast-config disable command restores the default configuration.

By default, the commands of the IPv4 unicast address family can be configured in the BGP view.

Format

bgp default ipv4-unicast-config disable

undo bgp default ipv4-unicast-config disable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the bgp default ipv4-unicast-config disable command to disable the configuration of commands that belong to the IPv4 unicast address family in the BGP view.

Example

# Disable the configuration of commands that belong to the IPv4 unicast address family in the BGP view.
<HUAWEI> system-view
[HUAWEI] bgp default ipv4-unicast-config disable

bgp dynamic-session-limit

Function

The bgp dynamic-session-limit command configures a maximum number for dynamic BGP peer sessions.

The undo bgp dynamic-session-limit command restores the default configuration.

By default, the maximum number of dynamic BGP peer sessions is 100.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

bgp dynamic-session-limit max-num

undo bgp dynamic-session-limit max-num

Parameters

Parameter Description Value
max-num

Specifies a maximum number for dynamic BGP peer sessions.

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

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The dynamic BGP peer function enables BGP to listen for BGP connection requests from a specified network segment, dynamically establish BGP peer relationships, and add these peers to the same dynamic peer group. This spares you from adding or deleting BGP peer configurations in response to each change in dynamic peers. To configure a maximum number for dynamic BGP peer sessions, run the bgp dynamic-session-limit command.

Precautions

If you run the command to reduce the maximum number of dynamic BGP peer sessions, the established dynamic peers are not disconnected. For example, the current max-num is 50, and 50 dynamic peers have been established. Then, max-num is changed to 20. In this case, the 50 dynamic peers are not disconnected.

If the bgp dynamic-session-limit command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum number to 20 for dynamic BGP peer sessions.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] bgp dynamic-session-limit 20

bgp instance

Function

The bgp instance command enables BGP and enter the BGP multi-instance view.

The undo bgp instance command disables BGP.

By default, the BGP is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

bgp as-number instance instance-name

undo bgp as-number instance instance-name

Parameters

Parameter Description Value
as-number

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

instance instance-name

Specifies the BGP multi-instance name.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

BGP transmits routes between ASs; however, it may not be required in some situations.

BGP is used only when at least one of the following conditions is met:

  • An AS allows packets to traverse it to reach other ASs.
  • An AS has multiple external connections to multiple ISPs and multiple connections to the Internet.
  • Data flows entering or leaving an AS must be controlled.

BGP is not required in the following situations:

  • Users are connected to only one ISP.
  • The ISP does not need to provide Internet routes for users.
  • ASs are connected using default routes.

Configuration Impact

After the bgp command is run, BGP is enabled.

Follow-up Procedure

Run the peer as-number command to establish BGP peer relationships between devices on a BGP network.

Precautions

Generally, only one local AS number is specified for each device. When BGP multi-instance is configured, a multi-instance local AS number is specified.

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

Example

# Enable BGP and enter the BGP multi-instance view.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance instance100

bgp paf feature off

Function

The bgp paf feature off command disables the PAF restriction for a specified BGP feature.

The undo bgp paf feature off command enables the PAF restriction for a specified BGP feature.

By default, the PAF restriction for each BGP feature is enabled.

Format

bgp paf feature featureName off

undo bgp paf feature featureName off

Parameters

Parameter Description Value
featureName

Specifies a feature name.

The value is of the enumerated type:

route-num-all-peer: feature indicating whether the number of routes received from all peers in a BGP address family exceeds the upper limit.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The feature indicating whether the number of routes received from all peers in a BGP address family exceeds the upper limit can be restricted by the PAF. With the PAF restriction, if the number of received routes exceeds 80% of the upper limit, a threshold alarm is generated. If the number exceeds the upper limit, a threshold-crossing alarm is generated, and the excess routes are discarded. To enable the local device to continue to receive routes even after the number exceeds the upper limit, run the bgp paf feature off command to disable the PAF restriction for this feature.

Precautions

If the number of routes on a device has exceeded the upper limit, the discarded excess routes cannot be restored automatically after the PAF restriction is disabled. To address this issue, run the refresh bgp command.

Example

# Disable the PAF restriction for the feature indicating whether the number of routes received from all peers in a BGP address family exceeds the upper limit.
<HUAWEI> system-view
[HUAWEI] bgp paf feature route-num-all-peer off
Warning: This operation will cause the system to be out of PAF protection. [Y/N]:y

bgp path-attribute

Function

The bgp path-attribute command configures the processing mode of the specified incorrect path attribute.

The undo bgp path-attribute command restores the default configuration.

By default, path attribute packets are processed according to the standard protocol.

  • After receiving a packet with the Originator-ID attribute of 0, the switch discards the packet.
  • The device has been enabled to discard the packets with the Community, Ext-Community, IPv6 Ext-Community, Large-Community and Wide-Community attributes whose length is 0.
  • When the Attr-set attribute contains the values of the preceding sub-attributes, the packet corresponding to the attribute is discarded.

Format

bgp path-attribute { originator-id | attr-set } accept-zero-value

bgp path-attribute { community | ext-community | ipv6-ext-community | large-community | attr-set | wide-community } accept-zero-length

undo bgp path-attribute { originator-id | attr-set } accept-zero-value

undo bgp path-attribute { community | ext-community | ipv6-ext-community | large-community | attr-set | wide-community } accept-zero-length

Parameters

Parameter Description Value
originator-id

Indicates the ORIGINATOR attribute.

-

attr-set

Indicates the Attr-set attribute.

-

accept-zero-value

Indicates to accept the path attributes with a value of 0.

-

community

Indicates the community attribute.

-

ext-community

Indicates the Ext-community attribute.

-

ipv6-ext-community

Indicates the IPv6-ext-community attribute.

-

large-community

Indicates the Large-community attribute.

-

wide-community

Indicates the Wide-community attribute.

-

accept-zero-length

Indicates to accept zero-length path attributes.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device receives Update messages in incorrect formats, BGP sessions may flap. To resolve this problem, run the bgp path-attribute command to configure special processing for the specified incorrect BGP path attribute. The options are as follows:

  • accept-zero-value: indicates that the path attribute with a zero value is accepted.
  • accept-zero-length: indicates that the zero-length path attribute is accepted.

Precautions

This function takes effect immediately for the routes received after this command is executed. However, this function does not take effect immediately for the routes received before this command is run, and you need to run the refresh bgp command for this function to take effect in this case.

Example

# Configure the device to accept packets with the Originator-ID attribute set to 0.
<HUAWEI> system-view
[HUAWEI] bgp path-attribute originator-id accept-zero-value
# Configure the device to accept packets with the length of 0 bytes for the community path attribute.
<HUAWEI> system-view
[HUAWEI] bgp path-attribute community accept-zero-length

bgp yang-mode enable

Function

The bgp yang-mode enable command enables the YANG management mode for BGP VPN instances and BGP Muli-Instance VPN instances.

The undo bgp yang-mode enable command disables the YANG management mode for BGP VPN instances and BGP muli-instance VPN instances.

By default, the YANG management mode of BGP and BGP muli-instance is disabled.

Format

bgp yang-mode enable

undo bgp yang-mode enable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure and manage BGP private network instances and BGP multi-instance private network instances in huawei-bgp.yang, you need to enable the YANG-based management mode of the BGP private network instances on the device or globally enable the leaf node (/bgp:bgp/bgp:global/bgp:yang-enable) through the YANG model file.

Precautions

Running the bgp yang-mode enable command changes the configurations of BGP VPN instances and their peers or peer groups.

If a command supports both the BGP-VPN instance view and the BGP-VPN instance IPv4 address family view, the command can be run in either view before the bgp yang-mode enable command is run; after the bgp yang-mode enable command is run, this command can be run only in the BGP-VPN instance view. If the command has been configured in the BGP-VPN instance IPv4 address family view, the configuration file is automatically switched to the BGP-VPN instance view, which does not interrupt the network. However, if a configuration rollback is performed and the command in the BGP-VPN instance view is rolled back to the BGP-VPN instance IPv4 address family view, the configuration of the command will be deleted and then delivered. As a result, the network is interrupted. Therefore, exercise caution when using the configuration rollback function in this scenario. After the bgp yang-mode enable comamnd configuration is deleted, the configuration file that has been automatically converted will not be modified, and the command can be run in either view.

If a command supports both the BGP-VPN instance view and the BGP-VPN instance IPv6 address family view, the command can be run in either view before the bgp yang-mode enable command is run; after the bgp yang-mode enable command is run, this command can be run only in the BGP-VPN instance view. If the command has been configured in the BGP-VPN instance IPv6 address family view, the configuration file is automatically switched to the BGP-VPN instance view, which does not interrupt the network. However, if a configuration rollback is performed and the command in the BGP-VPN instance view is rolled back to the BGP-VPN instance IPv6 address family view, the configuration of the command will be deleted and then delivered. As a result, the network is interrupted. Therefore, exercise caution when using the configuration rollback function in this scenario. After the bgp yang-mode enable comamnd configuration is deleted, the configuration file that has been automatically converted will not be modified, and the command can be run in either view.

After the bgp yang-mode enable command is run on a device, you cannot configure or manage BGP multi-instance private network instances in the bgp_bgpmultiinstcomm.xsd file using the schema. You can configure and manage BGP private network instances in the huawei-bgp.yang file only using NETCONF YANG.

After the bgp yang-mode enable command is run, the as-number command run in the BGP-VPN instance IPv4 address family view and BGP-VPN instance IPv6 address family view is converted into the as-number ipv4 and as-number ipv6 commands run in the BGP-VPN instance view.

Example

# Enable the YANG management mode of BGP.
<HUAWEI> system-view
[HUAWEI] bgp yang-mode enable

bmp

Function

The bmp command starts BMP and then displays the BGP Monitoring Protocol (BMP) view or displays the BMP view directly.

The undo bmp command deletes all BMP configurations.

By default, BMP is disabled in the system.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

bmp

undo bmp

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Example

# Start BMP and enter the BMP view.
<HUAWEI> system-view
[HUAWEI] bmp

bmp-session

Function

The bmp-session command specifies a BMP session address for a BMP device to set up a TCP connection with a monitoring server.

The undo bmp-session command restores the default configuration.

By default, no BMP session address is set for a BMP device. In this case, the client is not in TCP connections with any monitoring servers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

bmp-session [ vpn-instance vrf-name ] ipv4-address

undo bmp-session [ vpn-instance vrf-name ] ipv4-address

Parameters

Parameter Description Value
vpn-instance vrf-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

ipv4-address

Specifies the IPv4 address of a BMP session.

The value is in dotted decimal notation.

Views

BMP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BMP is used to monitor BGP running status of devices in real time, such as the establishment and termination status of BGP peer relationships and route update status. After a TCP connection is established between a device and a monitoring server, the device reports BGP running status to the monitoring server, improving network monitoring efficiency. To specify a BMP session address for a BMP device to establish a TCP session with a monitoring server, run the bmp-session command. If the command is not run, a BMP device cannot establish TCP connections with any monitoring servers, and therefore its BGP running status cannot be monitored on any servers.

Precautions

A BMP device can be connected to multiple monitoring servers. You can specify different IP addresses or the same IP address but different port numbers (by specifying the alias-name parameter) to identify the monitoring servers. When a BMP device is connected to multiple monitoring servers, the BMP sends data to multiple monitoring servers at the same time.

Example

# Set the BMP session address to 10.1.1.1.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1

bmp-session (BMP view)(IPv6)

Function

The bmp-session command specifies a BMP session address for a BMP device to set up a TCP connection with a monitoring server.

The undo bmp-session command restores the default configuration.

By default, no BMP session address is set for a BMP device. In this case, the client is not in TCP connections with any monitoring servers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

bmp-session [ vpn-instance vpn-instance-name ] ipv6-address

undo bmp-session [ vpn-instance vpn-instance-name ] ipv6-address

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

ipv6-address

Specifies the IPv6 address of a BMP session.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BMP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BMP is used to monitor BGP running status of devices in real time, such as the establishment and termination status of BGP peer relationships and route update status. After a TCP connection is established between a device and a monitoring server, the device reports BGP running status to the monitoring server, improving network monitoring efficiency. To specify a BMP session address for a BMP device to establish a TCP session with a monitoring server, run the bmp-session command. If the command is not run, a BMP device cannot establish TCP connections with any monitoring servers, and therefore its BGP running status cannot be monitored on any servers.

Precautions

A BMP device can be connected to multiple monitoring servers. You can specify different IP addresses or the same IP address but different port numbers (by specifying the alias-name parameter) to identify the monitoring servers. When a BMP device is connected to multiple monitoring servers, the BMP device sends data to multiple monitoring servers at the same time.

Example

# Set the BMP session address to 2001:DB8:1::1.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 2001:DB8:1::1

bmp-session alias

Function

The bmp-session alias command specifies a BMP session address and a session alias for a BMP device to set up a TCP connection with a monitoring server.

The undo bmp-session alias command restores the default configuration.

By default, no BMP session address is set for a BMP device. In this case, the client is not in TCP connections with any monitoring servers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

bmp-session [ vpn-instance vrf-name ] ipv4-address alias alias-name

undo bmp-session [ vpn-instance vrf-name ] ipv4-address alias alias-name

Parameters

Parameter Description Value
vpn-instance vrf-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

ipv4-address

Specifies the IPv4 address of a BMP session.

The value is in dotted decimal notation.

alias alias-name

Specifies a session alias. When the device needs to establish multiple TCP connections with the same monitoring server through different port numbers, specify session aliases for differentiation.

The value is a string of 1 to 31 case-sensitive characters. Spaces are allowed only when the string is enclosed in double quotation marks ("").

Views

BMP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BMP is used to monitor BGP running status of devices in real time, such as the establishment and termination status of BGP peer relationships and route update status. After a TCP connection is established between a device and a monitoring server, the device reports BGP running status to the monitoring server, improving network monitoring efficiency. To specify a BMP session address for a BMP device to establish a TCP session with a monitoring server, run the bmp-session command. If the command is not run, a BMP device cannot establish TCP connections with any monitoring servers, and therefore its BGP running status cannot be monitored on any servers.

Precautions

If a device needs to establish TCP connections with multiple monitoring servers, specify different IP addresses. If the device needs to establish multiple TCP connections with the same monitoring server through different port numbers, specify one IP address and different session aliases (through the alias-name parameter) for differentiation.

Example

# Set the BMP session address to 10.1.1.1 and session alias to aa.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1 alias aa

bmp-session alias (BMP view)(IPv6)

Function

The bmp-session alias command specifies a BMP session address and a session alias for a BMP device to set up a TCP connection with a monitoring server.

The undo bmp-session alias command restores the default configuration.

By default, no BMP session address is set for a BMP device. In this case, the client is not in TCP connections with any monitoring servers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

bmp-session [ vpn-instance vrf-name ] ipv6-address alias alias-name

undo bmp-session [ vpn-instance vrf-name ] ipv6-address alias alias-name

Parameters

Parameter Description Value
vpn-instance vrf-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

ipv6-address

Specifies the IPv6 address of a BMP session.

The address is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

alias alias-name

Specifies a session alias. When the device needs to establish multiple TCP connections with the same monitoring server through different port numbers, specify session aliases for differentiation.

The value is a string of 1 to 31 case-sensitive characters. Spaces are allowed only when the string is enclosed in double quotation marks ("").

Views

BMP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BMP is used to monitor BGP running status of devices in real time, such as the establishment and termination status of BGP peer relationships and route update status. After a TCP connection is established between a device and a monitoring server, the device reports BGP running status to the monitoring server, improving network monitoring efficiency. To specify a BMP session address for a BMP device to establish a TCP session with a monitoring server, run the bmp-session command. If the command is not run, a BMP device cannot establish TCP connections with any monitoring servers, and therefore its BGP running status cannot be monitored on any servers.

Precautions

If a device needs to establish TCP connections with multiple monitoring servers, specify different IP addresses. If the device needs to establish multiple TCP connections with the same monitoring server through different port numbers, specify one IP address and different session aliases (through the alias-name parameter) for differentiation.

Example

# Set the BMP session address to 2001:DB8:1::1 and session alias to aa.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 2001:DB8:1::1 alias aa

check-first-as (BGP multi-instance view)

Function

The check-first-as command enables BGP to check the first AS number in the AS_Path that is carried in Update messages sent by EBGP peers.

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

By default, the function is enabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

check-first-as

undo check-first-as

Parameters

None

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP checks the first AS number in the AS_Path list that is carried in the Update message sent by the EBGP peer. If only the first AS number indicates the AS where the EBGP peer locates, the Update message is permitted. Otherwise, the update information is rejected.

Follow-up Procedure

Run the refresh bgp command if you want to check the received routes again.

Precautions

The check-first-as command is not listed in the configuration file.

After the undo check-first-as command is configured, routing loops may occur. Therefore, exercise caution when running the command.

Example

# Check the first AS number in the AS_Path list that is carried in the Update messages sent by EBGP peers.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] check-first-as

check-first-as (BGP view)

Function

The check-first-as command enables BGP to check the first AS number in the AS_Path that is carried in Update messages sent by EBGP peers.

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

By default, the function is enabled.

Format

check-first-as

undo check-first-as

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP checks the first AS number in the AS_Path list that is carried in the Update message sent by the EBGP peer. If only the first AS number indicates the AS where the EBGP peer locates, the Update message is permitted. Otherwise, the update information is rejected.

Follow-up Procedure

Run the refresh bgp command if you want to check the received routes again.

Precautions

The check-first-as command is not listed in the configuration file.

After the undo check-first-as command is configured, routing loops may occur. Therefore, exercise caution when running the command.

Example

# Check the first AS number in the AS_Path list that is carried in the Update messages sent by EBGP peers.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] check-first-as

clear route loop-detect bgp alarm

Function

The clear route loop-detect bgp alarm command clears BGP loop alarms reported to the NMS.

Format

clear route loop-detect bgp alarm

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP routing loop is detected, the device reports a hwBgpRouteLoopDetected alarm. The device cannot automatically detect whether the loop is removed. Therefore, you need to run this command to manually clear the BGP loop alarm after the routing loop is removed.

Example

# Clear BGP loop alarms.
<HUAWEI> system-view
[HUAWEI] clear route loop-detect bgp alarm

compare-different-as-med (BGP multi-instance VPN instance IPv4 address family view)

Function

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

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

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

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

compare-different-as-med

undo compare-different-as-med

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Configuration Impact

After the compare-different-as-med command is run, the system compares the MEDs in the routes learned from peers in different ASs.

Precautions

Do not run the compare-different-as-med command unless different ASs use the same IGP and route selection mode.

Example

# Enable BGP to compare the MEDs in the routes learned from peers in different ASs.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] compare-different-as-med

compare-different-as-med (BGP view)

Function

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

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

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

Format

compare-different-as-med

undo compare-different-as-med

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Configuration Impact

After the compare-different-as-med command is run, the system compares the MEDs in the routes learned from peers in different ASs.

Precautions

Do not run the compare-different-as-med command unless different ASs use the same IGP and route selection mode.

Example

# Enable BGP to compare the MEDs in the routes learned from peers in different ASs.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] compare-different-as-med

compare-different-as-med (BGP-IPv4 unicast address family view)

Function

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

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

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

Format

compare-different-as-med

undo compare-different-as-med

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Configuration Impact

After the compare-different-as-med command is run, the system compares the MEDs in the routes learned from peers in different ASs.

Precautions

Do not run the compare-different-as-med command unless different ASs use the same IGP and route selection mode.

Example

# Enable BGP to compare the MEDs in the routes learned from peers in different ASs.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] compare-different-as-med

compare-different-as-med (BGP-IPv6 unicast address family view)

Function

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

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

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

Format

compare-different-as-med

undo compare-different-as-med

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Configuration Impact

After the compare-different-as-med command is run, the system compares the MEDs in the routes learned from peers in different ASs.

Precautions

Do not run the compare-different-as-med command unless different ASs use the same IGP and route selection mode.

Example

# Enable BGP to compare the MEDs in the routes learned from peers in different ASs.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] compare-different-as-med

compare-different-as-med (BGP-VPN instance IPv4 address family view)

Function

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

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

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

Format

compare-different-as-med

undo compare-different-as-med

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Configuration Impact

After the compare-different-as-med command is run, the system compares the MEDs in the routes learned from peers in different ASs.

Precautions

Do not run the compare-different-as-med command unless different ASs use the same IGP and route selection mode.

Example

# Enable BGP to compare the MEDs in the routes learned from peers in different ASs.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] compare-different-as-med

compare-different-as-med (BGP-VPN instance IPv6 address family view)

Function

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

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

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

Format

compare-different-as-med

undo compare-different-as-med

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Configuration Impact

After the compare-different-as-med command is run, the system compares the MEDs in the routes learned from peers in different ASs.

Precautions

Do not run the compare-different-as-med command unless different ASs use the same IGP and route selection mode.

Example

# Enable BGP to compare the MEDs in the routes learned from peers in different ASs.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] compare-different-as-med

confederation id

Function

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

The undo confederation id command deletes the configured BGP confederation.

By default, no BGP confederation is configured.

Format

confederation id as-number

undo confederation id

Parameters

Parameter Description Value
as-number

Specifies a destination AS number.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A large AS may contain a huge number of fully meshed IBGP peer relationships. To reduce the number of fully meshed IBGP peer relationships in the AS and keep the integrity of the original AS, perform the following operations:

Divide the AS into multiple sub-ASs and run the confederation id command to configure a BGP confederation. Then establish EBGP connections between sub-ASs and establish fully meshed IBGP connections within the same sub-AS.

Some key attributes of routes, such as the next hop, MED, and Local_Pref are not discarded when these routes pass through sub-ASs.

Precautions

The confederation ID is equal to the AS number. During the establishment of a peer relationship with a peer in an external AS, specify the confederation ID. All the sub-ASs in the same confederation must be configured with the same confederation ID, and the confederation ID must be different from the number of any sub-AS.

Example

# Configure a confederation ID. An AS is divided into sub-ASs 38, 39, 40, and 41, and their confederation ID is 9. Peer 10.2.3.4 is a member of the AS confederation. Peer 10.11.11.1 is a member outside the AS confederation. For external members, confederation 9 is a unified AS.
<HUAWEI> system-view
[HUAWEI] bgp 41
[HUAWEI-bgp] confederation id 9
[HUAWEI-bgp] confederation peer-as 38 39 40
[HUAWEI-bgp] peer 10.2.3.4 as-number 38
[HUAWEI-bgp] peer 10.11.11.1 as-number 98

confederation nonstandard

Function

The confederation nonstandard command enables devices to be compatible with the devices that do not support standard AS confederation.

The undo confederation nonstandard command disables the configuration.

By default, the Device is not compatible with the devices that do not support standard AS confederation.

Format

confederation nonstandard

undo confederation nonstandard

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To ensure that the devices can communicate with other devices that do not support standard AS confederation, run the command on all devices in a confederation.

Configuration Impact

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

Example

# Enable the devices to be compatible with devices that do not support standard AS confederation. The AS 100 contains two sub-ASs, 64000 and 65000.
<HUAWEI> system-view
[HUAWEI] bgp 64000
[HUAWEI-bgp] confederation id 100
[HUAWEI-bgp] confederation peer-as 65000
[HUAWEI-bgp] confederation nonstandard

confederation peer-as

Function

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

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

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

Format

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

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

Parameters

Parameter Description Value
as-number

Specifies an AS number.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A large AS may contain a huge number of fully meshed IBGP peer relationships. In this situation, configure a confederation. To configure the number of each sub-AS of the confederation, run the confederation peer-as command.

Prerequisites

A confederation ID has been configured using the confederation id command.

Configuration Impact

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

Precautions

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

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

Example

# Configure the number of each sub-AS of the confederation.
<HUAWEI> system-view
[HUAWEI] bgp 1090
[HUAWEI-bgp] confederation id 100
[HUAWEI-bgp] confederation peer-as 1091 1092 1093

connect-interface (BMP session view)

Function

The connect-interface command specifies a source interface to send BMP messages and a source IP address to set up a BMP session.

The undo connect-interface command restores the default configuration.

By default, no source interface is specified to send BMP messages.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

connect-interface { interface-name | ipv4-source-address | interface-type interface-number | interface-name ipv4-source-address | interface-type interface-number ipv4-source-address }

undo connect-interface

undo connect-interface { interface-name | ipv4-source-address | interface-type interface-number | interface-name ipv4-source-address | interface-type interface-number ipv4-source-address }

Parameters

Parameter Description Value
interface-name

Specifies an interface name.

-

ipv4-source-address

Specifies a source IPv4 address to set up a BMP session.

The value is in dotted decimal notation.

interface-type

Specifies an interface type.

-

interface-number

Specifies the number of an interface.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

Views

BMP session view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BMP is used to monitor BGP running status of devices in real time, such as the status of BGP peer relationship establishment and termination and route updates.

After a TCP connection is established between a monitoring server and a device to be monitored, the device sends unsolicited BMP messages to the monitoring server to report BGP running statistics. After receiving these BMP messages, the monitoring server parses them and displays the BGP running status in the monitoring view. By analyzing the headers in the BMP messages, the monitoring server can determine from which BGP peer the routes carried in the messages were received. By default, the source interface used to send BMP messages is not specified after a TCP connection is established between a monitoring server and a device to be monitored. If the device encounters a failure, the source interface used to send BMP messages may change. In this case, the monitoring server cannot determine whether the new source interface belongs to a new device. To address this problem, run the connect-interface command to specify a source interface to send BMP messages.

The connect-interface command can be run in both the BMP view and BMP session view. If the command is run in both views, the configuration in the BMP session view takes precedence over that in the BMP view.

Precautions

If the connect-interface command is run more than once, the last configuration overrides the previous one.

In the BMP view, a source IPv4 address to set up a BMP session can be specified using the connect-interface command, whereas no source IPv6 address to set up a BMP session or source interface to send BMP messages can be specified. If the command is run in the BMP view, all IPv4 BMP sessions without a source IP address or source interface configured will be reestablished.

Example

# Specify a source IPv4 address to set up a BMP session.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1
[HUAWEI-bmp-session-10.1.1.1] connect-interface 10.1.1.1

connect-interface (BMP session view) (IPv6)

Function

The connect-interface command specifies a source interface to send BMP messages and a source IP address to set up a BMP session.

The undo connect-interface command restores the default configuration.

By default, no source interface is specified to send BMP messages.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

connect-interface { interface-name | ipv6-source-address | interface-type interface-number | interface-name ipv6-source-address | interface-type interface-number ipv6-source-address }

undo connect-interface { interface-name | ipv6-source-address | interface-type interface-number | interface-name ipv6-source-address | interface-type interface-number ipv6-source-address }

Parameters

Parameter Description Value
interface-name

Specifies an interface name.

-

ipv6-source-address

Specifies a source IPv6 address to set up a BMP session.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

interface-type

Specifies the type of an interface.

-

interface-number

Specifies the number of an interface.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

Views

BMP session view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BMP is used to monitor BGP running status of devices in real time, such as the status of BGP peer relationship establishment and termination and route updates.

After a TCP connection is established between a monitoring server and a device to be monitored, the device sends unsolicited BMP messages to the monitoring server to report BGP running statistics. After receiving these BMP messages, the monitoring server parses them and displays the BGP running status in the monitoring view. By analyzing the headers in the BMP messages, the monitoring server can determine from which BGP peer the routes carried in the messages were received. By default, the source interface used to send BMP messages is not specified after a TCP connection is established between a monitoring server and a device to be monitored. If the device encounters a failure, the source interface used to send BMP messages may change. In this case, the monitoring server cannot determine whether the new source interface belongs to a new device. To address this problem, run the connect-interface command to specify a source interface to send BMP messages.

The connect-interface command can be run in both the BMP view and BMP session view. If the command is run in both views, the configuration in the BMP session view takes precedence over that in the BMP view.

Precautions

If the connect-interface command is run more than once, the last configuration overrides the previous one.

In the BMP view, a source IPv4 address to set up a BMP session can be specified using the connect-interface command, whereas no source IPv6 address to set up a BMP session or source interface to send BMP messages can be specified. If the command is run in the BMP view, all IPv4 BMP sessions without a source IP address or source interface configured will be reestablished.

Example

# Specify a source IPv6 address to set up a BMP session.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 2001:DB8:1::1
[HUAWEI-bmp-session-2001:DB8:1::1] connect-interface 2001:DB8:1::1

connect-interface (BMP view)

Function

The connect-interface command specifies a source interface to send BMP messages and a source IP address to set up a BMP session.

The undo connect-interface command restores the default configuration.

By default, no source interface is specified to send BMP messages.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

connect-interface localIpv4Addr

undo connect-interface [ localIpv4Addr ]

Parameters

Parameter Description Value
localIpv4Addr

Specifies a source IPv4 address to set up a BMP session.

The value is in dotted decimal notation.

Views

BMP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BMP is used to monitor BGP running status of devices in real time, such as the status of BGP peer relationship establishment and termination and route updates.

After a TCP connection is established between a monitoring server and a device to be monitored, the device sends unsolicited BMP messages to the monitoring server to report BGP running statistics. After receiving these BMP messages, the monitoring server parses them and displays the BGP running status in the monitoring view. By analyzing the headers in the BMP messages, the monitoring server can determine from which BGP peer the routes carried in the messages were received. By default, the source interface used to send BMP messages is not specified after a TCP connection is established between a monitoring server and a device to be monitored. If the device encounters a failure, the source interface used to send BMP messages may change. In this case, the monitoring server cannot determine whether the new source interface belongs to a new device. To address this problem, run the connect-interface command to specify a source interface to send BMP messages.

The connect-interface command can be run in both the BMP view and BMP session view. If the command is run in both views, the configuration in the BMP session view takes precedence over that in the BMP view.

Precautions

If the connect-interface command is run more than once, the last configuration overrides the previous one.

In the BMP view, a source IPv4 address to set up a BMP session can be specified using the connect-interface command, whereas no source IPv6 address to set up a BMP session or source interface to send BMP messages can be specified. If the command is run in the BMP view, all IPv4 BMP sessions without a source IP address or source interface configured will be reestablished.

Example

# Specify a source IPv4 address to set up a BMP session.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] connect-interface 10.1.1.1

dampening (BGP multi-instance VPN instance IPv4 address family view)

Function

The dampening command enables route flapping dampening for EBGP peers or modifies route flapping dampening parameters for EBGP peers.

The undo dampening command cancels the dampening on the flapping of EBGP routes.

The dampening ibgp command enables IBGP peer route flapping dampening or modifies various IBGP peer route flapping dampening parameters.

The undo dampening ibgp command disables IBGP route flapping dampening.

By default, BGP route flapping suppression is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

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

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

undo dampening

undo dampening ibgp

Parameters

Parameter Description Value
half-life-reach

Specifies the half life of a reachable route.

The value is an integer ranging from 1 to 45, in minutes. The default value is 15.

reuse

Specifies a Reuse value. If the penalty value of a route falls below the Reuse value, the route is reused.

The value is an integer ranging from 1 to 20000. The default value is 750.

suppress

Specifies a Suppress value. If the penalty value of a route exceeds the Suppress value, the route is dampened.

The value is an integer ranging from 1 to 20000 and must be greater than the value of reuse. The default value is 2000.

ceiling

Specifies a penalty ceiling.

The value is an integer ranging from 1001 to 20000. The configured value must be greater than the value of suppress. The default value is 16000.

route-policy route-policy-name

Specifies the name of a route-policy.

The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

update-standard

Enables BGP to add a penalty value (500) to the route carried in each received Update message (excluding Withdraw message).

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a policy is configured for route dampening, routes are preferentially matched against the dampening parameters defined by route-policy in the command.

The four parameters of the command are mutually dependent. If you configure one of the parameters, the other parameters also need to be configured in the command.

BGP dampening measures route stability using a penalty value. The greater the penalty value, the less stable a route. Each time route flapping occurs (the device receives a Withdraw), BGP adds a penalty value to the route carried in the message. If a route changes from active to inactive, the penalty value increases by 1000.

If the penalty value of a route exceeds the Suppress value, the route is dampened. The device does not add the route to the IP routing table or advertise any Update message to other BGP peers. BGP removes the best flag of the route. If the route is carried in an Update message, BGP adds a d flag to the route; if the route is carried in a Withdraw message, BGP adds an h flag to the route. If a route carries both a d flag and an h flag, the route is considered a deleted one. After the penalty value reaches the penalty ceiling, it does not increase any more.

The penalty value of a dampened route reduces by half after a half-life period. If the route is carried in an Update message and its penalty value decreases to the Reuse value, the route becomes reusable, and BGP removes the d flag from it, adds it to the IP routing table if it is an optimal route, and advertises an Update message carrying the route to BGP peers. If the route is carried in a Withdraw message and its penalty value decreases to 0, BGP deletes this route from the BGP routing table.

After BGP route dampening is configured, any parameter in the command can be used to dampen flapping routes. You can adjust the parameters as required. To increase the dampening time of flapping routes, perform any of the following operations (to reduce the dampening time, perform otherwise):

  • Increase ceiling.
  • Increase half-life-reach.
  • Reduce reuse.

Configuration Impact

If the dampening command is run more than once, the latest configuration overrides the previous one.

After the dampening command is run, the system dampens unstable routes. Specifically, the system does not add unstable routes to the BGP routing table or advertise them to other BGP peers.

Precautions

Note the following items when configuring BGP route flap dampening:

  • The values of reuse, suppress, and ceiling are in ascending order.
  • According to the formula MaxSuppressTime=half-life-reach×60×(ln(ceiling/reuse)/ln(2)), if the value of MaxSuppressTime is smaller than 1, dampening cannot be performed. Therefore, the value of the ceiling/reuse must be great enough so that the value of MaxSuppressTime can be equal to or greater than 1.

Example

# Enable EBGP peer route dampening and configure EBGP peer route dampening parameters.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] dampening 10 1000 2000 5000
# Enable IBGP peer route dampening and configure IBGP peer route dampening parameters.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] dampening ibgp 10 1000 2000 5000

dampening (BGP view)

Function

The dampening command enabled route flapping dampening for EBGP peers or modifies route flapping dampening parameters for EBGP peers.

The undo dampening command cancels the dampening on the flapping of EBGP routes.

The dampening ibgp command enables IBGP peer route flapping dampening or modifies various IBGP peer route flapping dampening parameters.

The undo dampening ibgp command canceld the dampening on IBGP route flapping.

By default, BGP route flapping suppression is disabled.

Format

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

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

undo dampening

undo dampening ibgp

Parameters

Parameter Description Value
half-life-reach

Specifies the half-life of a reachable route.

The value is an integer ranging from 1 to 45, in minutes. The default value is 15.

reuse

Specifies a Reuse value. If the penalty of a route falls below the Reuse value, the route is reused.

The value is an integer ranging from 1 to 20000. The default value is 750.

suppress

Specifies a Suppress value. If the penalty value of the route exceeds the Suppress value, the route is dampened.

The value is an integer ranging from 1 to 20000, which must be greater than the value of reuse. The default value is 2000.

ceiling

Specifies a penalty ceiling.

The value is an integer ranging from 1001 to 20000. The configured value must be greater than that of suppress. The default value is 16000.

route-policy route-policy-name

Specifies the name of the route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

update-standard

Enables BGP to add a penalty value (500) to the route carried in each received Update message (excluding Withdraw message).

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a policy is configured for route dampening, routes are preferentially matched against the dampening parameters defined by route-policy in the command.

The four parameters of the command are mutually dependent. If you configure one of the parameters, the other parameters also need to be configured in the command.

BGP dampening measures route stability using a penalty value. The greater the penalty value, the less stable a route. Each time route flapping occurs (the device receives a Withdraw), BGP adds a penalty value to the route carried in the message. If a route changes from active to inactive, the penalty value increases by 1000.

If the penalty value of a route exceeds the Suppress value, the route is dampened. The device does not add the route to the IP routing table or advertise any Update message to other BGP peers. BGP removes the best flag of the route. If the route is carried in an Update message, BGP adds a d flag to the route; if the route is carried in a Withdraw message, BGP adds an h flag to the route. If a route carries both a d flag and an h flag, the route is considered a deleted one. After the penalty value reaches the penalty ceiling, it does not increase any more.

The penalty value of a dampened route reduces by half after a half-life period. If the route is carried in an Update message and its penalty value decreases to the Reuse value, the route becomes reusable, and BGP removes the d flag from it, adds it to the IP routing table if it is an optimal route, and advertises an Update message carrying the route to BGP peers. If the route is carried in a Withdraw message and its penalty value decreases to 0, BGP deletes this route from the BGP routing table.

After BGP route dampening is configured, any parameter in the command can be used to dampen flapping routes. You can adjust the parameters as required. To increase the dampening time of flapping routes, perform any of the following operations (to reduce the dampening time, perform otherwise):

  • Increase ceiling.
  • Increase half-life-reach.
  • Reduce reuse.

Configuration Impact

If the dampening command is run more than once, the latest configuration overrides the previous one.

After the dampening command is run, the system dampens unstable routes. Specifically, the system does not add unstable routes to the BGP routing table or advertise them to other BGP peers.

Precautions

Note the following items when configuring BGP route flap dampening:

  • The values of reuse, suppress, and ceiling are in ascending order.
  • According to the formula MaxSuppressTime=half-life-reach×60×(ln(ceiling/reuse)/ln(2)), if the value of MaxSuppressTime is smaller than 1, suppression cannot be performed. Therefore, the value of the ceiling/reuse must be great enough so that the value of MaxSuppressTime can be equal to or greater than 1.

Example

# Enable EBGP peer route dampening and configure EBGP peer route dampening parameters.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] dampening 10 1000 2000 5000
# Enable IBGP peer route dampening and configure IBGP peer route dampening parameters.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] dampening ibgp 10 1000 2000 5000

dampening (BGP-IPv4 unicast address family view)

Function

The dampening command enabled route flapping dampening for EBGP peers or modifies route flapping dampening parameters for EBGP peers.

The undo dampening command cancels the dampening on the flapping of EBGP routes.

The dampening ibgp command enables IBGP peer route flapping dampening or modifies various IBGP peer route flapping dampening parameters.

The undo dampening ibgp command disables IBGP route flapping dampening.

By default, BGP route flapping suppression is disabled.

Format

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

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

undo dampening

undo dampening ibgp

Parameters

Parameter Description Value
half-life-reach

Specifies the half-life of a reachable route.

The value is an integer ranging from 1 to 45, in minutes. The default value is 15.

reuse

Specifies a Reuse value. If the penalty of a route falls below the Reuse value, the route is reused.

The value is an integer ranging from 1 to 20000. The default value is 750.

suppress

Specifies a Suppress value. If the penalty value of the route exceeds the Suppress value, the route is dampened.

The value is an integer ranging from 1 to 20000, which must be greater than the value of reuse. The default value is 2000.

ceiling

Specifies a penalty ceiling.

The value is an integer ranging from 1001 to 20000. The configured value must be greater than that of suppress. The default value is 16000.

route-policy route-policy-name

Specifies the name of the route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

update-standard

Enables BGP to add a penalty value (500) to the route carried in each received Update message (excluding Withdraw message).

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a policy is configured for route dampening, routes are preferentially matched against the dampening parameters defined by route-policy in the command.

The four parameters of the command are mutually dependent. If you configure one of the parameters, the other parameters also need to be configured in the command.

BGP dampening measures route stability using a penalty value. The greater the penalty value, the less stable a route. Each time route flapping occurs (the device receives a Withdraw), BGP adds a penalty value to the route carried in the message. If a route changes from active to inactive, the penalty value increases by 1000.

If the penalty value of a route exceeds the Suppress value, the route is dampened. The device does not add the route to the IP routing table or advertise any Update message to other BGP peers. BGP removes the best flag of the route. If the route is carried in an Update message, BGP adds a d flag to the route; if the route is carried in a Withdraw message, BGP adds an h flag to the route. If a route carries both a d flag and an h flag, the route is considered a deleted one. After the penalty value reaches the penalty ceiling, it does not increase any more.

The penalty value of a dampened route reduces by half after a half-life period. If the route is carried in an Update message and its penalty value decreases to the Reuse value, the route becomes reusable, and BGP removes the d flag from it, adds it to the IP routing table if it is an optimal route, and advertises an Update message carrying the route to BGP peers. If the route is carried in a Withdraw message and its penalty value decreases to 0, BGP deletes this route from the BGP routing table.

After BGP route dampening is configured, any parameter in the command can be used to dampen flapping routes. You can adjust the parameters as required. To increase the dampening time of flapping routes, perform any of the following operations (to reduce the dampening time, perform otherwise):

  • Increase ceiling.
  • Increase half-life-reach.
  • Reduce reuse.

Configuration Impact

If the dampening command is run more than once, the latest configuration overrides the previous one.

After the dampening command is run, the system dampens unstable routes. Specifically, the system does not add unstable routes to the BGP routing table or advertise them to other BGP peers.

Precautions

Note the following items when configuring BGP route flap dampening:

  • The values of reuse, suppress, and ceiling are in ascending order.
  • According to the formula MaxSuppressTime=half-life-reach×60×(ln(ceiling/reuse)/ln(2)), if the value of MaxSuppressTime is smaller than 1, suppression cannot be performed. Therefore, the value of the ceiling/reuse must be great enough so that the value of MaxSuppressTime can be equal to or greater than 1.

Example

# Enable EBGP peer route dampening and configure EBGP peer route dampening parameters.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] dampening 10 1000 2000 5000
# Enable IBGP peer route dampening and configure IBGP peer route dampening parameters.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] dampening ibgp 10 1000 2000 5000

dampening (BGP-IPv6 unicast address family view)

Function

The dampening command enabled route flapping dampening for EBGP peers or modifies route flapping dampening parameters for EBGP peers.

The undo dampening command cancels the dampening on the flapping of EBGP routes.

The dampening ibgp command enables IBGP peer route flapping dampening or modifies various IBGP peer route flapping dampening parameters.

The undo dampening ibgp command disables IBGP route flapping dampening.

By default, BGP route flapping suppression is disabled.

Format

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

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

undo dampening

undo dampening ibgp

Parameters

Parameter Description Value
half-life-reach

Specifies a half-life for reachable routes.

The value is an integer ranging from 1 to 45, in minutes. The default value is 15.

reuse

Specifies a Reuse value. If the penalty value of a route falls below the Reuse value, the route is reused.

The value is an integer ranging from 1 to 20000. The default value is 750.

suppress

Specifies a Suppress value. If the penalty value of a route exceeds the Suppress value, the route is dampened.

The value is an integer ranging from 1 to 20000 and must be greater than the value of reuse. The default value is 2000.

ceiling

Specifies a penalty ceiling.

The value is an integer ranging from 1001 to 20000. The configured value must be greater than the value of suppress. The default value is 16000.

route-policy route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

update-standard

Enables BGP to add the standard penalty value to the route carried in each received Update message (excluding Withdraw message).

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a policy is configured for route dampening, routes are preferentially matched against the dampening parameters defined by route-policy in the command.

The four parameters of the command are mutually dependent. If you configure one of the parameters, the other parameters also need to be configured in the command.

BGP dampening measures route stability using a penalty value. The greater the penalty value, the less stable a route. Each time route flapping occurs (the device receives a Withdraw), BGP adds a penalty value to the route carried in the message. If a route changes from active to inactive, the penalty value increases by 1000.

If the penalty value of a route exceeds the Suppress value, the route is dampened. The device does not add the route to the IP routing table or advertise any Update message to other BGP peers. BGP removes the best flag of the route. If the route is carried in an Update message, BGP adds a d flag to the route; if the route is carried in a Withdraw message, BGP adds an h flag to the route. If a route carries both a d flag and an h flag, the route is considered a deleted one. After the penalty value reaches the penalty ceiling, it does not increase any more.

The penalty value of a dampened route reduces by half after a half-life period. If the route is carried in an Update message and its penalty value decreases to the Reuse value, the route becomes reusable, and BGP removes the d flag from it, adds it to the IP routing table if it is an optimal route, and advertises an Update message carrying the route to BGP peers. If the route is carried in a Withdraw message and its penalty value decreases to 0, BGP deletes this route from the BGP routing table.

After BGP route dampening is configured, any parameter in the command can be used to dampen flapping routes. You can adjust the parameters as required. To increase the dampening time of flapping routes, perform any of the following operations (to reduce the dampening time, perform otherwise):

  • Increase ceiling.
  • Increase half-life-reach.
  • Reduce reuse.

Configuration Impact

If the dampening command is run more than once, the latest configuration overrides the previous one.

After the dampening command is run, the system dampens unstable routes. Specifically, the system does not add unstable routes to the BGP routing table or advertise them to other BGP peers.

Precautions

Note the following items when configuring BGP route flap dampening:

  • The values of reuse, suppress, and ceiling are in ascending order.
  • According to the formula MaxSuppressTime=half-life-reach×60×(ln(ceiling/reuse)/ln(2)), if the value of MaxSuppressTime is smaller than 1, suppression cannot be performed. Therefore, the value of the ceiling/reuse must be great enough so that the value of MaxSuppressTime can be equal to or greater than 1.

Example

# Enable EBGP peer route dampening and configure EBGP peer route dampening parameters.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] dampening 10 1000 2000 5000
# Enable IBGP peer route dampening and configure IBGP peer route dampening parameters.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] dampening ibgp 10 1000 2000 5000

dampening (BGP-VPN instance IPv4 address family view)

Function

The dampening command enabled route flapping dampening for EBGP peers or modifies route flapping dampening parameters for EBGP peers.

The undo dampening command cancels the dampening on the flapping of EBGP routes.

The dampening ibgp command enables IBGP peer route flapping dampening or modifies various IBGP peer route flapping dampening parameters.

The undo dampening ibgp command disables IBGP route flapping dampening.

By default, BGP route flapping suppression is disabled.

Format

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

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

undo dampening

undo dampening ibgp

Parameters

Parameter Description Value
half-life-reach

Specifies the half-life of a reachable route.

The value is an integer ranging from 1 to 45, in minutes. The default value is 15.

reuse

Specifies a Reuse value. If the penalty of a route falls below the Reuse value, the route is reused.

The value is an integer ranging from 1 to 20000. The default value is 750.

suppress

Specifies a Suppress value. If the penalty value of the route exceeds the Suppress value, the route is dampened.

The value is an integer ranging from 1 to 20000, which must be greater than the value of reuse. The default value is 2000.

ceiling

Specifies a penalty ceiling.

The value is an integer ranging from 1001 to 20000. The configured value must be greater than that of suppress. The default value is 16000.

route-policy route-policy-name

Specifies the name of the route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

update-standard

Enables BGP to add a penalty value (500) to the route carried in each received Update message (excluding Withdraw message).

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a policy is configured for route dampening, routes are preferentially matched against the dampening parameters defined by route-policy in the command.

The four parameters of the command are mutually dependent. If you configure one of the parameters, the other parameters also need to be configured in the command.

BGP dampening measures route stability using a penalty value. The greater the penalty value, the less stable a route. Each time route flapping occurs (the device receives a Withdraw), BGP adds a penalty value to the route carried in the message. If a route changes from active to inactive, the penalty value increases by 1000.

If the penalty value of a route exceeds the Suppress value, the route is dampened. The device does not add the route to the IP routing table or advertise any Update message to other BGP peers. BGP removes the best flag of the route. If the route is carried in an Update message, BGP adds a d flag to the route; if the route is carried in a Withdraw message, BGP adds an h flag to the route. If a route carries both a d flag and an h flag, the route is considered a deleted one. After the penalty value reaches the penalty ceiling, it does not increase any more.

The penalty value of a dampened route reduces by half after a half-life period. If the route is carried in an Update message and its penalty value decreases to the Reuse value, the route becomes reusable, and BGP removes the d flag from it, adds it to the IP routing table if it is an optimal route, and advertises an Update message carrying the route to BGP peers. If the route is carried in a Withdraw message and its penalty value decreases to 0, BGP deletes this route from the BGP routing table.

After BGP route dampening is configured, any parameter in the command can be used to dampen flapping routes. You can adjust the parameters as required. To increase the dampening time of flapping routes, perform any of the following operations (to reduce the dampening time, perform otherwise):

  • Increase ceiling.
  • Increase half-life-reach.
  • Reduce reuse.

Configuration Impact

If the dampening command is run more than once, the latest configuration overrides the previous one.

After the dampening command is run, the system dampens unstable routes. Specifically, the system does not add unstable routes to the BGP routing table or advertise them to other BGP peers.

Precautions

Note the following items when configuring BGP route flap dampening:

  • The values of reuse, suppress, and ceiling are in ascending order.
  • According to the formula MaxSuppressTime=half-life-reach×60×(ln(ceiling/reuse)/ln(2)), if the value of MaxSuppressTime is smaller than 1, suppression cannot be performed. Therefore, the value of the ceiling/reuse must be great enough so that the value of MaxSuppressTime can be equal to or greater than 1.

Example

# Enable EBGP route dampening and set EBGP route dampening parameters in the VPN instance IPv4 address family view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] dampening 10 1000 2000 5000
# Enable IBGP route dampening and set IBGP route dampening parameters in the VPN instance IPv4 address family view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] dampening ibgp 10 1000 2000 5000

dampening (BGP-VPN instance IPv6 address family view)

Function

The dampening command enabled route flapping dampening for EBGP peers or modifies route flapping dampening parameters for EBGP peers.

The undo dampening command cancels the dampening on the flapping of EBGP routes.

The dampening ibgp command enables IBGP peer route flapping dampening or modifies various IBGP peer route flapping dampening parameters.

The undo dampening ibgp command disables IBGP route flapping dampening.

By default, BGP route flapping suppression is disabled.

Format

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

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

undo dampening

undo dampening ibgp

Parameters

Parameter Description Value
half-life-reach

Specifies the half-life of a reachable route.

The value is an integer ranging from 1 to 45, in minutes. The default value is 15.

reuse

Specifies a Reuse value. If the penalty of a route falls below the Reuse value, the route is reused.

The value is an integer ranging from 1 to 20000. The default value is 750.

suppress

Specifies a Suppress value. If the penalty value of the route exceeds the Suppress value, the route is dampened.

The value is an integer ranging from 1 to 20000, which must be greater than the value of reuse. The default value is 2000.

ceiling

Specifies a penalty ceiling.

The value is an integer ranging from 1001 to 20000. The configured value must be greater than that of suppress. The default value is 16000.

route-policy route-policy-name

Specifies the name of the route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

update-standard

Enables BGP to add a penalty value (500) to the route carried in each received Update message (excluding Withdraw message).

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a policy is configured for route dampening, routes are preferentially matched against the dampening parameters defined by route-policy in the command.

The four parameters of the command are mutually dependent. If you configure one of the parameters, the other parameters also need to be configured in the command.

BGP dampening measures route stability using a penalty value. The greater the penalty value, the less stable a route. Each time route flapping occurs (the device receives a Withdraw), BGP adds a penalty value to the route carried in the message. If a route changes from active to inactive, the penalty value increases by 1000.

If the penalty value of a route exceeds the Suppress value, the route is dampened. The device does not add the route to the IP routing table or advertise any Update message to other BGP peers. BGP removes the best flag of the route. If the route is carried in an Update message, BGP adds a d flag to the route; if the route is carried in a Withdraw message, BGP adds an h flag to the route. If a route carries both a d flag and an h flag, the route is considered a deleted one. After the penalty value reaches the penalty ceiling, it does not increase any more.

The penalty value of a dampened route reduces by half after a half-life period. If the route is carried in an Update message and its penalty value decreases to the Reuse value, the route becomes reusable, and BGP removes the d flag from it, adds it to the IP routing table if it is an optimal route, and advertises an Update message carrying the route to BGP peers. If the route is carried in a Withdraw message and its penalty value decreases to 0, BGP deletes this route from the BGP routing table.

After BGP route dampening is configured, any parameter in the command can be used to dampen flapping routes. You can adjust the parameters as required. To increase the dampening time of flapping routes, perform any of the following operations (to reduce the dampening time, perform otherwise):

  • Increase ceiling.
  • Increase half-life-reach.
  • Reduce reuse.

Configuration Impact

If the dampening command is run more than once, the latest configuration overrides the previous one.

After the dampening command is run, the system dampens unstable routes. Specifically, the system does not add unstable routes to the BGP routing table or advertise them to other BGP peers.

Precautions

Note the following items when configuring BGP route flap dampening:

  • The values of reuse, suppress, and ceiling are in ascending order.
  • According to the formula MaxSuppressTime=half-life-reach×60×(ln(ceiling/reuse)/ln(2)), if the value of MaxSuppressTime is smaller than 1, suppression cannot be performed. Therefore, the value of the ceiling/reuse must be great enough so that the value of MaxSuppressTime can be equal to or greater than 1.

Example

# Enable EBGP peer route dampening and configure EBGP peer route dampening parameters.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] dampening 10 1000 2000 5000
# Enable IBGP peer route dampening and configure IBGP peer route dampening parameters.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] dampening ibgp 10 1000 2000 5000

default ipv4-unicast

Function

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

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

By default, the IPv4 unicast address family is enabled.

Format

default ipv4-unicast

undo default ipv4-unicast

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

Configuration Impact

After the default ipv4-unicast command is run, the IPv4 unicast address family is enabled by default for created BGP peers.

Precautions

The default ipv4-unicast command cannot be delivered through YANG. When a BGP peer is created in YANG mode, the IPv4 unicast address family is not enabled by default. The configurations delivered in YANG mode are based on packets. When a peer is created, the unicast address family is enabled for the peer only when the YANG packet carries the subtable of the peer address family and the type of the IPv4 unicast address family is specified. The function that packets do not carry subtables does not take effect by default.

Example

# Disable the IPv4 unicast address family for all peers.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] undo default ipv4-unicast

default local-preference (BGP multi-instance VPN instance IPv4 address family view)

Function

The default local-preference command configures a Local_Pref for BGP routes.

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

By default, the Local_Pref of BGP routes is 100.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

default local-preference local-preference

undo default local-preference

Parameters

Parameter Description Value
local-preference

Specifies the local preference for BGP routes. The larger the value, the higher the priority.

The value is an integer ranging from 0 to 4294967295. The default value is 100.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The preference attribute is used to determine the optimal route when traffic leaves an AS. When a BGP device obtains multiple routes that have the same destination address but different next hops from IBGP peers, the route with the highest preference value is selected.

The default local-preference command is used to configure the default local preference of BGP. If the default local preference of BGP is required, the configuration takes effect. For example, if a route carries the Local_Pref attribute and does not require the default local preference of BGP, the route is not affected by the default local preference.

Configuration Impact

If the default local-preference command is run more than once, the latest configuration overrides the previous one.

Precautions

  1. The default local-preference command sets the default Local_Pref for all the routes (except reflected routes) advertised by the local device to all IBGP peers. The Local_Pref is valid only between IBGP peers and is not advertised to other ASs.
  2. In load balancing scenarios other than EIBGP load balancing, if routes do not carry the Local_Pref attribute, the value 0 rather than the default Local_Pref attribute configured on the local device is used during route selection for load balancing.

Example

# Set the Local_Pref for BGP routes to 200.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] default local-preference 200

default local-preference (BGP view)

Function

The default local-preference command configures a Local_Pref for BGP routes.

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

By default, the Local_Pref of BGP routes is 100.

Format

default local-preference local-preference

undo default local-preference

Parameters

Parameter Description Value
local-preference

Specifies the local preference for BGP routes. The larger the value, the higher the priority.

The value is an integer ranging from 0 to 4294967295. The default value is 100.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The preference attribute is used to determine the optimal route when traffic leaves an AS. When a BGP device obtains multiple routes that have the same destination address but different next hops from IBGP peers, the route with the highest preference value is selected.

The default local-preference command is used to configure the default local preference of BGP. If the default local preference of BGP is required, the configuration takes effect. For example, if a route carries the Local_Pref attribute and does not require the default local preference of BGP, the route is not affected by the default local preference.

Configuration Impact

If the default local-preference command is run more than once, the latest configuration overrides the previous one.

Precautions

  1. The default local-preference command sets the default Local_Pref for all the routes (except reflected routes) advertised by the local device to all IBGP peers. The Local_Pref is valid only between IBGP peers and is not advertised to other ASs.
  2. In load balancing scenarios other than EIBGP load balancing, if routes do not carry the Local_Pref attribute, the value 0 rather than the default Local_Pref attribute configured on the local device is used during route selection for load balancing.

Example

# Set the Local_Pref for BGP routes to 200.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] default local-preference 200

default local-preference (BGP-IPv4 unicast address family view)

Function

The default local-preference command configures a Local_Pref for BGP routes.

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

By default, the Local_Pref of BGP routes is 100.

Format

default local-preference local-preference

undo default local-preference

Parameters

Parameter Description Value
local-preference

Specifies the local preference for BGP routes. The larger the value, the higher the priority.

The value is an integer ranging from 0 to 4294967295. The default value is 100.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The preference attribute is used to determine the optimal route when traffic leaves an AS. When a BGP device obtains multiple routes that have the same destination address but different next hops from IBGP peers, the route with the highest preference value is selected.

The default local-preference command is used to configure the default local preference of BGP. If the default local preference of BGP is required, the configuration takes effect. For example, if a route carries the Local_Pref attribute and does not require the default local preference of BGP, the route is not affected by the default local preference.

Configuration Impact

If the default local-preference command is run more than once, the latest configuration overrides the previous one.

Precautions

  1. The default local-preference command sets the default Local_Pref for all the routes (except reflected routes) advertised by the local device to all IBGP peers. The Local_Pref is valid only between IBGP peers and is not advertised to other ASs.
  2. In load balancing scenarios other than EIBGP load balancing, if routes do not carry the Local_Pref attribute, the value 0 rather than the default Local_Pref attribute configured on the local device is used during route selection for load balancing.

Example

# Set the Local_Pref for BGP routes to 200.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] default local-preference 200

default local-preference (BGP-IPv6 unicast address family view)

Function

The default local-preference command configures a Local_Pref for BGP routes.

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

By default, the Local_Pref of BGP routes is 100.

Format

default local-preference local-preference

undo default local-preference

Parameters

Parameter Description Value
local-preference

Specifies the local preference for BGP routes. The larger the value, the higher the priority.

The value is an integer ranging from 0 to 4294967295. The default value is 100.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The preference attribute is used to determine the optimal route when traffic leaves an AS. When a BGP device obtains multiple routes that have the same destination address but different next hops from IBGP peers, the route with the highest preference value is selected.

The default local-preference command is used to configure the default local preference of BGP. If the default local preference of BGP is required, the configuration takes effect. For example, if a route carries the Local_Pref attribute and does not require the default local preference of BGP, the route is not affected by the default local preference.

Configuration Impact

If the default local-preference command is run more than once, the latest configuration overrides the previous one.

Precautions

  1. The default local-preference command sets the default Local_Pref for all the routes (except reflected routes) advertised by the local device to all IBGP peers. The Local_Pref is valid only between IBGP peers and is not advertised to other ASs.
  2. In load balancing scenarios other than EIBGP load balancing, if routes do not carry the Local_Pref attribute, the value 0 rather than the default Local_Pref attribute configured on the local device is used during route selection for load balancing.

Example

# Set the Local_Pref for BGP routes to 200.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] default local-preference 200

default local-preference (BGP-VPN instance IPv4 address family view)

Function

The default local-preference command configures a Local_Pref for BGP routes.

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

By default, the Local_Pref of BGP routes is 100.

Format

default local-preference local-preference

undo default local-preference

Parameters

Parameter Description Value
local-preference

Specifies the local preference for BGP routes. The larger the value, the higher the priority.

The value is an integer ranging from 0 to 4294967295. The default value is 100.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The preference attribute is used to determine the optimal route when traffic leaves an AS. When a BGP device obtains multiple routes that have the same destination address but different next hops from IBGP peers, the route with the highest preference value is selected.

The default local-preference command is used to configure the default local preference of BGP. If the default local preference of BGP is required, the configuration takes effect. For example, if a route carries the Local_Pref attribute and does not require the default local preference of BGP, the route is not affected by the default local preference.

Configuration Impact

If the default local-preference command is run more than once, the latest configuration overrides the previous one.

Precautions

  1. The default local-preference command sets the default Local_Pref for all the routes (except reflected routes) advertised by the local device to all IBGP peers. The Local_Pref is valid only between IBGP peers and is not advertised to other ASs.
  2. In load balancing scenarios other than EIBGP load balancing, if routes do not carry the Local_Pref attribute, the value 0 rather than the default Local_Pref attribute configured on the local device is used during route selection for load balancing.

Example

# Set the Local_Pref for BGP routes to 200.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-vpna] quit
[HUAWEI-bgp] ipv4-labeled-unicast vpn-instance vpna
[HUAWEI-bgp-labeled-vpna] default local-preference 200

default local-preference (BGP-VPN instance IPv6 address family view)

Function

The default local-preference command configures a Local_Pref for BGP routes.

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

By default, the Local_Pref of BGP routes is 100.

Format

default local-preference preference

undo default local-preference

Parameters

Parameter Description Value
preference

Specifies the local preference for BGP routes. The larger the value, the higher the priority.

The value is an integer ranging from 0 to 4294967295. The default value is 100.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The preference attribute is used to determine the optimal route when traffic leaves an AS. When a BGP device obtains multiple routes that have the same destination address but different next hops from IBGP peers, the route with the highest preference value is selected.

The default local-preference command is used to configure the default local preference of BGP. If the default local preference of BGP is required, the configuration takes effect. For example, if a route carries the Local_Pref attribute and does not require the default local preference of BGP, the route is not affected by the default local preference.

Configuration Impact

If the default local-preference command is run more than once, the latest configuration overrides the previous one.

Precautions

  1. The default local-preference command sets the default Local_Pref for all the routes (except reflected routes) advertised by the local device to all IBGP peers. The Local_Pref is valid only between IBGP peers and is not advertised to other ASs.
  2. In load balancing scenarios other than EIBGP load balancing, if routes do not carry the Local_Pref attribute, the value 0 rather than the default Local_Pref attribute configured on the local device is used during route selection for load balancing.

Example

# Set the Local_Pref for BGP routes to 200.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vrf1
[HUAWEI-vpn-instance-vrf1] ipv6-family
[HUAWEI-vpn-instance-vrf1-af-ipv6] quit
[HUAWEI-vpn-instance-vrf1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vrf1
[HUAWEI-bgp6-vrf1] default local-preference 200

default med (BGP multi-instance VPN instance IPv4 address family view)

Function

The default med command configures a MED for BGP routes.

The undo default med command restores the default value.

By default, the MED value of a route imported from OSPF is the cost value of the imported route plus one; for other imported routes, the MED values are their cost values; the MED value of a route learned from a peer is the MED value of the route sent by the peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

default med med

undo default med

Parameters

Parameter Description Value
med

Specifies the MED for BGP routes.

The value is an integer ranging from 0 to 4294967295.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The default med command applies only to the routes imported using the import-route command and BGP summary routes.

After the default med command is run, the BGP routes that the local device sends to its BGP peers carry the MED, which helps control route selection for the traffic entering the local AS. If the other attributes of routes to the same destination are the same, BGP selects the route with the smallest MED as the optimal route.

Configuration Impact

If more than one MED is configured for BGP routes, the latest configuration overrides the previous one.

Precautions

The MED attribute is transmitted only between two neighboring ASs. The AS that receives the MED attribute does not advertise it to a third AS.

Example

# Set the MED of BGP routes to 10.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] default med 10

default med (BGP view)

Function

The default med command configures a MED for BGP routes.

The undo default med command restores the default value.

By default, the MED value of an imported route equals the cost of the imported route; the MED value carried in a route learned.

Format

default med med

undo default med

Parameters

Parameter Description Value
med

Specifies the MED for BGP routes.

The value is an integer ranging from 0 to 4294967295.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The default med command applies only to the routes imported using the import-route command and BGP summary routes.

After the default med command is run, the BGP routes that the local device sends to its BGP peers carry the MED, which helps control route selection for the traffic entering the local AS. If the other attributes of routes to the same destination are the same, BGP selects the route with the smallest MED as the optimal route.

Configuration Impact

If more than one MED is configured for BGP routes, the latest configuration overrides the previous one.

Precautions

The MED attribute is transmitted only between two neighboring ASs. The AS that receives the MED attribute does not advertise it to a third AS.

Example

# Set the MED of BGP routes to 10.
<HUAWEI> system-view
[HUAWEI] bgp 1
[HUAWEI-bgp] default med 10

default med (BGP-IPv4 unicast address family view)

Function

The default med command configures a MED for BGP routes.

The undo default med command restores the default value.

By default, the MED value of an imported route equals the cost of the imported route; the MED value carried in a route learned.

Format

default med med

undo default med

Parameters

Parameter Description Value
med

Specifies the MED for BGP routes.

The value is an integer ranging from 0 to 4294967295.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The default med command applies only to the routes imported using the import-route command and BGP summary routes.

After the default med command is run, the BGP routes that the local device sends to its BGP peers carry the MED, which helps control route selection for the traffic entering the local AS. If the other attributes of routes to the same destination are the same, BGP selects the route with the smallest MED as the optimal route.

Configuration Impact

If more than one MED is configured for BGP routes, the latest configuration overrides the previous one.

Precautions

The MED attribute is transmitted only between two neighboring ASs. The AS that receives the MED attribute does not advertise it to a third AS.

Example

# Set the MED of BGP routes to 10.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] default med 10

default med (BGP-IPv6 unicast address family view)

Function

The default med command configures a MED for BGP routes.

The undo default med command restores the default value.

By default, the MED value of an imported route equals the cost of the imported route; the MED value carried in a route learned.

Format

default med med

undo default med

Parameters

Parameter Description Value
med

Specifies the MED for BGP routes.

The value is an integer ranging from 0 to 4294967295.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The default med command applies only to the routes imported using the import-route command and BGP summary routes.

After the default med command is run, the BGP routes that the local device sends to its BGP peers carry the MED, which helps control route selection for the traffic entering the local AS. If the other attributes of routes to the same destination are the same, BGP selects the route with the smallest MED as the optimal route.

Configuration Impact

If more than one MED is configured for BGP routes, the latest configuration overrides the previous one.

Precautions

The MED attribute is transmitted only between two neighboring ASs. The AS that receives the MED attribute does not advertise it to a third AS.

Example

# Set the MED of BGP routes to 10.
<HUAWEI> system-view
[HUAWEI] bgp 1
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] default med 10

default med (BGP-VPN instance IPv4 address family view)

Function

The default med command configures a MED for BGP routes.

The undo default med command restores the default value.

By default, the MED value of a route imported from OSPF is the cost value of the imported route plus one; for other imported routes, the MED value is the cost value of the imported route; the MED value of a route learned from a peer is the MED value of the route sent by the peer.

Format

default med med

undo default med

Parameters

Parameter Description Value
med

Specifies the MED for BGP routes.

The value is an integer ranging from 0 to 4294967295.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The default med command applies only to the routes imported using the import-route command and BGP summary routes.

After the default med command is run, the BGP routes that the local device sends to its BGP peers carry the MED, which helps control route selection for the traffic entering the local AS. If the other attributes of routes to the same destination are the same, BGP selects the route with the smallest MED as the optimal route.

Configuration Impact

If more than one MED is configured for BGP routes, the latest configuration overrides the previous one.

Precautions

The MED attribute is transmitted only between two neighboring ASs. The AS that receives the MED attribute does not advertise it to a third AS.

Example

# Set the MED of BGP routes to 10.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] default med 10

default med (BGP-VPN instance IPv6 address family view)

Function

The default med command configures a MED for BGP routes.

The undo default med command restores the default value.

By default, the MED value of a route imported from OSPF is the cost value of the imported route plus one; for other imported routes, the MED values are their cost values; the MED value of a route learned from a peer is the MED value of the route sent by the peer.

Format

default med med

undo default med

Parameters

Parameter Description Value
med

Specifies the MED for BGP routes.

The value is an integer ranging from 0 to 4294967295.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The default med command applies only to the routes imported using the import-route command and BGP summary routes.

After the default med command is run, the BGP routes that the local device sends to its BGP peers carry the MED, which helps control route selection for the traffic entering the local AS. If the other attributes of routes to the same destination are the same, BGP selects the route with the smallest MED as the optimal route.

Configuration Impact

If more than one MED is configured for BGP routes, the latest configuration overrides the previous one.

Precautions

The MED attribute is transmitted only between two neighboring ASs. The AS that receives the MED attribute does not advertise it to a third AS.

Example

# Set the MED of BGP routes to 10.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] default med 10

default-route imported (BGP multi-instance VPN instance IPv4 address family view)

Function

The default-route imported command imports default routes to the BGP routing table.

The undo default-route imported command restores the default configuration.

By default, default routes are not imported to the BGP routing table.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

default-route imported

undo default-route imported

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To import default routes to the BGP routing table, run the default-route imported command. After a default route of another routing protocol is added to the BGP routing table, packets can be transmitted over the default route when no matched route is available in the routing table, preventing packet loss.

Follow-up Procedure

When a device needs to advertise default routes to a peer or peer group and no default route exists in the local routing table, run the peer default-route-advertise command.

Precautions

The default-route imported command must be used together with the import-route command to import default routes. This is because only the import-route command cannot import default routes and the default-route imported command is used to import only the default routes that exist in the local routing table. In addition, you can run the network 0.0.0.0 command to import default routes.

Example

# Import default routes to the BGP routing table.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] default-route imported

default-route imported (BGP view)

Function

The default-route imported command imports default routes to the BGP routing table.

The undo default-route imported command restores the default configuration.

By default, default routes are not imported to the BGP routing table.

Format

default-route imported

undo default-route imported

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To import default routes to the BGP routing table, run the default-route imported command. After a default route of another routing protocol is added to the BGP routing table, packets can be transmitted over the default route when no matched route is available in the routing table, preventing packet loss.

Follow-up Procedure

When a device needs to advertise default routes to a peer or peer group and no default route exists in the local routing table, run the peer default-route-advertise command.

Precautions

The default-route imported command must be used together with the import-route command to import default routes. This is because only the import-route command cannot import default routes and the default-route imported command is used to import only the default routes that exist in the local routing table. In addition, you can run the network 0.0.0.0 command to import default routes.

Example

# Import default routes to the BGP routing table.
<HUAWEI> system-view
[HUAWEI] bgp 1
[HUAWEI-bgp] default-route imported
[HUAWEI-bgp] import-route ospf 1

default-route imported (BGP-IPv4 unicast address family view)

Function

The default-route imported command imports default routes to the BGP routing table.

The undo default-route imported command restores the default configuration.

By default, default routes are not imported to the BGP routing table.

Format

default-route imported

undo default-route imported

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To import default routes to the BGP routing table, run the default-route imported command. After a default route of another routing protocol is added to the BGP routing table, packets can be transmitted over the default route when no matched route is available in the routing table, preventing packet loss.

Follow-up Procedure

When a device needs to advertise default routes to a peer or peer group and no default route exists in the local routing table, run the peer default-route-advertise command.

Precautions

The default-route imported command must be used together with the import-route command to import default routes. This is because only the import-route command cannot import default routes and the default-route imported command is used to import only the default routes that exist in the local routing table. In addition, you can run the network 0.0.0.0 command to import default routes.

Example

# Import default routes to the BGP routing table.
<HUAWEI> system-view
[HUAWEI] bgp 1
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] default-route imported
[HUAWEI-bgp-af-ipv4] import-route ospf 1

default-route imported (BGP-IPv6 unicast address family view)

Function

The default-route imported command imports default routes to the BGP routing table.

The undo default-route imported command restores the default configuration.

By default, default routes are not imported to the BGP routing table.

Format

default-route imported

undo default-route imported

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To import default routes to the BGP routing table, run the default-route imported command. After a default route of another routing protocol is added to the BGP routing table, packets can be transmitted over the default route when no matched route is available in the routing table, preventing packet loss.

Follow-up Procedure

When a device needs to advertise default routes to a peer or peer group and no default route exists in the local routing table, run the peer default-route-advertise command.

Precautions

The default-route imported command must be used together with the import-route command to import default routes. This is because only the import-route command cannot import default routes and the default-route imported command is used to import only the default routes that exist in the local routing table. In addition, you can run the network 0.0.0.0 command to import default routes.

Example

# Import default routes to the BGP routing table.
<HUAWEI> system-view
[HUAWEI] bgp 1
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] default-route imported
[HUAWEI-bgp-af-ipv6] import-route ospf 1

default-route imported (BGP-VPN instance IPv4 address family view)

Function

The default-route imported command imports default routes to the BGP routing table.

The undo default-route imported command restores the default configuration.

By default, default routes are not imported to the BGP routing table.

Format

default-route imported

undo default-route imported

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To import default routes to the BGP routing table, run the default-route imported command. After a default route of another routing protocol is added to the BGP routing table, packets can be transmitted over the default route when no matched route is available in the routing table, preventing packet loss.

Follow-up Procedure

When a device needs to advertise default routes to a peer or peer group and no default route exists in the local routing table, run the peer default-route-advertise command.

Precautions

The default-route imported command must be used together with the import-route command to import default routes. This is because only the import-route command cannot import default routes and the default-route imported command is used to import only the default routes that exist in the local routing table. In addition, you can run the network 0.0.0.0 command to import default routes.

Example

# Import default routes to the BGP routing table.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] default-route imported
[HUAWEI-bgp-vpna] import-route ospf 1

default-route imported (BGP-VPN instance IPv6 address family view)

Function

The default-route imported command imports default routes to the BGP routing table.

The undo default-route imported command restores the default configuration.

By default, default routes are not imported to the BGP routing table.

Format

default-route imported

undo default-route imported

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To import default routes to the BGP routing table, run the default-route imported command. After a default route of another routing protocol is added to the BGP routing table, packets can be transmitted over the default route when no matched route is available in the routing table, preventing packet loss.

Follow-up Procedure

When a device needs to advertise default routes to a peer or peer group and no default route exists in the local routing table, run the peer default-route-advertise command.

Precautions

The default-route imported command must be used together with the import-route command to import default routes. This is because only the import-route command cannot import default routes and the default-route imported command is used to import only the default routes that exist in the local routing table. In addition, you can run the network 0.0.0.0 command to import default routes.

Example

# Import default routes to the BGP routing table.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] default-route imported
[HUAWEI-bgp-6-vpna] import-route ospf 1

deterministic-med (BGP multi-instance VPN instance IPv4 address family view)

Function

The deterministic-med command enables the BGP deterministic-MED function so that the route selection result is irrelevant to the sequence in which routes are received.

The undo deterministic-med command restores the default configuration.

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

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

deterministic-med

undo deterministic-med

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the deterministic-med command is not run, routes are compared in the sequence in which they are received. Therefore, the sequence in which routes are received is relevant to the result of route selection.

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

For details about this command, see Configuration > IP Routing > BGP Configuration > BGP Route Selection Rules > Route Attributes > MED.

Precautions

The bestroute add-path and deterministic-med commands are mutually exclusive. Do not run them together.

Example

# Enable the deterministic-MED function.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] deterministic-med

deterministic-med (BGP view)

Function

The deterministic-med command enables the BGP deterministic-MED function so that the route selection result is irrelevant to the sequence in which routes are received.

The undo deterministic-med command restores the default configuration.

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

Format

deterministic-med

undo deterministic-med

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the deterministic-med command is not run, routes are compared in the sequence in which they are received. Therefore, the sequence in which routes are received is relevant to the result of route selection.

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

For details about this command, see Configuration > IP Routing > BGP Configuration > BGP Route Selection Rules > Route Attributes > MED.

Precautions

The bestroute add-path and deterministic-med commands are mutually exclusive. Do not run them together.

Example

# Enable the deterministic-MED function.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] deterministic-med

deterministic-med (BGP-IPv4 unicast address family view)

Function

The deterministic-med command enables the BGP deterministic-MED function so that the route selection result is irrelevant to the sequence in which routes are received.

The undo deterministic-med command restores the default configuration.

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

Format

deterministic-med

undo deterministic-med

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the deterministic-med command is not run, routes are compared in the sequence in which they are received. Therefore, the sequence in which routes are received is relevant to the result of route selection.

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

For details about this command, see Configuration > IP Routing > BGP Configuration > BGP Route Selection Rules > Route Attributes > MED.

Precautions

The bestroute add-path and deterministic-med commands are mutually exclusive. Do not run them together.

Example

# Enable the deterministic-MED function.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] deterministic-med

deterministic-med (BGP-IPv6 unicast address family view)

Function

The deterministic-med command enables the BGP deterministic-MED function so that the route selection result is irrelevant to the sequence in which routes are received.

The undo deterministic-med command restores the default configuration.

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

Format

deterministic-med

undo deterministic-med

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the deterministic-med command is not run, routes are compared in the sequence in which they are received. Therefore, the sequence in which routes are received is relevant to the result of route selection.

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

For details about this command, see Configuration > IP Routing > BGP Configuration > BGP Route Selection Rules > Route Attributes > MED.

Precautions

The bestroute add-path and deterministic-med commands are mutually exclusive. Do not run them together.

Example

# Enable the deterministic-MED function.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] deterministic-med

deterministic-med (BGP-VPN instance IPv4 address family view)

Function

The deterministic-med command enables the BGP deterministic-MED function so that the route selection result is irrelevant to the sequence in which routes are received.

The undo deterministic-med command restores the default configuration.

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

Format

deterministic-med

undo deterministic-med

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the deterministic-med command is not run, routes are compared in the sequence in which they are received. Therefore, the sequence in which routes are received is relevant to the result of route selection.

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

For details about this command, see Configuration > IP Routing > BGP Configuration > BGP Route Selection Rules > Route Attributes > MED.

Precautions

The bestroute add-path and deterministic-med commands are mutually exclusive. Do not run them together.

Example

# Enable the deterministic-MED function.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] deterministic-med

deterministic-med (BGP-VPN instance IPv6 address family view)

Function

The deterministic-med command enables the BGP deterministic-MED function so that the route selection result is irrelevant to the sequence in which routes are received.

The undo deterministic-med command restores the default configuration.

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

Format

deterministic-med

undo deterministic-med

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the deterministic-med command is not run, routes are compared in the sequence in which they are received. Therefore, the sequence in which routes are received is relevant to the result of route selection.

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

For details about this command, see Configuration > IP Routing > BGP Configuration > BGP Route Selection Rules > Route Attributes > MED.

Precautions

The bestroute add-path and deterministic-med commands are mutually exclusive. Do not run them together.

Example

# Enable the deterministic-MED function.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] deterministic-med

display bgp all summary

Function

The display bgp all summary command displays information about BGP peers in the address family, including the peer status and route statistics.

Format

display bgp all summary

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

During fault location, you can run the display bgp all summary command to view information about BGP peers in the address family, including the peer status and route statistics. The supported address family depends on the actual device.

Precautions

If no peers exist in an address family view, information about the address family is not displayed in the command output.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about peers in all BGP address family views.
<HUAWEI> display bgp all summary
 
 BGP local router ID : 10.1.1.1
 Local AS number : 100

 Address Family:Ipv4 Unicast
 --------------------------------------------------------------------------------------------
 Total number of peers : 3                 Peers in established state : 2

  Peer                     AS  MsgRcvd  MsgSent  OutQ  Up/Down       State    RtRcv    RtAdv
  10.1.1.2                200     1842     1844     0 0026h40m Established        2        3
  10.2.1.1                100        0        0     0 0026h40m     Connect        0        0
  10.3.1.2                200     1837     1840     0 0026h40m Established        2        3
 Address Family:Ipv6 Unicast
 --------------------------------------------------------------------------------------------
 Total number of peers : 1                 Peers in established state : 0

  Peer                     AS  MsgRcvd  MsgSent  OutQ  Up/Down       State    RtRcv    RtAdv
  2001:DB8:1::1           200        0        0     0 0026h40m        Idle        0        0
 Address Family:Vpnv4 All
 --------------------------------------------------------------------------------------------
 Total number of peers : 4                 Peers in established state : 1

  Peer                     AS  MsgRcvd  MsgSent  OutQ  Up/Down       State    RtRcv    RtAdv
  10.2.1.1                100        0        0     0 0026h40m     Connect        0        0
   
  Peer of IPv4-family for vpn instance :
  VPN-Instance kkk, Router ID 10.1.1.1:
  Peer                     AS  MsgRcvd  MsgSent  OutQ  Up/Down       State    RtRcv    RtAdv
  10.4.1.2                200     1840     1830     0 0026h34m Established        3        0
  VPN-Instance vrf1, Router ID 10.1.1.1:
  Peer                     AS  MsgRcvd  MsgSent  OutQ  Up/Down       State    RtRcv    RtAdv
  10.2.3.4                100        0        0     0 0026h40m      Active        0        0
  VPN-Instance vrf2, Router ID 10.1.1.1:
  Peer                     AS  MsgRcvd  MsgSent  OutQ  Up/Down       State    RtRcv    RtAdv
  10.6.6.6                200        0        0     0 0026h40m        Idle        0        0
 Address Family:Vpnv6 All
 --------------------------------------------------------------------------------------------
 Total number of peers : 2                 Peers in established state : 0

  Peer                     AS  MsgRcvd  MsgSent  OutQ  Up/Down       State    RtRcv    RtAdv
  10.2.1.1                100        0        0     0 0026h40m     Connect        0        0
                
  Peer of IPv6-family for vpn instance :
  VPN-Instance vrf1, Router ID 10.1.1.1:
  Peer                     AS  MsgRcvd  MsgSent  OutQ  Up/Down       State    RtRcv    RtAdv
  2001:DB8:4::5           300        0        0     0 0026h40m        Idle        0        0
 Address Family:Ipv4 Mvpn
 --------------------------------------------------------------------------------------------
 Total number of peers : 1                 Peers in established state : 0

  Peer                     AS  MsgRcvd  MsgSent  OutQ  Up/Down       State    RtRcv    RtAdv
  10.2.1.1                100        0        0     0 0026h40m     Connect        0        0
Table 2-503 Description of the display bgp all summary command output
Item Description
BGP local router ID

ID of the local BGP device, in the same format as an IPv4 address.

Local AS number

Local AS number of the EVN BGP routes.

AS

AS number of the BGP peer.

Address Family

Address family in the view for BMP to monitor a specific peer.

  • Ipv4 Unicast: BGP-IPv4 unicast address family.
  • Ipv6 Unicast: BGP-IPv6 unicast address family.
  • vpnv4 All: BGP-VPNv4 address family.
  • vpnv6 All: BGP-VPNv6 address family.
  • Ipv4 Mvpn: BGP-MVPN address family.
Total number of peers

Number of BGP peers.

Peers in established state

Number of BGP peers in the Established state.

Peer

IP address of the BGP peer.

Peer of IPv4-family for vpn instance

Peers in the BGP-VPN instance IPv4 address family.

Peer of IPv6-family for vpn instance

Peers in the BGP-VPN instance IPv6 address family.

MsgRcvd

Statistics about messages received from peers. The received messages are defined in BGP, such as Update and Open messages.

MsgSent

Statistics about messages sent to the peer. The sent messages are defined in BGP, such as Update and Open messages.

OutQ

Number of route prefixes that have been packed and are waiting to be sent to the peer. The statistics cover the prefixes of updated and withdrawn routes.

Up/Down

Duration in which the BGP session remains in the current state.

State

State of BGP:

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

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

  • Connect: indicates that BGP is waiting for the TCP connection to be set up before it determines whether to perform other operations.
    1. If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.
    2. If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active.
    3. If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value, initiates a TCP connection request to the remote BGP peer, and stays in the Connect state.
  • Active: indicates that BGP tries to set up a TCP connection. This is the intermediate state of BGP.
    1. If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.
    2. If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value and changes its state to Connect.
    3. If BGP initiates a TCP connection request with an unknown IP address, the TCP connection fails. When this occurs, BGP restarts the ConnectRetry Timer with the initial value and stays in the Active state.
  • OpenSent: indicates that BGP has sent one Open message to its peer and is waiting for the other Open message from the peer.
    1. If there are no errors in the Open message received, BGP changes its state to OpenConfirm.
    2. If there are errors in the Open message received, BGP sends a Notification message to the remote peer and changes its state to Idle.
    3. If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active.
  • OpenConfirm: indicates that BGP is waiting for a Notification or Keepalive message.
    1. If BGP receives a Notification message, or the TCP connection fails, BGP changes its state to Idle.
    2. If BGP receives a Keepalive message, BGP changes its state to Established.
  • Established: indicates that BGP peers can exchange Update, Notification, and Keepalive messages.
    1. If BGP receives an Update or a Keepalive message, its state stays in Established.
    2. If BGP receives a Notification message, BGP changes its state to Idle.
  • No neg: The address family is not enabled for the BGP peer. In this state, Update messages can be exchanged in other address families whose capabilities have been successfully negotiated. If the address family is enabled for the BGP peer, the local BGP peer receives a Notification message, and the peer relationship is disconnected. Then, the BGP peer changes to the Idle state and re-establishes the peer relationship.
RtRcv

Statistics about route prefixes received from peers. The value indicates the number of Ribin routes of the peers, excluding the routes denied by a policy.

RtAdv

Statistics of route prefixes advertised to peers. The statistics increase when routes are advertised to peers for the first time and decrease when routes are withdrawn. The statistics are reset when the export policy of a peer changes or a slow peer is detected.

VPN-Instance kkk

VPN instance name.

Router ID

Router ID.

display bgp bfd session

Function

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

Format

For S6730-H-V2, S5732-H-V2:

display bgp [ instance instance-name ] bfd session all

display bgp [ instance instance-name ] bfd session peer ipv4-address

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

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp bfd session all

display bgp bfd session peer ipv4-address

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

Parameters

Parameter Description Value
peer ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

instance instance-name

Specifies the name of a BGP instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

all

Displays all BFD sessions established by BGP.

-

vpnv4

Indicates the BGP-VPNv4 address family.

-

vpn-instance vpn-instance-name

Displays information about BFD sessions of an IPv4 VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp bfd session command with different parameters specified displays different information.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about all BFD sessions established by EVN BGP.
<HUAWEI> display bgp bfd session all
--------------------------------------------------------------------------------
  Local_Address      Peer_Address       Interface
  10.1.12.2          10.1.12.1          10GE1/0/1
  Tx-interval(ms)    Rx-interval(ms)    Multiplier  Session-State         
     10           10           3       Up
  Wtr-interval(m) 
     0                           
--------------------------------------------------------------------------------
Table 2-504 Description of the display bgp bfd session command output
Item Description
Local_Address

Local IP address.

Peer_Address

Neighbor IP address.

Interface

Interface used to set up the BFD session.

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

Tx-interval(ms)

Interval at which BFD packets are sent, in milliseconds.

Rx-interval(ms)

Interval at which BFD packets are received, in milliseconds.

Multiplier

Remote detection multiplier.

Session-State

BFD status:

  • BFD global disable: BFD is globally disabled.
  • Up: The BFD session is in the Up state.
  • Down: The BFD session is in the Down state.
  • Unknown: When BFD fails to go Up for the first time, whether the link is faulty is unknown.
Wtr-interval(m)

WTR time of the BFD session, in minutes.

display bgp bmp-monitor

Function

The display bgp bmp-monitor command displays information about the BGP peers monitored by a BMP session in all address families or in a specified address family.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

display bgp bmp-monitor ipv4 { ipv4-address | ipv6-address }

display bgp bmp-monitor ipv6 ipv6-address

display bgp bmp-monitor vpnv4 vpn-instance vpn-instance-name ipv4-address

display bgp bmp-monitor vpnv6 vpn-instance vpn-instance-name ipv6-address

display bgp bmp-monitor all

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

ipv6-address

Specifies the IPv6 address of a BGP peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

ipv4

Displays information about BGP peers monitored by a BMP session in the IPv4 unicast address family.

-

ipv6

Displays information about BGP peers monitored by a BMP session in the IPv6 unicast address family.

-

vpnv4

Displays information about BGP peers monitored by a BMP session in the VPNv4 address family.

-

vpn-instance vpn-instance-name

Displays information about BGP peers monitored by a BMP session in the VPN instance address family.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

vpnv6

Displays information about BGP peers monitored by a BMP session in the VPNv6 address family.

-

all

Displays information about BGP peers monitored by a BMP session in all address families.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check information about the BGP peers monitored by a BMP session in all address families or in a specified address family, run the display bgp bmp-monitor command. The information includes the type of route reported to the monitoring server, IP address of the server with which a BMP session is established, BMP session alias, and BMP session status.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about BGP peers monitored by a BMP session in the IPv6 unicast address family.
<HUAWEI> display bgp bmp-monitor ipv6 10::1
*>BGP ipv6-family unicast :
  Peer                     Session Ip               Alias      State  route-mode
  10::1                 10::1                            down   in pre-policy/in post-policy
# Display information about BGP peers monitored by a BMP session in all address families.
<HUAWEI> display bgp bmp-monitor all

 0.0.0.0/:: : monitor public / private
 Route modes: a - add-path, A - all, m - path-marking, ID - route-identifier

*>BGP ipv4-family unicast :
  Peer            Session Ip      Alias      State   route-mode
  10.1.1.1        10.10.10.10                down    in post-policy
                  10.10.10.10                down    in pre-policy
  10.2.2.2        10.10.10.12                down    in pre-policy
  0.0.0.0         10.10.10.11                up      local-rib(A/m)
                  10.10.10.12                down    local-rib

*>BGP ipv6-family unicast :
  Peer            Session Ip      Alias      State    route-mode
  2001:DB8:2::2   10.10.10.13     a          down     in pre-policy
  0.0.0.0         10.10.10.12                down     local-rib(a)
                  10.10.10.13     a          down     local-rib
Table 2-505 Description of the display bgp bmp-monitor command output
Item Description
Peer

IP address of a monitored BGP peer.

Session Ip

IP address of the server with which a BMP session is established.

Alias

Alias of a BMP session. If no alias is specified, the field is empty.

State

Status of the BMP session:

  • down.
  • up.
route-mode

Type of route reported to the monitoring server:

  • in pre-policy: all received RIB-in routes.
  • in post-policy: RIB-in routes accepted by an import policy.
  • out pre-policy: all RIB-out routes, regardless of whether they match an export policy.
  • out post-policy: RIB-out routes that match an export policy.
  • local-rib: Local-RIB routes.
  • local-rib(a): Local-RIB Add-Path routes.
Route modes

BMP monitoring routing mode.

BGP ipv4-family unicast

BGP-IPv4 unicast address family.

BGP ipv6-family unicast

BGP-IPv6 unicast address family.

display bgp brief

Function

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

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv4 all brief

display bgp vpnv4 vpn-instance vpn-instance-name brief

For S6730-H-V2, S5732-H-V2:

display bgp instance instance-name vpnv4 all brief

display bgp instance instance-name vpnv4 vpn-instance vpn-instance-name brief

Parameters

Parameter Description Value
all

Displays information about all VPNv4 and VPN instances (IPv4 address family).

-

vpn-instance vpn-instance-name

Specify a VPN-Instance (VRF) name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

instance instance-name

Specifies a BGP instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check information about VPNv4 and VPN instances (IPv4 address family), run the display bgp vpnv4 brief command. The VPN instances are displayed and arranged alphabetically by name.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display brief information about VPNv4 instances and all VPN instances (IPv4 address family).
<HUAWEI> display bgp vpnv4 all brief

VPNV4 :
  Rd Num              Peer Num            Route Num
  0                   1                   0

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

BGP-VPNv4 address family.

Rd Num

Number of RDs.

Peer Num

Indicates the number of peers.

Route Num

Number of routes.

VPN-Instance Name

VPN instance name.

VPN-Instance(IPv4-family)

BGP-VPN instance IPv4 address family.

display bgp error discard

Function

The display bgp error discard command displays BGP errors.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

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

For S6730-H-V2, S5732-H-V2:

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

Parameters

Parameter Description Value
peer ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

vpn-instance vpn-instance-name

Displays the BGP errors of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

instance instance-name

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

When a BGP fault occurs, you can run this command to check BGP errors. BGP error information includes peer error information, route error information, and resource threshold-crossing error information.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about discarded BGP error packets.
<HUAWEI> display bgp error discard
BGP discard Info Counts: 
 Routes received with cluster ID loop            : 0
 Routes received with As path count over limit   : 0
 Routes advertised with As path count over limit : 0
 Routes received with As loop                    : 0
 Routes received with Zero RD(0:0)               : 0
 Routes received with no prefix                  : 0
 Routes received with error path-attribute       : 0
 Routes received with originator ID loop         : 0
 Routes received with total number over limit    : 0
 Routes received with error router id            : 0
 
BGP discard info:(IPv4 Unicast)
 Routes received with cluster ID loop            : 0
 Routes received with As path count over limit   : 0
 Routes advertised with As path count over limit : 0
 Routes received with As loop                    : 0
 Routes received with Zero RD(0:0)               : 0
 Routes received with error path-attribute       : 0
 Routes received with originator ID loop         : 0
 Routes received with total number over limit    : 0

No discard record.
Table 2-507 Description of the display bgp error discard command output
Item Description
BGP discard info

Number of routes discarded by BGP.

Routes received with cluster ID loop

Number of routes discarded due to duplicate cluster IDs.

Routes received with As loop

Number of routes discarded due to repeated AS numbers.

Routes received with Zero RD(0:0)

Number of routes discarded because the RD value is 0.

Routes received with no prefix

Number of routes discarded because there are no route prefixes.

Routes received with error path-attribute

Number of BGP routes with invalid attributes.

Routes received with originator ID loop

Total number of routes that carry the original ID.

Routes received with total number over limit

Total number of routes that are discarded because the number of routes exceeds the upper limit.

Routes received with error router id

Number of routes with incorrect router IDs and connection failures.

Routes received with As path count over limit

Number of received routes that are discarded because the number of AS_Paths exceeds the upper limit.

Routes advertised with As path count over limit

Number of sent routes discarded because the AS_Path exceeds the upper limit.

Record time

Record time.

Peer ID

IP address of a peer.

Reason

Reason why the packet is discarded.

Error data

Error information that is recorded.

display bgp graceful-restart status

Function

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

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

Format

For S6730-H-V2, S5732-H-V2:

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

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

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp graceful-restart status

display bgp local-graceful-restart status

Parameters

Parameter Description Value
instance instance-name

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check GR information on a BGP speaker, including whether GR is enabled and time parameters, run the display bgp graceful-restart status command.

To check information about local GR on a BGP speaker, including whether GR is enabled and time parameters, run the display bgp local-graceful-restart status command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about local GR on a BGP speaker.
<HUAWEI> display bgp local-graceful-restart status
-------------------------------------------------------
IPv4-UNC (_public_)
Peers:
   1.1.1.1
     Peer state: Active
     GR state: false
-------------------------------------------------------
IPv4-UNC (_public_)
Peers:
   10.1.1.1
     Peer state: Established
     GR state: false
# Display GR information on a BGP speaker.
<HUAWEI> display bgp graceful-restart status
  BGP protocol GR information: GR is configured
  GR timer configuration: 
    Restarter           : 150
    Wait-for-EOR        : 600
    Selection-deferral  : 600
    Wait-all-peer-up    : 120
    Protection          : 300
    Force-quit          : 3600
-------------------------------------------------------
IPv4-UNC (_public_)
Restarter Status                     : Init
Number of helpers                    : 1
Number of peers in established state : 1
Number of EORs expected from peer    : 0
Running timer(s) : 
  NO Running Timer!
 Peer information :(* - Dynamic Peer, R - Restarter, H - Helper, r - received, s - sent)
 Peer                               State   Role EOR  Running Timer(lefts)
 10.1.1.2                          UP      -    -    None
Table 2-508 Description of the display bgp graceful-restart status command output
Item Description
IPv4-UNC (_public_)

Public unicast address family.

Peer information

Peer information.

Peer state

Peer status:

  • Idle: indicates that BGP denies any connection request. This is the initial status of BGP.
  • Active: BGP tries to set up a TCP connection. This is the intermediate status of BGP.
  • Established: indicates that BGP peers can exchange Update, Notification, and Keepalive messages.
  • Connect: BGP is waiting for the TCP connection to be established before performing further actions.
  • OpenSent: BGP is waiting for an Open message from the peer.
  • OpenConfirm: BGP is waiting for a Notification message and a Keepalive message.
GR timer configuration

Value of the timer.

GR state

Status of the peer:

  • true: The peer is in the GR state.
  • false: The peer is not in the GR state.
BGP protocol GR information
  • "GR is configured" indicates that the GR capability of the BGP speaker is enabled.
  • "GR is NOT configured" indicates that the GR capability of the BGP speaker is not enabled.
Restarter

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

Restarter Status

Current status of the restarter:

  • Init: The device does not enter the GR state.
  • Connecting: indicates that BGP enters the GR state and waits for the peer to establish a connection.
  • Receiving: indicates that the route is received and the EOR flag is set.
  • Quering: Queries the next hop status.
  • Selecting: route selection status.
  • Distributing: distributing status.
  • Normal: indicates that the device exits the GR state.
Wait-for-EOR

Period during which a BGP speaker waits for the End-Of-RIB flag, in seconds.

Selection-deferral

Time for waiting for route selection delay, in seconds.

Wait-all-peer-up

Time for waiting for all peers to be re-established, in seconds.

Protection

Time taken to prevent all peers from being re-established, in seconds.

Force-quit

Time for forcibly exiting from GR, in seconds.

Number of helpers

Number of helpers.

Number of peers in established state

Number of peers that have established connections.

Number of EORs expected from peer

Number of peers that wait to receive EOR messages.

Running timer(s)

If the GR status is not entered, the message "NO Running Timer!" is displayed, it indicates that no timer is running,

Otherwise, the remaining time of the running timer is displayed.

Running Timer(lefts)

Remaining running time of the timer.

State

Status of the peers.

  • DOWN.
  • DOWN-GR.
  • UP.
Role

Peer role.

  • R Restarter.
  • H Helper.
EOR

Receiving and sending status of EOR.

  • r Received.
  • s sent.
Peers

Peers.

display bgp group

Function

The display bgp group command displays information about BGP peer groups, excluding the BGP unnumbered peer groups.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp group

display bgp vpnv4 all group [ group-name ]

display bgp group group-name

For S6730-H-V2, S5732-H-V2:

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

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

vpnv4

Displays information about BGP VPNv4 peer groups.

-

all

Displays information about all BGP VPNv4 peer groups.

-

instance instance-name

Specifies a BGP instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

The display bgp group command displays information about the peer group, including peers in the peer group and configuration information about the peer group. This command is used in the following scenarios:

  • Run the group command to configure the peer group and check whether the configuration is successful.
  • Run the peer group command to add a peer to a peer group and check whether the configuration is successful.
  • After running the undo peer group command to delete a peer, check whether the peer is successfully deleted.
  • After modifying the configuration of the peer group, check whether the modification is successful.

Precautions

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

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about all BGP VPNv4 peer groups.
<HUAWEI> display bgp vpnv4 all group
Group in VPNV4:
 
 BGP peer-group           : aa
 Remote AS number isn't specified
 Type : external
 PeerSession Members      :
   3.3.3.3
 
 Peer Members:
   3.3.3.3
 ***********************

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

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

 Peer Members:
   2.2.2.1
# Display information about the BGP VPNv4 peer group named rr1.
<HUAWEI> display bgp vpnv4 all group rr1
Group in VPNV4:
 No such a peer-group 

Group in VPN-Instance:

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

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

 Peer Preferred Value       : 0
 No routing policy is configured
 Peer Members:
  No Peer Exists
# Display information about the peer group named my-peer.
<HUAWEI> display bgp group my-peer
BGP peer-group                : my-peer
 Remote AS                     : 200
 Authentication type configured: None
 Group's BFD has been enabled
 Type                          : internal
 Maximum allowed route limit   : 150000
 Threshold                     : 75%
 Configured hold timer value   : 180
 Keepalive timer value         : 60
 Minimum route advertisement interval is 15 seconds
 listen-only has been configured
 TCP-MSS configured value      : 200
 PeerSession Members:
   2.2.2.2
 Send best-external has been configured
 Peer Preferred Value          : 0
 No routing policy is configured
 Peer Members:
  Peer             V    AS  MsgRcvd  MsgSent  OutQ  Up/Down       State PrefRcv
  2.2.2.2          4   200        0        0     0 00:00:47      Active       0
# Display information about the dynamic EBGP peer group named dyn-peer.
<HUAWEI> display bgp group dyn-peer

 BGP peer-group                : dyn-peer
 Remote AS                     : Dynamic
 Authentication type configured: None
 Type                          : listen external
 Configured hold timer value   : 180
 Keepalive timer value         : 60
 Connect-retry timer value     : 32
 Minimum route advertisement interval is 30 seconds
 PeerSession Members:
  NONE
  
 Peer Preferred Value          : 0
 No routing policy is configured
 Peer Members:
 Info: No peer exists.
Table 2-509 Description of the display bgp group command output
Item Description
Group in VPNV4

All BGP peer groups in the VPNv4 address family view.

Group in VPN-Instance

Peer groups in a VPN instance.

BGP peer-group

Name of a BGP peer group.

Remote AS

Number of the AS where the peer group resides.

  • Dynamic: The peer group is a dynamic EBGP peer group configured with an AS number.
  • Specific value: This field is displayed when the peer group is an IBGP peer group or a static EBGP peer group configured with an AS number.
Remote AS number isn't specified

This information is displayed when the peer group is an EBGP peer group with no AS number configured.

AS

Number of the AS where a peer group member resides.

Type

Types of the peer group:

  • internal: The type of the peer group is IBGP.
  • external: indicates that the type of the peer group is EBGP.
  • listen internal: indicates that the peer group is a dynamic IBGP peer group.
  • listen external: indicates that the peer group is a dynamic EBGP peer group.
  • listen confederation-external: indicates that the peer group is a dynamic confederation EBGP peer group.
PeerSession Members

A member that has established a session connection with a peer.

Peer Preferred Value

Preferred value of the BGP peer.

Peer Members

The following information is about peers.

Peer

Peer IP address.

VPN-Instance

VPN instance name.

Configured hold timer value

Hold time.

Keepalive timer value

Value of the Keepalive time.

Minimum route advertisement interval

Minimum interval at which routes are advertised:

Authentication type configured

BGP authentication type: The options are as follows:

  • MD5.
  • None: No BGP authentication is configured.
Maximum allowed route limit

Maximum number of allowed BGP routes.

listen-only has been configured

The device listens to connection requests but does not initiate connection requests.

TCP-MSS configured value

TCP MSS value used for setting up the TCP connection with the peer group.

Send best-external has been configured

The local device has been enabled to advertise Best External routes to a specified peer group.

V

BGP version number.

MsgRcvd

BGP version of a peer.

MsgSent

Number of messages sent.

OutQ

Number of messages to be sent to neighbors.

Up/Down

Duration in which the BGP session remains in the current state.

State

BGP state:

  • Idle: BGP denies any connection request. This is the initial status of BGP.
  • Active: BGP attempts to establish a TCP connection. This is the intermediate state of BGP.
  • Established: BGP peers can exchange Update, Notification, and Keepalive messages.
  • Connect: BGP is waiting for the TCP connection to be established before performing subsequent operations.
  • OpenSent: BGP is waiting for an Open message from the peer.
  • OpenConfirm: BGP waits for a Notification or Keepalive message.
PrefRcv

Number of route prefixes sent from the peer.

Threshold

Alarm threshold, that is, the percentage of the number of BGP routes to the maximum number of routes that can be received.

display bgp instance vpnv4 routing-table large-community

Function

The display bgp instance vpnv4 routing-table large-community command displays information about BGP VPNv4 routes matched with large communities.

The display bgp instance vpnv4 routing-table statistics large-community command displays statistics about BGP VPNv4 routes matched with large communities.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table large-community [ aa:bb:cc ] &<1-33>

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics large-community [ aa:bb:cc ] &<1-33>

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table large-community [ aa:bb:cc ] &<1-33> whole-match

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics large-community [ aa:bb:cc ] &<1-33> whole-match

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table large-community-filter large-community-filter-name

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics large-community-filter large-community-filter-name

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table large-community-filter large-community-filter-name whole-match

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics large-community-filter large-community-filter-name whole-match

Parameters

Parameter Description Value
route-distinguisher route-distinguisher

Displays statistics about the BGP routes with a specified RD.

The value is a string of 3 to 21 case-sensitive characters, spaces not supported.

large-community aa:bb:cc

Specifies a value of the Large-Community attribute.

The value is a string of 5 to 32 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

instance instance-name

Specifies a BGP instance.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

statistics

Displays statistics about routes advertised to or received from a specified peer.

-

whole-match

Indicates exact matching.

-

large-community-filter large-community-filter-name

Displays detailed configurations of a Large-Community filter with a specified name.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp instance vpnv4 routing-table large-community command displays information about BGP VPNv4 routes matched with large communities.

The display bgp instance vpnv4 routing-table statistics large-community command displays statistics about BGP VPNv4 routes matched with large communities.

Precautions

If a routing loop occurs, some routes may have not converged when you run the display bgp ipv6 routing-table statistics command. Therefore, the route statistics displayed using the command may be different from the actual number.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP routes with large-community attributes.
<HUAWEI> display bgp instance a vpnv4 route-distinguisher 11:11 routing-table large-community
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Route Distinguisher: 11:11

 Total Number of Routes: 3
        Network            NextHop                       MED        LocPrf    PrefVal LargeCommunity

 *>     1.1.1.11/32        127.0.0.1                      0                     0      <1:1:1>
 *>     2.2.2.22/32        10.3.123.2                     0                     0      <1:1:1>, <2:2:2>
 *>     3.3.3.33/32        10.3.123.3                     0                     0      <1:1:1>, <3:3:3>
    
 VPN-Instance vpna, Router ID 10.1.123.1:

 Total Number of Routes: 3
        Network            NextHop                       MED        LocPrf    PrefVal LargeCommunity

 *>     1.1.1.11/32        0.0.0.0                        0                     0      <1:1:1>
 *>     2.2.2.22/32        10.3.123.2                     0                     0      <1:1:1>, <2:2:2>
 *>     3.3.3.33/32        10.3.123.3                     0                     0      <1:1:1>, <3:3:3>
Table 2-510 Description of the display bgp instance vpnv4 routing-table large-community command output
Item Description
LargeCommunity

Large-community attribute of a route.

display bgp instance vpnv6 routing-table statistics

Function

The display bgp instance vpnv6 routing-table statistics command displays statistics about BGP multi-instance VPNv6 routes that are filtered based on specified attributes.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics community-filter { community-filter-num | community-filter-numEx | community-filter-name }

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics community-filter { community-filter-num | community-filter-name } whole-match

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33>

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> whole-match

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics regular-expression strRegular

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics

display bgp instance bgpName vpnv6 { route-distinguisher strRd | all | vpn-instance vpn-instance-name } routing-table statistics different-origin-as

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics label

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics extcommunity [ { rt | soo } strExtCommunity ] &<1-33>

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics extcommunity [ { rt | soo } strExtCommunity ] &<1-33> match-any

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics extcommunity-filter { basic-extcomm-flt-num | adv-extcomm-flt-num | extcommunity-filter-name }

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics large-community-filter largeComFilName

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics large-community-filter largeComFilName whole-match

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics large-community [ largeCommuStr ] &<1-33>

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table statistics large-community [ largeCommuStr ] &<1-33> whole-match

display bgp instance bgpName vpnv6 { route-distinguisher strRd | all | vpn-instance vpn-instance-name } routing-table statistics { active | best }

Parameters

Parameter Description Value
route-distinguisher strRd

X.X.X.X:number or number:number or number.number:number.

The value is a string of 3 to 21 case-sensitive characters, spaces not supported.

community-filter community-filter-num

Specifies the number of a basic community filter.

The value is an integer ranging from 1 to 99.

community-filter community-filter-numEx

Specifies the number of an advanced community filter.

The value is an integer ranging from 100 to 199.

community-filter community-filter-name

Specifies the name of a community filter.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

instance bgpName

Specifies the BGP multi-instance name.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

whole-match

Indicates exact matching.

-

community communityNum

Specifies a community number.

The value is an integer ranging from 0 to 4294967295.

community strCommunityNum

Specifies a community number.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

internet

Displays the BGP public network routes carrying the internet community attribute.

-

no-advertise

Displays the BGP routes carrying the No-Advertise community attribute.

-

no-export

Displays the BGP public network routes carrying the No-Export community attribute.

-

no-export-subconfed

Displays the BGP routes carrying the No-Export-Subconfed community attribute.

-

g-shut

Display routes with the Grateful-Shutdown community attribute.

-

as-path-filter as-path-filter-num

Specifies an AS_Path filter index.

The value is a decimal integer ranging from 1 to 256.

as-path-filter as-path-filter-name

AS path filter name (the name is a string of 1 to 51 characters, which cannot contain only numbers.).

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

regular-expression strRegular

Displays the routes that match the regular expression.

The value is a string of 1 to 80 characters.

all

Display all information on VPNv6 and IPv6 VPN instance.

-

vpn-instance vpn-instance-name

Specify a VPN-Instance (VRF) name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

different-origin-as

Displays the routes with the same destination address and mask but different origin AS numbers.

-

label

Labeled route information.

-

extcommunity

Specifies the excommunity value. IP<X.X.X.X>:NN<0-65535> or AS<0-65535>:NN<0-4294967295> or AS<65536-4294967295>:NN<0-65535> or AS<0-65535>.<0-65535>:NN<0-65535>.

-

rt

Displays information about routes with a specified RT.

-

soo

Displays information about IPv4 routes with the source of origin (SoO) extended community attribute.

-

strExtCommunity

Specifies the excommunity value. IP<X.X.X.X>:NN<0-65535> or AS<0-65535>:NN<0-4294967295> or AS<65536-4294967295>:NN<0-65535> or AS<0-65535>.<0-65535>:NN<0-65535>.

The attribute is a BGP extended community attribute and can be expressed in any of the following formats:

  • 2-byte AS number:4-byte user-defined number, for example, 1:3. The AS number ranges from 0 to 65535, and the user-defined number ranges from 0 to 4294967295. The AS number and user-defined number cannot both be set to 0. Specifically, the value of the SoO attribute cannot be 0:0.
  • IPv4-address:2-byte user-defined number, for example, 192.168.122.15:1. The IP address ranges from 0.0.0.0 to 255.255.255.255, and the user-defined number ranges from 0 to 65535.
  • Integral 4-byte AS number:2-byte user-defined number, for example, 0:3 or 65537:3. An AS number ranges from 65536 to 4294967295. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. Specifically, the value of the SoO attribute cannot be 0:0.
  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. Specifically, the value of the SoO attribute cannot be 0.0:0.
match-any

Displays information about routes with any of the specified extended community attributes.

-

extcommunity-filter basic-extcomm-flt-num

Specifies the number of an extcommunity filter.

The value is an integer ranging from 1 to 199.

extcommunity-filter adv-extcomm-flt-num

Specifies the number of an advanced extcommunity filter.

The value is an integer ranging from 200 to 399.

extcommunity-filter extcommunity-filter-name

Specifies the name of an extcommunity filter.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

large-community-filter largeComFilName

large Community filter name (the name is a string of 1 to 51 characters, which cannot contain only numbers.).

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

large-community largeCommuStr

Specifies a value of the Large-Community attribute.

The value is in the format of a:b:c. The values of a, b, and c are integers ranging from 0 to 4294967295.

active

Displays the active routes.

-

best

Displays Best, add-path, and best-external routes.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To view BGP multi-instance VPNv6 route statistics based on specified attributes, run the display bgp instance vpnv6 routing-table statistics command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about BGP multi-instance VPNv6 routes carrying community attributes.
<HUAWEI> display bgp instance a vpnv6 route-distinguisher 11:11 routing-table statistics extcommunity
 
 Route Distinguisher: 11:11

 Total Number of Routes: 3

 VPN-Instance lzy, Router ID 10.1.123.1:
 Total Number of Routes: 3
Table 2-511 Description of the display bgp instance vpnv6 routing-table statistics command output
Item Description
Route Distinguisher

Route distinguisher of the EVN BGP routes.

Total Number of Routes

Total number of routes.

display bgp instance vpnv6 vpn-instance peer statistics

Function

The display bgp instance vpnv6 vpn-instance peer statistics command displays route statistics of a specified peer in the BGP multi-instance VPN instance IPv6 address family.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

display bgp instance bgpName vpnv6 vpn-instance vpn-instance-name peer peerIpv6Addr statistics

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

peerIpv6Addr

Specifies an IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

instance bgpName

Specifies a BGP instance name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp instance vpnv6 vpn-instance peer statistics command displays route statistics of a specified peer in the BGP multi-instance VPN instance IPv6 address family.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display route statistics of a specified BGP multi-instance peer.
<HUAWEI> display bgp instance a vpnv6 vpn-instance vrf2 peer 2001:db8:1::1 statistics

Peer 2001:db8:1::1, IPv6 Unicast
   Number of prefixes rejected by inbound policy         : 0
   Number of (known) duplicate prefix advertisements     : 0
   Number of (known) duplicate withdraws                 : 0
   Number of updates invalidated due to CLUSTER_LIST loop: 0
   Number of updates invalidated due to AS_PATH loop     : 0
   Number of updates invalidated due to ORIGINATOR_ID    : 0
   Number of updates invalidated due to AS_CONFED loop   : 0
   Number of routes in Adj-RIBs-In (pre-policy)          : 0
   Number of routes in Adj-RIBs-In (post-policy)         : 1
   Number of best routes in Loc-RIB                      : 1
Table 2-512 Description of the display bgp instance vpnv6 vpn-instance peer statistics command output
Item Description
Number of prefixes rejected by inbound policy

Number of routes that are filtered out by the import policy.

Number of (known) duplicate prefix advertisements

Number of times that a route is re-advertised.

Number of (known) duplicate withdraws

Number of times that a route is re-deleted.

Number of updates invalidated due to CLUSTER_LIST loop

Number of routes that are invalid because the local Cluster_ID exists in the Cluster_List.

Number of updates invalidated due to AS_PATH loop

Number of routes that are invalid because the local AS number exists in the AS_Path list.

Number of updates invalidated due to ORIGINATOR_ID

Number of routes that are invalid because their Originator_IDs are the same as the local router ID.

Number of updates invalidated due to AS_CONFED loop

Number of routes that are invalid because their AS_Path lists contain the AS number of the local confederation.

Number of routes in Adj-RIBs-In (pre-policy)

Number of all received routes.

Number of routes in Adj-RIBs-In (post-policy)

Number of routes that match the import policy.

Number of best routes in Loc-RIB

Total number of optimal routes in the routing table.

display bgp instance vpnv6 vpn-instance routing-table peer statistics

Function

The display bgp instance vpnv6 vpn-instance routing-table peer advertised-routes statistics command displays statistics about routes advertised to a specified peer in the BGP multi-instance VPN instance IPv6 address family.

The display bgp instance vpnv6 vpn-instance routing-table peer received-routes statistics command displays statistics about routes received from a specified peer in the BGP multi-instance VPN instance IPv6 address family.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

display bgp instance bgpName vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr advertised-routes statistics

display bgp instance bgpName vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr received-routes [ active ] statistics

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Specify a VPN-Instance (VRF) name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

remoteIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

instance bgpName

Specifies the BGP multi-instance name.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

active

Displays the active routes learned from a specified peer.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp instance vpnv6 vpn-instance routing-table peer advertised-routes statistics command displays statistics about routes advertised to a specified peer in the BGP multi-instance VPN instance IPv6 address family.

The display bgp instance vpnv6 vpn-instance routing-table peer received-routes statistics command displays statistics about routes received from a specified peer in the BGP multi-instance VPN instance IPv6 address family.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about BGP multi-instance VPNv6 routes advertised to a specified peer.
<HUAWEI> display bgp instance a vpnv6 vpn-instance  vrf2 routing-table peer 2001:db8:1::1 advertised-routes statistics

 Advertised routes total: 2
 
 Default originated : 0
# Display statistics about BGP multi-instance VPNv6 routes received from a specified peer.
<HUAWEI> display bgp instance a vpnv6 vpn-instance  vrf2 routing-table peer 2001:db8:1::1 received-routes statistics

 Received routes total: 1
Table 2-513 Description of the display bgp instance vpnv6 vpn-instance routing-table peer statistics command output
Item Description
Advertised routes total

Total number of advertised routes.

Default originated

Total number of Default originated.

Received routes total

Total number of received routes.

display bgp instance vpnv6 vpn-instance routing-table time-range

Function

The display bgp instance vpnv6 routing-table time-range command displays information about BGP VPNv6 routes that flap within a specified time range.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

display bgp instance bgpName vpnv6 vpn-instance vpn-instance-name routing-table [ peer remoteIpv6Addr { received-routes | advertised-routes } ] time-range time-range-start time-range-end

display bgp instance bgpName vpnv6 all routing-table time-range time-range-start time-range-end

display bgp instance bgpName vpnv6 route-distinguisher strRd routing-table time-range time-range-start time-range-end

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Specify a VPN-Instance (VRF) name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

peer remoteIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

received-routes

Displays information about the routes received from the specified peer.

-

advertised-routes

Routes advertised to the remote peer.

-

time-range-start

Specifies the start time.

The formats of time-range-start and time-range-end both are xxdxxhxxmxxs.

The d indicates days. The value is an integer ranging from 0 to 10000.

The h indicates hours. The value is an integer ranging from 0 to 23.

The m indicates minutes. The value is an integer ranging from 0 to 59.

The s indicates seconds. The value is an integer ranging from 0 to 59.

time-range-end

Specifies the time that the device stopped to record the information.

The formats of time-range-start and time-range-end both are xxdxxhxxmxxs.

The d indicates days. The value is an integer ranging from 0 to 10000.

The h indicates hours. The value is an integer ranging from 0 to 23.

The m indicates minutes. The value is an integer ranging from 0 to 59.

The s indicates seconds. The value is an integer ranging from 0 to 59.

instance bgpName

Specifies the BGP multi-instance name.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

all

Display all information on VPNv6 and IPv6 VPN instance.

-

route-distinguisher strRd

X.X.X.X:number or number:number or number.number:number.

The value is a string of 3 to 21 case-sensitive characters, spaces not supported.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

You can specify different parameters to view specific BGP multi-instance VPNv6 routes.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about BGP VPNv6 routes that flap within a specified time range.
<HUAWEI> display  bgp instance a vpnv6 all  routing-table time-range 0d1h1m1s 2d1h1m1s
 
 BGP Local router ID is 10.1.1.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete

 Route Distinguisher: 2:3

 *>     Network  : 2001:db8:1::1                            PrefixLen : 128 
        NextHop  : ::                                       Duration  : 1d01h17m02s
        Peer     : 10.1.1.2                                  
        Path/Ogn :  ?
 *>     Network  : 2001:db8:1::2                            PrefixLen : 128 
        NextHop  : ::                                       Duration  : 1d01h17m02s
        Peer     : 10.1.1.3                                  
        Path/Ogn :  ?
 *>     Network  : 2001:db8:1::3                            PrefixLen : 128 
        NextHop  : 2001:db8:1::10                           Duration  : 1d01h16m12s
        Peer     : 10.1.1.3                                  
        Path/Ogn : 200?
    
 VPN-Instance vrf1, Router ID 10.2.1.1:
 *>     Network  : 2001:db8:1::4                            PrefixLen : 128 
        NextHop  : ::                                       Duration  : 1d01h17m03s
        Peer     : ::                                       
        Path/Ogn :  ?
 *>     Network  : 2001:db8:1::5                            PrefixLen : 128 
        NextHop  : ::                                       Duration  : 1d01h17m03s
        Peer     : ::                                       
        Path/Ogn :  ?
 *>     Network  : 2001:db8:1::6                            PrefixLen : 128 
        NextHop  : 2001:db8:1::50                           Duration  : 1d01h16m13s
        Peer     : 10.1.1.4                                     
        Path/Ogn : 200?
Table 2-514 Description of the display bgp instance vpnv6 vpn-instance routing-table time-range command output
Item Description
BGP Local router ID

ID of the local BGP device, in the same format as an IPv4 address.

best

Indicates that the BGP route is the optimal route.

Origin

Origin attribute of the BGP route. It is classified into the following types:

  • IGP: indicates that routing information is obtained through IGP. For example, the Origin attribute of the routes imported to the BGP routing table by using the network command is IGP.
  • EGP: indicates that the Origin attribute of the routes obtained through EGP is EGP.
  • Incomplete: The origin of the route cannot be identified. For example, the Origin attribute of the routes imported by BGP through the import-route command is Incomplete.
Route Distinguisher

Route distinguisher (RD) of a route.

Network

Indicates the destination network or host address of the route.

PrefixLen

Mask length of the destination network address or host address of the route.

NextHop

IPv6 address of the next hop.

Duration

Duration of a route.

Peer

Indicates the bgp peer.

Path/Ogn

Indicates the AS_Path number and the Origin attribute of the route.

valid

Indicates that the BGP route is a valid route.

internal

Internal route.

display bgp ipv6 bfd session

Function

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

Format

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] ipv6 bfd session all

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp ipv6 bfd session all

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp ipv6 bfd session peer ipv6-address

Parameters

Parameter Description Value
instance bgpName

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

all

Displays all BFD sessions established by BGP.

-

peer ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The peer bfd and peer bfd enable commands can be used to change the parameters of BFD sessions between BGP peers. To view information about BFD sessions between BGP peers, run the display bgp ipv6 bfd session command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about all BFD sessions established by EVN BGP.
<HUAWEI> display bgp ipv6 bfd session all
--------------------------------------------------------------------------------
  Local_Address  : 2001:DB8:100::1
  Peer_Address   : 2001:DB8:100::2
  Tx-interval(ms): 10          Rx-interval(ms): 10
  Multiplier     : 3           Interface      : 10GE1/0/1
  Session-State  : Up
  Wtr-interval(m): 10
--------------------------------------------------------------------------------
Table 2-515 Description of the display bgp ipv6 bfd session command output
Item Description
Local_Address

Local IP address.

Peer_Address

Peer IP address.

Multiplier

Remote detection multiplier.

Interface

Interface used to set up the BFD session.

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

Session-State

BFD status:

  • BFD global disable: BFD is disabled.
  • Up: The BFD session is in the Up state.
  • Down: The BFD session is in the Down state.
  • Unknown: indicates that BFD does not know whether the link is faulty when the link is not Up for the first time.
Tx-interval(ms)

Interval at which BFD packets are sent, in ms.

Rx-interval(ms)

Interval for receiving BFD packets, in milliseconds.

Wtr-interval(m)

WTR time of the BFD session, in minutes.

display bgp ipv6 bfd session vpnv6 vpn-instance peer

Function

The display bgp ipv6 bfd session vpnv6 vpn-instance peer command displays information about BFD sessions in vpn instances between BGP peers.

Format

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] ipv6 bfd session vpnv6 vpn-instance vpn-instance-name peer ipv6-address

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp ipv6 bfd session vpnv6 vpn-instance vpn-instance-name peer ipv6-address

Parameters

Parameter Description Value
instance bgpName

Specifies the name of a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

vpnv6

Displays information about the BFD sessions of a VPNv6 instance.

-

vpn-instance vpn-instance-name

Specifies the name of a VPN instance in an IPv6 address family.

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

peer ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The peer bfd and peer bfd enable commands can be used to change the parameters of BFD sessions between BGP peers. To view information about BFD sessions between BGP peers, run the display bgp ipv6 bfd session command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BFD sessions in VPN instances between BGP peers.
<HUAWEI> display bgp ipv6 bfd session vpnv6 vpn-instance vpn1 peer 2001:DB8:100::2
VPN-Instance vpn1:
  Local_Address  : 2001:DB8:100::1                                  
  Peer_Address   : 2001:DB8:100::2                                  
  Tx-interval(ms): 10          Rx-interval(ms): 10  
  Multiplier     : 3           Interface      : 10GE1/0/1
  Session-State  : Up
  Wtr-interval(m): 10
Table 2-516 Description of the display bgp ipv6 bfd session vpnv6 vpn-instance peer command output
Item Description
Local_Address

Local address.

Peer_Address

Peer address.

Multiplier

Remote detection multiplier.

Interface

Interface used to set up the BFD session.

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

Session-State

BFD status:

  • BFD global disable: BFD is globally disabled.
  • Up: The BFD session is in the Up state.
  • Down: The BFD session is in the Down state.
  • Unknown: When BFD fails to go Up for the first time, whether the link is faulty is unknown.
Tx-interval(ms)

Interval at which BFD packets are sent, in milliseconds.

Rx-interval(ms)

Interval at which BFD packets are received, in milliseconds.

Wtr-interval(m)

WTR time of the BFD session, in minutes.

display bgp ipv6 group

Function

The display bgp ipv6 group command displays information about IPv6 peer groups, excluding BGP unnumbered peer groups.

Format

display bgp ipv6 group

display bgp ipv6 group group-name

Parameters

Parameter Description Value
ipv6

Displays information about IPv6 peer groups.

-

group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

The display bgp group command displays information about the peer group, including peers in the peer group and configuration information about the peer group. This command is used in the following scenarios:

  • Run the group command to configure the peer group and check whether the configuration is successful.
  • Run the peer group command to add a peer to a peer group and check whether the configuration is successful.
  • After running the undo peer group command to delete a peer, check whether the peer is successfully deleted.
  • After modifying the configuration of the peer group, check whether the modification is successful.

Precautions

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about all BGP IPv6 peer groups.
<HUAWEI> display bgp ipv6 group
BGP peer-group is in
 Remote AS 100
 Type               : internal
 PeerSession Members:
   2001:DB8:2::1
 
 Peer Members:
   2001:DB8:1::1               2001:DB8:2::1
 ***********************
 
 BGP peer-group is ex
 Remote AS number not specified
 Type               : external
 PeerSession Members:
   2001:DB8:20::1
 Peer Members:
   2001:DB8:10::1              2001:DB8:20::1
Table 2-517 Description of the display bgp ipv6 group command output
Item Description
BGP peer-group

BGP peer group name.

Remote AS

Number of the AS where a peer group resides.

Remote AS number not specified

This item is displayed when the peer group is a mixed EBGP peer group.

Type

Type of a peer group:

  • internal: IBGP peer group.
  • external: EBGP peer group.
PeerSession Members

Peers with which sessions have been established.

Peer Members

The following information is about peers.

display bgp ipv6 network

Function

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

Format

display bgp ipv6 network

Parameters

Parameter Description Value
ipv6

Displays the IPv6 routes advertised by BGP.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display IPv6 routes advertised by BGP.
<HUAWEI> display bgp ipv6 network
BGP Local Router ID is 10.5.5.5
Local AS Number is 100(PublicV6)
Network          Prefix           Route-policy

2001:DB8:100::   64
2001:DB8:200::   64
Table 2-518 Description of the display bgp ipv6 network command output
Item Description
BGP Local Router ID is

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

Local AS Number is

Local AS number.

display bgp ipv6 peer

Function

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

The display bgp ipv6 peer command displays information about BGP IPv6 peers.

Format

display bgp ipv6 peer

display bgp ipv6 slow-peer

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

The

display bgp ipv6 peer command displays BGP IPv6 peer information. You can implement the following operations based on the command output:

  • To check the status of BGP connections
  • To check information about a BGP peer
  • To check whether a BGP peer is configured using the peer as-number command
  • To check whether a BGP peer is deleted using the undo peer as-number command

    The display bgp peer command can be used for troubleshooting, with details as follows: If BGP peers are disconnected, specify log-info in the command to check the log information of the specified peer. In the command output, Date/Time indicates the time when the peers were disconnected, and Error Code and Error Subcode indicate the cause of the disconnection.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about IPv6 peers.
<HUAWEI> display bgp ipv6 peer

BGP Local router ID : 10.0.0.1
local AS number : 100
Total number of peers : 1                 Peers in established state : 1

Peer              V    AS  MsgRcvd  MsgSent  OutQ  Up/Down       State PrefRcv
2001:DB8:20::21   4   200       17       19     0 00:09:59 Established       3
Table 2-519 Description of the display bgp ipv6 peer command output
Item Description
BGP Local router ID

Router ID of the BGP local device.

If two ends have the same BGP local router ID, no BGP peer relationship can be established between them. In this situation, run the router id command in the BGP view on either end to change the BGP local router ID. Changing it to the IP address of a loopback interface is recommended.

local AS number

Local AS number.

AS

Autonomous system number.

Total number of peers

Number of BGP peers.

Peers in established state

Number of BGP peers in the Established state.

Peer

Peer IP address.

V

BGP version.

MsgRcvd

BGP version of a peer.

MsgSent

Number of messages sent.

OutQ

Number of messages waiting to be sent to a specified peer.

Up/Down

Period during which a BGP session keeps the current state.

  • When the duration is shorter than 24 hours, the value is displayed as xx:xx:xx, indicating xx hours xx minutes and xx seconds.
  • When the duration is longer than 24 hours, xxxxhxxm is displayed, indicating xxxx hours and xx minutes.
State

Current BGP status:

  • Idle: BGP denies any connection request. This is the initial status of BGP.

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

  • Connect: BGP is waiting for the TCP connection to be established before performing subsequent operations.
  • If the TCP connection is successfully established, BGP stops the ConnectRetry Timer, sends an Open message to the peer, and changes its state to Opensent.
  • If the TCP connection fails to be established, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection initiated by the remote peer, and changes its state to Active.
  • If the ConnectRetry timer expires, BGP restarts the ConnectRetry timer and attempts to establish a TCP connection with the peer again. At this time, BGP remains in the Connect state.
  • Active: BGP attempts to establish a TCP connection. This is the intermediate state of BGP.
  • If the TCP connection is successfully established, BGP restarts the ConnectRetry Timer with the initial value, sends an Open message to the remote peer, and changes its state to Opensent.
  • If the ConnectRetry timer expires, BGP restarts the ConnectRetry timer and enters the Connect state.
  • If BGP attempts to establish a TCP connection with an unknown IP address, the TCP connection fails, the ConnectRetry Timer is reset, and BGP remains in the Active state.
  • OpenSent: BGP has sent an Open message to the peer and is now waiting for an Open message from the peer.
  • If BGP receives a correct Open message, BGP enters the OpenConfirm state.
  • If the Open message received by BGP is incorrect, BGP sends a Notification message to the peer and enters the Idle state.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection initiated by the remote peer, and changes its state to Active.
  • OpenConfirm: BGP is waiting for a Notification message or a Keepalive message.
  • If BGP receives a Notification message or a TCP connection teardown message, BGP changes its state to Idle.
  • If BGP receives a Keepalive message, BGP enters the Established state.
  • Established: indicates that BGP peers can exchange Update, Notification, and Keepalive messages.
  • If BGP receives an Update or Keepalive message, BGP remains in the Established state.
  • If BGP receives a Notification message, BGP changes its state to Idle.
  • No neg: The address family is not enabled for the BGP peer. In this state, Update messages can be exchanged in other successfully negotiated address families. If the address family is enabled on the remote BGP peer, the local BGP peer receives a Notification message, disconnects from the remote BGP peer, changes to the Idle state, and re-establishes a connection with the remote BGP peer.
PrefRcv

Number of route prefixes sent from the peer.

display bgp ipv6 peer log-info

Function

The display bgp ipv6 peer log-info command displays log information about BGP IPv6 peers.

Format

display bgp ipv6 peer ipv6-address log-info

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer to be displayed.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp ipv6 peer log-info command can be used for troubleshooting, with details as follows: If BGP peers are disconnected, check the log information of the specified peer. In the command output, Date/Time indicates the time when the peers were disconnected, and Error Code and Error Subcode indicate the cause of the disconnection.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display log information about the BGP peer 2001:DB8:1::2.
<HUAWEI> display bgp ipv6 peer 2001:DB8:1::2 log-info
Peer : 2001:DB8:1::2 
 Date/Time     : 2019/16/09 11:53:21
 State         : Up
 Date/Time     : 2019/16/09 11:53:09
 State         : Down
 Error Code    : 6(CEASE)
 Error Subcode : 4(Administrative Reset)
 Notification  : Receive Notification
 Date/Time     : 2019/16/09 10:34:05
 State         : Up
Table 2-520 Description of the display bgp ipv6 peer log-info command output
Item Description
Peer

Peer IP address.

Date/Time

Date/time.

State

Status of a HWTACACS server.

Error Code

Error code.

For the meanings and possible causes of error codes, see BGP Principles - BGP NOTIFICATION Packets. These packets are used to process various errors in the BGP process.

Error Subcode

Error subcode.

For details about error subcodes and possible causes, see BGP Fundamentals - BGP Notification Messages. These messages are used to process various errors in the BGP process.

Notification

Notification message sent or received by a peer.

display bgp ipv6 peer verbose

Function

The display bgp ipv6 peer verbose command displays detailed information about BGP IPv6 peers.

Format

display bgp ipv6 peer verbose

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

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer to be displayed.

The prefix is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

ipv4-address

Specifies the IPv4 address of a peer to be displayed.

The value is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp ipv6 peer verbose command displays detailed information about BGP IPv6 peers.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display detailed information about the IPv6 neighbor 2001:db8:1::2.
<HUAWEI> display bgp ipv6 peer 2001:db8:1::2 verbose

         BGP Peer is 2001:db8:1::2,  remote AS 100
         Type: IBGP link
         BGP version 4, Remote router ID 2.2.2.2
         Update-group ID: 3
         BGP current state: Established, Up for 00h01m28s
         BGP current event: KATimerExpired
         BGP last state: OpenConfirm
         BGP Peer Up count: 1
         Received total routes: 0
         Received active routes total: 0
         Advertised total routes: 0
         Port: Local - 179        Remote - 51020
         Configured: Connect-retry Time: 32 sec
         Configured: Min Hold Time: 0 sec
         Configured: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Received  : Active Hold Time: 180 sec
         Negotiated: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Peer optional capabilities:
         Peer supports bgp multi-protocol extension
         Peer supports bgp route refresh capability
         Peer supports bgp 4-byte-as capability
         Address family IPv6 Unicast: advertised and received
 Received: Total 4 messages
                  Update messages                1
                  Open messages                  1
                  KeepAlive messages             2
                  Notification messages          0
                  Refresh messages               0
 Sent: Total 4 messages
                  Update messages                1
                  Open messages                  1
                  KeepAlive messages             2
                  Notification messages          0
                  Refresh messages               0
 Authentication type configured: None
 Last keepalive received: 2020-09-17 06:58:57+00:00
 Last keepalive sent    : 2020-09-17 06:59:08+00:00
 Last update    received: 2020-09-17 06:58:09+00:00
 Last update    sent    : 2020-09-17 06:58:09+00:00
 No refresh received since peer has been configured
 No refresh sent since peer has been configured
 Minimum route advertisement interval is 15 seconds
 Optional capabilities:
 Route refresh capability has been enabled
 4-byte-as capability has been enabled
 Peer Preferred Value: 0
 Routing policy configured:
 No routing policy is configured
# Display detailed information about IPv6 peers.
<HUAWEI> display bgp ipv6 peer verbose

         BGP Peer is 2001:DB8:1::2,  remote AS 200
         Type: EBGP link
         BGP version 4, Remote router ID 10.1.1.2
         Update-group ID: 3
         BGP current state: Established, Up for 00h00m13s
         BGP current event: RecvUpdate
         BGP last state: OpenConfirm
         BGP Peer Up count: 1
         Received total routes: 0
         Received active routes total: 0
         Advertised total routes: 0
         Port: Local - 53781        Remote - 179
         Configured: Connect-retry Time: 32 sec
         Configured: Min Hold Time: 0 sec
         Configured: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Received  : Active Hold Time: 180 sec
         Negotiated: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Peer optional capabilities:
         Peer supports bgp multi-protocol extension
         Peer supports bgp route refresh capability
         Peer supports bgp 4-byte-as capability
         Address family IPv6 Unicast: advertised and received
 Received: Total 3 messages
                  Update messages                1
                  Open messages                  1
                  KeepAlive messages             1
                  Notification messages          0
                  Refresh messages               0
 Sent: Total 3 messages
                  Update messages                1
                  Open messages                  1
                  KeepAlive messages             1
                  Notification messages          0
                  Refresh messages               0
 Authentication type configured: None
 Last keepalive received: 2020-01-28 12:34:27+00:00
 Last keepalive sent    : 2020-01-28 12:34:27+00:00
 Last update    received: 2020-01-28 12:34:27+00:00
 Last update    sent    : 2020-01-28 12:34:27+00:00
 No refresh received since peer has been configured
 No refresh sent since peer has been configured
 Minimum route advertisement interval is 30 seconds
 Optional capabilities:
 Route refresh capability has been enabled
 4-byte-as capability has been enabled
 Peer Preferred Value: 0
 Routing policy configured:
 No routing policy is configured
Table 2-521 Description of the display bgp ipv6 peer verbose command output
Item Description
BGP version

BGP version.

BGP current state

State of BGP:

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

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

  • Connect: indicates that BGP is waiting for the TCP connection to be set up before it determines whether to perform other operations.
  • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active.
  • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value, initiates a TCP connection request to the remote BGP peer, and stays in the Connect state.
  • Active: indicates that BGP tries to set up a TCP connection. This is the intermediate status of BGP.
  • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.
  • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value and changes its state to Connect.
  • If BGP initiates a TCP connection request with an unknown IP address, the TCP connection fails. When this occurs, BGP restarts the ConnectRetry Timer with the initial value and stays in the Active state.
  • OpenSent: indicates that BGP has sent one Open message to its peer and is waiting for the other Open message from the peer.
  • If there are no errors in the Open message received, BGP changes its state to OpenConfirm.
  • If there are errors in the Open message received, BGP sends a Notification message to the remote peer and changes its state to Idle.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active.
  • OpenConfirm: indicates that BGP is waiting for a Notification or Keepalive message.
  • If BGP receives a Notification message, or the TCP connection fails, BGP changes its state to Idle.
  • If BGP receives a Keepalive message, BGP changes its state to Established.
  • Established: indicates that BGP peers can exchange Update, Notification, and Keepalive messages.
  • If BGP receives an Update or a Keepalive message, its state stays in Established.
  • If BGP receives a Notification message, BGP changes its state to Idle.
  • No neg: The address family is not enabled for the BGP peer. In this state, Update messages can be exchanged in other address families whose capabilities have been successfully negotiated. If the address family is enabled for the BGP peer, the local BGP peer receives a Notification message, and the peer relationship is disconnected. Then, the BGP peer changes to the Idle state and re-establishes the peer relationship.
BGP current event

Current BGP event.

BGP last state

Last BGP status, which may be Idle, Connect, Active, OpenSent, OpenConfirm, Established or No neg.

BGP Peer Up count

Flapping count of a BGP peer in a specified period of time.

BGP Peer is

Peer address.

Peer Preferred Value

PrefVal of the peer.

Peer optional capabilities

Optional capabilities of the peer.

Remote router ID

Router ID of the peer.

Update-group ID

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

Received total routes

Number of received route prefixes.

Received active routes total

Number of received active route prefixes.

Received : Active Hold Time:

Hold time on the peer.

Received

Number of messages received from a peer.

  • Total: indicates the total number of messages received from a peer.
  • Update messages: indicates the number of Update messages received from a peer.
  • Open messages: indicates the number of Open messages received from a peer.
  • KeepAlive messages: indicates the number of Keepalive messages received from a peer.
  • Notification messages: indicates the number of Notification messages received from a peer.
  • Refresh messages: indicates the number of route-refresh messages received from a peer.
Advertised total routes

Number of sent route prefixes.

Keepalive Time

Indicates the interval at which Keepalive messages are sent to the peer.

Negotiated: Active Hold Time:

Hold time agreed between the BGP peers after capability negotiation.

Address family IPv6 Unicast

IPv6 unicast address family.

Authentication type configured

Authentication type.

Last keepalive received

Last time when a Keepalive message is received.

Last keepalive sent

Last time when a Keepalive message is sent.

Minimum route advertisement interval

Minimum route advertisement interval.

  • The minimum interval at which EBGP routes are advertised is 30 seconds.
  • The minimum interval at which IBGP routes are advertised is 15 seconds.
Optional capabilities

Optional capabilities of the peer.

Route refresh capability has been enabled

Route refreshing has been enabled.

Routing policy configured

Configured routing policy.

Type

BGP link type: IBGP or EBGP.

Port

Port type:

  • Local: indicates the local port number, which is always 179. BGP uses TCP at the transport layer.
  • Remote: indicates the port number used on the peer.
Configured

Locally configured timers.

  • Active Hold Time: indicates the hold time. If BGP does not receive any Keepalive message from the peer in the hold time, BGP considers that the peer is Down and then instructs other peers to remove the routes that are sent from the peer.
  • Keep Alive Time: indicates the interval at which Keepalive messages are sent to the peer. BGP peers exchange Keepalive messages periodically to maintain their relationships.
Sent

Number of messages sent to a peer.

  • Total: indicates the total number of messages sent to a peer.
  • Update messages: indicates the number of Update messages sent to a peer.
  • Open messages: indicates the number of Open messages sent to a peer.
  • KeepAlive messages: indicates the number of Keepalive messages sent to a peer.
  • Notification messages: indicates the number of Notification messages sent to a peer.
  • Refresh messages: indicates the number of route-refresh messages sent to a peer.

display bgp ipv6 routing-table (Attribute)

Function

The display bgp ipv6 routing-table command displays information about BGP4+ public network routes based on specified multiple attribute values.

Format

display bgp ipv6 routing-table

display bgp ipv6 routing-table regular-expression strRegular

display bgp ipv6 routing-table community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> [ whole-match ]

display bgp ipv6 routing-table large-community [ largeCommuStr ] &<1-33> [ whole-match ]

Parameters

Parameter Description Value
community communityNum

Specifies a community number.

The value is an integer ranging from 0 to 4294967295.

community strCommunityNum

Specifies a community number.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

internet

Displays the BGP routes carrying the internet community attribute.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

no-advertise

Displays the BGP routes carrying the No-Advertise community attribute.

-

no-export

Displays the BGP routes carrying the No-Export community attribute.

-

no-export-subconfed

Displays the BGP routes carrying the No-Export-Subconfed community attribute.

-

g-shut

Displays routes with the Grateful-Shutdown community attribute.

-

whole-match

Matches the specified community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

large-community largeCommuStr

Specifies a value of the Large-Community attribute.

The value is a string of 5 to 32 case-sensitive characters, spaces not supported.

regular-expression strRegular

Specifies the regular expression that matches AS_Path.

The value is a string of 1 to 80 characters.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query information about BGP4+ public network routes based on specified multiple attribute values, run this command. Multiple attribute values can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP4+ public network routes with the large community attribute.
<HUAWEI> display bgp ipv6 routing-table large-community
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 2
 *>     Network  : 2001:DB8:1::                             PrefixLen : 64  
        Nexthop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Large-Community : <1:1:1>, <2:2:2>
 *>     Network  : 2001:DB8:2::                             PrefixLen : 64  
        Nexthop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Large-Community : <1:1:1>, <2:2:2>
# Display the BGP4+ public network routes that match the AS_Path regular expression ^20.
<HUAWEI> display bgp ipv6 routing-table regular-expression ^20
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 2
 *>     Network  : 2001:DB8:1::                             PrefixLen : 64  
        NextHop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Path/Ogn : 200i
 *>     Network  : 2001:DB8:2::                             PrefixLen : 64  
        NextHop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Path/Ogn : 200i
# Display BGP4+ public network routes.
<HUAWEI> display bgp ipv6 routing-table
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 2
 *>     Network  : 2001:DB8:1::                             PrefixLen : 64  
        NextHop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Path/Ogn : 200i
 *>     Network  : 2001:DB8:2::                             PrefixLen : 64  
        NextHop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Path/Ogn : 200i
# Display BGP4+ public network routes with the community attribute.
<HUAWEI> display bgp ipv6 routing-table community
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 2
 *>     Network  : 2001:DB8:1::                             PrefixLen : 64  
        Nexthop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Community : <1:1>, <2:2>
 *>     Network  : 2001:DB8:2::                             PrefixLen : 64  
        Nexthop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Community : <1:1>, <3:3>
Table 2-522 Description of the display bgp ipv6 routing-table (Attribute) command output
Item Description
BGP Local router ID is

Router ID of the local BGP device.

Total Number of Routes

Total number of routes.

Network

Network address in the BGP public network routing table.

PrefixLen

Prefix length.

Nexthop

Next hop address of the packet.

LocPrf

Local_Pref.

MED

MED of a route.

PrefVal

PrefVal.

Label

Label value.

Large-Community

LargeCommunity attribute of a route.

Path/Ogn

AS_Path number and the origin attribute.

Community

Community attribute of a route.

display bgp ipv6 routing-table (Route Attributes)

Function

The display bgp ipv6 routing-table command displays BGP4+ public network routes.

Format

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

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

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer to be displayed.

The value is in the X:X:X:X:X:X:X:X format.

prefix-length

Specify network prefix length.

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

as-path

Displays the AS_Path attribute contained in a public network route.

-

community-list

Displays the community attribute contained in a public network route.

-

large-community

Displays the BGP routes with the specified Large-Community attribute.

-

ext-community

Displays the extended community attribute contained in a public network route.

-

cluster-list

Displays the cluster list contained in a route.

-

advertised-peer

Displays the list of the peers to which a route is advertised.

-

peer peerIpv6Addr

Specify an IPv6 peer address.

The value is in the X:X:X:X:X:X:X:X format.

peerIpv4Addr

Displays the IPv4 address of a peer on which public network routes are to be displayed.

The value is in dotted decimal notation.

advertised-routes

Displays the BGP4+ public network routes advertised to a specified peer.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the cluster list attributes of all routes in the BGP4+ public network routing table.
<HUAWEI> display bgp ipv6  routing-table 2001:DB8:111::1 cluster-list
BGP routing table entry information of 2001:DB8:111::1/128:
 Imported route.
 From: ::
 BGP routing table entry information of ::FFFF:127.0.0.1/128:
 Imported route.
 From: ::
 BGP routing table entry information of 2001:DB8:100::/96:
 Imported route.
 From: ::
 BGP routing table entry information of 2001:DB8:100::/96:
 From: 2001:DB8:100::2
 BGP routing table entry information of 2001:DB8:100::1/128:
 Imported route.
 From: ::
 BGP routing table entry information of 2001:DB8:103::103/128:
 From: 2001:DB8:100::2
 Cluster list: 3.3.3.3
 BGP routing table entry information of 2001:DB8:200::200/128:
 From: 2001:DB8:100::2
# Display the community attributes of all routes in the BGP4+ public network routing table.
<HUAWEI> display bgp ipv6 routing-table 2001:DB8:111::1 community-list
BGP routing table entry information of 2001:DB8:100::/96:
 From: 2001:DB8:100::2
 Community: <400:1>
 BGP routing table entry information of 2001:DB8:101::101/128:
 From: 2001:DB8:100::2
 Community: <400:1>
 BGP routing table entry information of 2001:DB8:200::200/128:
 From: 2001:DB8:100::2
 Community: <400:1>
# Display the Large-Community attributes of all routes in the BGP4+ routing table.
<HUAWEI> display bgp ipv6 routing-table 2001:DB8:111::1 large-community
BGP routing table entry information of 2001:DB8:111::1/128:
 From: 2001:DB8:10::2
 Large-Community: <400:1:1>
# Display AS-Path information about BGP IPv6 routes.
<HUAWEI> display bgp ipv6 routing-table 2001:DB8:111::1 as-path
BGP routing table entry information of 2001:DB8:111::1/128:
 Imported route.
 From: ::
 AS-path Nil
 BGP routing table entry information of ::FFFF:127.0.0.1/128:
 Imported route.
 From: ::
 AS-path Nil
 BGP routing table entry information of 2001:DB8:100::100/128:
 Imported route. 
 From: ::
 AS-path Nil
# Display the extended community attributes of all routes in the BGP4+ public network routing table.
<HUAWEI> display bgp ipv6 routing-table 2001:DB8:111::1 ext-community
BGP routing table entry information of 2001:DB8:100::/96:
 From: 2001:DB8:100::2
 BGP routing table entry information of 2001:DB8:101::101/128:
 From: 2001:DB8:100::2
 BGP routing table entry information of 2001:DB8:200::200/128:
 From: 2001:DB8:100::2
 Ext-Community: RT <300 : 1>
Table 2-523 Description of the display bgp ipv6 routing-table (Route Attributes) command output
Item Description
BGP routing table entry information of

Routing entry information.

Imported route

Routes imported into the BGP routing table using the import-route command.

Cluster list

Cluster list of a route.

AS-path

AS_Path attribute.

Nil indicates that the attribute value is null.

Large-Community

Large-Community attribute of a route.

Ext-Community

Extended community attribute of a route.

From

IP address of the device that advertises the route.

Community

Community attribute of a route.

display bgp ipv6 routing-table dampened

Function

The display bgp ipv6 routing-table dampened command displays BGP dampened routes and statistics about the routes.

Format

display bgp ipv6 routing-table dampened

display bgp ipv6 routing-table statistics dampened

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp ipv6 routing-table statistics dampened command displays BGP dampened routes and statistics about the routes.

Precautions

If a routing loop occurs, some routes may have not converged when you run the display bgp ipv6 routing-table statistics command. Therefore, the route statistics displayed using the command may be different from the actual number.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP dampened routes.
<HUAWEI> display bgp ipv6 routing-table dampened

 Total Number of Routes: 4

 BGP Local router ID is 10.0.0.2
 Status codes: * - valid, > - best, d - damped, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
 Origin      : i - IGP, e - EGP, ? - incomplete

  d  Network : 2001:DB8:1::                              PrefixLen : 48
     From    : 2001:DB8:5::                              Reuse     : 01:06:26
     Path/Ogn: 65001?

  d  Network : 2001:DB8:2::                              PrefixLen : 48
     From    : 2001:DB8:5::                              Reuse     : 01:06:26
     Path/Ogn: 65001?

  d  Network : 2001:DB8:3::                              PrefixLen : 48
     From    : 2001:DB8:5::                              Reuse     : 01:06:26
     Path/Ogn: 65001?

  d  Network : 2001:DB8:4::                              PrefixLen : 48
     From    : 2001:DB8:5::                              Reuse     : 01:06:26
     Path/Ogn: 65001?
Table 2-524 Description of the display bgp ipv6 routing-table dampened command output
Item Description
Total Number of Routes

Total number of routes.

Network

Indicates the network address in the BGP routing table.

PrefixLen

Prefix length.

From

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

Reuse

Reuse value (in seconds).

Path/Ogn

Indicates the AS_Path number and the Origin attribute of the route.

display bgp ipv6 routing-table dampening parameter

Function

The display bgp ipv6 routing-table dampening parameter command displays configured BGP4+ route dampening parameters.

Format

display bgp ipv6 routing-table dampening parameter

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check configured BGP4+ route dampening parameters, run the display bgp ipv6 routing-table dampening parameter command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP4+ route dampening parameters.
<HUAWEI> display bgp ipv6 routing-table dampening parameter
Maximum Suppress Time(in second) : 3069
Ceiling Value                    : 16000
Reuse Value                      : 750
HalfLife Time(in  second)        : 900
Suppress-Limit                   : 2000
Table 2-525 Description of the display bgp ipv6 routing-table dampening parameter command output
Item Description
Maximum Suppress Time(in second)

Maximum route suppression time, in seconds.

Ceiling Value

Indicates the penalty ceiling.

Reuse Value

Threshold for the routes to be unsuppressed.

HalfLife Time(in second)

Half life of a reachable route, in seconds.

Suppress-Limit

Indicates the threshold for a route to be suppressed.

display bgp ipv6 routing-table different-origin-as

Function

The display bgp ipv6 routing-table different-origin-as command displays routes that have the same destination address but different source AS numbers.

Format

display bgp ipv6 routing-table different-origin-as

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp ipv6 routing-table different-origin-as command displays routes that have the same destination address but different source AS numbers.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about IPv6 routes with the same destination address but different origin AS numbers.
<HUAWEI> display bgp ipv6 routing-table different-origin-as

 Total Number of Routes: 0
Table 2-526 Description of the display bgp ipv6 routing-table different-origin-as command output
Item Description
Total Number of Routes

Number of routes.

display bgp ipv6 routing-table flap-info

Function

The display bgp ipv6 routing-table flap-info command displays statistics about BGP4+ route flapping.

Format

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

Parameters

Parameter Description Value
as-path-filter as-path-filter-name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

as-path-filter as-path-filter-number

Specifies the number of an AS_Path filter.

The value is a decimal integer ranging from 1 to 256.

network-address

Specifies the network address of dampened routes.

The value is in dotted decimal notation.

prefix-length

Specify network prefix length.

It is an integer ranging from 0 to 128.

longer-match

Allows longer prefix length match.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To view statistics about BGP4+ route flapping, run the display bgp ipv6 routing-table flap-info command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about BGP4+ route flapping.
<HUAWEI> display bgp ipv6 routing-table flap-info

 Total Number of Routes: 3

 BGP Local router ID is 10.53.53.53
 Status codes: * - valid, > - best, d - damped, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
 Origin      : i - IGP, e - EGP, ? - incomplete

  d  Network : 2001:DB8:1:1:1::                          PrefixLen : 96
     From    : 2001:DB8:1:1:1::1                         Flaps     : 8
     Duration: 00:02:11                                  Reuse     : 00:49:21
     Path/Ogn: 100?

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

  d  Network : 2001:DB8:2::3                             PrefixLen : 128
     From    : 2001:DB8:1:1:1::1                         Flaps     : 5
     Duration: 00:00:18                                  Reuse     : 00:41:06
     Path/Ogn: 100?
Table 2-527 Description of the display bgp ipv6 routing-table flap-info command output
Item Description
Total Number of Routes

Total number of routes.

Network

Indicates the network address in the BGP routing table.

PrefixLen

Mask length of the destination network address or host address of the route.

From

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

Flaps

Total number of route flappings.

Reuse

Reuse value.

Duration

Total duration of route flapping.

Path/Ogn

AS_Path and Origin.

display bgp ipv6 routing-table flap-info regular-expression

Function

The display bgp ipv6 routing-table flap-info regular-expression command displays statistics about the flapping routes that match an AS_Path regular expression.

Format

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

Parameters

Parameter Description Value
regular-expression as-regular-expression

Displays statistics about the flapping routes that match an AS_Path regular expression.

The value is a string of 1 to 80 characters.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To view statistics about the flapping routes that match an AS_Path regular expression, run the display bgp ipv6 routing-table flap-info regular-expression command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about the flapping routes that match an AS_Path regular expression.
<HUAWEI> display bgp ipv6 routing-table flap-info regular-expression 8
 BGP Local router ID is 10.1.1.1
 Status codes: * - valid, > - best, d - damped, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
 Origin      : i - IGP, e - EGP, ? - incomplete
 Total Number of Routes: 3
  d  Network : 2001:DB8:1:1:1::                          PrefixLen : 96
     From    : 2001:DB8:1:1:1::1                         Flaps     : 8
     Duration: 00:02:11                                  Reuse     : 00:49:21
     Path/Ogn: 1.1 100?
  d  Network : 2001:DB8:2::2                             PrefixLen : 128
     From    : 2001:DB8:1:1:1::1                         Flaps     : 5
     Duration: 00:00:18                                  Reuse     : 00:41:06
     Path/Ogn: 1.1 100?
  d  Network : 2001:DB8:2::3                             PrefixLen : 128
     From    : 2001:DB8:1:1:1::1                         Flaps     : 5
     Duration: 00:00:18                                  Reuse     : 00:41:06
     Path/Ogn: 1.1 100?
Table 2-528 Description of the display bgp ipv6 routing-table flap-info regular-expression command output
Item Description
Total Number of Routes

Total number of routes.

Network

Indicates the network address in the BGP routing table.

PrefixLen

Mask length of the destination network address or host address of the route.

From

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

Flaps

Total number of route flappings.

Reuse

Reuse value.

Duration

Total duration of route flapping.

Path/Ogn

AS_Path and Origin.

display bgp ipv6 routing-table peer

Function

The display bgp ipv6 routing-table peer command displays public network routes of the specified BGP4+ peer.

Format

display bgp ipv6 routing-table peer { remoteIpv4Addr | remoteIpv6Addr } advertised-routes

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

display bgp ipv6 routing-table peer { remoteIpv4Addr | remoteIpv6Addr } received-routes

display bgp ipv6 routing-table peer { remoteIpv4Addr | remoteIpv6Addr } received-routes active

display bgp ipv6 routing-table peer { remoteIpv4Addr | remoteIpv6Addr } advertised-routes networkIpv6 [ mask-length ]

display bgp ipv6 routing-table peer { remoteIpv4Addr | remoteIpv6Addr } received-routes networkIpv6 [ mask-length [ original-attributes ] ]

Parameters

Parameter Description Value
remoteIpv4Addr

Specify an IPv4 peer address.

The value is in dotted decimal notation.

advertised-routes networkIpv6

Displays the BGP4+ public network routes advertised to a specified peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

peer remoteIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

accepted-routes

Displays routes accepted by routing policy.

-

not-accepted-routes

Displays routes not accepted by routing policy.

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

-

received-routes networkIpv6

Displays the BGP4+ public network routes received from the specified peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

active

Displays information about the active routes received from a specified peer.

-

mask-length

Specifies the mask length of a network address.

It is an integer ranging from 0 to 128.

original-attributes

Displays original attributes of specified routes.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the IPv6 routing information of the peer accepted by routing policy.
<HUAWEI> display bgp ipv6 routing-table peer 2001:DB8:9:3::1 accepted-routes
 
 BGP Local router ID is 3.3.3.3
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 2
 *>i    Network  : 2001:DB8:9:1::                           PrefixLen : 64  
        NextHop  : 2001:db8:9:3::1                          LocPrf    : 100 
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Path/Ogn :  i
   i    Network  : 2001:DB8:9:3::                           PrefixLen : 64  
        NextHop  : 2001:db8:9:3::1                          LocPrf    : 100 
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Path/Ogn :  i
Table 2-529 Description of the display bgp ipv6 routing-table peer command output
Item Description
Total Number of Routes

Total number of routes in the routing table.

Network

Network address in the BGP4+ routing table.

NextHop

Indicates the next-hop address of the packet.

LocPrf

Local_Pref of the route.

MED

Indicates the MED of the route.

PrefVal

Preferred value of a protocol.

Label

Label value.

Path/Ogn

AS_Path and Origin.

display bgp ipv6 routing-table peer statistics

Function

The display bgp ipv6 routing-table peer statistics command displays the routing statistics of the specified BGP4+ peer.

Format

display bgp ipv6 routing-table peer { remoteIpv4Addr | remoteIpv6Addr } { advertised-routes | received-routes | received-routes active } statistics

Parameters

Parameter Description Value
remoteIpv4Addr

Specify an IPv4 peer address.

The value is in dotted decimal notation.

advertised-routes

Routes advertised to the remote peer.

-

received-routes

Indicates the routes from the peer.

-

active

Displays the active routes received from the specified peer.

-

statistics

Displays statistics about routes.

-

peer remoteIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp ipv6 routing-table peer statistics command displays the routing statistics of the specified BGP4+ peer. You can specify different parameters to view the specific routing statistics information.

Example

The actual command output varies according to the device. The command output here is only an example.

# Displays statistics about IPv6 routes received from the peer.
<HUAWEI> display bgp ipv6 routing-table peer 2001:DB8:9:3::1 received-routes statistics

 Received routes total: 2
Table 2-530 Description of the display bgp ipv6 routing-table peer statistics command output
Item Description
Received routes total

Number of BGP routes received from the peer.

display bgp ipv6 routing-table statistics

Function

The display bgp ipv6 routing-table statistics community command displays statistics about the routing information of the specified BGP4+ routes in the public routing table.

Format

display bgp ipv6 routing-table statistics active

Parameters

Parameter Description Value
active

Specifies the number of active routes.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Precautions

During route flapping, the route statistics may differ from the actual number of routes on the network because some routes are still on the way.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about active BGP4+ routes.
<HUAWEI> display bgp ipv6 routing-table statistics active
Total Number of Prefix Advertised to RM : 2
Total Number of Active Route : 2
Table 2-531 Description of the display bgp ipv6 routing-table statistics command output
Item Description
Total Number of Prefix Advertised to RM

Total number of routes delivered to the RM module.

Total Number of Active Route

Number of active routes.

display bgp ipv6 routing-table statistics(Attribute Filter)

Function

The display bgp ipv6 routing-table statistics command displays statistics about BGP4+ public network routes based on specified multiple attribute filters.

Format

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

display bgp ipv6 routing-table statistics community-filter { { community-filter-num | community-filter-numEx | community-filter-name } | { community-filter-num | community-filter-name } whole-match }

display bgp ipv6 routing-table statistics large-community-filter largeComFilName [ whole-match ]

Parameters

Parameter Description Value
statistics

Displays BGP route statistics.

-

as-path-filter as-path-filter-num

Specifies the number of an AS_Path filter.

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

as-path-filter as-path-filter-name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

community-filter community-filter-name

Specifies the name of a community filter.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

community-filter community-filter-num

Specifies the number of a basic community filter.

The value is an integer ranging from 1 to 99.

community-filter community-filter-numEx

Specifies the number of an advanced community filter.

The value is an integer that ranges from 100 to 199.

whole-match

Matches the specified community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

large-community-filter largeComFilName

Specifies the name of a Large-Community filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query statistics about BGP4+ public network routes based on specified multiple attribute filters, run this command. Multiple attribute filters can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP4+ public network routes statistics that match the AS path filter pas.
<HUAWEI> display bgp ipv6 routing-table statistics as-path-filter pas
 Total Number of Routes: 2
# Display BGP4+ public network routes statistics that match the community filter 10.
<HUAWEI> display bgp ipv6 routing-table statistics community-filter 10
 Total Number of Routes: 1
# Display BGP4+ public network routes statistics that match the large community filter aaa.
<HUAWEI> display bgp ipv6 routing-table statistics large-community-filter aaa
 Total Number of Routes: 2
Table 2-532 Description of the display bgp ipv6 routing-table statistics(Attribute Filter) command output
Item Description
Total Number of Routes

Total number of routes in the routing table.

display bgp ipv6 routing-table statistics(Attribute)

Function

The display bgp ipv6 routing-table statistics command displays statistics about BGP4+ public network routes based on specified multiple attribute values.

Format

display bgp ipv6 routing-table statistics

display bgp ipv6 routing-table statistics regular-expression strRegular

display bgp ipv6 routing-table statistics community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> [ whole-match ]

display bgp ipv6 routing-table statistics large-community [ largeCommuStr ] &<1-33> [ whole-match ]

Parameters

Parameter Description Value
statistics

Displays BGP route statistics.

The value is a string of 1 to 80 characters.

community communityNum

Specify community number.

The value is an integer ranging from 0 to 4294967295.

community strCommunityNum

Specify community number.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

internet

Displays the BGP routes carrying the internet community attribute.

-

no-advertise

Displays the BGP routes carrying the No-Advertise community attribute.

-

no-export

Displays the BGP routes carrying the No-Export community attribute.

-

no-export-subconfed

Displays the BGP routes carrying the No-Export-Subconfed community attribute.

-

g-shut

Display routes with the Grateful-Shutdown community attribute.

-

whole-match

Matches the specified community attribute or the specified Large-Community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

large-community largeCommuStr

Specifies a value of the Large-Community attribute.

The value is a string of 5 to 32 case-sensitive characters, spaces not supported.

regular-expression strRegular

Specifies the regular expression that matches AS_Path.

The value is a string of 1 to 80 characters.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query statistics about BGP4+ public network routes based on specified multiple attribute values, run this command. Multiple attribute values can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP4+ public network routes statistics.
<HUAWEI> display bgp ipv6 routing-table statistics
 Total Number of Routes: 2
# Display BGP4+ public network routes statistics with the community attribute.
<HUAWEI> display bgp ipv6 routing-table statistics community
 Total Number of Routes: 1
# Display BGP4+ public network routes statistics with the large community attribute.
<HUAWEI> display bgp ipv6 routing-table statistics large-community
 Total Number of Routes: 4
# Display BGP4+ public network routes statistics that match the AS_Path regular expression ^20.
<HUAWEI> display bgp ipv6 routing-table statistics regular-expression ^20
 Total Number of Routes: 2
Table 2-533 Description of the display bgp ipv6 routing-table statistics(Attribute) command output
Item Description
Total Number of Routes

Total number of routes in the routing table.

display bgp ipv6 routing-table time-range

Function

The display bgp ipv6 routing-table time-range command displays BGP IPv6 routes that flap within the specified time period.

Format

display bgp ipv6 routing-table [ peer { remoteIpv4Addr | remoteIpv6Addr } { received-routes | advertised-routes } ] time-range time-range-start time-range-end

Parameters

Parameter Description Value
peer remoteIpv6Addr

Specifies the IPv6 address of a peer.

The value is in the format X:X:X:X:X:X:X:X.

remoteIpv4Addr

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

received-routes

Displays the BGP4+ public network routes received from a specified peer.

-

advertised-routes

Displays the BGP4+ public network routes advertised to a specified peer.

-

time-range time-range-start time-range-end

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

The values of start-time and end-time are in the format of xxdxxhxxmxxs. d specifies the day, which is an integer ranging from 0 to 10000. h specifies the hour, which is an integer ranging from 0 to 23. m specifies the minute, which is an integer ranging from 0 to 59. s specifies the second, which is an integer ranging from 0 to 59.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp ipv6 routing-table time-range command displays BGP IPv6 routes that flap within the specified time period. You can view information about specified routes by specifying different keywords or parameters.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP4+ routes that flap within the specified time period.
<HUAWEI> display bgp ipv6 routing-table time-range 0d5h0m0s 1d5h0m0s
BGP Local router ID is 10.1.1.2
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found

 *>i Network  : 2001:DB8:100::100                    PrefixLen : 128
     NextHop  : 2001:DB8:12::1                       Duration  : 0d05h46m16s
     Peer     : 2001:DB8:12::1
     Path/Ogn : ?
 * i
     NextHop  : 2001:DB8:112::1                      Duration  : 0d05h46m16s
     Peer     : 2001:DB8:112::1
     Path/Ogn : ?
 *>i Network  : 2001:DB8:111::111                    PrefixLen : 128
     NextHop  : 2001:DB8:12::1                       Duration  : 0d05h46m16s
     Peer     : 2001:DB8:12::1
     Path/Ogn : ?
 * i
     NextHop  : 2001:DB8:112::1                      Duration  : 0d05h46m16s
     Peer     : 2001:DB8:112::1
     Path/Ogn : ?
 *>i Network  : 2001:DB8:112::111                    PrefixLen : 128
     NextHop  : 2001:DB8:12::1                       Duration  : 0d05h46m16s
     Peer     : 2001:DB8:12::1
     Path/Ogn : ?
   i
     NextHop  : 2001:DB8:112::1                      Duration  : 0d05h46m16s
     Peer     : 2001:DB8:112::1
     Path/Ogn : ?
 *>i Network  : 2001:DB8:112::113                    PrefixLen : 128
     NextHop  : 2001:DB8:12::1                       Duration  : 0d05h46m16s
     Peer     : 2001:DB8:12::1
     Path/Ogn : ?
   i
     NextHop  : 2001:DB8:112::1                      Duration  : 0d05h46m17s
     Peer     : 2001:DB8:112::1
     Path/Ogn : ?
 *>i Network  : 2001:DB8:114::113                    PrefixLen : 128
     NextHop  : 2001:DB8:12::1                       Duration  : 0d05h46m17s
     Peer     : 2001:DB8:12::1
     Path/Ogn : ?
 * i
     NextHop  : 2001:DB8:112::1                      Duration  : 0d05h46m17s
     Peer     : 2001:DB8:112::1 
     Path/Ogn : ?
Table 2-534 Description of the display bgp ipv6 routing-table time-range command output
Item Description
BGP Local router ID is

Router ID of the local BGP device.

Network

Network address in the BGP4+ public network routing table.

PrefixLen

Prefix length.

NextHop

Next-hop address of the packet.

Duration

Route duration.

Peer

IP addresses of the peer.

Path/Ogn

AS_Path number and Origin attribute.

Prefix

IP prefix.

display bgp ipv6 routing-table(Attribute Filter)

Function

The display bgp ipv6 routing-table command displays information about BGP4+ public network routes based on specified multiple attribute filters.

Format

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

display bgp ipv6 routing-table community-filter { { community-filter-num | community-filter-numEx | community-filter-name } | { community-filter-num | community-filter-name } whole-match }

display bgp ipv6 routing-table large-community-filter largeComFilName [ whole-match ]

Parameters

Parameter Description Value
as-path-filter as-path-filter-num

Specifies the number of an AS_Path filter.

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

as-path-filter as-path-filter-name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

community-filter community-filter-name

Specifies the name of a community filter.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

community-filter community-filter-num

Specifies the number of a basic community filter.

The value is an integer ranging from 1 to 99.

community-filter community-filter-numEx

Specifies the number of an advanced community filter.

The value is an integer that ranges from 100 to 199.

whole-match

Matches the specified community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

large-community-filter largeComFilName

Specifies the name of a Large-Community filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query information about BGP4+ public network routes based on specified multiple attribute filters, run this command. Multiple attribute filters can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about BGP4+ routes that match community filter 10.
<HUAWEI> display bgp ipv6 routing-table community-filter 10
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 1
 *>     Network  : 2001:DB8:2::                             PrefixLen : 64  
        Nexthop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Community : <1:1>, <3:3>
# Display information about BGP4+ routes that match large community filter aaa.
<HUAWEI> display bgp ipv6 routing-table large-community-filter aaa
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 2
 *>     Network  : 2001:DB8:1::                             PrefixLen : 64  
        Nexthop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Large-Community : <1:1:1>, <2:2:2>
 *>     Network  : 2001:DB8:2::                             PrefixLen : 64  
        Nexthop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Large-Community : <1:1:1>, <2:2:2>
# Display information about BGP4+ routes that match AS path filter pas.
<HUAWEI> display bgp ipv6 routing-table as-path-filter pas
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 2
 *>     Network  : 2001:DB8:1::                             PrefixLen : 64  
        NextHop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Path/Ogn : 200i
 *>     Network  : 2001:DB8:2::                             PrefixLen : 64  
        NextHop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Path/Ogn : 200i
Table 2-535 Description of the display bgp ipv6 routing-table(Attribute Filter) command output
Item Description
BGP Local router ID is

Router ID of the local BGP device.

Total Number of Routes

Total number of routes.

Network

Network address in the BGP public network routing table.

PrefixLen

Prefix length.

Nexthop

Next hop address of the packet.

LocPrf

Local_Pref.

MED

MED of a route.

PrefVal

PrefVal of a BGP route.

Label

Label value.

Community

Community attribute of a route.

Large-Community

LargeCommunity attribute of a route.

Path/Ogn

AS_Path number and the origin attribute.

display bgp ipv6 routing-table(NLRI)

Function

The display bgp ipv6 routing-table command displays the routing information of the specified BGP4+ routes in public routing table.

Format

display bgp ipv6 routing-table ipv6-address [ mask-length ]

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer to be displayed.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

mask-length

Specifies the mask length of a network address.

It is an integer ranging from 0 to 128.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp instance vpnv4 all routing-table peer advertised-routes command is used to view active and inactive BGP VPNv4 routes and BGP VPN routes.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display details of IPv6 routes.
<HUAWEI> display bgp ipv6 routing-table 2001:DB8:9:3::1 64
 
 BGP local router ID : 3.3.3.3
 Local AS number : 65009
 Paths:   2 available, 1 best, 1 select, 0 best-external, 0 add-path
 BGP routing table entry information of 2001:DB8:9:3::/64:
 Network route.
 From: :: (0.0.0.0)  
 Route Duration: 1d11h38m10s
 Direct Out-interface: Loopback1
 Original nexthop: 2001:DB8:9:3::2
 Qos information : 0x0
 AS-path Nil, origin igp, MED 0, pref-val 0, valid, local, best, select, pre 0
 Advertised to such 1 peers:
    2001:DB8:9:3::1

 BGP routing table entry information of 2001:DB8:9:3::/64:
 From: 2001:DB8:9:3::1 (2.2.2.2)  
 Route Duration: 1d11h37m50s
 Relay IP Nexthop: 2001:DB8:9:3::1
 Relay IP Out-Interface: Loopback1
 Original nexthop: 2001:DB8:9:3::1
 Qos information : 0x0
 AS-path Nil, origin igp, MED 0, localpref 100, pref-val 0, internal, supernet, pre 255, invalid for super network
 Not advertised to any peer yet
Table 2-536 Description of the display bgp ipv6 routing-table(NLRI) command output
Item Description
BGP local router ID

Router ID of the local BGP device.

Local AS number

Local AS number.

Route Duration

Route duration.

Direct Out-interface

Directly connected outbound interface.

Original nexthop

Original next hop.

AS-path

AS_Path attribute. Nil indicates that the attribute value is null.

MED

Indicates the MED of the route.

Advertised to such 1 peer

Peers to which routes are advertised.

Relay IP Nexthop

Next hop for IP recursion.

Relay IP Out-Interface

Iterated outbound interface.

Not advertised to any peer yet

No route is advertised to the BGP peer.

Paths

Route selection result.

From

IP address of the router that sends the route.

display bgp ipv6 update-peer-group

Function

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

Format

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

Parameters

Parameter Description Value
index update-group-index

Specifies the index of an update peer-group.

The value is an integer ranging from 0 to 65535.

ipv6

Displays information about IPv6 BGP update peer-groups.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about all the update peer-groups in the IPv6 unicast address family on the public network.
<HUAWEI> display bgp ipv6 update-peer-group index 1
  Group ID : 1
  BGP Version : 4
  Group Type : internal 
  Addr Family : IPv6-UNC
  AdvMinTimeVal : 15
  Total Peers : 1
  Leader Peer : 2001:DB8:1:1::1:2 
  Total format packet number : 0
  Total send packet number : 0
  Total replicate packet number : 0 
  The replication percentages(%) : 0
  Peers List : 2001:DB8:1:1::1:2
Table 2-537 Description of the display bgp ipv6 update-peer-group command output
Item Description
Group ID

Update group ID of the BGP peer.

Group Type

Type of an update peer-group:

  • external: EBGP.
  • internal: IBGP.
  • unknown: unknown type.
BGP Version

BGP version.

Addr Family

Address family.

AdvMinTimeVal

Minimum route advertisement interval:

30 seconds for EBGP.

15 seconds for IBGP.

Total Peers

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

Total format packet number

Total format packet number.

Total send packet number

Total number of sent packets.

Total replicate packet number

Number of replicated packets. The value equals the total number of sent packets minus the total number of packets.

Peers List

List of peers.

Leader Peer

IP addresses of peers in an update peer-group.

The replication percentages(%)

Replication percentage: (Total number of sent packets - Total number of formatted packets) x 100/Total number of formatted packets.

display bgp network

Function

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

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp network

display bgp vpnv4 all network

display bgp vpnv4 vpn-instance vpn-instance-name network

For S6730-H-V2, S5732-H-V2:

display bgp instance instance-name vpnv4 all network

display bgp instance instance-name vpnv4 vpn-instance vpn-instance-name network

Parameters

Parameter Description Value
vpnv4

Displays the VPNv4 routes that are advertised using the network command.

-

all

Displays all the VPNv4 routes that are advertised using the network command.

-

vpn-instance vpn-instance-name

Displays the routes of a specified VPN instance that are advertised using the network command.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

instance instance-name

Specifies a BGP instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check the routes imported into the BGP routing table using the network command, run the display bgp network command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about routes that are imported using the network command.
<HUAWEI> display bgp network
BGP Local Router ID is 10.1.1.9
Local AS Number is 10(Public)

Network          Mask            Route-policy
10.2.0.0          255.255.0.0
10.0.0.0          255.0.0.0       Policy1
10.4.4.0          255.255.255.0
# Display information about BGP VPNv4 routes that are imported using the network command.
<HUAWEI> display bgp vpnv4 all network
BGP Local Router ID is 10.2.2.9
Local AS Number is 100

Route Distinguisher: 1:1
(vpn1)
Network          Mask            Route-policy
419.4.4.4          255.255.255.255

Route Distinguisher: 2:2
(vpn2)
Network          Mask            Route-policy
10.5.5.5          255.255.255.255
Table 2-538 Description of the display bgp network command output
Item Description
BGP Local Router ID is

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

Local AS Number is

Local AS number.

Router ID

Router ID of the device.

Network

Locally-imported network address.

Mask

Mask of the network address.

Route-policy

Route-policy.

Route Distinguisher

Route Distinguisher.

display bgp peer (or slow-peer)

Function

The display bgp peer command displays information about BGP peers.

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

Format

display bgp { peer | slow-peer }

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp peer command displays information about a BGP peer. You can run the command with the following parameters:

  • Check the status of BGP connections.
  • Displays the configuration of BGP peers.
  • After configuring BGP peers using the peer as-number command, check whether the configuration is successful.
  • To check whether a BGP peer is successfully deleted using the undo peer as-number command, run the display bgp peer as-number command.

    After slow BGP peer detection is enabled, you can run the display bgp slow-peer command to view information about slow BGP peers, the information includes the time when a peer starts to be considered as a slow peer, the time when a peer stops being considered as a slow peer last time, the number of times a peer is considered as a slow peer, and the remaining time of the switchback timer.

Precautions

When dynamic BGP peer relationships are being established or disconnected, statistics about the BGP peers may be inconsistent with the actual number of BGP peers. Therefore, you are advised to query statistics after the BGP peer status is stable.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP peer information.
<HUAWEI> display bgp peer

Status codes: * - Dynamic
 BGP local router ID : 10.2.3.4
 Local AS number : 10
 Total number of peers : 2                 
 Peers in established state : 1
 Total number of dynamic peers : 1

  Peer          V    AS  MsgRcvd  MsgSent  OutQ  Up/Down       State PrefRcv
  10.1.1.1       4   100        0        0     0 00:00:07        Idle       0
  10.2.2.2       4   200       32       35     0 00:17:49 Established       0
Table 2-539 Description of the display bgp peer (or slow-peer) command output
Item Description
BGP local router ID

Local router ID of BGP.

If the BGP local router IDs of the two ends conflict, the BGP peer relationship cannot be established. Run the router id command in the BGP view to change the router IDs to different values. Generally, the IP address of the loopback interface is used as the router ID of the local end.

Local AS number

Local AS number.

AS

AS number.

Total number of peers

Total number of BGP peers.

Total number of dynamic peers

Number of dynamic BGP peers.

Peers in established state

Number of BGP peers in Established state.

Peer

Peer IP address.

V

BGP version used on the peer.

MsgRcvd

Number of received messages.

MsgSent

Number of messages sent.

OutQ

Message to be sent to the specified peer.

Up/Down

Duration that the BGP session is in the current state.

  • If the duration is less than 24 hours, xx:xx:xx is displayed, indicating xx hours, xx minute, and xx seconds.
  • If the time is longer than 24 hours, xxxxhxxm is displayed, indicating xxxx hours and xx minutes.
State

Status of the peer:

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

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

  • Connect: indicates that BGP is waiting for the TCP connection to be set up before it determines whether to perform other operations.
  • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active.
  • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value, initiates a TCP connection request to the remote BGP peer, and stays in the Connect state.
  • Active: indicates that BGP tries to set up a TCP connection. This is the intermediate status of BGP.
  • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.
  • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value and changes its state to Connect.
  • If BGP initiates a TCP connection request with an unknown IP address, the TCP connection fails. When this occurs, BGP restarts the ConnectRetry Timer with the initial value and stays in the Active state.
  • OpenSent: indicates that BGP has sent one Open message to its peer and is waiting for the other Open message from the peer.
  • If there are no errors in the Open message received, BGP changes its state to OpenConfirm.
  • If there are errors in the Open message received, BGP sends a Notification message to the remote peer and changes its state to Idle.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active.
  • OpenConfirm: indicates that BGP is waiting for a Notification or Keepalive message.
  • If BGP receives a Notification message, or the TCP connection fails, BGP changes its state to Idle.
  • If BGP receives a Keepalive message, BGP changes its state to Established.
  • Established: indicates that BGP peers can exchange Update, Notification, and Keepalive messages.
  • If BGP receives an Update or a Keepalive message, its state stays in Established.
  • If BGP receives a Notification message, BGP changes its state to Idle.
  • No neg: The address family is not enabled for the BGP peer. In this state, Update messages can be exchanged in other address families whose capabilities have been successfully negotiated. If the address family is enabled for the BGP peer, the local BGP peer receives a Notification message, and the peer relationship is disconnected. Then, the BGP peer changes to the Idle state and re-establishes the peer relationship.
PrefRcv

Number of route prefixes received by the local peer from the remote peer.

Status codes

Status of a peer.

display bgp peer log-info

Function

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

Format

For S6730-H-V2, S5732-H-V2:

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

display bgp instance instance-name vpnv4 vpn-instance vpn-instance-name peer ipv4-address log-info

display bgp instance instance-name vpnv4 vpn-instance vpn-instance-name peer-group group-name log-info

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp peer { ipv4-address | group-name } log-info

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv4 vpn-instance vpn-instance-name peer ipv4-address log-info

display bgp all peer log-info

display bgp vpnv4 vpn-instance vpn-instance-name peer-group group-name log-info

Parameters

Parameter Description Value
log-info

Displays logs of a peer.

-

instance instance-name

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters. If spaces are used, the string must be enclosed in double quotation marks (" ").

peer ipv4-address

Specify an IPv4 peer address.

The value is in dotted decimal notation.

group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

vpnv4

Displays information about peers in a VPNv4 instance.

-

vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters without spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

peer-group

Specifies the peer-group.

-

all

Displays information about all peers.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp peer log-info command can be used for troubleshooting, with details as follows: If BGP peers are disconnected, specify log-info in the command to check the log information of the specified peer. In the command output, Date/Time indicates the time when the peers were disconnected, and Error Code and Error Subcode indicate the cause of the disconnection.

Example

The actual command output varies according to the device. The command output here is only an example.

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

Peer IP address.

Date/Time

Date/time.

State

Thread status.

Error Code

Error code.

For the meanings and possible causes of error codes, see BGP Principles - BGP NOTIFICATION Packets. These packets are used to process various errors in the BGP process.

Error Subcode

Error subcode.

For details about error subcodes and possible causes, see BGP Fundamentals - BGP Notification Messages. These messages are used to process various errors in the BGP process.

Notification

Notification message sent or received by a peer.

display bgp peer orf ip-prefix

Function

The display bgp peer orf ip-prefix command displays the prefix-based Outbound Route Filtering (ORF) learned from a specified peer.

Format

display bgp peer ipv4-address orf ip-prefix

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in the dotted decimal format.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

After a device successfully negotiates the ORF capability with its peer, you can run the display bgp peer orf ip-prefix command to view information about the prefix-based ORF learned from the peer.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the prefix-based ORF learned from a peer at 10.1.1.2.
<HUAWEI> display bgp peer 10.1.1.2 orf ip-prefix
Total number of ip-prefix received: 1
 Index  Action  Prefix           MaskLen  MinLen  MaxLen
 10     Permit  4.4.4.0          24       32      32
Table 2-541 Description of the display bgp peer orf ip-prefix command output
Item Description
Index

Index of an IP prefix list.

Action

Action associated with an IP prefix list:

  • deny.
  • permit.
Prefix

Prefix length.

MaskLen

Mask length of an IP prefix.

MinLen

Minimum mask length of an IP prefix.

MaxLen

Maximum mask length of an IP prefix.

display bgp peer statistics

Function

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

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp peer ipv4-address statistics

display bgp ipv6 peer ipv6-address statistics

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

For S6730-H-V2, S5732-H-V2:

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

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ipv6

Specify IPv6 unicast address-family.

-

ipv6-address

Specifies an IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

vpnv4

Indicates the VPNv4 address family.

-

all

Displays all information about VPNv6 and IPv6 VPN instances.

-

vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

instance instance-name

Specifies a BGP instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about routes learned from a specified peer.
<HUAWEI> display bgp peer 1.1.1.2 statistics
Peer 1.1.1.2, IPv4 Unicast
   Number of prefixes rejected by inbound policy         : 0
   Number of (known) duplicate prefix advertisements     : 6
   Number of (known) duplicate withdraws                 : 6
   Number of updates invalidated due to CLUSTER_LIST loop: 0
   Number of updates invalidated due to AS_PATH loop     : 0
   Number of updates invalidated due to ORIGINATOR_ID    : 0
   Number of updates invalidated due to AS_CONFED loop   : 0
   Number of routes in Adj-RIBs-In (pre-policy)          : 0
   Number of routes in Adj-RIBs-In (post-policy)         : 2
   Number of best routes in Loc-RIB                      : 1
Table 2-542 Description of the display bgp peer statistics command output
Item Description
Number of prefixes rejected by inbound policy

Number of routes that are filtered out by the import policy.

Number of (known) duplicate prefix advertisements

Number of times that a route is re-advertised.

Number of (known) duplicate withdraws

Number of times that a route is re-deleted.

Number of updates invalidated due to CLUSTER_LIST loop

Number of routes that are invalid because the local Cluster_ID exists in the Cluster_List.

Number of updates invalidated due to AS_PATH loop

Number of routes that are invalid because the local AS number exists in the AS_Path list.

Number of updates invalidated due to ORIGINATOR_ID

Number of routes that are invalid because their Originator_IDs are the same as the local router ID.

Number of updates invalidated due to AS_CONFED loop

Number of routes that are invalid because their AS_Path lists contain the AS number of the local confederation.

Number of routes in Adj-RIBs-In (pre-policy)

Number of all received routes.

Number of routes in Adj-RIBs-In (post-policy)

Number of routes that match the import policy.

Number of best routes in Loc-RIB

Total number of optimal routes in the routing table.

display bgp peer verbose

Function

The display bgp peer verbose command displays detailed information about BGP peers.

Format

display bgp peer ipv4-address verbose

display bgp peer verbose

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp peer command displays BGP peer detailed information. This command can be used for troubleshooting.

Example

The actual command output varies according to the device. The command output here is only an example.

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

BGP version.

BGP current state

State of BGP:

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

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

  • Connect: indicates that BGP is waiting for the TCP connection to be set up before it determines whether to perform other operations.
  • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active.
  • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value, initiates a TCP connection request to the remote BGP peer, and stays in the Connect state.
  • Active: indicates that BGP tries to set up a TCP connection. This is the intermediate status of BGP.
  • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.
  • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value and changes its state to Connect.
  • If BGP initiates a TCP connection request with an unknown IP address, the TCP connection fails. When this occurs, BGP restarts the ConnectRetry Timer with the initial value and stays in the Active state.
  • OpenSent: indicates that BGP has sent one Open message to its peer and is waiting for the other Open message from the peer.
  • If there are no errors in the Open message received, BGP changes its state to OpenConfirm.
  • If there are errors in the Open message received, BGP sends a Notification message to the remote peer and changes its state to Idle.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active.
  • OpenConfirm: indicates that BGP is waiting for a Notification or Keepalive message.
  • If BGP receives a Notification message, or the TCP connection fails, BGP changes its state to Idle.
  • If BGP receives a Keepalive message, BGP changes its state to Established.
  • Established: indicates that BGP peers can exchange Update, Notification, and Keepalive messages.
  • If BGP receives an Update or a Keepalive message, its state stays in Established.
  • If BGP receives a Notification message, BGP changes its state to Idle.
  • No neg: The address family is not enabled for the BGP peer. In this state, Update messages can be exchanged in other address families whose capabilities have been successfully negotiated. If the address family is enabled for the BGP peer, the local BGP peer receives a Notification message, and the peer relationship is disconnected. Then, the BGP peer changes to the Idle state and re-establishes the peer relationship.
BGP current event

Current BGP event.

BGP last state

State of last BGP stage, The possible states are Idle, Connect, Active, OpenSent, OpenConfirm, Established, and No neg.

BGP Peer Up count

Number of times the BGP peer flaps.

Peer optional capabilities

Optional capabilities supported by the peer.

Peer Preferred Value

PrefVal of the peer.

Peer limit state

Suppression status of the pipe for receiving packets from peers:

  • true: suppressed.
  • false: not suppressed.
Remote router ID

Router ID of the peer.

Update-group ID

ID of the Update group to which a peer belongs.

Received total routes

Number of received route prefixes.

Received active routes total

Number of active route prefixes received.

Received : Active Hold Time

Hold time of the peer.

Received

Number of messages received from the peerr:

  • Total: total number of records.
  • Update messages: indicates the number of Update messages.
  • Open messages: indicates the number of Open messages.
  • KeepAlive messages: indicates the number of Keepalive messages.
  • Notification messages: indicates the number of Notification messages.
  • Refresh messages: indicates the number of Route-refresh messages.
Advertised total routes

Number of route prefixes sent.

Keepalive Time

Interval at which Keepalive messages are sent to the peer.

Address family IPv4 Unicast

IPv4 unicast address family.

Authentication type configured

Authentication type that is configured.

Last keepalive received

Time when a Keepalive message was last received.

No routing policy is configured

No routing policy is configured.

Minimum route advertisement interval is 15 seconds

Minimum interval at which routes are advertised.

Optional capabilities

Optional capabilities of the peer.

Route refresh capability has been enabled

Route-refresh enabled.

Pipe limit percent

Rate limit percentage of the pipe for receiving neighbor packets.

Pipe limit count

Number of times rate limiting is performed on the pipe for receiving neighbor packets.

Pipe last limit time

Last time when the rate of the pipe for receiving neighbor packets was limited.

Routing policy configured

Configured routing policy.

Listen-only has been configured

The device listens for connection requests but does not initiate any connection.

Send best-external has been configured

The local device has been enabled to advertise Best External routes to a specified peer.

Add-path number

Number of optimal routes that the local device can send to the peer.

Peer's BFD has been enabled

BFD has been enabled on the peer.

TCP-MSS configured value

TCP MSS value used during TCP connection establishment. This field is displayed only after the peer tcp-mss command is configured.

Type

BGP link type (IBGP or EBGP).

Port

Port number.

  • Local: local port number. BGP uses TCP as the transport layer protocol and uses the fixed port number 179.
  • Remote: indicates the port number of the peer.
Configured

Locally configured timers:

  • Active Hold Time: If a BGP device does not receive a Keepalive message from its peer within the Hold Time, the BGP device considers the peer Down. In this case, the BGP device instructs other peers to withdraw the routes received from the peer that is Down.
  • Keep Alive Time: interval for sending KeepAlive messages to the peer. BGP peers send KeepAlive messages to each other periodically to notify each other that they are working normally.
Negotiated : Active Hold Time

Hold time negotiated by BGP peers.

Sent

Number of packets sent to peers:

  • Total: total number of records.
  • Update messages: indicates the number of Update messages.
  • Open messages: indicates the number of Open messages.
  • KeepAlive messages: indicates the number of Keepalive messages.
  • Notification messages: indicates the number of Notification messages.
  • Refresh messages: indicates the number of Route-refresh messages.
Negotiated

Negotiated value of the timer.

display bgp router-id

Function

The display bgp router-id command displays the router ID.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

For S6730-H-V2, S5732-H-V2:

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Specifies the ID of a device in a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

instance bgpName

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check router IDs on the public network and in the VPN instance, run the display bgp router-id command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the ID of a router in the VPN instance.
<HUAWEI> display bgp router-id vpn-instance vrf1
 VPN-Instance Name                RouterID
 vrf1                             3.3.3.3
# Display the Router ID of a device on the public network.
<HUAWEI> display bgp router-id
BGP RouterID:2.2.2.2
Table 2-544 Description of the display bgp router-id command output
Item Description
VPN-Instance Name

VPN instance name.

RouterID

Router ID.

BGP RouterID

Router ID on the public network.

display bgp routing-table (condition)

Function

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

Format

display bgp routing-table network { mask-length | mask }

display bgp routing-table network { mask-length | mask } longer-prefixes

Parameters

Parameter Description Value
network

Specifies a destination IPv4 address.

It is in dotted decimal notation.

mask-length

Specifies the mask length of the destination IP address.

The value is an integer in the range from 0 to 32.

mask

Specifies the mask of an IPv4 address.

The value is in dotted decimal notation.

longer-prefixes

Matches according to the mask longer than the specified length.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To view the information about routes in the BGP routing table, run the display bgp routing-table command with specified parameters.

Precautions

If a routing loop occurs, some routes may have not converged when you run the display bgp ipv6 routing-table statistics command. Therefore, the route statistics displayed using the command may be different from the actual number.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display public network routes.
<HUAWEI> display bgp routing-table 10.1.1.1
 
 BGP local router ID : 10.1.1.2
 Local AS number : 100
 Paths:   1 available, 1 best, 1 select, 0 best-external, 0 add-path
 BGP routing table entry information of 10.1.1.1/32:
 Label information (Received/Applied): 48073/NULL
 From: 10.10.1.1 (10.1.1.2)  
 Route Duration: 0d00h45m10s
 Relay IP Nexthop: 10.1.1.1
 Relay IP Out-Interface: Loopback0
 Relay Tunnel Out-Interface: Loopback0
 Original nexthop: 10.10.1.1
 Qos information : 0x0
 Community: <1:1>
 Ext-Community: Color <0 : 3>
 Large-Community: <1:1:1>
 AS-path Nil, origin incomplete, MED 33, localpref 100, pref-val 0, valid, internal, best, select, pre 255, IGP cost 10
 Originator: 10.3.1.1
 Cluster list: 0.0.0.100
 Not advertised to any peer yet
Table 2-545 Description of the display bgp routing-table (condition) command output
Item Description
Route Duration

Timestamp of a route.

Relay IP Nexthop

Relay IP Nexthop.

Relay Tunnel Out-Interface

Name of the tunnel to which a route recurses.

IP Out-Interface

Name of a route's outbound interface.

MED

MED of the route.

Cluster list

Cluster_List.

Origin

Route origin.

From

Source peer for route advertisement.

display bgp routing-table (ipv4-address)

Function

The display bgp routing-table command displays information about BGP routes with specified destinations.

Format

display bgp routing-table ipv4-address

Parameters

Parameter Description Value
ipv4-address

Specifies a destination IPv4 address.

The value is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To view the BGP routes with specified destinations, run the display bgp routing-table command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the routing information with specified destination in BGP public network.
<HUAWEI> display bgp routing-table 10.1.1.1
 BGP local router ID : 192.168.2.2
 Local AS number : 100
 Paths:   1 available, 1 best, 1 select, 0 best-external, 0 add-path
 BGP routing table entry information of 10.1.1.1/32:
 From: 10.1.3.1 (192.168.2.3)
 Route Duration: 0d00h01m33s
 Direct Out-interface: 10GE1/0/1
 Relay is delayed as nexthop flapped frequently
 Original nexthop: 10.1.3.1
 Qos information : 0x0
 Primary Routing Table: vrf1
 AS-path 200, origin incomplete, MED 0, pref-val 0, valid, external, best, select, active, pre 255
 Advertised to such 1 peers:
    10.1.3.1
Table 2-546 Description of the display bgp routing-table (ipv4-address) command output
Item Description
BGP local router ID

Router ID of the local BGP device.

BGP routing table entry information of

Routing entry information.

Local AS number

Local AS number.

Route Duration

Route duration.

Relay is delayed as nexthop flapped frequently

Route recursion to a specified next hop is suppressed because the next hop flaps. If the number of routes is small, the suppression period may be too short. In this case, this field is not displayed in the command output.

Original nexthop

Original next hop.

Qos information

QoS information.

AS-path

AS_Path attribute. Nil indicates that the attribute value is null.

MED

MED (Multi-Exit-Discriminator): determines the optimal route for traffic entering an AS. In the case of the same other conditions, the route with the smallest MED value is selected as the optimal route.

pref-val

PrefVal of a BGP route.

pre

BGP route priority.

Advertised to such 1 peers

Peers to which routes are advertised.

Direct Out-interface

Directly connected outbound interface.

Primary Routing Table

Source routing table.

Paths

Route selection result.

From

IP address of the router that sends the route.

Origin

Origin attribute of a BGP route:

  • IGP: indicates that the route is added to the BGP routing table using the network command.
  • EGP: indicates that the route is obtained using EGP.
  • Incomplete: indicates that the route source is unknown. For example a route is imported using the import-route command.
valid

Valid route.

best

The BGP route is an optimal route.

select

Preferred route.

active

Active route.

The field is displayed only after the active-route-advertise command is run.

external

External route.

display bgp routing-table (public)

Function

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

The display bgp routing-table command displays BGP public network routes.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp routing-table peer ipv4-address received-routes

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp routing-table peer ipv6-address received-routes

Parameters

Parameter Description Value
peer ipv4-address

Displays the IPv4 address of a peer on which public network routes are to be displayed.

The value is in dotted decimal notation.

received-routes

Displays the public network routes received from a specified peer.

-

ipv6-address

Specifies the IPv6 address of a peer.

NOTE:

This parameter is supported only on the S5735-L-V2, S5735-S-V2 and S5735I-S-V2.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Precautions

To simulate an XPL route-filter to query BGP routes, run the xpl simulate enable command before running the display bgp routing-table route-filter command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display detailed routes information advertised to a specified peer.
<HUAWEI> display bgp routing-table peer 10.1.1.1 advertised-routes 10.9.9.9
BGP local router ID : 10.1.1.2
 Local AS number : 100
 BGP routing table entry information of 10.9.9.9/32:
 Label information (Received/Applied): 7505/NULL
 From: 172.16.1.3 (172.16.1.3)  
 Route Duration: 3d05h25m45s
 Relay IP Nexthop: 172.16.1.3
 Relay IP Out-interface: 10GE1/0/1
 Original nexthop: 172.16.1.3
 Advertised nexthop: 10.1.1.2
 Qos information : 0x0            
 AS-path Nil, origin incomplete, MED 0, localpref 100, pref-val 0, valid, internal, best, select, pre 255
 Advertised to such 4 peers:
    10.3.1.1
    10.1.1.1
    10.2.1.1
    172.16.1.3
# Display detailed information of the specified routes.
<HUAWEI> display bgp routing-table 10.1.1.1
BGP local router ID : 192.168.2.2
 Local AS number : 100
 Paths:   1 available, 1 best, 1 select, 0 best-external, 0 add-path
 BGP routing table entry information of 10.1.1.1/32:
 From: 10.1.3.1 (192.168.2.3)
 Route Duration: 0d00h01m33s
 Direct Out-interface: 10GE1/0/1
 Relay is delayed as nexthop flapped frequently
 Original nexthop: 10.1.3.1
 Qos information : 0x0
 Primary Routing Table: vrf1
 AS-path 200, origin incomplete, MED 0, pref-val 0, valid, external, best, select, active, pre 255
 Advertised to such 1 peers:
    10.1.3.1
Table 2-547 Description of the display bgp routing-table (public) command output
Item Description
BGP routing table entry information of

Routing Entry Info.

BGP local router ID

ID of the local BGP device.

Local AS number

Local AS number.

Label information (Received/Applied)

Label information (received label/advertised label).

Route Duration

Route duration.

Relay is delayed as nexthop flapped frequently

Route recursion to a specified next hop is suppressed because the next hop flaps. If the number of routes is small, the suppression period may be too short. In this case, this field is not displayed in the command output.

Relay IP Nexthop

IP recursive next hop.

Original nexthop

Original next hop.

Qos information

Qos information.

MED

MED of the route.

Advertised to such 1 peers

Peers to which routes are sent.

Advertised nexthop

Advertisement next hop.

Direct Out-interface

Directly connected outbound interface.

Primary Routing Table

Source routing table.

Paths

Route selection result.

From

IP address of the route advertiser.

display bgp routing-table (Route Attributes)

Function

The display bgp vpnv4 routing-table command displays information about BGP VPNv4 routes and BGP VPN routes.

The display bgp routing-table command displays information about BGP public network routes.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

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

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

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

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

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

For S6730-H-V2, S5732-H-V2:

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

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

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

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

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

mask

Specifies a mask.

The value is in dotted decimal notation.

mask-length

Length of IP address mask.

The value is an integer ranging from 0 to 32.

as-path

Displays AS_Path attribute information.

-

community-list

Displays the community attribute contained in a route.

-

large-community

Displays the routes with the specified BGP Large-Community in the routing table.

-

ext-community

Displays the extended community list of the route.

-

cluster-list

Displays the cluster list of a route.

-

advertised-peer

Displays the list of the peers for which a route is destined.

-

all

Displays all the VPNv4 and VPN instance routes.

-

vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

peer remoteIpv4Addr

Displays the IPv4 address of a peer on which public network routes are to be displayed.

The value is in dotted decimal notation.

advertised-routes

Displays public network routes advertised to a specified peer.

-

instance instance-name

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp instance vpnv4 all routing-table peer advertised-routes command is used to view active and inactive BGP VPNv4 routes and BGP VPN routes.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display AS_Path information contained in BGP public network routes.
<HUAWEI> display bgp routing-table 192.168.1.1 24 as-path
BGP routing table entry information of 192.168.1.0/24:
 From: 192.168.1.1
 AS-path 100
# Display the Large-Community attributes of all routes in the BGP routing table.
<HUAWEI> display bgp routing-table 192.168.1.1 24 large-community
BGP routing table entry information of 192.168.1.1/24:
 Aggregated oute.
 Large-community: 200:1:1>, 300:1:1>
# Display the community attributes of all routes in the BGP public network routing table.
<HUAWEI> display bgp routing-table 192.168.1.1 24 community-list
BGP routing table entry information of 192.168.1.0/24:
 From: 192.168.1.1
 Community: <400:1>
Table 2-548 Description of the display bgp routing-table (Route Attributes) command output
Item Description
BGP routing table entry information

The following information is about a specified BGP routing entry.

AS-path

AS_Path attribute.

Nil indicates that the attribute value is null.

From

IP address of the device that advertised routes.

Community

Community attribute of the route.

Large-community

Large-community attribute information.

display bgp routing-table cidr

Function

The display bgp routing-table cidr command displays classless inter-domain routing (CIDR) information about BGP routes.

Format

display bgp routing-table cidr

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To view the classless inter-domain routing (CIDR) information about BGP routes, run the display bgp routing-table cidr command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Displays classless inter-domain routing (CIDR) information about BGP routes.
<HUAWEI> display bgp routing-table cidr
 BGP Local router ID is 10.1.3.2
 Status codes: * - valid, > - best, d - damped, h - history,
               i - internal, s - suppressed, S - Stale
 Origin      : i - IGP, e - EGP, ? - incomplete


 Total Number of Routes: 2
        Network            NextHop                       MED        LocPrf    PrefVal Path/Ogn
 *>     10.1.3.1/32        0.0.0.0                        0                     0       ?
 *>     10.1.3.2/32        0.0.0.0                        0                     0       ?
Table 2-549 Description of the display bgp routing-table cidr command output
Item Description
BGP Local router ID is

Router ID of the local BGP device.

Status codes

The codes of status.

Origin

Origin attribute of a BGP route:

  • IGP: indicates that the route is added to the BGP routing table using the network command.
  • EGP: indicates that the route is obtained using EGP.
  • Incomplete: indicates that the route source is unknown. For example a route is imported using the import-route command.
Total Number of Routes

The total number of BGP routes.

Network

Indicates the network address in the BGP routing table.

NextHop

Next hop address used to forward the packet.

MED

Indicates the MED of the route.

LocPrf

Local preference of a route.

PrefVal

PrefVal of a BGP route.

Path/Ogn

AS-Path number and the Origin attribute.

display bgp routing-table cidr (vpnv4/labeled)

Function

The display bgp vpnv4 routing-table cidr command displays information about classless inter-domain routing (CIDR).

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

For S6730-H-V2, S5732-H-V2:

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

Parameters

Parameter Description Value
cidr

Displays information about classless inter-domain routing (CIDR) routes.

-

all

Displays statistics about all BGP VPNv4 routes.

-

vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

instance instance-name

Specifies a BGP instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv4 routing-table cidr command displays information about classless inter-domain routing (CIDR).

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about classless inter-domain routing (CIDR) routes in the BGP-VPNv4 address family.
<HUAWEI> display bgp vpnv4 all routing-table cidr
   BGP Local router ID is 192.168.7.1
   Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
                 h - history, i - internal, s - suppressed, S - Stale
                 Origin : i - IGP, e - EGP, ? - incomplete
   RPKI validation codes: V - valid, I - invalid, N - not-found
   Total number of routes from all PE: 3
   Route Distinguisher: 100:1 
        Network            NextHop        MED        LocPrf    PrefVal Path/Ogn
   *>   1.1.1.1/32         0.0.0.0         0                     0      ?
   Route Distinguisher: 200:1
        Network            NextHop        MED        LocPrf    PrefVal Path/Ogn
   *>i 1.1.1.1/32         192.168.100.10 0          100        0      33 55?
   *>i 2.2.2.2/32         192.168.100.10 0          100        0      33 55?
  VPN-Instance vrf1, router ID 1.1.1.9:
   Total number of routes: 3
        Network            NextHop        MED        LocPrf    PrefVal Path/Ogn
   *>   1.1.1.1/32         0.0.0.0         0                     0      ?
   * i                     192.168.100.10  0          100        0      33 55?
   *>i  2.2.2.2/32         192.168.100.10  0          100        0      33 55?
Table 2-550 Description of the display bgp routing-table cidr (vpnv4/labeled) command output
Item Description
Total number of routes from all PE

Number of routes from all Pes.

Total number of routes

Total number of routes.

Route Distinguisher

Specified RD.

Network

Indicates the network address in the BGP routing table.

NextHop

Next hop address used to forward the packet.

MED

Indicates the MED of the route.

LocPrf

Local preference of a route.

Path/Ogn

Indicates the AS_Path number and the Origin attribute of the route.

display bgp routing-table dampened

Function

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

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

For S6730-H-V2, S5732-H-V2:

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

Parameters

Parameter Description Value
statistics

Displays statistics about BGP routes.

-

dampened

BGP-dampened routes.

-

vpnv4

Displays the BGP routes of a VPNv4 instance.

-

vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

instance instance-name

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To view the information about BGP dampened routes, run the display bgp routing-table dampened command with specified parameters.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP dampened routes.
<HUAWEI> display bgp routing-table dampened
 BGP Local router ID is 10.0.0.2
 Status codes: * - valid, > - best, d - damped, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
 Origin      : i - IGP, e - EGP, ? - incomplete
 Total Number of Routes: 5
   Network           From              Reuse     Path/Origin
 d 10.1.0.0          10.110.156.30     00:09:33  700 i
 d 10.2.0.0          10.110.156.30     00:09:33  700 i
 d 10.3.0.0          10.110.156.30     00:09:33  700 i
 d 10.4.0.0          10.110.156.30     00:09:33  700 i
 d 10.5.0.0          10.110.156.30     00:09:33  700 i
Table 2-551 Description of the display bgp routing-table dampened command output
Item Description
Total Number of Routes

Total number of dampened routes.

Network

Indicates the network address in the BGP routing table.

From

IP address of the peer from which the route is learned.

Reuse

Reuse value (in seconds).

Path

AS_Path and Origin attributes of a route.

display bgp routing-table dampening parameter

Function

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

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp routing-table dampening parameter

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

For S6730-H-V2, S5732-H-V2:

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

vpnv4

Displays the BGP route dampening parameters of a VPNv4 instance.

-

instance instance-name

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check configured BGP route dampening parameters, run the display bgp routing-table dampening parameter command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the BGP VPNv4 route dampening parameters.
<HUAWEI> display bgp vpnv4 all routing-table dampening parameter
 Maximum Suppress Time(in second)  : 3973
 Ceiling Value                     : 16000
 Reuse Value                       : 750
 HalfLife Time(in second)          : 900
 Suppress-Limit                    : 2000
# Display the BGP instance VPNv4 route dampening parameters.
<HUAWEI> display bgp instance aaa vpnv4 all routing-table dampening parameter
 Maximum Suppress Time(in second) : 3973
 Ceiling Value                    : 16000
 Reuse Value                      : 750
 HalfLife Time(in  second)        : 900
 Suppress-Limit                   : 2000
# Display BGP route dampening parameters.
<HUAWEI> display bgp routing-table dampening parameter
Maximum Suppress Time(in second) : 3973
Ceiling Value                    : 16000
Reuse Value                      : 750
HalfLife Time(in  second)        : 900
Suppress-Limit                   : 2000
Table 2-552 Description of the display bgp routing-table dampening parameter command output
Item Description
Maximum Suppress Time(in second)

Maximum route suppression time, in seconds.

Ceiling Value

Indicates the penalty ceiling.

Reuse Value

Threshold for the routes to be unsuppressed.

HalfLife Time(in second)

Half life of a reachable route, in seconds.

Suppress-Limit

Indicates the threshold for a route to be suppressed.

display bgp routing-table different-origin-as

Function

The display bgp vpnv4 routing-table different-origin-as command displays information about routes with the same destination address&mask but originating from different origin ASs.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table different-origin-as

For S6730-H-V2, S5732-H-V2:

display bgp instance instance-name vpnv4 { all | vpn-instance vpn-instance-name } routing-table different-origin-as

Parameters

Parameter Description Value
different-origin-as

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

-

all

Displays statistics about all BGP VPNv4 routes.

-

vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

instance instance-name

Specifies a BGP instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv4 routing-table different-origin-as command displays information about routes with the same destination address&mask but originating from different origin ASs.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about the routes with the same destination address but different origin AS numbers in the BGP-VPNv4 address family.
<HUAWEI> display bgp vpnv4 all routing-table different-origin-as
 
 Total number of routes from all PE: 0
Table 2-553 Description of the display bgp routing-table different-origin-as command output
Item Description
Total number of routes from all PE

Total number of BGP routes received by the router from its peer PEs.

display bgp routing-table different-origin-as (public)

Function

The display bgp routing-table different-origin-as command displays BGP routes that have the same destination address but different source AS numbers.

Format

display bgp routing-table different-origin-as

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To view the BGP routes that have the same destination address but different source AS numbers, run the display bgp routing-table different-origin-as command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP routes that have the same destination address but different source AS numbers.
<HUAWEI> display bgp routing-table different-origin-as
 BGP Local router ID is 10.1.3.1
 Status codes: * - valid, > - best, d - damped, h - history,
               i - internal, s - suppressed, S - Stale
 Origin      : i - IGP, e - EGP, ? - incomplete


 Total Number of Routes: 2
        Network            NextHop                       MED        LocPrf    PrefVal Path/Ogn
 *>     10.2.1.0/24        0.0.0.0                        0                     0       i
 *                         10.17.1.1                      1                     0      300?
Table 2-554 Description of the display bgp routing-table different-origin-as (public) command output
Item Description
BGP Local router ID is

Router ID of the local BGP device.

Status codes

The codes of status.

Origin

Origin attribute of a BGP route:

  • IGP: indicates that the route is added to the BGP routing table using the network command.
  • EGP: indicates that the route is obtained using EGP.
  • Incomplete: indicates that the route source is unknown. For example a route is imported using the import-route command.
Total Number of Routes

The total number of BGP routes.

Network

Indicates the network address in the BGP routing table.

NextHop

Next hop address used to forward the packet.

MED

Indicates the MED of the route.

LocPrf

Local preference of a route.

PrefVal

PrefVal of a BGP route.

Path/Ogn

AS-Path number and the Origin attribute.

display bgp routing-table flap-info

Function

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

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

display bgp vpnv6 vpn-instance vpn-instance-name routing-table flap-info [ as-path-filter { as-path-filter-number | as-path-filter-name } | regular-expression as-regular-expression | ipv6-address [ prefix-length [ longer-match ] ] ]

For S6730-H-V2, S5732-H-V2:

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

display bgp instance instance-name vpnv6 vpn-instance vpn-instance-name routing-table flap-info [ as-path-filter { as-path-filter-number | as-path-filter-name } | regular-expression as-regular-expression | ipv6-address [ prefix-length [ longer-match ] ] ]

Parameters

Parameter Description Value
as-path-filter as-path-filter-name

Specifies an AS_Path filter name (a string of 1 to 51 characters, which cannot contain only digits.).

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

as-path-filter as-path-filter-number

Specifies an AS_Path filter index.

The value is a decimal integer ranging from 1 to 256.

regular-expression as-regular-expression

Displays the routes that match the regular expression.

The value is a string of 1 to 80 characters.

ipv4-address

Specify an IPv4 network address.

The value is in dotted decimal notation.

mask

Specifies an IPv4 network mask.

The value is in dotted decimal notation.

mask-length

Specifies an IP address prefix length.

The value is an integer ranging from 0 to 32.

longer-match

Allows match against longer masks.

-

vpnv4

Indicates the VPNv4 address family.

-

vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

vpnv6

VPNv6 address-family.

-

ipv6-address

Specifies an ipv6 network address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

prefix-length

Length of the mask.

It is an integer ranging from 0 to 128.

instance instance-name

Specifies a BGP instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To view statistics about BGP route flapping, run the display bgp routing-table flap-info command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the flapping statistics of EBGP peers.
<HUAWEI> display bgp routing-table flap-info

 BGP Local router ID is 10.20.200.201
 Status codes: * - valid, > - best, d - damped, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
 Origin      : i - IGP, e - EGP, ? - incomplete

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

 d  172.16.1.0       10.20.200.200   5      00:00:36  00:40:47  600i
 d  172.16.2.0       10.20.200.200   5      00:00:36  00:40:47  600i
 d  172.16.3.0       10.20.200.200   5      00:00:36  00:40:47  600i
 d  172.16.4.0       10.20.200.200   5      00:00:36  00:40:47  600i
 d  172.16.5.0       10.20.200.200   5      00:00:36  00:40:47  600i
# Display the flapping statistics of IBGP peers.
<HUAWEI> display bgp routing-table flap-info

 BGP Local router ID is 10.20.200.201
 Status codes: * - valid, > - best, d - damped, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
 Origin      : i - IGP, e - EGP, ? - incomplete

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

 di  172.16.1.0       10.20.200.200   5      00:00:36  00:40:47  600i
 di  172.16.2.0       10.20.200.200   5      00:00:36  00:40:47  600i
 di  172.16.3.0       10.20.200.200   5      00:00:36  00:40:47  600i
 di  172.16.4.0       10.20.200.200   5      00:00:36  00:40:47  600i
 di  172.16.5.0       10.20.200.200   5      00:00:36  00:40:47  600i
Table 2-555 Description of the display bgp routing-table flap-info command output
Item Description
BGP Local router ID

ID of the local BGP device, in the same format as an IPv4 address.

Total Number of Routes

Number of flapping routes.

Network

Indicates the network address in the BGP routing table.

From

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

Flaps

Total number of route flappings.

Duration

Total duration of route flapping.

Reuse

Reuse value.

Path/Ogn

AS_Path and Origin.

display bgp routing-table peer

Function

The display bgp routing-table peer command displays the BGP routing information of a specified peer.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

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

display bgp vpnv4 all routing-table peer remoteIpv4Addr { accepted-routes | not-accepted-routes }

display bgp routing-table peer remoteIpv4Addr advertised-routes [ statistics ]

display bgp routing-table peer remoteIpv4Addr received-routes statistics

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table peer remoteIpv4Addr advertised-routes [ statistics ]

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table peer remoteIpv4Addr received-routes [ statistics ]

display bgp routing-table peer remoteIpv4Addr received-routes active [ statistics ]

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

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

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

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

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

For S6730-H-V2, S5732-H-V2:

display bgp instance instance-name vpnv4 { all | vpn-instance vpn-instance-name } routing-table peer remoteIpv4Addr advertised-routes [ statistics ]

display bgp instance instance-name vpnv4 { all | vpn-instance vpn-instance-name } routing-table peer remoteIpv4Addr received-routes [ statistics ]

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

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

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

Parameters

Parameter Description Value
advertised-routes

Indicates the routes advertised to the peer.

-

statistics

Displays route statistics.

-

vpnv4

Indicates the VPNv4 address family.

-

all

Display all information on VPNv4 and VPN instance.

-

ipv4-address

Specify an IPv4 network address.

The value is in dotted decimal notation.

mask-length

Specifies an IP address prefix length.

The value is an integer ranging from 0 to 32.

mask

Specifies an IPv4 network mask.

The value is in dotted decimal notation.

longer-prefixes

Allows longer mask matching. The queried route data is filtered, and the number of routes is not filtered.

-

received-routes

Displays routes received from the remote peer.

-

active

Displays active routes from the remote peer.

-

accepted-routes

Displays the routes that match a routing policy.

-

not-accepted-routes

Displays the routes that do not match a routing policy.

-

remoteIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

original-attributes

Displays original route attributes.

-

vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

instance instance-name

Specifies a BGP instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp routing-table peer command displays the BGP routing information of a specified peer. You can view only specific routing information by specifying different parameters.

Precautions

This command does not display the default routes that are advertised to peers using the peer default-route-advertise command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about BGP routes received from a specified peer, with the routes carrying a specified destination address and the entropy label.
<HUAWEI> display bgp routing-table peer 10.1.1.1 received-routes 10.1.1.1

 BGP local router ID : 10.2.2.2
 Local AS number : 100
 BGP routing table entry information of 10.1.1.1/32:
 RR-client route.
 Label information (Received/Applied): 48288/NULL
 From: 10.1.1.1 (10.1.1.1)
 Route Duration: 0d05h28m03s
 Relay IP Nexthop: 10.2.2.2
 Relay IP Out-Interface: Tunnel1
 Relay Tunnel Out-Interface:
 Original nexthop: 10.1.1.1
 Qos information : 0x0
 Community: <1:1>
 Ext-Community: Color <0 : 3>
 Large-Community: <1:1:1>
 Entropy-label padding value : AB 6A F2
 AS-path Nil, origin igp, MED 0, localpref 100, pref-val 0, valid, internal, best, select, supernet, pre 255, IGP cost 1
 Originator: 10.3.1.1
 Cluster list: 0.0.0.100
 Not advertised to any peer yet
# Display the BGP routing information accepted from a specified peer.
<HUAWEI> display bgp routing-table peer 10.1.1.1 accepted-routes
BGP Local router ID is 10.1.1.2
Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
 h - history, i - internal, s - suppressed, S - Stale
 Origin : i - IGP, e - EGP, ? - incomplete
RPKI validation codes: V - valid, I - invalid, N - not-found

Total Number of Routes: 3 
 Network NextHop MED LocPrf PrefVal Path/Ogn
*>i 10.9.9.9/32 10.1.1.2 0 100 0 ?
* ixa 10.1.1.2 0 100 0 ?
* i a 10.1.1.2 0 100 0 ?
Table 2-556 Description of the display bgp routing-table peer command output
Item Description
BGP Local router ID

Router ID of the local BGP device.

Label information (Received/Applied)

Label information, including received and sent labels.

Relay IP Nexthop

IP address of the next hop to which a route is recursed.

Relay Tunnel Out-Interface

Name of the tunnel to which a route recurses.

Qos information

Indicates QoS information.

Entropy-label padding value

Entropy label attribute value.

This field is displayed only after the entropy-label command is run.

MED

MED of the route.

Cluster list

Cluster_List.

Origin

Indicates the origin of the route.

Total Number of Routes

Total number of received, advertised, received, or unreceived routes.

Network

Route prefix.

LocPrf

Local_Pref of the route.

PrefVal

PrefVal of the route.

Nexthop

Nexthop IP address.

From

Indicates the source peer for route advertisement.

Community

Community attribute of the route.

Originator

Router ID of the route originator.

Remote Router ID

Router ID of the peer.

Ext-Community

Extended community attribute.

display bgp routing-table relay-nexthop interface

Function

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

Format

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

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 address.

The value is in dotted decimal notation.

mask-length

Specifies the mask of an IPv4 address.

The value is an integer ranging from 0 to 32.

mask-ipv4

Specifies the mask of an IPv4 address.

The value is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about the recursion of routes to 6.6.6.6.
<HUAWEI> display bgp routing-table 10.6.6.6 relay-nexthop interface

 BGP routing table entry information of 10.6.6.6/32:
 From: 10.10.1.2 (10.5.1.2)
 Relay Type: Route Relay
 Relay Nexthop: 10.10.3.2
 Original nexthop: 10.6.6.6
 Relay Out Interface: Eth-trunk1.66

 From: 10.10.1.2 (10.5.1.2)
 Relay Type: Route Relay
 Relay Nexthop: 10.10.2.2
 Original nexthop: 10.6.6.6
 Relay Out Interface: Eth-trunk1.65
Table 2-557 Description of the display bgp routing-table relay-nexthop interface command output
Item Description
Relay Type

Recursion type.

Relay Nexthop

Recursive next hop.

Relay Out Interface

Outbound interface used in the recursion.

Original nexthop

Original next hop of the route.

From

IP address of the peer from which the route is received.

display bgp routing-table statistics

Function

The display bgp routing-table statistics command displays related information about BGP route statistics.

Format

display bgp routing-table statistics active

display bgp routing-table statistics cidr

display bgp routing-table statistics different-origin-as

Parameters

Parameter Description Value
statistics

Displays statistics about BGP routes.

-

cidr

Displays classless inter-domain routing (CIDR) information.

-

different-origin-as

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

-

active

Displays statistics about active routes.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

When you need to view the statistics of BGP routes, run this command and specify the required parameters.

Precautions

During route flapping, the route statistics may differ from the actual number of routes on the network because some routes are on the way and have not arrived.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display active route statistics.
<HUAWEI> display bgp routing-table statistics active

 Total Number of Prefix Advertised to RM : 2
 Total Number of Active Route : 2
Table 2-558 Description of the display bgp routing-table statistics command output
Item Description
Total Number of Routes

Number of routes in the routing table.

Total Number of Prefix Advertised to RM

Number of routes delivered to the RM module.

Total Number of Active Route

Number of active routes.

Total Number of Best Routes

Number of optimal routes.

Total Number of Best-external Routes

Number of best-external routes.

Total Number of Cidr Routes

Number of CIDR routes.

Total Number of Community Routes

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

Total Number of Different-origin-as Routes

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

Total Number of Dampened Routes

Number of dampened BGP routes.

display bgp routing-table statistics(Attribute Filter)

Function

The display bgp routing-table statistics command displays BGP public network route statistics based on multiple attribute filters.

Format

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

display bgp routing-table statistics community-filter { { community-filter-num | community-filter-numEx | community-filter-name } | { community-filter-num | community-filter-name } whole-match }

display bgp routing-table statistics large-community-filter largeComFilName [ whole-match ]

Parameters

Parameter Description Value
statistics

Displays statistics about BGP routes.

-

as-path-filter as-path-filter-num

Specifies the number of the matched AS_Path filter.

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

as-path-filter as-path-filter-name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. It cannot contain spaces.

community-filter community-filter-name

Specifies the name of a community filter.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

community-filter community-filter-num

Specifies the number of a basic community filter.

The value is an integer ranging from 1 to 99.

community-filter community-filter-numEx

Specifies the number of an advanced community filter.

The value is an integer ranging from 100 to 199.

whole-match

Matches the specified community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

large-community-filter largeComFilName

Specifies the name of a Large-Community filter.

The value is a string of 1 to 51 case-sensitive characters. It cannot contain spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query statistics about BGP public network routes based on specified multiple attribute filters, run this command. Multiple attribute filters can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about BGP public network route matching the AS_Path filter pas.
<HUAWEI> display bgp routing-table statistics as-path-filter pas
 Total Number of Routes: 2
# Display statistics about the BGP routes that match community filter 10.
<HUAWEI> display bgp routing-table statistics community-filter 10
 Total Number of Routes: 1
# Display statistics about the BGP routes that match the Large-community filter aaa.
<HUAWEI> display bgp routing-table statistics large-community-filter aaa
 Total Number of Routes: 2
Table 2-559 Description of the display bgp routing-table statistics(Attribute Filter) command output
Item Description
Total Number of Routes

Total number of routes.

display bgp routing-table statistics(Attribute)

Function

To check statistics about BGP public network routes, run the display bgp routing-table statistics command. You can specify multiple attribute values to query the route statistics as required.

Format

display bgp routing-table statistics

display bgp routing-table statistics regular-expression strRegular

display bgp routing-table statistics community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> [ whole-match ]

display bgp routing-table statistics large-community [ largeCommuStr ] &<1-33> [ whole-match ]

Parameters

Parameter Description Value
statistics

Displays statistics about BGP routes.

The value is a string of 1 to 80 characters.

community communityNum

Specifies a community number.

The value is an integer ranging from 0 to 4294967295.

community strCommunityNum

Specifies a community number.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

internet

Displays the BGP public network routes carrying the internet community attribute.

-

no-advertise

Displays the BGP routes carrying the No-Advertise community attribute.

-

no-export

Displays the BGP routes carrying the No-Export community attribute.

-

no-export-subconfed

Displays the BGP routes carrying the No-Export-Subconfed community attribute.

-

g-shut

Display routes with the Grateful-Shutdown community attribute.

-

whole-match

Indicates that the specified community attribute is fully matched.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

large-community largeCommuStr

Specifies the value of the Large-Community attribute.

The value is a string of 5 to 32 case-sensitive characters, spaces not supported.

regular-expression strRegular

Specifies an AS_Path regular expression.

The value is a string of 1 to 80 characters.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query statistics about BGP public network routes based on specified multiple attribute values, run this command. Multiple attribute values can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP public network route statistics.
<HUAWEI> display bgp routing-table statistics
 Total Number of Routes: 5
# Display BGP public network route statistics with community attributes.
<HUAWEI> display bgp routing-table statistics community
 Total Number of Routes: 3
# Display statistics about BGP public network route with the Large-Community attribute.
<HUAWEI> display bgp routing-table statistics large-community
 Total Number of Routes: 2
# Display BGP public network route statistics that match the AS regular expression ^20.
<HUAWEI> display bgp routing-table statistics regular-expression ^20
 Total Number of Routes: 1
Table 2-560 Description of the display bgp routing-table statistics(Attribute) command output
Item Description
Total Number of Routes

Total number of routes in the routing table.

display bgp routing-table time-range

Function

The display bgp routing-table time-range command displays the BGP routes that flap within the specified period.

Format

display bgp routing-table peer remoteIpv4Addr { received-routes time-range time-range-start time-range-end | advertised-routes time-range time-range-start time-range-end }

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

Parameters

Parameter Description Value
received-routes

Displays the public network routes received from a specified peer.

-

time-range time-range-start time-range-end

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

Both start-time and end-time are in the format of xxdxxhxxmxxs. d indicates the day, which is an integer ranging from 0 to 10000. h indicates the hour, which is an integer ranging from 0 to 23. m indicates the minute, which is an integer ranging from 0 to 59. s indicates the second, which is an integer ranging from 0 to 59.

advertised-routes

Displays the public network routes advertised to a specified peer.

-

peer remoteIpv4Addr

Displays the public network routes of a specified peer.

The value is in the dotted decimal format.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

Using the display bgp routing-table time-range command, you can view the BGP routes that flap within the specified period. For example, if service traffic is abnormal or CPU usage of the device remains high within a period, you can run this command to check whether route flapping occurs within the period. The faulty route can be viewed in the command output, facilitating fault location.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP routes that flap within the specified period.
<HUAWEI> display bgp routing-table time-range 0d0h5m3s 1d1h1m1s
BGP Local router ID is 10.1.1.2
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found

        Network            NextHop         Peer                                      Duration        Path/Ogn

 *>i    10.1.1.2/32         10.1.1.2        10.1.1.2                                  0d01h42m09s        ?
 * i                       10.2.1.2        10.2.1.2                                  0d01h42m09s        ?
 *>i    10.1.1.3/32         10.1.1.2        10.1.1.2                                  0d01h42m09s        ?
 * i                       10.2.1.2        10.2.1.2                                  0d01h42m09s        ?
 *>i    10.1.1.4/32         10.1.1.2        10.1.1.2                                  0d01h42m09s        ?
 * i                       10.2.1.2        10.2.1.2                                  0d01h42m09s        ?
 *>     10.2.3.4/32         0.0.0.0         0.0.0.0                                   0d01h42m39s        ?
 *>i    10.10.10.10/32     10.1.1.2        10.1.1.2                                  0d01h42m09s        ?
 * i                       10.2.1.2        10.2.1.2                                  0d01h42m09s        ?
Table 2-561 Description of the display bgp routing-table time-range command output
Item Description
BGP Local router ID is

Router ID of the local BGP device.

Network

Network address in the BGP routing table.

NextHop

Next-hop address used to send packets.

Peer

Peer IP address.

Duration

Route duration.

Path/Ogn

AS-Path number and the Origin attribute.

display bgp routing-table verbose

Function

The display bgp routing-table verbose command displays detailed information about BGP routes.

Format

display bgp routing-table verbose

display bgp ipv6 routing-table verbose

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

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table verbose

Parameters

Parameter Description Value
ipv6

Indicates the IPv6 unicast address family.

-

vpnv4

Indicates the VPNv4 address family.

-

all

Specifies all VPN instances.

-

vpn-instance vpn-instance-name

Specifies a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. In addition, the VPN instance name must not be _public_. The character string can contain spaces if it is enclosed in double quotation marks ("").

vpnv6

Indicates the VPNv6 address family.

-

Views

All views

Default Level

3: Management level

Usage Guidelines

Usage Scenario

To check detailed information about all BGP IPv4 public network routes, run the display bgp routing-table verbose command.

To check detailed information about all BGP IPv6 public network routes, run the display bgp ipv6 routing-table verbose command.

To check detailed information about routes in the BGP-VPNv4 address family, run the display bgp vpnv4 all routing-table verbose command.

To check detailed information about routes in the BGP-VPNv6 address family, run the display bgp vpnv6 all routing-table verbose command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display detailed information about all VPN routes in the BGP-VPNv6 address family.
<HUAWEI> display bgp vpnv6 all routing-table verbose
 
 Total number of routes from all PE: 4
 
 BGP local router ID : 10.0.12.2
 Local AS number : 100
 
 Total routes of Route Distinguisher(1:100): 1
 BGP routing table entry information of 2001:DB8:2003::/64:
 Label information (Received/Applied): 48122/48127
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m32s
 Direct Out-interface:  Eth-trunk1
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: ::FFFF:10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <1 : 1>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Advertised to such 1 peers:
    10.1.1.1
 
 Total routes of Route Distinguisher(2:200): 3
 BGP routing table entry information of 2001:DB8:2003::/64:
 Label information (Received/Applied): 48123/48128
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m32s
 Direct Out-interface:  Eth-trunk1
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: ::FFFF:10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <2 : 2>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Advertised to such 1 peers:
    10.1.1.1

 BGP routing table entry information of 2001:DB8:2222::/64:
 Label information (Received/Applied): 48124/48129
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m32s
 Direct Out-interface:  Eth-trunk1
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: ::FFFF:10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <2 : 2>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Advertised to such 1 peers:
    10.1.1.1

 BGP routing table entry information of 2001:DB8:2223::/64:
 Label information (Received/Applied): 48125/48130
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m32s
 Direct Out-interface:  Eth-trunk1
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: ::FFFF:10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <2 : 2>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Advertised to such 1 peers:
    10.1.1.1

 VPN-Instance 1, Router ID 10.0.12.2:

 Total Number of Routes: 1
 BGP routing table entry information of 2001:DB8:2003::/64:
 Route Distinguisher: 1:100
 Remote-Cross route
 Label information (Received/Applied): 48122/NULL
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m32s
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: ::FFFF:10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <1 : 1>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Not advertised to any peer yet

 VPN-Instance 2, Router ID 10.0.12.2:

 Total Number of Routes: 3
 BGP routing table entry information of 2001:DB8:2003::/64:
 Route Distinguisher: 2:200
 Remote-Cross route
 Label information (Received/Applied): 48123/NULL
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m32s
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: ::FFFF:10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <2 : 2>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Not advertised to any peer yet

 BGP routing table entry information of 2001:DB8:2222::/64:
 Route Distinguisher: 2:200
 Remote-Cross route
 Label information (Received/Applied): 48124/NULL
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m32s
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: ::FFFF:10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <2 : 2>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Not advertised to any peer yet

 BGP routing table entry information of 2001:DB8:2223::/64:
 Route Distinguisher: 2:200
 Remote-Cross route
 Label information (Received/Applied): 48125/NULL
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m32s
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: ::FFFF:10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <2 : 2>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Not advertised to any peer yet
# Display detailed information about all routes in the BGP-VPNv6 address family of a specified VPN instance.
<HUAWEI> display bgp vpnv6 vpn-instance 1 routing-table verbose

 VPN-Instance 1, Router ID 10.0.12.2:

 Total Number of Routes: 1
 
 BGP local router ID : 10.0.12.2
 Local AS number : 100
 Paths:   1 available, 1 best, 1 select, 0 best-external, 0 add-path
 BGP routing table entry information of 2001:DB8:2003::/64:
 Route Distinguisher: 1:100
 Remote-Cross route
 Label information (Received/Applied): 48122/NULL
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m31s
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: ::FFFF:10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <1 : 1>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Not advertised to any peer yet
# Display detailed information about all VPN routes in the BGP-VPNv4 address family.
<HUAWEI> display bgp vpnv4 all routing-table verbose
 
 Total number of routes from all PE: 4
 
 BGP local router ID : 10.0.12.2
 Local AS number : 100
 
 Total routes of Route Distinguisher(1:100): 1
 BGP routing table entry information of 10.0.3.0/24:
 Label information (Received/Applied): 48126/48123
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m31s
 Direct Out-interface:  Eth-trunk1
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: 10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <1 : 1>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Advertised to such 1 peers:
    10.1.1.1
 
 Total routes of Route Distinguisher(2:200): 3
 BGP routing table entry information of 10.0.3.0/24:
 Label information (Received/Applied): 48127/48124
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m31s
 Direct Out-interface:  Eth-trunk1
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: 10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <2 : 2>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Advertised to such 1 peers:
    10.1.1.1

 BGP routing table entry information of 10.22.22.0/24:
 Label information (Received/Applied): 48128/48125
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m31s
 Direct Out-interface:  Eth-trunk1
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: 10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <2 : 2>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Advertised to such 1 peers:
    10.1.1.1

 BGP routing table entry information of 10.23.23.0/24:
 Label information (Received/Applied): 48129/48126
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m31s
 Direct Out-interface:  Eth-trunk1
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: 10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <2 : 2>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Advertised to such 1 peers:
    10.1.1.1

 VPN-Instance 1, Router ID 10.0.12.2:

 Total Number of Routes: 1
 BGP routing table entry information of 10.0.3.0/24:
 Route Distinguisher: 1:100
 Remote-Cross route
 Label information (Received/Applied): 48126/NULL
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m31s
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: 10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <1 : 1>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Not advertised to any peer yet

 VPN-Instance 2, Router ID 10.0.12.2:

 Total Number of Routes: 3
 BGP routing table entry information of 10.0.3.0/24:
 Route Distinguisher: 2:200
 Remote-Cross route
 Label information (Received/Applied): 48127/NULL
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m31s
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: 10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <2 : 2>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Not advertised to any peer yet

 BGP routing table entry information of 10.22.22.0/24:
 Route Distinguisher: 2:200
 Remote-Cross route
 Label information (Received/Applied): 48128/NULL
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m31s
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: 10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <2 : 2>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Not advertised to any peer yet

 BGP routing table entry information of 10.23.23.0/24:
 Route Distinguisher: 2:200
 Remote-Cross route
 Label information (Received/Applied): 48129/NULL
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m31s
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: 10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <2 : 2>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Not advertised to any peer yet
# Display detailed information about all routes in the BGP-VPNv4 address family of a specified VPN instance.
<HUAWEI> display bgp vpnv4 vpn-instance 1 routing-table verbose

 VPN-Instance 1, Router ID 10.0.12.2:

 Total Number of Routes: 1
 
 BGP local router ID : 10.0.12.2
 Local AS number : 100
 Paths:   1 available, 1 best, 1 select, 0 best-external, 0 add-path
 BGP routing table entry information of 10.0.3.0/24:
 Route Distinguisher: 1:100
 Remote-Cross route
 Label information (Received/Applied): 48126/NULL
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m31s
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: 10.0.23.3
 Qos information : 0x0
 Ext-Community: RT <1 : 1>
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Not advertised to any peer yet
# Display detailed information about all BGP IPv6 public network routes.
<HUAWEI> display bgp ipv6 routing-table verbose

 Total Number of Routes: 2
 
 BGP local router ID : 10.0.12.2
 Local AS number : 100
 Paths:   1 available, 1 best, 1 select, 0 best-external, 0 add-path
 BGP routing table entry information of 2001:DB8:2003::/64:
 From: 2001:DB8:2023::3 (10.0.23.3)  
 Route Duration: 0d00h13m30s
 Direct Out-interface:  Eth-trunk1
 Original nexthop: 2001:DB8:2023::3
 Qos information : 0x0
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Not advertised to any peer yet
 
 BGP local router ID : 10.0.12.2
 Local AS number : 100
 Paths:   1 available, 1 best, 1 select, 0 best-external, 0 add-path
 BGP routing table entry information of 2001:DB8:2005::/64:
 From: 2001:DB8:2023::3 (10.0.23.3)  
 Route Duration: 0d00h13m30s
 Direct Out-interface:  Eth-trunk1
 Original nexthop: 2001:DB8:2023::3
 Qos information : 0x0
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Not advertised to any peer yet
# Display detailed information about BGP IPv4 public network routes.
<HUAWEI> display bgp routing-table verbose

 Total Number of Routes: 1
 
 BGP local router ID : 10.0.12.2
 Local AS number : 100
 Paths:   1 available, 1 best, 1 select, 0 best-external, 0 add-path
 BGP routing table entry information of 10.0.3.0/24:
 Label information (Received/Applied): 48130/48122
 From: 10.0.23.3 (10.0.23.3)  
 Route Duration: 0d00h13m31s
 Direct Out-interface:  Eth-trunk1
 Relay Tunnel Out-Interface:  Eth-trunk1
 Original nexthop: 10.0.23.3
 Qos information : 0x0
 AS-path 200, origin igp, MED 0, pref-val 1, valid, external, best, select, pre 255
 Advertised to such 1 peers:
    10.1.1.1
Table 2-562 Description of the display bgp routing-table verbose command output
Item Description
Total Number of Routes

Total number of routes in the routing table.

Total number of routes from all PE

Total number of current routes.

BGP local router ID

Router ID of the local BGP device.

BGP routing table entry information of

Routing entry information.

Local AS number

Local AS number.

Route Duration

Route duration.

Route Distinguisher

Route distinguisher.

Label information (Received/Applied)

Information about labels, including received and sent labels.

Relay Tunnel Out-Interface

Recursive tunnel outbound interface.

Original nexthop

Original next hop ddress used to forward packets.

Qos information

Qos information.

AS-path

Number of the AS that the route passes through.

MED

MED.

pref-val

PrefVal of a route.

pre

EXP value.

Advertised to such 1 peers

Information about the device that sends the peer information.

Remote-Cross route

Remotely leaked route.

Not advertised to any peer yet

Not advertised to any peer yet.

Ext-Community

Extended community attribute contained in a route.

Origin

Origin attribute of a BGP route It is classified into the following types:

  • IGP: If a route is added to the BGP routing table using the network command, its origin is IGP.
  • EGP: The Origin attribute of the route obtained through EGP is EGP.
  • Incomplete: The origin of the route cannot be identified. For example, the Origin attribute of the routes imported by BGP through the import-route command is Incomplete.
select

Preferred route.

best

Optimal route.

valid

Valid route.

From

Origin of the route.

Paths

Route selection result.

display bgp routing-table(Attribute Filter)

Function

The display bgp routing-table command displays BGP public network route information based on specified multiple attribute filters.

Format

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

display bgp routing-table community-filter { { community-filter-num | community-filter-numEx | community-filter-name } | { community-filter-num | community-filter-name } whole-match }

display bgp routing-table large-community-filter largeComFilName [ whole-match ]

Parameters

Parameter Description Value
as-path-filter as-path-filter-num

Specifies the number of an AS_Path filter.

It is an integer ranging from 1 to 256.

as-path-filter as-path-filter-name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

community-filter community-filter-name

Specifies the name of a community filter.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

community-filter community-filter-num

Specifies the number of a basic community filter.

The value is an integer ranging from 1 to 99.

community-filter community-filter-numEx

Specifies the number of an advanced community filter.

The value is an integer ranging from 100 to 199.

whole-match

Indicates that the specified attribute filter is fully matched.

-

large-community-filter largeComFilName

Specifies the name of a Large-Community filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query information about BGP public network routes based on specified multiple attribute filters, run this command. Multiple attribute filters can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the BGP routes that match community filter 10.
<HUAWEI> display bgp routing-table community-filter 10
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


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

 *>     10.1.2.0/24        10.1.123.2                     0                     0      <1:1>, <3:3>
# Display the BGP routes that match the Large-community filter aaa.
<HUAWEI> display bgp routing-table large-community-filter aaa
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 2
        Network            NextHop                       MED        LocPrf    PrefVal LargeCommunity

 *>     10.1.1.0/24        10.1.123.2                     0                     0      <1:1:1>, <2:2:2>
 *>     10.1.2.0/24        10.1.123.2                     0                     0      <1:1:1>, <2:2:2>
# Display BGP routes that match the AS_Path filter named pas.
<HUAWEI> display bgp routing-table as-path-filter pas
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 2
        Network            NextHop                       MED        LocPrf    PrefVal Path/Ogn

 *>     10.1.1.0/24        10.1.123.2                     0                     0      200i
 *>     10.1.2.0/24        10.1.123.2                     0                     0      200i
Table 2-563 Description of the display bgp routing-table(Attribute Filter) command output
Item Description
BGP Local router ID is

Router ID of the local BGP device.

Total Number of Routes

Total number of routes.

Network

Indicates the network address in the BGP routing table.

NextHop

Next hop address used to forward the packet.

MED

Indicates the MED of the route.

LocPrf

Local preference of a route.

PrefVal

PrefVal of a BGP route.

Community

Community attribute contained in a route.

LargeCommunity

Large-Community attribute of a route.

Path/Ogn

AS-Path number and the Origin attribute.

display bgp routing-table(Attribute)

Function

The display bgp routing-table command displays BGP public network route information based on specified attribute values.

Format

display bgp routing-table

display bgp routing-table regular-expression strRegular

display bgp routing-table community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> [ whole-match ]

display bgp routing-table large-community [ largeCommuStr ] &<1-33> [ whole-match ]

Parameters

Parameter Description Value
community communityNum

Specify community number.

The value is an integer ranging from 0 to 4294967295.

community strCommunityNum

Specify community number.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

internet

Displays the BGP public network routes carrying the internet community attribute.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

no-advertise

Displays the BGP routes carrying the No-Advertise community attribute.

-

no-export

Displays the BGP public network routes carrying the No-Export community attribute.

-

no-export-subconfed

Displays the BGP routes carrying the No-Export-Subconfed community attribute.

-

g-shut

Display routes with the Grateful-Shutdown community attribute.

-

whole-match

Matches the specified community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

large-community largeCommuStr

Specifies the value of the Large-Community attribute.

The value is a string of 5 to 32 case-sensitive characters, spaces not supported.

regular-expression strRegular

Specifies an AS_Path regular expression.

The value is a string of 1 to 80 characters.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query information about BGP public network routes based on specified multiple attribute values, run this command. Multiple attribute values can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about all BGP public network routes.
<HUAWEI> display bgp routing-table
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 2
        Network            NextHop                       MED        LocPrf    PrefVal Path/Ogn

 *>     10.1.1.0/24        10.1.123.2                     0                     0      200i
 *>     10.1.2.0/24        10.1.123.2                     0                     0      200i
# Display information about BGP public network routes with community attributes.
<HUAWEI> display bgp routing-table community
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


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

 *>     10.1.1.0/24        10.1.123.2                     0                     0      <1:1>, <2:2>
 *>     10.1.2.0/24        10.1.123.2                     0                     0      <1:1>, <3:3>
# Display information about BGP public network routes with the Large-Community attribute.
<HUAWEI> display bgp routing-table large-community
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 2
        Network            NextHop                       MED        LocPrf    PrefVal LargeCommunity

 *>     10.1.1.0/24        10.1.123.2                     0                     0      <1:1:1>, <2:2:2>
 *>     10.1.2.0/24        10.1.123.2                     0                     0      <1:1:1>, <2:2:2>
# Display the BGP public network route information that matches the AS regular expression ^20.
<HUAWEI> display bgp routing-table regular-expression ^20
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 2
        Network            NextHop                       MED        LocPrf    PrefVal Path/Ogn

 *>     10.1.1.0/24        10.1.123.2                     0                     0      200i
 *>     10.1.2.0/24        10.1.123.2                     0                     0      200i
Table 2-564 Description of the display bgp routing-table(Attribute) command output
Item Description
BGP Local router ID is

Router ID of the local BGP device.

Total Number of Routes

Total number of routes.

Network

Indicates the network address in the BGP routing table.

NextHop

Next hop address used to forward the packet.

MED

Indicates the MED of the route.

LocPrf

Local preference of a route.

PrefVal

PrefVal of a BGP route.

Path/Ogn

AS-Path number and the Origin attribute.

Community

Community attribute contained in a route.

LargeCommunity

Large-Community attribute of a route.

display bgp routing-table(vpnv4/labeled)

Function

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

The display bgp vpnv4 routing-table command displays information about BGP VPNv4 routes and BGP VPN routes.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv4 vpn-instance vpn-instance-name routing-table [ peer ipv4-address { received-routes | advertised-routes } ] time-range start-time end-time

display bgp vpnv4 all routing-table [ peer ipv4-address { received-routes | advertised-routes } ] time-range start-time end-time

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

For S6730-H-V2, S5732-H-V2:

display bgp instance instance-name vpnv4 vpn-instance vpn-instance-name routing-table time-range start-time end-time

display bgp instance instance-name vpnv4 all routing-table time-range start-time end-time

Parameters

Parameter Description Value
instance instance-name

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

all

Displays statistics about all BGP VPNv4 routes.

-

route-distinguisher route-distinguisher

Displays statistics about the BGP routes with a specified RD.

The RD can be in any of the following formats:

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

The AS number and the user-defined number cannot both be 0s. That is, an RD cannot be 0.0:0.

  • IPv4 address:2-byte user-defined number, for example, 192.168.122.15:1. The IP address ranges from 0.0.0.0 to 255.255.255.255, and the user-defined number is an integer ranging from 0 to 65535.
vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

time-range start-time

Specifies a starting time ([0-10000]d[0-23]h[0-59]m[0-59]s).

The value is an integer ranging from 0 to 4294967295.

time-range end-time

Ending time ([0-10000]d[0-23]h[0-59]m[0-59]s).

The value is an integer ranging from 0 to 4294967295.

peer ipv4-address

Displays information about the routes of a specified peer.

The value is in dotted decimal notation.

received-routes

Displays information about the routes received from the specified peer.

-

advertised-routes

Displays the routes advertised to a specified peer.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To display the labeled routes in the BGP routing table, run display bgp routing-table label command.

To display information about BGP VPNv4 routes and BGP VPN routes, run display bgp vpnv4 routing-table command.

Precautions

This command does not display the default routes that are advertised to peers using the peer default-route-advertise command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the BGP labeled routes of all VPN instances.
<HUAWEI> display bgp vpnv4 all routing-table label
BGP Local router ID is 10.1.1.9
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
 Origin      : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found

 Total number of routes from all PE: 3
 Route Distinguisher: 100:1
        Network           NextHop           In/Out Label
 *>i    10.22.22.22       10.3.3.9           NULL/1036

 Route Distinguisher: 100:4
        Network           NextHop           In/Out Label
 *>     10.2.3.0          10.2.3.1          1037/NULL
 *>     10.11.11.11       10.0.0.11         1038/NULL

 VPN-Instance vpn1, router ID 10.1.1.9:
 Total Number of Routes: 1
        Network           NextHop           In/Out Label
 *>i    10.22.22.22       10.3.3.9          NULL/1036
 VPN-Instance vpn2, router ID 10.1.1.9:
 Total Number of Routes: 0
Table 2-565 Description of the display bgp routing-table(vpnv4/labeled) command output
Item Description
BGP Local router ID is

Router ID of the local BGP device.

Total number of routes from all PE

Number of routes from all Pes.

Total Number of Routes

Total number of routes.

Route Distinguisher

Route distinguisher (RD).

Network

Network address in the BGP labeled routing table.

NextHop

Next hop address used to forward the packet.

In/Out Label

Values of the incoming and outgoing labels.

display bgp troubleshooting

Function

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

Format

display bgp troubleshooting

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the cause of BGP peer relationship disconnection or flapping.
<HUAWEI> display bgp troubleshooting
Total counts: 2 
--------------------------------------------------------------------------------  
Sequence   Time                      Event Description 
-------------------------------------------------------------------------------- 

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

Number of BGP peer relationship disconnection times.

Sequence

Sequence number of a record.

Time

Time when a BGP peer relationship was disconnected.

Event Description

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

display bgp update-peer-group

Function

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

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

For S6730-H-V2, S5732-H-V2:

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

Parameters

Parameter Description Value
vpnv4

Displays information about the BGP update peer-groups of a VPNv4 instance.

-

vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

all

Displays information about all the update peer-groups in current address family.

-

index index-value

Specifies the index of an update peer-group.

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

instance instance-name

Specifies the name of a BGP instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about the update peer-group with a specified index.
<HUAWEI> display bgp update-peer-group index 0
 Group ID : 0
 BGP Version : 4
 Group Type : external
 Addr Family : IPv4-UNC
 Total Peers : 1
 AdvMinTimeVal : 30
 Leader Peer : 192.168.1.2

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

 Peers List : 192.168.1.2
# Display information about the update peer-groups in a specified address family.
<HUAWEI> display bgp update-peer-group
The Public instance's update peer group number : 1
 Keep buffer update peer group number : 0
 BGP Version : 4

 Update peer group number :1 
 Group ID : 0 
 Group Type : external 
 Addr Family : IPv4-UNC 
 AdvMinTimeVal : 30 
 Total Peers : 1 
 Leader Peer : 192.168.1.2 
 Peers List : 192.168.1.2
Table 2-567 Description of the display bgp update-peer-group command output
Item Description
The Public instance's update peer group number

Number of update peer-groups in an instance.

The replication percentages(%)

Replication percentage: (Total number of sent packets - Total number of formatted packets) x 100/Total number of formatted packets.

Keep buffer update peer group number

Number of update peer-groups stored in the batch buffer.

BGP Version

BGP version.

Group ID

Update group ID of the BGP peer.

Group Type

Type of an update peer-group:

  • external: EBGP.
  • internal: IBGP.
  • unknown: unknown type.
Addr Family

Address family.

AdvMinTimeVal

Minimum route advertisement interval:

30 seconds for EBGP.

15 seconds for IBGP.

Total Peers

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

Total format packet number

Total format packet number.

Total send packet number

Total number of sent packets.

Total replicate packet number

Number of replicated packets. The value equals the total number of sent packets minus the total number of packets.

Peers List

List of peers.

Leader Peer

IP addresses of peers in an update peer-group.

Update peer group number

Number of update peer-groups.

display bgp vpn-instance group

Function

The display bgp vpn-instance group command displays information about BGP peer groups in a specified VPN instance.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

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

For S6730-H-V2, S5732-H-V2:

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

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Displays information about BGP peer groups in a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

vpnv4

Displays information about BGP VPNv4 peer groups.

-

instance instance-name

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

The

display bgp vpn-instance group command displays information about BGP peer groups in a specified VPN instance, including peers in the peer group and configuration information about the peer group. The

display bgp vpn-instance group command is used in the following scenarios:

  • Verify the configuration after a peer group is configured using the group command.
  • Verify the configuration after a peer is added to a peer group using the peer group command.
  • Verify the configuration after a peer is deleted from a peer group using the undo peer group command.
  • Verify the configuration after modifying the configuration of a peer group.

Precautions

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

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about a BGP peer group in a specified VPN instance.
<HUAWEI> display bgp instance aaa vpnv4 vpn-instance vpn3 group

 BGP peer-group: ccc
 Remote AS number isn't specified
 VPN-Instance(IPv4-family): vpn3
 
 Authentication type configured: None
 Type : external
 PeerSession Members: 
 10.1.1.2                                 

 Peer Members: 
 10.1.1.2
<HUAWEI> display bgp vpnv4 vpn-instance vpn2 group

 BGP peer-group: bb
 Remote AS number isn't specified
 VPN-Instance(IPv4-family): vpn2
 
 Authentication type configured: None
 Type : external
 PeerSession Members: 
 10.1.1.2                                 

 Peer Members: 
 10.1.1.2
Table 2-568 Description of the display bgp vpn-instance group command output
Item Description
BGP peer-group

BGP peer group name.

Remote AS

Number of the AS where a peer group resides.

AS

Number of the AS where a member of a peer group resides.

Authentication type configured

BGP authentication type:

  • MD5.
  • None: indicates that no BGP authentication is configured.
Type

Type of a peer group:

  • internal: IBGP peer group.
  • external: EBGP peer group.
PeerSession Members

Peers with which sessions have been established.

Peer Members

The following information is about peers.

Peer

IP addresses of the peer.

V

BGP version.

display bgp vpn-instance peer

Function

The display bgp vpn-instance peer command displays information about BGP peers in a specified VPN instance.

The display bgp vpn-instance slow-peer command displays information about slow BGP peers in a specified VPN instance.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv4 vpn-instance vpn-instance-name peer

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

For S6730-H-V2, S5732-H-V2:

display bgp instance instance-name vpnv4 vpn-instance vpn-instance-name peer

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

vpnv4

Specifies a BGP-VPNv4 address family.

-

instance instance-name

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpn-instance peer command displays information about BGP peers in a specified VPN instance. You can implement the following operations based on the command output:

  • To check the status of BGP connections
  • To check information about a BGP peer
  • To check whether a BGP peer is configured using the peer as-number command
  • To check whether a BGP peer is deleted using the undo peer as-number command

    The display bgp vpn-instance peer command can be used for troubleshooting, with details as follows: If BGP peers are disconnected, specify log-info in the command to check the log information of the specified peer. In the command output, Date/Time indicates the time when the peers were disconnected, and Error Code and Error Subcode indicate the cause of the disconnection.

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about the BGP peer of the VPN instance vrf1.
<HUAWEI> display bgp vpnv4 vpn-instance vrf1 peer
Status codes: * - Dynamic
 BGP local router ID : 1.1.1.9
 Local AS number : 100
 Total number of peers : 1                 
 Peers in established state : 1
 Total number of dynamic peers : 1
Peer        V    AS  MsgRcvd  MsgSent  OutQ  Up/Down       State PrefRcv

  10.1.1.1    4 65410      207      192     0 02:59:49 Established       1
Table 2-569 Description of the display bgp vpn-instance peer command output
Item Description
BGP local router ID

Router ID of the local BGP device.

Local AS number

Local AS number.

AS

AS number.

Total number of peers

Number of BGP peers.

Total number of dynamic peers

Number of dynamic BGP peers.

Peers in established state

Number of BGP peers in the Established state.

Peer

Peer IP address.

V

BGP version used on the peer.

MsgRcvd

Number of received messages.

MsgSent

Number of sent messages.

OutQ

Message to be sent to the specified peer.

Up/Down

Duration in which the BGP session remains in the current state.

State

Peer relationship status:

  • Idle: BGP denies any connection request, which is BGP's initial state.
  • Active: BGP attempts to set up a TCP connection, which is BGP's intermediate state.
  • Established: BGP peers can exchange Update, Notification, and Keepalive messages.
  • Connect: BGP is waiting for the complete setup of the TCP connection before performing subsequent operations.
  • OpenSent: BGP is waiting for an Open message from the peer.
  • OpenConfirm: BGP is waiting for a Notification message or a Keepalive message.
PrefRcv

Number of route prefixes sent from the peer.

display bgp vpn-instance peer verbose

Function

The display bgp vpn-instance peer verbose command displays detailed information about BGP peers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

display bgp vpnv4 vpn-instance vpn-instance-name peer verbose

display bgp vpnv4 vpn-instance vpn-instance-name peer ipv4-address verbose

display bgp instance instance-name vpnv4 vpn-instance vpn-instance-name peer verbose

display bgp instance instance-name vpnv4 vpn-instance vpn-instance-name peer ipv4-address verbose

Parameters

Parameter Description Value
verbose

Displays detailed information about peers.

-

vpnv4

Displays information about peers in a VPNv4 instance.

-

vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

ipv4-address

Specify an IPv4 peer address.

The value is in dotted decimal notation.

instance instance-name

Specifies the BGP multi-instance name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp peer verbose command displays BGP peer detailed information. You can implement the following operations based on the command output:

  • To check the status of BGP connections
  • To check information about a BGP peer
  • To check whether a BGP peer is configured using the peer as-number command
  • To check whether a BGP peer is deleted using the undo peer as-number command

Precautions

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

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display detailed information about the BGP peer of the VPN instance vrf.
<HUAWEI> display bgp vpnv4 vpn-instance vrf peer verbose

         BGP Peer is 10.1.1.2,  remote AS 200
         Type: EBGP link
         BGP version 4, Remote router ID 10.1.1.2
         Update-group ID: 5
         BGP current state: Established, Up for 00h00m52s
         BGP current event: KATimerExpired
         BGP last state: OpenConfirm
         BGP Peer Up count: 1
         Received total routes: 0
         Received active routes total: 0
         Advertised total routes: 0
         Port: Local - 179        Remote - 50525
         Configured: Connect-retry Time: 32 sec
         Configured: Min Hold Time: 0 sec
         Configured: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Received  : Active Hold Time: 180 sec
         Negotiated: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Peer optional capabilities:
         Peer supports bgp multi-protocol extension
         Peer supports bgp route refresh capability
         Peer supports bgp 4-byte-as capability
         Address family IPv4 Unicast: advertised and received
 Received: Total 4 messages
                  Update messages                1
                  Open messages                  1
                  KeepAlive messages             2
                  Notification messages          0
                  Refresh messages               0
 Sent: Total 4 messages
                  Update messages                1
                  Open messages                  1
                  KeepAlive messages             2
                  Notification messages          0
                  Refresh messages               0
 Authentication type configured: None
 Last keepalive received: 2020-01-28 13:37:29+00:00
 Last keepalive sent    : 2020-01-28 13:37:32+00:00
 Last update    received: 2020-01-28 13:36:41+00:00
 Last update    sent    : 2020-01-28 13:36:41+00:00
 No refresh received since peer has been configured
 No refresh sent since peer has been configured
 Minimum route advertisement interval is 30 seconds
 Optional capabilities:
 Route refresh capability has been enabled
 4-byte-as capability has been enabled
 Peer Preferred Value: 0
 Routing policy configured:
 No routing policy is configured
# Display detailed information about the peer 10.1.1.2.
<HUAWEI> display bgp vpnv4 vpn-instance vrf peer 10.1.1.2 verbose

         BGP Peer is 10.1.1.2,  remote AS 200
         Type: EBGP link
         BGP version 4, Remote router ID 10.1.1.2
         Update-group ID: 5
         BGP current state: Established, Up for 00h03m46s
         BGP current event: KATimerExpired
         BGP last state: OpenConfirm
         BGP Peer Up count: 1
         Received total routes: 0
         Received active routes total: 0
         Advertised total routes: 0
         Port: Local - 179        Remote - 50525
         Configured: Connect-retry Time: 32 sec
         Configured: Min Hold Time: 0 sec
         Configured: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Received  : Active Hold Time: 180 sec
         Negotiated: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Peer optional capabilities:
         Peer supports bgp multi-protocol extension
         Peer supports bgp route refresh capability
         Peer supports bgp 4-byte-as capability
         Address family IPv4 Unicast: advertised and received
 Received: Total 7 messages
                  Update messages                1
                  Open messages                  1
                  KeepAlive messages             5
                  Notification messages          0
                  Refresh messages               0
 Sent: Total 7 messages
                  Update messages                1
                  Open messages                  1
                  KeepAlive messages             5
                  Notification messages          0
                  Refresh messages               0
 Authentication type configured: None
 Last keepalive received: 2020-01-28 13:39:53+00:00
 Last keepalive sent    : 2020-01-28 13:40:21+00:00
 Last update    received: 2020-01-28 13:36:41+00:00
 Last update    sent    : 2020-01-28 13:36:41+00:00
 No refresh received since peer has been configured
 No refresh sent since peer has been configured
 Minimum route advertisement interval is 30 seconds
 Optional capabilities:
 Route refresh capability has been enabled
 4-byte-as capability has been enabled
 Peer Preferred Value: 0
 Routing policy configured:
 No routing policy is configured
Table 2-570 Description of the display bgp vpn-instance peer verbose command output
Item Description
BGP version

BGP version.

BGP current state

Current BGP status:

  • Idle: BGP denies any connection request. This is the initial status of BGP.

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

  • Connect: BGP is waiting for the TCP connection to be established before performing subsequent operations.
  • If the TCP connection is successfully established, BGP stops the ConnectRetry timer and sends an Open message to the peer. BGP then enters the Opensent state.
  • If the TCP connection fails to be established, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection initiated by the remote peer, and changes its state to Active.
  • If the ConnectRetry timer expires, BGP restarts the ConnectRetry timer and attempts to establish a TCP connection with the peer again. At this time, BGP remains in the Connect state.
  • Active: BGP attempts to establish a TCP connection. This is the intermediate state of BGP.
  • If the TCP connection is successfully established, BGP restarts the ConnectRetry Timer with the initial value, sends an Open message to the remote peer, and changes its state to Opensent.
  • If the ConnectRetry timer expires, BGP restarts the ConnectRetry timer and enters the Connect state.
  • If BGP attempts to establish a TCP connection with an unknown IP address, the TCP connection fails, the ConnectRetry Timer is reset, and BGP remains in the Active state.
  • OpenSent: BGP has sent an Open message to the peer and is now waiting for an Open message from the peer.
  • If BGP receives a correct Open message, BGP enters the OpenConfirm state.
  • If the Open message received by BGP is incorrect, BGP sends a Notification message to the peer and enters the Idle state.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection initiated by the remote peer, and changes its state to Active.
  • OpenConfirm: BGP is waiting for a Notification message or a Keepalive message.
  • If BGP receives a Notification message or a TCP connection teardown message, BGP changes its state to Idle.
  • If BGP receives a Keepalive message, BGP enters the Established state.
  • Established: indicates that BGP peers can exchange Update, Notification, and Keepalive messages.
  • If BGP receives an Update or Keepalive message, BGP remains in the Established state.
  • If BGP receives a Notification message, BGP changes its state to Idle.
  • No neg: The address family is not enabled for the BGP peer. In this state, Update messages can be exchanged in other successfully negotiated address families. If the address family is enabled on the remote BGP peer, the local BGP peer receives a Notification message, disconnects from the remote BGP peer, changes to the Idle state, and re-establishes a connection with the remote BGP peer.
BGP current event

Current BGP event.

BGP last state

State of last BGP stage, which may be Idle, Connect, Active, OpenSent, OpenConfirm, Established or No neg.

BGP Peer Up count

Number of times the BGP peer flaps within a specified period.

Peer Preferred Value

Preferred value of the BGP peer.

Peer optional capabilities

Optional capabilities supported by the peer.

Remote router ID

Router ID of the peer.

Update-group ID

ID of the Update group to which a peer belongs.

Received total routes

Number of route prefixes received.

Received active routes total

Number of received active route prefixes.

Received : Active Hold Time

Hold time of the peer.

Received

Number of packets received from neighbors:

  • Total: total number of records.
  • Update messages: number of Update messages.
  • Open messages: number of Open messages.
  • KeepAlive messages: number of Keepalive messages.
  • Number of Notification messages:Notification packets.
  • Refresh messages: number of Route-refresh messages.
Advertised total routes

Number of route prefixes sent.

Keepalive Time

Interval at which Keepalive messages are sent to the peer.

Negotiated: Active Hold Time

Hold time agreed between the BGP peers after capability negotiation.

Address family IPv4 Unicast

IPv4 unicast address family.

Authentication type configured

Configured authentication type.

Last keepalive received

Time when a Keepalive message was last received.

Last keepalive sent

Time when the last Keepalive message was sent.

Minimum route advertisement interval is 30 seconds

Minimum route advertisement interval.

  • The minimum interval at which EBGP routes are advertised is 30 seconds.
  • The minimum interval at which IBGP routes are advertised is 15 seconds.
Optional capabilities

Optional capabilities supported by the BGP peer.

Route refresh capability has been enabled

Route refreshing has been enabled.

Routing policy configured

Indicates the configured routing policy.

Type

BGP link type, which can be either IBGP Link or EBGP Link.

Port

Port type:

  • Local: indicates the local port number, which is always 179. BGP uses TCP at the transport layer.
  • Remote: indicates the port number used on the peer.
Configured

Locally configured timers.

  • Active Hold Time: indicates the hold time. If BGP does not receive any Keepalive message from the peer in the hold time, BGP considers that the peer is down and then instructs other peers to remove the routes that are received from the peer.
  • Keep Alive Time: indicates the interval at which Keepalive messages are sent to the peer. BGP peers exchange Keepalive messages periodically to notify each other that they are in the Active state.
Sent

Number of messages sent to a peer.

  • Total: indicates the total number of messages sent to a peer.
  • Update messages: indicates the number of Update messages sent to a peer.
  • Open messages: indicates the number of Open messages sent to a peer.
  • KeepAlive messages: indicates the number of Keepalive messages sent to a peer.
  • Notification messages: indicates the number of Notification messages sent to a peer.
  • Refresh messages: indicates the number of route-refresh messages sent to a peer.

display bgp vpnv4 all peer

Function

The display bgp vpnv4 all peer command displays information about peers in VPNv4 address-family.

The display bgp vpnv4 slow-peer command displays information about slow BGP peers in VPNv4 address-family.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv4 all peer

For S6730-H-V2, S5732-H-V2:

display bgp instance instance-name vpnv4 all peer

Parameters

Parameter Description Value
instance instance-name

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv4 all peer command can be used to locate faults. For example, when a peer is disconnected, you can view the log information of the specified peer to know the time when the peer is disconnected and the cause of the disconnection (error code and sub-error code).

After slow BGP peer detection is enabled, you can run the display bgp vpnv4 all peer command to view information about slow BGP peers. The information includes the time when a peer began to be identified as a slow peer, the time when a peer last exited the slow peer state, the number of times a peer has been identified as a slow peer, and the remaining time for a peer to exit the slow peer state.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about peers.
<HUAWEI> display bgp vpnv4 all peer
 
 BGP local router ID : 10.1.1.1
 Local AS number : 100
 Total number of peers : 1                 Peers in established state : 1

  Peer                             V          AS  MsgRcvd  MsgSent  OutQ  Up/Down       State  PrefRcv
  10.1.1.2                        4         100        7        7     0 00:03:04 Established        0
Table 2-571 Description of the display bgp vpnv4 all peer command output
Item Description
AS

AS number of the BGP peer.

Total number of peers

Number of existing slow BGP peers.

Peers in established state

Number of BGP peers in Established state.

Peer

IP address of a slow peer.

V

BGP version used on the peer.

MsgRcvd

Statistics about messages received from peers. The received messages are defined in BGP, such as Update and Open messages.

MsgSent

Statistics about messages sent to the peer. The sent messages are defined in BGP, such as Update and Open messages.

OutQ

Number of route prefixes to be sent to the peer after being grouped. The statistics include update and withdraw statistics.

Up/Down

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

State

Current BGP status:

  • Idle: BGP denies any connection request. This is the initial state of BGP.

After receiving a Start event, BGP initiates a TCP connection to the peer, starts the ConnectRetry Timer, listens to TCP messages from the peer, and changes its state to Connect.

  • Connect: BGP waits for the TCP connection to be established before performing subsequent operations.
  1. If the TCP connection is successfully established, BGP stops the ConnectRetry Timer, sends an Open message to the peer, and changes its state to Opensent.
  2. If the TCP connection fails to be established, BGP restarts the ConnectRetry Timer with the initial value, listens for a TCP connection initiated by the peer, and changes its state to Active.
  3. If the ConnectRetry timer expires, BGP restarts the ConnectRetry timer and attempts to establish a TCP connection with the peer again. At this time, BGP remains in the Connect state.
  • Active: BGP attempts to establish a TCP connection. This is the intermediate state of BGP.
  1. If the TCP connection is successfully established, BGP resets the ConnectRetry timer and sends an Open message to the peer. BGP then enters the Opensent state.
  2. If the ConnectRetry timer expires, BGP restarts the ConnectRetry timer and enters the Connect state.
  3. If BGP attempts to establish a TCP session with an unknown IP address, the TCP connection fails, the ConnectRetry Timer is reset, and BGP remains in the Active state.
  • OpenSent: BGP has sent an Open message to the peer and is waiting for an Open message from the peer.
  1. If BGP receives a correct Open message, BGP enters the OpenConfirm state.
  2. If BGP receives an incorrect Open message, BGP sends a Notification message to the peer and enters the Idle state.
  3. If BGP receives a TCP connection teardown message, BGP restarts the ConnectRetry Timer with the initial value, listens to a TCP connection initiated by the peer, and changes its state to Active.
  • OpenConfirm: BGP is waiting for a Notification or Keepalive message.
  1. If BGP receives a Notification message or a TCP connection teardown message, BGP enters the Idle state.
  2. If BGP receives a Keepalive message, BGP enters the Established state.
  • Established: BGP peers can exchange Update, Notification, and Keepalive messages.
  1. If BGP receives an Update or Keepalive message, BGP remains in the Established state.
  2. If BGP receives a Notification message, BGP enters the Idle state.
  • No neg: The address family is not enabled on the peer BGP peer. In this state, Update messages can be exchanged in other successfully negotiated address families. If the address family is enabled on the peer BGP peer, the local BGP peer receives a Notification message. The peer relationship is disconnected and enters the Idle state. The peer relationship is re-established.
PrefRcv

Number of route prefixes received by the local peer from the remote peer.

display bgp vpnv4 all peer verbose

Function

The display bgp vpnv4 all peer verbose command displays detailed information about BGP peers in the BGP-VPNv4 address family.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv4 all peer [ ipv4-address ] verbose

For S6730-H-V2, S5732-H-V2:

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

Parameters

Parameter Description Value
ipv4-address

Specify an IPv4 peer address.

The value is in dotted decimal notation.

instance instance-name

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without any spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv4 all peer verbose command displays information about BGP peers in the BGP-VPNv4 address family. You can run the command as required:

  • Check the connection status of BGP peers.
  • Check the configuration of BGP peers.
  • After running the peer as-number command to configure a BGP peer, check whether the configuration is successful.
  • After running the undo peer as-number command to delete a BGP peer, check whether the BGP peer is successfully deleted.

    The display bgp vpnv4 all peer verbose command can be used to locate faults. For example, when a peer is disconnected, you can view the log information of the specified peer to know the time when the peer is disconnected and the cause of the disconnection (error code and sub-error code).

Example

The actual command output varies according to the device. The command output here is only an example.

# Display detailed information about VPNv4 peers.
<HUAWEI> display bgp vpnv4 all peer verbose
 BGP Peer is 2.2.2.2,  remote AS 100
 Type: IBGP link
 BGP version 4, Remote router ID 2.2.2.2
 Update-group ID: 3
 BGP current state: Established, Up for 01h12m50s
 BGP current event: RecvKeepalive
 BGP last state: OpenConfirm
 BGP Peer Up count: 1
 Received total routes: 0
 Received active routes total: 0
 Advertised total routes: 1
 Port: Local - 179        Remote - 58368
 Configured: Connect-retry Time: 32 sec
 Configured: Active Hold Time: 180 sec   Keepalive Time:60 sec
 Received  : Active Hold Time: 180 sec
 Negotiated: Active Hold Time: 180 sec   Keepalive Time:60 sec
 Peer optional capabilities:
  Peer supports bgp multi-protocol extension
  Peer supports bgp route refresh capability
  Peer supports bgp 4-byte-as capability
  Address family IPv4 Unicast: advertised and received
  Address family VPNv4 Unicast: advertised and received
 Received:
                  Total  messages                88
                  Update messages                2
                  Open messages                  1
                  KeepAlive messages             84
                  Notification messages          0
                  Refresh messages               1
 Sent    :
                  Total  messages                97
                  Update messages                11
                  Open messages                  1
                  KeepAlive messages             85
                  Notification messages          0
                  Refresh messages               0
 Authentication type configured: None
  Last keepalive received: 2015-01-07 09:48:41+00:00
  Last keepalive sent    : 2015-01-07 09:48:41+00:00
  Last update received   : 2015-01-07 08:36:31+00:00
  Last update sent       : 2015-01-07 09:34:22+00:00
  Last refresh received  : 2015-01-07 08:37:36+00:00
  No refresh sent since peer has been configured
 Minimum route advertisement interval is 0 seconds
 Optional capabilities:
 Route refresh capability has been enabled
 4-byte-as capability has been enabled
 Connect-interface has been configured
 Send remote-nexthop has been configured
 Peer Preferred Value: 0
 Routing policy configured:
 No routing policy is configured
Table 2-572 Description of the display bgp vpnv4 all peer verbose command output
Item Description
BGP version

BGP version.

BGP current state

State of BGP:

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

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

  • Connect: indicates that BGP is waiting for the TCP connection to be set up before it determines whether to perform other operations.
  • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active.
  • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value, initiates a TCP connection request to the remote BGP peer, and stays in the Connect state.
  • Active: indicates that BGP tries to set up a TCP connection. This is the intermediate status of BGP.
  • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.
  • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value and changes its state to Connect.
  • If BGP initiates a TCP connection request with an unknown IP address, the TCP connection fails. When this occurs, BGP restarts the ConnectRetry Timer with the initial value and stays in the Active state.
  • OpenSent: indicates that BGP has sent one Open message to its peer and is waiting for the other Open message from the peer.
  • If there are no errors in the Open message received, BGP changes its state to OpenConfirm.
  • If there are errors in the Open message received, BGP sends a Notification message to the remote peer and changes its state to Idle.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active.
  • OpenConfirm: indicates that BGP is waiting for a Notification or Keepalive message.
  • If BGP receives a Notification message, or the TCP connection fails, BGP changes its state to Idle.
  • If BGP receives a Keepalive message, BGP changes its state to Established.
  • Established: indicates that BGP peers can exchange Update, Notification, and Keepalive messages.
  • If BGP receives an Update or a Keepalive message, its state stays in Established.
  • If BGP receives a Notification message, BGP changes its state to Idle.
  • No neg: The address family is not enabled for the BGP peer. In this state, Update messages can be exchanged in other address families whose capabilities have been successfully negotiated. If the address family is enabled for the BGP peer, the local BGP peer receives a Notification message, and the peer relationship is disconnected. Then, the BGP peer changes to the Idle state and re-establishes the peer relationship.
BGP current event

Current BGP event.

BGP last state

State of last BGP stage, which may be Idle, Connect, Active, OpenSent, OpenConfirm, Established or No neg.

BGP Peer Up count

Number of times the BGP peer flaps.

BGP Peer

Peer IP address.

Peer Preferred Value

PrefVal of the peer.

Peer optional capabilities

Optional capabilities supported by the peer.

remote AS

AS Number of the peer.

Update-group ID

ID of the Update group to which a peer belongs.

Received total routes

Number of received route prefixes.

Received active routes total

Number of active route prefixes received.

Received

Number of packets received from neighbors:

  • Total: total number of records.
  • Update messages: number of Update messages.
  • Open messages: number of Open messages.
  • KeepAlive messages: number of Keepalive messages.
  • Number of Notification messages:Notification packets.
  • Refresh messages: number of Route-refresh messages.
Received : Active Hold Time

Hold time determined after negotiation between BGP peers.

Advertised total routes

Number of route prefixes sent.

Keepalive Time

Interval for sending Keepalive messages to the peer.

Negotiated: Active Hold Time

Hold time of the peer.

Address family IPv4 Unicast

IPv4 unicast address family.

Address family VPNv4 Unicast

VPNv4 address family.

Sent

Number of packets sent to peers:

  • Total: total number of records.
  • Update messages: indicates the number of Update messages.
  • Open messages: indicates the number of Open messages.
  • KeepAlive messages: indicates the number of Keepalive messages.
  • Notification messages: indicates the number of Notification messages.
  • Refresh messages: indicates the number of Route-refresh messages.
Authentication type configured

Configured authentication type.

Last keepalive received

Time when a Keepalive message was last received.

Last refresh received

Time when a Refresh message was last received.

Last update received

Last time when an Update message is received.

Last update sent

Last time when an Update message is sent.

Last keepalive sent

Time at which the last keepalive message is sent.

Optional capabilities

Optional capabilities of the peer.

Route refresh capability has been enabled

Route-refresh enabled.

Routing policy configured

Configured routing policy.

Type

BGP link type (IBGP or EBGP).

Port

Port number.

  • Local: local port number. BGP uses TCP as the transport layer protocol and uses the fixed port number 179.
  • Remote: indicates the port number of the peer.
Configured

Locally configured timers.

  • Active Hold Time: indicates the hold time. If BGP does not receive any Keepalive message from the peer in the hold time, BGP considers that the peer is Down and then instructs other peers to remove the routes that are sent from the peer.
  • Keep Alive Time: indicates the interval at which Keepalive messages are sent to the peer. BGP peers exchange Keepalive messages periodically to maintain their relationships.

display bgp vpnv4 routing-table

Function

The display bgp vpnv4 routing-table command displays information about BGP VPNv4 routes and BGP VPN routes.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv4 route-distinguisher route-distinguisher routing-table

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

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics

display bgp vpnv4 route-distinguisher route-distinguisher routing-table cidr

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

display bgp vpnv4 route-distinguisher route-distinguisher routing-table different-origin-as

display bgp vpnv4 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table statistics different-origin-as

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter { basic-community-filter-number | advanced-community-filter-number }

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter community-filter-name

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

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

display bgp vpnv4 route-distinguisher route-distinguisher routing-table community-filter { basic-community-filter-number | advanced-community-filter-number }

display bgp vpnv4 route-distinguisher route-distinguisher routing-table community-filter community-filter-name

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

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

display bgp vpnv4 route-distinguisher route-distinguisher routing-table as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics regular-expression as-regular-expression

display bgp vpnv4 route-distinguisher route-distinguisher routing-table regular-expression as-regular-expression

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

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter basic-community-filter-number whole-match

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter community-filter-name whole-match

display bgp vpnv4 route-distinguisher route-distinguisher routing-table community-filter basic-community-filter-number whole-match

display bgp vpnv4 route-distinguisher route-distinguisher routing-table community-filter community-filter-name whole-match

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

For S6730-H-V2, S5732-H-V2:

display bgp instance instance-name vpnv4 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table statistics different-origin-as

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table

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

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table cidr

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

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table different-origin-as

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter { basic-community-filter-number | advanced-community-filter-number }

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter community-filter-name

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics community [ community-number | aa:nn | internet | no-advertise | no-export | no-export-subconfed ] &<1-33>

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

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table community-filter { basic-community-filter-number | advanced-community-filter-number }

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table community-filter community-filter-name

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

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

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics regular-expression as-regular-expression

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table regular-expression as-regular-expression

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

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter basic-community-filter-number whole-match

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table statistics community-filter community-filter-name whole-match

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table community-filter basic-community-filter-number whole-match

display bgp instance instance-name vpnv4 route-distinguisher route-distinguisher routing-table community-filter community-filter-name whole-match

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

Parameters

Parameter Description Value
all

Displays statistics about all BGP VPNv4 routes.

-

vpn-instance vpn-instance-name

Displays the BGP routes of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

statistics

Displays statistics about routes advertised to or received from a specified peer.

-

route-distinguisher route-distinguisher

Displays statistics about the BGP routes with a specified RD.

The value is a string of 3 to 21 case-sensitive characters, spaces not supported.

instance instance-name

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

ipv4-address

Specify an IPv4 peer address.

Dotted decimal notation.

mask-length

Length of IP address mask.

The value is an integer ranging from 0 to 32.

mask

Specifies a mask.

The value is in dotted decimal notation.

as-path-filter as-path-filter-num

Displays the routes that match the AS_Path filter of a specified number.

It is an integer ranging from 1 to 256.

as-path-filter-name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

community-filter basic-community-filter-number

Specifies the number of a basic community filter.

The value is an integer ranging from 1 to 99.

community-filter community-filter-name

Specifies the name of a community filter.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

community-filter advanced-community-filter-number

Specifies the number of an advanced community filter.

The value is an integer ranging from 100 to 199.

community community-number

Specifies a community number.

The value is an integer ranging from 0 to 4294967295.

community aa:nn

Specifies a community number.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

internet

Allows the routes that match the community filter to be sent to all peers.

-

no-advertise

Displays the BGP routes carrying the No-Advertise community attribute.

-

no-export

Displays the BGP public network routes carrying the No-Export community attribute.

-

no-export-subconfed

Displays the BGP routes carrying the No-Export-Subconfed community attribute.

-

whole-match

Indicates exact matching.

-

regular-expression as-regular-expression

Displays the routes that match the regular expression.

The value is a string of 1 to 80 characters.

longer-prefixes

Matches any route whose prefix mask is longer than the specified length.

-

active

Displays the active routes learned from a specified peer.

-

cidr

Displays CIDR information.

-

different-origin-as

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

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp instance vpnv4 all routing-table peer advertised-routes command is used to view active and inactive BGP VPNv4 routes and BGP VPN routes.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about active VPNv4 routes.
<HUAWEI> display bgp vpnv4 all routing-table statistics active
 Total number of routes from all PE: 2
 VPN-Instance vrf1, router ID 1.1.1.1:
 Total Number of Prefix Advertised to RM : 2
 Total Number of Active Route : 2
# Display statistics about the VPNv4 routes with the specified RD.
<HUAWEI> display bgp vpnv4 route-distinguisher 100:1 routing-table statistics
 Route Distinguisher: 100:1
 Total Number of Routes: 1
 Total number of routes of IPv4-family for vpn-instance vrf1: 3
# Display statistics about the VPNv4 routes with a specified RD in a BGP multi-instance.
<HUAWEI> display bgp instance aaa vpnv4 route-distinguisher 1:1 routing-table statistics best
 Route Distinguisher: 1:1
Total Number of Best Routes from All PE: 1
Total Number of Add-path Routes from All PE: 0
Total Number of Best-external Routes from All PE: 1
 VPN-Instance vrf1, Router ID 11.11.11.11:
Total Number of Best Routes: 1
# Display statistics about dampened VPNv4 routes.
<HUAWEI> display bgp vpnv4 all routing-table statistics dampened
 Total Number of Routes: 2
# Display information about optimal VPNv4 routes.
<HUAWEI> display bgp vpnv4 all routing-table statistics best
 Total Number of Best Routes from All PE: 1
 Total Number of Add-path Routes from All PE: 0 
 Total Number of Best-external Routes from All PE: 1
 VPN-Instance vrf1, Router ID 11.11.11.11:
Total Number of Best Routes: 1
 VPN-Instance vrf2, Router ID 11.11.11.11:
Total Number of Best Routes: 1
Table 2-573 Description of the display bgp vpnv4 routing-table command output
Item Description
Total number of routes from all PE

Total number of VPNv4 routes.

Total number of routes of IPv4-family for vpn-instance vrf1

Number of routes in the BGP-VPN instance IPv4 address family.

Total Number of Routes

Total number of VPNv4 routes with a specified RD.

Total Number of Best Routes from All PE

Number of optimal routes that are selected among the routes received from all PEs.

Total Number of Best-external Routes from All PE

Number of Best-External routes from all PEs.

Total Number of Add-path Routes from All PE

Number of Add-Path routes from all PEs.

Total Number of Best Routes

Number of optimal routes.

Total Number of Prefix Advertised to RM

Number of routes delivered to the RM module.

Total Number of Active Route

Number of active routes.

Prefix

Prefix of a BGP route.

Route Distinguisher

Route distinguisher (RD) of a route.

BGP Local router ID

Router ID of the local BGP device.

display bgp vpnv4 routing-table large-community

Function

The display bgp vpnv4 routing-table large-community command displays the BGP VPNv4 route and the BGP private network route information of the specified BGP large-community in the routing table.

Format

display bgp vpnv4 route-distinguisher route-distinguisher routing-table large-community [ aa:bb:cc ] &<1-33>

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics large-community [ aa:bb:cc ] &<1-33>

display bgp vpnv4 route-distinguisher route-distinguisher routing-table large-community [ aa:bb:cc ] &<1-33> whole-match

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics large-community [ aa:bb:cc ] &<1-33> whole-match

display bgp vpnv4 route-distinguisher route-distinguisher routing-table large-community-filter large-community-filter-name

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics large-community-filter large-community-filter-name

display bgp vpnv4 route-distinguisher route-distinguisher routing-table large-community-filter large-community-filter-name whole-match

display bgp vpnv4 route-distinguisher route-distinguisher routing-table statistics large-community-filter large-community-filter-name whole-match

Parameters

Parameter Description Value
route-distinguisher route-distinguisher

Specifies an RD of a remote route.

The value is a string of 3 to 21 case-sensitive characters, spaces not supported.

large-community aa:bb:cc

Specifies large community values, with each value ranging from 0 to 4294967295.

The value is a string of 5 to 32 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

vpnv4

Indicates the VPNv4 address family.

-

statistics

Displays statistics about BGP routes.

-

whole-match

Indicates exact match with specified communities.

-

large-community-filter large-community-filter-name

Specifies the large community filter name.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv4 routing-table large-community command displays the BGP VPNv4 route and the BGP private network route information of the specified BGP large-community in the routing table.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the BGP VPNv4 routes and the BGP private network routes with large-community attribute.
<HUAWEI> display bgp vpnv4 route-distinguisher 1:1 routing-table large-community
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Route Distinguisher: 1:1

 Total Number of Routes: 3
        Network            NextHop                       MED        LocPrf    PrefVal LargeCommunity

 *>     10.11.11.11/32     10.20.0.1                      0                     0      <1:1:1>
 *>     10.22.22.22/32     10.2.123.2                     0                     0      <1:1:1>, <2:2:2>
 *>     10.33.33.33/32     10.2.123.3                     0                     0      <1:1:1>, <3:3:3>
    
 VPN-Instance vrf, Router ID 10.1.123.1:

 Total Number of Routes: 3
        Network            NextHop                       MED        LocPrf    PrefVal LargeCommunity

 *>     10.11.11.11/32     0.0.0.0                        0                     0      <1:1:1>
 *>     10.22.22.22/32     10.2.123.2                     0                     0      <1:1:1>, <2:2:2>
 *>     10.33.33.33/32     10.2.123.3                     0                     0      <1:1:1>, <3:3:3>
Table 2-574 Description of the display bgp vpnv4 routing-table large-community command output
Item Description
Total Number of Routes

Total number of routes.

Network

Indicates the network address in the BGP routing table.

NextHop

Next hop address used to forward the packet.

MED

Indicates the MED of the route.

LocPrf

Local preference of a route.

PrefVal

PrefVal of a BGP route.

LargeCommunity

Large-community attribute of a route.

display bgp vpnv4 routing-table statistics(Attribute Filter)

Function

The display bgp vpnv4 routing-table statistics command displays statistics about BGP VPNv4 routes and BGP VPN routes based on specified multiple attribute filters.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics community-filter { { community-filter-num | community-filter-numEx | community-filter-name } | { community-filter-num | community-filter-name } whole-match }

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics large-community-filter largeComFilName [ whole-match ]

For S6730-H-V2, S5732-H-V2:

display bgp instance bgpName vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp instance bgpName vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics community-filter { { community-filter-num | community-filter-numEx | community-filter-name } | { community-filter-num | community-filter-name } whole-match }

display bgp instance bgpName vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics large-community-filter largeComFilName [ whole-match ]

Parameters

Parameter Description Value
all

Displays BGP VPNv4 routes and BGP routes of VPN instances.

-

vpn-instance vpn-instance-name

Displays about the BGP routes of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

statistics

Displays statistics about BGP routes.

-

as-path-filter as-path-filter-num

Specifies the number of an AS_Path filter.

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

as-path-filter as-path-filter-name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

community-filter community-filter-name

Specifies the name of a community filter.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

community-filter community-filter-num

Specifies the number of a basic community filter.

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

community-filter community-filter-numEx

Specifies the number of an advanced community filter.

The value is an integer that ranges from 100 to 199.

whole-match

Matches the specified community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

large-community-filter largeComFilName

Specifies the name of a Large-Community filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

instance bgpName

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query statistics about BGP VPNv4 routes and BGP VPN routes based on specified multiple attribute filters, run this command. Multiple attribute filters can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about BGP VPNv4 routes that match community filter 10.
<HUAWEI> display bgp vpnv4 all routing-table statistics community-filter 10
 
 Total number of routes from all PE: 2

 VPN-Instance vrf, Router ID 10.1.123.1:
 Total Number of Routes: 2
# Display statistics about BGP private routes that match large community filter aaa.
<HUAWEI> display bgp vpnv4 vpn-instance vrf routing-table statistics large-community-filter aaa

 VPN-Instance vrf, Router ID 10.1.123.1:
 Total Number of Routes: 1
# Display statistics about BGP multi-instance VPNv4 routes that match AS path filter pas.
<HUAWEI> display bgp instance a vpnv4 all routing-table statistics as-path-filter pas
 
 Total number of routes from all PE: 3

 VPN-Instance vpna, Router ID 10.3.123.1:
 Total Number of Routes: 3
# Display statistics about BGP VPNv4 routes that exactly match large community filter aaa.
<HUAWEI> display bgp vpnv4 all routing-table large-community-filter aaa whole-match
 
 Total number of routes from all PE: 1

 VPN-Instance vrf, Router ID 10.1.123.1:
 Total Number of Routes: 1
Table 2-575 Description of the display bgp vpnv4 routing-table statistics(Attribute Filter) command output
Item Description
Total number of routes from all PE

Number of VPNv4 routes.

Total Number of Routes

Total number of routes.

VPN-Instance

Name of a VPN instance.

Router ID

Router ID of the VPN instance.

display bgp vpnv4 routing-table statistics(Attribute)

Function

The display bgp vpnv4 routing-table statistics command displays statistics about BGP VPNv4 routes and BGP VPN routes based on specified multiple attribute values.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics regular-expression strRegular

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> [ whole-match ]

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics large-community [ largeCommuStr ] &<1-33> [ whole-match ]

For S6730-H-V2, S5732-H-V2:

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

display bgp instance bgpName vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics regular-expression strRegular

display bgp instance bgpName vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> [ whole-match ]

display bgp instance bgpName vpnv4 { all | vpn-instance vpn-instance-name } routing-table statistics large-community [ largeCommuStr ] &<1-33> [ whole-match ]

Parameters

Parameter Description Value
all

Displays BGP VPNv4 routes and BGP routes of VPN instances.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

vpn-instance vpn-instance-name

Displays about the BGP routes of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

statistics

Displays BGP route statistics.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

community communityNum

Specify community number.

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

community strCommunityNum

Specify community number.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

internet

Displays the BGP routes carrying the internet community attribute.

-

no-advertise

Displays the BGP routes carrying the No-Advertise community attribute.

-

no-export

Displays the BGP routes carrying the No-Export community attribute.

-

no-export-subconfed

Displays the BGP routes carrying the No-Export-Subconfed community attribute.

-

g-shut

Display routes with the Grateful-Shutdown community attribute.

-

whole-match

Matches the specified community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

large-community largeCommuStr

Specifies a value of the Large-Community attribute.

The value is a string of 5 to 32 case-sensitive characters, spaces not supported.

regular-expression strRegular

Specifies the regular expression that matches AS_Path.

The value is a string of 1 to 80 characters.

instance bgpName

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 80 characters.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query statistics about BGP VPNv4 routes and BGP VPN routes based on specified multiple attribute values, run this command. Multiple attribute values can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about BGP VPNv4 routes.
<HUAWEI> display bgp vpnv4 all routing-table statistics
 
 Total number of routes from all PE: 2

 VPN-Instance vrf, Router ID 10.1.123.1:
 Total Number of Routes: 2
# Display statistics about BGP private network routes with community attribute.
<HUAWEI> display bgp vpnv4 vpn-instance vrf routing-table statistics community

 VPN-Instance vrf, Router ID 10.1.123.1:
 Total Number of Routes: 2
Table 2-576 Description of the display bgp vpnv4 routing-table statistics(Attribute) command output
Item Description
Total number of routes from all PE

Number of VPNv4 routes.

Total Number of Routes

Total number of routes.

VPN-Instance

Name of a VPN instance.

Router ID

Router ID of the VPN instance.

display bgp vpnv4 routing-table(Attribute Filter)

Function

The display bgp vpnv4 routing-table command displays information about BGP VPNv4 routes and BGP VPN routes based on specified multiple attribute filters.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table community-filter { { community-filter-num | community-filter-numEx | community-filter-name } | { community-filter-num | community-filter-name } whole-match }

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table large-community-filter largeComFilName [ whole-match ]

For S6730-H-V2, S5732-H-V2:

display bgp instance bgpName vpnv4 { all | vpn-instance vpn-instance-name } routing-table as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp instance bgpName vpnv4 { all | vpn-instance vpn-instance-name } routing-table community-filter { { community-filter-num | community-filter-numEx | community-filter-name } | { community-filter-num | community-filter-name } whole-match }

display bgp instance bgpName vpnv4 { all | vpn-instance vpn-instance-name } routing-table large-community-filter largeComFilName [ whole-match ]

Parameters

Parameter Description Value
all

Displays BGP VPNv4 routes and BGP routes of VPN instances.

-

vpn-instance vpn-instance-name

Displays about the BGP routes of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

as-path-filter as-path-filter-num

Specifies the number of an AS_Path filter.

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

as-path-filter as-path-filter-name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

community-filter community-filter-name

Specifies the name of a community filter.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

community-filter community-filter-num

Specifies the number of a basic community filter.

The value is an integer ranging from 1 to 99.

community-filter community-filter-numEx

Specifies the number of an advanced community filter.

The value is an integer that ranges from 100 to 199.

whole-match

Matches the specified community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

large-community-filter largeComFilName

Specifies the name of a Large-Community filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

instance bgpName

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query information about BGP VPNv4 routes and BGP VPN routes based on specified multiple attribute filters, run this command. Multiple attribute filters can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP VPNv4 routes that match community filter 10.
<HUAWEI> display bgp vpnv4 all routing-table community-filter 10
 
 BGP Local router ID is 10.3.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found

 
 Total number of routes from all PE: 2

 Route Distinguisher: 1:1


        Network            NextHop                       MED        LocPrf    PrefVal Community

 *>     10.1.1.0/24        10.1.123.2                     0                     0      <1:1>, <2:2>
 *>     10.1.2.0/24        10.1.123.2                     0                     0      <1:1>, <3:3>
    
 VPN-Instance vrf, Router ID 10.1.123.1:

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

 *>     10.1.1.0/24        10.1.123.2                     0                     0      <1:1>, <2:2>
 *>     10.1.2.0/24        10.1.123.2                     0                     0      <1:1>, <3:3>
# Display BGP private routes that match large community filter aaa.
<HUAWEI> display bgp vpnv4 vpn-instance vrf routing-table large-community-filter aaa
 
 BGP Local router ID is 10.3.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found

    
 VPN-Instance vrf, Router ID 10.1.123.1:

 Total Number of Routes: 1
        Network            NextHop                       MED        LocPrf    PrefVal LargeCommunity

 *>     10.1.1.0/24        10.1.123.2                     0                     0      <1:1:1>, <2:2:2>
# Display BGP multi-instance VPNv4 routes that match AS path filter pas.
<HUAWEI> display bgp instance a vpnv4 all routing-table as-path-filter pas
 
 BGP Local router ID is 10.3.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found

 
 Total number of routes from all PE: 1

 Route Distinguisher: 11:11


        Network            NextHop                       MED        LocPrf    PrefVal Path/Ogn

 *>     10.1.1.0/24        10.2.123.2                     0                     0      200?
    
 VPN-Instance vrf, Router ID 10.3.123.1:

 Total Number of Routes: 0
    
 VPN-Instance vpna, Router ID 10.3.123.1:

 Total Number of Routes: 1
        Network            NextHop                       MED        LocPrf    PrefVal Path/Ogn

 *>     10.1.1.0/24        10.2.123.2                     0                     0      200?
Table 2-577 Description of the display bgp vpnv4 routing-table(Attribute Filter) command output
Item Description
BGP Local router ID is

Router ID of the local BGP device.

Total number of routes from all PE

Number of VPNv4 routes.

Total Number of Routes

Total number of routes.

Route Distinguisher

Route distinguisher (RD) of a route.

Network

Network address in the BGP public network routing table.

NextHop

Next hop address of the packet.

MED

MED of a route.

LocPrf

Local_Pref.

PrefVal

PrefVal of a BGP route.

Community

Community attribute of a route.

VPN-Instance

Name of a VPN instance.

LargeCommunity

LargeCommunity attribute of a route.

Path/Ogn

AS_Path number and the origin attribute.

display bgp vpnv4 routing-table(Attribute)

Function

The display bgp vpnv4 routing-table command displays information about BGP VPNv4 routes and BGP VPN routes based on specified multiple attribute values.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table regular-expression strRegular

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> [ whole-match ]

display bgp vpnv4 { all | vpn-instance vpn-instance-name } routing-table large-community [ largeCommuStr ] &<1-33> [ whole-match ]

For S6730-H-V2, S5732-H-V2:

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

display bgp instance bgpName vpnv4 { all | vpn-instance vpn-instance-name } routing-table regular-expression strRegular

display bgp instance bgpName vpnv4 { all | vpn-instance vpn-instance-name } routing-table community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> [ whole-match ]

display bgp instance bgpName vpnv4 { all | vpn-instance vpn-instance-name } routing-table large-community [ largeCommuStr ] &<1-33> [ whole-match ]

Parameters

Parameter Description Value
all

Displays BGP VPNv4 routes and BGP routes of VPN instances.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

vpn-instance vpn-instance-name

Displays about the BGP routes of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

community communityNum

Specify community number.

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

community strCommunityNum

Specify community number.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

internet

Displays the BGP routes carrying the internet community attribute.

-

no-advertise

Displays the BGP routes carrying the No-Advertise community attribute.

-

no-export

Displays the BGP routes carrying the No-Export community attribute.

-

no-export-subconfed

Displays the BGP routes carrying the No-Export-Subconfed community attribute.

-

g-shut

Display routes with the Grateful-Shutdown community attribute.

-

whole-match

Matches the specified community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

large-community largeCommuStr

Specifies a value of the Large-Community attribute.

The value is a string of 5 to 32 case-sensitive characters, spaces not supported.

regular-expression strRegular

Specifies the regular expression that matches AS_Path.

The value is a string of 1 to 80 characters.

instance bgpName

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 80 characters.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query information about BGP VPNv4 routes and BGP VPN routes based on specified multiple attribute values, run this command. Multiple attribute values can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP VPNv4 routes information.
<HUAWEI> display bgp vpnv4 all routing-table
 
 BGP Local router ID is 10.3.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found

 
 Total number of routes from all PE: 7

 Route Distinguisher: 1:1


        Network            NextHop                       MED        LocPrf    PrefVal Path/Ogn

 *>     10.1.1.0/24        10.1.123.2                     0                     0      200i
 *>     10.1.2.0/24        10.1.123.2                     0                     0      200i
    
 VPN-Instance vrf, Router ID 10.1.123.1:

 Total Number of Routes: 2
        Network            NextHop                       MED        LocPrf    PrefVal Path/Ogn

 *>     10.1.1.0/24        10.1.123.2                     0                     0      200i
 *>     10.1.2.0/24        10.1.123.2                     0                     0      200i
# Display BGP private network routes with community attribute.
<HUAWEI> display bgp vpnv4 vpn-instance vrf routing-table community
 
 BGP Local router ID is 10.3.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found

    
 VPN-Instance vrf, Router ID 10.1.123.1:

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

 *>     10.1.1.0/24        10.1.123.2                     0                     0      <1:1>, <2:2>
 *>     10.1.2.0/24        10.1.123.2                     0                     0      <1:1>, <3:3>
Table 2-578 Description of the display bgp vpnv4 routing-table(Attribute) command output
Item Description
BGP Local router ID is

Router ID of the local BGP device.

Total number of routes from all PE

Number of VPNv4 routes.

Total Number of Routes

Total number of routes.

Route Distinguisher

Route distinguisher (RD) of a route.

Network

Network address in the BGP public network routing table.

NextHop

Next hop address of the packet.

MED

MED of a route.

LocPrf

Local_Pref.

PrefVal

PrefVal of a BGP route.

Path/Ogn

AS_Path number and the origin attribute.

VPN-Instance

Name of a VPN instance.

Community

Community attribute of a route.

display bgp vpnv6 all group

Function

The display bgp vpnv6 all group command displays all the VPNv6 peer groups information.

Format

For S6730-H-V2, S5732-H-V2:

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

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 all group [ group-name ]

Parameters

Parameter Description Value
instance bgpName

Specifies the name of a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

group-name

Specifies a peer-group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv6 all group command is used to display all the VPNv6 peer groups information.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display all the VPNv6 peer groups information.
<HUAWEI> display bgp vpnv6 all group
Group in VPNV6:
 
 BGP peer-group     : 123
 Remote AS number isn't specified
 Type               : external
 PeerSession Members:
   2001:DB8:1::1
 
 Peer Members:
  No Peer Exists
 ***********************
 
 BGP peer-group     : 222
 Remote AS 200
 Type               : internal
 PeerSession Members:
   2001:DB8:2::2
 
 Peer Members:
  No Peer Exists
 ***********************
 
 BGP peer-group     : 333
 Remote AS 400
 Type               : external
 PeerSession Members:
   2001:DB8:3::3
 
 Peer Members:
  No Peer Exists
 
 
Group in VPN-Instance:
 
 BGP peer-group           : 55
 Remote AS number isn't specified
 VPN-Instance(IPv6-family): vpn1
 
 Type : external
 PeerSession Members:
   2001:DB8:4::4
 
 Peer Members:
   2001:DB8:4::4
Table 2-579 Description of the display bgp vpnv6 all group command output
Item Description
Group in VPN-Instance

Information about peer groups in a VPN instance is displayed.

Group in VPNV6

Information about all VPNv6 peer groups is displayed.

Remote AS number isn't specified

This item is displayed when the peer group is a mixed EBGP peer group.

Type

Type of a peer group:

  • internal: indicates that the peer group is an IBGP peer group.
  • external: indicates that the peer group is an EBGP peer group.
  • listen internal: indicates that the peer group is a dynamic IBGP peer group.
  • listen external: indicates that the peer group is a dynamic EBGP peer group.
  • listen confederation-external: indicates that the peer group is a dynamic confederation EBGP peer group.
PeerSession Members

Peers with which sessions have been established.

Peer Members

Peer information.

VPN-Instance

VPN instance name.

display bgp vpnv6 all peer verbose

Function

The display bgp vpnv6 all peer verbose command displays the detailed information of all the BGP VPNv6 peers.

Format

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] vpnv6 all peer verbose

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 all peer verbose

Parameters

Parameter Description Value
instance bgpName

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv6 all peer verbose command is used to display the detailed information of all the BGP VPNv6 peers.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display detailed information about the VPNv6 peer.
<HUAWEI> display bgp vpnv6 all peer verbose

         BGP Peer is 10.1.1.2,  remote AS 200
         Type: EBGP link
         BGP version 4, Remote router ID 10.1.1.2
         Update-group ID: 1
         BGP current state: Established, Up for 00h01m44s
         BGP current event: RecvKeepalive
         BGP last state: OpenConfirm
         BGP Peer Up count: 2
         Received total routes: 0
         Received active routes total: 0
         Advertised total routes: 0
         Port: Local - 179        Remote - 59043
         Configured: Connect-retry Time: 32 sec
         Configured: Min Hold Time: 0 sec
         Configured: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Received  : Active Hold Time: 180 sec
         Negotiated: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Peer optional capabilities:
         Peer supports bgp multi-protocol extension
         Peer supports bgp route refresh capability
         Peer supports bgp 4-byte-as capability
         Address family IPv4 Unicast: advertised and received
         Address family VPNv6 Unicast: advertised and received
 Received: Total 6 messages
                  Update messages                2
                  Open messages                  1
                  KeepAlive messages             3
                  Notification messages          0
                  Refresh messages               0
 Sent: Total 6 messages
                  Update messages                2
                  Open messages                  2
                  KeepAlive messages             2
                  Notification messages          0
                  Refresh messages               0
 Authentication type configured: None
 Last keepalive received: 2020-01-28 11:50:08+00:00
 Last keepalive sent    : 2020-01-28 11:49:23+00:00
 Last update    received: 2020-01-28 11:48:30+00:00
 Last update    sent    : 2020-01-28 11:48:30+00:00
 No refresh received since peer has been configured
 No refresh sent since peer has been configured
 Minimum route advertisement interval is 30 seconds
 Optional capabilities:
 Route refresh capability has been enabled
 4-byte-as capability has been enabled
 Peer Preferred Value: 0
 Routing policy configured:
 No routing policy is configured
# Display detailed information about the VPNv6 peer with the IPv4 address 10.1.1.2.
<HUAWEI> display bgp vpnv6 all peer 10.1.1.2 verbose

         BGP Peer is 10.1.1.2,  remote AS 200
         Type: EBGP link
         BGP version 4, Remote router ID 10.1.1.2
         Update-group ID: 1
         BGP current state: Established, Up for 00h01m06s
         BGP current event: KATimerExpired
         BGP last state: OpenConfirm
         BGP Peer Up count: 2
         Received total routes: 0
         Received active routes total: 0
         Advertised total routes: 0
         Port: Local - 179        Remote - 59043
         Configured: Connect-retry Time: 32 sec
         Configured: Min Hold Time: 0 sec
         Configured: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Received  : Active Hold Time: 180 sec
         Negotiated: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Peer optional capabilities:
         Peer supports bgp multi-protocol extension
         Peer supports bgp route refresh capability
         Peer supports bgp 4-byte-as capability
         Address family IPv4 Unicast: advertised and received
         Address family VPNv6 Unicast: advertised and received
 Received: Total 5 messages
                  Update messages                2
                  Open messages                  1
                  KeepAlive messages             2
                  Notification messages          0
                  Refresh messages               0
 Sent: Total 6 messages
                  Update messages                2
                  Open messages                  2
                  KeepAlive messages             2
                  Notification messages          0
                  Refresh messages               0
 Authentication type configured: None
 Last keepalive received: 2020-01-28 11:49:17+00:00
 Last keepalive sent    : 2020-01-28 11:49:23+00:00
 Last update    received: 2020-01-28 11:48:30+00:00
 Last update    sent    : 2020-01-28 11:48:30+00:00
 No refresh received since peer has been configured
 No refresh sent since peer has been configured
 Minimum route advertisement interval is 30 seconds
 Optional capabilities:
 Route refresh capability has been enabled
 4-byte-as capability has been enabled
 Peer Preferred Value: 0
 Routing policy configured:
 No routing policy is configured
Table 2-580 Description of the display bgp vpnv6 all peer verbose command output
Item Description
BGP version

BGP version.

BGP current state

Current BGP status:

  • Idle: BGP denies any connection request. This is the initial status of BGP.

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

  • Connect: BGP is waiting for the TCP connection to be established before performing subsequent operations.
  • If the TCP connection is successfully established, BGP stops the ConnectRetry timer and sends an Open message to the peer. BGP then enters the Opensent state.
  • If the TCP connection fails to be established, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection initiated by the remote peer, and changes its state to Active.
  • If the ConnectRetry timer expires, BGP restarts the ConnectRetry timer and attempts to establish a TCP connection with the peer again. At this time, BGP remains in the Connect state.
  • Active: BGP attempts to establish a TCP connection. This is the intermediate state of BGP.
  • If the TCP connection is successfully established, BGP restarts the ConnectRetry Timer with the initial value, sends an Open message to the remote peer, and changes its state to Opensent.
  • If the ConnectRetry timer expires, BGP restarts the ConnectRetry timer and enters the Connect state.
  • If BGP attempts to establish a TCP connection with an unknown IP address, the TCP connection fails, the ConnectRetry Timer is reset, and BGP remains in the Active state.
  • OpenSent: BGP has sent an Open message to the peer and is now waiting for an Open message from the peer.
  • If BGP receives a correct Open message, BGP enters the OpenConfirm state.
  • If the Open message received by BGP is incorrect, BGP sends a Notification message to the peer and enters the Idle state.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection initiated by the remote peer, and changes its state to Active.
  • OpenConfirm: BGP is waiting for a Notification message or a Keepalive message.
  • If BGP receives a Notification message or a TCP connection teardown message, BGP changes its state to Idle.
  • If BGP receives a Keepalive message, BGP enters the Established state.
  • Established: indicates that BGP peers can exchange Update, Notification, and Keepalive messages.
  • If BGP receives an Update or Keepalive message, BGP remains in the Established state.
  • If BGP receives a Notification message, BGP changes its state to Idle.
  • No neg: The address family is not enabled for the BGP peer. In this state, Update messages can be exchanged in other successfully negotiated address families. If the address family is enabled on the remote BGP peer, the local BGP peer receives a Notification message, disconnects from the remote BGP peer, changes to the Idle state, and re-establishes a connection with the remote BGP peer.
BGP current event

Current BGP event.

BGP last state

State of last BGP stage, which may be Idle, Connect, Active, OpenSent, OpenConfirm, Established or No neg.

BGP Peer Up count

Number of times the BGP peer flaps within a specified period.

Peer Preferred Value

Preferred value of the BGP peer.

Peer optional capabilities

Optional capabilities supported by the peer.

Received total routes

Number of route prefixes received.

Received active routes total

Number of received active route prefixes.

Received : Active Hold Time

Hold time of the peer.

Received

Number of packets received from neighbors:

  • Total: total number of records.
  • Update messages: number of Update messages.
  • Open messages: number of Open messages.
  • KeepAlive messages: number of Keepalive messages.
  • Number of Notification messages:Notification packets.
  • Refresh messages: number of Route-refresh messages.
Advertised total routes

Number of route prefixes sent.

Keepalive Time

Interval at which Keepalive messages are sent to the peer.

Address family IPv4 Unicast

IPv4 unicast address family.

Address family VPNv6 Unicast

VPNv6 address family.

Authentication type configured

Configured authentication type.

Last keepalive received

Time when a Keepalive message was last received.

Last keepalive sent

Time when the last Keepalive message was sent.

Minimum route advertisement interval is 30 seconds

Minimum route advertisement interval.

  • The minimum interval at which EBGP routes are advertised is 30 seconds.
  • The minimum interval at which IBGP routes are advertised is 15 seconds.
Optional capabilities

Optional capabilities supported by the BGP peer.

Route refresh capability has been enabled

Route refreshing has been enabled.

Routing policy configured

Indicates the configured routing policy.

Type

BGP link type, which can be either IBGP Link or EBGP Link.

Port

Port type:

  • Local: indicates the local port number, which is always 179. BGP uses TCP at the transport layer.
  • Remote: indicates the port number used on the peer.
Configured

Locally configured timers.

  • Active Hold Time: indicates the hold time. If BGP does not receive any Keepalive message from the peer in the hold time, BGP considers that the peer is down and then instructs other peers to remove the routes that are received from the peer.
  • Keep Alive Time: indicates the interval at which Keepalive messages are sent to the peer. BGP peers exchange Keepalive messages periodically to notify each other that they are in the Active state.
Negotiated

Hold time agreed between the BGP peers after capability negotiation.

Sent

Number of messages sent to a peer.

  • Total: indicates the total number of messages sent to a peer.
  • Update messages: indicates the number of Update messages sent to a peer.
  • Open messages: indicates the number of Open messages sent to a peer.
  • KeepAlive messages: indicates the number of Keepalive messages sent to a peer.
  • Notification messages: indicates the number of Notification messages sent to a peer.
  • Refresh messages: indicates the number of route-refresh messages sent to a peer.

display bgp vpnv6 all routing-table peer

Function

The display bgp vpnv6 all routing-table peer command displays BGP VPNv6 routes.

Format

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr advertised-routes

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr received-routes

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr received-routes active

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr advertised-routes ipv6-address [ masklen ]

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr received-routes ipv6-address [ masklen [ original-attributes ] ]

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr advertised-routes

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr received-routes

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr received-routes active

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr advertised-routes ipv6-address [ masklen ]

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr received-routes ipv6-address [ masklen [ original-attributes ] ]

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr advertised-routes statistics

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr received-routes statistics

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr received-routes active statistics

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv4Addr advertised-routes

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv4Addr received-routes

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv4Addr advertised-routes statistics

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv4Addr received-routes statistics

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv4Addr advertised-routes ipv6-address [ masklen ]

Parameters

Parameter Description Value
remoteIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

advertised-routes

Indicates the routes advertised to the peer.

-

peer

Peer routers.

-

received-routes

Displays routes received from the remote peer.

-

active

Displays active routes from the remote peer.

-

statistics

Displays route statistics.

-

ipv6-address

Specifies an ipv6 network address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

masklen

Specifies an IP address prefix length.

It is an integer ranging from 0 to 128.

original-attributes

Displays original route attributes.

-

remoteIpv6Addr

Specifies an IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

instance bgpName

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv6 all routing-table command displays BGP VPNv6 routes.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display advertised BGP vrf6 routes.
<HUAWEI> display bgp vpnv6 vpn-instance vr1 routing-table peer 2001:DB8:2::2 advertised-routes
Total Number of Routes: 1

 BGP Local router ID is 10.2.1.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 *>  Network  : 2001:DB8:2001::                          PrefixLen : 64
     NextHop  : ::                                       LocPrf    :
     MED      : 0                                        PrefVal   : 0
     Label    : NULL
     Path/Ogn : ?
Table 2-581 Description of the display bgp vpnv6 all routing-table peer command output
Item Description
Total Number of Routes

Total number of BGP VPNv6 routes.

BGP Local router ID

ID of the local BGP device, in the same format as an IPv4 address.

Network

Indicates the destination network or host address of the route.

PrefixLen

Mask length of the destination network address or host address of the route.

NextHop

IPv6 address of the next hop.

Label

Indicates the label carried by the data packet destined for the destination network or host address of the route.

Path/Ogn

AS_Path and Origin attributes of a route.

origin

Indicates the origin of the route.

display bgp vpnv6 brief

Function

The display bgp vpnv6 brief command displays brief information about VPNv6 instances.

Format

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] vpnv6 all brief

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name brief

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 all brief

display bgp vpnv6 vpn-instance vpn-instance-name brief

Parameters

Parameter Description Value
instance bgpName

Specify the BGP instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported.

all

Displays information about all VPNv6 instances.

-

vpn-instance vpn-instance-name

Specifies the name of a VPNv6 instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

When you run the display bgp vpnv6 brief command to view information about IPv6 VPN instances, the IPv6 VPN instances are listed in lexicographic order by name.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display brief information about VPNv6 instances.
<HUAWEI> display bgp vpnv6 all brief
VPNV6 :
  Rd Num              Peer Num            Route Num
  0                   1                   0

VPN-Instance(IPv6-family):
  VPN-Instance Name   Peer Num            Route Num
  vrf0                   0                   0
  vrf1                   0                   0
  vrf11                  0                   0
  vrf12                  0                   0
  vrf13                  0                   0
  vrf14                  0                   0
  vrf2                   0                   20
  vrf3                   0                   20
  vrf4                   0                   24
  vrf5                   0                   24
  vrf6                   0                   0
Table 2-582 Description of the display bgp vpnv6 brief command output
Item Description
VPNV6

BGP-VPNv6 address family.

Rd Num

Number of RDs.

Peer Num

Number of peers.

Route Num

Number of routes.

VPN-Instance Name

Name of a VPN instance.

VPN-Instance(IPv6-family)

BGP-VPN instance IPv6 address family.

display bgp vpnv6 group

Function

The display bgp vpnv6 group command is used to display the VPNv6 peer group information.

Format

For S6730-H-V2, S5732-H-V2:

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

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

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 vpn-instance vpn-instance-name group

display bgp vpnv6 vpn-instance vpn-instance-name group group-name

Parameters

Parameter Description Value
instance bgpName

Specifies the name of a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

vpn-instance vpn-instance-name

Specify a VPN-Instance (VRF) name.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

group-name

Specify a peer-group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv6 group command is used to display the VPNv6 peer group information.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the VPNv6 peer group information.
<HUAWEI> display bgp vpnv6 vpn-instance vpn6 group
BGP peer-group      : g1
 Remote AS 65410
 Type               : external
 PeerSession Members:
   2001:DB8:2000::2
 
 Peer Members:
   2001:DB8:2000::2
Table 2-583 Description of the display bgp vpnv6 group command output
Item Description
BGP peer-group

Name of a BGP peer group.

Remote AS

Number of the AS where a peer group resides.

Type

Type of a peer group:

  • internal: indicates that the peer group is an IBGP peer group.
  • external: indicates that the peer group is an EBGP peer group.
PeerSession Members

Peers with which sessions have been established.

Peer Members

Peer information.

display bgp vpnv6 network

Function

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

Format

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] vpnv6 all network

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name network

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 all network

display bgp vpnv6 vpn-instance vpn-instance-name network

Parameters

Parameter Description Value
instance bgpName

Specifies the name of a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

all

Display all information on VPNv6 routes.

-

vpn-instance vpn-instance-name

Specify a VPN-Instance (VRF) name.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the routes imported into the BGP VPNv6 routing table using the network command.
<HUAWEI> display bgp vpnv6 all network
BGP Local Router ID is 10.2.2.9
Local AS Number is 100

Route Distinguisher: 100:5
(vrf1)
Network          Prefix            Route-policy
2001:DB8:3::3    128

Route Distinguisher: 100:9
(vrf2)
Network          Prefix            Route-policy
2001:DB8:8::9    128
Table 2-584 Description of the display bgp vpnv6 network command output
Item Description
BGP Local Router ID is

Router ID of the local device, in the format of an IPv4 address.

Local AS Number is

Local AS number.

Router ID

Router ID.

Network

Locally advertised network address.

Prefix

Network address mask of an imported route.

Route-policy

Route-policy.

Route Distinguisher

Route distinguisher.

display bgp vpnv6 peer

Function

The display bgp vpnv6 peer command is used to display the information of the BGP VPNv6 peer.

Format

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] vpnv6 all peer

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

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 all peer

display bgp vpnv6 vpn-instance vpn-instance-name peer

Parameters

Parameter Description Value
instance bgpName

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

all

Display all information on VPNv6 routes.

-

vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv6 peer command is used to display the information of the BGP VPNv6 peer.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display brief information about VPNv6 peers.
<HUAWEI> display bgp vpnv6 all peer
BGP local router ID : 10.1.1.1
 Local AS number : 100
 Total number of peers : 2                 Peers in established state : 2

  Peer              V    AS  MsgRcvd  MsgSent  OutQ  Up/Down       State PrefRcv

  10.2.2.2          4   100      210      220     0   02:42:55     Established    1

  Peer of IPv6-family for vpn instance :

  VPN-Instance vpn1 :
  2001:DB8:2000::2  4   65410    205      178     0   02:42:53     Established    0
Table 2-585 Description of the display bgp vpnv6 peer command output
Item Description
BGP local router ID

Router ID of the BGP local device.

If two ends have the same BGP local router ID, no BGP peer relationship can be established between them. In this situation, run the router id command in the BGP view on either end to change the BGP local router ID. Changing it to the IP address of a loopback interface is recommended.

Local AS number

Local AS number.

AS

Autonomous system number.

Total number of peers

Number of BGP peers.

Peers in established state

Number of BGP peers in the Established state.

Peer

Peer IP address.

V

BGP version.

MsgRcvd

BGP version of a peer.

MsgSent

Number of messages sent.

OutQ

Number of messages waiting to be sent to a specified peer.

Up/Down

Period during which a BGP session keeps the current state.

  • When the duration is shorter than 24 hours, the value is displayed as xx:xx:xx, indicating xx hours xx minutes and xx seconds.
  • When the duration is longer than 24 hours, xxxxhxxm is displayed, indicating xxxx hours and xx minutes.
State

Status of the peer:

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

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

  • Connect: indicates that BGP is waiting for the TCP connection to be set up before it determines whether to perform other operations.
  • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active.
  • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value, initiates a TCP connection request to the remote BGP peer, and stays in the Connect state.
  • Active: indicates that BGP tries to set up a TCP connection. This is the intermediate status of BGP.
  • If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent.
  • If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value and changes its state to Connect.
  • If BGP initiates a TCP connection request with an unknown IP address, the TCP connection fails. When this occurs, BGP restarts the ConnectRetry Timer with the initial value and stays in the Active state.
  • OpenSent: indicates that BGP has sent one Open message to its peer and is waiting for the other Open message from the peer.
  • If there are no errors in the Open message received, BGP changes its state to OpenConfirm.
  • If there are errors in the Open message received, BGP sends a Notification message to the remote peer and changes its state to Idle.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active.
  • OpenConfirm: indicates that BGP is waiting for a Notification or Keepalive message.
  • If BGP receives a Notification message, or the TCP connection fails, BGP changes its state to Idle.
  • If BGP receives a Keepalive message, BGP changes its state to Established.
  • Established: indicates that BGP peers can exchange Update, Notification, and Keepalive messages.
  • If BGP receives an Update or a Keepalive message, its state stays in Established.
  • If BGP receives a Notification message, BGP changes its state to Idle.
  • No neg: The address family is not enabled for the BGP peer. In this state, Update messages can be exchanged in other address families whose capabilities have been successfully negotiated. If the address family is enabled for the BGP peer, the local BGP peer receives a Notification message, and the peer relationship is disconnected. Then, the BGP peer changes to the Idle state and re-establishes the peer relationship.
PrefRcv

Number of route prefixes sent from the peer.

display bgp vpnv6 peer log-info

Function

The display bgp vpnv6 peer log-info command displays the log information of the BGP VPNv6 address family.

Format

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name peer ipv6-address log-info

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name peer-group group-name log-info

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 vpn-instance vpn-instance-name peer ipv6-address log-info

display bgp vpnv6 vpn-instance vpn-instance-name peer-group group-name log-info

Parameters

Parameter Description Value
instance bgpName

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

ipv6-address

Specifies an IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

peer-group group-name

Specifies a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv6 peer log-info command displays the log information of the BGP VPNv6 address family.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the log information of the BGP VPNv6 address family.
<HUAWEI> display bgp vpnv6 vpn-instance vpn1 peer 2001:DB8:1::2 log-info
            
Peer : 2001:DB8:1::2 

 Date/Time     : 2019-09-17 06:43:16+00:00
 State         : Up

 Date/Time     : 2019-09-17 06:42:33+00:00
 State         : Down
 Error Code    : 6(CEASE)
 Error Subcode : 6(Other Configuration Change)
 Notification  : Receive Notification

 Date/Time     : 2019-09-17 06:42:29+00:00
 State         : Up

 Date/Time     : 2019-09-17 06:42:19+00:00
 State         : Down
 Error Code    : 6(CEASE)
 Error Subcode : 6(Other Configuration Change)
 Notification  : Send Notification

 Date/Time     : 2019-09-17 05:00:02+00:00
 State         : Up
                
 Date/Time     : 2019-09-17 04:59:52+00:00
 State         : Down
 Error Code    : 6(CEASE)
 Error Subcode : 6(Other Configuration Change)
 Notification  : Receive Notification

 Date/Time     : 2019-09-17 04:58:31+00:00
 State         : Up
Table 2-586 Description of the display bgp vpnv6 peer log-info command output
Item Description
Peer

Peers.

Date/Time

Date/Time.

State

Thread status.

Error Code

Error code.

Error Subcode

Error sub-code.

Notification

Notification message sent or received by a peer.

display bgp vpnv6 peer verbose

Function

The display bgp vpnv6 peer verbose command displays detailed information about BGP VPNv6 peers.

Format

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name peer verbose

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name peer ipv6-address verbose

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 vpn-instance vpn-instance-name peer verbose

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

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 vpn-instance vpn-instance-name peer ipv4-address verbose

Parameters

Parameter Description Value
instance bgpName

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

ipv6-address

Specifies an IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv6 peer verbose command displays detailed information about BGP VPNv6 peers.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display detailed information about BGP VPNv6 peers.
<HUAWEI> display bgp vpnv6 vpn-instance vrf1 peer 2001:DB8:12::2 verbose

         BGP Peer is 2001:DB8:12::2,  remote AS 200
         Type: EBGP link
         BGP version 4, Remote router ID 10.1.1.2
         Update-group ID: 6
         BGP current state: Established, Up for 00h05m02s
         BGP current event: RecvKeepalive
         BGP last state: OpenConfirm
         BGP Peer Up count: 1
         Received total routes: 0
         Received active routes total: 0
         Advertised total routes: 0
         Port: Local - 179        Remote - 54463
         Configured: Connect-retry Time: 32 sec
         Configured: Min Hold Time: 0 sec
         Configured: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Received  : Active Hold Time: 180 sec
         Negotiated: Active Hold Time: 180 sec   Keepalive Time:60 sec
         Peer optional capabilities:
         Peer supports bgp multi-protocol extension
         Peer supports bgp route refresh capability
         Peer supports bgp 4-byte-as capability
         Address family IPv6 Unicast: advertised and received
 Received: Total 8 messages
                  Update messages                1
                  Open messages                  1
                  KeepAlive messages             6
                  Notification messages          0
                  Refresh messages               0
 Sent: Total 10 messages
                  Update messages                1
                  Open messages                  3
                  KeepAlive messages             6
                  Notification messages          0
                  Refresh messages               0
 Authentication type configured: None
 Last keepalive received: 2020-01-28 17:24:31+00:00
 Last keepalive sent    : 2020-01-28 17:24:12+00:00
 Last update    received: 2020-01-28 17:20:03+00:00
 Last update    sent    : 2020-01-28 17:20:03+00:00
 No refresh received since peer has been configured
 No refresh sent since peer has been configured
 Minimum route advertisement interval is 30 seconds
 Optional capabilities:
 Route refresh capability has been enabled
 4-byte-as capability has been enabled
 Peer Preferred Value: 0
 Routing policy configured:
 No routing policy is configured
Table 2-587 Description of the display bgp vpnv6 peer verbose command output
Item Description
BGP version

BGP version.

BGP current state

Current BGP status:

  • Idle: BGP denies any connection request. This is the initial status of BGP.

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

  • Connect: BGP is waiting for the TCP connection to be established before performing subsequent operations.
  • If the TCP connection is successfully established, BGP stops the ConnectRetry timer and sends an Open message to the peer. BGP then enters the Opensent state.
  • If the TCP connection fails to be established, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection initiated by the remote peer, and changes its state to Active.
  • If the ConnectRetry timer expires, BGP restarts the ConnectRetry timer and attempts to establish a TCP connection with the peer again. At this time, BGP remains in the Connect state.
  • Active: BGP attempts to establish a TCP connection. This is the intermediate state of BGP.
  • If the TCP connection is successfully established, BGP restarts the ConnectRetry Timer with the initial value, sends an Open message to the remote peer, and changes its state to Opensent.
  • If the ConnectRetry timer expires, BGP restarts the ConnectRetry timer and enters the Connect state.
  • If BGP attempts to establish a TCP connection with an unknown IP address, the TCP connection fails, the ConnectRetry Timer is reset, and BGP remains in the Active state.
  • OpenSent: BGP has sent an Open message to the peer and is now waiting for an Open message from the peer.
  • If BGP receives a correct Open message, BGP enters the OpenConfirm state.
  • If the Open message received by BGP is incorrect, BGP sends a Notification message to the peer and enters the Idle state.
  • If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection initiated by the remote peer, and changes its state to Active.
  • OpenConfirm: BGP is waiting for a Notification message or a Keepalive message.
  • If BGP receives a Notification message or a TCP connection teardown message, BGP changes its state to Idle.
  • If BGP receives a Keepalive message, BGP enters the Established state.
  • Established: indicates that BGP peers can exchange Update, Notification, and Keepalive messages.
  • If BGP receives an Update or Keepalive message, BGP remains in the Established state.
  • If BGP receives a Notification message, BGP changes its state to Idle.
  • No neg: The address family is not enabled for the BGP peer. In this state, Update messages can be exchanged in other successfully negotiated address families. If the address family is enabled on the remote BGP peer, the local BGP peer receives a Notification message, disconnects from the remote BGP peer, changes to the Idle state, and re-establishes a connection with the remote BGP peer.
BGP current event

Current BGP event.

BGP last state

State of last BGP stage, which may be Idle, Connect, Active, OpenSent, OpenConfirm, Established or No neg.

BGP Peer Up count

Number of times the BGP peer flaps within a specified period.

BGP Peer is

IP address of a peer.

Peer Preferred Value

Preferred value of the BGP peer.

Peer optional capabilities

Optional capabilities supported by the peer.

Remote router ID

Router ID of the peer.

Update-group ID

ID of the Update group to which a peer belongs.

Received total routes

Number of route prefixes received.

Received active routes total

Number of received active route prefixes.

Received

Number of packets received from neighbors:

  • Total: total number of records.
  • Update messages: number of Update messages.
  • Open messages: number of Open messages.
  • KeepAlive messages: number of Keepalive messages.
  • Number of Notification messages:Notification packets.
  • Refresh messages: number of Route-refresh messages.
Advertised total routes

Number of route prefixes sent.

Keepalive Time

Interval at which Keepalive messages are sent to the peer.

4-byte-as capability has been enabled

The 4-byte AS capability has been enabled.

Address family IPv6 Unicast

IPv6 unicast address family.

Notification

Notification message sent or received by a peer.

Authentication type configured

Authentication type.

Last keepalive received

Time when a Keepalive message was last received.

Last keepalive sent

Last time when a Keepalive message is sent.

Last update received

Last time when an Update message is received.

Last update sent

Last time when an Update message is sent.

No refresh received since peer has been configured

No Route-Refresh packets are received from the peer since the peer relationship is established.

No refresh sent since peer has been configured

No Route-Refresh messages have been sent to the peer since the peer relationship was established.

Minimum route advertisement interval is 30 seconds

Minimum interval at which routes are advertised:

Optional capabilities

Optional capabilities supported by the BGP peer.

Route refresh capability has been enabled

Route refreshing has been enabled.

Routing policy configured

Indicates the configured routing policy.

Type

BGP link type, which can be either IBGP Link or EBGP Link.

Port

Port type:

  • Local: indicates the local port number, which is always 179. BGP uses TCP at the transport layer.
  • Remote: indicates the port number used on the peer.
Configured

Locally configured timers.

  • Active Hold Time: indicates the hold time. If BGP does not receive any Keepalive message from the peer in the hold time, BGP considers that the peer is down and then instructs other peers to remove the routes that are received from the peer.
  • Keep Alive Time: indicates the interval at which Keepalive messages are sent to the peer. BGP peers exchange Keepalive messages periodically to notify each other that they are in the Active state.
Sent

Number of messages sent to a peer.

  • Total: indicates the total number of messages sent to a peer.
  • Update messages: indicates the number of Update messages sent to a peer.
  • Open messages: indicates the number of Open messages sent to a peer.
  • KeepAlive messages: indicates the number of Keepalive messages sent to a peer.
  • Notification messages: indicates the number of Notification messages sent to a peer.
  • Refresh messages: indicates the number of route-refresh messages sent to a peer.
Negotiated

The value of negotiated timer.

display bgp vpnv6 routing-table

Function

The display bgp vpnv6 routing-table command displays BGP VPNv6 routes.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics community-filter { basic-community-filter-number | advanced-community-filter-number }

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics community-filter community-filter-name

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics community [ community-number | aa:nn | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33>

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

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics regular-expression as-regular-expression

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics

display bgp vpnv6 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table statistics different-origin-as

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics community-filter basic-community-filter-number whole-match

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics community-filter community-filter-name whole-match

display bgp vpnv6 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table statistics best

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics extcommunity [ { rt | soo } strExtCommunity ] &<1-33>

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics extcommunity [ { rt | soo } strExtCommunity ] &<1-33> match-any

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics extcommunity-filter { basic-extcomm-filter-number | advanced-extcomm-filter-number }

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics extcommunity-filter extcomm-filter-name

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics large-community [ aa:bb:cc ] &<1-33>

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics large-community [ aa:bb:cc ] &<1-33> whole-match

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics large-community-filter large-community-filter-name

display bgp vpnv6 route-distinguisher route-distinguisher routing-table statistics large-community-filter large-community-filter-name whole-match

display bgp vpnv6 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table statistics active

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table community-filter { basic-community-filter-number | advanced-community-filter-number }

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table community-filter community-filter-name

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table community [ community-number | aa:nn | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33>

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table community [ community-number | aa:nn | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> whole-match

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table regular-expression as-regular-expression

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table

display bgp [ instance bgpName ] vpnv6 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table ipv6-address [ prefix-length ]

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table different-origin-as

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table community-filter basic-community-filter-number whole-match

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table community-filter community-filter-name whole-match

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table extcommunity [ { rt | soo } strExtCommunity ] &<1-33>

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table extcommunity [ { rt | soo } strExtCommunity ] &<1-33> match-any

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table extcommunity-filter { basic-extcomm-filter-number | advanced-extcomm-filter-number }

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table extcommunity-filter extcomm-filter-name

display bgp [ instance bgpName ] vpnv6 { all | vpn-instance vpn-instance-name } routing-table ipv6-address prefix-length longer-prefixes

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table large-community [ aa:bb:cc ] &<1-33>

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table large-community [ aa:bb:cc ] &<1-33> whole-match

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table large-community-filter large-community-filter-name

display bgp [ instance bgpName ] vpnv6 route-distinguisher route-distinguisher routing-table large-community-filter large-community-filter-name whole-match

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 route-distinguisher route-distinguisher routing-table community-filter { basic-community-filter-number | advanced-community-filter-number }

display bgp vpnv6 route-distinguisher route-distinguisher routing-table community-filter community-filter-name

display bgp vpnv6 route-distinguisher route-distinguisher routing-table community [ community-number | aa:nn | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33>

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

display bgp vpnv6 route-distinguisher route-distinguisher routing-table as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp vpnv6 route-distinguisher route-distinguisher routing-table regular-expression as-regular-expression

display bgp vpnv6 route-distinguisher route-distinguisher routing-table

display bgp vpnv6 { route-distinguisher route-distinguisher | all | vpn-instance vpn-instance-name } routing-table ipv6-address [ prefix-length ]

display bgp vpnv6 route-distinguisher route-distinguisher routing-table different-origin-as

display bgp vpnv6 route-distinguisher route-distinguisher routing-table community-filter basic-community-filter-number whole-match

display bgp vpnv6 route-distinguisher route-distinguisher routing-table community-filter community-filter-name whole-match

display bgp vpnv6 route-distinguisher route-distinguisher routing-table extcommunity [ { rt | soo } strExtCommunity ] &<1-33>

display bgp vpnv6 route-distinguisher route-distinguisher routing-table extcommunity [ { rt | soo } strExtCommunity ] &<1-33> match-any

display bgp vpnv6 route-distinguisher route-distinguisher routing-table extcommunity-filter { basic-extcomm-filter-number | advanced-extcomm-filter-number }

display bgp vpnv6 route-distinguisher route-distinguisher routing-table extcommunity-filter extcomm-filter-name

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table ipv6-address prefix-length longer-prefixes

display bgp vpnv6 route-distinguisher route-distinguisher routing-table large-community [ aa:bb:cc ] &<1-33>

display bgp vpnv6 route-distinguisher route-distinguisher routing-table large-community [ aa:bb:cc ] &<1-33> whole-match

display bgp vpnv6 route-distinguisher route-distinguisher routing-table large-community-filter large-community-filter-name

display bgp vpnv6 route-distinguisher route-distinguisher routing-table large-community-filter large-community-filter-name whole-match

Parameters

Parameter Description Value
route-distinguisher route-distinguisher

Specifies an RD of a remote route.

The value is in the format of a:b:c. The values of a, b, and c are integers ranging from 0 to 4294967295.

all

Displays all information on VPNv6 and IPv6 VPN instances.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

routing-table

Displays the BGP routing table.

-

ipv6-address

Specifies an IPv6 network address.

The value is an integer ranging from 0 to 4294967295.

prefix-length

Specifies an IP network prefix length.

It is an integer ranging from 0 to 128.

vpnv6

Indicates the VPNv6 address family.

-

statistics

Displays statistics of routes.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

different-origin-as

Displays the routes with the same destination address and mask but different origin AS numbers.

The value is an integer ranging from 1 to 256.

vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

best

Displays statistics about best, Add-path, and best-external routes.

-

longer-prefixes

Allows match against longer masks.

-

active

Displays active routes.

-

community-filter basic-community-filter-number

Specifies the number of a basic community filter.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

community-filter community-filter-name

Specifies the name of a community filter.

The value is an integer ranging from 100 to 199.

community-filter advanced-community-filter-number

Specifies the number of an advanced community filter.

The value is an integer ranging from 1 to 199.

community community-number

Specifies a community number.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

community aa:nn

Specifies a community number.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

internet

Indicates the Internet (well-known) community attribute.

-

no-advertise

Indicates a community that prevents routes from being advertised to any peer.

-

no-export

Indicates a community that prevents routes from being advertised outside an AS.

-

no-export-subconfed

Indicates a community that prevents routes from being advertised outside a sub-AS.

-

g-shut

Display routes with the Grateful-Shutdown community attribute.

-

whole-match

Indicates exact match with the specified community.

The value is a string of 1 to 80 characters.

as-path-filter as-path-filter-num

Specifies an AS_Path filter index.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

as-path-filter as-path-filter-name

Specifies an AS_Path filter name (a string of 1 to 51 characters, which cannot contain only digits.).

The value is an integer ranging from 1 to 99.

regular-expression as-regular-expression

Displays the routes that match the regular expression.

The value is a string of 1 to 80 characters.

extcommunity

Displays routes matching a specified ext-community.

-

rt

Specifies a route target extended community.

-

soo

Specifies the SoO extended community.

-

strExtCommunity

Specifies the excommunity value.

The attribute value can be expressed in one of the following formats:

  • 2-byte AS number:4-byte user-defined number, for example, 1:3. The AS number is an integer ranging from 0 to 65535, and the user-defined number is an integer ranging from 0 to 4294967295. The AS number and user-defined number cannot both be set to 0. That is, the SoO must not be 0:0.
  • IPv4 address:2-byte user-defined number, for example, 192.168.122.15:1. The IP address ranges from 0.0.0.0 to 255.255.255.255, and the user-defined number is an integer ranging from 0 to 65535.
  • 4-byte AS number in integer format:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295, and a user-defined number ranges from 0 to 65535.
  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535. A user-defined number also ranges from 0 to 65535. The AS number and user-defined number must not be both 0s. That is, the SoO must not be 0.0:0.
match-any

Matches any specified extended communities.

-

extcommunity-filter extcomm-filter-name

Specifies the name of an extcommunity filter.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

extcommunity-filter basic-extcomm-filter-number

Specifies the number of an extcommunity filter.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

extcommunity-filter advanced-extcomm-filter-number

Specifies the number of an advanced extcommunity filter.

The value is an integer ranging from 200 to 399.

large-community aa:bb:cc

Specifies a value of the Large-Community attribute.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

large-community-filter large-community-filter-name

Specifies a Large-Community list name.

The value is a string of 1 to 51 case-sensitive characters. It cannot contain spaces.

instance bgpName

Specifies the name of a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is an integer ranging from 200 to 399.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

You can view only specific routing information by specifying different parameters.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about the Best, Add-Path, and Best-External VPNv6 routes.
<HUAWEI> display bgp vpnv6 all routing-table statistics best
 Total Number of Best Routes from All PE: 1
 Total Number of Add-path Routes from All PE: 0 
 Total Number of Best-external Routes from All PE: 1
 VPN-Instance vrf1, Router ID 10.10.1.1:
Total Number of Best Routes: 1
 VPN-Instance vrf2, Router ID 10.10.1.1:
Total Number of Best Routes: 1
# Display statistics about active VPNv6 routes.
<HUAWEI> display bgp vpnv6 all routing-table statistics active
 Total number of routes from all PE: 2
 VPN-Instance vrf1, router ID 10.10.1.1:
 Total Number of Prefix Advertised to RM : 2
 Total Number of Active Route : 2
# Display the Ext-Community information contained in a VPNv6 route with a specified prefix.
<HUAWEI> display bgp vpnv6 all routing-table 2001:DB8:2:3:: ext-community
Routes of vpn-instance vrf2:
 BGP routing table entry information of 2001:DB8:2:3::/64:
 From: 2001:DB8:42:4::7:7
Table 2-588 Description of the display bgp vpnv6 routing-table command output
Item Description
Total number of routes from all PE

Number of routes received from all PEs in the routing table.

Total Number of Best Routes from All PE

Number of Best routes.

Total Number of Add-path Routes from All PE

Number of Add-Path routes.

Total Number of Best-external Routes from All PE

Number of Best-external routes.

Total Number of Best Routes

Number of optimal routes.

Total Number of Prefix Advertised to RM

Number of routes delivered to the RM module.

Total Number of Active Route

Number of active routes.

From

Source peer that sent the route.

Pre

Preference of a route.

display bgp vpnv6 routing-table (Route Attributes)

Function

The display bgp vpnv6 routing-table command displays BGP VPNv6 routes.

Format

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] vpnv6 all routing-table ipv6-address [ ipv6-mask-length ] { as-path | community-list | large-community | ext-community | cluster-list | advertised-peer }

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name routing-table ipv6-address [ ipv6-mask-length ] { as-path | community-list | large-community | ext-community | cluster-list | advertised-peer }

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name routing-table peer peerIpv6Addr advertised-routes ipv6-address [ ipv6-mask-length ] { as-path | community-list | large-community | ext-community | cluster-list | advertised-peer }

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 all routing-table ipv6-address [ ipv6-mask-length ] { as-path | community-list | large-community | ext-community | cluster-list | advertised-peer }

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

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer peerIpv6Addr advertised-routes ipv6-address [ ipv6-mask-length ] { as-path | community-list | large-community | ext-community | cluster-list | advertised-peer }

Parameters

Parameter Description Value
ipv6-address

Specifies an ipv6 network address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

ipv6-mask-length

Specifies an IP address prefix length.

The value is an integer ranging from 0 to 128.

as-path

Indicates the AS path list.

-

community-list

Indicates the BGP community list.

-

ext-community

Indicates the BGP ext-community list.

-

cluster-list

Indicates a BGP RR cluster list.

-

advertised-peer

Indicates the list of peers to which routes are sent.

-

vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

all

Displays all information about VPNv6 and IPv6 VPN instances.

-

peer peerIpv6Addr

Specifies an IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

advertised-routes

Indicates the routes advertised to the peer.

-

large-community

Displays routes with large communities.

-

instance bgpName

Specifies the name of a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv6 routing-table command displays BGP VPNv6 routes.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the Ext-Community information contained in a VPNv6 route with a specified prefix.
<HUAWEI> display bgp vpnv6 all routing-table 2001:DB8:2:3:: ext-community
Routes of vpn-instance vrf2:
 BGP routing table entry information of 2001:DB8:2:3::/64:
 From: 2001:DB8:42:4::7:7
# Display the cluster list contained in a VPNv6 route with a specified prefix.
<HUAWEI> display bgp vpnv6 all routing-table 2001:DB8:2:3:: cluster-list
Routes of vpn-instance vrf2:
 BGP routing table entry information of 2001:DB8:2:3::/64:
 From: 2001:DB8:42:4::7:7
# Display the AS_Path information contained in a VPNv6 route with a specified prefix.
<HUAWEI> display bgp vpnv6 all routing-table 2001:DB8:2:3:: as-path
Routes of vpn-instance vrf2:
 BGP routing table entry information of 2001:DB8:2:3::/64:
 From: 2001:DB8:42:4::7:7
 AS-path 65004
Table 2-589 Description of the display bgp vpnv6 routing-table (Route Attributes) command output
Item Description
BGP routing table entry information of

The following information is about a specified BGP routing entry.

AS-path

AS_Path attribute.

Nil indicates that the attribute value is null.

From

IPv6 address of the route originator.

display bgp vpnv6 routing-table dampened

Function

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

Format

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name routing-table dampened

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

Parameters

Parameter Description Value
instance bgpName

Specifies the name of a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

vpn-instance vpn-instance-name

Specify a VPN-Instance (VRF) name.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display dampened BGP VPNv6 routes.
<HUAWEI> display bgp vpnv6 vpn-instance vpn1 routing-table dampened
 BGP Local router ID is 10.1.1.1
 Status codes: * - valid, > - best, d - damped, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
 Origin      : i - IGP, e - EGP, ? - incomplete
 Total Number of Routes: 3
    Network           From              Reuse     Path/Origin
 d  2001:DB8:1::1     2001:DB8:20::20   00:09:33  1.1 100?
 d  2001:DB8:1::2     2001:DB8:20::20   00:09:33  1.1 100?
 d  2001:DB8:1::3     2001:DB8:20::20   00:09:33  1.1 100?
Table 2-590 Description of the display bgp vpnv6 routing-table dampened command output
Item Description
Total Number of Routes

Total number of routes.

Network

Indicates the network address in the BGP routing table.

From

IP address of the peer from which the route is learned.

Reuse

Reuse value (in seconds).

Path

Indicates the AS_Path number and the Origin attribute.

display bgp vpnv6 routing-table dampening parameter

Function

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

Format

For S6730-H-V2, S5732-H-V2:

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

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

Parameters

Parameter Description Value
instance bgpName

Specifies the name of a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display configured BGP VPNv6 route dampening parameters.
<HUAWEI> display bgp vpnv6 vpn-instance VPN1 routing-table dampening parameter
 Maximum Suppress Time(in second)  : 3973
 Ceiling Value                     : 16000
 Reuse Value                       : 750
 HalfLife Time(in second)          : 900
 Suppress-Limit                    : 2000
Table 2-591 Description of the display bgp vpnv6 routing-table dampening parameter command output
Item Description
Maximum Suppress Time(in second)

Maximum route suppression time, in seconds.

Ceiling Value

Penalty ceiling.

Reuse Value

Threshold for the routes to be unsuppressed.

HalfLife Time(in second)

Half life of a reachable route, in seconds.

Suppress-Limit

Threshold for the routes to be suppressed.

display bgp vpnv6 routing-table different-origin-as

Function

The display bgp vpnv6 routing-table different-origin-as command is used to display the VPNv6 routes with the same destination address but different source AS numbers.

Format

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] vpnv6 { all | vpn-instance vpn-instance-name } routing-table different-origin-as

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table different-origin-as

Parameters

Parameter Description Value
instance bgpName

Specifies the name of a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

all

Displays all the BGP routes in the specified address family.

-

vpn-instance vpn-instance-name

Specify a VPN-Instance (VRF) name.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv6 routing-table different-origin-as command is used to display the VPNv6 routes with the same destination address but different source AS numbers.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the VPNv6 routes with the same destination address but different source AS numbers.
<HUAWEI> display bgp vpnv6 all routing-table different-origin-as
 
 Total number of routes from all PE: 0
Table 2-592 Description of the display bgp vpnv6 routing-table different-origin-as command output
Item Description
Total number of routes from all PE

Total number of BGP routes received by the device from its peer PEs.

display bgp vpnv6 routing-table peer

Function

The display bgp vpnv6 routing-table peer command displays BGP VPNv6 routes of a specified peer.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv4Addr received-routes ipv6-address [ masklen ]

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr { accepted-routes | not-accepted-routes }

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv4Addr advertised-routes ipv6-address [ masklen [ longer-prefixes ] ]

For S6730-H-V2, S5732-H-V2:

display bgp [ instance bgpName ] vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr advertised-routes ipv6-address [ masklen [ longer-prefixes ] ]

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 vpn-instance vpn-instance-name routing-table peer remoteIpv6Addr advertised-routes ipv6-address [ masklen [ longer-prefixes ] ]

Parameters

Parameter Description Value
remoteIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

accepted-routes

Displays the routes that match a routing policy.

-

not-accepted-routes

Displays the routes that do not match a routing policy.

-

remoteIpv6Addr

Specifies an IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

received-routes

Displays routes received from the remote peer.

-

vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

ipv6-address

Specifies an ipv6 network address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

masklen

Specifies an IPv6 address prefix length.

It is an integer ranging from 0 to 128.

advertised-routes

Indicates the routes advertised to the peer.

-

longer-prefixes

Allows match against longer masks.

-

instance bgpName

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without any spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv6 routing-table peer command displays BGP VPNv6 routes of a specified peer.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display received BGP VPNv6 routes.
<HUAWEI> display bgp vpnv6 all routing-table peer 10.1.1.2 accepted-routes
BGP Local router ID is 172.16.1.1
Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
 h - history, i - internal, s - suppressed, S - Stale
 Origin : i - IGP, e - EGP, ? - incomplete
RPKI validation codes: V - valid, I - invalid, N - not-found

Total Number of Routes: 3
Route Distinguisher: 100:1

*>i Network : 2001:DB8:11::11 PrefixLen : 128 
 NextHop : ::FFFF:192.168.1.1 LocPrf : 
 MED : PrefVal : 0
 Label : 32860/32868
 Path/Ogn : 100?
*>i Network : 2001:DB8:2000::1 PrefixLen : 128 
 NextHop : ::FFFF:192.168.1.1 LocPrf : 
 MED : PrefVal : 0
 Label : 32860/32867
 Path/Ogn : 100?
 
Route Distinguisher: 100:3

*> Network : 2001:DB8:3::3 PrefixLen : 128
 NextHop : ::FFFF:192.168.1.1 LocPrf :
 MED : 0 PrefVal : 0
 Label : NULL/32860
 Path/Ogn : 100?
Table 2-593 Description of the display bgp vpnv6 routing-table peer command output
Item Description
BGP Local router ID

ID of the local BGP device, in the same format as an IPv4 address.

Total Number of Routes

Total number of BGP VPNv6 routes.

Route Distinguisher

Route distinguisher (RD) of a route.

Network

Indicates the destination network or host address of the route.

PrefixLen

Mask length of the destination network address or host address of the route.

NextHop

IPv6 address of the next hop.

LocPrf

Local_Pref of a BGP route. The default value is 100.

MED

Indicates the MED of the route. The default value is 0.

PrefVal

PrefVal.

Label

Indicates the label carried by the data packet destined for the destination network or host address of the route.

Path/Ogn

AS_Path and Origin attributes of a route.

display bgp vpnv6 routing-table statistics(Attribute Filter)

Function

The display bgp vpnv6 routing-table statistics command displays statistics about BGP VPNv6 routes and BGP4+ VPN routes based on specified multiple attribute filters.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics community-filter { { community-filter-num | community-filter-numEx | community-filter-name } | { community-filter-num | community-filter-name } whole-match }

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics extcommunity-filter { basic-extcomm-flt-num | adv-extcomm-flt-num | extcommunity-filter-name }

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics large-community-filter largeComFilName [ whole-match ]

For S6730-H-V2, S5732-H-V2:

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics community-filter { { community-filter-num | community-filter-numEx | community-filter-name } | { community-filter-num | community-filter-name } whole-match }

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics extcommunity-filter { basic-extcomm-flt-num | adv-extcomm-flt-num | extcommunity-filter-name }

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics large-community-filter largeComFilName [ whole-match ]

Parameters

Parameter Description Value
all

Displays BGP VPNv6 routes and BGP4+ routes of VPN instances.

-

vpn-instance vpn-instance-name

Displays the BGP routing information of the specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

as-path-filter as-path-filter-num

Specifies the number of an AS_Path filter.

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

as-path-filter as-path-filter-name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

community-filter community-filter-name

Specifies the name of a community filter.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

community-filter community-filter-num

Specifies the number of a basic community filter.

The value is an integer ranging from 1 to 99.

community-filter community-filter-numEx

Specifies the number of an advanced community filter.

The value is an integer that ranges from 100 to 199.

whole-match

Matches the specified community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

extcommunity-filter basic-extcomm-flt-num

Specifies the number of the basic extended community filter.

The value is an integer ranging from 1 to 199.

extcommunity-filter adv-extcomm-flt-num

Specifies the number of the advanced extended community filter.

The value is an integer ranging from 200 to 399.

extcommunity-filter extcommunity-filter-name

Specifies the name of an extcommunity filter.

The value is a string of 1 to 51 characters.

large-community-filter largeComFilName

Specifies the name of a Large-Community filter.

The value is a string of 1 to 51 case-sensitive characters. It cannot contain spaces.

instance bgpName

Displays BGP routes of a specified BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without any spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query statistics about BGP VPNv6 routes and BGP4+ VPN routes based on specified multiple attribute filters, run this command. Multiple attribute filters can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about BGP VPNv6 routes that match community filter 10.
<HUAWEI> display bgp vpnv6 all routing-table statistics community-filter 10
 
 Total number of routes from all PE: 2

 VPN-Instance vrf, Router ID 10.1.123.1:
 Total Number of Routes: 2
# Display statistics about BGP4+ private routes that match large community filter aaa.
<HUAWEI> display bgp vpnv6 vpn-instance vrf routing-table statistics large-community-filter aaa
 Total Number of Routes: 1
# Display statistics about BGP4+ private routes that match AS path filter pas.
<HUAWEI> display bgp vpnv6 vpn-instance vrf routing-table statistics as-path-filter pas
 Total Number of Routes: 3
Table 2-594 Description of the display bgp vpnv6 routing-table statistics(Attribute Filter) command output
Item Description
Total number of routes from all PE

Number of VPNv6 routes.

Total Number of Routes

Total number of routes.

VPN-Instance

Specifies the name of a VPN instance.

Router ID

Router ID of the VPN instance.

display bgp vpnv6 routing-table statistics(Attribute)

Function

The display bgp vpnv6 routing-table statistics command displays statistics about BGP VPNv6 routes and BGP4+ VPN routes based on specified multiple attribute values.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics regular-expression strRegular

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> [ whole-match ]

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics extcommunity [ { rt | soo } strExtCommunity ] &<1-33> [ match-any ]

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics large-community [ largeCommuStr ] &<1-33> [ whole-match ]

For S6730-H-V2, S5732-H-V2:

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics regular-expression strRegular

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> [ whole-match ]

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics extcommunity [ { rt | soo } strExtCommunity ] &<1-33> [ match-any ]

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table statistics large-community [ largeCommuStr ] &<1-33> [ whole-match ]

Parameters

Parameter Description Value
all

Displays BGP VPNv6 routes and BGP4+ routes of VPN instances.

-

vpn-instance vpn-instance-name

Displays about the BGP routes of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

statistics

Displays BGP route statistics.

-

community communityNum

Specifies a community number.

The value is an integer ranging from 0 to 4294967295.

community strCommunityNum

Specifies a community number.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

internet

Displays the BGP public network routes carrying the internet community attribute.

-

no-advertise

Displays the BGP routes carrying the No-Advertise community attribute.

-

no-export

Displays the BGP routes carrying the No-Export community attribute.

-

no-export-subconfed

Displays the BGP routes carrying the No-Export-Subconfed community attribute.

-

g-shut

Display routes with the Grateful-Shutdown community attribute.

-

whole-match

Matches the specified community attribute or the specified Large-Community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

extcommunity

Displays information about BGP routes with a specified extended community attribute.

-

rt

Displays information about BGP routes with the route target (RT) extended community attribute.

-

soo

Displays information about BGP routes with the source of origin (SoO) extended community attribute.

-

strExtCommunity

Specifies the excommunity value. IP<X.X.X.X>:NN<0-65535> or AS<0-65535>:NN<0-4294967295> or AS<65536-4294967295>:NN<0-65535> or AS<0-65535>.<0-65535>:NN<0-65535>.

The attribute value can be expressed in one of the following formats:

  • 2-byte AS number:4-byte user-defined number, for example, 1:3. The AS number is an integer ranging from 0 to 65535, and the user-defined number is an integer ranging from 0 to 4294967295. The AS number and user-defined number cannot both be set to 0. That is, the SoO must not be 0:0.
  • IPv4 address:2-byte user-defined number, for example, 192.168.122.15:1. The IP address ranges from 0.0.0.0 to 255.255.255.255, and the user-defined number is an integer ranging from 0 to 65535.
  • 4-byte AS number in integer format:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295, and a user-defined number ranges from 0 to 65535.
  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535. A user-defined number also ranges from 0 to 65535. The AS number and user-defined number must not be both 0s. That is, the SoO must not be 0.0:0.
match-any

Displays information about BGP routes with any of the specified extended community attributes.

-

large-community largeCommuStr

Specifies a value of the Large-Community attribute.

The value is a string of 5 to 32 case-sensitive characters, spaces not supported.

regular-expression strRegular

Specifies the regular expression that matches AS_Path.

The value is a string of 1 to 80 characters.

instance bgpName

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 80 characters.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query statistics about BGP VPNv6 routes and BGP4+ VPN routes based on specified multiple attribute values, run this command. Multiple attribute values can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about BGP VPNv6 routes.
<HUAWEI> display bgp vpnv6 all routing-table statistics
 
 Total number of routes from all PE: 2

 VPN-Instance vrf, Router ID 10.1.123.1:
 Total Number of Routes: 2
# Display statistics about BGP4+ private network routes with community attribute.
<HUAWEI> display bgp vpnv6 vpn-instance vrf routing-table statistics community
 Total Number of Routes: 2
# Display statistics about BGP4+ private network routes with large community attribute.
<HUAWEI> display bgp vpnv6 vpn-instance vrf routing-table statistics large-community
 Total Number of Routes: 3
Table 2-595 Description of the display bgp vpnv6 routing-table statistics(Attribute) command output
Item Description
Total number of routes from all PE

Number of VPNv6 routes.

Total Number of Routes

Total number of routes.

VPN-Instance

Specifies the name of a VPN instance.

Router ID

Router ID of the VPN instance.

display bgp vpnv6 routing-table(Attribute Filter)

Function

The display bgp vpnv6 routing-table command displays information about BGP VPNv6 routes and BGP4+ VPN routes based on specified multiple attribute filters.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table community-filter { { community-filter-num | community-filter-numEx | community-filter-name } | { community-filter-num | community-filter-name } whole-match }

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table extcommunity-filter { basic-extcomm-flt-num | adv-extcomm-flt-num | extcommunity-filter-name }

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table large-community-filter largeComFilName [ whole-match ]

For S6730-H-V2, S5732-H-V2:

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table as-path-filter { as-path-filter-num | as-path-filter-name }

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table community-filter { { community-filter-num | community-filter-numEx | community-filter-name } | { community-filter-num | community-filter-name } whole-match }

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table extcommunity-filter { basic-extcomm-flt-num | adv-extcomm-flt-num | extcommunity-filter-name }

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table large-community-filter largeComFilName [ whole-match ]

Parameters

Parameter Description Value
all

Displays BGP VPNv6 routes and BGP4+ routes of VPN instances.

-

vpn-instance vpn-instance-name

Displays about the BGP routes of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

as-path-filter community-filter-name

Specifies the name of a community filter.

The value is a string of 1 to 51 case-sensitive characters. The string cannot be all digits.

as-path-filter as-path-filter-num

Specifies the number of an AS_Path filter.

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

as-path-filter as-path-filter-name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

community-filter community-filter-num

Specifies the number of a basic community filter.

The value is an integer ranging from 1 to 99.

community-filter community-filter-numEx

Specifies the number of an advanced community filter.

The value is an integer that ranges from 100 to 199.

whole-match

Matches the specified community attribute or the specified Large-Community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

extcommunity-filter basic-extcomm-flt-num

Specifies the number of a basic extcommunity filter.

The value is an integer ranging from 1 to 199.

extcommunity-filter adv-extcomm-flt-num

Specifies the number of an advanced extcommunity filter.

The value is an integer that ranges from 200 to 399.

extcommunity-filter extcommunity-filter-name

Specifies the name of an extended community filter.

The value is a string of 1 to 51 characters.

large-community-filter largeComFilName

Specifies the name of a Large-Community filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

instance bgpName

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query information about BGP VPNv6 routes and BGP4+ VPN routes based on specified multiple attribute filters, run this command. Multiple attribute filters can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP4+ private routes that match large community filter aaa.
<HUAWEI> display bgp vpnv6 vpn-instance vrf routing-table large-community-filter aaa
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 1
 *>     Network  : 2001:DB8:1::                             PrefixLen : 64  
        Nexthop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Large-Community : <1:1:1>, <2:2:2>
# Display BGP multi-instance VPNv6 routes that match AS path filter pas.
<HUAWEI> display bgp instance a vpnv6 all routing-table as-path-filter pas
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found

 
 Total number of routes from all PE: 1

 Route Distinguisher: 11:11


 *>     Network  : 2001:DB8:1::                             PrefixLen : 128 
        NextHop  : ::                                       LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Path/Ogn : 100 999i
    
 VPN-Instance vpna, Router ID 10.1.123.1:

 Total Number of Routes: 1
 *>     Network  : 2001:DB8:1::                             PrefixLen : 128 
        NextHop  : ::                                       LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Path/Ogn : 100 999i
Table 2-596 Description of the display bgp vpnv6 routing-table(Attribute Filter) command output
Item Description
BGP Local router ID is

Router ID of the local BGP device.

Total number of routes from all PE

Number of VPNv6 routes.

Route Distinguisher

Route distinguisher (RD) of a route.

Network

Network address in the BGP public network routing table.

PrefixLen

Prefix length.

Nexthop

Next hop address of the packet.

LocPrf

Local_Pref.

MED

MED of a route.

PrefVal

PrefVal of a BGP route.

Label

Label value.

Path/Ogn

AS_Path number and the origin attribute.

display bgp vpnv6 routing-table(Attribute)

Function

The display bgp vpnv6 routing-table command displays information about BGP VPNv6 routes and BGP4+ VPN routes based on specified multiple attribute values.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table regular-expression strRegular

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> [ whole-match ]

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table extcommunity [ { rt | soo } strExtCommunity ] &<1-33> [ match-any ]

display bgp vpnv6 { all | vpn-instance vpn-instance-name } routing-table large-community [ largeCommuStr ] &<1-33> [ whole-match ]

For S6730-H-V2, S5732-H-V2:

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table regular-expression strRegular

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table community [ communityNum | strCommunityNum | internet | no-advertise | no-export | no-export-subconfed | g-shut ] &<1-33> [ whole-match ]

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table extcommunity [ { rt | soo } strExtCommunity ] &<1-33> [ match-any ]

display bgp instance bgpName vpnv6 { all | vpn-instance vpn-instance-name } routing-table large-community [ largeCommuStr ] &<1-33> [ whole-match ]

Parameters

Parameter Description Value
all

Displays BGP VPNv6 routes and BGP4+ routes of VPN instances.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

vpn-instance vpn-instance-name

Displays about the BGP routes of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

community communityNum

Specify community number.

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

community strCommunityNum

Specify community number.

The value is a string of 1 to 11 case-sensitive characters, spaces not supported.

internet

Displays the BGP routes carrying the internet community attribute.

-

no-advertise

Displays the BGP routes carrying the No-Advertise community attribute.

-

no-export

Displays the BGP routes carrying the No-Export community attribute.

-

no-export-subconfed

Displays the BGP routes carrying the No-Export-Subconfed community attribute.

-

g-shut

Display routes with the Grateful-Shutdown community attribute.

-

whole-match

Matches the specified community attribute.

-

whole-match

Indicates that the Large-Community attribute is fully matched.

-

extcommunity

Displays information about BGP routes with a specified extended community attribute.

-

rt

Displays information about BGP routes with the route target (RT) extended community attribute.

-

soo

Displays information about BGP routes with the source of origin (SoO) extended community attribute.

-

strExtCommunity

Specifies the excommunity value. IP<X.X.X.X>:NN<0-65535> or AS<0-65535>:NN<0-4294967295> or AS<65536-4294967295>:NN<0-65535> or AS<0-65535>.<0-65535>:NN<0-65535>.

The attribute value can be expressed in one of the following formats:

  • 2-byte AS number:4-byte user-defined number, for example, 1:3. The AS number is an integer ranging from 0 to 65535, and the user-defined number is an integer ranging from 0 to 4294967295. The AS number and user-defined number cannot both be set to 0. That is, the SoO must not be 0:0.
  • IPv4 address:2-byte user-defined number, for example, 192.168.122.15:1. The IP address ranges from 0.0.0.0 to 255.255.255.255, and the user-defined number is an integer ranging from 0 to 65535.
  • 4-byte AS number in integer format:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295, and a user-defined number ranges from 0 to 65535.
  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535. A user-defined number also ranges from 0 to 65535. The AS number and user-defined number must not be both 0s. That is, the SoO must not be 0.0:0.
match-any

Displays information about BGP routes with any of the specified extended community attributes.

-

large-community largeCommuStr

Specifies a value of the Large-Community attribute.

The value is a string of 5 to 32 case-sensitive characters, spaces not supported.

regular-expression strRegular

Specifies the regular expression that matches AS_Path.

The value is a string of 1 to 80 characters.

instance bgpName

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 80 characters.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To query information about BGP VPNv6 routes and BGP4+ VPN routes based on specified multiple attribute values, run this command. Multiple attribute values can be specified in this command for query.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display BGP4+ private network routes with large community attribute.
<HUAWEI> display bgp vpnv6 vpn-instance vrf routing-table large-community
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found


 Total Number of Routes: 2
 *>     Network  : 2001:DB8:1::                             PrefixLen : 64  
        Nexthop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Large-Community : <1:1:1>, <2:2:2>
 *>     Network  : 2001:DB8:2::                             PrefixLen : 64  
        Nexthop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Large-Community : <1:1:1>, <2:2:2>
# Display BGP multi-instance VPNv6 routes that match the AS_Path regular expression ^20.
<HUAWEI> display bgp instance a vpnv6 all routing-table regular-expression ^20
 
 BGP Local router ID is 10.1.123.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found

 
 Total number of routes from all PE: 1

 Route Distinguisher: 11:11


 *>     Network  : 2001:DB8:1::                             PrefixLen : 128 
        NextHop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Path/Ogn : 200 999i
    
 VPN-Instance vpna, Router ID 10.1.123.1:

 Total Number of Routes: 1
 *>     Network  : 2001:DB8:1::                             PrefixLen : 128 
        NextHop  : 2001:DB8:8::8                            LocPrf    :   
        MED      : 0                                        PrefVal   : 0
        Label    : 
        Path/Ogn : 200 999i
Table 2-597 Description of the display bgp vpnv6 routing-table(Attribute) command output
Item Description
BGP Local router ID is

Router ID of the local BGP device.

Total number of routes from all PE

Number of VPNv6 routes.

Route Distinguisher

Route distinguisher (RD) of a route.

Network

Network address in the BGP public network routing table.

PrefixLen

Prefix length.

LocPrf

Local_Pref.

MED

MED of a route.

PrefVal

PrefVal of a BGP route.

Label

Label value.

Path/Ogn

AS_Path number and the origin attribute.

Nexthop

Next hop address of the packet.

display bgp vpnv6 slow-peer

Function

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

Format

For S6730-H-V2, S5732-H-V2:

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

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

Parameters

Parameter Description Value
instance bgpName

Specifies the name of a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

vpn-instance vpn-instance-name

Specify a VPN-Instance (VRF) name.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about slow BGP VPNv6 peers.
<HUAWEI> display bgp vpnv6 vpn-instance vpn1 slow-peer
 Total number of peers : 2                 
 Switchback detection timer: Remaining 3581 Second(s)
  Peer            LastSlowEndTime              SlowStartTime                SlowCount
  2001:DB8:1::2   2019-09-15 20:41:33+00:00    2019-09-16 00:02:33+00:00            3
  2001:DB8:1::3   2019-09-15 23:02:40+00:00    2019-09-16 00:02:40+00:00            5
Table 2-598 Description of the display bgp vpnv6 slow-peer command output
Item Description
Total number of peers

Total number of BGP slow-peers.

Switchback detection timer

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

Peer

IP address of the BGP peer.

LastSlowEndTime

Time when a peer last exited from the slow peer state.

SlowStartTime

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

SlowCount

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

display bgp vpnv6 update-peer-group

Function

The display bgp vpnv6 update-peer-group command displays information about BGP VPNv6 update peer-groups.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

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

For S6730-H-V2, S5732-H-V2:

display bgp instance bgpName vpnv6 vpn-instance vpn-instance-name update-peer-group [ index update-group-index ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

all

Displays all information about VPNv6 and IPv6 VPN instances.

-

index update-group-index

Index of update peer group.

The value is an integer ranging from 0 to 65535.

instance bgpName

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv6 update-peer-group command displays information about BGP VPNv6 update peer-groups. Details about update peer-groups can be displayed based on the update peer-group index.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about BGP VPNv6 update peer-groups.
<HUAWEI> display bgp vpnv6 all update-peer-group index 0
 Group ID : 0
 BGP Version : 4
 Group Type : external
 Addr Family : VPNv6
 Total Peers : 1
 AdvMinTimeVal : 30
 Leader Peer : 192.168.1.2

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

 Peers List : 192.168.1.2
Table 2-599 Description of the display bgp vpnv6 update-peer-group command output
Item Description
Group ID

Update group ID of the BGP peer.

Group Type

Type of an update peer-group:

  • external: EBGP.
  • internal: IBGP.
  • unknown: unknown type.
BGP Version

BGP version.

Addr Family

Address family.

Total Peers

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

Total format packet number

Total format packet number.

Total send packet number

Total number of sent packets.

Total replicate packet number

Total number of sent packets - Total number of formatted packets.

Peers List

List of peers.

AdvMinTimeVal

Minimum route advertisement interval:

30 seconds for EBGP.

15 seconds for IBGP.

Leader Peer

IP addresses of peers in an update peer-group.

The replication percentages(%)

Replication percentage: (Total number of sent packets - Total number of formatted packets) x 100/Total number of formatted packets.

display bgp vpnv6 vpn-instance routing-table

Function

The display bgp vpnv6 vpn-instance routing-table command displays BGP VPNv6 routes.

Format

display bgp vpnv6 vpn-instance vpn-instance-name routing-table [ peer ipv6-address { received-routes | advertised-routes } ] time-range start-time end-time

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Specify a VPN-Instance (VRF) name.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

route-distinguisher route-distinguisher

X.X.X.X:number or number:number or number.number:number.

The value is a string of 3 to 21 case-sensitive characters, spaces not supported.

peer

Peer routers.

-

ipv6-address

Specify an IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

received-routes

Routes received from the remote peer.

-

advertised-routes

Routes advertised to the remote peer.

-

time-range start-time

Starting time.

The formats is xxdxxhxxmxxs.

  • The d indicates days. The value is an integer ranging from 0 to 10000.
  • The h indicates hours. The value is an integer ranging from 0 to 23.
  • The m indicates minutes. The value is an integer ranging from 0 to 59.
  • The s indicates seconds. The value is an integer ranging from 0 to 59.
time-range end-time

Ending time.

The formats is xxdxxhxxmxxs.

  • The d indicates days. The value is an integer ranging from 0 to 10000.
  • The h indicates hours. The value is an integer ranging from 0 to 23.
  • The m indicates minutes. The value is an integer ranging from 0 to 59.
  • The s indicates seconds. The value is an integer ranging from 0 to 59.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display bgp vpnv6 vpn-instance routing-table command displays BGP VPNv6 routes.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display all BGP VPNv6 routes.
<HUAWEI> display bgp vpnv6 all routing-table
BGP Local router ID is 192.168.7.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found

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


 *>  Network  : 2001:DB8:1::1                            PrefixLen : 128
     NextHop  : ::                                       LocPrf    :
     MED      : 0                                        PrefVal   : 0
     Label    : 
     Path/Ogn : ?

 Route Distinguisher: 200:1


 *>i Network  : 2001:DB8:1::1                            PrefixLen : 128
     NextHop  : ::FFFF:192.168.100.10                    LocPrf    : 100
     MED      : 0                                        PrefVal   : 0
     Label    : 15362
     Path/Ogn : 33 55 ?
 *>i Network  : 2001:DB8:2::2                            PrefixLen : 128
     NextHop  : ::FFFF:192.168.100.10                    LocPrf    : 100
     MED      : 0                                        PrefVal   : 0
     Label    : 15363
     Path/Ogn : 33 55 ?

 Total routes of vpn-instance vrf1: 3
 *>  Network  : 2001:DB8:1::1                            PrefixLen : 128
     NextHop  : ::                                       LocPrf    :
     MED      : 0                                        PrefVal   : 0
     Label    : 
     Path/Ogn : ?
 * i
     NextHop  : ::FFFF:192.168.100.10                    LocPrf    : 100
     MED      : 0                                        PrefVal   : 0
     Label    : 15362
     Path/Ogn : 33 55 ?
 *>i Network  : 2001:DB8:2::2                            PrefixLen : 128
     NextHop  : ::FFFF:192.168.100.10                    LocPrf    : 100
     MED      : 0                                        PrefVal   : 0
     Label    : 15363
     Path/Ogn : 33 55 ?
# Display the routes of an IPv6 address family-enabled VPN instance named vpn1 on the local device.
<HUAWEI> display bgp vpnv6 vpn-instance vpn1 routing-table
Total Number of Routes: 5

 BGP Local router ID is 10.1.1.1
 Status codes: * - valid, > - best, d - damped, x - best external, a - add path,
               h - history,  i - internal, s - suppressed, S - Stale
               Origin : i - IGP, e - EGP, ? - incomplete
 RPKI validation codes: V - valid, I - invalid, N - not-found

 *>  Network  : 2001:DB8:2000::                          PrefixLen : 64
     NextHop  : ::                                       LocPrf    :
     MED      : 0                                        PrefVal   : 0
     Label    : 15360/NULL
     Path/Ogn : ?

 *>  Network  : 2001:DB8:2000::1                         PrefixLen : 128
     NextHop  : ::                                       LocPrf    :
     MED      : 0                                        PrefVal   : 0
     Label    :
     Path/Ogn : ?

 *>i Network  : 2001:DB8:2001::                          PrefixLen : 64
     NextHop  : ::FFFF:10.2.2.2                          LocPrf    : 100
     MED      : 0                                        PrefVal   : 0
     Label    : NULL/15360
     Path/Ogn : ?

 *>i Network  : 2001:DB8:3000::1                         PrefixLen : 128
     NextHop  : ::FFFF:10.2.2.2                          LocPrf    : 100
     MED      : 0                                        PrefVal   : 0
     Label    : NULL/15361
     Path/Ogn : 65420 ?

 *>  Network  : FE80::                                   PrefixLen : 10
     NextHop  : ::                                       LocPrf    :
     MED      : 0                                        PrefVal   : 0
     Label    :
     Path/Ogn : ?
Table 2-600 Description of the display bgp vpnv6 vpn-instance routing-table command output
Item Description
BGP Local router ID is

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

Total Number of Routes

Total number of routes.

Total number of routes from all PE

Number of VPNv4 routes.

Route Distinguisher

Specified RD.

Network

Destination network or host address of the route.

PrefixLen

Prefix length of the destination network or host address of the route.

NextHop

IPv6 address of the next hop.

LocPrf

Local_Pref of a BGP route. The default value is 100.

MED

MED of a route. The default value is 0.

PrefVal

PrefVal of a route.

Label

Label carried by the data packet destined for the destination network or host address of the route.

Path/Ogn

AS_Path number and the Origin attribute of the route.

display bmp session

Function

The display bmp session command displays configurations about a BGP Monitoring Protocol (BMP) session.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

display bmp session [ vpn-instance vpn-instacne-name ]

display bmp session [ vpn-instance vpn-instacne-name ] { ipv4-address | ipv6-address } verbose

display bmp session [ vpn-instance vpn-instacne-name ] { ipv4-address | ipv6-address } alias alias-name verbose

Parameters

Parameter Description Value
vpn-instance vpn-instacne-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

ipv4-address

Specifies the IPv4 address used for the RPKI session.

The value is in dotted decimal notation.

ipv6-address

Specifies the IPv6 address of a BMP session.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

verbose

Displays detailed session information.

-

alias alias-name

Specifies a session alias. When the device needs to establish multiple TCP connections with the same monitoring server through different port numbers, specify session aliases for differentiation.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check configurations about a BMP session, run the display bmp session command. The command output helps you locate a fault (if any) and determine whether the BMP session is properly configured.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display configurations about the BMP session with 1.1.1.1 as the session address.
<HUAWEI> display bmp session 1.1.1.1 verbose
BMP session 10.10.10.10, port 0
    Current state: Down (Reason: Manual Stop), Age: 04h39m54s
    VPN-instance name: _public_
    Local address: 0.0.0.0, Local port: 0
    Statistics timeout: 3600(s)
    ConnectRetry Timer Remainder: 15(s)
    Statistics-report Timer Remainder: 2538(s)
    Send Route Monitoring messages: 9
    Send Statistics Report messages: 53
    Send Peer Down Notification messages: 3
    Send Peer Up Notification messages: 4
    Send Initiation messages: 1
    Send Termination messages: 0
    Send Trace Route messages: 121
  BGP ipv4-family unicast :
  0.0.0.0   (local-rib(all/path-marking))
  1.1.1.1 (in pre-policy)     
  2.2.2.2 (in pre-policy)
  BGP ipv4-family vpnv4 :
  2.2.2.2 (in pre-policy)
# Display configurations about the BMP session with 1.1.1.1 as the session address.
<HUAWEI> display bmp session
Total number of BMP session : 2
 Session in up state : 0
  Session          Alias      State      Age            VPN                                
  1.1.1.1                     Down       57s            _public_                           
  1.1.1.1          a          Down       44s            _public_
# Display detailed information about the BMP session with the session address of 3.3.3.3 and alias of aa.
<HUAWEI> display bmp session 3.3.3.3 alias aa verbose
BMP session 3.3.3.3, port 30000
    Current state: Up, Age: 12h18m32s
    VPN-instance name: _public_
    Local address: 10.98.178.12, Local port: 50423
    Statistics timeout: 3600(s)
    ConnectRetry Timer Remainder: 0(s)
    Statistics-report Timer Remainder: 2490(s)
    Send Route Monitoring messages: 9
    Send Statistics Report messages: 53
    Send Peer Down Notification messages: 3
    Send Peer Up Notification messages: 4
    Send Initiation messages: 1
    Send Termination messages: 0
    Send Trace Route messages: 121
  BGP ipv4-family unicast :
  0.0.0.0   (local-rib(all/path-marking))
  1.1.1.1 (in pre-policy)     
  2.2.2.2 (in pre-policy)
  BGP ipv4-family vpnv4 :
  2.2.2.2 (in pre-policy)
Table 2-601 Description of the display bmp session command output
Item Description
BMP session

IP address of the server with which a BMP session is established.

port

Server port number.

Current state

Status of the BMP session:

  • Down.
  • Up.
VPN-instance name

VPN instance to which the BMP session belongs.

Local address

Local IP address.

Local port

Local port number.

Statistics timeout

Interval at which the router sends BGP running statistics to the monitoring server.

ConnectRetry Timer Remainder

Period after which a connection is re-established.

Statistics-report Timer Remainder

Period after which the router sends BGP running statistics to a monitoring server.

Send Route Monitoring messages

Number of Route Monitoring messages sent by a BMP session.

Send Statistics Report messages

Number of statistics messages sent by a BMP session.

Send Peer Down Notification messages

Number of Peer Down messages sent by a BMP session.

Send Peer Up Notification messages

Number of Peer Up messages sent over a BMP session.

Send Initiation messages

Number of Initiation messages sent over a BMP session.

Send Termination messages

Number of Termination messages sent by a BMP session.

Send Trace Route messages

Number of Trace Route messages sent by a BMP session.

BGP ipv4-family unicast

Type of route whose statistics are sent by the device to the monitoring server in the IPv4 unicast address family.

  • in pre-policy: all received RIB-in routes.
  • in post-policy: RIB-in routes accepted by an import policy.
  • out pre-policy: all RIB-out routes, regardless of whether they match an export policy.
  • out post-policy: RIB-out routes that match an export policy.
  • local-rib: Local-RIB routes.
  • local-rib(a): Local-RIB Add-Path routes.
BGP ipv4-family vpnv4

Type of route whose statistics are sent by the device to the monitoring server in the BGP-VPNv4 address family.

  • in pre-policy: all received RIB-in routes.
  • in post-policy: RIB-in routes accepted by an import policy.
  • out pre-policy: all RIB-out routes, regardless of whether they match an export policy.
  • out post-policy: RIB-out routes that match an export policy.
  • local-rib: Local-RIB routes.
  • local-rib(a): Local-RIB Add-Path routes.
Total number of BMP session

Total number of BMP session.

Session in up state

Number of BMP sessions that are Up.

Session

IP address of the server with which a BMP session is established.

Alias

Alias of a BMP session. If no alias is specified, the field is empty.

State

Status of the BMP session:

  • Down.
  • Up.
Age

Duration of the BGP session in the Up or Down state.

VPN

VPN instance to which the BMP session belongs.

display debugging bgp

Function

The display debugging bgp command displays information about enabled BGP debugging functions.

Format

display debugging bgp

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

When a large amount of information is output, you can run the display debugging bgp command to view information about enabled BGP debugging functions and disable some unnecessary debugging functions to minimize the debugging information output.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about enabled debugging functions.
<HUAWEI> terminal debugging
<HUAWEI> debugging bgp packet all
<HUAWEI> display debugging bgp
[BGP] : Packet update send debugging switch is on
[BGP] : Packet update receive debugging switch is on
[BGP] : Packet keepalive send debugging switch is on
[BGP] : Packet keepalive receive debugging switch is on
[BGP] : Packet open send debugging switch is on
[BGP] : Packet open receive debugging switch is on
[BGP] : Packet route-refresh send debugging switch is on
[BGP] : Packet route-refresh receive debugging switch is on
<HUAWEI> debugging bgp packet open vpn-instance vrf1
<HUAWEI> display debugging bgp
[BGP] : Packet open send (VPN)vrf1 debugging switch is on
[BGP] : Packet open receive (VPN)vrf1 debugging switch is on
<HUAWEI> debugging bgp event peer 1.1.1.1
<HUAWEI> display debugging bgp
[BGP] : EVENT (VPN)_public_ (Peer) 1.1.1.1 debugging switch is on
<HUAWEI> debugging bgp packet update ipv4 unicast
<HUAWEI> display debugging bgp
[BGP] : Packet update send (VPN)_public_ IPv4-unicast debugging switch is on
[BGP] : Packet update receive (VPN)_public_ IPv4-unicast debugging switch is on
Table 2-602 Description of the display debugging bgp command output
Item Description
Packet keepalive send debugging switch is on

BGP keepalive send debugging is enabled.

Packet keepalive receive debugging switch is on

BGP keepalive receive debugging is enabled.

Packet open send debugging switch is on

BGP open send debugging is enabled.

Packet open receive debugging switch is on

BGP open receive debugging is enabled.

Packet route-refresh send debugging switch is on

BGP route-refresh send debugging is enabled.

Packet route-refresh receive debugging switch is on

BGP route-refresh receive debugging is enabled.

Packet update send debugging switch is on

BGP update send debugging is enabled.

Packet update receive debugging switch is on

BGP update receive debugging is enabled.

Packet open send (VPN)vrf1 debugging switch is on

(VPN)vrf: Debugging is enabled for packets in a specified VPN instance.

EVENT (VPN)_public_ (Peer) 1.1.1.1 debugging switch is on

(VPN)_public_: Debugging is enabled for packets on the public network.

peer 1.1.1.1: Debugging is enabled for packets of the peer 1.1.1.1.

This field can also be as follows:

  • ipv4 unicast: Debugging is enabled for packets in the BGP-IPv4 unicast address family.
  • ipv6 unicast: Debugging is enabled for packets in the BGP-IPv6 unicast address family.
  • vpnv4: Debugging is enabled for packets in the BGP-VPNv4 address family.
  • vpnv6: Debugging is enabled for packets in the BGP-VPNv6 address family.
[BGP]

BGP debugging is enabled.

display debugging bmp

Function

The display debugging bmp command displays information about enabled BGP Monitoring Protocol (BMP) debugging functions.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

display debugging bmp

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

When a large amount of information is output, you can run the display debugging bmp command to view information about enabled BMP debugging functions and disable some unnecessary debugging functions to minimize the debugging information output.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about enabled BMP debugging functions.
<HUAWEI> display debugging bmp
[BMP] :session-msg(NULL) debugging switch is on
[BMP] :peer-notification(NULL) debugging switch is on
[BMP] :state-report(NULL) debugging switch is on
[BMP] :route-monitor(NULL) debugging switch is on
Table 2-603 Description of the display debugging bmp command output
Item Description
session-msg(NULL) debugging switch is on

BMP session message debugging.

peer-notification(NULL) debugging switch is on

BMP Peer-Notification message debugging.

state-report(NULL) debugging switch is on

BMP Status-Report message debugging.

route-monitor(NULL) debugging switch is on

BMP Route-Monitor message debugging.

display default-parameter bgp

Function

The display default-parameter bgp command displays the default configurations in BGP initialization.

Format

display default-parameter bgp

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To view the default configurations in BGP initialization, run the display default-parameter bgp command. The command output remains unchanged even when the BGP configurations are modified. Before you run this command, BGP must have been enabled.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the default configurations in BGP initialization.
<HUAWEI> display default-parameter bgp
 BGP version               : 4
 EBGP preference           : 255
 IBGP preference           : 255
 Local preference          : 255
 BGP connect-retry         : 32s
 BGP holdtime              : 180s
 BGP keepAlive             : 60s
 EBGP route-update-interval: 30s
 IBGP route-update-interval: 15s
 Default local-preference  : 100
 Default MED               : 0
 IPv4-family unicast       : enable
 EBGP-interface-sensitive  : enable
 IBGP-interface-sensitive  : disable
 Reflect between-clients   : enable
 Check-first-as            : enable
 Synchronization           : disable
 Private-4-byte-as         : enable
 Nexthop-resolved rules    :
     IPv4-family           : unicast(ip)
                             vpn-instance(tunnel)
     IPv6-family           : unicast(ip)
                             vpn-instance(tunnel)
Table 2-604 Description of the display default-parameter bgp command output
Item Description
BGP version

BGP version.

BGP connect-retry

ConnectRetry interval.

BGP holdtime

Hold time.

BGP keepAlive

Keepalive interval.

EBGP preference

Protocol preference of an EBGP route.

EBGP route-update-interval

Minimum interval for sending EBGP Update messages.

IBGP preference

Protocol preference of an IBGP route.

IBGP route-update-interval

Minimum interval for sending IBGP Update messages.

Local preference

Protocol preference of the local route.

Default local-preference

Local preference of a BGP route.

Default MED

MED value of a BGP route.

IPv4-family unicast

BGP IPv4 unicast address family view:

  • enable.
  • disable.
EBGP-interface-sensitive

When an interface goes Down, the BGP session between the interface and its directly connected external peer is immediately cleared.

  • enable.
  • disable.
Reflect between-clients

Route reflection between clients through the RR:

  • enable.
  • disable.
Check-first-as

When the check on the first AS number in the AS_Path attribute carried in the Update message sent by the EBGP peer is enabled:

  • enable.
  • disable.
Synchronization

Synchronization between IBGP and IGP:

  • enable.
  • disable.
Private-4-byte-as

Whether the 4-byte private AS number function is enabled.

  • enable.
  • disable.
Nexthop-resolved rules

Next hop recursion rule.

IBGP-interface-sensitive

Enables a device to immediately delete the directly connected IBGP peer relationship established on an interface if the local interface that directly connects the IBGP peer relationship fails.

display default-parameter bmp

Function

The display default-parameter bmp command displays default BGP Monitoring Protocol (BMP) configurations.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

display default-parameter bmp

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check the default interval at which a router sends BGP running statistics to a monitoring server and whether statistics about all received routes or only accepted routes are sent to the monitoring server, run the display default-parameter bmp command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display default BMP configurations.
<HUAWEI> display default-parameter bmp
statistics-timer : 3600
route-mode : post-policy
Table 2-605 Description of the display default-parameter bmp command output
Item Description
statistics-timer

Interval at which the router sends BGP running statistics to the monitoring server, in seconds.

route-mode

Whether statistics about all received routes or only accepted routes are sent to the monitoring server.

ebgp-interface-sensitive (BGP multi-instance VPN instance IPv4 address family view)

Function

The ebgp-interface-sensitive command immediately resets BGP sessions between the local interface and directly connected EBGP peers if the local interface goes Down.

The undo ebgp-interface-sensitive command disables the function.

By default, this function is enabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

ebgp-interface-sensitive

undo ebgp-interface-sensitive

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the ebgp-interface-sensitive command is not configured, the system does not immediately select a sub-optimal route for packet transmission if the local interface goes Down. Instead, the system waits for a period (180s by default) before checking whether another interface can be used to send packets to the same destination address. This will interrupt services for a period of time. If the ebgp-interface-sensitive command is run, BGP can fast detect an EBGP link failure and use another interface to establish a BGP peer relationship with the remote peer.

If the interface used for a BGP connection alternates between Up and Down, run the undo ebgp-interface-sensitive command to prevent repeated BGP session deletion and reestablishment caused by route flapping, which reduces network bandwidth consumption.

Precautions

If the interface used for a BGP connection alternates between Up and Down, do not run the ebgp-interface-sensitive command.

Example

# Enable the system to automatically reset BGP sessions between the local interface and directly connected EBGP peers if the local interface goes Down.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] ebgp-interface-sensitive

ebgp-interface-sensitive (BGP view)

Function

The ebgp-interface-sensitive command immediately resets BGP sessions between the local interface and directly connected EBGP peers if the local interface goes Down.

The undo ebgp-interface-sensitive command disables the function.

By default, this function is enabled.

Format

ebgp-interface-sensitive

undo ebgp-interface-sensitive

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the ebgp-interface-sensitive command is not configured, the system does not immediately select a sub-optimal route for packet transmission if the local interface goes Down. Instead, the system waits for a period (180s by default) before checking whether another interface can be used to send packets to the same destination address. This will interrupt services for a period of time. If the ebgp-interface-sensitive command is run, BGP can fast detect an EBGP link failure and use another interface to establish a BGP peer relationship with the remote peer.

If the interface used for a BGP connection alternates between Up and Down, run the undo ebgp-interface-sensitive command to prevent repeated BGP session deletion and reestablishment caused by route flapping, which reduces network bandwidth consumption.

Precautions

If the interface used for a BGP connection alternates between Up and Down, do not run the ebgp-interface-sensitive command.

Example

# Enable the system to automatically reset BGP sessions between the local interface and directly connected EBGP peers if the local interface goes Down.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ebgp-interface-sensitive

ebgp-interface-sensitive (BGP-IPv4 unicast address family view)

Function

The ebgp-interface-sensitive command immediately resets BGP sessions between the local interface and directly connected EBGP peers if the local interface goes Down.

The undo ebgp-interface-sensitive command disables the function.

By default, this function is enabled.

Format

ebgp-interface-sensitive

undo ebgp-interface-sensitive

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the ebgp-interface-sensitive command is not configured, the system does not immediately select a sub-optimal route for packet transmission if the local interface goes Down. Instead, the system waits for a period (180s by default) before checking whether another interface can be used to send packets to the same destination address. This will interrupt services for a period of time. If the ebgp-interface-sensitive command is run, BGP can fast detect an EBGP link failure and use another interface to establish a BGP peer relationship with the remote peer.

If the interface used for a BGP connection alternates between Up and Down, run the undo ebgp-interface-sensitive command to prevent repeated BGP session deletion and reestablishment caused by route flapping, which reduces network bandwidth consumption.

Precautions

If the interface used for a BGP connection alternates between Up and Down, do not run the ebgp-interface-sensitive command.

Example

# Enable the system to automatically reset BGP sessions between the local interface and directly connected EBGP peers if the local interface goes Down.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] ebgp-interface-sensitive

ebgp-interface-sensitive (BGP-IPv6 unicast address family view)

Function

The ebgp-interface-sensitive command immediately resets BGP sessions between the local interface and directly connected EBGP peers if the local interface goes Down.

The undo ebgp-interface-sensitive command disables the function.

By default, this function is enabled.

Format

ebgp-interface-sensitive

undo ebgp-interface-sensitive

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the ebgp-interface-sensitive command is not configured, the system does not immediately select a sub-optimal route for packet transmission if the local interface goes Down. Instead, the system waits for a period (180s by default) before checking whether another interface can be used to send packets to the same destination address. This will interrupt services for a period of time. If the ebgp-interface-sensitive command is run, BGP can fast detect an EBGP link failure and use another interface to establish a BGP peer relationship with the remote peer.

If the interface used for a BGP connection alternates between Up and Down, run the undo ebgp-interface-sensitive command to prevent repeated BGP session deletion and reestablishment caused by route flapping, which reduces network bandwidth consumption.

Precautions

If the interface used for a BGP connection alternates between Up and Down, do not run the ebgp-interface-sensitive command.

Example

# Enable the system to automatically reset BGP sessions between the local interface and directly connected EBGP peers if the local interface goes Down.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] ebgp-interface-sensitive

ebgp-interface-sensitive (BGP-VPN instance IPv4 address family view)

Function

The ebgp-interface-sensitive command immediately resets BGP sessions between the local interface and directly connected EBGP peers if the local interface goes Down.

The undo ebgp-interface-sensitive command disables the function.

By default, this function is enabled.

Format

ebgp-interface-sensitive

undo ebgp-interface-sensitive

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the ebgp-interface-sensitive command is not configured, the system does not immediately select a sub-optimal route for packet transmission if the local interface goes Down. Instead, the system waits for a period (180s by default) before checking whether another interface can be used to send packets to the same destination address. This will interrupt services for a period of time. If the ebgp-interface-sensitive command is run, BGP can fast detect an EBGP link failure and use another interface to establish a BGP peer relationship with the remote peer.

If the interface used for a BGP connection alternates between Up and Down, run the undo ebgp-interface-sensitive command to prevent repeated BGP session deletion and reestablishment caused by route flapping, which reduces network bandwidth consumption.

Precautions

If the interface used for a BGP connection alternates between Up and Down, do not run the ebgp-interface-sensitive command.

Example

# Enable the system to automatically reset BGP sessions between the local interface and directly connected EBGP peers if the local interface goes Down.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] ebgp-interface-sensitive

ebgp-interface-sensitive (BGP-VPN instance IPv6 address family view)

Function

The ebgp-interface-sensitive command immediately resets BGP sessions between the local interface and directly connected EBGP peers if the local interface goes Down.

The undo ebgp-interface-sensitive command disables the function.

By default, this function is enabled.

Format

ebgp-interface-sensitive

undo ebgp-interface-sensitive

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the ebgp-interface-sensitive command is not configured, the system does not immediately select a sub-optimal route for packet transmission if the local interface goes Down. Instead, the system waits for a period (180s by default) before checking whether another interface can be used to send packets to the same destination address. This will interrupt services for a period of time. If the ebgp-interface-sensitive command is run, BGP can fast detect an EBGP link failure and use another interface to establish a BGP peer relationship with the remote peer.

If the interface used for a BGP connection alternates between Up and Down, run the undo ebgp-interface-sensitive command to prevent repeated BGP session deletion and reestablishment caused by route flapping, which reduces network bandwidth consumption.

Precautions

If the interface used for a BGP connection alternates between Up and Down, do not run the ebgp-interface-sensitive command.

Example

# Enable the system to automatically reset BGP sessions between the local interface and directly connected EBGP peers if the local interface goes Down.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] ebgp-interface-sensitive

ext-community-change enable (BGP multi-instance VPN instance IPv4 address family view)

Function

The ext-community-change enable command allows a routing policy to modify the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute.

The undo ext-community-change enable command disables the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute from being modified using a routing policy.

By default, a BGP device cannot use route-policies to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwidth attribute in matched BGP routes.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

ext-community-change enable

undo ext-community-change enable

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP prevents a device from using a route-policy to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes either learned from or to be advertised to a peer or peer group. To enable a device to use route-policies to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in matched routes, run the ext-community-change enable command. After running this command, you can configure an import route-policy to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes received from a peer or peer group. You can also configure an export route-policy to filter the optimal routes selected by BGP and then change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes that are to be advertised to the peer or peer group.

Precautions

  • The ext-community-change enable command must be used together with the peer route-policy import command so that the extended community attributes received from a peer or peer group can be modified based on an import policy.
  • The ext-community-change enable command must be used together with the peer advertise-ext-community and peer route-policy export commands so that the changed extended community attributes can be advertised to a peer or peer group based on an export policy.
  • The ext-community-change enable command allows a device to change only VPN targets and SoO extended community attributes based on a route-policy.

Example

# Enable the device to change extended community attributes based on a route-policy.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] ext-community-change enable

ext-community-change enable (BGP-IPv4 unicast address family view)

Function

The ext-community-change enable command allows a routing policy to modify the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute.

The undo ext-community-change enable command disables the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute from being modified using a routing policy.

By default, a BGP device cannot use route-policies to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in matched BGP routes.

Format

ext-community-change enable

undo ext-community-change enable

Parameters

None

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP prevents a device from using a route-policy to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes either learned from or to be advertised to a peer or peer group. To enable a device to use route-policies to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in matched routes, run the ext-community-change enable command. After running this command, you can configure an import route-policy to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes received from a peer or peer group. You can also configure an export route-policy to filter the optimal routes selected by BGP and then change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes that are to be advertised to the peer or peer group.

Precautions

  • The ext-community-change enable command must be used together with the peer route-policy import command so that the extended community attributes received from a peer or peer group can be modified based on an import policy.
  • The ext-community-change enable command must be used together with the peer advertise-ext-community and peer route-policy export commands so that the changed extended community attributes can be advertised to a peer or peer group based on an export policy.
  • The ext-community-change enable command allows a device to change only VPN targets and SoO extended community attributes based on a route-policy.

Example

# Enable the device to change extended community attributes based on a route-policy.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ext-community-change enable

ext-community-change enable (BGP-IPv6 unicast address family view)

Function

The ext-community-change enable command allows a routing policy to modify the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute.

The undo ext-community-change enable command disables the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute from being modified using a routing policy.

By default, a BGP device cannot use route-policies to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in matched BGP routes.

Format

ext-community-change enable

undo ext-community-change enable

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP prevents a device from using a route-policy to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes either learned from or to be advertised to a peer or peer group. To enable a device to use route-policies to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in matched routes, run the ext-community-change enable command. After running this command, you can configure an import route-policy to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes received from a peer or peer group. You can also configure an export route-policy to filter the optimal routes selected by BGP and then change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes that are to be advertised to the peer or peer group.

Precautions

  • The ext-community-change enable command must be used together with the peer route-policy import command so that the extended community attributes received from a peer or peer group can be modified based on an import policy.
  • The ext-community-change enable command must be used together with the peer advertise-ext-community and peer route-policy export commands so that the changed extended community attributes can be advertised to a peer or peer group based on an export policy.
  • The ext-community-change enable command allows a device to change only VPN targets and SoO extended community attributes based on a routing policy.
  • To make the apply extcommunity soo command take effect in the export policy configured for a peer in the BGP-IPv6 unicast address family view, run the ext-community-change enable command in the BGP-IPv6 unicast address family view.

Example

# Enable the device to change extended community attributes based on a route-policy.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] ext-community-change enable

ext-community-change enable (BGP-VPN instance IPv4 address family view)

Function

The ext-community-change enable command allows a routing policy to modify the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute.

The undo ext-community-change enable command disables the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute from being modified using a routing policy.

By default, a BGP device cannot use route-policies to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in matched BGP routes.

Format

ext-community-change enable

undo ext-community-change enable

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP prevents a device from using a route-policy to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes either learned from or to be advertised to a peer or peer group. To enable a device to use route-policies to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in matched routes, run the ext-community-change enable command. After running this command, you can configure an import route-policy to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes received from a peer or peer group. You can also configure an export route-policy to filter the optimal routes selected by BGP and then change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes that are to be advertised to the peer or peer group.

Prerequisites

The BGP view or a specified address family view has been displayed.

Precautions

  • The ext-community-change enable command must be used together with the peer route-policy import command so that the extended community attributes received from a peer or peer group can be modified based on an import policy.
  • The ext-community-change enable command must be used together with the peer advertise-ext-community and peer route-policy export commands so that the changed extended community attributes can be advertised to a peer or peer group based on an export policy.
  • The ext-community-change enable command allows a device to change only VPN targets and SoO extended community attributes based on a route-policy.

Example

# Enable the device to change extended community attributes based on a route-policy.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] ext-community-change enable

ext-community-change enable (BGP-VPN instance IPv6 address family view)

Function

The ext-community-change enable command allows a routing policy to modify the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute.

The undo ext-community-change enable command disables the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute from being modified using a routing policy.

By default, a BGP device cannot use route-policies to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in matched BGP routes.

Format

ext-community-change enable

undo ext-community-change enable

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BGP prevents a device from using a route-policy to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes either learned from or to be advertised to a peer or peer group. To enable a device to use route-policies to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in matched routes, run the ext-community-change enable command. After running this command, you can configure an import route-policy to change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes received from a peer or peer group. You can also configure an export route-policy to filter the optimal routes selected by BGP and then change the VPN target extended community attribute, SoO extended community attribute, and link-bandwith attribute in the matched routes that are to be advertised to the peer or peer group.

Precautions

  • The ext-community-change enable command must be used together with the peer route-policy import command so that the extended community attributes received from a peer or peer group can be modified based on an import policy.
  • The ext-community-change enable command must be used together with the peer advertise-ext-community and peer route-policy export commands so that the changed extended community attributes can be advertised to a peer or peer group based on an export policy.
  • The ext-community-change enable command allows a device to change only VPN targets and SoO extended community attributes based on a route-policy.

Example

# Enable the device to change extended community attributes based on a route-policy.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] ext-community-change enable

filter-policy (BGP multi-instance VPN instance IPv4 address family view)

Function

The filter-policy export command configures a device to use an export policy to filter the routes to be advertised so that only the routes that match the export policy are advertised.

The undo filter-policy export command restores the default configuration.

The filter-policy import command configures a device to filter received routes.

The undo filter-policy import command restores the default configuration.

By default, received routes or the routes to be advertised are not filtered.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

filter-policy { acl-number | ip-prefix ip-prefix-name | acl-name acl-name } { import | export [ direct | isis process-id | ospf process-id | rip process-id | static ] }

undo filter-policy [ acl-number | ip-prefix ip-prefix-name | acl-name acl-name ] { import | export [ direct | isis process-id | ospf process-id | rip process-id | static ] }

Parameters

Parameter Description Value
acl-number

Specifies a basic ACL number.

The value is an integer ranging from 2000 to 2999.

ip-prefix ip-prefix-name

Specifies the name of an IPv4 prefix list.

The value is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 32 case-sensitive characters, spaces not supported.

direct

Configures a device to filter the direct routes to be advertised.

-

isis process-id

Specifies the ID of an IS-IS process.

The value is an integer ranging from 1 to 4294967295.

ospf process-id

process-id Specifies the ID of an OSPF process.

The value is an integer ranging from 1 to 4294967295.

rip process-id

Specifies the ID of an RIPng process.

The value is an integer ranging from 1 to 4294967295.

static

Filters the static routes to be advertised.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The filter-policy export command filters the routes to be advertised by the BGP multi-instance VPNv4 instance IPv4 address family. After the filter-policy export command is run, BGP filters the routes imported using the import-route command before importing them. Only the routes that pass the filtering can be added to the local BGP routing table and advertised by BGP.

You can run the filter-policy import command to filter the routes received by the BGP multi-instance VPNv4 instance IPv4 address family on a BGP device and determine whether to add the routes to the BGP routing table.

If a protocol is specified, only the routes imported from the specified protocol are filtered. The routes imported from other protocols are not affected. If protocol is not specified, the routes imported from all protocols are filtered.

For a named ACL, when the rule command is used to configure a filtering rule, the source address range specified by the source parameter and the time period specified by the time-range parameter take effect in the filtering rule.

Example

# Use ip-prefix named aaa to filter the routes received by BGP.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix aaa permit 10.0.192.0 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] filter-policy ip-prefix aaa import
# Use ACL 2000 to filter all the routes to be advertised by BGP.
<HUAWEI> system-view
[HUAWEI] acl 2000
[HUAWEI-acl4-basic-2000] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] filter-policy 2000 export

filter-policy (BGP view)

Function

The filter-policy export command configures a device to use an export policy to filter the routes to be advertised so that only the routes that match the export policy are advertised.

The undo filter-policy export command restores the default configuration.

The filter-policy import command configures a device to filter received routes.

The undo filter-policy import command restores the default configuration.

By default, received routes or the routes to be advertised are not filtered.

Format

filter-policy { acl-number | ip-prefix ip-prefix-name | acl-name acl-name } { import | export [ direct | isis process-id | ospf process-id | rip process-id | static ] }

undo filter-policy [ acl-number | ip-prefix ip-prefix-name | acl-name acl-name ] { import | export [ direct | isis process-id | ospf process-id | rip process-id | static ] }

Parameters

Parameter Description Value
acl-number

Specifies a basic ACL number.

The value is an integer ranging from 2000 to 2999.

ip-prefix ip-prefix-name

Specifies the name of an IPv4 prefix list.

The value is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 32 case-sensitive characters, spaces not supported.

direct

Configures a device to filter the direct routes to be advertised.

-

isis process-id

Specifies the ID of an IS-IS process.

The value is an integer ranging from 1 to 4294967295.

ospf process-id

process-id Specifies the ID of an OSPF process.

The value is an integer ranging from 1 to 4294967295.

rip process-id

Specifies the RIPng process ID.

The value is an integer ranging from 1 to 4294967295.

static

Filters the static routes to be advertised.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The filter-policy export command filters the routes advertised globally. After the filter-policy export command is run, BGP filters the routes imported using the import-route command before importing them. Only the routes that pass the filtering can be added to the local BGP routing table and advertised by BGP.

The filter-policy import command filters the routes received by a BGP device globally and determines whether to add the routes to the BGP routing table.

If a protocol is specified, only the routes imported from the specified protocol are filtered. The routes imported from other protocols are not affected. If protocol is not specified, the routes imported from any protocol are filtered.

When configured filtering conditions are used for a named ACL, only the configurations specified by source and time-range take effect.

Example

# Use ACL 2000 to filter all the routes to be advertised by BGP.
<HUAWEI> system-view
[HUAWEI] acl 2000
[HUAWEI-acl4-basic-2000] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] filter-policy 2000 export
# Use ip-prefix named aaa to filter the routes received by BGP.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix aaa permit 10.0.192.0 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] filter-policy ip-prefix aaa import

filter-policy (BGP-IPv4 unicast address family view)

Function

The filter-policy export command configures a device to use an export policy to filter the routes to be advertised so that only the routes that match the export policy are advertised.

The undo filter-policy export command restores the default configuration.

The filter-policy import command configures a device to filter received routes.

The undo filter-policy import command restores the default configuration.

By default, received routes or the routes to be advertised are not filtered.

Format

filter-policy { acl-number | ip-prefix ip-prefix-name | acl-name acl-name } { import | export [ direct | isis process-id | ospf process-id | rip process-id | static ] }

undo filter-policy [ acl-number | ip-prefix ip-prefix-name | acl-name acl-name ] { import | export [ direct | isis process-id | ospf process-id | rip process-id | static ] }

Parameters

Parameter Description Value
acl-number

Specifies a basic ACL number.

The value is an integer ranging from 2000 to 2999.

ip-prefix ip-prefix-name

Specifies the name of an IPv4 prefix list.

The value is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 32 case-sensitive characters, spaces not supported.

direct

Configures a device to filter the direct routes to be advertised.

-

isis process-id

Specifies the ID of an IS-IS process.

The value is an integer ranging from 1 to 4294967295.

ospf process-id

process-id Specifies the ID of an OSPF process.

The value is an integer ranging from 1 to 4294967295.

rip process-id

Specifies the RIPng process ID.

The value is an integer ranging from 1 to 4294967295.

static

Filters the static routes to be advertised.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The filter-policy export command filters the routes advertised globally. After the filter-policy export command is run, BGP filters the routes imported using the import-route command before importing them. Only the routes that pass the filtering can be added to the local BGP routing table and advertised by BGP.

The filter-policy import command filters the routes received by a BGP device globally and determines whether to add the routes to the BGP routing table.

If a protocol is specified, only the routes imported from the specified protocol are filtered. The routes imported from other protocols are not affected. If protocol is not specified, the routes imported from any protocol are filtered.

When configured filtering conditions are used for a named ACL, only the configurations specified by source and time-range take effect.

Example

# Use ACL 2000 to filter all the routes to be advertised by BGP.
<HUAWEI> system-view
[HUAWEI] acl 2000
[HUAWEI-acl4-basic-2000] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] filter-policy 2000 export
# Use ip-prefix named aaa to filter the routes received by BGP.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix aaa permit 10.0.192.0 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] filter-policy ip-prefix aaa import

filter-policy (BGP-IPv6 unicast address family view)

Function

The filter-policy import command configures a device to filter received routes.

The undo filter-policy import command restores the default configuration.

The filter-policy export command configures a device to use an export policy to filter the routes to be advertised so that only the routes that match the export policy are advertised.

The undo filter-policy export command restores the default configuration.

By default, the received or advertised routes are not filtered.

Format

filter-policy { acl6-number | ipv6-prefix ipv6-prefix-name | acl6-name acl6-name } { import | export [ direct | isis process-id | ospfv3 process-id | ripng process-id | static ] }

undo filter-policy [ acl6-number | ipv6-prefix ipv6-prefix-name | acl6-name acl6-name ] { import | export [ direct | isis process-id | ospfv3 process-id | ripng process-id | static ] }

Parameters

Parameter Description Value
acl6-number

Specifies the number of a basic ACL6.

The value is an integer ranging from 2000 to 2999.

ipv6-prefix ipv6-prefix-name

Specifies the name of an IPv6 prefix list.

The value is a string of 1 to 169 case-sensitive characters. The character string can contain spaces if it is enclosed in double quotation marks ("").

acl6-name acl6-name

Specifies the name of a basic named ACL6.

The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter or digit, and cannot contain only digits.

direct

Filters the direct routes to be advertised.

-

isis process-id

Specifies the ID of an IS-IS process.

The value is an integer ranging from 1 to 4294967295.

ospfv3 process-id

Specifies an process ID of OSPFv3.

The value is an integer ranging from 1 to 4294967295.

ripng process-id

Specifies the RIPng process ID.

The value is an integer ranging from 1 to 4294967295.

static

Configures a device to filter the static routes to be advertised.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The filter-policy export command affects the routes advertised by BGP. After the filter-policy export command is run, BGP filters the routes imported using the import-route command before importing them. Only the routes that pass the filtering can be added to the local BGP routing table and advertised by BGP.

The filter-policy import command can be used to filter the routes received by a BGP device globally and determine whether to add the routes to the BGP routing table.

If a protocol is specified, only the routes imported from the specified protocol are filtered. The routes imported from other protocols are not affected. If protocol is not specified, the routes imported from all protocols will be filtered.

When configured filtering conditions are used for a named ACL, only the configurations specified by source and time-range take effect.

Configuration Impact

If the filter-policy export command with the same protocol specified is run more than once, the latest configuration overrides the previous one.

If the filter-policy import command runs more than once, the latest configuration overrides the previous one.

Example

# Use ACL 2000 to filter all the routes to be advertised by BGP.
<HUAWEI> system-view
[HUAWEI] acl ipv6 2000
[HUAWEI-acl6-basic-2000] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] filter-policy 2000 import

filter-policy (BGP-VPN instance IPv4 address family view)

Function

The filter-policy export command configures a device to use an export policy to filter the routes to be advertised so that only the routes that match the export policy are advertised.

The undo filter-policy export command restores the default configuration.

The filter-policy import command configures a device to filter received routes.

The undo filter-policy import command restores the default configuration.

By default, received routes or the routes to be advertised are not filtered.

Format

filter-policy { acl-number | ip-prefix ip-prefix-name | acl-name acl-name } { import | export [ direct | isis process-id | ospf process-id | rip process-id | static ] }

undo filter-policy [ acl-number | ip-prefix ip-prefix-name | acl-name acl-name ] { import | export [ direct | isis process-id | ospf process-id | rip process-id | static ] }

Parameters

Parameter Description Value
acl-number

Specifies a basic ACL number.

The value is an integer ranging from 2000 to 2999.

ip-prefix ip-prefix-name

Specifies the name of an IPv4 prefix list.

The value is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 32 case-sensitive characters, spaces not supported.

direct

Configures a device to filter the direct routes to be advertised.

-

isis process-id

Specifies the ID of an IS-IS process.

The value is an integer ranging from 1 to 4294967295.

ospf process-id

process-id Specifies the ID of an OSPF process.

The value is an integer ranging from 1 to 4294967295.

rip process-id

Specifies a RIPng process ID.

The value is an integer ranging from 1 to 4294967295.

static

Filters the static routes to be advertised.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Using the filter-policy export command, you can filter the routes to be advertised by the BGP-VPN instance IPv4 address family. After the filter-policy export command is run, BGP filters the routes imported using the import-route command before importing them. Only the routes that pass the filtering can be added to the local BGP routing table and advertised by BGP.

You can run the filter-policy import command to filter the routes received by the BGP-VPN instance IPv4 address family on a BGP device and determine whether to add the routes to the BGP routing table.

If a protocol is specified, only the routes imported from the specified protocol are filtered. The routes imported from other protocols are not affected. If protocol is not specified, the routes imported from any protocol are filtered.

For a named ACL, when the rule command is used to configure a filtering rule, the filtering rule is valid only when the source address range is specified by the source parameter and the time period is specified by the time-range parameter.

Example

# Use ACL 2000 to filter all the routes to be advertised by BGP.
<HUAWEI> system-view
[HUAWEI] acl 2000
[HUAWEI-acl4-basic-2000] quit
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] filter-policy 2000 export

filter-policy (BGP-VPN instance IPv6 address family view)

Function

The filter-policy export command configures a device to use an export policy to filter the routes to be advertised so that only the routes that match the export policy are advertised.

The undo filter-policy export command restores the default configuration.

The filter-policy import command configures a device to filter received routes.

The undo filter-policy import command restores the default configuration.

By default, received routes or the routes to be advertised are not filtered.

Format

filter-policy { acl6-number | ipv6-prefix ipv6-prefix-name | acl6-name acl6-name } { import | export [ direct | isis process-id | ospfv3 process-id | ripng process-id | static ] }

undo filter-policy [ acl6-number | ipv6-prefix ipv6-prefix-name | acl6-name acl6-name ] { import | export [ direct | isis process-id | ospfv3 process-id | ripng process-id | static ] }

Parameters

Parameter Description Value
acl6-number

Specifies a basic ACL6 number.

The value is an integer ranging from 2000 to 2999.

ipv6-prefix ipv6-prefix-name

Specifies the name of an IPv6 prefix list.

The value is a string of 1 to 169 case-sensitive characters. The character string can contain spaces if it is enclosed in double quotation marks ("").

acl6-name acl6-name

Specifies the name of a named basic ACL6.

The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter or digit, and cannot contain only digits.

direct

Configures a device to filter the direct routes to be advertised.

-

isis process-id

Specifies the ID of an IS-IS process.

The value is an integer ranging from 1 to 4294967295.

ospfv3 process-id

Specifies the OSPFv3 process ID.

The value is an integer ranging from 1 to 4294967295.

ripng process-id

Specifies the ID of an RIPng process.

The value is an integer ranging from 1 to 4294967295.

static

Filters the static routes to be advertised.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The filter-policy export command filters the routes to be advertised by the BGP-VPN instance IPv6 address family. After the filter-policy export command is run, BGP filters the routes imported using the import-route command before importing them. Only the routes that pass the filtering can be added to the local BGP routing table and advertised by BGP.

You can run the filter-policy import command to filter the routes received by the BGP-VPN instance IPv6 address family on a BGP device and determine whether to add the routes to the BGP routing table.

If a protocol is specified, only the routes imported from the specified protocol are filtered. The routes imported from other protocols are not affected. If a protocol is not specified, the routes imported from any protocol are filtered.

For a named ACL, when the rule command is used to configure a filtering rule, the filtering rule is valid only when the source address range is specified by the source parameter and the time period is specified by the time-range parameter.

Example

# Use ACL 2000 to filter all the routes to be advertised by BGP.
<HUAWEI> system-view
[HUAWEI] acl ipv6 2000
[HUAWEI-acl6-basic-2000] quit
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] filter-policy 2000 export

graceful-restart

Function

The graceful-restart command enables GR globally on a BGP speaker.

The undo graceful-restart command disables GR globally.

By default, GR is disabled globally.

Format

graceful-restart

undo graceful-restart

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After you run the graceful-restart command to enable GR on a device, the device helps other GR-capable devices to perform GR during a BGP restart, preventing traffic interruption.

Both static peers and network segment peers support the GR helper capability.

Configuration Impact

Enabling or disabling GR deletes and reestablishes all sessions and instances.

Follow-up Procedure

Run the graceful-restart timer wait-for-rib command to set the time for waiting for the End-Of-RIB flag.

Example

# Enable GR globally for the speaker in BGP process 100.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] graceful-restart

graceful-restart (BGP multi-instance view)

Function

The graceful-restart command enables GR globally on a BGP speaker.

The undo graceful-restart command disables GR globally.

By default, GR is disabled globally.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

graceful-restart

undo graceful-restart

Parameters

None

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A BGP restart causes traffic interruption. To prevent traffic interruption, run the graceful-restart command on a BGP speaker to enable GR globally. This enables all the peers specified on the BGP speaker to perform GR during a BGP restart.

Configuration Impact

Enabling or disabling GR deletes and reestablishes all sessions and instances.

Follow-up Procedure

Run the graceful-restart timer wait-for-rib command to set the time for waiting for the End-Of-RIB flag.

Example

# Enable GR globally for the speaker in BGP process 100.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] graceful-restart

graceful-restart peer-reset (BGP multi-instance view)

Function

The graceful-restart peer-reset command enables the device to reset a BGP connection in GR mode.

The undo graceful-restart peer-reset command restores the default configuration.

By default, the device is not enabled to reset a BGP connection in GR mode.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

graceful-restart peer-reset

undo graceful-restart peer-reset

Parameters

None

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. As a result, each time the BGP capability changes, the BGP peer relationship is re-established. For example, a BGP IPv4 unicast peer relationship is established and IPv4 services are running; if the BGP capability changes, the BGP IPv4 unicast peer relationship will be re-established, which interrupts ongoing IPv4 services. To prevent the service interruptions, run the graceful-restart peer-reset command to enable the device to reset a BGP session in GR mode.

If the GR reset function and a new BGP capability are enabled on a BGP speaker, the BGP speaker enters the GR state, resets the BGP session (without deleting the routing entries for the session), and renegotiates BGP capabilities with its peer. Therefore, existing services are not interrupted.

Enable the device to reset a BGP connection in GR mode when establishing BGP peer relationships.

Example

# Enable the device to reset a BGP connection in GR mode.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] graceful-restart
[HUAWEI-bgp-instance-a] graceful-restart peer-reset

graceful-restart peer-reset (BGP view)

Function

The graceful-restart peer-reset command enables the device to reset a BGP connection in GR mode.

The undo graceful-restart peer-reset command restores the default configuration.

By default, the device is not enabled to reset a BGP connection in GR mode.

Format

graceful-restart peer-reset

undo graceful-restart peer-reset

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. As a result, each time the BGP capability changes, the BGP peer relationship is re-established. For example, a BGP IPv4 unicast peer relationship is established and IPv4 services are running; if the BGP capability changes, the BGP IPv4 unicast peer relationship will be re-established, which interrupts ongoing IPv4 services. To prevent the service interruptions, run the graceful-restart peer-reset command to enable the device to reset a BGP session in GR mode.

If the GR reset function and a new BGP capability are enabled on a BGP speaker, the BGP speaker enters the GR state, resets the BGP session (without deleting the routing entries for the session), and renegotiates BGP capabilities with its peer. Therefore, existing services are not interrupted.

Enable the device to reset a BGP connection in GR mode when establishing BGP peer relationships.

Example

# Enable the device to reset a BGP connection in GR mode.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] graceful-restart
[HUAWEI-bgp] graceful-restart peer-reset

graceful-restart timer restart (BGP multi-instance view)

Function

The graceful-restart timer restart command sets the maximum duration on a device for each peer to wait for its BGP peer relationship to be reestablished with the device.

The undo graceful-restart timer restart command deletes the configured duration.

By default, each peer specified on a device waits for its BGP peer relationship to be reestablished with the device for a maximum of 150s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

graceful-restart timer restart restart-time

undo graceful-restart timer restart

Parameters

Parameter Description Value
restart-time

Specifies the maximum duration on a device for each peer to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To set the maximum duration on a device for each peer to wait for its BGP peer relationship to be reestablished with the device, run the graceful-restart timer restart command. After this command is run, if any peer detects that the device is down, the BGP session on the peer enters the GR process. If the peer relationship is not reestablished within the specified duration, the BGP session exits the GR process, and the peer selects the optimal route among existing routes.

Configuration Impact

If the graceful-restart timer restart command is run more than once, the latest configuration overrides the previous one.

After the graceful-restart timer restart command is run on a device, all the device's BGP peer relationships will be disconnected and then reestablished.

Precautions

If there are a large number of routes, setting time to a large value is recommended.

Example

# Set the maximum duration to 250s on a device for each peer to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] graceful-restart timer restart 250

graceful-restart timer restart (BGP view)

Function

The graceful-restart timer restart command sets the maximum duration on a device for each peer to wait for its BGP peer relationship to be reestablished with the device.

The undo graceful-restart timer restart command deletes the configured duration.

By default, each peer specified on a device waits for its BGP peer relationship to be reestablished with the device for a maximum of 150s.

Format

graceful-restart timer restart restart-time

undo graceful-restart timer restart

Parameters

Parameter Description Value
restart-time

Specifies the maximum duration on a device for each peer to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To set the maximum duration on a device for each peer to wait for its BGP peer relationship to be reestablished with the device, run the graceful-restart timer restart command. After this command is run, if any peer detects that the device is down, the BGP session on the peer enters the GR process. If the peer relationship is not reestablished within the specified duration, the BGP session exits the GR process, and the peer selects the optimal route among existing routes.

Configuration Impact

If the graceful-restart timer restart command is run more than once, the latest configuration overrides the previous one.

After the graceful-restart timer restart command is run on a device, all the device's BGP peer relationships will be disconnected and then reestablished.

Precautions

If there are a large number of routes, setting time to a large value is recommended.

Example

# Set the maximum delay to 250 seconds.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] graceful-restart timer restart 250

graceful-restart timer wait-for-rib (BGP multi-instance view)

Function

The graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer.

The undo graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer for a maximum of 600s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

graceful-restart timer wait-for-rib time

undo graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
time

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To set the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer, run the graceful-restart timer wait-for-rib command. After the BGP session between the BGP restarter and any peer is reestablished, if the BGP restarter does not receive the End-of-RIB flag from this peer within the specified duration, the BGP session on the device exits from the GR process, and the device selects the optimal route among reachable routes.

Configuration Impact

If the graceful-restart timer wait-for-rib command is run more than once, the latest configuration overrides the previous one.

Precautions

If there are a large number of routes, setting time to a large value is recommended.

Example

# Set the maximum duration to 100s for a BGP restarter to wait for the End-of-RIB flag from each peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] graceful-restart timer wait-for-rib 100

graceful-restart timer wait-for-rib (BGP view)

Function

The graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer.

The undo graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer for a maximum of 600s.

Format

graceful-restart timer wait-for-rib time

undo graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
time

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To set the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer, run the graceful-restart timer wait-for-rib command. After the BGP session between the BGP restarter and any peer is reestablished, if the BGP restarter does not receive the End-of-RIB flag from this peer within the specified duration, the BGP session on the device exits from the GR process, and the device selects the optimal route among reachable routes.

Configuration Impact

If the graceful-restart timer wait-for-rib command is run more than once, the latest configuration overrides the previous one.

Precautions

If there are a large number of routes, setting time to a large value is recommended.

Example

# Set the maximum duration to 100s for a BGP restarter to wait for the End-of-RIB flag from each peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] graceful-restart timer wait-for-rib 100

group (BGP multi-instance view)

Function

The group command creates a peer group.

The undo group command deletes a peer group.

By default, no peer group is created.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

group group-name [ internal | external ]

undo group group-name

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

internal

Creates an IBGP peer group.

-

external

Creates an EBGP peer group.

-

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A peer group consists of peers with the same routing policies. After a peer is added to a peer group, it inherits the configurations of this peer group. When the configurations of the peer group are changed, the configurations of these peers are changed accordingly.

On a large-scale BGP network, there are a large number of peers, many of which require the same policy. In such a case, you can run the group command to create a peer group, configure the policy for the peer group, and then add peers to the group, which simplifies configurations.

Configuration Impact

If the group command is run more than once, all configurations take effect.

After the group command is run, the system creates a BGP peer group of the specified type.

Precautions

After a peer group is deleted, all the peers in the peer group are deleted.

If no type (IBGP or EBGP) is specified for a peer group, an IBGP peer group is created by default.

If an attribute configuration of a BGP peer in a peer group differs from that of the peer group, you can disable the attribute configuration of the peer using an undo command; then the peer inherits the attribute configuration of the peer group.

If you run the undo group command, all configurations related to the peer group are deleted. Therefore, exercise caution when running this command.

Note:

Deleting a peer group will disconnect the peers without AS numbers configured in the peer group. Therefore, before deleting a peer group, delete these peers or configure AS numbers for these peers.

The functions configured on a peer using the following commands take precedence over those configured on the peer group of the peer:

  • peer bfd
  • peer bfd block
  • peer bfd enable
  • peer listen-only
  • peer valid-ttl-hops

    For other BGP commands, the latest configuration preferentially takes effect.

Example

# Create an IBGP peer group named in.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] group in internal
# Create an EBGP peer group ex and set its AS number to 500.1.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] group ex external

group (BGP multi-instance VPN instance IPv4 address family view)

Function

The group command creates a peer group.

The undo group command deletes a peer group.

By default, no peer group is created.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

group group-name [ internal | external ]

undo group group-name

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

internal

Creates an IBGP peer group.

-

external

Creates an EBGP peer group.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A peer group consists of peers with the same routing policies. After a peer is added to a peer group, it inherits the configurations of this peer group. When the configurations of the peer group are changed, the configurations of these peers are changed accordingly.

On a large-scale BGP network, there are a large number of peers, many of which require the same policy. In such a case, you can run the group command to create a peer group, configure the policy for the peer group, and then add peers to the group, which simplifies configurations.

Configuration Impact

If the group command is run more than once, all configurations take effect.

After the group command is run, the system creates a BGP peer group of the specified type.

Precautions

After a peer group is deleted, all the peers in the peer group are deleted.

If no type (IBGP or EBGP) is specified for a peer group, an IBGP peer group is created by default.

If an attribute configuration of a BGP peer in a peer group differs from that of the peer group, you can disable the attribute configuration of the peer using an undo command; then the peer inherits the attribute configuration of the peer group.

If you run the undo group command, all configurations related to the peer group are deleted. Therefore, exercise caution when running this command.

Note:

Deleting a peer group will disconnect the peers without AS numbers configured in the peer group. Therefore, before deleting a peer group, delete these peers or configure AS numbers for these peers.

The functions configured on a peer using the following commands take precedence over those configured on the peer group of the peer:

  • peer bfd
  • peer bfd block
  • peer bfd enable
  • peer listen-only
  • peer valid-ttl-hops

    For other BGP commands, the latest configuration preferentially takes effect.

Example

# Create an IBGP peer group named in.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group in internal
# Create an EBGP peer group named ex and set its AS number to 500.1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group ex external
[HUAWEI-bgp-instance-a-vpna] peer ex as-number 500.1

group (BGP view)

Function

The group command creates a peer group.

The undo group command deletes a peer group.

By default, no peer group is created.

Format

group group-name { internal | external }

group group-name

undo group group-name

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

internal

Creates an IBGP peer group.

-

external

Creates an EBGP peer group.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A peer group consists of peers with the same routing policies. After a peer is added to a peer group, it inherits the configurations of this peer group. When the configurations of the peer group are changed, the configurations of these peers are changed accordingly.

On a large-scale BGP network, there are a large number of peers, many of which require the same policy. In such a case, you can run the group command to create a peer group, configure the policy for the peer group, and then add peers to the group, which simplifies configurations.

Configuration Impact

If the group command is run more than once, all configurations take effect.

After the group command is run, the system creates a BGP peer group of the specified type.

Precautions

After a peer group is deleted, all the peers in the peer group are deleted.

If no type (IBGP or EBGP) is specified for a peer group, an IBGP peer group is created by default.

If an attribute configuration of a BGP peer in a peer group differs from that of the peer group, you can disable the attribute configuration of the peer using an undo command; then the peer inherits the attribute configuration of the peer group.

If you run the undo group command, all configurations related to the peer group are deleted. Therefore, exercise caution when running this command.

Note:

Deleting a peer group will disconnect the peers without AS numbers configured in the peer group. Therefore, before deleting a peer group, delete these peers or configure AS numbers for these peers.

The functions configured on a peer using the following commands take precedence over those configured on the peer group of the peer:

  • peer bfd
  • peer bfd block
  • peer bfd enable
  • peer listen-only
  • peer valid-ttl-hops

    For other BGP commands, the latest configuration preferentially takes effect.

Example

# Create an EBGP peer group named ex and set its AS number to 500.1.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group ex external
[HUAWEI-bgp] peer ex as-number 500.1
# Create an IBGP peer group named in.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group in internal

group (BGP-VPN instance IPv4 address family view)

Function

The group command creates a peer group.

The undo group command deletes a peer group.

By default, no peer group is created.

Format

group group-name { internal | external }

group group-name

undo group group-name

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

internal

Creates an IBGP peer group.

-

external

Creates an EBGP peer group.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A peer group consists of peers with the same routing policies. After a peer is added to a peer group, it inherits the configurations of this peer group. When the configurations of the peer group are changed, the configurations of these peers are changed accordingly.

On a large-scale BGP network, there are a large number of peers, many of which require the same policy. In such a case, you can run the group command to create a peer group, configure the policy for the peer group, and then add peers to the group, which simplifies configurations.

Configuration Impact

If the group command is run more than once, all configurations take effect.

After the group command is run, the system creates a BGP peer group of the specified type.

Precautions

After a peer group is deleted, all the peers in the peer group are deleted.

If no type (IBGP or EBGP) is specified for a peer group, an IBGP peer group is created by default.

If an attribute configuration of a BGP peer in a peer group differs from that of the peer group, you can disable the attribute configuration of the peer using an undo command; then the peer inherits the attribute configuration of the peer group.

If you run the undo group command, all configurations related to the peer group are deleted. Therefore, exercise caution when running this command.

Note:

Deleting a peer group will disconnect the peers without AS numbers configured in the peer group. Therefore, before deleting a peer group, delete these peers or configure AS numbers for these peers.

The functions configured on a peer using the following commands take precedence over those configured on the peer group of the peer:

  • peer bfd
  • peer bfd block
  • peer bfd enable
  • peer listen-only
  • peer valid-ttl-hops

    For other BGP commands, the latest configuration preferentially takes effect.

Example

# Create an IBGP peer group named in.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group in internal
# Create an EBGP peer group named ex and set its AS number to 500.1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group ex external
[HUAWEI-bgp-vpn1] peer ex as-number 500.1

group (BGP-VPN instance IPv6 address family view)

Function

The group command creates a peer group.

The undo group command deletes a peer group.

By default, no peer group is created.

Format

group group-name { external | internal }

group group-name

undo group group-name

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

external

Creates an EBGP peer group.

-

internal

Creates an IBGP peer group.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A peer group consists of peers with the same routing policies. After a peer is added to a peer group, it inherits the configurations of this peer group. When the configurations of the peer group are changed, the configurations of these peers are changed accordingly.

On a large-scale BGP network, there are a large number of peers, many of which require the same policy. In such a case, you can run the group command to create a peer group, configure the policy for the peer group, and then add peers to the group, which simplifies configurations.

Configuration Impact

If the group command is run more than once, all configurations take effect.

After the group command is run, the system creates a BGP peer group of the specified type.

Precautions

After a peer group is deleted, all the peers in the peer group are deleted.

If no type (IBGP or EBGP) is specified for a peer group, an IBGP peer group is created by default.

If an attribute configuration of a BGP peer in a peer group differs from that of the peer group, you can disable the attribute configuration of the peer using an undo command; then the peer inherits the attribute configuration of the peer group.

If you run the undo group command, all configurations related to the peer group are deleted. Therefore, exercise caution when running this command.

Note:

Deleting a peer group will disconnect the peers without AS numbers configured in the peer group. Therefore, before deleting a peer group, delete these peers or configure AS numbers for these peers.

The functions configured on a peer using the following commands take precedence over those configured on the peer group of the peer:

  • peer bfd
  • peer bfd block
  • peer bfd enable
  • peer listen-only
  • peer valid-ttl-hops

    For other BGP commands, the latest configuration preferentially takes effect.

Example

# Create an EBGP peer group named ex and set its AS number to 500.1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] group ex external
[HUAWEI-bgp-6-vpna] peer ex as-number 500.1
# Create an IBGP peer group named in.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] group in internal

group (BGP-VPN instance view)

Function

The group command creates a peer group.

The undo group command deletes a peer group.

By default, no peer group is created.

Format

group group-name [ internal | external ]

undo group group-name [ internal | external ]

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

internal

Creates an IBGP peer group.

-

external

Creates an EBGP peer group.

-

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A peer group consists of peers with the same routing policies. After a peer is added to a peer group, it inherits the configurations of this peer group. When the configurations of the peer group are changed, the configurations of these peers are changed accordingly.

On a large-scale BGP network, there are a large number of peers, many of which require the same policy. In such a case, you can run the group command to create a peer group, configure the policy for the peer group, and then add peers to the group, which simplifies configurations.

Example

# Create an IBGP peer group named in.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group in internal
# Create an EBGP peer group named ex and set its AS number to 500.1.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-vpn1] group ex external
[HUAWEI-bgp-vpn1] peer ex as-number 500.1

group listen (BGP view)

Function

The group listen command creates a dynamic BGP peer group.

The undo group listen command deletes a dynamic BGP peer group.

By default, no dynamic BGP peer groups are created.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

group group-name listen { internal | external | confederation-external }

group group-name listen

undo group group-name listen [ internal | external | confederation-external ]

Parameters

Parameter Description Value
group-name

Specifies the name of a dynamic BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

internal

Creates a dynamic IBGP peer group.

-

external

Creates a dynamic EBGP peer group.

-

confederation-external

Creates a dynamic confederation EBGP peer group.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If static BGP peers change frequently on a BGP network, you need to add or delete BGP peer configurations in response to each change, which requires a heavy maintenance workload. To address this problem, configure the dynamic BGP peer function to enable BGP to listen for BGP connection requests from a specified network segment, dynamically establish BGP peer relationships, and add these peers to the same dynamic peer group. This spares you from adding or deleting BGP peer configurations in response to each change in dynamic peers. To create a dynamic BGP peer group, run the group listen command.

After a peer is added to a dynamic peer group, the peer inherits the configurations of this peer group. If the configurations of the peer group change, the configurations of all the peers in the group change accordingly. Such implementation is the same as that of static BGP peer groups.

If a dynamic BGP peer group is created in a BGP address family, creating the same peer group in another address family does not take effect. In this case, you must run the reset bgp x.x.x.x command (x.x.x.x specifies the IP address of a dynamic BGP peer) or run the reset bgp group groupname command in the user view to allow the dynamic BGP peer group to be created in the latter address family.

Precautions

If the group listen command is run more than once, all configurations take effect.

If a dynamic BGP peer group is deleted, connections with all peers in the peer group are deleted.

Names of BGP peer groups must be unique, regardless of whether they are of dynamic or static peer groups.

If the type (IBGP or EBGP) of a dynamic BGP peer group is not specified, a dynamic IBGP peer group is created by default.

Peers in a dynamic BGP peer group share the same attribute. Peer-based attribute configuration is not allowed in a dynamic BGP peer group.

The undo group command applies to both dynamic and static BGP peer groups. If the command is run, the corresponding peer group and all its configurations are deleted. Therefore, exercise caution when running this command.

Example

# Create a dynamic IBGP peer group named in.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group in listen internal

group listen (BGP-VPN instance IPv4 address family view)

Function

The group listen command creates a dynamic BGP peer group.

The undo group listen command deletes a dynamic BGP peer group.

By default, no dynamic BGP peer groups are created.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

group group-name listen { internal | external }

group group-name listen

undo group group-name listen [ internal | external ]

Parameters

Parameter Description Value
group-name

Specifies the name of a dynamic BGP peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

internal

Creates a dynamic IBGP peer group.

-

external

Creates a dynamic EBGP peer group.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If static BGP peers change frequently on a BGP network, you need to add or delete BGP peer configurations in response to each change, which requires a heavy maintenance workload. To address this problem, configure the dynamic BGP peer function to enable BGP to listen for BGP connection requests from a specified network segment, dynamically establish BGP peer relationships, and add these peers to the same dynamic peer group. This spares you from adding or deleting BGP peer configurations in response to each change in dynamic peers. To create a dynamic BGP peer group, run the group listen command.

After a peer is added to a dynamic peer group, the peer inherits the configurations of this peer group. If the configurations of the peer group change, the configurations of all the peers in the group change accordingly. Such implementation is the same as that of static BGP peer groups.

Precautions

If the group listen command is run more than once, all configurations take effect.

If a dynamic BGP peer group is deleted, connections with all peers in the peer group are deleted.

Names of BGP peer groups must be unique, regardless of whether they are of dynamic or static peer groups.

If the type (IBGP or EBGP) of a dynamic BGP peer group is not specified, a dynamic IBGP peer group is created by default.

Peers in a dynamic BGP peer group share the same attribute. Peer-based attribute configuration is not allowed in a dynamic BGP peer group.

The undo group command applies to both dynamic and static BGP peer groups. If the command is run, the corresponding peer group and all its configurations are deleted. Therefore, exercise caution when running this command.

Example

# Create a dynamic IBGP peer group named in.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group in listen internal

group listen (BGP-VPN instance view)

Function

The group listen command creates a dynamic BGP peer group.

The undo group listen command deletes a dynamic BGP peer group.

By default, no dynamic BGP peer groups are created.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

group group-name listen { internal | external }

group group-name listen

undo group group-name listen [ internal | external ]

Parameters

Parameter Description Value
group-name

Specifies the name of a dynamic BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

internal

Creates a dynamic IBGP peer group.

-

external

Creates a dynamic EBGP peer group.

-

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If static BGP peers change frequently on a BGP network, you need to add or delete BGP peer configurations in response to each change, which requires a heavy maintenance workload. To address this problem, configure the dynamic BGP peer function to enable BGP to listen for BGP connection requests from a specified network segment, dynamically establish BGP peer relationships, and add these peers to the same dynamic peer group. This spares you from adding or deleting BGP peer configurations in response to each change in dynamic peers. To create a dynamic BGP peer group, run the group listen command.

After a peer is added to a dynamic peer group, the peer inherits the configurations of this peer group. If the configurations of the peer group change, the configurations of all the peers in the group change accordingly. Such implementation is the same as that of static BGP peer groups.

Precautions

If the group listen command is run more than once, all configurations take effect.

If a dynamic BGP peer group is deleted, connections with all peers in the peer group are deleted.

Names of BGP peer groups must be unique, regardless of whether they are of dynamic or static peer groups.

If the type (IBGP or EBGP) of a dynamic BGP peer group is not specified, a dynamic IBGP peer group is created by default.

Peers in a dynamic BGP peer group share the same attribute. Peer-based attribute configuration is not allowed in a dynamic BGP peer group.

The undo group command applies to both dynamic and static BGP peer groups. If the command is run, the corresponding peer group and all its configurations are deleted. Therefore, exercise caution when running this command.

Example

# Create a dynamic IBGP peer group named in.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group in listen internal

ibgp-interface-sensitive (BGP multi-instance VPN instance IPv4 address family view)

Function

The ibgp-interface-sensitive command enables BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

The undo ibgp-interface-sensitive command restores the default configuration.

By default, BGP is not enabled to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

ibgp-interface-sensitive

undo ibgp-interface-sensitive

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the ibgp-interface-sensitive command is not run and a local interface on which a direct IBGP peer relationship is established fails, the system deletes the IBGP peer relationship only when the hold timer expires, which delays route switching. To address this problem, run the ibgp-interface-sensitive command to enable BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

Precautions

If a local interface on which a direct IBGP peer relationship is established alternates between Up and Down, do not run the ibgp-interface-sensitive command; otherwise, route flapping may occur.

The command enables BGP to quickly respond to failures of a local interface on which a direct IBGP peer relationship is established but does not enable BGP to quickly respond to recovery of the interface. After the interface recovers, BGP uses its state machine to restore the relevant session.

Example

# Enable BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] ibgp-interface-sensitive

ibgp-interface-sensitive (BGP view)

Function

The ibgp-interface-sensitive command enables BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

The undo ibgp-interface-sensitive command restores the default configuration.

By default, BGP is not enabled to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

Format

ibgp-interface-sensitive

undo ibgp-interface-sensitive

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the ibgp-interface-sensitive command is not run and a local interface on which a direct IBGP peer relationship is established fails, the system deletes the IBGP peer relationship only when the hold timer expires, which delays route switching. To address this problem, run the ibgp-interface-sensitive command to enable BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

Precautions

If a local interface on which a direct IBGP peer relationship is established alternates between Up and Down, do not run the ibgp-interface-sensitive command; otherwise, route flapping may occur.

The command enables BGP to quickly respond to failures of a local interface on which a direct IBGP peer relationship is established but does not enable BGP to quickly respond to recovery of the interface. After the interface recovers, BGP uses its state machine to restore the relevant session.

Example

# Enable BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ibgp-interface-sensitive

ibgp-interface-sensitive (BGP-IPv4 unicast address family view)

Function

The ibgp-interface-sensitive command enables BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

The undo ibgp-interface-sensitive command restores the default configuration.

By default, BGP is not enabled to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

Format

ibgp-interface-sensitive

undo ibgp-interface-sensitive

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the ibgp-interface-sensitive command is not run and a local interface on which a direct IBGP peer relationship is established fails, the system deletes the IBGP peer relationship only when the hold timer expires, which delays route switching. To address this problem, run the ibgp-interface-sensitive command to enable BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

Precautions

If a local interface on which a direct IBGP peer relationship is established alternates between Up and Down, do not run the ibgp-interface-sensitive command; otherwise, route flapping may occur.

The command enables BGP to quickly respond to failures of a local interface on which a direct IBGP peer relationship is established but does not enable BGP to quickly respond to recovery of the interface. After the interface recovers, BGP uses its state machine to restore the relevant session.

Example

# Enable BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] ibgp-interface-sensitive

ibgp-interface-sensitive (BGP-IPv6 unicast address family view)

Function

The ibgp-interface-sensitive command enables BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

The undo ibgp-interface-sensitive command restores the default configuration.

By default, BGP is not enabled to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

Format

ibgp-interface-sensitive

undo ibgp-interface-sensitive

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the ibgp-interface-sensitive command is not run and a local interface on which a direct IBGP peer relationship is established fails, the system deletes the IBGP peer relationship only when the hold timer expires, which delays route switching. To address this problem, run the ibgp-interface-sensitive command to enable BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

Precautions

If a local interface on which a direct IBGP peer relationship is established alternates between Up and Down, do not run the ibgp-interface-sensitive command; otherwise, route flapping may occur.

The command enables BGP to quickly respond to failures of a local interface on which a direct IBGP peer relationship is established but does not enable BGP to quickly respond to recovery of the interface. After the interface recovers, BGP uses its state machine to restore the relevant session.

Example

# Enable BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] ibgp-interface-sensitive

ibgp-interface-sensitive (BGP-VPN instance IPv4 address family view)

Function

The ibgp-interface-sensitive command enables BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

The undo ibgp-interface-sensitive command restores the default configuration.

By default, BGP is not enabled to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

Format

ibgp-interface-sensitive

undo ibgp-interface-sensitive

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the ibgp-interface-sensitive command is not run and a local interface on which a direct IBGP peer relationship is established fails, the system deletes the IBGP peer relationship only when the hold timer expires, which delays route switching. To address this problem, run the ibgp-interface-sensitive command to enable BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

Precautions

If a local interface on which a direct IBGP peer relationship is established alternates between Up and Down, do not run the ibgp-interface-sensitive command; otherwise, route flapping may occur.

The command enables BGP to quickly respond to failures of a local interface on which a direct IBGP peer relationship is established but does not enable BGP to quickly respond to recovery of the interface. After the interface recovers, BGP uses its state machine to restore the relevant session.

Example

# Enable BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] ibgp-interface-sensitive

ibgp-interface-sensitive (BGP-VPN instance IPv6 address family view)

Function

The ibgp-interface-sensitive command enables BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

The undo ibgp-interface-sensitive command restores the default configuration.

By default, BGP is not enabled to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

Format

ibgp-interface-sensitive

undo ibgp-interface-sensitive

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the ibgp-interface-sensitive command is not run and a local interface on which a direct IBGP peer relationship is established fails, the system deletes the IBGP peer relationship only when the hold timer expires, which delays route switching. To address this problem, run the ibgp-interface-sensitive command to enable BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.

Precautions

If a local interface on which a direct IBGP peer relationship is established alternates between Up and Down, do not run the ibgp-interface-sensitive command; otherwise, route flapping may occur.

The command enables BGP to quickly respond to failures of a local interface on which a direct IBGP peer relationship is established but does not enable BGP to quickly respond to recovery of the interface. After the interface recovers, BGP uses its state machine to restore the relevant session.

Example

# Enable BGP to delete the direct IBGP peer relationship established on a local interface upon a failure of the interface.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] ibgp-interface-sensitive

import-rib

Function

The import-rib command imports public network BGP routes or BGP routes in a specified VPN instance into a BGP-VPN instance routing table.

The undo import-rib command cancels the configuration of importing public network BGP routes or BGP routes in a specified VPN instance into a BGP-VPN instance routing table.

By default, a device does not import public network BGP routes or BGP routes in a VPN instance into a BGP-VPN instance routing table.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

import-rib { vpn-instance vpn-instance-name } [ valid-route ] [ route-policy route-policy-name ]

undo import-rib { vpn-instance vpn-instance-name } [ valid-route ] [ route-policy route-policy-name ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

valid-route

Imports valid routes of a specified type. Valid routes include optimal routes, routes for load balancing, FRR routes, and reachable routes that are not selected for packet forwarding. If this parameter is not specified, only optimal routes, load balancing routes, and FRR routes can be imported.

-

route-policy route-policy-name

Specifies the name of a route-filter.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string. If parameters are included in the referenced route-filter, specify values for them in the format of (var1, var2, ...var8) behind the route-filter name. Each value ranges from 1 to 200 characters.

Views

BGP multi-instance VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to import public network BGP routes into a BGP-VPN instance IPv6 routing table, run the import-rib public command in the BGP-VPN instance IPv6 address family view.

To configure a device to import BGP routes from a specified VPN instance into a BGP-VPN instance IPv6 routing table, run the import-rib vpn-instance command in the BGP-VPN instance IPv6 address family view.

Precautions

If the route-policy route-policy-name parameter is specified in the import-rib vpn-instance command, the if-match interface command configuration in the route-policy will not take effect.

The import-rib command configuration does not take effect for unlabeled routes that are leaked locally or remotely. Nor does this configuration take effect for the routes imported using the import-route command or network command.

Example

# Configure a device to import BGP routes from a vpn network to a specified VPN instance's BGP routing table.
<pe> system-view
[~pe] ip vpn-instance vpna
[*pe-vpn-instance-vpna] ipv6-family
[*pe-vpn-instance-vpna-af-ipv6] quit
[*pe-vpn-instance-vpna] quit
[*pe] ip vpn-instance vpnb
[*pe-vpn-instance-vpnb] ipv6-family
[*pe-vpn-instance-vpnb-af-ipv6] quit
[*pe-vpn-instance-vpnb] quit
[*pe] bgp 100 instance a
[*pe-bgp-instance-a] ipv6-family vpn-instance vpna
[*pe-bgp-instance-a-6-vpna] import-rib vpn-instance vpnb valid-route

import-rib (BGP-IPv4 unicast address family view)

Function

The import-rib command imports public network BGP routes or BGP routes in a specified VPN instance into the public network BGP routing table.

The undo import-rib command cancels the configuration.

By default, a device does not import public network BGP routes or BGP routes in a VPN instance into the public network BGP routing table.

Format

import-rib vpn-instance vpn-instance-name [ valid-route ] [ route-policy route-policy-name ]

undo import-rib vpn-instance vpn-instance-name [ valid-route ] [ route-policy route-policy-name ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

valid-route

Imports valid routes of a specified type. Valid routes include optimal routes, routes for load balancing, FRR routes, and reachable routes that are not selected for packet forwarding. If this parameter is not specified, only optimal routes, load balancing routes, and FRR routes can be imported.

-

route-policy route-policy-name

Specifies a route-policy to filter routes to be imported.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to import BGP routes from a specified VPN instance into the public network routing table, run the import-rib vpn-instance command in the BGP view or BGP-IPv4 unicast address family view.

Precautions

If the route-policy-name parameter is specified in the import-rib command, the if-match interface or if-match route-type command configuration will become ineffective.

The BGP IPv4 route import between public network and VPN instances does not take effect for non-labeled routes that are leaked remotely or locally or the routes that are imported in Import or Network mode.

Example

# Configure a device to import BGP routes from a VPN instance named vpna to a public network's BGP routing table.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] import-rib vpn-instance vpna

import-rib (BGP-IPv6 unicast address family view)

Function

The import-rib vpn-instance command imports BGP routes from a specified VPN instance into the public network BGP routing table.

The undo import-rib vpn-instance command cancels the configuration.

By default, a device does not import BGP routes from a VPN instance into the public network BGP routing table.

Format

import-rib vpn-instance vpn-instance-name [ valid-route ] [ route-policy route-policy-name ]

undo import-rib vpn-instance vpn-instance-name [ valid-route ] [ route-policy route-policy-name ]

Parameters

Parameter Description Value
vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters without spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

valid-route

Imports valid routes of a specified type. Valid routes include optimal routes, routes for load balancing, FRR routes, and reachable routes that are not selected for packet forwarding. If this parameter is not specified, only optimal routes, load balancing routes, and FRR routes can be imported.

-

route-policy route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to import BGP routes from a specified VPN instance into the public network BGP IPv6 routing table, run the import-rib vpn-instance command in the BGP-IPv6 unicast address family view.

If the valid-route parameter is specified in the import-rib vpn-instance command, all valid BGP routes in the specified VPN instance are imported. If the valid-route parameter is not specified, only active BGP routes among valid BGP routes are imported.

If the include-label-route parameter is specified in the import-rib vpn-instance command, the device will import the labeled routes that are received from BGP peers and that are leaked to the specified VPN instance.

If you want the imported routes to be preferentially selected, you can configure route-policy route-policy-name and apply a routing policy to modify the attributes of the BGP routes.

Precautions

If the route-policy route-policy-name parameter is specified in the import-rib vpn-instance command, the if-match interface command configuration in the route-policy will not take effect.

The import-rib vpn-instance command configuration does not take effect for unlabeled routes that are leaked locally or remotely. Nor does this configuration take effect for the routes imported using the import-route command or network command.

Example

# Configure a device to import BGP routes from a VPN instance named vpna to a public network's BGP routing table.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] import-rib vpn-instance vpna

import-rib (BGP-VPN instance IPv4 address family view)

Function

The import-rib command imports public network BGP routes or BGP routes in a specified VPN instance into a BGP-VPN instance routing table.

The undo import-rib command cancels the configuration.

By default, a device does not import public network BGP routes or BGP routes in a VPN instance into a BGP-VPN instance routing table.

Format

import-rib { public | vpn-instance vpn-instance-name } [ valid-route ] [ route-policy route-policy-name ]

undo import-rib { public | vpn-instance vpn-instance-name } [ valid-route ] [ route-policy route-policy-name ]

Parameters

Parameter Description Value
public

Importes routes from the public network BGP routing table.

-

vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. In addition, the VPN instance name must not be _public_. The character string can contain spaces if it is enclosed in double quotation marks ("").

valid-route

Imports only valid routes of a specified route type.

-

route-policy route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to import public network BGP routes into a BGP-VPN instance routing table, run the import-rib public command in the BGP-VPN instance IPv4 address family view.

To configure a device to import BGP routes from a specified VPN instance into a BGP-VPN instance routing table, run the import-rib vpn-instance command in the BGP-VPN instance IPv4 address family view.

Precautions

If the source of the invalid routes imported using the import-rib command matches the instance and address family in which the routing-table rib-only command is run, the import-rib and routing-table rib-only commands are mutually exclusive.

Example

# Configure a device to import valid BGP routes from the public network instance to a VPN instance's BGP routing table.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] vpn-target 100:1 both
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] import-rib public valid-route

import-rib (BGP-VPN instance IPv6 address family view)

Function

The import-rib command imports public network BGP routes or BGP routes in a specified VPN instance into a BGP-VPN instance routing table.

The undo import-rib command cancels the configuration.

By default, a device does not import public network BGP routes or BGP routes in a VPN instance into a BGP-VPN instance routing table.

Format

import-rib { public | vpn-instance vpn-instance-name } [ valid-route ] [ route-policy route-policy-name ]

undo import-rib { public | vpn-instance vpn-instance-name } [ valid-route ] [ route-policy route-policy-name ]

Parameters

Parameter Description Value
public

Imports routes from the public network BGP routing table.

-

vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters without spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

valid-route

Imports valid routes of a specified type. Valid routes include optimal routes, routes for load balancing, FRR routes, and reachable routes that are not selected for packet forwarding. If this parameter is not specified, only optimal routes, load balancing routes, and FRR routes can be imported.

-

route-policy route-policy-name

Specifies the name of a route-policy.

The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to import public network BGP routes into a BGP-VPN instance IPv6 routing table, run the import-rib public command in the BGP-VPN instance IPv6 address family view.

To configure a device to import BGP routes from a specified VPN instance into a BGP-VPN instance IPv6 routing table, run the import-rib vpn-instance command in the BGP-VPN instance IPv6 address family view.

Precautions

If the route-policy route-policy-name parameter is specified in the import-rib vpn-instance command, the if-match interface command configuration in the route-policy will not take effect.

The import-rib command configuration does not take effect for unlabeled routes that are leaked locally or remotely. Nor does this configuration take effect for the routes imported using the import-route command or network command.

Example

# Configure a device to import BGP routes from a public network to a specified VPN instance's BGP routing table.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] import-rib public

import-rib route next-hop-invariable

Function

The import-rib route next-hop-invariable command configures a VPN instance to retain the original next hops of imported routes when advertising these routes to its IBGP peers.

The undo import-rib route next-hop-invariable command restores the default configuration.

By default, a VPN instance changes the next hops of imported routes to its own next hop when advertising these routes to its IBGP peers.

Format

import-rib route next-hop-invariable

undo import-rib route next-hop-invariable

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a VPN instance to retain the original next hops of imported routes when advertising these routes to its IBGP peers, run the import-rib route next-hop-invariable command for the VPN instance.

Example

# Configure a VPN instance to retain the original next hops of imported routes when advertising these routes to its IBGP peers.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] import-rib route next-hop-invariable

import-rib route next-hop-invariable (BGP multi-instance VPN instance IPv4 address family view)

Function

The import-rib route next-hop-invariable command configures a VPN instance to retain the original next hops of imported routes when advertising these routes to its IBGP peers.

The undo import-rib route next-hop-invariable command restores the default configuration.

By default, a VPN instance changes the next hops of imported routes to its own next hop when advertising these routes to its IBGP peers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

import-rib route next-hop-invariable

undo import-rib route next-hop-invariable

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a VPN instance to retain the original next hops of imported routes when advertising these routes to its IBGP peers, run the import-rib route next-hop-invariable command for the VPN instance.

Example

# Configure a VPN instance to retain the original next hops of imported routes when advertising these routes to its IBGP peers.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] import-rib route next-hop-invariable

import-rib route next-hop-invariable (BGP-VPN instance IPv6 address family view)

Function

The import-rib route next-hop-invariable command configures a VPN instance to retain the original next hops of imported routes when advertising these routes to its IBGP peers.

The undo import-rib route next-hop-invariable command restores the default configuration.

By default, a VPN instance changes the next hops of imported routes to its own next hop when advertising these routes to its IBGP peers.

Format

import-rib route next-hop-invariable

undo import-rib route next-hop-invariable

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a VPN instance to retain the original next hops of imported routes when advertising these routes to its IBGP peers, run the import-rib route next-hop-invariable command for the VPN instance.

Example

# Configure a VPN instance to retain the original next hops of imported routes when advertising these routes to its IBGP peers.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] import-rib route next-hop-invariable

import-rib(BGP multi-instance VPN instance IPv4 address family view)

Function

The import-rib vpn-instance command imports BGP routes from a VPN instance into a BGP multi-instance VPN instance routing table.

The undo import-rib vpn-instance command cancels the configuration.

By default, a device does not import BGP routes from a VPN instance into a BGP multi-instance VPN instance routing table.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

import-rib { vpn-instance vpn-instance-name } [ valid-route ] [ route-policy route-policy-name ]

undo import-rib { vpn-instance vpn-instance-name } [ valid-route ] [ route-policy route-policy-name ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

valid-route

Imports valid routes of a specified type. Valid routes include optimal routes, routes for load balancing, FRR routes, and reachable routes that are not selected for packet forwarding. If this parameter is not specified, only optimal routes, load balancing routes, and FRR routes can be imported.

-

route-policy route-policy-name

Specifies a route-policy to filter routes to be imported.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to import BGP routes from a specified VPN instance into a BGP multi-instance VPN instance IPv4 routing table, run the import-rib vpn-instance command in the BGP multi-instance VPN instance IPv4 address family view.

If the valid-route parameter is specified in the import-rib vpn-instance command, all valid BGP routes in the specified VPN instance are imported. If the valid-route parameter is not specified, only active BGP routes among valid BGP routes are imported.

If you want imported BGP routes to be preferentially selected, specify the route-policy route-policy-name parameter so that the BGP attribute values in the routes to be imported can be changed as required using the specified route-policy.

Precautions

If the route-policy route-policy-name parameter is specified in the import-rib vpn-instance command, the if-match interface command configuration in the route-policy will not take effect.

The BGP IPv4 route import between public network and VPN instances does not take effect for non-labeled routes that are leaked remotely or locally or the routes that are imported in Import or Network mode.

Example

# Configure a device to import valid BGP routes from the public network instance to a VPN instance's BGP routing table.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] ip vpn-instance vpnb
[HUAWEI-vpn-instance-vpnb] ipv4-family
[HUAWEI-vpn-instance-vpnb-af-ipv4] route-distinguisher 100:2
[HUAWEI-vpn-instance-vpnb-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpnb-af-ipv4] quit
[HUAWEI-instance-vpnb] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] import-rib vpn-instance vpnb

import-route (BGP multi-instance VPN instance IPv4 address family view)

Function

The import-route command configures BGP to import routes from other protocols.

The undo import-route command cancels the configuration.

By default, BGP does not import routes from other protocols.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

import-route { static | direct } [ [ med med-value ] | [ route-policy route-policy-name ] ] *

undo import-route { static | direct }

Parameters

Parameter Description Value
static

Imports static routes.

-

direct

Imports direct routes.

-

med med-value

Specifies the MED for imported routes.

The value is an integer ranging from 0 to 4294967295.

route-policy route-policy-name

Specifies the route-policy used to filter routes and modify route attributes when these routes are imported from other protocols.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP can import routes using the import-route command or network command:

  • The import-route command imports routes of a specified type into the BGP routing table, such as RIP, OSPF, IS-IS, static, or direct routes.
  • The network command imports routes with the specified prefix and mask into the BGP routing table. Compared with the import-route command, the network command imports more specific routes.

Example

# Import static routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] import-route static

import-route (BGP multi-instance VPN instance IPv4 address family view) (route)

Function

The import-route command configures BGP to import routes from other protocols.

The undo import-route command cancels the configuration.

By default, BGP does not import routes from other protocols.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

import-route { { ospf | isis | rip } processId } [ [ med med-value ] | [ route-policy route-policy-name ] ] *

undo import-route { { ospf | isis | rip } processId }

Parameters

Parameter Description Value
med med-value

Specifies a MED value for imported routes.

The value is an integer ranging from 0 to 4294967295.

route-policy route-policy-name

Specifies the route-policy used to filter routes and modify route attributes when these routes are imported from other protocols.

The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

ospf

Imports OSPF routes.

-

isis

Imports IS-IS routes.

-

rip

Imports RIP routes.

-

processId

Specifies the ID of a process for matching.

The value is an integer ranging from 1 to 4294967295.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP can import routes using the import-route command or network command:

  • The import-route command imports routes of a specified protocol into the BGP routing table, such as RIP routes, OSPF routes, IS-IS routes, static routes, or direct routes.
  • Compared with the import-route command, the network command imports a route with the specified prefix and mask into the BGP routing table.

    Note:

    When the import-route static command is used to import static routes, only active routes can be imported.

Example

# Import routes from OSPF process 1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] import-route ospf 1

import-route (BGP view)

Function

The import-route command configures BGP to import routes from other protocols.

The undo import-route command cancels the configuration.

By default, BGP does not import routes from other protocols.

Format

import-route { ospf | isis | rip } process-id [ [ med med ] | [ route-policy route-policy-name ] ] *

undo import-route { rip | isis | ospf } process-id

Parameters

Parameter Description Value
rip

Configures MBGP to import RIP routes.

-

isis

Configures BGP to import IS-IS routes.

-

ospf

Configures BGP to import OSPF routes.

-

process-id

Specifies the ID of a process in which routes are to be filtered.

The value is an integer ranging from 1 to 4294967295.

med med

Specifies the MED for imported routes.

The value is an integer ranging from 0 to 4294967295.

route-policy route-policy-name

Specifies the route-policy used to filter routes and modify route attributes when these routes are imported from other protocols.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP can import routes using the import-route command or network command:

  • The import-route command imports routes of a specified type into the BGP routing table, such as RIP, OSPF, IS-IS, static, or direct routes.
  • The network command imports routes with the specified prefix and mask into the BGP routing table. Compared with the import-route command, the network command imports more specific routes.

Configuration Impact

If the default-route imported command has not been used when you run the import-route command to import routes from other protocols, BGP cannot import default routes.

Example

# Import routes from OSPF process 1.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] import-route ospf 1

import-route (BGP view) (Non-IGP)

Function

The import-route command configures BGP to import routes from other protocols.

The undo import-route command cancels the configuration.

By default, BGP does not import routes from other protocols.

Format

import-route { direct | static } [ [ med med ] | [ route-policy route-policy-name ] ] *

undo import-route { direct | static }

Parameters

Parameter Description Value
direct

Configures MBGP to import direct routes.

-

static

Imports static routes.

-

med med

Specifies the MED for imported routes.

The value is an integer ranging from 0 to 4294967295.

route-policy route-policy-name

Specifies the route-policy used to filter routes and modify route attributes when these routes are imported from other protocols.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP can import routes using the import-route command or network command:

  • The import-route command imports routes of a specified type into the BGP routing table, such as RIP, OSPF, IS-IS, static, or direct routes.
  • The network command imports routes with the specified prefix and mask into the BGP routing table. Compared with the import-route command, the network command imports more specific routes.

    NOTE:

    When the import-route static command is run, only active static routes are imported.

Example

# Import direct routes.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] import-route direct

import-route (BGP-IPv4 unicast address family view)

Function

The import-route command configures BGP to import routes from other protocols.

The undo import-route command cancels the configuration.

By default, BGP does not import routes from other protocols.

Format

import-route { ospf | isis | rip } process-id [ [ med med ] | [ route-policy route-policy-name ] ] *

undo import-route { ospf | isis | rip } process-id

Parameters

Parameter Description Value
ospf

Configures BGP to import OSPF routes.

-

isis

Configures BGP to import IS-IS routes.

-

rip

Configures MBGP to import RIP routes.

-

process-id

Specifies the ID of a process in which routes are to be filtered.

The value is an integer ranging from 1 to 4294967295.

med med

Specifies the MED for imported routes.

The value is an integer ranging from 0 to 4294967295.

route-policy route-policy-name

Specifies the route-policy used to filter routes and modify route attributes when these routes are imported from other protocols.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP can import routes using the import-route command or network command:

  • The import-route command imports routes of a specified type into the BGP routing table, such as RIP, OSPF, IS-IS, static, or direct routes.
  • The network command imports routes with the specified prefix and mask into the BGP routing table. Compared with the import-route command, the network command imports more specific routes.

Configuration Impact

If the default-route imported command has not been used when you run the import-route command to import routes from other protocols, BGP cannot import default routes.

Example

# Import routes from OSPF process 1.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] import-route ospf 1

import-route (BGP-IPv4 unicast address family view) (Non-IGP)

Function

The import-route command configures BGP to import routes from other protocols.

The undo import-route command cancels the configuration.

By default, BGP does not import routes from other protocols.

Format

import-route { direct | static } [ [ med med ] | [ route-policy route-policy-name ] ] *

undo import-route { direct | static }

Parameters

Parameter Description Value
direct

Configures MBGP to import direct routes.

-

static

Imports static routes.

-

med med

Specifies the MED for imported routes.

The value is an integer ranging from 0 to 4294967295.

route-policy route-policy-name

Specifies the route-policy used to filter routes and modify route attributes when these routes are imported from other protocols.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP can import routes using the import-route command or network command:

  • The import-route command imports routes of a specified type into the BGP routing table, such as RIP, OSPF, IS-IS, static, or direct routes.
  • The network command imports routes with the specified prefix and mask into the BGP routing table. Compared with the import-route command, the network command imports more specific routes.

    NOTE:

    When the import-route static command is run, only active static routes are imported.

Configuration Impact

If the default-route imported command has not been used when you run the import-route command to import routes from other protocols, BGP cannot import default routes.

Example

# Import static routes.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] import-route static

import-route (BGP-IPv6 unicast address family view)

Function

The import-route command configures BGP to import routes from other protocols.

The undo import-route command cancels the configuration.

By default, BGP does not import routes from other protocols.

Format

import-route { direct | static | { ospfv3 | isis | ripng } process-id } [ med med | route-policy route-policy-name ] *

undo import-route { direct | static | { ospfv3 | isis | ripng } process-id }

Parameters

Parameter Description Value
direct

Configures MBGP to import direct routes.

-

static

Imports static routes.

-

ospfv3

Configures BGP to import OSPFv3 routes.

-

isis

Configures BGP to import IS-IS routes.

-

ripng

Configures BGP to import RIPng routes.

-

process-id

Specifies the ID of a process in which routes are to be filtered.

The value is an integer ranging from 1 to 4294967295.

med med

Specifies the MED for imported routes.

The value is an integer ranging from 0 to 4294967295.

route-policy route-policy-name

Specifies the route-policy used to filter routes and modify route attributes when these routes are imported from other protocols.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP can import routes using the import-route command or network command:

  • The import-route command imports routes of a specified type into the BGP routing table, such as RIP, OSPF, IS-IS, static, or direct routes.
  • The network command imports routes with the specified prefix and mask into the BGP routing table. Compared with the import-route command, the network command imports more specific routes.

    NOTE:

    When the import-route static command is run, only active static routes are imported.

Configuration Impact

If the default-route imported command has not been used when you run the import-route command to import routes from other protocols, BGP cannot import default routes.

Example

# Import static routes.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] import-route static

import-route (BGP-VPN instance IPv4 address family view)

Function

The import-route command configures BGP to import routes from other protocols.

The undo import-route command cancels the configuration.

By default, BGP does not import routes from other protocols.

Format

import-route { ospf | isis | rip } process-id [ [ med med ] | [ route-policy route-policy-name ] ] *

undo import-route { ospf | isis | rip } process-id

Parameters

Parameter Description Value
ospf process-id

process-id Specifies the ID of an OSPF process.

The value is an integer ranging from 1 to 4294967295.

isis process-id

Specifies the ID of an IS-IS process.

The value is an integer ranging from 1 to 4294967295.

rip

Imports RIP routes.

-

med med

Specifies the MED for imported routes.

The value is an integer ranging from 0 to 4294967295.

route-policy route-policy-name

Specifies the route-policy used to filter routes and modify route attributes when these routes are imported from other protocols.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP can import routes using the import-route command or network command:

  • The import-route command imports routes of a specified type into the BGP routing table, such as RIP, OSPF, IS-IS, static, or direct routes.
  • The network command imports routes with the specified prefix and mask into the BGP routing table. Compared with the import-route command, the network command imports more specific routes.

    NOTE:

    When the import-route static command is run, only active static routes are imported.

Configuration Impact

If the default-route imported command has not been used when you run the import-route command to import routes from other protocols, BGP cannot import default routes.

Precautions

If load balancing routes are imported, only the first route in the IP routing table can be imported.

Example

# Import routes from OSPF process 1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] import-route ospf 1

import-route (BGP-VPN instance IPv4 address family view) (Non-IGP)

Function

The import-route command configures BGP to import routes from other protocols.

The undo import-route command cancels the configuration.

By default, BGP does not import routes from other protocols.

Format

import-route { static | direct } [ [ med med ] | [ route-policy route-policy-name ] ] *

undo import-route { static | direct }

Parameters

Parameter Description Value
static

Imports static routes.

-

direct

Configures MBGP to import direct routes.

-

med med

Specifies the MED for imported routes.

The value is an integer ranging from 0 to 4294967295.

route-policy route-policy-name

Specifies the route-policy used to filter routes and modify route attributes when these routes are imported from other protocols.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP can import routes using the import-route command or network command:

  • The import-route command imports routes of a specified type into the BGP routing table, such as RIP, OSPF, IS-IS, static, or direct routes.
  • The network command imports routes with the specified prefix and mask into the BGP routing table. Compared with the import-route command, the network command imports more specific routes.

    NOTE:

    When the import-route static command is run, only active static routes are imported.

Configuration Impact

If the default-route imported command has not been used when you run the import-route command to import routes from other protocols, BGP cannot import default routes.

Example

# Import static routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] import-route static

import-route (BGP-VPN instance IPv6 address family view)

Function

The import-route command configures BGP to import routes from other protocols.

The undo import-route command cancels the configuration.

By default, BGP does not import routes from other protocols.

Format

import-route { direct | static | { ospfv3 | isis | ripng } process-id } [ [ med med ] | [ route-policy route-policy-name ] ] *

undo import-route { direct | static | { ospfv3 | isis | ripng } process-id }

Parameters

Parameter Description Value
direct

Configures MBGP to import direct routes.

-

static

Imports static routes.

-

ospfv3

Configures BGP to import OSPFv3 routes.

-

isis

Configures BGP to import IS-IS routes.

-

ripng

Configures BGP to import RIPng routes.

-

process-id

Specifies the ID of a process in which routes are to be filtered.

The value is an integer ranging from 1 to 4294967295.

med med

Specifies the MED for imported routes.

The value is an integer ranging from 0 to 4294967295.

route-policy route-policy-name

Specifies the route-policy used to filter routes and modify route attributes when these routes are imported from other protocols.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP can import routes using the import-route command or network command:

  • The import-route command imports routes of a specified type into the BGP routing table, such as RIP, OSPF, IS-IS, static, or direct routes.
  • The network command imports routes with the specified prefix and mask into the BGP routing table. Compared with the import-route command, the network command imports more specific routes.

    NOTE:

    When the import-route static command is run, only active static routes are imported.

Configuration Impact

If the default-route imported command has not been used when you run the import-route command to import routes from other protocols, BGP cannot import default routes.

Example

# Import static routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] import-route static

ipv4 unicast (BMP session view)

Function

The ipv4 unicast command creates and displays the BMP session IPv4 unicast view.

The undo ipv4 unicast command deletes the BMP session IPv4 unicast view.

By default, the BMP session IPv4 unicast view does not exist.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

ipv4 unicast

undo ipv4 unicast

Parameters

None

Views

BMP session view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To create and enter the BMP session IPv4 unicast view, run the ipv4 unicast command in the BMP session view.

Follow-up Procedure

After this configuration is performed, you can run either of the following commands as needed:

  • trace-prefix ipv4-address mask-length: configures BMP to report the trace data of a specified IPv4 public network unicast route to the BMP server.
  • trace-prefix all: configures BMP to report the trace data of all IPv4 public network unicast routes to the BMP server.

Example

# Create and enter the BMP session IPv4 unicast view.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1
[HUAWEI-bmp-session-10.1.1.1] ipv4 unicast
[HUAWEI-bmp-session-10.1.1.1-ipv4-unicast]

ipv4 vpn (BMP session view)

Function

The ipv4 vpn command creates and displays the BMP session IPv4 VPN view.

The undo ipv4 vpn command deletes the BMP session IPv4 VPN view.

By default, the BMP session IPv4 VPN view does not exist.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

ipv4 vpn

undo ipv4 vpn

Parameters

None

Views

BMP session view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To create and enter the BMP session IPv4 VPN view, run the ipv4 vpn command in the BMP session view.

Follow-up Procedure

After this configuration is performed, you can run either of the following commands as needed:

  • trace-prefix route-distinguisher vrfRD ipv4-address mask-length: configures BMP to report the trace data of a specified VPNv4 route and the IPv4 VPN unicast route (transformed from the VPNv4 route) to the BMP server.
  • trace-prefix route-distinguisher vrfRD all: configures BMP to report the trace data of all VPNv4 routes and IPv4 VPN unicast routes (transformed from the VPNv4 routes) to the BMP server.

Example

# Create and enter the BMP session IPv4 VPN view.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1
[HUAWEI-bmp-session-10.1.1.1] ipv4 vpn
[HUAWEI-bmp-session-10.1.1.1-ipv4-vpn]

ipv4-family unicast

Function

The ipv4-family unicast command displays the BGP-IPv4 unicast address family.

By default, the BGP-IPv4 unicast address family view is displayed.

Format

ipv4-family unicast

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Before performing BGP configurations in an IPv4 address family, you need to run the ipv4-family command in the BGP view to enable the IPv4 address family and enter the address family view. By default, BGP uses the IPv4 unicast address family.

Configuration Impact

To disable the IPv4 unicast address family, run the undo default ipv4-unicast command.

Example

# Enter the BGP-IPv4 unicast address family view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4]

ipv4-family vpn-instance

Function

The ipv4-family vpn-instance command enables the BGP-VPN instance address family and displays the address family view.

The undo ipv4-family vpn-instance command deletes the configurations in the BGP-VPN instance address family.

By default, the BGP-VPN instance address family is disabled.

Format

ipv4-family vpn-instance vpn-instance-name

undo ipv4-family vpn-instance vpn-instance-name

Parameters

Parameter Description Value
vpn-instance-name

Associates a specified VPN instance with the BGP-IPv4 address family. You can enter the BGP-VPN instance address family view using the parameter.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Before performing BGP configurations in a BGP-VPN instance address family, you need to run the ipv4-family vpn-instance command in the BGP view to enable the BGP-VPN instance address family and enter the address family view. The configuration in this view takes effect for the IPv4 unicast routes and peers in the specified VPN instance.

Precautions

After the YANG management mode is enabled for a BGP VPN instance using the bgp yang-mode enable command, a VPN instance must have been created before you run the ipv4-family vpn-instance command.

If the YANG management mode is disabled for a BGP VPN instance, running the ipv4-family vpn-instance command does not depend on the creation of the VPN instance.

Example

# Enter the BGP-VPN instance IPv4 address family view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] vpn-target 100:1 both
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1]

ipv4-family vpn-instance (BGP multi-instance view)

Function

The ipv4-family vpn-instance command enables BGP multi-instance VPN instance IPv4 address family and displays the BGP multi-instance VPN instance IPv4 address family view.

The undo ipv4-family vpn-instance command deletes all configurations in the BGP multi-instance VPN instance IPv4 address family view.

By default, the BGP multi-instance VPN instance IPv4 address family is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

ipv4-family vpn-instance vpn-instance-name

undo ipv4-family vpn-instance vpn-instance-name

Parameters

Parameter Description Value
vpn-instance-name

Associates a specified VPN instance with the IPv4 address family. This parameter displays the BGP multi-instance VPN instance IPv4 address family view.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Before performing configurations in the BGP multi-instance VPN instance IPv4 address family view, run the ipv4-family vpn-instance command in the BGP view to enable the BGP multi-instance VPN instance IPv4 address family and enter the address family view.

Precautions

If you attempt to configure the IPv4 VPN address family view in the BGP multi-instance view and MVPN services have been configured for the VPN instance, the configuration fails.

Example

# Enter the BGP multi-instance VPN instance IPv4 address family view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vrf1
[HUAWEI-vpn-instance-vrf1] ipv4-family
[HUAWEI-vpn-instance-vrf1-af-ipv4] route-distinguisher 1:1
[HUAWEI-vpn-instance-vrf1-af-ipv4] vpn-target 100:1 both
[HUAWEI-vpn-instance-vrf1-af-ipv4] quit
[HUAWEI-vpn-instance-vrf1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1

ipv6-family

Function

The ipv6-family command enables and enters the IPv6 address family view of BGP.

The undo ipv6-family command disables the IPv6 address family view and deletes the configurations in the view.

By default, the IPv6 address family view of BGP is disabled.

Format

ipv6-family unicast

ipv6-family

undo ipv6-family [ unicast ]

Parameters

Parameter Description Value
unicast

Displays the unicast address family view.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If no VPN instance is specified in the command, the IPv6 address family view is displayed by default.

Configuration Impact

The undo ipv6-family command with no VPN instance specified deletes all IPv6 unicast address family configurations.

Example

# Enter the BGP-IPv6 unicast address family view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6]

ipv6-family vpn-instance (BGP multi-instance view)

Function

The ipv6-family vpn-instance command enables and enters the IPv6 address family view of BGP multi-instance VPN instance.

The undo ipv6-family vpn-instance command disables the IPv6 address family view of BGP multi-instance VPN instance and deletes the configurations in the view.

By default, the IPv6 address family view of BGP multi-instance VPN instance is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

ipv6-family vpn-instance vpn-instance-name

undo ipv6-family vpn-instance vpn-instance-name

Parameters

Parameter Description Value
vpn-instance-name

Associates a specified VPN instance with the IPv6 address family. You can enter the IPv6 address family view of BGP multi-instance VPN instance using the parameter.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Before performing configurations in the BGP multi-instance VPN instance IPv6 address family view, you must run the ipv6-family vpn-instance command in the BGP multi-instance view to enable the BGP multi-instance VPN instance IPv6 address family view and enter the address family view.

Example

# Enter the IPv6 address family view of BGP multi-instance VPN instance.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] vpn-target 100:1 both
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-instance-a-6-vpn1]

ipv6-family vpn-instance (BGP view)

Function

The ipv6-family vpn-instance command enables a BGP-VPN instance IPv6 address family and displays the BGP-VPN instance IPv6 address family view.

The undo ipv6-family vpn-instance command disables the BGP-VPN instance IPv6 address family view and deletes all configurations in the view.

By default, the IPv6 address family view of BGP is disabled.

Format

ipv6-family vpn-instance vpn-instance-name

undo ipv6-family vpn-instance vpn-instance-name

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Associates a specified VPN instance with the IPv6 address family. You can enter the BGP-VPN instance IPv6 address family view using the parameter.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If no VPN instance is specified in the command, the IPv6 address family view is displayed by default.

Configuration Impact

The undo ipv6-family command with no VPN instance specified deletes all IPv6 unicast address family configurations.

Precautions

If the YANG management mode is enabled for BGP VPN instances using the bgp yang-mode enable command, the ipv6-family vpn-instance command can be run only after a VPN instance is created.

If the YANG management mode is disabled for BGP VPN instances, running the ipv6-family vpn-instance command does not depend on the creation of VPN instances.

Example

# Enter the BGP VPN instance IPv6 address family view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna]

irb asymmetric (BGP multi-instance VPN instance IPv4 address family view)

Function

The irb asymmetric command enables the asymmetric mode for IRB routes.

The undo irb asymmetric command restores the default configuration.

By default, the asymmetric mode is disabled for IRB routes.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

irb asymmetric [ route-policy route-policy-name ]

undo irb asymmetric [ route-policy route-policy-name ]

Parameters

Parameter Description Value
route-policy route-policy-name

Specifies the name of a route-policy. After this parameter is specified, the asymmetric IRB function takes effect only for the routes to which the route-policy applies.

The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, a device generates an IP prefix route based on the IP address in an IRB route that it has received from a BGP EVPN peer. IP prefix routes can be used for Layer 3 traffic forwarding. If Layer 2 forwarding is required, run the irb asymmetric command to enable the asymmetric mode for IRB routes. Specifically, after this configuration is performed, the device does not generate IP prefix routes after receiving IRB routes.

Example

# Enable the asymmetric mode for IRB routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100 instance a1
[HUAWEI-bgp-instance-a1] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a1-vpna] irb asymmetric

keep-all-routes

Function

The keep-all-routes command saves all the routes carried in BGP Update messages advertised by BGP peers or peer groups after BGP connections are established.

The undo keep-all-routes command disables this function.

By default, the device saves only accepted routes (routes that match the import policy).

Format

keep-all-routes

undo keep-all-routes

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you must reset BGP connections for the new import policy to take effect. As a result, services on these BGP connections are interrupted temporarily. If a device's peer does not support route-refresh, you can run the keep-all-routes command on the device to save all routing updates received from the peer so that the device can refresh its routing table without resetting the connection with the peer.

Precautions

If the device does not support the route-refresh capability, you need to run this command on both the local device and its peer. After the keep-all-routes command is run for the first time, the sessions between the local device and its peers are reestablished.

If the device supports the route-refresh capability, running this command does not cause the sessions between the device and its peers to be reestablished. However, updating the routing table using the refresh bgp command does not take effect on the device.

After the keep-all-routes command is run in the BGP view, the configuration of the peer keep-all-routes command is overwritten by the keep-all-routes configuration in the BGP view.

After the keep-all-routes command is run in the BGP view, this function takes effect only in the BGP-IPv4 unicast address family, BGP-VPN instance IPv4 address family, BGP-IPv6 unicast address family, BGP-VPN instance IPv6 address family, BGP-IPv4 multicast address family, BGP-VPNv4 address family, and BGP-VPNv6 address family.

Example

# Configure a device to save all BGP routing updates received from its peers.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] keep-all-routes

load-balancing (BGP view)

Function

The load-balancing as-path-ignore command configures a router not to compare the AS_Path attributes of routes that are to be used for load balancing.

The undo load-balancing as-path-ignore command cancels the configuration.

The load-balancing as-path-relax command configures BGP to compare only the AS_Path lengths of the routes to be used for load balancing. Routes with different AS-Path attributes can form equal-cost routes as long as the AS-Path lengths of the routes are the same.

The undo load-balancing as-path-relax command cancels the configuration.

By default, a device compares the AS_Path attributes of the routes to be used for load balancing.

Format

load-balancing { as-path-ignore | as-path-relax }

undo load-balancing { as-path-ignore | as-path-relax }

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When load balancing is performed among routes, the device processes the AS_Path attribute as follows:

  • Load balancing can be implemented only when the AS_Path attributes are the same.
  • Ignores the AS_Path attributes. You can run the load-balancing as-path-ignore command to configure the device to ignore the AS_Path attributes. After this command is run, the device does not compare the AS_Path attributes (including the AS_Path length and content) of routes when selecting the routes used for load balancing. That is, load balancing can be performed even if the AS_Path attributes of the routes are different. This changes the conditions for load balancing. Therefore, exercise caution when running this command.
  • Ignores the AS_Path content and compares only the AS_Path lengths. You can run the load-balancing as-path-relax command to configure the device to compare the AS_Path lengths. After this command is run, the device compares only the AS_Path lengths of the routes to be used for load balancing. Load balancing can be implemented as long as the AS_Path lengths are the same. If the AS_Path lengths are different, load balancing cannot be implemented. For example, the AS_Path attribute of route A is 10 and that of route B is 10 20. The AS_Path lengths of route A and route B are different. In this case, load balancing cannot be implemented.

    The load-balancing as-path-relax command is mainly used in BGP route load balancing scenarios. Exercise caution when running this command because it will change the conditions for load balancing.

Precautions

The load-balancing as-path-ignore and bestroute as-path-ignore commands are mutually exclusive. That is, the load-balancing as-path-ignore command cannot be configured after the bestroute as-path-ignore command is configured.

If you run both the load-balancing as-path-relax and load-balancing as-path-ignore commands, the latest configuration overrides the previous one.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but as-path-ignore or as-path-relax is not specified in the peer load-balancing command, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignore or as-path-relax is specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Configure a device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] load-balancing as-path-relax

load-balancing (BGP-IPv4 unicast address family view)

Function

The load-balancing as-path-ignore command configures a router not to compare the AS_Path attributes of routes that are to be used for load balancing.

The undo load-balancing as-path-ignore command cancels the configuration.

The load-balancing as-path-relax command configures BGP to compare only the AS_Path lengths of the routes to be used for load balancing. Routes with different AS-Path attributes can form equal-cost routes as long as the AS-Path lengths of the routes are the same.

The undo load-balancing as-path-relax command cancels the configuration.

By default, a device compares the AS_Path attributes of the routes to be used for load balancing.

Format

load-balancing { as-path-ignore | as-path-relax }

undo load-balancing { as-path-ignore | as-path-relax }

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When load balancing is performed among routes, the device processes the AS_Path attribute as follows:

  • Load balancing can be implemented only when the AS_Path attributes are the same.
  • Ignores the AS_Path attributes. You can run the load-balancing as-path-ignore command to configure the device to ignore the AS_Path attributes. After this command is run, the device does not compare the AS_Path attributes (including the AS_Path length and content) of routes when selecting the routes used for load balancing. That is, load balancing can be performed even if the AS_Path attributes of the routes are different. This changes the conditions for load balancing. Therefore, exercise caution when running this command.
  • Ignores the AS_Path content and compares only the AS_Path lengths. You can run the load-balancing as-path-relax command to configure the device to compare the AS_Path lengths. After this command is run, the device compares only the AS_Path lengths of the routes to be used for load balancing. Load balancing can be implemented as long as the AS_Path lengths are the same. If the AS_Path lengths are different, load balancing cannot be implemented. For example, the AS_Path attribute of route A is 10 and that of route B is 10 20. The AS_Path lengths of route A and route B are different. In this case, load balancing cannot be implemented.

    The load-balancing as-path-relax command is mainly used in BGP route load balancing scenarios. Exercise caution when running this command because it will change the conditions for load balancing.

Precautions

The load-balancing as-path-ignore and bestroute as-path-ignore commands are mutually exclusive. That is, the load-balancing as-path-ignore command cannot be configured after the bestroute as-path-ignore command is configured.

If you run both the load-balancing as-path-relax and load-balancing as-path-ignore commands, the latest configuration overrides the previous one.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but as-path-ignore or as-path-relax is not specified in the peer load-balancing command, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignore or as-path-relax is specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Prevent a router from comparing the AS_Path attributes of routes when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] load-balancing as-path-ignore
# Configure a device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] load-balancing as-path-relax

load-balancing (BGP-IPv6 unicast address family view)

Function

The load-balancing as-path-ignore command configures a router not to compare the AS_Path attributes of routes that are to be used for load balancing.

The undo load-balancing as-path-ignore command cancels the configuration.

The load-balancing as-path-relax command configures BGP to compare only the AS_Path lengths of the routes to be used for load balancing. Routes with different AS-Path attributes can form equal-cost routes as long as the AS-Path lengths of the routes are the same.

The undo load-balancing as-path-relax command cancels the configuration.

By default, a device compares the AS_Path attributes of the routes to be used for load balancing.

Format

load-balancing { as-path-ignore | as-path-relax }

undo load-balancing { as-path-ignore | as-path-relax }

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When load balancing is performed among routes, the device processes the AS_Path attribute as follows:

  • Load balancing can be implemented only when the AS_Path attributes are the same.
  • Ignores the AS_Path attributes. You can run the load-balancing as-path-ignore command to configure the device to ignore the AS_Path attributes. After this command is run, the device does not compare the AS_Path attributes (including the AS_Path length and content) of routes when selecting the routes used for load balancing. That is, load balancing can be performed even if the AS_Path attributes of the routes are different. This changes the conditions for load balancing. Therefore, exercise caution when running this command.
  • Ignores the AS_Path content and compares only the AS_Path lengths. You can run the load-balancing as-path-relax command to configure the device to compare the AS_Path lengths. After this command is run, the device compares only the AS_Path lengths of the routes to be used for load balancing. Load balancing can be implemented as long as the AS_Path lengths are the same. If the AS_Path lengths are different, load balancing cannot be implemented. For example, the AS_Path attribute of route A is 10 and that of route B is 10 20. The AS_Path lengths of route A and route B are different. In this case, load balancing cannot be implemented.

    The load-balancing as-path-relax command is mainly used in BGP route load balancing scenarios. Exercise caution when running this command because it will change the conditions for load balancing.

Precautions

The load-balancing as-path-ignore and bestroute as-path-ignore commands are mutually exclusive. That is, the load-balancing as-path-ignore command cannot be configured after the bestroute as-path-ignore command is configured.

If you run both the load-balancing as-path-relax and load-balancing as-path-ignore commands, the latest configuration overrides the previous one.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but as-path-ignore or as-path-relax is not specified in the peer load-balancing command, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignore or as-path-relax is specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Configure a device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] load-balancing as-path-relax

load-balancing (BGP-VPN instance IPv4 address family view)

Function

The load-balancing as-path-ignore command configures a router not to compare the AS_Path attributes of routes that are to be used for load balancing.

The undo load-balancing as-path-ignore command cancels the configuration.

The load-balancing as-path-relax command configures BGP to compare only the AS_Path lengths of the routes to be used for load balancing. Routes with different AS-Path attributes can form equal-cost routes as long as the AS-Path lengths of the routes are the same.

The undo load-balancing as-path-relax command cancels the configuration.

By default, a device compares the AS_Path attributes of the routes to be used for load balancing.

Format

load-balancing { as-path-ignore | as-path-relax }

undo load-balancing { as-path-ignore | as-path-relax }

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When load balancing is performed among routes, the device processes the AS_Path attribute as follows:

  • Load balancing can be implemented only when the AS_Path attributes are the same.
  • Ignores the AS_Path attributes. You can run the load-balancing as-path-ignore command to configure the device to ignore the AS_Path attributes. After this command is run, the device does not compare the AS_Path attributes (including the AS_Path length and content) of routes when selecting the routes used for load balancing. That is, load balancing can be performed even if the AS_Path attributes of the routes are different. This changes the conditions for load balancing. Therefore, exercise caution when running this command.
  • Ignores the AS_Path content and compares only the AS_Path lengths. You can run the load-balancing as-path-relax command to configure the device to compare the AS_Path lengths. After this command is run, the device compares only the AS_Path lengths of the routes to be used for load balancing. Load balancing can be implemented as long as the AS_Path lengths are the same. If the AS_Path lengths are different, load balancing cannot be implemented. For example, the AS_Path attribute of route A is 10 and that of route B is 10 20. The AS_Path lengths of route A and route B are different. In this case, load balancing cannot be implemented.

    The load-balancing as-path-relax command is mainly used in BGP route load balancing scenarios. Exercise caution when running this command because it will change the conditions for load balancing.

Precautions

The load-balancing as-path-ignore and bestroute as-path-ignore commands are mutually exclusive. That is, the load-balancing as-path-ignore command cannot be configured after the bestroute as-path-ignore command is configured.

If you run both the load-balancing as-path-relax and load-balancing as-path-ignore commands, the latest configuration overrides the previous one.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but as-path-ignore or as-path-relax is not specified in the peer load-balancing command, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignore or as-path-relax is specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Configure a device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] load-balancing as-path-relax

load-balancing (BGP-VPN instance IPv6 address family view)

Function

The load-balancing as-path-ignore command configures a router not to compare the AS_Path attributes of routes that are to be used for load balancing.

The undo load-balancing as-path-ignore command cancels the configuration.

The load-balancing as-path-relax command configures BGP to compare only the AS_Path lengths of the routes to be used for load balancing. Routes with different AS-Path attributes can form equal-cost routes as long as the AS-Path lengths of the routes are the same.

The undo load-balancing as-path-relax command cancels the configuration.

By default, a device compares the AS_Path attributes of the routes to be used for load balancing.

Format

load-balancing { as-path-ignore | as-path-relax }

undo load-balancing { as-path-ignore | as-path-relax }

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When load balancing is performed among routes, the device processes the AS_Path attribute as follows:

  • Load balancing can be implemented only when the AS_Path attributes are the same.
  • Ignores the AS_Path attributes. You can run the load-balancing as-path-ignore command to configure the device to ignore the AS_Path attributes. After this command is run, the device does not compare the AS_Path attributes (including the AS_Path length and content) of routes when selecting the routes used for load balancing. That is, load balancing can be performed even if the AS_Path attributes of the routes are different. This changes the conditions for load balancing. Therefore, exercise caution when running this command.
  • Ignores the AS_Path content and compares only the AS_Path lengths. You can run the load-balancing as-path-relax command to configure the device to compare the AS_Path lengths. After this command is run, the device compares only the AS_Path lengths of the routes to be used for load balancing. Load balancing can be implemented as long as the AS_Path lengths are the same. If the AS_Path lengths are different, load balancing cannot be implemented. For example, the AS_Path attribute of route A is 10 and that of route B is 10 20. The AS_Path lengths of route A and route B are different. In this case, load balancing cannot be implemented.

    The load-balancing as-path-relax command is mainly used in BGP route load balancing scenarios. Exercise caution when running this command because it will change the conditions for load balancing.

Precautions

The load-balancing as-path-ignore and bestroute as-path-ignore commands are mutually exclusive. That is, the load-balancing as-path-ignore command cannot be configured after the bestroute as-path-ignore command is configured.

If you run both the load-balancing as-path-relax and load-balancing as-path-ignore commands, the latest configuration overrides the previous one.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but as-path-ignore or as-path-relax is not specified in the peer load-balancing command, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignore or as-path-relax is specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Configure a device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] load-balancing as-path-relax
# Prevent a router from comparing the AS_Path attributes of routes when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] load-balancing as-path-ignore

load-balancing eibgp(BGP-VPN instance IPv4 address family view)

Function

The load-balancing eibgp command enables load balancing among EBGP and IBGP routes.

The undo load-balancing eibgp command disables load balancing among EBGP and IBGP routes.

The load-balancing igp-metric-ignore command prevents a router from comparing IGP cost when selecting routes for load balancing.

The undo load-balancing igp-metric-ignore command restores the default configuration.

By default, load balancing can be implemented only between IBGP or EBGP routes. The IGP metric of the routes is compared when load balancing is implemented.

Format

load-balancing { eibgp | igp-metric-ignore }

undo load-balancing { eibgp | igp-metric-ignore }

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the load-balancing eibgp command is run, load balancing can be performed among EBGP and IBGP routes.

The load-balancing eibgp command is used when EBGP and IBGP routes coexist on a device and load balancing needs to be implemented among the EBGP and IBGP routes. This command will change the conditions for load balancing among routes. Therefore, exercise caution when running this command.

After the load-balancing igp-metric-ignore command is run, the device does not compare the IGP costs of the routes to be used for load balancing.

The load-balancing igp-metric-ignore command is mainly used when routes with different IGP metrics exist on a device and load balancing needs to be implemented among these routes. Running this command will change the conditions for load balancing among routes. Therefore, exercise caution when running this command.

Example

# Prevent a router from comparing IGP costs when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 22:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 5:5 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] load-balancing igp-metric-ignore

load-balancing eibgp(BGP-VPN instance IPv6 address family view)

Function

The load-balancing eibgp command enables load balancing among EBGP and IBGP routes.

The undo load-balancing eibgp command disables load balancing among EBGP and IBGP routes.

The load-balancing igp-metric-ignore command prevents a router from comparing IGP cost when selecting routes for load balancing.

The undo load-balancing igp-metric-ignore command restores the default configuration.

By default, load balancing can be implemented only between IBGP or EBGP routes. The IGP metric of the routes is compared when load balancing is implemented.

Format

load-balancing { eibgp | igp-metric-ignore }

undo load-balancing { eibgp | igp-metric-ignore }

Parameters

None

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable load balancing among EBGP and IBGP routes, run the load-balancing eibgp command.

When both EBGP and IBGP routes are available and load balancing among them is required, run the load-balancing eibgp command. Exercise caution when using the command because the execution of this command will change the conditions of load balancing.

To prevent a router from comparing IGP costs when selecting routes for load balancing, run the load-balancing igp-metric-ignore command.

When routes with different IGP costs are available and load balancing among them is required, run the load-balancing igp-metric-ignore command. Exercise caution when using the command because the execution of this command will change the conditions of load balancing.

Example

# Enable load balancing among EBGP and IBGP routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] load-balancing eibgp
# Prevent a router from comparing IGP costs when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] load-balancing igp-metric-ignore

load-balancing igp-metric-ignore (BGP view)

Function

The load-balancing igp-metric-ignore command prevents a router from comparing IGP costs when selecting routes for load balancing.

The undo load-balancing igp-metric-ignore command restores the default configuration.

By default, a device compares IGP costs when selecting routes for load balancing.

Format

load-balancing igp-metric-ignore

undo load-balancing igp-metric-ignore

Parameters

None

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To prevent a router from comparing IGP costs when selecting routes for load balancing, run the load-balancing igp-metric-ignore command.

When routes with different IGP costs are available and load balancing among them is required, run the command. Exercise caution when using the command because the execution of this command will change the conditions of load balancing.

Example

# Prevent a router from comparing IGP costs when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] load-balancing igp-metric-ignore

load-balancing igp-metric-ignore (BGP-IPv6 unicast address family view)

Function

The load-balancing igp-metric-ignore command prevents a router from comparing IGP costs when selecting routes for load balancing.

The undo load-balancing igp-metric-ignore command restores the default configuration.

By default, a device compares IGP costs when selecting routes for load balancing.

Format

load-balancing igp-metric-ignore

undo load-balancing igp-metric-ignore

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To prevent a router from comparing IGP costs when selecting routes for load balancing, run the load-balancing igp-metric-ignore command.

When routes with different IGP costs are available and load balancing among them is required, run the command. Exercise caution when using the command because the execution of this command will change the conditions of load balancing.

Example

# Prevent a router from comparing IGP costs when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] load-balancing igp-metric-ignore

load-balancing(BGP multi-instance VPN instance IPv4 address family view)(as-path)

Function

The load-balancing as-path-ignore command configures a router not to compare the AS_Path attributes of routes that are to be used for load balancing.

The undo load-balancing as-path-ignore command cancels the configuration.

The load-balancing as-path-relax command configures BGP to compare only the AS_Path lengths of the routes to be used for load balancing. Routes with different AS-Path attributes can form equal-cost routes as long as the AS-Path lengths of the routes are the same.

The undo load-balancing as-path-relax command cancels the configuration.

By default, a device compares the AS_Path attributes of the routes to be used for load balancing.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

load-balancing { as-path-ignore | as-path-relax }

undo load-balancing { as-path-ignore | as-path-relax }

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When load balancing is performed among routes, the device processes the AS_Path attribute as follows:

  • Load balancing can be implemented only when the AS_Path attributes are the same.
  • Ignores the AS_Path attributes. You can run the load-balancing as-path-ignore command to configure the device to ignore the AS_Path attributes. After this command is run, the device does not compare the AS_Path attributes (including the AS_Path length and content) of routes when selecting the routes used for load balancing. That is, load balancing can be performed even if the AS_Path attributes of the routes are different. This changes the conditions for load balancing. Therefore, exercise caution when running this command.
  • Ignores the AS_Path content and compares only the AS_Path lengths. You can run the load-balancing as-path-relax command to configure the device to compare the AS_Path lengths. After this command is run, the device compares only the AS_Path lengths of the routes to be used for load balancing. Load balancing can be implemented as long as the AS_Path lengths are the same. If the AS_Path lengths are different, load balancing cannot be implemented. For example, the AS_Path attribute of route A is 10 and that of route B is 10 20. The AS_Path lengths of route A and route B are different. In this case, load balancing cannot be implemented.

    The load-balancing as-path-relax command is mainly used in BGP route load balancing scenarios. Exercise caution when running this command because it will change the conditions for load balancing.

Precautions

The load-balancing as-path-ignore and bestroute as-path-ignore commands are mutually exclusive. That is, the load-balancing as-path-ignore command cannot be configured after the bestroute as-path-ignore command is configured.

If you run both the load-balancing as-path-relax and load-balancing as-path-ignore commands, the latest configuration overrides the previous one.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but as-path-ignore or as-path-relax is not specified in the peer load-balancing command, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignore or as-path-relax is specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Prevent a router from comparing the AS_Path attributes of routes when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] load-balancing as-path-ignore
# Configure a device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] load-balancing as-path-relax

maximum load-balancing (BGP multi-instance VPN instance IPv4 address family view)

Function

The maximum load-balancing command configures the maximum number of equal-cost routes for load balancing.

The undo maximum load-balancing command restores the default setting.

By default, the maximum number of equal-cost routes for load balancing is 1, and load balancing is not implemented.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

maximum load-balancing number

maximum load-balancing ebgp ebgpNumber

maximum load-balancing ibgp ibgpNumber

maximum load-balancing number ecmp-nexthop-changed

maximum load-balancing ebgp ebgpNumber ecmp-nexthop-changed

maximum load-balancing ibgp ibgpNumber ecmp-nexthop-changed

undo maximum load-balancing

undo maximum load-balancing ebgp

undo maximum load-balancing ibgp

Parameters

Parameter Description Value
number

Specifies the maximum number of equal-cost routes for load balancing.

The value is an integer ranging from 1 to 32.

ebgp ebgpNumber

Specifies the maximum number of equal-cost EBGP routes for load balancing.

The value is an integer ranging from 1 to 32.

ibgp ibgpNumber

Specifies the maximum number of equal-cost IBGP routes for load balancing.

The value is an integer ranging from 1 to 32.

ecmp-nexthop-changed

Configures a BGP device to change the next hop addresses of routes for load balancing to its address only when the device advertises these routes.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After this command is run, multiple BGP equal-cost routes will implement load balancing, improving network resource efficiency.

After this command is run, the routes that meet the following conditions will become equal-cost routes and implement load balancing:

  • The original next hops are different.
  • The PrefVal values are the same.
  • Local_Pref values are the same.
  • All routes are summary routes or none of them are summary routes.
  • Origin types (IGP, EGP, and Incomplete) are the same.
  • The MED values are the same.
  • All routes are EBGP or IBGP routes.
  • The IGP metric values within an AS are the same.
  • The AS_Path attributes are the same.

    For BGP routes with the same prefix in the routing table:
  • If the optimal routes are labeled routes, the routes selected for load balancing are also labeled routes. The number of routes for load balancing is determined by the maximum load-balancing ingress-lsp or maximum load-balancing transit-lsp command.
  • If the optimal route is a common route, the routes selected for load balancing are also common routes, and the maximum number of routes for load balancing is determined by the maximum load-balancing command.

    When load balancing is performed among BGP labeled routes, ingress LSPs are created for the labeled routes if the routes meet the conditions for creating ingress LSPs. When load balancing is performed among BGP labeled routes, transit LSPs are created for the labeled routes if the routes meet the conditions for creating transit LSPs.

    After the maximum load-balancing ebgp command is run, only EBGP routes implement load balancing. After the maximum load-balancing ibgp command is run, only IBGP routes implement load balancing. If [ ebgp | ibgp ] is not specified, both EBGP and IBGP routes can carry out load balancing, and the number of EBGP routes for load balancing is the same as the number of IBGP routes for load balancing.

    By default, after the maximum load-balancing command is run, a BGP device changes the next hop of a route to itself before advertising the route to a peer, regardless of whether the route is used for load balancing. After ecmp-nexthop-changed is set, a BGP device changes the next-hop of only routes that participate in load balancing to itself before advertising them to peers and keeps the next-hop of the routes that do not participate in load balancing unchanged.

    Note:

    After the maximum load-balancing command is run, the device changes the next hop addresses of the routes to be advertised to a local address, regardless of whether the routes are used for load balancing. However, in RR and BGP confederation scenarios, the device does not change the next hop address of non-local routes to the local address.

    After the maximum load-balancing { ebgp | ibgp } command is run, the device does not forcibly change the next hop addresses of the routes to be advertised to a local address, regardless of whether the routes are used for load balancing.

    After the maximum load-balancing [ ebgp | ibgp ] ecmp-nexthop-changed command is run, the device changes the next hop addresses of the routes to be advertised to a local address only when the routes are used for load balancing. When advertising the routes that are not used for load balancing, the device does not process the next hops of these routes. That is, the original next hop of these routes is the same as the next hop of the routes that are advertised when load balancing is not configured.

    In the Add-Path scenario, the next hop of Add-Path routes is processed in the same way as that of optimal routes, regardless of whether Add-Path routes are used for load balancing.

Configuration Impact

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

Precautions

If the maximum load-balancing command has been configured, the maximum load-balancing ebgp or maximum load-balancing ibgp command configuration does not take effect. If the maximum load-balancing ebgp or maximum load-balancing ibgp command has been configured, the maximum load-balancing command configuration does not take effect.

If either the ebgp or the ibgp parameter is configured in the maximum load-balancing command, this parameter must be also configured in the undo maximum load-balancing command when deleting load balancing.

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

Example

# Set two equal-cost routes to a specified destination.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] maximum load-balancing 2

maximum load-balancing (BGP view)

Function

The maximum load-balancing command configures the maximum number of equal-cost routes for load balancing.

The undo maximum load-balancing command restores the default setting.

By default, the maximum number of equal-cost routes for load balancing is 1, and load balancing is not implemented.

Format

maximum load-balancing number

maximum load-balancing ebgp ebgpNumber

maximum load-balancing ibgp ibgpNumber

maximum load-balancing number ecmp-nexthop-changed

maximum load-balancing ebgp ebgpNumber ecmp-nexthop-changed

maximum load-balancing ibgp ibgpNumber ecmp-nexthop-changed

undo maximum load-balancing

undo maximum load-balancing ebgp

undo maximum load-balancing ibgp

Parameters

Parameter Description Value
number

Specifies the maximum number of equal-cost routes for load balancing.

The value is an integer ranging from 1 to 32.

ebgp ebgpNumber

Specifies the maximum number of equal-cost EBGP routes for load balancing.

The value is an integer ranging from 1 to 32.

ibgp ibgpNumber

Specifies the maximum number of equal-cost IBGP routes for load balancing.

The value is an integer ranging from 1 to 32.

ecmp-nexthop-changed

Configures the device to change the next hop addresses of only the routes that carry out load balancing to its address.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After this command is run, multiple BGP equal-cost routes will implement load balancing, improving network resource efficiency.

After this command is run, the routes that meet the following conditions will become equal-cost routes and implement load balancing:

  • The original next hops are different.
  • The PrefVal values are the same.
  • Local_Pref values are the same.
  • All routes are summary routes or none of them are summary routes.
  • Origin types (IGP, EGP, and Incomplete) are the same.
  • The MED values are the same.
  • All routes are EBGP or IBGP routes.
  • The IGP metric values within an AS are the same.
  • The AS_Path attributes are the same.

    For BGP routes with the same prefix in the routing table:
  • If the optimal routes are labeled routes, the routes selected for load balancing are also labeled routes. The number of routes for load balancing is determined by the maximum load-balancing ingress-lsp or maximum load-balancing transit-lsp command.
  • If the optimal route is a common route, the routes selected for load balancing are also common routes, and the maximum number of routes for load balancing is determined by the maximum load-balancing command.

    When load balancing is performed among BGP labeled routes, ingress LSPs are created for the labeled routes if the routes meet the conditions for creating ingress LSPs. When load balancing is performed among BGP labeled routes, transit LSPs are created for the labeled routes if the routes meet the conditions for creating transit LSPs.

    After the maximum load-balancing ebgp command is run, only EBGP routes implement load balancing. After the maximum load-balancing ibgp command is run, only IBGP routes implement load balancing. If [ ebgp | ibgp ] is not specified, both EBGP and IBGP routes can carry out load balancing, and the number of EBGP routes for load balancing is the same as the number of IBGP routes for load balancing.

    By default, after the maximum load-balancing command is run, a BGP device changes the next hop of a route to itself before advertising the route to a peer, regardless of whether the route is used for load balancing. After ecmp-nexthop-changed is set, a BGP device changes the next-hop of only routes that participate in load balancing to itself before advertising them to peers and keeps the next-hop of the routes that do not participate in load balancing unchanged.

    Note:

    After the maximum load-balancing command is run, the device changes the next hop addresses of the routes to be advertised to a local address, regardless of whether the routes are used for load balancing. However, in RR and BGP confederation scenarios, the device does not change the next hop address of non-local routes to the local address.

    After the maximum load-balancing { ebgp | ibgp } command is run, the device does not forcibly change the next hop addresses of the routes to be advertised to a local address, regardless of whether the routes are used for load balancing.

    After the maximum load-balancing [ ebgp | ibgp ] ecmp-nexthop-changed command is run, the device changes the next hop addresses of the routes to be advertised to a local address only when the routes are used for load balancing. When advertising the routes that are not used for load balancing, the device does not process the next hops of these routes. That is, the original next hop of these routes is the same as the next hop of the routes that are advertised when load balancing is not configured.

    In the Add-Path scenario, the next hop of Add-Path routes is processed in the same way as that of optimal routes, regardless of whether Add-Path routes are used for load balancing.

Configuration Impact

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

Precautions

If the maximum load-balancing command has been configured, the maximum load-balancing ebgp or maximum load-balancing ibgp command configuration does not take effect. If the maximum load-balancing ebgp or maximum load-balancing ibgp command has been configured, the maximum load-balancing command configuration does not take effect.

If either the ebgp or the ibgp parameter is configured in the maximum load-balancing command, this parameter must be also configured in the undo maximum load-balancing command when deleting load balancing.

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

Example

# Set two equal-cost routes to a specified destination.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] maximum load-balancing 2

maximum load-balancing (BGP-IPv4 unicast address family view)

Function

The maximum load-balancing command configures the maximum number of equal-cost routes for load balancing.

The undo maximum load-balancing command restores the default setting.

By default, the maximum number of equal-cost routes for load balancing is 1, and load balancing is not implemented.

Format

maximum load-balancing number

maximum load-balancing ebgp ebgpNumber

maximum load-balancing ibgp ibgpNumber

maximum load-balancing number ecmp-nexthop-changed

maximum load-balancing ebgp ebgpNumber ecmp-nexthop-changed

maximum load-balancing ibgp ibgpNumber ecmp-nexthop-changed

undo maximum load-balancing

undo maximum load-balancing ebgp

undo maximum load-balancing ibgp

Parameters

Parameter Description Value
number

Specifies the maximum number of equal-cost routes for load balancing.

The value is an integer ranging from 1 to 32.

ebgp ebgpNumber

Specifies the maximum number of equal-cost EBGP routes for load balancing.

The value is an integer ranging from 1 to 32.

ibgp ibgpNumber

Specifies the maximum number of equal-cost IBGP routes for load balancing.

The value is an integer ranging from 1 to 32.

ecmp-nexthop-changed

Configures a BGP device to change the next hop addresses of routes for load balancing to its address only when the device advertises these routes.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After this command is run, multiple BGP equal-cost routes will implement load balancing, improving network resource efficiency.

After this command is run, the routes that meet the following conditions will become equal-cost routes and implement load balancing:

  • The original next hops are different.
  • The PrefVal values are the same.
  • Local_Pref values are the same.
  • All routes are summary routes or none of them are summary routes.
  • Origin types (IGP, EGP, and Incomplete) are the same.
  • The MED values are the same.
  • All routes are EBGP or IBGP routes.
  • The IGP metric values within an AS are the same.
  • The AS_Path attributes are the same.

    For BGP routes with the same prefix in the routing table:
  • If the optimal routes are labeled routes, the routes selected for load balancing are also labeled routes. The number of routes for load balancing is determined by the maximum load-balancing ingress-lsp or maximum load-balancing transit-lsp command.
  • If the optimal route is a common route, the routes selected for load balancing are also common routes, and the maximum number of routes for load balancing is determined by the maximum load-balancing command.

    When load balancing is performed among BGP labeled routes, ingress LSPs are created for the labeled routes if the routes meet the conditions for creating ingress LSPs. When load balancing is performed among BGP labeled routes, transit LSPs are created for the labeled routes if the routes meet the conditions for creating transit LSPs.

    After the maximum load-balancing ebgp command is run, only EBGP routes implement load balancing. After the maximum load-balancing ibgp command is run, only IBGP routes implement load balancing. If [ ebgp | ibgp ] is not specified, both EBGP and IBGP routes can carry out load balancing, and the number of EBGP routes for load balancing is the same as the number of IBGP routes for load balancing.

    By default, after the maximum load-balancing command is run, a BGP device changes the next hop of a route to itself before advertising the route to a peer, regardless of whether the route is used for load balancing. After ecmp-nexthop-changed is set, a BGP device changes the next-hop of only routes that participate in load balancing to itself before advertising them to peers and keeps the next-hop of the routes that do not participate in load balancing unchanged.

    Note:

    After the maximum load-balancing command is run, the device changes the next hop addresses of the routes to be advertised to a local address, regardless of whether the routes are used for load balancing. However, in RR and BGP confederation scenarios, the device does not change the next hop address of non-local routes to the local address.

    After the maximum load-balancing { ebgp | ibgp } command is run, the device does not forcibly change the next hop addresses of the routes to be advertised to a local address, regardless of whether the routes are used for load balancing.

    After the maximum load-balancing [ ebgp | ibgp ] ecmp-nexthop-changed command is run, the device changes the next hop addresses of the routes to be advertised to a local address only when the routes are used for load balancing. When advertising the routes that are not used for load balancing, the device does not process the next hops of these routes. That is, the original next hop of these routes is the same as the next hop of the routes that are advertised when load balancing is not configured.

    In the Add-Path scenario, the next hop of Add-Path routes is processed in the same way as that of optimal routes, regardless of whether Add-Path routes are used for load balancing.

Configuration Impact

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

Precautions

If the maximum load-balancing command has been configured, the maximum load-balancing ebgp or maximum load-balancing ibgp command configuration does not take effect. If the maximum load-balancing ebgp or maximum load-balancing ibgp command has been configured, the maximum load-balancing command configuration does not take effect.

If either the ebgp or the ibgp parameter is configured in the maximum load-balancing command, this parameter must be also configured in the undo maximum load-balancing command when deleting load balancing.

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

Example

# Set three equal-cost routes to a specific destination and configure a device to change the next-hop addresses of only routes that participate in load balancing to its address.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] maximum load-balancing 3 ecmp-nexthop-changed
# Set two equal-cost routes to a specified destination.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] maximum load-balancing 2

maximum load-balancing (BGP-IPv6 unicast address family view)

Function

The maximum load-balancing command configures the maximum number of equal-cost routes for load balancing.

The undo maximum load-balancing command restores the default setting.

By default, the maximum number of equal-cost routes for load balancing is 1, and load balancing is not implemented.

Format

maximum load-balancing number

maximum load-balancing ebgp ebgpNumber

maximum load-balancing ibgp ibgpNumber

maximum load-balancing number ecmp-nexthop-changed

maximum load-balancing ebgp ebgpNumber ecmp-nexthop-changed

maximum load-balancing ibgp ibgpNumber ecmp-nexthop-changed

undo maximum load-balancing

undo maximum load-balancing ebgp

undo maximum load-balancing ibgp

Parameters

Parameter Description Value
number

Specifies the maximum number of equal-cost routes for load balancing.

The value is an integer ranging from 1 to 32.

ebgp ebgpNumber

Specifies the maximum number of equal-cost EBGP routes for load balancing.

The value is an integer ranging from 1 to 32.

ibgp ibgpNumber

Specifies the maximum number of equal-cost IBGP routes for load balancing.

The value is an integer ranging from 1 to 32.

ecmp-nexthop-changed

Configures a BGP device to change the next hop addresses of routes for load balancing to its address only when the device advertises these routes.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure the maximum number of equal-cost routes for load balancing, run the maximum load-balancing command. Load balancing improves the usage of network resources.

After BGP load balancing is configured, the routes that meet the following conditions can carry out load balancing as equal-cost routes.

  • Original next-hop addresses are different.
  • PrefVal values are the same.
  • Local_Pref attributes are the same.
  • The routes are either summarized or non-summarized.
  • Origin attributes (IGP, EGP, or incomplete) are the same.
  • MED values are the same.
  • The routes are EBGP or IBGP routes.
  • The IGP costs within an AS are the same.
  • AS_Path attributes are the same.

    For BGP routes with the same prefix in a routing table:
  • If the optimal route and the routes selected for load balancing are all labeled routes, the number of routes used for load balancing depends on the maximum load-balancing ingress-lsp or maximum load-balancing transit-lsp command configuration.
  • If the optimal route and the routes selected for load balancing are all non-labeled routes, the number of routes used for load balancing depends on the maximum load-balancing command configuration.

    If BGP labeled routes implement load balancing and the ingress LSP creation criteria are met, ingress LSPs are created for the labeled routes; If BGP labeled routes implement load balancing and the transit LSP creation criteria are met, transit LSPs are created for the labeled routes.

    After the maximum load-balancing ebgp command is run, only EBGP routes implement road balancing. After the maximum load-balancing ibgp command is run, only IBGP routes implement load balancing. If neither ebgp nor ibgp is configured, both EBGP and IBGP routes participate in load balancing, and the number of EBGP routes for load balancing is the same as the number of IBGP routes for load balancing.

    By default, after the maximum load-balancing command is run on a BGP device, the BGP device changes the next-hop of a route to itself before advertising the route to a peer, regardless of whether the route participates in load balancing. After ecmp-nexthop-changed is set, a BGP device changes the next-hop of only routes that participate in load balancing to itself before advertising them to peers and keeps the next-hop of the routes that do not participate in load balancing unchanged.

    NOTE:

    If you run the maximum load-balancing command, the device changes the next hop addresses of the routes to be advertised to a local address no matter whether the routes are used for load balancing. However, in RR or BGP confederation scenarios, the device does not change the next hop addresses of non-local routes to be advertised to a local address.

    If you run the maximum load-balancing [ ebgp | ibgp ] command, the device does not change the next hop addresses of the routes to be advertised to a local address no matter whether the routes are used for load balancing.

    If you run the maximum load-balancing [ ebgp | ibgp ] ecmp-nexthop-changed command, the device changes the next hop addresses of the routes to be advertised to a local address only when the routes are used for load balancing.

    In Add-Path scenarios, the next hops of Add-Path routes to be advertised are processed in the same way as that of the optimal route no matter whether the routes are used for load balancing, regardless of whether load balancing is implemented.

Configuration Impact

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

Precautions

If the maximum load-balancing command has been configured, the maximum load-balancing ebgp or maximum load-balancing ibgp command configuration does not take effect. If the maximum load-balancing ebgp or maximum load-balancing ibgp command has been configured, the maximum load-balancing command configuration does not take effect.

If either the ebgp or the ibgp parameter is configured in the maximum load-balancing command, this parameter must be also configured in the undo maximum load-balancing command when deleting load balancing.

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

Example

# Set two equal-cost routes to a specified destination.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] maximum load-balancing 2

maximum load-balancing (BGP-VPN instance IPv4 address family view)

Function

The maximum load-balancing command configures the maximum number of equal-cost routes for load balancing.

The undo maximum load-balancing command restores the default setting.

By default, the maximum number of equal-cost routes for load balancing is 1, and load balancing is not implemented.

Format

maximum load-balancing number

maximum load-balancing ebgp ebgpNumber

maximum load-balancing ibgp ibgpNumber

maximum load-balancing number ecmp-nexthop-changed

maximum load-balancing ebgp ebgpNumber ecmp-nexthop-changed

maximum load-balancing ibgp ibgpNumber ecmp-nexthop-changed

undo maximum load-balancing

undo maximum load-balancing ebgp

undo maximum load-balancing ibgp

Parameters

Parameter Description Value
number

Specifies the maximum number of equal-cost routes for load balancing.

The value is an integer ranging from 1 to 32.

ebgp ebgpNumber

Specifies the maximum number of equal-cost EBGP routes for load balancing.

The value is an integer ranging from 1 to 32.

ibgp ibgpNumber

Specifies the maximum number of equal-cost IBGP routes for load balancing.

The value is an integer ranging from 1 to 32.

ecmp-nexthop-changed

Configures a BGP device to change the next hop addresses of routes for load balancing to its address only when the device advertises these routes.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure the maximum number of equal-cost routes for load balancing, run the maximum load-balancing command. Load balancing improves the usage of network resources.

After BGP load balancing is configured, the routes that meet the following conditions can carry out load balancing as equal-cost routes.

  • Original next-hop addresses are different.
  • PrefVal values are the same.
  • Local_Pref attributes are the same.
  • The routes are either summarized or non-summarized.
  • Origin attributes (IGP, EGP, or incomplete) are the same.
  • MED values are the same.
  • The routes are EBGP or IBGP routes.
  • The IGP costs within an AS are the same.
  • AS_Path attributes are the same.

    For BGP routes with the same prefix in a routing table:
  • If the optimal route and the routes selected for load balancing are all labeled routes, the number of routes used for load balancing depends on the maximum load-balancing ingress-lsp or maximum load-balancing transit-lsp command configuration.
  • If the optimal route and the routes selected for load balancing are all non-labeled routes, the number of routes used for load balancing depends on the maximum load-balancing command configuration.

    If BGP labeled routes implement load balancing and the ingress LSP creation criteria are met, ingress LSPs are created for the labeled routes; If BGP labeled routes implement load balancing and the transit LSP creation criteria are met, transit LSPs are created for the labeled routes.

    After the maximum load-balancing ebgp command is run, only EBGP routes implement road balancing. After the maximum load-balancing ibgp command is run, only IBGP routes implement load balancing. If neither ebgp nor ibgp is configured, both EBGP and IBGP routes participate in load balancing, and the number of EBGP routes for load balancing is the same as the number of IBGP routes for load balancing.

    By default, after the maximum load-balancing command is run on a BGP device, the BGP device changes the next-hop of a route to itself before advertising the route to a peer, regardless of whether the route participates in load balancing. After ecmp-nexthop-changed is set, a BGP device changes the next-hop of only routes that participate in load balancing to itself before advertising them to peers and keeps the next-hop of the routes that do not participate in load balancing unchanged.

    NOTE:

    If you run the maximum load-balancing command, the device changes the next hop addresses of the routes to be advertised to a local address no matter whether the routes are used for load balancing. However, in RR or BGP confederation scenarios, the device does not change the next hop addresses of non-local routes to be advertised to a local address.

    If you run the maximum load-balancing [ ebgp | ibgp ] command, the device does not change the next hop addresses of the routes to be advertised to a local address no matter whether the routes are used for load balancing.

    If you run the maximum load-balancing [ ebgp | ibgp ] ecmp-nexthop-changed command, the device changes the next hop addresses of the routes to be advertised to a local address only when the routes are used for load balancing.

    In Add-Path scenarios, the next hops of Add-Path routes to be advertised are processed in the same way as that of the optimal route no matter whether the routes are used for load balancing, regardless of whether load balancing is implemented.

Configuration Impact

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

Precautions

If the maximum load-balancing command has been configured, the maximum load-balancing ebgp or maximum load-balancing ibgp command configuration does not take effect. If the maximum load-balancing ebgp or maximum load-balancing ibgp command has been configured, the maximum load-balancing command configuration does not take effect.

If either the ebgp or the ibgp parameter is configured in the maximum load-balancing command, this parameter must be also configured in the undo maximum load-balancing command when deleting load balancing.

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

Example

# Set two equal-cost routes to a specified destination.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] maximum load-balancing 2

maximum load-balancing (BGP-VPN instance IPv6 address family view)

Function

The maximum load-balancing command configures the maximum number of equal-cost routes for load balancing.

The undo maximum load-balancing command restores the default setting.

By default, the maximum number of equal-cost routes for load balancing is 1, and load balancing is not implemented.

Format

maximum load-balancing number

maximum load-balancing ebgp ebgpNumber

maximum load-balancing ibgp ibgpNumber

maximum load-balancing number ecmp-nexthop-changed

maximum load-balancing ebgp ebgpNumber ecmp-nexthop-changed

maximum load-balancing ibgp ibgpNumber ecmp-nexthop-changed

undo maximum load-balancing

undo maximum load-balancing ebgp

undo maximum load-balancing ibgp

Parameters

Parameter Description Value
number

Specifies the maximum number of equal-cost routes for load balancing.

The value is an integer ranging from 1 to 32.

ebgp ebgpNumber

Specifies the maximum number of equal-cost EBGP routes for load balancing.

The value is an integer ranging from 1 to 32.

ibgp ibgpNumber

Specifies the maximum number of equal-cost IBGP routes for load balancing.

The value is an integer ranging from 1 to 32.

ecmp-nexthop-changed

Configures a BGP device to change the next hop addresses of routes for load balancing to its address only when the device advertises these routes.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After this command is run, multiple BGP equal-cost routes will implement load balancing, improving network resource efficiency.

After this command is run, the routes that meet the following conditions will become equal-cost routes and implement load balancing:

  • The original next hops are different.
  • The PrefVal values are the same.
  • Local_Pref values are the same.
  • All routes are summary routes or none of them are summary routes.
  • Origin types (IGP, EGP, and Incomplete) are the same.
  • The MED values are the same.
  • All routes are EBGP or IBGP routes.
  • The IGP metric values within an AS are the same.
  • The AS_Path attributes are the same.

    For BGP routes with the same prefix in the routing table:
  • If the optimal routes are labeled routes, the routes selected for load balancing are also labeled routes. The number of routes for load balancing is determined by the maximum load-balancing ingress-lsp or maximum load-balancing transit-lsp command.
  • If the optimal route is a common route, the routes selected for load balancing are also common routes, and the maximum number of routes for load balancing is determined by the maximum load-balancing command.

    When load balancing is performed among BGP labeled routes, ingress LSPs are created for the labeled routes if the routes meet the conditions for creating ingress LSPs. When load balancing is performed among BGP labeled routes, transit LSPs are created for the labeled routes if the routes meet the conditions for creating transit LSPs.

    After the maximum load-balancing ebgp command is run, only EBGP routes implement load balancing. After the maximum load-balancing ibgp command is run, only IBGP routes implement load balancing. If [ ebgp | ibgp ] is not specified, both EBGP and IBGP routes can carry out load balancing, and the number of EBGP routes for load balancing is the same as the number of IBGP routes for load balancing.

    By default, after the maximum load-balancing command is run, a BGP device changes the next hop of a route to itself before advertising the route to a peer, regardless of whether the route is used for load balancing. After ecmp-nexthop-changed is set, a BGP device changes the next-hop of only routes that participate in load balancing to itself before advertising them to peers and keeps the next-hop of the routes that do not participate in load balancing unchanged.

    Note:

    After the maximum load-balancing command is run, the device changes the next hop addresses of the routes to be advertised to a local address, regardless of whether the routes are used for load balancing. However, in RR and BGP confederation scenarios, the device does not change the next hop address of non-local routes to the local address.

    After the maximum load-balancing { ebgp | ibgp } command is run, the device does not forcibly change the next hop addresses of the routes to be advertised to a local address, regardless of whether the routes are used for load balancing.

    After the maximum load-balancing [ ebgp | ibgp ] ecmp-nexthop-changed command is run, the device changes the next hop addresses of the routes to be advertised to a local address only when the routes are used for load balancing. When advertising the routes that are not used for load balancing, the device does not process the next hops of these routes. That is, the original next hop of these routes is the same as the next hop of the routes that are advertised when load balancing is not configured.

    In the Add-Path scenario, the next hop of Add-Path routes is processed in the same way as that of optimal routes, regardless of whether Add-Path routes are used for load balancing.

Configuration Impact

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

Precautions

If the maximum load-balancing command has been configured, the maximum load-balancing ebgp or maximum load-balancing ibgp command configuration does not take effect. If the maximum load-balancing ebgp or maximum load-balancing ibgp command has been configured, the maximum load-balancing command configuration does not take effect.

If either the ebgp or the ibgp parameter is configured in the maximum load-balancing command, this parameter must be also configured in the undo maximum load-balancing command when deleting load balancing.

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

Example

# Set two equal-cost routes to a specified destination.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] maximum load-balancing 2

maximum load-balancing eibgp (BGP multi-instance VPN instance IPv4 address family view)

Function

The maximum load-balancing eibgp command configures the maximum number of EBGP and IBGP routes for load balancing.

The undo maximum load-balancing eibgp command deletes the configured maximum number of EBGP and IBGP routes for load balancing.

By default, the maximum number of EBGP and IBGP routes for load balancing is 1, and load balancing is not implemented.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

maximum load-balancing eibgp number

maximum load-balancing eibgp number ecmp-nexthop-changed

undo maximum load-balancing eibgp

Parameters

Parameter Description Value
number

Specifies the maximum number of equal-cost EBGP and IBGP routes.

The value is an integer ranging from 1 to 32.

ecmp-nexthop-changed

Configures the device to change the next hop addresses of only the routes that carry out load balancing to its address.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The maximum load-balancing eibgp command is used in a VPN where a CE is dual-homed to PEs. When the CE shares one AS with only one of the CEs, you can set the number of EBGP and IBGP routes for load balancing. This allows VPN traffic to be balanced among EBGP and IBGP routes.

NOTE:

If you run the maximum load-balancing eibgp command, the device changes the next hop addresses of the routes to be advertised to a local address no matter whether the routes are used for load balancing. However, in RR or BGP confederation scenarios, the device does not change the next hop addresses of non-local routes to be advertised to a local address.

If you run the maximum load-balancing eibgp ecmp-nexthop-changed command, the device does not change the next hop addresses of the routes to be advertised to a local address no matter whether the routes are used for load balancing.

In Add-Path scenarios, the next hops of Add-Path routes to be advertised are processed in the same way as that of the optimal route no matter whether the routes are used for load balancing, regardless of whether load balancing is implemented.

After BGP load balancing is configured, BGP routes that meet the following conditions and have the same AS_Path attribute are equal-cost routes and implement load balancing:

  • PrefVal values are the same.
  • Local_Pref attributes are the same.
  • All BGP routes are summarized or non-summarized routes.
  • AS_path lengths are the same.
  • Origin types (IGP, EGP, or Incomplete) are the same.
  • Multi_Exit Discriminator (MED) values are the same.
  • AS_Path attributes are the same.

    Configuring BGP load balancing better utilizes network resources.

    For BGP routes with the same prefix in a routing table:
  • If the optimal route and the routes selected for load balancing are all labeled routes, the number of routes used for load balancing depends on the maximum load-balancing ingress-lsp or maximum load-balancing transit-lsp command configuration.
  • If the optimal route and the routes selected for load balancing are all non-labeled routes, the number of routes used for load balancing depends on the maximum load-balancing eibgp command configuration.

    If BGP labeled routes implement load balancing and the ingress LSP creation criteria are met, ingress LSPs are created for the labeled routes; If BGP labeled routes implement load balancing and the transit LSP creation criteria are met, transit LSPs are created for the labeled routes.

Configuration Impact

If the maximum load-balancing eibgp command is run more than once, the latest configuration overrides the previous one.

Precautions

The maximum load-balancing and the maximum load-balancing eibgp commands are mutually exclusive.

Load balancing cannot be implemented between leaked and non-leaked routes.

Example

# Set the maximum number of EBGP and IBGP routes for load balancing to 3 and configure the device to change the next hop addresses of routes for load balancing to its address only when the device advertises these routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] maximum load-balancing eibgp 3 ecmp-nexthop-changed
# Set the maximum number of EBGP and IBGP routes for load balancing to 3.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] maximum load-balancing eibgp 3

maximum load-balancing eibgp (BGP-VPN instance IPv4 address family view)

Function

The maximum load-balancing eibgp command configures the maximum number of EBGP and IBGP routes for load balancing.

The undo maximum load-balancing eibgp command deletes the configured maximum number of EBGP and IBGP routes for load balancing.

By default, the maximum number of EBGP and IBGP routes for load balancing is 1, and load balancing is not implemented.

Format

maximum load-balancing eibgp number

maximum load-balancing eibgp number ecmp-nexthop-changed

undo maximum load-balancing eibgp

Parameters

Parameter Description Value
number

Specifies the maximum number of equal-cost EBGP and IBGP routes.

The value is an integer ranging from 1 to 32.

ecmp-nexthop-changed

Configures a BGP device to change the next hop addresses of routes for load balancing to its address only when the device advertises these routes.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The maximum load-balancing eibgp command is used in a VPN where a CE is dual-homed to PEs. When the CE shares one AS with only one of the CEs, you can set the number of EBGP and IBGP routes for load balancing. This allows VPN traffic to be balanced among EBGP and IBGP routes.

NOTE:

If you run the maximum load-balancing eibgp command, the device changes the next hop addresses of the routes to be advertised to a local address no matter whether the routes are used for load balancing. However, in RR or BGP confederation scenarios, the device does not change the next hop addresses of non-local routes to be advertised to a local address.

If you run the maximum load-balancing eibgp ecmp-nexthop-changed command, the device does not change the next hop addresses of the routes to be advertised to a local address no matter whether the routes are used for load balancing.

In Add-Path scenarios, the next hops of Add-Path routes to be advertised are processed in the same way as that of the optimal route no matter whether the routes are used for load balancing, regardless of whether load balancing is implemented.

After BGP load balancing is configured, BGP routes that meet the following conditions and have the same AS_Path attribute are equal-cost routes and implement load balancing:

  • PrefVal values are the same.
  • Local_Pref attributes are the same.
  • All BGP routes are summarized or non-summarized routes.
  • AS_path lengths are the same.
  • Origin types (IGP, EGP, or Incomplete) are the same.
  • Multi_Exit Discriminator (MED) values are the same.
  • AS_Path attributes are the same.

    Configuring BGP load balancing better utilizes network resources.

    For BGP routes with the same prefix in a routing table:
  • If the optimal route and the routes selected for load balancing are all labeled routes, the number of routes used for load balancing depends on the maximum load-balancing ingress-lsp or maximum load-balancing transit-lsp command configuration.
  • If the optimal route and the routes selected for load balancing are all non-labeled routes, the number of routes used for load balancing depends on the maximum load-balancing eibgp command configuration.

    If BGP labeled routes implement load balancing and the ingress LSP creation criteria are met, ingress LSPs are created for the labeled routes; If BGP labeled routes implement load balancing and the transit LSP creation criteria are met, transit LSPs are created for the labeled routes.

Configuration Impact

If the maximum load-balancing eibgp command is run more than once, the latest configuration overrides the previous one.

Precautions

The maximum load-balancing and the maximum load-balancing eibgp commands are mutually exclusive.

Load balancing cannot be implemented between leaked and non-leaked routes.

Example

# Set the maximum number of EBGP and IBGP routes for load balancing to 3.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] maximum load-balancing eibgp 3

maximum load-balancing eibgp (BGP-VPN instance IPv6 address family view)

Function

The maximum load-balancing eibgp command configures the maximum number of EBGP and IBGP routes for load balancing.

The undo maximum load-balancing eibgp command deletes the configured maximum number of EBGP and IBGP routes for load balancing.

By default, the maximum number of EBGP and IBGP routes for load balancing is 1, and load balancing is not implemented.

Format

maximum load-balancing eibgp number

maximum load-balancing eibgp number ecmp-nexthop-changed

undo maximum load-balancing eibgp

Parameters

Parameter Description Value
number

Specifies the maximum number of equal-cost EBGP and IBGP routes.

The value is an integer ranging from 1 to 32.

ecmp-nexthop-changed

Configures a BGP device to change the next hop addresses of routes for load balancing to its address only when the device advertises these routes.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The maximum load-balancing eibgp command is used in a VPN where a CE is dual-homed to PEs. When the CE shares one AS with only one of the CEs, you can set the number of EBGP and IBGP routes for load balancing. This allows VPN traffic to be balanced among EBGP and IBGP routes.

NOTE:

If you run the maximum load-balancing eibgp command, the device changes the next hop addresses of the routes to be advertised to a local address no matter whether the routes are used for load balancing. However, in RR or BGP confederation scenarios, the device does not change the next hop addresses of non-local routes to be advertised to a local address.

If you run the maximum load-balancing eibgp ecmp-nexthop-changed command, the device does not change the next hop addresses of the routes to be advertised to a local address no matter whether the routes are used for load balancing.

In Add-Path scenarios, the next hops of Add-Path routes to be advertised are processed in the same way as that of the optimal route no matter whether the routes are used for load balancing, regardless of whether load balancing is implemented.

After BGP load balancing is configured, BGP routes that meet the following conditions and have the same AS_Path attribute are equal-cost routes and implement load balancing:

  • PrefVal values are the same.
  • Local_Pref attributes are the same.
  • All BGP routes are summarized or non-summarized routes.
  • AS_path lengths are the same.
  • Origin types (IGP, EGP, or Incomplete) are the same.
  • Multi_Exit Discriminator (MED) values are the same.
  • AS_Path attributes are the same.

    Configuring BGP load balancing better utilizes network resources.

    For BGP routes with the same prefix in a routing table:
  • If the optimal route and the routes selected for load balancing are all labeled routes, the number of routes used for load balancing depends on the maximum load-balancing ingress-lsp or maximum load-balancing transit-lsp command configuration.
  • If the optimal route and the routes selected for load balancing are all non-labeled routes, the number of routes used for load balancing depends on the maximum load-balancing eibgp command configuration.

    If BGP labeled routes implement load balancing and the ingress LSP creation criteria are met, ingress LSPs are created for the labeled routes; If BGP labeled routes implement load balancing and the transit LSP creation criteria are met, transit LSPs are created for the labeled routes.

Configuration Impact

If the maximum load-balancing eibgp command is run more than once, the latest configuration overrides the previous one.

Precautions

The maximum load-balancing and the maximum load-balancing eibgp commands are mutually exclusive.

Load balancing cannot be implemented between leaked and non-leaked routes.

Example

# Set the maximum number of EBGP and IBGP routes for load balancing to 3 and configure the device to change the next hop addresses of routes for load balancing to its address only when the device advertises these routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] maximum load-balancing eibgp 3 ecmp-nexthop-changed
# Set the maximum number of EBGP and IBGP routes for load balancing to 3.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] maximum load-balancing eibgp 3

monitor all-vpn-instance

Function

The monitor all-vpn-instance command displays the BMP-Monitor view and allows the BGP running status of BGP peers in all VPN instance address families to be monitored.

The undo monitor all-vpn-instance command restores the default configuration.

By default, the BGP running status of BGP peers is not monitored.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

monitor all-vpn-instance

undo monitor all-vpn-instance

Parameters

None

Views

BMP session view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BMP is used to monitor BGP running status of devices in real time, such as the establishment and termination status of BGP peer relationships and route update status. To allow the BGP running status of BGP peers in all VPN instance address families to be monitored, run the monitor all-vpn-instance command. After a TCP connection is established between the device and the monitoring server, the device reports BGP running status to the monitoring server, improving network monitoring efficiency.

Follow-up Procedure

Perform either of the following operations as required:

  • Run the route-mode { { ipv4-family | ipv6-family } unicast } adj-rib-in { pre-policy | post-policy } command to set the type of RIB-in route (received from all peers in a specified address family of a specified VPN instance) whose statistics are to be sent by the device to the monitoring server.
  • Run the route-mode { { ipv4-family | ipv6-family } unicast } adj-rib-out { pre-policy | post-policy } command to set the type of RIB-out route (to be advertised or already advertised to all peers in a specified address family of a specified VPN instance) whose statistics are to be sent by the device to the monitoring server.
  • Run the route-mode { { ipv4-family | ipv6-family } unicast } local-rib [ add-path ] command to configure the device to send statistics about Local-RIB routes of all BGP peers in a specified address family of the VPN instance to the monitoring server.

Example

# Display the BMP-Monitor view and allow the BGP running status of all BGP peers in all VPN instance address families to be monitored.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1 alias a
[HUAWEI-bmp-session-10.1.1.1-a] monitor all-vpn-instance

monitor peer

Function

The monitor peer command displays the BMP-Monitor view and allows the BGP running status of a specified BGP peer in the public network address family to be monitored.

The undo monitor peer command restores the default configuration.

By default, the BGP running status of BGP peers is not monitored.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

monitor peer ipv4-address

monitor peer ipv6-address

undo monitor peer ipv4-address

undo monitor peer ipv6-address

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

ipv6-address

Specifies the IPv6 address of a BGP peer.

The address is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BMP session view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BMP is used to monitor BGP running status of devices in real time, such as the establishment and termination status of BGP peer relationships and route update status. To allow the BGP running status of a specified BGP peer in the public network address family to be monitored, run the monitor peer command. After a TCP connection is established between the device and the monitoring server, the device reports BGP running status to the monitoring server, improving network monitoring efficiency.

Follow-up Procedure

Perform either of the following operations as required:

  • Run the route-mode { { { ipv4-family | ipv6-family } unicast } | ipv4-family vpnv4 | ipv6-family vpnv6 } adj-rib-in { pre-policy | post-policy } command to set the type of RIB-in route (received from a specified peer in a specified public network address family) whose statistics are to be sent by the device to the monitoring server.
  • Run the route-mode { { { ipv4-family | ipv6-family } unicast } | ipv4-family vpnv4 | ipv6-family vpnv6 } adj-rib-out { pre-policy | post-policy } command to set the type of RIB-out route (to be advertised or already advertised to a specified peer in a specified public network address family) whose statistics are to be sent by the device to the monitoring server.

Precautions

This command cannot be used to monitor a specified peer in a distributed instance.

Example

# Display the BMP-Monitor view and allow the BGP running status of a specified BGP peer in the public network address family to be monitored.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1 alias a
[HUAWEI-bmp-session-10.1.1.1-a] monitor peer 10.1.1.1

monitor public

Function

The monitor public command displays the BMP-Monitor view and allows the BGP running status of all BGP peers in the public network address family to be monitored.

The undo monitor public command restores the default configuration.

By default, the BGP running status of BGP peers is not monitored.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

monitor public

undo monitor public

Parameters

None

Views

BMP session view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BMP is used to monitor BGP running status of devices in real time, such as the establishment and termination status of BGP peer relationships and route update status. To allow the BGP running status of all BGP peers in the public network address family to be monitored, run the monitor public command. After a TCP connection is established between a device and a monitoring server, the device reports BGP running status to the monitoring server, improving network monitoring efficiency.

Follow-up Procedure

Perform either of the following operations as required:

  • Run the route-mode { { { ipv4-family | ipv6-family } unicast } | ipv4-family vpnv4 | ipv6-family vpnv6 } adj-rib-in { pre-policy | post-policy } command to set the type of RIB-in route (received from all peers in a specified public network address family) whose statistics are to be sent by the device to the monitoring server.
  • Run the route-mode { { { ipv4-family | ipv6-family } unicast } | ipv4-family vpnv4 | ipv6-family vpnv6 } adj-rib-out { pre-policy | post-policy } command to set the type of RIB-out route (to be advertised or already advertised to all peers in a specified public network address family) whose statistics are to be sent by the device to the monitoring server.
  • Run the route-mode { { { ipv4-family | ipv6-family } unicast } | ipv4-family vpnv4 | ipv6-family vpnv6 } local-rib [ add-path ] command to configure the device to send statistics about Local-RIB routes of all BGP peers in the specified public network address family to the monitoring server.

Example

# Display the BMP-Monitor view and allow the BGP running status of all BGP peers in the public network address family to be monitored.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1 alias a
[HUAWEI-bmp-session-10.1.1.1-a] monitor public

monitor vpn-instance

Function

The monitor vpn-instance command displays the BMP-Monitor view and allows the BGP running status of all BGP peers in a specified VPN instance address family to be monitored.

The undo monitor vpn-instance command restores the default configuration.

By default, the BGP running status of BGP peers is not monitored.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

monitor vpn-instance vpn-instance-name

undo monitor vpn-instance vpn-instance-name

Parameters

Parameter Description Value
vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BMP session view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BMP is used to monitor BGP running status of devices in real time, such as the establishment and termination status of BGP peer relationships and route update status. To allow the BGP running status of all BGP peers in an address family of a specified VPN instance to be monitored, run the monitor vpn-instance command. After a TCP connection is established between the device and the monitoring server, the device reports BGP running status to the monitoring server, improving network monitoring efficiency.

Example

# Display the BMP-Monitor view and allow the BGP running status of all BGP peers in a specified VPN instance address family to be monitored.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1 alias a
[HUAWEI-bmp-session-10.1.1.1-a] monitor vpn-instance vpn1

monitor vpn-instance peer

Function

The monitor vpn-instance peer command displays the BMP-Monitor view and allows the BGP running status of a specified BGP peer in a specified VPN instance address family to be monitored.

The undo monitor vpn-instance peer command restores the default configuration.

By default, the BGP running status of BGP peers is not monitored.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

monitor vpn-instance vpn-instance-name peer ipv4-address

monitor vpn-instance vpn-instance-name peer ipv6-address

undo monitor vpn-instance vpn-instance-name peer ipv4-address

undo monitor vpn-instance vpn-instance-name peer ipv6-address

Parameters

Parameter Description Value
vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

ipv4-address

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

ipv6-address

Specifies the IPv6 address of a BGP peer.

The address is a 32-bit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BMP session view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BMP is used to monitor BGP running status of devices in real time, such as the establishment and termination status of BGP peer relationships and route update status. To allow the BGP running status of a specified BGP peer in a specified VPN instance address family to be monitored, run the monitor vpn-instance peer command. After a TCP connection is established between the device and the monitoring server, the device reports BGP running status to the monitoring server, improving network monitoring efficiency.

Follow-up Procedure

Perform either of the following operations as required:

  • Run the route-mode { { ipv4-family | ipv6-family } unicast } adj-rib-in { pre-policy | post-policy } command to set the type of RIB-in route (received from a specified peer in a specified VPN instance address family) whose statistics are to be sent by the device to the monitoring server.
  • Run the route-mode { { ipv4-family | ipv6-family } unicast } adj-rib-out { pre-policy | post-policy } command to set the type of RIB-out route (to be advertised or already advertised to a specified peer in a specified VPN instance address family) whose statistics are to be sent by the device to the monitoring server.

Example

# Display the BMP-Monitor view and allow the BGP running status of a specified BGP peer in a specified VPN instance address family to be monitored.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1 alias a
[HUAWEI-bmp-session-10.1.1.1-a] monitor vpn-instance vpn1 peer 10.1.1.1

network (BGP multi-instance VPN instance IPv4 address family view)

Function

The network command imports routes to the BGP routing table and advertises them to peers.

The undo network command cancels the configuration.

By default, BGP does not import routes.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

network { ipv4-address [ mask | mask-length ] } [ route-policy route-policy-name ]

undo network { ipv4-address [ mask | mask-length ] }

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a route to be imported by BGP.

The value is in dotted decimal notation.

mask

Specifies an IP address mask. If no mask is specified, the IP address is considered as a classful address.

The value is in dotted decimal notation.

mask-length

Specifies the mask length of an IP address. If no mask length is specified, the IP address is considered as a classful address.

The value is an integer ranging from 0 to 32.

route-policy route-policy-name

Specifies the name of a route-policy that is used for route advertisement.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP itself cannot discover routes. Instead, it imports routes discovered by other protocols (such as an IGP or static routes) to the BGP routing table. These imported routes then are transmitted within an AS or between ASs. Before adding routes to the BGP routing table, BGP can filter them based on the routing protocol. Alternatively, if routes in the local routing table need to be manually added to the BGP routing table and then advertised, you can use the network command.

The Origin attribute of the routes imported to the BGP routing table using the network command is IGP.

If a route with a specific prefix or mask is added to the BGP routing table using the network command, this route is the optimal route selected from all types of protocol routes. Unlike the network command, the import-route command is used to add all routes of a specified protocol, such as RIP, OSPF, IS-IS, static routes, or direct routes to the BGP routing table.

Precautions

The network command is used to import exactly-matching routes. This means that only the routes in the local IP routing table that exactly match the specified destination address and prefix length can be advertised. If no mask is specified, routes are exactly matched against the natural network mask.

When using the undo network command to delete the existing configuration, specify the correct mask.

If the routes to be imported are load balancing routes, only the first route in the IP routing table can be imported.

Example

# Configure BGP to import the local route 1.0.0.0/16.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] network 1.0.0.0 255.255.0.0

network (BGP view/BGP-IPv4 unicast address family view)

Function

The network command imports routes to the BGP routing table and advertises them to peers.

The undo network command cancels the configuration.

By default, BGP does not import routes.

Format

network { ipv4-address [ mask | mask-length ] } [ route-policy route-policy-name ]

undo network { ipv4-address [ mask | mask-length ] }

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a route to be imported by BGP.

The value is in the dotted decimal format.

mask

Specifies an IP address mask. If no mask is specified, the IP address is considered as a classful address.

It is in dotted decimal notation.

mask-length

Specifies the mask length of an IP address. If no mask length is specified, the IP address is considered as a classful address.

The value is an integer in the range from 0 to 32.

route-policy route-policy-name

Specifies the name of a route-policy that is used for route advertisement.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP itself cannot discover routes. Instead, it imports routes discovered by other protocols (such as an IGP or static routes) to the BGP routing table. These imported routes then are transmitted within an AS or between ASs. Before adding routes to the BGP routing table, BGP can filter them based on the routing protocol. Alternatively, if routes in the local routing table need to be manually added to the BGP routing table and then advertised, you can use the network command.

The Origin attribute of the routes imported to the BGP routing table using the network command is IGP.

If a route with a specific prefix or mask is added to the BGP routing table using the network command, this route is the optimal route selected from all types of protocol routes. Unlike the network command, the import-route command is used to add all routes of a specified protocol, such as RIP, OSPF, IS-IS, static routes, or direct routes to the BGP routing table.

Precautions

The network command is used to import exactly-matching routes. This means that only the routes in the local IP routing table that exactly match the specified destination address and prefix length can be advertised. If no mask is specified, routes are exactly matched against the natural network mask.

When using the undo network command to delete the existing configuration, specify the correct mask.

If the routes to be imported are load balancing routes, only the first route in the IP routing table can be imported.

Example

# Configure BGP to import the local route 1.0.0.0/16.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] network 1.0.0.0 255.255.0.0

network (BGP-IPv6 unicast address family view)

Function

The network command imports routes to the BGP routing table and advertises them to peers.

The undo network command cancels the configuration.

By default, BGP does not import routes.

Format

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

undo network ipv6-address prefix-length

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a route to be imported by BGP.

The address is in the format of X:X:X:X:X:X:X:X.

prefix-length

Specifies the mask length of an IPv6 address. If no mask length is specified, the IP address is considered as a classful address.

It is an integer ranging from 0 to 128.

route-policy route-policy-name

Specifies the name of a route-policy that is used for route advertisement.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP itself cannot discover routes. Instead, it imports routes discovered by other protocols (such as an IGP or static routes) to the BGP routing table. These imported routes then are transmitted within an AS or between ASs. Before adding routes to the BGP routing table, BGP can filter them based on the routing protocol. Alternatively, if routes in the local routing table need to be manually added to the BGP routing table and then advertised, you can use the network command.

The Origin attribute of the routes imported to the BGP routing table using the network command is IGP.

If a route with a specific prefix or mask is added to the BGP routing table using the network command, this route is the optimal route selected from all types of protocol routes. Unlike the network command, the import-route command is used to add all routes of a specified protocol, such as RIP, OSPF, IS-IS, static routes, or direct routes to the BGP routing table.

Precautions

The network command is used to import exactly-matching routes. This means that only the routes in the local IP routing table that exactly match the specified destination address and prefix length can be added to the BGP routing table. If no mask is specified, routes are exactly matched against the natural network mask.

When using the undo network command to delete the existing configuration, specify the correct mask.

If load balancing routes are imported, only the first route in the IP routing table can be imported.

Example

# Configure BGP to import the local route 1.0.0.0/16.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] network 1::1 32

network (BGP-VPN instance IPv4 address family view)

Function

The network command imports routes to the BGP routing table and advertises them to peers.

The undo network command cancels the configuration.

By default, BGP does not import routes.

Format

network { ipv4-address [ mask | mask-length ] } [ route-policy route-policy-name ]

undo network { ipv4-address [ mask | mask-length ] }

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a route to be imported by BGP.

The value is in the dotted decimal format.

mask

Specifies an IP address mask. If no mask is specified, the IP address is considered as a classful address.

The value is in dotted decimal notation.

mask-length

Specifies the mask length of an IP address. If no mask length is specified, the IP address is considered as a classful address.

The value is an integer in the range from 0 to 32.

route-policy route-policy-name

Specifies the name of a route-policy that is used for route advertisement.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP itself cannot discover routes. Instead, it imports routes discovered by other protocols (such as an IGP or static routes) to the BGP routing table. These imported routes then are transmitted within an AS or between ASs. Before adding routes to the BGP routing table, BGP can filter them based on the routing protocol. Alternatively, if routes in the local routing table need to be manually added to the BGP routing table and then advertised, you can use the network command.

The Origin attribute of the routes imported to the BGP routing table using the network command is IGP.

If a route with a specific prefix or mask is added to the BGP routing table using the network command, this route is the optimal route selected from all types of protocol routes. Unlike the network command, the import-route command is used to add all routes of a specified protocol, such as RIP, OSPF, IS-IS, static routes, or direct routes to the BGP routing table.

Precautions

The network command is used to import exactly-matching routes. This means that only the routes in the local IP routing table that exactly match the specified destination address and prefix length can be added to the BGP routing table. If no mask is specified, routes are exactly matched against the natural network mask.

When using the undo network command to delete the existing configuration, specify the correct mask.

If load balancing routes are imported, only the first route in the IP routing table can be imported.

Example

# Configure BGP to import the local route 10.0.0.0/16.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-labeled-vpna] network 10.0.0.0 255.255.0.0

network (BGP-VPN instance IPv6 address family view)

Function

The network command imports routes to the BGP routing table and advertises them to peers.

The undo network command cancels the configuration.

By default, BGP does not import routes.

Format

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

undo network ipv6-address mask-length

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a route to be imported by BGP.

The address is in the format of X:X:X:X:X:X:X:X.

mask-length

Specifies the mask length of an IP address. If no mask length is specified, the IP address is considered as a classful address.

It is an integer ranging from 0 to 128.

route-policy route-policy-name

Specifies the name of a route-policy that is used for route advertisement.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP itself cannot discover routes. Instead, it imports routes discovered by other protocols (such as an IGP or static routes) to the BGP routing table. These imported routes then are transmitted within an AS or between ASs. Before adding routes to the BGP routing table, BGP can filter them based on the routing protocol. Alternatively, if routes in the local routing table need to be manually added to the BGP routing table and then advertised, you can use the network command.

The Origin attribute of the routes imported to the BGP routing table using the network command is IGP.

If a route with a specific prefix or mask is added to the BGP routing table using the network command, this route is the optimal route selected from all types of protocol routes. Unlike the network command, the import-route command is used to add all routes of a specified protocol, such as RIP, OSPF, IS-IS, static routes, or direct routes to the BGP routing table.

Precautions

The network command is used to import exactly-matching routes. This means that only the routes in the local IP routing table that exactly match the specified destination address and prefix length can be added to the BGP routing table. If no mask is specified, routes are exactly matched against the natural network mask.

When using the undo network command to delete the existing configuration, specify the correct mask.

If load balancing routes are imported, only the first route in the IP routing table can be imported.

Example

# Configure BGP to import the local route 2001:db8:5::6/64.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] network 2001:db8:5::6 64

nexthop recursive-lookup default-route (BGP-IPv4 unicast address family view)

Function

The nexthop recursive-lookup default-route command enables BGP route recursion to the default route.

The undo nexthop recursive-lookup default-route command disables BGP route recursion to the default route.

By default, BGP route recursion to the default route is disabled.

Format

nexthop recursive-lookup default-route

undo nexthop recursive-lookup default-route

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The next hop of a BGP route may not be directly reachable. In this case, route recursion is required. To allow BGP routes to be recursed to the default IP route in the IPv4 address family view, run the nexthop recursive-lookup default-route command.

Precautions

After the nexthop recursive-lookup default-route command is run, BGP routes can recurse to the default route, which may lead to a forwarding path change.

Example

# Enable BGP route recursion to the default route in the BGP-IPv4 unicast address family view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] nexthop recursive-lookup default-route

nexthop recursive-lookup default-route (BGP-IPv6 unicast address family view)

Function

The nexthop recursive-lookup default-route command enables BGP route recursion to the default route.

The undo nexthop recursive-lookup default-route command disables BGP route recursion to the default route.

By default, BGP route recursion to the default route is disabled.

Format

nexthop recursive-lookup default-route

undo nexthop recursive-lookup default-route

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The next hop of a BGP route may not be directly reachable. In this case, route recursion is required. During route recursion, you can run the nexthop recursive-lookup default-route command to enable BGP route recursion to the default IP route in the IPv6 address family view.

Precautions

After the nexthop recursive-lookup default-route command is run, BGP routes can recurse to the default route, which may lead to a forwarding path change.

Example

# Enable BGP route recursion to the default route in the BGP-IPv6 unicast address family view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] nexthop recursive-lookup default-route

nexthop recursive-lookup default-route (BGP-VPN instance IPv4 address family view)

Function

The nexthop recursive-lookup default-route command enables BGP route recursion to the default route.

The undo nexthop recursive-lookup default-route command disables BGP route recursion to the default route.

By default, BGP route recursion to the default route is disabled.

Format

nexthop recursive-lookup default-route

undo nexthop recursive-lookup default-route

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The next hop of a BGP route may not be directly reachable. In this case, route recursion is required. To allow BGP routes to be recursed to the default IP route in the BGP-VPN instance IPv4 address family view, run the nexthop recursive-lookup default-route command.

Precautions

After this command is run, BGP routes can be recursed to the default route. Therefore, the actual forwarding path of data traffic may change.

This command takes effect only for routes learned from VPN peers.

Example

# Enable the function to send packets over a default route when the recursive next-hop IP address is unavailable.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] nexthop recursive-lookup default-route

nexthop recursive-lookup default-route (BGP-VPN instance IPv6 address family view)

Function

The nexthop recursive-lookup default-route command enables BGP route recursion to the default route.

The undo nexthop recursive-lookup default-route command disables BGP route recursion to the default route.

By default, BGP route recursion to the default route is disabled.

Format

nexthop recursive-lookup default-route

undo nexthop recursive-lookup default-route

Parameters

None

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The next hop of a BGP route may not be directly reachable. In this case, route recursion is required. To allow BGP routes to be recursed to the default IP route in the BGP-VPN instance IPv6 address family view, run the nexthop recursive-lookup default-route command.

Precautions

After this command is run, BGP routes can be recursed to the default route. Therefore, the actual forwarding path of data traffic may change.

This command takes effect only for routes learned from VPN peers.

Example

# Enable the function to send packets over a default route when the recursive next-hop IP address is unavailable.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] nexthop recursive-lookup default-route

nexthop recursive-lookup delay (BGP multi-instance VPN instance IPv4 address family view)

Function

The nexthop recursive-lookup delay command configures a delay in responding to changes in the next hop recursion result.

The undo nexthop recursive-lookup delay command restores the default configuration.

The nexthop recursive-lookup non-critical-event delay command configures a delay in responding to non-critical next-hop recursion changes.

The undo nexthop recursive-lookup non-critical-event delay command restores the default configuration.

By default, the delay in responding to non-critical next hop recursion changes is 10s, and the device does not delay responding to critical next hop recursion changes.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

nexthop recursive-lookup delay [ delay-time ]

nexthop recursive-lookup non-critical-event delay [ nonCrit-delay-time ]

undo nexthop recursive-lookup delay

undo nexthop recursive-lookup non-critical-event delay

Parameters

Parameter Description Value
delay-time

Specifies the delay in responding to recursion changes.

The value is an integer that ranges from 1 to 100, in seconds. The default value is 5 seconds.

nonCrit-delay-time

Indicates the delay in responding to non-critical recursion changes.

The value is an integer ranging from 0 to 100, in seconds. The default value is 10.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If repeated recursion causes the BGP next hop to frequently change on a device, the device frequently selects and advertises routes. To prevent unwanted re-routing and route advertisement, run the nexthop recursive-lookup delay command to enable the device to respond to BGP recursion changes after a specified delay time. The recursion results are as follows:

  • Critical recursion result change: The recursive next hop is changed, and BGP route reachability is also changed. For example, if a fault occurs on a network, a device finds no next-hop route or tunnel to which a BGP route recurses. As a result, traffic is interrupted.
  • Non-critical recursion result change: The recursive next hop is changed, and BGP route reachability is not affected. For example, after the interface or type of a tunnel to which the next hop of a BGP route recurses is changed, traffic keeps traveling over the BGP route.

Configuration Impact

After the nexthop recursive-lookup delay command is run, the device delays responses to all recursion changes. After the nexthop recursive-lookup non-critical-event delay command is run, the device delays responses only to non-critical BGP recursion changes. If both commands are run, the nexthop recursive-lookup non-critical-event delay command takes precedence over the nexthop recursive-lookup delay command

Precautions

Delayed response to BGP next hop recursion changes applies only to scenarios where multiple links exist between the downstream device and the same destination. If there is only one link between the next hop and the destination, configuring the BGP next hop delayed response may cause heavier traffic loss when the link fails because link switching is impossible in this case.

Example

# Enable the device to respond to non-critical BGP recursion changes after a 10-second delay.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] nexthop recursive-lookup non-critical-event delay 10

nexthop recursive-lookup delay (BGP view)

Function

The nexthop recursive-lookup delay command configures a delay in responding to changes in the next hop recursion result.

The undo nexthop recursive-lookup delay command restores the default configuration.

The nexthop recursive-lookup non-critical-event delay command configures a delay in responding to non-critical next-hop recursion changes.

The undo nexthop recursive-lookup non-critical-event delay command restores the default configuration.

By default, the delay in responding to non-critical next hop recursion changes is 10s, and the device does not delay responding to critical next hop recursion changes.

Format

nexthop recursive-lookup delay [ delay-time ]

nexthop recursive-lookup non-critical-event delay [ nonCrit-delay-time ]

undo nexthop recursive-lookup delay

undo nexthop recursive-lookup non-critical-event delay

Parameters

Parameter Description Value
delay-time

Specifies the delay in responding to recursion changes.

The value is an integer that ranges from 1 to 100, in seconds. The default value is 5 seconds.

nonCrit-delay-time

Indicates the delay in responding to non-critical recursion changes.

The value is an integer ranging from 0 to 100, in seconds. The default value is 10.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If repeated recursion causes the BGP next hop to frequently change on a device, the device frequently selects and advertises routes. To prevent unwanted re-routing and route advertisement, run the nexthop recursive-lookup delay command to enable the device to respond to BGP recursion changes after a specified delay time. The recursion results are as follows:

  • Critical recursion result change: The recursive next hop is changed, and BGP route reachability is also changed. For example, if a fault occurs on a network, a device finds no next-hop route or tunnel to which a BGP route recurses. As a result, traffic is interrupted.
  • Non-critical recursion result change: The recursive next hop is changed, and BGP route reachability is not affected. For example, after the interface or type of a tunnel to which the next hop of a BGP route recurses is changed, traffic keeps traveling over the BGP route.

Configuration Impact

After the nexthop recursive-lookup delay command is run, the device delays responses to all recursion changes. After the nexthop recursive-lookup non-critical-event delay command is run, the device delays responses only to non-critical BGP recursion changes. If both commands are run, the nexthop recursive-lookup non-critical-event delay command takes precedence over the nexthop recursive-lookup delay command

Precautions

Delayed response to BGP next hop recursion changes applies only to scenarios where multiple links exist between the downstream device and the same destination. If there is only one link between the next hop and the destination, configuring the BGP next hop delayed response may cause heavier traffic loss when the link fails because link switching is impossible in this case.

Example

# Enable the device to respond to non-critical BGP recursion changes after a 10-second delay.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] nexthop recursive-lookup non-critical-event delay 10

nexthop recursive-lookup delay (BGP-IPv4 unicast address family view)

Function

The nexthop recursive-lookup delay command configures a delay in responding to changes in the next hop recursion result.

The undo nexthop recursive-lookup delay command restores the default configuration.

The nexthop recursive-lookup non-critical-event delay command configures a delay in responding to non-critical next-hop recursion changes.

The undo nexthop recursive-lookup non-critical-event delay command restores the default configuration.

By default, the delay in responding to non-critical next hop recursion changes is 10s, and the device does not delay responding to critical next hop recursion changes.

Format

nexthop recursive-lookup delay [ delay-time ]

nexthop recursive-lookup non-critical-event delay [ nonCrit-delay-time ]

undo nexthop recursive-lookup delay

undo nexthop recursive-lookup non-critical-event delay

Parameters

Parameter Description Value
delay-time

Specifies the delay in responding to recursion changes.

The value is an integer that ranges from 1 to 100, in seconds. The default value is 5 seconds.

nonCrit-delay-time

Specifies the delay in responding to non-critical changes of the next hop.

The value is an integer ranging from 0 to 100, in seconds. The default value is 10.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If repeated recursion causes the BGP next hop to frequently change on a device, the device frequently selects and advertises routes. To prevent unwanted re-routing and route advertisement, run the

nexthop recursive-lookup delay command to enable the device to respond to BGP recursion changes after a specified delay time. The recursion results are as follows:

  • Critical recursion result change: The recursive next hop is changed, and BGP route reachability is also changed. For example, if a fault occurs on a network, a device finds no next-hop route or tunnel to which a BGP route recurses. As a result, traffic is interrupted.
  • Non-critical recursion result change: The recursive next hop is changed, and BGP route reachability is not affected. For example, after the interface or type of a tunnel to which the next hop of a BGP route recurses is changed, traffic keeps traveling over the BGP route.

Configuration Impact

After the nexthop recursive-lookup delay command is run, the device delays responses to all recursion changes. After the nexthop recursive-lookup non-critical-event delay command is run, the device delays responses only to non-critical BGP recursion changes. If both commands are run, the nexthop recursive-lookup non-critical-event delay command takes precedence over the nexthop recursive-lookup delay command

Precautions

Delayed response to BGP next hop recursion changes applies only to scenarios where multiple links exist between the downstream device and the same destination. If there is only one link between the next hop and the destination, configuring the BGP next hop delayed response may cause heavier traffic loss when the link fails because link switching is impossible in this case.

Example

# Enable the device to respond to non-critical MBGP recursion changes after a 10-second delay.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] nexthop recursive-lookup non-critical-event delay 10

nexthop recursive-lookup delay (BGP-IPv6 unicast address family view)

Function

The nexthop recursive-lookup delay command configures a delay in responding to changes in the next hop recursion result.

The undo nexthop recursive-lookup delay command restores the default configuration.

The nexthop recursive-lookup non-critical-event delay command configures a delay in responding to non-critical next-hop recursion changes.

The undo nexthop recursive-lookup non-critical-event delay command restores the default configuration.

By default, the delay in responding to non-critical next hop recursion changes is 10s, and the device does not delay responding to critical next hop recursion changes.

Format

nexthop recursive-lookup delay [ delay-time ]

nexthop recursive-lookup non-critical-event delay [ nonCrit-delay-time ]

undo nexthop recursive-lookup delay

undo nexthop recursive-lookup non-critical-event delay

Parameters

Parameter Description Value
delay-time

Specifies the delay in responding to next hop changes.

The value is an integer ranging from 1 to 100, in seconds. By default, the value is 5s.

nonCrit-delay-time

Indicates the delay in responding to non-critical recursion changes.

The value is an integer ranging from 0 to 100, in seconds. The default value is 10.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If repeated recursion causes the BGP next hop to frequently change on a device, the device frequently selects and advertises routes. To prevent unwanted re-routing and route advertisement, run the nexthop recursive-lookup delay command to enable the device to respond to BGP recursion changes after a specified delay time. The recursion results are as follows:

  • Critical recursion result change: The recursive next hop is changed, and BGP route reachability is also changed. For example, if a fault occurs on a network, a device finds no next-hop route or tunnel to which a BGP route recurses. As a result, traffic is interrupted.
  • Non-critical recursion result change: The recursive next hop is changed, and BGP route reachability is not affected. For example, after the interface or type of a tunnel to which the next hop of a BGP route recurses is changed, traffic keeps traveling over the BGP route.

Configuration Impact

After the nexthop recursive-lookup delay command is run, the device delays responses to all recursion changes. After the nexthop recursive-lookup non-critical-event delay command is run, the device delays responses only to non-critical BGP recursion changes. If both commands are run, the nexthop recursive-lookup non-critical-event delay command takes precedence over the nexthop recursive-lookup delay command

Precautions

The delay time specified in the nexthop recursive-lookup non-critical-event delay command must be greater than or equal to that specified in the nexthop recursive-lookup delay command if both commands are run.

Delayed response to BGP next hop recursion changes applies only to scenarios where multiple links exist between the downstream device and the same destination. If there is only one link between the next hop and the destination, configuring the BGP next hop delayed response may cause heavier traffic loss when the link fails because link switching is impossible.

Example

# Enable the device to respond to non-critical MBGP recursion changes after a 10-second delay.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] nexthop recursive-lookup non-critical-event delay 10

nexthop recursive-lookup delay (BGP-VPN instance IPv4 address family view)

Function

The nexthop recursive-lookup delay command configures a delay in responding to changes in the next hop recursion result.

The undo nexthop recursive-lookup delay command restores the default configuration.

The nexthop recursive-lookup non-critical-event delay command configures a delay in responding to non-critical next-hop recursion result changes.

The undo nexthop recursive-lookup non-critical-event delay command restores the default configuration.

By default, the delay in responding to non-critical next hop recursion changes is 10s, and the device does not delay responding to critical next hop recursion changes.

Format

nexthop recursive-lookup delay [ delay-time ]

nexthop recursive-lookup non-critical-event delay [ nonCrit-delay-time ]

undo nexthop recursive-lookup delay

undo nexthop recursive-lookup non-critical-event delay

Parameters

Parameter Description Value
delay-time

Specifies the delay in responding to recursion changes.

The value is an integer that ranges from 1 to 100, in seconds. The default value is 5 seconds.

nonCrit-delay-time

Indicates the delay in responding to non-critical recursion changes.

The value is an integer ranging from 0 to 100, in seconds. The default value is 10.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If repeated recursion causes the BGP next hop to frequently change on a device, the device frequently selects and advertises routes. To prevent unwanted re-routing and route advertisement, run the

nexthop recursive-lookup delay command to enable the device to respond to BGP recursion changes after a specified delay time. The recursion results are as follows:

  • Critical recursion result change: The recursive next hop is changed, and BGP route reachability is also changed. For example, if a fault occurs on a network, a device finds no next-hop route or tunnel to which a BGP route recurses. As a result, traffic is interrupted.
  • Non-critical recursion result change: The recursive next hop is changed, and BGP route reachability is not affected. For example, after the interface or type of a tunnel to which the next hop of a BGP route recurses is changed, traffic keeps traveling over the BGP route.

Configuration Impact

After the nexthop recursive-lookup delay command is run, the device delays responses to all recursion changes. After the nexthop recursive-lookup non-critical-event delay command is run, the device delays responses only to non-critical BGP recursion changes. If both commands are run, the nexthop recursive-lookup non-critical-event delay command takes precedence over the nexthop recursive-lookup delay command

Precautions

The delay time specified in the nexthop recursive-lookup non-critical-event delay command must be greater than or equal to that specified in the nexthop recursive-lookup delay command if both commands are run.

Delayed response to BGP next hop recursion changes applies only to scenarios where multiple links exist between the downstream device and the same destination. If there is only one link between the next hop and the destination, configuring the BGP next hop delayed response may cause heavier traffic loss when the link fails because link switching is impossible.

Example

# Enable the device to respond to non-critical MBGP recursion changes after a 10-second delay.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] nexthop recursive-lookup non-critical-event delay 10

nexthop recursive-lookup delay (BGP-VPN instance IPv6 address family view)

Function

The nexthop recursive-lookup delay command configures a delay in responding to changes in the next hop recursion result.

The undo nexthop recursive-lookup delay command restores the default configuration.

The nexthop recursive-lookup non-critical-event delay command configures a delay in responding to non-critical next-hop recursion changes.

The undo nexthop recursive-lookup non-critical-event delay command restores the default configuration.

By default, the delay in responding to non-critical next hop recursion changes is 10s, and the device does not delay responding to critical next hop recursion changes.

Format

nexthop recursive-lookup delay [ delay-time ]

nexthop recursive-lookup non-critical-event delay [ nonCrit-delay-time ]

undo nexthop recursive-lookup delay

undo nexthop recursive-lookup non-critical-event delay

Parameters

Parameter Description Value
delay-time

Specifies the delay in responding to next hop changes.

The value is an integer ranging from 1 to 100, in seconds. By default, the value is 5s.

nonCrit-delay-time

Indicates the delay in responding to non-critical recursion changes.

The value is an integer ranging from 0 to 100, in seconds. The default value is 10.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If repeated recursion causes the BGP next hop to frequently change on a device, the device frequently selects and advertises routes. To prevent unwanted re-routing and route advertisement, run the nexthop recursive-lookup delay command to enable the device to respond to BGP recursion changes after a specified delay time. The recursion results are as follows:

  • Critical recursion result change: The recursive next hop is changed, and BGP route reachability is also changed. For example, if a fault occurs on a network, a device finds no next-hop route or tunnel to which a BGP route recurses. As a result, traffic is interrupted.
  • Non-critical recursion result change: The recursive next hop is changed, and BGP route reachability is not affected. For example, after the interface or type of a tunnel to which the next hop of a BGP route recurses is changed, traffic keeps traveling over the BGP route.

Configuration Impact

After the nexthop recursive-lookup delay command is run, the device delays responses to all recursion changes. After the nexthop recursive-lookup non-critical-event delay command is run, the device delays responses only to non-critical BGP recursion changes. If both commands are run, the nexthop recursive-lookup non-critical-event delay command takes precedence over the nexthop recursive-lookup delay command

Precautions

The delay time specified in the nexthop recursive-lookup non-critical-event delay command must be greater than or equal to that specified in the nexthop recursive-lookup delay command if both commands are run.

Delayed response to BGP next hop recursion changes applies only to scenarios where multiple links exist between the downstream device and the same destination. If there is only one link between the next hop and the destination, configuring the BGP next hop delayed response may cause heavier traffic loss when the link fails because link switching is impossible.

Example

# Enable the device to respond to non-critical MBGP recursion changes after a 10-second delay.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vrf1
[HUAWEI-bgp-6-vrf1] nexthop recursive-lookup non-critical-event delay 10

nexthop recursive-lookup restrain (BGP view)

Function

The nexthop recursive-lookup restrain command configures the intervals for increasing, retaining, and clearing the penalty value for BGP recursion suppression in case of next hop flapping.

The undo nexthop recursive-lookup restrain command restores the default configuration.

By default, the intervals for increasing, retaining, and clearing the penalty value for BGP recursion suppression in case of next hop flapping are 60s, 120s, and 600s, respectively.

Format

nexthop recursive-lookup restrain suppress-interval add-count-time hold-interval hold-count-time clear-interval clear-count-time

undo nexthop recursive-lookup restrain suppress-interval hold-interval clear-interval

Parameters

Parameter Description Value
hold-interval hold-count-time

Specifies the interval for retaining the penalty value for recursion suppression.

The value is an integer ranging from 1 to 65535, in seconds. The default values is recommended.

clear-interval clear-count-time

Specifies the interval for clearing the penalty value for recursion suppression.

The value is an integer ranging from 1 to 65535, in seconds. The default values is recommended.

suppress-interval add-count-time

Specifies the interval for increasing the penalty value for recursion suppression.

The value is an integer ranging from 1 to 65535, in seconds. The default value is recommended.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a large number of routes are recursed to the same next hop and the next hop flaps frequently, the system frequently processes the changes of these routes, consuming a large number of resources and causing high CPU usage. To address this problem, recursion suppression in case of next hop flapping is enabled by default. This function slows down route processing, saves system resources, and reduces CPU usage.

After recursion suppression in case of next hop flapping is enabled, BGP compares the interval between two next hop flappings with the configured threshold, and increases, maintains, or clears the suppression count based on the comparison result. When the suppression count reaches a certain value (greater than 10), suppresses recursion in case of next hop flapping. Assume that the time threshold for suppressing the penalty count is T1, the time threshold for keeping the penalty count is T2, and the time threshold for clearing the penalty count is T3. The detailed processing is as follows:

  • If the interval between two next hop flappings is less than T1, the penalty count increases by 1.
  • If the interval between two next hop flappings is greater than or equal to T1 and less than T2, the penalty count remains unchanged.
  • If the interval between two next hop flappings is greater than or equal to T2 and less than T3, the penalty count decreases by 1.
  • If the interval between two next hop flappings is greater than or equal to T3, the penalty count is cleared.

Example

# Set the intervals for increasing, retaining, and clearing the penalty value for BGP recursion suppression in case of next hop flapping to 30s, 60s, and 120s, respectively.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] nexthop recursive-lookup restrain suppress-interval 30 hold-interval 60 clear-interval 120

nexthop recursive-lookup restrain disable

Function

The nexthop recursive-lookup restrain disable command disables BGP recursion suppression in case of next hop flapping.

The undo nexthop recursive-lookup restrain disable command enables BGP recursion suppression in case of next hop flapping.

By default, BGP recursion suppression in case of next hop flapping is enabled.

Format

nexthop recursive-lookup restrain disable

undo nexthop recursive-lookup restrain disable

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a large number of routes are recursed to the same next hop and the next hop flaps frequently, the system frequently processes the changes of these routes, consuming a large number of resources and causing high CPU usage. To address this problem, recursion suppression in case of next hop flapping is enabled by default. This function slows down route processing, saves system resources, and reduces CPU usage.

If you do not want to slow down recursion processing or do not care about the high CPU usage caused by recursion change processing, run the nexthop recursive-lookup restrain disable command to disable recursion suppression in case of next hop flapping.

Example

# Disable BGP recursion suppression in case of next hop flapping in the BGP-IPv4 unicast address family view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] nexthop recursive-lookup restrain disable

nexthop recursive-lookup restrain disable (BGP multi-instance VPN instance IPv4 address family view)

Function

The nexthop recursive-lookup restrain disable command disables BGP recursion suppression in case of next hop flapping.

The undo nexthop recursive-lookup restrain disable command enables BGP recursion suppression in case of next hop flapping.

By default, BGP recursion suppression in case of next hop flapping is enabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

nexthop recursive-lookup restrain disable

undo nexthop recursive-lookup restrain disable

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a large number of routes are recursed to the same next hop and the next hop flaps frequently, the system frequently processes the changes of these routes, consuming a large number of resources and causing high CPU usage. To address this problem, recursion suppression in case of next hop flapping is enabled by default. This function slows down route processing, saves system resources, and reduces CPU usage.

If you do not want to slow down recursion processing or do not care about the high CPU usage caused by recursion change processing, run the nexthop recursive-lookup restrain disable command to disable recursion suppression in case of next hop flapping.

Example

# Disable BGP recursion suppression in case of next hop flapping.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] nexthop recursive-lookup restrain disable

nexthop recursive-lookup restrain disable (BGP view)

Function

The nexthop recursive-lookup restrain disable command disables BGP recursion suppression in case of next hop flapping.

The undo nexthop recursive-lookup restrain disable command enables BGP recursion suppression in case of next hop flapping.

By default, BGP recursion suppression in case of next hop flapping is enabled.

Format

nexthop recursive-lookup restrain disable

undo nexthop recursive-lookup restrain disable

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a large number of routes are recursed to the same next hop and the next hop flaps frequently, the system frequently processes the changes of these routes, consuming a large number of resources and causing high CPU usage. To address this problem, recursion suppression in case of next hop flapping is enabled by default. This function slows down route processing, saves system resources, and reduces CPU usage.

If you do not want to slow down recursion processing or do not care about the high CPU usage caused by recursion change processing, run the nexthop recursive-lookup restrain disable command to disable recursion suppression in case of next hop flapping.

Example

# Disable BGP recursion suppression in case of next hop flapping.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] nexthop recursive-lookup restrain disable

nexthop recursive-lookup restrain disable (BGP-VPN instance IPv4 address family view)

Function

The nexthop recursive-lookup restrain disable command disables BGP recursion suppression in case of next hop flapping.

The undo nexthop recursive-lookup restrain disable command enables BGP recursion suppression in case of next hop flapping.

By default, BGP recursion suppression in case of next hop flapping is enabled.

Format

nexthop recursive-lookup restrain disable

undo nexthop recursive-lookup restrain disable

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a large number of routes are recursed to the same next hop and the next hop flaps frequently, the system frequently processes the changes of these routes, consuming a large number of resources and causing high CPU usage. To address this problem, recursion suppression in case of next hop flapping is enabled by default. This function slows down route processing, saves system resources, and reduces CPU usage.

If you do not want to slow down recursion processing or do not care about the high CPU usage caused by recursion change processing, run the nexthop recursive-lookup restrain disable command to disable recursion suppression in case of next hop flapping.

Example

# Disable BGP recursion suppression in case of next hop flapping.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] nexthop recursive-lookup restrain disable

nexthop recursive-lookup route-policy

Function

The nexthop recursive-lookup route-policy command configures route-policy next hop recursion.

The undo nexthop recursive-lookup route-policy command disables route-policy next hop recursion.

By default, route-policy-based next hop recursion is disabled.

Format

nexthop recursive-lookup route-policy route-policy-name

undo nexthop recursive-lookup route-policy

Parameters

Parameter Description Value
route-policy-name

Indicates the name of a route-policy.

The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP needs route recursion in case of next hops. If route recursion is not limited, BGP routes may be incorrectly iterated, causing traffic loss. Therefore, next hops should perform recursion according to certain conditions.

To control route recursion based on a route-policy, run the nexthop recursive-lookup route-policy command. If a target recursive route is filtered out by the route-policy, the route is considered unreachable. In this manner, BGP route recursion will fail.

Prerequisites

The target recursive route has been determined, and a route-policy has been configured.

Note:

Before configuring a route-policy, ensure that all desired target recursive routes will not be filtered out by the route-policy.

Precautions

The command does not apply to the routes received from LinkLocal peers.

Example

# Configure BGP to filter routes based on a specified route-policy.
<HUAWEI> system-view
[HUAWEI] route-policy aa permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] nexthop recursive-lookup route-policy aa

nexthop recursive-lookup route-policy (BGP multi-instance VPN instance IPv4 address family view)

Function

The nexthop recursive-lookup route-policy command configures route-policy next hop recursion.

The undo nexthop recursive-lookup route-policy command disables route-policy next hop recursion.

By default, route-policy-based next hop recursion is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

nexthop recursive-lookup route-policy route-policy-name

undo nexthop recursive-lookup route-policy

Parameters

Parameter Description Value
route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP needs route recursion in case of next hops. If route recursion is not limited, BGP routes may be incorrectly iterated, causing traffic loss. Therefore, next hops should perform recursion according to certain conditions.

To control route recursion based on a route-policy, run the nexthop recursive-lookup route-policy command. If a target recursive route is filtered out by the route-policy, the route is considered unreachable. In this manner, BGP route recursion will fail.

Prerequisites

The target recursive route has been determined, and a route-policy has been configured.

Note:

Before configuring a route-policy, ensure that all desired target recursive routes will not be filtered out by the route-policy.

Precautions

The command does not apply to the routes received from LinkLocal peers.

Example

# Configure BGP to filter routes based on a specified route-policy.
<HUAWEI> system-view
[HUAWEI] route-policy rp_nexthop permit node 0
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] nexthop recursive-lookup route-policy rp_nexthop

nexthop recursive-lookup route-policy (BGP-IPv4 unicast address family view)

Function

The nexthop recursive-lookup route-policy command configures route-policy next hop recursion.

The undo nexthop recursive-lookup route-policy command disables route-policy next hop recursion.

By default, route-policy-based next hop recursion is disabled.

Format

nexthop recursive-lookup route-policy route-policy-name

undo nexthop recursive-lookup route-policy

Parameters

Parameter Description Value
route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP needs route recursion in case of next hops. If route recursion is not limited, BGP routes may be incorrectly iterated, causing traffic loss. Therefore, next hops should perform recursion according to certain conditions.

To control route recursion based on a route-policy, run the nexthop recursive-lookup route-policy command. If a target recursive route is filtered out by the route-policy, the route is considered unreachable. In this manner, BGP route recursion will fail.

Prerequisites

The target recursive route has been determined, and a route-policy has been configured.

Note:

Before configuring a route-policy, ensure that all desired target recursive routes will not be filtered out by the route-policy.

Precautions

The command does not apply to the routes received from LinkLocal peers.

Example

# Configure BGP to filter routes based on a specified route-policy.
<HUAWEI> system-view
[HUAWEI] route-policy aa permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] nexthop recursive-lookup route-policy aa

nexthop recursive-lookup route-policy (BGP-IPv6 unicast address family view)

Function

The nexthop recursive-lookup route-policy command configures route-policy next hop recursion.

The undo nexthop recursive-lookup route-policy command disables route-policy next hop recursion.

By default, route-policy-based next hop recursion is disabled.

Format

nexthop recursive-lookup route-policy route-policy-name

undo nexthop recursive-lookup route-policy

Parameters

Parameter Description Value
route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP needs route recursion in case of next hops. If route recursion is not limited, BGP routes may be incorrectly iterated, causing traffic loss. Therefore, next hops should perform recursion according to certain conditions.

To control route recursion based on a route-policy, run the nexthop recursive-lookup route-policy command. If a target recursive route is filtered out by the route-policy, the route is considered unreachable. In this manner, BGP route recursion will fail.

Prerequisites

The target recursive route has been determined, and a route-policy or the route-filter has been configured.

Note:

Before configuring a route-policy, ensure that all desired target recursive routes will not be filtered out by the route-policy.

Precautions

The command does not apply to the routes received from LinkLocal peers.

Example

# Configure BGP to filter routes based on a specified route-policy.
<HUAWEI> system-view
[HUAWEI] route-policy aa permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] nexthop recursive-lookup route-policy aa

nexthop recursive-lookup route-policy (BGP-VPN instance IPv4 address family view)

Function

The nexthop recursive-lookup route-policy command configures route-policy next hop recursion.

The undo nexthop recursive-lookup route-policy command disables route-policy next hop recursion.

By default, route-policy-based next hop recursion is disabled.

Format

nexthop recursive-lookup route-policy route-policy-name

undo nexthop recursive-lookup route-policy

Parameters

Parameter Description Value
route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP needs route recursion in case of next hops. If route recursion is not limited, BGP routes may be incorrectly iterated, causing traffic loss. Therefore, next hops should perform recursion according to certain conditions.

To control route recursion based on a route-policy, run the nexthop recursive-lookup route-policy command. If a target recursive route is filtered out by the route-policy, the route is considered unreachable. In this manner, BGP route recursion will fail.

Prerequisites

The target recursive route has been determined, and a route-policy or the route-filter has been configured.

Note:

Before configuring a route-policy, ensure that all desired target recursive routes will not be filtered out by the route-policy.

Precautions

The command does not apply to the routes received from LinkLocal peers.

Example

# Configure BGP to filter routes based on a specified route-policy.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] route-policy aa permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-instance-vpna] quit
[HUAWEI-bgp] ipv4-labeled-unicast vpn-instance vpna
[HUAWEI-bgp-labeled-vpna] nexthop recursive-lookup route-policy aa

nexthop recursive-lookup route-policy (BGP-VPN instance IPv6 address family view)

Function

The nexthop recursive-lookup route-policy command configures route-policy next hop recursion.

The undo nexthop recursive-lookup route-policy command disables route-policy next hop recursion.

By default, route-policy-based next hop recursion is disabled.

Format

nexthop recursive-lookup route-policy route-policy-name

undo nexthop recursive-lookup route-policy

Parameters

Parameter Description Value
route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP needs route recursion in case of next hops. If route recursion is not limited, BGP routes may be incorrectly iterated, causing traffic loss. Therefore, next hops should perform recursion according to certain conditions.

To control route recursion based on a route-policy, run the nexthop recursive-lookup route-policy command. If a target recursive route is filtered out by the route-policy, the route is considered unreachable. In this manner, BGP route recursion will fail.

Prerequisites

The target recursive route has been determined, and a route-policy has been configured.

Note:

Before configuring a route-policy, ensure that all desired target recursive routes will not be filtered out by the route-policy.

Precautions

The command does not apply to the routes received from LinkLocal peers.

Example

# Configure BGP to filter routes based on a specified route-policy.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] route-policy aa permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] nexthop recursive-lookup route-policy aa

nexthop third-party (BGP multi-instance VPN instance IPv4 address family view)

Function

The nexthop third-party command prevents a BGP speaker from changing the next hop address of a route when the BGP speaker advertises the route to its peers in the following scenarios:

- The route is learned from a directly connected peer and is to be advertised to a directly connected EBGP peer, the original next hop of the route resides on the same network segment as the local interface that is used to establish the BGP peer relationship with the EBGP peer, and all directly connected interfaces are broadcast interfaces.

- The route is locally imported and is to be advertised to a directly connected IBGP or EBGP peer, the next hop to which the route recurses resides on the same network segment as the local interface that is used to establish the BGP peer relationship with the IBGP or EBGP peer, and all directly connected interfaces are broadcast interfaces.

The undo nexthop third-party command restores the default configurations.

The default configurations are as follows:

  • Before advertising a route that is learned from a directly connected peer to a directly connected EBGP peer, the device changes the next hop of the route to the IP address of the local interface that is used to establish the BGP peer relationship with the EBGP peer.
  • Before advertising a locally imported route to a directly connected IBGP or EBGP peer, the device changes the next hop of the route to the IP address of the local interface that is used to establish the BGP peer relationship with the IBGP or EBGP peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

nexthop third-party

undo nexthop third-party

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a Layer 2 protocol tunneling scenario, to ensure that traffic is transmitted along the optimal route, run the nexthop third-party command.

Precautions

If the command and load balancing function are both configured, this command does not take effect.

Example

# Prevent a BGP speaker from changing the next hop address of a route when the BGP speaker advertises the route to a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] nexthop third-party

nexthop third-party (BGP view)

Function

The nexthop third-party command prevents a BGP speaker from changing the next hop address of a route when the BGP speaker advertises the route to its peers in the following scenarios:

- The route is learned from a directly connected peer and is to be advertised to a directly connected EBGP peer, the original next hop of the route resides on the same network segment as the local interface that is used to establish the BGP peer relationship with the EBGP peer, and all directly connected interfaces are broadcast interfaces.

- The route is locally imported and is to be advertised to a directly connected IBGP or EBGP peer, the next hop to which the route recurses resides on the same network segment as the local interface that is used to establish the BGP peer relationship with the IBGP or EBGP peer, and all directly connected interfaces are broadcast interfaces.

The undo nexthop third-party command restores the default configurations.

The default configurations are as follows:

  • Before advertising a route that is learned from a directly connected peer to a directly connected EBGP peer, the device changes the next hop of the route to the IP address of the local interface that is used to establish the BGP peer relationship with the EBGP peer.
  • Before advertising a locally imported route to a directly connected IBGP or EBGP peer, the device changes the next hop of the route to the IP address of the local interface that is used to establish the BGP peer relationship with the IBGP or EBGP peer.

Format

nexthop third-party

undo nexthop third-party

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a Layer 2 protocol tunneling scenario, to ensure that traffic is transmitted along the optimal route, run the nexthop third-party command.

Precautions

If the command and load balancing function are both configured, this command does not take effect.

Example

# Prevent a BGP speaker from changing the next hop address of a route when the BGP speaker advertises the route to a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] nexthop third-party

nexthop third-party (BGP-IPv4 unicast address family view)

Function

The nexthop third-party command prevents a BGP speaker from changing the next hop address of a route when the BGP speaker advertises the route to its peers in the following scenarios:

- The route is learned from a directly connected peer and is to be advertised to a directly connected EBGP peer, the original next hop of the route resides on the same network segment as the local interface that is used to establish the BGP peer relationship with the EBGP peer, and all directly connected interfaces are broadcast interfaces.

- The route is locally imported and is to be advertised to a directly connected IBGP or EBGP peer, the next hop to which the route recurses resides on the same network segment as the local interface that is used to establish the BGP peer relationship with the IBGP or EBGP peer, and all directly connected interfaces are broadcast interfaces.

The undo nexthop third-party command restores the default configurations.

The default configurations are as follows:

  • Before advertising a route that is learned from a directly connected peer to a directly connected EBGP peer, the device changes the next hop of the route to the IP address of the local interface that is used to establish the BGP peer relationship with the EBGP peer.
  • Before advertising a locally imported route to a directly connected IBGP or EBGP peer, the device changes the next hop of the route to the IP address of the local interface that is used to establish the BGP peer relationship with the IBGP or EBGP peer.

Format

nexthop third-party

undo nexthop third-party

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a Layer 2 protocol tunneling scenario, to ensure that traffic is transmitted along the optimal route, run the nexthop third-party command.

Precautions

If the command and load balancing function are both configured, this command does not take effect.

Example

# Prevent a BGP speaker from changing the next hop address of a route when the BGP speaker advertises the route to a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] nexthop third-party

nexthop third-party (BGP-IPv6 unicast address family view)

Function

The nexthop third-party command prevents a BGP speaker from changing the next hop address of a route when the BGP speaker advertises the route to its peers in the following scenarios:

- The route is learned from a directly connected peer and is to be advertised to a directly connected EBGP peer, the original next hop of the route resides on the same network segment as the local interface that is used to establish the BGP peer relationship with the EBGP peer, and all directly connected interfaces are broadcast interfaces.

- The route is locally imported and is to be advertised to a directly connected IBGP or EBGP peer, the next hop to which the route recurses resides on the same network segment as the local interface that is used to establish the BGP peer relationship with the IBGP or EBGP peer, and all directly connected interfaces are broadcast interfaces.

The undo nexthop third-party command restores the default configurations.

The default configurations are as follows:

  • Before advertising a route that is learned from a directly connected peer to a directly connected EBGP peer, the device changes the next hop of the route to the IP address of the local interface that is used to establish the BGP peer relationship with the EBGP peer.
  • Before advertising a locally imported route to a directly connected IBGP or EBGP peer, the device changes the next hop of the route to the IP address of the local interface that is used to establish the BGP peer relationship with the IBGP or EBGP peer.

Format

nexthop third-party

undo nexthop third-party

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a Layer 2 protocol tunneling scenario, to ensure that traffic is transmitted along the optimal route, run the nexthop third-party command.

Precautions

If the command and load balancing function are both configured, this command does not take effect.

Example

# Prevent a BGP speaker from changing the next hop address of a route when the BGP speaker advertises the route to a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] nexthop third-party

nexthop third-party (BGP-VPN instance IPv4 address family view)

Function

The nexthop third-party command prevents a BGP speaker from changing the next hop address of a route when the BGP speaker advertises the route to its peers in the following scenarios:

- The route is learned from a directly connected peer and is to be advertised to a directly connected EBGP peer, the original next hop of the route resides on the same network segment as the local interface that is used to establish the BGP peer relationship with the EBGP peer, and all directly connected interfaces are broadcast interfaces.

- The route is locally imported and is to be advertised to a directly connected IBGP or EBGP peer, the next hop to which the route recurses resides on the same network segment as the local interface that is used to establish the BGP peer relationship with the IBGP or EBGP peer, and all directly connected interfaces are broadcast interfaces.

The undo nexthop third-party command restores the default configurations.

The default configurations are as follows:

  • Before advertising a route that is learned from a directly connected peer to a directly connected EBGP peer, the device changes the next hop of the route to the IP address of the local interface that is used to establish the BGP peer relationship with the EBGP peer.
  • Before advertising a locally imported route to a directly connected IBGP or EBGP peer, the device changes the next hop of the route to the IP address of the local interface that is used to establish the BGP peer relationship with the IBGP or EBGP peer.

Format

nexthop third-party

undo nexthop third-party

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a Layer 2 protocol tunneling scenario, to ensure that traffic is transmitted along the optimal route, run the nexthop third-party command.

Precautions

If the command and load balancing function are both configured, this command does not take effect.

Example

# Prevent a BGP speaker from changing the next hop address of a route when the BGP speaker advertises the route to a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 22:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 5:5 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] nexthop third-party

nexthop third-party (BGP-VPN instance IPv6 address family view)

Function

The nexthop third-party command prevents a BGP speaker from changing the next hop address of a route when the BGP speaker advertises the route to its peers in the following scenarios:

- The route is learned from a directly connected peer and is to be advertised to a directly connected EBGP peer, the original next hop of the route resides on the same network segment as the local interface that is used to establish the BGP peer relationship with the EBGP peer, and all directly connected interfaces are broadcast interfaces.

- The route is locally imported and is to be advertised to a directly connected IBGP or EBGP peer, the next hop to which the route recurses resides on the same network segment as the local interface that is used to establish the BGP peer relationship with the IBGP or EBGP peer, and all directly connected interfaces are broadcast interfaces.

The undo nexthop third-party command restores the default configurations.

The default configurations are as follows:

  • Before advertising a route that is learned from a directly connected peer to a directly connected EBGP peer, the device changes the next hop of the route to the IP address of the local interface that is used to establish the BGP peer relationship with the EBGP peer.
  • Before advertising a locally imported route to a directly connected IBGP or EBGP peer, the device changes the next hop of the route to the IP address of the local interface that is used to establish the BGP peer relationship with the IBGP or EBGP peer.

Format

nexthop third-party

undo nexthop third-party

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a Layer 2 protocol tunneling scenario, to ensure that traffic is transmitted along the optimal route, run the nexthop third-party command.

Precautions

If the command and load balancing function are both configured, this command does not take effect.

Example

# Prevent a BGP speaker from changing the next hop address of a route when the BGP speaker advertises the route to a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vrf1
[HUAWEI-vpn-instance-vrf1] ipv6-family
[HUAWEI-vpn-instance-vrf1-af-ipv6] quit
[HUAWEI-vpn-instance-vrf1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vrf1
[HUAWEI-bgp-6-vrf1] nexthop third-party

peer (listen-only / connect-only) (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer listen-only command configures a peer group to only listen to connection requests and not to initiatively send connection requests.

The undo peer listen-only command cancels the function.

The peer connect-only command configures a peer group to send connection requests but rejects connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer group listens to and accepts connection requests and sends connection requests.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name { listen-only | connect-only }

undo peer group-name { listen-only | connect-only }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer group to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer group to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Configure peer group to only listen to connection requests from the remote peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test listen-only

peer (listen-only / connect-only) (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer listen-only command configures a peer group to only listen to connection requests and not to initiatively send connection requests.

The undo peer listen-only command cancels the function.

The peer connect-only command configures a peer group to send connection requests but rejects connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer listens to and accepts connection requests, and sends connection requests.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address { listen-only | connect-only }

undo peer ipv4-address { listen-only | connect-only }

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Enable peer to send connection requests but rejects connection requests.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 connect-only

peer (listen-only / connect-only) (BGP view)(IPv4)

Function

The peer listen-only command configures a peer group to only listen to connection requests and not to initiatively send connection requests.

The undo peer listen-only command cancels the function.

The peer connect-only command configures a peer group to send connection requests but rejects connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer listens to and accepts connection requests, and sends connection requests.

Format

peer ipv4-address { listen-only | connect-only }

undo peer ipv4-address { listen-only | connect-only }

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Enable peer to send connection requests but rejects connection requests.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 connect-only

peer (listen-only / connect-only) (BGP-VPN instance IPv4 address family view) (group)

Function

The peer listen-only command configures a peer group to only listen to connection requests and not to initiatively send connection requests.

The undo peer listen-only command cancels the function.

The peer connect-only command configures a peer group to send connection requests but rejects connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer group listens to and accepts connection requests and sends connection requests.

Format

peer group-name { listen-only | connect-only }

undo peer group-name { listen-only | connect-only }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer group to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer group to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Enable a peer group to send connection requests but reject connection requests.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test
[HUAWEI-bgp-vpn1] peer test connect-only

peer (listen-only / connect-only) (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer listen-only command configures a peer group to only listen to connection requests and not to initiatively send connection requests.

The undo peer listen-only command cancels the function.

The peer connect-only command configures a peer group to send connection requests but rejects connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer listens to and accepts connection requests, and sends connection requests.

Format

peer ipv4-address { listen-only | connect-only }

undo peer ipv4-address { listen-only | connect-only }

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Enable peer to send connection requests but rejects connection requests.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 connect-only

peer (listen-only / connect-only) (BGP-VPN instance view)(IPv4)

Function

The peer listen-only command configures a peer group to only listen to connection requests and not to initiatively send connection requests.

The undo peer listen-only command cancels the function.

The peer connect-only command configures a peer group to send connection requests but rejects connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer listens to and accepts connection requests, and sends connection requests.

Format

peer ipv4-address { listen-only | connect-only }

undo peer ipv4-address { listen-only | connect-only }

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Enable peer to send connection requests but rejects connection requests.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 connect-only

peer advertise add-path path-number (BGP-IPv4 unicast address family view) (group)

Function

The peer advertise add-path path-number command sets the number of preferred routes to be advertised to a specified peer group.

The undo peer advertise add-path command restores the default configurations.

By default, BGP advertises only the optimal route to a peer group.

Format

peer groupName advertise add-path path-number number [ route-policy route-policy-name ]

undo peer groupName advertise add-path

undo peer groupName advertise add-path path-number number route-policy route-policy-name

Parameters

Parameter Description Value
groupName

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

path-number number

Specifies the number of preferred routes.

The value is an integer ranging from 2 to 64.

route-policy route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After BGP Add-Path is configured on an RR, the RR needs to send BGP Add-Path routes to a specified BGP peer. To configure the maximum number of routes that the RR can send to a specified BGP peer, run the peer advertise add-path path-number command. The actual number of preferred routes advertised to the peer is the smaller value between the number of routes configured using the peer advertise add-path path-number command and the number of selected routes. If the number of routes that the RR can send to the peer is less than the actual number of routes selected by the RR, the RR selects routes based on the BGP route selection rules.

Prerequisites

The peer advertise add-path path-number command takes effect only if the following conditions are met:

  • BGP Add-Path has been enabled and the number of routes that the device can select has been configured using the bestroute add-path command.
  • The device has been enabled to send Add-Path routes to a specified peer using the peer capability-advertise add-path send command.

Precautions

To allow a device to accept Add-Path routes received from a specified peer, run the peer capability-advertise add-path receive command.

A device can advertise Add-Path routes to IBGP/EBGP peers, and Add-Path routes are advertised based on existing route advertisement rules.

This command supports only if-match, but not the apply action.

Deploying BGP Add-Path may cause traffic loops. Therefore, exercise caution when configuring BGP Add-Path.

Example

# Configure the device to advertise three preferred routes to a peer group.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] bestroute add-path path-number 6
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer test as-number 100
[HUAWEI-bgp] peer test capability-advertise add-path send
[HUAWEI-bgp] peer test advertise add-path path-number 3 route-policy test-policy

peer advertise add-path path-number (BGP-IPv6 unicast address family view) (group)

Function

The peer advertise add-path path-number command sets the number of preferred routes to be advertised to a specified peer group.

The undo peer advertise add-path command restores the default configurations.

By default, the device sends only the optimal route to a peer group.

Format

peer groupName advertise add-path path-number number [ route-policy route-policy-name ]

undo peer groupName advertise add-path

undo peer groupName advertise add-path path-number number route-policy route-policy-name

Parameters

Parameter Description Value
groupName

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

path-number number

Specifies the maximum number of routes that the device can send to a peer.

The value is an integer ranging from 2 to 64.

route-policy route-policy-name

Specifies the name of a route-policy.

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

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After BGP Add-Path is configured on an RR, the RR needs to send BGP Add-Path routes to a specified peer group. To configure the maximum number of routes that the RR can send to a specified peer group, run the peer advertise add-path path-number command. The actual number of preferred routes to be advertised to a peer group is the smaller value between the number of routes configured using the peer advertise add-path path-number command and the number of selected routes. If the number of routes to be sent to a peer group is less than the number of optimal routes, BGP selects routes based on BGP route selection rules.

Prerequisites

The peer advertise add-path path-number command takes effect only if the following conditions are met:

  • BGP Add-Path has been enabled and the number of routes that the device can select has been configured using the bestroute add-path command.
  • The device has been enabled to send Add-Path routes to a specified peer using the peer capability-advertise add-path send command.

Precautions

To allow a device to accept Add-Path routes received from a specified peer, run the peer capability-advertise add-path receive command.

A device can advertise Add-Path routes to IBGP/EBGP peers, and Add-Path routes are advertised based on existing route advertisement rules.

This command supports only if-match, but not the apply action.

Deploying BGP Add-Path may cause traffic loops. Therefore, exercise caution when configuring BGP Add-Path.

Example

# Configure the device to advertise three preferred routes to a peer group.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] bestroute add-path path-number 6
[HUAWEI-bgp-af-ipv6] peer test capability-advertise add-path send
[HUAWEI-bgp-af-ipv6] peer test advertise add-path path-number 3 route-policy test-policy

peer advertise add-path path-number(BGP-IPv4 unicast address family view)

Function

The peer advertise add-path path-number command sets the number of preferred routes to be advertised to a specified peer.

The undo peer advertise add-path command restores the default configurations.

By default, BGP advertises only one optimal route to its peer.

Format

peer peerIpv4Addr advertise add-path path-number number [ route-policy route-policy-name ]

undo peer peerIpv4Addr advertise add-path

undo peer peerIpv4Addr advertise add-path path-number number route-policy route-policy-name

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

path-number number

Specifies the maximum number of routes that the device can send to a peer.

The value is an integer ranging from 2 to 64.

route-policy route-policy-name

Specifies the name of a route-policy.

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

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After BGP Add-Path is configured on an RR, the RR needs to send BGP Add-Path routes to a specified BGP peer. To configure the maximum number of routes that the RR can send to a specified BGP peer, run the peer advertise add-path path-number command. The actual number of preferred routes advertised to the peer is the smaller value between the number of routes configured using the peer advertise add-path path-number command and the number of selected routes. If the number of routes that the RR can send to the peer is less than the actual number of routes selected by the RR, the RR selects routes based on the BGP route selection rules.

Prerequisites

The peer advertise add-path path-number command takes effect only if the following conditions are met:

  • BGP Add-Path has been enabled and the number of routes that the device can select has been configured using the bestroute add-path command.
  • The device has been enabled to send Add-Path routes to a specified peer using the peer capability-advertise add-path send command.

Precautions

To allow a device to accept Add-Path routes received from a specified peer, run the peer capability-advertise add-path receive command.

A device can advertise Add-Path routes to IBGP/EBGP peers, and Add-Path routes are advertised based on existing route advertisement rules.

This command supports only if-match, but not the apply action.

Deploying BGP Add-Path may cause traffic loops. Therefore, exercise caution when configuring BGP Add-Path.

Example

# Configure the device to advertise three preferred routes to a peer.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] bestroute add-path path-number 6
[HUAWEI-bgp] peer 172.16.1.1 as-number 100
[HUAWEI-bgp] peer 172.16.1.1 capability-advertise add-path send
[HUAWEI-bgp] peer 172.16.1.1 advertise add-path path-number 3 route-policy test-policy

peer advertise add-path path-number(BGP-IPv6 unicast address family view)

Function

The peer advertise add-path path-number command sets the number of preferred routes to be advertised to a specified peer.

The undo peer advertise add-path command restores the default configurations.

By default, the device sends only the optimal route to peers.

Format

peer peerIpv4Addr advertise add-path path-number number [ route-policy route-policy-name ]

undo peer peerIpv4Addr advertise add-path

undo peer peerIpv4Addr advertise add-path path-number number route-policy route-policy-name

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

path-number number

Specifies the number of preferred routes.

The value is an integer ranging from 2 to 64.

route-policy route-policy-name

Specifies the name of a route-policy.

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

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After BGP Add-Path is configured on an RR, the RR needs to send BGP Add-Path routes to a specified BGP peer. To configure the maximum number of routes that the RR can send to a specified BGP peer, run the peer advertise add-path path-number command. The actual number of preferred routes advertised to the peer is the smaller value between the number of routes configured using the peer advertise add-path path-number command and the number of selected routes. If the number of routes that the RR can send to the peer is less than the actual number of routes selected by the RR, the RR selects routes based on the BGP route selection rules.

Prerequisites

The peer advertise add-path path-number command takes effect only if the following conditions are met:

  • BGP Add-Path has been enabled and the number of routes that the device can select has been configured using the bestroute add-path command.
  • The device has been enabled to send Add-Path routes to a specified peer using the peer capability-advertise add-path send command.

Precautions

To allow a device to accept Add-Path routes received from a specified peer, run the peer capability-advertise add-path receive command.

A device can advertise Add-Path routes to IBGP/EBGP peers, and Add-Path routes are advertised based on existing route advertisement rules.

This command supports only if-match, but not the apply action.

Deploying BGP Add-Path may cause traffic loops. Therefore, exercise caution when configuring BGP Add-Path.

Example

# Configure the device to advertise three preferred routes to a peer.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 172.16.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 172.16.1.1 enable
[HUAWEI-bgp-af-ipv6] bestroute add-path path-number 6
[HUAWEI-bgp-af-ipv6] peer 172.16.1.1 capability-advertise add-path send
[HUAWEI-bgp-af-ipv6] peer 172.16.1.1 advertise add-path path-number 3 route-policy test-policy

peer advertise add-path path-number(BGP-IPv6 unicast address family view) (IPv6)

Function

The peer advertise add-path path-number command sets the number of preferred routes to be advertised to a specified peer.

The undo peer advertise add-path command restores the default configurations.

By default, the device sends only the optimal route to a peer group.

Format

peer peerIpv6Addr advertise add-path path-number number [ route-policy route-policy-name ]

undo peer peerIpv6Addr advertise add-path

undo peer peerIpv6Addr advertise add-path path-number number route-policy route-policy-name

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

path-number number

Specifies the maximum number of routes that the device can send to a peer.

The value is an integer ranging from 2 to 64.

route-policy route-policy-name

Specifies the name of a route-policy.

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

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After BGP Add-Path is configured on an RR, the RR needs to send BGP Add-Path routes to a specified BGP peer. To configure the maximum number of routes that the RR can send to a specified BGP peer, run the peer advertise add-path path-number command. The actual number of preferred routes advertised to the peer is the smaller value between the number of routes configured using the peer advertise add-path path-number command and the number of selected routes. If the number of routes that the RR can send to the peer is less than the actual number of routes selected by the RR, the RR selects routes based on the BGP route selection rules.

Prerequisites

The peer advertise add-path path-number command takes effect only if the following conditions are met:

  • BGP Add-Path has been enabled and the number of routes that the device can select has been configured using the bestroute add-path command.
  • The device has been enabled to send Add-Path routes to a specified peer using the peer capability-advertise add-path send command.

Precautions

  • The device that receives Add-Path routes can accept the Add-Path routes from a specified BGP peer only after the peer capability-advertise add-path receive command is run on the device.
  • The device can send Add-Path routes only to IBGP peers, and Add-Path routes are advertised based on BGP route advertisement rules.
  • If this command is run on a specified peer, the peer advertise best-external command is run in a peer group, and the peer is then added to the peer group, the peer cannot inherit the function of the peer advertise best-external command from the peer group.
  • This command supports only if-match, but not apply.

Example

# Configure the device to advertise three preferred routes to a peer.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] bestroute add-path path-number 6
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 capability-advertise add-path send
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 advertise add-path path-number 3 route-policy test-policy

peer advertise-community

Function

The peer advertise-community command configures a device to advertise community attributes to its peer.

The undo peer advertise-community command cancels the existing configuration.

By default, a device does not advertise community attributes to any peer.

Format

peer ipv4-address advertise-community

undo peer ipv4-address advertise-community

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to advertise community attributes to a specified peer or peer group, run the peer advertise-community command. If the command is run on the local device for a peer group, all the members in the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to configure a device to advertise a BGP community attribute, you can use a route-policy to define this community attribute.

Example

# Configure a device to advertise community attributes to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 10.1.1.1 advertise-community

peer advertise-community (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer advertise-community command configures a device to advertise community attributes to its peer.

The undo peer advertise-community command cancels the existing configuration.

By default, a device does not advertise community attributes to any peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address advertise-community

undo peer ipv4-address advertise-community

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to advertise community attributes to a specified peer or peer group, run the peer advertise-community command. If the command is run on the local device for a peer group, all the members in the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to configure a device to advertise a BGP community attribute, you can use a route-policy to define this community attribute.

Example

# Configure a device to advertise community attributes to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 advertise-community

peer advertise-community (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer advertise-community command configures a device to advertise a community attribute to its peer group.

The undo peer advertise-community command cancels the existing configuration.

By default, a device advertises no community attribute to its peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name advertise-community

undo peer group-name advertise-community

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to advertise community attributes to a specified peer or peer group, run the peer advertise-community command. If the command is run on the local device for a peer group, all the members in the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to configure a device to advertise a BGP community attribute, you can use a route-policy to define this community attribute.

Example

# Configure a device to advertise community attributes to each peer in a specified peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test advertise-community

peer advertise-community (BGP view)

Function

The peer advertise-community command configures a device to advertise a community attribute to its peer.

The undo peer advertise-community command cancels the existing configuration.

By default, a device advertises no community attribute to its peer.

Format

peer ipv4-address advertise-community

undo peer ipv4-address advertise-community

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-community command is used to configure a device to advertise a community attribute to its peer. If a device advertises a community attribute to its peer group, all the members of the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to advertise BGP community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise a community attribute to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 advertise-community

peer advertise-community (BGP view) (group)

Function

The peer advertise-community command configures a device to advertise a community attribute to its peer group.

The undo peer advertise-community command cancels the existing configuration.

By default, a device advertises no community attribute to its peer group.

Format

peer group-name advertise-community

undo peer group-name advertise-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-community command is used to configure a device to advertise a community attribute to its peer group. If a device advertises a community attribute to its peer group, all the members of the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to advertise BGP community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise a community attribute to its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test advertise-community

peer advertise-community (BGP-IPv4 unicast address family view)

Function

The peer advertise-community command configures a device to advertise a community attribute to its peer group.

The undo peer advertise-community command cancels the existing configuration.

By default, a device advertises no community attribute to its peer.

Format

peer ipv4-address advertise-community

undo peer ipv4-address advertise-community

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to advertise community attributes to a specified peer or peer group, run the peer advertise-community command. If the command is run on the local device for a peer group, all the members in the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to configure a device to advertise a BGP community attribute, you can use a route-policy to define this community attribute.

Example

# Configure a device to advertise community attributes to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 advertise-community

peer advertise-community (BGP-IPv4 unicast address family view) (group)

Function

The peer advertise-community command configures a device to advertise a community attribute to its peer group.

The undo peer advertise-community command cancels the existing configuration.

By default, a device advertises no community attribute to its peer.

Format

peer group-name advertise-community

undo peer group-name advertise-community

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to advertise community attributes to a specified peer or peer group, run the peer advertise-community command. If the command is run on the local device for a peer group, all the members in the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to configure a device to advertise a BGP community attribute, you can use a route-policy to define this community attribute.

Example

# Configure a device to advertise community attributes to each peer in a specified peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test advertise-community

peer advertise-community (BGP-IPv6 unicast address family view)

Function

The peer advertise-community command configures a device to advertise community attributes to its peer.

The undo peer advertise-community command cancels the existing configuration.

By default, a device does not advertise community attributes to any peer.

Format

peer ipv6-address advertise-community

undo peer ipv6-address advertise-community

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to advertise community attributes to a specified peer or peer group, run the peer advertise-community command. If the command is run on the local device for a peer group, all the members in the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Prerequisites

A specific community attribute has been defined by in a routing policy.

Example

# Configure a device to advertise community attributes to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 advertise-community

peer advertise-community (BGP-IPv6 unicast address family view) (group)

Function

The peer advertise-community command configures a device to advertise a community attribute to its peer group.

The undo peer advertise-community command cancels the existing configuration.

By default, a device advertises no community attribute to its peer group.

Format

peer group-name advertise-community

undo peer group-name advertise-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-community command is used to configure a device to advertise a community attribute to its peer group. If a device advertises a community attribute to its peer group, all the members of the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to advertise BGP community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise a community attribute to its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test advertise-community

peer advertise-community (BGP-IPv6 unicast address family view) (IPv4)

Function

The peer advertise-community command configures a device to advertise community attributes to its peer.

The undo peer advertise-community command cancels the existing configuration.

By default, a device does not advertise community attributes to any peer.

Format

peer ipv4-address advertise-community

undo peer ipv4-address advertise-community

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to advertise community attributes to a specified peer or peer group, run the peer advertise-community command. If the command is run on the local device for a peer group, all the members in the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to configure a device to advertise a BGP community attribute, you can use a route-policy to define this community attribute.

Example

# Configure a device to advertise community attributes to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 advertise-community

peer advertise-community (BGP-VPN instance IPv4 address family view) (group)

Function

The peer advertise-community command configures a device to advertise a community attribute to its peer group.

The undo peer advertise-community command cancels the existing configuration.

By default, a device advertises no community attribute to its peer.

Format

peer group-name advertise-community

undo peer group-name advertise-community

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a device to advertise community attributes to a specified peer or peer group, run the peer advertise-community command. If the command is run on the local device for a peer group, all the members in the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to configure a device to advertise a BGP community attribute, you can use a route-policy to define this community attribute.

Example

# Configure a device to advertise community attributes to each peer in a specified peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test advertise-community

peer advertise-community (BGP-VPN instance IPv6 address family view)

Function

The peer advertise-community command configures a device to advertise a community attribute to its peer.

The undo peer advertise-community command cancels the existing configuration.

By default, a device advertises no community attribute to its peer.

Format

peer ipv4-address advertise-community

undo peer ipv4-address advertise-community

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-community command is used to configure a device to advertise a community attribute to its peer. If a device advertises a community attribute to its peer group, all the members of the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to advertise BGP community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise a community attribute to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 advertise-community

peer advertise-community (BGP-VPN instance IPv6 address family view) (group)

Function

The peer advertise-community command configures a device to advertise a community attribute to its peer group.

The undo peer advertise-community command cancels the existing configuration.

By default, a device advertises no community attribute to its peer group.

Format

peer group-name advertise-community

undo peer group-name advertise-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-community command is used to configure a device to advertise a community attribute to its peer group. If a device advertises a community attribute to its peer group, all the members of the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to advertise BGP community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise a community attribute to its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test advertise-community

peer advertise-community (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer advertise-community command configures a device to advertise a community attribute to its peer.

The undo peer advertise-community command cancels the existing configuration.

By default, a device advertises no community attribute to its peer.

Format

peer ipv6-address advertise-community

undo peer ipv6-address advertise-community

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-community command is used to configure a device to advertise a community attribute to its peer. If a device advertises a community attribute to its peer group, all the members of the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to advertise BGP community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise a community attribute to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 advertise-community

peer advertise-ext-community (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer advertise-ext-community command enables a device to advertise an extended community attribute to its peer.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device does not advertise extended community attribute to its peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address advertise-ext-community

undo peer ipv4-address advertise-ext-community

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to advertise the extended community attribute to a specified peer or peer group.

Precautions

Before running the peer advertise-ext-community command to configure extended community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise an extended community attribute to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 advertise-ext-community

peer advertise-ext-community (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer advertise-ext-community command enables a device to advertise extended community attributes to BGP peers in a peer group.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device advertises no extended community attribute its peer or peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name advertise-ext-community

undo peer group-name advertise-ext-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to advertise the extended community attribute to a specified peer or peer group.

Precautions

Before running the peer advertise-ext-community command to configure extended community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure the device to advertise the extended community attribute to a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test advertise-ext-community

peer advertise-ext-community (BGP view)

Function

The peer advertise-ext-community command enables a device to advertise an extended community attribute to its peer.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device does not advertise extended community attribute to its peer.

Format

peer ipv4-address advertise-ext-community

undo peer ipv4-address advertise-ext-community

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to enable a device to advertise an extended community attribute to a specified peer.

Precautions

Before running the peer advertise-ext-community command to configure extended community attributes, you can use a routing policy to define specific community attributes.

By default, in the address family that does not support the peer advertise-ext-community command, the extended community attribute is advertised to peers.

Example

# Configure a device to advertise an extended community attribute to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 advertise-ext-community

peer advertise-ext-community (BGP view) (group)

Function

The peer advertise-ext-community command enables a device to advertise an extended community attribute to its peer.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device does not advertise extended community attribute to its peer.

Format

peer group-name advertise-ext-community

undo peer group-name advertise-ext-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to enable a device to advertise an extended community attribute to a specified peer.

Precautions

Before running the peer advertise-ext-community command to configure extended community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise an extended community attribute to its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test advertise-ext-community

peer advertise-ext-community (BGP-IPv4 unicast address family view)

Function

The peer advertise-ext-community command enables a device to advertise an extended community attribute to its peer.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device does not advertise extended community attribute to its peer.

Format

peer ipv4-address advertise-ext-community

undo peer ipv4-address advertise-ext-community

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to advertise the extended community attribute to a specified peer or peer group.

Precautions

Before running the peer advertise-ext-community command to configure extended community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise an extended community attribute to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 advertise-ext-community

peer advertise-ext-community (BGP-IPv4 unicast address family view) (group)

Function

The peer advertise-ext-community command enables a device to advertise extended community attributes to BGP peers in a peer group.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device advertises no extended community attribute its peer or peer group.

Format

peer group-name advertise-ext-community

undo peer group-name advertise-ext-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to advertise the extended community attribute to a specified peer or peer group.

Precautions

Before running the peer advertise-ext-community command to configure extended community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure the device to advertise the extended community attribute to a peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test advertise-ext-community

peer advertise-ext-community (BGP-IPv6 unicast address family view)

Function

The peer advertise-ext-community command enables a device to advertise an extended community attribute to its peer.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device advertises no extended community attribute its peer or peer group.

Format

peer ipv4-address advertise-ext-community

undo peer ipv4-address advertise-ext-community

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to advertise the extended community attribute to a specified peer or peer group.

Precautions

Before running the peer advertise-community command to configure a device to advertise a BGP community attribute, you can use a route-policy to define this community attribute.

Example

# Configure a device to advertise an extended community attribute to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 advertise-ext-community

peer advertise-ext-community (BGP-IPv6 unicast address family view) (group)

Function

The peer advertise-ext-community command enables a device to advertise an extended community attribute to its peer.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device does not advertise extended community attribute to its peer.

Format

peer group-name advertise-ext-community

undo peer group-name advertise-ext-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to enable a device to advertise an extended community attribute to a specified peer.

Precautions

Before running the peer advertise-community command to advertise BGP community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise an extended community attribute to its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test advertise-ext-community

peer advertise-ext-community (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer advertise-ext-community command enables a device to advertise an extended community attribute to its peer.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device advertises no extended community attribute its peer or peer group.

Format

peer ipv6-address advertise-ext-community

undo peer ipv6-address advertise-ext-community

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to advertise the extended community attribute to a specified peer or peer group.

Precautions

Before running the peer advertise-community command to configure a device to advertise a BGP community attribute, you can use a route-policy to define this community attribute.

Example

# Configure a device to advertise an extended community attribute to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 advertise-ext-community

peer advertise-ext-community (BGP-VPN instance IPv4 address family view)

Function

The peer advertise-ext-community command enables a device to advertise an extended community attribute to its peer.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device advertises no extended community attribute its peer or peer group.

Format

peer ipv4-address advertise-ext-community

undo peer ipv4-address advertise-ext-community

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to advertise the extended community attribute to a specified peer or peer group.

Precautions

Before running the peer advertise-ext-community command to configure extended community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise an extended community attribute to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 10.1.1.1 advertise-ext-community

peer advertise-ext-community (BGP-VPN instance IPv4 address family view) (group)

Function

The peer advertise-ext-community command enables a device to advertise extended community attributes to BGP peers in a peer group.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device advertises no extended community attribute its peer or peer group.

Format

peer group-name advertise-ext-community

undo peer group-name advertise-ext-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to advertise the extended community attribute to a specified peer or peer group.

Precautions

Before running the peer advertise-ext-community command to configure extended community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure the device to advertise the extended community attribute to a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test advertise-ext-community

peer advertise-ext-community (BGP-VPN instance IPv6 address family view)

Function

The peer advertise-ext-community command enables a device to advertise an extended community attribute to its peer.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device does not advertise extended community attribute to its peer.

Format

peer ipv4-address advertise-ext-community

undo peer ipv4-address advertise-ext-community

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to enable a device to advertise an extended community attribute to a specified peer.

Precautions

Before running the peer advertise-community command to advertise BGP community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise an extended community attribute to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 advertise-ext-community

peer advertise-ext-community (BGP-VPN instance IPv6 address family view) (group)

Function

The peer advertise-ext-community command enables a device to advertise an extended community attribute to its peer.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device does not advertise extended community attribute to its peer.

Format

peer group-name advertise-ext-community

undo peer group-name advertise-ext-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to enable a device to advertise an extended community attribute to a specified peer.

Precautions

Before running the peer advertise-community command to advertise BGP community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise an extended community attribute to its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test advertise-ext-community

peer advertise-ext-community (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer advertise-ext-community command enables a device to advertise an extended community attribute to its peer.

The undo peer advertise-ext-community command cancels the existing configuration.

By default, a device does not advertise extended community attribute to its peer.

Format

peer ipv6-address advertise-ext-community

undo peer ipv6-address advertise-ext-community

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer advertise-ext-community command is used to enable a device to advertise an extended community attribute to a specified peer. If a device advertises an extended community attribute to a specified peer group, all the members of the peer group will inherit the configuration. This simplifies the application of routing policies and facilitates route maintenance and management.

Precautions

Before running the peer advertise-community command to advertise BGP community attributes, you can use a routing policy to define specific community attributes.

Example

# Configure a device to advertise an extended community attribute to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 advertise-ext-community

peer advertise-large-community (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer advertise-large-community command enables a device to advertise the large-community attribute to a peer.

The undo peer advertise-large-community command cancels the existing configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address advertise-large-community [ disable ]

undo peer ipv4-address advertise-large-community [ disable ]

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

disable

Disables the function.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer group, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer group, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

A route-policy has been used to define the large-community attribute.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 advertise-large-community

peer advertise-large-community (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer advertise-large-community command enables a device to advertise the Large-Community attribute to a BGP peer group.

The undo peer advertise-large-community command cancels the configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name advertise-large-community

undo peer group-name advertise-large-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer group, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer group, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

A route-policy has been used to define the large-community attribute.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test advertise-large-community

peer advertise-large-community (BGP view)

Function

The peer advertise-large-community command enables a device to advertise the Large-Community attribute to a BGP peer.

The undo peer advertise-large-community command cancels the configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer.

Format

peer ipv4-address advertise-large-community [ disable ]

undo peer ipv4-address advertise-large-community [ disable ]

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

disable

Disables the Large-Community attribute from being advertised to a BGP peer.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

Specific Large-Community values have been defined in a route-policy.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] peer 10.1.1.2 advertise-large-community

peer advertise-large-community (BGP view) (group)

Function

The peer advertise-large-community command enables a device to advertise the Large-Community attribute to a BGP peer group.

The undo peer advertise-large-community command cancels the configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer group.

Format

peer group-name advertise-large-community

undo peer group-name advertise-large-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer group, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer group, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

Specific Large-Community values have been defined in a route-policy.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test advertise-large-community

peer advertise-large-community (BGP-IPv4 unicast address family view)

Function

The peer advertise-large-community command enables a device to advertise the Large-Community attribute to a BGP peer.

The undo peer advertise-large-community command cancels the configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer.

Format

peer peerIpv4Addr advertise-large-community [ disable ]

undo peer peerIpv4Addr advertise-large-community [ disable ]

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

disable

Disables the Large-Community attribute from being advertised to a BGP peer.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

A route-policy has been used to define the large-community attribute.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix 1 permit 10.1.1.0 24
[HUAWEI] route-policy RP permit node 10
[HUAWEI-route-policy] if-match ip-prefix 1
[HUAWEI-route-policy] apply large-community 35551:100:65552 additive
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.2 as-number 200
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 1.1.1.2 advertise-large-community

peer advertise-large-community (BGP-IPv4 unicast address family view) (group)

Function

The peer advertise-large-community command enables a device to advertise the Large-Community attribute to a BGP peer group.

The undo peer advertise-large-community command cancels the configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer group.

Format

peer group-name advertise-large-community

undo peer group-name advertise-large-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer group, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer group, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

A route-policy has been used to define the large-community attribute.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test advertise-large-community

peer advertise-large-community (BGP-IPv6 unicast address family view)

Function

The peer advertise-large-community command enables a device to advertise the large-community attribute to a peer.

The undo peer advertise-large-community command cancels the existing configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer.

Format

peer ipv6-address advertise-large-community [ disable ]

undo peer ipv6-address advertise-large-community [ disable ]

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

disable

Disables the Large-Community attribute from being advertised to a BGP peer.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer group, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer group, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

A route-policy has been used to define the large-community attribute.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 advertise-large-community

peer advertise-large-community (BGP-IPv6 unicast address family view) (group)

Function

The peer advertise-large-community command enables a device to advertise the Large-Community attribute to a BGP peer group.

The undo peer advertise-large-community command cancels the configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer group.

Format

peer group-name advertise-large-community

undo peer group-name advertise-large-community

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer group, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer group, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

A route-policy has been used to define the large-community attribute.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test advertise-large-community

peer advertise-large-community (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer advertise-large-community command enables a device to advertise the large-community attribute to a peer.

The undo peer advertise-large-community command cancels the existing configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer.

Format

peer peerIpv4Addr advertise-large-community [ disable ]

undo peer peerIpv4Addr advertise-large-community [ disable ]

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

disable

Disables the Large-Community attribute from being advertised to a BGP peer.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer group, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer group, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

A route-policy has been used to define the large-community attribute.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 1.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 1.1.1.1 advertise-large-community

peer advertise-large-community (BGP-VPN instance IPv4 address family view)

Function

The peer advertise-large-community command enables a device to advertise the Large-Community attribute to a BGP peer.

The undo peer advertise-large-community command cancels the configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer.

Format

peer peerIpv4Addr advertise-large-community [ disable ]

undo peer peerIpv4Addr advertise-large-community [ disable ]

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

disable

Disables the Large-Community attribute from being advertised to a BGP peer.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

A route-policy has been used to define the large-community attribute.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-labeled-vpna] peer 1.1.1.1 advertise-large-community

peer advertise-large-community (BGP-VPN instance IPv4 address family view) (group)

Function

The peer advertise-large-community command enables a device to advertise the Large-Community attribute to a BGP peer group.

The undo peer advertise-large-community command cancels the configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer group.

Format

peer group-name advertise-large-community

undo peer group-name advertise-large-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer group, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer group, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

A route-policy has been used to define the large-community attribute.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test advertise-large-community

peer advertise-large-community (BGP-VPN instance IPv6 address family view)

Function

The peer advertise-large-community command enables a device to advertise the Large-Community attribute to a BGP peer.

The undo peer advertise-large-community command cancels the configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer.

Format

peer peerIpv4Addr advertise-large-community [ disable ]

undo peer peerIpv4Addr advertise-large-community [ disable ]

Parameters

Parameter Description Value
peerIpv4Addr

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

disable

Disables the Large-Community attribute from being advertised to a BGP peer.

-

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

Specific Large-Community values have been defined in a route-policy.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 1.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 1.1.1.1 advertise-large-community

peer advertise-large-community (BGP-VPN instance IPv6 address family view) (group)

Function

The peer advertise-large-community command enables a device to advertise the Large-Community attribute to a BGP peer group.

The undo peer advertise-large-community command cancels the configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer group.

Format

peer group-name advertise-large-community

undo peer group-name advertise-large-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer group, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer group, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

Specific Large-Community values have been defined in a route-policy.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test advertise-large-community

peer advertise-large-community (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer advertise-large-community command enables a device to advertise the Large-Community attribute to a BGP peer.

The undo peer advertise-large-community command cancels the configuration.

By default, a device does not advertise the Large-Community attribute to its BGP peer.

Format

peer peerIpv6Addr advertise-large-community [ disable ]

undo peer peerIpv6Addr advertise-large-community [ disable ]

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

disable

Disables the Large-Community attribute from being advertised to a BGP peer.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to advertise the Large-Community attribute to its BGP peer group, run the peer advertise-large-community command. If the Large-Community attribute is advertised to a peer group, all the peer members in the group inherit this configuration. This simplifies the application of route-policies and facilitates route maintenance and management.

Prerequisites

Specific Large-Community values have been defined in a route-policy.

Example

# Enable a device to advertise the Large-Community attribute to a BGP peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 advertise-large-community

peer allow-as-loop (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer allow-as-loop command sets the number of times that the local AS number can be repeated.

The undo peer allow-as-loop command disables this function.

By default, local AS number repetition is not allowed.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address allow-as-loop [ number ]

undo peer ipv4-address allow-as-loop

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

number

Maximum number of times the local AS number can be included in the AS_Path of each received route.

The value is an integer ranging from 1 to 10. The default value is 1.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer fake-as command. The largest number of times any of the configured AS numbers is repeated is considered as the routing loop count.

After the peer allow-as-loop command is run to set the number of times the local AS number is repeated, the BGP speaker allows the routes with repeated AS numbers in the AS_Path attribute to pass, meeting the requirements of special scenarios.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer multiple times, the latest configuration overrides the previous one.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 allow-as-loop 2

peer allow-as-loop (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer allow-as-loop command sets the number of local AS number repetitions.

The undo peer allow-as-loop command cancels the configuration.

By default, the local AS number cannot be repeated.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name allow-as-loop [ number ]

undo peer group-name allow-as-loop

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

number

Specifies the maximum number of times the local AS number can be repeated in the AS_Path of each received route.

The value is an integer in the range from 1 to 10. The default value is 1.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer local-as command.

After the peer allow-as-loop command is executed to configure the number of local AS number repetitions, BGP Speaker can allow routes with repeated AS numbers in AS_Path to pass to meet the requirements of special scenarios.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer group multiple times, the latest configuration overrides the previous one.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test allow-as-loop 2

peer allow-as-loop (BGP view)

Function

The peer allow-as-loop command sets the number of local AS number repetitions.

The undo peer allow-as-loop command cancels the configuration.

By default, the local AS number cannot be repeated.

Format

peer ipv4-address allow-as-loop [ number ]

undo peer ipv4-address allow-as-loop

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

number

Specifies the maximum number of times the local AS number can be repeated in the AS_Path of each received route.

The value is an integer in the range from 1 to 10. The default value is 1.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer local-as command.

After the peer allow-as-loop command is executed to configure the number of local AS number repetitions, the BGP speaker can allow routes with repeated AS numbers in AS_Path to pass to meet the requirements of special scenarios.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer multiple times, the latest configuration overrides the previous one.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 allow-as-loop 2

peer allow-as-loop (BGP view) (group)

Function

The peer allow-as-loop command sets the number of local AS number repetitions.

The undo peer allow-as-loop command cancels the configuration.

By default, the local AS number cannot be repeated.

Format

peer group-name allow-as-loop [ number ]

undo peer group-name allow-as-loop

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

number

Specifies the maximum number of times the local AS number can be repeated in the AS_Path of each received route.

The value is an integer in the range from 1 to 10. The default value is 1.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer local-as command.

After the peer allow-as-loop command is executed to configure the number of local AS number repetitions, BGP Speaker can allow routes with repeated AS numbers in AS_Path to pass to meet the requirements of special scenarios.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer group multiple times, the latest configuration overrides the previous one.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test allow-as-loop 2

peer allow-as-loop (BGP-IPv4 unicast address family view)

Function

The peer allow-as-loop command sets the number of times that the local AS number can be repeated.

The undo peer allow-as-loop command disables this function.

By default, local AS number repetition is not allowed.

Format

peer ipv4-address allow-as-loop [ number ]

undo peer ipv4-address allow-as-loop

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

number

Specifies the maximum number of times the local AS number can be repeated in the AS_Path of each received route.

The value is an integer in the range from 1 to 10. The default value is 1.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer fake-as command. The largest number of times any of the configured AS numbers is repeated is considered as the routing loop count.

After the peer allow-as-loop command is run to set the number of times the local AS number is repeated, the BGP speaker allows the routes with repeated AS numbers in the AS_Path attribute to pass, meeting the requirements of special scenarios.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer multiple times, the latest configuration overrides the previous one.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 allow-as-loop 2

peer allow-as-loop (BGP-IPv4 unicast address family view) (group)

Function

The peer allow-as-loop command sets the number of times that the local AS number can be repeated.

The undo peer allow-as-loop command disables this function.

By default, local AS number repetition is not allowed.

Format

peer group-name allow-as-loop [ number ]

undo peer group-name allow-as-loop

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

number

Maximum number of times the local AS number can be included in the AS_Path of each received route.

The value is an integer ranging from 1 to 10. The default value is 1.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer fake-as command. The largest number of times any of the configured AS numbers is repeated is considered as the routing loop count.

After the peer allow-as-loop command is run to set the number of times the local AS number is repeated, the BGP speaker allows the routes with repeated AS numbers in the AS_Path attribute to pass, meeting the requirements of special scenarios.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer multiple times, the latest configuration overrides the previous one.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test allow-as-loop 2

peer allow-as-loop (BGP-IPv6 unicast address family view)

Function

The peer allow-as-loop command sets the number of times that the local AS number can be repeated.

The undo peer allow-as-loop command disables this function.

By default, local AS number repetition is not allowed.

Format

peer ipv4-address allow-as-loop [ number ]

undo peer ipv4-address allow-as-loop

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

number

Maximum number of times the local AS number can be included in the AS_Path of each received route.

The value is an integer ranging from 1 to 10. The default value is 1.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer fake-as command. The largest number of times any of the configured AS numbers is repeated is considered as the maximum number. In the Hub and Spoke networking, if EBGP runs between a Hub-PE and a Hub-CE on a Hub site, the route sent from the Hub-PE to the Hub-CE carries the AS number of the Hub-PE. If the Hub-CE sends a routing update to the Hub-PE, the Hub-PE will deny it because the routing update contains the AS number of the Hub-PE.

To ensure proper route transmission in the Hub and Spoke networking, configure all the BGP peers on the path, along which the Hub-CE advertises private network routes to the Spoke-CE, to accept the routes in which the AS number repeats once.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer multiple times, the latest configuration overrides the previous one.

Precautions

The peer allow-as-loop command enables BGP to check the count of the local AS number in the routes received from EBGP peers or confederation EBGP peers. The command does not apply to IBGP peers or confederation IBGP peers. If the command is not run, the implementation is equivalent to the peer allow-as-loop 0 configuration.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 allow-as-loop 2

peer allow-as-loop (BGP-IPv6 unicast address family view) (group)

Function

The peer allow-as-loop command sets the number of times that the local AS number can be repeated.

The undo peer allow-as-loop command disables this function.

By default, local AS number repetition is not allowed.

Format

peer group-name allow-as-loop [ number ]

undo peer group-name allow-as-loop

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

number

Maximum number of times the local AS number can be included in the AS_Path of each received route.

The value is an integer ranging from 1 to 10. The default value is 1.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer fake-as command. The largest number of times any of the configured AS numbers is repeated is considered as the routing loop count.

After the peer allow-as-loop command is run to set the number of times the local AS number is repeated, the BGP speaker allows the routes with repeated AS numbers in the AS_Path attribute to pass, meeting the requirements of special scenarios.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer multiple times, the latest configuration overrides the previous one.

Precautions

The peer allow-as-loop command enables BGP to check the count of the local AS number in the routes received from EBGP peers or confederation EBGP peers. The command does not apply to IBGP peers or confederation IBGP peers. If the command is not run, the implementation is equivalent to the peer allow-as-loop 0 configuration.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test allow-as-loop 2

peer allow-as-loop (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer allow-as-loop command sets the number of times that the local AS number can be repeated.

The undo peer allow-as-loop command disables this function.

By default, local AS number repetition is not allowed.

Format

peer ipv6-address allow-as-loop [ number ]

undo peer ipv6-address allow-as-loop

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

number

Maximum number of times the local AS number can be included in the AS_Path of each received route.

The value is an integer ranging from 1 to 10. The default value is 1.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer fake-as command. The largest number of times any of the configured AS numbers is repeated is considered as the routing loop count.

After the peer allow-as-loop command is run to set the number of times the local AS number is repeated, the BGP speaker allows the routes with repeated AS numbers in the AS_Path attribute to pass, meeting the requirements of special scenarios.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer multiple times, the latest configuration overrides the previous one.

Precautions

The peer allow-as-loop command enables BGP to check the count of the local AS number in the routes received from EBGP peers or confederation EBGP peers. The command does not apply to IBGP peers or confederation IBGP peers. If the command is not run, the implementation is equivalent to the peer allow-as-loop 0 configuration.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 allow-as-loop 2

peer allow-as-loop (BGP-VPN instance IPv4 address family view)

Function

The peer allow-as-loop command sets the number of times that the local AS number can be repeated.

The undo peer allow-as-loop command disables this function.

By default, local AS number repetition is not allowed.

Format

peer ipv4-address allow-as-loop [ number ]

undo peer ipv4-address allow-as-loop

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

number

Maximum number of times the local AS number can be included in the AS_Path of each received route.

The value is an integer ranging from 1 to 10. The default value is 1.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer fake-as command. The largest number of times any of the configured AS numbers is repeated is considered as the routing loop count. However, in Hub and Spoke networking, if EBGP runs between a Hub-PE and a Hub-CE, the routes that the Hub-PE sends to the Hub-CE carry the AS number of the Hub-PE; if the Hub-CE sends an Update message to the Hub-PE, the Hub-PE discards the message because the message includes the AS number of the Hub-PE.

To ensure proper route transmission in the Hub and Spoke networking, configure all the BGP peers on the path, along which the Hub-CE advertises VPN routes to the Spoke-CE, to accept the routes that contain the local AS number as long as the number of repetitions in each route is within the default limit (1).

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer multiple times, the latest configuration overrides the previous one.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 1.1.1.1 allow-as-loop 2

peer allow-as-loop (BGP-VPN instance IPv4 address family view) (group)

Function

The peer allow-as-loop command sets the number of times that the local AS number can be repeated.

The undo peer allow-as-loop command disables this function.

By default, local AS number repetition is not allowed.

Format

peer group-name allow-as-loop [ number ]

undo peer group-name allow-as-loop

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

number

Maximum number of times the local AS number can be included in the AS_Path of each received route.

The value is an integer ranging from 1 to 10. The default value is 1.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer fake-as command. The largest number of times any of the configured AS numbers is repeated is considered as the routing loop count.

After the peer allow-as-loop command is run to set the number of times the local AS number is repeated, the BGP speaker allows the routes with repeated AS numbers in the AS_Path attribute to pass, meeting the requirements of special scenarios.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer multiple times, the latest configuration overrides the previous one.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test allow-as-loop 2

peer allow-as-loop (BGP-VPN instance IPv6 address family view)

Function

The peer allow-as-loop command sets the number of local AS number repetitions.

The undo peer allow-as-loop command cancels the configuration.

By default, the local AS number cannot be repeated.

Format

peer ipv4-address allow-as-loop [ number ]

undo peer ipv4-address allow-as-loop

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

number

Specifies the number of local AS number repetitions.

The value is an integer ranging from 1 to 10. The default value is 1.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer fake-as command. The largest number of times any of the configured AS numbers is repeated is considered as the maximum number. In the Hub and Spoke networking, if EBGP runs between a Hub-PE and a Hub-CE on a Hub site, the route sent from the Hub-PE to the Hub-CE carries the AS number of the Hub-PE. If the Hub-CE sends a routing update to the Hub-PE, the Hub-PE will deny it because the routing update contains the AS number of the Hub-PE.

To ensure proper route transmission in the Hub and Spoke networking, configure all the BGP peers on the path, along which the Hub-CE advertises private network routes to the Spoke-CE, to accept the routes in which the AS number repeats once.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer multiple times, the latest configuration overrides the previous one.

Precautions

The peer allow-as-loop command enables BGP to check the count of the local AS number in the routes received from EBGP peers or confederation EBGP peers. The command does not apply to IBGP peers or confederation IBGP peers. If the command is not run, the implementation is equivalent to the peer allow-as-loop 0 configuration.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 allow-as-loop 2

peer allow-as-loop (BGP-VPN instance IPv6 address family view) (group)

Function

The peer allow-as-loop command sets the number of local AS number repetitions.

The undo peer allow-as-loop command cancels the configuration.

By default, the local AS number cannot be repeated.

Format

peer group-name allow-as-loop [ number ]

undo peer group-name allow-as-loop

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

number

Specifies the maximum number of times the local AS number can be repeated in the AS_Path of each received route.

The value is an integer ranging from 1 to 10. The default value is 1.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer local-as command.

After the peer allow-as-loop command is executed to configure the number of local AS number repetitions, BGP Speaker can allow routes with repeated AS numbers in AS_Path to pass to meet the requirements of special scenarios.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer group multiple times, the latest configuration overrides the previous one.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test allow-as-loop 2

peer allow-as-loop (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer allow-as-loop command sets the number of local AS number repetitions.

The undo peer allow-as-loop command cancels the configuration.

By default, the local AS number cannot be repeated.

Format

peer ipv6-address allow-as-loop [ number ]

undo peer ipv6-address allow-as-loop

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

number

Specifies the maximum number of times the local AS number can be repeated in the AS_Path of each received route.

The value is an integer in the range from 1 to 10. The default value is 1.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, BGP uses AS numbers to detect routing loops. The AS numbers in the AS_Path of each received route are matched against the local AS number configured using the bgp command and the fake AS number configured using the peer fake-as command. The largest number of times any of the configured AS numbers is repeated is considered as the routing loop count. However, in Hub and Spoke networking, if EBGP runs between a Hub-PE and a Hub-CE, the routes that the Hub-PE sends to the Hub-CE carry the AS number of the Hub-PE; if the Hub-CE sends an Update message to the Hub-PE, the Hub-PE discards the message because the message includes the AS number of the Hub-PE.

To ensure proper route transmission in the Hub and Spoke networking, configure all the BGP peers on the path, along which the Hub-CE advertises VPN routes to the Spoke-CE, to accept the routes that contain the local AS number as long as the number of repetitions in each route is within the default limit (1).

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

If the peer allow-as-loop command is run for a peer multiple times, the latest configuration overrides the previous one.

Example

# Set the number of local AS number repetitions to 2.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 allow-as-loop 2

peer as-number (BGP multi-instance view)

Function

The peer as-number command creates a peer and configures an AS number for a specified peer.

The undo peer as-number command deletes the AS number of a specified peer.

By default, no BGP peer is configured, and no AS number is specified for a peer or peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address as-number as-number

undo peer ipv4-address

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

as-number

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv6-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

After the YANG management mode is enabled for a BGP VPN instance using the bgp yang-mode enable command, the group command cannot be configured. To configure a peer, run the peer as-number command in the BGP multi-instance VPN instance view and run the peer enable command in the BGP multi-instance view to enable the peer.

If the YANG management mode is disabled for a BGP VPN instance, the peer as-number command can be configured.

Example

# Set the AS number to 100 for IPv4 peer 10.1.1.1.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100

peer as-number (BGP multi-instance view) (group)

Function

The peer as-number command configures an AS number for a specified peer group.

The undo peer as-number command deletes the AS number of a specified peer group.

By default, no BGP peer is configured, and no AS number is specified for a peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name as-number as-number

undo peer group-name as-number

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

as-number

Specifies a destination AS number.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv6-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

After the YANG management mode is enabled for a BGP VPN instance using the bgp yang-mode enable command, the group command cannot be configured. To configure a peer group, run the group command in the BGP multi-instance VPN instance view and run the peer enable command in the BGP multi-instance view to enable the peer group.

If the YANG management mode is not enabled for a BGP VPN instance, the group command can be configured.

Example

# Set the AS number to 200 for a peer group named test.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] group test
[HUAWEI-bgp-instance-a] peer test as-number 100

peer as-number (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer as-number command creates a peer or configures an AS number for a specified peer group.

The undo peer as-number command deletes a specified peer or the AS number of a specified peer group.

By default, no BGP peer is configured, and no AS number is specified for a peer or peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address as-number as-number

undo peer ipv4-address

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

as-number

Specifies a destination AS number.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv6-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

Example

# Set the AS number to 100 for IPv4 peer 10.1.1.1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100

peer as-number (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer as-number command configures an AS number for a specified peer group.

The undo peer as-number command deletes the AS number of a specified peer group.

By default, no BGP peer is configured, and no AS number is specified for a peer or peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name as-number as-number

undo peer group-name as-number

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

as-number

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv6-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

Example

# Set the AS number to 200 for a peer group named test.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test external
[HUAWEI-bgp-instance-a-vpna] peer test as-number 200

peer as-number (BGP view)

Function

The peer as-number command creates a peer and configures an AS number for a specified peer.

The undo peer as-number command deletes the AS number of a specified peer.

By default, no BGP peer is configured, and no AS number is specified for a peer or peer group.

Format

peer ipv4-address as-number as-number

undo peer ipv4-address

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

as-number

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv10-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

When the local device sends routes to IBGP peers, the AS_Path attribute does not carry the local AS number. When the local device sends routes to EBGP peers, the AS_Path attribute carries the local AS number.

It is recommended that the hold time be set based on the total number of BGP peers in each address family. As the number of peers increases, the recommended minimum hold time increases accordingly. Adjust the hold time according to "Mapping Between the Total Number of BGP Peers in Each Address Family and the Recommended Minimum Hold Time" in the usage guide of the peer timer command.

Example

# Set the AS number to 100 for IPv4 peer 10.1.1.1.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100

peer as-number (BGP view) (group)

Function

The peer as-number command configures an AS number for a specified peer group.

The undo peer as-number command deletes the AS number of a specified peer group.

By default, no BGP peer is configured, and no AS number is specified for a peer group.

Format

peer group-name as-number as-number

undo peer group-name as-number

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

as-number

Specifies a destination AS number.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv6-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

When the local device sends routes to IBGP peers, the AS_Path attribute does not carry the local AS number. When the local device sends routes to EBGP peers, the AS_Path attribute carries the local AS number.

It is recommended that the hold time be set based on the total number of BGP peers in each address family. As the number of peers increases, the recommended minimum hold time increases accordingly. Adjust the hold time according to "Mapping Between the Total Number of BGP Peers in Each Address Family and the Recommended Minimum Hold Time" in the usage guide of the peer timer command.

Example

# Set the AS number to 200 for a peer group named test.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200

peer as-number (BGP view) (IPv6)

Function

The peer as-number command creates a peer and configures an AS number for a specified peer.

The undo peer as-number command deletes the AS number of a specified peer.

By default, no BGP peer is configured, and no AS number is specified for a peer or peer group.

Format

peer ipv6-address as-number as-number

undo peer ipv6-address

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

as-number

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv8-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

When the local device sends routes to IBGP peers, the AS_Path attribute does not carry the local AS number. When the local device sends routes to EBGP peers, the AS_Path attribute carries the local AS number.

It is recommended that the hold time be set based on the total number of BGP peers in each address family. As the number of peers increases, the recommended minimum hold time increases accordingly. Adjust the hold time according to "Mapping Between the Total Number of BGP Peers in Each Address Family and the Recommended Minimum Hold Time" in the usage guide of the peer timer command.

Example

# Set the AS number to 100 for IPv6 peer 2001:DB8:1::1.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100

peer as-number (BGP-VPN instance IPv4 address family view)

Function

The peer as-number command creates a peer and configures an AS number for a specified peer.

The undo peer as-number command deletes the AS number of a specified peer.

By default, no BGP peer is configured, and no AS number is specified for a peer or peer group.

Format

peer ipv4-address as-number as-number

undo peer ipv4-address

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

as-number

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv6-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

After the YANG management mode is enabled for a BGP VPN instance using the bgp yang-mode enable command, the peer as-number command cannot be configured. To configure a peer, run the peer as-number command in the BGP-VPN instance view and the peer enable command in the BGP-VPN instance IPv4 address family view to enable the peer.

If the YANG management mode is disabled for a BGP VPN instance, the peer as-number command can be configured.

Example

# Set the AS number to 100 for the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100

peer as-number (BGP-VPN instance IPv4 address family view) (group)

Function

The peer as-number command configures an AS number for a specified peer group.

The undo peer as-number command deletes the AS number of a specified peer group.

By default, no BGP peer is configured, and no AS number is specified for a peer or peer group.

Format

peer group-name as-number as-number

undo peer group-name as-number

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

as-number

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv6-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

After the YANG management mode is enabled for a BGP VPN instance using the bgp yang-mode enable command, the group command cannot be configured. To configure a peer group, run the group command in the BGP-VPN instance view and the peer enable command in the BGP-VPN instance IPv4 address family view to enable the peer group.

If the YANG management mode is not enabled for a BGP VPN instance, the group command can be configured.

Example

# Set the AS number to 200 for a peer group named test.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test external
[HUAWEI-bgp-vpn1] peer test as-number 200

peer as-number (BGP-VPN instance IPv6 address family view) (group)

Function

The peer as-number command configures an AS number for a specified peer group.

The undo peer as-number command deletes the AS number of a specified peer group.

By default, no BGP peer is configured, and no AS number is specified for a peer group.

Format

peer group-name as-number as-number

undo peer group-name as-number

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

as-number

Specifies a destination AS number.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv6-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

After the YANG management mode is enabled for a BGP VPN instance using the bgp yang-mode enable command, the peer as-number command cannot be configured. To configure a peer, run the peer as-number command in the BGP-VPN instance view and the peer enable command in the BGP-VPN instance IPv6 address family view to enable the peer.

If the YANG management mode is disabled for a BGP VPN instance, the peer as-number command can be configured.

Example

# Set the AS number to 200 for a peer group named test.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] group test external
[HUAWEI-bgp-6-vpna] peer test as-number 200

peer as-number (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer as-number command creates a peer and configures an AS number for a specified peer.

The undo peer as-number command deletes the AS number of a specified peer.

By default, no BGP peer is configured, and no AS number is specified for a peer or peer group.

Format

peer ipv6-address as-number as-number

undo peer ipv6-address

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

as-number

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv6-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

After the YANG management mode is enabled for a BGP VPN instance using the bgp yang-mode enable command, the group command cannot be configured. To configure a peer group, run the group command in the BGP-VPN instance view and the peer enable command in the BGP-VPN instance IPv6 address family view to enable the peer group.

If the YANG management mode is not enabled for a BGP VPN instance, the group command can be configured.

Example

# Set the AS number to 100 for IPv6 peer 2001:DB8:1::1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100

peer as-number (BGP-VPN instance view)

Function

The peer as-number command creates a peer and configures an AS number for a specified peer.

The undo peer as-number command deletes the AS number of a specified peer.

By default, no BGP peer is configured, and no AS number is specified for a peer or peer group.

Format

peer ipv4-address as-number as-number

undo peer ipv4-address

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

as-number

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv6-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

Example

# Set the AS number to 100 for IPv4 peer 10.1.1.1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.1 as-number 100

peer as-number (BGP-VPN instance view) (group)

Function

The peer as-number command configures an AS number for a specified peer group.

The undo peer as-number command deletes the AS number of a specified peer group.

By default, no BGP peer is configured, and no AS number is specified for a peer or peer group.

Format

peer group-name as-number as-number

undo peer group-name as-number [ as-number ]

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

as-number

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv6-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

Example

# Set the AS number to 200 for a peer group named test.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test external
[HUAWEI-bgp-instance-vpn1] peer test as-number 200

peer as-number (BGP-VPN instance view) (IPv6)

Function

The peer as-number command creates a peer and configures an AS number for a specified peer.

The undo peer as-number command deletes the AS number of a specified peer.

By default, no BGP peer is configured, and no AS number is specified for a peer or peer group.

Format

peer ipv6-address as-number as-number

undo peer ipv6-address

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

as-number

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer as-number command is used to create a BGP peer.

Precautions

If the peer group to which a peer belongs is not configured with an AS number or the peer is not added to any peer group, deleting the AS number of the peer resets the peer relationship.

The AS number of an external peer group must be different from the local AS number.

Running the undo peer ipv4-address or undo peer ipv6-address command deletes all configurations related to the peer. Therefore, exercise caution when running this command.

Example

# Set the AS number to 100 for IPv6 peer 2001:DB8:1::1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 100

peer as-path-filter export (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer as-path-filter export command configures a route-filter based on the AS_Path for the routes to be advertised to a peer group.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to peers in a peer group, and all the BGP routes will be advertised to the peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name as-path-filter { number | name } export

undo peer group-name as-path-filter { number | name } export

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

number

Specifies the number of the AS path filter.

The value is a decimal integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the peer as-path-filter export command is run to apply a routing policy to the BGP routes to be advertised to a specified peer group, the AS_Path filter filters out unqualified routes.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

Example

# Configure an AS_Path filter for a peer group.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test external
[HUAWEI-bgp-instance-a-vpna] peer test as-path-filter 3 export

peer as-path-filter export (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer as-path-filter export command applies a routing policy based on an AS_Path list to filter BGP routes to be advertised to a specified peer.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to a peer, and all the BGP routes will be advertised to the peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address as-path-filter { number | name } export

undo peer ipv4-address as-path-filter { number | name } export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

number

Specifies the number of the AS path filter.

The value is a decimal integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To apply a routing policy based on an AS_Path list to filter BGP routes to be advertised to a specified peer, run the peer as-path-filter export command. This configuration allows the routes that do not match the policy to be filtered out.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-path-filter 3 export

peer as-path-filter export (BGP view) (group)

Function

The peer as-path-filter export command configures a policy based on an AS_Path list for filtering BGP routes to be advertised to a specified peer group.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to a peer group, and all the BGP routes will be advertised to the peer group.

Format

peer group-name as-path-filter { number | name } export

undo peer group-name as-path-filter { number | name } export

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

number

Specifies the number of an AS_Path filter.

The value is an integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer as-path-filter export command is used to apply a route filtering policy based on an AS_Path list to BGP routes to be advertised to a specified peer group, the routers that do not match the policy are filtered out.

Prerequisites

The ip as-path-filter command has been run to define an AS-Path filter.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

Example

# Configure an AS_Path filter for a peer group.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test as-path-filter 3 export

peer as-path-filter export (BGP view)(IPv4)

Function

The peer as-path-filter export command applies a routing policy based on an AS_Path list to filter BGP routes to be advertised to a specified peer.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to a peer, and all the BGP routes will be advertised to the peer.

Format

peer ipv4-address as-path-filter { number | name } export

undo peer ipv4-address as-path-filter { number | name } export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

number

Specifies the number of the AS path filter.

The value is a decimal integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To apply a routing policy based on an AS_Path list to filter BGP routes to be advertised to a specified peer, run the peer as-path-filter export command. This configuration allows the routes that do not match the policy to be filtered out.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 as-path-filter 3 export

peer as-path-filter export (BGP-IPv4 unicast address family view) (group)

Function

The peer as-path-filter export command configures a route-filter based on the AS_Path for the routes to be advertised to a peer group.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to peers in a peer group, and all the BGP routes will be advertised to the peer group.

Format

peer group-name as-path-filter { number | name } export

undo peer group-name as-path-filter { number | name } export

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

number

Specifies the number of the AS path filter.

The value is a decimal integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the peer as-path-filter export command is run to apply a routing policy to the BGP routes to be advertised to a specified peer group, the AS_Path filter filters out unqualified routes.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test as-path-filter 3 export

peer as-path-filter export (BGP-IPv4 unicast address family view)(IPv4)

Function

The peer as-path-filter export command applies a routing policy based on an AS_Path list to filter BGP routes to be advertised to a specified peer.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to a peer, and all the BGP routes will be advertised to the peer.

Format

peer ipv4-address as-path-filter { number | name } export

undo peer ipv4-address as-path-filter { number | name } export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

number

Specifies the number of the AS_Path filter.

The value is an integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To apply a routing policy based on an AS_Path list to filter BGP routes to be advertised to a specified peer, run the peer as-path-filter export command. This configuration allows the routes that do not match the policy to be filtered out.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 as-path-filter 3 export

peer as-path-filter export (BGP-IPv6 unicast address family view) (group)

Function

The peer as-path-filter export command configures a route-filter based on the AS_Path for the routes to be advertised to a peer group.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to peers in a peer group, and all the BGP routes will be advertised to the peer group.

Format

peer group-name as-path-filter { number | name } export

undo peer group-name as-path-filter { number | name } export

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

number

Specifies the number of the AS path filter.

The value is a decimal integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the peer as-path-filter export command is run to apply a routing policy to the BGP routes to be advertised to a specified peer group, the AS_Path filter filters out unqualified routes.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test as-path-filter 3 export

peer as-path-filter export (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer as-path-filter export command applies a routing policy based on an AS_Path list to filter BGP routes to be advertised to a specified peer.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to a peer, and all the BGP routes will be advertised to the peer.

Format

peer ipv6-address as-path-filter { number | name } export

undo peer ipv6-address as-path-filter { number | name } export

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

number

Specifies the number of an AS_Path filter.

The value is an integer in the range from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. It cannot contain spaces.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To apply a routing policy based on an AS_Path list to filter BGP routes to be advertised to a specified peer, run the peer as-path-filter export command. This configuration allows the routes that do not match the policy to be filtered out.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 as-path-filter 3 export

peer as-path-filter export (BGP-IPv6 unicast address family view)(IPv4)

Function

The peer as-path-filter export command applies a routing policy based on an AS_Path list to filter BGP routes to be advertised to a specified peer.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to a peer, and all the BGP routes will be advertised to the peer.

Format

peer ipv4-address as-path-filter { number | name } export

undo peer ipv4-address as-path-filter { number | name } export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

number

Specifies the number of the AS_Path filter.

The value is an integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To apply a routing policy based on an AS_Path list to filter BGP routes to be advertised to a specified peer, run the peer as-path-filter export command. This configuration allows the routes that do not match the policy to be filtered out.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit 100
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 as-path-filter 3 export

peer as-path-filter export (BGP-VPN instance IPv4 address family view) (group)

Function

The peer as-path-filter export command configures a route-filter based on the AS_Path for the routes to be advertised to a peer group.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to peers in a peer group, and all the BGP routes will be advertised to the peer group.

Format

peer group-name as-path-filter { number | name } export

undo peer group-name as-path-filter { number | name } export

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

number

Specifies the number of the AS_Path filter.

The value is an integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the peer as-path-filter export command is run to apply a routing policy to the BGP routes to be advertised to a specified peer group, the AS_Path filter filters out unqualified routes.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

The peer as-path-filter export command is mutually exclusive with the peer route-filter export commands.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] ip as-path-filter 3 permit 10
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test as-path-filter 3 export

peer as-path-filter export (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer as-path-filter export command applies a routing policy based on an AS_Path list to filter BGP routes to be advertised to a specified peer.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to a peer, and all the BGP routes will be advertised to the peer.

Format

peer ipv4-address as-path-filter { number | name } export

undo peer ipv4-address as-path-filter { number | name } export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

number

Specifies the number of the AS_Path filter.

The value is an integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To apply a routing policy based on an AS_Path list to filter BGP routes to be advertised to a specified peer, run the peer as-path-filter export command. This configuration allows the routes that do not match the policy to be filtered out.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

The peer as-path-filter export command is mutually exclusive with the peer route-filter export commands.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] ip as-path-filter 3 permit 10
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-path-filter 3 export

peer as-path-filter export (BGP-VPN instance IPv6 address family view) (group)

Function

The peer as-path-filter export command configures a route-filter based on the AS_Path for the routes to be advertised to a peer group.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to peers in a peer group, and all the BGP routes will be advertised to the peer group.

Format

peer group-name as-path-filter { number | name } export

undo peer group-name as-path-filter { number | name } export

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

number

Specifies the number of the AS path filter.

The value is a decimal integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the peer as-path-filter export command is run to apply a routing policy to the BGP routes to be advertised to a specified peer group, the AS_Path filter filters out unqualified routes.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test as-path-filter 3 export

peer as-path-filter export (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer as-path-filter export command configures a policy based on an AS_Path list for filtering BGP routes to be advertised to a specified peer.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to a peer, and all the BGP routes will be advertised to the peer.

Format

peer ipv6-address as-path-filter { number | name } export

undo peer ipv6-address as-path-filter { number | name } export

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

number

Specifies the number of an AS_Path filter.

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

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. It cannot contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer as-path-filter export command is used to apply a route filtering policy based on an AS_Path list to BGP routes to be advertised to a specified peer, the routers that do not match the policy are filtered out.

Prerequisites

The ip as-path-filter command has been run to define an AS-Path filter.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-path-filter 3 export

peer as-path-filter export (BGP-VPN instance IPv6 address family view)(IPv4)

Function

The peer as-path-filter export command configures a policy based on an AS_Path list for filtering BGP routes to be advertised to a specified peer.

The undo peer as-path-filter export command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes to be advertised to a peer, and all the BGP routes will be advertised to the peer.

Format

peer ipv4-address as-path-filter { number | name } export

undo peer ipv4-address as-path-filter { number | name } export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

number

Specifies the number of the AS_Path filter.

The value is an integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer as-path-filter export command is used to apply a route filtering policy based on an AS_Path list to BGP routes to be advertised to a specified peer, the routers that do not match the policy are filtered out.

Prerequisites

The ip as-path-filter command has been run to define an AS-Path filter.

Precautions

Only one AS_Path filter can be used to filter routes to be advertised to the same peer.

The peer as-path-filter export command is mutually exclusive with the peer route-filter export commands.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] ip as-path-filter 3 permit 100
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 as-path-filter 3 export

peer as-path-filter import (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer as-path-filter import command applies a routing policy based on an AS_Path list to filter BGP routes received from a specified peer.

The undo peer as-path-filter import command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from a peer, and all the BGP routes will be received from the peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address as-path-filter { number | name } import

undo peer ipv4-address as-path-filter { number | name } import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

number

Specifies the number of the AS path filter.

The value is a decimal integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To apply a routing policy based on an AS_Path list to filter BGP routes received from a specified peer, run the peer as-path-filter import command. This configuration allows the routes that do not match the policy to be filtered out.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter the routes received from the same peer. Similarly, only one AS_Path filter can be used to filter routes to be received from the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit 20
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 as-path-filter 3 import

peer as-path-filter import (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer as-path-filter import command configures a BGP route filtering policy based on the AS_Path for the routes received from a peer group.

The undo peer as-path-filter import command cancels the existing configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from peers in a peer group, and all the received BGP routes will be permitted.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name as-path-filter { number | name } import

undo peer group-name as-path-filter { number | name } import

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

number

Specifies the number of the AS path filter.

The value is a decimal integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the peer as-path-filter import command is run to apply a routing policy to BGP routes received from a specified peer group, the AS_Path filter filters out unqualified routes.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter the routes received from the same peer. Similarly, only one AS_Path filter can be used to filter routes to be received from the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 2 permit 20
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test as-path-filter 2 import

peer as-path-filter import (BGP view)

Function

The peer as-path-filter import command configures a policy based on an AS_Path list for filtering BGP routes received from a peer.

The undo peer as-path-filter import command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from a peer, and all the BGP routes will be received from the peer.

Format

peer ipv4-address as-path-filter { number | name } import

undo peer ipv4-address as-path-filter { number | name } import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

number

Specifies the number of the AS_Path filter.

The value is an integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer as-path-filter import command is used to apply a route filtering policy based on an AS_Path list to BGP routes to be received from a specified peer, the routers that do not match the policy are filtered out.

Prerequisites

The ip as-path-filter command has been run to define an AS-Path filter.

Precautions

Only one AS_Path filter can be used to filter the routes received from the same peer. Similarly, only one AS_Path filter can be used to filter routes to be received from the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 as-path-filter 3 import

peer as-path-filter import (BGP view) (group)

Function

The peer as-path-filter import command configures a policy based on an AS_Path list for filtering BGP routes received from a peer group.

The undo peer as-path-filter import command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from a peer group, and all the BGP routes will be received from the peer group.

Format

peer group-name as-path-filter { number | name } import

undo peer group-name as-path-filter { number | name } import

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

number

Specifies the number of the AS_Path filter.

The value is an integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer as-path-filter import command is used to apply a route filtering policy based on an AS_Path list to BGP routes to be received from a specified peer group, the routers that do not match the policy are filtered out.

Prerequisites

The ip as-path-filter command has been run to define an AS-Path filter.

Precautions

Only one AS_Path filter can be used to filter the routes received from the same peer. Similarly, only one AS_Path filter can be used to filter routes to be received from the same peer.

Example

# Configure an AS_Path filter for a peer group.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test as-path-filter 3 import

peer as-path-filter import (BGP-IPv4 unicast address family view)

Function

The peer as-path-filter import command applies a routing policy based on an AS_Path list to filter BGP routes received from a specified peer.

The undo peer as-path-filter import command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from a peer, and all the BGP routes will be received from the peer.

Format

peer ipv4-address as-path-filter { number | name } import

undo peer ipv4-address as-path-filter { number | name } import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

number

Specifies the number of the AS_Path filter.

The value is an integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To apply a routing policy based on an AS_Path list to filter BGP routes received from a specified peer, run the peer as-path-filter import command. This configuration allows the routes that do not match the policy to be filtered out.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter the routes received from the same peer. Similarly, only one AS_Path filter can be used to filter routes to be received from the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 as-path-filter 3 import

peer as-path-filter import (BGP-IPv4 unicast address family view) (group)

Function

The peer as-path-filter import command configures a BGP route filtering policy based on the AS_Path for the routes received from a peer group.

The undo peer as-path-filter import command cancels the existing configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from peers in a peer group, and all the received BGP routes will be permitted.

Format

peer group-name as-path-filter { number | name } import

undo peer group-name as-path-filter { number | name } import

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

number

Specifies the number of the AS_Path filter.

The value is an integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the peer as-path-filter import command is run to apply a routing policy to BGP routes received from a specified peer group, the AS_Path filter filters out unqualified routes.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter the routes received from the same peer. Similarly, only one AS_Path filter can be used to filter routes to be received from the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test as-path-filter 3 import

peer as-path-filter import (BGP-IPv6 unicast address family view)

Function

The peer as-path-filter import command applies a routing policy based on an AS_Path list to filter BGP routes received from a specified peer.

The undo peer as-path-filter import command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from a peer, and all the BGP routes will be received from the peer.

Format

peer ipv4-address as-path-filter { number | name } import

undo peer ipv4-address as-path-filter { number | name } import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

number

Specifies the number of the AS path filter.

The value is a decimal integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To apply a routing policy based on an AS_Path list to filter BGP routes received from a specified peer, run the peer as-path-filter import command. This configuration allows the routes that do not match the policy to be filtered out.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter the routes received from the same peer. Similarly, only one AS_Path filter can be used to filter routes to be received from the same peer.

Example

# Set the peer AS_Path filter.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit 100
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 as-path-filter 3 import

peer as-path-filter import (BGP-IPv6 unicast address family view) (group)

Function

The peer as-path-filter import command configures a BGP route filtering policy based on the AS_Path for the routes received from a peer group.

The undo peer as-path-filter import command cancels the existing configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from peers in a peer group, and all the received BGP routes will be permitted.

Format

peer group-name as-path-filter { number | name } import

undo peer group-name as-path-filter { number | name } import

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

number

Specifies the number of the AS path filter.

The value is a decimal integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the peer as-path-filter import command is run to apply a routing policy to BGP routes received from a specified peer group, the AS_Path filter filters out unqualified routes.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter the routes received from the same peer. Similarly, only one AS_Path filter can be used to filter routes to be received from the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test as-path-filter 3 import

peer as-path-filter import (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer as-path-filter import command applies a routing policy based on an AS_Path list to filter BGP routes received from a specified peer.

The undo peer as-path-filter import command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from a peer, and all the BGP routes will be received from the peer.

Format

peer ipv6-address as-path-filter { number | name } import

undo peer ipv6-address as-path-filter { number | name } import

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

number

Specifies the number of an AS_Path filter.

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

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters, spaces not supported.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To apply a routing policy based on an AS_Path list to filter BGP routes received from a specified peer, run the peer as-path-filter import command. This configuration allows the routes that do not match the policy to be filtered out.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter the routes received from the same peer. Similarly, only one AS_Path filter can be used to filter routes to be received from the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 as-path-filter 3 import

peer as-path-filter import (BGP-VPN instance IPv4 address family view)

Function

The peer as-path-filter import command applies a routing policy based on an AS_Path list to filter BGP routes received from a specified peer.

The undo peer as-path-filter import command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from a peer, and all the BGP routes will be received from the peer.

Format

peer ipv4-address as-path-filter { number | name } import

undo peer ipv4-address as-path-filter { number | name } import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

number

Specifies the number of the AS path filter.

The value is a decimal integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To apply a routing policy based on an AS_Path list to filter BGP routes received from a specified peer, run the peer as-path-filter import command. This configuration allows the routes that do not match the policy to be filtered out.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter routes to be received from the same peer.

The peer as-path-filter import command is mutually exclusive with the peer route-filter import commands.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] ip as-path-filter 3 permit 10
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-path-filter 3 import

peer as-path-filter import (BGP-VPN instance IPv4 address family view) (group)

Function

The peer as-path-filter import command configures a BGP route filtering policy based on the AS_Path for the routes received from a peer group.

The undo peer as-path-filter import command cancels the existing configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from peers in a peer group, and all the received BGP routes will be permitted.

Format

peer group-name as-path-filter { number | name } import

undo peer group-name as-path-filter { number | name } import

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

number

Specifies the number of the AS path filter.

The value is a decimal integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the peer as-path-filter import command is run to apply a routing policy to BGP routes received from a specified peer group, the AS_Path filter filters out unqualified routes.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter routes to be received from the same peer.

The peer as-path-filter import command is mutually exclusive with the peer route-filter import commands.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit 10
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test as-path-filter 3 import

peer as-path-filter import (BGP-VPN instance IPv6 address family view)

Function

The peer as-path-filter import command configures a policy based on an AS_Path list for filtering BGP routes received from a peer.

The undo peer as-path-filter import command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from a peer, and all the BGP routes will be received from the peer.

Format

peer ipv4-address as-path-filter { number | name } import

undo peer ipv4-address as-path-filter { number | name } import

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

number

Specifies the number of an AS_Path filter.

The value is an integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer as-path-filter import command is used to apply a route filtering policy based on an AS_Path list to BGP routes to be received from a specified peer, the routers that do not match the policy are filtered out.

Prerequisites

The ip as-path-filter command has been run to define an AS-Path filter.

Precautions

Only one AS_Path filter can be used to filter routes to be received from the same peer.

The peer as-path-filter import command is mutually exclusive with the peer route-filter import commands.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit 100
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 as-path-filter 3 import

peer as-path-filter import (BGP-VPN instance IPv6 address family view) (group)

Function

The peer as-path-filter import command configures a BGP route filtering policy based on the AS_Path for the routes received from a peer group.

The undo peer as-path-filter import command cancels the existing configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from peers in a peer group, and all the received BGP routes will be permitted.

Format

peer group-name as-path-filter { number | name } import

undo peer group-name as-path-filter { number | name } import

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

number

Specifies the number of the AS path filter.

The value is a decimal integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the peer as-path-filter import command is run to apply a routing policy to BGP routes received from a specified peer group, the AS_Path filter filters out unqualified routes.

Prerequisites

Before configuring a BGP route-filter based on the AS_Path, you must run the ip as-path-filter command to define an AS_Path filter first.

Precautions

Only one AS_Path filter can be used to filter the routes received from the same peer. Similarly, only one AS_Path filter can be used to filter routes to be received from the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test as-path-filter 3 import

peer as-path-filter import (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer as-path-filter import command configures a policy based on an AS_Path list for filtering BGP routes received from a peer.

The undo peer as-path-filter import command cancels this configuration.

By default, no policy based on an AS_Path list is configured for filtering BGP routes received from a peer, and all the BGP routes will be received from the peer.

Format

peer ipv6-address as-path-filter { number | name } import

undo peer ipv6-address as-path-filter { number | name } import

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

number

Specifies the number of the AS_Path filter.

The value is an integer ranging from 1 to 256.

name

Specifies the name of an AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer as-path-filter import command is used to apply a route filtering policy based on an AS_Path list to BGP routes to be received from a specified peer, the routers that do not match the policy are filtered out.

Prerequisites

The ip as-path-filter command has been run to define an AS-Path filter.

Precautions

Only one AS_Path filter can be used to filter the routes received from the same peer. Similarly, only one AS_Path filter can be used to filter routes to be received from the same peer.

Example

# Configure an AS_Path filter for a peer.
<HUAWEI> system-view
[HUAWEI] ip as-path-filter 3 permit ^10_
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-path-filter 3 import

peer attribute-id (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer attribute-id command configures the mode of processing a specified path attribute or an incorrect path attribute.

The undo peer attribute-id command restores the default setting.

By default, the specified path attributes are processed according to the standard protocol.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> { discard | withdraw | treat-as-unknown }

peer peerIpv4Addr treat-with-error attribute-id id accept-zero-value

undo peer peerIpv4Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> [ discard | withdraw | treat-as-unknown ]

undo peer peerIpv4Addr treat-with-error attribute-id id [ accept-zero-value ]

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

path-attribute-treat

Processes path attribute packets.

-

attribute-id id

Specifies an attribute ID.

The value is an integer and can be one of the following ones:

0: Reserved

11: DPA

12: ADVERTISER

13: RCID_PATH / CLUSTER_ID

16: Extended Communities

19: SAFI Specific Attribute (SSA)

20: Connector Attribute

21: AS_PATHLIMIT

22: PMSI_TUNNEL

23: Tunnel Encapsulation Attribute

24: Traffic Engineering

25: IPv6 Address Specific Extended Community

26: AIGP

27: PE Distinguisher Labels

28: ELC

29: LS_TYPE

30: REMOTE_NEXTHOP

32: LARGE_COMMUNITY

40: PREFIX_SID

128: ATTR_SET

129: WIDE_COMMUNITY

255: Reserved for development

31, 33-39, 41-127, 130-254: Unassigned

to id2

Specifies an end attribute ID.

The value is an integer and can be one of the following ones:

0: Reserved

11: DPA

12: ADVERTISER

13: RCID_PATH / CLUSTER_ID

16: Extended Communities

19: SAFI Specific Attribute (SSA)

20: Connector Attribute

21: AS_PATHLIMIT

22: PMSI_TUNNEL

23: Tunnel Encapsulation Attribute

24: Traffic Engineering

25: IPv6 Address Specific Extended Community

26: AIGP

27: PE Distinguisher Labels

28: ELC

29: LS_TYPE

30: REMOTE_NEXTHOP

32: LARGE_COMMUNITY

40: PREFIX_SID

128: ATTR_SET

129: WIDE_COMMUNITY

255: Reserved for development

31, 33-39, 41-127, 130-254: Unassigned

discard

Discards messages carrying specified attributes.

-

withdraw

Withdraws the routes with the specified attribute.

-

treat-as-unknown

Processes the specified attributes as unknown attributes. If a specified attribute is optional transitive, the BGP device accepts this attribute and advertises it to other peers; if the specified attribute is of any other type, the BGP device discards this attribute.

-

treat-with-error

Processes packets with incorrect path attributes.

-

accept-zero-value

Indicates to accept the path attributes with a value of 0.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP Update messages contain various path attributes. If the local device receives any Update message with an incorrect format, BGP session flapping may occur. To enhance reliability, you can run this command to configure a processing mode for specified BGP path attributes.

The path-attribute-treat command is used to specify a processing mode for path attributes. The processing modes are as follows:

  • discard: discarding messages carrying specified attributes.
  • withdraw: withdrawing routes with specified attributes.
  • treat-as-unknown: Processing specified attributes as unknown attributes

treat-with-error is used to specify the processing mode of incorrect path attributes. The processing modes are as follows:

  • accept-zero-value: accepting the path attribute with the value of 0.

Precautions

This command may cause the specified path attributes to be discarded or routes carrying the path attributes to be withdrawn. Therefore, exercise caution when you run this command.

The command configuration takes effect immediately for the routes received after the command is run. However, for the routes received before the command is run, the configuration can take effect only after the refresh bgp command is run.

Example

# Configure a mode in which a device processes specified path attributes in received BGP Update messages.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance a
[HUAWEI-vpn-instance-a] ipv4-family
[HUAWEI-vpn-instance-a-af-ipv4] quit
[HUAWEI-vpn-instance-a] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance a
[HUAWEI-bgp-instance-a-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-a] peer 10.1.1.1 path-attribute-treat attribute-id 19 to 21 discard

peer attribute-id (BGP-IPv4 unicast address family view)

Function

The peer attribute-id command configures the mode of processing a specified path attribute or an incorrect path attribute.

The undo peer attribute-id command restores the default setting.

By default, BGP path attributes are processed according to a standard protocol.

Format

peer peerIpv4Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> { discard | withdraw | treat-as-unknown }

peer peerIpv4Addr treat-with-error attribute-id id accept-zero-value

undo peer peerIpv4Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> [ discard | withdraw | treat-as-unknown ]

undo peer peerIpv4Addr treat-with-error attribute-id id [ accept-zero-value ]

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

path-attribute-treat

Processes path attribute packets.

-

attribute-id id

Specifies an attribute ID.

The value is an integer and can be one of the following ones:

0: Reserved

11: DPA

12: ADVERTISER

13: RCID_PATH / CLUSTER_ID

16: Extended Communities

19: SAFI Specific Attribute (SSA)

20: Connector Attribute

21: AS_PATHLIMIT

22: PMSI_TUNNEL

23: Tunnel Encapsulation Attribute

24: Traffic Engineering

25: IPv6 Address Specific Extended Community

26: AIGP

27: PE Distinguisher Labels

28: ELC

29: LS_TYPE

30: REMOTE_NEXTHOP

32: LARGE_COMMUNITY

40: PREFIX_SID

128: ATTR_SET

129: WIDE_COMMUNITY

255: Reserved for development

31, 33-39, 41-127, 130-254: Unassigned

to id2

Specifies an end attribute ID.

The value is an integer and can be one of the following ones:

0: Reserved

11: DPA

12: ADVERTISER

13: RCID_PATH / CLUSTER_ID

16: Extended Communities

19: SAFI Specific Attribute (SSA)

20: Connector Attribute

21: AS_PATHLIMIT

22: PMSI_TUNNEL

23: Tunnel Encapsulation Attribute

24: Traffic Engineering

25: IPv6 Address Specific Extended Community

26: AIGP

27: PE Distinguisher Labels

28: ELC

29: LS_TYPE

30: REMOTE_NEXTHOP

32: LARGE_COMMUNITY

40: PREFIX_SID

128: ATTR_SET

129: WIDE_COMMUNITY

255: Reserved for development

31, 33-39, 41-127, 130-254: Unassigned

discard

Discards messages carrying specified attributes.

-

withdraw

Withdraws the routes with the specified attribute.

-

treat-as-unknown

Processes the specified attributes as unknown attributes. If a specified attribute is optional transitive, the BGP device accepts this attribute and advertises it to other peers; if the specified attribute is of any other type, the BGP device discards this attribute.

-

treat-with-error

Processes packets with incorrect path attributes.

-

accept-zero-value

Indicates to accept the path attributes with a value of 0.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP Update messages contain various path attributes. If the local device receives any Update message with an incorrect format, BGP session flapping may occur. To enhance reliability, you can run this command to configure a processing mode for specified BGP path attributes.

The path-attribute-treat command is used to specify a processing mode for path attributes. The processing modes are as follows:

  • discard: discarding messages carrying specified attributes.
  • withdraw: withdrawing routes with specified attributes.
  • treat-as-unknown: Processing specified attributes as unknown attributes

treat-with-error is used to specify the processing mode of incorrect path attributes. The processing modes are as follows:

  • accept-zero-value: accepting the path attribute with the value of 0.

Precautions

This command may cause the specified path attributes to be discarded or routes carrying the path attributes to be withdrawn. Therefore, exercise caution when you run this command.

The command configuration takes effect immediately for the routes received after the command is run. However, for the routes received before the command is run, the configuration can take effect only after the refresh bgp command is run.

Example

# Configure a mode in which a device processes specified path attributes in received BGP Update messages.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 path-attribute-treat attribute-id 19 to 21 discard

peer attribute-id (BGP-IPv6 unicast address family view)

Function

The peer attribute-id command configures the mode of processing a specified path attribute or an incorrect path attribute.

The undo peer attribute-id command restores the default setting.

By default, the specified path attributes are processed according to the standard protocol.

Format

peer peerIpv6Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> { discard | withdraw | treat-as-unknown }

peer peerIpv4Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> { discard | withdraw | treat-as-unknown }

peer peerIpv6Addr treat-with-error attribute-id id accept-zero-value

peer peerIpv4Addr treat-with-error attribute-id id accept-zero-value

undo peer peerIpv6Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> [ discard | withdraw | treat-as-unknown ]

undo peer peerIpv4Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> [ discard | withdraw | treat-as-unknown ]

undo peer peerIpv6Addr treat-with-error attribute-id id [ accept-zero-value ]

undo peer peerIpv4Addr treat-with-error attribute-id id [ accept-zero-value ]

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

path-attribute-treat

Processes path attribute packets.

-

attribute-id id

Specifies an attribute ID.

The value is an integer and can be one of the following ones:

0: Reserved

11: DPA

12: ADVERTISER

13: RCID_PATH / CLUSTER_ID

16: Extended Communities

19: SAFI Specific Attribute (SSA)

20: Connector Attribute

21: AS_PATHLIMIT

22: PMSI_TUNNEL

23: Tunnel Encapsulation Attribute

24: Traffic Engineering

25: IPv6 Address Specific Extended Community

26: AIGP

27: PE Distinguisher Labels

28: ELC

29: LS_TYPE

30: REMOTE_NEXTHOP

32: LARGE_COMMUNITY

40: PREFIX_SID

128: ATTR_SET

129: WIDE_COMMUNITY

255: Reserved for development

31, 33-39, 41-127, 130-254: Unassigned

to id2

Specifies an end attribute ID.

The value is an integer and can be one of the following ones:

0: Reserved

11: DPA

12: ADVERTISER

13: RCID_PATH / CLUSTER_ID

16: Extended Communities

19: SAFI Specific Attribute (SSA)

20: Connector Attribute

21: AS_PATHLIMIT

22: PMSI_TUNNEL

23: Tunnel Encapsulation Attribute

24: Traffic Engineering

25: IPv6 Address Specific Extended Community

26: AIGP

27: PE Distinguisher Labels

28: ELC

29: LS_TYPE

30: REMOTE_NEXTHOP

32: LARGE_COMMUNITY

40: PREFIX_SID

128: ATTR_SET

129: WIDE_COMMUNITY

255: Reserved for development

31, 33-39, 41-127, 130-254: Unassigned

discard

Discards messages carrying specified attributes.

-

withdraw

Withdraws the routes with the specified attribute.

-

treat-as-unknown

Processes the specified attributes as unknown attributes. If a specified attribute is optional transitive, the BGP device accepts this attribute and advertises it to other peers; if the specified attribute is of any other type, the BGP device discards this attribute.

-

peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

treat-with-error

Processes packets with incorrect path attributes.

-

accept-zero-value

Indicates to accept the path attributes with a value of 0.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP Update messages contain various path attributes. If the local device receives any Update message with an incorrect format, BGP session flapping may occur. To enhance reliability, you can run this command to configure a processing mode for specified BGP path attributes.

The path-attribute-treat command is used to specify a processing mode for path attributes. The processing modes are as follows:

  • discard: discarding messages carrying specified attributes.
  • withdraw: withdrawing routes with specified attributes.
  • treat-as-unknown: Processing specified attributes as unknown attributes

treat-with-error is used to specify the processing mode of incorrect path attributes. The processing modes are as follows:

  • accept-zero-value: accepting the path attribute with the value of 0.

Precautions

This command may cause the specified path attributes to be discarded or routes carrying the path attributes to be withdrawn. Therefore, exercise caution when you run this command.

The command configuration takes effect immediately for the routes received after the command is run. However, for the routes received before the command is run, the configuration can take effect only after the refresh bgp command is run.

Example

# Configure a mode in which a device processes specified path attributes in received BGP Update messages.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 path-attribute-treat attribute-id 19 to 21 discard

peer attribute-id (BGP-VPN instance IPv4 address family view)

Function

The peer attribute-id command configures the mode of processing a specified path attribute or an incorrect path attribute.

The undo peer attribute-id command restores the default setting.

By default, BGP path attributes are processed according to a standard protocol.

Format

peer peerIpv4Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> { discard | withdraw | treat-as-unknown }

peer peerIpv4Addr treat-with-error attribute-id id accept-zero-value

undo peer peerIpv4Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> [ discard | withdraw | treat-as-unknown ]

undo peer peerIpv4Addr treat-with-error attribute-id id [ accept-zero-value ]

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

It is in dotted decimal notation.

path-attribute-treat

Processes path attribute packets.

-

attribute-id id

Specifies an attribute ID.

The value is an integer and can be one of the following ones:

0: Reserved

11: DPA

12: ADVERTISER

13: RCID_PATH / CLUSTER_ID

16: Extended Communities

19: SAFI Specific Attribute (SSA)

20: Connector Attribute

21: AS_PATHLIMIT

22: PMSI_TUNNEL

23: Tunnel Encapsulation Attribute

24: Traffic Engineering

25: IPv6 Address Specific Extended Community

26: AIGP

27: PE Distinguisher Labels

28: ELC

29: LS_TYPE

30: REMOTE_NEXTHOP

32: LARGE_COMMUNITY

40: PREFIX_SID

128: ATTR_SET

129: WIDE_COMMUNITY

255: Reserved for development

31, 33-39, 41-127, 130-254: Unassigned

to id2

Specifies an end attribute ID.

The value is an integer and can be one of the following ones:

0: Reserved

11: DPA

12: ADVERTISER

13: RCID_PATH / CLUSTER_ID

16: Extended Communities

19: SAFI Specific Attribute (SSA)

20: Connector Attribute

21: AS_PATHLIMIT

22: PMSI_TUNNEL

23: Tunnel Encapsulation Attribute

24: Traffic Engineering

25: IPv6 Address Specific Extended Community

26: AIGP

27: PE Distinguisher Labels

28: ELC

29: LS_TYPE

30: REMOTE_NEXTHOP

32: LARGE_COMMUNITY

40: PREFIX_SID

128: ATTR_SET

129: WIDE_COMMUNITY

255: Reserved for development

31, 33-39, 41-127, 130-254: Unassigned

discard

Discards messages carrying specified attributes.

-

withdraw

Withdraws the routes with the specified attribute.

-

treat-as-unknown

Processes the specified attributes as unknown attributes. If a specified attribute is optional transitive, the BGP device accepts this attribute and advertises it to other peers; if the specified attribute is of any other type, the BGP device discards this attribute.

-

treat-with-error

Processes packets with incorrect path attributes.

-

accept-zero-value

Indicates to accept the path attributes with a value of 0.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP Update messages contain various path attributes. If the local device receives any Update message with an incorrect format, BGP session flapping may occur. To enhance reliability, you can run this command to configure a processing mode for specified BGP path attributes.

The path-attribute-treat command is used to specify a processing mode for path attributes. The processing modes are as follows:

  • discard: discarding messages carrying specified attributes.
  • withdraw: withdrawing routes with specified attributes.
  • treat-as-unknown: Processing specified attributes as unknown attributes

treat-with-error is used to specify the processing mode of incorrect path attributes. The processing modes are as follows:

  • accept-zero-value: accepting the path attribute with the value of 0.

Precautions

This command may cause the specified path attributes to be discarded or routes carrying the path attributes to be withdrawn. Therefore, exercise caution when you run this command.

The command configuration takes effect immediately for the routes received after the command is run. However, for the routes received before the command is run, the configuration can take effect only after the refresh bgp command is run.

Example

# Configure a mode in which a device processes specified path attributes in received BGP Update messages.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance a
[HUAWEI-vpn-instance-a] ipv4-family
[HUAWEI-vpn-instance-a-af-ipv4] quit
[HUAWEI-vpn-instance-a] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance a
[HUAWEI-bgp-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-a] peer 10.1.1.1 path-attribute-treat attribute-id 19 to 21 discard

peer attribute-id (BGP-VPN instance IPv6 address family view)

Function

The peer attribute-id command configures the mode of processing a specified path attribute or an incorrect path attribute.

The undo peer attribute-id command restores the default setting.

By default, BGP path attributes are processed according to a standard protocol.

Format

peer peerIpv4Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> { discard | withdraw | treat-as-unknown }

peer peerIpv4Addr treat-with-error attribute-id id accept-zero-value

undo peer peerIpv4Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> [ discard | withdraw | treat-as-unknown ]

undo peer peerIpv4Addr treat-with-error attribute-id id [ accept-zero-value ]

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

path-attribute-treat

Processes path attribute packets.

-

attribute-id id

Specifies an attribute ID.

The value is an integer and can be one of the following ones:

0: Reserved

11: DPA

12: ADVERTISER

13: RCID_PATH / CLUSTER_ID

16: Extended Communities

19: SAFI Specific Attribute (SSA)

20: Connector Attribute

21: AS_PATHLIMIT

22: PMSI_TUNNEL

23: Tunnel Encapsulation Attribute

24: Traffic Engineering

25: IPv6 Address Specific Extended Community

26: AIGP

27: PE Distinguisher Labels

28: ELC

29: LS_TYPE

30: REMOTE_NEXTHOP

32: LARGE_COMMUNITY

40: PREFIX_SID

128: ATTR_SET

129: WIDE_COMMUNITY

255: Reserved for development

31, 33-39, 41-127, 130-254: Unassigned

to id2

Specifies an end attribute ID.

The value is an integer and can be one of the following ones:

0: Reserved

11: DPA

12: ADVERTISER

13: RCID_PATH / CLUSTER_ID

16: Extended Communities

19: SAFI Specific Attribute (SSA)

20: Connector Attribute

21: AS_PATHLIMIT

22: PMSI_TUNNEL

23: Tunnel Encapsulation Attribute

24: Traffic Engineering

25: IPv6 Address Specific Extended Community

26: AIGP

27: PE Distinguisher Labels

28: ELC

29: LS_TYPE

30: REMOTE_NEXTHOP

32: LARGE_COMMUNITY

40: PREFIX_SID

128: ATTR_SET

129: WIDE_COMMUNITY

255: Reserved for development

31, 33-39, 41-127, 130-254: Unassigned

discard

Discards messages carrying specified attributes.

-

withdraw

Withdraws the routes with the specified attribute.

-

treat-as-unknown

Processes the specified attributes as unknown attributes. If a specified attribute is optional transitive, the BGP device accepts this attribute and advertises it to other peers; if the specified attribute is of any other type, the BGP device discards this attribute.

-

treat-with-error

Processes packets with incorrect path attributes.

-

accept-zero-value

Indicates to accept the path attributes with a value of 0.

-

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP Update messages contain various path attributes. If the local device receives any Update message with an incorrect format, BGP session flapping may occur. To enhance reliability, you can run this command to configure a processing mode for specified BGP path attributes.

The path-attribute-treat command is used to specify a processing mode for path attributes. The processing modes are as follows:

  • discard: discarding messages carrying specified attributes.
  • withdraw: withdrawing routes with specified attributes.
  • treat-as-unknown: Processing specified attributes as unknown attributes

treat-with-error is used to specify the processing mode of incorrect path attributes. The processing modes are as follows:

  • accept-zero-value: accepting the path attribute with the value of 0.

Precautions

This command may cause the specified path attributes to be discarded or routes carrying the path attributes to be withdrawn. Therefore, exercise caution when you run this command.

The command configuration takes effect immediately for the routes received after the command is run. However, for the routes received before the command is run, the configuration can take effect only after the refresh bgp command is run.

Example

# Configure a mode in which a device processes specified path attributes in received BGP Update messages.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance a
[HUAWEI-vpn-instance-a] ipv6-family
[HUAWEI-vpn-instance-a-af-ipv6] quit
[HUAWEI-vpn-instance-a] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] quit
[HUAWEI-bgp] ipv6-family vpn-instance a
[HUAWEI-bgp-6-a] peer 10.1.1.1 enable
[HUAWEI-bgp-6-a] peer 10.1.1.1 path-attribute-treat attribute-id 19 to 21 discard

peer attribute-id (BGP-VPN instance IPv6 address family view)(IPv6)

Function

The peer attribute-id command configures the mode of processing a specified path attribute or an incorrect path attribute.

The undo peer attribute-id command restores the default setting.

By default, BGP path attributes are processed according to a standard protocol.

Format

peer peerIpv6Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> { discard | withdraw | treat-as-unknown }

peer peerIpv6Addr treat-with-error attribute-id id accept-zero-value

undo peer peerIpv6Addr path-attribute-treat attribute-id { id [ to id2 ] } &<1-255> [ discard | withdraw | treat-as-unknown ]

undo peer peerIpv6Addr treat-with-error attribute-id id [ accept-zero-value ]

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

path-attribute-treat

Processes path attribute packets.

-

attribute-id id

Specifies an attribute ID.

The value is an integer and can be one of the following ones:

0: Reserved

11: DPA

12: ADVERTISER

13: RCID_PATH / CLUSTER_ID

16: Extended Communities

19: SAFI Specific Attribute (SSA)

20: Connector Attribute

21: AS_PATHLIMIT

22: PMSI_TUNNEL

23: Tunnel Encapsulation Attribute

24: Traffic Engineering

25: IPv6 Address Specific Extended Community

26: AIGP

27: PE Distinguisher Labels

28: ELC

29: LS_TYPE

30: REMOTE_NEXTHOP

32: LARGE_COMMUNITY

40: PREFIX_SID

128: ATTR_SET

129: WIDE_COMMUNITY

255: Reserved for development

31, 33-39, 41-127, 130-254: Unassigned

to id2

Specifies an end attribute ID.

The value is an integer and can be one of the following ones:

0: Reserved

11: DPA

12: ADVERTISER

13: RCID_PATH / CLUSTER_ID

16: Extended Communities

19: SAFI Specific Attribute (SSA)

20: Connector Attribute

21: AS_PATHLIMIT

22: PMSI_TUNNEL

23: Tunnel Encapsulation Attribute

24: Traffic Engineering

25: IPv6 Address Specific Extended Community

26: AIGP

27: PE Distinguisher Labels

28: ELC

29: LS_TYPE

30: REMOTE_NEXTHOP

32: LARGE_COMMUNITY

40: PREFIX_SID

128: ATTR_SET

129: WIDE_COMMUNITY

255: Reserved for development

31, 33-39, 41-127, 130-254: Unassigned

discard

Discards messages carrying specified attributes.

-

withdraw

Withdraws the routes with the specified attribute.

-

treat-as-unknown

Processes the specified attributes as unknown attributes. If a specified attribute is optional transitive, the BGP device accepts this attribute and advertises it to other peers; if the specified attribute is of any other type, the BGP device discards this attribute.

-

treat-with-error

Processes packets with incorrect path attributes.

-

accept-zero-value

Indicates to accept the path attributes with a value of 0.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP Update messages contain various path attributes. If the local device receives any Update message with an incorrect format, BGP session flapping may occur. To enhance reliability, you can run this command to configure a processing mode for specified BGP path attributes.

The path-attribute-treat command is used to specify a processing mode for path attributes. The processing modes are as follows:

  • discard: discarding messages carrying specified attributes.
  • withdraw: withdrawing routes with specified attributes.
  • treat-as-unknown: Processing specified attributes as unknown attributes

treat-with-error is used to specify the processing mode of incorrect path attributes. The processing modes are as follows:

  • accept-zero-value: accepting the path attribute with the value of 0.

Precautions

This command may cause the specified path attributes to be discarded or routes carrying the path attributes to be withdrawn. Therefore, exercise caution when you run this command.

The command configuration takes effect immediately for the routes received after the command is run. However, for the routes received before the command is run, the configuration can take effect only after the refresh bgp command is run.

Example

# Configure a mode in which a device processes specified path attributes in received BGP Update messages.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance a
[HUAWEI-vpn-instance-a] ipv6-family
[HUAWEI-vpn-instance-a-af-ipv4] quit
[HUAWEI-vpn-instance-a] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance a
[HUAWEI-bgp-6-a] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-a] peer 2001:DB8:1::1 path-attribute-treat attribute-id 19 to 21 discard

peer bfd (BGP multi-instance view)

Function

The peer bfd command sets BFD detection parameters for a peer.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval at which BFD packets are sent is 1000 milliseconds, the interval at which BFD packets are received is 1000 milliseconds, the local detection time multiplier is 3.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

undo peer ipv4-address bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

min-tx-interval min-tx-interval

Specifies the interval at which BFD packets are sent.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

min-rx-interval min-rx-interval

Specifies an interval at which BFD packets are received.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

detect-multiplier multiplier

Specifies the local detection time multiplier.

The value is an integer ranging from 3 to 50. The default value is 3.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP session is in the Established state.

Configuration Impact

If the peer bfd command is run multiple times, the latest configuration overwrites the previous one. The BFD session uses the latest parameters as the detection parameters.

Assume that BFD is configured on a peer. If the peer bfd block command is not run on members of the peer group, the members will establish BFD sessions.

Precautions

If BFD parameters are set on a peer, a BFD session will be established by using the BFD parameters on the peer.

Example

# Configure BFD and set detection parameters on the peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 192.168.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 192.168.1.1 bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer bfd (BGP multi-instance view) (group)

Function

The peer bfd command sets BFD detection parameters for a peer group.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval for sending BFD packets is 1000 ms, the interval for receiving BFD packets is 1000 ms, and the local detection multiplier is 3.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

undo peer group-name bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

min-tx-interval min-tx-interval

Specifies the interval at which BFD packets are sent.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

min-rx-interval min-rx-interval

Specifies the interval at which BFD packets are received.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

detect-multiplier multiplier

Specifies the local detection multiplier.

The value is an integer in the range 3 to 50. The default value is 3.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP session is in the Established state.

Configuration Impact

If the peer bfd command is run multiple times, the latest configuration overwrites the previous one. The BFD session uses the latest parameters as the detection parameters.

Assume that BFD is configured on a peer group. If the peer bfd block command is not run on members of the peer group, the members will establish BFD sessions.

Precautions

If BFD parameters are set on a peer, a BFD session will be established by using the BFD parameters on the peer.

Example

# Configure BFD and set detection parameters on peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] group test
[HUAWEI-bgp-instance-a] peer test bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer bfd (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer bfd command sets BFD detection parameters for a peer.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval at which BFD packets are sent is 1000 milliseconds, the interval at which BFD packets are received is 1000 milliseconds, the local detection time multiplier is 3.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

undo peer ipv4-address bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

min-tx-interval min-tx-interval

Specifies the interval at which BFD packets are sent.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

min-rx-interval min-rx-interval

Specifies an interval at which BFD packets are received.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

detect-multiplier multiplier

Specifies the local detection time multiplier.

The value is an integer ranging from 3 to 50. The default value is 3.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP session is in the Established state.

Configuration Impact

If the peer bfd command is run multiple times, the latest configuration overwrites the previous one. The BFD session uses the latest parameters as the detection parameters.

Assume that BFD is configured on a peer. If the peer bfd block command is not run on members of the peer group, the members will establish BFD sessions.

Precautions

If BFD parameters are set on a peer, a BFD session will be established by using the BFD parameters on the peer.

Example

# Configure BFD and set detection parameters on peer 192.168.1.1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 192.168.1.1 as-number 200
[HUAWEI-bgp-instance-a-vpna] peer 192.168.1.1 bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer bfd (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer bfd command sets BFD detection parameters for a peer group.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval at which BFD packets are sent is 1000 milliseconds, the interval at which BFD packets are received is 1000 milliseconds, the local detection time multiplier is 3.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

undo peer group-name bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

min-tx-interval min-tx-interval

Specifies the interval at which BFD packets are sent.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

min-rx-interval min-rx-interval

Specifies an interval at which BFD packets are received.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

detect-multiplier multiplier

Specifies the local detection time multiplier.

The value is an integer ranging from 3 to 50. The default value is 3.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP session is in the Established state.

Configuration Impact

If the peer bfd command is run multiple times, the latest configuration overwrites the previous one. The BFD session uses the latest parameters as the detection parameters.

Assume that BFD is configured on a peer. If the peer bfd block command is not run on members of the peer group, the members will establish BFD sessions.

Precautions

If BFD parameters are set on a peer, a BFD session will be established by using the BFD parameters on the peer.

Example

# Configure BFD and set detection parameters on its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test external
[HUAWEI-bgp-instance-a-vpna] peer test bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer bfd (BGP view)

Function

The peer bfd command sets BFD detection parameters for a peer.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval for sending BFD packets is 1000 ms, the interval for receiving BFD packets is 1000 ms, and the local detection multiplier is 3.

Format

peer ipv4-address bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

undo peer ipv4-address bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

min-tx-interval min-tx-interval

Specifies the interval at which BFD packets are sent.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

min-rx-interval min-rx-interval

Specifies the interval at which BFD packets are received.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

detect-multiplier multiplier

Specifies the local detection time multiplier.

The value is an integer ranging from 3 to 50. The default value is 3.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP session is in the Established state.

Configuration Impact

If the peer bfd command is run multiple times, the latest configuration overwrites the previous one. The BFD session uses the latest parameters as the detection parameters.

Assume that BFD is configured on a peer. If the peer bfd block command is not run on members of the peer group, the members will establish BFD sessions.

Precautions

If BFD parameters are set on a peer, a BFD session will be established by using the BFD parameters on the peer.

Example

# Configure BFD and set detection parameters on peer 192.168.1.1.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 192.168.1.1 as-number 200
[HUAWEI-bgp] peer 192.168.1.1 bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer bfd (BGP view) (group)

Function

The peer bfd command sets BFD detection parameters for a peer group.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval for sending BFD packets is 1000 ms, the interval for receiving BFD packets is 1000 ms, and the local detection multiplier is 3.

Format

peer group-name bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

undo peer group-name bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

min-tx-interval min-tx-interval

Specifies the interval at which BFD packets are sent.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

min-rx-interval min-rx-interval

Specifies the interval at which BFD packets are received.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

detect-multiplier multiplier

Specifies the local detection multiplier.

The value is an integer in the range 3 to 50. The default value is 3.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP session is in the Established state.

Configuration Impact

If the peer bfd command is run multiple times, the latest configuration overwrites the previous one. The BFD session uses the latest parameters as the detection parameters.

Assume that BFD is configured on a peer. If the peer bfd block command is not run on members of the peer group, the members will establish BFD sessions.

Precautions

If BFD parameters are set on a peer, a BFD session will be established by using the BFD parameters on the peer.

Example

# Configure BFD and set detection parameters on peer 192.168.1.1.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer bfd (BGP view) (IPv6)

Function

The peer bfd command sets BFD detection parameters for a peer.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval at which BFD packets are sent is 1000 milliseconds, the interval at which BFD packets are received is 1000 milliseconds, the local detection time multiplier is 3.

Format

peer ipv6-address bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

undo peer ipv6-address bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is in the format of X:X:X:X:X:X:X:X.

min-tx-interval min-tx-interval

Specifies the interval at which BFD packets are sent.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

min-rx-interval min-rx-interval

Specifies an interval at which BFD packets are received.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

detect-multiplier multiplier

Specifies the local detection time multiplier.

The value is an integer ranging from 3 to 50. The default value is 3.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP session is in the Established state.

Configuration Impact

If the peer bfd command is run multiple times, the latest configuration overwrites the previous one. The BFD session uses the latest parameters as the detection parameters.

Assume that BFD is configured on a peer. If the peer bfd block command is not run on members of the peer group, the members will establish BFD sessions.

Precautions

If BFD parameters are set on a peer, a BFD session will be established by using the BFD parameters on the peer.

Example

# Configure BFD and set detection parameters on the peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp] peer 2001:DB8:1::1 bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer bfd (BGP-VPN instance IPv4 address family view)

Function

The peer bfd command sets BFD detection parameters for a peer.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval at which BFD packets are sent is 1000 milliseconds, the interval at which BFD packets are received is 1000 milliseconds, the local detection time multiplier is 3.

Format

peer ipv4-address bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

undo peer ipv4-address bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

min-tx-interval min-tx-interval

Specifies the interval at which BFD packets are sent.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

min-rx-interval min-rx-interval

Specifies an interval at which BFD packets are received.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

detect-multiplier multiplier

Specifies the local detection time multiplier.

The value is an integer ranging from 3 to 50. The default value is 3.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP session is in the Established state.

Configuration Impact

If the peer bfd command is run multiple times, the latest configuration overwrites the previous one. The BFD session uses the latest parameters as the detection parameters.

Assume that BFD is configured on a peer. If the peer bfd block command is not run on members of the peer group, the members will establish BFD sessions.

Precautions

If BFD parameters are set on a peer, a BFD session will be established by using the BFD parameters on the peer.

Example

# Configure BFD and set detection parameters on the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer bfd (BGP-VPN instance IPv4 address family view) (group)

Function

The peer bfd command sets BFD detection parameters for a peer group.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval at which BFD packets are sent is 1000 milliseconds, the interval at which BFD packets are received is 1000 milliseconds, the local detection time multiplier is 3.

Format

peer group-name bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

undo peer group-name bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

min-tx-interval min-tx-interval

Specifies the interval at which BFD packets are sent.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

min-rx-interval min-rx-interval

Specifies an interval at which BFD packets are received.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

detect-multiplier multiplier

Specifies the local detection time multiplier.

The value is an integer ranging from 3 to 50. The default value is 3.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP session is in the Established state.

Configuration Impact

If the peer bfd command is run multiple times, the latest configuration overwrites the previous one. The BFD session uses the latest parameters as the detection parameters.

Assume that BFD is configured on a peer. If the peer bfd block command is not run on members of the peer group, the members will establish BFD sessions.

Precautions

If BFD parameters are set on a peer, a BFD session will be established by using the BFD parameters on the peer.

Example

# Configure BFD and set detection parameters on its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test external
[HUAWEI-bgp-vpn1] peer test as-number 200
[HUAWEI-bgp-vpn1] peer test bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer bfd (BGP-VPN instance IPv6 address family view) (group)

Function

The peer bfd command sets BFD detection parameters for a peer group.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval for sending BFD packets is 1000 ms, the interval for receiving BFD packets is 1000 ms, and the local detection multiplier is 3.

Format

peer group-name bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

undo peer group-name bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

min-tx-interval min-tx-interval

Specifies the interval at which BFD packets are sent.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

min-rx-interval min-rx-interval

Specifies the interval at which BFD packets are received.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

detect-multiplier multiplier

Specifies the local detection multiplier.

The value is an integer ranging from 3 to 50. The default value is 3.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP session is in the Established state.

Configuration Impact

If the peer bfd command is run multiple times, the latest configuration overwrites the previous one. The BFD session uses the latest parameters as the detection parameters.

Assume that BFD is configured on a peer group. If the peer bfd block command is not run on members of the peer group, the members will establish BFD sessions.

Precautions

If BFD parameters are set on a peer, a BFD session will be established by using the BFD parameters on the peer.

Example

# Configure BFD and set detection parameters on the peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer bfd (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer bfd command sets BFD detection parameters for a peer.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval for sending BFD packets is 1000 ms, the interval for receiving BFD packets is 1000 ms, and the local detection multiplier is 3.

Format

peer ipv6-address bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

undo peer ipv6-address bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is in the format of X:X:X:X:X:X:X:X.

min-tx-interval min-tx-interval

Specifies the interval at which BFD packets are sent.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

min-rx-interval min-rx-interval

Specifies the interval at which BFD packets are received.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

detect-multiplier multiplier

Specifies the local detection time multiplier.

The value is an integer ranging from 3 to 50. The default value is 3.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP session is in the Established state.

Configuration Impact

If the peer bfd command is run multiple times, the latest configuration overwrites the previous one. The BFD session uses the latest parameters as the detection parameters.

Assume that BFD is configured on a peer. If the peer bfd block command is not run on members of the peer group, the members will establish BFD sessions.

Precautions

If BFD parameters are set on a peer, a BFD session will be established by using the BFD parameters on the peer.

Example

# Configure BFD and set detection parameters on the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer bfd (BGP-VPN instance view)

Function

The peer bfd command sets BFD detection parameters for a peer.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval at which BFD packets are sent is 1000 milliseconds, the interval at which BFD packets are received is 1000 milliseconds, the local detection time multiplier is 3.

Format

peer ipv4-address bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

peer ipv6-address bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

undo peer ipv4-address bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

undo peer ipv6-address bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

min-tx-interval min-tx-interval

Specifies the interval at which BFD packets are sent.

The value is an integer ranging from 3 to 1000, in milliseconds. The default value is 1000.

min-rx-interval min-rx-interval

Specifies an interval at which BFD packets are received.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

detect-multiplier multiplier

Specifies the local detection time multiplier.

The value is an integer ranging from 3 to 50. The default value is 3.

ipv6-address

Specifies an IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Example

# Configure BFD and set detection parameters on peer 192.168.1.1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 192.168.1.1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 192.168.1.1 bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer bfd (BGP-VPN instance view) (group)

Function

The peer bfd command sets BFD detection parameters for a peer group.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval at which BFD packets are sent is 1000 milliseconds, the interval at which BFD packets are received is 1000 milliseconds, the local detection time multiplier is 3.

Format

peer group-name bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

undo peer group-name bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

undo peer group-name bfd { min-tx-interval min-tx-interval | min-rx-interval min-rx-interval | detect-multiplier multiplier } *

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

min-tx-interval min-tx-interval

Specifies the interval at which BFD packets are sent.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

min-rx-interval min-rx-interval

Specifies an interval at which BFD packets are received.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

detect-multiplier multiplier

Specifies the local detection time multiplier.

The value is an integer ranging from 3 to 50. The default value is 3.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Example

# Configure BFD and set detection parameters on its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test external
[HUAWEI-bgp-instance-vpn1] peer test bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer bfd block (BGP multi-instance view)

Function

The peer bfd block command prevents a peer from inheriting the BFD function of its peer group.

The undo peer bfd block command restores the default configuration.

By default, a peer inherits the BFD function from its peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address bfd block

undo peer ipv4-address bfd block

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. If a peer group is configured with BFD, all members of the peer group will establish BFD sessions. The peer bfd block command can be used to prevent a peer from inheriting the BFD function from its peer group.

Prerequisites

A BFD session has been established.

Configuration Impact

After the peer bfd block command is run on a peer, the corresponding BFD session on the peer is deleted. As a result, fast link fault detection cannot be implemented.

Precautions

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, related BFD sessions are automatically deleted.

Example

# Disable BFD function.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 192.168.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 192.168.1.1 bfd block

peer bfd block (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer bfd block command prevents a peer from inheriting the BFD function of its peer group.

The undo peer bfd block command restores the default configuration.

By default, a peer inherits the BFD function from its peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address bfd block

undo peer ipv4-address bfd block

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. If a peer group is configured with BFD, all members of the peer group will establish BFD sessions. The peer bfd block command can be used to prevent a peer from inheriting the BFD function from its peer group.

Prerequisites

A BFD session has been established.

Configuration Impact

After the peer bfd block command is run on a peer, the corresponding BFD session on the peer is deleted. As a result, fast link fault detection cannot be implemented.

Precautions

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, related BFD sessions are automatically deleted.

Example

# Prevent the peer from inheriting the BFD function of its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 bfd block

peer bfd block (BGP view)

Function

The peer bfd block command prevents a peer from inheriting the BFD function of its peer group.

The undo peer bfd block command restores the default configuration.

By default, a peer inherits the BFD function from its peer group.

Format

peer ipv4-address bfd block

undo peer ipv4-address bfd block

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. If a peer group is configured with BFD, all members of the peer group will establish BFD sessions. The peer bfd block command can be used to prevent a peer from inheriting the BFD function from its peer group.

Configuration Impact

After the peer bfd block command is run on a peer, the corresponding BFD session on the peer is deleted. As a result, fast link fault detection cannot be implemented.

Precautions

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, related BFD sessions are automatically deleted.

Example

# Prevent the peer from inheriting the BFD function of its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 192.168.1.1 as-number 100
[HUAWEI-bgp] peer 192.168.1.1 bfd block

peer bfd block (BGP view) (IPv6)

Function

The peer bfd block command prevents a peer from inheriting the BFD function of its peer group.

The undo peer bfd block command restores the default configuration.

By default, a peer inherits the BFD function from its peer group.

Format

peer ipv6-address bfd block

undo peer ipv6-address bfd block

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. If a peer group is configured with BFD, all members of the peer group will establish BFD sessions. The peer bfd block command can be used to prevent a peer from inheriting the BFD function from its peer group.

Prerequisites

A BFD session has been established.

Configuration Impact

After the peer bfd block command is run on a peer, the corresponding BFD session on the peer is deleted. As a result, fast link fault detection cannot be implemented.

Precautions

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, related BFD sessions are automatically deleted.

Example

# Prevent the peer from inheriting the BFD function of its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] peer 2001:DB8:1::1 bfd block

peer bfd block (BGP-VPN instance IPv4 address family view)

Function

The peer bfd block command prevents a peer from inheriting the BFD function of its peer group.

The undo peer bfd block command restores the default configuration.

By default, a peer inherits the BFD function from its peer group.

Format

peer ipv4-address bfd block

undo peer ipv4-address bfd block

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. If a peer group is configured with BFD, all members of the peer group will establish BFD sessions. The peer bfd block command can be used to prevent a peer from inheriting the BFD function from its peer group.

Prerequisites

A BFD session has been established.

Configuration Impact

After the peer bfd block command is run on a peer, the corresponding BFD session on the peer is deleted. As a result, fast link fault detection cannot be implemented.

Precautions

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, related BFD sessions are automatically deleted.

Example

# Prevent the peer from inheriting the BFD function of its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 192.168.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 192.168.1.1 bfd block

peer bfd block (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer bfd block command prevents a peer from inheriting the BFD function of its peer group.

The undo peer bfd block command restores the default configuration.

By default, a peer inherits the BFD function from its peer group.

Format

peer ipv6-address bfd block

undo peer ipv6-address bfd block

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. If a peer group is configured with BFD, all members of the peer group will establish BFD sessions. The peer bfd block command can be used to prevent a peer from inheriting the BFD function from its peer group.

Prerequisites

A BFD session has been established.

Configuration Impact

After the peer bfd block command is run on a peer, the corresponding BFD session on the peer is deleted. As a result, fast link fault detection cannot be implemented.

Precautions

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, related BFD sessions are automatically deleted.

Example

# Prevent peer from inheriting the BFD function of its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 bfd block

peer bfd block (BGP-VPN instance view)

Function

The peer bfd block command prevents a peer from inheriting the BFD function of its peer group.

The undo peer bfd block command restores the default configuration.

By default, a peer inherits the BFD function from its peer group.

Format

peer ipv4-address bfd block

peer ipv6-address bfd block

undo peer ipv4-address bfd block

undo peer ipv6-address bfd block

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

ipv6-address

Specifies an IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. If a peer group is configured with BFD, all members of the peer group will establish BFD sessions. The peer bfd block command can be used to prevent a peer from inheriting the BFD function from its peer group.

Example

# Prevent peer 192.168.1.1 from inheriting the BFD function of its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 192.168.1.1 as-number 100
[HUAWEI-bgp-instance-vpn1] peer 192.168.1.1 bfd block

peer bfd block(BGP multi-instance VPN instance view)

Function

The peer bfd block command prevents a peer from inheriting the BFD function of its peer group.

The undo peer bfd block command restores the function that enables a peer to inherit the BFD function of its peer group.

By default, a peer inherits the BFD function from its peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr bfd block

peer peerIpv6Addr bfd block

undo peer peerIpv4Addr bfd block

undo peer peerIpv6Addr bfd block

Parameters

Parameter Description Value
peerIpv4Addr

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. If a peer group is configured with BFD, all members of the peer group will establish BFD sessions. The peer bfd block command can be used to prevent a peer from inheriting the BFD function from its peer group.

Example

# Prevent the peer from inheriting the BFD function of its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] vpn-instance vpna
[HUAWEI-bgp-instance-a-instance-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-instance-vpna] peer 10.1.1.1 bfd block

peer bfd enable (BGP multi-instance view)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address bfd enable [ single-hop-prefer ] [ compatible ]

undo peer ipv4-address bfd enable

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

single-hop-prefer

Preferentially creates a single-hop BFD session for BGP peers.

-

compatible

Indicates the compatibility mode. If this keyword is specified, the TTL in packets sent by BFD is set to 255.

-

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP4 peers. This accelerates network convergence. The peer bfd enable command is used to configure a BFD session with default detection parameters for a peer or peer group.

If single-hop-prefer is specified in the command, single-hop BFD is preferentially used to monitor IP connectivity between BGP peers. That is, only one BFD session is created on a specified BGP interface. The single-hop-prefer parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. If a peer does not need to inherit the configuration of its peer group, run the peer bfd block command on the peer to prevent the peer from inheriting the BFD configuration of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP peer relationship is in the Established state.

Configuration Impact

After the peer bfd enable command is enabled, peers or peer groups can establish IPv6 BFD sessions using default parameter values. This allows fast link fault detection.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer inherits the BFD configurations from the peer group.

Precautions

Before enabling BFD on a BGP peer, enable BFD in the system view. If no BFD detection parameter is specified, the BFD session uses the default values.

If the command is run more than once, the latest configuration overrides the previous one.

Note:

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, the BFD session is automatically deleted.

Example

# Configure BFD for a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 192.168.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 192.168.1.1 bfd enable

peer bfd enable (BGP multi-instance view) (group)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer group using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name bfd enable [ single-hop-prefer ] [ compatible ]

undo peer group-name bfd enable

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

single-hop-prefer

Preferentially creates a single-hop BFD session for BGP peers.

-

compatible

Indicates the compatibility mode and sets the TTL value in sent BFD packets to 255.

-

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP peers. This accelerates network convergence. You can run this command to create a BFD session with default detection parameters for a peer or peer group.

If single-hop-prefer is specified, single-hop detection is preferentially used to monitor IP connectivity between BGP peers when a BFD session is established between BGP peers. That is, only one BFD session exists on a specified BGP interface. This parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. If the peer does not need to inherit the configuration of the peer group, run the peer bfd block command on the peer to prevent the peer from inheriting the BFD configuration of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP peer relationship is in the Established state.

Configuration Impact

After the peer bfd enable command is enabled, peers or peer groups can establish IPv6 BFD sessions using default parameter values. This allows fast link fault detection.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer inherits the BFD configurations from the peer group.

Precautions

Before enabling BFD on a BGP peer, enable BFD in the system view. If no BFD detection parameter is specified, a BFD session is established using default parameter values.

If the command is run more than once, the latest configuration overrides the previous one.

NOTE:

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, the BFD session is deleted automatically.

Example

# Configure BFD for peer group.
<HUAWEI> system-view
[HUAWEI] bfd
[HUAWEI-bfd] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] group test
[HUAWEI-bgp-instance-a] peer test bfd enable

peer bfd enable (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address bfd enable [ single-hop-prefer ] [ compatible ]

undo peer ipv4-address bfd enable

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

single-hop-prefer

Preferentially creates a single-hop BFD session for BGP peers.

-

compatible

Indicates the compatibility mode. If this keyword is specified, the TTL in packets sent by BFD is set to 255.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP4 peers. This accelerates network convergence. The peer bfd enable command is used to configure a BFD session with default detection parameters for a peer or peer group.

If single-hop-prefer is specified in the command, single-hop BFD is preferentially used to monitor IP connectivity between BGP peers. That is, only one BFD session is created on a specified BGP interface. The single-hop-prefer parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. If a peer does not need to inherit the configuration of its peer group, run the peer bfd block command on the peer to prevent the peer from inheriting the BFD configuration of the peer group.

Example

# Configure BFD for peer 192.168.1.1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 192.168.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 192.168.1.1 bfd enable

peer bfd enable (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer group using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name bfd enable [ single-hop-prefer ] [ compatible ]

undo peer group-name bfd enable

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

single-hop-prefer

Preferentially creates a single-hop BFD session for BGP peers.

-

compatible

Indicates the compatibility mode. If this keyword is specified, the TTL in packets sent by BFD is set to 255.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP4 peers. This accelerates network convergence. The peer bfd enable command is used to configure a BFD session with default detection parameters for a peer or peer group.

If single-hop-prefer is specified in the command, single-hop BFD is preferentially used to monitor IP connectivity between BGP peers. That is, only one BFD session is created on a specified BGP interface. The single-hop-prefer parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. If a peer does not need to inherit the configuration of its peer group, run the peer bfd block command on the peer to prevent the peer from inheriting the BFD configuration of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP peer relationship is in the Established state.

Configuration Impact

After the peer bfd enable command is enabled, peers or peer groups can establish IPv6 BFD sessions using default parameter values. This allows fast link fault detection.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer inherits the BFD configurations from the peer group.

Example

# Configure BFD for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test external
[HUAWEI-bgp-instance-a-vpna] peer test as-number 200
[HUAWEI-bgp-instance-a-vpna] peer test bfd enable

peer bfd enable (BGP multi-instance VPN instance view)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr bfd enable [ single-hop-prefer ] [ compatible ]

peer peerIpv4Addr bfd enable per-link one-arm-echo

peer peerIpv6Addr bfd enable [ [ single-hop-prefer ] [ compatible ] ]

undo peer peerIpv4Addr bfd enable

undo peer peerIpv6Addr bfd enable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

single-hop-prefer

Preferentially creates a single-hop BFD session for BGP peers.

-

compatible

Indicates the compatibility mode. If this keyword is specified, the TTL in packets sent by BFD is set to 255.

-

per-link

Preferentially creates a single-hop BFD session for BGP peers.

-

one-arm-echo

Indicates a one-arm BFD echo session.

-

peerIpv6Addr

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP peers. This accelerates network convergence. The peer bfd enable command is used to configure a device to establish a BFD session with its peer group using default detection parameter values.

If single-hop-prefer is specified in the command, BGP peers preferentially use the single-hop detection mode when establishing BFD sessions with each other to implement link connectivity detection. Specifically, only one BFD session is created on a specified BGP interface. The single-hop-prefer parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

The per-link one-arm-echo parameter configures a one-arm BFD echo session for one link and ensures that the local and peer devices use the same detection mode when a Huawei device is connected to a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. To prevent this peer from inheriting the BFD configuration of the group, run the peer bfd block command for the peer.

Example

# Configure BFD for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] vpn-instance vpna
[HUAWEI-bgp-instance-a-instance-vpna] peer 192.168.1.1 as-number 100
[HUAWEI-bgp-instance-a-instance-vpna] peer 192.168.1.1 bfd enable

peer bfd enable (BGP multi-instance VPN instance view)(group)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer group using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerGroupName bfd enable [ single-hop-prefer ] [ compatible ]

peer peerGroupName bfd enable per-link one-arm-echo

undo peer peerGroupName bfd enable [ single-hop-prefer ]

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

single-hop-prefer

Preferentially creates a single-hop BFD session for BGP peers.

-

compatible

Indicates the compatibility mode. If this keyword is specified, the TTL in packets sent by BFD is set to 255.

-

per-link

Preferentially creates a single-hop BFD session for BGP peers.

-

one-arm-echo

Indicates a one-arm BFD echo session.

-

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP4 peers. This accelerates network convergence. The peer bfd enable command is used to configure a BFD session with default detection parameters for a peer or peer group.

If single-hop-prefer is specified in the command, single-hop BFD is preferentially used to monitor IP connectivity between BGP peers. That is, only one BFD session is created on a specified BGP interface. The single-hop-prefer parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. If a peer does not need to inherit the configuration of its peer group, run the peer bfd block command on the peer to prevent the peer from inheriting the BFD configuration of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP peer relationship is in the Established state.

Configuration Impact

After the peer bfd enable command is enabled, peers or peer groups can establish IPv6 BFD sessions using default parameter values. This allows fast link fault detection.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer inherits the BFD configurations from the peer group.

Precautions

Before enabling BFD on a BGP peer, enable BFD in the system view. If no BFD detection parameter is specified, a BFD session is established using default parameter values.

If the command is run more than once, the latest configuration overrides the previous one.

NOTE:

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, the BFD session is deleted automatically.

Example

# Configure BFD for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] vpn-instance vpna
[HUAWEI-bgp-instance-a-instance-vpna] group test external
[HUAWEI-bgp-instance-a-instance-vpna] peer test as-number 200
[HUAWEI-bgp-instance-a-instance-vpna] peer test bfd enable

peer bfd enable (BGP view)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer.

Format

peer ipv4-address bfd enable [ single-hop-prefer ] [ compatible ]

undo peer ipv4-address bfd enable

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

single-hop-prefer

Configures the BGP peer to preferentially use the single-hop mode when establishing BFD sessions.

-

compatible

Indicates the compatibility mode and sets the TTL value in sent BFD packets to 255.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP peers. This accelerates network convergence. You can run this command to create a BFD session with default detection parameters for a peer or peer group.

If single-hop-prefer is specified, single-hop detection is preferentially used to monitor IP connectivity between BGP peers when a BFD session is established between BGP peers. That is, only one BFD session exists on a specified BGP interface. This parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. If the peer does not need to inherit the configuration of the peer group, run the peer bfd block command on the peer to prevent the peer from inheriting the BFD configuration of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP peer relationship is in the Established state.

Configuration Impact

After the peer bfd enable command is enabled, peers or peer groups can establish IPv6 BFD sessions using default parameter values. This allows fast link fault detection.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer inherits the BFD configurations from the peer group.

Precautions

Before enabling BFD on a BGP peer, enable BFD in the system view. If no BFD detection parameter is specified, a BFD session is established using default parameter values.

If the command is run more than once, the latest configuration overrides the previous one.

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, the BFD session is deleted automatically.

Example

# Configure BFD for peer 192.168.1.1.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 192.168.1.1 as-number 100
[HUAWEI-bgp] peer 192.168.1.1 bfd enable

peer bfd enable (BGP view) (group)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer group using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer group.

Format

peer group-name bfd enable [ single-hop-prefer ] [ compatible ]

undo peer group-name bfd enable

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

single-hop-prefer

Configures the BGP peer to preferentially use the single-hop mode when establishing BFD sessions.

-

compatible

Indicates the compatibility mode and sets the TTL value in sent BFD packets to 255.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP peers. This accelerates network convergence. You can run this command to create a BFD session with default detection parameters for a peer or peer group.

If single-hop-prefer is specified, single-hop detection is preferentially used to monitor IP connectivity between BGP peers when a BFD session is established between BGP peers. That is, only one BFD session exists on a specified BGP interface. This parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. If the peer does not need to inherit the configuration of the peer group, run the peer bfd block command on the peer to prevent the peer from inheriting the BFD configuration of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP peer relationship is in the Established state.

Configuration Impact

After the peer bfd enable command is enabled, peers or peer groups can establish IPv6 BFD sessions using default parameter values. This allows fast link fault detection.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer inherits the BFD configurations from the peer group.

Precautions

Before enabling BFD on a BGP peer, enable BFD in the system view. If no BFD detection parameter is specified, a BFD session is established using default parameter values.

If the command is run more than once, the latest configuration overrides the previous one.

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, the BFD session is deleted automatically.

Example

# Configure BFD for a peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer test bfd enable

peer bfd enable (BGP view) (IPv6)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer.

Format

peer ipv6-address bfd enable [ single-hop-prefer ] [ compatible ]

undo peer ipv6-address bfd enable

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

single-hop-prefer

Preferentially creates a single-hop BFD session for BGP peers.

-

compatible

Indicates the compatibility mode. If this keyword is specified, the TTL in packets sent by BFD is set to 255.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP peers. This accelerates network convergence. The peer bfd enable command is used to configure a device to establish a BFD session with its peer group using default detection parameter values.

If single-hop-prefer is specified in the command, BGP peers preferentially use the single-hop detection mode when establishing BFD sessions with each other to implement link connectivity detection. Specifically, only one BFD session is created on a specified BGP interface. The single-hop-prefer parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

The per-link one-arm-echo parameter configures a one-arm BFD echo session for one link and ensures that the local and peer devices use the same detection mode when a Huawei device is connected to a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. To prevent this peer from inheriting the BFD configuration of the group, run the peer bfd block command for the peer.

Prerequisites

A BFD session can be established only when the corresponding BGP peer relationship is in the Established state.

Configuration Impact

After the peer bfd enable command is enabled, peers or peer groups can establish IPv6 BFD sessions using default parameter values. This allows fast link fault detection.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer inherits the BFD configurations from the peer group.

Precautions

Before enabling BFD on a BGP peer, enable BFD in the system view. If no BFD detection parameter is specified, the BFD session uses the default values.

If the command is run more than once, the latest configuration overrides the previous one.

Note:

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, the BFD session is automatically deleted.

Example

# Configure BFD for peer 2001:db8:2::9.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:db8:2::9 as-number 100
[HUAWEI-bgp] peer 2001:db8:2::9 bfd enable

peer bfd enable (BGP-VPN instance IPv4 address family view)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer.

Format

peer ipv4-address bfd enable [ single-hop-prefer ] [ compatible ]

undo peer ipv4-address bfd enable

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

single-hop-prefer

Preferentially creates a single-hop BFD session for BGP peers.

-

compatible

Indicates the compatibility mode. If this keyword is specified, the TTL in packets sent by BFD is set to 255.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP4 peers. This accelerates network convergence. The peer bfd enable command is used to configure a BFD session with default detection parameters for a peer or peer group.

If single-hop-prefer is specified in the command, single-hop BFD is preferentially used to monitor IP connectivity between BGP peers. That is, only one BFD session is created on a specified BGP interface. The single-hop-prefer parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. If a peer does not need to inherit the configuration of its peer group, run the peer bfd block command on the peer to prevent the peer from inheriting the BFD configuration of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP peer relationship is in the Established state.

Configuration Impact

After the peer bfd enable command is enabled, peers or peer groups can establish IPv6 BFD sessions using default parameter values. This allows fast link fault detection.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer inherits the BFD configurations from the peer group.

Example

# Configure BFD for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 192.168.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 192.168.1.1 bfd enable

peer bfd enable (BGP-VPN instance IPv4 address family view) (group)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer group using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer group.

Format

peer group-name bfd enable [ single-hop-prefer ] [ compatible ]

undo peer group-name bfd enable

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

single-hop-prefer

Preferentially creates a single-hop BFD session for BGP peers.

-

compatible

Indicates the compatibility mode. If this keyword is specified, the TTL in packets sent by BFD is set to 255.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP peers. This accelerates network convergence. The peer bfd enable command is used to configure a device to establish a BFD session with its peer group using default detection parameter values.

If single-hop-prefer is specified in the command, BGP peers preferentially use the single-hop detection mode when establishing BFD sessions with each other to implement link connectivity detection. Specifically, only one BFD session is created on a specified BGP interface. The single-hop-prefer parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

The per-link one-arm-echo parameter configures a one-arm BFD echo session for one link and ensures that the local and peer devices use the same detection mode when a Huawei device is connected to a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. To prevent this peer from inheriting the BFD configuration of the group, run the peer bfd block command for the peer.

Prerequisites

A BFD session can be established only when the corresponding BGP peer relationship is in the Established state.

Configuration Impact

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer inherits the BFD configurations from the peer group.

Precautions

Before enabling BFD on a BGP peer, enable BFD in the system view. If no BFD detection parameter is specified, a BFD session is established using default parameter values.

If the command is run more than once, the latest configuration overrides the previous one.

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, the BFD session is deleted automatically.

Example

# Configure BFD for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test external
[HUAWEI-bgp-vpn1] peer test as-number 200
[HUAWEI-bgp-vpn1] peer test bfd enable

peer bfd enable (BGP-VPN instance IPv6 address family view) (group)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer group using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer group.

Format

peer group-name bfd enable [ single-hop-prefer ] [ compatible ]

undo peer group-name bfd enable

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

single-hop-prefer

Configures the BGP peer to preferentially use the single-hop mode when establishing BFD sessions.

-

compatible

Indicates the compatibility mode and sets the TTL value in sent BFD packets to 255.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP peers. This accelerates network convergence. You can run this command to create a BFD session with default detection parameters for a peer or peer group.

If single-hop-prefer is specified, single-hop detection is preferentially used to monitor IP connectivity between BGP peers when a BFD session is established between BGP peers. That is, only one BFD session exists on a specified BGP interface. This parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. If the peer does not need to inherit the configuration of the peer group, run the peer bfd block command on the peer to prevent the peer from inheriting the BFD configuration of the peer group.

Prerequisites

A BFD session can be established only when the corresponding BGP peer relationship is in the Established state.

Precautions

Before enabling BFD on a BGP peer, enable BFD in the system view. If no BFD detection parameter is specified, a BFD session is established by using default parameter values.

If the command is run more than once, the latest configuration overrides the previous one.

Note:

The peer bfd block command and the peer bfd enable command are mutually exclusive. After the peer bfd block command is run, related BFD sessions are automatically deleted.

Example

# Configure BFD for the peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test bfd enable

peer bfd enable (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer.

Format

peer ipv6-address bfd enable [ single-hop-prefer ] [ compatible ]

undo peer ipv6-address bfd enable

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is in the X:X:X:X:X:X:X:X format.

single-hop-prefer

Preferentially creates a single-hop BFD session for BGP peers.

-

compatible

Indicates the compatibility mode and sets the TTL value in sent BFD packets to 255.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP peers. This accelerates network convergence. The peer bfd enable command is used to configure a device to establish a BFD session with its peer using default detection parameter values.

If single-hop-prefer is specified in the command, BGP peers preferentially use the single-hop detection mode when establishing BFD sessions with each other to implement link connectivity detection. Specifically, only one BFD session is created on a specified BGP interface. The single-hop-prefer parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. To prevent this peer from inheriting the BFD configuration of the group, run the peer bfd block command for the peer.

Prerequisites

A BFD session can be established only when the corresponding BGP peer relationship is in the Established state.

Configuration Impact

After the peer bfd enable command is enabled, peers or peer groups can establish IPv6 BFD sessions using default parameter values. This allows fast link fault detection.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer inherits the BFD configurations from the peer group.

Example

# Configure BFD for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 bfd enable

peer bfd enable (BGP-VPN instance view)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer.

Format

peer ipv4-address bfd enable [ single-hop-prefer ] [ compatible ]

peer ipv6-address bfd enable [ single-hop-prefer ] [ compatible ]

undo peer ipv4-address bfd enable

undo peer ipv6-address bfd enable

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

single-hop-prefer

Preferentially creates a single-hop BFD session for BGP peers.

-

compatible

Indicates the compatibility mode. If this keyword is specified, the TTL in packets sent by BFD is set to 255.

-

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP peers. This accelerates network convergence. The peer bfd enable command is used to configure a device to establish a BFD session with its peer using default detection parameter values.

If single-hop-prefer is specified in the command, BGP peers preferentially use the single-hop detection mode when establishing BFD sessions with each other to implement link connectivity detection. Specifically, only one BFD session is created on a specified BGP interface. The single-hop-prefer parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. To prevent this peer from inheriting the BFD configuration of the group, run the peer bfd block command for the peer.

Example

# Configure BFD for peer 1.1.1.1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-instance-vpn1] peer 1.1.1.1 bfd enable

peer bfd enable (BGP-VPN instance view) (group)

Function

The peer bfd enable command enables a device to establish a BFD session with its peer group using default detection parameter values.

The undo peer bfd enable command cancels this function.

By default, a BGP device does not establish any BFD session with its peer group.

Format

peer group-name bfd enable [ single-hop-prefer ] [ compatible ]

undo peer group-name bfd enable [ single-hop-prefer ]

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

single-hop-prefer

Preferentially creates a single-hop BFD session for BGP peers.

-

compatible

Indicates the compatibility mode. If this keyword is specified, the TTL in packets sent by BFD is set to 255.

-

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses BFD to quickly detect faults in links between BGP4 peers. This accelerates network convergence. The peer bfd enable command is used to configure a BFD session with default detection parameters for a peer or peer group.

If single-hop-prefer is specified in the command, single-hop BFD is preferentially used to monitor IP connectivity between BGP peers. That is, only one BFD session is created on a specified BGP interface. The single-hop-prefer parameter ensures detection mode consistency between a Huawei device and a non-Huawei device.

If a peer is added to a peer group, the peer inherits the BFD configuration of the group, regardless of whether BFD is enabled for the peer. If a peer does not need to inherit the configuration of its peer group, run the peer bfd block command on the peer to prevent the peer from inheriting the BFD configuration of the peer group.

Example

# Configure BFD for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test external
[HUAWEI-bgp-instance-vpn1] peer test bfd enable

peer bfd(BGP multi-instance VPN instance view)

Function

The peer bfd command sets BFD parameters for a peer.

The undo peer bfd command restores default BFD detection parameter values.

By default, the interval at which BFD packets are sent is 10 milliseconds, the interval at which BFD packets are received is 10 milliseconds, the local detection time multiplier is 3.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr bfd { min-tx-interval min-tx-value | min-rx-interval min-rx-value | detect-multiplier multiplier } *

peer peerIpv6Addr bfd { min-tx-interval min-tx-value | min-rx-interval min-rx-value | detect-multiplier multiplier } *

undo peer peerIpv4Addr bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

undo peer peerIpv6Addr bfd { min-tx-interval | min-rx-interval | detect-multiplier } *

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

min-tx-interval min-tx-value

Specifies the interval at which BFD packets are sent.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

min-rx-interval min-rx-value

Specifies an interval at which BFD packets are received.

The value is an integer that ranges from 3 to 1000, in milliseconds. The default value is 1000 milliseconds.

detect-multiplier multiplier

Specifies the local detection time multiplier.

The value is an integer ranging from 3 to 50. The default value is 3.

peerIpv6Addr

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BFD provides millisecond-level fault detection. It helps BGP to detect faults in neighboring devices or links more quickly, and instructs BGP to recalculate routes for correct packet forwarding. The peer bfd command can be used to set the values of BFD session parameters on a specified interface.

The BFD configuration of a peer takes precedence over that of the peer group to which the peer belongs. If BFD is not configured on a peer and the peer group to which the peer belongs is enabled with BFD, the peer will inherit the BFD configurations of the peer group.

Example

# Configure BFD and set detection parameters on the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] vpn-instance vpna
[HUAWEI-bgp-instance-a-instance-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-instance-vpna] peer 10.1.1.1 bfd min-tx-interval 100 min-rx-interval 100 detect-multiplier 5

peer capability-advertise (BGP multi-instance view)

Function

The peer capability-advertise command enables optional functions for BGP to advertise routes, including the route-refresh function, conventional functions, and 4-byte AS number function.

The undo peer capability-advertise command restores the default setting.

By default, the BGP route-refresh and 4-byte AS number functions are enabled, but conventional functions are disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address capability-advertise { conventional | route-refresh | 4-byte-as }

undo peer ipv4-address capability-advertise { conventional | route-refresh | 4-byte-as }

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

conventional

Indicates conventional functions.

  • This parameter is valid only in the BGP view and BGP-VPN instance IPv4 address family view.
  • After conventional functions are enabled on a device, the device does not have extended functions, such as route-refresh and GR.

-

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP has many optional functions when advertising routes, including the route-refresh function, conventional functions, and 4-byte AS number function. Using the peer capability-advertise command, you can enable or disable these functions as required.

Configuration Impact

Enabling or disabling the route-refresh function, conventional functions, or 4-byte AS number function causes the disconnection and re-establishment of peer sessions. This may lead to a temporary network interruption.. Therefore, exercise caution when perfom such operations.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 10.1.1.1 capability-advertise route-refresh

peer capability-advertise (BGP multi-instance view) (group)

Function

The peer capability-advertise command enables the optional functions for BGP to advertise routes, including the route-refresh function, conventional functions, and 4-byte AS number function.

The undo peer capability-advertise command restores the default setting.

By default, the BGP route-refresh and 4-byte AS number functions are enabled, but conventional functions are disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name capability-advertise { conventional | route-refresh | 4-byte-as }

undo peer group-name capability-advertise { conventional | route-refresh | 4-byte-as }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

conventional

Indicates conventional functions.

  • This parameter is valid only in the BGP view and BGP-VPN instance IPv4 address family view.
  • After conventional functions are enabled on a device, the device does not have extended functions, such as route-refresh and GR.

-

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP has many optional functions when advertising routes, including route-refresh, conventional functions, and 4-byte AS numbers. Using the peer capability-advertise command, you can enable or disable these functions as required.

Configuration Impact

Enabling or disabling the route-refresh function, conventional functions, or 4-byte AS number function causes the disconnection and re-establishment of peer sessions. This may lead to a temporary network interruption.. Therefore, exercise caution when perfom such operations.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instanc a
[HUAWEI-bgp-instance-a] group test
[HUAWEI-bgp-instance-a] peer test capability-advertise route-refresh

peer capability-advertise (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer capability-advertise command enables optional functions for BGP to advertise routes, including the route-refresh function, conventional functions, and 4-byte AS number function.

The undo peer capability-advertise command restores the default setting.

By default, the BGP route-refresh and 4-byte AS number functions are enabled, but conventional functions are disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address capability-advertise { conventional | route-refresh | 4-byte-as }

undo peer ipv4-address capability-advertise { conventional | route-refresh | 4-byte-as }

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

conventional

Indicates conventional functions.

  • This parameter is valid only in the BGP view and BGP-VPN instance IPv4 address family view.
  • After conventional functions are enabled on a device, the device does not have extended functions, such as route-refresh and GR.

-

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP has many optional functions when advertising routes, including the route-refresh function, conventional functions, and 4-byte AS number function. Using the peer capability-advertise command, you can enable or disable these functions as required.

Configuration Impact

Enabling or disabling the route-refresh function, conventional functions, or 4-byte AS number function causes the disconnection and re-establishment of peer sessions. This may lead to a temporary network interruption.. Therefore, exercise caution when performing such operations.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 capability-advertise route-refresh

peer capability-advertise (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer capability-advertise command enables the optional functions for BGP to advertise routes, including the route-refresh function, conventional functions, and 4-byte AS number function.

The undo peer capability-advertise command restores the default setting.

By default, the BGP route-refresh and 4-byte AS number functions are enabled, but conventional functions are disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name capability-advertise { conventional | route-refresh | 4-byte-as }

undo peer group-name capability-advertise { conventional | route-refresh | 4-byte-as }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

conventional

Indicates conventional functions.

  • This parameter is valid only in the BGP view and BGP-VPN instance IPv4 address family view.
  • After conventional functions are enabled on a device, the device does not have extended functions, such as route-refresh and GR.

-

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP has many optional functions when advertising routes, including the route-refresh function, conventional functions, and 4-byte AS number function. Using the peer capability-advertise command, you can enable or disable these functions as required.

Configuration Impact

Enabling or disabling the route-refresh function, conventional functions, or 4-byte AS number function causes the disconnection and re-establishment of peer sessions. This may lead to a temporary network interruption.. Therefore, exercise caution when perfom such operations.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test capability-advertise route-refresh

peer capability-advertise (BGP view)

Function

The peer capability-advertise command enables optional functions for BGP to advertise routes, including the route-refresh function, conventional functions, and 4-byte AS number function.

The undo peer capability-advertise command restores the default setting.

By default, the BGP route-refresh and 4-byte AS number functions are enabled, but conventional functions are disabled.

Format

peer ipv4-address capability-advertise { conventional | route-refresh | 4-byte-as }

undo peer ipv4-address capability-advertise { conventional | route-refresh | 4-byte-as }

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

conventional

Indicates conventional functions.

  • This parameter is valid only in the BGP view and BGP-VPN instance IPv4 address family view.
  • After conventional functions are enabled on a device, the device does not have extended functions, such as route-refresh and GR.

-

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP has many optional functions when advertising routes, including the route-refresh function, conventional functions, and 4-byte AS number function. Using the peer capability-advertise command, you can enable or disable these functions as required.

Configuration Impact

Enabling or disabling the route-refresh function, conventional functions, or 4-byte AS number function causes the disconnection and re-establishment of peer sessions. This may lead to a temporary network interruption.. Therefore, exercise caution when perfom such operations.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 capability-advertise route-refresh

peer capability-advertise (BGP view) (group)

Function

The peer capability-advertise command enables optional functions for BGP to advertise routes, including the route-refresh function, conventional functions, and 4-byte AS number function.

The undo peer capability-advertise command restores the default setting.

By default, the BGP route-refresh and 4-byte AS number functions are enabled, but conventional functions are disabled.

Format

peer group-name capability-advertise { conventional | route-refresh | 4-byte-as }

undo peer group-name capability-advertise { conventional | route-refresh | 4-byte-as }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

conventional

Indicates conventional functions.

  • This parameter is valid only in the BGP view and BGP-VPN instance IPv4 address family view.
  • After conventional functions are enabled on a device, the device does not have extended functions, such as route-refresh and GR.

-

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP has many optional functions when advertising routes, including the route-refresh function, conventional functions, and 4-byte AS number function. Using the peer capability-advertise command, you can enable or disable these functions as required.

Configuration Impact

Enabling or disabling the route-refresh function, conventional functions, or 4-byte AS number function causes the disconnection and re-establishment of peer sessions. This may lead to a temporary network interruption.. Therefore, exercise caution when perfom such operations.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test capability-advertise route-refresh

peer capability-advertise (BGP view) (IPv6)

Function

The peer capability-advertise command enables optional functions for BGP to advertise routes, including the route-refresh function, conventional functions, and 4-byte AS number function.

The undo peer capability-advertise command restores the default setting.

By default, the BGP route-refresh and 4-byte AS number functions are enabled, but conventional functions are disabled.

Format

peer ipv6-address capability-advertise { route-refresh | 4-byte-as }

undo peer ipv6-address capability-advertise { route-refresh | 4-byte-as }

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP has many optional functions when advertising routes, including the route-refresh function, conventional functions, and 4-byte AS number function. Using the peer capability-advertise command, you can enable or disable these functions as required.

Configuration Impact

Enabling or disabling the route-refresh function, conventional functions, or 4-byte AS number function causes the disconnection and re-establishment of peer sessions. This may lead to a temporary network interruption.. Therefore, exercise caution when perfom such operations.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] peer 2001:DB8:1::1 capability-advertise route-refresh

peer capability-advertise (BGP-VPN instance IPv4 address family view)

Function

The peer capability-advertise command enables optional functions for BGP to advertise routes, including the route-refresh function, conventional functions, and 4-byte AS number function.

The undo peer capability-advertise command restores the default setting.

By default, the BGP route-refresh and 4-byte AS number functions are enabled, but conventional functions are disabled.

Format

peer ipv4-address capability-advertise { conventional | route-refresh | 4-byte-as }

undo peer ipv4-address capability-advertise { conventional | route-refresh | 4-byte-as }

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

conventional

Indicates conventional functions.

  • This parameter is valid only in the BGP view and BGP-VPN instance IPv4 address family view.
  • After conventional functions are enabled on a device, the device does not have extended functions, such as route-refresh and GR.

-

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP has many optional functions when advertising routes, including the route-refresh function, conventional functions, and 4-byte AS number function. Using the peer capability-advertise command, you can enable or disable these functions as required.

Configuration Impact

Enabling or disabling the route-refresh function, conventional functions, or 4-byte AS number function causes the disconnection and re-establishment of peer sessions. This may lead to a temporary network interruption.. Therefore, exercise caution when perfom such operations.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 capability-advertise route-refresh

peer capability-advertise (BGP-VPN instance IPv4 address family view) (group)

Function

The peer capability-advertise command enables optional functions for BGP to advertise routes, including the route-refresh function, conventional functions, and 4-byte AS number function.

The undo peer capability-advertise command restores the default setting.

By default, the BGP route-refresh and 4-byte AS number functions are enabled, but conventional functions are disabled.

Format

peer group-name capability-advertise { conventional | route-refresh | 4-byte-as }

undo peer group-name capability-advertise { conventional | route-refresh | 4-byte-as }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

conventional

Indicates conventional functions.

  • This parameter is valid only in the BGP view and BGP-VPN instance IPv4 address family view.
  • After conventional functions are enabled on a device, the device does not have extended functions, such as route-refresh and GR.

-

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP has many optional functions when advertising routes, including the route-refresh function, conventional functions, and 4-byte AS number function. Using the peer capability-advertise command, you can enable or disable these functions as required.

Configuration Impact

Enabling or disabling the route-refresh function, conventional functions, or 4-byte AS number function causes the disconnection and re-establishment of peer sessions. This may lead to a temporary network interruption.. Therefore, exercise caution when perfom such operations.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test
[HUAWEI-bgp-vpn1] peer test capability-advertise route-refresh

peer capability-advertise (BGP-VPN instance IPv6 address family view) (group)

Function

The peer capability-advertise command enables optional BGP functions when a BGP peer advertises routes to its peer. The optional BGP functions include route-refresh, general function, 4-byte AS number, and Add-Path.

The undo peer capability-advertise command restores the default setting.

By default, the BGP route-refresh and 4-byte AS number functions are enabled, but conventional functions are disabled.

Format

peer group-name capability-advertise { route-refresh | 4-byte-as }

undo peer group-name capability-advertise { route-refresh | 4-byte-as }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP has many optional functions when advertising routes, including the route-refresh function, conventional functions, and 4-byte AS number function. Using the peer capability-advertise command, you can enable or disable these functions as required.

Configuration Impact

Enabling or disabling the route-refresh function, conventional functions, or 4-byte AS number function causes the disconnection and re-establishment of peer sessions. This may lead to a temporary network interruption.. Therefore, exercise caution when perfom such operations.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test capability-advertise route-refresh

peer capability-advertise (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer capability-advertise command enables optional BGP functions when a BGP peer advertises routes to its peer. The optional BGP functions include route-refresh, general function, 4-byte AS number, and Add-Path.

The undo peer capability-advertise command restores the default setting.

By default, the route-refresh and 4-byte AS number functions are enabled, but the general function and Add-Path are disabled.

Format

peer ipv6-address capability-advertise { route-refresh | 4-byte-as }

undo peer ipv6-address capability-advertise { route-refresh | 4-byte-as }

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is in the format of X:X:X:X:X:X:X:X.

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

There are multiple optional BGP functions when a BGP peer advertises routes to its peer. The optional BGP functions include route-refresh, general function, 4-byte AS number, and Add-Path. You can run the peer capability-advertise command to select one of the functions based on the needs on the live network.

Configuration Impact

If you enable or disable the route-refresh, general function, 4-byte AS number, or Add-Path function, the BGP peer relationship will be re-established, which can lead to a temporary network interruption. Therefore, exercise caution when running the related commands.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 capability-advertise route-refresh

peer capability-advertise (BGP-VPN instance view)

Function

The peer capability-advertise command enables optional functions for BGP to advertise routes, including the route-refresh function, conventional functions, and 4-byte AS number function.

The undo peer capability-advertise command restores the default setting.

By default, the BGP route-refresh and 4-byte AS number functions are enabled, but conventional functions are disabled.

Format

peer ipv4-address capability-advertise { conventional | route-refresh | 4-byte-as }

undo peer ipv4-address capability-advertise { conventional | route-refresh | 4-byte-as }

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

conventional

Indicates conventional functions.

  • This parameter is valid only in the BGP view and BGP-VPN instance IPv4 address family view.
  • After conventional functions are enabled on a device, the device does not have extended functions, such as route-refresh and GR.

-

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP has many optional functions when advertising routes, including the route-refresh function, conventional functions, and 4-byte AS number function. Using the peer capability-advertise command, you can enable or disable these functions as required.

Configuration Impact

Enabling or disabling the route-refresh function, conventional functions, or 4-byte AS number function causes the disconnection and re-establishment of peer sessions. This may lead to a temporary network interruption.. Therefore, exercise caution when perfom such operations.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.2.3.4 as-number 100
[HUAWEI-bgp-instance-vpn1] peer 10.2.3.4 capability-advertise route-refresh

peer capability-advertise (BGP-VPN instance view) (group)

Function

The peer capability-advertise command enables optional functions for BGP to advertise routes, including the route-refresh function, conventional functions, and 4-byte AS number function.

The undo peer capability-advertise command restores the default setting.

By default, the BGP route-refresh and 4-byte AS number functions are enabled, but conventional functions are disabled.

Format

peer group-name capability-advertise { conventional | route-refresh | 4-byte-as }

undo peer group-name capability-advertise { conventional | route-refresh | 4-byte-as }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

conventional

Indicates conventional functions.

  • This parameter is valid only in the BGP view and BGP-VPN instance IPv4 address family view.
  • After conventional functions are enabled on a device, the device does not have extended functions, such as route-refresh and GR.

-

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP has many optional functions when advertising routes, including the route-refresh function, conventional functions, and 4-byte AS number function. Using the peer capability-advertise command, you can enable or disable these functions as required.

Configuration Impact

Enabling or disabling the route-refresh function, conventional functions, or 4-byte AS number function causes the disconnection and re-establishment of peer sessions. This may lead to a temporary network interruption.. Therefore, exercise caution when perfom such operations.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test external
[HUAWEI-bgp-instance-vpn1] peer test capability-advertise route-refresh

peer capability-advertise (BGP-VPN instance view) (IPv6)

Function

The peer capability-advertise command enables optional functions for BGP to advertise routes, including the route-refresh function, conventional functions, and 4-byte AS number function.

The undo peer capability-advertise command restores the default setting.

By default, the BGP route-refresh and 4-byte AS number functions are enabled, but conventional functions are disabled.

Format

peer ipv6-address capability-advertise { route-refresh | 4-byte-as }

undo peer ipv6-address capability-advertise { route-refresh | 4-byte-as }

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

route-refresh

Indicates the route-refresh function.

-

4-byte-as

Indicates the 4-byte AS number function.

-

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP has many optional functions when advertising routes, including the route-refresh function, conventional functions, and 4-byte AS number function. Using the peer capability-advertise command, you can enable or disable these functions as required.

Configuration Impact

Enabling or disabling the route-refresh function, conventional functions, or 4-byte AS number function causes the disconnection and re-establishment of peer sessions. This may lead to a temporary network interruption.. Therefore, exercise caution when perfom such operations.

Example

# Configure a BGP device to advertise the route-refresh capability to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn-af-ipv4] quit
[HUAWEI-vpn-instance-vpn] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn
[HUAWEI-bgp] peer 2001:DB8:4::4 as-number 100
[HUAWEI-bgp-instance-vpn] peer 2001:DB8:4::4 capability-advertise route-refresh

peer capability-advertise add-path (BGP view)

Function

The peer capability-advertise add-path command enables BGP Add-Path function.

The undo peer capability-advertise add-path command restores the default setting.

By default, the Add-Path function is disabled.

Format

peer ipv4-address capability-advertise add-path { both | receive | send }

undo peer ipv4-address capability-advertise add-path { both | receive | send }

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

add-path

Indicates the Add-Path function.

add-path takes effect only on IBGP peers.

-

both

Enables the RR to receive Add-Path routes from and send Add-Path routes to a specified IBGP peer.

-

receive

Enables the RR to receive Add-Path routes from a specified IBGP peer.

-

send

Enables the RR to send Add-Path routes to a specified IBGP peer.

-

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

This command is used to configure BGP Add-Path. After BGP Add-Path is configured, a device can advertise two or more routes with the same prefix to a BGP peer. These routes can back up each other or load-balance traffic, thereby ensuring data transmission reliability.

When deploying BGP Add-Path, run the peer capability-advertise add-path command to enable the device to advertise Add-Path routes to a specified BGP peer or receive Add-Path routes from a specified BGP peer. In addition, you need to run the peer advertise add-path command to configure the number of routes that the device can advertise to a specified peer.

Prerequisites

The peer has been enabled in the current view using the peer enable command.

Configuration Impact

Enabling or disabling the Add-Path function causes the peer session to be disconnected and then re-established. Therefore, exercise caution when running the two commands.

Precautions

If the peer capability-advertise add-path command is run for a specified peer and the peer advertise best-external command is run for a specified peer group, the peer cannot inherit the function of the peer advertise best-external command configured for the peer group when the peer is added to the peer group.

The peer capability-advertise add-path command takes effect only on the routes received from BGP peers.

  • If the route received from a BGP peer is preferred, the local BGP route using the network command is not preferred or advertised.
  • If the local network route is preferred, the route received from the BGP peer is not preferred. After the add-path command is run, the route can be advertised.

Example

# Enable the RR to receive Add-Path routes from a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.2.3.4 as-number 100
[HUAWEI-bgp] peer 10.2.3.4 capability-advertise add-path receive

peer capability-advertise add-path (BGP view) (group)

Function

The peer capability-advertise add-path command enables BGP Add-Path function.

The undo peer capability-advertise add-path command restores the default setting.

By default, Add-Path funcition is disabled.

Format

peer group-name capability-advertise add-path { both | receive | send }

undo peer group-name capability-advertise add-path { both | receive | send }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

add-path

Indicates the Add-Path function.

add-path takes effect only on IBGP peers.

-

both

Enables the RR to receive Add-Path routes from and send Add-Path routes to a specified IBGP peer.

-

receive

Enables the RR to receive Add-Path routes from a specified IBGP peer.

-

send

Enables the RR to send Add-Path routes to a specified IBGP peer.

-

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP advertises routes, optional functions include Add-Path. Using the peer capability-advertise add-path command, you can enable or disable the ADD-PATH function as required.

Prerequisites

The peer has been enabled in the current view using the peer enable command.

Configuration Impact

Enabling or disabling the Add-Path function causes the peer session to be disconnected and then re-established. Therefore, exercise caution when running the two commands.

Precautions

If the peer capability-advertise add-path command is run for a specified peer and the peer advertise best-external command is run for a specified peer group, the peer cannot inherit the function of the peer advertise best-external command configured for the peer group when the peer is added to the peer group.

The peer capability-advertise add-path command takes effect only on the routes received from BGP peers.

  • If the route received from a BGP peer is preferred, the local BGP route using the network command is not preferred or advertised.
  • If the local network route is preferred, the route received from the BGP peer is not preferred. After the add-path command is run, the route can be advertised.

Example

# Enable the device to accept the Add-Path routes from a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer test capability-advertise add-path both

peer capability-advertise add-path (BGP-IPv6 unicast address family view)

Function

The peer capability-advertise add-path command enables optional functions for BGP to advertise routes, including route-refresh, common functions, 4-byte AS number, and Add-Path.

The undo peer advertise add-path command restores the default configuration.

By default, the route-refresh and 4-byte AS number functions are enabled, but the general function and Add-Path are disabled.

Format

peer ipv4-address capability-advertise add-path { both | receive | send }

undo peer ipv4-address capability-advertise add-path { both | receive | send }

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

add-path

Indicates the Add-Path function.

add-path takes effect only on IBGP peers.

-

both

Enables the RR to receive Add-Path routes from and send Add-Path routes to a specified IBGP peer.

-

receive

Enables the RR to receive Add-Path routes from a specified IBGP peer.

-

send

Enables the RR to send Add-Path routes to a specified IBGP peer.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

There are multiple optional BGP functions when a BGP peer advertises routes to its peer. The optional BGP functions include route-refresh, general function, 4-byte AS number, and Add-Path. You can run the peer capability-advertise command to select one of the functions based on the needs on the live network.

Configuration Impact

If you enable or disable the route-refresh, general function, 4-byte AS number, or Add-Path function, the BGP peer relationship will be re-established, which can lead to a temporary network interruption. Therefore, exercise caution when running the related commands.

Precautions

If a peer is specified when the peer capability-advertise add-path command is run, a peer group is specified when the peer advertise best-external command is run, and then the peer is added to the peer group, the peer cannot inherit the configuration of the peer advertise best-external command from the peer group.

Example

# Enable the RR to receive Add-Path routes from a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 capability-advertise add-path receive

peer capability-advertise add-path (BGP-IPv6 unicast address family view) (group)

Function

The peer capability-advertise add-path command enables the Add-Path function.

The undo peer capability-advertise add-path command restores the default setting.

By default, Add-Path function is disabled.

Format

peer group-name capability-advertise add-path { both | receive | send }

undo peer group-name capability-advertise add-path { both | receive | send }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

add-path

Indicates the Add-Path function.

add-path takes effect only on IBGP peers.

-

both

Enables the RR to receive Add-Path routes from and send Add-Path routes to a specified IBGP peer.

-

receive

Enables the RR to receive Add-Path routes from a specified IBGP peer.

-

send

Enables the RR to send Add-Path routes to a specified IBGP peer.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

This command is used to configure BGP Add-Path. After BGP Add-Path is configured, a device can advertise two or more routes with the same prefix to a BGP peer. These routes can back up each other or load-balance traffic, thereby ensuring data transmission reliability.

When deploying BGP Add-Path, run the peer capability-advertise add-path command to enable the device to advertise Add-Path routes to a specified BGP peer or receive Add-Path routes from a specified BGP peer. In addition, you need to run the peer advertise add-path command to configure the number of routes that the device can advertise to a specified peer.

Configuration Impact

Enabling or disabling the Add-Path function causes the peer session to be disconnected and then re-established. Therefore, exercise caution when running the two commands.

Precautions

If a peer is specified when the peer capability-advertise add-path command is run, a peer group is specified when the peer advertise best-external command is run, and then the peer is added to the peer group, the peer cannot inherit the configuration of the peer advertise best-external command from the peer group.

Example

# Enable the device to accept the Add-Path routes received from a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test capability-advertise add-path both

peer capability-advertise add-path (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer capability-advertise add-path command enables optional functions for BGP to advertise routes, including route-refresh, common functions, 4-byte AS number, and Add-Path.

The undo peer advertise add-path command restores the default configuration.

By default, the route-refresh and 4-byte AS number functions are enabled, but the general function and Add-Path are disabled.

Format

peer ipv6-address capability-advertise add-path { both | receive | send }

undo peer ipv6-address capability-advertise add-path { both | receive | send }

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

add-path

Indicates the Add-Path function.

add-path takes effect only on IBGP peers.

-

both

Enables the RR to receive Add-Path routes from and send Add-Path routes to a specified IBGP peer.

-

receive

Enables the RR to receive Add-Path routes from a specified IBGP peer.

-

send

Enables the RR to send Add-Path routes to a specified IBGP peer.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

This command is used to configure BGP Add-Path. After BGP Add-Path is configured, a device can advertise two or more routes with the same prefix to a BGP peer. These routes can back up each other or load-balance traffic, thereby ensuring data transmission reliability.

When deploying BGP Add-Path, run the peer capability-advertise add-path command to enable the device to advertise Add-Path routes to a specified BGP peer or receive Add-Path routes from a specified BGP peer. In addition, you need to run the peer advertise add-path command to configure the number of routes that the device can advertise to a specified peer.

Configuration Impact

Enabling or disabling the Add-Path function causes the peer session to be disconnected and then re-established. Therefore, exercise caution when running the two commands.

Precautions

If a peer is specified when the peer capability-advertise add-path command is run, a peer group is specified when the peer advertise best-external command is run, and then the peer is added to the peer group, the peer cannot inherit the configuration of the peer advertise best-external command from the peer group.

Example

# Enable the RR to receive Add-Path routes from a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 capability-advertise add-path receive

peer capability-advertise graceful-restart (BGP multi-instance view)

Function

The peer capability-advertise graceful-restart command enables GR for a specified peer on a device. After this command is run, the device will advertise the GR capability to the specified peer.

The peer capability-advertise graceful-restart disable command disables GR for a specified peer on a device.

The undo peer capability-advertise graceful-restart command cancels GR enabling for a specified peer on a device.

The undo peer capability-advertise graceful-restart disable command cancels GR disabling for a specified peer on a device.

By default, GR is not enabled for a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address capability-advertise graceful-restart

peer ipv4-address capability-advertise graceful-restart disable

undo peer ipv4-address capability-advertise graceful-restart

undo peer ipv4-address capability-advertise graceful-restart disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the graceful-restart command is run in the BGP view to enable GR globally on a device, all the device's peer relationships are disconnected, and the device has to renegotiate the GR capability with its peers. You are therefore advised to run the peer capability-advertise graceful-restart command instead to enable GR for a specified peer. If GR is not enabled globally, you can run this command to enable the GR capability and configure the device to notify the specified peer of the GR capability. In this manner, the routes and forwarding entries related to the specified peer are not deleted within the GR time, preventing traffic interruption.

Configuration Impact

Enabling or disabling GR for a specified peer on a device causes the BGP peer relationship to be disconnected and then reestablished.

Example

# Enable GR for a specified peer on a device. The device will then advertise the GR capability to the specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 10.1.1.1 capability-advertise graceful-restart

peer capability-advertise graceful-restart (BGP multi-instance view) (group)

Function

The peer capability-advertise graceful-restart command enables GR for all peers in a specified group on a device. After this command is run, the device will advertise the GR capability to all the peers in the group.

The undo peer capability-advertise graceful-restart command cancels GR enabling for each peer in a specified group on a device.

By default, GR is not enabled for any peer in a specified group on a device.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name capability-advertise graceful-restart

undo peer group-name capability-advertise graceful-restart

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the graceful-restart command is run in the BGP view to enable GR globally on a device, all the device's peer relationships are disconnected, and the device has to renegotiate the GR capability with its peers. You are therefore advised to enable GR for peers in a specified group. Specifically, run this command when GR is not enabled globally, to enable the GR capability and notify the specified peer group of the GR capability. In this manner, the routes and forwarding entries related to the specified peers are not deleted within the GR time, preventing traffic interruption.

Configuration Impact

Enabling or disabling GR for a specified peer on a device causes the BGP peer relationship to be disconnected and then reestablished.

Example

# Enable GR for each peer in a specified group on a device. The device will then advertise the GR capability to all the peers in the group.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] group a
[HUAWEI-bgp-instance-a] peer a capability-advertise graceful-restart

peer capability-advertise graceful-restart (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer capability-advertise graceful-restart command enables GR for a specified peer on a device. After this command is run, the device will advertise the GR capability to the specified peer.

The peer capability-advertise graceful-restart disable command disables GR for a specified peer on a device.

The undo peer capability-advertise graceful-restart command cancels GR enabling for a specified peer on a device.

The undo peer capability-advertise graceful-restart disable command cancels GR disabling for a specified peer on a device.

By default, GR is not enabled for a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address capability-advertise graceful-restart

peer ipv4-address capability-advertise graceful-restart disable

undo peer ipv4-address capability-advertise graceful-restart

undo peer ipv4-address capability-advertise graceful-restart disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the graceful-restart command is run in the BGP view to enable GR globally on a device, all the device's peer relationships are disconnected, and the device has to renegotiate the GR capability with its peers. You are therefore advised to run the peer capability-advertise graceful-restart command instead to enable GR for a specified peer. If GR is not enabled globally, you can run this command to enable the GR capability and configure the device to notify the specified peer of the GR capability. In this manner, the routes and forwarding entries related to the specified peer are not deleted within the GR time, preventing traffic interruption.

Configuration Impact

Enabling or disabling GR for a specified peer on a device causes the BGP peer relationship to be disconnected and then reestablished.

Example

# Enable GR for a specified peer on a device. The device will then advertise the GR capability to the specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-instance-a-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpn1] peer 10.1.1.1 capability-advertise graceful-restart

peer capability-advertise graceful-restart (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer capability-advertise graceful-restart command enables GR for all peers in a specified group on a device. After this command is run, the device will advertise the GR capability to all the peers in the group.

The undo peer capability-advertise graceful-restart command cancels GR enabling for a specified peer on a device.

By default, GR is not enabled for any peer in a specified group on a device.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name capability-advertise graceful-restart

undo peer group-name capability-advertise graceful-restart

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the graceful-restart command is run in the BGP view to enable GR globally on a device, all the device's peer relationships are disconnected, and the device has to renegotiate the GR capability with its peers. You are therefore advised to run the peer capability-advertise graceful-restart command instead to enable GR for peers in a specified group. After the command is run, the device advertises the GR capability to all the peers in the group. This ensures that the device does not delete the routes received from these peers and forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Configuration Impact

Enabling or disabling GR for each peer in a specified group on a device causes the BGP peer relationships to be disconnected and then reestablished.

Example

# Enable GR for each peer in a specified group on a device, which will then advertise the GR capability to all the peers in the specified group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-instance-a-vpn1] group a
[HUAWEI-bgp-instance-a-vpn1] peer a capability-advertise graceful-restart

peer capability-advertise graceful-restart (BGP view)

Function

The peer capability-advertise graceful-restart command enables GR for a specified peer on a device. After this command is run, the device will advertise the GR capability to the specified peer.

The peer capability-advertise graceful-restart disable command disables GR for a specified peer on a device.

The undo peer capability-advertise graceful-restart command cancels GR enabling for a specified peer on a device.

The undo peer capability-advertise graceful-restart disable command cancels GR disabling for a specified peer on a device.

By default, GR is not enabled for a peer.

Format

peer ipv4-address capability-advertise graceful-restart

peer ipv4-address capability-advertise graceful-restart disable

peer ipv6-address capability-advertise graceful-restart

peer ipv6-address capability-advertise graceful-restart disable

undo peer ipv4-address capability-advertise graceful-restart

undo peer ipv4-address capability-advertise graceful-restart disable

undo peer ipv6-address capability-advertise graceful-restart

undo peer ipv6-address capability-advertise graceful-restart disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the graceful-restart command is run in the BGP view to enable GR globally on a device, all the device's peer relationships are disconnected, and the device has to renegotiate the GR capability with its peers. You are therefore advised to run the peer capability-advertise graceful-restart command instead to enable GR for a specified peer. If GR is not enabled globally, you can run this command to enable the GR capability and configure the device to notify the specified peer of the GR capability. In this manner, the routes and forwarding entries related to the specified peer are not deleted within the GR time, preventing traffic interruption.

Configuration Impact

Enabling or disabling GR for a specified peer on a device causes the BGP peer relationship to be disconnected and then reestablished.

Example

# Enable GR for a specified peer on a device. The device will then advertise the GR capability to the specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 capability-advertise graceful-restart

peer capability-advertise graceful-restart (BGP view)(group)

Function

The peer capability-advertise graceful-restart command enables GR for all peers in a specified group on a device. After this command is run, the device will advertise the GR capability to all the peers in the group.

The undo peer capability-advertise graceful-restart command cancels GR enabling for each peer in a specified group on a device.

By default, GR is not enabled for any peer in a specified group on a device.

Format

peer group-name capability-advertise graceful-restart

undo peer group-name capability-advertise graceful-restart

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the graceful-restart command is run in the BGP view to enable GR globally on a device, all the device's peer relationships are disconnected, and the device has to renegotiate the GR capability with its peers. You are therefore advised to enable GR for peers in a specified group. Specifically, run this command when GR is not enabled globally, to enable the GR capability and notify the specified peer group of the GR capability. In this manner, the routes and forwarding entries related to the specified peers are not deleted within the GR time, preventing traffic interruption.

Configuration Impact

Enabling or disabling GR for each peer in a specified group on a device causes the BGP peer relationships to be disconnected and then reestablished.

Example

# Enable GR for each peer in a specified group on a device. The device will then advertise the GR capability to all the peers in the group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group a
[HUAWEI-bgp] peer a capability-advertise graceful-restart

peer capability-advertise graceful-restart (BGP-VPN instance IPv4 address family view)

Function

The peer capability-advertise graceful-restart command enables GR for a specified peer on a device. After this command is run, the device will advertise the GR capability to the specified peer.

The peer capability-advertise graceful-restart disable command disables GR for a specified peer on a device.

The undo peer capability-advertise graceful-restart command cancels GR enabling for a specified peer on a device.

The undo peer capability-advertise graceful-restart disable command cancels GR disabling for a specified peer on a device.

By default, GR is not enabled for a peer.

Format

peer ipv4-address capability-advertise graceful-restart

peer ipv4-address capability-advertise graceful-restart disable

undo peer ipv4-address capability-advertise graceful-restart

undo peer ipv4-address capability-advertise graceful-restart disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the graceful-restart command is run in the BGP view to enable GR globally on a device, all the device's peer relationships are disconnected, and the device has to renegotiate the GR capability with its peers. You are therefore advised to run the peer capability-advertise graceful-restart command instead to enable GR for a specified peer. If GR is not enabled globally, you can run this command to enable the GR capability and configure the device to notify the specified peer of the GR capability. In this manner, the routes and forwarding entries related to the specified peer are not deleted within the GR time, preventing traffic interruption.

Configuration Impact

Enabling or disabling GR for a specified peer on a device causes the BGP peer relationship to be disconnected and then reestablished.

Example

# Enable GR for a specified peer on a device. The device will then advertise the GR capability to the specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 capability-advertise graceful-restart

peer capability-advertise graceful-restart (BGP-VPN instance IPv4 address family view) (group)

Function

The peer capability-advertise graceful-restart command enables GR for all peers in a specified group on a device. After this command is run, the device will advertise the GR capability to all the peers in the group.

The undo peer capability-advertise graceful-restart command cancels GR enabling for each peer in a specified group on a device.

By default, GR is not enabled for any peer in a specified group on a device.

Format

peer group-name capability-advertise graceful-restart

undo peer group-name capability-advertise graceful-restart

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the graceful-restart command is run in the BGP view to enable GR globally on a device, all the device's peer relationships are disconnected, and the device has to renegotiate the GR capability with its peers. You are therefore advised to run the peer capability-advertise graceful-restart command instead to enable GR for peers in a specified group. After the command is run, the device advertises the GR capability to all the peers in the group. This ensures that the device does not delete the routes received from these peers and forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Configuration Impact

Enabling or disabling GR for each peer in a specified group on a device causes the BGP peer relationships to be disconnected and then reestablished.

Example

# Enable GR for each peer in a specified group on a device. The device will then advertise the GR capability to all the peers in the group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group a
[HUAWEI-bgp-vpn1] peer a capability-advertise graceful-restart

peer capability-advertise graceful-restart (BGP-VPN instance IPv6 address family view) (group)

Function

The peer capability-advertise graceful-restart command enables GR for all peers in a specified group on a device. After this command is run, the device will advertise the GR capability to all the peers in the group.

The undo peer capability-advertise graceful-restart command cancels GR enabling for each peer in a specified group on a device.

By default, GR is not enabled for any peer in a specified group on a device.

Format

peer group-name capability-advertise graceful-restart

undo peer group-name capability-advertise graceful-restart

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the graceful-restart command is run in the BGP view to enable GR globally on a device, all the device's peer relationships are disconnected, and the device has to renegotiate the GR capability with its peers. You are therefore advised to enable GR for peers in a specified group. Specifically, run this command when GR is not enabled globally, to enable the GR capability and notify the specified peer group of the GR capability. In this manner, the routes and forwarding entries related to the specified peers are not deleted within the GR time, preventing traffic interruption.

Configuration Impact

Enabling or disabling GR for each peer in a specified group on a device causes the BGP peer relationships to be disconnected and then reestablished.

Example

# Enable GR for each peer in a specified group on a device. The device will then advertise the GR capability to all the peers in the group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group a
[HUAWEI-bgp-6-vpn1] peer a capability-advertise graceful-restart

peer capability-advertise graceful-restart (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer capability-advertise graceful-restart command enables GR for a specified peer on a device. After this command is run, the device will advertise the GR capability to the specified peer.

The peer capability-advertise graceful-restart disable command disables GR for a specified peer on a device.

The undo peer capability-advertise graceful-restart command cancels GR enabling for a specified peer on a device.

The undo peer capability-advertise graceful-restart disable command cancels GR disabling for a specified peer on a device.

By default, GR is not enabled for a peer.

Format

peer ipv6-address capability-advertise graceful-restart

peer ipv6-address capability-advertise graceful-restart disable

undo peer ipv6-address capability-advertise graceful-restart

undo peer ipv6-address capability-advertise graceful-restart disable

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the graceful-restart command is run in the BGP view to enable GR globally on a device, all the device's peer relationships are disconnected, and the device has to renegotiate the GR capability with its peers. You are therefore advised to run the peer capability-advertise graceful-restart command instead to enable GR for a specified peer. If GR is not enabled globally, you can run this command to enable the GR capability and configure the device to notify the specified peer of the GR capability. In this manner, the routes and forwarding entries related to the specified peer are not deleted within the GR time, preventing traffic interruption.

Configuration Impact

Enabling or disabling GR for a specified peer on a device causes the BGP peer relationship to be disconnected and then reestablished.

Example

# Enable GR for a specified peer on a device. The device will then advertise the GR capability to the specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpn1] peer 2001:DB8:1::1 capability-advertise graceful-restart

peer capability-advertise graceful-restart (BGP-VPN instance view)

Function

The peer capability-advertise graceful-restart command enables GR for a specified peer on a device. After this command is run, the device will advertise the GR capability to the specified peer.

The peer capability-advertise graceful-restart disable command disables GR for a specified peer on a device.

The undo peer capability-advertise graceful-restart command cancels GR enabling for a specified peer on a device.

The undo peer capability-advertise graceful-restart disable command cancels GR disabling for a specified peer on a device.

By default, GR is not enabled for a peer.

Format

peer ipv4-address capability-advertise graceful-restart

peer ipv4-address capability-advertise graceful-restart disable

peer ipv6-address capability-advertise graceful-restart

peer ipv6-address capability-advertise graceful-restart disable

undo peer ipv4-address capability-advertise graceful-restart

undo peer ipv4-address capability-advertise graceful-restart disable

undo peer ipv6-address capability-advertise graceful-restart

undo peer ipv6-address capability-advertise graceful-restart disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the graceful-restart command is run in the BGP view to enable GR globally on a device, all the device's peer relationships are disconnected, and the device has to renegotiate the GR capability with its peers. You are therefore advised to run the peer capability-advertise graceful-restart command instead to enable GR for a specified peer. If GR is not enabled globally, you can run this command to enable the GR capability and configure the device to notify the specified peer of the GR capability. In this manner, the routes and forwarding entries related to the specified peer are not deleted within the GR time, preventing traffic interruption.

Configuration Impact

Enabling or disabling GR for a specified peer on a device causes the BGP peer relationship to be disconnected and then reestablished.

Example

# Enable GR for a specified peer on a device. The device will then advertise the GR capability to the specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.1 capability-advertise graceful-restart

peer capability-advertise graceful-restart (BGP-VPN instance view) (group)

Function

The peer capability-advertise graceful-restart command enables GR for all peers in a specified group on a device. After this command is run, the device will advertise the GR capability to all the peers in the group.

The undo peer capability-advertise graceful-restart command cancels GR enabling for each peer in a specified group on a device.

By default, GR is not enabled for any peer in a specified group on a device.

Format

peer group-name capability-advertise graceful-restart

undo peer group-name capability-advertise graceful-restart

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the graceful-restart command is run in the BGP view to enable GR globally on a device, all the device's peer relationships are disconnected, and the device has to renegotiate the GR capability with its peers. You are therefore advised to enable GR for peers in a specified group. Specifically, run this command when GR is not enabled globally, to enable the GR capability and notify the specified peer group of the GR capability. In this manner, the routes and forwarding entries related to the specified peers are not deleted within the GR time, preventing traffic interruption.

Configuration Impact

Enabling or disabling GR for a specified peer on a device causes the BGP peer relationship to be disconnected and then reestablished.

Example

# Enable GR for each peer in a specified group on a device. The device will then advertise the GR capability to all the peers in the group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group a
[HUAWEI-bgp-instance-vpn1] peer a capability-advertise graceful-restart

peer capability-advertise graceful-restart(BGP multi-instance VPN instance view)

Function

The peer capability-advertise graceful-restart command enables the GR capability and configures the device to advertise the capability to a specified peer.

The peer capability-advertise graceful-restart disable command disables the GR capability of a peer.

The undo peer capability-advertise graceful-restart command cancels the configuration of enabling the GR capability of a peer.

The undo peer capability-advertise graceful-restart disable command cancels the configuration of disabling the GR capability of a peer.

By default, GR is not enabled for a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr capability-advertise graceful-restart

peer peerIpv6Addr capability-advertise graceful-restart

peer peerIpv4Addr capability-advertise graceful-restart disable

peer peerIpv6Addr capability-advertise graceful-restart disable

undo peer peerIpv4Addr capability-advertise graceful-restart

undo peer peerIpv6Addr capability-advertise graceful-restart

undo peer peerIpv4Addr capability-advertise graceful-restart disable

undo peer peerIpv6Addr capability-advertise graceful-restart disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the graceful-restart command is run in the BGP view to enable GR globally on a device, all the device's peer relationships are disconnected, and the device has to renegotiate the GR capability with its peers. You are therefore advised to run the peer capability-advertise graceful-restart command instead to enable GR for a specified peer. If GR is not enabled globally, you can run this command to enable the GR capability and configure the device to notify the specified peer of the GR capability. In this manner, the routes and forwarding entries related to the specified peer are not deleted within the GR time, preventing traffic interruption.

Example

# Enable GR for a specified peer on a device. The device will then advertise the GR capability to the specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] vpn-instance vpn1
[HUAWEI-bgp-instance-a-instance-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-instance-vpn1] peer 10.1.1.1 capability-advertise graceful-restart

peer capability-advertise orf ip-prefix (BGP-IPv4 unicast address family view)

Function

The peer capability-advertise orf ip-prefix command configures a BGP device to advertise the prefix-based ORF capability to its peer.

The undo peer capability-advertise orf ip-prefix command cancels the configuration.

By default, a BGP device is not configured to advertise the prefix-based ORF capability to its peer.

Format

peer ipv4-address capability-advertise orf ip-prefix { both | receive | send }

peer ipv4-address capability-advertise orf non-standard-compatible ip-prefix { both | receive | send }

undo peer ipv4-address capability-advertise orf ip-prefix { both | receive | send }

undo peer ipv4-address capability-advertise orf non-standard-compatible ip-prefix { both | receive | send }

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in the dotted decimal format.

both

Indicates that a peer is allowed to send and receive ORF packets.

-

receive

Indicates that a peer is allowed only to receive ORF packets.

-

send

Indicates that a peer is allowed only to send ORF packets.

-

non-standard-compatible

Indicates that ORF supported by Huawei devices is compatible with that supported by a non-Huawei device.

-

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

ORF enables a BGP device to send to its BGP peer a set of routing policies that can be used by its peer to filter out unwanted routes during route advertisement.

Example

# Configure a BGP device to advertise the prefix-based ORF capability to its peer or peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.11.11.1 as-number 200
[HUAWEI-bgp] peer 10.11.11.1 capability-advertise orf ip-prefix both

peer capability-advertise orf ip-prefix (BGP-IPv4 unicast address family view) (group)

Function

The peer capability-advertise orf ip-prefix command configures a BGP device to advertise the prefix-based ORF capability to its peer group.

The undo peer capability-advertise orf ip-prefix command cancels the configuration.

By default, a BGP device is not configured to advertise the prefix-based ORF capability to its peer group.

Format

peer group-name capability-advertise orf ip-prefix { both | receive | send }

peer group-name capability-advertise orf non-standard-compatible ip-prefix { both | receive | send }

undo peer group-name capability-advertise orf ip-prefix { both | receive | send }

undo peer group-name capability-advertise orf non-standard-compatible ip-prefix { both | receive | send }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

both

Allows the device to send and receive ORF messages.

-

receive

Allows the device only to receive ORF messages.

-

send

Allows the device only to send ORF messages.

-

non-standard-compatible

Indicates that the device is compatible with the devices of other vendors.

-

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

ORF enables a BGP device to send to its BGP peer a set of routing policies that can be used by its peer to filter out unwanted routes during route advertisement.

Example

# Configure a BGP device to advertise the prefix-based ORF capability to its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test capability-advertise orf ip-prefix both

peer check-first-as (BGP multi-instance view)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address check-first-as enable

peer ipv4-address check-first-as disable

undo peer ipv4-address check-first-as enable

undo peer ipv4-address check-first-as disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer is the AS where the EBGP peer resides. If the two AS numbers are different, the Update message is denied. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer. That is, BGP accepts the Update message even if the first AS number is not the AS number of the EBGP peer. This undo command deletes the configuration of the specified EBGP peer and restores the default configuration.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

Run the refresh bgp command if you want to check the received routes again.

Precautions

The check-first-as command applies to all EBGP peers, whereas the peer check-first-as command applies to a specified peer.

Example

# Enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-instance-a] peer 10.1.1.1 check-first-as enable

peer check-first-as (BGP multi-instance view) (group)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name check-first-as enable

peer group-name check-first-as disable

undo peer group-name check-first-as enable

undo peer group-name check-first-as disable

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path carried in the Update messages sent by a specified EBGP peer group is the same as the AS where the EBGP peer group resides. If the two AS numbers are different, the update information is rejected. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path carried in the Update messages sent by a specified EBGP peer group. That is, BGP accepts the Update messages even if the first AS number is not the AS number of the EBGP peer group. This undo command deletes the configurations of a specified EBGP peer group and restores the default settings.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

After the check function is enabled, to enable the device to perform a check on received update messages, run the refresh bgp command.

Precautions

The check-first-as command applies to all EBGP peers, whereas the peer check-first-as command applies to a specified peer.

Example

# Enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100 instanc a
[HUAWEI-bgp-instance-a] group test external
[HUAWEI-bgp-instance-a] peer test check-first-as enable

peer check-first-as (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address check-first-as enable

peer ipv4-address check-first-as disable

undo peer ipv4-address check-first-as enable

undo peer ipv4-address check-first-as disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer is the AS where the EBGP peer resides. If the two AS numbers are different, the Update message is denied. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer. That is, BGP accepts the Update message even if the first AS number is not the AS number of the EBGP peer. This undo command deletes the configuration of the specified EBGP peer and restores the default configuration.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

Run the refresh bgp command if you want to check the received routes again.

Precautions

The check-first-as command applies to all EBGP peers, whereas the peer check-first-as command applies to a specified peer.

Example

# Enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 check-first-as enable

peer check-first-as (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name check-first-as enable

peer group-name check-first-as disable

undo peer group-name check-first-as enable

undo peer group-name check-first-as disable

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path carried in the Update messages sent by a specified EBGP peer group is the same as the AS where the EBGP peer group resides. If the two AS numbers are different, the update information is rejected. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path carried in the Update messages sent by a specified EBGP peer group. That is, BGP accepts the Update messages even if the first AS number is not the AS number of the EBGP peer group. This undo command deletes the configurations of a specified EBGP peer group and restores the default settings.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

Run the refresh bgp command if you want to check the received routes again.

Precautions

The check-first-as command applies to all EBGP peers, whereas the peer check-first-as command applies to a specified peer.

Example

# Enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test external
[HUAWEI-bgp-instance-a-vpna] peer test as-number 200
[HUAWEI-bgp-instance-a-vpna] peer test check-first-as enable

peer check-first-as (BGP view)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

Format

peer ipv4-address check-first-as enable

peer ipv4-address check-first-as disable

undo peer ipv4-address check-first-as enable

undo peer ipv4-address check-first-as disable

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer is the AS where the EBGP peer resides. If the two AS numbers are different, the Update message is denied. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer. That is, BGP accepts the Update message even if the first AS number is not the AS number of the EBGP peer. This undo command deletes the configuration of the specified EBGP peer and restores the default configuration.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

After the check function is enabled, to enable the device to perform a check on received update messages, run the refresh bgp command.

Precautions

The check-first-as command is valid for all EBGP peers, whereas the peer check-first-as command is valid for a specified peer.

This command takes effect before the import routing policy is used.

Example

# Enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 check-first-as enable

peer check-first-as (BGP view) (group)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

Format

peer group-name check-first-as enable

peer group-name check-first-as disable

undo peer group-name check-first-as enable

undo peer group-name check-first-as disable

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path carried in the Update messages sent by a specified EBGP peer group is the same as the AS where the EBGP peer group resides. If the two AS numbers are different, the update information is rejected. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path carried in the Update messages sent by a specified EBGP peer group. That is, BGP accepts the Update messages even if the first AS number is not the AS number of the EBGP peer group. This undo command deletes the configurations of a specified EBGP peer group and restores the default settings.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

Run the refresh bgp command if you want to check the received routes again.

Precautions

The check-first-as command is valid for all EBGP peers, whereas the peer check-first-as command is valid for a specified peer.

This command takes effect before the import routing policy is used.

Example

# Enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test check-first-as enable

peer check-first-as (BGP view) (IPv6)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

Format

peer ipv6-address check-first-as enable

peer ipv6-address check-first-as disable

undo peer ipv6-address check-first-as enable

undo peer ipv6-address check-first-as disable

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer is the AS where the EBGP peer resides. If the two AS numbers are different, the Update message is denied. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer. That is, BGP accepts the Update message even if the first AS number is not the AS number of the EBGP peer. This undo command deletes the configuration of the specified EBGP peer and restores the default configuration.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

Run the refresh bgp command if you want to check the received routes again.

Precautions

The check-first-as command is valid for all EBGP peers, whereas the peer check-first-as command is valid for a specified peer.

This command takes effect before the import routing policy is used.

Example

# Enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp] peer 2001:DB8:1::1 check-first-as enable

peer check-first-as (BGP-VPN instance IPv4 address family view)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

Format

peer ipv4-address check-first-as enable

peer ipv4-address check-first-as disable

undo peer ipv4-address check-first-as enable

undo peer ipv4-address check-first-as disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer is the AS where the EBGP peer resides. If the two AS numbers are different, the Update message is denied. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer. That is, BGP accepts the Update message even if the first AS number is not the AS number of the EBGP peer. This undo command deletes the configuration of the specified EBGP peer and restores the default configuration.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

Run the refresh bgp command if you want to check the received routes again.

Precautions

The check-first-as command applies to all EBGP peers, whereas the peer check-first-as command applies to a specified peer.

Example

# Enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-vpn1] peer 10.1.1.1 check-first-as enable

peer check-first-as (BGP-VPN instance IPv4 address family view) (group)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

Format

peer group-name check-first-as enable

peer group-name check-first-as disable

undo peer group-name check-first-as enable

undo peer group-name check-first-as disable

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path carried in the Update messages sent by a specified EBGP peer group is the same as the AS where the EBGP peer group resides. If the two AS numbers are different, the update information is rejected. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path carried in the Update messages sent by a specified EBGP peer group. That is, BGP accepts the Update messages even if the first AS number is not the AS number of the EBGP peer group. This undo command deletes the configurations of a specified EBGP peer group and restores the default settings.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

Run the refresh bgp command if you want to check the received routes again.

Precautions

The check-first-as command applies to all EBGP peers, whereas the peer check-first-as command applies to a specified peer.

Example

# Enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test external
[HUAWEI-bgp-vpn1] peer test check-first-as enable

peer check-first-as (BGP-VPN instance IPv6 address family view) (group)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

Format

peer group-name check-first-as enable

peer group-name check-first-as disable

undo peer group-name check-first-as enable

undo peer group-name check-first-as disable

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path carried in the Update messages sent by a specified EBGP peer group is the same as the AS where the EBGP peer group resides. If the two AS numbers are different, the update information is rejected. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path carried in the Update messages sent by a specified EBGP peer group. That is, BGP accepts the Update messages even if the first AS number is not the AS number of the EBGP peer group. This undo command deletes the configurations of a specified EBGP peer group and restores the default settings.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

After the check function is enabled, to enable the device to perform a check on received update messages, run the refresh bgp command.

Precautions

The check-first-as command applies to all EBGP peers, whereas the peer check-first-as command applies to a specified peer.

Example

# Enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test check-first-as enable

peer check-first-as (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

Format

peer ipv6-address check-first-as enable

peer ipv6-address check-first-as disable

undo peer ipv6-address check-first-as enable

undo peer ipv6-address check-first-as disable

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer is the AS where the EBGP peer resides. If the two AS numbers are different, the Update message is denied. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer. That is, BGP accepts the Update message even if the first AS number is not the AS number of the EBGP peer. This undo command deletes the configuration of the specified EBGP peer and restores the default configuration.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

After the check function is enabled, to enable the device to perform a check on received update messages, run the refresh bgp command.

Precautions

The check-first-as command applies to all EBGP peers, whereas the peer check-first-as command applies to a specified peer.

Example

# In the BGP-VPN instance IPv6 address family view, enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vrf1
[HUAWEI-vpn-instance-vrf1] ipv6-family
[HUAWEI-vpn-instance-vrf1-af-ipv6] quit
[HUAWEI-vpn-instance-vrf1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vrf1
[HUAWEI-bgp-6-vrf1] peer 2001:db8:9:1::2 as-number 200
[HUAWEI-bgp-6-vrf1] peer 2001:db8:9:1::2 check-first-as enable

peer check-first-as (BGP-VPN instance view)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

Format

peer ipv4-address check-first-as enable

peer ipv4-address check-first-as disable

undo peer ipv4-address check-first-as enable

undo peer ipv4-address check-first-as disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer is the AS where the EBGP peer resides. If the two AS numbers are different, the Update message is denied. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer. That is, BGP accepts the Update message even if the first AS number is not the AS number of the EBGP peer. This undo command deletes the configuration of the specified EBGP peer and restores the default configuration.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

Run the refresh bgp command if you want to check the received routes again.

Precautions

The check-first-as command applies to all EBGP peers, whereas the peer check-first-as command applies to a specified peer.

Example

# Enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 check-first-as enable

peer check-first-as (BGP-VPN instance view) (group)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

Format

peer group-name check-first-as enable

peer group-name check-first-as disable

undo peer group-name check-first-as enable

undo peer group-name check-first-as disable

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path carried in the Update messages sent by a specified EBGP peer group is the same as the AS where the EBGP peer group resides. If the two AS numbers are different, the update information is rejected. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path carried in the Update messages sent by a specified EBGP peer group. That is, BGP accepts the Update messages even if the first AS number is not the AS number of the EBGP peer group. This undo command deletes the configurations of a specified EBGP peer group and restores the default settings.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

Run the refresh bgp command if you want to check the received routes again.

Precautions

The check-first-as command applies to all EBGP peers, whereas the peer check-first-as command applies to a specified peer.

Example

# Enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test external
[HUAWEI-bgp-instance-vpn1] peer test check-first-as enable

peer check-first-as (BGP-VPN instance view) (IPv6)

Function

The peer check-first-as enable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The peer check-first-as disable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as enable command disables a device from checking the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

The undo peer check-first-as disable command enables a device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.

By default, a device checks the first AS number in the AS_Path attribute contained in the update messages received from all EBGP peers or peer groups.

Format

peer ipv6-address check-first-as enable

peer ipv6-address check-first-as disable

undo peer ipv6-address check-first-as enable

undo peer ipv6-address check-first-as disable

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the peer check-first-as enable command is run, BGP checks whether the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer is the AS where the EBGP peer resides. If the two AS numbers are different, the Update message is denied. If the peer check-first-as disable command is run, BGP does not check the first AS number in the AS_Path list carried in the Update message sent by a specified EBGP peer. That is, BGP accepts the Update message even if the first AS number is not the AS number of the EBGP peer. This undo command deletes the configuration of the specified EBGP peer and restores the default configuration.

The check on the first AS number in the AS_Path attribute of each received Update message can be configured for a specified EBGP peer, the peer group that the EBGP peer belongs to, or the entire BGP process. The configuration takes effect in descending order of priority as follows: EBGP peer > peer group > entire BGP process.

Follow-up Procedure

Run the refresh bgp command if you want to check the received routes again.

Precautions

The check-first-as command applies to all EBGP peers, whereas the peer check-first-as command applies to a specified peer.

Example

# Enable the device to check the first AS number in the AS_Path attribute contained in the update messages received from a specified EBGP peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 check-first-as enable

peer connect-interface (BGP multi-instance view) (group)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name connect-interface { interface-name | ipv4-source-addr | interface-type interface-number | interface-name ipv4-source-addr | interface-type interface-number ipv4-source-addr }

undo peer group-name connect-interface

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

interface-name

Specifies an interface name.

-

ipv4-source-addr

Specifies an IPv4 source address used for establishing a connection.

It is in dotted decimal notation.

interface-type

Specifies an interface type.

-

interface-number

Specifies an interface number.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

It is recommended that you run the peer connect-interface command when two devices establish multiple peer groups through multiple links.

If a physical interface is configured with multiple IP addresses, you must specify ipv4-source-address in the peer connect-interface command.

Prerequisites

A peer group has been established using the peer as-number command.

Configuration Impact

After the peer connect-interface or undo peer connect-interface command is run, the peer session is disconnected and then re-established.

BGP in all address families on a device shares a TCP connection. Therefore, the connect-interface information configured in the BGP view can be inherited in both the IPv4 unicast address family and VPNv4 address family.

Precautions

To enable a device to send BGP packets even if its physical interface fails, you can configure the device to use a loopback interface as the source interface of the BGP packets. When configure a device to use a loopback interface as the source interface of BGP packets, note the following points:

  • The loopback interface of the device's BGP peer must be reachable.
  • In the case of an EBGP connection, the peer ebgp-max-hop command needs to be run to enable the two devices to establish an indirect peer relationship.

    NOTE:

    If the specified interface borrows the IP address of another interface and then the IP address of the specified interface is changed, BGP still uses the borrowed IP address to keep the connection if no connection reestablishment is triggered, and data receiving and sending is not affected; if connection reestablishment is triggered, BGP uses the new IP address to reestablish the connection.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] interface LoopBack 0
[HUAWEI-LoopBack0] ip address 10.1.1.1 32
[HUAWEI-LoopBack0] quit
[HUAWEI] bgp 100 instanc a
[HUAWEI-bgp-instance-a] group test
[HUAWEI-bgp-instance-a] peer test connect-interface LoopBack 0

peer connect-interface (BGP multi-instance view)(IPv4)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address connect-interface { interface-name | ipv4-source-address | interface-type interface-number | interface-name ipv4-source-address | interface-type interface-number ipv4-source-address }

undo peer ipv4-address connect-interface

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

interface-name

Specifies the name of an interface.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

ipv4-source-address

Specifies an IPv4 source address used for establishing a connection.

The value is in dotted decimal notation.

interface-type

Specifies an interface type.

-

interface-number

Specifies an interface number.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the peer connect-interface command to establish multiple peer relationships between two devices by using multiple links is recommended.

If the physical interface has multiple IP addresses, the parameter ipv4-source-address must be in the command peer connect-interface.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

After the peer connect-interface or undo peer connect-interface command is run, the peer session is disconnected and then re-established.

BGP in all address families on a device shares a TCP connection. Therefore, the connect-interface information configured in the BGP view can be inherited in both the IPv4 unicast address family and VPNv4 address family.

Precautions

To enable a device to send BGP packets even if its physical interface fails, you can configure the device to use a loopback interface as the source interface of the BGP packets. When configure a device to use a loopback interface as the source interface of BGP packets, note the following points:

  • The loopback interface of the device's BGP peer must be reachable.
  • In the case of an EBGP connection, the peer ebgp-max-hop command needs to be run to enable the two devices to establish an indirect peer relationship.

    NOTE:

    If the specified interface borrows the IP address of another interface and then the IP address of the specified interface is changed, BGP still uses the borrowed IP address to keep the connection if no connection reestablishment is triggered, and data receiving and sending is not affected; if connection reestablishment is triggered, BGP uses the new IP address to reestablish the connection.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] interface LoopBack 0
[HUAWEI-LoopBack0] ip address 10.1.1.1 32
[HUAWEI-LoopBack0] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 10.1.1.1 connect-interface LoopBack 0

peer connect-interface (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name connect-interface { interface-name | ipv4-source-addr | interface-type interface-number | interface-name ipv4-source-addr | interface-type interface-number ipv4-source-addr }

undo peer group-name connect-interface

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

interface-name

Specifies an interface name.

-

ipv4-source-addr

Specifies an IPv4 source address used for establishing a connection.

The value is in dotted decimal notation.

interface-type

Specifies an interface type.

-

interface-number

Specifies an interface number.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

It is recommended that you run the peer connect-interface command when two devices establish multiple peer groups through multiple links.

If a physical interface is configured with multiple IP addresses, you must specify ipv4-source-address in the peer connect-interface command.

Prerequisites

A peer group has been established using the peer as-number command.

Configuration Impact

After the peer connect-interface or undo peer connect-interface command is run, the peer session is disconnected and then re-established.

BGP in all address families on a device shares a TCP connection. Therefore, the connect-interface information configured in the BGP view can be inherited in both the IPv4 unicast address family and VPNv4 address family.

Precautions

To enable a device to send BGP packets even if its physical interface fails, you can configure the device to use a loopback interface as the source interface of the BGP packets. When configure a device to use a loopback interface as the source interface of BGP packets, note the following points:

  • The loopback interface of the device's BGP peer must be reachable.
  • In the case of an EBGP connection, the peer ebgp-max-hop command needs to be run to enable the two devices to establish an indirect peer relationship.

    NOTE:

    If the specified interface borrows the IP address of another interface and then the IP address of the specified interface is changed, BGP still uses the borrowed IP address to keep the connection if no connection reestablishment is triggered, and data receiving and sending is not affected; if connection reestablishment is triggered, BGP uses the new IP address to reestablish the connection.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] interface LoopBack 0
[HUAWEI-LoopBack0] ip address 10.1.1.1 32
[HUAWEI-LoopBack0] quit
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test connect-interface LoopBack 0

peer connect-interface (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address connect-interface { interface-name | ipv4-source-address | interface-type interface-number | interface-name ipv4-source-address | interface-type interface-number ipv4-source-address }

undo peer ipv4-address connect-interface

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

interface-name

Specifies an interface name.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

ipv4-source-address

Specifies an IPv4 source address used for establishing a connection.

The value is in dotted decimal notation.

interface-type

Specifies an interface type.

-

interface-number

Specifies an interface number.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the peer connect-interface command to establish multiple peer relationships between two devices by using multiple links is recommended.

If the physical interface has multiple IP addresses, the parameter ipv4-source-address must be in the command peer connect-interface.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

After the peer connect-interface or undo peer connect-interface command is run, the peer session is disconnected and then re-established.

BGP in all address families on a device shares a TCP connection. Therefore, the connect-interface information configured in the BGP view can be inherited in both the IPv4 unicast address family and VPNv4 address family.

Precautions

To enable a device to send BGP packets even if its physical interface fails, you can configure the device to use a loopback interface as the source interface of the BGP packets. When configure a device to use a loopback interface as the source interface of BGP packets, note the following points:

  • The loopback interface of the device's BGP peer must be reachable.
  • In the case of an EBGP connection, the peer ebgp-max-hop command needs to be run to enable the two devices to establish an indirect peer relationship.

    NOTE:

    If the specified interface borrows the IP address of another interface and then the IP address of the specified interface is changed, BGP still uses the borrowed IP address to keep the connection if no connection reestablishment is triggered, and data receiving and sending is not affected; if connection reestablishment is triggered, BGP uses the new IP address to reestablish the connection.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] interface LoopBack 0
[HUAWEI-LoopBack0] ip address 10.1.1.1 32
[HUAWEI-LoopBack0] quit
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 connect-interface LoopBack 0

peer connect-interface (BGP view) (group)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

Format

peer group-name connect-interface { interface-name | ipv4-source-addr | ipv6-source-addr | interface-type interface-number | interface-name ipv4-source-addr | interface-name ipv6-source-addr | interface-type interface-number ipv4-source-addr | interface-type interface-number ipv6-source-addr }

undo peer group-name connect-interface

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

interface-name

Specifies an interface name.

-

ipv4-source-addr

Specifies an IPv4 source address used for establishing a connection.

The value is in dotted decimal notation.

ipv6-source-addr

Specifies an IPv6 source address used for establishing a connection.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

interface-type

Specifies an interface type.

-

interface-number

Specifies an interface number.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

It is recommended that you run the peer connect-interface command when two devices establish multiple peer groups through multiple links.

If a physical interface is configured with multiple IP addresses, you must specify ipv4-source-address in the peer connect-interface command.

Prerequisites

A peer group has been established using the peer as-number command.

Configuration Impact

After the peer connect-interface or undo peer connect-interface command is run, the peer session is disconnected and then re-established.

BGP in all address families on a device shares a TCP connection. Therefore, the connect-interface information configured in the BGP view can be inherited in both the IPv4 unicast address family and VPNv4 address family.

Precautions

To enable a device to send BGP packets even if its physical interface fails, you can configure the device to use a loopback interface as the source interface of the BGP packets. When configure a device to use a loopback interface as the source interface of BGP packets, note the following points:

  • The loopback interface of the device's BGP peer must be reachable.
  • In the case of an EBGP connection, the peer ebgp-max-hop command needs to be run to enable the two devices to establish an indirect peer relationship.

    NOTE:

    If the specified interface borrows the IP address of another interface and then the IP address of the specified interface is changed, BGP still uses the borrowed IP address to keep the connection if no connection reestablishment is triggered, and data receiving and sending is not affected; if connection reestablishment is triggered, BGP uses the new IP address to reestablish the connection.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] interface LoopBack 0
[HUAWEI-LoopBack0] ip address 10.1.1.1 32
[HUAWEI-LoopBack0] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test connect-interface LoopBack 0

peer connect-interface (BGP view) (IPv6)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

Format

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

undo peer ipv6-address connect-interface

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

interface-name

Specifies an interface name.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

ipv6-source-address

Specifies an IPv6 source address used for establishing a connection.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

interface-type

Specifies an interface type.

-

interface-number

Specifies an interface number.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the peer connect-interface command to establish multiple peer relationships between two devices by using multiple links is recommended.

If the physical interface has multiple IP addresses, the parameter ipv6-source-address is must in the command peer connect-interface.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

After the peer connect-interface or undo peer connect-interface command is run, the peer session is disconnected and then re-established.

BGP in all address families on a device shares a TCP connection. Therefore, the connect-interface information configured in the BGP view can be inherited in both the IPv4 unicast address family and VPNv4 address family.

Precautions

To enable a device to send BGP packets even if its physical interface fails, you can configure the device to use a loopback interface as the source interface of the BGP packets. When configure a device to use a loopback interface as the source interface of BGP packets, note the following points:

  • The loopback interface of the device's BGP peer must be reachable.
  • In the case of an EBGP connection, the peer ebgp-max-hop command needs to be run to enable the two devices to establish an indirect peer relationship.

    NOTE:

    If the specified interface borrows the IP address of another interface and then the IP address of the specified interface is changed, BGP still uses the borrowed IP address to keep the connection if no connection reestablishment is triggered, and data receiving and sending is not affected; if connection reestablishment is triggered, BGP uses the new IP address to reestablish the connection.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] interface LoopBack 0
[HUAWEI-LoopBack0] ip address 10.1.1.1 32
[HUAWEI-LoopBack0] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] peer 2001:DB8:1::1 connect-interface LoopBack 0

peer connect-interface (BGP view)(IPv4)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

Format

peer ipv4-address connect-interface { interface-name | ipv4-source-address | interface-type interface-number | interface-name ipv4-source-address | interface-type interface-number ipv4-source-address }

undo peer ipv4-address connect-interface

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

interface-name

Specifies an interface name.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

ipv4-source-address

Specifies an IPv4 source address used for establishing a connection.

The value is in dotted decimal notation.

interface-type

Specifies an interface type.

-

interface-number

Specifies an interface number.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the peer connect-interface command to establish multiple peer relationships between two devices by using multiple links is recommended.

If the physical interface has multiple IP addresses, the parameter ipv4-source-address must be in the command peer connect-interface.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

After the peer connect-interface or undo peer connect-interface command is run, the peer session is disconnected and then re-established.

BGP in all address families on a device shares a TCP connection. Therefore, the connect-interface information configured in the BGP view can be inherited in both the IPv4 unicast address family and VPNv4 address family.

Precautions

To enable a device to send BGP packets even if its physical interface fails, you can configure the device to use a loopback interface as the source interface of the BGP packets. When configure a device to use a loopback interface as the source interface of BGP packets, note the following points:

  • The loopback interface of the device's BGP peer must be reachable.
  • In the case of an EBGP connection, the peer ebgp-max-hop command needs to be run to enable the two devices to establish an indirect peer relationship.

    NOTE:

    If the specified interface borrows the IP address of another interface and then the IP address of the specified interface is changed, BGP still uses the borrowed IP address to keep the connection if no connection reestablishment is triggered, and data receiving and sending is not affected; if connection reestablishment is triggered, BGP uses the new IP address to reestablish the connection.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] interface LoopBack 0
[HUAWEI-LoopBack0] ip address 10.1.1.1 32
[HUAWEI-LoopBack0] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 connect-interface LoopBack 0

peer connect-interface (BGP-VPN instance IPv4 address family view) (group)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

Format

peer group-name connect-interface { interface-name | ipv4-source-addr | interface-type interface-number | interface-name ipv4-source-addr | interface-type interface-number ipv4-source-addr }

undo peer group-name connect-interface

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

interface-name

Specifies an interface name.

-

ipv4-source-addr

Specifies an IPv4 source address used for establishing a connection.

The value is in dotted decimal notation.

interface-type

Specifies an interface type.

-

interface-number

Specifies the number of an interface.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

It is recommended that you run the peer connect-interface command when two devices establish multiple peer groups through multiple links.

If a physical interface is configured with multiple IP addresses, you must specify ipv4-source-address in the peer connect-interface command.

Prerequisites

A peer group has been established using the peer as-number command.

Configuration Impact

After the peer connect-interface or undo peer connect-interface command is run, the peer session is disconnected and then re-established.

BGP in all address families on a device shares a TCP connection. Therefore, the connect-interface information configured in the BGP view can be inherited in both the IPv4 unicast address family and VPNv4 address family.

Precautions

To enable a device to send BGP packets even if its physical interface fails, you can configure the device to use a loopback interface as the source interface of the BGP packets. When configure a device to use a loopback interface as the source interface of BGP packets, note the following points:

  • The loopback interface of the device's BGP peer must be reachable.
  • In the case of an EBGP connection, the peer ebgp-max-hop command needs to be run to enable the two devices to establish an indirect peer relationship.

    NOTE:

    If the specified interface borrows the IP address of another interface and then the IP address of the specified interface is changed, BGP still uses the borrowed IP address to keep the connection if no connection reestablishment is triggered, and data receiving and sending is not affected; if connection reestablishment is triggered, BGP uses the new IP address to reestablish the connection.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] interface LoopBack 0
[HUAWEI-LoopBack0] ip address 1.1.1.1 32
[HUAWEI-LoopBack0] quit
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test
[HUAWEI-bgp-vpn1] peer test connect-interface LoopBack 0

peer connect-interface (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

Format

peer ipv4-address connect-interface { interface-name | ipv4-source-address | interface-type interface-number | interface-name ipv4-source-address | interface-type interface-number ipv4-source-address }

undo peer ipv4-address connect-interface

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

interface-name

Specifies an interface name.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

ipv4-source-address

Specifies an IPv4 source address used for establishing a connection.

The value is in dotted decimal notation.

interface-type

Specifies an interface type.

-

interface-number

Specifies the number of an interface.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the peer connect-interface command to establish multiple peer relationships between two devices by using multiple links is recommended.

If the physical interface has multiple IP addresses, the parameter ipv4-source-address must be in the command peer connect-interface.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

After the peer connect-interface or undo peer connect-interface command is run, the peer session is disconnected and then re-established.

BGP in all address families on a device shares a TCP connection. Therefore, the connect-interface information configured in the BGP view can be inherited in both the IPv4 unicast address family and VPNv4 address family.

Precautions

To enable a device to send BGP packets even if its physical interface fails, you can configure the device to use a loopback interface as the source interface of the BGP packets. When configure a device to use a loopback interface as the source interface of BGP packets, note the following points:

  • The loopback interface of the device's BGP peer must be reachable.
  • In the case of an EBGP connection, the peer ebgp-max-hop command needs to be run to enable the two devices to establish an indirect peer relationship.

    NOTE:

    If the specified interface borrows the IP address of another interface and then the IP address of the specified interface is changed, BGP still uses the borrowed IP address to keep the connection if no connection reestablishment is triggered, and data receiving and sending is not affected; if connection reestablishment is triggered, BGP uses the new IP address to reestablish the connection.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] interface LoopBack 0
[HUAWEI-LoopBack0] ip address 10.1.1.1 32
[HUAWEI-LoopBack0] quit
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 connect-interface LoopBack 0

peer connect-interface (BGP-VPN instance IPv6 address family view) (group)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

Format

peer group-name connect-interface { interface-name | interface-type interface-number | ipv6-source-addr | interface-name ipv6-source-addr | interface-type interface-number ipv6-source-addr }

undo peer group-name connect-interface

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

interface-name

Specifies an interface name.

-

interface-type

Specifies an interface type.

-

interface-number

Specifies the number of an interface.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

ipv6-source-addr

Specifies an IPv6 source address used for establishing a connection.

The address is in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

It is recommended that you run the peer connect-interface command when two devices establish multiple peer groups through multiple links.

If a physical interface is configured with multiple IP addresses, you must specify ipv4-source-address in the peer connect-interface command.

Prerequisites

A peer group has been established using the peer as-number command.

Configuration Impact

After the peer connect-interface or undo peer connect-interface command is run, the peer session is disconnected and then re-established.

BGP in all address families on a device shares a TCP connection. Therefore, the connect-interface information configured in the BGP view can be inherited in both the IPv4 unicast address family and VPNv4 address family.

Precautions

To enable a device to send BGP packets even if its physical interface fails, you can configure the device to use a loopback interface as the source interface of the BGP packets. When configure a device to use a loopback interface as the source interface of BGP packets, note the following points:

  • The loopback interface of the device's BGP peer must be reachable.
  • In the case of an EBGP connection, the peer ebgp-max-hop command needs to be run to enable the two devices to establish an indirect peer relationship.

    NOTE:

    If the specified interface borrows the IP address of another interface and then the IP address of the specified interface is changed, BGP still uses the borrowed IP address to keep the connection if no connection reestablishment is triggered, and data receiving and sending is not affected; if connection reestablishment is triggered, BGP uses the new IP address to reestablish the connection.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] interface LoopBack 0
[HUAWEI-LoopBack0] ip address 10.1.1.1 32
[HUAWEI-LoopBack0] quit
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test connect-interface LoopBack 0

peer connect-interface (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

Format

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

undo peer ipv6-address connect-interface

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

interface-name

Specifies an interface name.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

ipv6-source-address

Specifies an IPv6 source address used for establishing a connection.

The value is in the format of X:X:X:X:X:X:X:X.

interface-type

Specifies an interface type.

-

interface-number

Specifies the number of an interface.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the peer connect-interface command to establish multiple peer relationships between two devices by using multiple links is recommended.

If the physical interface has multiple IP addresses, the parameter ipv6-source-address is must in the command peer connect-interface.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

After the peer connect-interface or undo peer connect-interface command is run, the peer session is disconnected and then re-established.

BGP in all address families on a device shares a TCP connection. Therefore, the connect-interface information configured in the BGP view can be inherited in both the IPv4 unicast address family and VPNv4 address family.

Precautions

To enable a device to send BGP packets even if its physical interface fails, you can configure the device to use a loopback interface as the source interface of the BGP packets. When configure a device to use a loopback interface as the source interface of BGP packets, note the following points:

  • The loopback interface of the device's BGP peer must be reachable.
  • In the case of an EBGP connection, the peer ebgp-max-hop command needs to be run to enable the two devices to establish an indirect peer relationship.

    NOTE:

    If the specified interface borrows the IP address of another interface and then the IP address of the specified interface is changed, BGP still uses the borrowed IP address to keep the connection if no connection reestablishment is triggered, and data receiving and sending is not affected; if connection reestablishment is triggered, BGP uses the new IP address to reestablish the connection.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] interface LoopBack 0
[HUAWEI-LoopBack0] ip address 10.1.1.1 32
[HUAWEI-LoopBack0] quit
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 connect-interface LoopBack 0

peer connect-interface (BGP-VPN instance view) (group)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

Format

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

undo peer group-name connect-interface

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

interface-name

Specifies an interface name.

-

ipv4-address

Specifies an IPv4 source address used for establishing a connection.

The value is in dotted decimal notation.

interface-type

Specifies an interface type.

-

interface-number

Specifies an interface number.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

It is recommended that you run the peer connect-interface command when two devices establish multiple peer groups through multiple links.

If a physical interface is configured with multiple IP addresses, you must specify ipv4-source-address in the peer connect-interface command.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test
[HUAWEI-bgp-instance-vpn1] peer test connect-interface LoopBack 1

peer connect-interface (BGP-VPN instance view) (IPv6)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

Format

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

undo peer ipv6-address connect-interface

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

interface-name

Specifies an interface name.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

ipv6-source-address

Specifies an IPv6 source address used for establishing a connection.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

interface-type

Specifies an interface type.

-

interface-number

Specifies an interface number.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the peer connect-interface command to establish multiple peer relationships between two devices by using multiple links is recommended.

If the physical interface has multiple IP addresses, the parameter ipv6-source-address is must in the command peer connect-interface.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

After the peer connect-interface or undo peer connect-interface command is run, the peer session is disconnected and then re-established.

BGP in all address families on a device shares a TCP connection. Therefore, the connect-interface information configured in the BGP view can be inherited in both the IPv4 unicast address family and VPNv4 address family.

Precautions

To enable a device to send BGP packets even if its physical interface fails, you can configure the device to use a loopback interface as the source interface of the BGP packets. When configure a device to use a loopback interface as the source interface of BGP packets, note the following points:

  • The loopback interface of the device's BGP peer must be reachable.
  • In the case of an EBGP connection, the peer ebgp-max-hop command needs to be run to enable the two devices to establish an indirect peer relationship.

    NOTE:

    If the specified interface borrows the IP address of another interface and then the IP address of the specified interface is changed, BGP still uses the borrowed IP address to keep the connection if no connection reestablishment is triggered, and data receiving and sending is not affected; if connection reestablishment is triggered, BGP uses the new IP address to reestablish the connection.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 connect-interface LoopBack 1

peer connect-interface (BGP-VPN instance view)(IPv4)

Function

The peer connect-interface command specifies a source interface from which BGP packets are sent, and a source address used for initiating a connection.

The undo peer connect-interface command restores the default setting.

By default, the outbound interface of a BGP packet serves as the source interface of a BGP packet.

Format

peer ipv4-address connect-interface { interface-name | ipv4-source-address | interface-type interface-number | interface-name ipv4-source-address | interface-type interface-number ipv4-source-address }

undo peer ipv4-address connect-interface

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

interface-name

Specifies an interface name.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

ipv4-source-address

Specifies an IPv4 source address used for establishing a connection.

The value is in dotted decimal notation.

interface-type

Specifies an interface type.

-

interface-number

Specifies an interface number.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the peer connect-interface command to establish multiple peer relationships between two devices by using multiple links is recommended.

If the physical interface has multiple IP addresses, the parameter ipv4-source-address must be in the command peer connect-interface.

Prerequisites

Peer relationships have been established using the peer as-number command.

Configuration Impact

After the peer connect-interface or undo peer connect-interface command is run, the peer session is disconnected and then re-established.

BGP in all address families on a device shares a TCP connection. Therefore, the connect-interface information configured in the BGP view can be inherited in both the IPv4 unicast address family and VPNv4 address family.

Example

# Specify a source interface for sending BGP packets for initiating a connection.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 connect-interface LoopBack 1

peer default-route-advertise(BGP multi-instance VPN instance IPv4 address family view)(group)

Function

The peer default-route-advertise command configures a device to advertise default routes to a peer group.

The undo peer default-route-advertise command restores the default configuration.

By default, a BGP device does not advertise any default route to its peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name default-route-advertise [ route-policy route-policy-name ]

peer group-name default-route-advertise [ route-policy route-policy-name ] { conditional-route-match-all | conditional-route-match-any } { ipv4-address { mask-length | mask } } &<1-4>

undo peer group-name default-route-advertise

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

route-policy route-policy-name

Specifies the name of the route-policy.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

conditional-route-match-all

Configures the device to send the default route when all conditional routes are matched.

-

conditional-route-match-any

Configures the device to send the default route when any conditional route is matched.

-

ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

mask-length

Specifies the mask length of the conditional routes.

The value is an integer in the range from 0 to 32.

mask

Specifies the mask of the conditional routes.

It is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Default routes are usually used on networks with the following characteristics:

  • There are multiple EBGP peers, and full Internet routes are received from each peer.
  • There are multiple RRs, and each RR receives full Internet routes.

    If load balancing is not performed on a network, a BGP peer receives at most one copy of active full Internet routes. If load balancing is performed on a network, the number of active routes received by a BGP peer increases sharply, causing the number of routes on the network to sharply increase. In this case, you can configure the device to advertise default routes to BGP peer groups and use default routes for load balancing to reduce the number of routes on the network.

    This command does not require a default route in the routing table. Instead, the device unconditionally sends a default route with the next hop being itself to the peer group.

Precautions

This command enables the device to advertise the default route generated by itself, and condition-based matching is not used. Therefore, you are not advised to configure if-match clauses in a route-policy.

Example

# Configure a BGP device to advertise default routes to its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test default-route-advertise

peer default-route-advertise(BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer default-route-advertise command configures a device to advertise default routes to its peer.

The undo peer default-route-advertise command restores the default configuration.

By default, a BGP device does not advertise any default route to its peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr default-route-advertise [ route-policy route-policy-name ]

peer peerIpv4Addr default-route-advertise [ route-policy route-policy-name ] { conditional-route-match-all | conditional-route-match-any } { ipv4-address { mask-length | mask } } &<1-4>

undo peer peerIpv4Addr default-route-advertise

Parameters

Parameter Description Value
peerIpv4Addr

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

route-policy route-policy-name

Specifies the name of a route-policy.

The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

conditional-route-match-all

Configures the device to send the default route when all conditional routes are matched.

-

conditional-route-match-any

Configures the device to send the default route when any conditional route is matched.

-

ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

mask-length

Specifies the mask length of the conditional routes.

The value is an integer in the range from 0 to 32.

mask

Specifies the mask of the conditional routes.

It is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Default routes are usually used on networks with the following characteristics:

  • There are multiple EBGP peers, and full Internet routes are received from each peer.
  • There are multiple RRs, and each RR receives full Internet routes.

    If load balancing is not performed on a network, a BGP peer receives at most one copy of active full Internet routes. If load balancing is performed on a network, the number of active routes received by a BGP peer increases sharply, causing the number of routes on the network to sharply increase.On such a network, you can configure the device to advertise default routes to BGP peers and use default routes for load balancing to reduce the number of routes on the network.

    This command does not require that a default route exist in the routing table. Instead, the device unconditionally sends a default route with the next hop being itself to the peer.

Precautions

This command enables the device to advertise the default route generated by itself, and condition-based matching is not used. Therefore, you are not advised to configure if-match clauses in a route-policy.

Example

# Configure a BGP device to advertise default routes to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 default-route-advertise

peer default-route-advertise(BGP view)(group)

Function

The peer default-route-advertise command configures a device to advertise default routes to a peer group.

The undo peer default-route-advertise command restores the default configuration.

By default, an MBGP device does not advertise any default route to its peer group.

Format

peer group-name default-route-advertise [ route-policy route-policy-name ]

peer group-name default-route-advertise [ route-policy route-policy-name ] { conditional-route-match-all | conditional-route-match-any } { ipv4-address { mask-length | mask } } &<1-4>

undo peer group-name default-route-advertise

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

route-policy route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

conditional-route-match-all

The default routes are sent to the peer group only when all the conditional routes are matched.

-

conditional-route-match-any

The default routes are sent to the peer group if any conditional route is matched.

-

ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

mask-length

Specifies the mask length of the conditional routes.

The value is an integer ranging from 0 to 32.

mask

Specifies the mask of the conditional routes.

The value is in dotted decimal notation.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Default routes are usually used on networks with the following characteristics:

  • There are multiple EBGP peers, and full Internet routes are received from each peer.
  • There are multiple RRs, and each RR receives full Internet routes.

    If load balancing is not performed on a network, a BGP peer receives at most one copy of active full Internet routes. If load balancing is performed on a network, the number of active routes received by a BGP peer increases sharply, causing the number of routes on the network to sharply increase. In this case, you can configure the device to advertise default routes to BGP peer groups and use default routes for load balancing to reduce the number of routes on the network.

    This command does not require a default route in the routing table. Instead, the device unconditionally sends a default route with the next hop being itself to the peer group.

Precautions

This command enables the device to advertise the default route generated by itself, and condition-based matching is not used. Therefore, you are not advised to configure if-match clauses in a route-policy.

Example

# Configure a BGP device to advertise default routes to its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test default-route-advertise

peer default-route-advertise(BGP-IPv4 unicast address family view)(IPv4)

Function

The peer default-route-advertise command configures a device to advertise default routes to its peer.

The undo peer default-route-advertise command restores the default configuration.

By default, a BGP device does not advertise any default route to its peer.

Format

peer peerIpv4Addr default-route-advertise [ route-policy route-policy-name ]

peer peerIpv4Addr default-route-advertise [ route-policy route-policy-name ] { conditional-route-match-all | conditional-route-match-any } { ipv4-address { mask-length | mask } } &<1-4>

undo peer peerIpv4Addr default-route-advertise

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

It is in dotted decimal notation.

route-policy route-policy-name

Specifies the name of the route-policy.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

conditional-route-match-all

Configures the device to send the default route when all conditional routes are matched.

-

conditional-route-match-any

Configures the device to send the default route when any conditional route is matched.

-

ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

mask-length

Specifies the mask length of the conditional routes.

The value is an integer in the range from 0 to 32.

mask

Specifies the mask of the conditional routes.

It is in dotted decimal notation.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Default routes are usually used on networks with the following characteristics:

  • There are multiple EBGP peers, and full Internet routes are received from each peer.
  • There are multiple RRs, and each RR receives full Internet routes.

    If load balancing is not performed on a network, a BGP peer receives at most one copy of active full Internet routes. If load balancing is performed on a network, the number of active routes received by a BGP peer increases sharply, causing the number of routes on the network to sharply increase.On such a network, you can configure the device to advertise default routes to BGP peers and use default routes for load balancing to reduce the number of routes on the network.

    This command does not require that a default route exist in the routing table. Instead, the device unconditionally sends a default route with the next hop being itself to the peer.

Precautions

This command enables the device to advertise the default route generated by itself, and condition-based matching is not used. Therefore, you are not advised to configure if-match clauses in a route-policy.

Example

# Configure a BGP device to advertise default routes to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 default-route-advertise

peer default-route-advertise(BGP-IPv6 unicast address family view)(group)

Function

The peer default-route-advertise command configures a device to advertise default routes to a peer group.

The undo peer default-route-advertise command restores the default configuration.

By default, an MBGP device does not advertise any default route to its peer group.

Format

peer group-name default-route-advertise [ route-policy route-policy-name ]

peer group-name default-route-advertise [ route-policy route-policy-name ] { conditional-route-match-all | conditional-route-match-any } { ipv6-address mask-length } &<1-4>

undo peer group-name default-route-advertise

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

route-policy route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

conditional-route-match-all

Configures the device to send the default route when all conditional routes are matched.

-

conditional-route-match-any

Configures the device to send the default route when any conditional route is matched.

-

ipv6-address

Specifies the IPv6 address of a conditional route.

The value is in the format of X:X:X:X:X:X:X:X.

mask-length

Specifies the IPv6 mask length of a conditional route.

It is an integer ranging from 0 to 128.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Default routes are usually used on networks with the following characteristics:

  • There are multiple EBGP peers, and full Internet routes are received from each peer.
  • There are multiple RRs, and each RR receives full Internet routes.

    If load balancing is not performed on a network, a BGP peer receives at most one copy of active full Internet routes. If load balancing is performed on a network, the number of active routes received by a BGP peer increases sharply, causing the number of routes on the network to sharply increase. In this case, you can configure the device to advertise default routes to BGP peer groups and use default routes for load balancing to reduce the number of routes on the network.

    This command does not require a default route in the routing table. Instead, the device unconditionally sends a default route with the next hop being itself to the peer group.

Precautions

This command enables the device to advertise the default route generated by itself, and condition-based matching is not used. Therefore, you are not advised to configure if-match clauses in a route-policy.

Example

# Configure a BGP device to advertise default routes to its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test default-route-advertise

peer default-route-advertise(BGP-IPv6 unicast address family view)(IPv4)

Function

The peer default-route-advertise command configures a device to advertise default routes to its peer.

The undo peer default-route-advertise command restores the default configuration.

By default, a BGP device does not advertise any default route to its peer.

Format

peer ipv4-address default-route-advertise [ route-policy route-policy-name ]

peer ipv4-address default-route-advertise [ route-policy route-policy-name ] { conditional-route-match-all | conditional-route-match-any } { ipv6-address mask-length } &<1-4>

undo peer ipv4-address default-route-advertise

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

route-policy route-policy-name

Specifies the name of the route-policy.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. When double quotation marks are used around the string, spaces are allowed in the string.

conditional-route-match-all

The default routes are sent to the peer group only when all the conditional routes are matched.

-

conditional-route-match-any

Configures the device to send the default route when any conditional route is matched.

-

ipv6-address

Specifies the IPv6 address of the conditional routes.

The address is in the format of X:X:X:X:X:X:X:X.

mask-length

Specifies the IPv6 mask length of a conditional route.

It is an integer ranging from 0 to 128.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Default routes are usually used on networks with the following characteristics:

  • There are multiple EBGP peers, and full Internet routes are received from each peer.
  • There are multiple RRs, and each RR receives full Internet routes.

    If load balancing is not performed on a network, a BGP peer receives at most one copy of active full Internet routes. If load balancing is performed on a network, the number of active routes received by a BGP peer increases sharply, causing the number of routes on the network to sharply increase.On such a network, you can configure the device to advertise default routes to BGP peers and use default routes for load balancing to reduce the number of routes on the network.

    This command does not require that a default route exist in the routing table. Instead, the device unconditionally sends a default route with the next hop being itself to the peer.

Precautions

This command enables the device to advertise the default route generated by itself, and condition-based matching is not used. Therefore, you are not advised to configure if-match clauses in a route-policy.

Example

# Configure a BGP device to advertise default routes to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.2 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.2 default-route-advertise

peer default-route-advertise(BGP-IPv6 unicast address family view)(IPv6)

Function

The peer default-route-advertise command configures a device to advertise default routes to its peer.

The undo peer default-route-advertise command restores the default configuration.

By default, a BGP device does not advertise any default route to its peer.

Format

peer peerIpv6Addr default-route-advertise [ route-policy route-policy-name ]

peer peerIpv6Addr default-route-advertise [ route-policy route-policy-name ] { conditional-route-match-all | conditional-route-match-any } { ipv6-address ipv6-mask-length } &<1-4>

undo peer peerIpv6Addr default-route-advertise

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

route-policy route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

conditional-route-match-all

Configures the device to send the default route when all conditional routes are matched.

-

conditional-route-match-any

Configures the device to send the default route when any conditional route is matched.

-

ipv6-address

Specifies the IPv6 address of a conditional route.

The value is in the format of X:X:X:X:X:X:X:X.

ipv6-mask-length

Specifies the mask length of the conditional routes.

It is an integer ranging from 0 to 128.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Default routes are usually used on networks with the following characteristics:

  • There are multiple EBGP peers, and full Internet routes are received from each peer.
  • There are multiple RRs, and each RR receives full Internet routes.

    If load balancing is not performed on a network, a BGP peer receives at most one copy of active full Internet routes. If load balancing is performed on a network, the number of active routes received by a BGP peer increases sharply, causing the number of routes on the network to sharply increase.On such a network, you can configure the device to advertise default routes to BGP peers and use default routes for load balancing to reduce the number of routes on the network.

    This command does not require that a default route exist in the routing table. Instead, the device unconditionally sends a default route with the next hop being itself to the peer.

Precautions

This command enables the device to advertise the default route generated by itself, and condition-based matching is not used. Therefore, you are not advised to configure if-match clauses in a route-policy.

Example

# Configure a BGP device to advertise default routes to its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 default-route-advertise

peer default-route-advertise(BGP-VPN instance IPv4 address family view)(group)

Function

The peer default-route-advertise command configures a device to advertise default routes to a peer group.

The undo peer default-route-advertise command restores the default configuration.

By default, an MBGP device does not advertise any default route to its peer group.

Format

peer group-name default-route-advertise [ route-policy route-policy-name ]

peer group-name default-route-advertise [ route-policy route-policy-name ] { conditional-route-match-all | conditional-route-match-any } { ipv4-address { mask-length | mask } } &<1-4>

undo peer group-name default-route-advertise

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

route-policy route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

conditional-route-match-all

The default routes are sent to the peer group only when all the conditional routes are matched.

-

conditional-route-match-any

The default routes are sent to the peer group if any conditional route is matched.

-

ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

mask-length

Specifies the mask length of the conditional routes.

The value is an integer ranging from 0 to 32.

mask

Specifies the mask of the conditional routes.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Default routes are usually used on networks with the following characteristics:

  • There are multiple EBGP peers, and full Internet routes are received from each peer.
  • There are multiple RRs, and each RR receives full Internet routes.

    If load balancing is not performed on a network, a BGP peer receives at most one copy of active full Internet routes. If load balancing is performed on a network, the number of active routes received by a BGP peer increases sharply, causing the number of routes on the network to sharply increase. In this case, you can configure the device to advertise default routes to BGP peer groups and use default routes for load balancing to reduce the number of routes on the network.

    This command does not require a default route in the routing table. Instead, the device unconditionally sends a default route with the next hop being itself to the peer group.

Precautions

This command enables the device to advertise the default route generated by itself, and condition-based matching is not used. Therefore, you are not advised to configure if-match clauses in a route-policy.

Example

# Configure a BGP device to advertise default routes to its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test
[HUAWEI-bgp-vpn1] peer test default-route-advertise

peer default-route-advertise(BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer default-route-advertise command configures a device to advertise default routes to its peer.

The undo peer default-route-advertise command restores the default configuration.

By default, a BGP device does not advertise any default route to its peer.

Format

peer peerIpv4Addr default-route-advertise [ route-policy route-policy-name ]

peer peerIpv4Addr default-route-advertise [ route-policy route-policy-name ] { conditional-route-match-all | conditional-route-match-any } { ipv4-address { mask-length | mask } } &<1-4>

undo peer peerIpv4Addr default-route-advertise

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

route-policy route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

conditional-route-match-all

The default routes are sent to the peer group only when all the conditional routes are matched.

-

conditional-route-match-any

The default routes are sent to the peer group if any conditional route is matched.

-

ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

mask-length

Specifies the mask length of the conditional routes.

The value is an integer ranging from 0 to 32.

mask

Specifies the mask of the conditional routes.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Default routes are usually used on networks with the following characteristics:

  • There are multiple EBGP peers, and full Internet routes are received from each peer.
  • There are multiple RRs, and each RR receives full Internet routes.

    If load balancing is not performed on a network, a BGP peer receives at most one copy of active full Internet routes. If load balancing is performed on a network, the number of active routes received by a BGP peer increases sharply, causing the number of routes on the network to sharply increase.On such a network, you can configure the device to advertise default routes to BGP peers and use default routes for load balancing to reduce the number of routes on the network.

    This command does not require that a default route exist in the routing table. Instead, the device unconditionally sends a default route with the next hop being itself to the peer.

Precautions

This command enables the device to advertise the default route generated by itself, and condition-based matching is not used. Therefore, you are not advised to configure if-match clauses in a route-policy.

Example

# Configure a BGP device to advertise default routes to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 default-route-advertise

peer default-route-advertise(BGP-VPN instance IPv6 address family view)(group)

Function

The peer default-route-advertise command configures a device to advertise default routes to a peer group.

The undo peer default-route-advertise command restores the default configuration.

By default, a BGP device does not advertise any default route to its peer group.

Format

peer group-name default-route-advertise [ route-policy route-policy-name ]

peer group-name default-route-advertise [ route-policy route-policy-name ] { conditional-route-match-all | conditional-route-match-any } { ipv6-address mask-length } &<1-4>

undo peer group-name default-route-advertise

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

route-policy route-policy-name

Specifies the name of a route-policy.

The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

conditional-route-match-all

Configures the device to send the default route when all conditional routes are matched.

-

conditional-route-match-any

Configures the device to send the default route when any conditional route is matched.

-

ipv6-address

Specifies the IPv6 address of a conditional route.

The value is in the format of X:X:X:X:X:X:X:X.

mask-length

Specifies the IPv6 mask length of a conditional route.

It is an integer ranging from 0 to 128.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Default routes are usually used on networks with the following characteristics:

  • There are multiple EBGP peers, and full Internet routes are received from each peer.
  • There are multiple RRs, and each RR receives full Internet routes.

    If load balancing is not performed on a network, a BGP peer receives at most one copy of active full Internet routes. If load balancing is performed on a network, the number of active routes received by a BGP peer increases sharply, causing the number of routes on the network to sharply increase. In this case, you can configure the device to advertise default routes to BGP peer groups and use default routes for load balancing to reduce the number of routes on the network.

    This command does not require a default route in the routing table. Instead, the device unconditionally sends a default route with the next hop being itself to the peer group.

Precautions

This command enables the device to advertise the default route generated by itself, and condition-based matching is not used. Therefore, you are not advised to configure if-match clauses in a route-policy.

Example

# Configure a BGP device to advertise default routes to its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test default-route-advertise

peer default-route-advertise(BGP-VPN instance IPv6 address family view)(IPv6)

Function

The peer default-route-advertise command configures a device to advertise default routes to its peer.

The undo peer default-route-advertise command restores the default configuration.

By default, a BGP device does not advertise any default route to its peer.

Format

peer peerIpv6Addr default-route-advertise [ route-policy route-policy-name ]

peer peerIpv6Addr default-route-advertise [ route-policy route-policy-name ] { conditional-route-match-all | conditional-route-match-any } { ipv6-address mask-length } &<1-4>

undo peer peerIpv6Addr default-route-advertise

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

route-policy route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

conditional-route-match-all

Configures the device to send the default route when all conditional routes are matched.

-

conditional-route-match-any

Configures the device to send the default route when any conditional route is matched.

-

ipv6-address

Specifies the IPv6 address of a conditional route.

The value is in the format of X:X:X:X:X:X:X:X.

mask-length

Specifies the IPv6 mask length of a conditional route.

It is an integer ranging from 0 to 128.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Default routes are usually used on networks with the following characteristics:

  • There are multiple EBGP peers, and full Internet routes are received from each peer.
  • There are multiple RRs, and each RR receives full Internet routes.

    If load balancing is not performed on a network, a BGP peer receives at most one copy of active full Internet routes. If load balancing is performed on a network, the number of active routes received by a BGP peer increases sharply, causing the number of routes on the network to sharply increase.On such a network, you can configure the device to advertise default routes to BGP peers and use default routes for load balancing to reduce the number of routes on the network.

    This command does not require that a default route exist in the routing table. Instead, the device unconditionally sends a default route with the next hop being itself to the peer.

Precautions

This command enables the device to advertise the default route generated by itself, and condition-based matching is not used. Therefore, you are not advised to configure if-match clauses in a route-policy.

Example

# Configure a BGP device to advertise default routes to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 default-route-advertise

peer description(BGP multi-instance view)(group)

Function

The peer description command configures a description for a peer group.

The undo peer description command deletes the description of a peer group.

By default, no description is configured for a peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name description description-text

undo peer group-name description

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer group, which facilitates management of peers or peer groups. The description records information about the peer group, such as the VPN instance to which the peer group belongs, and devices that establish peer relationships with the peer group.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the command is run multiple times to configure a description for a peer, the latest configuration overwrites the previous one.

Follow-up Procedure

Run the display bgp peer verbose command to view the description of a peer configured using the peer description command.

Example

# Configure a description for a peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100 instanc a
[HUAWEI-bgp-instance-a] group test
[HUAWEI-bgp-instance-a] peer test description ISP1

peer description(BGP multi-instance view)(IPv4)

Function

The peer description command configures a description for a peer.

The undo peer description command deletes the description of a peer.

By default, no description is configured for a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address description description-text

undo peer ipv4-address description

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer, which facilitates management of peers or peer groups. The description records information about the peer, such as the VPN instance to which the peer belongs, and devices that establish peer relationships with the peer.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the command is run multiple times to configure a description for a peer, the latest configuration overwrites the previous one.

Follow-up Procedure

Run the display bgp peer verbose command to view the description of a peer configured using the peer description command.

Example

# Configure a description for a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 10.1.1.1 description ISP1

peer description(BGP multi-instance VPN instance IPv4 address family view)(group)

Function

The peer description command configures a description for a peer group.

The undo peer description command deletes the description of a peer group.

By default, no description is configured for a peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name description description-text

undo peer group-name description

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer group, which facilitates management of peers or peer groups. The description records information about the peer group, such as the VPN instance to which the peer group belongs, and devices that establish peer relationships with the peer group.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the command is run multiple times to configure a description for a peer, the latest configuration overwrites the previous one.

Follow-up Procedure

Run the display bgp peer verbose command to view the description of a peer configured using the peer description command.

Example

# Configure a description for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group group1
[HUAWEI-bgp-instance-a-vpna] peer group1 description ISP1

peer description(BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer description command configures a description for a peer.

The undo peer description command deletes the description of a peer.

By default, no description is configured for a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address description description-text

undo peer ipv4-address description

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer, which facilitates management of peers or peer groups. The description records information about the peer, such as the VPN instance to which the peer belongs, and devices that establish peer relationships with the peer.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the peer description command is run multiple times to configure a description for a peer, the latest configuration overwrites the previous one.

Follow-up Procedure

You can run display bgp peer verbose command can be used to view the description of a peer.

Example

# Configure a description for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 description ISP1

peer description(BGP view)(group)

Function

The peer description command configures a description for a peer group.

The undo peer description command deletes the description of a peer group.

By default, no description is configured for a peer group.

Format

peer group-name description description-text

undo peer group-name description

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer group, which facilitates management of peers or peer groups. The description records information about the peer group, such as the VPN instance to which the peer group belongs, and devices that establish peer relationships with the peer group.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the command is run multiple times to configure a description for a peer, the latest configuration overwrites the previous one.

Follow-up Procedure

Run the display bgp peer verbose command to view the description of a peer configured using the peer description command.

Example

# Configure a description for a peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test description ISP1

peer description(BGP view)(IPv4)

Function

The peer description command configures a description for a peer.

The undo peer description command deletes the description of a peer.

By default, no description is configured for a peer.

Format

peer ipv4-address description description-text

undo peer ipv4-address description

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer, which facilitates management of peers or peer groups. The description records information about the peer, such as the VPN instance to which the peer belongs, and devices that establish peer relationships with the peer.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the peer description command is run multiple times to configure a description for a peer, the latest configuration overwrites the previous one.

Follow-up Procedure

Run the display bgp peer verbose command to view the description of a peer configured using the peer description command.

Example

# Configure a description for a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 description ISP1

peer description(BGP view)(IPv6)

Function

The peer description command configures a description for a peer.

The undo peer description command deletes the description of a peer.

By default, no description is configured for a peer.

Format

peer ipv6-address description description-text

undo peer ipv6-address description

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer, which facilitates management of peers or peer groups. The description records information about the peer, such as the VPN instance to which the peer belongs, and devices that establish peer relationships with the peer.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the command is run multiple times to configure a description for a peer, the latest configuration overwrites the previous one.

Follow-up Procedure

Run the display bgp peer verbose command to view the description of a peer configured using the peer description command.

Example

# Configure a description for a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] peer 2001:DB8:1::1 description abc

peer description(BGP-VPN instance IPv4 address family view)(group)

Function

The peer description command configures a description for a peer group.

The undo peer description command deletes the description of a peer group.

By default, no description is configured for a peer group.

Format

peer group-name description description-text

undo peer group-name description

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer group, which facilitates management of peers or peer groups. The description records information about the peer group, such as the VPN instance to which the peer group belongs, and devices that establish peer relationships with the peer group.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the command is run multiple times to configure a description for a peer, the latest configuration overwrites the previous one.

Follow-up Procedure

Run the display bgp peer verbose command to view the description of a peer configured using the peer description command.

Example

# Configure a description for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test
[HUAWEI-bgp-vpn1] peer test description ISP1

peer description(BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer description command configures a description for a peer.

The undo peer description command deletes the description of a peer.

By default, no description is configured for a peer.

Format

peer ipv4-address description description-text

undo peer ipv4-address description

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer, which facilitates management of peers or peer groups. The description records information about the peer, such as the VPN instance to which the peer belongs, and devices that establish peer relationships with the peer.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the command is run multiple times to configure a description for a peer, the latest configuration overwrites the previous one.

Follow-up Procedure

Run the display bgp peer verbose command to view the description of a peer configured using the peer description command.

Example

# Configure a description for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 description ISP1

peer description(BGP-VPN instance IPv6 address family view)(group)

Function

The peer description command configures a description for a peer group.

The undo peer description command deletes the description of a peer group.

By default, no description is configured for a peer group.

Format

peer group-name description description-text

undo peer group-name description

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer group, which facilitates management of peers or peer groups. The description records information about the peer group, such as the VPN instance to which the peer group belongs, and devices that establish peer relationships with the peer group.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the peer description command is run multiple times to configure a description for a peer group, the latest configuration overwrites the previous one.

Follow-up Procedure

You can run display bgp peer verbose command can be used to view the description of a peer.

Example

# Configure a description for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test description ISP1

peer description(BGP-VPN instance IPv6 address family view)(IPv6)

Function

The peer description command configures a description for a peer.

The undo peer description command deletes the description of a peer.

By default, no description is configured for a peer.

Format

peer ipv6-address description description-text

undo peer ipv6-address description

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The prefix is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer, which facilitates management of peers or peer groups. The description records information about the peer, such as the VPN instance to which the peer belongs, and devices that establish peer relationships with the peer.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the peer description command is run multiple times to configure a description for a peer, the latest configuration overwrites the previous one.

Follow-up Procedure

You can run display bgp peer verbose command can be used to view the description of a peer.

Example

# Configure a description for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 description ISP1

peer description(BGP-VPN instance view)(group)

Function

The peer description command configures a description for a peer group.

The undo peer description command deletes the description of a peer group.

By default, no description is configured for a peer group.

Format

peer group-name description description-text

undo peer group-name description

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer group, which facilitates management of peers or peer groups. The description records information about the peer group, such as the VPN instance to which the peer group belongs, and devices that establish peer relationships with the peer group.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the command is run multiple times to configure a description for a peer, the latest configuration overwrites the previous one.

Follow-up Procedure

Run the display bgp peer verbose command to view the description of a peer configured using the peer description command.

Example

# Configure a description for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test
[HUAWEI-bgp-instance-vpn1] peer test description ISP1

peer description(BGP-VPN instance view)(IPv4)

Function

The peer description command configures a description for a peer.

The undo peer description command deletes the description of a peer.

By default, no description is configured for a peer.

Format

peer ipv4-address description description-text

undo peer ipv4-address description

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer, which facilitates management of peers or peer groups. The description records information about the peer, such as the VPN instance to which the peer belongs, and devices that establish peer relationships with the peer.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the command is run multiple times to configure a description for a peer, the latest configuration overwrites the previous one.

Follow-up Procedure

Run the display bgp peer verbose command to view the description of a peer configured using the peer description command.

Example

# Configure a description for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 description ISP1

peer description(BGP-VPN instance view)(IPv6)

Function

The peer description command configures a description for a peer.

The undo peer description command deletes the description of a peer.

By default, no description is configured for a peer.

Format

peer ipv6-address description description-text

undo peer ipv6-address description

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

description-text

Specifies a description.

The value is a string of 1 to 255 characters. Letters, digits, and spaces are supported.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer description can be used to configure a description for a peer, which facilitates management of peers or peer groups. The description records information about the peer, such as the VPN instance to which the peer belongs, and devices that establish peer relationships with the peer.

Implementation Procedure

The description configured by using the peer description command for a peer is displayed from the first non-space character.

Configuration Impact

If the command is run multiple times to configure a description for a peer, the latest configuration overwrites the previous one.

Follow-up Procedure

Run the display bgp peer verbose command to view the description of a peer configured using the peer description command.

Example

# Configure a description for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 description abc

peer discard-ext-community(BGP multi-instance VPN instance IPv4 address family view)(group)

Function

The peer discard-ext-community command configures a BGP device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name discard-ext-community

undo peer group-name discard-ext-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the device only needs to accept the routes received from a peer group but not the extended community attributes, you can run this command on the peer group to discard the extended community attributes in the received routing information.

Example

# Configure a BGP device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test discard-ext-community

peer discard-ext-community(BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer discard-ext-community command configures a BGP device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address discard-ext-community

undo peer ipv4-address discard-ext-community

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer only needs to accepts routes but not extended community attributes, you can run this command on the peer to discard the extended community attributes from the received routes.

Example

# Configure a BGP device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 discard-ext-community

peer discard-ext-community(BGP multi-instance VPN instance IPv6 address family view)(group)

Function

The peer discard-ext-community command configures a device to discard the extended community attributes carried in routes of a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name discard-ext-community

undo peer group-name discard-ext-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP multi-instance VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the device only needs to accept the routes received from a peer group but not the extended community attributes, you can run this command on the peer group to discard the extended community attributes in the received routing information.

Example

# Configure the device to discard the extended community attributes carried in routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance aaa
[HUAWEI-bgp-instance-aaa] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-instance-aaa-6-vpn1] group test external
[HUAWEI-bgp-instance-aaa-6-vpn1] peer test as-number 200
[HUAWEI-bgp-instance-aaa-6-vpn1] peer test discard-ext-community

peer discard-ext-community(BGP multi-instance VPN instance IPv6 address family view)(IPv6)

Function

The peer discard-ext-community command configures a BGP device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv6-address discard-ext-community

undo peer ipv6-address discard-ext-community

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP multi-instance VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer only needs to accepts routes but not extended community attributes, you can run this command on the peer to discard the extended community attributes from the received routes.

Example

# Configure a BGP device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100 instance test
[HUAWEI-bgp-instance-test] ipv6-family vpn-instance vpna
[HUAWEI-bgp-instance-test-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-instance-test-6-vpna] peer 2001:DB8:1::1 discard-ext-community

peer discard-ext-community(BGP view)(group)

Function

The peer discard-ext-community command configures a BGP device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

Format

peer group-name discard-ext-community

undo peer group-name discard-ext-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the device only needs to accept the routes received from a peer group but not the extended community attributes, you can run this command on the peer group to discard the extended community attributes in the received routing information.

Example

# Configure the device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test discard-ext-community

peer discard-ext-community(BGP view)(IPv4)

Function

The peer discard-ext-community command configures a BGP device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

Format

peer ipv4-address discard-ext-community

undo peer ipv4-address discard-ext-community

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer only needs to accepts routes but not extended community attributes, you can run this command on the peer to discard the extended community attributes from the received routes.

Example

# Configure the device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 discard-ext-community

peer discard-ext-community(BGP-IPv4 unicast address family view)(group)

Function

The peer discard-ext-community command configures a BGP device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

Format

peer group-name discard-ext-community

undo peer group-name discard-ext-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the device only needs to accept the routes received from a peer group but not the extended community attributes, you can run this command on the peer group to discard the extended community attributes in the received routing information.

Example

# Configure the device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test discard-ext-community

peer discard-ext-community(BGP-IPv4 unicast address family view)(IPv4)

Function

The peer discard-ext-community command configures a BGP device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

Format

peer ipv4-address discard-ext-community

undo peer ipv4-address discard-ext-community

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer only needs to accepts routes but not extended community attributes, you can run this command on the peer to discard the extended community attributes from the received routes.

Example

# Configure a BGP device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 discard-ext-community

peer discard-ext-community(BGP-IPv6 unicast address family view)(group)

Function

The peer discard-ext-community command configures a BGP device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

Format

peer group-name discard-ext-community

undo peer group-name discard-ext-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the device only needs to accept the routes received from a peer group but not the extended community attributes, you can run this command on the peer group to discard the extended community attributes in the received routing information.

Example

# Configure a BGP device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test discard-ext-community

peer discard-ext-community(BGP-IPv6 unicast address family view)(IPv4)

Function

The peer discard-ext-community command configures a BGP device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

Format

peer ipv4-address discard-ext-community

undo peer ipv4-address discard-ext-community

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer only needs to accepts routes but not extended community attributes, you can run this command on the peer to discard the extended community attributes from the received routes.

Example

# Configure a BGP device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 discard-ext-community

peer discard-ext-community(BGP-IPv6 unicast address family view)(IPv6)

Function

The peer discard-ext-community command configures a BGP device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

Format

peer ipv6-address discard-ext-community

undo peer ipv6-address discard-ext-community

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer only needs to accepts routes but not extended community attributes, you can run this command on the peer to discard the extended community attributes from the received routes.

Example

# Configure a BGP device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 discard-ext-community

peer discard-ext-community(BGP-VPN instance IPv4 address family view)(group)

Function

The peer discard-ext-community command configures a device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

Format

peer group-name discard-ext-community

undo peer group-name discard-ext-community

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the device only needs to accept the routes received from a peer group but not the extended community attributes, you can run this command on the peer group to discard the extended community attributes in the received routing information.

Example

# Configure a BGP device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test discard-ext-community

peer discard-ext-community(BGP-VPN instance IPv4 address family view/BGP-labeled VPN instance IPv4 address family view)

Function

The peer discard-ext-community command configures a device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

Format

peer ipv4-address discard-ext-community

undo peer ipv4-address discard-ext-community

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer only needs to accepts routes but not extended community attributes, you can run this command on the peer to discard the extended community attributes from the received routes.

Example

# Configure a BGP device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 1.1.1.1 discard-ext-community

peer discard-ext-community(BGP-VPN instance IPv6 address family view)(group)

Function

The peer discard-ext-community command configures a BGP device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

Format

peer peerGroupName discard-ext-community

undo peer peerGroupName discard-ext-community

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the device only needs to accept the routes received from a peer group but not the extended community attributes, you can run this command on the peer group to discard the extended community attributes in the received routing information.

Example

# Discard the BGP origin validation result of RPKI in routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] group test external
[HUAWEI-bgp-6-vpna] peer test discard-ext-community

peer discard-ext-community(BGP-VPN instance IPv6 address family view)(IPv4)

Function

The peer discard-ext-community command configures a BGP device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

Format

peer ipv4-address discard-ext-community

undo peer ipv4-address discard-ext-community

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer only needs to accepts routes but not extended community attributes, you can run this command on the peer to discard the extended community attributes from the received routes.

Example

# Configure a BGP device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 discard-ext-community

peer discard-ext-community(BGP-VPN instance IPv6 address family view)(IPv6)

Function

The peer discard-ext-community command configures a BGP device to discard the extended community attributes carried by routes received from a specified peer.

The undo peer discard-ext-community command cancels the configuration.

By default, the extended community attributes in the routing information of peers are not discarded.

Format

peer peerIpv6Addr discard-ext-community

undo peer peerIpv6Addr discard-ext-community

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer only needs to accepts routes but not extended community attributes, you can run this command on the peer to discard the extended community attributes from the received routes.

Precautions

peer discard-ext-community origin-as-validation takes effect only on EBGP peers.

Example

# Configure the device to discard the extended community attribute carried by a route.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:db8:1::1 as-number 200
[HUAWEI-bgp-6-vpna] peer 2001:db8:1::1 discard-ext-community

peer ebgp-max-hop (BGP multi-instance view) (group)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name ebgp-max-hop [ hop-count ]

undo peer group-name ebgp-max-hop

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer group to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] bgp 100 instanc a
[HUAWEI-bgp-instance-a] group test external
[HUAWEI-bgp-instance-a] peer test ebgp-max-hop

peer ebgp-max-hop (BGP multi-instance view) (IPv4)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address ebgp-max-hop [ hop-count ]

undo peer ipv4-address ebgp-max-hop

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-instance-a] peer 10.1.1.1 ebgp-max-hop

peer ebgp-max-hop (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name ebgp-max-hop [ hop-count ]

undo peer group-name ebgp-max-hop

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer group to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test external
[HUAWEI-bgp-instance-a-vpna] peer test ebgp-max-hop

peer ebgp-max-hop (BGP multi-instance VPN instance IPv4 address family view) (IPv4)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address ebgp-max-hop [ hop-count ]

undo peer ipv4-address ebgp-max-hop

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer with the IP address of to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 ebgp-max-hop

peer ebgp-max-hop (BGP view) (group)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

Format

peer group-name ebgp-max-hop [ hop-count ]

undo peer group-name ebgp-max-hop

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer group to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test ebgp-max-hop

peer ebgp-max-hop (BGP view) (IPv4)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

Format

peer ipv4-address ebgp-max-hop [ hop-count ]

undo peer ipv4-address ebgp-max-hop

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 ebgp-max-hop

peer ebgp-max-hop (BGP view) (IPv6)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

Format

peer ipv6-address ebgp-max-hop [ hop-count ]

undo peer ipv6-address ebgp-max-hop

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp] peer 2001:DB8:1::1 ebgp-max-hop

peer ebgp-max-hop (BGP-VPN instance IPv4 address family view) (group)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

Format

peer group-name ebgp-max-hop [ hop-count ]

undo peer group-name ebgp-max-hop

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer group to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test external
[HUAWEI-bgp-vpn1] peer test ebgp-max-hop

peer ebgp-max-hop (BGP-VPN instance IPv4 address family view) (IPv4)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

Format

peer ipv4-address ebgp-max-hop [ hop-count ]

undo peer ipv4-address ebgp-max-hop

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-vpn1] peer 10.1.1.1 ebgp-max-hop

peer ebgp-max-hop (BGP-VPN instance IPv6 address family view) (group)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

Format

peer group-name ebgp-max-hop [ hop-count ]

undo peer group-name ebgp-max-hop

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer group to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test ebgp-max-hop

peer ebgp-max-hop (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

Format

peer ipv6-address ebgp-max-hop [ hop-count ]

undo peer ipv6-address ebgp-max-hop

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 ebgp-max-hop

peer ebgp-max-hop (BGP-VPN instance view) (group)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

Format

peer group-name ebgp-max-hop [ hop-count ]

undo peer group-name ebgp-max-hop

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer group to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test external
[HUAWEI-bgp-instance-vpn1] peer test ebgp-max-hop

peer ebgp-max-hop (BGP-VPN instance view) (IPv4)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

Format

peer ipv4-address ebgp-max-hop [ hop-count ]

undo peer ipv4-address ebgp-max-hop

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 ebgp-max-hop

peer ebgp-max-hop (BGP-VPN instance view) (IPv6)

Function

The peer ebgp-max-hop command configures a BGP device to establish an EBGP peer relationship with a peer on an indirectly-connected network and set the maximum number of hops between the two devices.

The undo peer ebgp-max-hop command cancels the existing configuration.

By default, an EBGP connection can be set up only on a directly-connected physical link.

Format

peer ipv6-address ebgp-max-hop [ hop-count ]

undo peer ipv6-address ebgp-max-hop

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

hop-count

Specifies the maximum number of hops.

The value is an integer ranging from 1 to 255. By default, the maximum number of hops in an EBGP connection is 1. If the specified maximum number of hops is 1, EBGP connection cannot be established between non-directly connected devices. If hop-count is not specified in the peer ebgp-max-hop command, 255 is used as the maximum number of hops in EBGP connections.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a directly connected physical link must be available between EBGP peers. If a directly connected physical link is unavailable, the peer ebgp-max-hop command must be used to allow EBGP peers to establish a multi-hop connection.

If loopback interfaces are used to establish an EBGP peer relationship, the peer ebgp-max-hop command (hop-count ≥ 2) must be run. Otherwise, the EBGP peer relationship cannot be established.

Precautions

If the peer ebgp-max-hop command is used on one end of an EBGP connection, it must also be used on the other end.

The configurations of GTSM and EBGP-MAX-HOP affect the TTL values of sent BGP packets, and the configurations of the two functions are mutually exclusive.

Example

# Allow indirectly connected EBGP peer to establish a connection with the local device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 ebgp-max-hop

peer enable (BGP view) (group)

Function

The peer enable command enables a device to exchange routing information with a specified peer group in the address family view.

The undo peer enable command disables a device from exchanging routes with a specified peer group.

By default, a device is disabled from exchanging routing information with a specified peer group.

Format

peer group-name enable

undo peer group-name enable

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the device is automatically enabled to exchange routing information only with peer groups in the BGP-IPv4 unicast address family. That is, after the peer as-number command is run in the BGP view, the system automatically configures the corresponding peer enable command. This function must be manually enabled in other address family views.

Configuration Impact

Enabling or disabling a BGP peer group in this address family causes the BGP connections of the peer group in other address families to be disconnected and automatically renegotiated.

Precautions

If a peer group has established peer relationships in another address family, running the peer enable command may disconnect and re-establish all peer relationships in the peer group, causing route flapping. Therefore, exercise caution when running this command.

Example

# Enable the device to exchange relevant routing information with a specified peer group in the address family view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer test enable

peer enable (BGP view) (IPv4)

Function

The peer enable command enables a BGP device to exchange routes with a specified peer in the address family view.

The undo peer enable command disables a BGP device from exchanging routes with a specified peer.

By default, a device is disabled from exchanging routing information with a specified peer.

Format

peer ipv4-address enable

undo peer ipv4-address enable

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, only peer groups in the BGP-IPv4 unicast address family are automatically enabled to exchange routing information. In other words, after the peer as-number command is run in the BGP view, the system automatically configures the peer enable command. In other address family views, however, this function must be manually enabled.

Configuration Impact

Enabling or disabling a BGP peer in this address family causes the BGP connection with the peer in another address family to be disconnected and automatically renegotiated.

Precautions

If a peer has established a peer relationship in another address family when you run this command, running the peer enable command may disconnect and re-establish the peer relationship in all other address families of the peer (using the same address), causing route flapping. Therefore, exercise caution when running this command.

Example

# Enable the device to exchange routing information with a specified peer in the address family view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 enable

peer enable (BGP-IPv4 unicast address family view) (group)

Function

The peer enable command enables a device to exchange routing information with a specified peer group in the address family view.

The undo peer enable command disables a device from exchanging routes with a specified peer group.

By default, route exchange with a specified peer group is enabled only in the BGP-IPv4 unicast address family.

Format

peer group-name enable

undo peer group-name enable

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the device is automatically enabled to exchange routing information only with peer groups in the BGP-IPv4 unicast address family. That is, after the peer as-number command is run in the BGP view, the system automatically configures the corresponding peer enable command. This function must be manually enabled in other address family views.

Configuration Impact

Enabling or disabling a BGP peer group in this address family causes the BGP connections of the peer group in other address families to be disconnected and automatically renegotiated.

Precautions

If a peer group has established peer relationships in another address family, running the peer enable command may disconnect and re-establish all peer relationships in the peer group, causing route flapping. Therefore, exercise caution when running this command.

Example

# Enable the device to exchange relevant routing information with a specified peer group in the address family view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test enable

peer enable (BGP-IPv4 unicast address family view) (IPv4)

Function

The peer enable command enables a BGP device to exchange routes with a specified peer group in the address family view.

The undo peer enable command disables a BGP device from exchanging routes with a specified peer group.

By default, route exchange with a specified peer is enabled only in the BGP-IPv4 unicast address family.

Format

peer ipv4-address enable

undo peer ipv4-address enable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, only peer groups in the BGP-IPv4 unicast address family are automatically enabled to exchange routing information. In other words, after the peer as-number command is run in the BGP view, the system automatically configures the peer enable command. In other address family views, however, this function must be manually enabled.

Configuration Impact

Enabling or disabling a BGP peer in this address family causes the BGP connection with the peer in another address family to be disconnected and automatically renegotiated.

Precautions

If a peer has established a peer relationship in another address family when you run this command, running the peer enable command may disconnect and re-establish the peer relationship in all other address families of the peer (using the same address), causing route flapping. Therefore, exercise caution when running this command.

Example

# Enable the device to exchange routing information with a specified peer in the address family view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 enable

peer enable (BGP-IPv6 unicast address family view) (group)

Function

The peer enable command enables a device to exchange routing information with a specified peer group in the address family view.

The undo peer enable command disables a device from exchanging routes with a specified peer group.

By default, a device is disabled from exchanging routing information with a specified peer group.

Format

peer group-name enable

undo peer group-name enable

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the device is automatically enabled to exchange routing information only with peer groups in the BGP-IPv4 unicast address family. That is, after the peer as-number command is run in the BGP view, the system automatically configures the corresponding peer enable command. This function must be manually enabled in other address family views.

Configuration Impact

Enabling or disabling a BGP peer group in this address family causes the BGP connections of the peer group in other address families to be disconnected and automatically renegotiated.

Example

# Enable the device to exchange relevant routing information with a specified peer group in the address family view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable

peer enable (BGP-IPv6 unicast address family view) (IPv4)

Function

The peer enable command enables a BGP device to exchange routes with a specified peer group in the address family view.

The undo peer enable command disables a BGP device from exchanging routes with a specified peer group.

By default, a device is disabled from exchanging routing information with a specified peer.

Format

peer ipv4-address enable

undo peer ipv4-address enable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, only peer groups in the BGP-IPv4 unicast address family are automatically enabled to exchange routing information. In other words, after the peer as-number command is run in the BGP view, the system automatically configures the peer enable command. In other address family views, however, this function must be manually enabled.

Configuration Impact

Enabling or disabling a BGP peer in this address family causes the BGP connection with the peer in another address family to be disconnected and automatically renegotiated.

Precautions

If a peer has established a peer relationship in another address family when you run this command, running the peer enable command may disconnect and re-establish the peer relationship in all other address families of the peer (using the same address), causing route flapping. Therefore, exercise caution when running this command.

Example

# Enable the device to exchange routing information with a specified peer in the address family view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable

peer enable (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer enable command enables a BGP device to exchange routes with a specified peer group in the address family view.

The undo peer enable command disables a BGP device from exchanging routes with a specified peer group.

By default, a device is disabled from exchanging routing information with a specified peer.

Format

peer ipv6-address enable

undo peer ipv6-address enable

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, only peer groups in the BGP-IPv4 unicast address family are automatically enabled to exchange routing information. In other words, after the peer as-number command is run in the BGP view, the system automatically configures the peer enable command. In other address family views, however, this function must be manually enabled.

Configuration Impact

Enabling or disabling a BGP peer in this address family causes the BGP connection with the peer in another address family to be disconnected and automatically renegotiated.

Precautions

If a peer has established a peer relationship in another address family when you run this command, running the peer enable command may disconnect and re-establish the peer relationship in all other address families of the peer (using the same address), causing route flapping. Therefore, exercise caution when running this command.

Example

# Enable the device to exchange routing information with a specified peer in the address family view.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable

peer enable (BGP-VPN instance IPv4 address family view) (group)

Function

The peer enable command enables a device to exchange routing information with a specified peer group in the address family view.

The undo peer enable command disables a device from exchanging routes with a specified peer group.

By default, a device is disabled from exchanging routing information with a specified peer group.

Format

peer group-name enable

undo peer group-name enable

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the device is automatically enabled to exchange routing information only with peer groups in the BGP-IPv4 unicast address family. That is, after the peer as-number command is run in the BGP view, the system automatically configures the corresponding peer enable command. This function must be manually enabled in other address family views.

Configuration Impact

Enabling or disabling a BGP peer group in this address family causes the BGP connections of the peer group in other address families to be disconnected and automatically renegotiated.

Precautions

If a peer group has established peer relationships in another address family, running the peer enable command may disconnect and re-establish all peer relationships in the peer group, causing route flapping. Therefore, exercise caution when running this command.

Example

# Enable the device to exchange relevant routing information with a specified peer group in the address family view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-vpna] group test
[HUAWEI-bgp-instance-vpna] quit
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer test enable

peer enable (BGP-VPN instance IPv4 address family view) (IPv4)

Function

The peer enable command enables a BGP device to exchange routes with a specified peer group in the address family view.

The undo peer enable command disables a BGP device from exchanging routes with a specified peer group.

By default, a device is disabled from exchanging routing information with a specified peer.

Format

peer ipv4-address enable

undo peer ipv4-address enable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, only peer groups in the BGP-IPv4 unicast address family are automatically enabled to exchange routing information. In other words, after the peer as-number command is run in the BGP view, the system automatically configures the peer enable command. In other address family views, however, this function must be manually enabled.

Configuration Impact

Enabling or disabling a BGP peer in this address family causes the BGP connection with the peer in another address family to be disconnected and automatically renegotiated.

Example

# Enable the device to exchange routing information with a specified peer in the address family view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-instance-vpna] quit
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 enable

peer enable (BGP-VPN instance IPv6 address family view) (IPv4)

Function

The peer enable command enables a BGP device to exchange routes with a specified peer group in the address family view.

The undo peer enable command disables a BGP device from exchanging routes with a specified peer group.

By default, a device is disabled from exchanging routing information with a specified peer.

Format

peer ipv4-address enable

undo peer ipv4-address enable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, only peer groups in the BGP-IPv4 unicast address family are automatically enabled to exchange routing information. In other words, after the peer as-number command is run in the BGP view, the system automatically configures the peer enable command. In other address family views, however, this function must be manually enabled.

Configuration Impact

Enabling or disabling a BGP peer in this address family causes the BGP connection with the peer in another address family to be disconnected and automatically renegotiated.

Precautions

To run the command in the BGP VPN instance IPv4 address family view or BGP VPN instance IPv6 address family view, ensure that the related BGP peers and BGP peer groups have been configured in the BGP VPN instance.

If the peer has established a peer relationship in another address family, running the peer enable command may disconnect and re-establish all peer relationships with the peer, causing route flapping. Therefore, exercise caution when running this command.

Example

# Enable the device to exchange routing information with a specified peer in the address family view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable

peer enable (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer enable command enables a BGP device to exchange routes with a specified peer group in the address family view.

The undo peer enable command disables a BGP device from exchanging routes with a specified peer group.

By default, a device is disabled from exchanging routing information with a specified peer.

Format

peer ipv6-address enable

undo peer ipv6-address enable

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, only peer groups in the BGP-IPv4 unicast address family are automatically enabled to exchange routing information. In other words, after the peer as-number command is run in the BGP view, the system automatically configures the peer enable command. In other address family views, however, this function must be manually enabled.

Configuration Impact

Enabling or disabling a BGP peer in this address family causes the BGP connection with the peer in another address family to be disconnected and automatically renegotiated.

Example

# Enable the device to exchange routing information with a specified peer in the address family view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-instance-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 enable

peer filter-policy export (BGP view/BGP-IPv4 unicast address family view) (group)

Function

The peer filter-policy export command configures an ACL-based policy for filtering BGP routes to be advertised to a specified peer group.

The undo peer filter-policy export command cancels this configuration.

By default, no filtering policy is configured for the routes to be advertised to a peer group.

Format

peer group-name filter-policy acl-number export

peer group-name filter-policy acl-name acl-name export

undo peer group-name filter-policy acl-number export

undo peer group-name filter-policy acl-name acl-name export

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

acl-number

Specifies the number of a basic ACL.

The value is an integer ranging from 2000 to 2999.

export

Filters routes to be advertised.

-

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 64 case-sensitive characters starting with a letter. It cannot contain spaces.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want all routes to be advertised to a peer group, you can run the peer filter-policy export command to configure an ACL-based filtering policy to filter the routes to be advertised to the peer group.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer group.

For a peer group, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peer group.
<HUAWEI> system-view
[HUAWEI] acl 2001
[HUAWEI-acl4-basic-2001] rule permit
[HUAWEI-acl4-basic-2001] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test filter-policy 2001 export

peer filter-policy export (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer filter-policy export command configures an ACL-based policy for filtering BGP routes to be advertised to a specified peer group.

The undo peer filter-policy export command cancels this configuration.

By default, no filtering policy is configured for the routes to be advertised to a peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name filter-policy acl-number export

peer group-name filter-policy acl-name acl-name export

undo peer group-name filter-policy acl-number export

undo peer group-name filter-policy acl-name acl-name export

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

acl-number

Specifies the number of the basic ACL.

The value is an integer ranging from 2000 to 2999.

export

Filters advertised routes.

-

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 64 case-sensitive characters starting with a letter. It cannot contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want all routes to be advertised to a peer group, you can run the peer filter-policy export command to configure an ACL-based filtering policy to filter the routes to be advertised to the peer group.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer group.

For a peer group, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for a peer group.
<HUAWEI> system-view
[HUAWEI] acl 2001
[HUAWEI-acl4-basic-2001] rule permit
[HUAWEI-acl4-basic-2001] quit
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test filter-policy 2001 export

peer filter-policy export (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer filter-policy export command configures an ACL-based policy for filtering BGP routes to be advertised to a specified peer.

The undo peer filter-policy export command cancels this configuration.

By default, no filtering policy is configured for the routes to be advertised to peers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address filter-policy acl-number export

peer ipv4-address filter-policy acl-name acl-name export

undo peer ipv4-address filter-policy acl-number export

undo peer ipv4-address filter-policy acl-name acl-name export

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in the dotted decimal format.

acl-number

Specifies the number of the basic ACL.

The value is an integer ranging from 2000 to 2999.

export

Filters advertised routes.

-

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want all routes to be advertised to a peer, you can run the peer filter-policy export command to configure an ACL-based filtering policy to filter the routes to be advertised to the peer.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer.

For a peer, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] acl 2001
[HUAWEI-acl4-basic-2001] rule permit
[HUAWEI-acl4-basic-2001] quit
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 filter-policy 2001 export

peer filter-policy export (BGP view/BGP-IPv4 unicast address family view)(IPv4)

Function

The peer filter-policy export command configures an ACL-based policy for filtering BGP routes to be advertised to a specified peer.

The undo peer filter-policy export command cancels this configuration.

By default, no filtering policy is configured for the routes to be advertised to peers.

Format

peer ipv4-address filter-policy acl-number export

peer ipv4-address filter-policy acl-name acl-name export

undo peer ipv4-address filter-policy acl-number export

undo peer ipv4-address filter-policy acl-name acl-name export

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in the dotted decimal format.

acl-number

Specifies the number of the basic ACL.

The value is an integer ranging from 2000 to 2999.

export

Filters advertised routes.

-

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 64 case-sensitive characters starting with a letter. It cannot contain spaces.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want all routes to be advertised to a peer, you can run the peer filter-policy export command to configure an ACL-based filtering policy to filter the routes to be advertised to the peer.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer.

For a peer, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] acl 2001
[HUAWEI-acl4-basic-2001] rule permit
[HUAWEI-acl4-basic-2001] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 filter-policy 2001 export

peer filter-policy export (BGP-IPv6 unicast address family view) (group)

Function

The peer filter-policy export command configures an ACL-based policy for filtering BGP routes to be advertised to a specified peer group.

The undo peer filter-policy export command cancels this configuration.

By default, no filtering policy is configured for the routes to be advertised to a peer group.

Format

peer group-name filter-policy acl-number export

peer group-name filter-policy acl6-name acl6-name export

undo peer group-name filter-policy acl-number export

undo peer group-name filter-policy acl6-name acl6-name export

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

acl-number

Specifies the number of a basic ACL.

The value is an integer ranging from 2000 to 2999.

export

Filters advertised routes.

-

acl6-name acl6-name

Specifies the name of a named basic ACL6.

The value is a string of 1 to 64 case-sensitive characters starting with a letter. It cannot contain spaces.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want all routes to be advertised to a peer group, you can run the peer filter-policy export command to configure an ACL-based filtering policy to filter the routes to be advertised to the peer group.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer group.

For a peer group, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peer group.
<HUAWEI> system-view
[HUAWEI] acl ipv6 2001
[HUAWEI-acl6-basic-2001] rule permit
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test internal
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test filter-policy 2001 export

peer filter-policy export (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer filter-policy export command configures an ACL-based policy for filtering BGP routes to be advertised to a specified peer.

The undo peer filter-policy export command cancels this configuration.

By default, no filtering policy is configured for the routes to be advertised to peers.

Format

peer ipv6-address filter-policy acl6-number export

peer ipv6-address filter-policy acl6-name acl6-name export

undo peer ipv6-address filter-policy acl6-number export

undo peer ipv6-address filter-policy acl6-name acl6-name export

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

acl6-number

Specifies the number of the basic ACL.

The value is an integer ranging from 2000 to 2999.

acl6-name acl6-name

Specifies the name of a basic named ACL6.

The value is a string of 1 to 64 case-sensitive characters. It cannot contain spaces and must start with a letter.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want all routes to be advertised to a peer, you can run the peer filter-policy export command to configure an ACL-based filtering policy to filter the routes to be advertised to the peer.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer.

For a peer, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the IPv6 filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] acl ipv6 2001
[HUAWEI-acl6-basic-2001] rule permit
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:db8::3:4 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:db8::3:4 enable
[HUAWEI-bgp-af-ipv6] peer 2001:db8::3:4 filter-policy 2001 export

peer filter-policy export (BGP-IPv6 unicast address family view)(IPv4)

Function

The peer filter-policy export command configures an ACL-based policy for filtering BGP routes to be advertised to a specified peer.

The undo peer filter-policy export command cancels this configuration.

By default, no filtering policy is configured for the routes to be advertised to peers.

Format

peer ipv4-address filter-policy acl-number export

peer ipv4-address filter-policy acl6-name acl6-name export

undo peer ipv4-address filter-policy acl-number export

undo peer ipv4-address filter-policy acl6-name acl6-name export

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in the dotted decimal format.

acl-number

Specifies the number of a basic ACL.

The value is an integer ranging from 2000 to 2999.

export

Filters advertised routes.

-

acl6-name acl6-name

Specifies the name of a named basic ACL6.

The value is a string of 1 to 64 case-sensitive characters starting with a letter. It cannot contain spaces.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want all routes to be advertised to a peer, you can run the peer filter-policy export command to configure an ACL-based filtering policy to filter the routes to be advertised to the peer.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer.

For a peer, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] acl ipv6 2001
[HUAWEI-acl6-basic-2001] rule permit
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 filter-policy 2001 export

peer filter-policy export (BGP-VPN instance IPv4 address family view) (group)

Function

The peer filter-policy export command configures an ACL-based policy for filtering BGP routes to be advertised to a specified peer group.

The undo peer filter-policy export command cancels this configuration.

By default, no filtering policy is configured for the routes to be advertised to a peer group.

Format

peer group-name filter-policy acl-number export

peer group-name filter-policy acl-name acl-name export

undo peer group-name filter-policy acl-number export

undo peer group-name filter-policy acl-name acl-name export

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

acl-number

Specifies the number of a basic ACL.

The value is an integer ranging from 2000 to 2999.

export

Filters advertised routes.

-

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 64 case-sensitive characters. It cannot contain spaces and must start with a letter.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want all routes to be advertised to a peer group, you can run the peer filter-policy export command to configure an ACL-based filtering policy to filter the routes to be advertised to the peer group.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer group.

For a peer group, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test filter-policy 2001 export

peer filter-policy export (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer filter-policy export command configures an ACL-based policy for filtering BGP routes to be advertised to a specified peer.

The undo peer filter-policy export command cancels this configuration.

By default, no filtering policy is configured for the routes to be advertised to peers.

Format

peer ipv4-address filter-policy acl-number export

peer ipv4-address filter-policy acl-name acl-name export

undo peer ipv4-address filter-policy acl-number export

undo peer ipv4-address filter-policy acl-name acl-name export

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in the dotted decimal format.

acl-number

Specifies the number of the basic ACL.

The value is an integer ranging from 2000 to 2999.

export

Filters advertised routes.

-

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 64 case-sensitive characters. It cannot contain spaces and must start with a letter.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want all routes to be advertised to a peer, you can run the peer filter-policy export command to configure an ACL-based filtering policy to filter the routes to be advertised to the peer.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer.

For a peer, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] acl 2001
[HUAWEI-acl4-basic-2001] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 10.1.1.1 filter-policy 2001 export

peer filter-policy export (BGP-VPN instance IPv6 address family view) (group)

Function

The peer filter-policy export command configures an ACL-based policy for filtering BGP routes to be advertised to a specified peer group.

The undo peer filter-policy export command cancels this configuration.

By default, no filtering policy is configured for the routes to be advertised to a peer group.

Format

peer group-name filter-policy acl-number export

peer group-name filter-policy acl6-name acl6-name export

undo peer group-name filter-policy acl-number export

undo peer group-name filter-policy acl6-name acl6-name export

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

acl-number

Specifies the number of the basic ACL.

The value is an integer ranging from 2000 to 2999.

export

Filters advertised routes.

-

acl6-name acl6-name

Specifies the name of a basic named ACL6.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want all routes to be advertised to a peer group, you can run the peer filter-policy export command to configure an ACL-based filtering policy to filter the routes to be advertised to the peer group.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer group.

For a peer group, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] acl ipv6 2001
[HUAWEI-acl6-basic-2001] rule permit
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group yy internal
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.1 group yy
[HUAWEI-bgp-instance-vpn1] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] peer yy enable
[HUAWEI-bgp-6-vpn1] peer yy filter-policy 2001 export

peer filter-policy export (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer filter-policy export command configures an ACL-based policy for filtering BGP routes to be advertised to a specified peer.

The undo peer filter-policy export command cancels this configuration.

By default, no filtering policy is configured for the routes to be advertised to peers.

Format

peer ipv6-address filter-policy acl-number export

peer ipv6-address filter-policy acl6-name acl6-name export

undo peer ipv6-address filter-policy acl-number export

undo peer ipv6-address filter-policy acl6-name acl6-name export

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

acl-number

Specifies the number of the basic ACL.

The value is an integer ranging from 2000 to 2999.

export

Filters advertised routes.

-

acl6-name acl6-name

Specifies the name of a basic named ACL6.

The value is a string of 1 to 64 case-sensitive characters starting with a letter. It cannot contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want all routes to be advertised to a peer, you can run the peer filter-policy export command to configure an ACL-based filtering policy to filter the routes to be advertised to the peer.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer.

For a peer, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] acl ipv6 2001
[HUAWEI-acl6-basic-2001] rule permit
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:db8::3:4 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:db8::3:4 filter-policy 2001 export

peer filter-policy import (BGP view/BGP-IPv4 unicast address family view) (group)

Function

The peer filter-policy import command configures an ACL-based policy for filtering BGP routes received from a specified peer group.

The undo peer filter-policy import command cancels this configuration.

By default, no filtering policy is configured for the routes to be received from a peer group.

Format

peer group-name filter-policy acl-number import

peer group-name filter-policy acl-name acl-name import

undo peer group-name filter-policy acl-number import

undo peer group-name filter-policy acl-name acl-name import

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

acl-number

Specifies the number of a basic ACL.

The value is an integer ranging from 2000 to 2999.

import

Filters received routes.

-

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 64 case-sensitive characters starting with a letter. It cannot contain spaces.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want to accept all the routes from a peer group, run the peer filter-policy import command to configure an ACL-based filtering policy to filter the routes received from the peer group.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer group.

For a peer group, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peer group.
<HUAWEI> system-view
[HUAWEI] acl 2000
[HUAWEI-acl4-basic-2000] rule permit
[HUAWEI-acl4-basic-2000] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test filter-policy 2000 import

peer filter-policy import (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer filter-policy import command configures an ACL-based policy for filtering BGP routes received from a specified peer group.

The undo peer filter-policy import command cancels this configuration.

By default, no filtering policy is configured for the routes to be received from a peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name filter-policy acl-number import

peer group-name filter-policy acl-name acl-name import

undo peer group-name filter-policy acl-number import

undo peer group-name filter-policy acl-name acl-name import

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

acl-number

Specifies the number of a basic ACL.

The value is an integer ranging from 2000 to 2999.

import

Filters received routes.

-

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 64 case-sensitive characters starting with a letter. It cannot contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want to accept all the routes from a peer group, run the peer filter-policy import command to configure an ACL-based filtering policy to filter the routes received from the peer group.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer group.

For a peer group, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for a peer group.
<HUAWEI> system-view
[HUAWEI] acl 2001
[HUAWEI-acl4-basic-2001] rule permit
[HUAWEI-acl4-basic-2001] quit
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test filter-policy 2001 import

peer filter-policy import (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer filter-policy import command configures an ACL-based policy for filtering BGP routes received from a specified peer.

The undo peer filter-policy import command cancels this configuration.

By default, no filtering policy is configured for the routes received from peers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address filter-policy acl-number import

peer ipv4-address filter-policy acl-name acl-name import

undo peer ipv4-address filter-policy acl-number import

undo peer ipv4-address filter-policy acl-name acl-name import

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in the dotted decimal format.

acl-number

Specifies the number of the basic ACL.

The value is an integer ranging from 2000 to 2999.

import

Filters received routes.

-

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 64 case-sensitive characters starting with a letter. It cannot contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want to receive all routes from a peer, you can run the peer filter-policy import command to configure an ACL-based filtering policy to filter the routes received from the peer.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer.

For a peer, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] acl 2001
[HUAWEI-acl4-basic-2001] rule permit
[HUAWEI-acl4-basic-2001] quit
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 filter-policy 2001 import

peer filter-policy import (BGP view/BGP-IPv4 unicast address family view)(IPv4)

Function

The peer filter-policy import command configures an ACL-based policy for filtering BGP routes received from a specified peer group.

The undo peer filter-policy import command cancels this configuration.

By default, no filtering policy is configured for the routes received from peers.

Format

peer ipv4-address filter-policy acl-number import

peer ipv4-address filter-policy acl-name acl-name import

undo peer ipv4-address filter-policy acl-number import

undo peer ipv4-address filter-policy acl-name acl-name import

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in the dotted decimal format.

acl-number

Specifies the number of the basic ACL.

The value is an integer ranging from 2000 to 2999.

import

Filters received routes.

-

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 64 case-sensitive characters starting with a letter. It cannot contain spaces.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want to receive all routes from a peer, you can run the peer filter-policy import command to configure an ACL-based filtering policy to filter the routes received from the peer.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer.

For a peer, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] acl 2001
[HUAWEI-acl4-basic-2001] rule permit
[HUAWEI-acl4-basic-2001] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 filter-policy 2001 import

peer filter-policy import (BGP-IPv6 unicast address family view) (group)

Function

The peer filter-policy import command configures an ACL-based policy for filtering BGP routes received from a specified peer group.

The undo peer filter-policy import command cancels this configuration.

By default, no filtering policy is configured for the routes to be received from a peer group.

Format

peer group-name filter-policy acl-number import

peer group-name filter-policy acl6-name acl6-name import

undo peer group-name filter-policy acl-number import

undo peer group-name filter-policy acl6-name acl6-name import

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

acl-number

Specifies the number of a basic ACL.

The value is an integer ranging from 2000 to 2999.

import

Filters received routes.

-

acl6-name acl6-name

Specifies the name of a basic named ACL6.

The value is a string of 1 to 64 case-sensitive characters. It cannot contain spaces and must start with a letter.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want to accept all the routes from a peer group, run the peer filter-policy import command to configure an ACL-based filtering policy to filter the routes received from the peer group.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer group.

For a peer group, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peer group.
<HUAWEI> system-view
[HUAWEI] acl ipv6 2001
[HUAWEI-acl6-basic-2001] rule permit
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test filter-policy 2001 import

peer filter-policy import (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer filter-policy import command configures an ACL-based policy for filtering BGP routes received from a specified peer group.

The undo peer filter-policy import command cancels this configuration.

By default, no filtering policy is configured for the routes received from peers.

Format

peer ipv6-address filter-policy acl6-number import

peer ipv6-address filter-policy acl6-name acl6-name import

undo peer ipv6-address filter-policy acl6-number import

undo peer ipv6-address filter-policy acl6-name acl6-name import

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

acl6-number

Specifies the number of the basic ACL.

The value is an integer ranging from 2000 to 2999.

acl6-name acl6-name

Specifies the name of a basic named ACL6.

The value is a string of 1 to 64 case-sensitive characters. It cannot contain spaces and must start with a letter.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want to receive all routes from a peer, you can run the peer filter-policy import command to configure an ACL-based filtering policy to filter the routes received from the peer.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer.

For a peer, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the IPv6 filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] acl ipv6 2001
[HUAWEI-acl6-basic-2001] rule permit
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:db8::3:4 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:db8::3:4 enable
[HUAWEI-bgp-af-ipv6] peer 2001:db8::3:4 filter-policy 2001 import

peer filter-policy import (BGP-IPv6 unicast address family view)(IPv4)

Function

The peer filter-policy import command configures an ACL-based policy for filtering BGP routes received from a specified peer group.

The undo peer filter-policy import command cancels this configuration.

By default, no filtering policy is configured for the routes received from peers.

Format

peer ipv4-address filter-policy acl-number import

peer ipv4-address filter-policy acl6-name acl6-name import

undo peer ipv4-address filter-policy acl-number import

undo peer ipv4-address filter-policy acl6-name acl6-name import

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

acl-number

Specifies the number of the basic ACL.

The value is an integer ranging from 2000 to 2999.

import

Filters received routes.

-

acl6-name acl6-name

Specifies the name of a basic named ACL6.

The value is a string of 1 to 64 case-sensitive characters. It cannot contain spaces and must start with a letter.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want to receive all routes from a peer, you can run the peer filter-policy import command to configure an ACL-based filtering policy to filter the routes received from the peer.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer.

For a peer, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the IPv6 filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] acl ipv6 2001
[HUAWEI-acl6-basic-2001] rule permit
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 filter-policy 2001 import

peer filter-policy import (BGP-VPN instance IPv4 address family view) (group)

Function

The peer filter-policy import command configures an ACL-based policy for filtering BGP routes received from a specified peer group.

The undo peer filter-policy import command cancels this configuration.

By default, no filtering policy is configured for the routes to be received from a peer group.

Format

peer group-name filter-policy acl-number import

peer group-name filter-policy acl-name acl-name import

undo peer group-name filter-policy acl-number import

undo peer group-name filter-policy acl-name acl-name import

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

acl-number

Specifies the number of a basic ACL.

The value is an integer ranging from 2000 to 2999.

import

Filters received routes.

-

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 64 case-sensitive characters. It cannot contain spaces and must start with a letter.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want to accept all the routes from a peer group, run the peer filter-policy import command to configure an ACL-based filtering policy to filter the routes received from the peer group.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer group.

For a peer group, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test filter-policy 2001 import

peer filter-policy import (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer filter-policy import command configures an ACL-based policy for filtering BGP routes received from a specified peer group.

The undo peer filter-policy import command cancels this configuration.

By default, no filtering policy is configured for the routes received from peers.

Format

peer ipv4-address filter-policy acl-number import

peer ipv4-address filter-policy acl-name acl-name import

undo peer ipv4-address filter-policy acl-number import

undo peer ipv4-address filter-policy acl-name acl-name import

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in the dotted decimal format.

acl-number

Specifies the number of the basic ACL.

The value is an integer ranging from 2000 to 2999.

import

Filters received routes.

-

acl-name acl-name

Specifies the name of a named basic ACL.

The value is a string of 1 to 64 case-sensitive characters. It cannot contain spaces and must start with a letter.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want to receive all routes from a peer, you can run the peer filter-policy import command to configure an ACL-based filtering policy to filter the routes received from the peer.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer.

For a peer, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] acl 2001
[HUAWEI-acl4-basic-2001] quit
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 10.1.1.1 filter-policy 2001 import

peer filter-policy import (BGP-VPN instance IPv6 address family view) (group)

Function

The peer filter-policy import command configures an ACL-based policy for filtering BGP routes received from a specified peer group.

The undo peer filter-policy import command cancels this configuration.

By default, no filtering policy is configured for the routes to be received from a peer group.

Format

peer group-name filter-policy acl-number import

peer group-name filter-policy acl6-name acl6-name import

undo peer group-name filter-policy acl-number import

undo peer group-name filter-policy acl6-name acl6-name import

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

acl-number

Specifies the number of a basic ACL.

The value is an integer ranging from 2000 to 2999.

import

Filters received routes.

-

acl6-name acl6-name

Specifies the name of a named basic ACL6.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want to accept all the routes from a peer group, run the peer filter-policy import command to configure an ACL-based filtering policy to filter the routes received from the peer group.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer group.

For a peer group, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] acl ipv6 2001
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test filter-policy 2001 import

peer filter-policy import (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer filter-policy import command configures an ACL-based policy for filtering BGP routes received from a specified peer.

The undo peer filter-policy import command cancels this configuration.

By default, no filtering policy is configured for the routes received from peers.

Format

peer ipv6-address filter-policy acl-number import

peer ipv6-address filter-policy acl6-name acl6-name import

undo peer ipv6-address filter-policy acl-number import

undo peer ipv6-address filter-policy acl6-name acl6-name import

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

acl-number

Specifies the number of the basic ACL.

The value is an integer ranging from 2000 to 2999.

import

Filters received routes.

-

acl6-name acl6-name

Specifies the name of a basic named ACL6.

The value is a string of 1 to 64 case-sensitive characters starting with a letter. It cannot contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you do not want to receive all routes from a peer, you can run the peer filter-policy import command to configure an ACL-based filtering policy to filter the routes received from the peer.

Precautions

For a named ACL, when the rule command is used to configure a filtering rule, only the configurations specified by source and time-range take effect.

Select a correct basic ACL based on the address family type of the peer.

For a peer, only one route filtering policy can take effect. If the peer filter-policy command is run more than once, the latest configuration takes effect.

Example

# Set the filtering policy for peers.
<HUAWEI> system-view
[HUAWEI] acl ipv6 2001
[HUAWEI-acl6-basic-2001] rule permit
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:db8::3:4 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:db8::3:4 filter-policy 2001 import

peer graceful-restart peer-reset (BGP multi-instance view) (group)

Function

The peer graceful-restart peer-reset command enables the device to reset a BGP connection with a peer group in Graceful Restart (GR) mode.

The undo peer graceful-restart peer-reset command restores the default configuration.

By default, a device is not enabled to reset the BGP connection with a specified peer in GR mode.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name graceful-restart peer-reset

undo peer group-name graceful-restart peer-reset

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. Therefore, a BGP capability change causes the re-establishment of a peer relationship. To solve this problem, run the peer graceful-restart peer-reset command to reset the BGP connection with a specified peer group in GR mode.

For example, after the function of resetting the BGP connection with a specified peer group in GR mode is configured, if the BGP peer relationship of another address family is created based on the BGP IPv4 unicast peer session, BGP starts to reset the BGP connection with the specified peer group in GR mode, and capability negotiation is performed again. During this process, the BGP IPv4 unicast peer session is re-established, but the original routing entries are not deleted. The forwarding module can still forward packets based on the routing information, ensuring uninterrupted IPv4 services.

Prerequisites

GR has been enabled for a peer group using the peer capability-advertise graceful-restart command.

Example

# Enable a device to use the GR mode to reset BGP connections with all peers in a specified group.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance dd
[HUAWEI-bgp-instance-dd] group aaa
[HUAWEI-bgp-instance-dd] peer aaa graceful-restart peer-reset

peer graceful-restart peer-reset (BGP multi-instance view)(IPv4)

Function

The peer graceful-restart peer-reset command enables a device to reset the BGP connection with a specified peer in graceful restart (GR) mode.

The undo peer graceful-restart peer-reset command restores the default configuration.

The peer graceful-restart peer-reset disable command disables a peer from inheriting from a peer group the configuration of resetting the BGP connection with a specified peer in GR mode.

The undo peer graceful-restart peer-reset disable command restores the default configuration.

By default, a device is not enabled to reset the BGP connection with a specified peer in GR mode.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address graceful-restart peer-reset

peer ipv4-address graceful-restart peer-reset disable

undo peer ipv4-address graceful-restart peer-reset

undo peer ipv4-address graceful-restart peer-reset disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. Therefore, a BGP capability change causes the re-establishment of a peer relationship. To solve this problem, run the peer graceful-restart peer-reset command to reset the BGP connection with a specified peer in GR mode.

For example, after the function of resetting the BGP connection with a specified peer in GR mode is configured, if a BGP peer relationship in another address family is established based on the BGP IPv4 unicast peer session, BGP starts to reset the BGP connection with the specified peer in GR mode and renegotiates capabilities. During this process, the BGP IPv4 unicast peer session is re-established, but the original routing entries are not deleted. The forwarding module can still forward packets based on the routing information, ensuring uninterrupted IPv4 services.

Prerequisites

GR has been enabled on the peer using the peer capability-advertise graceful-restart command.

Example

# Enable a device to use the GR mode to reset the BGP connection with a specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance dd
[HUAWEI-bgp-instance-dd] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-dd] peer 10.1.1.1 graceful-restart peer-reset

peer graceful-restart peer-reset (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer graceful-restart peer-reset command enables the device to reset a BGP connection with a peer group in Graceful Restart (GR) mode.

The undo peer graceful-restart peer-reset command restores the default configuration.

By default, a device is not enabled to reset the BGP connection with a specified peer in GR mode.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name graceful-restart peer-reset

undo peer group-name graceful-restart peer-reset

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. Therefore, a BGP capability change causes the re-establishment of a peer relationship. To solve this problem, run the peer graceful-restart peer-reset command to reset the BGP connection with a specified peer group in GR mode.

For example, after the function of resetting the BGP connection with a specified peer group in GR mode is configured, if the BGP peer relationship of another address family is created based on the BGP IPv4 unicast peer session, BGP starts to reset the BGP connection with the specified peer group in GR mode, and capability negotiation is performed again. During this process, the BGP IPv4 unicast peer session is re-established, but the original routing entries are not deleted. The forwarding module can still forward packets based on the routing information, ensuring uninterrupted IPv4 services.

Prerequisites

GR has been enabled for a peer group using the peer capability-advertise graceful-restart command.

Example

# Enable a device to use the GR mode to reset BGP connections with all peers in a specified group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna] bgp 100 instance dd
[HUAWEI-bgp-instance-dd] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-dd-vpna] group aaa
[HUAWEI-bgp-instance-dd-vpna] peer aaa graceful-restart peer-reset

peer graceful-restart peer-reset (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer graceful-restart peer-reset command enables a device to reset the BGP connection with a specified peer in graceful restart (GR) mode.

The undo peer graceful-restart peer-reset command restores the default configuration.

The peer graceful-restart peer-reset disable command disables a peer from inheriting from a peer group the configuration of resetting the BGP connection with a specified peer in GR mode.

The undo peer graceful-restart peer-reset disable command restores the default configuration.

By default, a device is not enabled to reset the BGP connection with a specified peer in GR mode.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address graceful-restart peer-reset

peer ipv4-address graceful-restart peer-reset disable

undo peer ipv4-address graceful-restart peer-reset

undo peer ipv4-address graceful-restart peer-reset disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. Therefore, a BGP capability change causes the re-establishment of a peer relationship. To solve this problem, run the peer graceful-restart peer-reset command to reset the BGP connection with a specified peer in GR mode.

For example, after the function of resetting the BGP connection with a specified peer in GR mode is configured, if a BGP peer relationship in another address family is established based on the BGP IPv4 unicast peer session, BGP starts to reset the BGP connection with the specified peer in GR mode and renegotiates capabilities. During this process, the BGP IPv4 unicast peer session is re-established, but the original routing entries are not deleted. The forwarding module can still forward packets based on the routing information, ensuring uninterrupted IPv4 services.

Prerequisites

GR has been enabled on the peer using the peer capability-advertise graceful-restart command.

Example

# Enable a device to use the GR mode to reset the BGP connection with a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna] bgp 100 instance dd
[HUAWEI-bgp-instance-dd] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-dd-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-dd-vpna] peer 10.1.1.1 graceful-restart peer-reset

peer graceful-restart peer-reset (BGP view)

Function

The peer graceful-restart peer-reset command enables a device to reset the BGP connection with a specified peer in graceful restart (GR) mode.

The undo peer graceful-restart peer-reset command restores the default configuration.

The peer graceful-restart peer-reset disable command disables a peer from inheriting from a peer group the configuration of resetting the BGP connection with a specified peer in GR mode.

The undo peer graceful-restart peer-reset disable command restores the default configuration.

By default, a device is not enabled to reset the BGP connection with a specified peer in GR mode.

Format

peer ipv4-address graceful-restart peer-reset

peer ipv4-address graceful-restart peer-reset disable

peer ipv6-address graceful-restart peer-reset

peer ipv6-address graceful-restart peer-reset disable

undo peer ipv4-address graceful-restart peer-reset

undo peer ipv4-address graceful-restart peer-reset disable

undo peer ipv6-address graceful-restart peer-reset

undo peer ipv6-address graceful-restart peer-reset disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. Therefore, a BGP capability change causes the re-establishment of a peer relationship. To solve this problem, run the peer graceful-restart peer-reset command to reset the BGP connection with a specified peer in GR mode.

For example, after the function of resetting the BGP connection with a specified peer in GR mode is configured, if a BGP peer relationship in another address family is established based on the BGP IPv4 unicast peer session, BGP starts to reset the BGP connection with the specified peer in GR mode and renegotiates capabilities. During this process, the BGP IPv4 unicast peer session is re-established, but the original routing entries are not deleted. The forwarding module can still forward packets based on the routing information, ensuring uninterrupted IPv4 services.

Prerequisites

GR has been enabled on the peer using the peer capability-advertise graceful-restart command.

Example

# Enable a device to use the GR mode to reset the BGP connection with a specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 graceful-restart peer-reset

peer graceful-restart peer-reset (BGP view)(group)

Function

The peer graceful-restart peer-reset command enables the device to reset a BGP connection with a peer group in Graceful Restart (GR) mode.

The undo peer graceful-restart peer-reset command restores the default configuration.

By default, a device is not enabled to reset the BGP connection with a specified peer in GR mode.

Format

peer group-name graceful-restart peer-reset

undo peer group-name graceful-restart peer-reset

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. Therefore, a BGP capability change causes the re-establishment of a peer relationship. To solve this problem, run the peer graceful-restart peer-reset command to reset the BGP connection with a specified peer group in GR mode.

For example, after the function of resetting the BGP connection with a specified peer group in GR mode is configured, if the BGP peer relationship of another address family is created based on the BGP IPv4 unicast peer session, BGP starts to reset the BGP connection with the specified peer group in GR mode, and capability negotiation is performed again. During this process, the BGP IPv4 unicast peer session is re-established, but the original routing entries are not deleted. The forwarding module can still forward packets based on the routing information, ensuring uninterrupted IPv4 services.

Prerequisites

GR has been enabled for a peer group using the peer capability-advertise graceful-restart command.

Example

# Enable a device to use the GR mode to reset BGP connections with all peers in a specified group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group aaa
[HUAWEI-bgp] peer aaa graceful-restart peer-reset

peer graceful-restart peer-reset (BGP-VPN instance IPv4 address family view) (group)

Function

The peer graceful-restart peer-reset command enables the device to reset a BGP connection with a peer group in Graceful Restart (GR) mode.

The undo peer graceful-restart peer-reset command restores the default configuration.

By default, a device is not enabled to reset the BGP connection with a specified peer in GR mode.

Format

peer group-name graceful-restart peer-reset

undo peer group-name graceful-restart peer-reset

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. Therefore, a BGP capability change causes the re-establishment of a peer relationship. To solve this problem, run the peer graceful-restart peer-reset command to reset the BGP connection with a specified peer group in GR mode.

For example, after the function of resetting the BGP connection with a specified peer group in GR mode is configured, if the BGP peer relationship of another address family is created based on the BGP IPv4 unicast peer session, BGP starts to reset the BGP connection with the specified peer group in GR mode, and capability negotiation is performed again. During this process, the BGP IPv4 unicast peer session is re-established, but the original routing entries are not deleted. The forwarding module can still forward packets based on the routing information, ensuring uninterrupted IPv4 services.

Prerequisites

GR has been enabled for a peer group using the peer capability-advertise graceful-restart command.

Example

# Enable a device to use the GR mode to reset BGP connections with all peers in a specified group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group aaa
[HUAWEI-bgp-vpna] peer aaa graceful-restart peer-reset

peer graceful-restart peer-reset (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer graceful-restart peer-reset command enables a device to reset the BGP connection with a specified peer in graceful restart (GR) mode.

The undo peer graceful-restart peer-reset command restores the default configuration.

The peer graceful-restart peer-reset disable command disables a peer from inheriting from a peer group the configuration of resetting the BGP connection with a specified peer in GR mode.

The undo peer graceful-restart peer-reset disable command restores the default configuration.

By default, a device is not enabled to reset the BGP connection with a specified peer in GR mode.

Format

peer ipv4-address graceful-restart peer-reset

peer ipv4-address graceful-restart peer-reset disable

undo peer ipv4-address graceful-restart peer-reset

undo peer ipv4-address graceful-restart peer-reset disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. Therefore, a BGP capability change causes the re-establishment of a peer relationship. To solve this problem, run the peer graceful-restart peer-reset command to reset the BGP connection with a specified peer in GR mode.

For example, after the function of resetting the BGP connection with a specified peer in GR mode is configured, if a BGP peer relationship in another address family is established based on the BGP IPv4 unicast peer session, BGP starts to reset the BGP connection with the specified peer in GR mode and renegotiates capabilities. During this process, the BGP IPv4 unicast peer session is re-established, but the original routing entries are not deleted. The forwarding module can still forward packets based on the routing information, ensuring uninterrupted IPv4 services.

Prerequisites

GR has been enabled on the peer using the peer capability-advertise graceful-restart command.

Example

# Enable a device to use the GR mode to reset the BGP connection with a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 10.1.1.1 graceful-restart peer-reset

peer graceful-restart peer-reset (BGP-VPN instance IPv6 address family view) (group)

Function

The peer graceful-restart peer-reset command enables the device to reset a BGP connection with a peer group in Graceful Restart (GR) mode.

The undo peer graceful-restart peer-reset command restores the default configuration.

By default, a device is not enabled to reset the BGP connection with a specified peer in GR mode.

Format

peer group-name graceful-restart peer-reset

undo peer group-name graceful-restart peer-reset

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. Therefore, a BGP capability change causes the re-establishment of a peer relationship. To solve this problem, run the peer graceful-restart peer-reset command to reset the BGP connection with a specified peer group in GR mode.

For example, after the function of resetting the BGP connection with a specified peer group in GR mode is configured, if the BGP peer relationship of another address family is created based on the BGP IPv4 unicast peer session, BGP starts to reset the BGP connection with the specified peer group in GR mode, and capability negotiation is performed again. During this process, the BGP IPv4 unicast peer session is re-established, but the original routing entries are not deleted. The forwarding module can still forward packets based on the routing information, ensuring uninterrupted IPv4 services.

Prerequisites

GR has been enabled for a peer group using the peer capability-advertise graceful-restart command.

Example

# Enable a device to use the GR mode to reset BGP connections with all peers in a specified group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] group aaa
[HUAWEI-bgp-6-vpna] peer aaa graceful-restart peer-reset

peer graceful-restart peer-reset (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer graceful-restart peer-reset command enables a device to reset the BGP connection with a specified peer in graceful restart (GR) mode.

The undo peer graceful-restart peer-reset command restores the default configuration.

The peer graceful-restart peer-reset disable command disables a peer from inheriting from a peer group the configuration of resetting the BGP connection with a specified peer in GR mode.

The undo peer graceful-restart peer-reset disable command restores the default configuration.

By default, a device is not enabled to reset the BGP connection with a specified peer in GR mode.

Format

peer ipv6-address graceful-restart peer-reset

peer ipv6-address graceful-restart peer-reset disable

undo peer ipv6-address graceful-restart peer-reset

undo peer ipv6-address graceful-restart peer-reset disable

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a BGP peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. Therefore, a BGP capability change causes the re-establishment of a peer relationship. To solve this problem, run the peer graceful-restart peer-reset command to reset the BGP connection with a specified peer in GR mode.

For example, after the function of resetting the BGP connection with a specified peer in GR mode is configured, if a BGP peer relationship in another address family is established based on the BGP IPv4 unicast peer session, BGP starts to reset the BGP connection with the specified peer in GR mode and renegotiates capabilities. During this process, the BGP IPv4 unicast peer session is re-established, but the original routing entries are not deleted. The forwarding module can still forward packets based on the routing information, ensuring uninterrupted IPv4 services.

Prerequisites

GR has been enabled on the peer using the peer capability-advertise graceful-restart command.

Example

# Enable a device to use the GR mode to reset the BGP connection with a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 graceful-restart peer-reset

peer graceful-restart peer-reset (BGP-VPN instance view)

Function

The peer graceful-restart peer-reset command enables a device to reset the BGP connection with a specified peer in graceful restart (GR) mode.

The undo peer graceful-restart peer-reset command restores the default configuration.

The peer graceful-restart peer-reset disable command disables a peer from inheriting from a peer group the configuration of resetting the BGP connection with a specified peer in GR mode.

The undo peer graceful-restart peer-reset disable command restores the default configuration.

By default, a device is not enabled to reset the BGP connection with a specified peer in GR mode.

Format

peer ipv4-address graceful-restart peer-reset

peer ipv4-address graceful-restart peer-reset disable

peer ipv6-address graceful-restart peer-reset

peer ipv6-address graceful-restart peer-reset disable

undo peer ipv4-address graceful-restart peer-reset

undo peer ipv4-address graceful-restart peer-reset disable

undo peer ipv6-address graceful-restart peer-reset

undo peer ipv6-address graceful-restart peer-reset disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. Therefore, a BGP capability change causes the re-establishment of a peer relationship. To solve this problem, run the peer graceful-restart peer-reset command to reset the BGP connection with a specified peer in GR mode.

For example, after the function of resetting the BGP connection with a specified peer in GR mode is configured, if a BGP peer relationship in another address family is established based on the BGP IPv4 unicast peer session, BGP starts to reset the BGP connection with the specified peer in GR mode and renegotiates capabilities. During this process, the BGP IPv4 unicast peer session is re-established, but the original routing entries are not deleted. The forwarding module can still forward packets based on the routing information, ensuring uninterrupted IPv4 services.

Prerequisites

GR has been enabled on the peer using the peer capability-advertise graceful-restart command.

Example

# Enable a device to use the GR mode to reset the BGP connection with a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-vpna] peer 10.1.1.1 graceful-restart peer-reset

peer graceful-restart peer-reset (BGP-VPN instance view) (group)

Function

The peer graceful-restart peer-reset command enables the device to reset a BGP connection with a peer group in Graceful Restart (GR) mode.

The undo peer graceful-restart peer-reset command restores the default configuration.

By default, a device is not enabled to reset the BGP connection with a specified peer in GR mode.

Format

peer group-name graceful-restart peer-reset

undo peer group-name graceful-restart peer-reset

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. Therefore, a BGP capability change causes the re-establishment of a peer relationship. To solve this problem, run the peer graceful-restart peer-reset command to reset the BGP connection with a specified peer group in GR mode.

For example, after the function of resetting the BGP connection with a specified peer group in GR mode is configured, if the BGP peer relationship of another address family is created based on the BGP IPv4 unicast peer session, BGP starts to reset the BGP connection with the specified peer group in GR mode, and capability negotiation is performed again. During this process, the BGP IPv4 unicast peer session is re-established, but the original routing entries are not deleted. The forwarding module can still forward packets based on the routing information, ensuring uninterrupted IPv4 services.

Prerequisites

GR has been enabled for a peer group using the peer capability-advertise graceful-restart command.

Example

# Enable a device to use the GR mode to reset BGP connections with all peers in a specified group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-vpna] group aaa
[HUAWEI-bgp-instance-vpna] peer aaa graceful-restart peer-reset

peer graceful-restart peer-reset(BGP multi-instance VPN instance view)(IPv4)

Function

The peer graceful-restart peer-reset command enables a device to reset the BGP connection with a specified peer in graceful restart (GR) mode.

The undo peer graceful-restart peer-reset command restores the default configuration.

The peer graceful-restart peer-reset disable command disables a peer from inheriting from a peer group the configuration of resetting the BGP connection with a specified peer in GR mode.

The undo peer graceful-restart peer-reset disable command restores the default configuration.

By default, a device is not enabled to reset the BGP connection with a specified peer in GR mode.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr graceful-restart peer-reset

peer peerIpv6Addr graceful-restart peer-reset

peer peerIpv4Addr graceful-restart peer-reset disable

peer peerIpv6Addr graceful-restart peer-reset disable

undo peer peerIpv4Addr graceful-restart peer-reset

undo peer peerIpv6Addr graceful-restart peer-reset

undo peer peerIpv4Addr graceful-restart peer-reset disable

undo peer peerIpv6Addr graceful-restart peer-reset disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Currently, BGP does not support dynamic capability negotiation. Therefore, a BGP capability change causes the re-establishment of a peer relationship. To solve this problem, run the peer graceful-restart peer-reset command to reset the BGP connection with a specified peer in GR mode.

For example, after the function of resetting the BGP connection with a specified peer in GR mode is configured, if a BGP peer relationship in another address family is established based on the BGP IPv4 unicast peer session, BGP starts to reset the BGP connection with the specified peer in GR mode and renegotiates capabilities. During this process, the BGP IPv4 unicast peer session is re-established, but the original routing entries are not deleted. The forwarding module can still forward packets based on the routing information, ensuring uninterrupted IPv4 services.

Prerequisites

GR has been enabled on the peer using the peer capability-advertise graceful-restart command.

Example

# Enable a device to use the GR mode to reset the BGP connection with a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] bgp 100 instance dd
[HUAWEI-bgp-instance-dd] vpn-instance vpna
[HUAWEI-bgp-instance-dd-instance-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-dd-instance-vpna] peer 10.1.1.1 graceful-restart peer-reset

peer graceful-restart timer restart (BGP multi-instance view) (group)

Function

The peer graceful-restart timer restart command sets the maximum duration on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device. After the command is run, the device will advertise the maximum duration to all the peers in the specified group.

The undo peer graceful-restart timer restart command deletes the configured duration.

By default, each peer in a specified group on a device waits for its BGP peer relationship to be reestablished for a maximum of 150 seconds.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name graceful-restart timer restart time-value

undo peer group-name graceful-restart timer restart

Parameters

Parameter Description Value
group-name

Specifies the peer-group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

time-value

Specifies the maximum duration on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If both the local end and a specified peer group support GR, you can run this command to set the maximum waiting time for the specified peer group to wait for the re-establishment of the local BGP peer relationship. After this command is run, when the specified peer group finds that the local end is Down, the BGP session enters the GR process, and the specified peer group must establish a connection with the local end within the period set by this command. Otherwise, the GR process exits and the optimal route is selected from the existing routes.

Configuration Impact

If this command is run, the BGP peer relationship is disconnected and re-established. Therefore, exercise caution when running this command.

Example

# Set the maximum duration to 100s on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] group a
[HUAWEI-bgp-instance-a] peer a graceful-restart timer restart 100

peer graceful-restart timer restart (BGP multi-instance view)(IPv4)

Function

The peer graceful-restart timer restart command sets the maximum duration on a device for a specified peer to wait for its BGP peer relationship to be reestablished with the device. After the command is run, the device will advertise the maximum duration to the specified peer.

The undo peer graceful-restart timer restart command deletes the configured duration.

By default, a peer specified on a device waits for its BGP peer relationship to be reestablished with the device for a maximum of 150s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address graceful-restart timer restart time-value

undo peer ipv4-address graceful-restart timer restart

Parameters

Parameter Description Value
ipv4-address

Specify an IPv4 peer address.

The value is in dotted decimal notation.

time-value

Specifies the maximum duration on a device for a peer to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device and a BGP peer specified on the device both support GR, you can run the peer graceful-restart timer restart command to set the maximum duration on the device for the peer to wait for its BGP peer relationship to be reestablished with the device. After this command is run, if the peer detects that the device is down, the BGP session on the peer enters the GR process. If the peer relationship fails to be reestablished within the specified duration, the BGP session exits from the GR process and the peer selects the optimal route from current reachable routes.

Configuration Impact

If this command is run, the BGP peer relationship is disconnected and re-established. Therefore, exercise caution when running this command.

Example

# Set the maximum duration to 100s on a device for a specified peer to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 10.1.1.1 graceful-restart timer restart 100

peer graceful-restart timer restart (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer graceful-restart timer restart command sets the maximum duration on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device. After the command is run, the device will advertise the maximum duration to all the peers in the specified group.

The undo peer graceful-restart timer restart command deletes the configured duration.

By default, each peer in a specified group on a device waits for its BGP peer relationship to be reestablished for a maximum of 150 seconds.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name graceful-restart timer restart time-value

undo peer group-name graceful-restart timer restart

Parameters

Parameter Description Value
group-name

Specifies the peer-group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

time-value

Specifies the maximum duration on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If both the local end and a specified peer group support GR, you can run this command to set the maximum waiting time for the specified peer group to wait for the re-establishment of the local BGP peer relationship. After this command is run, when the specified peer group finds that the local end is Down, the BGP session enters the GR process, and the specified peer group must establish a connection with the local end within the period set by this command. Otherwise, the GR process exits and the optimal route is selected from the existing routes.

Configuration Impact

If this command is run, the BGP peer relationship is disconnected and re-established. Therefore, exercise caution when running this command.

Example

# Set the maximum duration to 100s on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-instance-a-vpn1] group a
[HUAWEI-bgp-instance-a-vpn1] peer a graceful-restart timer restart 100

peer graceful-restart timer restart (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer graceful-restart timer restart command sets the maximum duration on a device for a specified peer to wait for its BGP peer relationship to be reestablished with the device. After the command is run, the device will advertise the maximum duration to the specified peer.

The undo peer graceful-restart timer restart command deletes the configured duration.

By default, a peer specified on a device waits for its BGP peer relationship to be reestablished with the device for a maximum of 150s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address graceful-restart timer restart time-value

undo peer ipv4-address graceful-restart timer restart

Parameters

Parameter Description Value
ipv4-address

Specify an IPv4 peer address.

The value is in dotted decimal notation.

time-value

Specifies the maximum duration on a device for a peer to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device and a BGP peer specified on the device both support GR, you can run the peer graceful-restart timer restart command to set the maximum duration on the device for the peer to wait for its BGP peer relationship to be reestablished with the device. After this command is run, if the peer detects that the device is down, the BGP session on the peer enters the GR process. If the peer relationship fails to be reestablished within the specified duration, the BGP session exits from the GR process and the peer selects the optimal route from current reachable routes.

Configuration Impact

If this command is run, the BGP peer relationship is disconnected and re-established. Therefore, exercise caution when running this command.

Example

# Set the maximum duration to 100s on a device for a specified peer to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-instance-a-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpn1] peer 10.1.1.1 graceful-restart timer restart 100

peer graceful-restart timer restart (BGP view)

Function

The peer graceful-restart timer restart command sets the maximum duration on a device for a specified peer to wait for its BGP peer relationship to be reestablished with the device. After the command is run, the device will advertise the maximum duration to the specified peer.

The undo peer graceful-restart timer restart command deletes the configured duration.

By default, a peer specified on a device waits for its BGP peer relationship to be reestablished with the device for a maximum of 150s.

Format

peer ipv4-address graceful-restart timer restart time-value

peer ipv6-address graceful-restart timer restart time-value

undo peer ipv4-address graceful-restart timer restart

undo peer ipv6-address graceful-restart timer restart

Parameters

Parameter Description Value
ipv4-address

Specify an IPv4 peer address.

The value is in dotted decimal notation.

time-value

Specifies the maximum duration on a device for a peer to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device and a BGP peer specified on the device both support GR, you can run the peer graceful-restart timer restart command to set the maximum duration on the device for the peer to wait for its BGP peer relationship to be reestablished with the device. After this command is run, if the peer detects that the device is down, the BGP session on the peer enters the GR process. If the peer relationship fails to be reestablished within the specified duration, the BGP session exits from the GR process and the peer selects the optimal route from current reachable routes.

Configuration Impact

If this command is run, the BGP peer relationship is disconnected and re-established. Therefore, exercise caution when running this command.

Example

# Set the maximum duration to 100s on a device for a specified peer to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 graceful-restart timer restart 100

peer graceful-restart timer restart (BGP view)(group)

Function

The peer graceful-restart timer restart command sets the maximum duration on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device. After the command is run, the device will advertise the maximum duration to all the peers in the specified group.

The undo peer graceful-restart timer restart command deletes the configured duration.

By default, each peer in a specified group on a device waits for its BGP peer relationship to be reestablished for a maximum of 150 seconds.

Format

peer group-name graceful-restart timer restart time-value

undo peer group-name graceful-restart timer restart

Parameters

Parameter Description Value
group-name

Specifies a peer-group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

time-value

Specifies the maximum duration on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If both the local end and a specified peer group support GR, you can run this command to set the maximum waiting time for the specified peer group to wait for the re-establishment of the local BGP peer relationship. After this command is run, when the specified peer group finds that the local end is Down, the BGP session enters the GR process, and the specified peer group must establish a connection with the local end within the period set by this command. Otherwise, the GR process exits and the optimal route is selected from the existing routes.

Configuration Impact

If this command is run, the BGP peer relationship is disconnected and re-established. Therefore, exercise caution when running this command.

Example

# Set the maximum duration to 100s on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group a
[HUAWEI-bgp] peer a graceful-restart timer restart 100

peer graceful-restart timer restart (BGP-VPN instance IPv4 address family view) (group)

Function

The peer graceful-restart timer restart command sets the maximum duration on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device. After the command is run, the device will advertise the maximum duration to all the peers in the specified group.

The undo peer graceful-restart timer restart command deletes the configured duration.

By default, each peer in a specified group on a device waits for its BGP peer relationship to be reestablished for a maximum of 150 seconds.

Format

peer group-name graceful-restart timer restart time-value

undo peer group-name graceful-restart timer restart

Parameters

Parameter Description Value
group-name

Specifies the peer-group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

time-value

Specifies the maximum duration on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If both the local end and a specified peer group support GR, you can run this command to set the maximum waiting time for the specified peer group to wait for the re-establishment of the local BGP peer relationship. After this command is run, when the specified peer group finds that the local end is Down, the BGP session enters the GR process, and the specified peer group must establish a connection with the local end within the period set by this command. Otherwise, the GR process exits and the optimal route is selected from the existing routes.

Configuration Impact

If this command is run, the BGP peer relationship is disconnected and re-established. Therefore, exercise caution when running this command.

Example

# Set the maximum duration to 100s on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group a
[HUAWEI-bgp-vpn1] peer a graceful-restart timer restart 100

peer graceful-restart timer restart (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer graceful-restart timer restart command sets the maximum duration on a device for a specified peer to wait for its BGP peer relationship to be reestablished with the device. After the command is run, the device will advertise the maximum duration to the specified peer.

The undo peer graceful-restart timer restart command deletes the configured duration.

By default, a peer specified on a device waits for its BGP peer relationship to be reestablished with the device for a maximum of 150s.

Format

peer ipv4-address graceful-restart timer restart time-value

undo peer ipv4-address graceful-restart timer restart

Parameters

Parameter Description Value
ipv4-address

Specify an IPv4 peer address.

The value is in dotted decimal notation.

time-value

Specifies the maximum duration on a device for a peer to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device and a BGP peer specified on the device both support GR, you can run the peer graceful-restart timer restart command to set the maximum duration on the device for the peer to wait for its BGP peer relationship to be reestablished with the device. After this command is run, if the peer detects that the device is down, the BGP session on the peer enters the GR process. If the peer relationship fails to be reestablished within the specified duration, the BGP session exits from the GR process and the peer selects the optimal route from current reachable routes.

Configuration Impact

If this command is run, the BGP peer relationship is disconnected and re-established. Therefore, exercise caution when running this command.

Example

# Set the maximum duration to 100s on a device for a specified peer to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 graceful-restart timer restart 100

peer graceful-restart timer restart (BGP-VPN instance IPv6 address family view) (group)

Function

The peer graceful-restart timer restart command sets the maximum duration on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device. After the command is run, the device will advertise the maximum duration to all the peers in the specified group.

The undo peer graceful-restart timer restart command deletes the configured duration.

By default, each peer in a specified group on a device waits for its BGP peer relationship to be reestablished for a maximum of 150 seconds.

Format

peer group-name graceful-restart timer restart time-value

undo peer group-name graceful-restart timer restart

Parameters

Parameter Description Value
group-name

Specifies the peer-group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

time-value

Specifies the maximum duration on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If both the local end and a specified peer group support GR, you can run this command to set the maximum waiting time for the specified peer group to wait for the re-establishment of the local BGP peer relationship. After this command is run, when the specified peer group finds that the local end is Down, the BGP session enters the GR process, and the specified peer group must establish a connection with the local end within the period set by this command. Otherwise, the GR process exits and the optimal route is selected from the existing routes.

Configuration Impact

If this command is run, the BGP peer relationship is disconnected and re-established. Therefore, exercise caution when running this command.

Example

# Set the maximum duration to 100s on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group a
[HUAWEI-bgp-6-vpn1] peer a graceful-restart timer restart 100

peer graceful-restart timer restart (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer graceful-restart timer restart command sets the maximum duration on a device for a specified peer to wait for its BGP peer relationship to be reestablished with the device. After the command is run, the device will advertise the maximum duration to the specified peer.

The undo peer graceful-restart timer restart command deletes the configured duration.

By default, a peer specified on a device waits for its BGP peer relationship to be reestablished for a maximum of 150 seconds.

Format

peer ipv6-address graceful-restart timer restart time-value

undo peer ipv6-address graceful-restart timer restart

Parameters

Parameter Description Value
ipv6-address

Specifies the IP address of an IPv6 peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

time-value

Specifies the maximum duration for a peer to wait for its BGP peer relationship to be reestablished.

The value is an integer ranging from 3 to 3600, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device and a BGP peer specified on the device both support GR, you can run the peer graceful-restart timer restart command to set the maximum duration on the device for the peer to wait for its BGP peer relationship to be reestablished with the device. After this command is run, if the peer detects that the device is down, the BGP session on the peer enters the GR process. If the peer relationship fails to be reestablished within the specified duration, the BGP session exits from the GR process and the peer selects the optimal route from current reachable routes.

Configuration Impact

If this command is run, the BGP peer relationship is disconnected and re-established. Therefore, exercise caution when running this command.

Example

# Set the maximum duration to 100s on a device for a specified peer to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpn1] peer 2001:DB8:1::1 graceful-restart timer restart 100

peer graceful-restart timer restart (BGP-VPN instance view)

Function

The peer graceful-restart timer restart command sets the maximum duration on a device for a specified peer to wait for its BGP peer relationship to be reestablished with the device. After the command is run, the device will advertise the maximum duration to the specified peer.

The undo peer graceful-restart timer restart command deletes the configured duration.

By default, a peer specified on a device waits for its BGP peer relationship to be reestablished for a maximum of 150 seconds.

Format

peer ipv4-address graceful-restart timer restart time-value

peer ipv6-address graceful-restart timer restart time-value

undo peer ipv4-address graceful-restart timer restart

undo peer ipv6-address graceful-restart timer restart

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

time-value

Specifies the maximum duration on a device for a peer to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

ipv6-address

Specifies the IPv6 address of a BGP peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device and a BGP peer specified on the device both support GR, you can run the peer graceful-restart timer restart command to set the maximum duration on the device for the peer to wait for its BGP peer relationship to be reestablished with the device. After this command is run, if the peer detects that the device is down, the BGP session on the peer enters the GR process. If the peer relationship fails to be reestablished within the specified duration, the BGP session exits from the GR process and the peer selects the optimal route from current reachable routes.

Configuration Impact

If this command is run, the BGP peer relationship is disconnected and re-established. Therefore, exercise caution when running this command.

Example

# Set the maximum duration to 100s on a device for a specified peer to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.1 graceful-restart timer restart 100

peer graceful-restart timer restart (BGP-VPN instance view) (group)

Function

The peer graceful-restart timer restart command sets the maximum duration on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device. After the command is run, the device will advertise the maximum duration to all the peers in the specified group.

The undo peer graceful-restart timer restart command deletes the configured duration.

By default, each peer in a specified group on a device waits for its BGP peer relationship to be reestablished for a maximum of 150 seconds.

Format

peer group-name graceful-restart timer restart time-value

undo peer group-name graceful-restart timer restart

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

time-value

Specifies the maximum duration on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If both the local end and a specified peer group support GR, you can run this command to set the maximum waiting time for the specified peer group to wait for the re-establishment of the local BGP peer relationship. After this command is run, when the specified peer group finds that the local end is Down, the BGP session enters the GR process, and the specified peer group must establish a connection with the local end within the period set by this command. Otherwise, the GR process exits and the optimal route is selected from the existing routes.

Configuration Impact

If this command is run, the BGP peer relationship is disconnected and re-established. Therefore, exercise caution when running this command.

Example

# Set the maximum duration to 100s on a device for each peer in a specified group to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group a
[HUAWEI-bgp-instance-vpn1] peer a graceful-restart timer restart 100

peer graceful-restart timer restart(BGP multi-instance VPN instance view)(IPv4)

Function

The peer graceful-restart timer restart command sets the maximum time for a specified peer to wait for the local BGP peer relationship to be re-established and advertises the time to the specified peer.

The undo peer graceful-restart timer restart command deletes this configuration.

By default, a peer specified on a device waits for its BGP peer relationship to be reestablished with the device for a maximum of 150s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr graceful-restart timer restart time-value

peer peerIpv6Addr graceful-restart timer restart time-value

undo peer peerIpv4Addr graceful-restart timer restart

undo peer peerIpv6Addr graceful-restart timer restart

Parameters

Parameter Description Value
peerIpv4Addr

Specify an IPv4 peer address.

The value is in dotted decimal notation.

time-value

Specifies the maximum duration on a device for a peer to wait for its BGP peer relationship to be reestablished with the device.

The value is an integer ranging from 3 to 3600, in seconds.

peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device and a BGP peer specified on the device both support GR, you can run the peer graceful-restart timer restart command to set the maximum duration on the device for the peer to wait for its BGP peer relationship to be reestablished with the device. After this command is run, if the peer detects that the device is down, the BGP session on the peer enters the GR process. If the peer relationship fails to be reestablished within the specified duration, the BGP session exits from the GR process and the peer selects the optimal route from current reachable routes.

Configuration Impact

If this command is run, the BGP peer relationship is disconnected and re-established. Therefore, exercise caution when running this command.

Example

# Set the maximum duration to 100s on a device for a specified peer to wait for its BGP peer relationship to be reestablished with the device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] bgp 100 instance a
[HUAWEI-bgp-instance-a] vpn-instance vpn1
[HUAWEI-bgp-instance-a-instance-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-instance-vpn1] peer 10.1.1.1 graceful-restart timer restart 100

peer graceful-restart timer wait-for-rib (BGP multi-instance view) (group)

Function

The peer graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer in a specified group.

The undo peer graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer in a specified group for a maximum of 600s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name graceful-restart timer wait-for-rib time-value

undo peer group-name graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

time-value

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the local device re-establishes a BGP session with a specified peer group, the local device should receive the End-Of-RIB flag from the specified peer group within the period specified by this command. If the local device does not receive the End-Of-RIB flag within the period specified by this command, the local device exits the GR process and selects the optimal route from the existing routes.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from each peer in a specified group to 100s.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance dd
[HUAWEI-bgp-instance-dd] group aaa
[HUAWEI-bgp-instance-dd] peer aaa graceful-restart timer wait-for-rib 100

peer graceful-restart timer wait-for-rib (BGP multi-instance view)(IPv4)

Function

The peer graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from a specified peer.

The undo peer graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address graceful-restart timer wait-for-rib time-value

undo peer ipv4-address graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

time-value

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the local device reestablishes a BGP session with a specified peer, the local device should receive the End-Of-RIB flag from the specified peer within the period specified by this command. If the local device does not receive the End-Of-RIB flag within the period specified by this command, the local device exits the GR process and selects the optimal route from the existing routes.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance dd
[HUAWEI-bgp-instance-dd] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-dd] peer 10.1.1.1 graceful-restart timer wait-for-rib 100

peer graceful-restart timer wait-for-rib (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer in a specified group.

The undo peer graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer in a specified group for a maximum of 600s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name graceful-restart timer wait-for-rib time-value

undo peer group-name graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

time-value

Specifies the maximum duration for waiting for the End-Of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the local device re-establishes a BGP session with a specified peer group, the local device should receive the End-Of-RIB flag from the specified peer group within the period specified by this command. If the local device does not receive the End-Of-RIB flag within the period specified by this command, the local device exits the GR process and selects the optimal route from the existing routes.

Configuration Impact

If the peer graceful-restart timer wait-for-rib command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from each peer in a specified group to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna] bgp 100 instance dd
[HUAWEI-bgp-instance-dd] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-dd-vpna] group aaa
[HUAWEI-bgp-instance-dd-vpna] peer aaa graceful-restart timer wait-for-rib 100

peer graceful-restart timer wait-for-rib (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from a specified peer.

The undo peer graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address graceful-restart timer wait-for-rib time-value

undo peer ipv4-address graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

time-value

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the local device reestablishes a BGP session with a specified peer, the local device should receive the End-Of-RIB flag from the specified peer within the period specified by this command. If the local device does not receive the End-Of-RIB flag within the period specified by this command, the local device exits the GR process and selects the optimal route from the existing routes.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna] bgp 100 instance dd
[HUAWEI-bgp-instance-dd] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-dd-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-dd-vpna] peer 10.1.1.1 graceful-restart timer wait-for-rib 100

peer graceful-restart timer wait-for-rib (BGP view)

Function

The peer graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from a specified peer.

The undo peer graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

Format

peer ipv4-address graceful-restart timer wait-for-rib time-value

peer ipv6-address graceful-restart timer wait-for-rib time-value

undo peer ipv4-address graceful-restart timer wait-for-rib

undo peer ipv6-address graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

time-value

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the local device reestablishes a BGP session with a specified peer, the local device should receive the End-Of-RIB flag from the specified peer within the period specified by this command. If the local device does not receive the End-Of-RIB flag within the period specified by this command, the local device exits the GR process and selects the optimal route from the existing routes.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 graceful-restart timer wait-for-rib 100

peer graceful-restart timer wait-for-rib (BGP view)(group)

Function

The peer graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer in a specified group.

The undo peer graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer in a specified group for a maximum of 600s.

Format

peer group-name graceful-restart timer wait-for-rib time-value

undo peer group-name graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

time-value

Specifies the maximum duration for waiting for the End-Of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the local device re-establishes a BGP session with a specified peer group, the local device should receive the End-Of-RIB flag from the specified peer group within the period specified by this command. If the local device does not receive the End-Of-RIB flag within the period specified by this command, the local device exits the GR process and selects the optimal route from the existing routes.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from each peer in a specified group to 100s.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group aaa
[HUAWEI-bgp] peer aaa graceful-restart timer wait-for-rib 100

peer graceful-restart timer wait-for-rib (BGP-VPN instance IPv4 address family view) (group)

Function

The peer graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer in a specified group.

The undo peer graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer in a specified group for a maximum of 600s.

Format

peer group-name graceful-restart timer wait-for-rib time-value

undo peer group-name graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

time-value

Specifies the maximum duration for waiting for the End-Of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the local device re-establishes a BGP session with a specified peer group, the local device should receive the End-Of-RIB flag from the specified peer group within the period specified by this command. If the local device does not receive the End-Of-RIB flag within the period specified by this command, the local device exits the GR process and selects the optimal route from the existing routes.

Configuration Impact

If the peer graceful-restart timer wait-for-rib command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from each peer in a specified group to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group aaa
[HUAWEI-bgp-vpna] peer aaa graceful-restart timer wait-for-rib 100

peer graceful-restart timer wait-for-rib (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from a specified peer.

The undo peer graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

Format

peer ipv4-address graceful-restart timer wait-for-rib time-value

undo peer ipv4-address graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

time-value

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the local device reestablishes a BGP session with a specified peer, the local device should receive the End-Of-RIB flag from the specified peer within the period specified by this command. If the local device does not receive the End-Of-RIB flag within the period specified by this command, the local device exits the GR process and selects the optimal route from the existing routes.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 10.1.1.1 graceful-restart timer wait-for-rib 100

peer graceful-restart timer wait-for-rib (BGP-VPN instance IPv6 address family view) (group)

Function

The peer graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer in a specified group.

The undo peer graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer in a specified group for a maximum of 600s.

Format

peer group-name graceful-restart timer wait-for-rib time-value

undo peer group-name graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

time-value

Specifies the period during which the BGP restarter waits for the End-Of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the local device re-establishes a BGP session with a specified peer group, the local device should receive the End-Of-RIB flag from the specified peer group within the period specified by this command. If the local device does not receive the End-Of-RIB flag within the period specified by this command, the local device exits the GR process and selects the optimal route from the existing routes.

Configuration Impact

If the peer graceful-restart timer wait-for-rib command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from each peer in a specified group to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] group aaa
[HUAWEI-bgp-6-vpna] peer aaa graceful-restart timer wait-for-rib 100

peer graceful-restart timer wait-for-rib (BGP-VPN instance IPv6 address family view)(IPv6)

Function

The peer graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from a specified peer.

The undo peer graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

Format

peer ipv6-address graceful-restart timer wait-for-rib time-value

undo peer ipv6-address graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

time-value

Specifies the maximum duration for waiting for the End-Of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the local device reestablishes a BGP session with a specified peer, the local device should receive the End-Of-RIB flag from the specified peer within the period specified by this command. If the local device does not receive the End-Of-RIB flag within the period specified by this command, the local device exits the GR process and selects the optimal route from the existing routes.

Configuration Impact

If the peer graceful-restart timer wait-for-rib command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 graceful-restart timer wait-for-rib 100

peer graceful-restart timer wait-for-rib (BGP-VPN instance view)

Function

The peer graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from a specified peer.

The undo peer graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

Format

peer ipv4-address graceful-restart timer wait-for-rib time-value

peer ipv6-address graceful-restart timer wait-for-rib time-value

undo peer ipv4-address graceful-restart timer wait-for-rib

undo peer ipv6-address graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

time-value

Specifies the maximum duration for waiting for the End-Of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the local device reestablishes a BGP session with a specified peer, the local device should receive the End-Of-RIB flag from the specified peer within the period specified by this command. If the local device does not receive the End-Of-RIB flag within the period specified by this command, the local device exits the GR process and selects the optimal route from the existing routes.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-vpna] peer 10.1.1.1 graceful-restart timer wait-for-rib 100

peer graceful-restart timer wait-for-rib (BGP-VPN instance view) (group)

Function

The peer graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer in a specified group.

The undo peer graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer in a specified group for a maximum of 600s.

Format

peer group-name graceful-restart timer wait-for-rib time-value

undo peer group-name graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

time-value

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the local device re-establishes a BGP session with a specified peer group, the local device should receive the End-Of-RIB flag from the specified peer group within the period specified by this command. If the local device does not receive the End-Of-RIB flag within the period specified by this command, the local device exits the GR process and selects the optimal route from the existing routes.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from each peer in a specified group to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-vpna] group aaa
[HUAWEI-bgp-instance-vpna] peer aaa graceful-restart timer wait-for-rib 100

peer graceful-restart timer wait-for-rib(BGP multi-instance VPN instance view)

Function

The peer graceful-restart timer wait-for-rib command sets the maximum time to wait for the End-of-RIB flag from a specified peer.

The undo peer graceful-restart timer wait-for-rib command deletes the configured time.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr graceful-restart timer wait-for-rib time-value

peer peerIpv6Addr graceful-restart timer wait-for-rib time-value

undo peer peerIpv4Addr graceful-restart timer wait-for-rib

undo peer peerIpv6Addr graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

time-value

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the local device reestablishes a BGP session with a specified peer, the local device should receive the End-Of-RIB flag from the specified peer within the period specified by this command. If the local device does not receive the End-Of-RIB flag within the period specified by this command, the local device exits the GR process and selects the optimal route from the existing routes.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] bgp 100 instance dd
[HUAWEI-bgp-instance-dd] vpn-instance vpna
[HUAWEI-bgp-instance-dd-instance-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-dd-instance-vpna] peer 10.1.1.1 graceful-restart timer wait-for-rib 100

peer group (BGP multi-instance view)(IPv4)

Function

The peer group command adds a peer to a peer group.

The undo peer group command removes a peer from a peer group but retains all the configurations of the peer.

By default, no peer group is created.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address group group-name

undo peer ipv4-address group group-name

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale BGP network, there are a large number of peers and many of them have the same routing policies. To configure these peers, you have to repeatedly use some commands. In such a case, configuring peer groups can simplify configurations. If you intend to perform the same configuration on several peers, create and configure a peer. Then, add the peers to the peer group. The peers will inherit the configurations of the peer group.

Precautions

Peers with different AS numbers can be added to the same peer group. If a peer is configured with an AS number, the peer retains its AS number after being added to a peer group. If a peer is not configured with an AS number but a peer group is configured with an AS number, the peer inherits the AS number of the peer group after being added to the peer group.

Members in a peer group can be configured with different route receiving policies or route advertisement policies.

The undo peer group command has the same function as the undo peer and undo peer enable commands.

By default, the peers in a peer group inherit the functions of the peer group. Therefore, if the same peer configuration command is configured for a peer and its peer group, the display this command may not display the corresponding peer configuration command on the peer. If the peer configuration command supports the disable keyword, the command output is normal. For example:

  • The peer capability-advertise command supports the disable keyword. If the peer capability-advertise command is run on a peer and its peer group, the peer capability-advertise command is displayed only on the peer group, and the peer capability-advertise command is not displayed on the peer.
  • The peer allow-as-loop command does not support the disable keyword. If the peer allow-as-loop command is run on a peer and its peer group, the peer allow-as-loop command is displayed on both the peer and its peer group.

Example

# Create an IBGP peer group to it.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] group test internal
[HUAWEI-bgp-instance-a] peer 10.1.1.1 group test

peer group (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer group command adds a peer to a peer group.

The undo peer group command removes a peer from a peer group but retains all the configurations of the peer.

By default, no peer group is created.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address group group-name

undo peer ipv4-address group group-name

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale BGP network, there are a large number of peers and many of them have the same routing policies. To configure these peers, you have to repeatedly use some commands. In such a case, configuring peer groups can simplify configurations. If you intend to perform the same configuration on several peers, create and configure a peer. Then, add the peers to the peer group. The peers will inherit the configurations of the peer group.

Precautions

Peers with different AS numbers can be added to the same peer group. If a peer is configured with an AS number, the peer retains its AS number after being added to a peer group. If a peer is not configured with an AS number but a peer group is configured with an AS number, the peer inherits the AS number of the peer group after being added to the peer group.

Members in a peer group can be configured with different route receiving policies or route advertisement policies.

The undo peer group command has the same function as the undo peer and undo peer enable commands.

By default, the peers in a peer group inherit the functions of the peer group. Therefore, if the same peer configuration command is configured for a peer and its peer group, the display this command may not display the corresponding peer configuration command on the peer. If the peer configuration command supports the disable keyword, the command output is normal. For example:

  • The peer capability-advertise command supports the disable keyword. If the peer capability-advertise command is run on a peer and its peer group, the peer capability-advertise command is displayed only on the peer group, and the peer capability-advertise command is not displayed on the peer.
  • The peer allow-as-loop command does not support the disable keyword. If the peer allow-as-loop command is run on a peer and its peer group, the peer allow-as-loop command is displayed on both the peer and its peer group.

Example

# Create an IBGP peer group to it.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] group test internal
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 group test

peer group (BGP view) (IPv6)

Function

The peer group command adds a peer to a peer group.

The undo peer group command removes a peer from a peer group but retains all the configurations of the peer.

By default, no peer group is created.

Format

peer ipv6-address group group-name

undo peer ipv6-address group group-name

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. It cannot contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale BGP network, there are a large number of peers and many of them have the same routing policies. To configure these peers, you have to repeatedly use some commands. In such a case, configuring peer groups can simplify configurations. If you intend to perform the same configuration on several peers, create and configure a peer. Then, add the peers to the peer group. The peers will inherit the configurations of the peer group.

Precautions

Peers with different AS numbers can be added to the same peer group. If a peer is configured with an AS number, the peer retains its AS number after being added to a peer group. If a peer is not configured with an AS number but a peer group is configured with an AS number, the peer inherits the AS number of the peer group after being added to the peer group.

Members in a peer group can be configured with different route receiving policies or route advertisement policies.

The undo peer group command has the same function as the undo peer and undo peer enable commands.

By default, the peers in a peer group inherit the functions of the peer group. Therefore, if the same peer configuration command is configured for a peer and its peer group, the display this command may not display the corresponding peer configuration command on the peer. If the peer configuration command supports the disable keyword, the command output is normal. For example:

  • The peer capability-advertise command supports the disable keyword. If the peer capability-advertise command is run on a peer and its peer group, the peer capability-advertise command is displayed only on the peer group, and the peer capability-advertise command is not displayed on the peer.
  • The peer allow-as-loop command does not support the disable keyword. If the peer allow-as-loop command is run on a peer and its peer group, the peer allow-as-loop command is displayed on both the peer and its peer group.

Example

# Create an IBGP peer group named test and add a peer to the peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] peer 2001:DB8:1::1 group test

peer group (BGP view)(IPv4)

Function

The peer group command adds a peer to a peer group.

The undo peer group command removes a peer from a peer group but retains all the configurations of the peer.

By default, no peer group is created.

Format

peer ipv4-address group group-name

undo peer ipv4-address group group-name

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale BGP network, there are a large number of peers and many of them have the same routing policies. To configure these peers, you have to repeatedly use some commands. In such a case, configuring peer groups can simplify configurations. If you intend to perform the same configuration on several peers, create and configure a peer. Then, add the peers to the peer group. The peers will inherit the configurations of the peer group.

Precautions

Peers with different AS numbers can be added to the same peer group. If a peer is configured with an AS number, the peer retains its AS number after being added to a peer group. If a peer is not configured with an AS number but a peer group is configured with an AS number, the peer inherits the AS number of the peer group after being added to the peer group.

Members in a peer group can be configured with different route receiving policies or route advertisement policies.

The undo peer group command has the same function as the undo peer and undo peer enable commands.

By default, the peers in a peer group inherit the functions of the peer group. Therefore, if the same peer configuration command is configured for a peer and its peer group, the display this command may not display the corresponding peer configuration command on the peer. If the peer configuration command supports the disable keyword, the command output is normal. For example:

  • The peer capability-advertise command supports the disable keyword. If the peer capability-advertise command is run on a peer and its peer group, the peer capability-advertise command is displayed only on the peer group, and the peer capability-advertise command is not displayed on the peer.
  • The peer allow-as-loop command does not support the disable keyword. If the peer allow-as-loop command is run on a peer and its peer group, the peer allow-as-loop command is displayed on both the peer and its peer group.

Example

# Create an IBGP peer group named test, and add a peer to the peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test internal
[HUAWEI-bgp] peer 10.1.1.1 group test

peer group (BGP-IPv4 unicast address family view)(IPv4)

Function

The peer group command adds a peer to a peer group.

The undo peer group command removes a peer from a peer group but retains all the configurations of the peer.

By default, no peer group is created.

Format

peer ipv4-address group group-name

undo peer ipv4-address group group-name

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale BGP network, there are a large number of peers and many of them have the same routing policies. To configure these peers, you have to repeatedly use some commands. In such a case, configuring peer groups can simplify configurations. If you intend to perform the same configuration on several peers, create and configure a peer. Then, add the peers to the peer group. The peers will inherit the configurations of the peer group.

Precautions

Peers with different AS numbers can be added to the same peer group. If a peer is configured with an AS number, the peer retains its AS number after being added to a peer group. If a peer is not configured with an AS number but a peer group is configured with an AS number, the peer inherits the AS number of the peer group after being added to the peer group.

Members in a peer group can be configured with different route receiving policies or route advertisement policies.

The undo peer group command has the same function as the undo peer and undo peer enable commands.

By default, the peers in a peer group inherit the functions of the peer group. Therefore, if the same peer configuration command is configured for a peer and its peer group, the display this command may not display the corresponding peer configuration command on the peer. If the peer configuration command supports the disable keyword, the command output is normal. For example:

  • The peer capability-advertise command supports the disable keyword. If the peer capability-advertise command is run on a peer and its peer group, the peer capability-advertise command is displayed only on the peer group, and the peer capability-advertise command is not displayed on the peer.
  • The peer allow-as-loop command does not support the disable keyword. If the peer allow-as-loop command is run on a peer and its peer group, the peer allow-as-loop command is displayed on both the peer and its peer group.

Example

# Create an IBGP peer group named test, and add a peer to the peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test internal
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 group test

peer group (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer group command adds a peer to a peer group.

The undo peer group command removes a peer from a peer group but retains all the configurations of the peer.

By default, no peer group is created.

Format

peer ipv6-address group group-name

undo peer ipv6-address group group-name

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. It cannot contain spaces.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale BGP network, there are a large number of peers and many of them have the same routing policies. To configure these peers, you have to repeatedly use some commands. In such a case, configuring peer groups can simplify configurations. If you intend to perform the same configuration on several peers, create and configure a peer. Then, add the peers to the peer group. The peers will inherit the configurations of the peer group.

Precautions

Peers with different AS numbers can be added to the same peer group. If a peer is configured with an AS number, the peer retains its AS number after being added to a peer group. If a peer is not configured with an AS number but a peer group is configured with an AS number, the peer inherits the AS number of the peer group after being added to the peer group.

Members in a peer group can be configured with different route receiving policies or route advertisement policies.

The undo peer group command has the same function as the undo peer and undo peer enable commands.

By default, the peers in a peer group inherit the functions of the peer group. Therefore, if the same peer configuration command is configured for a peer and its peer group, the display this command may not display the corresponding peer configuration command on the peer. If the peer configuration command supports the disable keyword, the command output is normal. For example:

  • The peer capability-advertise command supports the disable keyword. If the peer capability-advertise command is run on a peer and its peer group, the peer capability-advertise command is displayed only on the peer group, and the peer capability-advertise command is not displayed on the peer.
  • The peer allow-as-loop command does not support the disable keyword. If the peer allow-as-loop command is run on a peer and its peer group, the peer allow-as-loop command is displayed on both the peer and its peer group.

Example

# Create an IBGP peer group named test and add a peer to the peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 group test

peer group (BGP-IPv6 unicast address family view)(IPv4)

Function

The peer group command adds a peer to a peer group.

The undo peer group command removes a peer from a peer group but retains all the configurations of the peer.

By default, no peer group is created.

Format

peer ipv4-address group group-name

undo peer ipv4-address group group-name

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale BGP network, there are a large number of peers and many of them have the same routing policies. To configure these peers, you have to repeatedly use some commands. In such a case, configuring peer groups can simplify configurations. If you intend to perform the same configuration on several peers, create and configure a peer. Then, add the peers to the peer group. The peers will inherit the configurations of the peer group.

Precautions

Peers with different AS numbers can be added to the same peer group. If a peer is configured with an AS number, the peer retains its AS number after being added to a peer group. If a peer is not configured with an AS number but a peer group is configured with an AS number, the peer inherits the AS number of the peer group after being added to the peer group.

Members in a peer group can be configured with different route receiving policies or route advertisement policies.

The undo peer group command has the same function as the undo peer and undo peer enable commands.

By default, the peers in a peer group inherit the functions of the peer group. Therefore, if the same peer configuration command is configured for a peer and its peer group, the display this command may not display the corresponding peer configuration command on the peer. If the peer configuration command supports the disable keyword, the command output is normal. For example:

  • The peer capability-advertise command supports the disable keyword. If the peer capability-advertise command is run on a peer and its peer group, the peer capability-advertise command is displayed only on the peer group, and the peer capability-advertise command is not displayed on the peer.
  • The peer allow-as-loop command does not support the disable keyword. If the peer allow-as-loop command is run on a peer and its peer group, the peer allow-as-loop command is displayed on both the peer and its peer group.

Example

# Create an IBGP peer group named test, and add a peer to the peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 group test

peer group (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer group command adds a peer to a peer group.

The undo peer group command removes a peer from a peer group but retains all the configurations of the peer.

By default, no peer group is created.

Format

peer ipv4-address group group-name

undo peer ipv4-address group group-name

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale BGP network, there are a large number of peers and many of them have the same routing policies. To configure these peers, you have to repeatedly use some commands. In such a case, configuring peer groups can simplify configurations. If you intend to perform the same configuration on several peers, create and configure a peer. Then, add the peers to the peer group. The peers will inherit the configurations of the peer group.

Precautions

Peers with different AS numbers can be added to the same peer group. If a peer is configured with an AS number, the peer retains its AS number after being added to a peer group. If a peer is not configured with an AS number but a peer group is configured with an AS number, the peer inherits the AS number of the peer group after being added to the peer group.

Members in a peer group can be configured with different route receiving policies or route advertisement policies.

The undo peer group command has the same function as the undo peer and undo peer enable commands.

By default, the peers in a peer group inherit the functions of the peer group. Therefore, if the same peer configuration command is configured for a peer and its peer group, the display this command may not display the corresponding peer configuration command on the peer. If the peer configuration command supports the disable keyword, the command output is normal. For example:

  • The peer capability-advertise command supports the disable keyword. If the peer capability-advertise command is run on a peer and its peer group, the peer capability-advertise command is displayed only on the peer group, and the peer capability-advertise command is not displayed on the peer.
  • The peer allow-as-loop command does not support the disable keyword. If the peer allow-as-loop command is run on a peer and its peer group, the peer allow-as-loop command is displayed on both the peer and its peer group.

Example

# Create an IBGP peer group to it.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] vpn-target 100:1 both
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test internal
[HUAWEI-bgp-vpn1] peer 10.1.1.1 group test

peer group (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer group command adds a peer to a peer group.

The undo peer group command removes a peer from a peer group but retains all the configurations of the peer.

By default, no peer group is created.

Format

peer ipv6-address group group-name

undo peer ipv6-address group group-name

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale BGP network, there are a large number of peers and many of them have the same routing policies. To configure these peers, you have to repeatedly use some commands. In such a case, configuring peer groups can simplify configurations. If you intend to perform the same configuration on several peers, create and configure a peer. Then, add the peers to the peer group. The peers will inherit the configurations of the peer group.

Precautions

Peers with different AS numbers can be added to the same peer group. If a peer is configured with an AS number, the peer retains its AS number after being added to a peer group. If a peer is not configured with an AS number but a peer group is configured with an AS number, the peer inherits the AS number of the peer group after being added to the peer group.

Members in a peer group can be configured with different route receiving policies or route advertisement policies.

The undo peer group command has the same function as the undo peer and undo peer enable commands.

By default, the peers in a peer group inherit the functions of the peer group. Therefore, if the same peer configuration command is configured for a peer and its peer group, the display this command may not display the corresponding peer configuration command on the peer. If the peer configuration command supports the disable keyword, the command output is normal. For example:

  • The peer capability-advertise command supports the disable keyword. If the peer capability-advertise command is run on a peer and its peer group, the peer capability-advertise command is displayed only on the peer group, and the peer capability-advertise command is not displayed on the peer.
  • The peer allow-as-loop command does not support the disable keyword. If the peer allow-as-loop command is run on a peer and its peer group, the peer allow-as-loop command is displayed on both the peer and its peer group.

Example

# Create an IBGP peer group to it.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] group test
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 group test

peer group (BGP-VPN instance view) (IPv6)

Function

The peer group command adds a peer to a peer group.

The undo peer group command removes a peer from a peer group but retains all the configurations of the peer.

By default, no peer group is created.

Format

peer ipv6-address group group-name

undo peer ipv6-address group group-name

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale BGP network, there are a large number of peers and many of them have the same routing policies. To configure these peers, you have to repeatedly use some commands. In such a case, configuring peer groups can simplify configurations. If you intend to perform the same configuration on several peers, create and configure a peer. Then, add the peers to the peer group. The peers will inherit the configurations of the peer group.

Precautions

Peers with different AS numbers can be added to the same peer group. If a peer is configured with an AS number, the peer retains its AS number after being added to a peer group. If a peer is not configured with an AS number but a peer group is configured with an AS number, the peer inherits the AS number of the peer group after being added to the peer group.

Members in a peer group can be configured with different route receiving policies or route advertisement policies.

The undo peer group command has the same function as the undo peer and undo peer enable commands.

By default, the peers in a peer group inherit the functions of the peer group. Therefore, if the same peer configuration command is configured for a peer and its peer group, the display this command may not display the corresponding peer configuration command on the peer. If the peer configuration command supports the disable keyword, the command output is normal. For example:

  • The peer capability-advertise command supports the disable keyword. If the peer capability-advertise command is run on a peer and its peer group, the peer capability-advertise command is displayed only on the peer group, and the peer capability-advertise command is not displayed on the peer.
  • The peer allow-as-loop command does not support the disable keyword. If the peer allow-as-loop command is run on a peer and its peer group, the peer allow-as-loop command is displayed on both the peer and its peer group.

Example

# Create an IBGP peer group named test, and add a peer to the peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 group test

peer group (BGP-VPN instance view)(IPv4)

Function

The peer group command adds a peer to a peer group.

The undo peer group command removes a peer from a peer group but retains all the configurations of the peer.

By default, no peer group is created.

Format

peer ipv4-address group group-name

undo peer ipv4-address group group-name

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale BGP network, there are a large number of peers and many of them have the same routing policies. To configure these peers, you have to repeatedly use some commands. In such a case, configuring peer groups can simplify configurations. If you intend to perform the same configuration on several peers, create and configure a peer. Then, add the peers to the peer group. The peers will inherit the configurations of the peer group.

Precautions

Peers with different AS numbers can be added to the same peer group. If a peer is configured with an AS number, the peer retains its AS number after being added to a peer group. If a peer is not configured with an AS number but a peer group is configured with an AS number, the peer inherits the AS number of the peer group after being added to the peer group.

Members in a peer group can be configured with different route receiving policies or route advertisement policies.

The undo peer group command has the same function as the undo peer and undo peer enable commands.

By default, the peers in a peer group inherit the functions of the peer group. Therefore, if the same peer configuration command is configured for a peer and its peer group, the display this command may not display the corresponding peer configuration command on the peer. If the peer configuration command supports the disable keyword, the command output is normal. For example:

  • The peer capability-advertise command supports the disable keyword. If the peer capability-advertise command is run on a peer and its peer group, the peer capability-advertise command is displayed only on the peer group, and the peer capability-advertise command is not displayed on the peer.
  • The peer allow-as-loop command does not support the disable keyword. If the peer allow-as-loop command is run on a peer and its peer group, the peer allow-as-loop command is displayed on both the peer and its peer group.

Example

# Create an IBGP peer group named test, and add a peer to the peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] vpn-target 100:1 both
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test internal
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.1 group test

peer group enable (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer group enable command enables a peer to be added to a peer group in the BGP VPN instance address family.

The undo peer group enable command disables a peer from being added to a peer group in the BGP VPN instance address family.

By default, a peer is disabled from being added to a peer group in the BGP VPN instance address family.

Format

peer ipv4-address group group-name enable

undo peer ipv4-address group group-name enable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A large number of BGP peers may exist on a large-scale BGP network. Among these BGP peers, many of them may use the same policies and have the same command configurations. In this situation, you can use peer groups to simplify configurations. Specifically, when configuring multiple peers in the same way, you can create and configure a peer group, and add multiple peers to the peer group. Then, all peers in the peer group will inherit the configurations of the peer group. The peer group enable command enables a peer to be added to a peer group in the BGP VPN instance address family. After being added to a peer group, a peer automatically inherits the configurations of the peer group.

Example

# Enable a peer to be added to a peer group in the BGP VPN instance IPv4 address family view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group yy internal
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.1 group yy
[HUAWEI-bgp-instance-vpn1] quit
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer yy enable
[HUAWEI-bgp-vpn1] peer 10.1.1.1 group yy enable

peer group enable (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer group enable command enables a peer to be added to a peer group in the BGP VPN instance address family.

The undo peer group enable command disables a peer from being added to a peer group in the BGP VPN instance address family.

By default, a peer is disabled from being added to a peer group in the BGP VPN instance address family.

Format

peer ipv6-address group group-name enable

undo peer ipv6-address group group-name enable

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A large number of BGP peers may exist on a large-scale BGP network. Among these BGP peers, many of them may use the same policies and have the same command configurations. In this situation, you can use peer groups to simplify configurations. Specifically, when configuring multiple peers in the same way, you can create and configure a peer group, and add multiple peers to the peer group. Then, all peers in the peer group will inherit the configurations of the peer group. The peer group enable command enables a peer to be added to a peer group in the BGP VPN instance address family. After being added to a peer group, a peer automatically inherits the configurations of the peer group.

Example

# Enable a peer to be added to a peer group in the BGP VPN instance IPv4 address family view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group yy internal
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 group yy
[HUAWEI-bgp-instance-vpn1] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] peer yy enable
[HUAWEI-bgp-6-vpn1] peer 2001:DB8:1::1 group yy enable

peer group enable (BGP-VPN instance IPv6 address family view)(IPv4)

Function

The peer group enable command enables a peer to be added to a peer group in the BGP VPN instance address family.

The undo peer group enable command disables a peer from being added to a peer group in the BGP VPN instance address family.

By default, a peer is disabled from being added to a peer group in the BGP VPN instance address family.

Format

peer ipv4-address group group-name enable

undo peer ipv4-address group group-name enable

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A large number of BGP peers may exist on a large-scale BGP network. Among these BGP peers, many of them may use the same policies and have the same command configurations. In this situation, you can use peer groups to simplify configurations. Specifically, when configuring multiple peers in the same way, you can create and configure a peer group, and add multiple peers to the peer group. Then, all peers in the peer group will inherit the configurations of the peer group. The peer group enable command enables a peer to be added to a peer group in the BGP VPN instance address family. After being added to a peer group, a peer automatically inherits the configurations of the peer group.

Prerequisites

BGP peers and BGP peer groups have been configured in the BGP VPN instance view.

Precautions

Peers in the same peer group can have different import and export routing policies.

The undo peer group enable command provides the same function as the undo peer enable command.

Example

# Enable a peer to be added to a peer group in the BGP VPN instance IPv6 address family view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group yy internal
[HUAWEI-bgp-instance-vpn1] peer 1.1.1.1 group yy
[HUAWEI-bgp-instance-vpn1] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] peer yy enable
[HUAWEI-bgp-6-vpn1] peer 1.1.1.1 group yy enable

peer ignore (BGP multi-instance view) (group)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer group.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name ignore

undo peer group-name ignore

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established due to the upgrade or link adjustment of the peer end within a period of time, you can run this command on the stable end to temporarily interrupt the BGP peer relationship to prevent frequent route or peer relationship flapping.

You can run this command to terminate the session with a specified peer group and clear all related routing information. For a peer group, this means that a large number of sessions with the peers are terminated suddenly.

Configuration Impact

After a BGP session is successfully established, running the peer ignore command interrupts the BGP session. The interrupted BGP session cannot be established again, and the status of the corresponding BGP peer relationship is displayed as Idle.

Example

# Prohibit a device from establishing any session with the peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100 instanc a
[HUAWEI-bgp-instance-a] group test
[HUAWEI-bgp-instance-a] peer test ignore

peer ignore (BGP multi-instance view)(IPv4)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address ignore

undo peer ipv4-address ignore

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established due to the upgrade or link adjustment of the peer end within a period of time, you can run this command on the stable end to temporarily interrupt the BGP peer relationship to prevent frequent route or peer relationship flapping.

You can run this command to terminate the session with a specified peer and clear all related routing information. For a peer group, this means that a large number of sessions with the peers are terminated suddenly.

Configuration Impact

After a BGP session is successfully established, running the peer ignore command interrupts the BGP session. The interrupted BGP session cannot be established again, and the status of the corresponding BGP peer relationship is displayed as Idle.

Example

# Prohibit a device from establishing any session with the peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 10.1.1.1 ignore

peer ignore (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer group.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name ignore

undo peer group-name ignore

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established due to the upgrade or link adjustment of the peer end within a period of time, you can run this command on the stable end to temporarily interrupt the BGP peer relationship to prevent frequent route or peer relationship flapping.

You can run this command to terminate the session with a specified peer group and clear all related routing information. For a peer group, this means that a large number of sessions with the peers are terminated suddenly.

Configuration Impact

After a BGP session is successfully established, running the peer ignore command interrupts the BGP session. The interrupted BGP session cannot be established again, and the status of the corresponding BGP peer relationship is displayed as Idle.

Example

# Prohibit a device from establishing any session with the peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test ignore

peer ignore (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address ignore

undo peer ipv4-address ignore

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established due to the upgrade or link adjustment of the peer end within a period of time, you can run this command on the stable end to temporarily interrupt the BGP peer relationship to prevent frequent route or peer relationship flapping.

You can run this command to terminate the session with a specified peer and clear all related routing information. For a peer group, this means that a large number of sessions with the peers are terminated suddenly.

Configuration Impact

After a BGP session is successfully established, running the peer ignore command interrupts the BGP session. The interrupted BGP session cannot be established again, and the status of the corresponding BGP peer relationship is displayed as Idle.

Example

# Prohibit a device from establishing any session with the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 ignore

peer ignore (BGP view) (group)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer group.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer group.

Format

peer group-name ignore

undo peer group-name ignore

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established due to the upgrade or link adjustment of the peer end within a period of time, you can run this command on the stable end to temporarily interrupt the BGP peer relationship to prevent frequent route or peer relationship flapping.

You can run this command to terminate the session with a specified peer group and clear all related routing information. For a peer group, this means that a large number of sessions with the peers are terminated suddenly.

Configuration Impact

After a BGP session is successfully established, running the peer ignore command interrupts the BGP session. The interrupted BGP session cannot be established again, and the status of the corresponding BGP peer relationship is displayed as Idle.

Example

# Prohibit a device from establishing any session with the peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test ignore

peer ignore (BGP view) (IPv6)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer.

Format

peer ipv6-address ignore

undo peer ipv6-address ignore

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established due to the upgrade or link adjustment of the peer end within a period of time, you can run this command on the stable end to temporarily interrupt the BGP peer relationship to prevent frequent route or peer relationship flapping.

You can run this command to terminate the session with a specified peer and clear all related routing information. For a peer group, this means that a large number of sessions with the peers are terminated suddenly.

Configuration Impact

After a BGP session is successfully established, running the peer ignore command interrupts the BGP session. The interrupted BGP session cannot be established again, and the status of the corresponding BGP peer relationship is displayed as Idle.

Example

# Prohibit a device from establishing any session with the peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] peer 2001:DB8:1::1 ignore

peer ignore (BGP view)(IPv4)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer.

Format

peer ipv4-address ignore

undo peer ipv4-address ignore

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established due to the upgrade or link adjustment of the peer end within a period of time, you can run this command on the stable end to temporarily interrupt the BGP peer relationship to prevent frequent route or peer relationship flapping.

You can run this command to terminate the session with a specified peer and clear all related routing information. For a peer group, this means that a large number of sessions with the peers are terminated suddenly.

Configuration Impact

After a BGP session is successfully established, running the peer ignore command interrupts the BGP session. The interrupted BGP session cannot be established again, and the status of the corresponding BGP peer relationship is displayed as Idle.

Example

# Prohibit a device from establishing any session with the peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 ignore

peer ignore (BGP-VPN instance IPv4 address family view) (group)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer group.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer group.

Format

peer group-name ignore

undo peer group-name ignore

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established due to the upgrade or link adjustment of the peer end within a period of time, you can run this command on the stable end to temporarily interrupt the BGP peer relationship to prevent frequent route or peer relationship flapping.

You can run this command to terminate the session with a specified peer group and clear all related routing information. For a peer group, this means that a large number of sessions with the peers are terminated suddenly.

Configuration Impact

After a BGP session is successfully established, running the peer ignore command interrupts the BGP session. The interrupted BGP session cannot be established again, and the status of the corresponding BGP peer relationship is displayed as Idle.

Example

# Prohibit a device from establishing any session with the peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test
[HUAWEI-bgp-vpn1] peer test ignore

peer ignore (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer.

Format

peer ipv4-address ignore

undo peer ipv4-address ignore

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established because of the upgrade or link adjustment on the peer, you can run this command on the stabler end to prevent frequent route flapping or peer relationship.

You can run this command to terminate the session with a specified peer and clear all related routing information. In the case of a peer group, a large number of sessions are suddenly torn down.

Configuration Impact

After a BGP session is successfully established, running the peer ignore command interrupts the BGP session. The interrupted BGP session cannot be established again, and the status of the corresponding BGP peer relationship is displayed as Idle.

Example

# Prohibit a device from establishing any session with the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 ignore

peer ignore (BGP-VPN instance IPv6 address family view) (group)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer group.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer group.

Format

peer group-name ignore

undo peer group-name ignore

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established due to the upgrade or link adjustment of the peer end within a period of time, you can run this command on the stable end to temporarily interrupt the BGP peer relationship to prevent frequent route or peer relationship flapping.

You can run this command to terminate the session with a specified peer group and clear all related routing information. For a peer group, this means that a large number of sessions with the peers are terminated suddenly.

Configuration Impact

After a BGP session is successfully established, running the peer ignore command interrupts the BGP session. The interrupted BGP session cannot be established again, and the status of the corresponding BGP peer relationship is displayed as Idle.

Example

# Prohibit a device from establishing any session with peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test ignore

peer ignore (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer.

Format

peer ipv6-address ignore

undo peer ipv6-address ignore

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established due to the upgrade or link adjustment of the peer end within a period of time, you can run this command on the stable end to temporarily interrupt the BGP peer relationship to prevent frequent route or peer relationship flapping.

You can run this command to terminate the session with a specified peer and clear all related routing information. For a peer group, this means that a large number of sessions with the peers are terminated suddenly.

Example

# Prohibit a device from establishing any session with the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 ignore

peer ignore (BGP-VPN instance view) (group)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer group.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer group.

Format

peer group-name ignore

undo peer group-name ignore

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established due to the upgrade or link adjustment of the peer end within a period of time, you can run this command on the stable end to temporarily interrupt the BGP peer relationship to prevent frequent route or peer relationship flapping.

You can run this command to terminate the session with a specified peer group and clear all related routing information. For a peer group, this means that a large number of sessions with the peers are terminated suddenly.

Configuration Impact

After a BGP session is successfully established, running the peer ignore command interrupts the BGP session. The interrupted BGP session cannot be established again, and the status of the corresponding BGP peer relationship is displayed as Idle.

Example

# Prohibit a device from establishing any session with the peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test
[HUAWEI-bgp-instance-vpn1] peer test ignore

peer ignore (BGP-VPN instance view) (IPv6)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer.

Format

peer ipv6-address ignore

undo peer ipv6-address ignore

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established because of the upgrade or link adjustment on the peer, you can run this command on the stabler end to prevent frequent route flapping or peer relationship.

You can run this command to terminate the session with a specified peer and clear all related routing information. In the case of a peer group, a large number of sessions are suddenly torn down.

Configuration Impact

After a BGP session is successfully established, running the peer ignore command interrupts the BGP session. The interrupted BGP session cannot be established again, and the status of the corresponding BGP peer relationship is displayed as Idle.

Example

# Prohibit a device from establishing any session with the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 ignore

peer ignore (BGP-VPN instance view)(IPv4)

Function

The peer ignore command prevents a BGP device from establishing a session with a peer.

The undo peer ignore command cancels the configuration.

By default, a BGP device is allowed to establish a session with a BGP peer.

Format

peer ipv4-address ignore

undo peer ipv4-address ignore

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a peer session needs to be interrupted temporarily and a large number of configurations exist on the peer, you can run the peer ignore command to reduce the reconfiguration workload. For example, if the peer relationship is frequently established because of the upgrade or link adjustment on the peer, you can run this command on the stabler end to prevent frequent route flapping or peer relationship.

You can run this command to terminate the session with a specified peer and clear all related routing information. In the case of a peer group, a large number of sessions are suddenly torn down.

Configuration Impact

After a BGP session is successfully established, running the peer ignore command interrupts the BGP session. The interrupted BGP session cannot be established again, and the status of the corresponding BGP peer relationship is displayed as Idle.

Example

# Prohibit a device from establishing any session with the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 ignore

peer ip-prefix export (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer ip-prefix export command configures a policy based on an IP prefix list for filtering BGP routes to be advertised to a specified peer group.

The undo peer ip-prefix export command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name ip-prefix ip-prefix-name export

undo peer group-name ip-prefix [ ip-prefix-name ] export

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

ip-prefix ip-prefix-name

Specifies the name of an IP prefix list.

The value is a string of 1 to 169 case-sensitive characters. The character string can contain spaces if it is enclosed in double quotation marks ("").

export

Applies a filtering policy to the routes to be advertised to a peer group.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ip-prefix export command can be used to configure a route filtering policy that is based on an IP prefix list for filtering BGP routes to be advertised to a specified peer group, implementing route control.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

If an IP prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IP prefix list is specified for a peer group, the peers in the peer group filter routes based on the IP prefix list when advertising routes to peers. Only the routes that pass the filtering of the IP prefix list can be advertised.

Precautions

If you run both this command and the peer route-filter export command, the latest configuration overrides the previous one.

If the name of a filter (such as an IP prefix list, ACL, or route-policy) contains less than or equal to six characters and the name matches the first six characters of import, you only need to enter the keyword import when running the undo peer route-filter import command, without the need to enter the filter name.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix list1 permit 10.1.1.1 8 greater-equal 17 less-equal 18
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test ip-prefix list1 export

peer ip-prefix export (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer ip-prefix export command configures a policy based on an IP prefix list for filtering BGP routes to be advertised to a specified peer.

The undo peer ip-prefix export command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address ip-prefix ip-prefix-name export

undo peer ipv4-address ip-prefix [ ip-prefix-name ] export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

ip-prefix ip-prefix-name

Specifies the name of an IP prefix list.

The value is a string of 1 to 169 case-sensitive characters. The character string can contain spaces if it is enclosed in double quotation marks ("").

export

Applies a filtering policy to the routes to be advertised to a peer.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To filter routes to be advertised to a specified peer, you can run the peer ip-prefix export command to configure a route filtering policy based on an IP prefix list.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

After an IP prefix list is specified for a peer, the device filters routes based on the IP prefix list when advertising routes to the peer. Only the routes that pass the filtering of the IP prefix list can be advertised.

Precautions

If you run both this command and the peer route-filter export command, the latest configuration overrides the previous one.

If the name of a filter (such as an IP prefix list, ACL, or route-policy) contains less than or equal to six characters and the name matches the first six characters of import, you only need to enter the keyword import when running the undo peer route-filter import command, without the need to enter the filter name.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix list1 permit 0.0.0.0 32 greater-equal 32 less-equal 32
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 ip-prefix list1 export

peer ip-prefix export (BGP view) (group)

Function

The peer ip-prefix export command configures a policy based on an IP prefix list for filtering BGP routes to be advertised to a specified peer group.

The undo peer ip-prefix export command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer group.

Format

peer group-name ip-prefix ip-prefix-name export

undo peer group-name ip-prefix [ ip-prefix-name ] export

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

ip-prefix ip-prefix-name

Specifies the name of an IP address prefix list.

The value is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

export

Applies a filtering policy to the routes to be advertised to a peer group.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ip-prefix export command can be used to configure a route filtering policy that is based on an IP prefix list for filtering BGP routes to be advertised to a specified peer group, implementing route control.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

If an IP prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IP prefix list is specified for a peer group, the peers in the peer group filter routes based on the IP prefix list when advertising routes to peers. Only the routes that pass the filtering of the IP prefix list can be advertised.

Precautions

If you run both this command and the peer route-filter export command, the latest configuration overrides the previous one.

If the name of a filter (such as an IP prefix list, ACL, or route-policy) contains less than or equal to six characters and the name matches the first six characters of import, you only need to enter the keyword import when running the undo peer route-filter import command, without the need to enter the filter name.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix list1 permit 10.1.1.1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test ip-prefix list1 export

peer ip-prefix export (BGP view)(IPv4)

Function

The peer ip-prefix export command configures a policy based on an IP prefix list for filtering BGP routes to be advertised to a specified peer.

The undo peer ip-prefix export command cancels the configuration of a policy based on an IP prefix list for filtering BGP routes to be advertised to a specified peer.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv4-address ip-prefix ip-prefix-name export

undo peer ipv4-address ip-prefix [ ip-prefix-name ] export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ip-prefix ip-prefix-name

Specifies the name of an IP address prefix list.

The value is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

export

Applies a filtering policy to the routes to be advertised to a peer group.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To filter routes to be advertised to a specified peer, you can run the peer ip-prefix export command to configure a route filtering policy based on an IP prefix list.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

After an IP prefix list is specified for a peer, the device filters routes based on the IP prefix list when advertising routes to the peer. Only the routes that pass the filtering of the IP prefix list can be advertised.

Precautions

If you run both this command and the peer route-filter export command, the latest configuration overrides the previous one.

If the name of a filter (such as an IP prefix list, ACL, or route-policy) contains less than or equal to six characters and the name matches the first six characters of import, you only need to enter the keyword import when running the undo peer route-filter import command, without the need to enter the filter name.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix list1 permit 10.1.1.1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 ip-prefix list1 export

peer ip-prefix export (BGP-IPv4 unicast address family view) (group)

Function

The peer ip-prefix export command configures a policy based on an IP prefix list for filtering BGP routes to be advertised to a specified peer group.

The undo peer ip-prefix export command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer group.

Format

peer group-name ip-prefix ip-prefix-name export

undo peer group-name ip-prefix [ ip-prefix-name ] export

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

ip-prefix ip-prefix-name

Specifies the name of an IP address prefix list.

The value is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

export

Applies a filtering policy to the routes to be advertised to a peer group.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ip-prefix export command can be used to configure a route filtering policy that is based on an IP prefix list for filtering BGP routes to be advertised to a specified peer group, implementing route control.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

If an IP prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IP prefix list is specified for a peer group, the peers in the peer group filter routes based on the IP prefix list when advertising routes to peers. Only the routes that pass the filtering of the IP prefix list can be advertised.

Precautions

If you run both this command and the peer route-filter export command, the latest configuration overrides the previous one.

If the name of a filter (such as an IP prefix list, ACL, or route-policy) contains less than or equal to six characters and the name matches the first six characters of import, you only need to enter the keyword import when running the undo peer route-filter import command, without the need to enter the filter name.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix list1 permit 10.1.1.1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test ip-prefix list1 export

peer ip-prefix export (BGP-IPv4 unicast address family view)(IPv4)

Function

The peer ip-prefix export command configures a policy based on an IP prefix list for filtering BGP routes to be advertised to a specified peer.

The undo peer ip-prefix export command cancels the configuration of a policy based on an IP prefix list for filtering BGP routes to be advertised to a specified peer.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv4-address ip-prefix ip-prefix-name export

undo peer ipv4-address ip-prefix [ ip-prefix-name ] export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

ip-prefix ip-prefix-name

Specifies the name of an IP prefix list.

The value is a string of 1 to 169 case-sensitive characters. The character string can contain spaces if it is enclosed in double quotation marks ("").

export

Applies a filtering policy to the routes to be advertised to a peer.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To filter routes to be advertised to a specified peer, you can run the peer ip-prefix export command to configure a route filtering policy based on an IP prefix list.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

After an IP prefix list is specified for a peer, the device filters routes based on the IP prefix list when advertising routes to the peer. Only the routes that pass the filtering of the IP prefix list can be advertised.

Precautions

If you run both this command and the peer route-filter export command, the latest configuration overrides the previous one.

If the name of a filter (such as an IP prefix list, ACL, or route-policy) contains less than or equal to six characters and the name matches the first six characters of import, you only need to enter the keyword import when running the undo peer route-filter import command, without the need to enter the filter name.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix list1 permit 10.1.1.1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 ip-prefix list1 export

peer ip-prefix export (BGP-VPN instance IPv4 address family view) (group)

Function

The peer ip-prefix export command configures a policy based on an IP prefix list for filtering BGP routes to be advertised to a specified peer group.

The undo peer ip-prefix export command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer group.

Format

peer group-name ip-prefix ip-prefix-name export

undo peer group-name ip-prefix [ ip-prefix-name ] export

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

ip-prefix ip-prefix-name

Specifies the name of an IP prefix list.

The value is a string of 1 to 169 case-sensitive characters. The character string can contain spaces if it is enclosed in double quotation marks ("").

export

Applies a route-filter to the routes to be advertised to a specified peer group.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ip-prefix export command can be used to configure a route filtering policy that is based on an IP prefix list for filtering BGP routes to be advertised to a specified peer group, implementing route control.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

If an IP prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IP prefix list is specified for a peer group, the peers in the peer group filter routes based on the IP prefix list when advertising routes to peers. Only the routes that pass the filtering of the IP prefix list can be advertised.

Precautions

If you run both this command and the peer route-filter export command, the latest configuration overrides the previous one.

If the name of a filter (such as an IP prefix list, ACL, or route-policy) contains less than or equal to six characters and the name matches the first six characters of import, you only need to enter the keyword import when running the undo peer route-filter import command, without the need to enter the filter name.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] ip ip-prefix list1 permit 1.1.1.1 24
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group a
[HUAWEI-bgp-vpna] peer a ip-prefix list1 export

peer ip-prefix export (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer ip-prefix export command configures a policy based on an IP prefix list for filtering BGP routes to be advertised to a specified peer.

The undo peer ip-prefix export command cancels the configuration of a policy based on an IP prefix list for filtering BGP routes to be advertised to a specified peer.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv4-address ip-prefix ip-prefix-name export

undo peer ipv4-address ip-prefix [ ip-prefix-name ] export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ip-prefix ip-prefix-name

Specifies the name of an IP prefix list.

The value is a string of 1 to 169 case-sensitive characters. The character string can contain spaces if it is enclosed in double quotation marks ("").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To filter routes to be advertised to a specified peer, you can run the peer ip-prefix export command to configure a route filtering policy based on an IP prefix list.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

After an IP prefix list is specified for a peer, the device filters routes based on the IP prefix list when advertising routes to the peer. Only the routes that pass the filtering of the IP prefix list can be advertised.

Precautions

If you run both this command and the peer route-filter export command, the latest configuration overrides the previous one.

If the name of a filter (such as an IP prefix list, ACL, or route-policy) contains less than or equal to six characters and the name matches the first six characters of import, you only need to enter the keyword import when running the undo peer route-filter import command, without the need to enter the filter name.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] ip ip-prefix list1 permit 1.1.1.1 24
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 1.1.1.1 ip-prefix list1 export

peer ip-prefix import (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer ip-prefix import command configures a policy based on an IP prefix list for filtering BGP routes received from a specified peer group.

The undo peer ip-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name ip-prefix ip-prefix-name import

undo peer group-name ip-prefix [ ip-prefix-name ] import

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

ip-prefix ip-prefix-name

Specifies the name of an IP prefix list.

The value is a string of 1 to 169 case-sensitive characters. The character string can contain spaces if it is enclosed in double quotation marks ("").

import

Applies a filtering policy to the routes received from a peer group.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ip-prefix import command can be used to configure a route filtering policy that is based on an IP prefix list for filtering BGP routes to be received from a specified peer group, implementing route control.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

If an IP prefix list is specified for a peer group, all peers in the peer group inherit the configuration.

After an IP prefix list is specified for a peer group, the device filters the routes received from the peers in the peer group based on the IP prefix list and accepts only the routes that match the IP prefix list.

Precautions

If this command and the peer route-filter import command are both run, the latest configuration overrides the previous one. An IP prefix list, an ACL, or a route-policy can be specified in the latter command.

If the length of the filter name is less than or equal to six characters and the name matches the first six characters of export, the undo route-filter export command does not support the filter name. You only need to enter the keyword export.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix list1 permit 0.0.0.0 32 greater-equal 32 less-equal 32
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test ip-prefix list1 import

peer ip-prefix import (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer ip-prefix import command configures a policy based on an IP prefix list for filtering BGP routes received from a specified peer.

The undo peer ip-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address ip-prefix ip-prefix-name import

undo peer ipv4-address ip-prefix [ ip-prefix-name ] import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

ip-prefix ip-prefix-name

Specifies the name of an IP prefix list.

The value is a string of 1 to 169 case-sensitive characters. The character string can contain spaces if it is enclosed in double quotation marks ("").

import

Applies a filtering policy to the routes received from a specified peer.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ip-prefix import command can be used to configure a route filtering policy that is based on an IP prefix list for filtering BGP routes to be received from a specified peer, implementing route control.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

After an IP prefix list is specified for a peer, the device filters routes based on the IP prefix list when receiving routes from the peer. Only the routes that match the IP prefix list can be accepted.

Precautions

If this command and the peer route-filter import command are both run, the latest configuration overrides the previous one. An IP prefix list, an ACL, or a route-policy can be specified in the latter command.

If the length of the filter name is less than or equal to six characters and the name matches the first six characters of export, the undo route-filter export command does not support the filter name. You only need to enter the keyword export.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix list1 permit 0.0.0.0 32 greater-equal 32 less-equal 32
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 ip-prefix list1 import

peer ip-prefix import (BGP view) (group)

Function

The peer ip-prefix import command configures a policy based on an IP prefix list for filtering BGP routes received from a specified peer group.

The undo peer ip-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer group.

Format

peer group-name ip-prefix ip-prefix-name import

undo peer group-name ip-prefix [ ip-prefix-name ] import

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

ip-prefix ip-prefix-name

Specifies the name of an IP address prefix list.

The value is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

import

Applies a filtering policy to the routes received from a peer group.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ip-prefix import command can be used to configure a route filtering policy that is based on an IP prefix list for filtering BGP routes to be received from a specified peer group, implementing route control.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

If an IP prefix list is specified for a peer group, all peers in the peer group inherit the configuration.

After an IP prefix list is specified for a peer group, the device filters the routes received from the peers in the peer group based on the IP prefix list and accepts only the routes that match the IP prefix list.

Precautions

If this command and the peer route-filter import command are both run, the latest configuration overrides the previous one. An IP prefix list, an ACL, or a route-policy can be specified in the latter command.

If the length of the filter name is less than or equal to six characters and the name matches the first six characters of export, the undo route-filter export command does not support the filter name. You only need to enter the keyword export.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix list1 permit 10.1.1.1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test ip-prefix list1 import

peer ip-prefix import (BGP view)(IPv4)

Function

The peer ip-prefix import command configures a policy based on an IP prefix list for filtering BGP routes received from a specified peer.

The undo peer ip-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv4-address ip-prefix ip-prefix-name import

undo peer ipv4-address ip-prefix [ ip-prefix-name ] import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ip-prefix ip-prefix-name

Specifies the name of an IP address prefix list.

The value is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

import

Applies a filtering policy to the routes received from a peer group.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ip-prefix import command can be used to configure a route filtering policy that is based on an IP prefix list for filtering BGP routes to be received from a specified peer, implementing route control.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

After an IP prefix list is specified for a peer, the device filters routes based on the IP prefix list when receiving routes from the peer. Only the routes that match the IP prefix list can be accepted.

Precautions

If this command and the peer route-filter import command are both run, the latest configuration overrides the previous one. An IP prefix list, an ACL, or a route-policy can be specified in the latter command.

If the length of the filter name is less than or equal to six characters and the name matches the first six characters of export, the undo route-filter export command does not support the filter name. You only need to enter the keyword export.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix list1 permit 10.1.1.1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 ip-prefix list1 import

peer ip-prefix import (BGP-IPv4 unicast address family view) (group)

Function

The peer ip-prefix import command configures a policy based on an IP prefix list for filtering BGP routes received from a specified peer group.

The undo peer ip-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer group.

Format

peer group-name ip-prefix ip-prefix-name import

undo peer group-name ip-prefix [ ip-prefix-name ] import

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

ip-prefix ip-prefix-name

Specifies the name of an IP address prefix list.

The value is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

import

Applies a filtering policy to the routes received from a peer group.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ip-prefix import command can be used to configure a route filtering policy that is based on an IP prefix list for filtering BGP routes to be received from a specified peer group, implementing route control.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

If an IP prefix list is specified for a peer group, all peers in the peer group inherit the configuration.

After an IP prefix list is specified for a peer group, the device filters the routes received from the peers in the peer group based on the IP prefix list and accepts only the routes that match the IP prefix list.

Precautions

If this command and the peer route-filter import command are both run, the latest configuration overrides the previous one. An IP prefix list, an ACL, or a route-policy can be specified in the latter command.

If the length of the filter name is less than or equal to six characters and the name matches the first six characters of export, the undo route-filter export command does not support the filter name. You only need to enter the keyword export.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix list1 permit 10.1.1.1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test ip-prefix list1 import

peer ip-prefix import (BGP-IPv4 unicast address family view)(IPv4)

Function

The peer ip-prefix import command configures a policy based on an IP prefix list for filtering BGP routes received from a specified peer.

The undo peer ip-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv4-address ip-prefix ip-prefix-name import

undo peer ipv4-address ip-prefix [ ip-prefix-name ] import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

ip-prefix ip-prefix-name

Specifies the name of an IP prefix list.

The value is a string of 1 to 169 case-sensitive characters. The character string can contain spaces if it is enclosed in double quotation marks ("").

import

Applies a filtering policy to the routes received from a peer.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ip-prefix import command can be used to configure a route filtering policy that is based on an IP prefix list for filtering BGP routes to be received from a specified peer, implementing route control.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

After an IP prefix list is specified for a peer, the device filters routes based on the IP prefix list when receiving routes from the peer. Only the routes that match the IP prefix list can be accepted.

Precautions

If this command and the peer route-filter import command are both run, the latest configuration overrides the previous one. An IP prefix list, an ACL, or a route-policy can be specified in the latter command.

If the length of the filter name is less than or equal to six characters and the name matches the first six characters of export, the undo route-filter export command does not support the filter name. You only need to enter the keyword export.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix list1 permit 10.1.1.1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 ip-prefix list1 import

peer ip-prefix import (BGP-VPN instance IPv4 address family view) (group)

Function

The peer ip-prefix import command configures a policy based on an IP prefix list for filtering BGP routes received from a specified peer group.

The undo peer ip-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer group.

Format

peer group-name ip-prefix ip-prefix-name import

undo peer group-name ip-prefix [ ip-prefix-name ] import

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

ip-prefix ip-prefix-name

Specifies the name of an IP address prefix list.

The value is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

import

Applies a filtering policy to the routes received from a peer group.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ip-prefix import command can be used to configure a route filtering policy that is based on an IP prefix list for filtering BGP routes to be received from a specified peer group, implementing route control.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

If an IP prefix list is specified for a peer group, all peers in the peer group inherit the configuration.

After an IP prefix list is specified for a peer group, the device filters the routes received from the peers in the peer group based on the IP prefix list and accepts only the routes that match the IP prefix list.

Precautions

If this command and the peer route-filter import command are both run, the latest configuration overrides the previous one. An IP prefix list, an ACL, or a route-policy can be specified in the latter command.

If the length of the filter name is less than or equal to six characters and the name matches the first six characters of export, the undo route-filter export command does not support the filter name. You only need to enter the keyword export.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip ip-prefix list1 permit 1.1.1.1 32
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group a
[HUAWEI-bgp-vpna] peer a ip-prefix list1 import

peer ip-prefix import (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer ip-prefix import command configures a policy based on an IP prefix list for filtering BGP routes received from a specified peer.

The undo peer ip-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv4-address ip-prefix ip-prefix-name import

undo peer ipv4-address ip-prefix [ ip-prefix-name ] import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ip-prefix ip-prefix-name

Specifies the name of an IP address prefix list.

The value is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

import

Applies a filtering policy to the routes received from a peer group.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ip-prefix import command can be used to configure a route filtering policy that is based on an IP prefix list for filtering BGP routes to be received from a specified peer, implementing route control.

Prerequisites

If the peer ip-prefix command specifies an IP prefix list that does not exist for a peer, use the ip ip-prefix command to create an IP prefix list.

Configuration Impact

After an IP prefix list is specified for a peer, the device filters routes based on the IP prefix list when receiving routes from the peer. Only the routes that match the IP prefix list can be accepted.

Precautions

If this command and the peer route-filter import command are both run, the latest configuration overrides the previous one. An IP prefix list, an ACL, or a route-policy can be specified in the latter command.

If the length of the filter name is less than or equal to six characters and the name matches the first six characters of export, the undo route-filter export command does not support the filter name. You only need to enter the keyword export.

Example

# Configure a route filtering policy based on an IP prefix list.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] ip ip-prefix list1 permit 1.1.1.1 24
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 1.1.1.1 ip-prefix list1 import

peer ipv6-prefix export (BGP-IPv6 unicast address family view) (group)

Function

The peer ipv6-prefix export command configures a policy based on an IPv6 prefix list for filtering BGP routes to be advertised to a specified peer group.

The undo peer ipv6-prefix export command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer group.

Format

peer group-name ipv6-prefix ipv6-prefix-name export

undo peer group-name ipv6-prefix [ ipv6-prefix-name ] export

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

ipv6-prefix ipv6-prefix-name

Indicates the filtering policy that is based on the IPv6 prefix list of the peer.

The name is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

export

Applies a filtering policy to the routes to be advertised to a peer group.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ipv6-prefix export command can be used to configure a route filtering policy that is based on an IPv6 prefix list to filter routes to be advertised, implementing route control.

Prerequisites

If the peer ipv6-prefix command specifies an IPv6 prefix list that does not exist for a peer group, use the ip ipv6-prefix command to create an IPv6 prefix list.

Configuration Impact

If an IPv6 prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IPv6 prefix list is specified for a peer group, the peers in the peer group filter the routes to be advertised to other peers based on the IPv6 prefix list. Only the routes that pass the filtering of the IPv6 prefix list can be advertised.

Precautions

The peer ipv6-prefix export command is mutually exclusive with the peer route-filter export commands.

Example

# Configure a route filtering policy based on an IPv6 prefix list.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix list1 permit 2001:DB8:1::1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test ipv6-prefix list1 export

peer ipv6-prefix export (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer ipv6-prefix export command configures a policy based on an IPv6 prefix list for filtering BGP routes to be advertised to a specified peer.

The undo peer ipv6-prefix export command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv6-address ipv6-prefix ipv6-prefix-name export

undo peer ipv6-address ipv6-prefix [ ipv6-prefix-name ] export

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is in the format of X:X:X:X:X:X:X:X.

ipv6-prefix ipv6-prefix-name

Indicates the filtering policy that is based on the IPv6 prefix list of the peer.

The name is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

export

Applies a filtering policy to the routes to be advertised to a peer group.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To filter routes to be advertised to a specified peer, run the peer ipv6-prefix export command to configure a route filtering policy based on an IPv6 prefix list.

Prerequisites

If the peer ipv6-prefix command specifies an IPv6 prefix list that does not exist for a peer, use the ip ipv6-prefix command to create an IPv6 prefix list.

Configuration Impact

If an IPv6 prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IPv6 prefix list is specified for a peer, the peer filter the routes to be advertised to other peers based on the IPv6 prefix list. Only the routes that pass the filtering of the IPv6 prefix list can be advertised.

Precautions

The peer ipv6-prefix export command is mutually exclusive with the peer route-filter export commands.

Example

# Configure a route filtering policy based on an IPv6 prefix list.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix list1 permit 2001:DB8:1::1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 ipv6-prefix list1 export

peer ipv6-prefix export (BGP-IPv6 unicast address family view)(IPv4)

Function

The peer ipv6-prefix export command configures a policy based on an IPv6 prefix list for filtering BGP routes to be advertised to a specified peer.

The undo peer ipv6-prefix export command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv4-address ipv6-prefix ipv6-prefix-name export

undo peer ipv4-address ipv6-prefix [ ipv6-prefix-name ] export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ipv6-prefix ipv6-prefix-name

Indicates the filtering policy that is based on the IPv6 prefix list of the peer.

The name is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

export

Applies a filtering policy to the routes to be advertised to a peer.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To filter routes to be advertised to a specified peer, run the peer ipv6-prefix export command to configure a route filtering policy based on an IPv6 prefix list.

Prerequisites

If the peer ipv6-prefix command specifies an IPv6 prefix list that does not exist for a peer, use the ip ipv6-prefix command to create an IPv6 prefix list.

Configuration Impact

If an IPv6 prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IPv6 prefix list is specified for a peer, the peer filter the routes to be advertised to other peers based on the IPv6 prefix list. Only the routes that pass the filtering of the IPv6 prefix list can be advertised.

Precautions

The peer ipv6-prefix export command is mutually exclusive with the peer route-filter export commands.

Example

# Configure a route filtering policy based on an IPv6 prefix list.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix list1 permit 1::1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.2 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.2 ipv6-prefix list1 export

peer ipv6-prefix export (BGP-VPN instance IPv6 address family view) (group)

Function

The peer ipv6-prefix export command configures a policy based on an IPv6 prefix list for filtering BGP routes to be advertised to a specified peer group.

The undo peer ipv6-prefix export command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer group.

Format

peer group-name ipv6-prefix ipv6-prefix-name export

undo peer group-name ipv6-prefix [ ipv6-prefix-name ] export

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

ipv6-prefix ipv6-prefix-name

Indicates the filtering policy that is based on the IPv6 prefix list of the peer group.

The name is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

export

Applies a route-filter to the routes to be advertised to a specified peer group.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ipv6-prefix export command can be used to configure a route filtering policy that is based on an IPv6 prefix list to filter routes to be advertised, implementing route control.

Prerequisites

If the peer ipv6-prefix command specifies an IPv6 prefix list that does not exist for a peer group, use the ip ipv6-prefix command to create an IPv6 prefix list.

Configuration Impact

If an IPv6 prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IPv6 prefix list is specified for a peer group, the peers in the peer group filter the routes to be advertised to other peers based on the IPv6 prefix list. Only the routes that pass the filtering of the IPv6 prefix list can be advertised.

Precautions

The peer ipv6-prefix export command is mutually exclusive with the peer route-filter export commands.

Example

# Configure a route filtering policy based on an IPv6 prefix list.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix list1 permit 2001:DB8:1::1 8 greater-equal 17 less-equal 18
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test ipv6-prefix list1 export

peer ipv6-prefix export (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer ipv6-prefix export command configures a policy based on an IPv6 prefix list for filtering BGP routes to be advertised to a specified peer.

The undo peer ipv6-prefix export command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv6-address ipv6-prefix ipv6-prefix-name export

undo peer ipv6-address ipv6-prefix [ ipv6-prefix-name ] export

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is in the format of X:X:X:X:X:X:X:X.

ipv6-prefix ipv6-prefix-name

Indicates the filtering policy that is based on the IPv6 prefix list of the peer.

The name is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

export

Applies a filtering policy to the routes to be advertised to a peer.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To filter routes to be advertised to a specified peer, run the peer ipv6-prefix export command to configure a route filtering policy based on an IPv6 prefix list.

Prerequisites

If the peer ipv6-prefix command specifies an IPv6 prefix list that does not exist for a peer, use the ip ipv6-prefix command to create an IPv6 prefix list.

Configuration Impact

If an IPv6 prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IPv6 prefix list is specified for a peer, the peer filter the routes to be advertised to other peers based on the IPv6 prefix list. Only the routes that pass the filtering of the IPv6 prefix list can be advertised.

Precautions

The peer ipv6-prefix export command is mutually exclusive with the peer route-filter export commands.

Example

# Configure a route filtering policy based on an IPv6 prefix list.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix list1 permit 2001:DB8:1::1 8 greater-equal 17 less-equal 18
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 ipv6-prefix list1 export

peer ipv6-prefix export (BGP-VPN instance IPv6 address family view)(IPv4)

Function

The peer ipv6-prefix export command configures a policy based on an IPv6 prefix list for filtering BGP routes to be advertised to a specified peer.

The undo peer ipv6-prefix export command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv4-address ipv6-prefix ipv6-prefix-name export

undo peer ipv4-address ipv6-prefix [ ipv6-prefix-name ] export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ipv6-prefix ipv6-prefix-name

Indicates the filtering policy that is based on the IPv6 prefix list of the peer.

The name is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

export

Applies a filtering policy to the routes to be advertised to a peer.

-

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To filter routes to be advertised to a specified peer, run the peer ipv6-prefix export command to configure a route filtering policy based on an IPv6 prefix list.

Prerequisites

If the peer ipv6-prefix command specifies an IPv6 prefix list that does not exist for a peer, use the ip ipv6-prefix command to create an IPv6 prefix list.

Configuration Impact

If an IPv6 prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IPv6 prefix list is specified for a peer, the peer filter the routes to be advertised to other peers based on the IPv6 prefix list. Only the routes that pass the filtering of the IPv6 prefix list can be advertised.

Precautions

The peer ipv6-prefix export command is mutually exclusive with the peer route-filter export commands.

Example

# Configure a route filtering policy based on an IPv6 prefix list.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix list1 permit 2001:DB8:1::1 8 greater-equal 17 less-equal 18
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 ipv6-prefix list1 export

peer ipv6-prefix import (BGP-IPv6 unicast address family view)

Function

The peer ipv6-prefix import command configures a policy based on an IPv6 prefix list for filtering BGP routes received from a specified peer.

The undo peer ipv6-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv4-address ipv6-prefix ipv6-prefix-name import

undo peer ipv4-address ipv6-prefix [ ipv6-prefix-name ] import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ipv6-prefix ipv6-prefix-name

Indicates the filtering policy that is based on the IPv6 prefix list of the peer or peer group.

The value is a string of 1 to 169 case-sensitive characters. It cannot contain spaces. The string can contain spaces if it is enclosed with double quotation marks (").

import

Applies a filtering policy to the routes received from a peer group.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ipv6-prefix import command can be used to configure a route filtering policy that is based on an IPv6 prefix list for filtering BGP routes to be received from a specified peer, implementing route control.

Prerequisites

If the peer ipv6-prefix command specifies an IPv6 prefix list that does not exist for a peer, use the ip ipv6-prefix command to create an IPv6 prefix list.

Configuration Impact

If an IPv6 prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IPv6 prefix list is specified for a peer, the peer filter the routes to be received from other peers based on the IPv6 prefix list. Only the routes that pass the filtering of the IPv6 prefix list can be received.

Precautions

The peer ipv6-prefix import command is mutually exclusive with the peer route-filter import commands.

Example

# Configure a route filtering policy based on an IPv6 prefix list.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix list1 permit 2001:DB8:1::1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.2 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.2 ipv6-prefix list1 import

peer ipv6-prefix import (BGP-IPv6 unicast address family view) (group)

Function

The peer ipv6-prefix import command configures a policy based on an IPv6 prefix list for filtering BGP routes received from a specified peer group.

The undo peer ipv6-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer group.

Format

peer group-name ipv6-prefix ipv6-prefix-name import

undo peer group-name ipv6-prefix [ ipv6-prefix-name ] import

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

ipv6-prefix ipv6-prefix-name

Indicates the filtering policy that is based on the IPv6 prefix list of the peer or peer group.

The value is a string of 1 to 169 case-sensitive characters. It cannot contain spaces. The string can contain spaces if it is enclosed with double quotation marks (").

import

Applies a filtering policy to the routes received from a peer group.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ipv6-prefix command can be used to configure a route filtering policy that is based on an IPv6 prefix list to filter routes received from a specified peer, implementing route control.

Prerequisites

If the peer ipv6-prefix command specifies an IPv6 prefix list that does not exist for a peer group, use the ip ipv6-prefix command to create an IPv6 prefix list.

Configuration Impact

If an IPv6 prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IPv6 prefix list is specified for a peer group, the peers in the peer group filter the routes to be received from other peers based on the IPv6 prefix list. Only the routes that pass the filtering of the IPv6 prefix list can be received.

Precautions

The peer ipv6-prefix import command is mutually exclusive with the peer route-filter import commands.

Example

# Configure a route filtering policy based on an IPv6 prefix list.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix list1 permit 1::1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.2 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.2 ipv6-prefix list1 import

peer ipv6-prefix import (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer ipv6-prefix import command configures a policy based on an IPv6 prefix list for filtering BGP routes received from a specified peer.

The undo peer ipv6-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv6-address ipv6-prefix ipv6-prefix-name import

undo peer ipv6-address ipv6-prefix [ ipv6-prefix-name ] import

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

ipv6-prefix ipv6-prefix-name

Indicates the filtering policy that is based on the IPv6 prefix list of the peer or peer group.

The value is a string of 1 to 169 case-sensitive characters. It cannot contain spaces. The string can contain spaces if it is enclosed with double quotation marks (").

import

Applies a filtering policy to the routes received from a peer group.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ipv6-prefix import command can be used to configure a route filtering policy that is based on an IPv6 prefix list for filtering BGP routes to be received from a specified peer, implementing route control.

Prerequisites

If the peer ipv6-prefix command specifies an IPv6 prefix list that does not exist for a peer, use the ip ipv6-prefix command to create an IPv6 prefix list.

Configuration Impact

If an IPv6 prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IPv6 prefix list is specified for a peer, the peer filter the routes to be received from other peers based on the IPv6 prefix list. Only the routes that pass the filtering of the IPv6 prefix list can be received.

Precautions

The peer ipv6-prefix import command is mutually exclusive with the peer route-filter import commands.

Example

# Configure a route filtering policy based on an IPv6 prefix list.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix list1 permit 2001:DB8:1::1 8 greater-equal 17 less-equal 18
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 ipv6-prefix list1 import

peer ipv6-prefix import (BGP-VPN instance IPv6 address family view)

Function

The peer ipv6-prefix import command configures a policy based on an IPv6 prefix list for filtering BGP routes received from a specified peer.

The undo peer ipv6-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv4-address ipv6-prefix ipv6-prefix-name import

undo peer ipv4-address ipv6-prefix [ ipv6-prefix-name ] import

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

ipv6-prefix ipv6-prefix-name

Indicates the filtering policy that is based on the IPv6 prefix list of the peer or peer group.

The name is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

import

Applies a filtering policy to the routes received from a peer.

-

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ipv6-prefix import command can be used to configure a route filtering policy that is based on an IPv6 prefix list for filtering BGP routes to be received from a specified peer, implementing route control.

Prerequisites

If the peer ipv6-prefix command specifies an IPv6 prefix list that does not exist for a peer, use the ip ipv6-prefix command to create an IPv6 prefix list.

Configuration Impact

If an IPv6 prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IPv6 prefix list is specified for a peer, the peer filter the routes to be received from other peers based on the IPv6 prefix list. Only the routes that pass the filtering of the IPv6 prefix list can be received.

Precautions

The peer ipv6-prefix import command is mutually exclusive with the peer route-filter import commands.

Example

# Configure a route filtering policy based on an IPv6 prefix list.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix list1 permit 2001:DB8:1::1 8 greater-equal 17 less-equal 18
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 ipv6-prefix list1 import

peer ipv6-prefix import (BGP-VPN instance IPv6 address family view) (group)

Function

The peer ipv6-prefix import command configures a policy based on an IPv6 prefix list for filtering BGP routes received from a specified peer group.

The undo peer ipv6-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer group.

Format

peer group-name ipv6-prefix ipv6-prefix-name import

undo peer group-name ipv6-prefix [ ipv6-prefix-name ] import

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

ipv6-prefix ipv6-prefix-name

An IPv6 prefix list-based route filtering policy is configured for the peer.

The value is a string of 1 to 169 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed in double quotation marks ("").

import

Applies a filtering policy to the routes received from a specified peer.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ipv6-prefix command can be used to configure a route filtering policy that is based on an IPv6 prefix list to filter routes received from a specified peer, implementing route control.

Prerequisites

If the peer ipv6-prefix command specifies an IPv6 prefix list that does not exist for a peer group, use the ip ipv6-prefix command to create an IPv6 prefix list.

Configuration Impact

If an IPv6 prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IPv6 prefix list is specified for a peer group, the peers in the peer group filter the routes to be received from other peers based on the IPv6 prefix list. Only the routes that pass the filtering of the IPv6 prefix list can be received.

Precautions

The peer ipv6-prefix import command is mutually exclusive with the peer route-filter import commands.

Example

# Configure a route filtering policy based on an IPv6 prefix list.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix list1 permit 2001:DB8:1::1 8 greater-equal 17 less-equal 18
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test ipv6-prefix list1 import

peer ipv6-prefix import (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer ipv6-prefix import command configures a policy based on an IPv6 prefix list for filtering BGP routes received from a specified peer.

The undo peer ipv6-prefix import command cancels this configuration.

By default, no route filtering policy based on an IP address prefix list is configured for a peer.

Format

peer ipv6-address ipv6-prefix ipv6-prefix-name import

undo peer ipv6-address ipv6-prefix [ ipv6-prefix-name ] import

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is in the format of X:X:X:X:X:X:X:X.

ipv6-prefix ipv6-prefix-name

Indicates the filtering policy that is based on the IPv6 prefix list of the peer.

The name is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

import

Applies a filtering policy to the routes received from a peer.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer ipv6-prefix import command can be used to configure a route filtering policy that is based on an IPv6 prefix list for filtering BGP routes to be received from a specified peer, implementing route control.

Prerequisites

If the peer ipv6-prefix command specifies an IPv6 prefix list that does not exist for a peer, use the ip ipv6-prefix command to create an IPv6 prefix list.

Configuration Impact

If an IPv6 prefix list is specified for a peer group, all the members of the peer group inherit the configuration.

After an IPv6 prefix list is specified for a peer, the peer filter the routes to be received from other peers based on the IPv6 prefix list. Only the routes that pass the filtering of the IPv6 prefix list can be received.

Precautions

The peer ipv6-prefix import command is mutually exclusive with the peer route-filter import commands.

Example

# Configure a route filtering policy based on an IPv6 prefix list.
<HUAWEI> system-view
[HUAWEI] ip ipv6-prefix list1 permit 2001:DB8:1::1 8 greater-equal 17 less-equal 18
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 ipv6-prefix list1 import

peer keep-all-routes (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peers and passing the configured ingress policy are saved.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address keep-all-routes

undo peer ipv4-address keep-all-routes

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to store all BGP routing updates received from its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 keep-all-routes

peer keep-all-routes (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peer group and passing the configured ingress policy are saved.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name keep-all-routes

undo peer group-name keep-all-routes

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to store all BGP routing updates received from its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test keep-all-routes

peer keep-all-routes (BGP view)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peers and passing the configured ingress policy are saved.

Format

peer ipv4-address keep-all-routes

undo peer ipv4-address keep-all-routes

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to store all BGP routing updates received from its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.1 as-number 100
[HUAWEI-bgp] peer 1.1.1.1 keep-all-routes

peer keep-all-routes (BGP view) (group)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peer group and passing the configured ingress policy are saved.

Format

peer group-name keep-all-routes

undo peer group-name keep-all-routes

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to store all BGP routing updates received from its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test keep-all-routes

peer keep-all-routes (BGP-IPv4 unicast address family view)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peers and passing the configured ingress policy are saved.

Format

peer ipv4-address keep-all-routes

undo peer ipv4-address keep-all-routes

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to save all BGP routing updates received from its peers.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 1.1.1.1 keep-all-routes

peer keep-all-routes (BGP-IPv4 unicast address family view) (group)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peers and passing the configured ingress policy are saved.

Format

peer group-name keep-all-routes

undo peer group-name keep-all-routes

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to store all BGP routing updates received from its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test keep-all-routes

peer keep-all-routes (BGP-IPv6 unicast address family view)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peers and passing the configured ingress policy are saved.

Format

peer ipv4-address keep-all-routes

undo peer ipv4-address keep-all-routes

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to save all BGP routing updates received from its peers.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 1.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 1.1.1.1 keep-all-routes

peer keep-all-routes (BGP-IPv6 unicast address family view) (group)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peers and passing the configured ingress policy are saved.

Format

peer group-name keep-all-routes

undo peer group-name keep-all-routes

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to store all BGP routing updates received from its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test keep-all-routes

peer keep-all-routes (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peers and passing the configured ingress policy are saved.

Format

peer ipv6-address keep-all-routes

undo peer ipv6-address keep-all-routes

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to save all BGP routing updates received from its peers.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 keep-all-routes

peer keep-all-routes (BGP-VPN instance IPv4 address family view)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peers and passing the configured ingress policy are saved.

Format

peer ipv4-address keep-all-routes

undo peer ipv4-address keep-all-routes

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to store all BGP routing updates received from its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 1.1.1.1 keep-all-routes

peer keep-all-routes (BGP-VPN instance IPv4 address family view) (group)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peer group and passing the configured ingress policy are saved.

Format

peer group-name keep-all-routes

undo peer group-name keep-all-routes

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to store all BGP routing updates received from its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test keep-all-routes

peer keep-all-routes (BGP-VPN instance IPv6 address family view)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peers and passing the configured ingress policy are saved.

Format

peer ipv4-address keep-all-routes

undo peer ipv4-address keep-all-routes

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to store all BGP routing updates received from its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 1.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 1.1.1.1 keep-all-routes

peer keep-all-routes (BGP-VPN instance IPv6 address family view) (group)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peer group and passing the configured ingress policy are saved.

Format

peer group-name keep-all-routes

undo peer group-name keep-all-routes

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to store all BGP routing updates received from its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test keep-all-routes

peer keep-all-routes (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer keep-all-routes command saves all the BGP routing updates from the specified peer or the peer group after the BGP connection is set up, even though those routes do not pass the configured ingress policy.

The undo peer keep-all-routes command disables this function.

By default, only the BGP routing updates received from the peers and passing the configured ingress policy are saved.

Format

peer ipv6-address keep-all-routes

undo peer ipv6-address keep-all-routes

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a BGP peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After changing a BGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these BGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure a device to store all BGP routing updates received from its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 keep-all-routes

peer keychain (BGP multi-instance view)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address keychain keychain-name

undo peer ipv4-address keychain

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

If the dependent keychain is deleted, the neighbor relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-insensitive characters. The string does not contain question marks or spaces. The string can contain spaces if it is enclosed in double quotation marks (").

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for the peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 10.1.1.1 keychain keychain_1

peer keychain (BGP multi-instance view) (group)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name keychain keychain-name

undo peer group-name keychain

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

If the dependent keychain is deleted, the neighbor relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-insensitive characters, It cannot contain question marks (?). If spaces are used, the string must start and end with double quotation marks (&quot;).

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for a peer group.
<HUAWEI> system-view
[HUAWEI] keychain a mode periodic daily
[HUAWEI-keychain-a] quit
[HUAWEI] bgp 100 instanc a
[HUAWEI-bgp-instance-a] group test
[HUAWEI-bgp-instance-a] peer test keychain keychain_1

peer keychain (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address keychain keychain-name

undo peer ipv4-address keychain

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

If the dependent keychain is deleted, the neighbor relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-insensitive characters. The string does not contain question marks or spaces. The string can contain spaces if it is enclosed in double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] keychain keychain_1 mode periodic daily
[HUAWEI-keychain-keychain_1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 keychain keychain_1

peer keychain (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name keychain keychain-name

undo peer group-name keychain

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

If the dependent keychain is deleted, the neighbor relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-insensitive characters. The string does not contain question marks or spaces. The string can contain spaces if it is enclosed in double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] keychain keychain_1 mode periodic daily
[HUAWEI-keychain-keychain_1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test keychain keychain_1

peer keychain (BGP view)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

Format

peer ipv4-address keychain keychain-name

undo peer ipv4-address keychain

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

If the dependent keychain is deleted, the neighbor relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-insensitive characters, It cannot contain question marks (?). If spaces are used, the string must start and end with double quotation marks (&quot;).

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for the peer.
<HUAWEI> system-view
[HUAWEI] keychain keychain_1 mode periodic daily
[HUAWEI-keychain-keychain_1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 keychain keychain_1

peer keychain (BGP view) (group)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

Format

peer group-name keychain keychain-name

undo peer group-name keychain

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

If the dependent keychain is deleted, the neighbor relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-insensitive characters. The string does not contain question marks or spaces. The string can contain spaces if it is enclosed in double quotation marks (").

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for a peer group.
<HUAWEI> system-view
[HUAWEI] keychain keychain_1 mode periodic daily
[HUAWEI-keychain-keychain_1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test keychain keychain_1

peer keychain (BGP view) (IPv6)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

Format

peer ipv6-address keychain keychain-name

undo peer ipv6-address keychain

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

If the dependent keychain is deleted, the neighbor relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-insensitive characters, It cannot contain question marks (?). If spaces are used, the string must start and end with double quotation marks (&quot;).

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for the peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] peer 2001:DB8:1::1 keychain keychain_1

peer keychain (BGP-VPN instance IPv4 address family view)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

Format

peer ipv4-address keychain keychain-name

undo peer ipv4-address keychain

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

keychain-name

Specifies the name of the keychain.

Before configuring keychain authentication, run the keychain command to create a keychain, the key-id command to configure a key ID, the key-string command to configure a password, and the algorithm command to configure an algorithm for the keychain. If these commands are not run, the keychain authentication fails, and the peer relationship cannot be established.

If the dependent keychain is deleted, the peer relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-insensitive characters. The string cannot contain question marks (?) or spaces. However, when double quotation marks ("") are used around the string, spaces are allowed in the string.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] keychain keychain_1 mode periodic daily
[HUAWEI-keychain-keychain_1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 keychain keychain_1

peer keychain (BGP-VPN instance IPv4 address family view) (group)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

Format

peer group-name keychain keychain-name

undo peer group-name keychain

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

If the dependent keychain is deleted, the neighbor relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-insensitive characters. The string does not contain question marks or spaces. The string can contain spaces if it is enclosed in double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] keychain keychain_1 mode periodic daily
[HUAWEI-keychain-keychain_1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test
[HUAWEI-bgp-vpn1] peer test keychain keychain_1

peer keychain (BGP-VPN instance IPv6 address family view) (group)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

Format

peer group-name keychain keychain-name

undo peer group-name keychain

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

If the dependent keychain is deleted, the neighbor relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-sensitive characters without any space. When double quotation marks are used around the string, spaces are allowed in the string.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] keychain keychain_1 mode periodic daily
[HUAWEI-keychain-keychain_1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test keychain keychain_1

peer keychain (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

Format

peer ipv6-address keychain keychain-name

undo peer ipv6-address keychain

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

If the dependent keychain is deleted, the neighbor relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-insensitive characters, It cannot contain question marks (?). If spaces are used, the string must start and end with double quotation marks (&quot;).

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] keychain keychain_1 mode periodic daily
[HUAWEI-keychain-keychain_1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 keychain keychain_1

peer keychain (BGP-VPN instance view)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

Format

peer ipv4-address keychain keychain-name

undo peer ipv4-address keychain

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

If the dependent keychain is deleted, the neighbor relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-insensitive characters, It cannot contain question marks (?). If spaces are used, the string must start and end with double quotation marks (&quot;).

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] keychain keychain_1 mode periodic daily
[HUAWEI-keychain-keychain_1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 keychain keychain_1

peer keychain (BGP-VPN instance view) (group)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

Format

peer group-name keychain keychain-name

undo peer group-name keychain

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

If the dependent keychain is deleted, the neighbor relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-insensitive characters, It cannot contain question marks (?). If spaces are used, the string must start and end with double quotation marks (&quot;).

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] keychain keychain_1 mode periodic daily
[HUAWEI-keychain-keychain_1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test
[HUAWEI-bgp-instance-vpn1] peer test keychain keychain_1

peer keychain (BGP-VPN instance view) (IPv6)

Function

The peer keychain command configures the Keychain authentication for establishing the TCP connection between BGP peers.

The undo peer keychain command deletes the Keychain authentication.

By default, the Keychain authentication is not configured for BGP peers.

Format

peer ipv6-address keychain keychain-name

undo peer ipv6-address keychain

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

If the dependent keychain is deleted, the neighbor relationship may be interrupted. Therefore, exercise caution when deleting the keychain.

The value is a string of 1 to 47 case-insensitive characters, It cannot contain question marks (?). If spaces are used, the string must start and end with double quotation marks (&quot;).

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Configuring Keychain authentication improves the security of the TCP connection. You must configure Keychain authentication specified for TCP-based applications on both BGP peers. Note that encryption algorithms and passwords configured for the Keychain authentication on both peers must be the same; otherwise, the TCP connection cannot be set up between BGP peers and BGP messages cannot be transmitted.

Prerequisites

Before configuring the BGP Keychain authentication, a Keychain in accordance with the configured keychain-name must be configured first.

Precautions

The peer keychain command and the peer password command are mutually exclusive.

Example

# Configure keychain authentication named keychain_1 for the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] keychain keychain_1 mode periodic daily
[HUAWEI-keychain-keychain_1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 keychain keychain_1

peer listen-as

Function

The peer listen-as command specifies a peer AS from which a dynamic EBGP peer group listens for BGP connection requests.

The undo peer listen-as command deletes the specified peer AS from which a dynamic EBGP peer group listens for BGP connection requests.

By default, no peer AS from which a dynamic EBGP peer group listens for BGP connection requests is specified.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name listen-as { asn } &<1-6>

undo peer group-name listen-as { asn } &<1-6>

Parameters

Parameter Description Value
group-name

Specifies the name of a dynamic BGP peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

asn

Specifies the AS number.

A 2-byte AS number is an integer ranging from 1 to 65535.

A 4-byte AS number can be: An integer ranging from 65536 to 4294967295. In the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The dynamic BGP peer function enables BGP to listen for BGP connection requests from a specified network segment, dynamically establish BGP peer relationships, and add these peers to the same dynamic peer group. This spares you from adding or deleting BGP peer configurations in response to each change in dynamic peers. To specify a peer AS from which a dynamic EBGP peer group listens for BGP connection requests, run the peer listen-as command.

Prerequisites

A dynamic EBGP peer group has been created using the group listen external command.

Precautions

If the undo peer listen-as command is run, all connections established between the local device and the dynamic peers in the specified AS are also deleted. Therefore, exercise caution when running this command.

If the peer listen-as command is run more than once, all configurations take effect, indicating that a dynamic EBGP peer group can listen for BGP connection requests from more than one peer AS.

Example

# Configure the dynamic EBGP peer group named ex to listen for BGP connection requests from peer AS 200.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group ex listen external
[HUAWEI-bgp] peer ex listen-as 200

peer listen-as (BGP-VPN instance IPv4 address family view)

Function

The peer listen-as command specifies a peer AS from which a dynamic EBGP peer group listens for BGP connection requests.

The undo peer listen-as command deletes the specified peer AS from which a dynamic EBGP peer group listens for BGP connection requests.

By default, no peer AS from which a dynamic EBGP peer group listens for BGP connection requests is specified.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name listen-as { asn } &<1-6>

undo peer group-name listen-as { asn } &<1-6>

Parameters

Parameter Description Value
group-name

Specifies the name of a dynamic BGP peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

asn

Specifies the AS number.

A 2-byte AS number is an integer ranging from 1 to 65535.

A 4-byte AS number can be: An integer ranging from 65536 to 4294967295. In the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The dynamic BGP peer function enables BGP to listen for BGP connection requests from a specified network segment, dynamically establish BGP peer relationships, and add these peers to the same dynamic peer group. This spares you from adding or deleting BGP peer configurations in response to each change in dynamic peers. To specify a peer AS from which a dynamic EBGP peer group listens for BGP connection requests, run the peer listen-as command.

Prerequisites

A dynamic EBGP peer group has been created using the group listen external command.

Precautions

If the undo peer listen-as command is run, all connections established between the local device and the dynamic peers in the specified AS are also deleted. Therefore, exercise caution when running this command.

If the peer listen-as command is run more than once, all configurations take effect, indicating that a dynamic EBGP peer group can listen for BGP connection requests from more than one peer AS.

Example

# Configure the dynamic EBGP peer group named ex to listen for BGP connection requests from peer AS 200.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group ex listen external
[HUAWEI-bgp-vpn1] peer ex listen-as 200

peer listen-as (BGP-VPN instance view)

Function

The peer listen-as command specifies a peer AS from which a dynamic EBGP peer group listens for BGP connection requests.

The undo peer listen-as command deletes the specified peer AS from which a dynamic EBGP peer group listens for BGP connection requests.

By default, no peer AS from which a dynamic EBGP peer group listens for BGP connection requests is specified.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name listen-as { asn } &<1-6>

undo peer group-name listen-as { asn } &<1-6>

Parameters

Parameter Description Value
group-name

Specifies the name of a dynamic BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

asn

Specifies the AS number.

A 2-byte AS number is an integer ranging from 1 to 65535.

A 4-byte AS number can be: An integer ranging from 65536 to 4294967295. In the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The dynamic BGP peer function enables BGP to listen for BGP connection requests from a specified network segment, dynamically establish BGP peer relationships, and add these peers to the same dynamic peer group. This spares you from adding or deleting BGP peer configurations in response to each change in dynamic peers. To specify a peer AS from which a dynamic EBGP peer group listens for BGP connection requests, run the peer listen-as command.

Prerequisites

A dynamic EBGP peer group has been created using the group listen external command.

Precautions

If the undo peer listen-as command is run, all connections established between the local device and the dynamic peers in the specified AS are also deleted. Therefore, exercise caution when running this command.

If the peer listen-as command is run more than once, all configurations take effect, indicating that a dynamic EBGP peer group can listen for BGP connection requests from more than one peer AS.

Example

# Configure the dynamic EBGP peer group named ex to listen for BGP connection requests from peer AS 200.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group ex listen external
[HUAWEI-bgp-instance-vpn1] peer ex listen-as 200

peer listen-as-segment

Function

The peer listen-as-segment command specifies a peer AS range from which a dynamic EBGP peer group listens for BGP connection requests.

The undo peer listen-as-segment command deletes the specified peer AS range from which a dynamic EBGP peer group listens for BGP connection requests.

By default, no peer AS range from which a dynamic EBGP peer group listens for BGP connection requests is specified.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name listen-as-segment begin-as begin-asn end-as end-asn

undo peer group-name listen-as-segment begin-as begin-asn end-as end-asn

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported.

begin-as begin-asn

Specifies the start AS number in an AS range.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

end-as end-asn

Specifies the end AS number in an AS range.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To specify a peer AS range from which a dynamic EBGP peer group listens for BGP connection requests, run the peer listen-as-segment command. The dynamic BGP peer function enables BGP to listen for BGP connection requests from a specified network segment, dynamically establish BGP peer relationships, and add these peers to the same dynamic peer group. This spares you from adding or deleting BGP peer configurations in response to each change in BGP peers.

Prerequisites

A dynamic EBGP peer group has been created using the group listen external command.

Precautions

If the undo peer listen-as-segment command is run, all connections established between the local device and the dynamic peers in the specified AS-Segment are also deleted. Therefore, exercise caution when running this command.

When you run the undo peer listen-as-segment command, ensure that the start and end AS numbers in the AS range to be deleted are the same as those in the configured AS range.

Example

# Configure the dynamic EBGP peer group named ex to listen for BGP connection requests from the peer AS range 200 to 300.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group ex listen external
[HUAWEI-bgp] peer ex listen-as-segment begin-as 200 end-as 300

peer listen-as-segment (BGP-VPN instance IPv4 address family view)

Function

The peer listen-as-segment command specifies a peer AS range from which a dynamic EBGP peer group listens for BGP connection requests.

The undo peer listen-as-segment command deletes the specified peer AS range from which a dynamic EBGP peer group listens for BGP connection requests.

By default, no peer AS range from which a dynamic EBGP peer group listens for BGP connection requests is specified.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name listen-as-segment begin-as begin-asn end-as end-asn

undo peer group-name listen-as-segment begin-as begin-asn end-as end-asn

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported.

begin-as begin-asn

Specifies the start AS number in an AS range.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

end-as end-asn

Specifies the end AS number in an AS range.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To specify a peer AS range from which a dynamic EBGP peer group listens for BGP connection requests, run the peer listen-as-segment command. The dynamic BGP peer function enables BGP to listen for BGP connection requests from a specified network segment, dynamically establish BGP peer relationships, and add these peers to the same dynamic peer group. This spares you from adding or deleting BGP peer configurations in response to each change in BGP peers.

Precautions

If the undo peer listen-as-segment command is run, all connections established between the local device and the dynamic peers in the specified AS-Segment are also deleted. Therefore, exercise caution when running this command.

When you run the undo peer listen-as-segment command, ensure that the start and end AS numbers in the AS range to be deleted are the same as those in the configured AS range.

Example

# Configure the dynamic EBGP peer group named ex to listen for BGP connection requests from the peer AS range 200 to 300.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group ex listen external
[HUAWEI-bgp-vpn1] peer ex listen-as-segment begin-as 200 end-as 300

peer listen-as-segment (BGP-VPN instance view)

Function

The peer listen-as-segment command specifies a peer AS range from which a dynamic EBGP peer group listens for BGP connection requests.

The undo peer listen-as-segment command deletes the specified peer AS range from which a dynamic EBGP peer group listens for BGP connection requests.

By default, no peer AS range from which a dynamic EBGP peer group listens for BGP connection requests is specified.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name listen-as-segment begin-as begin-asn end-as end-asn

undo peer group-name listen-as-segment begin-as begin-asn end-as end-asn

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

begin-as begin-asn

Specifies the start AS number in an AS range.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

end-as end-asn

Specifies the end AS number in an AS range.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To specify a peer AS range from which a dynamic EBGP peer group listens for BGP connection requests, run the peer listen-as-segment command. The dynamic BGP peer function enables BGP to listen for BGP connection requests from a specified network segment, dynamically establish BGP peer relationships, and add these peers to the same dynamic peer group. This spares you from adding or deleting BGP peer configurations in response to each change in BGP peers.

Precautions

If the undo peer listen-as-segment command is run, all connections established between the local device and the dynamic peers in the specified AS-Segment are also deleted. Therefore, exercise caution when running this command.

When you run the undo peer listen-as-segment command, ensure that the start and end AS numbers in the AS range to be deleted are the same as those in the configured AS range.

Example

# Configure the dynamic EBGP peer group named ex to listen for BGP connection requests from the peer AS range 200 to 300.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group ex listen external
[HUAWEI-bgp-instance-vpn1] peer ex listen-as-segment begin-as 200 end-as 300

peer listen-net

Function

The peer listen-net command specifies a network segment from which a dynamic BGP peer group listens for BGP connection requests.

The undo peer listen-net command deletes the specified network segment from which a dynamic BGP peer group listens for BGP connection requests.

By default, no network segment from which a dynamic BGP peer group listens for BGP connection requests is specified.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name listen-net ipv4-address [ mask-length | mask ]

undo peer group-name listen-net ipv4-address [ mask-length | mask ]

Parameters

Parameter Description Value
group-name

Specifies the name of a dynamic BGP peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

ipv4-address

Specifies the network segment from which the dynamic peer group listens for connection requests.

It is in dotted decimal notation.

mask-length

Specifies the mask length. A 32-bit mask is represented by consecutive 1s, and the mask in dotted decimal notation can be replaced by the mask length.

The value is an integer in the range from 0 to 32.

mask

Specifies the mask of the preceding IP address.

It is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To advertise the BGP origin AS validation result (Valid, NotFound, or Invalid) to a specified BGP peer or peer group so that the BGP peer or peer group can apply the result to route selection, run the peer advertise origin-as-validation command.

Prerequisites

A dynamic BGP peer group has been configured using the group listen [ internal | external ] command. In the case of a dynamic EBGP peer group, a peer AS from which the peer group listens for BGP connection requests must also have been specified using the peer listen-as command.

Precautions

If you run the undo peer listen-net command to delete the network segment from which a dynamic peer group listens for BGP connection requests, the corresponding dynamic peers are not deleted. However, if the dynamic peers are disconnected, they cannot be reconnected.

If both dynamic and static peers are configured on the local end, when the peer end attempts to establish a connection with the local end, the static peer relationship is preferentially established.

The peer listen-net command is an incremental command.

You are not advised to configure 32-bit network segment peers. You can use static peers instead.

Example

# Specify a network segment from which the dynamic IBGP peer group named in listens for BGP connection requests.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group in listen internal
[HUAWEI-bgp] peer in listen-net 10.10.10.0 24
# Specify a network segment from which the dynamic EBGP peer group named ex listens for BGP connection requests.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group ex listen external
[HUAWEI-bgp] peer ex listen-as 200
[HUAWEI-bgp] peer ex listen-net 10.10.10.0 24

peer listen-net (BGP-VPN instance IPv4 address family view)

Function

The peer listen-net command specifies a network segment from which a dynamic BGP peer group listens for BGP connection requests.

The undo peer listen-net command deletes the specified network segment from which a dynamic BGP peer group listens for BGP connection requests.

By default, no network segment from which a dynamic BGP peer group listens for BGP connection requests is specified.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name listen-net ipv4-address [ mask-length | mask ]

undo peer group-name listen-net ipv4-address [ mask-length | mask ]

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

ipv4-address

Specifies a network segment from which the dynamic BGP peer group listens for BGP connection requests.

It is in dotted decimal notation.

mask-length

Specifies the mask length. A 32-bit mask is represented by consecutive 1s, and the mask in dotted decimal notation can be replaced by the mask length.

The value is an integer in the range from 0 to 32.

mask

Specifies a subnet mask of an IP address.

It is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To advertise the BGP origin AS validation result (Valid, NotFound, or Invalid) to a specified BGP peer or peer group so that the BGP peer or peer group can apply the result to route selection, run the peer advertise origin-as-validation command.

Prerequisites

A dynamic BGP peer group has been configured using the group listen [ internal | external ] command. In the case of a dynamic EBGP peer group, a peer AS from which the peer group listens for BGP connection requests must also have been specified using the peer listen-as command.

Precautions

You are advised not to configure 32-bit network segment peers. You can use static peers instead.

Example

# Specify a network segment from which the dynamic EBGP peer group named ex listens for BGP connection requests.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group ex listen external
[HUAWEI-bgp] peer ex listen-as 200
[HUAWEI-bgp] peer ex listen-net 10.10.10.0 24
# Specify a network segment from which the dynamic IBGP peer group named in listens for BGP connection requests.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group in listen internal
[HUAWEI-bgp] peer in listen-net 10.10.10.0 24

peer listen-net (BGP-VPN instance view)

Function

The peer listen-net command specifies a network segment from which a dynamic BGP peer group listens for BGP connection requests.

The undo peer listen-net command deletes the specified network segment from which a dynamic BGP peer group listens for BGP connection requests.

By default, no network segment from which a dynamic BGP peer group listens for BGP connection requests is specified.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name listen-net ipv4-address [ mask-length | mask ]

undo peer group-name listen-net ipv4-address [ mask-length | mask ]

Parameters

Parameter Description Value
group-name

Specifies the name of a dynamic BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

ipv4-address

Specifies a network segment from which the dynamic BGP peer group listens for BGP connection requests.

The value is in dotted decimal notation.

mask-length

Specifies a mask length. The 1s in each 32-bit mask must be consecutive. Therefore, a mask in dotted decimal notation can be presented by a mask length.

The value is an integer ranging from 0 to 32.

mask

Specifies the mask of the IP address.

The value is in dotted decimal notation.

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To advertise the BGP origin AS validation result (Valid, NotFound, or Invalid) to a specified BGP peer or peer group so that the BGP peer or peer group can apply the result to route selection, run the peer advertise origin-as-validation command.

Prerequisites

A dynamic BGP peer group has been configured using the group listen [ internal | external ] command. In the case of a dynamic EBGP peer group, a peer AS from which the peer group listens for BGP connection requests must also have been specified using the peer listen-as command.

Precautions

You are advised not to configure 32-bit network segment peers. You can use static peers instead.

Example

# Specify a network segment from which the dynamic EBGP peer group named ex listens for BGP connection requests.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group ex listen external
[HUAWEI-bgp-instance-vpn1] peer ex listen-as 200
[HUAWEI-bgp-instance-vpn1] peer ex listen-net 10.10.10.0 24

peer listen-only connect-only (BGP multi-instance view) (group)

Function

The peer listen-only command enables a peer group to listen to connection requests but not to send connection requests.

The undo peer listen-only command restores the default setting.

The peer connect-only command enables a peer group to send connection requests but not to accept connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer group listens to and accepts connection requests and sends connection requests.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name { listen-only | connect-only }

undo peer group-name { listen-only | connect-only }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer group to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer group to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Enable a peer group to send connection requests but reject connection requests.
<HUAWEI> system-view
[HUAWEI] bgp 100 instanc a
[HUAWEI-bgp-instance-a] group test
[HUAWEI-bgp-instance-a] peer test connect-only

peer listen-only connect-only (BGP multi-instance view)(IPv4)

Function

The peer listen-only command enables a peer group to listen to connection requests but not to send connection requests.

The undo peer listen-only command restores the default setting.

The peer connect-only command enables a peer group to send connection requests but not to accept connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer listens to and accepts connection requests, and sends connection requests.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address { listen-only | connect-only }

undo peer ipv4-address { listen-only | connect-only }

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Enable peer to send connection requests but rejects connection requests.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 10.1.1.1 connect-only

peer listen-only connect-only (BGP view) (IPv6)

Function

The peer listen-only command enables a peer to listen to connection requests but not to send connection requests.

The undo peer listen-only command restores the default setting.

The peer connect-only command enables a peer to send connection requests but not to accept connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer listens to and accepts connection requests, and sends connection requests.

Format

peer ipv6-address { listen-only | connect-only }

undo peer ipv6-address { listen-only | connect-only }

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Enable peer to send connection requests but rejects connection requests.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp] peer 2001:DB8:1::1 connect-only

peer listen-only connect-only (BGP view)(group)

Function

The peer listen-only command enables a peer to listen to connection requests but not to send connection requests.

The undo peer listen-only command restores the default setting.

The peer connect-only command enables a peer to send connection requests but not to accept connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer group listens to and accepts connection requests and sends connection requests.

Format

peer group-name { listen-only | connect-only }

undo peer group-name { listen-only | connect-only }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer group to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer group to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Enable a peer group to send connection requests but reject connection requests.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer test connect-only

peer listen-only connect-only (BGP-VPN instance IPv6 address family view) (group)

Function

The peer listen-only command enables a peer group to listen to connection requests but not to send connection requests.

The undo peer listen-only command restores the default setting.

The peer connect-only command enables a peer group to send connection requests but not to accept connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer group listens to and accepts connection requests and sends connection requests.

Format

peer group-name { listen-only | connect-only }

undo peer group-name { listen-only | connect-only }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer group to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer group to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Enable peer group to send connection requests but rejects connection requests.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpn1] group test
[HUAWEI-bgp-6-vpn1] peer test connect-only

peer listen-only connect-only (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer listen-only command enables a peer to listen to connection requests but not to send connection requests.

The undo peer listen-only command restores the default setting.

The peer connect-only command enables a peer to send connection requests but not to accept connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer listens to and accepts connection requests, and sends connection requests.

Format

peer ipv6-address { listen-only | connect-only }

undo peer ipv6-address { listen-only | connect-only }

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Enable peer to send connection requests but rejects connection requests.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 connect-only

peer listen-only connect-only (BGP-VPN instance view) (group)

Function

The peer listen-only command enables a peer to listen to connection requests but not to send connection requests.

The undo peer listen-only command restores the default setting.

The peer connect-only command enables a peer to send connection requests but not to accept connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer group listens to and accepts connection requests and sends connection requests.

Format

peer group-name { listen-only | connect-only }

undo peer group-name { listen-only | connect-only }

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer group to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer group to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Enable a peer group to send connection requests but reject connection requests.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test
[HUAWEI-bgp-instance-vpn1] peer test connect-only

peer listen-only connect-only (BGP-VPN instance view) (IPv6)

Function

The peer listen-only command enables a peer to listen to connection requests but not to send connection requests.

The undo peer listen-only command restores the default setting.

The peer connect-only command enables a peer to send connection requests but not to accept connection requests.

The undo peer connect-only command restores the default setting.

By default, a peer listens to and accepts connection requests, and sends connection requests.

Format

peer ipv6-address { listen-only | connect-only }

undo peer ipv6-address { listen-only | connect-only }

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a peer to listen to connection requests but not to send connection requests, run the peer listen-only command.

To enable a peer to send connection requests but not to accept connection requests, run the peer connect-only command.

Configuration Impact

If the peer listen-only and peer connect-only commands are both run, the latest configuration overrides the previous one.

Precautions

The peer connect-only command or the peer listen-only command cannot be run on both devices that are peers of each other. Otherwise, the peer relationship cannot be established.

Example

# Enable peer to send connection requests but rejects connection requests.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 connect-only

peer load-balancing (BGP view)

Function

By default, BGP load balancing is not enabled.

Format

peer ipv4-address load-balancing [ as-path-ignore | as-path-relax ]

undo peer ipv4-address load-balancing [ as-path-ignore | as-path-relax ]

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

as-path-ignore

Prevents the router from comparing AS_Path attributes when selecting routes for load balancing.

-

as-path-relax

Configures the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.

-

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale network, there may be multiple valid routes to the same destination, but BGP advertises only the optimal route to its peers. This may cause unbalanced traffic load. This section describes how to configure BGP load balancing to implement load balancing among multiple BGP routes.

After the peer load-balancing command is run, the following conditions must be met to implement load balancing:

  • From the specified peer.
  • The route is the optimal route or is equal-cost with the optimal route.
  • If the AS_Path attribute of the route is the same as that of the optimal route or the as-path-ignoreor as-path-relaxparameter is configured for the peer when load balancing is enabled on the peer:

    as-path-ignore: ignores the AS_Path attribute and does not compare the AS_Path attributes of the routes to be used for load balancing. That is, load balancing can be implemented even if the AS_Path attributes of the routes are different.

    as-path-relax: The device ignores the AS_Path attributes of the same length and does not compare the AS_Path attributes of the same length when load balancing is performed among the routes. That is, load balancing cannot be performed among the routes with different AS_Path lengths. For example, the AS_Path attribute of route A is 10, and the AS_Path attribute of route B is 10 20. Because the AS_Path lengths of the two routes are different, load balancing cannot be implemented.

Precautions

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

By default, a BGP device does not change the next hop addresses of routes to a local address before sending the routes to its IBGP peer. However, after peer-based load balancing is enabled, a BGP device changes the next hop addresses of routes to a local address before sending the routes to its IBGP peer.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but the peer load-balancing command does not contain the as-path-ignoreor as-path-relaxparameter, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignoreor as-path-relaxis specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Enable load balancing among routes learned from peer and among routes learned from peer 2001:DB8:1::1 and configure the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.1 as-number 200
[HUAWEI-bgp] peer 1.1.1.1 load-balancing as-path-relax

peer load-balancing (BGP view) (group)

Function

By default, BGP load balancing is not enabled.

Format

peer group-name load-balancing [ as-path-ignore | as-path-relax ]

undo peer group-name load-balancing [ as-path-ignore | as-path-relax ]

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

as-path-ignore

Prevents the router from comparing AS_Path attributes when selecting routes for load balancing.

-

as-path-relax

Configures the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.

-

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale network, there may be multiple valid routes to the same destination, but BGP advertises only the optimal route to its peers. This may cause unbalanced traffic load. This section describes how to configure BGP load balancing to implement load balancing among multiple BGP routes.

After the peer load-balancing command is run, the following conditions must be met to implement load balancing:

  • The routes are learned from the specified peer group.
  • The route is the optimal route or equal-cost route with the optimal route.
  • If the AS_Path attribute is the same as that of the optimal route or the as-path-ignoreor as-path-relaxparameter is configured for the peer when load balancing is enabled on the peer:

    as-path-ignore: ignores the AS_Path attribute and does not compare the AS_Path attributes of the routes to be used for load balancing. That is, load balancing can be implemented even if the AS_Path attributes of the routes are different.

    as-path-relax: The device ignores the AS_Path attributes of the same length and does not compare the AS_Path attributes of the same length when load balancing is performed among the routes. That is, load balancing cannot be performed among the routes with different AS_Path lengths. For example, the AS_Path attribute of route A is 10, and the AS_Path attribute of route B is 10 20. Because the AS_Path lengths of the two routes are different, load balancing cannot be implemented.

Precautions

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

By default, a BGP device does not change the next hop addresses of routes to a local address before sending the routes to its IBGP peer. However, after peer-based load balancing is enabled, a BGP device changes the next hop addresses of routes to a local address before sending the routes to its IBGP peer.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but the peer load-balancing command does not contain the as-path-ignoreor as-path-relaxparameter, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignoreor as-path-relaxis specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Enable load balancing among routes learned from peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test load-balancing as-path-relax

peer load-balancing (BGP-IPv6 unicast address family view)

Function

By default, BGP load balancing is not enabled.

Format

peer ipv4-address load-balancing [ as-path-ignore | as-path-relax ]

undo peer ipv4-address load-balancing [ as-path-ignore | as-path-relax ]

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

as-path-ignore

Prevents the router from comparing AS_Path attributes when selecting routes for load balancing.

-

as-path-relax

Configures the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale network, there may be multiple valid routes to the same destination, but BGP advertises only the optimal route to its peers. This may cause unbalanced traffic load. This section describes how to configure BGP load balancing to implement load balancing among multiple BGP routes.

After the peer load-balancing command is run, the following conditions must be met to implement load balancing:

  • From the specified peer.
  • The route is the optimal route or is equal-cost with the optimal route.
  • If the AS_Path attribute of the route is the same as that of the optimal route or the as-path-ignoreor as-path-relaxparameter is configured for the peer when load balancing is enabled on the peer:

    as-path-ignore: ignores the AS_Path attribute and does not compare the AS_Path attributes of the routes to be used for load balancing. That is, load balancing can be implemented even if the AS_Path attributes of the routes are different.

    as-path-relax: The device ignores the AS_Path attributes of the same length and does not compare the AS_Path attributes of the same length when load balancing is performed among the routes. That is, load balancing cannot be performed among the routes with different AS_Path lengths. For example, the AS_Path attribute of route A is 10, and the AS_Path attribute of route B is 10 20. Because the AS_Path lengths of the two routes are different, load balancing cannot be implemented.

Precautions

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

By default, a BGP device does not change the next hop addresses of routes to a local address before sending the routes to its IBGP peer. However, after peer-based load balancing is enabled, a BGP device changes the next hop addresses of routes to a local address before sending the routes to its IBGP peer.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but the peer load-balancing command does not contain the as-path-ignoreor as-path-relaxparameter, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignoreor as-path-relaxis specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Enable load balancing among routes learned from peer and among routes learned from peer 2001:DB8:1::1 and configure the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 1.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 1.1.1.1 load-balancing as-path-relax

peer load-balancing (BGP-IPv6 unicast address family view) (group)

Function

By default, BGP load balancing is not enabled.

Format

peer group-name load-balancing [ as-path-ignore | as-path-relax ]

undo peer group-name load-balancing [ as-path-ignore | as-path-relax ]

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

as-path-ignore

Prevents the router from comparing AS_Path attributes when selecting routes for load balancing.

-

as-path-relax

Configures the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale network, there may be multiple valid routes to the same destination, but BGP advertises only the optimal route to its peers. This may cause unbalanced traffic load. This section describes how to configure BGP load balancing to implement load balancing among multiple BGP routes.

After the peer load-balancing command is run, the following conditions must be met to implement load balancing:

  • The routes are learned from the specified peer group.
  • The route is the optimal route or equal-cost route with the optimal route.
  • If the AS_Path attribute is the same as that of the optimal route or the as-path-ignoreor as-path-relaxparameter is configured for the peer when load balancing is enabled on the peer:

    as-path-ignore: ignores the AS_Path attribute and does not compare the AS_Path attributes of the routes to be used for load balancing. That is, load balancing can be implemented even if the AS_Path attributes of the routes are different.

    as-path-relax: The device ignores the AS_Path attributes of the same length and does not compare the AS_Path attributes of the same length when load balancing is performed among the routes. That is, load balancing cannot be performed among the routes with different AS_Path lengths. For example, the AS_Path attribute of route A is 10, and the AS_Path attribute of route B is 10 20. Because the AS_Path lengths of the two routes are different, load balancing cannot be implemented.

Precautions

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

By default, a BGP device does not change the next hop addresses of routes to a local address before sending the routes to its IBGP peer. However, after peer-based load balancing is enabled, a BGP device changes the next hop addresses of routes to a local address before sending the routes to its IBGP peer.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but the peer load-balancing command does not contain the as-path-ignoreor as-path-relaxparameter, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignoreor as-path-relaxis specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Enable load balancing among routes learned from peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test load-balancing as-path-relax

peer load-balancing (BGP-IPv6 unicast address family view) (IPv6)

Function

By default, BGP load balancing is not enabled.

Format

peer ipv6-address load-balancing [ as-path-ignore | as-path-relax ]

undo peer ipv6-address load-balancing [ as-path-ignore | as-path-relax ]

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

as-path-ignore

Prevents the router from comparing AS_Path attributes when selecting routes for load balancing.

-

as-path-relax

Configures the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale network, there may be multiple valid routes to the same destination, but BGP advertises only the optimal route to its peers. This may cause unbalanced traffic load. This section describes how to configure BGP load balancing to implement load balancing among multiple BGP routes.

After the peer load-balancing command is run, the following conditions must be met to implement load balancing:

  • From the specified peer.
  • The route is the optimal route or is equal-cost with the optimal route.
  • If the AS_Path attribute of the route is the same as that of the optimal route or the as-path-ignoreor as-path-relaxparameter is configured for the peer when load balancing is enabled on the peer:

    as-path-ignore: ignores the AS_Path attribute and does not compare the AS_Path attributes of the routes to be used for load balancing. That is, load balancing can be implemented even if the AS_Path attributes of the routes are different.

    as-path-relax: The device ignores the AS_Path attributes of the same length and does not compare the AS_Path attributes of the same length when load balancing is performed among the routes. That is, load balancing cannot be performed among the routes with different AS_Path lengths. For example, the AS_Path attribute of route A is 10, and the AS_Path attribute of route B is 10 20. Because the AS_Path lengths of the two routes are different, load balancing cannot be implemented.

Precautions

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

By default, a BGP device does not change the next hop addresses of routes to a local address before sending the routes to its IBGP peer. However, after peer-based load balancing is enabled, a BGP device changes the next hop addresses of routes to a local address before sending the routes to its IBGP peer.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but the peer load-balancing command does not contain the as-path-ignoreor as-path-relaxparameter, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignoreor as-path-relaxis specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Enable load balancing among routes learned from peer and among routes learned from peer 2001:DB8:1::1 and configure the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:db8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:db8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:db8:1::1 load-balancing as-path-relax

peer load-balancing (BGP-VPN instance IPv4 address family view) (group)

Function

By default, BGP load balancing is not enabled.

Format

peer group-name load-balancing [ as-path-ignore | as-path-relax ]

undo peer group-name load-balancing [ as-path-ignore | as-path-relax ]

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

as-path-ignore

Prevents the router from comparing AS_Path attributes when selecting routes for load balancing.

-

as-path-relax

Configures the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale network, there may be multiple valid routes to the same destination, but BGP advertises only the optimal route to its peers. This may cause unbalanced traffic load. This section describes how to configure BGP load balancing to implement load balancing among multiple BGP routes.

After the peer load-balancing command is run, the following conditions must be met to implement load balancing:

  • The routes are learned from the specified peer group.
  • The route is the optimal route or equal-cost route with the optimal route.
  • If the AS_Path attribute is the same as that of the optimal route or the as-path-ignoreor as-path-relaxparameter is configured for the peer when load balancing is enabled on the peer:

    as-path-ignore: ignores the AS_Path attribute and does not compare the AS_Path attributes of the routes to be used for load balancing. That is, load balancing can be implemented even if the AS_Path attributes of the routes are different.

    as-path-relax: The device ignores the AS_Path attributes of the same length and does not compare the AS_Path attributes of the same length when load balancing is performed among the routes. That is, load balancing cannot be performed among the routes with different AS_Path lengths. For example, the AS_Path attribute of route A is 10, and the AS_Path attribute of route B is 10 20. Because the AS_Path lengths of the two routes are different, load balancing cannot be implemented.

Precautions

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

By default, a BGP device does not change the next hop addresses of routes to a local address before sending the routes to its IBGP peer. However, after peer-based load balancing is enabled, a BGP device changes the next hop addresses of routes to a local address before sending the routes to its IBGP peer.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but the peer load-balancing command does not contain the as-path-ignoreor as-path-relaxparameter, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignoreor as-path-relaxis specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Enable load balancing among routes learned from peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test
[HUAWEI-bgp-vpn1] peer test load-balancing as-path-relax

peer load-balancing (BGP-VPN instance IPv4 address family view)

Function

By default, BGP load balancing is not enabled.

Format

peer ipv4-address load-balancing [ as-path-ignore | as-path-relax ]

undo peer ipv4-address load-balancing [ as-path-ignore | as-path-relax ]

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

as-path-ignore

Prevents the router from comparing AS_Path attributes when selecting routes for load balancing.

-

as-path-relax

Configures the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale network, there may be multiple valid routes to the same destination, but BGP advertises only the optimal route to its peers. This may cause unbalanced traffic load. This section describes how to configure BGP load balancing to implement load balancing among multiple BGP routes.

After the peer load-balancing command is run, the following conditions must be met to implement load balancing:

  • From the specified peer.
  • The route is the optimal route or is equal-cost with the optimal route.
  • If the AS_Path attribute of the route is the same as that of the optimal route or the as-path-ignoreor as-path-relaxparameter is configured for the peer when load balancing is enabled on the peer:

    as-path-ignore: ignores the AS_Path attribute and does not compare the AS_Path attributes of the routes to be used for load balancing. That is, load balancing can be implemented even if the AS_Path attributes of the routes are different.

    as-path-relax: The device ignores the AS_Path attributes of the same length and does not compare the AS_Path attributes of the same length when load balancing is performed among the routes. That is, load balancing cannot be performed among the routes with different AS_Path lengths. For example, the AS_Path attribute of route A is 10, and the AS_Path attribute of route B is 10 20. Because the AS_Path lengths of the two routes are different, load balancing cannot be implemented.

Precautions

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

By default, a BGP device does not change the next hop addresses of routes to a local address before sending the routes to its IBGP peer. However, after peer-based load balancing is enabled, a BGP device changes the next hop addresses of routes to a local address before sending the routes to its IBGP peer.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but the peer load-balancing command does not contain the as-path-ignoreor as-path-relaxparameter, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignoreor as-path-relaxis specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Enable load balancing among routes learned from peer and among routes learned from peer 2001:DB8:1::1 and configure the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 1.1.1.1 load-balancing as-path-relax

peer load-balancing (BGP-VPN instance IPv6 address family view)

Function

By default, BGP load balancing is not enabled.

Format

peer ipv4-address load-balancing [ as-path-ignore | as-path-relax ]

undo peer ipv4-address load-balancing [ as-path-ignore | as-path-relax ]

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

as-path-ignore

Prevents the router from comparing AS_Path attributes when selecting routes for load balancing.

-

as-path-relax

Configures the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.

-

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale network, there may be multiple valid routes to the same destination, but BGP advertises only the optimal route to its peers. This may cause unbalanced traffic load. This section describes how to configure BGP load balancing to implement load balancing among multiple BGP routes.

After the peer load-balancing command is run, the following conditions must be met to implement load balancing:

  • From the specified peer.
  • The route is the optimal route or is equal-cost with the optimal route.
  • If the AS_Path attribute of the route is the same as that of the optimal route or the as-path-ignoreor as-path-relaxparameter is configured for the peer when load balancing is enabled on the peer:

    as-path-ignore: ignores the AS_Path attribute and does not compare the AS_Path attributes of the routes to be used for load balancing. That is, load balancing can be implemented even if the AS_Path attributes of the routes are different.

    as-path-relax: The device ignores the AS_Path attributes of the same length and does not compare the AS_Path attributes of the same length when load balancing is performed among the routes. That is, load balancing cannot be performed among the routes with different AS_Path lengths. For example, the AS_Path attribute of route A is 10, and the AS_Path attribute of route B is 10 20. Because the AS_Path lengths of the two routes are different, load balancing cannot be implemented.

Precautions

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

By default, a BGP device does not change the next hop addresses of routes to a local address before sending the routes to its IBGP peer. However, after peer-based load balancing is enabled, a BGP device changes the next hop addresses of routes to a local address before sending the routes to its IBGP peer.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but the peer load-balancing command does not contain the as-path-ignoreor as-path-relaxparameter, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignoreor as-path-relaxis specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Enable load balancing among routes learned from peer and among routes learned from peer 2001:DB8:1::1 and configure the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 1.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 1.1.1.1 load-balancing as-path-relax

peer load-balancing (BGP-VPN instance IPv6 address family view) (group)

Function

By default, BGP load balancing is not enabled.

Format

peer group-name load-balancing [ as-path-ignore | as-path-relax ]

undo peer group-name load-balancing [ as-path-ignore | as-path-relax ]

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

as-path-ignore

Prevents the router from comparing AS_Path attributes when selecting routes for load balancing.

-

as-path-relax

Configures the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.

-

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale network, there may be multiple valid routes to the same destination, but BGP advertises only the optimal route to its peers. This may cause unbalanced traffic load. This section describes how to configure BGP load balancing to implement load balancing among multiple BGP routes.

After the peer load-balancing command is run, the following conditions must be met to implement load balancing:

  • From the specified peer.
  • The route is the optimal route or is equal-cost with the optimal route.
  • If the AS_Path attribute of the route is the same as that of the optimal route or the as-path-ignoreor as-path-relaxparameter is configured for the peer when load balancing is enabled on the peer:

    as-path-ignore: ignores the AS_Path attribute and does not compare the AS_Path attributes of the routes to be used for load balancing. That is, load balancing can be implemented even if the AS_Path attributes of the routes are different.

    as-path-relax: The device ignores the AS_Path attributes of the same length and does not compare the AS_Path attributes of the same length when load balancing is performed among the routes. That is, load balancing cannot be performed among the routes with different AS_Path lengths. For example, the AS_Path attribute of route A is 10, and the AS_Path attribute of route B is 10 20. Because the AS_Path lengths of the two routes are different, load balancing cannot be implemented.

Precautions

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

By default, a BGP device does not change the next hop addresses of routes to a local address before sending the routes to its IBGP peer. However, after peer-based load balancing is enabled, a BGP device changes the next hop addresses of routes to a local address before sending the routes to its IBGP peer.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but the peer load-balancing command does not contain the as-path-ignoreor as-path-relaxparameter, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignoreor as-path-relaxis specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Enable load balancing among routes learned from peer group and configure the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test load-balancing as-path-relax

peer load-balancing (BGP-VPN instance IPv6 address family view) (IPv6)

Function

By default, BGP load balancing is not enabled.

Format

peer ipv6-address load-balancing [ as-path-ignore | as-path-relax ]

undo peer ipv6-address load-balancing [ as-path-ignore | as-path-relax ]

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

as-path-ignore

Prevents the router from comparing AS_Path attributes when selecting routes for load balancing.

-

as-path-relax

Configures the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.

-

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a large-scale network, there may be multiple valid routes to the same destination, but BGP advertises only the optimal route to its peers. This may cause unbalanced traffic load. This section describes how to configure BGP load balancing to implement load balancing among multiple BGP routes.

After the peer load-balancing command is run, the following conditions must be met to implement load balancing:

  • From the specified peer.
  • The route is the optimal route or is equal-cost with the optimal route.
  • If the AS_Path attribute of the route is the same as that of the optimal route or the as-path-ignoreor as-path-relaxparameter is configured for the peer when load balancing is enabled on the peer:

    as-path-ignore: ignores the AS_Path attribute and does not compare the AS_Path attributes of the routes to be used for load balancing. That is, load balancing can be implemented even if the AS_Path attributes of the routes are different.

    as-path-relax: The device ignores the AS_Path attributes of the same length and does not compare the AS_Path attributes of the same length when load balancing is performed among the routes. That is, load balancing cannot be performed among the routes with different AS_Path lengths. For example, the AS_Path attribute of route A is 10, and the AS_Path attribute of route B is 10 20. Because the AS_Path lengths of the two routes are different, load balancing cannot be implemented.

Precautions

The maximum load-balancing and peer load-balancing commands are mutually exclusive.

By default, a BGP device does not change the next hop addresses of routes to a local address before sending the routes to its IBGP peer. However, after peer-based load balancing is enabled, a BGP device changes the next hop addresses of routes to a local address before sending the routes to its IBGP peer.

If the load-balancing as-path-ignore or load-balancing as-path-relax command is run but the peer load-balancing command does not contain the as-path-ignoreor as-path-relaxparameter, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If as-path-ignoreor as-path-relaxis specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Enable load balancing among routes learned from peer and among routes learned from peer 2001:DB8:1::1 and configure the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:2::2 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 load-balancing as-path-relax
[HUAWEI-bgp-6-vpna] peer 2001:DB8:2::2 load-balancing as-path-relax

peer local-as (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer local-as command enables a device to use a fake AS number to establish a BGP peer relationship with a specified peer.

The undo peer local-as command cancels the existing configuration.

By default, a device uses an actual AS number to establish a BGP peer relationship with a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address local-as local-as-value [ dual-as ] [ prepend-global-as ] [ prepend-local-as ]

undo peer ipv4-address local-as

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

local-as-value

Specifies an AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

dual-as

Allows the local end to use either the actual AS number or the fake AS number to establish a connection with the peer end.

-

prepend-global-as

Adds the actual AS number to the AS_Path in the messages to be sent.

-

prepend-local-as

Adds the fake AS number to the AS_Path in received messages.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer local-as command is run, without dual-as, prepend-global-as, or prepend-local-as specified, the local end uses only the fake AS number to establish a BGP peer relationship with the specified peer and adds only the fake AS number to the AS_Path of the routes to be advertised to the peer.

The peer local-as command is used in a scenario where a carrier modifies network deployment. For example, in a carrier merger and acquisition scenario, if the acquirer's network and the acquiree's network belong to different ASs, BGP peers on the acquiree's network need to be shifted from their original AS to the AS of the acquirer's AS. If the customers of the acquiree do not want their BGP configurations to be changed or do not want them to be changed immediately during the shift, BGP peer relationships may be interrupted for a long time.

If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions before sending routes to the EBGP peer or confederation EBGP peer:

  • If prepend-global-as is not specified in the command, the device adds only the fake AS number to the AS_Path of the routes that match a specified export policy.
  • If prepend-global-as is specified in the command, the device adds the fake AS number followed by the global AS number to the AS_Path of the routes that match a specified export policy.

    If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions after receiving routes from the EBGP peer or confederation EBGP peer:
  • If prepend-local-as is not specified in the command, the device does not change the AS_Path of the received routes.
  • If prepend-local-as is specified in the command, the device adds the fake AS number to the AS_Path of the received routes before filtering them using the specified import policy.

    The peer local-as command is valid only for EBGP peers. If the local device uses the actual AS number to establish an EBGP peer relationship with a remote device, the actual AS number is carried in the AS_Path of the route to be sent to the remote device. If the local device uses the fake AS number to establish the EBGP peer relationship, the fake AS number is carried in the AS_Path of the route to be sent to the remote device.

Prerequisites

Peers have been created using the peer as-number command.

Configuration Impact

If the peer fake-as command is run several times for a peer or a peer group, the latest configuration will overwrite the previous one.

Precautions

If the fake AS number configured on a local device is the same as the remote AS number configured on the device and dual-as is specified in the peer fake-as command, the specified peer cannot be added to a peer group; if dual-as is not specified in this case, the specified peer can be added to a peer group. In addition, if the specified peer is added to a peer group, the fake AS number configured on the device must be the same as the remote AS number configured on the device, and dual-as cannot be specified in the peer fake-as command. For a confederation EBGP peer relationship, the fake AS number configured on the local device cannot be the same as the remote AS number configured on the device. If the fake AS number configured on a local device is the same as the remote AS number configured on the device, EBGP-specific configurations are not allowed. If the fake AS number is deleted, IBGP-specific configurations are not allowed. If the fake AS number configured on a local device is the same as the remote AS number configured on the device and the dual-as parameter is specified in the peer fake-as command, the type of the connection to be established between the local device and the specified peer may be EBGP (or IBGP). For the EBGP connection, some IBGP-specific configurations on the peer may become invalid; for the IBGP connection, some EBGP-specific configurations on the peer may become invalid. Running the peer local-as command will cause the specified peer relationship to be reestablished. After the peer local-as [ dual-as ] [ prepend-global-as ] [ prepend-local-as ] command is run, if the configuration of the dual-as or prepend-local-as parameter is modified, the specified BGP peer relationship will be reestablished. If the configuration of the prepend-global-as parameter is modified in this case, the specified peer relationship will not be reestablished.

Example

# Set a 2-byte fake AS number for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 local-as 99

peer local-as (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer local-as command enables a device to use a fake AS number to establish a BGP peer relationship with a specified peer.

The undo peer local-as command cancels the existing configuration.

By default, a device uses an actual AS number to establish a BGP peer relationship with a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name local-as local-as-value [ dual-as ] [ prepend-global-as ] [ prepend-local-as ]

undo peer group-name local-as

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

local-as-value

Specifies an AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

dual-as

Allows the local end to use the actual or fake AS number to establish a BGP peer relationship with the specified peer.

-

prepend-global-as

Adds the actual AS number to the AS_Path in the messages to be sent.

-

prepend-local-as

Adds the fake AS number to the AS_Path in received messages.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer local-as command is run, without dual-as, prepend-global-as, or prepend-local-as specified, the local end uses only the fake AS number to establish a BGP peer relationship with the specified peer and adds only the fake AS number to the AS_Path of the routes to be advertised to the peer.

The peer local-as command is used in a scenario where a carrier modifies network deployment. For example, in a carrier merger and acquisition scenario, if the acquirer's network and the acquiree's network belong to different ASs, BGP peers on the acquiree's network need to be shifted from their original AS to the AS of the acquirer's AS. If the customers of the acquiree do not want their BGP configurations to be changed or do not want them to be changed immediately during the shift, BGP peer relationships may be interrupted for a long time.

If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions before sending routes to the EBGP peer or confederation EBGP peer:

  • If prepend-global-as is not specified in the command, the device adds only the fake AS number to the AS_Path of the routes that match a specified export policy.
  • If prepend-global-as is specified in the command, the device adds the fake AS number followed by the global AS number to the AS_Path of the routes that match a specified export policy.

    If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions after receiving routes from the EBGP peer or confederation EBGP peer:
  • If prepend-local-as is not specified in the command, the device does not change the AS_Path of the received routes.
  • If prepend-local-as is specified in the command, the device adds the fake AS number to the AS_Path of the received routes before filtering them using the specified import policy.

    The peer local-as command is valid only for EBGP peers. If the local device uses the actual AS number to establish an EBGP peer relationship with a remote device, the actual AS number is carried in the AS_Path of the route to be sent to the remote device. If the local device uses the fake AS number to establish the EBGP peer relationship, the fake AS number is carried in the AS_Path of the route to be sent to the remote device.

Prerequisites

Peers have been created using the peer as-number command.

Configuration Impact

If the peer fake-as command is run several times for a peer or a peer group, the latest configuration will overwrite the previous one.

Precautions

If the fake AS number configured on a local device is the same as the remote AS number configured on the device and dual-as is specified in the peer fake-as command, the specified peer cannot be added to a peer group; if dual-as is not specified in this case, the specified peer can be added to a peer group. In addition, if the specified peer is added to a peer group, the fake AS number configured on the device must be the same as the remote AS number configured on the device, and dual-as cannot be specified in the peer fake-as command. For a confederation EBGP peer relationship, the fake AS number configured on the local device cannot be the same as the remote AS number configured on the device. If the fake AS number configured on a local device is the same as the remote AS number configured on the device, EBGP-specific configurations are not allowed. If the fake AS number is deleted, IBGP-specific configurations are not allowed. If the fake AS number configured on a local device is the same as the remote AS number configured on the device and the dual-as parameter is specified in the peer fake-as command, the type of the connection to be established between the local device and the specified peer may be EBGP (or IBGP). For the EBGP connection, some IBGP-specific configurations on the peer may become invalid; for the IBGP connection, some EBGP-specific configurations on the peer may become invalid. Running the peer local-as command will cause the specified peer relationship to be reestablished. After the peer local-as [ dual-as ] [ prepend-global-as ] [ prepend-local-as ] command is run, if the configuration of the dual-as or prepend-local-as parameter is modified, the specified BGP peer relationship will be reestablished. If the configuration of the prepend-global-as parameter is modified in this case, the specified peer relationship will not be reestablished.

Example

# Set a 2-byte fake AS number for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test external
[HUAWEI-bgp-instance-a-vpna] peer test as-number 200
[HUAWEI-bgp-instance-a-vpna] peer test local-as 99

peer local-as (BGP view)

Function

The peer local-as command enables a device to use a fake AS number to establish a BGP peer relationship with a specified peer.

The undo peer local-as command cancels the existing configuration.

By default, a device uses an actual AS number to establish a BGP peer relationship with a peer.

Format

peer ipv4-address local-as local-as-value [ dual-as ] [ prepend-global-as ] [ prepend-local-as ]

undo peer ipv4-address local-as

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

local-as-value

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

dual-as

Allows the local end to use either the real AS number or the fake AS number to establish a connection with the peer end.

-

prepend-global-as

Indicates that the actual AS number is added to packets to be sent.

-

prepend-local-as

Adds the fake AS number to the AS_Path list in received BGP messages.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer local-as command is run, without dual-as, prepend-global-as, or prepend-local-as specified, the local end uses only the fake AS number to establish a BGP peer relationship with the specified peer and adds only the fake AS number to the AS_Path of the routes to be advertised to the peer.

The peer local-as command is used in a scenario where a carrier modifies network deployment. For example, in a carrier merger and acquisition scenario, if the acquirer's network and the acquiree's network belong to different ASs, BGP peers on the acquiree's network need to be shifted from their original AS to the AS of the acquirer's AS. If the customers of the acquiree do not want their BGP configurations to be changed or do not want them to be changed immediately during the shift, BGP peer relationships may be interrupted for a long time.

If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions before sending routes to the EBGP peer or confederation EBGP peer:

  • If prepend-global-as is not specified in the command, the device adds only the fake AS number to the AS_Path of the routes that match a specified export policy.
  • If prepend-global-as is specified in the command, the device adds the fake AS number followed by the global AS number to the AS_Path of the routes that match a specified export policy.

    If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions after receiving routes from the EBGP peer or confederation EBGP peer:
  • If prepend-local-as is not specified in the command, the device does not change the AS_Path of the received routes.
  • If prepend-local-as is specified in the command, the device adds the fake AS number to the AS_Path of the received routes before filtering them using the specified import policy.

    The peer local-as command is valid only for EBGP peers. If the local device uses the actual AS number to establish an EBGP peer relationship with a remote device, the actual AS number is carried in the AS_Path of the route to be sent to the remote device. If the local device uses the fake AS number to establish the EBGP peer relationship, the fake AS number is carried in the AS_Path of the route to be sent to the remote device.

Prerequisites

Peers have been created using the peer as-number command.

Configuration Impact

If this command is run several times for a peer or a peer group, the latest configuration will overwrite the previous one.

Precautions

If the fake AS number configured on a local device is the same as the remote AS number configured on the device and dual-as is specified in the peer fake-as command, the specified peer cannot be added to a peer group; if dual-as is not specified in this case, the specified peer can be added to a peer group. In addition, if the specified peer is added to a peer group, the fake AS number configured on the device must be the same as the remote AS number configured on the device, and dual-as cannot be specified in the peer fake-as command. For a confederation EBGP peer relationship, the fake AS number configured on the local device cannot be the same as the remote AS number configured on the device. If the fake AS number configured on a local device is the same as the remote AS number configured on the device, EBGP-specific configurations are not allowed. If the fake AS number is deleted, IBGP-specific configurations are not allowed. If the fake AS number configured on a local device is the same as the remote AS number configured on the device and the dual-as parameter is specified in the peer fake-as command, the type of the connection to be established between the local device and the specified peer may be EBGP (or IBGP). For the EBGP connection, some IBGP-specific configurations on the peer may become invalid; for the IBGP connection, some EBGP-specific configurations on the peer may become invalid. Running the peer local-as command will cause the specified peer relationship to be reestablished. After the peer local-as [ dual-as ] [ prepend-global-as ] [ prepend-local-as ] command is run, if the configuration of the dual-as or prepend-local-as parameter is modified, the specified BGP peer relationship will be reestablished. If the configuration of the prepend-global-as parameter is modified in this case, the specified peer relationship will not be reestablished.

Example

# Set a 2-byte fake AS number for a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 local-as 99

peer local-as (BGP view) (group)

Function

The peer local-as command enables a device to use a fake AS number to establish a BGP peer relationship with a specified peer.

The undo peer local-as command cancels the existing configuration.

By default, a device uses an actual AS number to establish a BGP peer relationship with a peer.

Format

peer group-name local-as local-as-value [ dual-as ] [ prepend-global-as ] [ prepend-local-as ]

undo peer group-name local-as

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

local-as-value

Specifies an AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

dual-as

Allows the local end to use either the actual AS number or the fake AS number to establish a connection with the peer end.

-

prepend-global-as

Adds the actual AS number to the AS_Path in the messages to be sent.

-

prepend-local-as

Adds the fake AS number to the AS_Path in received messages.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer local-as command is run, without dual-as, prepend-global-as, or prepend-local-as specified, the local end uses only the fake AS number to establish a BGP peer relationship with the specified peer and adds only the fake AS number to the AS_Path of the routes to be advertised to the peer.

The peer local-as command is used in a scenario where a carrier modifies network deployment. For example, in a carrier merger and acquisition scenario, if the acquirer's network and the acquiree's network belong to different ASs, BGP peers on the acquiree's network need to be shifted from their original AS to the AS of the acquirer's AS. If the customers of the acquiree do not want their BGP configurations to be changed or do not want them to be changed immediately during the shift, BGP peer relationships may be interrupted for a long time.

If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions before sending routes to the EBGP peer or confederation EBGP peer:

  • If prepend-global-as is not specified in the command, the device adds only the fake AS number to the AS_Path of the routes that match a specified export policy.
  • If prepend-global-as is specified in the command, the device adds the fake AS number followed by the global AS number to the AS_Path of the routes that match a specified export policy.

    If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions after receiving routes from the EBGP peer or confederation EBGP peer:
  • If prepend-local-as is not specified in the command, the device does not change the AS_Path of the received routes.
  • If prepend-local-as is specified in the command, the device adds the fake AS number to the AS_Path of the received routes before filtering them using the specified import policy.

    The peer local-as command is valid only for EBGP peers. If the local device uses the actual AS number to establish an EBGP peer relationship with a remote device, the actual AS number is carried in the AS_Path of the route to be sent to the remote device. If the local device uses the fake AS number to establish the EBGP peer relationship, the fake AS number is carried in the AS_Path of the route to be sent to the remote device.

Prerequisites

Peers have been created using the peer as-number command.

Configuration Impact

If the peer fake-as command is run several times for a peer or a peer group, the latest configuration will overwrite the previous one.

Precautions

If the fake AS number configured on a local device is the same as the remote AS number configured on the device and dual-as is specified in the peer fake-as command, the specified peer cannot be added to a peer group; if dual-as is not specified in this case, the specified peer can be added to a peer group. In addition, if the specified peer is added to a peer group, the fake AS number configured on the device must be the same as the remote AS number configured on the device, and dual-as cannot be specified in the peer fake-as command. For a confederation EBGP peer relationship, the fake AS number configured on the local device cannot be the same as the remote AS number configured on the device. If the fake AS number configured on a local device is the same as the remote AS number configured on the device, EBGP-specific configurations are not allowed. If the fake AS number is deleted, IBGP-specific configurations are not allowed. If the fake AS number configured on a local device is the same as the remote AS number configured on the device and the dual-as parameter is specified in the peer fake-as command, the type of the connection to be established between the local device and the specified peer may be EBGP (or IBGP). For the EBGP connection, some IBGP-specific configurations on the peer may become invalid; for the IBGP connection, some EBGP-specific configurations on the peer may become invalid. Running the peer local-as command will cause the specified peer relationship to be reestablished. After the peer local-as [ dual-as ] [ prepend-global-as ] [ prepend-local-as ] command is run, if the configuration of the dual-as or prepend-local-as parameter is modified, the specified BGP peer relationship will be reestablished. If the configuration of the prepend-global-as parameter is modified in this case, the specified peer relationship will not be reestablished.

Example

# Set a 2-byte fake AS number for a peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test local-as 99

peer local-as (BGP view) (IPv6)

Function

The peer local-as command enables a device to use a fake AS number to establish a BGP peer relationship with a specified peer.

The undo peer local-as command cancels the existing configuration.

By default, a device uses an actual AS number to establish a BGP peer relationship with a peer.

Format

peer ipv6-address local-as local-as-value [ dual-as ] [ prepend-global-as ] [ prepend-local-as ]

undo peer ipv6-address local-as

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

local-as-value

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

dual-as

Allows the local end to use either the real AS number or the fake AS number to establish a connection with the peer end.

-

prepend-global-as

Indicates that the actual AS number is added to packets to be sent.

-

prepend-local-as

Adds the fake AS number to the AS_Path list in received BGP messages.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer local-as command is run, without dual-as, prepend-global-as, or prepend-local-as specified, the local end uses only the fake AS number to establish a BGP peer relationship with the specified peer and adds only the fake AS number to the AS_Path of the routes to be advertised to the peer.

The peer local-as command is used in a scenario where a carrier modifies network deployment. For example, in a carrier merger and acquisition scenario, if the acquirer's network and the acquiree's network belong to different ASs, BGP peers on the acquiree's network need to be shifted from their original AS to the AS of the acquirer's AS. If the customers of the acquiree do not want their BGP configurations to be changed or do not want them to be changed immediately during the shift, BGP peer relationships may be interrupted for a long time.

If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions before sending routes to the EBGP peer or confederation EBGP peer:

  • If prepend-global-as is not specified in the command, the device adds only the fake AS number to the AS_Path of the routes that match a specified export policy.
  • If prepend-global-as is specified in the command, the device adds the fake AS number followed by the global AS number to the AS_Path of the routes that match a specified export policy.

    If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions after receiving routes from the EBGP peer or confederation EBGP peer:
  • If prepend-local-as is not specified in the command, the device does not change the AS_Path of the received routes.
  • If prepend-local-as is specified in the command, the device adds the fake AS number to the AS_Path of the received routes before filtering them using the specified import policy.

    The peer local-as command is valid only for EBGP peers. If the local device uses the actual AS number to establish an EBGP peer relationship with a remote device, the actual AS number is carried in the AS_Path of the route to be sent to the remote device. If the local device uses the fake AS number to establish the EBGP peer relationship, the fake AS number is carried in the AS_Path of the route to be sent to the remote device.

Prerequisites

Peers have been created using the peer as-number command.

Configuration Impact

If this command is run several times for a peer or a peer group, the latest configuration will overwrite the previous one.

Precautions

If the fake AS number configured on a local device is the same as the remote AS number configured on the device and dual-as is specified in the peer fake-as command, the specified peer cannot be added to a peer group; if dual-as is not specified in this case, the specified peer can be added to a peer group. In addition, if the specified peer is added to a peer group, the fake AS number configured on the device must be the same as the remote AS number configured on the device, and dual-as cannot be specified in the peer fake-as command. For a confederation EBGP peer relationship, the fake AS number configured on the local device cannot be the same as the remote AS number configured on the device. If the fake AS number configured on a local device is the same as the remote AS number configured on the device, EBGP-specific configurations are not allowed. If the fake AS number is deleted, IBGP-specific configurations are not allowed. If the fake AS number configured on a local device is the same as the remote AS number configured on the device and the dual-as parameter is specified in the peer fake-as command, the type of the connection to be established between the local device and the specified peer may be EBGP (or IBGP). For the EBGP connection, some IBGP-specific configurations on the peer may become invalid; for the IBGP connection, some EBGP-specific configurations on the peer may become invalid. Running the peer local-as command will cause the specified peer relationship to be reestablished. After the peer local-as [ dual-as ] [ prepend-global-as ] [ prepend-local-as ] command is run, if the configuration of the dual-as or prepend-local-as parameter is modified, the specified BGP peer relationship will be reestablished. If the configuration of the prepend-global-as parameter is modified in this case, the specified peer relationship will not be reestablished.

Example

# Set a 2-byte fake AS number for a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp] peer 2001:DB8:1::1 local-as 99

peer local-as (BGP-VPN instance IPv4 address family view)

Function

The peer local-as command enables a device to use a fake AS number to establish a BGP peer relationship with a specified peer.

The undo peer local-as command cancels the existing configuration.

By default, a device uses an actual AS number to establish a BGP peer relationship with a peer.

Format

peer ipv4-address local-as local-as-value [ dual-as ] [ prepend-global-as ] [ prepend-local-as ]

undo peer ipv4-address local-as

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

local-as-value

Specifies an AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

dual-as

Allows the local end to use either the actual AS number or the fake AS number to establish a connection with the peer end.

-

prepend-global-as

Adds the actual AS number to the AS_Path in the messages to be sent.

-

prepend-local-as

Indicates that the fake AS number is added to received packets.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer local-as command is run, without dual-as, prepend-global-as, or prepend-local-as specified, the local end uses only the fake AS number to establish a BGP peer relationship with the specified peer and adds only the fake AS number to the AS_Path of the routes to be advertised to the peer.

The peer local-as command is used in a scenario where a carrier modifies network deployment. For example, in a carrier merger and acquisition scenario, if the acquirer's network and the acquiree's network belong to different ASs, BGP peers on the acquiree's network need to be shifted from their original AS to the AS of the acquirer's AS. If the customers of the acquiree do not want their BGP configurations to be changed or do not want them to be changed immediately during the shift, BGP peer relationships may be interrupted for a long time.

If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions before sending routes to the EBGP peer or confederation EBGP peer:

  • If prepend-global-as is not specified in the command, the device adds only the fake AS number to the AS_Path of the routes that match a specified export policy.
  • If prepend-global-as is specified in the command, the device adds the fake AS number followed by the global AS number to the AS_Path of the routes that match a specified export policy.

    If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions after receiving routes from the EBGP peer or confederation EBGP peer:
  • If prepend-local-as is not specified in the command, the device does not change the AS_Path of the received routes.
  • If prepend-local-as is specified in the command, the device adds the fake AS number to the AS_Path of the received routes before filtering them using the specified import policy.

    The peer local-as command is valid only for EBGP peers. If the local device uses the actual AS number to establish an EBGP peer relationship with a remote device, the actual AS number is carried in the AS_Path of the route to be sent to the remote device. If the local device uses the fake AS number to establish the EBGP peer relationship, the fake AS number is carried in the AS_Path of the route to be sent to the remote device.

Prerequisites

Peers have been created using the peer as-number command.

Configuration Impact

If the peer fake-as command is run several times for a peer or a peer group, the latest configuration will overwrite the previous one.

Precautions

If the fake AS number configured on a local device is the same as the remote AS number configured on the device and dual-as is specified in the peer fake-as command, the specified peer cannot be added to a peer group; if dual-as is not specified in this case, the specified peer can be added to a peer group. In addition, if the specified peer is added to a peer group, the fake AS number configured on the device must be the same as the remote AS number configured on the device, and dual-as cannot be specified in the peer fake-as command.For a confederation?EBGP?peer relationship, the fake AS number configured on the local device cannot be the same as the remote AS number configured on the device.If the fake AS number configured on a local device is the same as the remote AS number configured on the device, EBGP-specific configurations are not allowed. If the fake AS number is deleted, IBGP-specific configurations are not allowed.If the fake AS number configured on a local device is the same as the remote AS number configured on the device and the dual-as parameter is specified in the peer fake-as command, the type of the connection to be established between the local device and the specified peer may be EBGP (or IBGP). For the EBGP connection, some IBGP-specific configurations on the peer may become invalid; for the IBGP connection, some EBGP-specific configurations on the peer may become invalid.Running the peer local-as command will cause the specified peer relationship to be reestablished.After the peer local-as [ dual-as ] [ prepend-global-as ] [ prepend-local-as ] command is run, if the configuration of the dual-as or prepend-local-as parameter is modified, the specified BGP peer relationship will be reestablished. If the configuration of the prepend-global-as parameter is modified in this case, the specified peer relationship will not be reestablished.

Example

# Set a 2-byte fake AS number for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-vpn1] peer 10.1.1.1 local-as 99

peer local-as (BGP-VPN instance IPv4 address family view) (group)

Function

The peer local-as command enables a device to use a fake AS number to establish a BGP peer relationship with a specified peer.

The undo peer local-as command cancels the existing configuration.

By default, a device uses an actual AS number to establish a BGP peer relationship with a peer.

Format

peer group-name local-as local-as-value [ dual-as ] [ prepend-global-as ] [ prepend-local-as ]

undo peer group-name local-as

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

local-as-value

Specifies an AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

dual-as

Allows the local end to use the actual or fake AS number to establish a BGP peer relationship with the specified peer.

-

prepend-global-as

Adds the actual AS number to the AS_Path in the messages to be sent.

-

prepend-local-as

Adds the fake AS number to the AS_Path in received messages.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer local-as command is run, without dual-as, prepend-global-as, or prepend-local-as specified, the local end uses only the fake AS number to establish a BGP peer relationship with the specified peer and adds only the fake AS number to the AS_Path of the routes to be advertised to the peer.

The peer local-as command is used in a scenario where a carrier modifies network deployment. For example, in a carrier merger and acquisition scenario, if the acquirer's network and the acquiree's network belong to different ASs, BGP peers on the acquiree's network need to be shifted from their original AS to the AS of the acquirer's AS. If the customers of the acquiree do not want their BGP configurations to be changed or do not want them to be changed immediately during the shift, BGP peer relationships may be interrupted for a long time.

If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions before sending routes to the EBGP peer or confederation EBGP peer:

  • If prepend-global-as is not specified in the command, the device adds only the fake AS number to the AS_Path of the routes that match a specified export policy.
  • If prepend-global-as is specified in the command, the device adds the fake AS number followed by the global AS number to the AS_Path of the routes that match a specified export policy.

    If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions after receiving routes from the EBGP peer or confederation EBGP peer:
  • If prepend-local-as is not specified in the command, the device does not change the AS_Path of the received routes.
  • If prepend-local-as is specified in the command, the device adds the fake AS number to the AS_Path of the received routes before filtering them using the specified import policy.

    The peer local-as command is valid only for EBGP peers. If the local device uses the actual AS number to establish an EBGP peer relationship with a remote device, the actual AS number is carried in the AS_Path of the route to be sent to the remote device. If the local device uses the fake AS number to establish the EBGP peer relationship, the fake AS number is carried in the AS_Path of the route to be sent to the remote device.

Prerequisites

Peers have been created using the peer as-number command.

Configuration Impact

If the peer fake-as command is run several times for a peer or a peer group, the latest configuration will overwrite the previous one.

Precautions

If the fake AS number configured on a local device is the same as the remote AS number configured on the device and dual-as is specified in the peer fake-as command, the specified peer cannot be added to a peer group; if dual-as is not specified in this case, the specified peer can be added to a peer group. In addition, if the specified peer is added to a peer group, the fake AS number configured on the device must be the same as the remote AS number configured on the device, and dual-as cannot be specified in the peer fake-as command. For a confederation EBGP peer relationship, the fake AS number configured on the local device cannot be the same as the remote AS number configured on the device. If the fake AS number configured on a local device is the same as the remote AS number configured on the device, EBGP-specific configurations are not allowed. If the fake AS number is deleted, IBGP-specific configurations are not allowed. If the fake AS number configured on a local device is the same as the remote AS number configured on the device and the dual-as parameter is specified in the peer fake-as command, the type of the connection to be established between the local device and the specified peer may be EBGP (or IBGP). For the EBGP connection, some IBGP-specific configurations on the peer may become invalid; for the IBGP connection, some EBGP-specific configurations on the peer may become invalid. Running the peer local-as command will cause the specified peer relationship to be reestablished. After the peer local-as [ dual-as ] [ prepend-global-as ] [ prepend-local-as ] command is run, if the configuration of the dual-as or prepend-local-as parameter is modified, the specified BGP peer relationship will be reestablished. If the configuration of the prepend-global-as parameter is modified in this case, the specified peer relationship will not be reestablished.

Example

# Set a 2-byte fake AS number for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test external
[HUAWEI-bgp-vpn1] peer test as-number 200
[HUAWEI-bgp-vpn1] peer test local-as 99

peer local-as (BGP-VPN instance IPv6 address family view) (group)

Function

The peer local-as command enables a device to use a fake AS number to establish a BGP peer relationship with a specified peer.

The undo peer local-as command cancels the existing configuration.

By default, a device uses an actual AS number to establish a BGP peer relationship with a peer.

Format

peer group-name local-as local-as-value [ dual-as ] [ prepend-global-as ] [ prepend-local-as ]

undo peer group-name local-as

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

local-as-value

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

dual-as

Allows the local end to use either the real AS number or the fake AS number to establish a connection with the peer end.

-

prepend-global-as

Indicates that the actual AS number is added to packets to be sent.

-

prepend-local-as

Adds the fake AS number to the AS_Path list in received BGP messages.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer local-as command is run, without dual-as, prepend-global-as, or prepend-local-as specified, the local end uses only the fake AS number to establish a BGP peer relationship with the specified peer and adds only the fake AS number to the AS_Path of the routes to be advertised to the peer.

The peer local-as command is used in a scenario where a carrier modifies network deployment. For example, in a carrier merger and acquisition scenario, if the acquirer's network and the acquiree's network belong to different ASs, BGP peers on the acquiree's network need to be shifted from their original AS to the AS of the acquirer's AS. If the customers of the acquiree do not want their BGP configurations to be changed or do not want them to be changed immediately during the shift, BGP peer relationships may be interrupted for a long time.

If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions before sending routes to the EBGP peer or confederation EBGP peer:

  • If prepend-global-as is not specified in the command, the device adds only the fake AS number to the AS_Path of the routes that match a specified export policy.
  • If prepend-global-as is specified in the command, the device adds the fake AS number followed by the global AS number to the AS_Path of the routes that match a specified export policy.

    If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions after receiving routes from the EBGP peer or confederation EBGP peer:
  • If prepend-local-as is not specified in the command, the device does not change the AS_Path of the received routes.
  • If prepend-local-as is specified in the command, the device adds the fake AS number to the AS_Path of the received routes before filtering them using the specified import policy.

    The peer local-as command is valid only for EBGP peers. If the local device uses the actual AS number to establish an EBGP peer relationship with a remote device, the actual AS number is carried in the AS_Path of the route to be sent to the remote device. If the local device uses the fake AS number to establish the EBGP peer relationship, the fake AS number is carried in the AS_Path of the route to be sent to the remote device.

Prerequisites

Peers have been created using the peer as-number command.

Configuration Impact

If this command is run several times for a peer or a peer group, the latest configuration will overwrite the previous one.

Precautions

If the fake AS number configured on a local device is the same as the remote AS number configured on the device and dual-as is specified in the peer fake-as command, the specified peer cannot be added to a peer group; if dual-as is not specified in this case, the specified peer can be added to a peer group. In addition, if the specified peer is added to a peer group, the fake AS number configured on the device must be the same as the remote AS number configured on the device, and dual-as cannot be specified in the peer fake-as command. For a confederation EBGP peer relationship, the fake AS number configured on the local device cannot be the same as the remote AS number configured on the device. If the fake AS number configured on a local device is the same as the remote AS number configured on the device, EBGP-specific configurations are not allowed. If the fake AS number is deleted, IBGP-specific configurations are not allowed. If the fake AS number configured on a local device is the same as the remote AS number configured on the device and the dual-as parameter is specified in the peer fake-as command, the type of the connection to be established between the local device and the specified peer may be EBGP (or IBGP). For the EBGP connection, some IBGP-specific configurations on the peer may become invalid; for the IBGP connection, some EBGP-specific configurations on the peer may become invalid. Running the peer local-as command will cause the specified peer relationship to be reestablished. After the peer local-as [ dual-as ] [ prepend-global-as ] [ prepend-local-as ] command is run, if the configuration of the dual-as or prepend-local-as parameter is modified, the specified BGP peer relationship will be reestablished. If the configuration of the prepend-global-as parameter is modified in this case, the specified peer relationship will not be reestablished.

Example

# Set a 2-byte fake AS number for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test local-as 99

peer local-as (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer local-as command enables a device to use a fake AS number to establish a BGP peer relationship with a specified peer.

The undo peer local-as command cancels the existing configuration.

By default, a device uses an actual AS number to establish a BGP peer relationship with a peer.

Format

peer ipv6-address local-as local-as-value [ dual-as ] [ prepend-global-as ] [ prepend-local-as ]

undo peer ipv6-address local-as

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

local-as-value

Specifies an AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

dual-as

Allows the local end to use the actual or fake AS number to establish a BGP peer relationship with the specified peer.

-

prepend-global-as

Adds the actual AS number to the AS_Path in the messages to be sent.

-

prepend-local-as

Adds the fake AS number to the AS_Path in received messages.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer local-as command is run, without dual-as, prepend-global-as, or prepend-local-as specified, the local end uses only the fake AS number to establish a BGP peer relationship with the specified peer and adds only the fake AS number to the AS_Path of the routes to be advertised to the peer.

The peer local-as command is used in a scenario where a carrier modifies network deployment. For example, in a carrier merger and acquisition scenario, if the acquirer's network and the acquiree's network belong to different ASs, BGP peers on the acquiree's network need to be shifted from their original AS to the AS of the acquirer's AS. If the customers of the acquiree do not want their BGP configurations to be changed or do not want them to be changed immediately during the shift, BGP peer relationships may be interrupted for a long time.

If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions before sending routes to the EBGP peer or confederation EBGP peer:

  • If prepend-global-as is not specified in the command, the device adds only the fake AS number to the AS_Path of the routes that match a specified export policy.
  • If prepend-global-as is specified in the command, the device adds the fake AS number followed by the global AS number to the AS_Path of the routes that match a specified export policy.

    If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions after receiving routes from the EBGP peer or confederation EBGP peer:
  • If prepend-local-as is not specified in the command, the device does not change the AS_Path of the received routes.
  • If prepend-local-as is specified in the command, the device adds the fake AS number to the AS_Path of the received routes before filtering them using the specified import policy.

    The peer local-as command is valid only for EBGP peers. If the local device uses the actual AS number to establish an EBGP peer relationship with a remote device, the actual AS number is carried in the AS_Path of the route to be sent to the remote device. If the local device uses the fake AS number to establish the EBGP peer relationship, the fake AS number is carried in the AS_Path of the route to be sent to the remote device.

Prerequisites

Peers have been created using the peer as-number command.

Configuration Impact

If the peer fake-as command is run several times for a peer or a peer group, the latest configuration will overwrite the previous one.

Precautions

If the fake AS number configured on a local device is the same as the remote AS number configured on the device and dual-as is specified in the peer fake-as command, the specified peer cannot be added to a peer group; if dual-as is not specified in this case, the specified peer can be added to a peer group. In addition, if the specified peer is added to a peer group, the fake AS number configured on the device must be the same as the remote AS number configured on the device, and dual-as cannot be specified in the peer fake-as command. For a confederation EBGP peer relationship, the fake AS number configured on the local device cannot be the same as the remote AS number configured on the device. If the fake AS number configured on a local device is the same as the remote AS number configured on the device, EBGP-specific configurations are not allowed. If the fake AS number is deleted, IBGP-specific configurations are not allowed. If the fake AS number configured on a local device is the same as the remote AS number configured on the device and the dual-as parameter is specified in the peer fake-as command, the type of the connection to be established between the local device and the specified peer may be EBGP (or IBGP). For the EBGP connection, some IBGP-specific configurations on the peer may become invalid; for the IBGP connection, some EBGP-specific configurations on the peer may become invalid. Running the peer local-as command will cause the specified peer relationship to be reestablished. After the peer local-as [ dual-as ] [ prepend-global-as ] [ prepend-local-as ] command is run, if the configuration of the dual-as or prepend-local-as parameter is modified, the specified BGP peer relationship will be reestablished. If the configuration of the prepend-global-as parameter is modified in this case, the specified peer relationship will not be reestablished.

Example

# Set a 2-byte fake AS number for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 local-as 99

peer local-as (BGP-VPN instance view)

Function

The peer local-as command enables a device to use a fake AS number to establish a BGP peer relationship with a specified peer.

The undo peer local-as command cancels the existing configuration.

By default, a device uses an actual AS number to establish a BGP peer relationship with a peer.

Format

peer ipv4-address local-as local-as-value [ dual-as ] [ prepend-global-as ] [ prepend-local-as ]

undo peer ipv4-address local-as

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

local-as-value

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

dual-as

Allows the local end to use either the real AS number or the fake AS number to establish a connection with the peer end.

-

prepend-global-as

Indicates that the actual AS number is added to packets to be sent.

-

prepend-local-as

Adds the fake AS number to the AS_Path list in received BGP messages.

-

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer local-as command is run, without dual-as, prepend-global-as, or prepend-local-as specified, the local end uses only the fake AS number to establish a BGP peer relationship with the specified peer and adds only the fake AS number to the AS_Path of the routes to be advertised to the peer.

The peer local-as command is used in a scenario where a carrier modifies network deployment. For example, in a carrier merger and acquisition scenario, if the acquirer's network and the acquiree's network belong to different ASs, BGP peers on the acquiree's network need to be shifted from their original AS to the AS of the acquirer's AS. If the customers of the acquiree do not want their BGP configurations to be changed or do not want them to be changed immediately during the shift, BGP peer relationships may be interrupted for a long time.

If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions before sending routes to the EBGP peer or confederation EBGP peer:

  • If prepend-global-as is not specified in the command, the device adds only the fake AS number to the AS_Path of the routes that match a specified export policy.
  • If prepend-global-as is specified in the command, the device adds the fake AS number followed by the global AS number to the AS_Path of the routes that match a specified export policy.

    If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions after receiving routes from the EBGP peer or confederation EBGP peer:
  • If prepend-local-as is not specified in the command, the device does not change the AS_Path of the received routes.
  • If prepend-local-as is specified in the command, the device adds the fake AS number to the AS_Path of the received routes before filtering them using the specified import policy.

    The peer local-as command is valid only for EBGP peers. If the local device uses the actual AS number to establish an EBGP peer relationship with a remote device, the actual AS number is carried in the AS_Path of the route to be sent to the remote device. If the local device uses the fake AS number to establish the EBGP peer relationship, the fake AS number is carried in the AS_Path of the route to be sent to the remote device.

Prerequisites

Peers have been created using the peer as-number command.

Configuration Impact

If this command is run several times for a peer or a peer group, the latest configuration will overwrite the previous one.

Precautions

If the fake AS number configured on a local device is the same as the remote AS number configured on the device and dual-as is specified in the peer fake-as command, the specified peer cannot be added to a peer group; if dual-as is not specified in this case, the specified peer can be added to a peer group. In addition, if the specified peer is added to a peer group, the fake AS number configured on the device must be the same as the remote AS number configured on the device, and dual-as cannot be specified in the peer fake-as command. For a confederation EBGP peer relationship, the fake AS number configured on the local device cannot be the same as the remote AS number configured on the device. If the fake AS number configured on a local device is the same as the remote AS number configured on the device, EBGP-specific configurations are not allowed. If the fake AS number is deleted, IBGP-specific configurations are not allowed. If the fake AS number configured on a local device is the same as the remote AS number configured on the device and the dual-as parameter is specified in the peer fake-as command, the type of the connection to be established between the local device and the specified peer may be EBGP (or IBGP). For the EBGP connection, some IBGP-specific configurations on the peer may become invalid; for the IBGP connection, some EBGP-specific configurations on the peer may become invalid. Running the peer local-as command will cause the specified peer relationship to be reestablished. After the peer local-as [ dual-as ] [ prepend-global-as ] [ prepend-local-as ] command is run, if the configuration of the dual-as or prepend-local-as parameter is modified, the specified BGP peer relationship will be reestablished. If the configuration of the prepend-global-as parameter is modified in this case, the specified peer relationship will not be reestablished.

Example

# Set a 2-byte fake AS number for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 local-as 99

peer local-as (BGP-VPN instance view) (group)

Function

The peer local-as command enables a device to use a fake AS number to establish a BGP peer relationship with a specified peer.

The undo peer local-as command cancels the existing configuration.

By default, a device uses an actual AS number to establish a BGP peer relationship with a peer.

Format

peer group-name local-as local-as-value [ dual-as ] [ prepend-global-as ] [ prepend-local-as ]

undo peer group-name local-as

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

local-as-value

Specifies a destination AS number.

For an AS number in integer format, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, it is in the format of x.y, in which x and y are integers, with x ranging from 1 to 65535 and y ranging from 0 to 65535.

dual-as

Allows the local end to use either the real AS number or the fake AS number to establish a connection with the peer end.

-

prepend-global-as

Indicates that the actual AS number is added to packets to be sent.

-

prepend-local-as

Adds the fake AS number to the AS_Path list in received BGP messages.

-

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer local-as command is run, without dual-as, prepend-global-as, or prepend-local-as specified, the local end uses only the fake AS number to establish a BGP peer relationship with the specified peer and adds only the fake AS number to the AS_Path of the routes to be advertised to the peer.

The peer local-as command is used in a scenario where a carrier modifies network deployment. For example, in a carrier merger and acquisition scenario, if the acquirer's network and the acquiree's network belong to different ASs, BGP peers on the acquiree's network need to be shifted from their original AS to the AS of the acquirer's AS. If the customers of the acquiree do not want their BGP configurations to be changed or do not want them to be changed immediately during the shift, BGP peer relationships may be interrupted for a long time.

If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions before sending routes to the EBGP peer or confederation EBGP peer:

  • If prepend-global-as is not specified in the command, the device adds only the fake AS number to the AS_Path of the routes that match a specified export policy.
  • If prepend-global-as is specified in the command, the device adds the fake AS number followed by the global AS number to the AS_Path of the routes that match a specified export policy.

    If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions after receiving routes from the EBGP peer or confederation EBGP peer:
  • If prepend-local-as is not specified in the command, the device does not change the AS_Path of the received routes.
  • If prepend-local-as is specified in the command, the device adds the fake AS number to the AS_Path of the received routes before filtering them using the specified import policy.

    The peer local-as command is valid only for EBGP peers. If the local device uses the actual AS number to establish an EBGP peer relationship with a remote device, the actual AS number is carried in the AS_Path of the route to be sent to the remote device. If the local device uses the fake AS number to establish the EBGP peer relationship, the fake AS number is carried in the AS_Path of the route to be sent to the remote device.

Prerequisites

Peers have been created using the peer as-number command.

Configuration Impact

If this command is run several times for a peer or a peer group, the latest configuration will overwrite the previous one.

Precautions

If the fake AS number configured on a local device is the same as the remote AS number configured on the device and dual-as is specified in the peer fake-as command, the specified peer cannot be added to a peer group; if dual-as is not specified in this case, the specified peer can be added to a peer group. In addition, if the specified peer is added to a peer group, the fake AS number configured on the device must be the same as the remote AS number configured on the device, and dual-as cannot be specified in the peer fake-as command. For a confederation EBGP peer relationship, the fake AS number configured on the local device cannot be the same as the remote AS number configured on the device. If the fake AS number configured on a local device is the same as the remote AS number configured on the device, EBGP-specific configurations are not allowed. If the fake AS number is deleted, IBGP-specific configurations are not allowed. If the fake AS number configured on a local device is the same as the remote AS number configured on the device and the dual-as parameter is specified in the peer fake-as command, the type of the connection to be established between the local device and the specified peer may be EBGP (or IBGP). For the EBGP connection, some IBGP-specific configurations on the peer may become invalid; for the IBGP connection, some EBGP-specific configurations on the peer may become invalid. Running the peer local-as command will cause the specified peer relationship to be reestablished. After the peer local-as [ dual-as ] [ prepend-global-as ] [ prepend-local-as ] command is run, if the configuration of the dual-as or prepend-local-as parameter is modified, the specified BGP peer relationship will be reestablished. If the configuration of the prepend-global-as parameter is modified in this case, the specified peer relationship will not be reestablished.

Example

# Set a 2-byte fake AS number for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test external
[HUAWEI-bgp-instance-vpn1] peer test as-number 200
[HUAWEI-bgp-instance-vpn1] peer test local-as 99

peer local-as (BGP-VPN instance view) (IPv6)

Function

The peer local-as command enables a device to use a fake AS number to establish a BGP peer relationship with a specified peer.

The undo peer local-as command cancels the existing configuration.

By default, a device uses an actual AS number to establish a BGP peer relationship with a peer.

Format

peer peerIpv6Addr local-as local-as-value [ dual-as ] [ prepend-global-as ] [ prepend-local-as ]

undo peer peerIpv6Addr local-as

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

local-as-value

Specifies an AS number.

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

dual-as

Allows the local end to use either the actual AS number or the fake AS number to establish a connection with the peer end.

-

prepend-global-as

Indicates that the actual AS number is added to packets to be sent.

-

prepend-local-as

Adds the fake AS number to the AS_Path in received messages.

-

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer local-as command is run, without dual-as, prepend-global-as, or prepend-local-as specified, the local end uses only the fake AS number to establish a BGP peer relationship with the specified peer and adds only the fake AS number to the AS_Path of the routes to be advertised to the peer.

The peer local-as command is used in a scenario where a carrier modifies network deployment. For example, in a carrier merger and acquisition scenario, if the acquirer's network and the acquiree's network belong to different ASs, BGP peers on the acquiree's network need to be shifted from their original AS to the AS of the acquirer's AS. If the customers of the acquiree do not want their BGP configurations to be changed or do not want them to be changed immediately during the shift, BGP peer relationships may be interrupted for a long time.

If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions before sending routes to the EBGP peer or confederation EBGP peer:

  • If prepend-global-as is not specified in the command, the device adds only the fake AS number to the AS_Path of the routes that match a specified export policy.
  • If prepend-global-as is specified in the command, the device adds the fake AS number followed by the global AS number to the AS_Path of the routes that match a specified export policy.

    If a device uses a fake AS number to establish a BGP peer relationship with an EBGP peer or confederation EBGP peer, it performs the following actions after receiving routes from the EBGP peer or confederation EBGP peer:
  • If prepend-local-as is not specified in the command, the device does not change the AS_Path of the received routes.
  • If prepend-local-as is specified in the command, the device adds the fake AS number to the AS_Path of the received routes before filtering them using the specified import policy.

    The peer local-as command is valid only for EBGP peers. If the local device uses the actual AS number to establish an EBGP peer relationship with a remote device, the actual AS number is carried in the AS_Path of the route to be sent to the remote device. If the local device uses the fake AS number to establish the EBGP peer relationship, the fake AS number is carried in the AS_Path of the route to be sent to the remote device.

Prerequisites

Peers have been created using the peer as-number command.

Configuration Impact

If the peer fake-as command is run several times for a peer or a peer group, the latest configuration will overwrite the previous one.

Precautions

If the fake AS number configured on a local device is the same as the remote AS number configured on the device and dual-as is specified in the peer fake-as command, the specified peer cannot be added to a peer group; if dual-as is not specified in this case, the specified peer can be added to a peer group. In addition, if the specified peer is added to a peer group, the fake AS number configured on the device must be the same as the remote AS number configured on the device, and dual-as cannot be specified in the peer fake-as command. For a confederation EBGP peer relationship, the fake AS number configured on the local device cannot be the same as the remote AS number configured on the device. If the fake AS number configured on a local device is the same as the remote AS number configured on the device, EBGP-specific configurations are not allowed. If the fake AS number is deleted, IBGP-specific configurations are not allowed. If the fake AS number configured on a local device is the same as the remote AS number configured on the device and the dual-as parameter is specified in the peer fake-as command, the type of the connection to be established between the local device and the specified peer may be EBGP (or IBGP). For the EBGP connection, some IBGP-specific configurations on the peer may become invalid; for the IBGP connection, some EBGP-specific configurations on the peer may become invalid. Running the peer local-as command will cause the specified peer relationship to be reestablished. After the peer local-as [ dual-as ] [ prepend-global-as ] [ prepend-local-as ] command is run, if the configuration of the dual-as or prepend-local-as parameter is modified, the specified BGP peer relationship will be reestablished. If the configuration of the prepend-global-as parameter is modified in this case, the specified peer relationship will not be reestablished.

Example

# Set a 2-byte fake AS number for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 local-as 99

peer local-graceful-restart (BGP multi-instance view)

Function

The peer local-graceful-restart enable command enables local GR for a specified peer on a device. After this command is run, the device will not advertise the GR capability to the specified peer.

The peer local-graceful-restart disable command disables local GR for a specified peer on a device.

By default, local GR is not enabled for a peer specified on a device.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address local-graceful-restart disable

peer ipv4-address local-graceful-restart enable

undo peer ipv4-address local-graceful-restart disable

undo peer ipv4-address local-graceful-restart enable

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart enable command on the device to enable local GR for the peer. This configuration ensures that the device does not delete the routes received from the peer and related forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Precautions

If a peer specified on a device does not support GR, you are advised to enable local GR for the peer.

Example

# Enable local GR for a specified peer on a device.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 local-graceful-restart enable

peer local-graceful-restart (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer local-graceful-restart enable command enables local GR for a specified peer on a device. After this command is run, the device will not advertise the GR capability to the specified peer.

The peer local-graceful-restart disable command disables local GR for a specified peer on a device.

By default, local GR is not enabled for a peer specified on a device.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address local-graceful-restart disable

peer ipv4-address local-graceful-restart enable

undo peer ipv4-address local-graceful-restart disable

undo peer ipv4-address local-graceful-restart enable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart enable command on the device to enable local GR for the peer. This configuration ensures that the device does not delete the routes received from the peer and related forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Precautions

If a peer specified on a device does not support GR, you are advised to enable local GR for the peer.

Example

# Enable local GR for a specified peer on a device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-instance-a-vpn1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-instance-a-vpn1] peer 10.1.1.2 local-graceful-restart enable

peer local-graceful-restart (BGP view) (IPv4 and IPv6)

Function

The peer local-graceful-restart enable command enables local GR for a specified peer on a device. After this command is run, the device will not advertise the GR capability to the specified peer.

The peer local-graceful-restart disable command disables local GR for a specified peer on a device.

By default, local GR is not enabled for a peer specified on a device.

Format

peer ipv4-address local-graceful-restart disable

peer ipv6-address local-graceful-restart disable

peer ipv4-address local-graceful-restart enable

peer ipv6-address local-graceful-restart enable

undo peer ipv4-address local-graceful-restart enable

undo peer ipv4-address local-graceful-restart disable

undo peer ipv6-address local-graceful-restart disable

undo peer ipv6-address local-graceful-restart enable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart enable command on the device to enable local GR for the peer. This configuration ensures that the device does not delete the routes received from the peer and related forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Precautions

If a peer specified on a device does not support GR, you are advised to enable local GR for the peer.

Example

# Enable local GR for a specified peer on a device.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 100
[HUAWEI-bgp] peer 10.1.1.2 local-graceful-restart enable

peer local-graceful-restart (BGP-VPN instance IPv4 address family view)

Function

The peer local-graceful-restart enable command enables local GR for a specified peer on a device. After this command is run, the device will not advertise the GR capability to the specified peer.

The peer local-graceful-restart disable command disables local GR for a specified peer on a device.

By default, local GR is not enabled for a peer specified on a device.

Format

peer ipv4-address local-graceful-restart disable

peer ipv4-address local-graceful-restart enable

undo peer ipv4-address local-graceful-restart disable

undo peer ipv4-address local-graceful-restart enable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart enable command on the device to enable local GR for the peer. This configuration ensures that the device does not delete the routes received from the peer and related forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Precautions

If a peer specified on a device does not support GR, you are advised to enable local GR for the peer.

Example

# Enable local GR for a specified peer on a device.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.2 local-graceful-restart enable

peer local-graceful-restart (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer local-graceful-restart enable command enables local GR for a specified peer on a device. After this command is run, the device will not advertise the GR capability to the specified peer.

The peer local-graceful-restart disable command disables local GR for a specified peer on a device.

By default, local GR is not enabled for a peer specified on a device.

Format

peer ipv6-address local-graceful-restart disable

peer ipv6-address local-graceful-restart enable

undo peer ipv6-address local-graceful-restart disable

undo peer ipv6-address local-graceful-restart enable

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a BGP peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart enable command on the device to enable local GR for the peer. This configuration ensures that the device does not delete the routes received from the peer and related forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Precautions

If a peer specified on a device does not support GR, you are advised to enable local GR for the peer.

Example

# Enable local GR for a specified peer on a device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpn1] peer 2001:DB8:1::1 local-graceful-restart enable

peer local-graceful-restart (BGP-VPN instance view)

Function

The peer local-graceful-restart enable command enables local GR for a specified peer on a device. After this command is run, the device will not advertise the GR capability to the specified peer.

The peer local-graceful-restart disable command disables local GR for a specified peer on a device.

By default, local GR is not enabled for a peer specified on a device.

Format

peer ipv4-address local-graceful-restart disable

peer ipv6-address local-graceful-restart disable

peer ipv4-address local-graceful-restart enable

peer ipv6-address local-graceful-restart enable

undo peer ipv4-address local-graceful-restart disable

undo peer ipv6-address local-graceful-restart disable

undo peer ipv4-address local-graceful-restart enable

undo peer ipv6-address local-graceful-restart enable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart enable command on the device to enable local GR for the peer. This configuration ensures that the device does not delete the routes received from the peer and related forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Precautions

If a peer specified on a device does not support GR, you are advised to enable local GR for the peer.

Example

# Enable local GR for a specified peer on a device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 local-graceful-restart enable

peer local-graceful-restart enable (BGP multi-instance view) (group)

Function

The peer local-graceful-restart enable command enables local GR for each peer in a specified group on a device. After this command is run, the device will not advertise the GR capability to any peer in the specified group.

The undo peer local-graceful-restart enable command disables local GR for each peer in a specified group on a device.

By default, local GR is not enabled for any peer in a specified group on a device.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name local-graceful-restart enable

undo peer group-name local-graceful-restart enable

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable local GR for each peer in a specified group on a device, run the peer local-graceful-restart enable command on the device. This configuration ensures that the device does not delete the routes received from the peers in the group and related forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Example

# Enable local GR for each peer in a specified group on a device.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance vpn1
[HUAWEI-bgp-instance-vpn1] group aa
[HUAWEI-bgp-instance-vpn1] peer aa local-graceful-restart enable

peer local-graceful-restart enable (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer local-graceful-restart enable command enables local GR for each peer in a specified group on a device. After this command is run, the device will not advertise the GR capability to any peer in the specified group.

The undo peer local-graceful-restart enable command disables local GR for each peer in a specified group on a device.

By default, local GR is not enabled for any peer in a specified group on a device.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name local-graceful-restart enable

undo peer group-name local-graceful-restart enable

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable local GR for each peer in a specified group on a device, run the peer local-graceful-restart enable command on the device. This configuration ensures that the device does not delete the routes received from the peers in the group and related forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Example

# Enable local GR for each peer in a specified group on a device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-instance-a-vpn1] group aa
[HUAWEI-bgp-instance-a-vpn1] peer aa local-graceful-restart enable

peer local-graceful-restart enable (BGP view)(group)

Function

The peer local-graceful-restart enable command enables local GR for each peer in a specified group on a device. After this command is run, the device will not advertise the GR capability to any peer in the specified group.

The undo peer local-graceful-restart enable command disables local GR for each peer in a specified group on a device.

By default, local GR is not enabled for any peer in a specified group on a device.

Format

peer group-name local-graceful-restart enable

undo peer group-name local-graceful-restart enable

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable local GR for each peer in a specified group on a device, run the peer local-graceful-restart enable command on the device. This configuration ensures that the device does not delete the routes received from the peers in the group and related forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Example

# Enable local GR for each peer in a specified group on a device.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group a
[HUAWEI-bgp] peer a local-graceful-restart enable

peer local-graceful-restart enable (BGP-VPN instance IPv4 address family view) (group)

Function

The peer local-graceful-restart enable command enables local GR for each peer in a specified group on a device. After this command is run, the device will not advertise the GR capability to any peer in the specified group.

The undo peer local-graceful-restart enable command disables local GR for each peer in a specified group on a device.

By default, local GR is not enabled for any peer in a specified group on a device.

Format

peer group-name local-graceful-restart enable

undo peer group-name local-graceful-restart enable

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable local GR for each peer in a specified group on a device, run the peer local-graceful-restart enable command on the device. This configuration ensures that the device does not delete the routes received from the peers in the group and related forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Example

# Enable local GR for each peer in a specified group on a device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group aa
[HUAWEI-bgp-vpn1] peer aa local-graceful-restart enable

peer local-graceful-restart enable (BGP-VPN instance IPv6 address family view) (group)

Function

The peer local-graceful-restart enable command enables local GR for each peer in a specified group on a device. After this command is run, the device will not advertise the GR capability to any peer in the specified group.

The undo peer local-graceful-restart enable command disables local GR for each peer in a specified group on a device.

By default, local GR is not enabled for any peer in a specified group on a device.

Format

peer group-name local-graceful-restart enable

undo peer group-name local-graceful-restart enable

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable local GR for each peer in a specified group on a device, run the peer local-graceful-restart enable command on the device. This configuration ensures that the device does not delete the routes received from the peers in the group and related forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Example

# Enable local GR for each peer in a specified group on a device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group aa
[HUAWEI-bgp-6-vpn1] peer aa local-graceful-restart enable

peer local-graceful-restart enable (BGP-VPN instance view) (group)

Function

The peer local-graceful-restart enable command enables local GR for each peer in a specified group on a device. After this command is run, the device will not advertise the GR capability to any peer in the specified group.

The undo peer local-graceful-restart enable command disables local GR for each peer in a specified group on a device.

By default, local GR is not enabled for any peer in a specified group on a device.

Format

peer group-name local-graceful-restart enable

undo peer group-name local-graceful-restart enable

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable local GR for each peer in a specified group on a device, run the peer local-graceful-restart enable command on the device. This configuration ensures that the device does not delete the routes received from the peers in the group and related forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Example

# Enable local GR for each peer in a specified group on a device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group aa
[HUAWEI-bgp-instance-vpn1] peer aa local-graceful-restart enable

peer local-graceful-restart enable(BGP multi-instance VPN instance view)

Function

The peer local-graceful-restart enable command enables local GR for a specified peer.

The peer local-graceful-restart disable command disables local GR for a specified peer.

By default, local GR is not enabled for a peer specified on a device.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr local-graceful-restart enable

peer peerIpv6Addr local-graceful-restart enable

peer peerIpv4Addr local-graceful-restart disable

peer peerIpv6Addr local-graceful-restart disable

undo peer peerIpv4Addr local-graceful-restart enable

undo peer peerIpv4Addr local-graceful-restart disable

undo peer peerIpv6Addr local-graceful-restart enable

undo peer peerIpv6Addr local-graceful-restart disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

peerIpv6Addr

Specifies the IPv6 address of a BGP peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart enable command on the device to enable local GR for the peer. This configuration ensures that the device does not delete the routes received from the peer and related forwarding entries before the GR time elapses, thereby preventing traffic interruption.

Example

# Enable local GR for a specified peer on a device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] vpn-instance vpn1
[HUAWEI-bgp-instance-a-instance-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-instance-vpn1] peer 10.1.1.1 local-graceful-restart enable

peer local-graceful-restart timer restart (BGP multi-instance view) (group)

Function

The peer local-graceful-restart timer restart command sets the maximum duration for a device to wait for the BGP peer relationship with each peer in a specified group to be reestablished. After this command is run, the device will not advertise the maximum duration to any peer in the specified group.

The undo peer local-graceful-restart timer restart command deletes the configured duration.

By default, a device waits for the BGP peer relationship with each peer in a specified group to be reestablished for a maximum of 150s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name local-graceful-restart timer restart restart-time

undo peer group-name local-graceful-restart timer restart

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

restart-time

Specifies the maximum duration for a device to wait for the GR recovery of each peer in a specified group.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device supports GR but the specified peer does not support GR, you can run this command to set the maximum waiting time for the local device to wait for the re-establishment of the BGP peer relationship.

After the peer local-graceful-restart timer restart command is run, if the local end finds that the peer group is Down, the BGP session enters the GR process. The local end must establish a connection with the peer group within the configured maximum waiting time. Otherwise, the local end selects the optimal route from the existing routes.

Example

# Set the maximum duration to 250s for a device to wait for the peer relationship with each peer in a specified group to be reestablished.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance vpn1
[HUAWEI-bgp-instance-vpn1] group aa
[HUAWEI-bgp-instance-vpn1] peer aa local-graceful-restart timer restart 250

peer local-graceful-restart timer restart (BGP multi-instance view)(IPv4)

Function

The peer local-graceful-restart timer restart command sets the maximum duration for a device to wait for the BGP peer relationship with a specified peer to be reestablished. After this command is run, the device will not advertise the maximum duration to the specified peer.

The undo peer local-graceful-restart timer restart command deletes the configured duration.

By default, a device waits for the peer relationship with a peer to be reestablished for a maximum of 150 seconds.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address local-graceful-restart timer restart restart-time

undo peer ipv4-address local-graceful-restart timer restart

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

restart-time

Specifies the maximum time for the local end to wait for GR recovery of the peer.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device supports GR but the specified peer does not support GR, you can run this command to set the maximum waiting time for the local device to wait for the re-establishment of the BGP peer relationship.

After the peer local-graceful-restart timer restart command is run, if the local end finds that the peer is Down, the BGP session enters the GR process. The local end must establish a connection with the peer within the configured maximum waiting time. Otherwise, the local end selects the optimal route from the existing routes.

Example

# Set the maximum duration to 250 seconds for a device to wait for the peer relationship with a specified peer to be reestablished.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 local-graceful-restart timer restart 250

peer local-graceful-restart timer restart (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer local-graceful-restart timer restart command sets the maximum duration for a device to wait for the BGP peer relationship with each peer in a specified group to be reestablished. After this command is run, the device will not advertise the maximum duration to any peer in the specified group.

The undo peer local-graceful-restart timer restart command deletes the configured duration.

By default, a device waits for the BGP peer relationship with each peer in a specified group to be reestablished for a maximum of 150s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name local-graceful-restart timer restart restart-time

undo peer group-name local-graceful-restart timer restart

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

restart-time

Specifies the maximum duration for a device to wait for the GR recovery of each peer in a specified group.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device supports GR but the specified peer does not support GR, you can run this command to set the maximum waiting time for the local device to wait for the re-establishment of the BGP peer relationship.

After the peer local-graceful-restart timer restart command is run, if the local end finds that the peer group is Down, the BGP session enters the GR process. The local end must establish a connection with the peer group within the configured maximum waiting time. Otherwise, the local end selects the optimal route from the existing routes.

Example

# Set the maximum duration to 250s for a device to wait for the peer relationship with each peer in a specified group to be reestablished.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-instance-a-vpn1] group aa
[HUAWEI-bgp-instance-a-vpn1] peer aa local-graceful-restart timer restart 250

peer local-graceful-restart timer restart (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer local-graceful-restart timer restart command sets the maximum duration for a device to wait for the BGP peer relationship with a specified peer to be reestablished. After this command is run, the device will not advertise the maximum duration to the specified peer.

The undo peer local-graceful-restart timer restart command deletes the configured duration.

By default, a device waits for the peer relationship with a peer to be reestablished for a maximum of 150 seconds.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address local-graceful-restart timer restart restart-time

undo peer ipv4-address local-graceful-restart timer restart

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

restart-time

Specifies the maximum time for the local end to wait for GR recovery of the peer.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device supports GR but the specified peer does not support GR, you can run this command to set the maximum waiting time for the local device to wait for the re-establishment of the BGP peer relationship.

After the peer local-graceful-restart timer restart command is run, if the local end finds that the peer is Down, the BGP session enters the GR process. The local end must establish a connection with the peer within the configured maximum waiting time. Otherwise, the local end selects the optimal route from the existing routes.

Example

# Set the maximum duration to 250 seconds for a device to wait for the peer relationship with a specified peer to be reestablished.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-instance-a-vpn1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-instance-a-vpn1] peer 10.1.1.2 local-graceful-restart timer restart 250

peer local-graceful-restart timer restart (BGP view)

Function

The peer local-graceful-restart timer restart command sets the maximum duration for a device to wait for the BGP peer relationship with a specified peer to be reestablished. After this command is run, the device will not advertise the maximum duration to the specified peer.

The undo peer local-graceful-restart timer restart command deletes the configured duration.

By default, a device waits for the peer relationship with a peer to be reestablished for a maximum of 150 seconds.

Format

peer ipv4-address local-graceful-restart timer restart restart-time

peer ipv6-address local-graceful-restart timer restart restart-time

undo peer ipv4-address local-graceful-restart timer restart

undo peer ipv6-address local-graceful-restart timer restart

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

restart-time

Specifies the maximum time for the local end to wait for GR recovery of the peer.

The value is an integer ranging from 3 to 3600, in seconds.

ipv6-address

Specifies the IPv6 address of a BGP peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device supports GR but the specified peer does not support GR, you can run this command to set the maximum waiting time for the local device to wait for the re-establishment of the BGP peer relationship.

After the peer local-graceful-restart timer restart command is run, if the local end finds that the peer is Down, the BGP session enters the GR process. The local end must establish a connection with the peer within the configured maximum waiting time. Otherwise, the local end selects the optimal route from the existing routes.

Example

# Set the maximum duration to 250 seconds for a device to wait for the peer relationship with a specified peer to be reestablished.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 100
[HUAWEI-bgp] peer 10.1.1.2 local-graceful-restart timer restart 250

peer local-graceful-restart timer restart (BGP view)(group)

Function

The peer local-graceful-restart timer restart command sets the maximum duration for a device to wait for the BGP peer relationship with each peer in a specified group to be reestablished. After this command is run, the device will not advertise the maximum duration to any peer in the specified group.

The undo peer local-graceful-restart timer restart command deletes the configured duration.

By default, a device waits for the BGP peer relationship with each peer in a specified group to be reestablished for a maximum of 150s.

Format

peer group-name local-graceful-restart timer restart restart-time

undo peer group-name local-graceful-restart timer restart

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

restart-time

Specifies the maximum duration for a device to wait for the GR recovery of each peer in a specified group.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device supports GR but the specified peer does not support GR, you can run this command to set the maximum waiting time for the local device to wait for the re-establishment of the BGP peer relationship.

After the peer local-graceful-restart timer restart command is run, if the local end finds that the peer group is Down, the BGP session enters the GR process. The local end must establish a connection with the peer group within the configured maximum waiting time. Otherwise, the local end selects the optimal route from the existing routes.

Example

# Set the maximum duration to 250s for a device to wait for the peer relationship with each peer in a specified group to be reestablished.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group aa
[HUAWEI-bgp] peer aa local-graceful-restart timer restart 250

peer local-graceful-restart timer restart (BGP-VPN instance IPv4 address family view) (group)

Function

The peer local-graceful-restart timer restart command sets the maximum duration for a device to wait for the BGP peer relationship with each peer in a specified group to be reestablished. After this command is run, the device will not advertise the maximum duration to any peer in the specified group.

The undo peer local-graceful-restart timer restart command deletes the configured duration.

By default, a device waits for the BGP peer relationship with each peer in a specified group to be reestablished for a maximum of 150s.

Format

peer group-name local-graceful-restart timer restart restart-time

undo peer group-name local-graceful-restart timer restart

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

restart-time

Specifies the maximum duration for a device to wait for the GR recovery of each peer in a specified group.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device supports GR but the specified peer does not support GR, you can run this command to set the maximum waiting time for the local device to wait for the re-establishment of the BGP peer relationship.

After the peer local-graceful-restart timer restart command is run, if the local end finds that the peer group is Down, the BGP session enters the GR process. The local end must establish a connection with the peer group within the configured maximum waiting time. Otherwise, the local end selects the optimal route from the existing routes.

Example

# Set the maximum duration to 250s for a device to wait for the peer relationship with each peer in a specified group to be reestablished.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group aa
[HUAWEI-bgp-vpn1] peer aa local-graceful-restart timer restart 250

peer local-graceful-restart timer restart (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer local-graceful-restart timer restart command sets the maximum duration for a device to wait for the BGP peer relationship with a specified peer to be reestablished. After this command is run, the device will not advertise the maximum duration to the specified peer.

The undo peer local-graceful-restart timer restart command deletes the configured duration.

By default, a device waits for the peer relationship with a peer to be reestablished for a maximum of 150 seconds.

Format

peer ipv4-address local-graceful-restart timer restart restart-time

undo peer ipv4-address local-graceful-restart timer restart

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

restart-time

Specifies the maximum duration for a device to wait for the GR recovery of a specified peer.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device supports GR but the specified peer does not support GR, you can run this command to set the maximum waiting time for the local device to wait for the re-establishment of the BGP peer relationship.

After the peer local-graceful-restart timer restart command is run, if the local end finds that the peer is Down, the BGP session enters the GR process. The local end must establish a connection with the peer within the configured maximum waiting time. Otherwise, the local end selects the optimal route from the existing routes.

Example

# Set the maximum duration to 250 seconds for a device to wait for the peer relationship with a specified peer to be reestablished.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-vpn1] peer 10.1.1.2 local-graceful-restart timer restart 250

peer local-graceful-restart timer restart (BGP-VPN instance IPv6 address family view) (group)

Function

The peer local-graceful-restart timer restart command sets the maximum duration for a device to wait for the BGP peer relationship with each peer in a specified group to be reestablished. After this command is run, the device will not advertise the maximum duration to any peer in the specified group.

The undo peer local-graceful-restart timer restart command deletes the configured duration.

By default, a device waits for the BGP peer relationship with each peer in a specified group to be reestablished for a maximum of 150s.

Format

peer group-name local-graceful-restart timer restart restart-time

undo peer group-name local-graceful-restart timer restart

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

restart-time

Specifies the maximum duration for a device to wait for the GR recovery of each peer in a specified group.

The value is an integer ranging from 3 to 3600, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device supports GR but the specified peer does not support GR, you can run this command to set the maximum waiting time for the local device to wait for the re-establishment of the BGP peer relationship.

After the peer local-graceful-restart timer restart command is run, if the local end finds that the peer group is Down, the BGP session enters the GR process. The local end must establish a connection with the peer group within the configured maximum waiting time. Otherwise, the local end selects the optimal route from the existing routes.

Example

# Set the maximum duration to 250s for a device to wait for the peer relationship with each peer in a specified group to be reestablished.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group aa
[HUAWEI-bgp-6-vpn1] peer aa local-graceful-restart timer restart 250

peer local-graceful-restart timer restart (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer local-graceful-restart timer restart command sets the maximum duration for a device to wait for the BGP peer relationship with a specified peer to be reestablished. After this command is run, the device will not advertise the maximum duration to the specified peer.

The undo peer local-graceful-restart timer restart command deletes the configured duration.

By default, a device waits for the peer relationship with a peer to be reestablished for a maximum of 150 seconds.

Format

peer ipv6-address local-graceful-restart timer restart restart-time

undo peer ipv6-address local-graceful-restart timer restart

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is in the format of X:X:X:X:X:X:X:X.

restart-time

Specifies the maximum time for the local end to wait for GR recovery of the peer.

The value is an integer ranging from 3 to 3600, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device supports GR but the specified peer does not support GR, you can run this command to set the maximum waiting time for the local device to wait for the re-establishment of the BGP peer relationship.

After the peer local-graceful-restart timer restart command is run, if the local end finds that the peer is Down, the BGP session enters the GR process. The local end must establish a connection with the peer within the configured maximum waiting time. Otherwise, the local end selects the optimal route from the existing routes.

Example

# Set the maximum duration to 250 seconds for a device to wait for the peer relationship with a specified peer to be reestablished.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpn1] peer 2001:DB8:1::1 local-graceful-restart timer restart 250

peer local-graceful-restart timer restart (BGP-VPN instance view)

Function

The peer local-graceful-restart timer restart command sets the maximum duration for a device to wait for the BGP peer relationship with a specified peer to be reestablished. After this command is run, the device will not advertise the maximum duration to the specified peer.

The undo peer local-graceful-restart timer restart command deletes the configured duration.

By default, a device waits for the peer relationship with a peer to be reestablished for a maximum of 150 seconds.

Format

peer ipv4-address local-graceful-restart timer restart restart-time

peer ipv6-address local-graceful-restart timer restart restart-time

undo peer ipv4-address local-graceful-restart timer restart

undo peer ipv6-address local-graceful-restart timer restart

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

restart-time

Specifies the maximum duration for a device to wait for the GR recovery of a specified peer.

The value is an integer ranging from 3 to 3600, in seconds.

ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device supports GR but the specified peer does not support GR, you can run this command to set the maximum waiting time for the local device to wait for the re-establishment of the BGP peer relationship.

After the peer local-graceful-restart timer restart command is run, if the local end finds that the peer is Down, the BGP session enters the GR process. The local end must establish a connection with the peer within the configured maximum waiting time. Otherwise, the local end selects the optimal route from the existing routes.

Example

# Set the maximum duration to 250 seconds for a device to wait for the peer relationship with a specified peer to be reestablished.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 local-graceful-restart timer restart 250

peer local-graceful-restart timer restart (BGP-VPN instance view) (group)

Function

The peer local-graceful-restart timer restart command sets the maximum duration for a device to wait for the BGP peer relationship with each peer in a specified group to be reestablished. After this command is run, the device will not advertise the maximum duration to any peer in the specified group.

The undo peer local-graceful-restart timer restart command deletes the configured duration.

By default, a device waits for the BGP peer relationship with each peer in a specified group to be reestablished for a maximum of 150s.

Format

peer group-name local-graceful-restart timer restart restart-time

undo peer group-name local-graceful-restart timer restart

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

restart-time

Specifies the maximum duration for a device to wait for the GR recovery of each peer in a specified group.

The value is an integer ranging from 3 to 3600, in seconds.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device supports GR but the specified peer does not support GR, you can run this command to set the maximum waiting time for the local device to wait for the re-establishment of the BGP peer relationship.

After the peer local-graceful-restart timer restart command is run, if the local end finds that the peer group is Down, the BGP session enters the GR process. The local end must establish a connection with the peer group within the configured maximum waiting time. Otherwise, the local end selects the optimal route from the existing routes.

Example

# Set the maximum duration to 250s for a device to wait for the peer relationship with each peer in a specified group to be reestablished.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group aa
[HUAWEI-bgp-instance-vpn1] peer aa local-graceful-restart timer restart 250

peer local-graceful-restart timer restart(BGP multi-instance VPN instance view)(IPv4)

Function

The peer local-graceful-restart timer restart command sets the maximum duration for a device to wait for the BGP peer relationship with a specified peer to be reestablished. After this command is run, the device will not advertise the maximum duration to the specified peer. The undo peer local-graceful-restart timer restart command deletes the configured duration.

By default, a device waits for the peer relationship with a peer to be reestablished for a maximum of 150 seconds.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr local-graceful-restart timer restart restart-time

peer peerIpv6Addr local-graceful-restart timer restart restart-time

undo peer peerIpv6Addr local-graceful-restart timer restart

undo peer peerIpv4Addr local-graceful-restart timer restart

Parameters

Parameter Description Value
peerIpv4Addr

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

restart-time

Specifies the maximum duration for a device to wait for the GR recovery of a specified peer.

The value is an integer that ranges from 3 to 3600, in seconds.

peerIpv6Addr

Specifies the IPv6 address of a BGP peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local device supports GR but the specified peer does not support GR, you can run this command to set the maximum waiting time for the local device to wait for the re-establishment of the BGP peer relationship.

After the peer local-graceful-restart timer restart command is run, if the local end finds that the peer group is Down, the BGP session enters the GR process. The local end must establish a connection with the peer group within the configured maximum waiting time. Otherwise, the local end selects the optimal route from the existing routes.

Example

# Set the maximum duration to 250 seconds for a device to wait for the peer relationship with a specified peer to be reestablished.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] vpn-instance vpn1
[HUAWEI-bgp-instance-a-instance-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-instance-vpn1] peer 10.1.1.1 local-graceful-restart timer restart 250

peer local-graceful-restart timer wait-for-rib (BGP multi-instance view)

Function

The peer local-graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from a specified peer.

The undo peer local-graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address local-graceful-restart timer wait-for-rib wfrtime

undo peer ipv4-address local-graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

wfrtime

Specifies the maximum duration for waiting for the End-Of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart timer wait-for-rib command to set the maximum duration for the device to wait for the End-of-RIB flag from the peer. After the BGP session between the device and the peer is reestablished, if the device does not receive the End-of-RIB flag within the specified duration, the BGP session on the device exits from the GR process and the device selects the optimal route among reachable routes.

Example

# Set the maximum duration for a device to wait for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 local-graceful-restart timer wait-for-rib 100

peer local-graceful-restart timer wait-for-rib (BGP multi-instance view) (group)

Function

The peer local-graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer in a specified group.

The undo peer local-graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer in a specified group for a maximum of 600s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name local-graceful-restart timer wait-for-rib wfrtime

undo peer group-name local-graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

wfrtime

Specifies the maximum duration for waiting for the End-Of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To set the maximum duration for a device to wait for the End-of-RIB flag from each peer in a group, run the peer local-graceful-restart timer wait-for-rib command on the device. After a BGP session between the device and a peer in the group is reestablished, if the device does not receive the End-of-RIB flag within the specified duration, the involved BGP session on the device exits from the GR process and the device selects the optimal route among reachable routes.

Example

# Set the maximum duration for a device to wait for the End-of-RIB flag from each peer in a specified group to 100s.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance vpn1
[HUAWEI-bgp-instance-vpn1] group aa
[HUAWEI-bgp-instance-vpn1] peer aa local-graceful-restart timer wait-for-rib 100

peer local-graceful-restart timer wait-for-rib (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer local-graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from a specified peer.

The undo peer local-graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address local-graceful-restart timer wait-for-rib wfrtime

undo peer ipv4-address local-graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

wfrtime

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart timer wait-for-rib command to set the maximum duration for the device to wait for the End-of-RIB flag from the peer. After the BGP session between the device and the peer is reestablished, if the device does not receive the End-of-RIB flag within the specified duration, the BGP session on the device exits from the GR process and the device selects the optimal route among reachable routes.

Example

# Set the maximum duration for a device to wait for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance vpn1
[HUAWEI-bgp-instance-vpn1] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1-vpn1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-instance-vpn1-vpn1] peer 10.1.1.2 local-graceful-restart timer wait-for-rib 100

peer local-graceful-restart timer wait-for-rib (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer local-graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer in a specified group.

The undo peer local-graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer in a specified group for a maximum of 600s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name local-graceful-restart timer wait-for-rib wfrtime

undo peer group-name local-graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

wfrtime

Specifies the maximum duration for waiting for the End-Of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To set the maximum duration for a device to wait for the End-of-RIB flag from each peer in a group, run the peer local-graceful-restart timer wait-for-rib command on the device. After a BGP session between the device and a peer in the group is reestablished, if the device does not receive the End-of-RIB flag within the specified duration, the involved BGP session on the device exits from the GR process and the device selects the optimal route among reachable routes.

Example

# Set the maximum duration for a device to wait for the End-of-RIB flag from each peer in a specified group to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-instance-a-vpn1] group aa
[HUAWEI-bgp-instance-a-vpn1] peer aa local-graceful-restart timer wait-for-rib 100

peer local-graceful-restart timer wait-for-rib (BGP view)

Function

The peer local-graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from a specified peer.

The undo peer local-graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

Format

peer ipv4-address local-graceful-restart timer wait-for-rib wfrtime

peer ipv6-address local-graceful-restart timer wait-for-rib wfrtime

undo peer ipv4-address local-graceful-restart timer wait-for-rib

undo peer ipv6-address local-graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

wfrtime

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart timer wait-for-rib command to set the maximum duration for the device to wait for the End-of-RIB flag from the peer. After the BGP session between the device and the peer is reestablished, if the device does not receive the End-of-RIB flag within the specified duration, the BGP session on the device exits from the GR process and the device selects the optimal route among reachable routes.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 100
[HUAWEI-bgp] peer 10.1.1.2 local-graceful-restart timer wait-for-rib 100

peer local-graceful-restart timer wait-for-rib (BGP view)(group)

Function

The peer local-graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer in a specified group.

The undo peer local-graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer in a specified group for a maximum of 600s.

Format

peer group-name local-graceful-restart timer wait-for-rib wfrtime

undo peer group-name local-graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

wfrtime

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To set the maximum duration for a device to wait for the End-of-RIB flag from each peer in a group, run the peer local-graceful-restart timer wait-for-rib command on the device. After a BGP session between the device and a peer in the group is reestablished, if the device does not receive the End-of-RIB flag within the specified duration, the involved BGP session on the device exits from the GR process and the device selects the optimal route among reachable routes.

Example

# Set the maximum duration for a device to wait for the End-of-RIB flag from each peer in a specified group to 100s.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group aa
[HUAWEI-bgp] peer aa local-graceful-restart timer wait-for-rib 100

peer local-graceful-restart timer wait-for-rib (BGP-VPN instance IPv4 address family view)

Function

The peer local-graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from a specified peer.

The undo peer local-graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

Format

peer ipv4-address local-graceful-restart timer wait-for-rib wfrtime

undo peer ipv4-address local-graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

wfrtime

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart timer wait-for-rib command to set the maximum duration for the device to wait for the End-of-RIB flag from the peer. After the BGP session between the device and the peer is reestablished, if the device does not receive the End-of-RIB flag within the specified duration, the BGP session on the device exits from the GR process and the device selects the optimal route among reachable routes.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.2 local-graceful-restart timer wait-for-rib 100

peer local-graceful-restart timer wait-for-rib (BGP-VPN instance IPv4 address family view) (group)

Function

The peer local-graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer in a specified group.

The undo peer local-graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer in a specified group for a maximum of 600s.

Format

peer group-name local-graceful-restart timer wait-for-rib wfrtime

undo peer group-name local-graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

wfrtime

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To set the maximum duration for a device to wait for the End-of-RIB flag from each peer in a group, run the peer local-graceful-restart timer wait-for-rib command on the device. After a BGP session between the device and a peer in the group is reestablished, if the device does not receive the End-of-RIB flag within the specified duration, the involved BGP session on the device exits from the GR process and the device selects the optimal route among reachable routes.

Example

# Set the maximum duration for a device to wait for the End-of-RIB flag from each peer in a specified group to 100s.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group aa
[HUAWEI-bgp-vpn1] peer aa local-graceful-restart timer wait-for-rib 100

peer local-graceful-restart timer wait-for-rib (BGP-VPN instance IPv6 address family view) (group)

Function

The peer local-graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer in a specified group.

The undo peer local-graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer in a specified group for a maximum of 600s.

Format

peer group-name local-graceful-restart timer wait-for-rib wfrtime

undo peer group-name local-graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

wfrtime

Specifies the maximum duration for waiting for the End-Of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To set the maximum duration for a device to wait for the End-of-RIB flag from each peer in a group, run the peer local-graceful-restart timer wait-for-rib command on the device. After a BGP session between the device and a peer in the group is reestablished, if the device does not receive the End-of-RIB flag within the specified duration, the involved BGP session on the device exits from the GR process and the device selects the optimal route among reachable routes.

Example

# Set the maximum duration for a device to wait for the End-of-RIB flag from each peer in a specified group to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group aa
[HUAWEI-bgp-6-vpn1] peer aa local-graceful-restart timer wait-for-rib 100

peer local-graceful-restart timer wait-for-rib (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer local-graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from a specified peer.

The undo peer local-graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

Format

peer ipv6-address local-graceful-restart timer wait-for-rib wfrtime

undo peer ipv6-address local-graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

wfrtime

Specifies the maximum duration for waiting for the End-Of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart timer wait-for-rib command to set the maximum duration for the device to wait for the End-of-RIB flag from the peer. After the BGP session between the device and the peer is reestablished, if the device does not receive the End-of-RIB flag within the specified duration, the BGP session on the device exits from the GR process and the device selects the optimal route among reachable routes.

Example

# Set the maximum duration for a device to wait for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpn1] peer 2001:DB8:1::1 local-graceful-restart timer wait-for-rib 100

peer local-graceful-restart timer wait-for-rib (BGP-VPN instance view)

Function

The peer local-graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from a specified peer.

The undo peer local-graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

Format

peer ipv4-address local-graceful-restart timer wait-for-rib wfrtime

peer ipv6-address local-graceful-restart timer wait-for-rib wfrtime

undo peer ipv4-address local-graceful-restart timer wait-for-rib

undo peer ipv6-address local-graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

wfrtime

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart timer wait-for-rib command to set the maximum duration for the device to wait for the End-of-RIB flag from the peer. After the BGP session between the device and the peer is reestablished, if the device does not receive the End-of-RIB flag within the specified duration, the BGP session on the device exits from the GR process and the device selects the optimal route among reachable routes.

Example

# Set the maximum duration during which a BGP restarter waits for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 local-graceful-restart timer wait-for-rib 100

peer local-graceful-restart timer wait-for-rib (BGP-VPN instance view) (group)

Function

The peer local-graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from each peer in a specified group.

The undo peer local-graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from each peer in a specified group for a maximum of 600s.

Format

peer group-name local-graceful-restart timer wait-for-rib wfrtime

undo peer group-name local-graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

wfrtime

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To set the maximum duration for a device to wait for the End-of-RIB flag from each peer in a group, run the peer local-graceful-restart timer wait-for-rib command on the device. After a BGP session between the device and a peer in the group is reestablished, if the device does not receive the End-of-RIB flag within the specified duration, the involved BGP session on the device exits from the GR process and the device selects the optimal route among reachable routes.

Example

# Set the maximum duration for a device to wait for the End-of-RIB flag from each peer in a specified group to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] route-distinguisher 1:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group aa
[HUAWEI-bgp-instance-vpn1] peer aa local-graceful-restart timer wait-for-rib 100

peer local-graceful-restart timer wait-for-rib(BGP multi-instance VPN instance view)

Function

The peer local-graceful-restart timer wait-for-rib command sets the maximum duration for a BGP restarter to wait for the End-of-RIB flag from a specified peer.

The undo peer local-graceful-restart timer wait-for-rib command deletes the configured duration.

By default, a BGP restarter waits for the End-of-RIB flag from a specified peer for a maximum of 600s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr local-graceful-restart timer wait-for-rib wfrtime

peer peerIpv6Addr local-graceful-restart timer wait-for-rib wfrtime

undo peer peerIpv4Addr local-graceful-restart timer wait-for-rib

undo peer peerIpv6Addr local-graceful-restart timer wait-for-rib

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

It is in dotted decimal notation.

wfrtime

Specifies the maximum duration for a BGP restarter to wait for the End-of-RIB flag.

The value is an integer ranging from 3 to 3000, in seconds.

peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device supports GR but a BGP peer specified on the device does not support GR, you can run the peer local-graceful-restart timer wait-for-rib command to set the maximum duration for the device to wait for the End-of-RIB flag from the peer. After the BGP session between the device and the peer is reestablished, if the device does not receive the End-of-RIB flag within the specified duration, the BGP session on the device exits from the GR process and the device selects the optimal route among reachable routes.

Example

# Set the maximum duration for a device to wait for the End-of-RIB flag from a specified peer to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn
[HUAWEI-vpn-instance-vpn] ipv4-family
[HUAWEI-vpn-instance-vpn-af-ipv4] quit
[HUAWEI-vpn-instance-vpn] quit
[HUAWEI] bgp 100 instance vpn1
[HUAWEI-bgp-instance-vpn1] vpn-instance vpn
[HUAWEI-bgp-instance-vpn1-instance-vpn] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-instance-vpn1-instance-vpn] peer 10.1.1.2 local-graceful-restart timer wait-for-rib 100

peer log-change (BGP multi-instance view)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified peer or a peer.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address log-change

undo peer ipv4-address log-change

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer, facilitating service management.

Example

# Configure a BGP device to log the session status and events of peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 10.1.1.1 log-change

peer log-change (BGP multi-instance view) (group)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified group.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name log-change

undo peer group-name log-change

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer group, facilitating service management.

Example

# Configure a BGP device to log the session status and events of a peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] group test
[HUAWEI-bgp-instance-a] peer test log-change

peer log-change (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified peer or a peer.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address log-change

undo peer ipv4-address log-change

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer, facilitating service management.

Example

# Configure a BGP device to log the session status and events of peer 10.1.1.2.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 log-change

peer log-change (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified group.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name log-change

undo peer group-name log-change

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer group, facilitating service management.

Example

# Configure a BGP device to log the session status and events of a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test log-change

peer log-change (BGP view)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified peer or a peer.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer.

Format

peer ipv4-address log-change

undo peer ipv4-address log-change

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer, facilitating service management.

Example

# Configure a BGP device to log the session status and events of peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 log-change

peer log-change (BGP view) (group)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified group.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer group.

Format

peer group-name log-change

undo peer group-name log-change

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer group, facilitating service management.

Example

# Configure a BGP device to log the session status and events of peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test log-change

peer log-change (BGP view) (IPv6)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified peer or a peer.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer.

Format

peer ipv6-address log-change

undo peer ipv6-address log-change

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer, facilitating service management.

Example

# Configure a BGP device to log the session status and events of peer 10.1.1.2.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp] peer 2001:DB8:1::1 log-change

peer log-change (BGP-VPN instance IPv4 address family view)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified peer or a peer.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer.

Format

peer ipv4-address log-change

undo peer ipv4-address log-change

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer, facilitating service management.

Example

# Configure a BGP device to log the session status and events of peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 log-change

peer log-change (BGP-VPN instance IPv4 address family view) (group)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified group.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer group.

Format

peer group-name log-change

undo peer group-name log-change

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer group, facilitating service management.

Example

# Configure a BGP device to log the session status and events of peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test
[HUAWEI-bgp-vpn1] peer test log-change

peer log-change (BGP-VPN instance IPv6 address family view) (group)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified group.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer group.

Format

peer group-name log-change

undo peer group-name log-change

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer group, facilitating service management.

Example

# Configure a BGP device to log the session status and events of a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test log-change

peer log-change (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified peer or a peer.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer.

Format

peer ipv6-address log-change

undo peer ipv6-address log-change

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer, facilitating service management.

Example

# Configure a BGP device to log the session status and events of peer 10.1.1.2.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 log-change

peer log-change (BGP-VPN instance view)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified peer or a peer.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer.

Format

peer ipv4-address log-change

undo peer ipv4-address log-change

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer, facilitating service management.

Example

# Configure a BGP device to log the session status and events of peer 10.1.1.2.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 log-change

peer log-change (BGP-VPN instance view) (group)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified group.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer group.

Format

peer group-name log-change

undo peer group-name log-change

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer group, facilitating service management.

Example

# Configure a BGP device to log the session status and events of a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test
[HUAWEI-bgp-instance-vpn1] peer test log-change

peer log-change (BGP-VPN instance view) (IPv6)

Function

The peer log-change command enables a BGP device to log the session status and events of a specified peer or a peer.

The undo peer log-change command cancels the configuration.

By default, a BGP device is enabled to log the session status and events of a specified peer.

Format

peer ipv6-address log-change

undo peer ipv6-address log-change

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer log-change command can be used to enable a device to log the session status and events of a specified peer, facilitating service management.

Example

# Configure a BGP device to log the session status and events of peer 2001:DB8:1::1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 log-change

peer next-hop-invariable (BGP view)

Function

The peer next-hop-invariable include-static-route command configures a BGP speaker to use the next hop address of an imported static route when advertising the static route to an IBGP peer.

The peer next-hop-invariable include-unicast-route command configures a BGP speaker not to change the next hop address when advertising unicast routes learned from other peers to EBGP peers.

The undo peer next-hop-invariable command restores the default configuration.

By default:

  • A device sets its interface IP address as the Next_Hops of routes when advertising these routes to EBGP peers.
  • A device does not modify the Next_Hops of non-labeled routes if the routes are learned from EBGP peers and are to be advertised to IBGP peers; the device sets its interface IP address as the Next_Hops of labeled routes if the routes are learned from EBGP peers and are to be advertised to IBGP peers.
  • A device does not change the Next_Hops of routes if the routes are learned from an IBGP peer and are to be advertised to another IBGP peer.
  • A device sets its interface IP address as the Next_Hops of routes when advertising imported IGP routes to IBGP peers.
  • A device modifies the Next_Hop of imported static routes to the local interface's IP address when advertising the routes to IBGP peers.

Format

peer ipv4-address next-hop-invariable [ include-static-route | include-unicast-route ] *

undo peer ipv4-address next-hop-invariable

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

include-static-route

Configures the device to retain the original Next_Hop of static routes when advertising the routes to the peer.

-

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-invariable command has the following functions:

  • The BGP speaker does not change the next hop when advertising routes to EBGP peers.
  • The BGP speaker does not change the next hop when advertising labeled routes to IBGP peers.
  • When advertising imported IGP routes to IBGP peers, the BGP speaker uses the next hop addresses of the IGP routes.

    If the peer next-hop-invariable include-static-route command is run, the BGP speaker retains the original next hop address of an imported public network static route when advertising the route to an IBGP peer under the condition that the original next hop address is valid; if the original next hop address of the public network static route is invalid, the next hop of the public network static route belongs to a VPN instance, or the public network static route is imported from a VPN instance, the BGP speaker uses its interface address as the next hop of the route.

    Using the peer next-hop-invariable include-unicast-route command, you can configure a BGP speaker not to change the next hop address when advertising unicast routes learned from other peers to EBGP peers.

Prerequisites

A peer has been created using the peer as-number command.

Precautions

The peer next-hop-invariable command is valid only for received routes. In the IPv4 unicast address family view, this command is valid only for the received labeled IPv4 unicast routes, and is invalid for the routes that do not carry labels.

After the peer next-hop-invariable include-static-route command is run, you can run the undo peer next-hop-invariable command to restore the default configuration or run the peer next-hop-invariable [ include-unicast-route ] command to override the previous configuration.

After the peer next-hop-invariable include-unicast-route command is run, you can run the undo peer next-hop-invariable command to restore the default configuration or run the peer next-hop-invariable [ include-static-route ] command to override the previous configuration.

If both the peer next-hop-invariable and peer next-hop-local commands are run, the latest configuration overrides the previous one.

Example

# Configure the BGP speaker to retain the original Next_Hop of imported static routes when advertising the routes to an IBGP peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 100
[HUAWEI-bgp] peer 10.1.1.2 next-hop-invariable include-static-route

peer next-hop-invariable (BGP view) (group)

Function

The peer next-hop-invariable include-static-route command configures a BGP speaker to use the next hop address of an imported static route when advertising the static route to an IBGP peer.

The peer next-hop-invariable include-unicast-route command configures a BGP speaker not to change the next hop address when advertising unicast routes learned from other peers to EBGP peers.

The undo peer next-hop-invariable command restores the default configuration.

By default:

  • A device sets its interface IP address as the Next_Hops of routes when advertising these routes to EBGP peers.
  • A device does not modify the Next_Hops of non-labeled routes if the routes are learned from EBGP peers and are to be advertised to IBGP peers; the device sets its interface IP address as the Next_Hops of labeled routes if the routes are learned from EBGP peers and are to be advertised to IBGP peers.
  • A device does not change the Next_Hops of routes if the routes are learned from an IBGP peer and are to be advertised to another IBGP peer.
  • A device sets its interface IP address as the Next_Hops of routes when advertising imported IGP routes to IBGP peers.
  • A device modifies the Next_Hop of imported static routes to the local interface's IP address when advertising the routes to IBGP peers.

Format

peer group-name next-hop-invariable [ include-static-route | include-unicast-route ] *

undo peer group-name next-hop-invariable

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

include-static-route

Configures the device to retain the original Next_Hop of static routes when advertising the routes to the peer.

-

include-unicast-route

Configures the device to retain the original next hop of the unicast routes learned from peers when advertising the routes.

-

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-invariable command has the following functions:

  • The BGP speaker does not change the next hop when advertising routes to EBGP peers.
  • The BGP speaker does not change the next hop when advertising labeled routes to IBGP peers.
  • When advertising imported IGP routes to IBGP peers, the BGP speaker uses the next hop addresses of the IGP routes.

    If the peer next-hop-invariable include-static-route command is run, the BGP speaker retains the original next hop address of an imported public network static route when advertising the route to an IBGP peer under the condition that the original next hop address is valid; if the original next hop address of the public network static route is invalid, the next hop of the public network static route belongs to a VPN instance, or the public network static route is imported from a VPN instance, the BGP speaker uses its interface address as the next hop of the route.

    Using the peer next-hop-invariable include-unicast-route command, you can configure a BGP speaker not to change the next hop address when advertising unicast routes learned from other peers to EBGP peers.

Prerequisites

A peer group has been created using the peer as-number command.

Precautions

The peer next-hop-invariable command is valid only for received routes. In the IPv4 unicast address family view, this command is valid only for the received labeled IPv4 unicast routes, and is invalid for the routes that do not carry labels.

After the peer next-hop-invariable include-static-route command is run, you can run the undo peer next-hop-invariable command to restore the default configuration or run the peer next-hop-invariable [ include-unicast-route ] command to override the previous configuration.

After the peer next-hop-invariable include-unicast-route command is run, you can run the undo peer next-hop-invariable command to restore the default configuration or run the peer next-hop-invariable [ include-static-route ] command to override the previous configuration.

If both the peer next-hop-invariable and peer next-hop-local commands are run, the latest configuration overrides the previous one.

Example

# Configure the BGP speaker to retain the original Next_Hop of imported static routes when advertising the routes to an IBGP peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test next-hop-invariable include-static-route

peer next-hop-local (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises routes to an IBGP peer group.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name next-hop-local

undo peer group-name next-hop-local

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, when an ASBR forwards a route learned from an EBGP peer to its IBGP peers, the ASBR does not change the Next_Hop of the route. Therefore, the Next_Hop address of the route remains the EBGP peer IP address. After being forwarded to the IBGP peers, the route cannot become active because of the unreachable Next_Hop. The peer next-hop-local command needs to be run to configure the ASBR to modify the Next_Hop of the route to the local IP address before advertising the route to IBGP peers. After being forwarded to the IBGP peers, the route can be active because the Next_Hop is reachable (an IGP is configured in the AS).

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test next-hop-local

peer next-hop-local (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises routes to an IBGP peer.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address next-hop-local

undo peer ipv4-address next-hop-local

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, a device does not change the next hop address of a route learned from an EBGP peer before forwarding the route to IBGP peers. The next hop address of a route advertised by an EBGP peer to this device is the peer address of the EBGP peer. After being forwarded to IBGP peers in the local AS, this route is not active because the next hop is unreachable. The peer next-hop-local command needs to be run to configure the ASBR to change the next hop of the route to its IP address when the ASBR advertises the route to an IBGP peer. Therefore, after being forwarded to the IBGP peer, the route can become an active route because the next hop is reachable.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 next-hop-local

peer next-hop-local (BGP view) (group)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises routes to an IBGP peer group.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

Format

peer group-name next-hop-local

undo peer group-name next-hop-local

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, when an ASBR forwards a route learned from an EBGP peer to its IBGP peers, the ASBR does not change the Next_Hop of the route. Therefore, the Next_Hop address of the route remains the EBGP peer IP address. After being forwarded to the IBGP peers, the route cannot become active because of the unreachable Next_Hop. The peer next-hop-local command needs to be run to configure the ASBR to modify the Next_Hop of the route to the local IP address before advertising the route to IBGP peers. After being forwarded to the IBGP peers, the route can be active because the Next_Hop is reachable (an IGP is configured in the AS).

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer test as-number 100
[HUAWEI-bgp] peer test next-hop-local

peer next-hop-local (BGP view)(IPv4)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises the routes to its IBGP peer.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

Format

peer ipv4-address next-hop-local

undo peer ipv4-address next-hop-local

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, a device does not change the next hop address of a route learned from an EBGP peer before forwarding the route to IBGP peers. The next hop address of a route advertised by an EBGP peer to this device is the peer address of the EBGP peer. After being forwarded to IBGP peers in the local AS, this route is not active because the next hop is unreachable. The peer next-hop-local command needs to be run to configure the ASBR to change the next hop of the route to its IP address when the ASBR advertises the route to an IBGP peer. Therefore, after being forwarded to the IBGP peer, the route can become an active route because the next hop is reachable.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 next-hop-local

peer next-hop-local (BGP-IPv4 unicast address family view) (group)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises routes to an IBGP peer group.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

Format

peer group-name next-hop-local

undo peer group-name next-hop-local

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, a device does not change the next hop address of a route learned from an EBGP peer before forwarding the route to IBGP peers. The next hop address of a route advertised by an EBGP peer to this device is the peer address of the EBGP peer. After being forwarded to IBGP peers in the local AS, this route is not active because the next hop is unreachable. The peer next-hop-local command needs to be run to configure the ASBR to change the next hop of the route to its IP address when the ASBR advertises the route to an IBGP peer. Therefore, after being forwarded to the IBGP peer, the route can become an active route because the next hop is reachable.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test next-hop-local

peer next-hop-local (BGP-IPv4 unicast address family view)(IPv4)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises the routes to its IBGP peer.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

Format

peer ipv4-address next-hop-local

undo peer ipv4-address next-hop-local

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, a device does not change the next hop address of a route learned from an EBGP peer before forwarding the route to IBGP peers. The next hop address of a route advertised by an EBGP peer to this device is the peer address of the EBGP peer. After being forwarded to IBGP peers in the local AS, this route is not active because the next hop is unreachable. The peer next-hop-local command needs to be run to configure the ASBR to change the next hop of the route to its IP address when the ASBR advertises the route to an IBGP peer. Therefore, after being forwarded to the IBGP peer, the route can become an active route because the next hop is reachable.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 1.1.1.1 next-hop-local

peer next-hop-local (BGP-IPv6 unicast address family view) (group)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises routes to an IBGP peer group.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

Format

peer group-name next-hop-local

undo peer group-name next-hop-local

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, when an ASBR forwards a route learned from an EBGP peer to its IBGP peers, the ASBR does not change the Next_Hop of the route. Therefore, the Next_Hop address of the route remains the EBGP peer IP address. After being forwarded to the IBGP peers, the route cannot become active because of the unreachable Next_Hop. The peer next-hop-local command needs to be run to configure the ASBR to modify the Next_Hop of the route to the local IP address before advertising the route to IBGP peers. After being forwarded to the IBGP peers, the route can be active because the Next_Hop is reachable (an IGP is configured in the AS).

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test next-hop-local

peer next-hop-local (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises the routes to its IBGP peer.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

Format

peer ipv6-address next-hop-local

undo peer ipv6-address next-hop-local

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, a device does not change the next hop address of a route learned from an EBGP peer before forwarding the route to IBGP peers. The next hop address of a route advertised by an EBGP peer to this device is the peer address of the EBGP peer. After being forwarded to IBGP peers in the local AS, this route is not active because the next hop is unreachable. The peer next-hop-local command needs to be run to configure the ASBR to change the next hop of the route to its IP address when the ASBR advertises the route to an IBGP peer. Therefore, after being forwarded to the IBGP peer, the route can become an active route because the next hop is reachable.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 next-hop-local

peer next-hop-local (BGP-IPv6 unicast address family view)(IPv4)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises the routes to its IBGP peer.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

Format

peer ipv4-address next-hop-local

undo peer ipv4-address next-hop-local

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, a device does not change the next hop address of a route learned from an EBGP peer before forwarding the route to IBGP peers. The next hop address of a route advertised by an EBGP peer to this device is the peer address of the EBGP peer. After being forwarded to IBGP peers in the local AS, this route is not active because the next hop is unreachable. The peer next-hop-local command needs to be run to configure the ASBR to change the next hop of the route to its IP address when the ASBR advertises the route to an IBGP peer. Therefore, after being forwarded to the IBGP peer, the route can become an active route because the next hop is reachable.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 next-hop-local

peer next-hop-local (BGP-VPN instance IPv4 address family view) (group)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises routes to an IBGP peer group.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

Format

peer group-name next-hop-local

undo peer group-name next-hop-local

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, a device does not change the next hop address of a route learned from an EBGP peer before forwarding the route to IBGP peers. The next hop address of a route advertised by an EBGP peer to this device is the peer address of the EBGP peer. After being forwarded to IBGP peers in the local AS, this route is not active because the next hop is unreachable. The peer next-hop-local command needs to be run to configure the ASBR to change the next hop of the route to its IP address when the ASBR advertises the route to an IBGP peer. Therefore, after being forwarded to the IBGP peer, the route can become an active route because the next hop is reachable.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test next-hop-local

peer next-hop-local (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises the routes to its IBGP peer.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

Format

peer ipv4-address next-hop-local

undo peer ipv4-address next-hop-local

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, a device does not change the next hop address of a route learned from an EBGP peer before forwarding the route to IBGP peers. The next hop address of a route advertised by an EBGP peer to this device is the peer address of the EBGP peer. After being forwarded to IBGP peers in the local AS, this route is not active because the next hop is unreachable. The peer next-hop-local command needs to be run to configure the ASBR to change the next hop of the route to its IP address when the ASBR advertises the route to an IBGP peer. Therefore, after being forwarded to the IBGP peer, the route can become an active route because the next hop is reachable.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 1.1.1.1 next-hop-local

peer next-hop-local (BGP-VPN instance IPv6 address family view) (group)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises routes to an IBGP peer group.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

Format

peer group-name next-hop-local

undo peer group-name next-hop-local

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, a device does not change the next hop address of a route learned from an EBGP peer before forwarding the route to IBGP peers. The next hop address of a route advertised by an EBGP peer to this device is the peer address of the EBGP peer. After being forwarded to IBGP peers in the local AS, this route is not active because the next hop is unreachable. The peer next-hop-local command needs to be run to configure the ASBR to change the next hop of the route to its IP address when the ASBR advertises the route to an IBGP peer. Therefore, after being forwarded to the IBGP peer, the route can become an active route because the next hop is reachable.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test
[HUAWEI-bgp-6-vpn1] peer test as-number 100
[HUAWEI-bgp-6-vpn1] peer test next-hop-local

peer next-hop-local (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises the routes to its IBGP peer.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

Format

peer ipv6-address next-hop-local

undo peer ipv6-address next-hop-local

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, a device does not change the next hop address of a route learned from an EBGP peer before forwarding the route to IBGP peers. The next hop address of a route advertised by an EBGP peer to this device is the peer address of the EBGP peer. After being forwarded to IBGP peers in the local AS, this route is not active because the next hop is unreachable. The peer next-hop-local command needs to be run to configure the ASBR to change the next hop of the route to its IP address when the ASBR advertises the route to an IBGP peer. Therefore, after being forwarded to the IBGP peer, the route can become an active route because the next hop is reachable.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 next-hop-local

peer next-hop-local (BGP-VPN instance IPv6 address family view)(IPv4)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises routes to an IBGP peer.

The undo peer next-hop-local command restores the default setting.

By default:

  • When advertising routes to EBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the EBGP peers.
  • When advertising non-labeled routes from EBGP peers to IBGP peers, BGP does not change the next hops of the routes. When advertising labeled routes, BGP changes the next hops of the routes to the IP address of its interface connected to IBGP peers.
  • BGP does not change the next hop of a route when advertising the route from an IBGP peer to another IBGP peer.
  • When advertising locally generated routes to IBGP peers, BGP sets the next hops of the routes to the IP address of its interface connected to the IBGP peers.

Format

peer ipv4-address next-hop-local

undo peer ipv4-address next-hop-local

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, when an ASBR forwards a route learned from an EBGP peer to its IBGP peers, the ASBR does not change the Next_Hop of the route. Therefore, the Next_Hop address of the route remains the EBGP peer IP address. After being forwarded to the IBGP peers, the route cannot become active because of the unreachable Next_Hop. The peer next-hop-local command needs to be run to configure the ASBR to modify the Next_Hop of the route to the local IP address before advertising the route to IBGP peers. After being forwarded to the IBGP peers, the route can be active because the Next_Hop is reachable (an IGP is configured in the AS).

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Precautions

The peer next-hop-local command is applicable only to IBGP peers.

If you run both the peer next-hop-local and peer next-hop-invariable commands, the latest configuration overrides the previous one.

If this command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

Except BGP labeled routes, VPNv4 routes, and VPNv6 routes, running this command on an RR or a peer in a BGP confederation to change the next hop of BGP routes does not take effect.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 next-hop-local

peer oscillation-dampening (BGP multi-instance view)

Function

The peer oscillation-dampening command enables BGP to suppress the establishment of a specified peer relationship that flaps continuously.

The peer oscillation-dampening disable command disables BGP from suppressing the establishment of a specified peer relationship that flaps continuously.

The undo peer oscillation-dampening command deletes the configuration of enabling the suppression function for a specified peer.

The undo peer oscillation-dampening disable command deletes the configuration of disabling the suppression function for a specified peer.

By default, BGP suppresses the establishment of a BGP peer relationship that flaps continuously.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr oscillation-dampening

peer peerIpv4Addr oscillation-dampening disable

undo peer peerIpv4Addr oscillation-dampening

undo peer peerIpv4Addr oscillation-dampening disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP peer relationship is established, the local device learns all routes from the peer and also advertises its local routes to the peer. If the peer relationship is disconnected, the local device deletes all the routes learned from the peer.

Generally, a large number of BGP routes exist, and in this case, a large number of routes change and a large amount of data is processed when the BGP peer relationship is flapping. As a result, a high volume of resources are consumed, causing high CPU usage. To prevent high CPU usage in this case, BGP needs to be enabled to suppress the establishment of the peer relationship if it flaps continuously. Such suppression is implemented for a BGP peer relationship that flaps for more than five times consecutively, and the suppression period increases as the number of flapping times increases. You can run the display bgp peer verbose command to check the remaining time that BGP waits to establish the BGP peer relationship.

After the peer relationship stops flapping for a certain period, suppression on the peer relationship establishment is automatically removed. To immediately remove the suppression, you can run the peer oscillation-dampening disable command. Alternatively, you can run a reset command or another command that can cause the peer relationship to be disconnected and re-established.

Precautions

By default, the initial time that the device waits to establish a peer relationship is 10s. If the peer timer connect-retry command is run, the configured ConnectRetry interval is used as the initial waiting time.

If peer dampening is configured and the initial time of waiting for peer relationship establishment is less than 600s, the actual time that the device waits to establish the peer relationship equals the initial waiting time plus the dampening period. The dampening time increases with the number of flapping times until the waiting time for establishing a peer relationship reaches 600s.

If the peer oscillation-dampening [ disable ] command is run on the local peer and the specified peer is added to the peer group, the configuration of the peer takes precedence over the configuration of the peer group.

If the peer oscillation-dampening [ disable ] command is not run on a local peer, the peer inherits the configurations of the peer group after being added to the peer group, and retains the configurations of the peer group even after being removed from the peer group.

Example

# Enable BGP to suppress the establishment of a specified peer relationship that flaps continuously.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-instance-a] peer 10.1.1.1 oscillation-dampening

peer oscillation-dampening (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer oscillation-dampening command enables BGP to suppress the establishment of a specified peer relationship that flaps continuously.

The peer oscillation-dampening disable command disables BGP from suppressing the establishment of a specified peer relationship that flaps continuously.

The undo peer oscillation-dampening command deletes the configuration of enabling the suppression function for a specified peer.

The undo peer oscillation-dampening disable command deletes the configuration of disabling the suppression function for a specified peer.

By default, BGP suppresses the establishment of a BGP peer relationship that flaps continuously.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr oscillation-dampening

peer peerIpv4Addr oscillation-dampening disable

undo peer peerIpv4Addr oscillation-dampening

undo peer peerIpv4Addr oscillation-dampening disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP peer relationship is established, the local device learns all routes from the peer and also advertises its local routes to the peer. If the peer relationship is disconnected, the local device deletes all the routes learned from the peer.

Generally, a large number of BGP routes exist, and in this case, a large number of routes change and a large amount of data is processed when the BGP peer relationship is flapping. As a result, a high volume of resources are consumed, causing high CPU usage. To prevent high CPU usage in this case, BGP needs to be enabled to suppress the establishment of the peer relationship if it flaps continuously. Such suppression is implemented for a BGP peer relationship that flaps for more than five times consecutively, and the suppression period increases as the number of flapping times increases. You can run the display bgp peer verbose command to check the remaining time that BGP waits to establish the BGP peer relationship.

After the peer relationship stops flapping for a certain period, suppression on the peer relationship establishment is automatically removed. To immediately remove the suppression, you can run the peer oscillation-dampening disable command. Alternatively, you can run a reset command or another command that can cause the peer relationship to be disconnected and re-established.

Precautions

By default, the initial time that the device waits to establish a peer relationship is 10s. If the peer timer connect-retry command is run, the configured ConnectRetry interval is used as the initial waiting time.

If peer dampening is configured and the initial time of waiting for peer relationship establishment is less than 600s, the actual time that the device waits to establish the peer relationship equals the initial waiting time plus the dampening period. The dampening time increases with the number of flapping times until the waiting time for establishing a peer relationship reaches 600s.

If the peer oscillation-dampening [ disable ] command is run on the local peer and the specified peer is added to the peer group, the configuration of the peer takes precedence over the configuration of the peer group.

If the peer oscillation-dampening [ disable ] command is not run on a local peer, the peer inherits the configurations of the peer group after being added to the peer group, and retains the configurations of the peer group even after being removed from the peer group.

Example

# Enable BGP to suppress the establishment of a specified peer relationship that flaps continuously.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 oscillation-dampening

peer oscillation-dampening (BGP view)

Function

The peer oscillation-dampening command enables BGP to suppress the establishment of a specified peer relationship that flaps continuously.

The peer oscillation-dampening disable command disables BGP from suppressing the establishment of a specified peer relationship that flaps continuously.

The undo peer oscillation-dampening command deletes the configuration of enabling the suppression function for a specified peer.

The undo peer oscillation-dampening disable command deletes the configuration of disabling the suppression function for a specified peer.

By default, BGP suppresses the establishment of a BGP peer relationship that flaps continuously.

Format

peer { peerIpv4Addr | peerIpv6Addr } oscillation-dampening

peer { peerIpv4Addr | peerIpv6Addr } oscillation-dampening disable

undo peer { peerIpv4Addr | peerIpv6Addr } oscillation-dampening

undo peer { peerIpv4Addr | peerIpv6Addr } oscillation-dampening disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

It is in dotted decimal notation.

peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP peer relationship is established, the local device learns all routes from the peer and also advertises its local routes to the peer. If the peer relationship is disconnected, the local device deletes all the routes learned from the peer.

Generally, a large number of BGP routes exist, and in this case, a large number of routes change and a large amount of data is processed when the BGP peer relationship is flapping. As a result, a high volume of resources are consumed, causing high CPU usage. To prevent high CPU usage in this case, BGP needs to be enabled to suppress the establishment of the peer relationship if it flaps continuously. Such suppression is implemented for a BGP peer relationship that flaps for more than five times consecutively, and the suppression period increases as the number of flapping times increases. You can run the display bgp peer verbose command to check the remaining time that BGP waits to establish the BGP peer relationship.

After the peer relationship stops flapping for a certain period, suppression on the peer relationship establishment is automatically removed. To immediately remove the suppression, you can run the peer oscillation-dampening disable command. Alternatively, you can run a reset command or another command that can cause the peer relationship to be disconnected and re-established.

Precautions

By default, the initial time that the device waits to establish a peer relationship is 10s. If the peer timer connect-retry command is run, the configured ConnectRetry interval is used as the initial waiting time.

If peer dampening is configured and the initial time of waiting for peer relationship establishment is less than 600s, the actual time that the device waits to establish the peer relationship equals the initial waiting time plus the dampening period. The dampening time increases with the number of flapping times until the waiting time for establishing a peer relationship reaches 600s.

If the peer oscillation-dampening [ disable ] command is run on the local peer and the specified peer is added to the peer group, the configuration of the peer takes precedence over the configuration of the peer group.

If the peer oscillation-dampening [ disable ] command is not run on a local peer, the peer inherits the configurations of the peer group after being added to the peer group, and retains the configurations of the peer group even after being removed from the peer group.

Example

# Enable BGP to suppress the establishment of a specified peer relationship that flaps continuously.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 oscillation-dampening

peer oscillation-dampening (BGP-VPN instance IPv4 address family view)

Function

The peer oscillation-dampening command enables BGP to suppress the establishment of a specified peer relationship that flaps continuously.

The peer oscillation-dampening disable command disables BGP from suppressing the establishment of a specified peer relationship that flaps continuously.

The undo peer oscillation-dampening command deletes the configuration of enabling the suppression function for a specified peer.

The undo peer oscillation-dampening disable command deletes the configuration of disabling the suppression function for a specified peer.

By default, BGP suppresses the establishment of a BGP peer relationship that flaps continuously.

Format

peer peerIpv4Addr oscillation-dampening

peer peerIpv4Addr oscillation-dampening disable

undo peer peerIpv4Addr oscillation-dampening

undo peer peerIpv4Addr oscillation-dampening disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP peer relationship is established, the local device learns all routes from the peer and also advertises its local routes to the peer. If the peer relationship is disconnected, the local device deletes all the routes learned from the peer.

Generally, a large number of BGP routes exist, and in this case, a large number of routes change and a large amount of data is processed when the BGP peer relationship is flapping. As a result, a high volume of resources are consumed, causing high CPU usage. To prevent high CPU usage in this case, BGP needs to be enabled to suppress the establishment of the peer relationship if it flaps continuously. Such suppression is implemented for a BGP peer relationship that flaps for more than five times consecutively, and the suppression period increases as the number of flapping times increases. You can run the display bgp peer verbose command to check the remaining time that BGP waits to establish the BGP peer relationship.

After the peer relationship stops flapping for a certain period, suppression on the peer relationship establishment is automatically removed. To immediately remove the suppression, you can run the peer oscillation-dampening disable command. Alternatively, you can run a reset command or another command that can cause the peer relationship to be disconnected and re-established.

Precautions

By default, the initial time that the device waits to establish a peer relationship is 10s. If the peer timer connect-retry command is run, the configured ConnectRetry interval is used as the initial waiting time.

If peer dampening is configured and the initial time of waiting for peer relationship establishment is less than 600s, the actual time that the device waits to establish the peer relationship equals the initial waiting time plus the dampening period. The dampening time increases with the number of flapping times until the waiting time for establishing a peer relationship reaches 600s.

If the peer oscillation-dampening [ disable ] command is run on the local peer and the specified peer is added to the peer group, the configuration of the peer takes precedence over the configuration of the peer group.

If the peer oscillation-dampening [ disable ] command is not run on a local peer, the peer inherits the configurations of the peer group after being added to the peer group, and retains the configurations of the peer group even after being removed from the peer group.

Example

# Enable BGP to suppress the establishment of a specified peer relationship that flaps continuously.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-vpn1] peer 10.1.1.1 oscillation-dampening

peer oscillation-dampening (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer oscillation-dampening command enables BGP to suppress the establishment of a specified peer relationship that flaps continuously.

The peer oscillation-dampening disable command disables BGP from suppressing the establishment of a specified peer relationship that flaps continuously.

The undo peer oscillation-dampening command deletes the configuration of enabling the suppression function for a specified peer.

The undo peer oscillation-dampening disable command deletes the configuration of disabling the suppression function for a specified peer.

By default, BGP suppresses the establishment of a BGP peer relationship that flaps continuously.

Format

peer peerIpv6Addr oscillation-dampening

peer peerIpv6Addr oscillation-dampening disable

undo peer peerIpv6Addr oscillation-dampening

undo peer peerIpv6Addr oscillation-dampening disable

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP peer relationship is established, the local device learns all routes from the peer and also advertises its local routes to the peer. If the peer relationship is disconnected, the local device deletes all the routes learned from the peer.

Generally, a large number of BGP routes exist, and in this case, a large number of routes change and a large amount of data is processed when the BGP peer relationship is flapping. As a result, a high volume of resources are consumed, causing high CPU usage. To prevent high CPU usage in this case, BGP needs to be enabled to suppress the establishment of the peer relationship if it flaps continuously. Such suppression is implemented for a BGP peer relationship that flaps for more than five times consecutively, and the suppression period increases as the number of flapping times increases. You can run the display bgp peer verbose command to check the remaining time that BGP waits to establish the BGP peer relationship.

After the peer relationship stops flapping for a certain period, suppression on the peer relationship establishment is automatically removed. To immediately remove the suppression, you can run the peer oscillation-dampening disable command. Alternatively, you can run a reset command or another command that can cause the peer relationship to be disconnected and re-established.

Precautions

By default, the initial time that the device waits to establish a peer relationship is 10s. If the peer timer connect-retry command is run, the configured ConnectRetry interval is used as the initial waiting time.

If peer dampening is configured and the initial time of waiting for peer relationship establishment is less than 600s, the actual time that the device waits to establish the peer relationship equals the initial waiting time plus the dampening period. The dampening time increases with the number of flapping times until the waiting time for establishing a peer relationship reaches 600s.

If the peer oscillation-dampening [ disable ] command is run on the local peer and the specified peer is added to the peer group, the configuration of the peer takes precedence over the configuration of the peer group.

If the peer oscillation-dampening [ disable ] command is not run on a local peer, the peer inherits the configurations of the peer group after being added to the peer group, and retains the configurations of the peer group even after being removed from the peer group.

Example

# Enable BGP to suppress the establishment of a specified peer relationship that flaps continuously.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vrf1
[HUAWEI-vpn-instance-vrf1] ipv6-family
[HUAWEI-vpn-instance-vrf1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vrf1-af-ipv6] quit
[HUAWEI-vpn-instance-vrf1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vrf1
[HUAWEI-bgp-6-vrf1] peer 2001:db8:9:1::2 as-number 200
[HUAWEI-bgp-6-vrf1] peer 2001:db8:9:1::2 oscillation-dampening

peer oscillation-dampening (BGP-VPN instance view)

Function

The peer oscillation-dampening command enables BGP to suppress the establishment of a specified peer relationship that flaps continuously.

The peer oscillation-dampening disable command disables BGP from suppressing the establishment of a specified peer relationship that flaps continuously.

The undo peer oscillation-dampening command deletes the configuration of enabling the suppression function for a specified peer.

The undo peer oscillation-dampening disable command deletes the configuration of disabling the suppression function for a specified peer.

By default, BGP suppresses the establishment of a BGP peer relationship that flaps continuously.

Format

peer { peerIpv4Addr | peerIpv6Addr } oscillation-dampening

peer { peerIpv4Addr | peerIpv6Addr } oscillation-dampening disable

undo peer { peerIpv4Addr | peerIpv6Addr } oscillation-dampening

undo peer { peerIpv4Addr | peerIpv6Addr } oscillation-dampening disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP peer relationship is established, the local device learns all routes from the peer and also advertises its local routes to the peer. If the peer relationship is disconnected, the local device deletes all the routes learned from the peer.

Generally, a large number of BGP routes exist, and in this case, a large number of routes change and a large amount of data is processed when the BGP peer relationship is flapping. As a result, a high volume of resources are consumed, causing high CPU usage. To prevent high CPU usage in this case, BGP needs to be enabled to suppress the establishment of the peer relationship if it flaps continuously. Such suppression is implemented for a BGP peer relationship that flaps for more than five times consecutively, and the suppression period increases as the number of flapping times increases. You can run the display bgp peer verbose command to check the remaining time that BGP waits to establish the BGP peer relationship.

After the peer relationship stops flapping for a certain period, suppression on the peer relationship establishment is automatically removed. To immediately remove the suppression, you can run the peer oscillation-dampening disable command. Alternatively, you can run a reset command or another command that can cause the peer relationship to be disconnected and re-established.

Precautions

By default, the initial time that the device waits to establish a peer relationship is 10s. If the peer timer connect-retry command is run, the configured ConnectRetry interval is used as the initial waiting time.

If peer dampening is configured and the initial time of waiting for peer relationship establishment is less than 600s, the actual time that the device waits to establish the peer relationship equals the initial waiting time plus the dampening period. The dampening time increases with the number of flapping times until the waiting time for establishing a peer relationship reaches 600s.

If the peer oscillation-dampening [ disable ] command is run on the local peer and the specified peer is added to the peer group, the configuration of the peer takes precedence over the configuration of the peer group.

If the peer oscillation-dampening [ disable ] command is not run on a local peer, the peer inherits the configurations of the peer group after being added to the peer group, and retains the configurations of the peer group even after being removed from the peer group.

Example

# Enable BGP to suppress the establishment of a specified peer relationship that flaps continuously.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 oscillation-dampening

peer oscillation-dampening disable (BGP multi-instance view) (group)

Function

The peer oscillation-dampening disable command disables BGP from suppressing the establishment of a specified peer group's peer relationships that flap continuously.

The undo peer oscillation-dampening disable command deletes the configuration of disabling the suppression function for a specified peer group.

By default, BGP suppresses the establishment of a specified peer group's peer relationships that flap continuously.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerGroupName oscillation-dampening disable

undo peer peerGroupName oscillation-dampening disable

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP peer relationship is established, the local device learns all routes from the peer and also advertises its local routes to the peer. If the peer relationship is disconnected, the local device deletes all the routes learned from the peer.

Generally, a large number of BGP routes exist, and in this case, a large number of routes change and a large amount of data is processed when the BGP peer relationship is flapping. As a result, a high volume of resources are consumed, causing high CPU usage. To prevent high CPU usage in this case, BGP needs to be enabled to suppress the establishment of the peer relationship if it flaps continuously. Such suppression is implemented for a BGP peer relationship that flaps for more than five times consecutively, and the suppression period increases as the number of flapping times increases. You can run the display bgp peer verbose command to check the remaining time that BGP waits to establish the BGP peer relationship.

After the peer relationship stops flapping for a certain period, suppression on the peer relationship establishment is automatically removed. To immediately remove the suppression, you can run the peer oscillation-dampening disable command. Alternatively, you can run a reset command or another command that can cause the peer relationship to be disconnected and re-established.

Precautions

By default, the initial time that the device waits to establish a peer relationship is 10s. If the peer timer connect-retry command is run, the configured ConnectRetry interval is used as the initial waiting time.

If peer dampening is configured and the initial time of waiting for peer relationship establishment is less than 600s, the actual time that the device waits to establish the peer relationship equals the initial waiting time plus the dampening period. The dampening time increases with the number of flapping times until the waiting time for establishing a peer relationship reaches 600s.

If the peer oscillation-dampening [ disable ] command is run on the local peer and the specified peer is added to the peer group, the configuration of the peer takes precedence over the configuration of the peer group.

If the peer oscillation-dampening [ disable ] command is not run on a local peer, the peer inherits the configurations of the peer group after being added to the peer group, and retains the configurations of the peer group even after being removed from the peer group.

Example

# Disable BGP from suppressing the establishment of a specified peer group's peer relationships that flap continuously.
<HUAWEI> system-view
[HUAWEI] bgp 100 instanc a
[HUAWEI-bgp-instance-a] group test internal
[HUAWEI-bgp-instance-a] peer test oscillation-dampening disable

peer oscillation-dampening disable (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer oscillation-dampening disable command disables BGP from suppressing the establishment of a specified peer group's peer relationships that flap continuously.

The undo peer oscillation-dampening disable command deletes the configuration of disabling the suppression function for a specified peer group.

By default, BGP suppresses the establishment of a specified peer group's peer relationships that flap continuously.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerGroupName oscillation-dampening disable

undo peer peerGroupName oscillation-dampening disable

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP peer relationship is established, the local device learns all routes from the peer and also advertises its local routes to the peer. If the peer relationship is disconnected, the local device deletes all the routes learned from the peer.

Generally, a large number of BGP routes exist, and in this case, a large number of routes change and a large amount of data is processed when the BGP peer relationship is flapping. As a result, a high volume of resources are consumed, causing high CPU usage. To prevent high CPU usage in this case, BGP needs to be enabled to suppress the establishment of the peer relationship if it flaps continuously. Such suppression is implemented for a BGP peer relationship that flaps for more than five times consecutively, and the suppression period increases as the number of flapping times increases. You can run the display bgp peer verbose command to check the remaining time that BGP waits to establish the BGP peer relationship.

After the peer relationship stops flapping for a certain period, suppression on the peer relationship establishment is automatically removed. To immediately remove the suppression, you can run the peer oscillation-dampening disable command. Alternatively, you can run a reset command or another command that can cause the peer relationship to be disconnected and re-established.

Precautions

By default, the initial time that the device waits to establish a peer relationship is 10s. If the peer timer connect-retry command is run, the configured ConnectRetry interval is used as the initial waiting time.

If peer dampening is configured and the initial time of waiting for peer relationship establishment is less than 600s, the actual time that the device waits to establish the peer relationship equals the initial waiting time plus the dampening period. The dampening time increases with the number of flapping times until the waiting time for establishing a peer relationship reaches 600s.

If the peer oscillation-dampening [ disable ] command is run on the local peer and the specified peer is added to the peer group, the configuration of the peer takes precedence over the configuration of the peer group.

If the peer oscillation-dampening [ disable ] command is not run on a local peer, the peer inherits the configurations of the peer group after being added to the peer group, and retains the configurations of the peer group even after being removed from the peer group.

Example

# Disable BGP from suppressing the establishment of a specified peer group's peer relationships that flap continuously.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test external
[HUAWEI-bgp-instance-a-vpna] peer test as-number 200
[HUAWEI-bgp-instance-a-vpna] peer test oscillation-dampening disable

peer oscillation-dampening disable (BGP view) (group)

Function

The peer oscillation-dampening disable command disables BGP from suppressing the establishment of a specified peer group's peer relationships that flap continuously.

The undo peer oscillation-dampening disable command deletes the configuration of disabling the suppression function for a specified peer group.

By default, BGP suppresses the establishment of a specified peer group's peer relationships that flap continuously.

Format

peer peerGroupName oscillation-dampening disable

undo peer peerGroupName oscillation-dampening disable

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP peer relationship is established, the local device learns all routes from the peer and also advertises its local routes to the peer. If the peer relationship is disconnected, the local device deletes all the routes learned from the peer.

Generally, a large number of BGP routes exist, and in this case, a large number of routes change and a large amount of data is processed when the BGP peer relationship is flapping. As a result, a high volume of resources are consumed, causing high CPU usage. To prevent high CPU usage in this case, BGP needs to be enabled to suppress the establishment of the peer relationship if it flaps continuously. Such suppression is implemented for a BGP peer relationship that flaps for more than five times consecutively, and the suppression period increases as the number of flapping times increases. You can run the display bgp peer verbose command to check the remaining time that BGP waits to establish the BGP peer relationship.

After the peer relationship stops flapping for a certain period, suppression on the peer relationship establishment is automatically removed. To immediately remove the suppression, you can run the peer oscillation-dampening disable command. Alternatively, you can run a reset command or another command that can cause the peer relationship to be disconnected and re-established.

Precautions

By default, the initial time that the device waits to establish a peer relationship is 10s. If the peer timer connect-retry command is run, the configured ConnectRetry interval is used as the initial waiting time.

If peer dampening is configured and the initial time of waiting for peer relationship establishment is less than 600s, the actual time that the device waits to establish the peer relationship equals the initial waiting time plus the dampening period. The dampening time increases with the number of flapping times until the waiting time for establishing a peer relationship reaches 600s.

If the peer oscillation-dampening [ disable ] command is run on the local peer and the specified peer is added to the peer group, the configuration of the peer takes precedence over the configuration of the peer group.

If the peer oscillation-dampening [ disable ] command is not run on a local peer, the peer inherits the configurations of the peer group after being added to the peer group, and retains the configurations of the peer group even after being removed from the peer group.

Example

# Disable BGP from suppressing the establishment of a specified peer group's peer relationships that flap continuously.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test internal
[HUAWEI-bgp] peer test oscillation-dampening disable

peer oscillation-dampening disable (BGP-VPN instance IPv4 address family view) (group)

Function

The peer oscillation-dampening disable command disables BGP from suppressing the establishment of a specified peer group's peer relationships that flap continuously.

The undo peer oscillation-dampening disable command deletes the configuration of disabling the suppression function for a specified peer group.

By default, BGP suppresses the establishment of a specified peer group's peer relationships that flap continuously.

Format

peer peerGroupName oscillation-dampening disable

undo peer peerGroupName oscillation-dampening disable

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP peer relationship is established, the local device learns all routes from the peer and also advertises its local routes to the peer. If the peer relationship is disconnected, the local device deletes all the routes learned from the peer.

Generally, a large number of BGP routes exist, and in this case, a large number of routes change and a large amount of data is processed when the BGP peer relationship is flapping. As a result, a high volume of resources are consumed, causing high CPU usage. To prevent high CPU usage in this case, BGP needs to be enabled to suppress the establishment of the peer relationship if it flaps continuously. Such suppression is implemented for a BGP peer relationship that flaps for more than five times consecutively, and the suppression period increases as the number of flapping times increases. You can run the display bgp peer verbose command to check the remaining time that BGP waits to establish the BGP peer relationship.

After the peer relationship stops flapping for a certain period, suppression on the peer relationship establishment is automatically removed. To immediately remove the suppression, you can run the peer oscillation-dampening disable command. Alternatively, you can run a reset command or another command that can cause the peer relationship to be disconnected and re-established.

Precautions

By default, the initial time that the device waits to establish a peer relationship is 10s. If the peer timer connect-retry command is run, the configured ConnectRetry interval is used as the initial waiting time.

If peer dampening is configured and the initial time of waiting for peer relationship establishment is less than 600s, the actual time that the device waits to establish the peer relationship equals the initial waiting time plus the dampening period. The dampening time increases with the number of flapping times until the waiting time for establishing a peer relationship reaches 600s.

If the peer oscillation-dampening [ disable ] command is run on the local peer and the specified peer is added to the peer group, the configuration of the peer takes precedence over the configuration of the peer group.

If the peer oscillation-dampening [ disable ] command is not run on a local peer, the peer inherits the configurations of the peer group after being added to the peer group, and retains the configurations of the peer group even after being removed from the peer group.

Example

# Disable BGP from suppressing the establishment of a specified peer group's peer relationships that flap continuously.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test internal
[HUAWEI-bgp-vpn1] peer test oscillation-dampening disable

peer oscillation-dampening disable (BGP-VPN instance IPv6 address family view) (group)

Function

The peer oscillation-dampening disable command disables BGP from suppressing the establishment of a specified peer group's peer relationships that flap continuously.

The undo peer oscillation-dampening disable command deletes the configuration of disabling the suppression function for a specified peer group.

By default, BGP suppresses the establishment of a specified peer group's peer relationships that flap continuously.

Format

peer peerGroupName oscillation-dampening disable

undo peer peerGroupName oscillation-dampening disable

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP peer relationship is established, the local device learns all routes from the peer and also advertises its local routes to the peer. If the peer relationship is disconnected, the local device deletes all the routes learned from the peer.

Generally, a large number of BGP routes exist, and in this case, a large number of routes change and a large amount of data is processed when the BGP peer relationship is flapping. As a result, a high volume of resources are consumed, causing high CPU usage. To prevent high CPU usage in this case, BGP needs to be enabled to suppress the establishment of the peer relationship if it flaps continuously. Such suppression is implemented for a BGP peer relationship that flaps for more than five times consecutively, and the suppression period increases as the number of flapping times increases. You can run the display bgp peer verbose command to check the remaining time that BGP waits to establish the BGP peer relationship.

After the peer relationship stops flapping for a certain period, suppression on the peer relationship establishment is automatically removed. To immediately remove the suppression, you can run the peer oscillation-dampening disable command. Alternatively, you can run a reset command or another command that can cause the peer relationship to be disconnected and re-established.

Precautions

By default, the initial time that the device waits to establish a peer relationship is 10s. If the peer timer connect-retry command is run, the configured ConnectRetry interval is used as the initial waiting time.

If peer dampening is configured and the initial time of waiting for peer relationship establishment is less than 600s, the actual time that the device waits to establish the peer relationship equals the initial waiting time plus the dampening period. The dampening time increases with the number of flapping times until the waiting time for establishing a peer relationship reaches 600s.

If the peer oscillation-dampening [ disable ] command is run on the local peer and the specified peer is added to the peer group, the configuration of the peer takes precedence over the configuration of the peer group.

If the peer oscillation-dampening [ disable ] command is not run on a local peer, the peer inherits the configurations of the peer group after being added to the peer group, and retains the configurations of the peer group even after being removed from the peer group.

Example

# Disable BGP from suppressing the establishment of a specified peer group's peer relationships that flap continuously.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpn1] group test internal
[HUAWEI-bgp-6-vpn1] peer test oscillation-dampening disable

peer oscillation-dampening disable (BGP-VPN instance view) (group)

Function

The peer oscillation-dampening disable command disables BGP from suppressing the establishment of a specified peer group's peer relationships that flap continuously.

The undo peer oscillation-dampening disable command deletes the configuration of disabling the suppression function for a specified peer group.

By default, BGP suppresses the establishment of a specified peer group's peer relationships that flap continuously.

Format

peer peerGroupName oscillation-dampening disable

undo peer peerGroupName oscillation-dampening disable

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP peer relationship is established, the local device learns all routes from the peer and also advertises its local routes to the peer. If the peer relationship is disconnected, the local device deletes all the routes learned from the peer.

Generally, a large number of BGP routes exist, and in this case, a large number of routes change and a large amount of data is processed when the BGP peer relationship is flapping. As a result, a high volume of resources are consumed, causing high CPU usage. To prevent high CPU usage in this case, BGP needs to be enabled to suppress the establishment of the peer relationship if it flaps continuously. Such suppression is implemented for a BGP peer relationship that flaps for more than five times consecutively, and the suppression period increases as the number of flapping times increases. You can run the display bgp peer verbose command to check the remaining time that BGP waits to establish the BGP peer relationship.

After the peer relationship stops flapping for a certain period, suppression on the peer relationship establishment is automatically removed. To immediately remove the suppression, you can run the peer oscillation-dampening disable command. Alternatively, you can run a reset command or another command that can cause the peer relationship to be disconnected and re-established.

Precautions

By default, the initial time that the device waits to establish a peer relationship is 10s. If the peer timer connect-retry command is run, the configured ConnectRetry interval is used as the initial waiting time.

If peer dampening is configured and the initial time of waiting for peer relationship establishment is less than 600s, the actual time that the device waits to establish the peer relationship equals the initial waiting time plus the dampening period. The dampening time increases with the number of flapping times until the waiting time for establishing a peer relationship reaches 600s.

If the peer oscillation-dampening [ disable ] command is run on the local peer and the specified peer is added to the peer group, the configuration of the peer takes precedence over the configuration of the peer group.

If the peer oscillation-dampening [ disable ] command is not run on a local peer, the peer inherits the configurations of the peer group after being added to the peer group, and retains the configurations of the peer group even after being removed from the peer group.

Example

# Disable BGP from suppressing the establishment of a specified peer group's peer relationships that flap continuously.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test internal
[HUAWEI-bgp-instance-vpn1] peer test oscillation-dampening disable

peer oscillation-dampening disable(BGP multi-instance VPN instance view)

Function

The peer oscillation-dampening command enables BGP to suppress the establishment of a specified peer relationship that flaps continuously.

The peer oscillation-dampening disable command disables BGP from suppressing the establishment of a specified peer relationship that flaps continuously.

The undo peer oscillation-dampening command deletes the configuration of enabling the suppression function for a specified peer.

The undo peer oscillation-dampening disable command deletes the configuration of disabling the suppression function for a specified peer.

By default, BGP suppresses the establishment of a BGP peer relationship that flaps continuously.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr oscillation-dampening

peer peerIpv4Addr oscillation-dampening disable

peer peerIpv6Addr oscillation-dampening

peer peerIpv6Addr oscillation-dampening disable

undo peer peerIpv4Addr oscillation-dampening

undo peer peerIpv4Addr oscillation-dampening disable

undo peer peerIpv6Addr oscillation-dampening

undo peer peerIpv6Addr oscillation-dampening disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a BGP peer relationship is established, the local device learns all routes from the peer and also advertises its local routes to the peer. If the peer relationship is disconnected, the local device deletes all the routes learned from the peer.

Generally, a large number of BGP routes exist, and in this case, a large number of routes change and a large amount of data is processed when the BGP peer relationship is flapping. As a result, a high volume of resources are consumed, causing high CPU usage. To prevent high CPU usage in this case, BGP needs to be enabled to suppress the establishment of the peer relationship if it flaps continuously. Such suppression is implemented for a BGP peer relationship that flaps for more than five times consecutively, and the suppression period increases as the number of flapping times increases. You can run the display bgp peer verbose command to check the remaining time that BGP waits to establish the BGP peer relationship.

After the peer relationship stops flapping for a certain period, suppression on the peer relationship establishment is automatically removed. To immediately remove the suppression, you can run the peer oscillation-dampening disable command. Alternatively, you can run a reset command or another command that can cause the peer relationship to be disconnected and re-established.

Example

# Enable BGP to suppress the establishment of a specified peer relationship that flaps continuously.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn3
[HUAWEI-vpn-instance-vpn3] ipv4-family
[HUAWEI-vpn-instance-vpn3-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn3-af-ipv4] quit
[HUAWEI-vpn-instance-vpn3] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] vpn-instance vpn3
[HUAWEI-bgp-instance-a-instance-vpn3] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-a-instance-vpn3] peer 10.1.1.2 oscillation-dampening

peer password (BGP multi-instance view) (group)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name password simple simple-password

peer group-name password cipher cipher-password

undo peer group-name password

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

simple simple-password

Specifies a cleartext password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

cipher cipher-password

Specifies a cipher text password.

In the case of a plain text, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a cipher text password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been used to create a peer or peer group.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure authentication for the TCP connection between a device and its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance p1
[HUAWEI-bgp-instance-p1] group gp1
[HUAWEI-bgp-instance-p1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-p1] peer 10.1.1.1 group gp1
[HUAWEI-bgp-instance-p1] peer gp1 password cipher YsHsjx_202206

peer password (BGP multi-instance view)(IPv4)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address password { cipher cipher-password | simple simple-password }

undo peer ipv4-address password

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

cipher cipher-password

Specifies a ciphertext password.

In the case of a plain text, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a cipher text password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

simple simple-password

Specifies a cleartext password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been used to create a peer.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure authentication for the TCP connection between a device and its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 10.1.1.1 password cipher YsHsjx_202206

peer password (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name password simple simple-password

peer group-name password cipher cipher-password

undo peer group-name password

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

simple simple-password

Specifies a simple text password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

The characters do not include the question mark (?) or spaces. However, when double quotation marks are used around a password, spaces are allowed in the password.

cipher cipher-password

Specifies a ciphertext password.

In the case of a plain text, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a cipher text password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure authentication for the TCP connection between a device and its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test password cipher YsHsjx_202206

peer password (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address password simple simple-password

peer ipv4-address password cipher cipher-password

undo peer ipv4-address password

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

simple simple-password

Specifies a cleartext password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

cipher cipher-password

Specifies a cipher text password.

In the case of a plain text, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a cipher text password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure authentication for the TCP connection between a device and its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 password cipher YsHsjx_202206

peer password (BGP view) (group)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

Format

peer group-name password simple simple-password

peer group-name password cipher cipher-password

undo peer group-name password

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

simple simple-password

Specifies a simple text password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

cipher cipher-password

Specifies a cipher text password.

In the case of a plain text, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a cipher text password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure authentication for the TCP connection between a device and its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test password cipher YsHsjx_202206

peer password (BGP view) (IPv6)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

Format

peer ipv6-address password simple simple-password

peer ipv6-address password cipher cipher-password

undo peer ipv6-address password

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

simple simple-password

Specifies a cleartext password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

cipher cipher-password

Specifies a cipher text password.

In the case of a plain text, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a cipher text password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure an authentication password for a TCP connection between BGP peers.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] peer 2001:DB8:1::1 password cipher YsHsjx_202206

peer password (BGP view)(IPv4)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

Format

peer ipv4-address password { cipher cipher-password | simple simple-password }

undo peer ipv4-address password

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

cipher cipher-password

Specifies a cipher text password.

In the case of a plain text, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a cipher text password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

simple simple-password

Specifies a cleartext password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure authentication for the TCP connection between a device and its peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 password cipher YsHsjx_202206

peer password (BGP-VPN instance IPv4 address family view) (group)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

Format

peer group-name password simple simple-password

peer group-name password cipher cipher-password

undo peer group-name password

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

simple simple-password

Specifies a simple text password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

cipher cipher-password

Specifies a ciphertext password.

In the case of a plain text, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a cipher text password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been used to create a peer group.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure authentication for the TCP connection between a device and its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test
[HUAWEI-bgp-vpn1] peer test password cipher YsHsjx_202206

peer password (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

Format

peer ipv4-address password simple simple-password

peer ipv4-address password cipher cipher-password

undo peer ipv4-address password

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

simple simple-password

Specifies a cleartext password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

cipher cipher-password

Specifies a cipher text password.

In the case of a plain text, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a cipher text password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been used to create a peer or peer group.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure authentication for the TCP connection between a device and its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] crypto weak-algorithm disable
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer  10.1.1.1 as-number 100
Info: If the SoO function is not enabled, routing loops may occur.

peer password (BGP-VPN instance IPv6 address family view) (group)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

Format

peer group-name password simple simple-password

peer group-name password cipher cipher-password

undo peer group-name password

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

simple simple-password

Specifies a cleartext password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

cipher cipher-password

Specifies a cipher text password.

In the case of a plain text, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a cipher text password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure authentication for the TCP connection between a device and its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test
[HUAWEI-bgp-6-vpn1] peer test password cipher YsHsjx_202206

peer password (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

Format

peer ipv6-address password simple simple-password

peer ipv6-address password cipher cipher-password

undo peer ipv6-address password

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

simple simple-password

Specifies a simple text password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

The characters do not include the question mark (?) or spaces. However, when double quotation marks are used around a password, spaces are allowed in the password.

cipher cipher-password

Specifies a cipher text password.

In the case of a plaintext, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a ciphertext password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

The characters do not include question marks (?) or spaces. However, when double quotation marks are used around a password, spaces are allowed in the password.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure authentication for the TCP connection between a device and its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 password cipher YsHsjx_202206

peer password (BGP-VPN instance view) (group)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

Format

peer group-name password simple simple-password

peer group-name password cipher cipher-password

undo peer group-name password

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

simple simple-password

Specifies a cleartext password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

cipher cipher-password

Specifies a cipher text password.

In the case of a plain text, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a cipher text password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure authentication for the TCP connection between a device and its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test
[HUAWEI-bgp-instance-vpn1] peer test password cipher YsHsjx_202206

peer password (BGP-VPN instance view) (IPv6)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

Format

peer ipv6-address password simple simple-password

peer ipv6-address password cipher cipher-password

undo peer ipv6-address password

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

simple simple-password

Specifies a cleartext password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

cipher cipher-password

Specifies a cipher text password.

In the case of a plain text, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a cipher text password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure authentication for the TCP connection between a device and its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 password cipher YsHsjx_202206

peer password (BGP-VPN instance view)(IPv4)

Function

The peer password command enables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

The undo peer password command disables a BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer.

By default, the BGP device to implement Message Digest 5 (MD5) authentication for BGP messages exchanged during the establishment of a TCP connection with a peer is disabled.

Format

peer ipv4-address password simple simple-password

peer ipv4-address password cipher cipher-password

undo peer ipv4-address password

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

simple simple-password

Specifies a cleartext password.

For security purposes, you are advised to configure a password in ciphertext mode. To further improve device security, periodically change the password.

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

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

cipher cipher-password

Specifies a cipher text password.

In the case of a plain text, the value is a string of 1 to 255 case-sensitive characters, without spaces. In the case of a cipher text password, the value is a string of 20 to 432 case-sensitive characters, without spaces.

Except the question mark (?) and space. However, when quotation marks (") are used around the password, spaces are allowed in the password.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP.

A password can be set either in cipher text or plain text. A plain text password is a configured character string that is directly recorded in a configuration file. A cipher text password is a character string that is encrypted by using a special algorithm and then recorded in a configuration file.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Configuration Impact

BGP uses TCP as the transport layer protocol. To enhance BGP security, MD5 authentication can be implemented for BGP packets exchanged during the establishment of a TCP connection. MD5 authentication, however, does not authenticate BGP packets. Instead, it sets the MD5 authentication password for the TCP connection, and the authentication is performed by TCP. If authentication fails, no TCP connection is established.

Precautions

The MD5 encryption algorithm has low security and has security risks. You are advised to use a more secure encryption algorithm within the encryption algorithm range supported by the protocol.

After MD5 is configured on a peer, keychain cannot be configured on the peer.

If the passwords configured on both ends of a BGP peer relationship are the same, the BGP peer relationship is not re-established. However, if the interval configured on both ends exceeds the holdtime of the BGP peer session or the passwords configured on both ends are different, the BGP peer relationship is disconnected due to timeout.

If authentication is configured for a peer using the peer password command, authentication is configured for a peer group using the peer password command, and you want to add the peer to the peer group and let the peer inherit the authentication configuratoin form the peer group, it is recommended that you run the undo peer password command to delete the configuration of the peer before adding the peer to the peer group using the peer group command.

Example

# Configure authentication for the TCP connection between a device and its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 password cipher YsHsjx_202206

peer path-mtu auto-discovery (BGP-VPN instance view) (group)

Function

The peer path-mtu auto-discovery command enables path MTU discovery.

The undo peer path-mtu auto-discovery command restores the default configuration.

By default, path MTU discovery is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name path-mtu auto-discovery

undo peer group-name path-mtu auto-discovery

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When hosts on the same network communicate, the MTU of the network is important to both communication ends. When hosts need to communicate across multiple networks, the smallest MTU on the communication path is most important to both ends. This is because different networks along the communication path have different link-layer MTUs. The minimum MTU on the communication path is called the path MTU.

The path MTU has the following characteristics:

  • Uncertainty: During communication, the path MTU of hosts depends on the selected path and thus may change.
  • Inconsistency: The path MTUs in the inbound and outbound directions may be inconsistent because the path from the sender to the receiver may be different from the path from the receiver to the sender.

Configuration Impact

After this command is run, the neighbor learns the maximum number of bytes of a data packet on the transmission path, preventing packet fragmentation. In addition, the local device sets the DF bit of the Update message to 1 before sending the Update message to the peer.

Enabling path MTU auto discovery affects TCP MSS calculation:

  • When path MTU auto discovery is disabled:
    1. For the sender, the formula for calculating the TCP MSS is MSS=MIN { CFGMSS, MTU-40 }.
    2. For the receiver, if the device supports SYNCOOKIE, the MSS is calculated as MSS=MIN { MIN { CFGMSS, MTU-40 }, internally-defined MSS value }. If the device does not support SYNCOOKIE, the MSS is calculated as MSS=MIN { CFGMSS, MTU-40 }.
  • After path MTU auto discovery is enabled:
    1. The sender updates the local MSS value only when sending a packet whose MSS value is greater than the path MTU. The formula for calculating the TCP MSS is MSS=MIN { MIN { CFGMSS, MTU-40 }, PMTU-40 }.
    2. For the receiver, if the device supports SYNCOOKIE, the TCP MSS is calculated as MSS=MIN { MIN { MIN { CFGMSS, MTU-40 }, internally-defined MSS value }, PMTU-40 }. If the device does not support SYNCOOKIE, the TCP MSS is calculated as MSS=MIN { MIN { CFGMSS, MTU-40 }, PMTU-40 }.

The parameters in the formula are described as follows:

  • CFGMSS: " MIN { APPMSS, CLICFGMSS }", where APPMSS is the MSS value configured using the peer tcp-mss command. CLICFGMSS indicates the maximum MSS value configured using the tcp max-mss command.
  • MTU-40: MTU of the interface minus 40.
  • PMTU-40: path MTU minus 40.
  • internally-defined MSS value: MSS level, including 216, 460, 952, 1400, 2900, 4900, 7900, 9500. When receiving a packet, the receiver selects a level that is less than and closest to the MSS value of the received packet as the value of this parameter.

Precautions

Enabling the path MTU requires extra costs. If the MTU is known during network planning, you do not need to enable the path MTU.

Example

# Configure path MTU discovery for peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test
[HUAWEI-bgp-instance-vpn1] peer test path-mtu auto-discovery

peer path-mtu auto-discovery (BGP-VPN instance view)(IPv4)

Function

The peer path-mtu auto-discovery command enables path MTU discovery.

The undo peer path-mtu auto-discovery command restores the default configuration.

By default, path MTU discovery is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address path-mtu auto-discovery

undo peer ipv4-address path-mtu auto-discovery

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When hosts on the same network communicate, the MTU of the network is important to both communication ends. When hosts need to communicate across multiple networks, the smallest MTU on the communication path is most important to both ends. This is because different networks along the communication path have different link-layer MTUs. The minimum MTU on the communication path is called the path MTU.

The path MTU has the following characteristics:

  • Uncertainty: During communication, the path MTU of hosts depends on the selected path and thus may change.
  • Inconsistency: The path MTUs in the inbound and outbound directions may be inconsistent because the path from the sender to the receiver may be different from the path from the receiver to the sender.

Configuration Impact

After this command is run, the neighbor learns the maximum number of bytes of a data packet on the transmission path, preventing packet fragmentation. In addition, the local device sets the DF bit of the Update message to 1 before sending the Update message to the peer.

Enabling path MTU auto discovery affects TCP MSS calculation:

  • When path MTU auto discovery is disabled:
    1. For the sender, the formula for calculating the TCP MSS is MSS=MIN { CFGMSS, MTU-40 }.
    2. For the receiver, if the device supports SYNCOOKIE, the MSS is calculated as MSS=MIN { MIN { CFGMSS, MTU-40 }, internally-defined MSS value }. If the device does not support SYNCOOKIE, the MSS is calculated as MSS=MIN { CFGMSS, MTU-40 }.
  • After path MTU auto discovery is enabled:
    1. The sender updates the local MSS value only when sending a packet whose MSS value is greater than the path MTU. The formula for calculating the TCP MSS is MSS=MIN { MIN { CFGMSS, MTU-40 }, PMTU-40 }.
    2. For the receiver, if the device supports SYNCOOKIE, the TCP MSS is calculated as MSS=MIN { MIN { MIN { CFGMSS, MTU-40 }, internally-defined MSS value }, PMTU-40 }. If the device does not support SYNCOOKIE, the TCP MSS is calculated as MSS=MIN { MIN { CFGMSS, MTU-40 }, PMTU-40 }.

The parameters in the formula are described as follows:

  • CFGMSS: " MIN { APPMSS, CLICFGMSS }", where APPMSS is the MSS value configured using the peer tcp-mss command. CLICFGMSS indicates the maximum MSS value configured using the tcp max-mss command.
  • MTU-40: MTU of the interface minus 40.
  • PMTU-40: path MTU minus 40.
  • internally-defined MSS value: MSS level, including 216, 460, 952, 1400, 2900, 4900, 7900, 9500. When receiving a packet, the receiver selects a level that is less than and closest to the MSS value of the received packet as the value of this parameter.

Precautions

Enabling the path MTU requires extra costs. If the MTU is known during network planning, you do not need to enable the path MTU.

Example

# Configure path MTU discovery for peer 10.1.1.2.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 path-mtu auto-discovery

peer peer-as-check

Function

The peer peer-as-check command prevents the routes received from an EBGP peer from being broadcast to other peers with the same AS number as the EBGP peer.

The undo peer peer-as-check command cancels the configuration.

By default, the routes received from an EBGP peer are broadcast to other EBGP peers in the same AS.

Format

peer peerGroupName peer-as-check

undo peer peerGroupName peer-as-check

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, after receiving a route from an EBGP peer in AS 200, the local device in AS 100 advertises the route to all EBGP peers in AS 200. After the peer peer-as-check command is run, the local device does not advertise the routes learned from an EBGP peer to the peers in a peer group with the same AS number as that of the EBGP peer. This reduces BGP memory and CPU consumption and shortens route convergence time during route flapping.

Configuration Impact

After this command is run, the number of BGP update peer-groups on the device is affected. If the AS numbers of BGP peers configured with this function are different, these BGP peers cannot be added to the same BGP update peer-group.

Precautions

This command applies only to EBGP peers.

Example

# Configure a peer group not to broadcast the routes received from EBGP peers to other peers with the same AS number.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group a external
[HUAWEI-bgp] peer a peer-as-check

peer peer-as-check (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer peer-as-check command prevents the routes received from an EBGP peer from being broadcast to other peers with the same AS number as the EBGP peer.

The undo peer peer-as-check command cancels the configuration.

By default, the routes received from an EBGP peer are broadcast to other EBGP peers in the same AS.

Format

peer peerIpv4Addr peer-as-check

peer peerIpv4Addr peer-as-check disable

undo peer peerIpv4Addr peer-as-check

undo peer peerIpv4Addr peer-as-check disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

disable

Disables the function.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, after receiving a route from an EBGP peer in AS 200, the local device in AS 100 advertises the route to all EBGP peers in AS 200. After the peer peer-as-check command is run, the local device does not advertise the routes received from an EBGP peer to other EBGP peers in the same AS with this EBGP peer. This reduces BGP memory and CPU consumption and shortens route convergence time during route flapping.

Configuration Impact

After this command is run, the number of BGP update peer-groups on the device is affected. If the AS numbers of BGP peers configured with this function are different, these BGP peers cannot be added to the same BGP update peer-group.

Precautions

This command applies only to EBGP peers.

Example

# Configure a device not to broadcast the routes received from an EBGP peer to other peers within the same AS.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance a
[HUAWEI-vpn-instance-a] ipv4-family
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance a
[HUAWEI-bgp-a] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-a] peer 10.1.1.1 peer-as-check
# Configure a device not to broadcast the routes received from an EBGP peer to other peers within the same AS.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance a
[HUAWEI-vpn-instance-a] ipv4-family
[HUAWEI-vpn-instance-a-af-ipv4] quit
[HUAWEI-vpn-instance-a] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance a
[HUAWEI-bgp-instance-a-a] peer 1.1.1.1 as-number 200
[HUAWEI-bgp-instance-a-a] peer 1.1.1.1 peer-as-check

peer peer-as-check (BGP multi-instance VPN instance IPv6 address family view)(IPv6)

Function

The peer peer-as-check command prevents the routes received from an EBGP peer from being broadcast to other peers with the same AS number as the EBGP peer.

The undo peer peer-as-check command cancels the configuration.

By default, the routes received from an EBGP peer are broadcast to other EBGP peers in the same AS.

Format

peer peerIpv6Addr peer-as-check

peer peerIpv6Addr peer-as-check disable

undo peer peerIpv6Addr peer-as-check

undo peer peerIpv6Addr peer-as-check disable

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

disable

Disables the function.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, after receiving a route from an EBGP peer in AS 200, the local device in AS 100 advertises the route to all EBGP peers in AS 200. After the peer peer-as-check command is run, the local device does not advertise the routes received from an EBGP peer to other EBGP peers in the same AS with this EBGP peer. This reduces BGP memory and CPU consumption and shortens route convergence time during route flapping.

Configuration Impact

After this command is run, the number of BGP update peer-groups on the device is affected. If the AS numbers of BGP peers configured with this function are different, these BGP peers cannot be added to the same BGP update peer-group.

Precautions

This command applies only to EBGP peers.

Example

# Configure a device not to broadcast the routes received from an EBGP peer to other peers within the same AS.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance a
[HUAWEI-vpn-instance-a] ipv6-family
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance a
[HUAWEI-bgp-6-a] peer 2001:db8:1::1 as-number 200
[HUAWEI-bgp-6-a] peer 2001:db8:1::1 peer-as-check
# Configure a device not to broadcast the routes received from an EBGP peer to other peers within the same AS.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance a
[HUAWEI-vpn-instance-a] ipv6-family
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv6-family vpn-instance a
[HUAWEI-bgp-instance-a-6-a] peer 2001:db8:1::1 as-number 200
[HUAWEI-bgp-instance-a-6-a] peer 2001:db8:1::1 peer-as-check

peer peer-as-check (BGP-IPv4 unicast address family view)(IPv6)

Function

The peer peer-as-check command prevents the routes received from an EBGP peer from being broadcast to other peers with the same AS number as the EBGP peer.

The undo peer peer-as-check command cancels the configuration.

By default, the routes received from an EBGP peer are broadcast to other EBGP peers in the same AS.

Format

peer peerIpv6Addr peer-as-check

peer peerIpv6Addr peer-as-check disable

undo peer peerIpv6Addr peer-as-check

undo peer peerIpv6Addr peer-as-check disable

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

disable

Disables the function.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, after receiving a route from an EBGP peer in AS 200, the local device in AS 100 advertises the route to all EBGP peers in AS 200. After the peer peer-as-check command is run, the local device does not advertise the routes received from an EBGP peer to other EBGP peers in the same AS with this EBGP peer. This reduces BGP memory and CPU consumption and shortens route convergence time during route flapping.

Configuration Impact

After this command is run, the number of BGP update peer-groups on the device is affected. If the AS numbers of BGP peers configured with this function are different, these BGP peers cannot be added to the same BGP update peer-group.

Precautions

This command applies only to EBGP peers.

Example

# Configure a device not to broadcast the routes received from an EBGP peer to other peers within the same AS.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:db8:1::1 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:db8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:db8:1::1 peer-as-check

peer peer-as-check (BGP-VPN instance IPv4 address family view)(group)

Function

The peer peer-as-check command prevents the routes received from an EBGP peer from being broadcast to other peers with the same AS number as the EBGP peer.

The undo peer peer-as-check command cancels the configuration.

By default, the routes received from an EBGP peer are broadcast to other EBGP peers in the same AS.

Format

peer peerGroupName peer-as-check

undo peer peerGroupName peer-as-check

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, after receiving a route from an EBGP peer in AS 200, the local device in AS 100 advertises the route to all EBGP peers in AS 200. After the peer peer-as-check command is run, the local device does not advertise the routes learned from an EBGP peer to the peers in a peer group with the same AS number as that of the EBGP peer. This reduces BGP memory and CPU consumption and shortens route convergence time during route flapping.

Configuration Impact

After this command is run, the number of BGP update peer-groups on the device is affected. If the AS numbers of BGP peers configured with this function are different, these BGP peers cannot be added to the same BGP update peer-group.

Precautions

This command applies only to EBGP peers.

Example

# Configure a peer group not to broadcast the routes received from EBGP peers to other peers with the same AS number.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance a
[HUAWEI-vpn-instance-a] ipv4-family
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance a
[HUAWEI-bgp-instance-a] group a external
[HUAWEI-bgp-instance-a] quit
[HUAWEI-bgp] ipv4-family vpn-instance a
[HUAWEI-bgp-instance-a-4-a] peer a enable
[HUAWEI-bgp-instance-a-4-a] peer a peer-as-check
# Configure a peer group not to broadcast the routes received from EBGP peers to other peers with the same AS number.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance a
[HUAWEI-vpn-instance-a] ipv6-family
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance a
[HUAWEI-bgp-instance-a] group a external
[HUAWEI-bgp-instance-a] quit
[HUAWEI-bgp] ipv6-family vpn-instance a
[HUAWEI-bgp-instance-a-6-a] peer a enable
[HUAWEI-bgp-instance-a-6-a] peer a peer-as-check
# Configure a peer group not to broadcast the routes received from EBGP peers to other peers with the same AS number.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance b
[HUAWEI-vpn-instance-b] ipv4-family
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] vpn-instance b
[HUAWEI-bgp-instance-a-instance-b] group b external
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance b
[HUAWEI-bgp-instance-a-b] peer b enable
[HUAWEI-bgp-instance-a-b] peer b peer-as-check
# Configure a peer group not to broadcast the routes received from EBGP peers to other peers with the same AS number.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance b
[HUAWEI-vpn-instance-b] ipv6-family
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] vpn-instance b
[HUAWEI-bgp-instance-a-instance-b] group b external
[HUAWEI-bgp-instance-a] ipv6-family vpn-instance b
[HUAWEI-bgp-instance-a-6-b] peer b enable
[HUAWEI-bgp-instance-a-6-b] peer b peer-as-check

peer peer-as-check (BGP-VPN instance IPv6 address family view)

Function

The peer peer-as-check command configures a device not to broadcast the routes learned from an EBGP peer to other peers with the AS number same as the EBGP peer.

The undo peer peer-as-check command restores the default configuration.

By default, the routes received from an EBGP peer are broadcast to other EBGP peers in the same AS.

Format

peer peerIpv4Addr peer-as-check

peer peerIpv4Addr peer-as-check disable

undo peer peerIpv4Addr peer-as-check

undo peer peerIpv4Addr peer-as-check disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

disable

Disables the function.

-

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, after receiving a route from an EBGP peer in AS 200, the local device in AS 100 advertises the route to all EBGP peers in AS 200. After the peer peer-as-check command is run, the local device does not advertise the routes received from an EBGP peer to other EBGP peers in the same AS with this EBGP peer. This reduces BGP memory and CPU consumption and shortens route convergence time during route flapping.

Configuration Impact

After this command is run, the number of BGP update peer-groups on the device is affected. If the AS numbers of BGP peers configured with this function are different, these BGP peers cannot be added to the same BGP update peer-group.

Precautions

This command applies only to EBGP peers.

Example

# Configure a device not to broadcast the routes received from an EBGP peer to other peers within the same AS.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance a
[HUAWEI-vpn-instance-a] ipv6-family
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-instance-a] quit
[HUAWEI-bgp] ipv6-family vpn-instance a
[HUAWEI-bgp-instance-a-6-a] peer 10.1.1.1 enable
[HUAWEI-bgp-instance-a-6-a] peer 10.1.1.1 peer-as-check

peer peer-as-check disable

Function

The peer peer-as-check command prevents the routes received from an EBGP peer from being broadcast to other peers with the same AS number as the EBGP peer.

The undo peer peer-as-check command cancels the configuration.

By default, the routes received from an EBGP peer are broadcast to other EBGP peers in the same AS.

Format

peer peerIpv4Addr peer-as-check

peer peerIpv4Addr peer-as-check disable

undo peer peerIpv4Addr peer-as-check

undo peer peerIpv4Addr peer-as-check disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

disable

Disables the function.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, after receiving a route from an EBGP peer in AS 200, the local device in AS 100 advertises the route to all EBGP peers in AS 200. After the peer peer-as-check command is run, the local device does not advertise the routes received from an EBGP peer to other EBGP peers in the same AS with this EBGP peer. This reduces BGP memory and CPU consumption and shortens route convergence time during route flapping.

Configuration Impact

After this command is run, the number of BGP update peer-groups on the device is affected. If the AS numbers of BGP peers configured with this function are different, these BGP peers cannot be added to the same BGP update peer-group.

Precautions

This command applies only to EBGP peers.

Example

# Configure a device not to broadcast the routes received from an EBGP peer to other peers within the same AS.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 peer-as-check

peer peer-as-check(BGP-IPv4 unicast address family view)(IPv4)

Function

The peer peer-as-check command prevents the device from advertising the routes received from an EBGP peer to other peers in the same AS with this EBGP peer.

The undo peer peer-as-check command cancels the function.

By default, the routes received from an EBGP peer are broadcast to other EBGP peers in the same AS.

Format

peer peerIpv4Addr peer-as-check

peer peerIpv4Addr peer-as-check disable

undo peer peerIpv4Addr peer-as-check

undo peer peerIpv4Addr peer-as-check disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

disable

Disables the function.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, after receiving a route from an EBGP peer in AS 200, the local device in AS 100 advertises the route to all EBGP peers in AS 200. After the peer peer-as-check command is run, the local device does not advertise the routes received from an EBGP peer to other EBGP peers in the same AS with this EBGP peer. This reduces BGP memory and CPU consumption and shortens route convergence time during route flapping.

Configuration Impact

After this command is run, the number of BGP update peer-groups on the device is affected. If the AS numbers of BGP peers configured with this function are different, these BGP peers cannot be added to the same BGP update peer-group.

Precautions

This command applies only to EBGP peers.

Example

# Configure a device not to broadcast the routes received from an EBGP peer to other peers within the same AS.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 peer-as-check
# Configure a device not to broadcast the routes received from an EBGP peer to other peers within the same AS.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 peer-as-check

peer peer-as-check(BGP-IPv4 unicast address family view/)(group)

Function

The peer peer-as-check command prevents the routes received from an EBGP peer from being broadcast to other peers with the same AS number as the EBGP peer.

The undo peer peer-as-check command cancels the configuration.

By default, the routes received from an EBGP peer are broadcast to other EBGP peers in the same AS.

Format

peer peerGroupName peer-as-check

undo peer peerGroupName peer-as-check

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, after receiving a route from an EBGP peer in AS 200, the local device in AS 100 advertises the route to all EBGP peers in AS 200. After the peer peer-as-check command is run, the local device does not advertise the routes learned from an EBGP peer to the peers in a peer group with the same AS number as that of the EBGP peer. This reduces BGP memory and CPU consumption and shortens route convergence time during route flapping.

Configuration Impact

After this command is run, the number of BGP update peer-groups on the device is affected. If the AS numbers of BGP peers configured with this function are different, these BGP peers cannot be added to the same BGP update peer-group.

Precautions

This command applies only to EBGP peers.

Example

# Configure a peer group not to broadcast the routes received from EBGP peers to other peers with the same AS number.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group a external
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer a enable
[HUAWEI-bgp-af-ipv4] peer a peer-as-check
# Configure a peer group not to broadcast the routes received from EBGP peers to other peers with the same AS number.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group a external
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer a enable
[HUAWEI-bgp-af-ipv6] peer a peer-as-check

peer preferred-value (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer preferred-value command sets a preferred value for the peer group.

The undo peer preferred-value command deletes the preferred value set for the peer group.

By default, the preferred value of the routes learned from other BGP peer groups is 0.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name preferred-value preferredvalue

undo peer group-name preferred-value

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

preferredvalue

Specifies the preferred value for routes.

The value is an integer in the range from 0 to 65535.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer group, all the routes learned from the peer group have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer group must be configured before the preferred value is assigned to the peer group. If you run this command for a peer group that does not exist, the system displays a message indicating that the peer group does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test internal
[HUAWEI-bgp-instance-a-vpna] peer test preferred-value 50

peer preferred-value (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer preferred-value command sets a preferred value for the routes that a BGP device learns from its peer.

The undo peer preferred-value command deletes the preferred value set for the routes that a BGP device learns from its peer.

By default, the preferred value of a route learned from a BGP peer is 0.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address preferred-value preferredvalue

undo peer ipv4-address preferred-value

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

preferredvalue

Specifies the preferred value of the routes that a BGP device learns from its peer.

The value is an integer ranging from 0 to 65535.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer, all the routes learned from the peer have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer has been configured. If the peer preferred-value command is used but no BGP peer exists, a message is displayed, indicating that the peer does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrfa
[HUAWEI-bgp-instance-a-vrfa] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vrfa] peer 10.1.1.1 preferred-value 50

peer preferred-value (BGP view) (group)

Function

The peer preferred-value command sets a preferred value for the peer group.

The undo peer preferred-value command deletes the preferred value set for the peer group.

By default, the preferred value of the routes learned from other BGP peer groups is 0.

Format

peer group-name preferred-value preferredvalue

undo peer group-name preferred-value

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

preferredvalue

Specifies the preferred value of the routes that a BGP device learns from its peer.

The value is an integer ranging from 0 to 65535.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer group, all the routes learned from the peer group have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer group must be configured before the preferred value is assigned to the peer group. If you run this command for a peer group that does not exist, the system displays a message indicating that the peer group does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test preferred-value 50

peer preferred-value (BGP view)(IPv4)

Function

The peer preferred-value command sets a preferred value for the routes that a BGP device learns from its peer.

The undo peer preferred-value command deletes the preferred value set for the routes that a BGP device learns from its peer.

By default, the preferred value of a route learned from a BGP peer is 0.

Format

peer ipv4-address preferred-value preferredvalue

undo peer ipv4-address preferred-value

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

preferredvalue

Specifies the preferred value for routes.

The value is an integer ranging from 0 to 65535.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer, all the routes learned from the peer have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer has been configured. If the peer preferred-value command is used but no BGP peer exists, a message is displayed, indicating that the peer does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.1 as-number 100
[HUAWEI-bgp] peer 1.1.1.1 preferred-value 50

peer preferred-value (BGP-IPv4 unicast address family view) (group)

Function

The peer preferred-value command sets a preferred value for the peer group.

The undo peer preferred-value command deletes the preferred value set for the peer group.

By default, the preferred value of the routes learned from other BGP peer groups is 0.

Format

peer group-name preferred-value preferredvalue

undo peer group-name preferred-value

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

preferredvalue

Specifies the preferred value for routes.

The value is an integer in the range from 0 to 65535.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer group, all the routes learned from the peer group have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer group must be configured before the preferred value is assigned to the peer group. If you run this command for a peer group that does not exist, the system displays a message indicating that the peer group does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test preferred-value 50

peer preferred-value (BGP-IPv4 unicast address family view)(IPv4)

Function

The peer preferred-value command sets a preferred value for the routes that a BGP device learns from its peer.

The undo peer preferred-value command deletes the preferred value set for the routes that a BGP device learns from its peer.

By default, the preferred value of a route learned from a BGP peer is 0.

Format

peer ipv4-address preferred-value preferredvalue

undo peer ipv4-address preferred-value

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

preferredvalue

Specifies the preferred value for routes.

The value is an integer in the range from 0 to 65535.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer, all the routes learned from the peer have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer has been configured. If the peer preferred-value command is used but no BGP peer exists, a message is displayed, indicating that the peer does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 1.1.1.1 preferred-value 50

peer preferred-value (BGP-IPv6 unicast address family view) (group)

Function

The peer preferred-value command sets a preferred value for the peer group.

The undo peer preferred-value command deletes the preferred value set for the peer group.

By default, the preferred value of the routes learned from other BGP peer groups is 0.

Format

peer group-name preferred-value preferredvalue

undo peer group-name preferred-value

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

preferredvalue

Specifies the preferred value of the routes that a BGP device learns from its peer.

The value is an integer ranging from 0 to 65535.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer group, all the routes learned from the peer group have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer group must be configured before the preferred value is assigned to the peer group. If you run this command for a peer group that does not exist, the system displays a message indicating that the peer group does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test preferred-value 50

peer preferred-value (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer preferred-value command sets a preferred value for the routes that a BGP device learns from its peer.

The undo peer preferred-value command deletes the preferred value set for the routes that a BGP device learns from its peer.

By default, the preferred value of a route learned from a BGP peer is 0.

Format

peer ipv6-address preferred-value preferredValue

undo peer ipv6-address preferred-value

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

preferredValue

Specifies the preferred value of the routes that a BGP device learns from its peer.

The value is an integer ranging from 0 to 65535.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer, all the routes learned from the peer have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer has been configured. If the peer preferred-value command is used but no BGP peer exists, a message is displayed, indicating that the peer does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 preferred-value 50

peer preferred-value (BGP-IPv6 unicast address family view)(IPv4)

Function

The peer preferred-value command sets a preferred value for the routes that a BGP device learns from its peer.

The undo peer preferred-value command deletes the preferred value set for the routes that a BGP device learns from its peer.

By default, the preferred value of a route learned from a BGP peer is 0.

Format

peer ipv4-address preferred-value preferredvalue

undo peer ipv4-address preferred-value

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

preferredvalue

Specifies the preferred value of the routes that a BGP device learns from its peer.

The value is an integer ranging from 0 to 65535.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer, all the routes learned from the peer have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer has been configured. If the peer preferred-value command is used but no BGP peer exists, a message is displayed, indicating that the peer does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 1.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 1.1.1.1 preferred-value 50

peer preferred-value (BGP-VPN instance IPv4 address family view) (group)

Function

The peer preferred-value command sets a preferred value for the peer group.

The undo peer preferred-value command deletes the preferred value set for the peer group.

By default, the preferred value of the routes learned from other BGP peer groups is 0.

Format

peer group-name preferred-value preferredvalue

undo peer group-name preferred-value

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

preferredvalue

Specifies the preferred value of the routes that a BGP device learns from its peer.

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

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer group, all the routes learned from the peer group have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer group must be configured before the preferred value is assigned to the peer group. If you run this command for a peer group that does not exist, the system displays a message indicating that the peer group does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test preferred-value 50

peer preferred-value (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer preferred-value command sets a preferred value for the routes that a BGP device learns from its peer.

The undo peer preferred-value command deletes the preferred value set for the routes that a BGP device learns from its peer.

By default, the preferred value of a route learned from a BGP peer is 0.

Format

peer ipv4-address preferred-value preferredvalue

undo peer ipv4-address preferred-value

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

preferredvalue

Specifies the preferred value of the routes that a BGP device learns from its peer.

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

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer, all the routes learned from the peer have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer has been configured. If the peer preferred-value command is used but no BGP peer exists, a message is displayed, indicating that the peer does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 1.1.1.1 preferred-value 50

peer preferred-value (BGP-VPN instance IPv6 address family view) (group)

Function

The peer preferred-value command sets a preferred value for the peer group.

The undo peer preferred-value command deletes the preferred value set for the peer group.

By default, the preferred value of the routes learned from other BGP peer groups is 0.

Format

peer group-name preferred-value preferredvalue

undo peer group-name preferred-value

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

preferredvalue

Specifies the preferred value for routes.

The value is an integer ranging from 0 to 65535.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer group, all the routes learned from the peer group have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer group must be configured before the preferred value is assigned to the peer group. If you run this command for a peer group that does not exist, the system displays a message indicating that the peer group does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test preferred-value 50

peer preferred-value (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer preferred-value command sets a preferred value for the routes that a BGP device learns from its peer.

The undo peer preferred-value command deletes the preferred value set for the routes that a BGP device learns from its peer.

By default, the preferred value of a route learned from a BGP peer is 0.

Format

peer ipv6-address preferred-value preferredvalue

undo peer ipv6-address preferred-value

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

preferredvalue

Specifies the preferred value for routes.

The value is an integer in the range from 0 to 65535.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer, all the routes learned from the peer have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer has been configured. If the peer preferred-value command is used but no BGP peer exists, a message is displayed, indicating that the peer does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 preferred-value 50

peer preferred-value (BGP-VPN instance IPv6 address family view)(IPv4)

Function

The peer preferred-value command sets a preferred value for the routes that a BGP device learns from its peer.

The undo peer preferred-value command deletes the preferred value set for the routes that a BGP device learns from its peer.

By default, the preferred value of a route learned from a BGP peer is 0.

Format

peer ipv4-address preferred-value preferredvalue

undo peer ipv4-address preferred-value

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

preferredvalue

Specifies the preferred value of the routes that a BGP device learns from its peer.

The value is an integer ranging from 0 to 65535.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a preferred value is configured for a peer, all the routes learned from the peer have the preferred value. If multiple routes with the same prefix are available, the route with the largest preferred value is preferred.

Prerequisites

A BGP peer has been configured. If the peer preferred-value command is used but no BGP peer exists, a message is displayed, indicating that the peer does not exist.

Configuration Impact

If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.

Example

# Set a preferred value to 50 for the routes that a BGP device learns from a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 1.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 1.1.1.1 preferred-value 50

peer public-as-only (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address public-as-only

peer ipv4-address public-as-only force [ replace ] [ include-peer-as ]

peer ipv4-address public-as-only limited [ replace ] [ include-peer-as ]

undo peer ipv4-address public-as-only

undo peer ipv4-address public-as-only force [ replace ] [ include-peer-as ]

undo peer ipv4-address public-as-only limited [ replace ] [ include-peer-as ]

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

force

Deletes all private AS numbers from the AS_Path attribute. The AS_Path attribute of a specified peer is ignored during the deletion.

-

replace

Replaces AS numbers with the local AS number.

If both force and replace are specified, all private AS numbers in the AS_Path list are replaced with the local AS number, and the AS number of the specified peer is ignored during the replacement.

If both limited and replace are specified, the device replaces all private AS numbers in the AS_Path list with the local AS number from the left, and stops the replacement until the local or public AS number is encountered. During the replacement, the device ignores the AS number of the specified peer.

-

include-peer-as

Deletes AS numbers.

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, private AS numbers in the AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers on the left are deleted, and the deletion stops when the local or public AS number is encountered.

If limited, replace, and include-peer-as are specified at the same time, the private AS numbers in the AS_Path list are replaced with the local AS number from the leftmost one, and the replacement stops when the local or public AS number is encountered.

-

limited

Deletes private AS numbers from the leftmost one to the local or a public AS number except the private AS number of a specified peer group.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Select one of the preceding parameters based on the network topology to prevent routing loops or forwarding errors.

Example

# Configure a device to remove all private AS numbers from the AS_Path attribute in the Update messages to be sent to a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 public-as-only

peer public-as-only (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name public-as-only

peer group-name public-as-only force [ replace ] [ include-peer-as ]

peer group-name public-as-only limited [ replace ] [ include-peer-as ]

undo peer group-name public-as-only

undo peer group-name public-as-only force [ replace ] [ include-peer-as ]

undo peer group-name public-as-only limited [ replace ] [ include-peer-as ]

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

force

Deletes all private AS numbers from the AS_Path attribute. The AS_Path attribute of a specified peer is ignored during the deletion.

-

replace

Replaces AS numbers with the local AS number.

If both force and replace are specified, all private AS numbers in the AS_Path list are replaced with the local AS number, and the AS number of the specified peer is ignored during the replacement.

If both limited and replace are specified, the device replaces all private AS numbers in the AS_Path list with the local AS number from the left, and stops the replacement until the local or public AS number is encountered. During the replacement, the device ignores the AS number of the specified peer.

-

include-peer-as

Deletes AS numbers.

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, private AS numbers in the AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers on the left are deleted, and the deletion stops when the local or public AS number is encountered.

If limited, replace, and include-peer-as are specified at the same time, the private AS numbers in the AS_Path list are replaced with the local AS number from the leftmost one, and the replacement stops when the local or public AS number is encountered.

-

limited

Deletes AS numbers from the leftmost one to the local or a public AS number. The AS number of a specified peer is ignored during the deletion.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Select one of the preceding parameters based on the network topology to prevent routing loops or forwarding errors.

Example

# Configure a device to remove all private AS numbers from the AS_Path attribute when sending a BGP Update message to its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test public-as-only

peer public-as-only (BGP view)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

Format

peer ipv4-address public-as-only

peer ipv4-address public-as-only force [ replace ] [ include-peer-as ]

peer ipv4-address public-as-only limited [ replace ] [ include-peer-as ]

undo peer ipv4-address public-as-only

undo peer ipv4-address public-as-only force [ replace ] [ include-peer-as ]

undo peer ipv4-address public-as-only limited [ replace ] [ include-peer-as ]

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

force

Deletes all private AS numbers from the AS_Path attribute. The AS_Path attribute of a specified peer is ignored during the deletion.

-

replace

Replaces AS numbers with the local AS number.

If both force and replace are specified, all private AS numbers in the AS_Path list are replaced with the local AS number, and the AS number of the specified peer is ignored during the replacement.

If both limited and replace are specified, the device replaces all private AS numbers in the AS_Path list with the local AS number from the left, and stops the replacement until the local or public AS number is encountered. During the replacement, the device ignores the AS number of the specified peer.

-

include-peer-as

Deletes AS numbers.

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, private AS numbers in the AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers on the left are deleted, and the deletion stops when the local or public AS number is encountered.

If limited, replace, and include-peer-as are specified at the same time, the private AS numbers in the AS_Path list are replaced with the local AS number from the leftmost one, and the replacement stops when the local or public AS number is encountered.

-

limited

Deletes AS numbers from the leftmost one to the local or a public AS number. The AS number of a specified peer is ignored during the deletion.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Analyze the network structure with caution and select proper optional parameters to prevent routing loops or forwarding errors.

This command takes effect before an export routing policy is configured.

Example

# Configure a device to remove all private AS numbers from the AS_Path attribute in the Update messages to be sent to a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 public-as-only

peer public-as-only (BGP view) (group)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

Format

peer group-name public-as-only

peer group-name public-as-only force [ replace ] [ include-peer-as ]

peer group-name public-as-only limited [ replace ] [ include-peer-as ]

undo peer group-name public-as-only

undo peer group-name public-as-only force [ replace ] [ include-peer-as ]

undo peer group-name public-as-only limited [ replace ] [ include-peer-as ]

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

force

Deletes all private AS numbers from the AS_Path attribute. The AS_Path attribute of a specified peer is ignored during the deletion.

-

replace

Replaces AS numbers with the local AS number.

If both force and replace are specified, all private AS numbers in the AS_Path list are replaced with the local AS number, and the AS number of the specified peer is ignored during the replacement.

If both limited and replace are specified, the device replaces all private AS numbers in the AS_Path list with the local AS number from the left, and stops the replacement until the local or public AS number is encountered. During the replacement, the device ignores the AS number of the specified peer.

-

include-peer-as

Deletes AS numbers.

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, private AS numbers in the AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers on the left are deleted, and the deletion stops when the local or public AS number is encountered.

If limited, replace, and include-peer-as are specified at the same time, the private AS numbers in the AS_Path list are replaced with the local AS number from the leftmost one, and the replacement stops when the local or public AS number is encountered.

-

limited

Deletes AS numbers from the leftmost one to the local or a public AS number. The AS number of a specified peer is ignored during the deletion.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Analyze the network structure with caution and select proper optional parameters to prevent routing loops or forwarding errors.

This command takes effect before an export routing policy is configured.

Example

# Configure the device to send BGP Update messages without private AS numbers in the AS_Path attribute to a peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test public-as-only

peer public-as-only (BGP-IPv4 unicast address family view)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

Format

peer ipv4-address public-as-only

peer ipv4-address public-as-only force [ replace ] [ include-peer-as ]

peer ipv4-address public-as-only limited [ replace ] [ include-peer-as ]

undo peer ipv4-address public-as-only

undo peer ipv4-address public-as-only force [ replace ] [ include-peer-as ]

undo peer ipv4-address public-as-only limited [ replace ] [ include-peer-as ]

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

force

Deletes all private AS numbers from the AS_Path attribute. The AS_Path attribute of a specified peer is ignored during the deletion.

-

replace

Replaces AS numbers with the local AS number.

If both force and replace are specified, all private AS numbers in the AS_Path list are replaced with the local AS number, and the AS number of the specified peer is ignored during the replacement.

If both limited and replace are specified, the device replaces all private AS numbers in the AS_Path list with the local AS number from the left, and stops the replacement until the local or public AS number is encountered. During the replacement, the device ignores the AS number of the specified peer.

-

include-peer-as

Deletes AS numbers.

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, private AS numbers in the AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers on the left are deleted, and the deletion stops when the local or public AS number is encountered.

If limited, replace, and include-peer-as are specified at the same time, the private AS numbers in the AS_Path list are replaced with the local AS number from the leftmost one, and the replacement stops when the local or public AS number is encountered.

-

limited

Deletes AS numbers from the leftmost one to the local or a public AS number. The AS number of a specified peer is ignored during the deletion.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Select one of the preceding parameters based on the network topology to prevent routing loops or forwarding errors.

Example

# Configure a device to remove all private AS numbers from the AS_Path attribute in the Update messages to be sent to a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 public-as-only

peer public-as-only (BGP-IPv4 unicast address family view) (group)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

Format

peer group-name public-as-only

peer group-name public-as-only force [ replace ] [ include-peer-as ]

peer group-name public-as-only limited [ replace ] [ include-peer-as ]

undo peer group-name public-as-only

undo peer group-name public-as-only force [ replace ] [ include-peer-as ]

undo peer group-name public-as-only limited [ replace ] [ include-peer-as ]

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

force

Deletes all private AS numbers from the AS_Path attribute. The AS_Path attribute of a specified peer is ignored during the deletion.

-

replace

Replaces AS numbers with the local AS number.

If both force and replace are specified, all private AS numbers in the AS_Path list are replaced with the local AS number, and the AS number of the specified peer is ignored during the replacement.

If both limited and replace are specified, the device replaces all private AS numbers in the AS_Path list with the local AS number from the left, and stops the replacement until the local or public AS number is encountered. During the replacement, the device ignores the AS number of the specified peer.

-

include-peer-as

Deletes AS numbers.

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, private AS numbers in the AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers on the left are deleted, and the deletion stops when the local or public AS number is encountered.

If limited, replace, and include-peer-as are specified at the same time, the private AS numbers in the AS_Path list are replaced with the local AS number from the leftmost one, and the replacement stops when the local or public AS number is encountered.

-

limited

Deletes private AS numbers from the leftmost one to the local or a public AS number except the private AS number of a specified peer group.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Select one of the preceding parameters based on the network topology to prevent routing loops or forwarding errors.

Example

# Configure a device to remove all private AS numbers from the AS_Path attribute when sending a BGP Update message to its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test public-as-only

peer public-as-only (BGP-IPv6 unicast address family view)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

Format

peer ipv4-address public-as-only

peer ipv4-address public-as-only force [ replace ] [ include-peer-as ]

peer ipv4-address public-as-only limited [ replace ] [ include-peer-as ]

undo peer ipv4-address public-as-only

undo peer ipv4-address public-as-only force [ replace ] [ include-peer-as ]

undo peer ipv4-address public-as-only limited [ replace ] [ include-peer-as ]

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

force

Deletes all private AS numbers from the AS_Path attribute. The AS_Path attribute of a specified peer is ignored during the deletion.

-

replace

Replaces AS numbers with the local AS number.

If both force and replace are specified, all private AS numbers in the AS_Path list are replaced with the local AS number, and the AS number of the specified peer is ignored during the replacement.

If both limited and replace are specified, the device replaces all private AS numbers in the AS_Path list with the local AS number from the left, and stops the replacement until the local or public AS number is encountered. During the replacement, the device ignores the AS number of the specified peer.

-

include-peer-as

Deletes AS numbers.

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, private AS numbers in the AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers on the left are deleted, and the deletion stops when the local or public AS number is encountered.

If limited, replace, and include-peer-as are specified at the same time, the private AS numbers in the AS_Path list are replaced with the local AS number from the leftmost one, and the replacement stops when the local or public AS number is encountered.

-

limited

Deletes private AS numbers from the leftmost one to the local or a public AS number except the private AS number of a specified peer group.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Select one of the preceding parameters based on the network topology to prevent routing loops or forwarding errors.

Example

# Configure a device to remove all private AS numbers from the AS_Path attribute in the Update messages to be sent to a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 public-as-only

peer public-as-only (BGP-IPv6 unicast address family view) (group)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

Format

peer group-name public-as-only

peer group-name public-as-only force [ replace ] [ include-peer-as ]

peer group-name public-as-only limited [ replace ] [ include-peer-as ]

undo peer group-name public-as-only

undo peer group-name public-as-only force [ replace ] [ include-peer-as ]

undo peer group-name public-as-only limited [ replace ] [ include-peer-as ]

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

force

Deletes all private AS numbers from the AS_Path attribute. The AS_Path attribute of a specified peer is ignored during the deletion.

-

replace

Replaces AS numbers with the local AS number.

If both force and replace are specified, all private AS numbers in the AS_Path list are replaced with the local AS number, and the AS number of the specified peer is ignored during the replacement.

If both limited and replace are specified, the device replaces all private AS numbers in the AS_Path list with the local AS number from the left, and stops the replacement until the local or public AS number is encountered. During the replacement, the device ignores the AS number of the specified peer.

-

include-peer-as

Deletes AS numbers.

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, private AS numbers in the AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers on the left are deleted, and the deletion stops when the local or public AS number is encountered.

If limited, replace, and include-peer-as are specified at the same time, the private AS numbers in the AS_Path list are replaced with the local AS number from the leftmost one, and the replacement stops when the local or public AS number is encountered.

-

limited

Deletes private AS numbers from the leftmost one to the local or a public AS number except the private AS number of a specified peer group.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Select one of the preceding parameters based on the network topology to prevent routing loops or forwarding errors.

Example

# Configure a device to remove all private AS numbers from the AS_Path attribute when sending a BGP Update message to its peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test public-as-only

peer public-as-only (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

Format

peer ipv6-address public-as-only

peer ipv6-address public-as-only force [ replace ] [ include-peer-as ]

peer ipv6-address public-as-only limited [ replace ] [ include-peer-as ]

undo peer ipv6-address public-as-only

undo peer ipv6-address public-as-only force [ replace ] [ include-peer-as ]

undo peer ipv6-address public-as-only limited [ replace ] [ include-peer-as ]

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

force

Deletes all private AS numbers from the AS_Path attribute. The AS_Path attribute of a specified peer is ignored during the deletion.

-

replace

Replaces AS numbers with the local AS number.

If both force and replace are specified, all private AS numbers in the AS_Path list are replaced with the local AS number, and the AS number of the specified peer is ignored during the replacement.

If both limited and replace are specified, the device replaces all private AS numbers in the AS_Path list with the local AS number from the left, and stops the replacement until the local or public AS number is encountered. During the replacement, the device ignores the AS number of the specified peer.

-

include-peer-as

Deletes AS numbers.

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, private AS numbers in the AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers on the left are deleted, and the deletion stops when the local or public AS number is encountered.

If limited, replace, and include-peer-as are specified at the same time, the private AS numbers in the AS_Path list are replaced with the local AS number from the leftmost one, and the replacement stops when the local or public AS number is encountered.

-

limited

Deletes private AS numbers from the leftmost one to the local or a public AS number except the private AS number of a specified peer group.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Select one of the preceding parameters based on the network topology to prevent routing loops or forwarding errors.

Example

# Configure a device to remove all private AS numbers from the AS_Path attribute in the Update messages to be sent to a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 public-as-only

peer public-as-only (BGP-VPN instance IPv4 address family view)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

Format

peer ipv4-address public-as-only

peer ipv4-address public-as-only force [ replace ] [ include-peer-as ]

peer ipv4-address public-as-only limited [ replace ] [ include-peer-as ]

undo peer ipv4-address public-as-only

undo peer ipv4-address public-as-only force [ replace ] [ include-peer-as ]

undo peer ipv4-address public-as-only limited [ replace ] [ include-peer-as ]

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

force

Deletes all private AS numbers from the AS_Path attribute. The AS_Path attribute of a specified peer is ignored during the deletion.

-

replace

Replaces AS numbers with the local AS number.

If both force and replace are specified, all private AS numbers in the AS_Path list are replaced with the local AS number, and the AS number of the specified peer is ignored during the replacement.

If both limited and replace are specified, the device replaces all private AS numbers in the AS_Path list with the local AS number from the left, and stops the replacement until the local or public AS number is encountered. During the replacement, the device ignores the AS number of the specified peer.

-

include-peer-as

Deletes AS numbers.

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, private AS numbers in the AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers on the left are deleted, and the deletion stops when the local or public AS number is encountered.

If limited, replace, and include-peer-as are specified at the same time, the private AS numbers in the AS_Path list are replaced with the local AS number from the leftmost one, and the replacement stops when the local or public AS number is encountered.

-

limited

Deletes private AS numbers from the leftmost one to the local or a public AS number except the private AS number of a specified peer group.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Select one of the preceding parameters based on the network topology to prevent routing loops or forwarding errors.

Example

# Configure a device to remove all private AS numbers from the AS_Path attribute in the Update messages to be sent to a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 10.1.1.1 public-as-only

peer public-as-only (BGP-VPN instance IPv4 address family view) (group)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

Format

peer group-name public-as-only

peer group-name public-as-only force [ replace ] [ include-peer-as ]

peer group-name public-as-only limited [ replace ] [ include-peer-as ]

undo peer group-name public-as-only

undo peer group-name public-as-only force [ replace ] [ include-peer-as ]

undo peer group-name public-as-only limited [ replace ] [ include-peer-as ]

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

force

Deletes all private AS numbers from the AS_Path attribute. The AS_Path attribute of a specified peer is ignored during the deletion.

-

replace

Replaces AS numbers with the local AS number.

If both force and replace are specified, all private AS numbers in the AS_Path list are replaced with the local AS number, and the AS number of the specified peer is ignored during the replacement.

If both limited and replace are specified, the device replaces all private AS numbers in the AS_Path list with the local AS number from the left, and stops the replacement until the local or public AS number is encountered. During the replacement, the device ignores the AS number of the specified peer.

-

include-peer-as

Deletes AS numbers.

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, private AS numbers in the AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers on the left are deleted, and the deletion stops when the local or public AS number is encountered.

If limited, replace, and include-peer-as are specified at the same time, the private AS numbers in the AS_Path list are replaced with the local AS number from the leftmost one, and the replacement stops when the local or public AS number is encountered.

-

limited

Deletes private AS numbers from the leftmost one to the local or a public AS number except the private AS number of a specified peer group.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Select one of the preceding parameters based on the network topology to prevent routing loops or forwarding errors.

Example

# Configure a device to remove all private AS numbers from the AS_Path attribute when sending a BGP Update message to its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test public-as-only

peer public-as-only (BGP-VPN instance IPv6 address family view)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

Format

peer ipv4-address public-as-only

peer ipv4-address public-as-only force [ replace ] [ include-peer-as ]

peer ipv4-address public-as-only limited [ replace ] [ include-peer-as ]

undo peer ipv4-address public-as-only

undo peer ipv4-address public-as-only force [ replace ] [ include-peer-as ]

undo peer ipv4-address public-as-only limited [ replace | include-peer-as ]

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

force

Deletes all private AS numbers from the AS_Path attribute except the private AS number of a specified peer.

-

replace

Replaces private AS numbers in an AS_Path list with a local AS number:

If both force and replace are specified, private AS numbers in an AS_Path list, except the AS number of a specified peer or peer group, are replaced with the local AS number.

If both limited and replace are specified, private AS numbers starting from the leftmost one in an AS_Path list, except the local or private AS number of a specified peer or peer group, are replaced with the local AS number.

-

include-peer-as

Deletes AS numbers:

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, the private AS numbers in an AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers starting from the leftmost one in an AS_Path list, except the local and public AS numbers, are deleted.

If limited, replace, and include-peer-as are specified, private AS numbers starting from the leftmost one in an AS_Path list, except the local or private AS numbers, are replaced with the local AS number.

-

limited

Deletes private AS numbers from the leftmost one to the local or a public AS number except the private AS number of a specified peer.

-

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Select one of the preceding parameters based on the network topology to prevent routing loops or forwarding errors.

Example

# Configure a device to remove all private AS numbers from the AS_Path attribute when sending a BGP Update message to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 public-as-only

peer public-as-only (BGP-VPN instance IPv6 address family view) (group)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

Format

peer group-name public-as-only

peer group-name public-as-only force [ replace ] [ include-peer-as ]

peer group-name public-as-only limited [ replace ] [ include-peer-as ]

undo peer group-name public-as-only

undo peer group-name public-as-only force [ replace ] [ include-peer-as ]

undo peer group-name public-as-only limited [ replace ] [ include-peer-as ]

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

force

Deletes all private AS numbers from the AS_Path attribute. The AS_Path attribute of a specified peer is ignored during the deletion.

-

replace

Replaces AS numbers with the local AS number.

If both force and replace are specified, all private AS numbers in the AS_Path list are replaced with the local AS number, and the AS number of the specified peer is ignored during the replacement.

If both limited and replace are specified, the device replaces all private AS numbers in the AS_Path list with the local AS number from the left, and stops the replacement until the local or public AS number is encountered. During the replacement, the device ignores the AS number of the specified peer.

-

include-peer-as

Deletes AS numbers.

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, private AS numbers in the AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers on the left are deleted, and the deletion stops when the local or public AS number is encountered.

If limited, replace, and include-peer-as are specified at the same time, the private AS numbers in the AS_Path list are replaced with the local AS number from the leftmost one, and the replacement stops when the local or public AS number is encountered.

-

limited

Deletes private AS numbers from the leftmost one to the local or a public AS number except the private AS number of a specified peer group.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Select one of the preceding parameters based on the network topology to prevent routing loops or forwarding errors.

Example

# Configure a device to remove all private AS numbers from the AS_Path attribute when sending a BGP Update message to its peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test public-as-only

peer public-as-only (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer public-as-only command configures the AS-Path attribute in a BGP Update message not to carry the private AS number. Only the public AS number is contained in the update messages.

The undo peer public-as-only command allows the AS-Path attribute in a BGP Update message to carry the private AS number.

By default, the AS-Path attribute in a BGP Update message is allowed to carry private AS numbers.

Format

peer ipv6-address public-as-only

peer ipv6-address public-as-only force [ replace ] [ include-peer-as ]

peer ipv6-address public-as-only limited [ replace ] [ include-peer-as ]

undo peer ipv6-address public-as-only

undo peer ipv6-address public-as-only force [ replace ] [ include-peer-as ]

undo peer ipv6-address public-as-only limited [ replace ] [ include-peer-as ]

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is in the format of X:X:X:X:X:X:X:X.

force

Deletes all private AS numbers from the AS_Path attribute. The AS_Path attribute of a specified peer is ignored during the deletion.

-

replace

Replaces AS numbers with the local AS number.

If both force and replace are specified, all private AS numbers in the AS_Path list are replaced with the local AS number, and the AS number of the specified peer is ignored during the replacement.

If both limited and replace are specified, the device replaces all private AS numbers in the AS_Path list with the local AS number from the left, and stops the replacement until the local or public AS number is encountered. During the replacement, the device ignores the AS number of the specified peer.

-

include-peer-as

Deletes AS numbers.

If both force and include-peer-as are specified, all private AS numbers are forcibly deleted.

If force, replace, and include-peer-as are specified, private AS numbers in the AS_Path list are replaced with the local AS number.

If both limited and include-peer-as are specified, the AS numbers on the left are deleted, and the deletion stops when the local or public AS number is encountered.

If limited, replace, and include-peer-as are specified at the same time, the private AS numbers in the AS_Path list are replaced with the local AS number from the leftmost one, and the replacement stops when the local or public AS number is encountered.

-

limited

Deletes AS numbers from the leftmost one to the local or a public AS number. The AS number of a specified peer is ignored during the deletion.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including public AS numbers, private AS numbers, and reserved AS numbers. If the private-4-byte-as enable command is not configured, the private AS number ranges from 64512 to 65534. 65535 is reserved for special applications. After the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special applications.

Public AS numbers can be directly used on the Internet. Private AS numbers cannot be directly advertised to the Internet. Otherwise, loops may occur. Therefore, private AS numbers are used only in internal routing domains.

You can run this command to process private AS numbers and reserved AS numbers in the AS_Path attribute of BGP routes as required. The processing of reserved AS numbers is the same as that of private AS numbers. The following describes how to process private AS numbers.

If the peer public-as-only command is run without any optional parameter and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then advertises the routes. BGP does not delete private AS numbers in the following situations:

  • The AS_Path attribute of a route contains the AS number of the peer. In this case, deleting the private AS number may cause routing loops.
  • The AS_Path list contains both public and private AS numbers. This list indicates that the route has passed through the public network. Deleting the private AS number may cause a forwarding error.

    To delete or replace private AS numbers in the AS_Path list, set the following parameters:
  • force: indicates that all private AS numbers are directly deleted. The AS numbers of the specified peer group are ignored during the deletion.
  • force replace: replaces the private AS number in the AS_Path list with the local AS number and ignores the AS number of the specified peer group.
  • force include-peer-as: deletes all private AS numbers.
  • force replace include-peer-as: replaces the private AS numbers in the AS_Path list with the local AS number. The purpose of replacement is to ensure that the lengths of the AS_Path lists are the same without affecting the route selection result.
  • limited: deletes the AS numbers from the leftmost one until a local or public AS number is found. The AS number of the specified peer is ignored during the deletion.
  • limited replace: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found. The AS number of the specified peer group is ignored during the replacement.
  • limited include-peer-as: deletes the AS numbers from the leftmost AS number. The purpose is to delete the private AS numbers of the network where the local device resides.
  • limited replace include-peer-as: replaces the private AS numbers in the AS_Path list from the left with the local AS number until the local or public AS number is found.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Select one of the preceding parameters based on the network topology to prevent routing loops or forwarding errors.

Example

# Configure a device to remove all private AS numbers from the AS_Path attribute when sending a BGP Update message to its peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 public-as-only

peer public-as-only import (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerGroupName public-as-only import [ force ]

undo peer peerGroupName public-as-only import [ force ]

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

force

Deletes all private AS numbers from the AS_Path attribute.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test public-as-only import

peer public-as-only import (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr public-as-only import [ force ]

peer peerIpv4Addr public-as-only import disable

undo peer peerIpv4Addr public-as-only import [ force ]

undo peer peerIpv4Addr public-as-only import disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

force

Deletes all private AS numbers from the AS_Path attribute.

-

disable

Disables a device from removing the private AS numbers from the AS_Path list in received BGP Update messages.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 public-as-only import

peer public-as-only import (BGP view)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

Format

peer peerIpv4Addr public-as-only import [ force ]

peer peerIpv4Addr public-as-only import disable

undo peer peerIpv4Addr public-as-only import [ force ]

undo peer peerIpv4Addr public-as-only import disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

force

Deletes all private AS numbers from the AS_Path attribute.

-

disable

Disables a device from removing the private AS numbers from the AS_Path list in received BGP Update messages.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Analyze the network structure with caution and select proper optional parameters to prevent routing loops or forwarding errors.

This command takes effect before an export routing policy is configured.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 public-as-only import

peer public-as-only import (BGP view) (group)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

Format

peer peerGroupName public-as-only import [ force ]

undo peer peerGroupName public-as-only import [ force ]

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

force

Deletes all private AS numbers from the AS_Path attribute.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Configuration Impact

If the peer public-as-only command is run for a peer group, the peers of the peer group inherit the configuration.

Precautions

Analyze the network structure with caution and select proper optional parameters to prevent routing loops or forwarding errors.

This command takes effect before an export routing policy is configured.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer test as-number 100
[HUAWEI-bgp] peer test public-as-only import

peer public-as-only import (BGP-IPv4 unicast address family view)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

Format

peer peerIpv4Addr public-as-only import disable

peer peerIpv4Addr public-as-only import [ force ]

undo peer peerIpv4Addr public-as-only import disable

undo peer peerIpv4Addr public-as-only import [ force ]

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

It is in dotted decimal notation.

disable

Disables a device from removing the private AS numbers from the AS_Path list in received BGP Update messages.

-

force

Deletes all private AS numbers from the AS_Path attribute.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 public-as-only import

peer public-as-only import (BGP-IPv4 unicast address family view) (group)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

Format

peer peerGroupName public-as-only import [ force ]

undo peer peerGroupName public-as-only import [ force ]

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

force

Deletes all private AS numbers from the AS_Path attribute.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test public-as-only import

peer public-as-only import (BGP-IPv6 unicast address family view)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

Format

peer peerIpv4Addr public-as-only import [ force ]

peer peerIpv4Addr public-as-only import disable

undo peer peerIpv4Addr public-as-only import [ force ]

undo peer peerIpv4Addr public-as-only import disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

force

Deletes all private AS numbers from the AS_Path attribute.

-

disable

Disables a device from removing the private AS numbers from the AS_Path list in received BGP Update messages.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 public-as-only import

peer public-as-only import (BGP-IPv6 unicast address family view) (group)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

Format

peer peerGroupName public-as-only import [ force ]

undo peer peerGroupName public-as-only import [ force ]

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

force

Deletes all private AS numbers from the AS_Path attribute.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test public-as-only import

peer public-as-only import (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

Format

peer peerIpv6Addr public-as-only import [ force ]

peer peerIpv6Addr public-as-only import disable

undo peer peerIpv6Addr public-as-only import [ force ]

undo peer peerIpv6Addr public-as-only import disable

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

force

Deletes all private AS numbers from the AS_Path attribute.

-

disable

Disables a device from removing the private AS numbers from the AS_Path list in received BGP Update messages.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 public-as-only import

peer public-as-only import (BGP-VPN instance IPv4 address family view)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

Format

peer peerIpv4Addr public-as-only import [ force ]

peer peerIpv4Addr public-as-only import disable

undo peer peerIpv4Addr public-as-only import [ force ]

undo peer peerIpv4Addr public-as-only import disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

force

Deletes all private AS numbers from the AS_Path attribute.

-

disable

Disables a device from removing the private AS numbers from the AS_Path list in received BGP Update messages.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 10.1.1.1 public-as-only import

peer public-as-only import (BGP-VPN instance IPv4 address family view) (group)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

Format

peer peerGroupName public-as-only import [ force ]

undo peer peerGroupName public-as-only import [ force ]

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

force

Deletes all private AS numbers from the AS_Path attribute.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test public-as-only import

peer public-as-only import (BGP-VPN instance IPv6 address family view)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

Format

peer peerIpv4Addr public-as-only import [ force ]

peer peerIpv4Addr public-as-only import disable

undo peer peerIpv4Addr public-as-only import [ force ]

undo peer peerIpv4Addr public-as-only import disable

Parameters

Parameter Description Value
peerIpv4Addr

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

force

Deletes all private AS numbers from the AS_Path attribute.

-

disable

Disables a device from removing the private AS numbers from the AS_Path list in received BGP Update messages.

-

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 public-as-only import

peer public-as-only import (BGP-VPN instance IPv6 address family view) (group)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

Format

peer peerGroupName public-as-only import [ force ]

undo peer peerGroupName public-as-only import [ force ]

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

force

Deletes all private AS numbers from the AS_Path attribute.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test public-as-only import

peer public-as-only import (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer public-as-only import command enables a device to remove private AS numbers from the AS_Path list in received BGP Update messages.

The undo peer public-as-only import command allows a device to accept BGP Update messages in which the AS_Path list carries private AS numbers.

By default, a device does not remove private AS numbers from the AS_Path list when receiving BGP Update messages.

Format

peer peerIpv6Addr public-as-only import [ force ]

peer peerIpv6Addr public-as-only import disable

undo peer peerIpv6Addr public-as-only import [ force ]

undo peer peerIpv6Addr public-as-only import disable

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The prefix is in the format of X:X:X:X:X:X:X:X.

force

Deletes all private AS numbers from the AS_Path attribute except the private AS number of a specified peer.

-

disable

Disables a device from removing the private AS numbers from the AS_Path list in received BGP Update messages.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the private-4-byte-as enable command is not run, private AS numbers range from 64512 to 65534, and the AS number 65535 is reserved for special use. If the private-4-byte-as enable command is run, private AS numbers range from 64512 to 65534 and from 4200000000 to 4294967294, and the AS numbers 65535 and 4294967295 are reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

This command enables BGP to process the private and reserved AS numbers in the AS_Path attribute of BGP routes as required. Reserved AS numbers are processed the same as private AS numbers. The following uses private AS numbers as an example to illustrate the processing modes:

If the peer public-as-only import command is run without any optional parameter specified and the AS_Path attribute of BGP routes contains only private AS numbers, BGP deletes these private AS numbers and then accepts update messages. If the AS_Path contains both public and private AS numbers, BGP does not delete the private AS numbers. If private AS numbers are deleted in this case, a forwarding error may occur. To forcibly delete private AS numbers from the AS_Path, configure force.

Example

# Enable a BGP device to remove all the private AS numbers from the AS_Path list in BGP Update messages received from a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 public-as-only import

peer reflect-client (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer reflect-client command configures the local router as the route reflector and the peer group as the client of the route reflector.

The undo peer reflect-client command cancels the configuration.

By default, the route reflector and its client are not configured.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name reflect-client

undo peer group-name reflect-client

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Full-meshed connections need to be established between IBGP peers to ensure the connectivity between the IBGP peers. If there are n devices in an AS, n x (n – 1)/2 IBGP connections need to be established. When there are a lot of IBGP peers, network resources and CPU resources are greatly consumed. To solve this problem, route reflection is used.

In an AS, one device functions as an RR, and the other devices function as clients. The clients establish IBGP connections with the RR. The RR and its clients form a cluster. The RR reflects routes among the clients, and therefore the clients do not need to establish any BGP connection. Assume that an AS has n devices. If one of the devices functions as an RR, and other devices function as clients, the number of IBGP connections to be established is n-1. This means that network and CPU resource consumption is greatly reduced.

An RR is easy to configure, because it needs to be configured only on the device that functions as a reflector and clients do not need to know that they are clients.

Configuration Impact

If the peer reflect-client command is run multiple times in the same view, the latest configuration overwrites the previous one.

The device where the peer reflect-client command is run serves as the RR and a specified peer group serves as the client of the RR.

Precautions

The peer reflect-client command applies only to IBGP peer groups.

The RR information configured in an address family is valid only in this address family and cannot be inherited by other address families. Therefore, you are advised to configure RR information in a specific address family.

If this command is run on a specified peer and the peer advertise best-external command is run in a specified peer group, the peer cannot inherit the function of the peer advertise best-external command when the peer is added to the peer group.

Example

# Configure a peer group as a client of an RR.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test reflect-client

peer reflect-client (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer reflect-client command configures the local router as the route reflector and the peer or peer group as the client of the route reflector.

The undo peer reflect-client command cancels the configuration.

By default, the route reflector and its client are not configured.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address reflect-client

undo peer ipv4-address reflect-client

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Full-meshed connections need to be established between IBGP peers to ensure the connectivity between the IBGP peers. If there are n devices in an AS, n x (n – 1)/2 IBGP connections need to be established. When there are a lot of IBGP peers, network resources and CPU resources are greatly consumed. To solve this problem, route reflection is used.

In an AS, one device functions as an RR, and the other devices function as clients. The clients establish IBGP connections with the RR. The RR and its clients form a cluster. The RR reflects routes among the clients, and therefore the clients do not need to establish any BGP connection. Assume that an AS has n devices. If one of the devices functions as an RR, and other devices function as clients, the number of IBGP connections to be established is n-1. This means that network and CPU resource consumption is greatly reduced.

An RR is easy to configure, because it needs to be configured only on the device that functions as a reflector and clients do not need to know that they are clients.

Configuration Impact

If the peer reflect-client command is run multiple times in the same view, the latest configuration overwrites the previous one.

The device where the peer reflect-client command is run serves as the RR and a specified peer serves as the client of the RR.

Precautions

The peer reflect-client command applies only to IBGP peers.

The RR information configured in an address family is valid only in this address family and cannot be inherited by other address families. Therefore, you are advised to configure RR information in a specific address family.

If this command is run on a specified peer and the peer advertise best-external command is run in a specified peer group, the peer cannot inherit the function of the peer advertise best-external command when the peer is added to the peer group.

Example

# Configure a peer as a client of an RR.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 reflect-client

peer reflect-client (BGP view) (group)

Function

The peer reflect-client command configures the local device as the route reflector and a peer group as the client of the route reflector.

The undo peer reflect-client command cancels the existing configuration.

By default, the route reflector and its client are not configured.

Format

peer group-name reflect-client

undo peer group-name reflect-client

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Full-meshed connections need to be established between IBGP peers to ensure the connectivity between the IBGP peers. If there are n Devices in an AS, n (n-1)/2 IBGP connections need to be established. A large number of IBGP peers use a lot of network and CPU resources. An RR can be used to solve the problem.

In an AS, one Device functions as an RR and other Devices function as clients. The clients establish IBGP connections with the RR. The RR and its clients form a cluster. The RR reflects routes among the clients, and therefore the clients do not need to establish any BGP connection. Assume that an AS has n Devices. If one of the Devices functions as an RR, and other Devices function as clients, the number of IBGP connections to be established is n-1. This means that network and CPU resources are greatly reduced.

An RR is easy to configure, because it needs to be configured only on the device that functions as a reflector and clients do not need to know that they are clients.

Configuration Impact

If the peer reflect-client command is run multiple times in the same view, the latest configuration overwrites the previous one.

After the peer reflect-client command is run, the local device functions as the RR and the specified peer group functions as the client of the RR.

Precautions

The peer reflect-client command applies only to IBGP peer groups.

The RR information configured in an address family is valid only in this address family and cannot be inherited by other address families. Therefore, you are advised to configure RR information in a specific address family.

If this command is run on a specified peer and the peer advertise best-external command is run in a specified peer group, the peer cannot inherit the function of the peer advertise best-external command when the peer is added to the peer group.

Example

# Configure a peer group as a client of an RR.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test internal
[HUAWEI-bgp] peer test reflect-client

peer reflect-client (BGP view)(IPv4)

Function

The peer reflect-client command configures the local router as the route reflector and the peer or peer group as the client of the route reflector.

The undo peer reflect-client command cancels the configuration.

By default, the route reflector and its client are not configured.

Format

peer ipv4-address reflect-client

undo peer ipv4-address reflect-client

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Full-meshed connections need to be established between IBGP peers to ensure the connectivity between the IBGP peers. If there are n Devices in an AS, n (n-1)/2 IBGP connections need to be established. A large number of IBGP peers use a lot of network and CPU resources. An RR can be used to solve the problem.

In an AS, one Device functions as an RR and other Devices function as clients. The clients establish IBGP connections with the RR. The RR and its clients form a cluster. The RR reflects routes among the clients, and therefore the clients do not need to establish any BGP connection. Assume that an AS has n Devices. If one of the Devices functions as an RR, and other Devices function as clients, the number of IBGP connections to be established is n-1. This means that network and CPU resources are greatly reduced.

An RR is easy to configure, because it needs to be configured only on the device that functions as a reflector and clients do not need to know that they are clients.

Configuration Impact

If the peer reflect-client command is run multiple times in the same view, the latest configuration overwrites the previous one.

The device where the peer reflect-client command is run serves as the RR and a specified peer serves as the client of the RR.

Precautions

The peer reflect-client command applies only to IBGP peers.

The RR information configured in an address family is valid only in this address family and cannot be inherited by other address families. Therefore, you are advised to configure RR information in a specific address family.

If this command is run on a specified peer and the peer advertise best-external command is run in a specified peer group, the peer cannot inherit the function of the peer advertise best-external command when the peer is added to the peer group.

Example

# Configure a peer as a client of an RR.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 reflect-client

peer reflect-client (BGP-IPv4 unicast address family view) (group)

Function

The peer reflect-client command configures the local device as the route reflector and a peer group as the client of the route reflector.

The undo peer reflect-client command cancels the existing configuration.

By default, the route reflector and its client are not configured.

Format

peer group-name reflect-client

undo peer group-name reflect-client

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Full-meshed connections need to be established between IBGP peers to ensure the connectivity between the IBGP peers. If there are n Devices in an AS, n (n-1)/2 IBGP connections need to be established. A large number of IBGP peers use a lot of network and CPU resources. An RR can be used to solve the problem.

In an AS, one Device functions as an RR and other Devices function as clients. The clients establish IBGP connections with the RR. The RR and its clients form a cluster. The RR reflects routes among the clients, and therefore the clients do not need to establish any BGP connection. Assume that an AS has n Devices. If one of the Devices functions as an RR, and other Devices function as clients, the number of IBGP connections to be established is n-1. This means that network and CPU resources are greatly reduced.

An RR is easy to configure, because it needs to be configured only on the device that functions as a reflector and clients do not need to know that they are clients.

Configuration Impact

If the peer reflect-client command is run multiple times in the same view, the latest configuration overwrites the previous one.

After the peer reflect-client command is run, the local device functions as the RR and the specified peer group functions as the client of the RR.

Precautions

The peer reflect-client command applies only to IBGP peer groups.

The RR information configured in an address family is valid only in this address family and cannot be inherited by other address families. Therefore, you are advised to configure RR information in a specific address family.

If this command is run on a specified peer and the peer advertise best-external command is run in a specified peer group, the peer cannot inherit the function of the peer advertise best-external command when the peer is added to the peer group.

Example

# Configure a peer group as a client of an RR.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test reflect-client

peer reflect-client (BGP-IPv4 unicast address family view)(IPv4)

Function

The peer reflect-client command configures the local router as the route reflector and the peer or peer group as the client of the route reflector.

The undo peer reflect-client command cancels the configuration.

By default, the route reflector and its client are not configured.

Format

peer ipv4-address reflect-client

undo peer ipv4-address reflect-client

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Full-meshed connections need to be established between IBGP peers to ensure the connectivity between the IBGP peers. If there are n Devices in an AS, n (n-1)/2 IBGP connections need to be established. A large number of IBGP peers use a lot of network and CPU resources. An RR can be used to solve the problem.

In an AS, one Device functions as an RR and other Devices function as clients. The clients establish IBGP connections with the RR. The RR and its clients form a cluster. The RR reflects routes among the clients, and therefore the clients do not need to establish any BGP connection. Assume that an AS has n Devices. If one of the Devices functions as an RR, and other Devices function as clients, the number of IBGP connections to be established is n-1. This means that network and CPU resources are greatly reduced.

An RR is easy to configure, because it needs to be configured only on the device that functions as a reflector and clients do not need to know that they are clients.

Configuration Impact

If the peer reflect-client command is run multiple times in the same view, the latest configuration overwrites the previous one.

The device where the peer reflect-client command is run serves as the RR and a specified peer serves as the client of the RR.

Precautions

The peer reflect-client command applies only to IBGP peers.

The RR information configured in an address family is valid only in this address family and cannot be inherited by other address families. Therefore, you are advised to configure RR information in a specific address family.

If this command is run on a specified peer and the peer advertise best-external command is run in a specified peer group, the peer cannot inherit the function of the peer advertise best-external command when the peer is added to the peer group.

Example

# Configure a peer as a client of an RR.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.1 reflect-client

peer reflect-client (BGP-IPv6 unicast address family view) (group)

Function

The peer reflect-client command configures the local device as the route reflector and a peer group as the client of the route reflector.

The undo peer reflect-client command cancels the existing configuration.

By default, the route reflector and its client are not configured.

Format

peer group-name reflect-client

undo peer group-name reflect-client

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Full-meshed connections need to be established between IBGP peers to ensure the connectivity between the IBGP peers. If there are n Devices in an AS, n (n-1)/2 IBGP connections need to be established. A large number of IBGP peers use a lot of network and CPU resources. An RR can be used to solve the problem.

In an AS, one Device functions as an RR and other Devices function as clients. The clients establish IBGP connections with the RR. The RR and its clients form a cluster. The RR reflects routes among the clients, and therefore the clients do not need to establish any BGP connection. Assume that an AS has n Devices. If one of the Devices functions as an RR, and other Devices function as clients, the number of IBGP connections to be established is n-1. This means that network and CPU resources are greatly reduced.

An RR is easy to configure, because it needs to be configured only on the device that functions as a reflector and clients do not need to know that they are clients.

Configuration Impact

If the peer reflect-client command is run multiple times in the same view, the latest configuration overwrites the previous one.

After the peer reflect-client command is run, the local device functions as the RR and the specified peer group functions as the client of the RR.

Precautions

The peer reflect-client command applies only to IBGP peer groups.

The RR information configured in an address family is valid only in this address family and cannot be inherited by other address families. Therefore, you are advised to configure RR information in a specific address family.

If this command is run on a specified peer and the peer advertise best-external command is run in a specified peer group, the peer cannot inherit the function of the peer advertise best-external command when the peer is added to the peer group.

Example

# Configure a peer group as a client of an RR.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test reflect-client

peer reflect-client (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer reflect-client command configures the local router as the route reflector and the peer or peer group as the client of the route reflector.

The undo peer reflect-client command cancels the configuration.

By default, the route reflector and its client are not configured.

Format

peer ipv6-address reflect-client

undo peer ipv6-address reflect-client

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Full-meshed connections need to be established between IBGP peers to ensure the connectivity between the IBGP peers. If there are n Devices in an AS, n (n-1)/2 IBGP connections need to be established. A large number of IBGP peers use a lot of network and CPU resources. An RR can be used to solve the problem.

In an AS, one Device functions as an RR and other Devices function as clients. The clients establish IBGP connections with the RR. The RR and its clients form a cluster. The RR reflects routes among the clients, and therefore the clients do not need to establish any BGP connection. Assume that an AS has n Devices. If one of the Devices functions as an RR, and other Devices function as clients, the number of IBGP connections to be established is n-1. This means that network and CPU resources are greatly reduced.

An RR is easy to configure, because it needs to be configured only on the device that functions as a reflector and clients do not need to know that they are clients.

Configuration Impact

If the peer reflect-client command is run multiple times in the same view, the latest configuration overwrites the previous one.

The device where the peer reflect-client command is run serves as the RR and a specified peer serves as the client of the RR.

Precautions

The peer reflect-client command applies only to IBGP peers.

The RR information configured in an address family is valid only in this address family and cannot be inherited by other address families. Therefore, you are advised to configure RR information in a specific address family.

If this command is run on a specified peer and the peer advertise best-external command is run in a specified peer group, the peer cannot inherit the function of the peer advertise best-external command when the peer is added to the peer group.

Example

# Configure a peer as a client of an RR.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 reflect-client

peer reflect-client (BGP-IPv6 unicast address family view)(IPv4)

Function

The peer reflect-client command configures the local router as the route reflector and the peer or peer group as the client of the route reflector.

The undo peer reflect-client command cancels the configuration.

By default, the route reflector and its client are not configured.

Format

peer ipv4-address reflect-client

undo peer ipv4-address reflect-client

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Full-meshed connections need to be established between IBGP peers to ensure the connectivity between the IBGP peers. If there are n Devices in an AS, n (n-1)/2 IBGP connections need to be established. A large number of IBGP peers use a lot of network and CPU resources. An RR can be used to solve the problem.

In an AS, one Device functions as an RR and other Devices function as clients. The clients establish IBGP connections with the RR. The RR and its clients form a cluster. The RR reflects routes among the clients, and therefore the clients do not need to establish any BGP connection. Assume that an AS has n Devices. If one of the Devices functions as an RR, and other Devices function as clients, the number of IBGP connections to be established is n-1. This means that network and CPU resources are greatly reduced.

An RR is easy to configure, because it needs to be configured only on the device that functions as a reflector and clients do not need to know that they are clients.

Configuration Impact

If the peer reflect-client command is run multiple times in the same view, the latest configuration overwrites the previous one.

The device where the peer reflect-client command is run serves as the RR and a specified peer serves as the client of the RR.

Precautions

The peer reflect-client command applies only to IBGP peers.

The RR information configured in an address family is valid only in this address family and cannot be inherited by other address families. Therefore, you are advised to configure RR information in a specific address family.

If this command is run on a specified peer and the peer advertise best-external command is run in a specified peer group, the peer cannot inherit the function of the peer advertise best-external command when the peer is added to the peer group.

Example

# Configure a peer as a client of an RR.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 reflect-client

peer reflect-client (BGP-VPN instance IPv4 address family view) (group)

Function

The peer reflect-client command configures the local device as the route reflector and a peer group as the client of the route reflector.

The undo peer reflect-client command cancels the existing configuration.

By default, the route reflector and its client are not configured.

Format

peer group-name reflect-client

undo peer group-name reflect-client

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Full-meshed connections need to be established between IBGP peers to ensure the connectivity between the IBGP peers. If there are n devices in an AS, n x (n – 1)/2 IBGP connections need to be established. When there are a lot of IBGP peers, network resources and CPU resources are greatly consumed. To solve this problem, route reflection is used.

In an AS, one device functions as an RR, and the other devices function as clients. The clients establish IBGP connections with the RR. The RR and its clients form a cluster. The RR reflects routes among the clients, and therefore the clients do not need to establish any BGP connection. Assume that an AS has n devices. If one of the devices functions as an RR, and other devices function as clients, the number of IBGP connections to be established is n-1. This means that network and CPU resource consumption is greatly reduced.

An RR is easy to configure, because it needs to be configured only on the device that functions as a reflector and clients do not need to know that they are clients.

Configuration Impact

If the peer reflect-client command is run multiple times in the same view, the latest configuration overwrites the previous one.

The device where the peer reflect-client command is run serves as the RR and a specified peer group serves as the client of the RR.

Precautions

The peer reflect-client command applies only to IBGP peer groups.

The RR information configured in an address family is valid only in this address family and cannot be inherited by other address families. Therefore, you are advised to configure RR information in a specific address family.

If this command is run on a specified peer and the peer advertise best-external command is run in a specified peer group, the peer cannot inherit the function of the peer advertise best-external command when the peer is added to the peer group.

Example

# Configure a peer group as a client of an RR.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test reflect-client

peer reflect-client (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer reflect-client command configures the local router as the route reflector and the peer or peer group as the client of the route reflector.

The undo peer reflect-client command cancels the configuration.

By default, the route reflector and its client are not configured.

Format

peer ipv4-address reflect-client

undo peer ipv4-address reflect-client

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Full-meshed connections need to be established between IBGP peers to ensure the connectivity between the IBGP peers. If there are n devices in an AS, n x (n – 1)/2 IBGP connections need to be established. When there are a lot of IBGP peers, network resources and CPU resources are greatly consumed. To solve this problem, route reflection is used.

In an AS, one device functions as an RR, and the other devices function as clients. The clients establish IBGP connections with the RR. The RR and its clients form a cluster. The RR reflects routes among the clients, and therefore the clients do not need to establish any BGP connection. Assume that an AS has n devices. If one of the devices functions as an RR, and other devices function as clients, the number of IBGP connections to be established is n-1. This means that network and CPU resource consumption is greatly reduced.

An RR is easy to configure, because it needs to be configured only on the device that functions as a reflector and clients do not need to know that they are clients.

Configuration Impact

If the peer reflect-client command is run multiple times in the same view, the latest configuration overwrites the previous one.

The device where the peer reflect-client command is run serves as the RR and a specified peer serves as the client of the RR.

Precautions

The peer reflect-client command applies only to IBGP peers.

The RR information configured in an address family is valid only in this address family and cannot be inherited by other address families. Therefore, you are advised to configure RR information in a specific address family.

If this command is run on a specified peer and the peer advertise best-external command is run in a specified peer group, the peer cannot inherit the function of the peer advertise best-external command when the peer is added to the peer group.

Example

# Configure a peer as a client of an RR.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 1.1.1.1 reflect-client

peer reflect-client (BGP-VPN instance IPv6 address family view) (group)

Function

The peer reflect-client command configures the local device as the route reflector and a peer group as the client of the route reflector.

The undo peer reflect-client command cancels the existing configuration.

By default, the route reflector and its client are not configured.

Format

peer group-name reflect-client

undo peer group-name reflect-client

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Full-meshed connections need to be established between IBGP peers to ensure the connectivity between the IBGP peers. If there are n Devices in an AS, n (n-1)/2 IBGP connections need to be established. A large number of IBGP peers use a lot of network and CPU resources. An RR can be used to solve the problem.

In an AS, one Device functions as an RR and other Devices function as clients. The clients establish IBGP connections with the RR. The RR and its clients form a cluster. The RR reflects routes among the clients, and therefore the clients do not need to establish any BGP connection. Assume that an AS has n Devices. If one of the Devices functions as an RR, and other Devices function as clients, the number of IBGP connections to be established is n-1. This means that network and CPU resources are greatly reduced.

An RR is easy to configure, because it needs to be configured only on the device that functions as a reflector and clients do not need to know that they are clients.

Configuration Impact

If the peer reflect-client command is run multiple times in the same view, the latest configuration overwrites the previous one.

After the peer reflect-client command is run, the local device functions as the RR and the specified peer group functions as the client of the RR.

Precautions

The peer reflect-client command applies only to IBGP peer groups.

The RR information configured in an address family is valid only in this address family and cannot be inherited by other address families. Therefore, you are advised to configure RR information in a specific address family.

If this command is run on a specified peer and the peer advertise best-external command is run in a specified peer group, the peer cannot inherit the function of the peer advertise best-external command when the peer is added to the peer group.

Example

# Configure a peer group as a client of an RR.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test internal
[HUAWEI-bgp-6-vpn1] peer test reflect-client

peer reflect-client (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer reflect-client command configures the local router as the route reflector and the peer or peer group as the client of the route reflector.

The undo peer reflect-client command cancels the configuration.

By default, the route reflector and its client are not configured.

Format

peer ipv6-address reflect-client

undo peer ipv6-address reflect-client

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Full-meshed connections need to be established between IBGP peers to ensure the connectivity between the IBGP peers. If there are n Devices in an AS, n (n-1)/2 IBGP connections need to be established. A large number of IBGP peers use a lot of network and CPU resources. An RR can be used to solve the problem.

In an AS, one Device functions as an RR and other Devices function as clients. The clients establish IBGP connections with the RR. The RR and its clients form a cluster. The RR reflects routes among the clients, and therefore the clients do not need to establish any BGP connection. Assume that an AS has n Devices. If one of the Devices functions as an RR, and other Devices function as clients, the number of IBGP connections to be established is n-1. This means that network and CPU resources are greatly reduced.

An RR is easy to configure, because it needs to be configured only on the device that functions as a reflector and clients do not need to know that they are clients.

Configuration Impact

If the peer reflect-client command is run multiple times in the same view, the latest configuration overwrites the previous one.

The device where the peer reflect-client command is run serves as the RR and a specified peer serves as the client of the RR.

Precautions

The peer reflect-client command applies only to IBGP peers.

The RR information configured in an address family is valid only in this address family and cannot be inherited by other address families. Therefore, you are advised to configure RR information in a specific address family.

If this command is run on a specified peer and the peer advertise best-external command is run in a specified peer group, the peer cannot inherit the function of the peer advertise best-external command when the peer is added to the peer group.

Example

# Configure a peer as a client of an RR.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 reflect-client

peer rely-state interface (BGP view)

Function

The peer rely-state interface command configures a BGP peer to track the physical status of a specified physical interface.

The undo peer rely-state interface command configures a BGP peer not to track the physical status of a specified physical interface.

By default, the BGP peer is not configured to track the physical status of any physical interface.

Format

peer ipv4-address rely-state interface { interface-name | interface-type interface-number }

undo peer ipv4-address rely-state interface { interface-name | interface-type interface-number }

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

interface-name

Specifies an interface name.

-

interface-type

Specifies the type of an interface.

-

-

-

-

-

interface-number

Specifies the number of an interface.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A device sets up BGP peer relationships with some servers in a VLAN through a VLANIF interface. If the physical status of the interface connected to a server goes Down, the BGP peer cannot detect the status change in time, and the BGP peer relationship is disconnected only after a period of time (180s by default). During this period, traffic is lost. To prevent this problem, run the peer rely-state interface command to configure the BGP peer to track the physical status of a specified physical interface. The establishment of a BGP peer relationship depends on the physical status of the specified physical interface. If the physical status of the specified physical interface is Up, the BGP peer relationship can be established. If the physical status is Down, the BGP peer relationship is disconnected.

Precautions

If a BGP peer is configured to track the physical status of a specified physical interface, the establishment of a BGP peer relationship depends on the physical status of the specified physical interface. If the physical status is Down, the BGP peer relationship cannot be established. Therefore, exercise caution when running the command.

Example

# Configure a public network BGP IPv4 peer to track the physical status of 10GE 1/0/1.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 100
[HUAWEI-bgp] peer 10.1.1.2 rely-state interface 10GE 1/0/1

peer rely-state interface (BGP view) (IPv6)

Function

The peer rely-state interface command configures a BGP peer to track the physical status of a specified physical interface.

The undo peer rely-state interface command configures a BGP peer not to track the physical status of a specified physical interface.

By default, the BGP peer is not configured to track the physical status of any physical interface.

Format

peer ipv6-address rely-state interface { interface-name | interface-type interface-number }

undo peer ipv6-address rely-state interface { interface-name | interface-type interface-number }

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

interface-name

Specifies the name of an interface.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

interface-type

Specifies the type of an interface.

-

-

-

-

-

interface-number

Specifies an interface number.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A device sets up BGP peer relationships with some servers in a VLAN through a VLANIF interface. If the physical status of the interface connected to a server goes Down, the BGP peer cannot detect the status change in time, and the BGP peer relationship is disconnected only after a period of time (180s by default). During this period, traffic is lost. To prevent this problem, run the peer rely-state interface command to configure the BGP peer to track the physical status of a specified physical interface. The establishment of a BGP peer relationship depends on the physical status of the specified physical interface. If the physical status of the specified physical interface is Up, the BGP peer relationship can be established. If the physical status is Down, the BGP peer relationship is disconnected.

Precautions

If a BGP peer is configured to track the physical status of a specified physical interface, the establishment of a BGP peer relationship depends on the physical status of the specified physical interface. If the physical status is Down, the BGP peer relationship cannot be established. Therefore, exercise caution when running the command.

Example

# Configure a public network BGP IPv6 peer to track the physical status of 10GE 1/0/1.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] peer 2001:DB8:1::1 rely-state interface 10GE 1/0/1

peer rely-state interface (BGP-VPN instance IPv4 address family view)

Function

The peer rely-state interface command configures a BGP peer to track the physical status of a specified physical interface.

The undo peer rely-state interface command configures a BGP peer not to track the physical status of a specified physical interface.

By default, the BGP peer is not configured to track the physical status of any physical interface.

Format

peer ipv4-address rely-state interface { interface-name | interface-type interface-number }

undo peer ipv4-address rely-state interface { interface-name | interface-type interface-number }

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

interface-name

Specifies an interface name.

-

interface-type

Specifies an interface type and number.

-

interface-number

Specifies the number of an interface.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A device sets up BGP peer relationships with some servers in a VLAN through a VLANIF interface. If the physical status of the interface connected to a server goes Down, the BGP peer cannot detect the status change in time, and the BGP peer relationship is disconnected only after a period of time (180s by default). During this period, traffic is lost. To prevent this problem, run the peer rely-state interface command to configure the BGP peer to track the physical status of a specified physical interface. The establishment of a BGP peer relationship depends on the physical status of the specified physical interface. If the physical status of the specified physical interface is Up, the BGP peer relationship can be established. If the physical status is Down, the BGP peer relationship is disconnected.

Precautions

If a BGP peer is configured to track the physical status of a specified physical interface, the establishment of a BGP peer relationship depends on the physical status of the specified physical interface. If the physical status is Down, the BGP peer relationship cannot be established. Therefore, exercise caution when running the command.

Example

# Configure a BGP peer to track the physical status of 10GE 1/0/1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-vrf1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vrf1] peer 10.1.1.1 rely-state interface 10GE 1/0/1

peer rely-state interface (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer rely-state interface command configures a BGP peer to track the physical status of a specified physical interface.

The undo peer rely-state interface command configures a BGP peer not to track the physical status of a specified physical interface.

By default, the BGP peer is not configured to track the physical status of any physical interface.

Format

peer ipv6-address rely-state interface { interface-name | interface-type interface-number }

undo peer ipv6-address rely-state interface { interface-name | interface-type interface-number }

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The format is X:X:X:X:X:X:X:X.

interface-name

Specifies an interface name.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.

interface-type

Specifies an interface type.

-

interface-number

Specifies the number of an interface.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A device sets up BGP peer relationships with some servers in a VLAN through a VLANIF interface. If the physical status of the interface connected to a server goes Down, the BGP peer cannot detect the status change in time, and the BGP peer relationship is disconnected only after a period of time (180s by default). During this period, traffic is lost. To prevent this problem, run the peer rely-state interface command to configure the BGP peer to track the physical status of a specified physical interface. The establishment of a BGP peer relationship depends on the physical status of the specified physical interface. If the physical status of the specified physical interface is Up, the BGP peer relationship can be established. If the physical status is Down, the BGP peer relationship is disconnected.

Precautions

If a BGP peer is configured to track the physical status of a specified physical interface, the establishment of a BGP peer relationship depends on the physical status of the specified physical interface. If the physical status is Down, the BGP peer relationship cannot be established. Therefore, exercise caution when running the command.

Example

# Specify a peer in the BGP-VPN instance IPv6 address family to track the status of the physical interface 10GE 1/0/1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 rely-state interface 10GE 1/0/1

peer rely-state interface (BGP-VPN instance view)

Function

The peer rely-state interface command configures a BGP peer to track the physical status of a specified physical interface.

The undo peer rely-state interface command configures a BGP peer not to track the physical status of a specified physical interface.

By default, the BGP peer is not configured to track the physical status of any physical interface.

Format

peer peerIpv4Addr rely-state interface { interface-name | localIfType localIfNum }

undo peer peerIpv4Addr rely-state interface { interface-name | localIfType localIfNum }

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

It is in dotted decimal notation.

interface-name

Specifies the name of an interface.

-

localIfType

Specifies an interface type.

-

localIfNum

Specifies an interface number.

-

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A device sets up BGP peer relationships with some servers in a VLAN through a VLANIF interface. If the physical status of the interface connected to a server goes Down, the BGP peer cannot detect the status change in time, and the BGP peer relationship is disconnected only after a period of time (180s by default). During this period, traffic is lost. To prevent this problem, run the peer rely-state interface command to configure the BGP peer to track the physical status of a specified physical interface. The establishment of a BGP peer relationship depends on the physical status of the specified physical interface. If the physical status of the specified physical interface is Up, the BGP peer relationship can be established. If the physical status is Down, the BGP peer relationship is disconnected.

Precautions

If a BGP peer is configured to track the physical status of a specified physical interface, the establishment of a BGP peer relationship depends on the physical status of the specified physical interface. If the physical status is Down, the BGP peer relationship cannot be established. Therefore, exercise caution when running the command.

Example

# Configure a BGP peer to track the physical status of 10GE 1/0/1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vrf1
[HUAWEI-bgp-instance-vrf1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-vrf1] peer 10.1.1.1 rely-state interface 10GE 1/0/1

peer rely-state interface (BGP-VPN instance view)(IPv6)

Function

The peer rely-state interface command configures a BGP peer to track the physical status of a specified physical interface.

The undo peer rely-state interface command configures a BGP peer not to track the physical status of a specified physical interface.

By default, a BGP peer is disabled from detecting the physical status of a specified physical interface.

Format

peer peerIpv6Addr rely-state interface { interface-name | localIfType localIfNum }

undo peer peerIpv6Addr rely-state interface { interface-name | localIfType localIfNum }

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is in dotted decimal notation.

interface-name

Specifies the name of an interface.

-

localIfType

Specifies the type of an interface.

-

-

-

-

localIfNum

Specifies an interface number.

-

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A device sets up BGP peer relationships with some servers in a VLAN through a VLANIF interface. If the physical status of the interface connected to a server goes Down, the BGP peer cannot detect the status change in time, and the BGP peer relationship is disconnected only after a period of time (180s by default). During this period, traffic is lost. To prevent this problem, run the peer rely-state interface command to enable a BGP peer to monitor the physical status of a specified physical interface. After the command is run, the BGP peer relationship is established only when the physical status of the physical interface is Up. If the physical status of a specified physical interface is Down, the peer relationship is disconnected.

Precautions

After the function of detecting the physical status of a physical interface is enabled for a BGP peer, the establishment of a BGP peer relationship depends on the physical status of the interface. If the physical status of the specified interface is Down, the BGP peer relationship cannot be established. Therefore, exercise caution when using this function.

Example

# Configure a peer to track the status of 10GE1/0/1.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-vpna] peer 2001:db8:1::1 as-number 100
[HUAWEI-bgp-instance-vpna] peer 2001:db8:1::1 rely-state interface 10GE 1/0/1

peer route-limit (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer group.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be received from a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name route-limit limit [ percentage ] [ alert-only | idle-forever | idle-timeout times ]

undo peer group-name route-limit

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the proportion threshold of the number of received routes to limit.

  • If the proportion reaches percentage and is less than 100%, the device sends a threshold-reaching alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and properly receives routes.
  • If the proportion reaches 100%, the device sends a threshold-crossing alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout times

Enables the device to send an alarm if the proportion of the number of received routes to limit reaches percentage. After the number of received routes exceeds the limit, the connection is interrupted, and the device does not automatically re-establish the connection until the timer expires.

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

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-limit command is used to set the maximum number of routes that a BGP device is allowed to receive from its peer group. This provides a mechanism for controlling the routes received from peer group in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from a peer group to 10000.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test route-limit 10000

peer route-limit (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be accepted from a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address route-limit limit [ percentage ] [ alert-only | idle-forever | idle-timeout times ]

undo peer ipv4-address route-limit

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the proportion threshold of the number of received routes to limit.

  • If the proportion reaches percentage and is less than 100%, the device sends a threshold-reaching alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and properly receives routes.
  • If the proportion reaches 100%, the device sends a threshold-crossing alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

Indicates that if the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout times

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device sends a threshold alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and the connection timeout timer is automatically reestablished. Before the timer expires, the device does not re-establish the connection.

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

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a routing table contains a large number of routes. To prevent excessive system resources from being consumed when a large number of routes are received from peers, you can run the peer route-limit command to set the maximum number of routes that a BGP device can receive from a peer. This provides a mechanism for controlling the routes received from peers in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from a peer to 10000
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 route-limit 10000

peer route-limit (BGP view) (group)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer group.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be received from a peer group.

Format

peer group-name route-limit [ accept-prefix ] limit [ percentage ] [ alert-only | idle-forever | idle-timeout minutes ]

undo peer group-name route-limit

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

accept-prefix

Indicates the number of routes that match the policy.

  • If accept-prefix is specified and the keep-all-routes command is run, only the routes that match the policy are counted in the maximum number of routes that can be received.
  • If accept-prefix is specified, routes are still received and take effect after the number of received routes exceeds the limit in the alert-only scenario.

-

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the percentage threshold of the number of received routes to the maximum number of routes that can be received.

  • If the actual percentage is greater than percentage and less than 100%, the device sends a threshold alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and can receive routes.
  • When the percentage reaches 100%, the device sends a threshold-crossing alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

Indicates that if the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout minutes

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device sends a threshold alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and the connection timeout timer is automatically reestablished. Before the timer expires, the device does not re-establish the connection.

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

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-limit command is used to set the maximum number of routes that a BGP device is allowed to receive from its peer group. This provides a mechanism for controlling the routes received from peer group in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from a peer group to 10000.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 100
[HUAWEI-bgp] peer 10.1.1.2 route-limit 10000

peer route-limit (BGP view)(IPv4)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be accepted from a peer.

Format

peer ipv4-address route-limit [ accept-prefix ] limit [ percentage ] [ alert-only | idle-forever | idle-timeout minutes ]

undo peer ipv4-address route-limit

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

accept-prefix

Indicates the number of routes that match the policy.

  • If accept-prefix is specified and the keep-all-routes command is run, only the routes that match the policy are counted in the maximum number of routes that can be received.
  • If accept-prefix is specified, routes are still received and take effect after the number of received routes exceeds the limit in the alert-only scenario.

-

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the percentage threshold of the number of received routes to the maximum number of routes that can be received.

  • If the actual percentage is greater than percentage and less than 100%, the device sends a threshold alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and can receive routes.
  • When the percentage reaches 100%, the device sends a threshold-crossing alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

Indicates that if the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout minutes

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device sends a threshold alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and the connection timeout timer is automatically reestablished. Before the timer expires, the device does not re-establish the connection.

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

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a routing table contains a large number of routes. To prevent excessive system resources from being consumed when a large number of routes are received from peers, you can run the peer route-limit command to set the maximum number of routes that a BGP device can receive from a peer. This provides a mechanism for controlling the routes received from peers in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from a peer to 10000
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] peer 10.1.1.2 route-limit 10000

peer route-limit (BGP-IPv4 unicast address family view)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be accepted from a peer.

Format

peer ipv4-address route-limit [ accept-prefix ] limit [ percentage ] [ alert-only | idle-forever | idle-timeout minutes ]

undo peer ipv4-address route-limit

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

accept-prefix

Indicates the number of routes that match the policy.

  • If accept-prefix is specified and the keep-all-routes command is run, only the routes that match the policy are counted in the maximum number of routes that can be received.
  • If accept-prefix is specified, routes are still received and take effect after the number of received routes exceeds the limit in the alert-only scenario.

-

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the percentage threshold of the number of received routes to the maximum number of routes that can be received.

  • If the actual percentage is greater than percentage and less than 100%, the device sends a threshold alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and can receive routes.
  • When the percentage reaches 100%, the device sends a threshold-crossing alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

Indicates that if the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout minutes

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device sends a threshold alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and the connection timeout timer is automatically reestablished. Before the timer expires, the device does not re-establish the connection.

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

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a routing table contains a large number of routes. To prevent excessive system resources from being consumed when a large number of routes are received from peers, you can run the peer route-limit command to set the maximum number of routes that a BGP device can receive from a peer. This provides a mechanism for controlling the routes received from peers in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from peers to 5000. When the number of routes received from peers exceeds 5000, BGP peer relationships are not disconnected and no more routes are received. Only an alarm is generated.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.2 route-limit 5000 alert-only
# Set the maximum number of routes that can be received from peers to 5000. When the number of received routes exceeds 80% of the maximum number, an alarm is generated. In addition, enable the device to disconnect BGP peer relationships when the number of routes exceeds 5000 and re-establish the relationships in 10 minutes.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.2 route-limit 5000 80 idle-timeout 10
# Set the maximum number of routes that can be received from peers to 5000. When the number of received routes exceeds 80% of the maximum number, an alarm is generated.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.2 route-limit 5000 80
# Set the maximum number of routes that can be received from a peer to 10000
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.2 route-limit 10000
# Set the maximum number of routes that can be received from peers to 5000 and disconnect BGP peer relationships when the number of received routes exceeds 5000.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.2 route-limit 5000 idle-forever

peer route-limit (BGP-IPv4 unicast address family view) (group)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer group.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be accepted from a peer.

Format

peer group-name route-limit [ accept-prefix ] limit [ percentage ] [ alert-only | idle-forever | idle-timeout minutes ]

undo peer group-name route-limit

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

accept-prefix

Specifies the number of routes that match a policy.

  • If accept-prefix is specified and the keep-all-routes command is run, only the routes that match the policy are counted into the maximum number of routes that can be accepted.
  • If accept-prefix and alert-only are both set, the system keeps receiving routes and the routes are valid after the proportion of the number of received routes to the limit reaches percentage or 100%.

-

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the proportion threshold of the number of received routes to limit.

  • If the proportion reaches percentage and is less than 100%, the device sends a threshold-reaching alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and properly receives routes.
  • If the proportion reaches 100%, the device sends a threshold-crossing alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout minutes

Enables the device to send an alarm if the proportion of the number of received routes to limit reaches percentage. After the number of received routes exceeds the limit, the connection is interrupted, and the device does not automatically re-establish the connection until the timer expires.

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

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-limit command is used to set the maximum number of routes that a BGP device is allowed to receive from its peer group. This provides a mechanism for controlling the routes received from peer group in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from a peer group to 10000.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test route-limit 10000

peer route-limit (BGP-IPv6 unicast address family view) (group)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer group.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be accepted from a peer.

Format

peer group-name route-limit [ accept-prefix ] limit [ percentage ] [ alert-only | idle-forever | idle-timeout times ]

undo peer group-name route-limit

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

accept-prefix

Specifies the number of routes that match a policy.

  • If accept-prefix is specified and the keep-all-routes command is run, only the routes that match the policy are counted into the maximum number of routes that can be accepted.
  • If accept-prefix and alert-only are both set, the system keeps receiving routes and the routes are valid after the proportion of the number of received routes to the limit reaches percentage or 100%.

-

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the percentage threshold of the number of received routes to the maximum number of routes that can be received.

  • If the actual percentage is greater than percentage and less than 100%, the device sends a threshold alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and can receive routes.
  • When the percentage reaches 100%, the device sends a threshold-crossing alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout times

Enables the device to send an alarm if the proportion of the number of received routes to limit reaches percentage. After the number of received routes exceeds the limit, the connection is interrupted, and the device does not automatically re-establish the connection until the timer expires.

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

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-limit command is used to set the maximum number of routes that a BGP device is allowed to receive from its peer group. This provides a mechanism for controlling the routes received from peer group in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from a peer group to 10000.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test route-limit 10000

peer route-limit (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be accepted from a peer.

Format

peer ipv6-address route-limit [ accept-prefix ] limit [ percentage ] [ alert-only | idle-forever | idle-timeout times ]

undo peer ipv6-address route-limit

Parameters

Parameter Description Value
ipv6-address

Specifies an IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

accept-prefix

Specifies the number of routes that match a policy.

  • If accept-prefix is specified and the keep-all-routes command is run, only the routes that match the policy are counted into the maximum number of routes that can be accepted.
  • If accept-prefix and alert-only are both set, the system keeps receiving routes and the routes are valid after the proportion of the number of received routes to the limit reaches percentage or 100%.

-

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the proportion threshold of the number of received routes to limit.

  • If the proportion reaches percentage and is less than 100%, the device sends a threshold-reaching alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and properly receives routes.
  • If the proportion reaches 100%, the device sends a threshold-crossing alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout times

Enables the device to send an alarm if the proportion of the number of received routes to limit reaches percentage. After the number of received routes exceeds the limit, the connection is interrupted, and the device does not automatically re-establish the connection until the timer expires.

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

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a routing table contains a large number of routes. To prevent excessive system resources from being consumed when a large number of routes are received from peers, you can run the peer route-limit command to set the maximum number of routes that a BGP device can receive from a peer. This provides a mechanism for controlling the routes received from peers in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from a peer to 10000
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 route-limit 10000

peer route-limit (BGP-IPv6 unicast address family view)(IPv4)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be received from a peer.

Format

peer ipv4-address route-limit [ accept-prefix ] limit [ percentage ] [ alert-only | idle-forever | idle-timeout times ]

undo peer ipv4-address route-limit

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

accept-prefix

Specifies the number of routes that match a policy.

  • If accept-prefix is specified and the keep-all-routes command is run, only the routes that match the policy are counted into the maximum number of routes that can be accepted.
  • If accept-prefix and alert-only are both set, the system keeps receiving routes and the routes are valid after the proportion of the number of received routes to the limit reaches percentage or 100%.

-

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the proportion threshold of the number of received routes to limit.

  • If the proportion reaches percentage and is less than 100%, the device sends a threshold-reaching alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and properly receives routes.
  • If the proportion reaches 100%, the device sends a threshold-crossing alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout times

Enables the device to send an alarm if the proportion of the number of received routes to limit reaches percentage. After the number of received routes exceeds the limit, the connection is interrupted, and the device does not automatically re-establish the connection until the timer expires.

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

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-limit command is used to set the maximum number of routes that a BGP device is allowed to receive from its peer. This provides a mechanism for controlling the routes received from peers in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from peers to 10000.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 route-limit 10000

peer route-limit (BGP-VPN instance IPv4 address family view) (group)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer group.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be accepted from a peer.

Format

peer group-name route-limit [ accept-prefix ] limit [ percentage ] [ alert-only | idle-forever | idle-timeout minutes ]

undo peer group-name route-limit

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

accept-prefix

Indicates the number of routes that match the policy.

  • If accept-prefix is specified and the keep-all-routes command is run, only the routes that match the policy are counted in the maximum number of routes that can be received.
  • If accept-prefix is specified, routes are still received and take effect after the number of received routes exceeds the limit in the alert-only scenario.

-

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the percentage threshold of the number of received routes to the maximum number of routes that can be received.

  • If the actual percentage is greater than percentage and less than 100%, the device sends a threshold alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and can receive routes.
  • When the percentage reaches 100%, the device sends a threshold-crossing alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

Indicates that if the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout minutes

Enables the device to send an alarm if the proportion of the number of received routes to limit reaches percentage. After the number of received routes exceeds the limit, the connection is interrupted, and the device does not automatically re-establish the connection until the timer expires.

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

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-limit command is used to set the maximum number of routes that a BGP device is allowed to receive from its peer group. This provides a mechanism for controlling the routes received from peer group in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from a peer group to 10000.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test route-limit 10000

peer route-limit (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be accepted from a peer.

Format

peer ipv4-address route-limit [ accept-prefix ] limit [ percentage ] [ alert-only | idle-forever | idle-timeout minutes ]

undo peer ipv4-address route-limit

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

accept-prefix

Specifies the number of routes that match a policy.

  • If accept-prefix is specified and the keep-all-routes command is run, only the routes that match the policy are counted into the maximum number of routes that can be accepted.
  • If accept-prefix and alert-only are both set, the system keeps receiving routes and the routes are valid after the proportion of the number of received routes to the limit reaches percentage or 100%.

-

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the proportion threshold of the number of received routes to limit.

  • If the proportion reaches percentage and is less than 100%, the device sends a threshold-reaching alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and properly receives routes.
  • If the proportion reaches 100%, the device sends a threshold-crossing alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout minutes

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device sends a threshold alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and the connection timeout timer is automatically reestablished. Before the timer expires, the device does not re-establish the connection.

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

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a routing table contains a large number of routes. To prevent excessive system resources from being consumed when a large number of routes are received from peers, you can run the peer route-limit command to set the maximum number of routes that a BGP device can receive from a peer. This provides a mechanism for controlling the routes received from peers in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from a peer to 10000
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-vpna] peer 10.1.1.2 route-limit 10000

peer route-limit (BGP-VPN instance IPv6 address family view) (group)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer group.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be received from a peer.

Format

peer group-name route-limit [ accept-prefix ] limit [ percentage ] [ alert-only | idle-forever | idle-timeout times ]

undo peer group-name route-limit

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

accept-prefix

Specifies the number of routes that match a policy.

  • If accept-prefix is specified and the keep-all-routes command is run, only the routes that match the policy are counted into the maximum number of routes that can be accepted.
  • If accept-prefix and alert-only are both set, the system keeps receiving routes and the routes are valid after the proportion of the number of received routes to the limit reaches percentage or 100%.

-

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the proportion threshold of the number of received routes to limit.

  • If the proportion reaches percentage and is less than 100%, the device sends a threshold-reaching alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and properly receives routes.
  • If the proportion reaches 100%, the device sends a threshold-crossing alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout times

Enables the device to send an alarm if the proportion of the number of received routes to limit reaches percentage. After the number of received routes exceeds the limit, the connection is interrupted, and the device does not automatically re-establish the connection until the timer expires.

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

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-limit command is used to set the maximum number of routes that a BGP device is allowed to receive from its peer group. This provides a mechanism for controlling the routes received from peer group in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from a peer group to 10000.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test route-limit 10000

peer route-limit (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be received from a peer.

Format

peer ipv6-address route-limit [ accept-prefix ] limit [ percentage ] [ alert-only | idle-forever | idle-timeout times ]

undo peer ipv6-address route-limit

Parameters

Parameter Description Value
ipv6-address

Specifies an IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

accept-prefix

Specifies the number of routes that match a policy.

  • If accept-prefix is specified and the keep-all-routes command is run, only the routes that match the policy are counted into the maximum number of routes that can be accepted.
  • If accept-prefix and alert-only are both set, the system keeps receiving routes and the routes are valid after the proportion of the number of received routes to the limit reaches percentage or 100%.

-

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the proportion threshold of the number of received routes to limit.

  • If the proportion reaches percentage and is less than 100%, the device sends a threshold-reaching alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and properly receives routes.
  • If the proportion reaches 100%, the device sends a threshold-crossing alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout times

Enables the device to send an alarm if the proportion of the number of received routes to limit reaches percentage. After the number of received routes exceeds the limit, the connection is interrupted, and the device does not automatically re-establish the connection until the timer expires.

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

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-limit command is used to set the maximum number of routes that a BGP device is allowed to receive from its peer. This provides a mechanism for controlling the routes received from peers in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from peers to 10000.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 route-limit 10000

peer route-limit (BGP-VPN instance IPv6 address family view)(IPv4)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be received from a peer.

Format

peer ipv4-address route-limit [ accept-prefix ] limit [ percentage ] [ alert-only | idle-forever | idle-timeout times ]

undo peer ipv4-address route-limit

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

accept-prefix

Specifies the number of routes that match a policy.

  • If accept-prefix is specified and the keep-all-routes command is run, only the routes that match the policy are counted into the maximum number of routes that can be accepted.
  • If accept-prefix and alert-only are both set, the system keeps receiving routes and the routes are valid after the proportion of the number of received routes to the limit reaches percentage or 100%.

-

limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the proportion threshold of the number of received routes to limit.

  • If the proportion reaches percentage and is less than 100%, the device sends a threshold-reaching alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and properly receives routes.
  • If the proportion reaches 100%, the device sends a threshold-crossing alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout times

Enables the device to send an alarm if the proportion of the number of received routes to limit reaches percentage. After the number of received routes exceeds the limit, the connection is interrupted, and the device does not automatically re-establish the connection until the timer expires.

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

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-limit command is used to set the maximum number of routes that a BGP device is allowed to receive from its peer. This provides a mechanism for controlling the routes received from peers in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from peers to 10000.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 route-limit 10000

peer route-limit(BGP multi-instance VPN instance IPv6 address family view)(group)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer group.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be accepted from a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerGroupName route-limit limit [ percentage ] [ alert-only | idle-forever | idle-timeout times ]

undo peer peerGroupName route-limit

Parameters

Parameter Description Value
route-limit limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the percentage threshold of the number of received routes to the maximum number of routes that can be received.

  • If the actual percentage is greater than percentage and less than 100%, the device sends a threshold alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and can receive routes.
  • When the percentage reaches 100%, the device sends a threshold-crossing alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

Indicates that if the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout times

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device sends a threshold alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and the connection timeout timer is automatically reestablished. Before the timer expires, the device does not re-establish the connection.

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

peer peerGroupName

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-limit command is used to set the maximum number of routes that a BGP device is allowed to receive from its peer group. This provides a mechanism for controlling the routes received from peer group in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from a peer group to 10000.
<pe> system-view
[~pe] ip vpn-instance vpna
[*pe-vpn-instance-vpna] ipv6-family
[*pe-vpn-instance-vpna-af-ipv6] quit
[*pe-vpn-instance-vpna] quit
[*pe] bgp 100 instance a
[*pe-bgp-instance-a] ipv6-family vpn-instance vpna
[*pe-bgp-instance-a-6-vpna] group b
[*pe-bgp-instance-a-6-vpna] peer b route-limit 10000

peer route-limit(BGP multi-instance VPN instance IPv6 address family view)(IPv6)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer.

The undo peer route-limit command restores the default setting.

By default, there is no limit on the number of routes that can be accepted from a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv6Addr route-limit limit [ percentage ] [ alert-only | idle-forever | idle-timeout times ]

undo peer peerIpv6Addr route-limit

Parameters

Parameter Description Value
route-limit limit

Specifies the maximum number of routes that can be received from a peer.

The value is an integer ranging from 1 to 4294967295.

percentage

Specifies the percentage threshold of the number of received routes to the maximum number of routes that can be received.

  • If the actual percentage is greater than percentage and less than 100%, the device sends a threshold alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and can receive routes.
  • When the percentage reaches 100%, the device sends a threshold-crossing alarm BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.

The value is an integer ranging from 1 to 100. The default value is 75.

alert-only

Enables the device to send a threshold alarm or limit-exceeding alarm and stop accepting excess routes if accept-prefix is not specified and the percentage of the number of received routes to the maximum number of routes that can be accepted reaches 100%. In this case, the peer relationship is not disconnected.

-

idle-forever

Indicates that if the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device reports an alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and will not be automatically re-established.

-

idle-timeout times

If the percentage of the number of received routes to the maximum number of routes that can be received is greater than percentage, the device sends a threshold alarm. After the number of received routes exceeds the threshold, the peer relationship is disconnected and the connection timeout timer is automatically reestablished. Before the timer expires, the device does not re-establish the connection.

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

peer peerIpv6Addr

Specifies an IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP multi-instance VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a routing table contains a large number of routes. To prevent excessive system resources from being consumed when a large number of routes are received from peers, you can run the peer route-limit command to set the maximum number of routes that a BGP device can receive from a peer. This provides a mechanism for controlling the routes received from peers in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

When the peer relationship between peers is Established:

  • If the peer route-limit command is run for the first time or the upper limit is reduced and the number of routes received by the device exceeds the upper limit:
  • If alert-only is specified in the command, the peer relationship is not interrupted and the received routes are not withdrawn, and for the new routes that are received, the system performs limit-exceeding processing.
  • If idle-forever is specified in the command, the local device terminates the connection with its peer. To reestablish the connection, run the reset bgp command.
  • If idle-timeout is specified in the command, the local device terminates the connection with its peer and starts the timer for automatic connection re-establishment. To re-establish the connection before the timer expires, you can run the reset bgp command.
  • If the upper limit is increased to a value greater than the number of received routes, the device sends Refresh messages to receive routes again. If the device does not support the route-refresh capability, the device reestablishes the connection.
  • If the upper limit is reduced but is still greater than the number of received routes, the device only changes the configuration parameter.

    If alert-only, idle-forever, or idle-timeout is not configured and the percentage of the number of received routes to the maximum number of routes that can be accepted is greater than the specified percentage, the device sends a threshold alarm. When the number of received routes exceeds the limit, the peer relationship is interrupted. After 30 seconds, the system automatically attempts to reestablish the peer relationship.
  • If the upper limit remains unchanged, the device only changes the configuration parameter.
  • If accept-prefix is specified, the device continues to accept excess routes in the alert-only scenario, and all received routes are valid. If accept-prefix is not specified in the alert-only scenario, the device only sends the threshold alarm or limit-exceeding alarm and does not accept excess routes. In this case, the peer relationship is not disconnected.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from a peer to 10000
<pe> system-view
[~pe] ip vpn-instance vpna
[*pe-vpn-instance-vpna] ipv6-family
[*pe-vpn-instance-vpna-af-ipv6] quit
[*pe-vpn-instance-vpna] quit
[*pe] bgp 100 instance a
[*pe-bgp-instance-a] ipv6-family vpn-instance vpna
[*pe-bgp-instance-a-6-vpna] peer 2001:DB8:1::1 as-number 100
[*pe-bgp-instance-a-6-vpna] peer 2001:DB8:1::1 route-limit 10000

peer route-policy export (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer route-policy export command specifies a route-policy for filtering routes to be advertised to a peer.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for the routes to be advertised to a specified peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address route-policy route-policy-name export

undo peer ipv4-address route-policy route-policy-name export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

export

Applies a route-policy to the routes to be advertised to a peer.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-policy export command is used to apply a created route-policy to a peer so that the routes advertised to the peer can be controlled. To be specific, only the necessary routes are advertised to the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If a route-policy is specified for a peer group, all the peers in the peer group inherit the configuration.

After a BGP peer relationship is established and a route-policy is bound to the BGP peer relationship, peer flapping may occur.

Example

# Apply a route-policy named test-policy to routes to be advertised to a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 route-policy test-policy export

peer route-policy export (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer route-policy export command specifies a route-policy for filtering routes to be advertised to a peer group.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for the routes to be advertised to a specified BGP peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name route-policy route-policy-name export

undo peer group-name route-policy route-policy-name export

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

export

Applies a route-policy to routes to be advertised to a peer group.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy export command is used to apply a Route-Policy to a peer group so that the routes advertised to a peer group can be controlled. To be specific, only the necessary routes are advertised to the peer group. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If the command specifies a route-policy that does not exist, use the route-policy command to create the route-policy.

Configuration Impact

If the peer route-policy command is run for a peer group, all the members of the peer group inherit the configuration.

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply a route-policy to routes to be advertised to a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test route-policy test-policy export

peer route-policy export (BGP view)

Function

The peer route-policy export command specifies a route-policy for filtering routes to be advertised to a peer.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for the routes to be advertised to a specified BGP peer.

Format

peer ipv4-address route-policy route-policy-name export

undo peer ipv4-address route-policy route-policy-name export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

route-policy-name

Specifies the name of a route-policy.

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

export

Applies a route-policy to the routes to be advertised to a peer.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy export command is used to apply a Route-Policy to a peer so that the routes advertised to the peer can be controlled. To be specific, only the necessary routes are advertised to the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If the command specifies a route-policy that does not exist, use the route-policy command to create the route-policy.

Configuration Impact

If a route-policy is specified for a peer group, all the peers in the peer group inherit the configuration.

After a BGP peer relationship is established and a route-policy is bound to the BGP peer relationship, peer flapping may occur.

Example

# Apply a route-policy named test-policy to routes to be advertised to a peer.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 route-policy test-policy export

peer route-policy export (BGP view) (group)

Function

The peer route-policy export command specifies a route-policy for the routes to be advertised to a peer group.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes to be advertised to a peer group.

Format

peer group-name route-policy route-policy-name export

undo peer group-name route-policy route-policy-name export

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

export

Applies a route-policy to routes to be advertised to a peer group.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy export command is used to apply a Route-Policy to a peer group so that the routes advertised to a peer group can be controlled. To be specific, only the necessary routes are advertised to the peer group. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If the peer route-policy command is run for a peer group, all the members of the peer group inherit the configuration.

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply a route-policy to routes to be advertised to peers in a peer group.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer test route-policy test-policy export

peer route-policy export (BGP-IPv4 unicast address family view)

Function

The peer route-policy export command specifies a route-policy for filtering routes to be advertised to a peer.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for the routes to be advertised to a specified peer.

Format

peer ipv4-address route-policy route-policy-name export

undo peer ipv4-address route-policy route-policy-name export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

export

Applies the route-policy to the routes to be advertised to a peer.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-policy export command is used to apply a created route-policy to a peer so that the routes advertised to the peer can be controlled. To be specific, only the necessary routes are advertised to the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If a route-policy is specified for a peer group, all the peers in the peer group inherit the configuration.

After a BGP peer relationship is established and a route-policy is bound to the BGP peer relationship, peer flapping may occur.

Example

# Apply a route-policy named test-policy to routes to be advertised to a peer.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.2 route-policy test-policy export

peer route-policy export (BGP-IPv4 unicast address family view) (group)

Function

The peer route-policy export command specifies a route-policy for the routes to be advertised to a peer group.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes to be advertised to a peer group.

Format

peer group-name route-policy route-policy-name export

undo peer group-name route-policy route-policy-name export

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

export

Applies a route-policy to routes to be advertised to a peer group.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy export command is used to apply a Route-Policy to a peer group so that the routes advertised to a peer group can be controlled. To be specific, only the necessary routes are advertised to the peer group. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If a route-policy is specified for a peer group, all the peers in the peer group inherit the configuration.

After a BGP peer relationship is established and a route-policy is bound to the BGP peer relationship, peer flapping may occur.

Example

# Apply a route-policy to the routes to be advertised to a peer.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test route-policy test-policy export

peer route-policy export (BGP-IPv6 unicast address family view)

Function

The peer route-policy export command specifies a route-policy for filtering routes to be advertised to a peer.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for the routes to be advertised to a specified peer.

Format

peer ipv4-address route-policy route-policy-name export

undo peer ipv4-address route-policy route-policy-name export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

export

Applies the route-policy to the routes to be advertised to a peer.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-policy export command is used to apply a created route-policy to a peer so that the routes advertised to the peer can be controlled. To be specific, only the necessary routes are advertised to the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If the peer route-policy command is run for a peer group, all the members of the peer group inherit the configuration.

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply a route-policy named test-policy to routes to be advertised to a peer.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 route-policy test-policy export

peer route-policy export (BGP-IPv6 unicast address family view) (group)

Function

The peer route-policy export command specifies a route-policy for the routes to be advertised to a peer group.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes to be advertised to a peer group.

Format

peer group-name route-policy route-policy-name export

undo peer group-name route-policy route-policy-name export

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

export

Applies a route-policy to routes to be advertised to a peer group.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy export command is used to apply a Route-Policy to a peer group so that the routes advertised to a peer group can be controlled. To be specific, only the necessary routes are advertised to the peer group. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If the peer route-policy command is run for a peer group, all the members of the peer group inherit the configuration.

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply a route-policy to the routes to be advertised to a peer.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test route-policy test-policy export

peer route-policy export (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer route-policy export command specifies a route-policy for filtering routes to be advertised to a peer.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for the routes to be advertised to a specified peer.

Format

peer ipv6-address route-policy route-policy-name export

undo peer ipv6-address route-policy route-policy-name export

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

export

Applies the route-policy to the routes to be advertised to a peer.

-

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-policy export command is used to apply a created route-policy to a peer so that the routes advertised to the peer can be controlled. To be specific, only the necessary routes are advertised to the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If the peer route-policy command is run for a peer group, all the members of the peer group inherit the configuration.

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply a route-policy named test-policy to routes to be advertised to a peer.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 1::1 enable
[HUAWEI-bgp-af-ipv6] peer 1::1 route-policy test-policy export

peer route-policy export (BGP-VPN instance IPv4 address family view)

Function

The peer route-policy export command specifies a route-policy for filtering routes to be advertised to a peer.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for the routes to be advertised to a specified peer.

Format

peer ipv4-address route-policy route-policy-name export

undo peer ipv4-address route-policy route-policy-name export

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

export

Applies a route-policy to the routes to be advertised to a peer.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-policy export command is used to apply a created route-policy to a peer so that the routes advertised to the peer can be controlled. To be specific, only the necessary routes are advertised to the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If the peer route-policy command is run for a peer group, all the members of the peer group inherit the configuration.

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply a route-policy named test-policy to routes to be advertised to a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 1.1.1.1 route-policy test-policy export

peer route-policy export (BGP-VPN instance IPv4 address family view) (group)

Function

The peer route-policy export command specifies a route-policy for the routes to be advertised to a peer group.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes to be advertised to a peer group.

Format

peer group-name route-policy route-policy-name export

undo peer group-name route-policy route-policy-name export

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

export

Applies a route-policy to routes to be advertised to a peer group.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy export command is used to apply a Route-Policy to a peer group so that the routes advertised to a peer group can be controlled. To be specific, only the necessary routes are advertised to the peer group. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If a route-policy is specified for a peer group, all the peers in the peer group inherit the configuration.

After a BGP peer relationship is established and a route-policy is bound to the BGP peer relationship, peer flapping may occur.

Example

# Apply a route-policy to the routes to be advertised to a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test route-policy test-policy export

peer route-policy export (BGP-VPN instance IPv6 address family view)

Function

The peer route-policy export command specifies a route-policy for filtering routes to be advertised to a peer.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for the routes to be advertised to a specified BGP peer.

Format

peer ipv4-address route-policy route-policy-name export

undo peer ipv4-address route-policy route-policy-name export

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

export

Applies a route-policy to routes to be advertised to a peer.

-

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy export command is used to apply a Route-Policy to a peer so that the routes advertised to the peer can be controlled. To be specific, only the necessary routes are advertised to the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If the command specifies a route-policy that does not exist, use the route-policy command to create the route-policy.

Configuration Impact

If this command is run for a peer group, all the members of the peer group inherit the configuration.

If both the peer route-filter and peer route-filter commands are run, the latest configuration overrides the previous one.

After a BGP peer relationship is established and a route-policy is bound to the BGP peer relationship, peer flapping may occur.

Example

# Apply a route-policy named test-policy to routes to be advertised to a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 route-policy test-policy export

peer route-policy export (BGP-VPN instance IPv6 address family view) (group)

Function

The peer route-policy export command specifies a route-policy for filtering routes to be advertised to a peer group.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for the routes to be advertised to a specified BGP peer group.

Format

peer group-name route-policy route-policy-name export

undo peer group-name route-policy route-policy-name export

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

route-policy-name

Specifies the name of a route-policy.

The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

export

Applies a route-policy to the routes to be advertised to a peer group.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy export command is used to apply a Route-Policy to a peer group so that the routes advertised to a peer group can be controlled. To be specific, only the necessary routes are advertised to the peer group. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If a route-policy is specified for a peer group, all the peers in the peer group inherit the configuration.

After a BGP peer relationship is established and a route-policy is bound to the BGP peer relationship, peer flapping may occur.

Example

# Apply a route-policy to the routes to be advertised to a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test route-policy test-policy export

peer route-policy export (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer route-policy export command specifies a route-policy for filtering routes to be advertised to a peer.

The undo peer route-policy export command deletes a specified route-policy.

By default, no route-policy is configured for the routes to be advertised to a specified peer.

Format

peer ipv6-address route-policy route-policy-name export

undo peer ipv6-address route-policy route-policy-name export

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

route-policy-name

Specifies the name of a route-policy.

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

export

Applies a route-policy to the routes to be advertised to a peer.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The peer route-policy export command is used to apply a created route-policy to a peer so that the routes advertised to the peer can be controlled. To be specific, only the necessary routes are advertised to the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If the peer route-policy command is run for a peer group, all the members of the peer group inherit the configuration.

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply a route-policy named test-policy to routes to be advertised to a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 route-policy test-policy export

peer route-policy import (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer route-policy import command specifies a route-policy for filtering routes received from a peer group.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes received from a peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name route-policy route-policy-name import

undo peer group-name route-policy route-policy-name import

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. If spaces are used, the string must start and end with double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer group so that the routes received from a peer group can be controlled. To be specific, only the necessary routes are received from the peer group. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If the command specifies a route-policy that does not exist, use the route-policy command to create the route-policy.

Configuration Impact

If the peer route-policy command is run for a peer group, all the members of the peer group inherit the configuration.

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply the route-policy named test-policy to the routes received from a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test route-policy test-policy import

peer route-policy import (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer route-policy import command specifies a route-policy for filtering routes received from a peer.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes received from a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address route-policy route-policy-name import

undo peer ipv4-address route-policy route-policy-name import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer so that the routes received from the peer can be controlled. To be specific, only the necessary routes are received from the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If the command specifies a route-policy that does not exist, use the route-policy command to create the route-policy.

Configuration Impact

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply the route-policy named test-policy to the routes received from a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 route-policy test-policy import

peer route-policy import (BGP view) (group)

Function

The peer route-policy import command specifies a route-policy for routes received from a peer group.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is specified for a peer group. That is, no route-policy is applied to the routes to be received from peers.

Format

peer group-name route-policy route-policy-name import

undo peer group-name route-policy route-policy-name import

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer group so that the routes received from a peer group can be controlled. To be specific, only the necessary routes are received from the peer group. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If the peer route-policy command is run for a peer group, all the members of the peer group inherit the configuration.

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply the route-policy named test-policy to the routes received from a peer group.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer test route-policy test-policy import

peer route-policy import (BGP view)(IPv4)

Function

The peer route-policy import command specifies a route-policy for filtering routes received from a peer.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes received from a peer.

Format

peer ipv4-address route-policy route-policy-name import

undo peer ipv4-address route-policy route-policy-name import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer so that the routes received from the peer can be controlled. To be specific, only the necessary routes are received from the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply the route-policy named test-policy to the routes received from a peer.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 route-policy test-policy import

peer route-policy import (BGP-IPv4 unicast address family view) (group)

Function

The peer route-policy import command specifies a route-policy for routes received from a peer group.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is specified for a peer group. That is, no route-policy is applied to the routes to be received from peers.

Format

peer group-name route-policy route-policy-name import

undo peer group-name route-policy route-policy-name import

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer group so that the routes received from a peer group can be controlled. To be specific, only the necessary routes are received from the peer group. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If a route-policy is specified for a peer group, all the peers in the peer group inherit the configuration.

After a BGP peer relationship is established and a route-policy is bound to the BGP peer relationship, peer flapping may occur.

Example

# Apply the route-policy named test-policy to the routes received from a peer group.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test route-policy test-policy import

peer route-policy import (BGP-IPv4 unicast address family view)(IPv4)

Function

The peer route-policy import command specifies a route-policy for filtering routes received from a peer.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes received from a peer.

Format

peer ipv4-address route-policy route-policy-name import

undo peer ipv4-address route-policy route-policy-name import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer so that the routes received from the peer can be controlled. To be specific, only the necessary routes are received from the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply the route-policy named test-policy to the routes received from a peer.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.2 route-policy test-policy import

peer route-policy import (BGP-IPv6 unicast address family view) (group)

Function

The peer route-policy import command specifies a route-policy for routes received from a peer group.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is specified for a peer group. That is, no route-policy is applied to the routes to be received from peers.

Format

peer group-name route-policy route-policy-name import

undo peer group-name route-policy route-policy-name import

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer group so that the routes received from a peer group can be controlled. To be specific, only the necessary routes are received from the peer group. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If the peer route-policy command is run for a peer group, all the members of the peer group inherit the configuration.

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply the route-policy named test-policy to the routes received from a peer group.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test route-policy test-policy import

peer route-policy import (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer route-policy import command specifies a route-policy for filtering routes received from a peer.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes received from a peer.

Format

peer ipv6-address route-policy route-policy-name import

undo peer ipv6-address route-policy route-policy-name import

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer so that the routes received from the peer can be controlled. To be specific, only the necessary routes are received from the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

After a BGP peer relationship is established and a route-policy is bound to the BGP peer relationship, peer flapping may occur.

Example

# Apply the route-policy named test-policy to the routes received from a peer.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 route-policy test-policy import

peer route-policy import (BGP-IPv6 unicast address family view)(IPv4)

Function

The peer route-policy import command specifies a route-policy for filtering routes received from a peer.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes received from a peer.

Format

peer ipv4-address route-policy route-policy-name import

undo peer ipv4-address route-policy route-policy-name import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

route-policy-name

Specifies the name of a route-policy.

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

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer so that the routes received from the peer can be controlled. To be specific, only the necessary routes are received from the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

After a BGP peer relationship is established and a route-policy is bound to the BGP peer relationship, peer flapping may occur.

Example

# Apply the route-policy named test-policy to the routes received from a peer.
<HUAWEI> system-view
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 route-policy test-policy import

peer route-policy import (BGP-VPN instance IPv4 address family view) (group)

Function

The peer route-policy import command specifies a route-policy for routes received from a peer group.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is specified for a peer group. That is, no route-policy is applied to the routes to be received from peers.

Format

peer group-name route-policy route-policy-name import

undo peer group-name route-policy route-policy-name import

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters. It cannot contain spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer group so that the routes received from a peer group can be controlled. To be specific, only the necessary routes are received from the peer group. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

If a route-policy is specified for a peer group, all the peers in the peer group inherit the configuration.

After a BGP peer relationship is established and a route-policy is bound to the BGP peer relationship, peer flapping may occur.

Example

# Apply the route-policy named test-policy to the routes received from a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test route-policy test-policy import

peer route-policy import (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer route-policy import command specifies a route-policy for filtering routes received from a peer.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes received from a peer.

Format

peer ipv4-address route-policy route-policy-name import

undo peer ipv4-address route-policy route-policy-name import

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer so that the routes received from the peer can be controlled. To be specific, only the necessary routes are received from the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply the route-policy named test-policy to the routes received from a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 10.1.1.1 route-policy test-policy import

peer route-policy import (BGP-VPN instance IPv6 address family view) (group)

Function

The peer route-policy import command specifies a route-policy for filtering routes received from a peer group.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes received from a peer group.

Format

peer group-name route-policy route-policy-name import

undo peer group-name route-policy route-policy-name import

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

route-policy-name

Specifies the name of a route-policy.

The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer group so that the routes received from a peer group can be controlled. To be specific, only the necessary routes are received from the peer group. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If the command specifies a route-policy that does not exist, use the route-policy command to create the route-policy.

Configuration Impact

If the peer route-policy command is run for a peer group, all the members of the peer group inherit the configuration.

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply the route-policy named test-policy to the routes received from a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test route-policy test-policy import

peer route-policy import (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer route-policy import command specifies a route-policy for filtering routes received from a peer.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes received from a peer.

Format

peer ipv6-address route-policy route-policy-name import

undo peer ipv6-address route-policy route-policy-name import

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

route-policy-name

Specifies the name of a routing policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer so that the routes received from the peer can be controlled. To be specific, only the necessary routes are received from the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If a route-policy that does not exist is specified in the command, use the route-policy command to create the route-policy.

Configuration Impact

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply the route-policy named test-policy to the routes received from a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 route-policy test-policy import

peer route-policy import (BGP-VPN instance IPv6 address family view)(IPv4)

Function

The peer route-policy import command specifies a route-policy for filtering routes received from a peer.

The undo peer route-policy import command deletes a specified route-policy.

By default, no route-policy is configured for filtering routes received from a peer.

Format

peer ipv4-address route-policy route-policy-name import

undo peer ipv4-address route-policy route-policy-name import

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

route-policy-name

Specifies the name of a route-policy.

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

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a route-policy is created, the peer route-policy import command is used to apply a Route-Policy to a peer so that the routes received from the peer can be controlled. To be specific, only the necessary routes are received from the peer. In this manner, route management is implemented, the scale of the routing table is reduced, and fewer network resources are consumed.

Prerequisites

If the command specifies a route-policy that does not exist, use the route-policy command to create the route-policy.

Configuration Impact

If the peer route-policy command is run for a peer group, all the members of the peer group inherit the configuration.

The peer route-policy command is mutually exclusive with the peer route-filter commands.

Binding a route-policy after a BGP peer relationship is established may cause peer flapping.

Example

# Apply the route-policy named test-policy to the routes received from a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] route-policy test-policy permit node 10
[HUAWEI-route-policy] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 route-policy test-policy import

peer route-priority-track interface (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer route-priority-track interface command configures BGP to detect the status changes of an Eth-Trunk interface connected to a specified peer and adjust the priority of BGP routes received from the peer accordingly.

The undo peer route-priority-track interface command restores the default configuration.

By default, BGP does not detect the status changes of an Eth-Trunk interface connected to a peer or adjust the priority of BGP routes received from a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr route-priority-track interface { interface-name | localIfType localIfNum }

undo peer peerIpv4Addr route-priority-track interface { interface-name | localIfType localIfNum }

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

interface-name

Specifies the name of an interface.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

localIfType

Specifies the type of an interface.

-

localIfNum

Specifies an interface number.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run this command to configure BGP to detect the Eth-Trunk interface fault and change the priority of the routes received from the peer to the lowest (by setting the MED to the maximum value and the Local_Pref to the minimum value).

Precautions

A maximum of four Eth-Trunk interfaces can be specified for each BGP peer.

The peer route-priority-track interface command takes precedence over the peer route-policy or peer route-filter command. If the peer route-priority-track interface command and either of the other commands are both run, the peer route-priority-track interface command takes effect if a link fault occurs.

Example

# Configure BGP to detect the status changes of an Eth-Trunk interface connected to a specified peer and adjust the priority of BGP routes received from the peer accordingly.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance v1
[HUAWEI-vpn-instance-v1] ipv4-family
[HUAWEI-vpn-instance-v1-af-ipv4] quit
[HUAWEI-vpn-instance-v1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance v1
[HUAWEI-bgp-instance-a-v1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-instance-a-v1] peer 10.1.1.2 route-priority-track interface Eth-Trunk 0

peer route-priority-track interface (BGP-IPv4 unicast address family view)

Function

The peer route-priority-track interface command configures BGP to detect the status changes of an Eth-Trunk interface connected to a specified peer and adjust the priority of BGP routes received from the peer accordingly.

The undo peer route-priority-track interface command restores the default configuration.

By default, BGP does not detect the status changes of an Eth-Trunk interface connected to a peer or adjust the priority of BGP routes received from a peer.

Format

peer peerIpv4Addr route-priority-track interface { interface-name | localIfType localIfNum }

undo peer peerIpv4Addr route-priority-track interface { interface-name | localIfType localIfNum }

Parameters

Parameter Description Value
peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

interface

Specifies the name of an interface.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

interface-name

Specifies the type of an interface.

-

localIfType

Specifies the type of an interface.

-

localIfNum

Specifies an interface number.

-

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run this command to configure BGP to detect the Eth-Trunk interface fault and change the priority of the routes received from the peer to the lowest (by setting the MED to the maximum value and the Local_Pref to the minimum value).

Precautions

A maximum of four Eth-Trunk interfaces can be specified for each BGP peer.

The peer route-priority-track interface command takes precedence over the peer route-policy or peer route-filter command. If the peer route-priority-track interface command and either of the other commands are both run, the peer route-priority-track interface command takes effect if a link fault occurs.

Example

# Configure BGP to detect the status changes of an Eth-Trunk interface connected to a specified peer and adjust the priority of BGP routes received from the peer accordingly.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.2 route-priority-track interface Eth-Trunk 0

peer route-priority-track interface (BGP-IPv6 unicast address family view)

Function

The peer route-priority-track interface command configures BGP to detect the status of an Eth-Trunk interface and adjust the route preference.

The undo peer route-priority-track interface command restores the default configuration.

By default, BGP does not detect the status changes of an Eth-Trunk interface connected to a peer or adjust the priority of BGP routes received from a peer.

Format

peer { peerIpv6Addr } route-priority-track interface { interface-name | localIfType localIfNum }

undo peer { peerIpv6Addr } route-priority-track interface { interface-name | localIfType localIfNum }

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

interface-name

Specifies the name of an interface.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

localIfType

Specifies the type of an interface.

-

localIfNum

Specifies an interface number.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run this command to configure BGP to detect the Eth-Trunk interface fault and change the priority of the routes received from the peer to the lowest (by setting the MED to the maximum value and the Local_Pref to the minimum value).

Precautions

A maximum of four Eth-Trunk interfaces can be specified for each BGP peer.

The peer route-priority-track interface command takes precedence over the peer route-policy or peer route-filter command. If the peer route-priority-track interface command and either of the other commands are both run, the peer route-priority-track interface command takes effect if a link fault occurs.

Example

# Configure BGP to detect the status changes of an Eth-Trunk interface connected to a specified peer and adjust the priority of BGP routes received from the peer accordingly.
<HUAWEI> system-view
[HUAWEI] interface Eth-Trunk 0
[HUAWEI-Eth-Trunk0] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 route-priority-track interface Eth-Trunk 0

peer route-priority-track interface (BGP-VPN instance IPv4 address family view)

Function

The peer route-priority-track interface command configures BGP to detect the status changes of an Eth-Trunk interface connected to a specified peer and adjust the priority of BGP routes received from the peer accordingly.

The undo peer route-priority-track interface command restores the default configuration.

By default, BGP does not detect the status changes of an Eth-Trunk interface connected to a peer or adjust the priority of BGP routes received from a peer.

Format

peer peerIpv4Addr route-priority-track interface { interface-name | localIfType localIfNum }

undo peer peerIpv4Addr route-priority-track interface { interface-name | localIfType localIfNum }

Parameters

Parameter Description Value
peerIpv4Addr

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

interface-name

Specifies the name of an interface.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

localIfType

Specifies the type of an interface.

-

localIfNum

Specifies the number of an interface.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer route-priority-track interface command to configure BGP to detect the Eth-Trunk interface fault and change the priority of the routes received from the peer to the lowest (by setting the MED to the maximum value and the Local_Pref to the minimum value).

Precautions

A maximum of four Eth-Trunk interfaces can be specified for each BGP peer.

The peer route-priority-track interface command takes precedence over the peer route-policy or peer route-filter command. If the peer route-priority-track interface command and either of the other commands are both run, the peer route-priority-track interface command takes effect if a link fault occurs.

Example

# Configure BGP to detect the status changes of an Eth-Trunk interface connected to a specified peer and adjust the priority of BGP routes received from the peer accordingly.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] q
[HUAWEI-vpn-instance-vpn1] q
[HUAWEI] interface Eth-Trunk 0
[HUAWEI-Eth-Trunk0] q
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.2 route-priority-track interface Eth-Trunk 0

peer route-priority-track interface (BGP-VPN instance IPv6 address family view)

Function

The peer route-priority-track interface command configures BGP to detect the status changes of an Eth-Trunk interface connected to a specified peer and adjust the priority of BGP routes received from the peer accordingly.

The undo peer route-priority-track interface command restores the default configuration.

By default, BGP does not detect the status changes of an Eth-Trunk interface connected to a peer or adjust the priority of BGP routes received from a peer.

Format

peer peerIpv6Addr route-priority-track interface { interface-name | localIfType localIfNum }

undo peer peerIpv6Addr route-priority-track interface { interface-name | localIfType localIfNum }

Parameters

Parameter Description Value
peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.

interface-name

Specifies the name of an interface.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

localIfType

Specifies an interface type.

-

localIfNum

Specifies the number of an interface.

The value is a string of 1 to 63 case-sensitive characters. It cannot contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer route-priority-track interface command to configure BGP to detect the Eth-Trunk interface fault and change the priority of the routes received from the peer to the lowest (by setting the MED to the maximum value and the Local_Pref to the minimum value).

Precautions

A maximum of four Eth-Trunk interfaces can be specified for each BGP peer.

The peer route-priority-track interface command takes precedence over the peer route-policy or peer route-filter command. If the peer route-priority-track interface command and either of the other commands are both run, the peer route-priority-track interface command takes effect if a link fault occurs.

Example

# Configure BGP to detect the status changes of an Eth-Trunk interface connected to a specified peer and adjust the priority of BGP routes received from the peer accordingly.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 route-priority-track interface Eth-Trunk 0

peer route-update-interval (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer group.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name route-update-interval interval

undo peer group-name route-update-interval

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

interval

Specifies the minimum interval at which BGP routing updates are sent.

The value is an integer that ranges from 0 to 600, in seconds. The value 0 indicates that the device immediately sends a BGP Update message to notify the peer of the route change.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends routing updates to notify its peers. If a route changes frequently, the peer route-update-interval command can be used to adjust the interval at which Update packets are sent for changes of this route. This frees the device from sending Update packets for every route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to a peer group to 10 seconds.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test route-update-interval 10

peer route-update-interval (BGP multi-instance VPN instance IPv4 address family view)(IPv4)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address route-update-interval interval

undo peer ipv4-address route-update-interval

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

interval

Specifies the minimum interval at which routing updates are sent.

The value is an integer that ranges from 0 to 600, in seconds. The value 0 indicates that the device immediately sends a BGP Update packet to notify the peer of the route change.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends Update packets to notify the peers. If a route changes frequently, run this command to set an interval at which the device sends Update messages carrying the same route prefix to a specified peer or peer group. This prevents the device from sending Update messages for each route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to the peer to 10 seconds.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 route-update-interval 10

peer route-update-interval (BGP view) (group)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer group.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

Format

peer group-name route-update-interval interval

undo peer group-name route-update-interval

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

interval

Specifies the minimum interval at which routing updates are sent.

The value is an integer that ranges from 0 to 600, in seconds. The value 0 indicates that the device immediately sends a BGP Update packet to notify the peer of the route change.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends Update packets to notify the peers. If a route changes frequently, run this command to set an interval at which the device sends Update messages carrying the same route prefix to a specified peer or peer group. This prevents the device from sending Update messages for each route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to a peer group to 10 seconds.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer test route-update-interval 10

peer route-update-interval (BGP view)(IPv4)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

Format

peer ipv4-address route-update-interval interval

undo peer ipv4-address route-update-interval

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

interval

Specifies the minimum interval at which routing updates are sent.

The value is an integer that ranges from 0 to 600, in seconds. The value 0 indicates that the device immediately sends a BGP Update packet to notify the peer of the route change.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends Update packets to notify the peers. If a route changes frequently, run this command to set an interval at which the device sends Update messages carrying the same route prefix to a specified peer or peer group. This prevents the device from sending Update messages for each route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to the peer to 10 seconds.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 route-update-interval 10

peer route-update-interval (BGP-IPv4 unicast address family view) (group)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer group.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

Format

peer group-name route-update-interval interval

undo peer group-name route-update-interval

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

interval

Specifies the minimum interval at which BGP routing updates are sent.

The value is an integer that ranges from 0 to 600, in seconds. The value 0 indicates that the device immediately sends a BGP Update message to notify the peer of the route change.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends Update packets to notify the peers. If a route changes frequently, run this command to set an interval at which the device sends Update messages carrying the same route prefix to a specified peer or peer group. This prevents the device from sending Update messages for each route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to a peer group to 10 seconds.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer test route-update-interval 10

peer route-update-interval (BGP-IPv4 unicast address family view)(IPv4)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

Format

peer ipv4-address route-update-interval interval

undo peer ipv4-address route-update-interval

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

interval

Specifies the minimum interval at which routing updates are sent.

The value is an integer that ranges from 0 to 600, in seconds. The value 0 indicates that the device immediately sends a BGP Update packet to notify the peer of the route change.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends Update packets to notify the peers. If a route changes frequently, run this command to set an interval at which the device sends Update messages carrying the same route prefix to a specified peer or peer group. This prevents the device from sending Update messages for each route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to the peer to 10 seconds.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] peer 10.1.1.2 route-update-interval 10

peer route-update-interval (BGP-IPv6 unicast address family view) (group)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer group.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

Format

peer group-name route-update-interval interval

undo peer group-name route-update-interval

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

interval

Specifies the minimum interval at which BGP routing updates are sent.

The value is an integer that ranges from 0 to 600, in seconds. The value 0 indicates that the device immediately sends a BGP Update message to notify the peer of the route change.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends Update packets to notify the peers. If a route changes frequently, run this command to set an interval at which the device sends Update messages carrying the same route prefix to a specified peer or peer group. This prevents the device from sending Update messages for each route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to a peer group to 10 seconds.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test route-update-interval 10

peer route-update-interval (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

Format

peer ipv6-address route-update-interval interval

undo peer ipv6-address route-update-interval

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

interval

Specifies the minimum interval at which routing updates are sent.

The value is an integer that ranges from 0 to 600, in seconds. The value 0 indicates that the device immediately sends a BGP Update packet to notify the peer of the route change.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends Update packets to notify the peers. If a route changes frequently, run this command to set an interval at which the device sends Update messages carrying the same route prefix to a specified peer or peer group. This prevents the device from sending Update messages for each route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to the peer to 10 seconds.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 route-update-interval 10

peer route-update-interval (BGP-IPv6 unicast address family view)(IPv4)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

Format

peer ipv4-address route-update-interval interval

undo peer ipv4-address route-update-interval

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

interval

Specifies the minimum interval at which routing updates are sent.

The value is an integer that ranges from 0 to 600, in seconds. The value 0 indicates that the device immediately sends a BGP Update packet to notify the peer of the route change.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends Update packets to notify the peers. If a route changes frequently, run this command to set an interval at which the device sends Update messages carrying the same route prefix to a specified peer or peer group. This prevents the device from sending Update messages for each route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to the peer to 10 seconds.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 enable
[HUAWEI-bgp-af-ipv6] peer 10.1.1.1 route-update-interval 10

peer route-update-interval (BGP-VPN instance IPv4 address family view) (group)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer group.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

Format

peer group-name route-update-interval interval

undo peer group-name route-update-interval

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

interval

Specifies the minimum interval at which routing updates are sent.

The value is an integer that ranges from 0 to 600, in seconds. The value 0 indicates that the device immediately sends a BGP Update packet to notify the peer of the route change.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends Update packets to notify the peers. If a route changes frequently, run this command to set an interval at which the device sends Update messages carrying the same route prefix to a specified peer or peer group. This prevents the device from sending Update messages for each route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to a peer group to 10 seconds.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test
[HUAWEI-bgp-vpna] peer test route-update-interval 10

peer route-update-interval (BGP-VPN instance IPv4 address family view)(IPv4)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

Format

peer ipv4-address route-update-interval interval

undo peer ipv4-address route-update-interval

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

interval

Specifies the minimum interval at which routing updates are sent.

The value is an integer that ranges from 0 to 600, in seconds. The value 0 indicates that the device immediately sends a BGP Update packet to notify the peer of the route change.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends Update packets to notify the peers. If a route changes frequently, run this command to set an interval at which the device sends Update messages carrying the same route prefix to a specified peer or peer group. This prevents the device from sending Update messages for each route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to the peer to 10 seconds.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] peer 10.1.1.1 route-update-interval 10

peer route-update-interval (BGP-VPN instance IPv6 address family view) (group)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer group.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

Format

peer group-name route-update-interval interval

undo peer group-name route-update-interval

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

interval

Specifies the minimum interval at which BGP routing updates are sent.

The value is an integer that ranges from 0 to 600, in seconds. The value 0 indicates that the device immediately sends a BGP Update message to notify the peer of the route change.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends routing updates to notify its peers. If a route changes frequently, the peer route-update-interval command can be used to adjust the interval at which Update packets are sent for changes of this route. This frees the device from sending Update packets for every route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to a peer group to 10 seconds.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] group test external
[HUAWEI-bgp-6-vpna] peer test as-number 200
[HUAWEI-bgp-6-vpna] peer test route-update-interval 10

peer route-update-interval (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

Format

peer ipv6-address route-update-interval interval

undo peer ipv6-address route-update-interval

Parameters

Parameter Description Value
ipv6-address

Specify an IPv6 peer address.

The address is in the format of X:X:X:X:X:X:X:X.

interval

Specifies the minimum interval at which routing updates are sent.

The value is an integer ranging from 0 to 600, in seconds. The value 0 indicates that the device immediately sends BGP Update messages to notify its peers of route changes.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends routing updates to notify its peers. If a route changes frequently, the peer route-update-interval command can be used to adjust the interval at which Update packets are sent for changes of this route. This frees the device from sending Update packets for every route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to the peer to 10 seconds.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 route-update-interval 10

peer route-update-interval (BGP-VPN instance IPv6 address family view)(IPv4)

Function

The peer route-update-interval command sets the interval for sending Update messages with the same route prefix to a peer.

The undo peer route-update-interval command restores the default configuration.

By default, the interval at which routing updates are sent to IBGP peers is 15s, and the interval at which routing updates are sent to EBGP peers is 30s.

Format

peer ipv4-address route-update-interval interval

undo peer ipv4-address route-update-interval

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

interval

Specifies the minimum interval at which routing updates are sent.

The value is an integer ranging from 0 to 600, in seconds. The value 0 indicates that the device immediately sends BGP Update messages to notify its peers of route changes.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When routes change, the device sends routing updates to notify its peers. If a route changes frequently, the peer route-update-interval command can be used to adjust the interval at which Update packets are sent for changes of this route. This frees the device from sending Update packets for every route change.

Implementation Procedure

If the peer route-update-interval command is used but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

  • If the interval between two route updates is longer than the interval configured using the peer route-update-interval command, the device immediately sends an Update message to notify its peer, regardless of the interval configured using the peer route-update-interval command.
  • If the interval between two route updates is shorter than the interval configured using the peer route-update-interval command, the device sends an Update message to notify its peer when the configured interval expires.

    If the route is withdrawn because the export policy denies the route, the device sends a Withdraw message to notify the peer when the configured interval expires.
  • In other cases, if a route is withdrawn, the device immediately sends a Withdraw message to notify its peers, regardless of the interval set using the peer route-update-interval command.

Example

# Set the interval for sending route update messages to the peer to 10 seconds.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpna] quit
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 enable
[HUAWEI-bgp-6-vpna] peer 10.1.1.1 route-update-interval 10

peer soo (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer soo command configures the Site of Origin (SoO) attribute for an EBGP peer in a BGP VPN instance.

The undo peer soo command cancels the configuration.

By default, no SoO attribute is configured for an EBGP peer in a BGP VPN instance.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address soo site-of-origin

undo peer ipv4-address soo

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv6 address of a BGP4+ peer.

The value is in dotted decimal notation.

site-of-origin

Specifies the SoO attribute.

The SoO attribute value can be expressed in any of the following formats:

  • 2-byte AS number:4-byte user-defined number, for example, 1:3. The AS number is an integer ranging from 0 to 65535, and the user-defined number is an integer ranging from 0 to 4294967295. The AS number and user-defined number cannot both be set to 0. That is, the SoO must not be 0:0.
  • IPv4 address:2-byte user-defined number, for example, 192.168.122.15:1. The IP address ranges from 0.0.0.0 to 255.255.255.255, and the user-defined number is an integer ranging from 0 to 65535.
  • 4-byte AS number in integer format:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295, and a user-defined number ranges from 0 to 65535.
  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535. A user-defined number also ranges from 0 to 65535. The AS number and user-defined number must not be both 0s. That is, the SoO must not be 0.0:0.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a L3VPN scenario, if the ASs to which two VPN sites belong use private AS numbers, the AS numbers of the two VPN sites may be the same. As a result, different sites of the same VPN cannot communicate. The peer substitute-as command can be used to enable AS number substitution on PEs to address this problem.

Enabling AS number substitution will cause another problem. Several CEs at a VPN site may establish EBGP connections with different PEs of a L3VPN backbone network, and a routing protocol has been configured on the CEs. If AS number substitution is enabled on PEs, the AS numbers carried by VPN routes of this site will be replaced on the PEs. As a result, routes advertised from a CE to a PE may be re-advertised to this VPN site after the routes traverse the backbone network, causing a routing loop. The peer soo command can be run on the PEs to address this problem.

After the peer soo command is run on a PE to configure the SoO attribute for a specified CE, the PE adds the attribute to a route sent from the CE and advertises the route to the remote PE. The remote PE checks the SoO attribute of the route before sending it to its attached CE. If the SoO attribute is the same as the local SoO attribute on the remote PE, the remote PE does not send the route to its attached CE, preventing a routing loop in a VPN site.

Example

# Configure the SoO attribute.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.2.3.4 as-number 200
[HUAWEI-bgp-instance-a-vpna] peer 10.2.3.4 soo 10.2.2.2:45

peer soo (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer soo command configures the Site of Origin (SoO) attribute for an EBGP peer in a BGP VPN instance.

The undo peer soo command cancels the configuration.

By default, no SoO attribute is configured for an EBGP peer in a BGP VPN instance.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name soo site-of-origin

undo peer group-name soo

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

site-of-origin

Specifies the SoO attribute.

The SoO attribute value can be expressed in any of the following formats:

  • 2-byte AS number:4-byte user-defined number, for example, 1:3. The AS number is an integer ranging from 0 to 65535, and the user-defined number is an integer ranging from 0 to 4294967295. The AS number and user-defined number cannot both be set to 0. That is, the SoO must not be 0:0.
  • IPv4 address:2-byte user-defined number, for example, 192.168.122.15:1. The IP address ranges from 0.0.0.0 to 255.255.255.255, and the user-defined number is an integer ranging from 0 to 65535.
  • 4-byte AS number in integer format:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295, and a user-defined number ranges from 0 to 65535.
  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535. A user-defined number also ranges from 0 to 65535. The AS number and user-defined number must not be both 0s. That is, the SoO must not be 0.0:0.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a L3VPN scenario, if the ASs to which two VPN sites belong use private AS numbers, the AS numbers of the two VPN sites may be the same. As a result, different sites of the same VPN cannot communicate. The peer substitute-as command can be used to enable AS number substitution on PEs to address this problem.

Enabling AS number substitution will cause another problem. Several CEs at a VPN site may establish EBGP connections with different PEs of a L3VPN backbone network, and a routing protocol has been configured on the CEs. If AS number substitution is enabled on PEs, the AS numbers carried by VPN routes of this site will be replaced on the PEs. As a result, routes advertised from a CE to a PE may be re-advertised to this VPN site after the routes traverse the backbone network, causing a routing loop. The peer soo command can be run on the PEs to address this problem.

After the peer soo command is run on a PE to configure the SoO attribute for a specified CE, the PE adds the attribute to a route sent from the CE and advertises the route to the remote PE. The remote PE checks the SoO attribute of the route before sending it to its attached CE. If the SoO attribute is the same as the local SoO attribute on the remote PE, the remote PE does not send the route to its attached CE, preventing a routing loop in a VPN site.

Example

# Configure the SoO attribute for EBGP peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test external
[HUAWEI-bgp-instance-a-vpna] peer test as-number 200
[HUAWEI-bgp-instance-a-vpna] peer test soo 10.2.2.2:45

peer soo (BGP-VPN instance IPv4 address family view)

Function

The peer soo command configures the Site of Origin (SoO) attribute for an EBGP peer in a BGP VPN instance.

The undo peer soo command cancels the configuration.

By default, no SoO attribute is configured for an EBGP peer in a BGP VPN instance.

Format

peer ipv4-address soo site-of-origin

undo peer ipv4-address soo

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv6 address of a BGP4+ peer.

The value is in dotted decimal notation.

site-of-origin

Specifies the SoO attribute.

The SoO attribute value can be expressed in any of the following formats:

  • 2-byte AS number:4-byte user-defined number, for example, 1:3. The AS number is an integer ranging from 0 to 65535, and the user-defined number is an integer ranging from 0 to 4294967295. The AS number and user-defined number cannot both be set to 0. That is, the SoO must not be 0:0.
  • IPv4 address:2-byte user-defined number, for example, 192.168.122.15:1. The IP address ranges from 0.0.0.0 to 255.255.255.255, and the user-defined number is an integer ranging from 0 to 65535.
  • 4-byte AS number in integer format:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295, and a user-defined number ranges from 0 to 65535.
  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535. A user-defined number also ranges from 0 to 65535. The AS number and user-defined number must not be both 0s. That is, the SoO must not be 0.0:0.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a L3VPN scenario, if the ASs to which two VPN sites belong use private AS numbers, the AS numbers of the two VPN sites may be the same. As a result, different sites of the same VPN cannot communicate. The peer substitute-as command can be used to enable AS number substitution on PEs to address this problem.

Enabling AS number substitution will cause another problem. Several CEs at a VPN site may establish EBGP connections with different PEs of a L3VPN backbone network, and a routing protocol has been configured on the CEs. If AS number substitution is enabled on PEs, the AS numbers carried by VPN routes of this site will be replaced on the PEs. As a result, routes advertised from a CE to a PE may be re-advertised to this VPN site after the routes traverse the backbone network, causing a routing loop. The peer soo command can be run on the PEs to address this problem.

After the peer soo command is run on a PE to configure the SoO attribute for a specified CE, the PE adds the attribute to a route sent from the CE and advertises the route to the remote PE. The remote PE checks the SoO attribute of the route before sending it to its attached CE. If the SoO attribute is the same as the local SoO attribute on the remote PE, the remote PE does not send the route to its attached CE, preventing a routing loop in a VPN site.

Example

# Configure the SoO attribute.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 200
[HUAWEI-bgp-vpna] peer 1.1.1.1 soo 2.2.2.2:45

peer soo (BGP-VPN instance IPv4 address family view) (group)

Function

The peer soo command configures the Site of Origin (SoO) attribute for an EBGP peer group in a BGP VPN instance.

The undo peer soo command cancels the configuration.

By default, no SoO attribute is configured for an EBGP peer group in a BGP VPN instance.

Format

peer group-name soo site-of-origin

undo peer group-name soo

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

site-of-origin

Specifies the SoO attribute.

The SoO attribute value can be expressed in any of the following formats:

  • 2-byte AS number:4-byte user-defined number, for example, 1:3. The AS number is an integer ranging from 0 to 65535, and the user-defined number is an integer ranging from 0 to 4294967295. The AS number and user-defined number cannot both be set to 0. That is, the SoO must not be 0:0.
  • IPv4 address:2-byte user-defined number, for example, 192.168.122.15:1. The IP address ranges from 0.0.0.0 to 255.255.255.255, and the user-defined number is an integer ranging from 0 to 65535.
  • 4-byte AS number in integer format:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295, and a user-defined number ranges from 0 to 65535.
  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535. A user-defined number also ranges from 0 to 65535. The AS number and user-defined number must not be both 0s. That is, the SoO must not be 0.0:0.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a L3VPN scenario, if the ASs to which two VPN sites belong use private AS numbers, the AS numbers of the two VPN sites may be the same. As a result, different sites of the same VPN cannot communicate. The peer substitute-as command can be used to enable AS number substitution on PEs to address this problem.

Enabling AS number substitution will cause another problem. Several CEs at a VPN site may establish EBGP connections with different PEs of a L3VPN backbone network, and a routing protocol has been configured on the CEs. If AS number substitution is enabled on PEs, the AS numbers carried by VPN routes of this site will be replaced on the PEs. As a result, routes advertised from a CE to a PE may be re-advertised to this VPN site after the routes traverse the backbone network, causing a routing loop. The peer soo command can be run on the PEs to address this problem.

After the peer soo command is run on a PE to configure the SoO attribute for a specified CE, the PE adds the attribute to a route sent from the CE and advertises the route to the remote PE. The remote PE checks the SoO attribute of the route before sending it to its attached CE. If the SoO attribute is the same as the local SoO attribute on the remote PE, the remote PE does not send the route to its attached CE, preventing a routing loop in a VPN site.

Example

# Configure the SoO attribute for EBGP peer group in a BGP VPN instance.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test external
[HUAWEI-bgp-vpna] peer test soo 2.2.2.2:45

peer soo (BGP-VPN instance IPv6 address family view) (group)

Function

The peer soo command configures the Site of Origin (SoO) attribute for an EBGP peer group in a BGP VPN instance.

The undo peer soo command cancels the configuration.

By default, no SoO attribute is configured for an EBGP peer group in a BGP VPN instance.

Format

peer group-name soo site-of-origin

undo peer group-name soo

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

site-of-origin

Specifies the SoO attribute.

The SoO attribute value can be expressed in any of the following formats:

  • 2-byte AS number:4-byte user-defined number, for example, 1:3. The AS number is an integer ranging from 0 to 65535, and the user-defined number is an integer ranging from 0 to 4294967295. The AS number and user-defined number cannot both be set to 0. That is, the SoO must not be 0:0.
  • IPv4 address:2-byte user-defined number, for example, 192.168.122.15:1. The IP address ranges from 0.0.0.0 to 255.255.255.255, and the user-defined number is an integer ranging from 0 to 65535.
  • 4-byte AS number in integer format:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295, and a user-defined number ranges from 0 to 65535.
  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535. A user-defined number also ranges from 0 to 65535. The AS number and user-defined number must not be both 0s. That is, the SoO must not be 0.0:0.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a L3VPN scenario, if the ASs to which two VPN sites belong use private AS numbers, the AS numbers of the two VPN sites may be the same. As a result, different sites of the same VPN cannot communicate. The peer substitute-as command can be used to enable AS number substitution on PEs to address this problem.

Enabling AS number substitution will cause another problem. Several CEs at a VPN site may establish EBGP connections with different PEs of a L3VPN backbone network, and a routing protocol has been configured on the CEs. If AS number substitution is enabled on PEs, the AS numbers carried by VPN routes of this site will be replaced on the PEs. As a result, routes advertised from a CE to a PE may be re-advertised to this VPN site after the routes traverse the backbone network, causing a routing loop. The peer soo command can be run on the PEs to address this problem.

After the peer soo command is run on a PE to configure the SoO attribute for a specified CE, the PE adds the attribute to a route sent from the CE and advertises the route to the remote PE. The remote PE checks the SoO attribute of the route before sending it to its attached CE. If the SoO attribute is the same as the local SoO attribute on the remote PE, the remote PE does not send the route to its attached CE, preventing a routing loop in a VPN site.

Example

# Configure the SoO attribute for EBGP peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test soo 10.2.2.2:45

peer soo (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer soo command configures the Site of Origin (SoO) attribute for an EBGP peer in a BGP VPN instance.

The undo peer soo command cancels the configuration.

By default, no SoO attribute is configured for an EBGP peer in a BGP VPN instance.

Format

peer ipv6-address soo site-of-origin

undo peer ipv6-address soo

Parameters

Parameter Description Value
ipv6-address

Specifies the SoO attribute for a peer.

The SoO attribute value can be expressed in any of the following formats:

  • 2-byte AS number:4-byte user-defined number, for example, 1:3. The AS number is an integer ranging from 0 to 65535, and the user-defined number is an integer ranging from 0 to 4294967295. The AS number and user-defined number cannot both be set to 0. That is, the SoO must not be 0:0.
  • IPv4 address:2-byte user-defined number, for example, 192.168.122.15:1. The IP address ranges from 0.0.0.0 to 255.255.255.255, and the user-defined number is an integer ranging from 0 to 65535.
  • 4-byte AS number in integer format:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295, and a user-defined number ranges from 0 to 65535.
  • 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535. A user-defined number also ranges from 0 to 65535. The AS number and user-defined number must not be both 0s. That is, the SoO must not be 0.0:0.
site-of-origin

Specifies the IPv6 address of a BGP peer.

The value is in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a L3VPN scenario, if the ASs to which two VPN sites belong use private AS numbers, the AS numbers of the two VPN sites may be the same. As a result, different sites of the same VPN cannot communicate. The peer substitute-as command can be used to enable AS number substitution on PEs to address this problem.

Enabling AS number substitution will cause another problem. Several CEs at a VPN site may establish EBGP connections with different PEs of a L3VPN backbone network, and a routing protocol has been configured on the CEs. If AS number substitution is enabled on PEs, the AS numbers carried by VPN routes of this site will be replaced on the PEs. As a result, routes advertised from a CE to a PE may be re-advertised to this VPN site after the routes traverse the backbone network, causing a routing loop. The peer soo command can be run on the PEs to address this problem.

After the peer soo command is run on a PE to configure the SoO attribute for a specified CE, the PE adds the attribute to a route sent from the CE and advertises the route to the remote PE. The remote PE checks the SoO attribute of the route before sending it to its attached CE. If the SoO attribute is the same as the local SoO attribute on the remote PE, the remote PE does not send the route to its attached CE, preventing a routing loop in a VPN site.

Example

# Configure the SoO attribute for EBGP peers.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 soo 10.2.2.2:45

peer ssl-policy (BGP view)

Function

The peer ssl-policy name command applies an SSL policy to an SSL client or server.

The peer ssl-policy disable command disables an SSL policy applied to an SSL client or server.

The undo peer ssl-policy name command cancels the configuration of applying an SSL policy to an SSL client or server.

The undo peer ssl-policy disable command restores the default configuration and takes effect only when the peer ssl-policy disable command is run.

By default, no SSL policy is applied to an SSL client or server.

Format

peer { ipv4-address | ipv6-address } ssl-policy name ssl-policy-name

peer { ipv4-address | ipv6-address } ssl-policy disable

undo peer { ipv4-address | ipv6-address } ssl-policy name ssl-policy-name

undo peer { ipv4-address | ipv6-address } ssl-policy disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

name ssl-policy-name

Specifies the name of an SSL policy.

The value is a string of 1 to 23 case-insensitive characters. The value does not contain spaces.

disable

Disables an SSL policy applied to an SSL client or server.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The Secure Sockets Layer (SSL) protocol protects data privacy on the Internet by preventing attackers from eavesdropping on data exchanged between a client and a server. Specifically, to ensure data transmission security on a network, an SSL policy needs to be applied to an SSL client or server using the peer ssl-policy name command, and SSL data encryption, identity authentication, and message integrity verification mechanisms need to be used.

Example

# Apply the SSL policy named ftps_der to an SSL client.
<HUAWEI> system-view
[HUAWEI] ssl policy ftps_der
[HUAWEI-ssl-policy-ftps_der] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 ssl-policy name ftps_der
# Apply the SSL default domain policy ftps_der to the client.
<HUAWEI> system-view
[HUAWEI] ssl policy ftps_der
[HUAWEI-ssl-policy-ftps_der] pki-domain default
[HUAWEI-ssl-policy-ftps_der] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 ssl-policy name ftps_der
Warning: The SSL policy is bound to the defaut PKI domain, Continue? [Y/N]:y

peer ssl-policy name (BGP view) (group)

Function

The peer ssl-policy name command applies an SSL policy to an SSL client or server.

The undo peer ssl-policy name command cancels the configuration of applying an SSL policy to an SSL client or server.

By default, no SSL policy is applied to an SSL client or server.

Format

peer group-name ssl-policy name ssl-policy-name

undo peer group-name ssl-policy name ssl-policy-name

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

name ssl-policy-name

Specifies the name of an SSL policy.

The value is a string of 1 to 23 case-insensitive characters. The value does not contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The Secure Sockets Layer (SSL) protocol protects data privacy on the Internet by preventing attackers from eavesdropping on data exchanged between a client and a server. Specifically, to ensure data transmission security on a network, an SSL policy needs to be applied to an SSL client or server using the peer ssl-policy name command, and SSL data encryption, identity authentication, and message integrity verification mechanisms need to be used.

Prerequisites

An SSL policy has been created using the ssl policy command, and a peer relationship has been established using the peer as-number command.

Precautions

The same SSL policy cannot be applied to different SSL roles.

The SSL policy configuration for a peer takes precedence over that for a peer group to which the peer belongs.

SSL/TLS authentication takes effect only when SSL client and server roles are specified, SSL policies are applied to the client and server, and SSL/TLS authentication is enabled on the server (SSL/TLS authentication is not required on the client).

Example

# Apply the SSL policy to an SSL client.
<HUAWEI> system-view
[HUAWEI] ssl policy ftps_der
[HUAWEI-ssl-policy-ftps_der] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test ssl-policy name ftps_der
# Apply the default SSL domain policy to the client.
<HUAWEI> system-view
[HUAWEI] ssl policy ftps_der
[HUAWEI-ssl-policy-ftps_der] pki-domain default
[HUAWEI-ssl-policy-ftps_der] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test ssl-policy name ftps_der
Warning: The SSL policy is bound to the defaut PKI domain, Continue? [Y/N]:y

peer ssl-policy role

Function

The peer ssl-policy role client command configures a peer as an SSL client.

The undo peer ssl-policy role client command cancels the SSL client configuration.

The peer ssl-policy role server command configures a peer as an SSL server.

The undo peer ssl-policy role server command cancels the SSL server configuration.

The peer ssl-policy role disable command disables SSL role setting for a peer.

The undo peer ssl-policy role disable command restores the default configuration and takes effect only when the peer ssl-policy role disable command is run.

By default, no peer is configured as an SSL client or server.

Format

peer { ipv4-address | ipv6-address } ssl-policy role server

peer { ipv4-address | ipv6-address } ssl-policy role client

peer { ipv4-address | ipv6-address } ssl-policy role disable

undo peer { ipv4-address | ipv6-address } ssl-policy role server

undo peer { ipv4-address | ipv6-address } ssl-policy role client

undo peer { ipv4-address | ipv6-address } ssl-policy role disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

disable

Disables SSL role setting for a peer.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The Secure Sockets Layer (SSL) protocol protects data privacy on the Internet by preventing attackers from eavesdropping on data exchanged between a client and a server. Specifically, to ensure data transmission security on a network, a peer needs to be configured as an SSL client using the peer ssl-policy role client command or as a server using the peer ssl-policy role server command, and the SSL data encryption, identity authentication, and message integrity verification mechanisms need to be used.

Example

# Configure a peer as an SSL client.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 100
[HUAWEI-bgp] peer 10.1.1.2 ssl-policy role client

peer ssl-policy role (BGP view) (group)

Function

The peer ssl-policy role client command configures a peer group as an SSL client.

The undo peer ssl-policy role client command cancels the SSL client configuration.

The peer ssl-policy role server command configures a peer group as an SSL server.

The undo peer ssl-policy role server command cancels the SSL server configuration.

By default, no peer or peer group is configured as an SSL client or server.

Format

peer group-name ssl-policy role server

peer group-name ssl-policy role client

undo peer group-name ssl-policy role server

undo peer group-name ssl-policy role client

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The Secure Sockets Layer (SSL) protocol protects data privacy on the Internet by preventing attackers from eavesdropping on data exchanged between a client and a server. Specifically, to ensure data transmission security on a network, a peer group needs to be configured as an SSL client using the peer ssl-policy role client command or as a server using the peer ssl-policy role server command, and the SSL data encryption, identity authentication, and message integrity verification mechanisms need to be used.

Prerequisites

A BGP peer relationship has been established using the peer as-number command.

Precautions

A set SSL role (server or client) of a peer group cannot be changed to another role unless you first run the peer ssl-policy role disable or undo peer ssl-policy role command to cancel the role configuration of the peer group.

If a peer group is configured as an SSL client, the peer listen-only command cannot be run. That is, the peer listen-only command is mutually exclusive with the peer ssl-policy role client command. If a peer group is configured as an SSL server, the peer connect-only command cannot be run. That is, the peer connect-only command is mutually exclusive with the peer ssl-policy role client command.

The SSL role configuration for a peer takes precedence over that for a peer group to which the peer belongs.

SSL/TLS authentication takes effect only when SSL client and server roles are specified, SSL policies are applied to the client and server, and SSL/TLS authentication is enabled on the server (SSL/TLS authentication is not required on the client).

Example

# Configure the peer group named group1 as an SSL client and configure a peer in the peer group as a server.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group group1 internal
[HUAWEI-bgp] peer 10.1.1.1 group group1
[HUAWEI-bgp] peer 10.1.1.2 group group1
[HUAWEI-bgp] peer 10.1.1.3 group group1
[HUAWEI-bgp] peer group1 ssl-policy role client
[HUAWEI-bgp] peer 10.1.1.1 ssl-policy role server

peer ssl-server certificate

Function

The peer ssl-server certificate command enables SSL/TLS authentication on an SSL server.

The peer ssl-server certificate disable command disables SSL/TLS authentication on an SSL server.

The undo peer ssl-server certificate command cancels SSL/TLS authentication on an SSL server.

The undo peer ssl-server certificate disable command restores the default configuration and takes effect only when the peer ssl-server certificate disable command is run.

By default, SSL/TLS authentication is disabled on an SSL server.

Format

peer { ipv4-address | ipv6-address } ssl-server certificate

peer { ipv4-address | ipv6-address } ssl-server certificate disable

undo peer { ipv4-address | ipv6-address } ssl-server certificate

undo peer { ipv4-address | ipv6-address } ssl-server certificate disable

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

disable

Disables SSL/TLS authentication on an SSL server.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The Secure Sockets Layer (SSL) protocol protects data privacy on the Internet by preventing attackers from eavesdropping on data exchanged between a client and a server. The Transport Layer Security (TLS) protocol is an SSL successor and ensures data integrity and privacy. To enable SSL/TLS authentication on an SSL server, run the peer ssl-server certificate command. BGP messages are then encrypted to ensure data transmission security on the network.

Example

# Enable SSL/TLS authentication on an SSL server.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 100
[HUAWEI-bgp] peer 10.1.1.2 ssl-server certificate

peer ssl-server certificate (BGP view) (group)

Function

The peer ssl-server certificate command enables SSL/TLS authentication on an SSL server.

The undo peer ssl-server certificate command cancels SSL/TLS authentication on an SSL server.

By default, SSL/TLS authentication is disabled on an SSL server.

Format

peer group-name ssl-server certificate

undo peer group-name ssl-server certificate

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The Secure Sockets Layer (SSL) protocol protects data privacy on the Internet by preventing attackers from eavesdropping on data exchanged between a client and a server. The Transport Layer Security (TLS) protocol is an SSL successor and ensures data integrity and privacy. To enable SSL/TLS authentication on an SSL server, run the peer ssl-server certificate command. BGP messages are then encrypted to ensure data transmission security on the network.

Example

# Enable SSL/TLS authentication on an SSL server.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test ssl-server certificate

peer substitute-as (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer substitute-as command substitutes the local AS number for the AS number of a specified peer in the AS_Path attribute in the advertisement direction.

The undo peer substitute-as command disables AS number substitution.

By default, AS number substitution is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address substitute-as

undo peer ipv4-address substitute-as

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a BGP public network scenario, when two devices with the same AS number learn a BGP route from each other through the same EBGP peer, the route may be discarded because the AS_Path attribute contains duplicate AS numbers. To prevent this problem, run the peer substitute-as command on this EBGP peer to enable AS number substitution in the advertisement direction.

Prerequisites

Enabling BGP AS number substitution may cause route loops in a CE multi-homing network. The peer soo command must be run to prevent a routing loop in a VPN site.

On BGP public networks, if three or more BGP peers form a ring network, the peer substitute-as command cannot be run; otherwise, a routing loop may occur.

Precautions

If the peer substitute-as command is run, the AS number of the route is replaced, which may cause routing loops. To solve this problem, run the peer soo command to configure the SoO feature.

Example

# Configure a device to replace the AS number of a specified peer in the AS_Path of a route with the local AS number.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 substitute-as

peer substitute-as (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer substitute-as command enables AS number substitution in the advertisement direction. That is, the AS number of a specified peer group in the AS_Path attribute is replaced with the local AS number.

The undo peer substitute-as command disables AS number substitution.

By default, AS number substitution is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name substitute-as

undo peer group-name substitute-as

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a BGP public network scenario, when two devices with the same AS number learn a BGP route from each other through the same EBGP peer, the route may be discarded because the AS_Path attribute contains duplicate AS numbers. To prevent this problem, run the peer substitute-as command on this EBGP peer to enable AS number substitution in the advertisement direction.

Prerequisites

Enabling BGP AS number substitution may cause route loops in a CE multi-homing network. The peer soo command must be run to prevent a routing loop in a VPN site.

On BGP public networks, if three or more BGP peers form a ring network, the peer substitute-as command cannot be run; otherwise, a routing loop may occur.

Precautions

If the peer substitute-as command is run, the AS number of the route is replaced, which may cause routing loops. To solve this problem, run the peer soo command to configure the SoO feature.

Example

# Configure a device to replace the AS number of a specified peer group in the AS_Path of a route with the local AS number.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test external
[HUAWEI-bgp-instance-a-vpna] peer test substitute-as

peer substitute-as (BGP-IPv4 unicast address family view)

Function

The peer substitute-as command substitutes the local AS number for the AS number of a specified peer in the AS_Path attribute in the advertisement direction.

The undo peer substitute-as command disables AS number substitution.

By default, AS number substitution is disabled.

Format

peer ipv4-address substitute-as

undo peer ipv4-address substitute-as

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a BGP public network scenario, when two devices with the same AS number learn a BGP route from each other through the same EBGP peer, the route may be discarded because the AS_Path attribute contains duplicate AS numbers. To prevent this problem, run the peer substitute-as command on this EBGP peer to enable AS number substitution in the advertisement direction.

Prerequisites

Enabling BGP AS number substitution may cause route loops in a CE multi-homing network. The peer soo command must be run to prevent a routing loop in a VPN site.

On BGP public networks, if three or more BGP peers form a ring network, the peer substitute-as command cannot be run; otherwise, a routing loop may occur.

Precautions

If the peer substitute-as command is run, the AS number of the route is replaced, which may cause routing loops. To solve this problem, run the peer soo command to configure the SoO feature.

Example

# Configure a device to replace the AS number of a specified peer in the AS_Path of a route with the local AS number.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.1 as-number 200
[HUAWEI-bgp] peer 1.1.1.1 substitute-as

peer substitute-as (BGP-IPv4 unicast address family view) (group)

Function

The peer substitute-as command enables AS number substitution in the advertisement direction. That is, the AS number of a specified peer group in the AS_Path attribute is replaced with the local AS number.

The undo peer substitute-as command disables AS number substitution.

By default, AS number substitution is disabled.

Format

peer group-name substitute-as

undo peer group-name substitute-as

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a BGP public network scenario, when two devices with the same AS number learn a BGP route from each other through the same EBGP peer, the route may be discarded because the AS_Path attribute contains duplicate AS numbers. To prevent this problem, run the peer substitute-as command on this EBGP peer to enable AS number substitution in the advertisement direction.

Prerequisites

Enabling BGP AS number substitution may cause route loops in a CE multi-homing network. The peer soo command must be run to prevent a routing loop in a VPN site.

On BGP public networks, if three or more BGP peers form a ring network, the peer substitute-as command cannot be run; otherwise, a routing loop may occur.

Precautions

If the peer substitute-as command is run, the AS number of the route is replaced, which may cause routing loops. To solve this problem, run the peer soo command to configure the SoO feature.

Example

# Configure a device to replace the AS number of a specified peer group in the AS_Path of a route with the local AS number.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] peer test substitute-as

peer substitute-as (BGP-IPv6 unicast address family view)

Function

The peer substitute-as command substitutes the local AS number for the AS number of a specified peer in the AS_Path attribute in the advertisement direction.

The undo peer substitute-as command disables AS number substitution.

By default, AS number substitution is disabled.

Format

peer ipv4-address substitute-as

undo peer ipv4-address substitute-as

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In an L3VPN scenario, if the ASs where two VPN sites reside use private AS numbers, the AS numbers of the two VPN sites may be the same. If a CE in a VPN site sends a VPN route to the local PE through EBGP and the remote PE sends the route to the remote CE, the remote CE discards the route due to duplicate AS numbers. As a result, different sites in the same VPN cannot communicate with each other. In this case, you need to run the peer substitute-as command on the PE to enable AS number substitution in the advertisement direction. That is, when advertising the routes learned from the remote PE to its connected CE, the PE replaces the AS number of the VPN site where the CE in the received VPN site resides with the local AS number.

In a BGP public network scenario, when two devices with the same AS number learn a BGP route from each other through the same EBGP peer, the route may be discarded because the AS_Path attribute contains duplicate AS numbers. To prevent this problem, run the peer substitute-as command on this EBGP peer to enable AS number substitution in the advertisement direction.

Prerequisites

Enabling BGP AS number substitution may cause route loops in a CE multi-homing network. The peer soo command must be run to prevent a routing loop in a VPN site.

On BGP public networks, if three or more BGP peers form a ring network, the peer substitute-as command cannot be run; otherwise, a routing loop may occur.

Precautions

If the peer substitute-as command is run, the AS number of the route is replaced, which may cause routing loops. To solve this problem, run the peer soo command to configure the SoO feature.

Example

# Configure a device to replace the AS number of a specified peer in the AS_Path of a route with the local AS number.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.2 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 1.1.1.2 enable
[HUAWEI-bgp-af-ipv6] peer 1.1.1.2 substitute-as

peer substitute-as (BGP-IPv6 unicast address family view) (group)

Function

The peer substitute-as command enables AS number substitution in the advertisement direction. That is, the AS number of a specified peer group in the AS_Path attribute is replaced with the local AS number.

The undo peer substitute-as command disables AS number substitution.

By default, AS number substitution is disabled.

Format

peer group-name substitute-as

undo peer group-name substitute-as

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a BGP public network scenario, when two devices with the same AS number learn a BGP route from each other through the same EBGP peer, the route may be discarded because the AS_Path attribute contains duplicate AS numbers. To prevent this problem, run the peer substitute-as command on this EBGP peer to enable AS number substitution in the advertisement direction.

Prerequisites

Enabling BGP AS number substitution may cause route loops in a CE multi-homing network. The peer soo command must be run to prevent a routing loop in a VPN site.

On BGP public networks, if three or more BGP peers form a ring network, the peer substitute-as command cannot be run; otherwise, a routing loop may occur.

Precautions

If the peer substitute-as command is run, the AS number of the route is replaced, which may cause routing loops. To solve this problem, run the peer soo command to configure the SoO feature.

Example

# Configure a device to replace the AS number of a specified peer group in the AS_Path of a route with the local AS number.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test external
[HUAWEI-bgp] peer test as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer test enable
[HUAWEI-bgp-af-ipv6] peer test substitute-as

peer substitute-as (BGP-IPv6 unicast address family view) (IPv6)

Function

The peer substitute-as command substitutes the local AS number for the AS number of a specified peer in the AS_Path attribute in the advertisement direction.

The undo peer substitute-as command disables AS number substitution.

By default, AS number substitution is disabled.

Format

peer ipv6-address substitute-as

undo peer ipv6-address substitute-as

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In an L3VPN scenario, if the ASs where two VPN sites reside use private AS numbers, the AS numbers of the two VPN sites may be the same. If a CE in a VPN site sends a VPN route to the local PE through EBGP and the remote PE sends the route to the remote CE, the remote CE discards the route due to duplicate AS numbers. As a result, different sites in the same VPN cannot communicate with each other. In this case, you need to run the peer substitute-as command on the PE to enable AS number substitution in the advertisement direction. That is, when advertising the routes learned from the remote PE to its connected CE, the PE replaces the AS number of the VPN site where the CE in the received VPN site resides with the local AS number.

In a BGP public network scenario, when two devices with the same AS number learn a BGP route from each other through the same EBGP peer, the route may be discarded because the AS_Path attribute contains duplicate AS numbers. To prevent this problem, run the peer substitute-as command on this EBGP peer to enable AS number substitution in the advertisement direction.

Prerequisites

Enabling BGP AS number substitution may cause route loops in a CE multi-homing network. The peer soo command must be run to prevent a routing loop in a VPN site.

On BGP public networks, if three or more BGP peers form a ring network, the peer substitute-as command cannot be run; otherwise, a routing loop may occur.

Precautions

If the peer substitute-as command is run, the AS number of the route is replaced, which may cause routing loops. To solve this problem, run the peer soo command to configure the SoO feature.

Example

# Configure a device to replace the AS number of a specified peer in the AS_Path of a route with the local AS number.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 enable
[HUAWEI-bgp-af-ipv6] peer 2001:DB8:1::1 substitute-as

peer substitute-as (BGP-VPN instance IPv4 address family view)

Function

The peer substitute-as command substitutes the local AS number for the AS number of a specified peer in the AS_Path attribute in the advertisement direction.

The undo peer substitute-as command disables AS number substitution.

By default, AS number substitution is disabled.

Format

peer ipv4-address substitute-as

undo peer ipv4-address substitute-as

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a BGP public network scenario, when two devices with the same AS number learn a BGP route from each other through the same EBGP peer, the route may be discarded because the AS_Path attribute contains duplicate AS numbers. To prevent this problem, run the peer substitute-as command on this EBGP peer to enable AS number substitution in the advertisement direction.

Prerequisites

Enabling BGP AS number substitution may cause route loops in a CE multi-homing network. The peer soo command must be run to prevent a routing loop in a VPN site.

On BGP public networks, if three or more BGP peers form a ring network, the peer substitute-as command cannot be run; otherwise, a routing loop may occur.

Precautions

If the peer substitute-as command is run, the AS number of the route is replaced, which may cause routing loops. To solve this problem, run the peer soo command to configure the SoO feature.

Example

# Configure a device to replace the AS number of a specified peer in the AS_Path of a route with the local AS number.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] peer 1.1.1.1 as-number 200
[HUAWEI-bgp-vpna] peer 1.1.1.1 substitute-as

peer substitute-as (BGP-VPN instance IPv4 address family view) (group)

Function

The peer substitute-as command enables AS number substitution in the advertisement direction. That is, the AS number of a specified peer group in the AS_Path attribute is replaced with the local AS number.

The undo peer substitute-as command disables AS number substitution.

By default, AS number substitution is disabled.

Format

peer group-name substitute-as

undo peer group-name substitute-as

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a BGP public network scenario, when two devices with the same AS number learn a BGP route from each other through the same EBGP peer, the route may be discarded because the AS_Path attribute contains duplicate AS numbers. To prevent this problem, run the peer substitute-as command on this EBGP peer to enable AS number substitution in the advertisement direction.

Prerequisites

Enabling BGP AS number substitution may cause route loops in a CE multi-homing network. The peer soo command must be run to prevent a routing loop in a VPN site.

On BGP public networks, if three or more BGP peers form a ring network, the peer substitute-as command cannot be run; otherwise, a routing loop may occur.

Precautions

If the peer substitute-as command is run, the AS number of the route is replaced, which may cause routing loops. To solve this problem, run the peer soo command to configure the SoO feature.

Example

# Configure a device to replace the AS number of a specified peer group in the AS_Path of a route with the local AS number.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn-af-ipv4] quit
[HUAWEI-vpn-instance-vpn] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] group test external
[HUAWEI-bgp-vpna] peer test substitute-as

peer substitute-as (BGP-VPN instance IPv6 address family view) (group)

Function

The peer substitute-as command enables AS number substitution in the advertisement direction. That is, the AS number of a specified peer group in the AS_Path attribute is replaced with the local AS number.

The undo peer substitute-as command disables AS number substitution.

By default, AS number substitution is disabled.

Format

peer group-name substitute-as

undo peer group-name substitute-as

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a BGP public network scenario, when two devices with the same AS number learn a BGP route from each other through the same EBGP peer, the route may be discarded because the AS_Path attribute contains duplicate AS numbers. To prevent this problem, run the peer substitute-as command on this EBGP peer to enable AS number substitution in the advertisement direction.

Prerequisites

Enabling BGP AS number substitution may cause route loops in a CE multi-homing network. The peer soo command must be run to prevent a routing loop in a VPN site.

On BGP public networks, if three or more BGP peers form a ring network, the peer substitute-as command cannot be run; otherwise, a routing loop may occur.

Precautions

If the peer substitute-as command is run, the AS number of the route is replaced, which may cause routing loops. To solve this problem, run the peer soo command to configure the SoO feature.

Example

# Configure a device to replace the AS number of a specified peer group in the AS_Path of a route with the local AS number.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test substitute-as

peer substitute-as (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer substitute-as command substitutes the local AS number for the AS number of a specified peer in the AS_Path attribute in the advertisement direction.

The undo peer substitute-as command disables AS number substitution.

By default, AS number substitution is disabled.

Format

peer ipv6-address substitute-as

undo peer ipv6-address substitute-as

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a BGP public network scenario, when two devices with the same AS number learn a BGP route from each other through the same EBGP peer, the route may be discarded because the AS_Path attribute contains duplicate AS numbers. To prevent this problem, run the peer substitute-as command on this EBGP peer to enable AS number substitution in the advertisement direction.

Prerequisites

Enabling BGP AS number substitution may cause route loops in a CE multi-homing network. The peer soo command must be run to prevent a routing loop in a VPN site.

On BGP public networks, if three or more BGP peers form a ring network, the peer substitute-as command cannot be run; otherwise, a routing loop may occur.

Precautions

If the peer substitute-as command is run, the AS number of the route is replaced, which may cause routing loops. To solve this problem, run the peer soo command to configure the SoO feature.

Example

# Configure a device to replace the AS number of a specified peer in the AS_Path of a route with the local AS number.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 substitute-as

peer tcp-mss (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer tcp-mss command configures a TCP MSS value used when the local device establishes TCP connections with a peer.

The undo peer tcp-mss command deletes the configured TCP MSS value.

By default, no TCP MSS is configured for the local device to establish TCP connections with a peer.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address tcp-mss tcp-mss-number

undo peer ipv4-address tcp-mss

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

tcp-mss-number

Specifies the TCP MSS value used for TCP connection establishment.

The value is an integer ranging from 176 to 4096, in bytes.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer tcp-mss command to configure a TCP MSS value used when the local device establishes a TCP connection with a peer. The TCP MSS value ranges from 176 to 4096. Setting the TCP MSS for a link ensures that TCP packets can be fragmented based on a proper size even if the path MTU does not take effect. This improves network performance.

Precautions

If you change the tcp-mss-number value, the TCP connection will be re-established.

If both the peer tcp-mss and peer path-mtu auto-discovery commands are run, note the following rules:

  • If the local device obtains the path MTU, the smaller value of TCP MSS and path MTU takes effect.
  • If the local device fails to obtain the path MTU, TCP MSS takes effect.

Example

# Configure a TCP MSS value for the local device to establish TCP connections with the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 tcp-mss 200

peer tcp-mss (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer tcp-mss command configures a TCP MSS value used when the local device establishes TCP connections with a peer group.

The undo peer tcp-mss command deletes the configured TCP MSS value.

By default, no TCP MSS is configured for the local device to establish TCP connections with a peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name tcp-mss tcp-mss-number

undo peer group-name tcp-mss

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

tcp-mss-number

Specifies the TCP MSS value used for TCP connection establishment.

The value is an integer ranging from 176 to 4096, in bytes.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer tcp-mss command to configure a TCP MSS value used for TCP connection establishment so that it is used to encapsulate BGP packets when the path MTU is unavailable. Such configuration improves network performance.

Precautions

If you change the tcp-mss-number value, the TCP connection will be re-established.

If both the peer tcp-mss and peer path-mtu auto-discovery commands are run, note the following rules:

  • If the local device obtains the path MTU, the smaller value of TCP MSS and path MTU takes effect.
  • If the local device fails to obtain the path MTU, TCP MSS takes effect.

Example

# Configure a TCP MSS value for the local device to establish TCP connections with the peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test tcp-mss 200

peer tcp-mss (BGP view)

Function

The peer tcp-mss command configures a TCP MSS value used when the local device establishes TCP connections with a peer.

The undo peer tcp-mss command deletes the configured TCP MSS value.

By default, no TCP MSS is configured for the local device to establish TCP connections with a peer.

Format

peer ipv4-address tcp-mss tcp-mss-number

undo peer ipv4-address tcp-mss

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

tcp-mss-number

Specifies the TCP MSS value used for TCP connection establishment.

The value is an integer ranging from 176 to 4096, in bytes.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer tcp-mss command to configure a TCP MSS value used for TCP connection establishment so that it is used to encapsulate BGP packets when the path MTU is unavailable. Such configuration improves network performance.

Precautions

If you change the tcp-mss-number value, the TCP connection will be re-established.

If both the peer tcp-mss and peer path-mtu auto-discovery commands are run, note the following rules:

  • If the local device obtains the path MTU, the smaller value of TCP MSS and path MTU takes effect.
  • If the local device fails to obtain the path MTU, TCP MSS takes effect.

Example

# Configure a TCP MSS value for the local device to establish TCP connections with the peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 tcp-mss 200

peer tcp-mss (BGP view) (group)

Function

The peer tcp-mss command configures a TCP MSS value used when the local device establishes TCP connections with a peer group.

The undo peer tcp-mss command deletes the configured TCP MSS value.

By default, no TCP MSS is configured for the local device to establish TCP connections with a peer group.

Format

peer group-name tcp-mss tcp-mss-number

undo peer group-name tcp-mss

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

tcp-mss-number

Specifies the TCP MSS value used for TCP connection establishment.

The value is an integer ranging from 176 to 4096, in bytes.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer tcp-mss command to configure a TCP MSS value used for TCP connection establishment so that it is used to encapsulate BGP packets when the path MTU is unavailable. Such configuration improves network performance.

Precautions

If you change the tcp-mss-number value, the TCP connection will be re-established.

If both the peer tcp-mss and peer path-mtu auto-discovery commands are run, note the following rules:

  • If the local device obtains the path MTU, the smaller value of TCP MSS and path MTU takes effect.
  • If the local device fails to obtain the path MTU, TCP MSS takes effect.

Example

# Configure a TCP MSS value for the local device to establish TCP connections with the peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer test tcp-mss 200

peer tcp-mss (BGP view) (IPv6)

Function

The peer tcp-mss command configures a TCP MSS value used when the local device establishes TCP connections with a peer.

The undo peer tcp-mss command deletes the configured TCP MSS value.

By default, no TCP MSS is configured for the local device to establish TCP connections with a peer.

Format

peer ipv6-address tcp-mss tcp-mss-number

undo peer ipv6-address tcp-mss

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 peer address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

tcp-mss-number

Specifies the TCP MSS value used for TCP connection establishment.

The value is an integer ranging from 176 to 4096, in bytes.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer tcp-mss command to configure a TCP MSS value used for TCP connection establishment so that it is used to encapsulate BGP packets when the path MTU is unavailable. Such configuration improves network performance.

Precautions

If you change the tcp-mss-number value, the TCP connection will be re-established.

If both the peer tcp-mss and peer path-mtu auto-discovery commands are run, note the following rules:

  • If the local device obtains the path MTU, the smaller value of TCP MSS and path MTU takes effect.
  • If the local device fails to obtain the path MTU, TCP MSS takes effect.

Example

# Configure a TCP MSS value for the local device to establish TCP connections with the peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 100
[HUAWEI-bgp] peer 10.1.1.1 tcp-mss 200

peer tcp-mss (BGP-VPN instance IPv4 address family view)

Function

The peer tcp-mss command configures a TCP MSS value used when the local device establishes TCP connections with a peer.

The undo peer tcp-mss command deletes the configured TCP MSS value.

By default, no TCP MSS is configured for the local device to establish TCP connections with a peer.

Format

peer ipv4-address tcp-mss tcp-mss-number

undo peer ipv4-address tcp-mss

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

tcp-mss-number

Specifies the maximum TCP MSS value used for TCP connection establishment.

The value is an integer ranging from 176 to 4096, in bytes.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer tcp-mss command to configure a TCP MSS value used for TCP connection establishment so that it is used to encapsulate BGP packets when the path MTU is unavailable. Such configuration improves network performance.

Precautions

If you change the tcp-mss-number value, the TCP connection will be re-established.

If both the peer tcp-mss and peer path-mtu auto-discovery commands are run, note the following rules:

  • If the local device obtains the path MTU, the smaller value of TCP MSS and path MTU takes effect.
  • If the local device fails to obtain the path MTU, TCP MSS takes effect.

Example

# Configure a TCP MSS value for the local device to establish TCP connections with the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-vrf1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vrf1] peer 10.1.1.1 tcp-mss 200

peer tcp-mss (BGP-VPN instance IPv4 address family view) (group)

Function

The peer tcp-mss command configures a TCP MSS value used when the local device establishes TCP connections with a peer group.

The undo peer tcp-mss command deletes the configured TCP MSS value.

By default, no TCP MSS is configured for the local device to establish TCP connections with a peer group.

Format

peer group-name tcp-mss tcp-mss-number

undo peer group-name tcp-mss

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

tcp-mss-number

Specifies the TCP MSS value used for TCP connection establishment.

The value is an integer ranging from 176 to 4096, in bytes.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer tcp-mss command to configure a TCP MSS value used for TCP connection establishment so that it is used to encapsulate BGP packets when the path MTU is unavailable. Such configuration improves network performance.

Precautions

If you change the tcp-mss-number value, the TCP connection will be re-established.

If both the peer tcp-mss and peer path-mtu auto-discovery commands are run, note the following rules:

  • If the local device obtains the path MTU, the smaller value of TCP MSS and path MTU takes effect.
  • If the local device fails to obtain the path MTU, TCP MSS takes effect.

Example

# Configure a TCP MSS value for the local device to establish TCP connections with the peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test
[HUAWEI-bgp-vpn1] peer test tcp-mss 200

peer tcp-mss (BGP-VPN instance IPv6 address family view) (group)

Function

The peer tcp-mss command configures a TCP MSS value used when the local device establishes TCP connections with a peer group.

The undo peer tcp-mss command deletes the configured TCP MSS value.

By default, no TCP MSS is configured for the local device to establish TCP connections with a peer group.

Format

peer group-name tcp-mss tcp-mss-number

undo peer group-name tcp-mss

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

tcp-mss-number

Specifies the TCP MSS value used for TCP connection establishment.

The value is an integer ranging from 176 to 4096, in bytes.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer tcp-mss command to configure a TCP MSS value. The value ranges from 176 to 4096 and used for TCP connection establishment so that it is used to encapsulate BGP packets when the path MTU is unavailable. Such configuration improves network performance.

Precautions

If you change the tcp-mss-number value, the TCP connection will be re-established.

If both the peer tcp-mss and peer path-mtu auto-discovery commands are run, note the following rules:

  • If the local device obtains the path MTU, the smaller value of TCP MSS and path MTU takes effect.
  • If the local device fails to obtain the path MTU, TCP MSS takes effect.

Example

# Configure a TCP MSS value for the local device to establish TCP connections with the peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test tcp-mss 200

peer tcp-mss (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer tcp-mss command configures a TCP MSS value used when the local device establishes TCP connections with a peer.

The undo peer tcp-mss command deletes the configured TCP MSS value.

By default, no TCP MSS is configured for the local device to establish TCP connections with a peer.

Format

peer ipv6-address tcp-mss tcp-mss-number

undo peer ipv6-address tcp-mss

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

tcp-mss-number

Specifies the maximum TCP MSS value used for TCP connection establishment.

The value is an integer ranging from 176 to 4096, in bytes.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer tcp-mss command to configure a TCP MSS value used for TCP connection establishment so that it is used to encapsulate BGP packets when the path MTU is unavailable. Such configuration improves network performance.

Precautions

If you change the tcp-mss-number value, the TCP connection will be re-established.

If both the peer tcp-mss and peer path-mtu auto-discovery commands are run, note the following rules:

  • If the local device obtains the path MTU, the smaller value of TCP MSS and path MTU takes effect.
  • If the local device fails to obtain the path MTU, TCP MSS takes effect.

Example

# Configure a TCP MSS value for the local device to establish TCP connections with the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 tcp-mss 200

peer tcp-mss (BGP-VPN instance view)

Function

The peer tcp-mss command configures a TCP MSS value used when the local device establishes TCP connections with a peer.

The undo peer tcp-mss command deletes the configured TCP MSS value.

By default, no TCP MSS is configured for the local device to establish TCP connections with a peer.

Format

peer ipv4-address tcp-mss tcp-mss-number

undo peer ipv4-address tcp-mss

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

tcp-mss-number

Specifies the TCP MSS value used for TCP connection establishment.

The value is an integer ranging from 176 to 4096, in bytes.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer tcp-mss command to configure a TCP MSS value used for TCP connection establishment so that it is used to encapsulate BGP packets when the path MTU is unavailable. Such configuration improves network performance.

Precautions

If you change the tcp-mss-number value, the TCP connection will be re-established.

If both the peer tcp-mss and peer path-mtu auto-discovery commands are run, note the following rules:

  • If the local device obtains the path MTU, the smaller value of TCP MSS and path MTU takes effect.
  • If the local device fails to obtain the path MTU, TCP MSS takes effect.

Example

# Configure a TCP MSS value for the local device to establish TCP connections with the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 tcp-mss 200

peer tcp-mss (BGP-VPN instance view) (group)

Function

The peer tcp-mss command configures a TCP MSS value used when the local device establishes TCP connections with a peer group.

The undo peer tcp-mss command deletes the configured TCP MSS value.

By default, no TCP MSS is configured for the local device to establish TCP connections with a peer group.

Format

peer group-name tcp-mss tcp-mss-number

undo peer group-name tcp-mss

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

tcp-mss-number

Specifies the TCP MSS value used for TCP connection establishment.

The value is an integer ranging from 176 to 4096, in bytes.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer tcp-mss command to configure a TCP MSS value used for TCP connection establishment so that it is used to encapsulate BGP packets when the path MTU is unavailable. Such configuration improves network performance.

Example

# Configure a TCP MSS value for the local device to establish TCP connections with the peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test
[HUAWEI-bgp-instance-vpn1] peer test tcp-mss 200

peer tcp-mss (BGP-VPN instance view) (IPv6)

Function

The peer tcp-mss command configures a TCP MSS value used when the local device establishes TCP connections with a peer.

The undo peer tcp-mss command deletes the configured TCP MSS value.

By default, no TCP MSS is configured for the local device to establish TCP connections with a peer.

Format

peer ipv6-address tcp-mss tcp-mss-number

undo peer ipv6-address tcp-mss

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

tcp-mss-number

Specifies the TCP MSS value used for TCP connection establishment.

The value is an integer ranging from 176 to 4096, in bytes.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the peer tcp-mss command to configure a TCP MSS value used for TCP connection establishment so that it is used to encapsulate BGP packets when the path MTU is unavailable. Such configuration improves network performance.

Example

# Configure a TCP MSS value for the local device to establish TCP connections with the peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 tcp-mss 200

peer timer (BGP multi-instance view)

Function

The peer timer command sets the Keepalive time and hold time for a peer.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the keepalive time is 60s, the hold time is 180s, and the session hold time is 360s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address timer keepalive keepalive-time hold hold-time

peer ipv4-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

peer ipv4-address timer send-hold send-hold-time

undo peer ipv4-address timer keepalive hold

undo peer ipv4-address timer keepalive keepalive-time hold hold-time

undo peer ipv4-address timer keepalive hold min-holdtime

undo peer ipv4-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer ipv4-address timer send-hold send-hold-time

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer ranging from 0 to 21845, in seconds. The default value is 60 seconds.

hold hold-time

Indicates the hold time.

The value is an integer that can be 0 or ranges from 3 to 65535, in seconds. The default value is 180.

Setting the Hold timer to be longer than 20s is recommended. If the hold time is shorter than 20s, the BGP peer session may be interrupted.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

send-hold send-hold-time

Specifies the interval for holding a session when the local end fails to send messages.

The value is 0 or an integer ranging from 360 to 3600, in seconds. The default value is 360. The value 0 indicates that the function is disabled.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers periodically send Keepalive messages to each other to detect the status of the BGP connection. If any of the following situations occurs on the device:

  1. The local end does not receive any Keepalive message or any other types of messages from the peer end within the hold time.
  2. No Keepalive message or other types of messages are sent to the peer end within the specified session hold time.

    The BGP connection is considered interrupted, and the BGP connection exits.

    The keepalive-time and hold-time values are determined through negotiation between peers. The smaller value of hold-time contained in Open messages of both peers is taken as the value of hold-time. The smaller value of one third of the negotiated hold-time and locally configured keepalive-time is taken as the final value of keepalive-time.

    This command is used to set the Keepalive time and hold time.
  • If Keepalive time and hold time are reduced, BGP can detect link faultd more quickly. This speeds up link switching, but increases the number of Keepalive messages on the network and loads of devices and consumes more network bandwidth resources.
  • If Keepalive time and holdtime are increased, the number of Keepalive messages on the network is reduced. This reduces device loads and network bandwidth consumption. If the Keepalive time is too long, BGP cannot detect link status changes in time, which may cause many messages to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Hold time must be at least three times the Keepalive time.

Avoid the following situations when settting the timers:

  • If both keepalive-time and hold-time are set to 0, the BGP timers become invalid. That is, BGP does not detect link faults based on the timers, which may cause great traffic loss.
  • The value of hold-time is much greater than that of keepalive-time, for example, keepalive 1 hold 65535. In this case, there are a large number of Keepalive messages on the network, and BGP does not consider the connection interrupted even if it does not receive any Keepalive message for a long time.
  • If keepalive-time is set to 0, the keepalive timer does not start and the send-hold timer does not take effect.

The Keepalive time and Hold time can be configured globally, or for a specified peer or peer group. The Keepalive time and Hold time configured for a specific peer take precedence over those configured for the corresponding peer group, and the Keepalive time and Hold time configured for a peer group take precedence over those configured globally. Using this command can still configure the Keepalive time and Hold time for a peer or peer group, although a global Keepalive time and Hold time have been configured.

After the keep-all-routes command is run, the undo peer timer keepalive command does not take effect after it is run. In this case, you can run the undo keep-all-routes command and then the peer timer keepalive command.

Example

# Set the Keepalive time and hold time for peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 10.1.1.1 timer keepalive 10 hold 30
# Set the session hold time for a specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 10.1.1.1 timer send-hold 720

peer timer (BGP multi-instance view) (group)

Function

The peer timer command sets the Keepalive time and hold time for a peer group.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the Keepalive time is 60s, and the hold time is 180s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name timer keepalive keepalive-time hold hold-time

peer group-name timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer group-name timer keepalive hold

undo peer group-name timer keepalive keepalive-time hold hold-time

undo peer group-name timer keepalive hold min-holdtime

undo peer group-name timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer in the range from 0 to 21845, in seconds. The default value is 60.

hold hold-time

Indicates the hold time.

The value is an integer that can be 0 or ranges from 3 to 65535, in seconds. The default value is 180.

Setting the hold time to be longer than 20s is recommended. If the hold time is shorter than 20s, the peer session may be interrupted.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers send Keepalive messages periodically to each other to detect the status of the BGP connection. If a device receives no Keepalive message or any other types of packets from its peer within the holdtime, the device considers the BGP connection closed, and it closes the BGP connection.

When the peers set up a connection, keepalive-time and hold-time are determined by negotiations between the peers. Each of the two peers sends the other an Open packet containing hold-time. The smaller hold-time contained in the Open packets from both peers is used. The smaller of the locally configured keepalive-time and one third of the negotiated hold-time is used as the actual keepalive-time.

The peer timer command is used to set the Keepalive time and hold time:

  • If a short Keepalive time and hold time are set, BGP can detect a link fault quickly and implement link switching. The number of Keepalive messages on the network, however, is increased. This increases device loads and consumption of network bandwidth resources.
  • If a long Keepalive time and hold time are set, the number of Keepalive messages on the network is reduced. This reduces device loads. If, however, the Keepalive time is too long, BGP is unable to detect link status changes in time, causing many packets to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Hold time must be at least three times the Keepalive time.

When setting the values of Keepalive time and Hold time, avoid the following configurations:

  • If the values of keepalive-time and hold-time are both set to 0, the BGP timers become invalid. That is, BGP does not detect link faults based on the timers, which may cause great traffic loss.
  • The value of hold-time is much greater than the value of keepalive-time, for example, keepalive 1 hold 65535. In this case, there are a large number of Keepalive messages on the network, and BGP does not consider that the connection is interrupted even if it does not receive Keepalive messages for a long time.

    The Keepalive period and Holdtime can be configured globally, or on a particular peer or peer group. The Keepalive period and Holdtime configured on a specific peer or peer group takes precedence over the global Keepalive period and Holdtime. Using this command can still change the Keepalive period and Holdtime configured on a peer or peer group, although they were globally configured through the timer command.

    After the keep-all-routes command is run, the undo peer timer keepalive command does not take effect. In this case, you need to run the undo keep-all-routes command and then the peer timer keepalive command.

Example

# Set the Keepalive time and hold time for peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100 instanc a
[HUAWEI-bgp-instance-a] group test
[HUAWEI-bgp-instance-a] peer test timer keepalive 10 hold 30

peer timer (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer timer command sets the Keepalive time and hold time for a peer.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the keepalive time is 60s, the hold time is 180s, and the session hold time is 360s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address timer keepalive keepalive-time hold hold-time

peer ipv4-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

peer ipv4-address timer send-hold send-hold-time

undo peer ipv4-address timer keepalive hold [ min-holdtime ]

undo peer ipv4-address timer keepalive keepalive-time hold hold-time

undo peer ipv4-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer ipv4-address timer send-hold send-hold-time

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer in the range from 0 to 21845, in seconds. The default value is 60.

hold hold-time

Indicates the hold time.

The value is an integer that can be 0 or ranges from 3 to 65535, in seconds. The default value is 180.

Setting the hold time to be longer than 20s is recommended. If the hold time is shorter than 20s, the peer session may be interrupted.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

send-hold send-hold-time

Specifies the interval for holding a session when the local end fails to send messages.

The value is 0 or an integer ranging from 360 to 3600, in seconds. The default value is 360. The value 0 indicates that the function is disabled.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers periodically send Keepalive messages to each other to detect the status of the BGP connection. If any of the following situations occurs on the device:

  1. The local end does not receive any Keepalive message or any other types of messages from the peer end within the hold time.
  2. No Keepalive message or other types of messages are sent to the peer end within the specified session hold time.

    The BGP connection is considered interrupted, and the BGP connection exits.

    The keepalive-time and hold-time values are determined through negotiation between peers. The smaller value of hold-time contained in Open messages of both peers is taken as the value of hold-time. The smaller value of one third of the negotiated hold-time and locally configured keepalive-time is taken as the final value of keepalive-time.

    This command is used to set the Keepalive time and hold time.
  • If Keepalive time and hold time are reduced, BGP can detect a link fault more quickly. This speeds up link switching, but increases the number of Keepalive messages on the network and loads of devices and consumes more network bandwidth resources.
  • If Keepalive time and holdtime are increased, the number of Keepalive messages on the network is reduced. This reduces device loads and network bandwidth consumption. If the Keepalive time is too long, BGP cannot detect link status changes in time, which may cause many messages to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Hold time must be at least three times the Keepalive time.

Avoid the following situations when setting values for the three timers:

  • If both keepalive-time and hold-time are set to 0, BGP timers become invalid. That is, BGP does not detect link faults based on the timers, which may cause great traffic loss.
  • The value of hold-time is much greater than the value of keepalive-time, for example, keepalive 1 hold 65535. In this case, there are a large number of Keepalive messages on the network. In addition, BGP does not consider the connection interrupted even if it does not receive Keepalive messages for a long time.
  • If keepalive-time is set to 0, the keepalive timer is not started and the send-hold timer function does not take effect.

The Keepalive period and Holdtime can be configured globally, or on a particular peer or peer group. The Keepalive period and Holdtime configured on a specific peer or peer group takes precedence over the global Keepalive period and Holdtime. Using this command can still change the Keepalive period and Holdtime configured on a peer or peer group, although they were globally configured through the timer command.

After the keep-all-routes command is run, the undo peer timer keepalive command does not take effect. To configure this function, run the undo keep-all-routes command and then the peer timer keepalive command.

If there is only one peer in the update peer-group, the send-hold timer does not take effect.

Example

# Set the Keepalive time and hold time for peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 timer keepalive 10 hold 30
# Set the session hold time for a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 timer send-hold 720

peer timer (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer timer command sets the Keepalive time and hold time for a peer group.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the Keepalive time is 60s, and the hold time is 180s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name timer keepalive keepalive-time hold hold-time

peer group-name timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer group-name timer keepalive hold [ min-holdtime ]

undo peer group-name timer keepalive keepalive-time hold hold-time

undo peer group-name timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer in the range from 0 to 21845, in seconds. The default value is 60.

hold hold-time

Indicates the hold time.

The value is an integer that can be 0 or ranges from 3 to 65535, in seconds. The default value is 180.

Setting the hold time to be longer than 20s is recommended. If the hold time is shorter than 20s, the peer session may be interrupted.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers send Keepalive messages periodically to each other to detect the status of the BGP connection. If a device receives no Keepalive message or any other types of packets from its peer within the holdtime, the device considers the BGP connection closed, and it closes the BGP connection.

When the peers set up a connection, keepalive-time and hold-time are determined by negotiations between the peers. Each of the two peers sends the other an Open packet containing hold-time. The smaller hold-time contained in the Open packets from both peers is used. The smaller of the locally configured keepalive-time and one third of the negotiated hold-time is used as the actual keepalive-time.

The peer timer command is used to set the Keepalive time and hold time:

  • If a short Keepalive time and hold time are set, BGP can detect a link fault quickly and implement link switching. The number of Keepalive messages on the network, however, is increased. This increases device loads and consumption of network bandwidth resources.
  • If a long Keepalive time and hold time are set, the number of Keepalive messages on the network is reduced. This reduces device loads. If, however, the Keepalive time is too long, BGP is unable to detect link status changes in time, causing many packets to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Hold time must be at least three times the Keepalive time.

When setting the values of Keepalive time and Hold time, avoid the following configurations:

  • If the values of keepalive-time and hold-time are both set to 0, the BGP timers become invalid. That is, BGP does not detect link faults based on the timers, which may cause great traffic loss.
  • The value of hold-time is much greater than the value of keepalive-time, for example, keepalive 1 hold 65535. In this case, there are a large number of Keepalive messages on the network, and BGP does not consider that the connection is interrupted even if it does not receive Keepalive messages for a long time.

    The Keepalive period and Holdtime can be configured globally, or on a particular peer or peer group. The Keepalive period and Holdtime configured on a specific peer or peer group takes precedence over the global Keepalive period and Holdtime. Using this command can still change the Keepalive period and Holdtime configured on a peer or peer group, although they were globally configured through the timer command.

    After the keep-all-routes command is run, the undo peer timer keepalive command does not take effect. In this case, you need to run the undo keep-all-routes command and then the peer timer keepalive command.

Example

# Set the Keepalive time and hold time for peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test timer keepalive 10 hold 30

peer timer (BGP view)

Function

The peer timer command sets the Keepalive time and hold time for a peer.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the keepalive time is 60s, the hold time is 180s, and the session hold time is 360s.

Format

peer ipv4-address timer keepalive keepalive-time hold hold-time

peer ipv4-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

peer ipv4-address timer send-hold send-hold-time

undo peer ipv4-address timer keepalive hold [ min-holdtime ]

undo peer ipv4-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer ipv4-address timer keepalive keepalive-time hold hold-time

undo peer ipv4-address timer send-hold send-hold-time

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer ranging from 0 to 21845, in seconds. The default value is 60 seconds.

hold hold-time

Indicates the hold time.

The value is an integer that can be 0, or ranges from 3 to 65535, in seconds. The default value is 180 seconds.

Setting the hold time of a BGP peer to be longer than 20s is recommended. If the hold time of a BGP peer is shorter than 20s, the session may be closed.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

send-hold send-hold-time

Specifies the interval for holding a session when the local end fails to send messages.

The value is 0 or an integer ranging from 360 to 3600, in seconds. The default value is 360. The value 0 indicates that the function is disabled.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers periodically send Keepalive messages to each other to detect the status of the BGP connection. If any of the following situations occurs on the device:

  1. The local end does not receive any Keepalive message or any other types of messages from the peer end within the hold time.
  2. No Keepalive message or other types of messages are sent to the peer end within the specified session hold time.

    The BGP connection is considered interrupted, and the BGP connection exits.

    The keepalive-time and hold-time values are determined through negotiation between peers. The smaller value of hold-time contained in Open messages of both peers is taken as the value of hold-time. The smaller value of one third of the negotiated hold-time and locally configured keepalive-time is taken as the final value of keepalive-time.

    This command is used to set the Keepalive time and hold time.
  • If Keepalive time and hold time are reduced, BGP can detect link faultd more quickly. This speeds up link switching, but increases the number of Keepalive messages on the network and loads of devices and consumes more network bandwidth resources.
  • If Keepalive time and holdtime are increased, the number of Keepalive messages on the network is reduced. This reduces device loads and network bandwidth consumption. If the Keepalive time is too long, BGP cannot detect link status changes in time, which may cause many messages to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Hold time must be at least three times the Keepalive time.

Avoid the following situations when setting values for the three timers:

  • If both keepalive-time and hold-time are set to 0, BGP timers become invalid. That is, BGP does not detect link faults based on the timers, which may cause great traffic loss.
  • The value of hold-time is much greater than the value of keepalive-time, for example, keepalive 1 hold 65535. In this case, there are a large number of Keepalive messages on the network. In addition, BGP does not consider the connection interrupted even if it does not receive Keepalive messages for a long time.
  • If keepalive-time is set to 0, the keepalive timer is not started and the send-hold timer function does not take effect.

The Keepalive period and Holdtime can be configured globally, or on a particular peer or peer group. The Keepalive period and Holdtime configured on a specific peer or peer group takes precedence over the global Keepalive period and Holdtime. Using this command can still change the Keepalive period and Holdtime configured on a peer or peer group, although they were globally configured through the timer command.

After the keep-all-routes command is run, the undo peer timer keepalive command does not take effect. To configure this function, run the undo keep-all-routes command and then the peer timer keepalive command.

If there is only one peer in the update peer-group, the send-hold timer does not take effect.

Example

# Set the Keepalive time and hold time for peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 timer keepalive 10 hold 30
# Set the session hold time for a specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 timer send-hold 720

peer timer (BGP view) (group)

Function

The peer timer command sets the Keepalive time and hold time for a peer group.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the Keepalive time is 60s, and the hold time is 180s.

Format

peer group-name timer keepalive keepalive-time hold hold-time

peer group-name timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer group-name timer keepalive hold [ min-holdtime ]

undo peer group-name timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer group-name timer keepalive keepalive-time hold hold-time

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer in the range from 0 to 21845, in seconds. The default value is 60.

hold hold-time

Specifies the hold time. On the same device, the value of holdTime must be at least three times the value of KeepaliveTime.

The value is an integer that can be 0 or ranges from 3 to 65535, in seconds. The default value is 180.

Setting the hold time to be longer than 20s is recommended. If the hold time is shorter than 20s, the peer session may be interrupted.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers send Keepalive messages periodically to each other to detect the status of the BGP connection. If a device receives no Keepalive message or any other types of packets from its peer within the holdtime, the device considers the BGP connection closed, and it closes the BGP connection.

When the peers set up a connection, keepalive-time and hold-time are determined by negotiations between the peers. Each of the two peers sends the other an Open packet containing hold-time. The smaller hold-time contained in the Open packets from both peers is used. The smaller of the locally configured keepalive-time and one third of the negotiated hold-time is used as the actual keepalive-time.

The peer timer command is used to set the Keepalive time and hold time:

  • If a short Keepalive time and hold time are set, BGP can detect a link fault quickly and implement link switching. The number of Keepalive messages on the network, however, is increased. This increases device loads and consumption of network bandwidth resources.
  • If a long Keepalive time and hold time are set, the number of Keepalive messages on the network is reduced. This reduces device loads. If, however, the Keepalive time is too long, BGP is unable to detect link status changes in time, causing many packets to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Hold time must be at least three times the Keepalive time.

When setting the values of Keepalive time and Hold time, avoid the following configurations:

  • If the values of keepalive-time and hold-time are both set to 0, the BGP timers become invalid. That is, BGP does not detect link faults based on the timers, which may cause great traffic loss.
  • The value of hold-time is much greater than the value of keepalive-time, for example, keepalive 1 hold 65535. In this case, there are a large number of Keepalive messages on the network, and BGP does not consider that the connection is interrupted even if it does not receive Keepalive messages for a long time.

    The Keepalive period and Holdtime can be configured globally, or on a particular peer or peer group. The Keepalive period and Holdtime configured on a specific peer or peer group takes precedence over the global Keepalive period and Holdtime. Using this command can still change the Keepalive period and Holdtime configured on a peer or peer group, although they were globally configured through the timer command.

    After the keep-all-routes command is run, the undo peer timer keepalive command does not take effect. In this case, you need to run the undo keep-all-routes command and then the peer timer keepalive command.

Example

# Set the Keepalive time and hold time for peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer test timer keepalive 10 hold 30

peer timer (BGP view) (IPv6)

Function

The peer timer command sets the Keepalive time and hold time for a peer.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the keepalive time is 60s, the hold time is 180s, and the session hold time is 360s.

Format

peer ipv6-address timer keepalive keepalive-time hold hold-time

peer ipv6-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

peer ipv6-address timer send-hold send-hold-time

undo peer ipv6-address timer keepalive hold [ min-holdtime ]

undo peer ipv6-address timer keepalive keepalive-time hold hold-time

undo peer ipv6-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer ipv6-address timer send-hold send-hold-time

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer ranging from 0 to 21845, in seconds. The default value is 60 seconds.

hold hold-time

Indicates the hold time.

The value is an integer that can be 0, or ranges from 3 to 65535, in seconds. The default value is 180 seconds.

Setting the hold time of a BGP peer to be longer than 20s is recommended. If the hold time of a BGP peer is shorter than 20s, the session may be closed.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

send-hold send-hold-time

Specifies the interval for holding a session when the local end fails to send messages.

The value is 0 or an integer ranging from 360 to 3600, in seconds. The default value is 360. The value 0 indicates that the function is disabled.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers periodically send Keepalive messages to each other to detect the status of the BGP connection. If any of the following situations occurs on the device:

  1. The local end does not receive any Keepalive message or any other types of messages from the peer end within the hold time.
  2. No Keepalive message or other types of messages are sent to the peer end within the specified session hold time.

    The BGP connection is considered interrupted, and the BGP connection exits.

    The keepalive-time and hold-time values are determined through negotiation between peers. The smaller value of hold-time contained in Open messages of both peers is taken as the value of hold-time. The smaller value of one third of the negotiated hold-time and locally configured keepalive-time is taken as the final value of keepalive-time.

    This command is used to set the Keepalive time and hold time.
  • If Keepalive time and hold time are reduced, BGP can detect link faultd more quickly. This speeds up link switching, but increases the number of Keepalive messages on the network and loads of devices and consumes more network bandwidth resources.
  • If Keepalive time and holdtime are increased, the number of Keepalive messages on the network is reduced. This reduces device loads and network bandwidth consumption. If the Keepalive time is too long, BGP cannot detect link status changes in time, which may cause many messages to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Hold time must be at least three times the Keepalive time.

Avoid the following situations when setting values for the three timers:

  • If both keepalive-time and hold-time are set to 0, BGP timers become invalid. That is, BGP does not detect link faults based on the timers, which may cause great traffic loss.
  • The value of hold-time is much greater than the value of keepalive-time, for example, keepalive 1 hold 65535. In this case, there are a large number of Keepalive messages on the network. In addition, BGP does not consider the connection interrupted even if it does not receive Keepalive messages for a long time.
  • If keepalive-time is set to 0, the keepalive timer is not started and the send-hold timer function does not take effect.

The Keepalive period and Holdtime can be configured globally, or on a particular peer or peer group. The Keepalive period and Holdtime configured on a specific peer or peer group takes precedence over the global Keepalive period and Holdtime. Using this command can still change the Keepalive period and Holdtime configured on a peer or peer group, although they were globally configured through the timer command.

After the keep-all-routes command is run, the undo peer timer keepalive command does not take effect. To configure this function, run the undo keep-all-routes command and then the peer timer keepalive command.

If there is only one peer in the update peer-group, the send-hold timer does not take effect.

Example

# Set the Keepalive timer and hold time for peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] peer 2001:DB8:1::1 timer keepalive 10 hold 30
# Set the session hold time for a specified peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] peer 2001:DB8:1::1 timer send-hold 720

peer timer (BGP-VPN instance IPv4 address family view)

Function

The peer timer command sets the Keepalive time and hold time for a peer.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the keepalive time is 60s, the hold time is 180s, and the session hold time is 360s.

Format

peer ipv4-address timer keepalive keepalive-time hold hold-time

peer ipv4-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

peer ipv4-address timer send-hold send-hold-time

undo peer ipv4-address timer keepalive hold [ min-holdtime ]

undo peer ipv4-address timer keepalive keepalive-time hold hold-time

undo peer ipv4-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer ipv4-address timer send-hold send-hold-time

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer in the range from 0 to 21845, in seconds. The default value is 60.

hold hold-time

Indicates the hold time.

The value is an integer that can be 0 or ranges from 3 to 65535, in seconds. The default value is 180.

Setting the hold time to be longer than 20s is recommended. If the hold time is shorter than 20s, the peer session may be interrupted.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

send-hold send-hold-time

Specifies the interval for holding a session when the local end fails to send messages.

The value is 0 or an integer ranging from 360 to 3600, in seconds. The default value is 360. The value 0 indicates that the function is disabled.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers periodically send Keepalive messages to each other to detect the status of the BGP connection. If any of the following situations occurs on the device:

  1. The local end does not receive any Keepalive message or any other types of messages from the peer end within the hold time.
  2. No Keepalive message or other types of messages are sent to the peer end within the specified session hold time.

    The BGP connection is considered interrupted, and the BGP connection exits.

    The keepalive-time and hold-time values are determined through negotiation between peers. The smaller value of hold-time contained in Open messages of both peers is taken as the value of hold-time. The smaller value of one third of the negotiated hold-time and locally configured keepalive-time is taken as the final value of keepalive-time.

    This command is used to set the Keepalive time and hold time.
  • If Keepalive time and hold time are reduced, BGP can detect link faultd more quickly. This speeds up link switching, but increases the number of Keepalive messages on the network and loads of devices and consumes more network bandwidth resources.
  • If Keepalive time and holdtime are increased, the number of Keepalive messages on the network is reduced. This reduces device loads and network bandwidth consumption. If the Keepalive time is too long, BGP cannot detect link status changes in time, which may cause many messages to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Hold time must be at least three times the Keepalive time.

Avoid the following situations when setting values for the three timers:

  • If both keepalive-time and hold-time are set to 0, BGP timers become invalid. That is, BGP does not detect link faults based on the timers, which may cause great traffic loss.
  • The value of hold-time is much greater than the value of keepalive-time, for example, keepalive 1 hold 65535. In this case, there are a large number of Keepalive messages on the network. In addition, BGP does not consider the connection interrupted even if it does not receive Keepalive messages for a long time.
  • If keepalive-time is set to 0, the keepalive timer is not started and the send-hold timer function does not take effect.

The Keepalive period and Holdtime can be configured globally, or on a particular peer or peer group. The Keepalive period and Holdtime configured on a specific peer or peer group takes precedence over the global Keepalive period and Holdtime. Using this command can still change the Keepalive period and Holdtime configured on a peer or peer group, although they were globally configured through the timer command.

After the keep-all-routes command is run, the undo peer timer keepalive command does not take effect. To configure this function, run the undo keep-all-routes command and then the peer timer keepalive command.

If there is only one peer in the update peer-group, the send-hold timer does not take effect.

Example

# Set the Keepalive time and hold time for peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 timer keepalive 10 hold 30
# Set the session hold time for a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 timer send-hold 720

peer timer (BGP-VPN instance IPv4 address family view) (group)

Function

The peer timer command sets the Keepalive time and hold time for a peer group.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the Keepalive time is 60s, and the hold time is 180s.

Format

peer group-name timer keepalive keepalive-time hold hold-time

peer group-name timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer group-name timer keepalive hold [ min-holdtime ]

undo peer group-name timer keepalive keepalive-time hold hold-time

undo peer group-name timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer ranging from 0 to 21845, in seconds. The default value is 60 seconds.

hold hold-time

Indicates the hold time.

The value is an integer that can be 0, or ranges from 3 to 65535, in seconds. The default value is 180 seconds.

Setting the hold time of a BGP peer group to be longer than 20s is recommended. If the hold time of a BGP peer group is shorter than 20s, the session may be closed.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers send Keepalive messages periodically to each other to detect the status of the BGP connection. If a device receives no Keepalive message or any other types of packets from its peer within the holdtime, the device considers the BGP connection closed, and it closes the BGP connection.

When the peers set up a connection, keepalive-time and hold-time are determined by negotiations between the peers. Each of the two peers sends the other an Open packet containing hold-time. The smaller hold-time contained in the Open packets from both peers is used. The smaller of the locally configured keepalive-time and one third of the negotiated hold-time is used as the actual keepalive-time.

The peer timer command is used to set the Keepalive time and hold time:

  • If a short Keepalive time and hold time are set, BGP can detect a link fault quickly and implement link switching. The number of Keepalive messages on the network, however, is increased. This increases device loads and consumption of network bandwidth resources.
  • If a long Keepalive time and hold time are set, the number of Keepalive messages on the network is reduced. This reduces device loads. If, however, the Keepalive time is too long, BGP is unable to detect link status changes in time, causing many packets to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Keepalive time must be at least three times of the hold time.

When setting keepalive-time and hold-time, note the following points:

  • It is recommended that keepalive-time and hold-time are not both set to 0; otherwise, the BGP timers are invalid, and BGP is unable to detect link faults using the timers.
  • The hold-time parameter cannot be significantly greater than the keepalive-time parameter. A setting of timer keepalive 1 hold 65535, for example, would be improper. If the hold time is too long, link faults cannot be detected in time.

    The Keepalive time and hold time can be configured globally, or on a specified peer group. The Keepalive time and hold time configured on a specific peer group takes precedence over the global Keepalive time and hold time. Using this command can still change the Keepalive time and hold time configured on a peer group, although they were globally configured through the timer command.

    After the keep-all-routes command is run, the undo peer timer keepalive command becomes ineffective. To have the undo peer timer keepalive command become effective, run the undo keep-all-routes command and then the peer timer keepalive command.

Example

# Set the Keepalive time and hold time for peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test
[HUAWEI-bgp-vpn1] peer test timer keepalive 10 hold 30

peer timer (BGP-VPN instance IPv6 address family view) (group)

Function

The peer timer command sets the Keepalive time and hold time for a peer group.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the Keepalive time is 60s, and the hold time is 180s.

Format

peer group-name timer keepalive keepalive-time hold hold-time

peer group-name timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer group-name timer keepalive hold [ min-holdtime ]

undo peer group-name timer keepalive keepalive-time hold hold-time

undo peer group-name timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer in the range from 0 to 21845, in seconds. The default value is 60.

hold hold-time

Indicates the hold time.

The value is an integer that can be 0 or ranges from 3 to 65535, in seconds. The default value is 180.

Setting the hold time to be longer than 20s is recommended. If the hold time is shorter than 20s, the peer session may be interrupted.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than or equal to hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers send Keepalive messages periodically to each other to detect the status of the BGP connection. If a device receives no Keepalive message or any other types of packets from its peer within the holdtime, the device considers the BGP connection closed, and it closes the BGP connection.

When the peers set up a connection, keepalive-time and hold-time are determined by negotiations between the peers. Each of the two peers sends the other an Open packet containing hold-time. The smaller hold-time contained in the Open packets from both peers is used. The smaller of the locally configured keepalive-time and one third of the negotiated hold-time is used as the actual keepalive-time.

The peer timer command is used to set the Keepalive time and hold time:

  • If a short Keepalive time and hold time are set, BGP can detect a link fault quickly and implement link switching. The number of Keepalive messages on the network, however, is increased. This increases device loads and consumption of network bandwidth resources.
  • If a long Keepalive time and hold time are set, the number of Keepalive messages on the network is reduced. This reduces device loads. If, however, the Keepalive time is too long, BGP is unable to detect link status changes in time, causing many packets to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Hold time must be at least three times the Keepalive time.

When setting the values of Keepalive time and Hold time, avoid the following configurations:

  • If the values of keepalive-time and hold-time are both set to 0, the BGP timers become invalid. That is, BGP does not detect link faults based on the timers, which may cause great traffic loss.
  • The value of hold-time is much greater than the value of keepalive-time, for example, keepalive 1 hold 65535. In this case, there are a large number of Keepalive messages on the network, and BGP does not consider that the connection is interrupted even if it does not receive Keepalive messages for a long time.

    The Keepalive period and Holdtime can be configured globally, or on a particular peer or peer group. The Keepalive period and Holdtime configured on a specific peer or peer group takes precedence over the global Keepalive period and Holdtime. Using this command can still change the Keepalive period and Holdtime configured on a peer or peer group, although they were globally configured through the timer command.

    After the keep-all-routes command is run, the undo peer timer keepalive command does not take effect. In this case, you need to run the undo keep-all-routes command and then the peer timer keepalive command.

Example

# Set the Keepalive time and hold time for peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test timer keepalive 10 hold 30

peer timer (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer timer command sets the Keepalive time and hold time for a peer.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the keepalive time is 60s, the hold time is 180s, and the session hold time is 360s.

Format

peer ipv6-address timer keepalive keepalive-time hold hold-time

peer ipv6-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

peer ipv6-address timer send-hold send-hold-time

undo peer ipv6-address timer keepalive hold [ min-holdtime ]

undo peer ipv6-address timer keepalive keepalive-time hold hold-time

undo peer ipv6-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer ipv6-address timer send-hold send-hold-time

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer ranging from 0 to 21845, in seconds. The default value is 60 seconds.

hold hold-time

Indicates the hold time.

The value is an integer that can be 0, or ranges from 3 to 65535, in seconds. The default value is 180 seconds.

Setting the hold time of a BGP peer to be longer than 20s is recommended. If the hold time of a BGP peer is shorter than 20s, the session may be closed.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

send-hold send-hold-time

Specifies the interval for holding a session when the local end fails to send messages.

The value is 0 or an integer ranging from 360 to 3600, in seconds. The default value is 360. The value 0 indicates that the function is disabled.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers periodically send Keepalive messages to each other to detect the status of the BGP connection. If any of the following situations occurs on the device:

  1. The local end does not receive any Keepalive message or any other types of messages from the peer end within the hold time.
  2. No Keepalive message or other types of messages are sent to the peer end within the specified session hold time.

    The BGP connection is considered interrupted, and the BGP connection exits.

    The keepalive-time and hold-time values are determined through negotiation between peers. The smaller value of hold-time contained in Open messages of both peers is taken as the value of hold-time. The smaller value of one third of the negotiated hold-time and locally configured keepalive-time is taken as the final value of keepalive-time.

    This command is used to set the Keepalive time and hold time.
  • If Keepalive time and hold time are reduced, BGP can detect link faultd more quickly. This speeds up link switching, but increases the number of Keepalive messages on the network and loads of devices and consumes more network bandwidth resources.
  • If Keepalive time and holdtime are increased, the number of Keepalive messages on the network is reduced. This reduces device loads and network bandwidth consumption. If the Keepalive time is too long, BGP cannot detect link status changes in time, which may cause many messages to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Hold time must be at least three times the Keepalive time.

Avoid the following situations when setting values for the three timers:

  • If both keepalive-time and hold-time are set to 0, BGP timers become invalid. That is, BGP does not detect link faults based on the timers, which may cause great traffic loss.
  • The value of hold-time is much greater than the value of keepalive-time, for example, keepalive 1 hold 65535. In this case, there are a large number of Keepalive messages on the network. In addition, BGP does not consider the connection interrupted even if it does not receive Keepalive messages for a long time.
  • If keepalive-time is set to 0, the keepalive timer is not started and the send-hold timer function does not take effect.

The Keepalive period and Holdtime can be configured globally, or on a particular peer or peer group. The Keepalive period and Holdtime configured on a specific peer or peer group takes precedence over the global Keepalive period and Holdtime. Using this command can still change the Keepalive period and Holdtime configured on a peer or peer group, although they were globally configured through the timer command.

After the keep-all-routes command is run, the undo peer timer keepalive command does not take effect. To configure this function, run the undo keep-all-routes command and then the peer timer keepalive command.

If there is only one peer in the update peer-group, the send-hold timer does not take effect.

Example

# Configure the Keepalive time, hold time, and minimum hold time for the BGP peer relationship with peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 timer keepalive 10 hold 30 min-holdtime 20
# Set the session hold time for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 timer send-hold 720

peer timer (BGP-VPN instance view)

Function

The peer timer command sets the Keepalive time and hold time for a peer.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the keepalive time is 60s, the hold time is 180s, and the session hold time is 360s.

Format

peer ipv4-address timer keepalive keepalive-time hold hold-time

peer ipv4-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

peer ipv4-address timer send-hold send-hold-time

undo peer ipv4-address timer keepalive hold [ min-holdtime ]

undo peer ipv4-address timer keepalive keepalive-time hold hold-time

undo peer ipv4-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer ipv4-address timer send-hold send-hold-time

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer ranging from 0 to 21845, in seconds. The default value is 60 seconds.

hold hold-time

Indicates the hold time.

The value is an integer that can be 0, or ranges from 3 to 65535, in seconds. The default value is 180 seconds.

Setting the hold time of a BGP peer to be longer than 20s is recommended. If the hold time of a BGP peer is shorter than 20s, the session may be closed.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

send-hold send-hold-time

Specifies the interval for holding a session when the local end fails to send messages.

The value is 0 or an integer ranging from 360 to 3600, in seconds. The default value is 360. The value 0 indicates that the function is disabled.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers periodically send Keepalive messages to each other to detect the status of the BGP connection. If any of the following situations occurs on the device:

  1. The local end does not receive any Keepalive message or any other types of messages from the peer end within the hold time.
  2. No Keepalive message or other types of messages are sent to the peer end within the specified session hold time.

    The BGP connection is considered interrupted, and the BGP connection exits.

    The keepalive-time and hold-time values are determined through negotiation between peers. The smaller value of hold-time contained in Open messages of both peers is taken as the value of hold-time. The smaller value of one third of the negotiated hold-time and locally configured keepalive-time is taken as the final value of keepalive-time.

    This command is used to set the Keepalive time and hold time.
  • If Keepalive time and hold time are reduced, BGP can detect link faultd more quickly. This speeds up link switching, but increases the number of Keepalive messages on the network and loads of devices and consumes more network bandwidth resources.
  • If Keepalive time and holdtime are increased, the number of Keepalive messages on the network is reduced. This reduces device loads and network bandwidth consumption. If the Keepalive time is too long, BGP cannot detect link status changes in time, which may cause many messages to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Hold time must be at least three times the Keepalive time.

Avoid the following situations when setting values for the three timers:

  • If both keepalive-time and hold-time are set to 0, BGP timers become invalid. That is, BGP does not detect link faults based on the timers, which may cause great traffic loss.
  • The value of hold-time is much greater than the value of keepalive-time, for example, keepalive 1 hold 65535. In this case, there are a large number of Keepalive messages on the network. In addition, BGP does not consider the connection interrupted even if it does not receive Keepalive messages for a long time.
  • If keepalive-time is set to 0, the keepalive timer is not started and the send-hold timer function does not take effect.

The Keepalive period and Holdtime can be configured globally, or on a particular peer or peer group. The Keepalive period and Holdtime configured on a specific peer or peer group takes precedence over the global Keepalive period and Holdtime. Using this command can still change the Keepalive period and Holdtime configured on a peer or peer group, although they were globally configured through the timer command.

After the keep-all-routes command is run, the undo peer timer keepalive command does not take effect. To configure this function, run the undo keep-all-routes command and then the peer timer keepalive command.

If there is only one peer in the update peer-group, the send-hold timer does not take effect.

Example

# Set the Keepalive time and hold time for peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 timer keepalive 10 hold 30
# Set the session hold time for a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.2 timer send-hold 720

peer timer (BGP-VPN instance view) (group)

Function

The peer timer command sets the Keepalive time and hold time for a peer group.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the Keepalive time is 60s, and the hold time is 180s.

Format

peer group-name timer keepalive keepalive-time hold hold-time

peer group-name timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer group-name timer keepalive hold [ min-holdtime ]

undo peer group-name timer keepalive keepalive-time hold hold-time

undo peer group-name timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer in the range from 0 to 21845, in seconds. The default value is 60.

hold hold-time

Indicates the hold time.

The value is an integer that can be 0 or ranges from 3 to 65535, in seconds. The default value is 180.

Setting the hold time to be longer than 20s is recommended. If the hold time is shorter than 20s, the peer session may be interrupted.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers send Keepalive messages periodically to each other to detect the status of the BGP connection. If a device receives no Keepalive message or any other types of packets from its peer within the holdtime, the device considers the BGP connection closed, and it closes the BGP connection.

When the peers set up a connection, keepalive-time and hold-time are determined by negotiations between the peers. Each of the two peers sends the other an Open packet containing hold-time. The smaller hold-time contained in the Open packets from both peers is used. The smaller of the locally configured keepalive-time and one third of the negotiated hold-time is used as the actual keepalive-time.

The peer timer command is used to set the Keepalive time and hold time:

  • If a short Keepalive time and hold time are set, BGP can detect a link fault quickly and implement link switching. The number of Keepalive messages on the network, however, is increased. This increases device loads and consumption of network bandwidth resources.
  • If a long Keepalive time and hold time are set, the number of Keepalive messages on the network is reduced. This reduces device loads. If, however, the Keepalive time is too long, BGP is unable to detect link status changes in time, causing many packets to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Hold time must be at least three times the Keepalive time.

When setting the values of Keepalive time and Hold time, avoid the following configurations:

  • If the values of keepalive-time and hold-time are both set to 0, the BGP timers become invalid. That is, BGP does not detect link faults based on the timers, which may cause great traffic loss.
  • The value of hold-time is much greater than the value of keepalive-time, for example, keepalive 1 hold 65535. In this case, there are a large number of Keepalive messages on the network, and BGP does not consider that the connection is interrupted even if it does not receive Keepalive messages for a long time.

    The Keepalive period and Holdtime can be configured globally, or on a particular peer or peer group. The Keepalive period and Holdtime configured on a specific peer or peer group takes precedence over the global Keepalive period and Holdtime. Using this command can still change the Keepalive period and Holdtime configured on a peer or peer group, although they were globally configured through the timer command.

    After the keep-all-routes command is run, the undo peer timer keepalive command does not take effect. In this case, you need to run the undo keep-all-routes command and then the peer timer keepalive command.

Example

# Set the Keepalive time and hold time for peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test
[HUAWEI-bgp-instance-vpn1] peer test timer keepalive 10 hold 30

peer timer (BGP-VPN instance view) (IPv6)

Function

The peer timer command sets the Keepalive time and hold time for a peer.

The undo peer timer command restores the default Keepalive time and hold time.

By default, the keepalive time is 60s, the hold time is 180s, and the session hold time is 360s.

Format

peer ipv6-address timer keepalive keepalive-time hold hold-time

peer ipv6-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

peer ipv6-address timer send-hold send-hold-time

undo peer ipv6-address timer keepalive hold [ min-holdtime ]

undo peer ipv6-address timer keepalive keepalive-time hold hold-time

undo peer ipv6-address timer keepalive keepalive-time hold hold-time min-holdtime min-hold-value

undo peer ipv6-address timer send-hold send-hold-time

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer ranging from 0 to 21845, in seconds. The default value is 60 seconds.

hold hold-time

Indicates the hold time.

The value is an integer that can be 0, or ranges from 3 to 65535, in seconds. The default value is 180 seconds.

Setting the hold time of a BGP peer to be longer than 20s is recommended. If the hold time of a BGP peer is shorter than 20s, the session may be closed.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

send-hold send-hold-time

Specifies the interval for holding a session when the local end fails to send messages.

The value is 0 or an integer ranging from 360 to 3600, in seconds. The default value is 360. The value 0 indicates that the function is disabled.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After establishing a BGP connection, two peers periodically send Keepalive messages to each other to detect the status of the BGP connection. If any of the following situations occurs on the device:

  1. The local end does not receive any Keepalive message or any other types of messages from the peer end within the hold time.
  2. No Keepalive message or other types of messages are sent to the peer end within the specified session hold time.

    The BGP connection is considered interrupted, and the BGP connection exits.

    The keepalive-time and hold-time values are determined through negotiation between peers. The smaller value of hold-time contained in Open messages of both peers is taken as the value of hold-time. The smaller value of one third of the negotiated hold-time and locally configured keepalive-time is taken as the final value of keepalive-time.

    This command is used to set the Keepalive time and hold time.
  • If Keepalive time and hold time are reduced, BGP can detect link faultd more quickly. This speeds up link switching, but increases the number of Keepalive messages on the network and loads of devices and consumes more network bandwidth resources.
  • If Keepalive time and holdtime are increased, the number of Keepalive messages on the network is reduced. This reduces device loads and network bandwidth consumption. If the Keepalive time is too long, BGP cannot detect link status changes in time, which may cause many messages to be lost.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate keepalive-time and hold-time. Therefore, exercise caution before changing the value of a timer.

Precautions

The Hold time must be at least three times the Keepalive time.

Avoid the following situations when setting values for the three timers:

  • If both keepalive-time and hold-time are set to 0, BGP timers become invalid. That is, BGP does not detect link faults based on the timers, which may cause great traffic loss.
  • The value of hold-time is much greater than the value of keepalive-time, for example, keepalive 1 hold 65535. In this case, there are a large number of Keepalive messages on the network. In addition, BGP does not consider the connection interrupted even if it does not receive Keepalive messages for a long time.
  • If keepalive-time is set to 0, the keepalive timer is not started and the send-hold timer function does not take effect.

The Keepalive period and Holdtime can be configured globally, or on a particular peer or peer group. The Keepalive period and Holdtime configured on a specific peer or peer group takes precedence over the global Keepalive period and Holdtime. Using this command can still change the Keepalive period and Holdtime configured on a peer or peer group, although they were globally configured through the timer command.

After the keep-all-routes command is run, the undo peer timer keepalive command does not take effect. To configure this function, run the undo keep-all-routes command and then the peer timer keepalive command.

If there is only one peer in the update peer-group, the send-hold timer does not take effect.

Example

# Set the Keepalive timer and hold time for peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 timer keepalive 10 hold 30
# Set the session hold time for a specified peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 2001:DB8:1::1 timer send-hold 720

peer timer connect-retry (BGP multi-instance view)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address timer connect-retry connect-retry-time

undo peer ipv4-address timer connect-retry

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been used to create a peer.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer. A ConnectRetry interval configured on a specific peer or peer group takes precedence over a global ConnectRetry interval.

  • If both the peer ipv4-address timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer ipv4-address timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.2.2.2 as-number 200
[HUAWEI-bgp-instance-a] peer 10.2.2.2 timer connect-retry 60

peer timer connect-retry (BGP multi-instance view) (group)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer group.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name timer connect-retry connect-retry-time

undo peer group-name timer connect-retry

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer group. A ConnectRetry interval configured on a specific peer group takes precedence over a global ConnectRetry interval.

  • If both the peer ipv4-address timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer ipv4-address timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] group test
[HUAWEI-bgp-instance-a] peer test timer connect-retry 60

peer timer connect-retry (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address timer connect-retry connect-retry-time

undo peer ipv4-address timer connect-retry

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer group. A ConnectRetry interval configured on a specific peer group takes precedence over a global ConnectRetry interval.

  • If both the peer ipv4-address timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer ipv4-address timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.1 timer connect-retry 60

peer timer connect-retry (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer group.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name timer connect-retry connect-retry-time

undo peer group-name timer connect-retry

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer group. A ConnectRetry interval configured on a specific peer group takes precedence over a global ConnectRetry interval.

  • If both the peer ipv4-address timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer ipv4-address timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test external
[HUAWEI-bgp-instance-a-vpna] peer test as-number 200
[HUAWEI-bgp-instance-a-vpna] peer test timer connect-retry 60

peer timer connect-retry (BGP view)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

Format

peer ipv4-address timer connect-retry connect-retry-time

undo peer ipv4-address timer connect-retry

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

It is in dotted decimal notation.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been used to create a peer.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer. A ConnectRetry interval configured on a specific peer or peer group takes precedence over a global ConnectRetry interval.

  • If both the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.1 as-number 200
[HUAWEI-bgp] peer 10.1.1.1 timer connect-retry 60

peer timer connect-retry (BGP view) (group)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer group.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

Format

peer group-name timer connect-retry connect-retry-time

undo peer group-name timer connect-retry

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer. A ConnectRetry interval configured on a specific peer or peer group takes precedence over a global ConnectRetry interval.

  • If both the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test timer connect-retry 60

peer timer connect-retry (BGP view) (IPv6)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

Format

peer ipv6-address timer connect-retry connect-retry-time

undo peer ipv6-address timer connect-retry

Parameters

Parameter Description Value
ipv6-address

Specifies an IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer. A ConnectRetry interval configured on a specific peer or peer group takes precedence over a global ConnectRetry interval.

  • If both the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] peer 2001:DB8:1::1 timer connect-retry 60

peer timer connect-retry (BGP-VPN instance IPv4 address family view)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

Format

peer ipv4-address timer connect-retry connect-retry-time

undo peer ipv4-address timer connect-retry

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer. A ConnectRetry interval configured on a specific peer or peer group takes precedence over a global ConnectRetry interval.

  • If both the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.1 timer connect-retry 60

peer timer connect-retry (BGP-VPN instance IPv4 address family view) (group)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer group.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

Format

peer group-name timer connect-retry connect-retry-time

undo peer group-name timer connect-retry

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been used to create a peer group.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer group. A ConnectRetry interval configured on a specific peer group takes precedence over a global ConnectRetry interval.

  • If both the peer { ipv4-address | ipv6-address } timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address | ipv6-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address | ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test timer connect-retry 60

peer timer connect-retry (BGP-VPN instance IPv6 address family view) (group)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer group.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

Format

peer group-name timer connect-retry connect-retry-time

undo peer group-name timer connect-retry

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer group. A ConnectRetry interval configured on a specific peer group takes precedence over a global ConnectRetry interval.

  • If both the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test timer connect-retry 60

peer timer connect-retry (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

Format

peer ipv6-address timer connect-retry connect-retry-time

undo peer ipv6-address timer connect-retry

Parameters

Parameter Description Value
ipv6-address

Specifies an IPv6 address of a peer.

The prefix is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been used to create a peer.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer. A ConnectRetry interval configured on a specific peer or peer group takes precedence over a global ConnectRetry interval.

  • If both the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 timer connect-retry 60

peer timer connect-retry (BGP-VPN instance view)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

Format

peer ipv4-address timer connect-retry connect-retry-time

undo peer ipv4-address timer connect-retry

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer. A ConnectRetry interval configured on a specific peer or peer group takes precedence over a global ConnectRetry interval.

  • If both the peer { ipv4-address | ipv6-address } timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address | ipv6-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address | ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 10:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 1.1.1.1 as-num 100
[HUAWEI-bgp-instance-vpn1] peer 1.1.1.1 timer connect-retry 60

peer timer connect-retry (BGP-VPN instance view) (group)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer group.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

Format

peer group-name timer connect-retry connect-retry-time

undo peer group-name timer connect-retry

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer. A ConnectRetry interval configured on a specific peer or peer group takes precedence over a global ConnectRetry interval.

  • If both the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test
[HUAWEI-bgp-instance-vpn1] peer test timer connect-retry 60

peer timer connect-retry (BGP-VPN instance view) (IPv6)

Function

The peer timer connect-retry command sets a ConnectRetry interval for a peer.

The undo peer timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

Format

peer ipv6-address timer connect-retry connect-retry-time

undo peer ipv6-address timer connect-retry

Parameters

Parameter Description Value
ipv6-address

Specifies an IPv6 address of a peer.

The prefix is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been used to create a peer.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer. A ConnectRetry interval configured on a specific peer or peer group takes precedence over a global ConnectRetry interval.

  • If both the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the ConnectRetry interval to 60s for peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test timer connect-retry 60

peer tracking (BGP multi-instance view)

Function

The peer tracking command enables BGP Peer Tracking. That is, you can configure BGP to fast detect the unreachable state of a peer and re-establish the connection between the local device and the peer.

The undo peer tracking command disables BGP Peer Tracking.

By default, BGP Peer Tracking is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address tracking [ delay delay-time ]

undo peer ipv4-address tracking

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

delay delay-time

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

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

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP peers successfully perform the GR negotiation, the master/slave switchover occurs on the BGP peers, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Prerequisites

The peer as-number command has been used to create a peer or peer group.

Precautions

IGP is configured with GR, and the BGP peer relationship is established based on IGP routes. In such a situation, when a node fails on the network and the master/slave switchover occurs on the node, IGP does not delete the routes from the node, and BGP peers cannot sense the fault on the node. Therefore, the BGP Peer Tracking function does not take effect.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a] peer 10.1.1.1 tracking

peer tracking (BGP multi-instance view) (group)

Function

The peer tracking command enables BGP Peer Tracking. That is, you can configure BGP to fast detect the unreachable state of a peer and re-establish the connection between the local device and the peer.

The undo peer tracking command disables BGP Peer Tracking.

By default, BGP Peer Tracking is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name tracking [ delay delay-time ]

undo peer group-name tracking

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

delay delay-time

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

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

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP neighbors successfully perform the GR negotiation, the master/slave switchover occurs on the BGP neighbors, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Prerequisites

The peer as-number command has been used to create a peer group.

Precautions

IGP is configured with GR, and the BGP neighbor relationship is established based on IGP routes. In such a situation, when a node fails on the network and the master/slave switchover occurs on the node, IGP does not delete the routes from the node, and BGP neighbors cannot sense the fault on the node. Therefore, the BGP Peer Tracking function does not take effect.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] group test
[HUAWEI-bgp-instance-a] peer test tracking

peer tracking (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer tracking command enables BGP Peer Tracking. That is, you can configure BGP to fast detect the unreachable state of a peer and re-establish the connection between the local device and the peer.

The undo peer tracking command disables BGP Peer Tracking.

By default, BGP Peer Tracking is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address tracking [ delay delay-time ]

undo peer ipv4-address tracking

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

delay delay-time

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

An integer ranging from 0 to 65535, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP neighbors successfully perform the GR negotiation, the master/slave switchover occurs on the BGP neighbors, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

IGP is configured with GR, and the BGP neighbor relationship is established based on IGP routes. In such a situation, when a node fails on the network and the master/slave switchover occurs on the node, IGP does not delete the routes from the node, and BGP neighbors cannot sense the fault on the node. Therefore, the BGP Peer Tracking function does not take effect.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-a-vrf1] peer 10.1.1.1 tracking

peer tracking (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer tracking command enables BGP Peer Tracking. That is, you can configure BGP to fast detect the unreachable state of a peer and re-establish the connection between the local device and the peer.

The undo peer tracking command disables BGP Peer Tracking.

By default, BGP Peer Tracking is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name tracking [ delay delay-time ]

undo peer group-name tracking

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

delay delay-time

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

An integer ranging from 0 to 65535, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP neighbors successfully perform the GR negotiation, the master/slave switchover occurs on the BGP neighbors, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

IGP is configured with GR, and the BGP neighbor relationship is established based on IGP routes. In such a situation, when a node fails on the network and the master/slave switchover occurs on the node, IGP does not delete the routes from the node, and BGP neighbors cannot sense the fault on the node. Therefore, the BGP Peer Tracking function does not take effect.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group test
[HUAWEI-bgp-instance-a-vpna] peer test tracking

peer tracking (BGP view)

Function

The peer tracking command enables BGP Peer Tracking. That is, you can configure BGP to fast detect the unreachable state of a peer and re-establish the connection between the local device and the peer.

The undo peer tracking command disables BGP Peer Tracking.

By default, BGP Peer Tracking is disabled.

Format

peer ipv4-address tracking [ delay delay-time ]

undo peer ipv4-address tracking

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

delay delay-time

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

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

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP peers successfully perform the GR negotiation, the master/slave switchover occurs on the BGP peers, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Prerequisites

The peer as-number command has been used to create a peer.

Precautions

IGP is configured with GR, and the BGP peer relationship is established based on IGP routes. In such a situation, when a node fails on the network and the master/slave switchover occurs on the node, IGP does not delete the routes from the node, and BGP peers cannot sense the fault on the node. Therefore, the BGP Peer Tracking function does not take effect.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] peer 10.1.1.2 tracking delay 20

peer tracking (BGP view) (group)

Function

The peer tracking command enables BGP Peer Tracking. That is, you can configure BGP to fast detect the unreachable state of a peer and re-establish the connection between the local device and the peer.

The undo peer tracking command disables BGP Peer Tracking.

By default, BGP Peer Tracking is disabled.

Format

peer group-name tracking [ delay delay-time ]

undo peer group-name tracking

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

delay delay-time

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

An integer ranging from 0 to 65535, in seconds.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP neighbors successfully perform the GR negotiation, the master/slave switchover occurs on the BGP neighbors, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

IGP is configured with GR, and the BGP neighbor relationship is established based on IGP routes. In such a situation, when a node fails on the network and the master/slave switchover occurs on the node, IGP does not delete the routes from the node, and BGP neighbors cannot sense the fault on the node. Therefore, the BGP Peer Tracking function does not take effect.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group test
[HUAWEI-bgp] peer test tracking delay 20

peer tracking (BGP view) (IPv6)

Function

The peer tracking command enables BGP Peer Tracking. That is, you can configure BGP to fast detect the unreachable state of a peer and re-establish the connection between the local device and the peer.

The undo peer tracking command disables BGP Peer Tracking.

By default, BGP Peer Tracking is disabled.

Format

peer ipv6-address tracking [ delay delay-time ]

undo peer ipv6-address tracking

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

delay delay-time

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

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

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP neighbors successfully perform the GR negotiation, the master/slave switchover occurs on the BGP neighbors, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Prerequisites

The peer as-number command has been used to create a peer.

Precautions

IGP is configured with GR, and the BGP neighbor relationship is established based on IGP routes. In such a situation, when a node fails on the network and the master/slave switchover occurs on the node, IGP does not delete the routes from the node, and BGP neighbors cannot sense the fault on the node. Therefore, the BGP Peer Tracking function does not take effect.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp] peer 2001:DB8:1::1 tracking

peer tracking (BGP-VPN instance IPv4 address family view)

Function

The peer tracking command enables BGP Peer Tracking. That is, you can configure BGP to fast detect the unreachable state of a peer and re-establish the connection between the local device and the peer.

The undo peer tracking command disables BGP Peer Tracking.

By default, BGP Peer Tracking is disabled.

Format

peer ipv4-address tracking [ delay delay-time ]

undo peer ipv4-address tracking

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

delay delay-time

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

An integer ranging from 0 to 65535, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP neighbors successfully perform the GR negotiation, the master/slave switchover occurs on the BGP neighbors, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

IGP is configured with GR, and the BGP neighbor relationship is established based on IGP routes. In such a situation, when a node fails on the network and the master/slave switchover occurs on the node, IGP does not delete the routes from the node, and BGP neighbors cannot sense the fault on the node. Therefore, the BGP Peer Tracking function does not take effect.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.2 as-number 100
[HUAWEI-bgp-vpn1] peer 10.1.1.2 tracking delay 20

peer tracking (BGP-VPN instance IPv4 address family view) (group)

Function

The peer tracking command enables BGP Peer Tracking. That is, you can configure BGP to fast detect the unreachable state of a peer and re-establish the connection between the local device and the peer.

The undo peer tracking command disables BGP Peer Tracking.

By default, BGP Peer Tracking is disabled.

Format

peer group-name tracking [ delay delay-time ]

undo peer group-name tracking

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

delay delay-time

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

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

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP neighbors successfully perform the GR negotiation, the master/slave switchover occurs on the BGP neighbors, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Prerequisites

The peer as-number command has been used to create a peer group.

Precautions

IGP is configured with GR, and the BGP neighbor relationship is established based on IGP routes. In such a situation, when a node fails on the network and the master/slave switchover occurs on the node, IGP does not delete the routes from the node, and BGP neighbors cannot sense the fault on the node. Therefore, the BGP Peer Tracking function does not take effect.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] group test external
[HUAWEI-bgp-vpn1] peer test as-number 200
[HUAWEI-bgp-vpn1] peer test tracking delay 20

peer tracking (BGP-VPN instance IPv6 address family view) (group)

Function

The peer tracking command enables BGP Peer Tracking. That is, you can configure BGP to fast detect the unreachable state of a peer and re-establish the connection between the local device and the peer.

The undo peer tracking command disables BGP Peer Tracking.

By default, BGP Peer Tracking is disabled.

Format

peer group-name tracking [ delay delay-time ]

undo peer group-name tracking

Parameters

Parameter Description Value
group-name

Specifies the name of a peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

delay delay-time

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

An integer ranging from 0 to 65535, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP neighbors successfully perform the GR negotiation, the master/slave switchover occurs on the BGP neighbors, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Prerequisites

The peer as-number command has been run to create BGP peers or BGP peer groups.

Precautions

IGP is configured with GR, and the BGP neighbor relationship is established based on IGP routes. In such a situation, when a node fails on the network and the master/slave switchover occurs on the node, IGP does not delete the routes from the node, and BGP neighbors cannot sense the fault on the node. Therefore, the BGP Peer Tracking function does not take effect.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv6] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpn1
[HUAWEI-bgp-6-vpn1] group test external
[HUAWEI-bgp-6-vpn1] peer test as-number 200
[HUAWEI-bgp-6-vpn1] peer test tracking

peer tracking (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer tracking command enables BGP Peer Tracking. That is, you can configure BGP to fast detect the unreachable state of a peer and re-establish the connection between the local device and the peer.

The undo peer tracking command disables BGP Peer Tracking.

By default, BGP Peer Tracking is disabled.

Format

peer ipv6-address tracking [ delay delay-time ]

undo peer ipv6-address tracking

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

delay delay-time

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

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

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP neighbors successfully perform the GR negotiation, the master/slave switchover occurs on the BGP neighbors, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Prerequisites

The peer as-number command has been used to create a peer.

Precautions

IGP is configured with GR, and the BGP neighbor relationship is established based on IGP routes. In such a situation, when a node fails on the network and the master/slave switchover occurs on the node, IGP does not delete the routes from the node, and BGP neighbors cannot sense the fault on the node. Therefore, the BGP Peer Tracking function does not take effect.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 tracking

peer tracking (BGP-VPN instance view)

Function

The peer tracking command enables BGP Peer Tracking. That is, you can configure BGP to fast detect the unreachable state of a peer and re-establish the connection between the local device and the peer.

The undo peer tracking command disables BGP Peer Tracking.

By default, BGP Peer Tracking is disabled.

Format

peer ipv4-address tracking [ delay delay-time ]

peer ipv6-address tracking [ delay delay-time ]

undo peer ipv4-address tracking

undo peer ipv6-address tracking

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

delay delay-time

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

The value is an integer that ranges from 0 to 65535, in seconds. The default value is 0 seconds.

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP neighbors successfully perform the GR negotiation, the master/slave switchover occurs on the BGP neighbors, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Prerequisites

The peer as-number command has been used to create a peer.

Precautions

IGP is configured with GR, and the BGP neighbor relationship is established based on IGP routes. In such a situation, when a node fails on the network and the master/slave switchover occurs on the node, IGP does not delete the routes from the node, and BGP neighbors cannot sense the fault on the node. Therefore, the BGP Peer Tracking function does not take effect.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-instance-vpn1] peer 10.1.1.1 tracking

peer tracking (BGP-VPN instance view) (group)

Function

The peer tracking command enables BGP Peer Tracking. That is, you can configure BGP to fast detect the unreachable state of a peer and re-establish the connection between the local device and the peer.

The undo peer tracking command disables BGP Peer Tracking.

By default, BGP Peer Tracking is disabled.

Format

peer group-name tracking [ delay delay-time ]

undo peer group-name tracking [ delay delay-time ]

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

delay delay-time

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

The value is an integer that ranges from 0 to 65535, in seconds. The default value is 0 seconds.

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP neighbors successfully perform the GR negotiation, the master/slave switchover occurs on the BGP neighbors, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test external
[HUAWEI-bgp-instance-vpn1] peer test as-number 200
[HUAWEI-bgp-instance-vpn1] peer test tracking delay 20

peer tracking disable(BGP multi-instance VPN instance view)

Function

The peer tracking command enables BGP peer tracking. After BGP peer tracking is enabled, BGP can rapidly detect the unreachability of a peer and re-establish a connection with the peer.

The undo peer tracking command disables BGP peer tracking.

By default, BGP Peer Tracking is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer peerIpv4Addr tracking [ delay delay-val ]

peer peerIpv6Addr tracking [ delay delay-val ]

undo peer peerIpv4Addr tracking

undo peer peerIpv6Addr tracking

Parameters

Parameter Description Value
peerIpv4Addr

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

delay delay-val

Indicates the interval between when BGP detects the peer unreachable and when BGP tears down the corresponding connection.

The value is an integer that ranges from 0 to 65535, in seconds. The default value is 0 seconds.

peerIpv6Addr

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a network where BFD is unsuitable to be deployed, you can configure BGP Peer Tracking on the local device to implement fast network convergence by rapidly detecting the unreachable state of the peer.

A BGP peer is considered unreachable in either of the following situations:

  • The BGP peer's IP address does not match any route in the IP routing table.
  • The BGP peer's IP address matches a route with the outbound interface being a Null0 interface in the IP routing table.

    A proper value of delay-time can ensure network stability when a peer is detected unreachable.
  • If delay-time is set to 0, BGP immediately tears down the connection between the local device and its peer after the peer is detected unreachable.
  • If IGP route flapping occurs and delay-time for an IBGP peer is set to 0, the peer relationship between the local device and the peer alternates between Up and Down. Therefore, delay-time for an IBGP peer should be set to a value greater than the actual IGP route convergence time.
  • When BGP neighbors successfully perform the GR negotiation, the master/slave switchover occurs on the BGP neighbors, to prevent the failure of GR, delay-time should be set to a value greater than GR convergence time. If delay-time is set to be smaller than the GR convergence time, the connection between the local device and the BGP peer will be torn down, which leads to the failure of GR.

Example

# Configure BGP Peer Tracking.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn3
[HUAWEI-vpn-instance-vpn3] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] vpn-instance vpn3
[HUAWEI-bgp-instance-a-instance-vpn3] peer 10.1.1.1 as-number 200
[HUAWEI-bgp-instance-a-instance-vpn3] peer 10.1.1.1 tracking

peer valid-ttl-hops

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer or peer group.

Format

peer ipv6-address valid-ttl-hops [ hops ]

undo peer ipv6-address valid-ttl-hops

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a BGP peer.

The value is in the format of X:X:X:X:X:X:X:X.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection.

GTSM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP messages. Therefore, only one of the two functions can be enabled on a peer or peer group.

If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp] peer 2001:DB8:1::1 valid-ttl-hops 1

peer valid-ttl-hops (BGP multi-instance view)

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer or peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address valid-ttl-hops [ hops ]

undo peer ipv4-address valid-ttl-hops

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a BGP peer.

It is in dotted decimal notation.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection at the same time.

GSTM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP packet. Therefore, the two functions cannot be enabled on a peer or peer group simultaneously.

If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-a] peer 10.1.1.2 valid-ttl-hops 1

peer valid-ttl-hops (BGP multi-instance view) (group)

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer or peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name valid-ttl-hops [ hops ]

undo peer group-name valid-ttl-hops

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection at the same time.

GSTM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP packet. Therefore, the two functions cannot be enabled on a peer or peer group simultaneously.

If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] group gtsm-group external
[HUAWEI-bgp-instance-a] peer gtsm-group valid-ttl-hops 1

peer valid-ttl-hops (BGP multi-instance VPN instance IPv4 address family view)

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer or peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer ipv4-address valid-ttl-hops [ hops ]

undo peer ipv4-address valid-ttl-hops

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a BGP peer.

It is in dotted decimal notation.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection at the same time.

GSTM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP packet. Therefore, the two functions cannot be enabled on a peer or peer group simultaneously.

If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-instance-a-vpna] peer 10.1.1.2 valid-ttl-hops 1

peer valid-ttl-hops (BGP multi-instance VPN instance IPv4 address family view) (group)

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer or peer group.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

peer group-name valid-ttl-hops [ hops ]

undo peer group-name valid-ttl-hops

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection at the same time.

GSTM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP packet. Therefore, the two functions cannot be enabled on a peer or peer group simultaneously.

If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] group gtsm-group external
[HUAWEI-bgp-instance-a-vpna] peer gtsm-group valid-ttl-hops 1

peer valid-ttl-hops (BGP view)

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer or peer group.

Format

peer ipv4-address valid-ttl-hops [ hops ]

undo peer ipv4-address valid-ttl-hops

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a BGP peer.

It is in dotted decimal notation.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection at the same time.

GSTM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP packet. Therefore, the two functions cannot be enabled on a peer or peer group simultaneously.

If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 10.1.1.2 as-number 200
[HUAWEI-bgp] peer 10.1.1.2 valid-ttl-hops 1

peer valid-ttl-hops (BGP view) (group)

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer or peer group.

Format

peer group-name valid-ttl-hops [ hops ]

undo peer group-name valid-ttl-hops

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection at the same time.

GSTM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP packet. Therefore, the two functions cannot be enabled on a peer or peer group simultaneously.

If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer group.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group gtsm-group external
[HUAWEI-bgp] peer gtsm-group valid-ttl-hops 1

peer valid-ttl-hops (BGP-VPN instance IPv4 address family view)

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer or peer group.

Format

peer ipv4-address valid-ttl-hops [ hops ]

undo peer ipv4-address valid-ttl-hops

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a BGP peer.

It is in dotted decimal notation.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection at the same time.

GSTM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP packet. Therefore, the two functions cannot be enabled on a peer or peer group simultaneously.

If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] peer 10.1.1.2 as-number 200
[HUAWEI-bgp-vpn1] peer 10.1.1.2 valid-ttl-hops 1

peer valid-ttl-hops (BGP-VPN instance IPv4 address family view) (group)

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer or peer group.

Format

peer peerGroupName valid-ttl-hops [ hops ]

undo peer peerGroupName valid-ttl-hops

Parameters

Parameter Description Value
peerGroupName

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection at the same time.

GSTM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP packet. Therefore, the two functions cannot be enabled on a peer or peer group simultaneously.

If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn
[HUAWEI-vpn-instance-vpn] ipv4-family
[HUAWEI-vpn-instance-vpn-af-ipv4] quit
[HUAWEI-vpn-instance-vpn] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn
[HUAWEI-bgp-vpn] group gtsm-group
[HUAWEI-bgp-vpn] peer gtsm-group valid-ttl-hops 5

peer valid-ttl-hops (BGP-VPN instance IPv6 address family view)

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer or peer group.

Format

peer ipv6-address valid-ttl-hops [ hops ]

undo peer ipv6-address valid-ttl-hops

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a BGP peer.

The value is in the format of X:X:X:X:X:X:X:X.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection at the same time.

GSTM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP packet. Therefore, the two functions cannot be enabled on a peer or peer group simultaneously.

If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 valid-ttl-hops 5

peer valid-ttl-hops (BGP-VPN instance IPv6 address family view) (group)

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer group.

Format

peer group-name valid-ttl-hops [ hops ]

undo peer group-name valid-ttl-hops

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP or BGP4+ packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Implementation Procedure

If you run the undo peer valid-ttl-hops command without specifying any parameter, all the GTSM configurations on a peer or a peer group are deleted.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection at the same time.

NOTE:

  • GSTM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP packet. Therefore, the two functions cannot be enabled on a peer group simultaneously.
  • If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] group gtsm-group external
[HUAWEI-bgp-6-vpna] peer gtsm-group valid-ttl-hops 1

peer valid-ttl-hops (BGP-VPN instance view)

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer or peer group.

Format

peer ipv4-address valid-ttl-hops [ hops ]

undo peer ipv4-address valid-ttl-hops

Parameters

Parameter Description Value
ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection at the same time.

GSTM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP packet. Therefore, the two functions cannot be enabled on a peer or peer group simultaneously.

If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] peer 1.1.1.1 as-num 200
[HUAWEI-bgp-instance-vpn1] peer 1.1.1.1 valid-ttl-hops 1

peer valid-ttl-hops (BGP-VPN instance view) (group)

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer group.

Format

peer group-name valid-ttl-hops [ hops ]

undo peer group-name valid-ttl-hops

Parameters

Parameter Description Value
group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters and cannot contain spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP or BGP4+ packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Implementation Procedure

If you run the undo peer valid-ttl-hops command without specifying any parameter, all the GTSM configurations on a peer or a peer group are deleted.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection.

NOTE:

  • GTSM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP messages. Therefore, only one of the two functions can be enabled on a peer or peer group.
  • If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer group.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] group test
[HUAWEI-bgp-instance-vpn1] peer test valid-ttl-hops 5

peer valid-ttl-hops (BGP-VPN instance view) (IPv6)

Function

The peer valid-ttl-hops command applies the GTSM on a BGP peer or a BGP peer group.

The undo peer valid-ttl-hops command cancels the GTSM configured on a BGP peer or a BGP peer group.

By default, GTSM is not configured on any BGP peer or peer group.

Format

peer ipv6-address valid-ttl-hops [ hops ]

undo peer ipv6-address valid-ttl-hops

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a peer.

The address is in the format of X:X:X:X:X:X:X:X.

hops

Specifies the number of TTL hops to be checked.

The value is an integer that ranges from 1 to 255. The default value is 255. If you specify the parameter hops, the valid range of the TTL value in the packet to be checked is [ 255-hops+1, 255 ].

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect a device against the attacks by the forged BGP packets, you can configure GTSM to check whether the TTL value in the IP packet header is within the valid range.

Prerequisites

Before configuring GTSM for a peer group, you need to run the peer group command to add peers to the peer group.

Precautions

When this command is used in the BGP view, it is also applicable to MP-BGP extensions because they use the same TCP connection.

The GTSM configurations are symmetrical, that is, GTSM must be enabled on both ends of the BGP connection at the same time.

GSTM and EBGP-MAX-HOP are mutually exclusive because both of them affect the TTL of the sent BGP packet. Therefore, the two functions cannot be enabled on a peer or peer group simultaneously.

If GTSM is enabled on two directly connected EBGP peers, the fast sensing function on the interfaces directly connecting the EBGP peers is invalid. This is because BGP regards the EBGP peers as indirectly connected when GTSM is enabled on the EBGP peers.

Example

# Configure GTSM for a peer.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 200
[HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 valid-ttl-hops 1

preference (BGP multi-instance VPN instance IPv4 address family view)

Function

The preference command sets a priority for EBGP routes, IBGP routes, or local BGP routes. BGP routes are configured with different priorities in different address family views.

The undo preference command restores the default setting.

By default, the priorities of EBGP routes, IBGP routes, and local BGP routes are all 255.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

preference { external internal local | route-policy route-policy-name }

undo preference

Parameters

Parameter Description Value
external

Specifies the priority of an EBGP route. An EBGP route is the optimal route learned from a peer outside the local AS.

The value is an integer ranging from 1 to 255. The smaller the value is, the higher the priority is.

internal

Specifies a protocol preference of IBGP external routes, which are the optimal routes learned from peers inside the local AS.

The value is an integer ranging from 1 to 255. The smaller the value is, the higher the priority is.

local

Specifies the priority for local routes. This parameter takes effect for the following routes:

  • Manually summary routes generated using the aggregate (BGP) command.
  • Automatically summary routes generated using the summary automatic command.
  • Routes generated through remote route leaking.
  • Routes generated through local route leaking.

    For details about these routes, see Precautions.

The value is an integer ranging from 1 to 255. The smaller the value is, the higher the priority is.

route-policy route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the preference command to set priorities for BGP routes affects route selection among BGP routes and routes of other routing protocols.

After a route-policy or route-filter is configured on a device, the device sets priorities only for the routes received from peers, which meet the matching rules. The routes that do not meet the rules use the default priority.

The smaller the priority value, the higher the priority.

Prerequisites

If the preference command uses the route-policy to set the preference, you need to create a route-policy first.

Precautions

Currently, the peer route-policy or peer route-filter command cannot be used to apply a route-policy to setting priorities for BGP routes.

The preference command cannot configure a priority for routes imported using the network command or the import-route command. If a route is imported to BGP as a BGP route using the network or import-route command, the BGP route inherits the priority of the imported route.

In this command, the local parameter specifies a priority for summary routes and leaked routes. This parameter takes effect for the following routes:

  • Manually summary routes generated using the aggregate (BGP) command. The Route type field for this type of route displays Aggregated route.
  • Automatically summary routes generated using the summary automatic command. The route type for these routes displays Summary automatic route.
  • Routes generated through remote route leaking. The route type for these routes displays Remote-Cross route.
  • Routes generated through local route leaking. The route type for these routes displays Local-Cross route.

Example

# Set the priority to 2 for EBGP routes, 2 for IBGP routes, and 20 for local BGP routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-instance-vpn1] quit
[HUAWEI] bgp 100 instance aa
[HUAWEI-bgp-instance-aa] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-instance-aa-vpn1] preference 2 2 20

preference (BGP view)

Function

The preference command sets a priority for EBGP routes, IBGP routes, or local BGP routes. BGP routes are configured with different priorities in different address family views.

The undo preference command restores the default setting.

By default, the priorities of EBGP routes, IBGP routes, and local BGP routes are all 255.

Format

preference { external internal local | route-policy route-policy-name }

undo preference

Parameters

Parameter Description Value
external

Specifies the priority of an EBGP route. An EBGP route is the optimal route learned from a peer outside the local AS.

The value is an integer ranging from 1 to 255. The smaller the value is, the higher the priority is.

internal

Specifies a protocol preference of IBGP external routes, which are the optimal routes learned from peers inside the local AS.

The value is an integer ranging from 1 to 255. The smaller the value is, the higher the priority is.

local

Specifies the priority for local routes. This parameter takes effect for the following routes:

  • Manually summary routes generated using the aggregate (BGP) command.
  • Automatically summary routes generated using the summary automatic command.
  • Routes generated through remote route leaking.
  • Routes generated through local route leaking.

    For details about these routes, see Precautions.

The value is an integer that ranges from 1 to 255. A smaller value indicates a higher priority.

This parameter takes effect for the following routes:

  • Summary routes that are generated using the aggregate (BGP) command.
  • Automatic summary routes generated using the summary automatic command.
  • Remotely leaked routes.
  • Locally leaked routes.

For details about how to identify the preceding types of routes, see Precautions.

route-policy route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the preference command to set priorities for BGP routes affects route selection among BGP routes and routes of other routing protocols.

After a route-policy or route-filter is configured on a device, the device sets priorities only for the routes received from peers, which meet the matching rules. The routes that do not meet the rules use the default priority.

The smaller the priority value, the higher the priority.

Prerequisites

If the preference command uses the route-policy to set the preference, you need to create a route-policy first.

Precautions

Currently, the peer route-policy or peer route-filter command cannot be used to apply a route-policy to setting priorities for BGP routes.

The preference command cannot configure a priority for routes imported using the network command or the import-route command. If a route is imported to BGP as a BGP route using the network or import-route command, the BGP route inherits the priority of the imported route.

In this command, the local parameter specifies a priority for summary routes and leaked routes. This parameter takes effect for the following routes:

  • Manually summary routes generated using the aggregate (BGP) command. The Route type field for this type of route displays Aggregated route.
  • Automatically summary routes generated using the summary automatic command. The route type for these routes displays Summary automatic route.
  • Routes generated through remote route leaking. The route type for these routes displays Remote-Cross route.
  • Routes generated through local route leaking. The route type for these routes displays Local-Cross route.

Example

# Configure a route-filter to set a priority for BGP.
<HUAWEI> system-view
[HUAWEI] xpl route-filter aa
[HUAWEI-xpl-filter] end-filter
[HUAWEI] bgp 100
[HUAWEI-bgp] preference route-filter aa

preference (BGP-IPv4 unicast address family view)

Function

The preference command sets a priority for EBGP routes, IBGP routes, or local BGP routes. BGP routes are configured with different priorities in different address family views.

The undo preference command restores the default setting.

By default, the priorities of EBGP routes, IBGP routes, and local BGP routes are all 255.

Format

preference { external internal local | route-policy route-policy-name }

undo preference

Parameters

Parameter Description Value
external

Specifies the priority of an EBGP route. An EBGP route is the optimal route learned from a peer outside the local AS.

The value is an integer ranging from 1 to 255. The smaller the value is, the higher the priority is.

internal

Specifies a protocol preference of IBGP external routes, which are the optimal routes learned from peers inside the local AS.

The value is an integer ranging from 1 to 255. The smaller the value is, the higher the priority is.

local

Specifies a protocol preference of a local BGP route.

The value is an integer that ranges from 1 to 255. A smaller value indicates a higher priority.

This parameter takes effect for the following routes:

  • Summary routes that are generated using the aggregate (BGP) command.
  • Automatic summary routes generated using the summary automatic command.
  • Remotely leaked routes.
  • Locally leaked routes.

For details about how to identify the preceding types of routes, see Precautions.

route-policy route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the preference command to set priorities for BGP routes affects route selection among BGP routes and routes of other routing protocols.

After a route-policy or route-filter is configured on a device, the device sets priorities only for the routes received from peers, which meet the matching rules. The routes that do not meet the rules use the default priority.

The smaller the priority value, the higher the priority.

Precautions

Currently, the peer route-policy or peer route-filter command cannot be used to apply a route-policy to setting priorities for BGP routes.

The preference command cannot configure a priority for routes imported using the network command or the import-route command. If a route is imported to BGP as a BGP route using the network or import-route command, the BGP route inherits the priority of the imported route.

In this command, the local parameter specifies a priority for summary routes and leaked routes. This parameter takes effect for the following routes:

  • Manually summary routes generated using the aggregate (BGP) command. The Route type field for this type of route displays Aggregated route.
  • Automatically summary routes generated using the summary automatic command. The route type for these routes displays Summary automatic route.
  • Routes generated through remote route leaking. The route type for these routes displays Remote-Cross route.
  • Routes generated through local route leaking. The route type for these routes displays Local-Cross route.

Example

# Set the priority to 2 for EBGP routes, 2 for IBGP routes, and 20 for local BGP routes.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] preference 2 2 20

preference (BGP-IPv6 unicast address family view)

Function

The preference command sets a priority for EBGP routes, IBGP routes, or local BGP routes. BGP routes are configured with different priorities in different address family views.

The undo preference command restores the default setting.

By default, the priorities of EBGP routes, IBGP routes, and local BGP routes are all 255.

Format

preference { external internal local | route-policy route-policy-name }

undo preference

Parameters

Parameter Description Value
external

Specifies the priority of an EBGP route. An EBGP route is the optimal route learned from a peer outside the local AS.

The value is an integer ranging from 1 to 255. The smaller the value is, the higher the priority is.

internal

Specifies a protocol preference of IBGP external routes, which are the optimal routes learned from peers inside the local AS.

The value is an integer ranging from 1 to 255. The smaller the value is, the higher the priority is.

local

Specifies a protocol preference of a local BGP route.

The value is an integer that ranges from 1 to 255. A smaller value indicates a higher priority.

This parameter takes effect for the following routes:

  • Summary routes that are generated using the aggregate (BGP) command.
  • Automatic summary routes generated using the summary automatic command.
  • Remotely leaked routes.
  • Locally leaked routes.

For details about how to identify the preceding types of routes, see Precautions.

route-policy route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the preference command to set priorities for BGP routes affects route selection among BGP routes and routes of other routing protocols.

After a route-policy is configured on a device, the device sets priorities only for the routes received from peers, which meet the matching rules. The routes that do not meet the rules use the default priority.

The smaller the priority value, the higher the priority.

Prerequisites

If the preference command uses the route-policy to set the preference, you need to create a route-policy first.

Precautions

Currently, the peer route-policy command cannot be used to apply a route-policy to setting priorities for BGP routes.

The preference command cannot configure a priority for routes imported using the network command or the import-route command. If a route is imported to BGP as a BGP route using the network or import-route command, the BGP route inherits the priority of the imported route.

In this command, the local parameter specifies a priority for summary routes and leaked routes. This parameter takes effect for the following routes:

  • Manually summary routes generated using the aggregate (BGP) command. The Route type field for this type of route displays Aggregated route.
  • Automatically summary routes generated using the summary automatic command. The route type for these routes displays Summary automatic route.
  • Routes generated through remote route leaking. The route type for these routes displays Remote-Cross route.
  • Routes generated through local route leaking. The route type for these routes displays Local-Cross route.

Example

# Set the priority to 2 for EBGP routes, 2 for IBGP routes, and 20 for local BGP routes.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] preference 2 2 20

preference (BGP-VPN instance IPv4 address family view)

Function

The preference command sets a priority for EBGP routes, IBGP routes, or local BGP routes. BGP routes are configured with different priorities in different address family views.

The undo preference command restores the default setting.

By default, the priorities of EBGP routes, IBGP routes, and local BGP routes are all 255.

Format

preference { external internal local | route-policy route-policy-name }

undo preference

Parameters

Parameter Description Value
external

Specifies the priority of an EBGP route. An EBGP route is the optimal route learned from a peer outside the local AS.

The value is an integer ranging from 1 to 255. The smaller the value is, the higher the priority is.

internal

Specifies the priority of an IBGP route. An IBGP route is a route learned from a peer inside the AS.

The value is an integer ranging from 1 to 255. The smaller the value is, the higher the priority is.

local

Specifies the priority for summary and leaked routes. This parameter takes effect for the following routes:

  • Manually summary routes generated using the aggregate (BGP) command.
  • Automatically summary routes generated using the summary automatic command.
  • Routes generated through remote route leaking.
  • Routes generated through local route leaking.

    For details about these routes, see.

    Precautions.

The value is an integer ranging from 1 to 255. The smaller the value is, the higher the priority is.

route-policy route-policy-name

Specifies the name of a route-policy.

The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the preference command to set priorities for BGP routes affects route selection among BGP routes and routes of other routing protocols.

After a route-policy or route-filter is configured on a device, the device sets priorities only for the routes received from peers, which meet the matching rules. The routes that do not meet the rules use the default priority.

The smaller the priority value, the higher the priority.

Prerequisites

If the preference command uses the route-policy to set the preference, you need to create a route-policy first.

Precautions

Currently, the peer route-policy or peer route-filter command cannot be used to apply a route-policy to setting priorities for BGP routes.

The preference command cannot configure a priority for routes imported using the network command or the import-route command. If a route is imported to BGP as a BGP route using the network or import-route command, the BGP route inherits the priority of the imported route.

In this command, the local parameter specifies a priority for summary routes and leaked routes. This parameter takes effect for the following routes:

  • Manually summary routes generated using the aggregate (BGP) command. The Route type field for this type of route displays Aggregated route.
  • Automatically summary routes generated using the summary automatic command. The route type for these routes displays Summary automatic route.
  • Routes generated through remote route leaking. The route type for these routes displays Remote-Cross route.
  • Routes generated through local route leaking. The route type for these routes displays Local-Cross route.

Example

# Set the priority to 2 for EBGP routes, 2 for IBGP routes, and 20 for local BGP routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] preference 2 2 20

preference (BGP-VPN instance IPv6 address family view)

Function

The preference command sets a priority for EBGP routes, IBGP routes, or local BGP routes. BGP routes are configured with different priorities in different address family views.

The undo preference command restores the default setting.

By default, the priorities of EBGP routes, IBGP routes, and local BGP routes are all 255.

Format

preference { external internal local | route-policy route-policy-name }

undo preference

Parameters

Parameter Description Value
external

Specifies a protocol preference of an EBGP external route. EBGP routes are the optimal routes learned from peers outside the local AS.

The value is an integer ranging from 1 to 255. The smaller the value is, the higher the preference is.

internal

Specifies the protocol preference of IBGP routes (those learned from peers in the same AS).

The value is an integer that ranges from 1 to 255. A smaller value indicates a higher priority.

local

Specifies the protocol preference of a local BGP route.

The value is an integer that ranges from 1 to 255. A smaller value indicates a higher priority.

This parameter takes effect for the following routes:

  • Manually summary routes generated using the aggregate (BGP) command.
  • Automatically summary routes generated using the summary automatic command.
  • Routes obtained through remote leaking.
  • Routes obtained through local leaking.

For details about how to identify the preceding types of routes, see Precautions.

route-policy route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the preference command to set priorities for BGP routes affects route selection among BGP routes and routes of other routing protocols.

After a route-policy or route-filter is configured on a device, the device sets priorities only for the routes received from peers, which meet the matching rules. The routes that do not meet the rules use the default priority.

The smaller the priority value, the higher the priority.

Prerequisites

If the preference command uses the route-policy to set the preference, you need to create a route-policy first.

Precautions

Currently, the peer route-policy or peer route-filter command cannot be used to apply a route-policy to setting priorities for BGP routes.

The preference command cannot configure a priority for routes imported using the network command or the import-route command. If a route is imported to BGP as a BGP route using the network or import-route command, the BGP route inherits the priority of the imported route.

In this command, the local parameter specifies a priority for summary routes and leaked routes. This parameter takes effect for the following routes:

  • Manually summary routes generated using the aggregate (BGP) command. The Route type field for this type of route displays Aggregated route.
  • Automatically summary routes generated using the summary automatic command. The route type for these routes displays Summary automatic route.
  • Routes generated through remote route leaking. The route type for these routes displays Remote-Cross route.
  • Routes generated through local route leaking. The route type for these routes displays Local-Cross route.

Example

# Set a BGP route priority based on a specified route-filter.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] preference 2 2 20

prefix memory-limit (BGP multi-instance view)

Function

The prefix memory-limit command configures BGP memory protection. With BGP memory protection, BGP will no longer receive BGP routes from peers and a log will be generated if the memory usage reaches the upper limit.

The undo prefix memory-limit command disables BGP memory protection.

By default, BGP memory protection is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

prefix memory-limit

undo prefix memory-limit

Parameters

None

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If BGP keeps receiving BGP routes from peers after the memory usage reaches the upper limit, the local device will restart and a master/slave main control board switchover will be performed, which affects system stability. To address this problem, run the prefix memory-limit command to enable BGP memory protection. With BGP memory protection, BGP will no longer receive BGP routes from peers and a log will be generated if the memory usage reaches the upper limit.

Example

# Enable BGP memory protection.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] prefix memory-limit

prefix memory-limit (BGP view)

Function

The prefix memory-limit command configures BGP memory protection. With BGP memory protection, BGP will no longer receive BGP routes from peers and a log will be generated if the memory usage reaches the upper limit.

The undo prefix memory-limit command disables BGP memory protection.

By default, BGP memory protection is disabled.

Format

prefix memory-limit

undo prefix memory-limit

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If BGP keeps receiving BGP routes from peers after the memory usage reaches the upper limit, the local device will restart and a master/slave main control board switchover will be performed, which affects system stability. To address this problem, run the prefix memory-limit command to enable BGP memory protection. With BGP memory protection, BGP will no longer receive BGP routes from peers and a log will be generated if the memory usage reaches the upper limit.

Example

# Enable BGP memory protection.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] prefix memory-limit

private-4-byte-as (BGP multi-instance view)

Function

The private-4-byte-as command enables or disables the 4-byte private AS number capability.

By default, the 4-byte private AS number capability is enabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

private-4-byte-as enable

private-4-byte-as disable

Parameters

Parameter Description Value
disable

Disables the 4-byte private AS number capability.

-

enable

Enables the 4-byte private AS number capability.

-

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the 4-byte private AS number capability is enabled, private AS numbers range from 64512 to 65534, and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special use. If 4-byte private AS numbers are disabled, private AS numbers range from 64512 to 65534, and 65535 is reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

Precautions

When the private-4-byte-as command configuration changes, the device re-advertises local routes to neighbors configured with the peer public-as-only import [ force ] command.

Example

# Enable the 4-byte private AS number function.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] private-4-byte-as enable

private-4-byte-as (BGP view)

Function

The private-4-byte-as command enables or disables the 4-byte private AS number capability.

By default, the 4-byte private AS number capability is enabled.

Format

private-4-byte-as enable

private-4-byte-as disable

Parameters

Parameter Description Value
disable

Disables the 4-byte private AS number capability.

-

enable

Enables the 4-byte private AS number capability.

-

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, AS numbers range from 1 to 4294967295, including the public, private, and reserved AS numbers. If the 4-byte private AS number capability is enabled, private AS numbers range from 64512 to 65534, and from 4200000000 to 4294967294. 65535 and 4294967295 are reserved for special use. If 4-byte private AS numbers are disabled, private AS numbers range from 64512 to 65534, and 65535 is reserved for special use.

Public AS numbers can be used over the Internet, whereas private AS numbers cannot be advertised to the Internet. If private AS numbers are advertised to the Internet, routing loops may occur. Therefore, private AS numbers are used only within a routing domain.

Precautions

When the private-4-byte-as command configuration changes, the device re-advertises local routes to neighbors configured with the peer public-as-only import [ force ] command.

Example

# Enable the 4-byte private AS number function.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] private-4-byte-as enable

qos-local-id (BGP view)

Function

The qos-local-id command sets a value for the QoS local ID.

The undo qos-local-id command deletes the value set for the QoS local ID.

By default, no value is set for the QoS local ID.

Format

qos-local-id { qos-local-id | route-policy route-policy-name }

undo qos-local-id

Parameters

Parameter Description Value
qos-local-id

Specifies a value for the QoS local ID.

The value is an integer in the range from 1 to 1024.

route-policy route-policy-name

Specifies the name of the route-policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To set a value for the QoS local ID, run the qos-local-id command. The set QoS local ID is delivered to the FIB. During forwarding, the system implements QoS policies based on the QoS local IDs in the FIB. Alternatively, you can use a route-policy to set a value for the QoS local ID.

Precautions

To set a QoS local ID for the routes to be imported, you can configure one using the qos-local-id command. Alternatively, you can configure a QoS local ID in a route-policy using the apply qos-local-id command and then set the route-policy as an import policy. If different QoS local IDs are configured using the two methods, the one configured using the second method takes effect.

Example

# Set the QoS local ID to 10.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] qos-local-id 10

qos-local-id (BGP-IPv4 unicast address family view)

Function

The qos-local-id command sets a value for the QoS local ID.

The undo qos-local-id command deletes the value set for the QoS local ID.

By default, no value is set for the QoS local ID.

Format

qos-local-id { qos-local-id | route-policy route-policy-name }

undo qos-local-id

Parameters

Parameter Description Value
qos-local-id

Specifies a value for the QoS local ID.

The value is an integer in the range from 1 to 1024.

route-policy route-policy-name

Specifies the name of the route-policy.

The value is a string of 1 to 200 case-sensitive characters, spaces not supported.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To set a value for the QoS local ID, run the qos-local-id command. The set QoS local ID is delivered to the FIB. During forwarding, the system implements QoS policies based on the QoS local IDs in the FIB. Alternatively, you can use a route-policy to set a value for the QoS local ID.

Precautions

To set a QoS local ID for the routes to be imported, you can configure one using the qos-local-id command. Alternatively, you can configure a QoS local ID in a route-policy using the apply qos-local-id command and then set the route-policy as an import policy. If different QoS local IDs are configured using the two methods, the one configured using the second method takes effect.

Example

# Set the QoS local ID to 10.
<HUAWEI> system
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] qos-local-id 10

reflect between-clients (BGP multi-instance VPN instance IPv4 address family view)

Function

The reflect between-clients command enables route reflection among clients.

The undo reflect between-clients command disables route reflection among clients. If the clients of an RR are fully meshed, you can disable route reflection between the clients to reduce the cost.

By default, route reflection among clients through the RR is enabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

reflect between-clients

undo reflect between-clients

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On some networks, if the clients of an RR establish full-mesh connections with each other, they can directly exchange routing information. Route reflection among clients through the RR is unnecessary. The undo reflect between-clients command can be used to prohibit the clients from reflecting routes to each other to reduce costs.

Prerequisites

An RR has been configured.

Configuration Impact

After the undo reflect between-clients command is run, the clients of an RR are prohibited from reflecting routes.

Precautions

The reflect between-clients command is run only on RRs.

Example

# Displays routes with the large-community attribute.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] reflect between-clients

reflect between-clients (BGP view)

Function

The reflect between-clients command enables route reflection among clients.

The undo reflect between-clients command disables route reflection among clients. If the clients of an RR are fully meshed, you can disable route reflection between the clients to reduce the cost.

By default, route reflection among clients through the RR is enabled.

Format

reflect between-clients

undo reflect between-clients

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On some networks, if the clients of an RR establish full-mesh connections with each other, they can directly exchange routing information. Route reflection among clients through the RR is unnecessary. The undo reflect between-clients command can be used to prohibit the clients from reflecting routes to each other to reduce costs.

Prerequisites

An RR has been configured.

Configuration Impact

After the undo reflect between-clients command is run, the clients of an RR are prohibited from reflecting routes.

Precautions

The reflect between-clients command is run only on RRs.

Example

# Displays routes with the large-community attribute.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] reflect between-clients

reflect between-clients (BGP-IPv4 unicast address family view)

Function

The reflect between-clients command enables route reflection among clients.

The undo reflect between-clients command disables route reflection among clients. If the clients of an RR are fully meshed, you can disable route reflection between the clients to reduce the cost.

By default, route reflection among clients through the RR is enabled.

Format

reflect between-clients

undo reflect between-clients

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On some networks, if the clients of an RR establish full-mesh connections with each other, they can directly exchange routing information. Route reflection among clients through the RR is unnecessary. The undo reflect between-clients command can be used to prohibit the clients from reflecting routes to each other to reduce costs.

Prerequisites

An RR has been configured.

Configuration Impact

After the undo reflect between-clients command is run, the clients of an RR are prohibited from reflecting routes.

Precautions

The reflect between-clients command is run only on RRs.

Example

# Displays routes with the large-community attribute.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] reflect between-clients

reflect between-clients (BGP-IPv6 unicast address family view)

Function

The reflect between-clients command enables route reflection among clients.

The undo reflect between-clients command disables route reflection among clients. If the clients of an RR are fully meshed, you can disable route reflection between the clients to reduce the cost.

By default, route reflection among clients through the RR is enabled.

Format

reflect between-clients

undo reflect between-clients

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On some networks, if the clients of an RR establish full-mesh connections with each other, they can directly exchange routing information. Route reflection among clients through the RR is unnecessary. The undo reflect between-clients command can be used to prohibit the clients from reflecting routes to each other to reduce costs.

Prerequisites

An RR has been configured.

Configuration Impact

After the undo reflect between-clients command is run, the clients of an RR are prohibited from reflecting routes.

Precautions

The reflect between-clients command is run only on RRs.

Example

# Displays routes with the large-community attribute.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] reflect between-clients

reflect between-clients (BGP-VPN instance IPv4 address family view)

Function

The reflect between-clients command enables route reflection among clients.

The undo reflect between-clients command disables route reflection among clients. If the clients of an RR are fully meshed, you can disable route reflection between the clients to reduce the cost.

By default, route reflection among clients through the RR is enabled.

Format

reflect between-clients

undo reflect between-clients

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On some networks, if the clients of an RR establish full-mesh connections with each other, they can directly exchange routing information. Route reflection among clients through the RR is unnecessary. The undo reflect between-clients command can be used to prohibit the clients from reflecting routes to each other to reduce costs.

Prerequisites

An RR has been configured.

Configuration Impact

After the undo reflect between-clients command is run, the clients of an RR are prohibited from reflecting routes.

Precautions

The reflect between-clients command is run only on RRs.

Example

# Displays routes with the large-community attribute.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] reflect between-clients

reflect between-clients (BGP-VPN instance IPv6 address family view)

Function

The reflect between-clients command enables route reflection among clients.

The undo reflect between-clients command disables route reflection among clients. If the clients of an RR are fully meshed, you can disable route reflection between the clients to reduce the cost.

By default, route reflection among clients through the RR is enabled.

Format

reflect between-clients

undo reflect between-clients

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On some networks, if the clients of an RR establish full-mesh connections with each other, they can directly exchange routing information. Route reflection among clients through the RR is unnecessary. The undo reflect between-clients command can be used to prohibit the clients from reflecting routes to each other to reduce costs.

Prerequisites

An RR has been configured.

Configuration Impact

After the undo reflect between-clients command is run, the clients of an RR are prohibited from reflecting routes.

Precautions

The reflect between-clients command is run only on RRs.

Example

# Displays routes with the large-community attribute.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] reflect between-clients

reflect change-path-attribute (BGP multi-instance VPN instance IPv4 address family view)

Function

The reflect change-path-attribute command enables an RR to modify path attributes of BGP routes through an export policy.

The undo reflect change-path-attribute command disables an RR from modifying path attributes of BGP routes through an export policy.

By default, an RR is disabled from modifying path attributes of BGP routes through an export policy.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

reflect change-path-attribute

undo reflect change-path-attribute

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

According to standard protocols, RRs are disabled from modifying path attributes through an export policy; otherwise, routing loops may occur. Therefore, by default, an export policy cannot be configured on an RR to modify path attributes.

To enable an RR to modify path attributes of BGP routes through an export policy, run the reflect change-path-attribute command. The attributes that can be modified are as follows:

  • The apply as-path command modifies the AS_Path attribute of BGP routes.
  • The apply comm-filter delete command deletes a community attribute from BGP routes.
  • The apply community command modifies a community attribute of BGP routes.
  • The apply cost command modifies the MED of BGP routes.
  • The apply ip-address next-hop command modifies the next hop of BGP routes.
  • The apply ipv6 next-hop command modifies the next hop of BGP4+ routes.
  • The apply local-preference command modifies the Local_Pref of BGP routes.
  • The apply origin command modifies the origin attribute of BGP routes.
  • The apply extcommunity command modifies the VPN-Target extcommunity attribute of BGP routes.
  • The apply extcommunity soo command modifies the SoO extcommunity attribute of BGP routes.

    If the undo reflect change-path-attribute command is run, the preceding configurations on the RR do not take effect.

Precautions

Export policies on the RR do not take effect before the reflect change-path-attribute command is run. After the reflect change-path-attribute command is run, these configurations may take effect and affect BGP route selection. Exercise caution when using this command.

Note:

After you run the reflect change-path-attribute command on the RR, the peer route-policy export command takes precedence over the peer next-hop-invariable and peer next-hop-local commands.

Example

# Enable the RR to modify the route attributes of the BGP routes by using the export policy.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] reflect change-path-attribute

reflect change-path-attribute (BGP-IPv4 unicast address family view)

Function

The reflect change-path-attribute command enables an RR to modify path attributes of BGP routes through an export policy.

The undo reflect change-path-attribute command disables an RR from modifying path attributes of BGP routes through an export policy.

By default, an RR is disabled from modifying path attributes of BGP routes through an export policy.

Format

reflect change-path-attribute

undo reflect change-path-attribute

Parameters

None

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

According to standard protocols, RRs are disabled from modifying path attributes through an export policy; otherwise, routing loops may occur. Therefore, by default, an export policy cannot be configured on an RR to modify path attributes.

To enable an RR to modify path attributes of BGP routes through an export policy, run the reflect change-path-attribute command. The attributes that can be modified are as follows:

  • The apply as-path command modifies the AS_Path attribute of BGP routes.
  • The apply comm-filter delete command deletes a community attribute from BGP routes.
  • The apply community command modifies a community attribute of BGP routes.
  • The apply cost command modifies the MED of BGP routes.
  • The apply ip-address next-hop command modifies the next hop of BGP routes.
  • The apply ipv6 next-hop command modifies the next hop of BGP4+ routes.
  • The apply local-preference command modifies the Local_Pref of BGP routes.
  • The apply origin command modifies the origin attribute of BGP routes.
  • The apply extcommunity command modifies the VPN-Target extcommunity attribute of BGP routes.
  • The apply extcommunity soo command modifies the SoO extcommunity attribute of BGP routes.

    If the undo reflect change-path-attribute command is run, the preceding configurations on the RR do not take effect.

Precautions

Export policies on the RR do not take effect before the reflect change-path-attribute command is run. After the reflect change-path-attribute command is run, these configurations may take effect and affect BGP route selection. Exercise caution when using this command.

Note:

After you run the reflect change-path-attribute command on the RR, the peer route-policy export command takes precedence over the peer next-hop-invariable and peer next-hop-local commands.

Example

# Enable the RR to modify the route attributes of the BGP routes by using the export policy.
<HUAWEI> system-view
[HUAWEI] bgp 65001
[HUAWEI-bgp] reflect change-path-attribute

reflect change-path-attribute (BGP-IPv6 unicast address family view)

Function

The reflect change-path-attribute command enables an RR to modify path attributes of BGP routes through an export policy.

The undo reflect change-path-attribute command disables an RR from modifying path attributes of BGP routes through an export policy.

By default, an RR is disabled from modifying path attributes of BGP routes through an export policy.

Format

reflect change-path-attribute

undo reflect change-path-attribute

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

According to standard protocols, RRs are disabled from modifying path attributes through an export policy; otherwise, routing loops may occur. Therefore, by default, an export policy cannot be configured on an RR to modify path attributes.

To enable an RR to modify path attributes of BGP routes through an export policy, run the reflect change-path-attribute command. The attributes that can be modified are as follows:

  • The apply as-path command modifies the AS_Path attribute of BGP routes.
  • The apply comm-filter delete command deletes a community attribute from BGP routes.
  • The apply community command modifies a community attribute of BGP routes.
  • The apply cost command modifies the MED of BGP routes.
  • The apply ip-address next-hop command modifies the next hop of BGP routes.
  • The apply ipv6 next-hop command modifies the next hop of BGP4+ routes.
  • The apply local-preference command modifies the Local_Pref of BGP routes.
  • The apply origin command modifies the origin attribute of BGP routes.
  • The apply extcommunity command modifies the VPN-Target extcommunity attribute of BGP routes.
  • The apply extcommunity soo command modifies the SoO extcommunity attribute of BGP routes.

    If the undo reflect change-path-attribute command is run, the preceding configurations on the RR do not take effect.

Precautions

Export policies on the RR do not take effect before the reflect change-path-attribute command is run. After the reflect change-path-attribute command is run, these configurations may take effect and affect BGP route selection. Exercise caution when using this command.

Note:

After you run the reflect change-path-attribute command on the RR, the peer route-policy export command takes precedence over the peer next-hop-invariable and peer next-hop-local commands.

Example

# Enable the RR to modify the route attributes of the BGP routes by using the export policy.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] reflect change-path-attribute

reflect change-path-attribute (BGP-VPN instance IPv4 address family view)

Function

The reflect change-path-attribute command enables an RR to modify path attributes of BGP routes through an export policy.

The undo reflect change-path-attribute command disables an RR from modifying path attributes of BGP routes through an export policy.

By default, an RR is disabled from modifying path attributes of BGP routes through an export policy.

Format

reflect change-path-attribute

undo reflect change-path-attribute

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

According to standard protocols, RRs are disabled from modifying path attributes through an export policy; otherwise, routing loops may occur. Therefore, by default, an export policy cannot be configured on an RR to modify path attributes.

To enable an RR to modify path attributes of BGP routes through an export policy, run the reflect change-path-attribute command. The attributes that can be modified are as follows:

  • The apply as-path command modifies the AS_Path attribute of BGP routes.
  • The apply comm-filter delete command deletes a community attribute from BGP routes.
  • The apply community command modifies a community attribute of BGP routes.
  • The apply cost command modifies the MED of BGP routes.
  • The apply ip-address next-hop command modifies the next hop of BGP routes.
  • The apply ipv6 next-hop command modifies the next hop of BGP4+ routes.
  • The apply local-preference command modifies the Local_Pref of BGP routes.
  • The apply origin command modifies the origin attribute of BGP routes.
  • The apply extcommunity command modifies the VPN-Target extcommunity attribute of BGP routes.
  • The apply extcommunity soo command modifies the SoO extcommunity attribute of BGP routes.

    If the undo reflect change-path-attribute command is run, the preceding configurations on the RR do not take effect.

Precautions

If an export policy is configured on the RR, the configuration does not take effect before the reflect change-path-attribute command is run. After the reflect change-path-attribute command is run, these configurations may take effect and affect BGP route selection. Therefore, exercise caution when running the reflect change-path-attribute command.

Description:

After the reflect change-path-attribute command is run on an RR, the peer route-policy export command takes precedence over the peer next-hop-invariable and peer next-hop-local commands.

Example

# Enable the RR to modify the route attributes of the BGP routes by using the export policy.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-vpna] peer 10.1.1.1 as-number 100
[HUAWEI-bgp-instance-vpna] quit
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgpvpna] reflect change-path-attribute

reflect change-path-attribute (BGP-VPN instance IPv6 address family view)

Function

The reflect change-path-attribute command enables an RR to modify path attributes of BGP routes through an export policy.

The undo reflect change-path-attribute command disables an RR from modifying path attributes of BGP routes through an export policy.

By default, an RR is disabled from modifying path attributes of BGP routes through an export policy.

Format

reflect change-path-attribute

undo reflect change-path-attribute

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

According to standard protocols, RRs are disabled from modifying path attributes through an export policy; otherwise, routing loops may occur. Therefore, by default, an export policy cannot be configured on an RR to modify path attributes.

To enable an RR to modify path attributes of BGP routes through an export policy, run the reflect change-path-attribute command. The attributes that can be modified are as follows:

  • The apply as-path command modifies the AS_Path attribute of BGP routes.
  • The apply comm-filter delete command deletes a community attribute from BGP routes.
  • The apply community command modifies a community attribute of BGP routes.
  • The apply cost command modifies the MED of BGP routes.
  • The apply ip-address next-hop command modifies the next hop of BGP routes.
  • The apply ipv6 next-hop command modifies the next hop of BGP4+ routes.
  • The apply local-preference command modifies the Local_Pref of BGP routes.
  • The apply origin command modifies the origin attribute of BGP routes.
  • The apply extcommunity command modifies the VPN-Target extcommunity attribute of BGP routes.
  • The apply extcommunity soo command modifies the SoO extcommunity attribute of BGP routes.

    If the undo reflect change-path-attribute command is run, the preceding configurations on the RR do not take effect.

Precautions

Export policies on the RR do not take effect before the reflect change-path-attribute command is run. After the reflect change-path-attribute command is run, these configurations may take effect and affect BGP route selection. Exercise caution when using this command.

Note:

After you run the reflect change-path-attribute command on the RR, the peer route-policy export command takes precedence over the peer next-hop-invariable and peer next-hop-local commands.

Example

# Enable the RR to modify the route attributes of the BGP routes by using the export policy.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] reflect change-path-attribute

reflector cluster-id (BGP multi-instance VPN instance IPv4 address family view)

Function

The reflector cluster-id command sets a cluster ID for an RR.

The undo reflector cluster-id command deletes the cluster ID configured for an RR.

By default, each RR uses its Router ID as the cluster ID.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

reflector cluster-id { cluster-id-value | cluster-id-ipv4 }

undo reflector cluster-id

Parameters

Parameter Description Value
cluster-id-value

Specifies the IPv4 address of an RR.

The value is an integer ranging from 1 to 4294967295.

cluster-id-ipv4

Specifies the IPv4 address of an RR.

The value is in dotted decimal notation.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Sometimes, more than one RR needs to be configured in a cluster to improve network reliability and prevent single-point failures. If a cluster has more than one RR, the reflector cluster-id command needs to be used to set the same cluster ID for the RRs. This helps to identify the cluster and avoid routing loops.

Configuring an RR allows IBGP peers to advertise routes learned in the local AS to each other. The Cluster_List attribute is introduced to avoid loops within an AS. The Cluster_List is composed of a series of Cluster_IDs. It records all the RRs through which a route passes.

Precautions

To ensure that a client can learn the routes reflected by an RR, the Cluster ID configured on the RR must be different from the Cluster ID of the client (By default, the client uses its Router ID as the cluster ID). If the Cluster ID is the same as the Cluster ID of the client, the client discards received routes.

Example

# Set the cluster ID to 50 for the device that is one of the route reflectors in the cluster.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] reflector cluster-id 50

reflector cluster-id (BGP view)

Function

The reflector cluster-id command sets a cluster ID for an RR.

The undo reflector cluster-id command deletes the cluster ID configured for an RR.

By default, each RR uses its Router ID as the cluster ID.

Format

reflector cluster-id { cluster-id-value | cluster-id-ipv4 }

undo reflector cluster-id

Parameters

Parameter Description Value
cluster-id-value

Specifies the IPv4 address of an RR.

The value is an integer ranging from 1 to 4294967295.

cluster-id-ipv4

Specifies the IPv4 address of an RR.

The value is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Sometimes, more than one RR needs to be configured in a cluster to improve network reliability and prevent single-point failures. If a cluster has more than one RR, the reflector cluster-id command needs to be used to set the same cluster ID for the RRs. This helps to identify the cluster and avoid routing loops.

Configuring an RR allows IBGP peers to advertise routes learned in the local AS to each other. The Cluster_List attribute is introduced to avoid loops within an AS. The Cluster_List is composed of a series of Cluster_IDs. It records all the RRs through which a route passes.

Precautions

To ensure that clients can learn routes from the RR, the cluster ID configured on the RR must not be the same as the cluster IDs of the clients. By default, the clients use their own router IDs as their cluster IDs. If the cluster IDs are the same, the clients discard the received routes.

This command takes effect in the BGP-IPv4 unicast address family view.

Example

# Set the cluster ID to 50 for the device that is one of the route reflectors in the cluster.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] reflector cluster-id 50

reflector cluster-id (BGP-IPv4 unicast address family view)

Function

The reflector cluster-id command sets a cluster ID for an RR.

The undo reflector cluster-id command deletes the cluster ID configured for an RR.

By default, each RR uses its router ID as the cluster ID.

Format

reflector cluster-id { cluster-id-value | cluster-id-ipv4 }

undo reflector cluster-id

Parameters

Parameter Description Value
cluster-id-value

Specifies the cluster ID of an RR.

The value is an integer ranging from 1 to 4294967295.

cluster-id-ipv4

Specifies the IPv4 address of an RR.

The value is in dotted decimal notation.

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Sometimes, more than one RR needs to be configured in a cluster to improve network reliability and prevent single-point failures. If a cluster has more than one RR, the reflector cluster-id command needs to be used to set the same cluster ID for the RRs. This helps to identify the cluster and avoid routing loops.

Configuring an RR allows IBGP peers to advertise routes learned in the local AS to each other. The Cluster_List attribute is introduced to avoid loops within an AS. The Cluster_List is composed of a series of Cluster_IDs. It records all the RRs through which a route passes.

Configuration Impact

If the reflector cluster-id command is run several times, the latest configuration overrides the previous one.

Precautions

To ensure that a client can learn the routes reflected by an RR, the Cluster ID configured on the RR must be different from the Cluster ID of the client (By default, the client uses its Router ID as the cluster ID). If the Cluster ID is the same as the Cluster ID of the client, the client discards received routes.

Example

# Set the cluster ID to 50 for the device that is one of the route reflectors in the cluster.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] peer 1.1.1.1 as-number 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] reflector cluster-id 50

reflector cluster-id (BGP-IPv6 unicast address family view)

Function

The reflector cluster-id command sets a cluster ID for an RR.

The undo reflector cluster-id command deletes the cluster ID configured for an RR.

By default, each RR uses its Router ID as the cluster ID.

Format

reflector cluster-id { cluster-id-value | cluster-id-ipv4 }

undo reflector cluster-id

Parameters

Parameter Description Value
cluster-id-value

Specifies the IPv4 address of an RR.

The value is an integer ranging from 1 to 4294967295.

cluster-id-ipv4

Specifies the IPv4 address of an RR.

The value is in dotted decimal notation.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Sometimes, more than one RR needs to be configured in a cluster to improve network reliability and prevent single-point failures. If a cluster has more than one RR, the reflector cluster-id command needs to be used to set the same cluster ID for the RRs. This helps to identify the cluster and avoid routing loops.

Configuring an RR allows IBGP peers to advertise routes learned in the local AS to each other. The Cluster_List attribute is introduced to avoid loops within an AS. The Cluster_List is composed of a series of Cluster_IDs. It records all the RRs through which a route passes.

Precautions

To ensure that a client can learn the routes reflected by an RR, the Cluster ID configured on the RR must be different from the Cluster ID of the client (By default, the client uses its Router ID as the cluster ID). If the Cluster ID is the same as the Cluster ID of the client, the client discards received routes.

Example

# Set the cluster ID to 50 for the device that is one of the route reflectors in the cluster.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] reflector cluster-id 50

reflector cluster-id (BGP-VPN instance IPv4 address family view)

Function

The reflector cluster-id command sets a cluster ID for an RR.

The undo reflector cluster-id command deletes the cluster ID configured for an RR.

By default, each RR uses its Router ID as the cluster ID.

Format

reflector cluster-id { cluster-id-value | cluster-id-ipv4 }

undo reflector cluster-id

Parameters

Parameter Description Value
cluster-id-value

Specifies the IPv4 address of an RR.

The value is an integer ranging from 1 to 4294967295.

cluster-id-ipv4

Specifies the IPv4 address of an RR.

The value is in dotted decimal notation.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Sometimes, more than one RR needs to be configured in a cluster to improve network reliability and prevent single-point failures. If a cluster has more than one RR, the reflector cluster-id command needs to be used to set the same cluster ID for the RRs. This helps to identify the cluster and avoid routing loops.

Configuring an RR allows IBGP peers to advertise routes learned in the local AS to each other. The Cluster_List attribute is introduced to avoid loops within an AS. The Cluster_List is composed of a series of Cluster_IDs. It records all the RRs through which a route passes.

Precautions

To ensure that a client can learn the routes reflected by an RR, the Cluster ID configured on the RR must be different from the Cluster ID of the client (By default, the client uses its Router ID as the cluster ID). If the Cluster ID is the same as the Cluster ID of the client, the client discards received routes.

Example

# Set the cluster ID to 50 for the device that is one of the route reflectors in the cluster.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] reflector cluster-id 50

reflector cluster-id (BGP-VPN instance IPv6 address family view)

Function

The reflector cluster-id command sets a cluster ID for an RR.

The undo reflector cluster-id command deletes the cluster ID configured for an RR.

By default, each RR uses its Router ID as the cluster ID.

Format

reflector cluster-id { cluster-id-value | cluster-id-ipv4 }

undo reflector cluster-id

Parameters

Parameter Description Value
cluster-id-value

Specifies the IPv4 address of an RR.

The value is an integer ranging from 1 to 4294967295.

cluster-id-ipv4

Specifies the IPv4 address of an RR.

The value is in dotted decimal notation.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Sometimes, more than one RR needs to be configured in a cluster to improve network reliability and prevent single-point failures. If a cluster has more than one RR, the reflector cluster-id command needs to be used to set the same cluster ID for the RRs. This helps to identify the cluster and avoid routing loops.

Configuring an RR allows IBGP peers to advertise routes learned in the local AS to each other. The Cluster_List attribute is introduced to avoid loops within an AS. The Cluster_List is composed of a series of Cluster_IDs. It records all the RRs through which a route passes.

Precautions

To ensure that a client can learn the routes reflected by an RR, the Cluster ID configured on the RR must be different from the Cluster ID of the client (By default, the client uses its Router ID as the cluster ID). If the Cluster ID is the same as the Cluster ID of the client, the client discards received routes.

Example

# Set the cluster ID to 50 for the device that is one of the route reflectors in the cluster.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] reflector cluster-id 50

refresh bgp

Function

The refresh bgp command manually performs a soft reset on BGP connections.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

refresh bgp { all | ipv4-address | external | internal | group group-name } { export | import }

refresh bgp vpnv4 { all | ipv4-address | ipv6-address | external | internal | group group-name } { export | import }

refresh bgp vpn-instance vpn-instance-name ipv4-family { all | ipv4-address | external | internal | group group-name } { export | import }

refresh bgp vpnv6 { all | ipv4-address | ipv6-address | external | internal | group group-name } { export | import }

For S6730-H-V2, S5732-H-V2:

refresh bgp [ instance bgpName ] vpn-instance vpn-instance-name ipv6-family { all | ipv6-address | external | internal | group group-name } { export | import }

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

refresh bgp vpn-instance vpn-instance-name ipv6-family { all | ipv6-address | external | internal | group group-name } { export | import }

Parameters

Parameter Description Value
all

Softly resets all the BGP IPv4 connections.

-

ipv4-address

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

external

Softly resets EBGP connections.

-

internal

Performs a soft reset on IBGP connections.

-

group group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

ipv6-address

Specifies the IPv6 address of a BGP peer.

The value is in the format of X:X:X:X:X:X:X:X.

export

Triggers an inbound soft reset.

-

import

Triggers an inbound soft reset.

-

vpn-instance vpn-instance-name

Softly resets the connection of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

ipv4-family

Indicates the IPv4 address family.

-

ipv6-family

Indicates the IPv6 address family.

-

vpnv4

Softly resets the BGP connections in a VPNv4 address family.

-

vpnv6

Performs a soft reset on BGP connections in the VPNv6 address family.

-

instance bgpName

Displays BGP routes of a specified BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without any spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer of a device supports route-refresh, you can run this command on the device to softly reset the BGP connection with the peer. BGP soft resetting can be used to refresh the BGP routing table and apply new routing policies, without tearing down any BGP connection.

Prerequisites

Configuring BGP soft resetting requires that the peers support the route-refresh capability.

Precautions

Assume that a device supports route-refresh and is configured with the peer keep-all-routes command. After the refresh bgp command is run on the device, the device does not refresh its routing table.

Example

# Perform a soft reset on all BGP connections in the inbound direction to make new configurations take effect.
<HUAWEI> refresh bgp all import

refresh bgp ipv6

Function

The refresh bgp ipv6 command softly resets connections in the BGP-IPv6 unicast address family.

Format

refresh bgp ipv6 { ipv6-address | group group-name } { export | import }

refresh bgp ipv6 { all | ipv4-address | external | internal } { export | import }

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a BGP peer.

The value is in the format of X:X:X:X:X:X:X:X.

group group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

export

Triggers an inbound soft reset.

-

import

Triggers an inbound soft reset.

-

ipv6

Softly resets BGP4+ connections.

-

all

Softly resets all the BGP IPv4 connections.

-

ipv4-address

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

external

Softly resets EBGP connections.

-

internal

Performs a soft reset on IBGP connections.

-

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer of a device supports route-refresh, you can run this command on the device to softly reset the BGP connection with the peer. BGP soft resetting can be used to refresh the BGP routing table and apply new routing policies, without tearing down any BGP connection.

Prerequisites

Configuring BGP soft resetting requires that the peers support the route-refresh capability.

Precautions

Assume that a device supports route-refresh and is configured with the peer keep-all-routes command. After the refresh bgp command is run on the device, the device does not refresh its routing table.

Example

# Softly resets BGP4+ connections.
<HUAWEI> refresh bgp ipv6 2001:DB8:1::1 export

refresh bgp vpn-instance ipv4-family

Function

The refresh bgp vpn-instance ipv4-family command softly resets connections in the BGP-VPN instance IPv4 address family.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

refresh bgp [ instance instance-name ] vpn-instance vpn-instance-name ipv4-family { all | ipv4-address | external | internal | group group-name } { export | import }

Parameters

Parameter Description Value
instance instance-name

Specifies a BGP multi-instance.

The value is a string of 1 to 31 case-sensitive characters without any spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

vpn-instance vpn-instance-name

Softly resets the connection of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

ipv4-family

Indicates the IPv4 address family.

-

all

Softly resets all the BGP IPv4 connections.

-

ipv4-address

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

external

Softly resets EBGP connections.

-

internal

Performs a soft reset on IBGP connections.

-

group group-name

Specifies the name of a BGP peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

export

Triggers an inbound soft reset.

-

import

Triggers an inbound soft reset.

-

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer of a device supports route-refresh, you can run this command on the device to softly reset the BGP connection with the peer. BGP soft resetting can be used to refresh the BGP routing table and apply new routing policies, without tearing down any BGP connection.

Prerequisites

Configuring BGP soft resetting requires that the peers support the route-refresh capability.

Precautions

Assume that a device supports route-refresh and is configured with the peer keep-all-routes command. After the refresh bgp command is run on the device, the device does not refresh its routing table.

Example

# Softly resets the connection of a specified VPN instance enabled with an IPv4 address family.
<HUAWEI> refresh bgp vpn-instance vpna ipv4-family all export

reset bgp

Function

The reset bgp command resets specified BGP connections.

Format

reset bgp { as-number | ipv4-address | external | internal | group group-name }

reset bgp all

reset bgp { ipv4 | vpnv4 } all

reset bgp vpnv4 { as-number | ipv4-address | ipv6-address | external | internal | group group-name }

reset bgp vpn-instance vpn-instance-name ipv4-family { all | as-number | ipv4-address | external | internal | group group-name }

Parameters

Parameter Description Value
as-number

Specifies a 2-byte AS number (number<1-65535>) or a 4-byte AS number (number<1-65535>.number<0-65535>).

For an integral AS number, the value ranges from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

ipv4-address

Resets the BGP connection with a specified peer.

It is in dotted decimal notation.

external

Reset all EBGP connections.

-

internal

Resets all IBGP connections.

-

group group-name

Resets BGP connections with the specified peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

ipv6-address

Resets the TCP connection with a specified BGP4+ peer (all the routes learned by using the connection are deleted).

The value is in the format of X:X:X:X:X:X:X:X.

all

Reset all BGP connections.

-

ipv4

Resets BGP IPv4 connections.

-

vpnv4

Resets BGP connections associated with VPNv4.

-

vpn-instance vpn-instance-name

Resets the connection of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. In addition, the VPN instance name must not be _public_. The character string can contain spaces if it is enclosed in double quotation marks ("").

ipv4-family

Indicates the IPv4 address family.

-

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The reset bgp command is used to make new BGP configurations take effect.

If a BGP routing policy is configured on the device that does not support Route-Refresh, the reset bgp command can be used to make the new routing policy to take effect.

The reset bgp ipv4 all command resets all public-network BGP IPv4 connections.

Configuration Impact

This command resets all TCP connections established between BGP peers and therefore results in the re-establishment of the BGP peer relationships. Exercise caution when running this command.

Example

# Reset all EVN BGP connections.
<HUAWEI> reset bgp all

reset bgp advertise delay on-startup

Function

The reset bgp advertise delay on-startup command allows immediate advertisement of BGP routes after a device restart.

Format

reset bgp advertise delay on-startup

Parameters

None

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the advertise delay on-startup delay-time command is run and its configuration is saved on a device as well as the reboot command is run, the device delays advertising BGP routes after the restart. To enable the device to immediately advertise BGP routes, run the reset bgp advertise delay on-startup command.

Example

# Allow immediate advertisement of BGP routes after a device restart.
<HUAWEI> reset bgp advertise delay on-startup

reset bgp advertise lowest-priority

Function

The reset bgp advertise lowest-priority on-startup command configures BGP to restore the original priorities of the BGP routes to be advertised.

The reset bgp advertise lowest-priority all-address-family peer-up command configures BGP to restore the priorities of the routes to be advertised to BGP peers when the peers go Up from Down.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

reset bgp advertise lowest-priority on-startup

reset bgp advertise lowest-priority all-address-family peer-up

For S6730-H-V2, S5732-H-V2:

reset bgp instance instance-name advertise lowest-priority all-address-family peer-up

Parameters

Parameter Description Value
instance instance-name

Specifies a BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

None

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The reset bgp advertise lowest-priority on-startup command restores the original priority of the routes advertised by BGP to peers.

After the advertise lowest-priority on-startup and reboot commands are run and configurations are saved, the priorities of the BGP routes to be advertised are minimized. To restore the original priorities of these routes, run the reset bgp advertise lowest-priority on-startup command.

The reset bgp advertise lowest-priority all-address-family peer-up command applies to delayed route advertisement scenarios. After this command is run, routes with normal priorities are sent to peers for re-selection. When the peer status is Up, low-priority routes are preferentially sent. After forwarding entries are delivered, the original priorities are restored. This prevents traffic loss caused by forwarding entry delivery failures. Otherwise, the priority of the route with a lower priority cannot be automatically restored if no delay timer is configured.

Precautions

After the reset bgp advertise lowest-priority on-startup command is run, the advertise lowest-priority on-startup configuration can still take effect after the reboot command is run.

Example

# Configure BGP to restore the priorities of the BGP multi-instance routes to be advertised to BGP peers when the peers go Up from Down.
<HUAWEI> reset bgp instance huawei advertise lowest-priority all-address-family peer-up
# Configure BGP to restore the priorities of the BGP routes to be advertised to BGP peers when the peers go Up from Down.
<HUAWEI> reset bgp advertise lowest-priority all-address-family peer-up

reset bgp dampening

Function

The reset bgp dampening command clears BGP route dampening information and releases suppressed routes.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

reset bgp [ instance bgpName ] [ vpn-instance vpn-instance-name ipv4-family ] dampening

reset bgp [ instance bgpName ] [ vpn-instance vpn-instance-name ipv4-family ] dampening ipv4-address [ mask | mask-length ]

Parameters

Parameter Description Value
instance bgpName

Clears route dampening information about a specified BGP multi-instance.

The value is a string of 1 to 31 case-sensitive characters without any spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

vpn-instance vpn-instance-name

Resets the connection of a specified VPN instance enabled with an IPv4 address family.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

ipv4-family

Indicates the IPv4 address family.

-

ipv4-address

Specifies an IPv4 network address.

The value is in dotted decimal notation.

mask

Specifies the network mask in dotted decimal notation. If neither of the mask nor mask length is specified, the address is considered as a classful address.

The value is in dotted decimal notation.

mask-length

Specifies the network mask length. If neither of the mask nor mask length is specified, the address is considered as a classful address.

The value is an integer in the range from 0 to 32.

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Route dampening is enabled to solve the problem of route instability. In most situations, BGP is applied to complex networks where routes change frequently. Route dampening is then used to suppress unstable routes.

The reset bgp dampening command is used to clear dampening information about specified routes on the public network and release specified suppressed routes. If no IP address is specified in the command, dampening information about all routes on the public network is cleared and all suppressed routes are released.

Prerequisites

You can use display bgp routing-table dampened command to view information about suppressed routes.

Configuration Impact

After the reset bgp dampening command is run, suppressed routes are released. If the status of some routes still changes frequently, route flapping may occur. Routing flapping consumes a large number of bandwidth and CPU resources.

Example

# Clear dampening information about routes and release suppressed routes.
<HUAWEI> reset bgp dampening

reset bgp dampening (IPv6)

Function

The reset bgp dampening command clears BGP route dampening information and releases suppressed routes.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

reset bgp ipv6 dampening

reset bgp ipv6 dampening ipv6-address prefix-length

For S6730-H-V2, S5732-H-V2:

reset bgp [ instance bgpName ] vpn-instance vpn-instance-name ipv6-family dampening [ ipv6-address prefix-length ]

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

reset bgp vpn-instance vpn-instance-name ipv6-family dampening [ ipv6-address prefix-length ]

Parameters

Parameter Description Value
ipv6

Clears IPv6 route dampening information and releases suppressed routes.

-

ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

prefix-length

Specifies the network mask in dotted decimal notation. If neither of the mask nor mask length is specified, the address is considered as a classful address.

It is an integer ranging from 0 to 128.

instance bgpName

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without any spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

vpn-instance vpn-instance-name

Clears route dampening information of a specified VPN instance enabled with an IPv6 address family.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

ipv6-family

Indicates the IPv6 address family.

-

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Route dampening is enabled to solve the problem of route instability. In most situations, BGP is applied to complex networks where routes change frequently. Route dampening is then used to suppress unstable routes.

The reset bgp dampening command is used to clear dampening information about specified routes on the public network and release specified suppressed routes. If no IP address is specified in the command, dampening information about all routes on the public network is cleared and all suppressed routes are released.

Prerequisites

You can use display bgp routing-table dampened command to view information about suppressed routes.

Configuration Impact

After the reset bgp dampening command is run, suppressed routes are released. If the status of some routes still changes frequently, route flapping may occur. Routing flapping consumes a large number of bandwidth and CPU resources.

When ipv6-address prefix-length is not specified, after you run the reset bgp ipv6 dampening command, IPv6 route dampening information in the whole BGP routing table is cleared.

Example

# Clear dampening information about the routes of IPv6 VPN instance named vpn1.
<HUAWEI> reset bgp vpn-instance vpn1 ipv6-family dampening
# Clear IPv6 route dampening information.
<HUAWEI> reset bgp ipv6 dampening

reset bgp dampening(IPv4)

Function

The reset bgp dampening command clears BGP route dampening information and releases suppressed routes.

Format

reset bgp [ vpn-instance vpn-instance-name ipv4-family ] dampening

reset bgp [ vpn-instance vpn-instance-name ipv4-family ] dampening ipv4-address [ mask | mask-length ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Clears route dampening information of a specified VPN instance enabled with an IPv4 address family.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

ipv4-family

Indicates the IPv4 address family.

-

ipv4-address

Specifies an IPv4 network address.

The value is in dotted decimal notation.

mask

Specifies the network mask in dotted decimal notation. If neither of the mask nor mask length is specified, the address is considered as a classful address.

The value is in dotted decimal notation.

mask-length

Specifies the network mask length. If neither of the mask nor mask length is specified, the address is considered as a classful address.

The value is an integer in the range from 0 to 32.

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Route dampening is enabled to solve the problem of route instability. In most situations, BGP is applied to complex networks where routes change frequently. Route dampening is then used to suppress unstable routes.

The reset bgp dampening command is used to clear dampening information about specified routes on the public network and release specified suppressed routes. If no IP address is specified in the command, dampening information about all routes on the public network is cleared and all suppressed routes are released.

Prerequisites

You can use display bgp routing-table dampened command to view information about suppressed routes.

Configuration Impact

After the reset bgp dampening command is run, suppressed routes are released. If the status of some routes still changes frequently, route flapping may occur. Routing flapping consumes a large number of bandwidth and CPU resources.

Example

# Clear dampening information about IPv4 routes and release suppressed routes.
<HUAWEI> reset bgp dampening 10.1.0.0 255.255.0.0

reset bgp flap-info

Function

The reset bgp flap-info command clears route flapping statistics.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

reset bgp [ instance instance-name ] [ vpn-instance vpn-instance-name ipv4-family ] flap-info network-address [ mask | mask-length ]

reset bgp [ instance instance-name ] [ vpn-instance vpn-instance-name ipv4-family ] ipv4-address flap-info

reset bgp [ instance instance-name ] [ vpn-instance vpn-instance-name ipv4-family ] flap-info

reset bgp [ instance instance-name ] [ vpn-instance vpn-instance-name ipv4-family ] flap-info as-path-filter { as-path-filter-number | as-path-filter-name }

reset bgp [ instance instance-name ] [ vpn-instance vpn-instance-name ipv4-family ] flap-info regexp as-path-regexp

Parameters

Parameter Description Value
instance instance-name

Specifies a BGP multi-instance.

The value is a string of 1 to 31 case-sensitive characters without any spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

vpn-instance vpn-instance-name

Clears the route flapping information of a specified VPN instance enabled with an IPv4 address family.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

ipv4-family

Indicates the IPv4 address family.

-

network-address

Specifies the network address of an IPv4 peer.

The value is in dotted decimal notation.

mask

Specifies the network mask that is used to filter the BGP IPv4 routes. If neither of the mask nor mask length is specified, the address is considered as a classful address.

The value is in dotted decimal notation.

mask-length

Specifies the network mask length that is used to filter the BGP IPv4 routes. If neither of the mask nor mask length is specified, the address is considered as a classful address.

The value is an integer in the range from 0 to 32.

ipv4-address

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

as-path-filter as-path-filter-number

Clears route flapping statistics based on a specified AS_Path filter.

The value is an integer ranging from 1 to 256.

as-path-filter-name

Clears route flapping statistics based on a specified AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

regexp as-path-regexp

Clear statistics about the flapping routes that match the AS_Path regular expression.

The value is a string of 1 to 80 case-sensitive characters with spaces supported.

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The process of adding a route to and then deleting the route from a routing table is called route flapping.

When route flapping occurs, the routing protocol sends Update packets to neighbors. The neighbors that receive the Update packets need to recalculate routes and modify its routing table. Therefore, frequent route flapping consumes great bandwidth and CPU resources and even seriously affects network operations.

The reset bgp flap-info command is used to clear the flapping information about routes. This allows the device to re-collect statistics about flapping routes and helps to monitor route changes and locate network problems.

Prerequisites

You can use display bgp routing-table flap-info command to view the information about BGP route flapping.

If there are a large number of flapping routes, define an AS_Path filter or an AS_Path regular expression to be referenced in the reset bgp flap-info command. The flapping statistics of the routes matching the AS_Path filter or the AS_Path regular expression are then cleared.

Follow-up Procedure

After the flapping statistics of routes are cleared, you can run the display bgp routing-table flap-info command again to view the flapping statistics of BGP routes to locate the fault.

Example

# Clear the flapping statistics about the routes that match AS_Path filter 10.
<HUAWEI> reset bgp flap-info as-path-filter 10

reset bgp flap-info(IPv4)

Function

The reset bgp flap-info command clears route flapping statistics.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

reset bgp [ vpn-instance vpn-instance-name ipv4-family ] flap-info ipv4-address [ mask | mask-length ]

reset bgp [ vpn-instance vpn-instance-name ipv4-family ] peerIpv4Addr flap-info

reset bgp [ vpn-instance vpn-instance-name ipv4-family ] flap-info

reset bgp [ vpn-instance vpn-instance-name ipv4-family ] flap-info as-path-filter { as-path-filter-number | as-path-filter-name }

reset bgp [ vpn-instance vpn-instance-name ipv4-family ] flap-info regexp as-path-regexp

For S6730-H-V2, S5732-H-V2:

reset bgp [ instance bgpName ] vpn-instance vpn-instance-name ipv6-family flap-info as-path-filter { as-path-filter-number | as-path-filter-name }

reset bgp [ instance bgpName ] vpn-instance vpn-instance-name ipv6-family flap-info regexp as-path-regexp

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

reset bgp vpn-instance vpn-instance-name ipv6-family flap-info as-path-filter { as-path-filter-number | as-path-filter-name }

reset bgp vpn-instance vpn-instance-name ipv6-family flap-info regexp as-path-regexp

Parameters

Parameter Description Value
ipv4-address

Specifies the network address of an IPv4 peer.

The value is in dotted decimal notation.

mask

Specifies the network mask that is used to filter the BGP IPv4 routes. If neither of the mask nor mask length is specified, the address is considered as a classful address.

The value is in dotted decimal notation.

mask-length

Specifies the network mask length that is used to filter the BGP IPv4 routes. If neither of the mask nor mask length is specified, the address is considered as a classful address.

The value is an integer ranging from 0 to 32.

peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

as-path-filter as-path-filter-number

Clears route flapping statistics based on a specified AS_Path filter.

The value is an integer ranging from 1 to 256.

as-path-filter as-path-filter-name

Clears route flapping statistics based on a specified AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

regexp as-path-regexp

Specifies the AS_Path regular expression.

The value is a string of 1 to 80 case-sensitive characters, spaces supported.

vpn-instance vpn-instance-name

Clears the route flapping information of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

ipv4-family

Indicates the IPv4 address family.

-

instance bgpName

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without any spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

ipv6-family

Indicates the IPv6 address family.

-

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The process of adding a route to and then deleting the route from a routing table is called route flapping.

When route flapping occurs, the routing protocol sends Update packets to neighbors. The neighbors that receive the Update packets need to recalculate routes and modify its routing table. Therefore, frequent route flapping consumes great bandwidth and CPU resources and even seriously affects network operations.

The reset bgp flap-info command is used to clear the flapping information about routes. This allows the device to re-collect statistics about flapping routes and helps to monitor route changes and locate network problems.

Prerequisites

You can use display bgp routing-table flap-info command to view the information about BGP route flapping.

If there are a large number of flapping routes, define an AS_Path filter or an AS_Path regular expression to be referenced in the reset bgp flap-info command. The flapping statistics of the routes matching the AS_Path filter or the AS_Path regular expression are then cleared.

Configuration Impact

After the reset bgp flap-info command is run, the flapping statistics of routes are reset and cannot be displayed.

Follow-up Procedure

After the flapping statistics of routes are cleared, you can run the display bgp routing-table flap-info command again to view the flapping statistics of BGP routes to locate the fault.

Example

# Clear the flapping statistics about the routes that match AS_Path filter 10.
<HUAWEI> reset bgp flap-info as-path-filter 10

reset bgp flap-info(IPv6)

Function

The reset bgp flap-info command clears the flapping statistics of IPv6 routes.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

reset bgp ipv6 flap-info network-ipv6-address prefix-length

reset bgp ipv6 ipv6-address flap-info

reset bgp ipv6 flap-info

reset bgp ipv6 flap-info as-path-filter { as-path-filter-num | as-path-filter-name }

reset bgp ipv6 flap-info regexp as-path-regexp

reset bgp ipv6 peerIpv4Addr flap-info

For S6730-H-V2, S5732-H-V2:

reset bgp [ instance bgpName ] vpn-instance vpn-instance-name ipv6-family flap-info [ network-ipv6-address prefix-length ]

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

reset bgp vpn-instance vpn-instance-name ipv6-family flap-info [ network-ipv6-address prefix-length ]

Parameters

Parameter Description Value
network-ipv6-address

Specifies the IPv6 address of a peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

prefix-length

Specifies the network mask that is used to filter the BGP IPv6 routes. If neither of the mask nor mask length is specified, the address is considered as a classful address.

It is an integer ranging from 0 to 128.

ipv6

Clears the route flapping statistics on all IPv6 peers.

-

ipv6-address

Specifies the network address of an IPv6 peer.

The format is X:X:X:X:X:X:X:X.

as-path-filter as-path-filter-num

Clears route flapping statistics based on a specified AS_Path filter.

The value is an integer ranging from 1 to 256.

as-path-filter as-path-filter-name

Clears route flapping statistics based on a specified AS_Path filter.

The value is a string of 1 to 51 case-sensitive characters. If spaces are used, the string must start and end with double quotation marks (").

regexp as-path-regexp

Clears statistics about the flapping routes that match the AS_Path regular expression.

The value is a string of 1 to 80 case-sensitive characters, spaces supported.

peerIpv4Addr

Specifies an IPv4 peer address.

The value is in dotted decimal notation.

instance bgpName

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without any spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

vpn-instance vpn-instance-name

Clears route dampening information of a specified VPN instance enabled with an IPv6 address family.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

ipv6-family

Indicates the IPv6 address family.

-

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The process of adding a route to and then deleting the route from a routing table is called route flapping.

When route flapping occurs, the routing protocol sends Update packets to neighbors. The neighbors that receive the Update packets need to recalculate routes and modify its routing table. Therefore, frequent route flapping consumes great bandwidth and CPU resources and even seriously affects network operations.

The reset bgp flap-info command is used to clear the flapping information about routes. This allows the device to re-collect statistics about flapping routes and helps to monitor route changes and locate network problems.

Prerequisites

You can use display bgp routing-table flap-info command to view the information about BGP route flapping.

If there are a large number of flapping routes, you can define as-path-filter or regexp, and then clear the statistics of the matched flapping routes.

Configuration Impact

After the reset bgp flap-info command is run, the flapping statistics of routes are reset and cannot be displayed.

Follow-up Procedure

After the flapping statistics of routes are cleared, you can run the display bgp routing-table flap-info command again to view the flapping statistics of BGP routes to locate the fault.

Example

# Clear the flapping statistics about the BGP4+ routes of the VPN instance named vpn1.
<HUAWEI> reset bgp vpn-instance vpn1 ipv6-family flap-info

reset bgp flapping-count

Function

The reset bgp flapping-count command resets the flapping count of a specified BGP peer.

Format

For S6730-H-V2, S5732-H-V2:

reset bgp { ipv4-address | [ instance bgpName ] vpn-instance vpn-instance-name ipv4-family ipv4-address } flapping-count

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

reset bgp { ipv4-address | vpn-instance vpn-instance-name ipv4-family ipv4-address } flapping-count

Parameters

Parameter Description Value
vpn-instance vpn-instance-name

Specifies the name of VPN instance enabled with an IPv4 address family.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

instance bgpName

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

ipv4-family ipv4-address

Specifies the IPv4 address of a BGP peer.

The value is in dotted decimal notation.

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP peer flapping affects the stability of a BGP network and BGP route convergence.

The reset bgp flapping-count command can be used to clear the flapping account of a BGP peer. This allows the device to re-collect the flapping statistics of a peer to locate BGP network problems.

Configuration Impact

After the reset bgp flapping-count command is run, the flapping statistics of BGP peers are reset and cannot be displayed.

Follow-up Procedure

After the reset bgp flapping-count command is used to clear the statistics count of a specified BGP peer, run the display bgp peer command to display the flapping count of BGP peers and locate BGP network problems.

Example

# Clear the flapping count of a specified BGP peer.
<HUAWEI> reset bgp 10.1.1.1 flapping-count

reset bgp flapping-count(IPv6)

Function

The reset bgp flapping-count command clears the flapping count of a specified BGP IPv6 peer.

Format

For S6730-H-V2, S5732-H-V2:

reset bgp { ipv6 | [ instance bgpName ] vpn-instance vpn-instance-name ipv6-family } ipv6-address flapping-count

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

reset bgp { ipv6 | vpn-instance vpn-instance-name ipv6-family } ipv6-address flapping-count

Parameters

Parameter Description Value
ipv6-address

Specifies the IPv6 address of a BGP peer.

The format is X:X:X:X:X:X:X:X.

ipv6

Clears the flapping count of a specified BGP IPv6 peer.

-

instance bgpName

Displays BGP routes of a specified BGP multi-instance.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without any spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

vpn-instance vpn-instance-name

Specifies the name of VPN instance enabled with an IPv6 address family.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

ipv6-family

Indicates the IPv6 address family.

-

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

BGP peer flapping affects the stability of a BGP network and BGP route convergence.

The reset bgp flapping-count command can be used to clear the flapping account of a BGP peer. This allows the device to re-collect the flapping statistics of a peer to locate BGP network problems.

Configuration Impact

After the reset bgp flapping-count command is run, the flapping statistics of BGP peers are reset and cannot be displayed.

Follow-up Procedure

After the reset bgp flapping-count command is used to clear the statistics count of a specified BGP peer, run the display bgp peer command to display the flapping count of BGP peers and locate BGP network problems.

Example

# Clear the flapping count of a specified BGP peer.
<HUAWEI> reset bgp ipv6 2001:DB8:1::1 flapping-count

reset bgp vpn-instance ipv4-family

Function

The reset bgp vpn-instance ipv4-family command resets BGP connections in the BGP-VPN instance IPv4 address family.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

reset bgp [ instance instance-name ] vpn-instance vpn-instance-name ipv4-family { all | as-number | ipv4-address | external | internal | group group-name }

reset bgp instance instance-name all

Parameters

Parameter Description Value
instance instance-name

Specifies a BGP multi-instance.

The value is a string of 1 to 31 case-sensitive characters without any spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

vpn-instance vpn-instance-name

Resets the connection of a specified VPN instance enabled with an IPv4 address family.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

all

Reset all BGP connections.

-

as-number

Specifies a 2-byte AS number (number<1-65535>) or a 4-byte AS number (number<1-65535>.number<0-65535>).

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

ipv4-address

Resets the BGP connection with a specified peer.

The value is in dotted decimal notation.

external

Reset all EBGP connections.

-

internal

Resets all IBGP connections.

-

group group-name

Resets BGP connections with the specified peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The reset bgp command is used to make new BGP configurations take effect.

If a BGP routing policy is configured on the device that does not support Route-Refresh, the reset bgp command can be used to make the new routing policy to take effect.

Configuration Impact

This command resets all TCP connections established between BGP peers and therefore results in the re-establishment of the BGP peer relationships. Exercise caution when running this command.

Example

# Reset all BGP connections about the routes of BGP multi-instance named vpn1.
<HUAWEI> reset bgp instance vpn1 all

reset bgp(IPv6)

Function

The reset bgp command resets a specified BGP IPv6 connection.

Format

For S6730-H-V2, S5732-H-V2, S5735-L-V2, S5735-S-V2, S5735I-S-V2:

reset bgp ipv6 { as-number | ipv4-address | external | internal | group group-name }

reset bgp ipv6 all

reset bgp ipv6 ipv6-address

reset bgp vpnv6 { all | as-number | ipv4-address | ipv6-address | external | internal | group group-name }

For S6730-H-V2, S5732-H-V2:

reset bgp [ instance bgpName ] vpn-instance vpn-instance-name ipv6-family { all | as-number | ipv6-address | external | internal | group group-name }

For S5735-L-V2, S5735-S-V2, S5735I-S-V2:

reset bgp vpn-instance vpn-instance-name ipv6-family { all | as-number | ipv6-address | external | internal | group group-name }

Parameters

Parameter Description Value
as-number

Specifies a 2-byte AS number (number<1-65535>) or a 4-byte AS number (number<1-65535>.number<0-65535>).

For an integral AS number, the value is an integer ranging from 1 to 4294967295.

For an AS number in dotted notation, the value is in the format of x.y, where x and y are integers ranging from 1 to 65535 and from 0 to 65535, respectively.

external

Reset all EBGP connections.

-

internal

Resets all IBGP connections.

-

group group-name

Resets BGP connections with the specified peer group.

The value is a string of 1 to 47 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed with double quotation marks (").

ipv6

Resets BGP IPv6 connections.

-

ipv4-address

Resets the BGP connection with a specified peer.

The value is in dotted decimal notation.

vpnv6

Resets BGP connections associated with VPNv6.

-

all

Reset all BGP connections.

-

vpn-instance vpn-instance-name

Resets the connection of a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name cannot be _public_. If the string is enclosed in double quotation marks (" "), the string can contain spaces..

ipv6-family

Indicates the IPv6 address family.

-

ipv6-address

Resets the TCP connection with a specified BGP4+ peer (all the routes learned by using the connection are deleted).

The value is in the format of X:X:X:X:X:X:X:X.

instance bgpName

Specifies the BGP multi-instance name.

NOTE:

This parameter is supported only on the S6730-H-V2 and S5732-H-V2.

The value is a string of 1 to 31 case-sensitive characters without any spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The reset bgp command is used to make new BGP configurations take effect.

If a BGP routing policy is changed on a device that does not support the route-refresh capability, the reset bgp command can be used to make the new routing policy take effect.

Configuration Impact

This command resets all TCP connections established between BGP peers and therefore results in the re-establishment of the BGP peer relationships. Exercise caution when running this command.

Example

# Reset BGP connections with the peer 2001:DB8:1::9.
<HUAWEI> reset bgp ipv6 2001:DB8:1::9

reset bmp session

Function

The reset bmp session command resets a specified BGP Monitoring Protocol (BMP) session.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

reset bmp session [ vpn-instance vrf-name ] { ipv4Addr | ipv6Addr | all }

reset bmp session [ vpn-instance vrf-name ] { ipv4Addr | ipv6Addr } alias alias-name

Parameters

Parameter Description Value
vpn-instance vrf-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

ipv4Addr

Resets a BMP session with an IPv4 session address.

The value is in dotted decimal notation.

ipv6Addr

Resets a BMP session with an IPv6 session address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

all

Resets all BMP sessions.

-

alias alias-name

Specifies a session alias. When the device needs to establish multiple TCP connections with the same monitoring server through different port numbers, specify session aliases for differentiation.

The value is a string of 1 to 31 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After configuring BMP session parameters, run the reset bmp session command to reset the BMP session for the new BMP session parameters to take effect.

Run the following commands can change the BMP session configurations:

  • The bmp-session command specifies an address of the monitoring server for the TCP connection between the router and the monitoring server.
  • The tcp command configures parameters for the TCP connection between the router and the monitoring server.

Configuration Impact

Running the reset bmp session command will reset the TCP connection and BMP session between the router and the monitoring server. Therefore, exercise caution when running this command.

Example

# Reset the BMP session with the session address of 10.1.1.1 and alias of aa.
<HUAWEI> reset bmp session 10.1.1.1 alias aa
# Reset all BMP sessions.
<HUAWEI> reset bmp session all
# Reset the BMP session with 2001:DB8:1::1 as the session address.
<HUAWEI> reset bmp session 2001:DB8:1::1
# Reset the BMP session with 10.1.1.1 as the session address.
<HUAWEI> reset bmp session 10.1.1.1

route loop-detect bgp enable

Function

The route loop-detect bgp enable command enables BGP loop detection.

The undo route loop-detect bgp enable command disables BGP loop detection.

By default, BGP loop detection is disabled.

Format

route loop-detect bgp enable

undo route loop-detect bgp enable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If BGP loop detection is incorrectly reported or other problems are caused by BGP loop detection, run the undo route loop-detect bgp enable command to disable BGP loop detection. To enable BGP loop detection again, run the route loop-detect bgp enable command.

Example

# Enable BGP loop detection.
<HUAWEI> system-view
[HUAWEI] route loop-detect bgp enable
# Disable BGP loop detection.
<HUAWEI> system-view
[HUAWEI] undo route loop-detect bgp enable

route-mode adj-rib-in (BMP monitor view)

Function

The route-mode adj-rib-in command sets the type of RIB-in route whose statistics are to be sent by the BMP device to the monitoring server in a specified address family.

The undo route-mode adj-rib-in command restores the default configuration.

The route-mode adj-rib-in command sets the type of RIB-out route whose statistics are to be sent by the BMP device to the monitoring server in a specified address family.

The undo route-mode adj-rib-in command restores the default configuration.

By default, a BMP device is not enabled to report any routing information to any server.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

route-mode { ipv4-family | ipv6-family } unicast { adj-rib-in | adj-rib-out } { pre-policy | post-policy }

undo route-mode { ipv4-family | ipv6-family } unicast { adj-rib-in | adj-rib-out } { pre-policy | post-policy }

Parameters

Parameter Description Value
ipv4-family

Sets the type of RIB-in or RIB-out route whose statistics are to be sent by the BMP device to the monitoring server in the IPv4 address family.

-

ipv6-family

Sets the type of RIB-in or RIB-out route whose statistics are to be sent by the BMP device to the monitoring server in the IPv6 address family.

-

unicast

Sets the type of RIB-in or RIB-out route whose statistics are to be sent by the BMP device to the monitoring server in the unicast address family.

-

pre-policy

Sends statistics about all received routes to the monitoring server.

-

post-policy

Sends statistics about only accepted routes to the monitoring server.

-

Views

BMP monitor view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To set the type of RIB-in route (received from peers) whose statistics are to be sent by the BMP device to the monitoring server in a specified address family, run the route-mode adj-rib-in command. To configure the device to send statistics about all received routes to the monitoring server, specify pre-policy in the command. To configure the device to send statistics about only accepted routes (delivered to the routing table) to the monitoring server, specify post-policy in the command.

To set the type of RIB-out route whose statistics are to be sent by the BMP device to the monitoring server in a specified address family, run the route-mode adj-rib-out command. If you want the monitoring server to monitor all the routes to be advertised, regardless of whether they match the export policy, specify pre-policy in the command. If you want the monitoring server to monitor only the advertised routes (those that match the export policy), specify post-policy in the command.

Prerequisites

The BMP-Monitor view has been displayed using any of the following commands:

  • monitor public: The BMP device sends statistics about RIB-IN or RIB-OUT routes of all BGP peers in the public network address family to the monitoring server.
  • monitor all-vpn-instance: The BMP device sends statistics about RIB-IN or RIB-OUT routes of all BGP peers in all VPN instance address families to the monitoring server.
  • monitor peer: The BMP device sends statistics about RIB-IN or RIB-OUT routes of a specified BGP peer in the public network address family to the monitoring server.
  • monitor vpn-instance: The BMP device sends statistics about RIB-IN or RIB-OUT routes of all BGP peers in a specified VPN instance address family to the monitoring server.
  • monitor vpn-instance peer: The BMP device sends statistics about RIB-IN or RIB-OUT routes of a specified BGP peer in a specified VPN instance address family to the monitoring server.

Precautions

If pre-policy is specified in the command, run the keep-all-routes command in the BGP view to save the routes carried in the BGP Update messages that are received from all BGP peers or peer groups after BGP connections are established, or run the peer keep-all-routes command to save the routes carried in the BGP Update messages that are received from a specified BGP peer or peer group after the BGP connection is established.

Example

# Configure the BMP device to send statistics about all the routes received from all BGP peers in the IPv4 unicast address family to the monitoring server.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1
[HUAWEI-bmp-session-10.1.1.1] monitor public
[HUAWEI-bmp-session-10.1.1.1-public] route-mode ipv4-family unicast adj-rib-in pre-policy
# Configure the BMP device to send statistics about all the routes to be advertised to all BGP peers in the IPv4 unicast address family to the monitoring server.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1
[HUAWEI-bmp-session-10.1.1.1] monitor public
[HUAWEI-bmp-session-10.1.1.1-public] route-mode ipv4-family unicast adj-rib-out pre-policy

route-mode local-rib (BMP monitor view)

Function

The route-mode local-rib command enables a device to send statistics about Local-RIB (Routing Information Base) best routes in a specified BGP address family to a monitoring server.

The undo route-mode local-rib command restores the default configuration.

By default, a BMP device is not enabled to report any routing information to any server.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

route-mode { ipv4-family | ipv6-family } unicast local-rib [ add-path | all ] [ path-marking ]

undo route-mode { ipv4-family | ipv6-family } unicast local-rib [ add-path | all ] [ path-marking ]

Parameters

Parameter Description Value
ipv4-family

Configures the device to send statistics about Local-RIB routes of BGP peers in the IPv4 address family to the monitoring server.

-

ipv6-family

Configures the device to send statistics about Local-RIB routes of BGP peers in the IPv6 address family to the monitoring server.

-

unicast

Configures the device to send statistics about Local-RIB routes of BGP peers in the unicast address family to the monitoring server.

-

add-path

Configures the device to send statistics about Add-Path routes of BGP peers to the monitoring server.

If the parameter is specified, statistics about load balancing routes are reported to the monitoring server.

-

all

Configures the device to report all routes.

-

path-marking

Configures the device to report path status.

-

Views

BMP monitor view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure the device to send statistics about Local-RIB routes (routes received from peers and locally imported routes) of BGP peers in a specified address family to the monitoring server, run the route-mode local-rib command.

Prerequisites

The BMP-Monitor view has been displayed using either of the following commands:

  • monitor public: The BMP device sends statistics about Local-RIB routes of all BGP peers in the public network address family to the monitoring server.
  • monitor vpn-instance: The BMP device sends statistics about Local-RIB routes of all BGP peers in a specified VPN instance address family to the monitoring server.

Example

# Configure the BMP device to send statistics about the Local-RIB routes of all BGP peers in the IPv4 unicast address family to the monitoring server.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1
[HUAWEI-bmp-session-10.1.1.1] monitor public
[HUAWEI-bmp-session-10.1.1.1-public] route-mode ipv4-family unicast local-rib

route-select delay (BGP multi-instance VPN instance IPv4 address family view)

Function

The route-select delay command configures a route selection delay.

The undo route-select delay command deletes the configured route selection delay.

The default delay-value value is 0, indicating that route selection is not delayed.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

route-select delay delay-value

undo route-select delay

Parameters

Parameter Description Value
delay-value

Specifies a route selection delay.

The value is an integer ranging from 0 to 3600, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a scenario in which primary and backup routes exist, packets may get lost after traffic switches back to the primary path from the backup path.

You can run the route-select delay command to configure a route selection delay. After the primary path recovers, an appropriate delay ensures that traffic switches back to the primary path after the device on the primary link completes refreshing forwarding entries.

Precautions

If the route-select delay command is run more than once, the latest configuration overrides the previous one. If you reconfigure the route selection delay and the delay timer has started, the new route selection delay takes effect immediately. That is, the route selection delay starts over based on the new delay.

Delayed route selection is valid only for the routes received from peers. If the new route is a locally imported route, its reselection is not delayed.

Example

# Set the route selection delay to 300s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] route-select delay 300

route-select delay (BGP view)

Function

The route-select delay command configures a route selection delay.

The undo route-select delay command deletes the configured route selection delay.

The default delay-value value is 0, indicating that route selection is not delayed.

Format

route-select delay delay-value

undo route-select delay

Parameters

Parameter Description Value
delay-value

Specifies a route selection delay.

The value is an integer that ranges from 0 to 3600, in seconds.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a scenario in which primary and backup routes exist, packets may get lost after traffic switches back to the primary path from the backup path.

You can run the route-select delay command to configure a route selection delay. After the primary path recovers, an appropriate delay ensures that traffic switches back to the primary path after the device on the primary link completes refreshing forwarding entries.

Precautions

If the route-select delay command is run more than once, the latest configuration overrides the previous one. If you reconfigure the route selection delay and the delay timer has started, the new route selection delay takes effect immediately. That is, the route selection delay starts over based on the new delay.

Delayed route selection is valid only for the routes received from peers. If the new route is a locally imported route, its reselection is not delayed.

Example

# Set the route selection delay to 300s.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] route-select delay 300

route-select delay (BGP-IPv6 unicast address family view)

Function

The route-select delay command configures a route selection delay.

The undo route-select delay command deletes the configured route selection delay.

The default delay-value value is 0, indicating that route selection is not delayed.

Format

route-select delay delay-value

undo route-select delay

Parameters

Parameter Description Value
delay-value

Specifies a route selection delay.

The value is an integer that ranges from 0 to 3600, in seconds.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a scenario in which primary and backup routes exist, packets may get lost after traffic switches back to the primary path from the backup path.

You can run the route-select delay command to configure a route selection delay. After the primary path recovers, an appropriate delay ensures that traffic switches back to the primary path after the device on the primary link completes refreshing forwarding entries.

Precautions

If the route-select delay command is run more than once, the latest configuration overrides the previous one. If you reconfigure the route selection delay and the delay timer has started, the new route selection delay takes effect immediately. That is, the route selection delay starts over based on the new delay.

Delayed route selection is valid only for the routes received from peers. If the new route is a locally imported route, its reselection is not delayed.

Example

# Set the route selection delay to 300s.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] route-select delay 300

route-select delay (BGP-VPN instance IPv4 address family view)

Function

The route-select delay command configures a route selection delay.

The undo route-select delay command deletes the configured route selection delay.

The default delay-value value is 0, indicating that route selection is not delayed.

Format

route-select delay delay-value

undo route-select delay

Parameters

Parameter Description Value
delay-value

Specifies a route selection delay.

The value is an integer that ranges from 0 to 3600, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a scenario in which primary and backup routes exist, packets may get lost after traffic switches back to the primary path from the backup path.

You can run the route-select delay command to configure a route selection delay. After the primary path recovers, an appropriate delay ensures that traffic switches back to the primary path after the device on the primary link completes refreshing forwarding entries.

Precautions

If the route-select delay command is run more than once, the latest configuration overrides the previous one. If you reconfigure the route selection delay and the delay timer has started, the new route selection delay takes effect immediately. That is, the route selection delay starts over based on the new delay.

Delayed route selection is valid only for the routes received from peers. If the new route is a locally imported route, its reselection is not delayed.

Example

# Set the route selection delay to 300s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgpvpna] route-select delay 300

route-select delay (BGP-VPN instance IPv6 address family view)

Function

The route-select delay command configures a route selection delay.

The undo route-select delay command deletes the configured route selection delay.

The default delay-value value is 0, indicating that route selection is not delayed.

Format

route-select delay delay-value

undo route-select delay

Parameters

Parameter Description Value
delay-value

Specifies a route selection delay.

The value is an integer ranging from 0 to 3600, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a scenario in which primary and backup routes exist, packets may get lost after traffic switches back to the primary path from the backup path.

You can run the route-select delay command to configure a route selection delay. After the primary path recovers, an appropriate delay ensures that traffic switches back to the primary path after the device on the primary link completes refreshing forwarding entries.

Precautions

If the route-select delay command is run more than once, the latest configuration overrides the previous one. If you reconfigure the route selection delay and the delay timer has started, the new route selection delay takes effect immediately. That is, the route selection delay starts over based on the new delay.

Delayed route selection is valid only for the routes received from peers. If the new route is a locally imported route, its reselection is not delayed.

Example

# Set the route selection delay to 300s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] route-select delay 300

router-id

Function

The router-id command configures a Router ID for the Router. Each Router ID uniquely identifies one Device in an AS.

The undo router-id command deletes the Router ID configured for the Device.

By default, no BGP Router ID is configured, and the Router ID configured for the route management module through the router id command is used.

Format

router-id ipv4-address

undo router-id

Parameters

Parameter Description Value
ipv4-address

Specifies a router ID in the format of an IPv4 address.

The value is in dotted decimal notation.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The router-id command is used to configure a router ID for the device. Each router ID identifies a device in an AS.

Prerequisites

The bgp command is run to enable BGP.

Configuration Impact

In the BGP view, changing the router ID or deleting the configured router ID resets the BGP session.

Precautions

By default, the device that is not configured with any interface uses the Router ID of 0.0.0.0 assigned by the RM module.

If the interface IP address selected as the router ID is deleted or modified, the system reselects a router ID and reset commands need to be run for the new router ID to take effect. During router ID selection, the following router IDs are involved and listed in descending order of priority: router ID configured for a BGP VPN instance, router ID configured for a BGP public network, and router ID assigned by the RM module.

When BGP and a BGP instance use the router ID of the RM module by default and all public IP addresses are deleted, running reset commands will cause the BGP router ID to change to 0.0.0.0. As a result, BGP peer relationships cannot be established.

Example

# Configure a Router ID for the Device.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] router-id 10.1.1.1

router-id (BGP multi-instance view)

Function

The router-id command configures a Router ID for the Router. Each Router ID uniquely identifies one Device in an AS.

The undo router-id command deletes the Router ID configured for the Device.

By default, no BGP Router ID is configured, and the Router ID configured for the route management module through the router id command is used.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

router-id ipv4-address

undo router-id

Parameters

Parameter Description Value
ipv4-address

Specifies the IPv4 address of a peer.

It is in dotted decimal notation.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The router-id command is used to specify a router ID for a device. Each router ID identifies a device in an AS.

You can configure automatic router ID selection for a BGP-VPN instance to distinguish the router ID of the BGP-VPN instance from the BGP router ID. For more information about the router ID of a BGP-VPN instance, see router-id (BGP-VPN instance IPv4 address family view).

Configuration Impact

When you change the router ID of a BGP-VPN instance IPv4 address family or delete a configured router ID, the BGP session will be reset if there are established BGP sessions in the BGP-VPN instance IPv4 address family. Exercise caution when running this command.

Precautions

By default, the device that is not configured with any interface IP address uses the router ID of 0.0.0.0 selected by the routing management (RM) module.

If the router-id command is not configured in the BGP multi-instance view, the router ID of the RM module is used by default. When the IP address of the interface selected as the router ID is deleted or modified, the reselecting process is triggered. In addition, the reset command is required for the modification to take effect.

When a BGP instance uses the router ID of the RM module by default and all public IP addresses are deleted, running the reset command changes the BGP router ID to 0.0.0.0. As a result, the BGP peer relationship cannot be established.

Example

# Configure a Router ID for the Device.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] router-id 1.1.1.1

router-id (BGP multi-instance VPN instance IPv4 address family view)

Function

The router-id command configures a router ID for the BGP-VPN instance IPv6 address family.

The undo router-id command deletes the router ID configured for the BGP-VPN instance IPv6 address family.

By default, if no router ID is configured for the BGP VPN instance IPv4/IPv6 address family, the BGP router ID (if any) is used. If no BGP router ID exists, an interface IP address in the VPN instance is used.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

router-id { router-id-value | auto-select }

undo router-id

Parameters

Parameter Description Value
router-id-value

Specifies a router ID in the format of an IPv4 address.

The value is in dotted decimal notation.

auto-select

Automatically selects a router ID for the IPv4 or IPv6 address family of an existing BGP VPN instance.

-

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a router ID is configured for the BGP-VPN instance IPv4 address family, the router ID of the BGP-VPN instance IPv4 address family can be distinguished from the router ID of BGP, meeting the requirements of specific scenarios.

For example, two VPN instances vrf1 and vrf2 are configured on a BGP device. To establish a BGP session between vrf1 and vrf2 through the bound interfaces, you can configure different router IDs for the BGP-VPN instance IPv4 address family. If the router ID is not configured, the BGP peer relationship cannot be established because the router IDs in the BGP-VPN instance IPv4 address family are the same as the BGP router ID.

The rules for selecting a router ID for a BGP-VPN instance are as follows:

  • If loopback interfaces configured with IP addresses are bound to the VPN instance, the largest IP address among the IP addresses of the loopback interfaces is selected as the router ID.
  • If no loopback interface configured with an IP address is bound to the VPN instance, the largest IP address among the other interfaces bound to the VPN instance is selected as the router ID, regardless of whether the interface is Up or Down.

Configuration Impact

When you change the router ID of a BGP-VPN instance IPv4 address family or delete a configured router ID, the BGP session will be reset if there are established BGP sessions in the BGP-VPN instance IPv4 address family. Exercise caution when running this command.

Example

# Configure a Router ID for the Device.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-instance-a-vrf1] router-id 1.1.1.1

router-id (BGP-VPN instance IPv4 address family view)

Function

The router-id command configures a router ID for a BGP-VPN instance IPv4 address family.

The undo router-id command deletes the router ID configured for the BGP-VPN instance IPv4 address family.

By default, if no router ID is configured for the BGP VPN instance IPv4 address family, the BGP router ID (if any) is used. If no BGP router ID exists, an interface IP address in the VPN instance is used.

Format

router-id { router-id-value | auto-select }

undo router-id

Parameters

Parameter Description Value
router-id-value

Specifies a router ID in the format of an IPv4 address.

The value is in dotted decimal notation.

auto-select

Automatically selects a router ID for the IPv4 or IPv6 address family of an existing BGP VPN instance.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a router ID is configured for the BGP-VPN instance IPv4 address family, the router ID of the BGP-VPN instance IPv4 address family can be distinguished from the router ID of BGP, meeting the requirements of specific scenarios.

For example, two VPN instances vrf1 and vrf2 are configured on a BGP device. To establish a BGP session between vrf1 and vrf2 through the bound interfaces, you can configure different router IDs for the BGP-VPN instance IPv4 address family. If the router ID is not configured, the BGP peer relationship cannot be established because the router IDs in the BGP-VPN instance IPv4 address family are the same as the BGP router ID.

The rules for selecting a router ID for a BGP-VPN instance are as follows:

  • If loopback interfaces configured with IP addresses are bound to the VPN instance, the largest IP address among the IP addresses of the loopback interfaces is selected as the router ID.
  • If no loopback interface configured with an IP address is bound to the VPN instance, the largest IP address among the other interfaces bound to the VPN instance is selected as the router ID, regardless of whether the interface is Up or Down.

Configuration Impact

When you change the router ID of a BGP-VPN instance IPv4 address family or delete a configured router ID, the BGP session will be reset if there are established BGP sessions in the BGP-VPN instance IPv4 address family. Exercise caution when running this command.

Example

# Configure a router ID for a BGP VPN instance IPv4 address family.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vrf1
[HUAWEI-vpn-instance-vrf1] ipv4-family
[HUAWEI-vpn-instance-vrf1-af-ipv4] quit
[HUAWEI-vpn-instance-vrf1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-vrf1] router-id 10.2.3.4

router-id (BGP-VPN instance IPv6 address family view)

Function

The router-id command configures a router ID for the BGP-VPN instance IPv6 address family.

The undo router-id command deletes the router ID configured for the BGP-VPN instance IPv6 address family.

By default, if no router ID is configured for the BGP VPN instance IPv4/IPv6 address family, the BGP router ID (if any) is used. If no BGP router ID exists, an interface IP address in the VPN instance is used.

Format

router-id { router-id-value | auto-select }

undo router-id

Parameters

Parameter Description Value
router-id-value

Specifies a router ID in the format of an IPv4 address.

The value is in dotted decimal notation.

auto-select

Automatically selects a router ID for the IPv4 or IPv6 address family of an existing BGP VPN instance.

-

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a router ID is configured for the BGP-VPN instance IPv6 address family, the router ID of the BGP-VPN instance IPv6 address family can be distinguished from the router ID of BGP, meeting the requirements of specific scenarios.

For example, two VPN instances vrf1 and vrf2 are configured on a BGP device. To establish a BGP session between vrf1 and vrf2 through the bound interfaces, you can configure different router IDs for the BGP-VPN instance IPv4 address family. If the router ID is not configured, the BGP peer relationship cannot be established because the router IDs in the BGP-VPN instance IPv4 address family are the same as the BGP router ID.

The rules for selecting a router ID for a BGP-VPN instance are as follows:

  • If loopback interfaces configured with IP addresses are bound to the VPN instance, the largest IP address among the IP addresses of the loopback interfaces is selected as the router ID.
  • If no loopback interface configured with an IP address is bound to the VPN instance, the largest IP address among the other interfaces bound to the VPN instance is selected as the router ID, regardless of whether the interface is Up or Down.

Configuration Impact

If the router ID of a BGP-VPN instance IPv6 address family is changed or the configured router ID is deleted, BGP sessions established in the BGP-VPN instance IPv6 address family will be reset. Exercise caution when running this command.

Example

# Configure a router ID.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vrf1
[HUAWEI-vpn-instance-vrf1] ipv6-family
[HUAWEI-vpn-instance-vrf1-af-ipv6] quit
[HUAWEI-vpn-instance-vrf1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vrf1
[HUAWEI-bgp6-vrf1] router-id 10.1.1.1

router-id (BGP-VPN instance view)

Function

The router-id command configures a router ID in the BGP-VPN instance view.

The undo router-id command deletes the router ID configured in the BGP-VPN instance view.

By default, if no router ID is configured for the BGP VPN instance IPv4/IPv6 address family, the BGP router ID (if any) is used. If no BGP router ID exists, an interface IP address in the VPN instance is used.

Format

router-id { router-id-value | auto-select }

undo router-id

Parameters

Parameter Description Value
router-id-value

Specifies a router ID in the format of an IPv4 address.

The value is in dotted decimal notation.

auto-select

Automatically selects a router ID for the IPv4 or IPv6 address family of an existing BGP VPN instance.

-

Views

BGP-VPN instance view, BGP multi-instance VPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a router ID is configured in the BGP-VPN instance view, the router ID in the BGP-VPN instance view can be distinguished from the BGP router ID to meet the requirements of specific scenarios.

The rules for selecting a router ID for a BGP-VPN instance are as follows:

  • If loopback interfaces configured with IP addresses are bound to the VPN instance, the largest IP address among the IP addresses of the loopback interfaces is selected as the router ID.
  • If no loopback interface configured with an IP address is bound to the VPN instance, the largest IP address among the other interfaces bound to the VPN instance is selected as the router ID, regardless of whether the interface is Up or Down.

Example

# Configure a Router ID for the Device.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1] router-id 10.2.3.4

router-id vpn-instance auto-select

Function

The router-id vpn-instance auto-select command configures automatic router ID selection for all BGP-VPN instances. Each router ID identifies only one device in an AS.

The undo router-id vpn-instance auto-select command deletes the configuration of automatic router ID selection for a BGP-VPN instance.

By default, no BGP Router ID is configured, and the Router ID configured for the route management module through the router id command is used.

Format

router-id vpn-instance auto-select

undo router-id vpn-instance auto-select

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The router-id command is used to specify a router ID for a device. Each router ID identifies a device in an AS.

You can run the router-id vpn-instance auto-select command to configure automatic router ID selection for a BGP-VPN instance so that the router ID of the BGP-VPN instance is distinguished from the BGP router ID. If a router ID has been manually specified for a BGP VPN instance, the manually specified router ID takes precedence over the automatically selected router ID. For more information about the router ID of a BGP-VPN instance, see router-id (BGP-VPN instance IPv4 address family view).

Prerequisites

The bgp command is run to enable BGP.

Configuration Impact

If a BGP session has been established in a BGP-VPN instance, deleting the router ID configured for the BGP-VPN instance will reset the BGP session. Therefore, exercise caution when running this command.

Precautions

By default, the Device that is not configured with any interface uses the Router ID of 0.0.0.0 assigned by routing management.

Example

# Configure automatic Router ID selection for all BGP-VPN instance.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] router-id vpn-instance auto-select

routing-table rib-only (BGP view)

Function

The routing-table rib-only command prohibits BGP routes from being added to the IP routing table.

The undo routing-table rib-only command restores the default configuration.

By default, the preferred BGP routes are added to the IP routing table.

Format

routing-table rib-only [ route-policy route-policy-name ]

undo routing-table rib-only

Parameters

Parameter Description Value
route-policy route-policy-name

Specifies the name of a routing policy.

The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a route reflector (RR) is used and preferred BGP routes do not need to be used during the forwarding, the routing-table rib-only command can be used to make BGP routes unable to be added to the IP routing table or the forwarding layer. This improves forwarding efficiency and the system capacity.

When route-policy-name is specified in the command, the routes matching the policy are not added to the IP routing table, and the routes not matching the policy are added to the IP routing table.

Configuration Impact

After the routing-table rib-only command is run, the routes preferred by BGP are not added to the IP routing table.

Precautions

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

Example

# Prohibit BGP routes from being advertised to the IP routing table.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] routing-table rib-only

routing-table rib-only (BGP-IPv4 unicast address family view)

Function

The routing-table rib-only command prohibits BGP routes from being added to the IP routing table.

The undo routing-table rib-only command restores the default configuration.

By default, the preferred BGP routes are added to the IP routing table.

Format

routing-table rib-only [ route-policy route-policy-name ]

undo routing-table rib-only

Parameters

Parameter Description Value
route-policy route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a route reflector (RR) is used and preferred BGP routes do not need to be used during the forwarding, the routing-table rib-only command can be used to make BGP routes unable to be added to the IP routing table or the forwarding layer. This improves forwarding efficiency and the system capacity.

When route-policy-name is specified in the command, the routes matching the policy are not added to the IP routing table, and the routes not matching the policy are added to the IP routing table.

Configuration Impact

After the routing-table rib-only command is run, the routes preferred by BGP are not added to the IP routing table.

Precautions

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

Example

# Prohibit BGP routes from being advertised to the IP routing table.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] routing-table rib-only

routing-table rib-only (BGP-IPv6 unicast address family view)

Function

The routing-table rib-only command prohibits BGP routes from being added to the IP routing table.

The undo routing-table rib-only command restores the default configuration.

By default, the preferred BGP routes are added to the IP routing table.

Format

routing-table rib-only [ route-policy route-policy-name ]

undo routing-table rib-only

Parameters

Parameter Description Value
route-policy route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a route reflector (RR) is used and preferred BGP routes do not need to be used during the forwarding, the routing-table rib-only command can be used to make BGP routes unable to be added to the IP routing table or the forwarding layer. This improves forwarding efficiency and the system capacity.

When route-policy-name is specified in the command, the routes matching the policy are not added to the IP routing table, and the routes not matching the policy are added to the IP routing table.

Configuration Impact

After the routing-table rib-only command is run, the routes preferred by BGP are not added to the IP routing table.

Precautions

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

Example

# Prohibit BGP routes from being advertised to the IP routing table.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] routing-table rib-only

routing-table rib-only (BGP-VPN instance IPv4 address family view)

Function

The routing-table rib-only command prohibits BGP routes from being added to the IP routing table.

The undo routing-table rib-only command restores the default configuration.

By default, the preferred BGP routes are added to the IP routing table.

Format

routing-table rib-only [ route-policy route-policy-name ]

undo routing-table rib-only

Parameters

Parameter Description Value
route-policy route-policy-name

Specifies the name of a route-policy.

The value is a string of 1 to 200 case-sensitive characters without spaces. The character string can contain spaces if it is enclosed with double quotation marks (").

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a route reflector (RR) is used and preferred BGP routes do not need to be used during the forwarding, the routing-table rib-only command can be used to make BGP routes unable to be added to the IP routing table or the forwarding layer. This improves forwarding efficiency and the system capacity.

When route-policy-name is specified in the command, the routes matching the policy are not added to the IP routing table, and the routes not matching the policy are added to the IP routing table.

Precautions

If the source of the invalid routes imported using the import-rib command matches the instance and address family in which the routing-table rib-only command is run, the two commands are mutually exclusive.

Example

# Prohibit BGP routes from being advertised to the IP routing table.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vrf1
[HUAWEI-vpn-instance-vrf1] route-distinguisher 222:2
[HUAWEI-vpn-instance-vrf1-af-ipv4] vpn-target 222:2
[HUAWEI-vpn-instance-vrf1-af-ipv4] quit
[HUAWEI-vpn-instance-vrf1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vrf1
[HUAWEI-bgp-vrf1] routing-table rib-only

routing-table rib-only (BGP-VPN instance IPv6 address family view)

Function

The routing-table rib-only command prohibits BGP routes from being added to the IP routing table.

The undo routing-table rib-only command restores the default configuration.

By default, the preferred BGP routes are added to the IP routing table.

Format

routing-table rib-only [ route-policy route-policy-name ]

undo routing-table rib-only

Parameters

Parameter Description Value
route-policy route-policy-name

Specifies the name of a routing policy.

The name is a string of 1 to 200 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a route reflector (RR) is used and preferred BGP routes do not need to be used during the forwarding, the routing-table rib-only command can be used to make BGP routes unable to be added to the IP routing table or the forwarding layer. This improves forwarding efficiency and the system capacity.

When route-policy-name is specified in the command, the routes matching the policy are not added to the IP routing table, and the routes not matching the policy are added to the IP routing table.

Precautions

If the source of the invalid routes imported using the import-rib command matches the instance and address family in which the routing-table rib-only command is run, the import-rib and routing-table rib-only commands are mutually exclusive.

Example

# Prohibit BGP routes from being advertised to the IP routing table.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vrf1
[HUAWEI-vpn-instance-vrf1] ipv6-family unicast
[HUAWEI-vpn-instance-vrf1-af-ipv6] route-distinguisher 333:3
[HUAWEI-vpn-instance-vrf1-af-ipv6] vpn-target 333:3
[HUAWEI-vpn-instance-vrf1-af-ipv6] quit
[HUAWEI-vpn-instance-vrf1-af] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vrf1
[HUAWEI-bgp-6-vrf1] routing-table rib-only

shutdown (BGP multi-instance view)

Function

The shutdown command terminates all sessions between a device and its BGP peers.

The undo shutdown command restores all sessions between a device and its BGP peers.

By default, the function of terminating all sessions between a device and its BGP peers is disabled.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

shutdown

undo shutdown

Parameters

None

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running this command causes all BGP peers unable to establish sessions. Exercise caution when using this command.

During the system upgrade, or maintenance, you can run the shutdown command to terminate all sessions between a device and its BGP peers to prevent possible BGP route flapping from affecting the network. After the system upgrade, or maintenance, run the undo shutdown command to restore the sessions. If a large number of BGP sessions exist, terminating BGP sessions one by one using the peer ignore command is inefficient. Running the shutdown command in the BGP view terminates all BGP sessions at one time.

Example

# Terminate all sessions between the device and its BGP peers.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] shutdown

shutdown (BGP view)

Function

The shutdown command terminates all sessions between a device and its BGP peers.

The undo shutdown command restores all sessions between a device and its BGP peers.

By default, the function of terminating all sessions between a device and its BGP peers is disabled.

Format

shutdown

undo shutdown

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running this command causes all BGP peers unable to establish sessions. Exercise caution when using this command.

During the system upgrade, or maintenance, you can run the shutdown command to terminate all sessions between a device and its BGP peers to prevent possible BGP route flapping from affecting the network. After the system upgrade, or maintenance, run the undo shutdown command to restore the sessions. If a large number of BGP sessions exist, terminating BGP sessions one by one using the peer ignore command is inefficient. Running the shutdown command in the BGP view terminates all BGP sessions at one time.

Example

# Terminate all sessions between the device and its BGP peers.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] shutdown

slow-peer absolute-detection (BGP multi-instance VPN instance IPv4 address family view)

Function

The slow-peer absolute-detection threshold command configures an absolute threshold for slow peer detection.

The undo slow-peer absolute-detection threshold command restores the absolute threshold of slow peer detection.

The slow-peer absolute-detection disable command disables slow peer detection in absolute mode.

The undo slow-peer absolute-detection disable command enables slow peer detection in absolute mode.

By default, slow peer detection in absolute mode is enabled, and the threshold for slow peer detection in absolute mode is 60 seconds.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

slow-peer absolute-detection threshold threshold

slow-peer absolute-detection disable

undo slow-peer absolute-detection threshold threshold

undo slow-peer absolute-detection disable

Parameters

Parameter Description Value
threshold threshold

Specifies an absolute threshold for slow peer detection.

The value is an integer that ranges from 3 to 3600. The default value is 9, in seconds.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After slow peer detection is enabled, the local device calculates the difference between the time taken to send Update messages to each BGP peer and the shortest time taken to send Update messages to a BGP peer in the group. If the difference between the time taken to send Update messages to BGP peer 1 and the shortest time is greater than the specified threshold, the local device considers BGP peer 1 as a slow peer and removes it from the update peer-group. The removal of the slow peer prevents this slow peer from affecting update message advertisement to other peers in the group. If Update messages fail to be advertised, the traditional slow peer detection function cannot be used to detect slow peers. To address this problem, configure an absolute threshold for slow peer detection. If the delay in sending Update messages to a peer is greater than the absolute threshold, the peer is considered a slow peer.

Example

# Set the absolute threshold for slow peer detection to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] slow-peer absolute-detection threshold 100

slow-peer absolute-detection (BGP-IPv4 unicast address family view)

Function

The slow-peer absolute-detection threshold command configures an absolute threshold for slow peer detection.

The undo slow-peer absolute-detection threshold command restores the absolute threshold of slow peer detection.

The slow-peer absolute-detection disable command disables slow peer detection in absolute mode.

The undo slow-peer absolute-detection disable command enables slow peer detection in absolute mode.

By default, slow peer detection in absolute mode is enabled. The absolute threshold for slow peer detection is 60 seconds.

Format

slow-peer absolute-detection threshold threshold

slow-peer absolute-detection disable

undo slow-peer absolute-detection threshold threshold

undo slow-peer absolute-detection disable

Parameters

Parameter Description Value
threshold threshold

Specifies an absolute threshold for slow peer detection.

The value is an integer that ranges from 3 to 3600. The default value is 9, in seconds.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After slow peer detection is enabled, the local device calculates the difference between the time taken to send Update messages to each BGP peer and the shortest time taken to send Update messages to a BGP peer in the group. If the difference between the time taken to send Update messages to BGP peer 1 and the shortest time is greater than the specified threshold, the local device considers BGP peer 1 as a slow peer and removes it from the update peer-group. The removal of the slow peer prevents this slow peer from affecting update message advertisement to other peers in the group. If Update messages fail to be advertised, the traditional slow peer detection function cannot be used to detect slow peers. To address this problem, configure an absolute threshold for slow peer detection. If the delay in sending Update messages to a peer is greater than the absolute threshold, the peer is considered a slow peer.

Example

# Set the absolute threshold for slow peer detection to 100s.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] slow-peer absolute-detection threshold 100

slow-peer absolute-detection (BGP-IPv6 unicast address family view)

Function

The slow-peer absolute-detection threshold command configures an absolute threshold for slow peer detection.

The undo slow-peer absolute-detection threshold command restores the absolute threshold of slow peer detection.

The slow-peer absolute-detection disable command disables slow peer detection in absolute mode.

The undo slow-peer absolute-detection disable command enables slow peer detection in absolute mode.

By default, slow peer detection in absolute mode is enabled, and the threshold for slow peer detection in absolute mode is 9s.

Format

slow-peer absolute-detection threshold threshold

slow-peer absolute-detection disable

undo slow-peer absolute-detection threshold threshold

undo slow-peer absolute-detection disable

Parameters

Parameter Description Value
threshold threshold

Specifies an absolute threshold for slow peer detection.

The value is an integer that ranges from 3 to 3600. The default value is 9, in seconds.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After slow peer detection is enabled, the local device calculates the difference between the time taken to send Update messages to each BGP peer and the shortest time taken to send Update messages to a BGP peer in the group. If the difference between the time taken to send Update messages to BGP peer 1 and the shortest time is greater than the specified threshold, the local device considers BGP peer 1 as a slow peer and removes it from the update peer-group. The removal of the slow peer prevents this slow peer from affecting update message advertisement to other peers in the group. If Update messages fail to be advertised, the traditional slow peer detection function cannot be used to detect slow peers. To address this problem, configure an absolute threshold for slow peer detection. If the delay in sending Update messages to a peer is greater than the absolute threshold, the peer is considered a slow peer.

Example

# Set the absolute threshold for slow peer detection to 100s.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] slow-peer absolute-detection threshold 100

slow-peer absolute-detection (BGP-VPN instance IPv4 address family view)

Function

The slow-peer absolute-detection threshold command configures an absolute threshold for slow peer detection.

The undo slow-peer absolute-detection threshold command restores the absolute threshold of slow peer detection.

The slow-peer absolute-detection disable command disables slow peer detection in absolute mode.

The undo slow-peer absolute-detection disable command enables slow peer detection in absolute mode.

By default, slow peer detection in absolute mode is enabled, and the threshold for slow peer detection in absolute mode is 9s.

Format

slow-peer absolute-detection threshold threshold

slow-peer absolute-detection disable

undo slow-peer absolute-detection threshold threshold

undo slow-peer absolute-detection disable

Parameters

Parameter Description Value
threshold threshold

Specifies an absolute threshold for slow peer detection.

The value is an integer that ranges from 3 to 3600. The default value is 9, in seconds.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After slow peer detection is enabled, the local device calculates the difference between the time taken to send Update messages to each BGP peer and the shortest time taken to send Update messages to a BGP peer in the group. If the difference between the time taken to send Update messages to BGP peer 1 and the shortest time is greater than the specified threshold, the local device considers BGP peer 1 as a slow peer and removes it from the update peer-group. The removal of the slow peer prevents this slow peer from affecting update message advertisement to other peers in the group. If Update messages fail to be advertised, the traditional slow peer detection function cannot be used to detect slow peers. To address this problem, configure an absolute threshold for slow peer detection. If the delay in sending Update messages to a peer is greater than the absolute threshold, the peer is considered a slow peer.

Example

# Set the absolute threshold for slow peer detection to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpna
[HUAWEI-bgp-instance-vpna] peer 1.1.1.1 as-number 100
[HUAWEI-bgp-instance-vpna] quit
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] slow-peer absolute-detection threshold 100

slow-peer absolute-detection (BGP-VPN instance IPv6 address family view)

Function

The slow-peer absolute-detection threshold command configures an absolute threshold for slow peer detection.

The undo slow-peer absolute-detection threshold command restores the absolute threshold of slow peer detection.

The slow-peer absolute-detection disable command disables slow peer detection in absolute mode.

The undo slow-peer absolute-detection disable command enables slow peer detection in absolute mode.

By default, slow peer detection in absolute mode is enabled, and the threshold for slow peer detection in absolute mode is 9s.

Format

slow-peer absolute-detection threshold threshold

slow-peer absolute-detection disable

undo slow-peer absolute-detection threshold threshold

undo slow-peer absolute-detection disable

Parameters

Parameter Description Value
threshold threshold

Specifies an absolute threshold for slow peer detection.

The value is an integer that ranges from 3 to 3600. The default value is 9, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After slow peer detection is enabled, the local device calculates the difference between the time taken to send Update messages to each BGP peer and the shortest time taken to send Update messages to a BGP peer in the group. If the difference between the time taken to send Update messages to BGP peer 1 and the shortest time is greater than the specified threshold, the local device considers BGP peer 1 as a slow peer and removes it from the update peer-group. The removal of the slow peer prevents this slow peer from affecting update message advertisement to other peers in the group. If Update messages fail to be advertised, the traditional slow peer detection function cannot be used to detect slow peers. To address this problem, configure an absolute threshold for slow peer detection. If the delay in sending Update messages to a peer is greater than the absolute threshold, the peer is considered a slow peer.

Example

# Set the absolute threshold for slow peer detection to 100s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] slow-peer absolute-detection threshold 100

slow-peer detection (BGP multi-instance VPN instance IPv4 address family view)

Function

The slow-peer detection threshold command enables slow peer detection.

The undo slow-peer detection threshold command disables slow peer detection.

The slow-peer detection disable command disables slow peer detection.

The undo slow-peer detection disable command enables slow peer detection.

By default, slow peer detection is enabled, and the slow peer detection threshold is 300s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

slow-peer detection threshold threshold-value

slow-peer detection disable

undo slow-peer detection [ threshold threshold-value ]

undo slow-peer detection disable

Parameters

Parameter Description Value
threshold threshold-value

Specifies a slow peer detection threshold. If the difference between the time taken to send packets to BGP peer 1 and the shortest time taken to send packets to BGP peer 2 is greater than the threshold, BGP peer 1 is considered as a slow peer.

The value is an integer ranging from 120 to 3600, in seconds. The default value is 300.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An update peer-group may contain multiple peers. If the local device advertises routes to one peer slowly due to network congestion, the speed at which the local device advertises routes to other peers in the update peer-group is affected. To prevent this problem, slow peer detection is enabled by default.

After slow peer detection is enabled, the local device calculates the difference between the time taken to send messages to each peer in the update peer-group and the shortest time taken to send messages to each peer in the group. If the difference between the time taken to send messages to a peer and the shortest time is greater than the threshold specified for slow peer detection, the local device considers this peer as a slow peer and removes it from the update peer-group, which prevents this slow peer from affecting route advertisement to other peers in the group.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Enable slow peer detection and set the slow peer detection threshold to 200s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] slow-peer detection threshold 200

slow-peer detection (BGP-IPv4 unicast address family view)

Function

The slow-peer detection threshold command enables slow peer detection.

The undo slow-peer detection threshold command disables slow peer detection.

The slow-peer detection disable command disables slow peer detection.

The undo slow-peer detection disable command enables slow peer detection.

By default, slow peer detection is enabled, and the slow peer detection threshold is 300s.

Format

slow-peer detection threshold threshold-value

slow-peer detection disable

undo slow-peer detection [ threshold threshold-value ]

undo slow-peer detection disable

Parameters

Parameter Description Value
threshold threshold-value

Specifies a slow peer detection threshold. If the difference between the time taken to send packets to BGP peer 1 and the shortest time taken to send packets to BGP peer 2 is greater than the threshold, BGP peer 1 is considered as a slow peer.

The value is an integer ranging from 120 to 3600, in seconds. The default value is 300.

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An update peer-group may contain multiple peers. If the local device advertises routes to one peer slowly due to network congestion, the speed at which the local device advertises routes to other peers in the update peer-group is affected. To prevent this problem, slow peer detection is enabled by default.

After slow peer detection is enabled, the local device calculates the difference between the time taken to send messages to each peer in the update peer-group and the shortest time taken to send messages to each peer in the group. If the difference between the time taken to send messages to a peer and the shortest time is greater than the threshold specified for slow peer detection, the local device considers this peer as a slow peer and removes it from the update peer-group, which prevents this slow peer from affecting route advertisement to other peers in the group.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Enable slow peer detection in the BGP-IPv4 unicast address family view and set the slow peer detection threshold to 200s.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] slow-peer detection threshold 200

slow-peer detection (BGP-IPv6 unicast address family view)

Function

The slow-peer detection threshold command enables slow peer detection.

The undo slow-peer detection threshold command disables slow peer detection.

The slow-peer detection disable command disables slow peer detection.

The undo slow-peer detection disable command enables slow peer detection.

By default, slow peer detection is enabled, and the slow peer detection threshold is 300s.

Format

slow-peer detection threshold threshold-value

slow-peer detection disable

undo slow-peer detection [ threshold threshold-value ]

undo slow-peer detection disable

Parameters

Parameter Description Value
threshold threshold-value

Specifies a slow peer detection threshold. If the difference between the time taken to send packets to BGP peer 1 and the shortest time taken to send packets to BGP peer 2 is greater than the threshold, BGP peer 1 is considered as a slow peer.

The value is an integer ranging from 120 to 3600, in seconds. The default value is 300.

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An update peer-group may contain multiple peers. If the local device advertises routes to one peer slowly due to network congestion, the speed at which the local device advertises routes to other peers in the update peer-group is affected. To prevent this problem, slow peer detection is enabled by default.

After slow peer detection is enabled, the local device calculates the difference between the time taken to send messages to each peer in the update peer-group and the shortest time taken to send messages to each peer in the group. If the difference between the time taken to send messages to a peer and the shortest time is greater than the threshold specified for slow peer detection, the local device considers this peer as a slow peer and removes it from the update peer-group, which prevents this slow peer from affecting route advertisement to other peers in the group.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Set the slow peer detection threshold.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] slow-peer detection threshold 600

slow-peer detection (BGP-VPN instance IPv4 address family view)

Function

The slow-peer detection threshold command enables slow peer detection.

The undo slow-peer detection threshold command disables slow peer detection.

The slow-peer detection disable command disables slow peer detection.

The undo slow-peer detection disable command enables slow peer detection.

By default, slow peer detection is enabled, and the slow peer detection threshold is 300s.

Format

slow-peer detection threshold threshold-value

slow-peer detection disable

undo slow-peer detection [ threshold threshold-value ]

undo slow-peer detection disable

Parameters

Parameter Description Value
threshold threshold-value

Specifies a slow peer detection threshold. If the difference between the time taken to send packets to BGP peer 1 and the shortest time taken to send packets to BGP peer 2 is greater than the threshold, BGP peer 1 is considered as a slow peer.

The value is an integer ranging from 120 to 3600, in seconds. The default value is 300.

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An update peer-group may contain multiple peers. If the local device advertises routes to one peer slowly due to network congestion, the speed at which the local device advertises routes to other peers in the update peer-group is affected. To prevent this problem, slow peer detection is enabled by default.

After slow peer detection is enabled, the local device calculates the difference between the time taken to send messages to each peer in the update peer-group and the shortest time taken to send messages to each peer in the group. If the difference between the time taken to send messages to a peer and the shortest time is greater than the threshold specified for slow peer detection, the local device considers this peer as a slow peer and removes it from the update peer-group, which prevents this slow peer from affecting route advertisement to other peers in the group.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Enable slow peer detection and set the slow peer detection threshold to 200s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpna
[HUAWEI-bgp-vpna] slow-peer detection threshold 200

slow-peer detection (BGP-VPN instance IPv6 address family view)

Function

The slow-peer detection threshold command enables slow peer detection.

The undo slow-peer detection threshold command disables slow peer detection.

The slow-peer detection disable command disables slow peer detection.

The undo slow-peer detection disable command enables slow peer detection.

By default, slow peer detection is enabled, and the slow peer detection threshold is 300s.

Format

slow-peer detection threshold threshold-value

slow-peer detection disable

undo slow-peer detection [ threshold threshold-value ]

undo slow-peer detection disable

Parameters

Parameter Description Value
threshold threshold-value

Specifies a slow peer detection threshold. If the difference between the time taken to send packets to BGP peer 1 and the shortest time taken to send packets to BGP peer 2 is greater than the threshold, BGP peer 1 is considered as a slow peer.

The value is an integer ranging from 120 to 3600, in seconds. The default value is 300.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An update peer-group may contain multiple peers. If the local device advertises routes to one peer slowly due to network congestion, the speed at which the local device advertises routes to other peers in the update peer-group is affected. To prevent this problem, slow peer detection is enabled by default.

After slow peer detection is enabled, the local device calculates the difference between the time taken to send messages to each peer in the update peer-group and the shortest time taken to send messages to each peer in the group. If the difference between the time taken to send messages to a peer and the shortest time is greater than the threshold specified for slow peer detection, the local device considers this peer as a slow peer and removes it from the update peer-group, which prevents this slow peer from affecting route advertisement to other peers in the group.

Configuration Impact

If the command is run more than once, the latest configuration overrides the previous one.

Example

# Enable slow peer detection and set the slow peer detection threshold to 200s.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv6] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] slow-peer detection threshold 200

ssl-policy name

Function

The ssl-policy name command configures an SSL policy for the BGP Monitoring Protocol (BMP).

The undo ssl-policy name command deletes the SSL policy configured for BMP.

By default, no SSL policy is configured for BMP.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

ssl-policy name policy-name

undo ssl-policy name policy-name

Parameters

Parameter Description Value
policy-name

Specifies the name of an SSL policy.

The value is a string of 1 to 23 case-insensitive characters. It cannot contain spaces.

Views

BMP session view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The Secure Sockets Layer (SSL) protocol protects data privacy on the Internet by preventing attackers from eavesdropping on data exchanged between a client and a server. Specifically, to ensure data transmission security on a network, an SSL policy needs to be configured for BMP using the ssl-policy name command to associate BMP with the SSL policy, and the SSL data encryption, identity authentication, and message integrity verification mechanisms need to be used.

Prerequisites

An SSL policy has been created using the ssl policy command in the system view.

Precautions

Only clients are available for BMP. Therefore, you can directly run the ssl-policy name command without the need to specify an SSL role.

A BMP SSL policy can be configured only for BMP sessions with IPv4 addresses and does not take effect for sessions with IPv6 addresses.

Example

# Configure the default SSL domain policy ftps_der for BMP.
<HUAWEI> system-view
[HUAWEI] ssl policy ftps_der
[HUAWEI-ssl-policy-ftps_der] pki-domain default
[HUAWEI-ssl-policy-ftps_der] quit
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1
[HUAWEI-bmp-session-10.1.1.1] ssl-policy name ftps_der
Warning: The SSL policy is bound to the defaut PKI domain, Continue? [Y/N]:y
# Configure the SSL policy ftps_der for BMP.
<HUAWEI> system-view
[HUAWEI] ssl policy ftps_der
[HUAWEI-ssl-policy-ftps_der] quit
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1
[HUAWEI-bmp-session-10.1.1.1] ssl-policy name ftps_der

statistics-timer

Function

The statistics-timer command configures an interval at which the router sends BGP running statistics to a monitoring server.

The undo statistics-timer command restores the default configuration.

By default, the interval at which the router sends BGP running statistics to the monitoring server is 3600s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

statistics-timer time

undo statistics-timer time

undo statistics-timer

Parameters

Parameter Description Value
time

Specifies the interval at which the router sends BGP running statistics to the monitoring server.

The value is an integer ranging from 15 to 65535, in seconds.

Views

BMP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure an interval at which the router sends BGP running statistics to a monitoring server, run the statistics-timer command. You can configure the interval based on the network stability requirements. If BGP requires high stability, configure a small interval. However, if the router sends BGP running statistics frequently, a large amount of bandwidth resources will be consumed. Therefore, retaining the default value is recommended.

Example

# Set the interval at which the router sends BGP running statistics to a monitoring server to 100s.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] statistics-timer 100

summary automatic (BGP multi-instance VPN instance IPv4 address family view)

Function

The summary automatic command enables automatic aggregation for the locally-imported routes.

The undo summary automatic command disables automatic aggregation for the locally-imported routes.

By default, the locally-imported routes are not aggregated automatically.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

summary automatic

undo summary automatic

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Using the summary automatic command, you can summarize the routes imported by BGP. The routes can be direct routes, static routes, RIP routes, OSPF routes, or IS-IS routes. After this command is run, BGP summarizes routes based on the natural network segment (for example, 10.1.1.1/32 and 10.2.1.1/32 are summarized to 10.0.0.0/8, a Class A address), and sends only the summary route to peers. This reduces the amount of routing information.

Configuration Impact

BGP route aggregation is classified into manual aggregation and automatic aggregation. The command is used to implement automatic aggregation. Manual aggregation takes precedence over automatic aggregation.

Precautions

The summary automatic command is invalid for the routes imported by using the network command.

When some summary routes are withdrawn, black holes may occur on the summary routes, causing traffic loss.

Example

# Enable automatic aggregation for imported routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] summary automatic

summary automatic (BGP view)

Function

The summary automatic command enables automatic aggregation for the locally-imported routes.

The undo summary automatic command disables automatic aggregation for the locally-imported routes.

By default, the locally-imported routes are not aggregated automatically.

Format

summary automatic

undo summary automatic

Parameters

None

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Using the summary automatic command, you can summarize the routes imported by BGP. The routes can be direct routes, static routes, RIP routes, OSPF routes, or IS-IS routes. After this command is run, BGP summarizes routes based on the natural network segment (for example, 10.1.1.1/32 and 10.2.1.1/32 are summarized to 10.0.0.0/8, a Class A address), and sends only the summary route to peers. This reduces the amount of routing information.

Configuration Impact

BGP route aggregation is classified into manual aggregation and automatic aggregation. The command is used to implement automatic aggregation. Manual aggregation takes precedence over automatic aggregation.

Precautions

The summary automatic command is invalid for the routes imported by using the network command.

When some summary routes are withdrawn, black holes may occur on the summary routes, causing traffic loss.

Example

# Enable automatic aggregation for imported routes.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] summary automatic

summary automatic (BGP-IPv4 unicast address family view)

Function

The summary automatic command enables automatic aggregation for the locally-imported routes.

The undo summary automatic command disables automatic aggregation for the locally-imported routes.

By default, the locally-imported routes are not aggregated automatically.

Format

summary automatic

undo summary automatic

Parameters

None

Views

BGP-IPv4 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In the BGP IPv4 unicast address family view, the summary automatic command configures BGP to automatically summarize locally imported routes on the public network.

The summary automatic command is used to summarize the routes imported by BGP. The routes can be direct routes, static routes, RIP routes, OSPF routes, or IS-IS routes. After this command is run, BGP summarizes routes based on the natural network segment (for example, 10.1.1.1/32 and 10.2.1.1/32 are summarized to 10.0.0.0/8, a Class A address), and sends only the summary route to peers. This reduces the amount of routing information.

Configuration Impact

BGP route aggregation is classified into manual aggregation and automatic aggregation. The command is used to implement automatic aggregation. Manual aggregation takes precedence over automatic aggregation.

Precautions

The summary automatic command is invalid for the routes imported by using the network command.

When some summary routes are withdrawn, black holes may occur on the summary routes, causing traffic loss.

Example

# Enable automatic aggregation for imported routes.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] summary automatic

summary automatic (BGP-VPN instance IPv4 address family view)

Function

The summary automatic command enables automatic aggregation for the locally-imported routes.

The undo summary automatic command disables automatic aggregation for the locally-imported routes.

By default, the locally-imported routes are not aggregated automatically.

Format

summary automatic

undo summary automatic

Parameters

None

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Using the summary automatic command, you can summarize the routes imported by BGP. The routes can be direct routes, static routes, RIP routes, OSPF routes, or IS-IS routes. After this command is run, BGP summarizes routes based on the natural network segment (for example, 10.1.1.1/32 and 10.2.1.1/32 are summarized to 10.0.0.0/8, a Class A address), and sends only the summary route to peers. This reduces the amount of routing information.

Configuration Impact

BGP route aggregation is classified into manual aggregation and automatic aggregation. The command is used to implement automatic aggregation. Manual aggregation takes precedence over automatic aggregation.

Precautions

The summary automatic command is invalid for the routes imported by using the network command.

When some summary routes are withdrawn, black holes may occur on the summary routes, causing traffic loss.

Example

# Enable automatic aggregation for imported routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] summary automatic

supernet advertise (BGP-IPv4 unicast address family view)

Function

The supernet unicast advertise enable command configures a BGP device to advertise BGP supernet unicast routes to its peers.

The undo supernet advertise command restores the default configuration.

By default, BGP supernet unicast routes are considered invalid and are not advertised to peers or delivered to the IP routing table.

Format

supernet unicast advertise enable

supernet unicast advertise disable

undo supernet unicast advertise enable

Parameters

Parameter Description Value
unicast

Indicates supernet unicast routes.

-

disable

Disables the device from sending BGP supernet routes.

-

enable

Enables the device to send BGP supernet routes.

-

Views

BGP-IPv4 unicast address family view, BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A BGP supernet route has the same destination address and next hop address or has a more detailed destination address than the next hop address. Any route that meets either of the following conditions is a BGP supernet route:

  • If bitwise AND operations are performed on the destination address mask with the destination address and next hop address, the two obtained network addresses are the same, and destination address mask is greater than or equal to the next hop address mask..
  • If bitwise AND operations are performed on the destination address mask with the destination address and next hop address, the two obtained network addresses are different. If bitwise AND operations are performed on the next hop address mask with the destination address and next hop address, however, the two obtained network addresses are the same.

    BGP supernet routes include BGP supernet labeled routes and BGP supernet unicast routes. When a Huawei device connects to a non-Huawei device, to enable the Huawei device to advertise BGP supernet unicast routes received from the non-Huawei device to BGP peers, run the supernet unicast advertise enable command on the Huawei device.

Precautions

If the next hop to which a supernet route is recursed is also a BGP route, this command does not take effect.

Example

# Configure a BGP device to advertise BGP supernet unicast routes to its peers.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] supernet unicast advertise enable

supernet advertise (BGP-VPN instance IPv4 address family view)

Function

The supernet advertise command enables a device to advertise BGP supernet unicast routes to BGP peers.

The undo supernet advertise command restores the default configuration.

By default, BGP supernet unicast routes are considered invalid and are not advertised to peers or delivered to the IP routing table.

Format

supernet unicast advertise enable

supernet unicast advertise disable

undo supernet unicast advertise enable

Parameters

Parameter Description Value
unicast

Indicates supernet unicast routes.

-

disable

Disables the device from sending BGP supernet routes.

-

enable

Enables the device to send BGP supernet routes.

-

Views

BGP-VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A BGP supernet route has the same destination address and next hop address or has a more detailed destination address than the next hop address. Any route that meets either of the following conditions is a BGP supernet route:

  • If bitwise AND operations are performed on the destination address mask with the destination address and next hop address, the two obtained network addresses are the same, and destination address mask is greater than or equal to the next hop address mask..
  • If bitwise AND operations are performed on the destination address mask with the destination address and next hop address, the two obtained network addresses are different. If bitwise AND operations are performed on the next hop address mask with the destination address and next hop address, however, the two obtained network addresses are the same.

    BGP supernet routes include BGP supernet labeled routes and BGP supernet unicast routes. When a Huawei device connects to a non-Huawei device, to enable the Huawei device to advertise BGP supernet unicast routes received from the non-Huawei device to BGP peers, run the supernet unicast advertise enable command on the Huawei device.

Precautions

If the next hop to which a supernet route is recursed is also a BGP route, this command does not take effect.

Example

# Disable a BGP device from advertising labeled BGP supernet routes.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] supernet label-route advertise disable
# Configure a BGP device to advertise BGP supernet unicast routes to its peers.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family vpn-instance vpn1
[HUAWEI-bgp-vpn1] supernet unicast advertise enable

supernet unicast advertise (BGP multi-instance VPN instance IPv4 address family view)

Function

The supernet unicast advertise enable command enables a device to advertise BGP supernet unicast routes to BGP peers.

The supernet unicast advertise disable command restores the default configuration.

The undo supernet unicast advertise enable command restores the default configuration.

By default, BGP supernet unicast routes are considered invalid and cannot be advertised to BGP peers or delivered to the IP routing table.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

supernet unicast advertise enable

supernet unicast advertise disable

undo supernet unicast advertise enable

Parameters

None

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A BGP supernet route has the same destination address and next hop address or has a more detailed destination address than the next hop address. Any route that meets one of the following conditions is a BGP supernet route.

  • If you perform bitwise AND operations on the destination address mask with the destination address and next hop address, respectively, the calculated network addresses are the same, and the destination address mask is greater than or equal to the next hop address mask.
  • If you perform bitwise AND operations on the destination address mask with the destination address and next hop address, respectively, the calculated network addresses are different. However, if you perform bitwise AND operations on the next hop address mask with the destination address and next hop address, respectively, the calculated network addresses are the same.

    BGP supernet routes include BGP supernet labeled routes and BGP supernet unicast routes. To allow a Huawei device to advertise BGP supernet unicast routes that it receives from a connected non-Huawei device to its BGP peers, run the supernet unicast advertise enable command on the Huawei device.

Precautions

If the next hop to which a supernet route is recursed is also a BGP route, this command does not take effect.

Example

# Configure a BGP device to advertise BGP supernet unicast routes to its peers.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv4-family
[HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[HUAWEI-vpn-instance-vpna-af-ipv4] quit
[HUAWEI-instance-vpna] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[HUAWEI-bgp-instance-a-vpna] supernet unicast advertise enable

supernet unicast advertise (BGP-IPv6 unicast address family view)

Function

The supernet unicast advertise enable command enables a device to advertise BGP supernet unicast routes to BGP peers.

The supernet unicast advertise disable command restores the default configuration.

The undo supernet unicast advertise enable command restores the default configuration.

By default, BGP supernet unicast routes are considered invalid and cannot be advertised to BGP peers or delivered to the IP routing table.

Format

supernet unicast advertise enable

supernet unicast advertise disable

undo supernet unicast advertise enable

Parameters

None

Views

BGP-IPv6 unicast address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A BGP supernet route has the same destination address and next hop address or has a more detailed destination address than the next hop address. Any route that meets one of the following conditions is a BGP supernet route.

  • If you perform bitwise AND operations on the destination address mask with the destination address and next hop address, respectively, the calculated network addresses are the same, and the destination address mask is greater than or equal to the next hop address mask.
  • If you perform bitwise AND operations on the destination address mask with the destination address and next hop address, respectively, the calculated network addresses are different. However, if you perform bitwise AND operations on the next hop address mask with the destination address and next hop address, respectively, the calculated network addresses are the same.

    BGP supernet routes include BGP supernet labeled routes and BGP supernet unicast routes. To allow a Huawei device to advertise BGP supernet unicast routes that it receives from a connected non-Huawei device to its BGP peers, run the supernet unicast advertise enable command on the Huawei device.

Precautions

If the next hop to which a supernet route is recursed is also a BGP route, this command does not take effect.

Example

# Configure a BGP device to advertise BGP supernet unicast routes to its peers.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family unicast
[HUAWEI-bgp-af-ipv6] supernet unicast advertise enable

supernet unicast advertise (BGP-VPN instance IPv6 address family view)

Function

The supernet unicast advertise enable command enables a device to advertise BGP supernet unicast routes to BGP peers.

The supernet unicast advertise disable command restores the default configuration.

The undo supernet unicast advertise enable command restores the default configuration.

By default, BGP supernet unicast routes are considered invalid and cannot be advertised to BGP peers or delivered to the IP routing table.

Format

supernet unicast advertise enable

supernet unicast advertise disable

undo supernet unicast advertise enable

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A BGP supernet route has the same destination address and next hop address or has a more detailed destination address than the next hop address. Any route that meets one of the following conditions is a BGP supernet route.

  • If you perform bitwise AND operations on the destination address mask with the destination address and next hop address, respectively, the calculated network addresses are the same, and the destination address mask is greater than or equal to the next hop address mask.
  • If you perform bitwise AND operations on the destination address mask with the destination address and next hop address, respectively, the calculated network addresses are different. However, if you perform bitwise AND operations on the next hop address mask with the destination address and next hop address, respectively, the calculated network addresses are the same.

    BGP supernet routes include BGP supernet labeled routes and BGP supernet unicast routes. To allow a Huawei device to advertise BGP supernet unicast routes that it receives from a connected non-Huawei device to its BGP peers, run the supernet unicast advertise enable command on the Huawei device.

Precautions

If the next hop to which a supernet route is recursed is also a BGP route, this command does not take effect.

Example

# Configure a BGP device to advertise BGP supernet unicast routes to its peers.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpna
[HUAWEI-vpn-instance-vpna] ipv6-family
[HUAWEI-vpn-instance-vpna-af-ipv6] quit
[HUAWEI-vpn-instance-vpna] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv6-family vpn-instance vpna
[HUAWEI-bgp-6-vpna] supernet unicast advertise enable

tcp (BMP session view)

Function

The tcp command configures parameters for the TCP connection between the router and the monitoring server.

The undo tcp command restores the default configuration.

By default, no parameters are configured for TCP connections.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

tcp connect port port-number [ password md5 cipher-password | keychain keychain-name ]

undo tcp connect port port-number

undo tcp connect port

Parameters

Parameter Description Value
password

Specifies the authentication.

-

md5 cipher-password

Specifies the authentication password for the TCP connection.

The value is a string of case-sensitive characters, spaces not supported. If the password is input in plaintext mode, the password length ranges from 1 to 255; if the password is input in ciphertext mode, the password length ranges from 20 to 432. When double quotation marks are used around the string, spaces are allowed in the string.

keychain keychain-name

Specifies the name of the Keychain authentication.

Before configuring this parameter, run the keychain command to create a keychain. Then, run the key-id, key-string, and algorithm commands to configure a key ID, a password, and an authentication algorithm for this keychain. Otherwise, the authentication will fail, and the BGP peer relationship fails to be established.

The value is a string of 1 to 47 case-insensitive characters. The string cannot contain question marks (?) or spaces. However, when double quotation marks ("") are used around the string, spaces are allowed in the string.

connect

Configures the device to initiate unsolicited TCP connection requests.

-

port port-number

BMP server port number of the TCP connection.

The value is an integer in the range from 1 to 65535.

Views

BMP session view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To establish a BMP session and ensure the validity and security of the TCP connection, run the tcp command to configure parameters for the TCP connection between the router and the monitoring server. The configurable parameters are the TCP connection mode (whether the device initiates unsolicited TCP connection requests or accepts TCP connection requests), TCP connection port number, authentication password of the TCP connection or the name of the Keychain authentication..

Precautions

The encryption algorithm used for MD5 authentication poses security risks. Therefore, you are advised to use an authentication mode based on a more secure encryption algorithm.

Example

# Configure parameters for the TCP connection between the router and the monitoring server.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1
[HUAWEI-bmp-session-10.1.1.1] tcp connect port 5364

timer (keepalive hold / send-hold) (BGP multi-instance view)

Function

Using the timer keepalive hold command, you can set the Keepalive time and hold time of BGP.

The undo timer keepalive hold command restores the default Keepalive time and hold time of a timer.

Using the timer send-hold command, you can set the hold time of a session when the local end fails to send packets.

Using the undo timer send-hold command, you can restore the default hold time of a session when the local end fails to send packets.

By default, the keepalive time is 60s, the hold time is 180s, and the session hold time is 360s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

timer keepalive keepalive-time hold hold-time [ min-holdtime min-hold-value ]

timer send-hold send-hold-time

undo timer keepalive hold [ min-holdtime ]

undo timer keepalive keepalive-time hold hold-time [ min-holdtime min-hold-value ]

undo timer send-hold send-hold-time

Parameters

Parameter Description Value
hold hold-time

Specifies the hold time.

The value is an integer that can be 0, or ranges from 3 to 65535, in seconds. The default value is 180 seconds.

Setting the hold time of a BGP peer to be longer than 20s is recommended. If the hold time of a BGP peer is shorter than 20s, the session may be closed.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

send-hold send-hold-time

Specifies the interval for holding a session when the local end fails to send messages.

The value is 0 or an integer ranging from 360 to 3600, in seconds. The default value is 360. The value 0 indicates that the function is disabled.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer ranging from 0 to 21845, in seconds. The default value is 60.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a connection is established between peers, keepalive-time and hold-time are negotiated by the peers.

  • The smaller hold-time carried by Open messages of both peers is used as the hold-time.
  • The smaller value of one third of hold-time and the locally configured keepalive-time is used as the keepalive-time.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

The timers configured for a specific peer or peer group using the peer timer command override the timers configured for all BGP peers using the timer command.

Precautions

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate the values of keepalive-time and hold-time. Therefore, exercise caution before changing the value of the timer.

The Hold time must be at least three times the Keepalive time. Avoid the following situations when setting timer values:

  • If both keepalive-time and hold-time are set to 0, the BGP timers become invalid. That is, BGP does not detect link faults based on the timers.
  • The hold-time value is much greater than the keepalive-time value, for example, timer keepalive 1 hold 65535. A long hold time cannot ensure that link faults can be detected in time.
  • If keepalive-time is set to 0, the keepalive timer does not start and the send-hold timer does not take effect.

Example

# Set the Keepalive time, hold time, and minimum hold time to 30s, 90s, and 60s, respectively.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] timer keepalive 30 hold 90 min-holdtime 60
# On a BGP device, set the Keepalive time to 30s and the hold time to 90s.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] timer keepalive 30 hold 90
# Set the BGP session hold time to 720 seconds.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] timer send-hold 720

timer (keepalive hold / send-hold) (BGP view)

Function

Using the timer keepalive hold command, you can set the Keepalive time and hold time of BGP.

The undo timer keepalive hold command restores the default Keepalive time and hold time of a timer.

Using the timer send-hold command, you can set the hold time of a session when the local end fails to send packets.

Using the undo timer send-hold command, you can restore the default hold time of a session when the local end fails to send packets.

By default, the keepalive time is 60s, the hold time is 180s, and the session hold time is 360s.

Format

timer keepalive keepalive-time hold hold-time [ min-holdtime min-hold-value ]

timer send-hold send-hold-time

undo timer keepalive hold [ min-holdtime ]

undo timer keepalive keepalive-time hold hold-time [ min-holdtime min-hold-value ]

undo timer send-hold send-hold-time

Parameters

Parameter Description Value
hold hold-time

Specifies the hold time.

The value is an integer that can be 0, or ranges from 3 to 65535, in seconds. The default value is 180 seconds.

Setting the hold time of a BGP peer to be longer than 20s is recommended. If the hold time of a BGP peer is shorter than 20s, the session may be closed.

min-holdtime min-hold-value

Specifies the minimum hold time. On the same device, min-hold-value must be less than hold-time.

The value is an integer ranging from 20 to 65535, in seconds.

send-hold send-hold-time

Specifies the interval for holding a session when the local end fails to send messages.

The value is 0 or an integer ranging from 360 to 3600, in seconds. The default value is 360. The value 0 indicates that the function is disabled.

keepalive keepalive-time

Specifies the Keepalive time.

The value is an integer ranging from 0 to 21845, in seconds. The default value is 60.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a connection is established between peers, keepalive-time and hold-time are negotiated by the peers.

  • The smaller hold-time carried by Open messages of both peers is used as the hold-time.
  • The smaller value of one third of hold-time and the locally configured keepalive-time is used as the keepalive-time.

    If the hold time configured on a remote device is less than the min-hold-value configured on the local device, no BGP peer relationship can be established between the two devices. However, if the hold time configured on the remote device is 0s, a BGP peer relationship can be established between the two devices.

Configuration Impact

The timers configured for a specific peer or peer group using the peer timer command override the timers configured for all BGP peers using the timer command.

Precautions

If the value of a timer changes, the BGP peer relationship between devices is disconnected. This is because the devices need to re-negotiate the values of keepalive-time and hold-time. Therefore, exercise caution before changing the value of the timer.

The Hold time must be at least three times the Keepalive time. Avoid the following three timer values:

  • If both keepalive-time and hold-time are set to 0, the BGP timers become invalid. That is, BGP does not detect link faults based on the timers.
  • The hold-time value is much greater than the keepalive-time value. For example, if the timer keepalive 1 hold 65535 command is run, link faults cannot be detected in time.
  • If keepalive-time is set to 0, the keepalive timer is not started and the send-hold timer function does not take effect.

If there is only one peer in the update peer-group, the send-hold timer does not take effect.

Example

# Set the Keepalive time, hold time, and minimum hold time to 30s, 90s, and 60s, respectively.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] timer keepalive 30 hold 90 min-holdtime 60
# Set the EVN BGP Keepalive time to 30s and hold time to 90s.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] timer keepalive 30 hold 90
# Set the BGP session hold time to 720 seconds.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] timer send-hold 720

timer connect-retry (BGP multi-instance view)

Function

The timer connect-retry command sets a global ConnectRetry interval.

The undo timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

timer connect-retry connect-retry-time

undo timer connect-retry

Parameters

Parameter Description Value
connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Prerequisites

The peer as-number command has been used to create a peer or peer group.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer or peer group. A ConnectRetry interval configured on a specific peer or peer group takes precedence over a global ConnectRetry interval.

  • If both the peer { ipv4-address | ipv6-address } timer connect-retry connect-retry-time command and the peer group-name timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { ipv4-address| ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the peer group-name timer connect-retry connect-retry-time command does not.
  • If both the peer { group-name | ipv4-address | ipv6-address } timer connect-retry connect-retry-time command and the timer connect-retry connect-retry-time command are run on a device, the configuration of the peer { group-name | ipv4-address | ipv6-address } timer connect-retry connect-retry-time command takes effect, but the configuration of the timer connect-retry connect-retry-time command does not.

Example

# Set the global ConnectRetry interval to 60 seconds.
<HUAWEI> system-view
[HUAWEI] bgp 100 instance aa
[HUAWEI-bgp-instance-aa] timer connect-retry 60

timer connect-retry (BGP view)

Function

The timer connect-retry command sets a global ConnectRetry interval.

The undo timer connect-retry command restores the default setting.

By default, the ConnectRetry interval is 32s.

Format

timer connect-retry connect-retry-time

undo timer connect-retry

Parameters

Parameter Description Value
connect-retry-time

Specifies a ConnectRetry interval.

The value ranges from 1 to 65535, in seconds.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When BGP initiates a TCP connection, the ConnectRetry timer is stopped if the TCP connection is established successfully. If the first attempt to establish a TCP connection fails, BGP tries again to establish the TCP connection after the ConnectRetry timer expires. The ConnectRetry interval can be adjusted as needed.

  • The ConnectRetry interval can be reduced in order to lessen the time BGP waits to retry establishing a TCP connection after the first attempt fails.
  • To suppress route flapping caused by constant peer flapping, the ConnectRetry interval can be increased to accelerate route convergence.

Precautions

A ConnectRetry interval can be configured globally, or on a particular peer or peer group. A ConnectRetry interval configured on a specific peer or peer group takes precedence over a global ConnectRetry interval.

If both the peer timer connect-retry command and the timer connect-retry command are run on a device, the configuration of the peer timer connect-retry command takes effect, but the configuration of the timer connect-retry command does not.

Example

# Set a global BGP ConnectRetry interval to 60s.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] timer connect-retry 60

trace-prefix (BMP Session IPv4 unicast view)

Function

The trace-prefix command configures BMP to monitor the trace data of a specified IPv4 public network unicast route.

The undo trace-prefix command restores the default configuration.

By default, BMP does not monitor the trace data of a specified IPv4 public network unicast route.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

trace-prefix ipv4-address mask-length

undo trace-prefix ipv4-address mask-length

Parameters

Parameter Description Value
ipv4-address

Specifies the destination IPv4 address.

The value is in dotted decimal notation.

mask-length

Specifies the mask length.

The value is an integer ranging from 0 to 32.

Views

BMP Session IPv4 unicast view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BMP does not report the trace data of BGP routes on a device. As a result, you can only manually query the trace data of the device's BGP routes.

To resolve this issue, run the trace-prefix command on the device after a connection is established between the device and BMP server. The command configures BMP to monitor the trace data of a specified IPv4 public network unicast route in real time. After the configuration, BMP can monitor how the route is processed in response to the following main items:

  • Import route-policy for routes received from a specified peer (configured using the peer route-policy import command)
  • Export route-policy for routes to be advertised to a specified peer (configured using the peer route-policy export command)
  • Export route-policy for BGP VPN routes (configured using the export route-policy command)
  • Import route-policy for BGP VPN routes (configured using the import route-policy command)
  • Route-policy for routes imported using the network command
  • Route-policy for summary routes
  • Route withdrawal

Example

# Configure BMP to report the trace data of a specified IPv4 public network unicast route to a BMP server.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1
[HUAWEI-bmp-session-10.1.1.1] ipv4 unicast
[HUAWEI-bmp-session-10.1.1.1-ipv4-unicast] trace-prefix 192.168.1.1 32

trace-prefix all (BMP Session IPv4 unicast view)

Function

The trace-prefix all command configures BMP to monitor the trace data of all IPv4 public network unicast routes.

The undo trace-prefix all command restores the default configuration.

By default, BMP does not monitor the trace data of any IPv4 public network unicast routes.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

trace-prefix all

undo trace-prefix all

Parameters

None

Views

BMP Session IPv4 unicast view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BMP does not report the trace data of BGP routes on a device. As a result, you can only manually query the trace data of the device's BGP routes.

To resolve this issue, run the trace-prefix all command on the device after a connection is established between the device and BMP server. The command configures BMP to monitor the trace data of all IPv4 public network unicast routes in real time. After the configuration, BMP can monitor how the routes are processed in response to the following main items:

  • Import route-policy for routes received from a specified peer (configured using the peer route-policy import command)
  • Export route-policy for routes to be advertised to a specified peer (configured using the peer route-policy export command)
  • Export route-policy for BGP VPN routes (configured using the export route-policy command)
  • Import route-policy for BGP VPN routes (configured using the import route-policy command)
  • Route-policy for routes imported using the network command
  • Route-policy for summary routes
  • Route withdrawal

Example

# Configure BMP to report the trace data of all IPv4 public network unicast routes to a BMP server.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1
[HUAWEI-bmp-session-10.1.1.1] ipv4 unicast
[HUAWEI-bmp-session-10.1.1.1-ipv4-unicast] trace-prefix all

trace-prefix route-distinguisher (BMP Session IPv4 VPN view)

Function

The trace-prefix route-distinguisher command configures BMP to monitor the trace data of a VPNv4 route with a specified RD and route prefix as well as the IPv4 VPN unicast route transformed from the VPNv4 route.

The undo trace-prefix route-distinguisher command restores the default configuration.

By default, BMP does not monitor the trace data of a specified VPNv4 route or IPv4 VPN unicast route transformed from the VPNv4 route.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

trace-prefix route-distinguisher vrfRD ipv4-address mask-length

undo trace-prefix route-distinguisher vrfRD ipv4-address mask-length

Parameters

Parameter Description Value
ipv4-address

Specifies the destination IPv4 address.

The value is in dotted decimal notation.

mask-length

Specifies the mask length.

The value is an integer ranging from 0 to 32.

route-distinguisher vrfRD

Specifies the route distinguisher of a VPN instance.

The value is a string of 3 to 21 case-sensitive characters, spaces not supported.

Views

BMP Session IPv4 VPN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BMP does not report the trace data of BGP routes on a device. As a result, you can only manually query the trace data of the device's BGP routes.

To resolve this issue, run the trace-prefix route-distinguisher command on the device after a connection is established between the device and BMP server. The command configures BMP to monitor the trace data of a specified VPNv4 route and the IPv4 VPN unicast route transformed from the VPNv4 route in real time. After the configuration, BMP can monitor how the routes are processed in response to the following main items:

  • Import route-policy for routes received from a specified peer (configured using the peer route-policy import command)
  • Export route-policy for routes to be advertised to a specified peer (configured using the peer route-policy export command)
  • Export route-policy for BGP VPN routes (configured using the export route-policy command)
  • Import route-policy for BGP VPN routes (configured using the import route-policy command)
  • Route-policy for routes imported using the network command
  • Route-policy for summary routes
  • Route withdrawal

Example

# Configure BMP to report the trace data of a specified VPNv4 route and the IPv4 VPN unicast route (transformed from the VPNv4 route) to a BMP server.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1
[HUAWEI-bmp-session-10.1.1.1] ipv4 vpn
[HUAWEI-bmp-session-10.1.1.1-ipv4-vpn] trace-prefix route-distinguisher 1:1 192.168.1.1 32

trace-prefix route-distinguisher all (BMP Session IPv4 VPN view)

Function

The trace-prefix route-distinguisher all command configures BMP to monitor the trace data of all VPNv4 routes with a specified RD and IPv4 VPN unicast routes transformed from the VPNv4 routes.

The undo trace-prefix route-distinguisher all command restores the default configuration.

By default, BMP does not monitor the trace data of any VPNv4 route or IPv4 VPN unicast route transformed from the VPNv4 route.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

trace-prefix route-distinguisher vrfRD all

undo trace-prefix route-distinguisher vrfRD all

Parameters

Parameter Description Value
route-distinguisher vrfRD

Specifies the route distinguisher of a VPN instance.

The value is a string of 3 to 21 case-sensitive characters, spaces not supported.

Views

BMP Session IPv4 VPN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, BMP does not report the trace data of BGP routes on a device. As a result, you can only manually query the trace data of the device's BGP routes.

To resolve this issue, run the trace-prefix route-distinguisher all command on the device after a connection is established between the device and BMP server. The command configures BMP to monitor the trace data of all VPNv4 routes and IPv4 VPN unicast routes (transformed from the VPNv4 routes) in real time. After the configuration, BMP can monitor how the routes are processed in response to the following main items:

  • Import route-policy for routes received from a specified peer (configured using the peer route-policy import command)
  • Export route-policy for routes to be advertised to a specified peer (configured using the peer route-policy export command)
  • Export route-policy for BGP VPN routes (configured using the export route-policy command)
  • Import route-policy for BGP VPN routes (configured using the import route-policy command)
  • Route-policy for routes imported using the network command
  • Route-policy for summary routes
  • Route withdrawal

Example

# Configure BMP to report the trace data of all VPNv4 routes and IPv4 VPN unicast routes (transformed from the VPNv4 routes) to a BMP server.
<HUAWEI> system-view
[HUAWEI] bmp
[HUAWEI-bmp] bmp-session 10.1.1.1
[HUAWEI-bmp-session-10.1.1.1] ipv4 vpn
[HUAWEI-bmp-session-10.1.1.1-ipv4-vpn] trace-prefix route-distinguisher 1:1 all

undo synchronization

Function

The undo synchronization command disables synchronization between BGP and an IGP.

By default, synchronization between BGP and an IGP is disabled.

Format

undo synchronization

Parameters

None

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Device does not support IGP and BGP synchronization. Therefore, the undo synchronization command is configured by default and the configuration cannot be modified.

Example

# Disable synchronization between BGP and an IGP.
<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] ipv4-family unicast
[HUAWEI-bgp-af-ipv4] undo synchronization

vpn-instance (BGP view)

Function

The vpn-instance command creates a BGP VPN instance and displays the BGP VPN instance view.

The undo vpn-instance command deletes a BGP VPN instance.

By default, no BGP VPN instance is created.

Format

vpn-instance vpn-instance-name

undo vpn-instance vpn-instance-name

Parameters

Parameter Description Value
vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces. The VPN instance name cannot be _public_. If the character string is quoted by double quotation marks, the character string can contain spaces.

Views

BGP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the vpn-instance command creates a BGP VPN instance and displays the BGP VPN instance view. The configuration in this view takes effect for the routes and peers in all address families of the specified VPN instance.

Prerequisites

A VPN instance must have been created using the ip vpn-instance command before this command is run.

Configuration Impact

Running the undo vpn-instance command to delete a BGP VPN instance clears all the configurations in the BGP VPN instance.

Follow-up Procedure

After creating a BGP-VPN instance, run the peer as-number command in the BGP-VPN instance view to configure a BGP peer and enable the BGP peer.

Precautions

The BGP peers configured in the BGP VPN instance view can be used in both the BGP VPN instance IPv4 address family view and the BGP VPN instance IPv6 address family view.

Example

# Create a BGP VPN instance named vpn1 and access the BGP VPN instance view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[HUAWEI-vpn-instance-vpn1] quit
[HUAWEI] bgp 100
[HUAWEI-bgp] vpn-instance vpn1
[HUAWEI-bgp-instance-vpn1]

vpn-instance(BGP multi-instance view)

Function

The vpn-instance command creates a BGP multi-instance VPN instance view and displays the BGP multi-instance VPN instance view.

The undo vpn-instance command deletes the BGP multi-instance VPN instance view.

By default, BGP multi-instance VPN instance view is not created.

This command is supported only on the S6730-H-V2 and S5732-H-V2.

Format

vpn-instance vpn-instance-name

undo vpn-instance vpn-instance-name

Parameters

Parameter Description Value
vpn-instance-name

Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.

Views

BGP multi-instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Running the vpn-instance command creates a BGP multi-instance VPN instance and displays the BGP multi-instance VPN instance view. The configuration in this view takes effect for the routes and peers in all address families of the specified VPN instance.

Prerequisites

A VPN instance has been created using the ip vpn-instance command.

Example

# Create a BGP multi-instance VPN instance view named vpn3 and access the BGP multi-instance VPN instance view.
<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn3
[HUAWEI-vpn-instance-vpn3] ipv4-family
[HUAWEI-vpn-instance-vpn3-af-ipv4] quit
[HUAWEI-vpn-instance-vpn3] quit
[HUAWEI] bgp 100 instance a
[HUAWEI-bgp-instance-a] vpn-instance vpn3
[HUAWEI-bgp-instance-a-instance-vpn3]
Translation
Favorite
Download
Update Date:2023-11-14
Document ID:EDOC1100291031
Views:101529
Downloads:750
Average rating:0.0Points

Digital Signature File

digtal sigature tool