- Table of Contents
-
- 07-Layer 3 - IP Routing Command Reference
- 00-Preface
- 01-Basic IP Routing Commands
- 02-Static Routing Commands
- 03-RIP Commands
- 04-OSPF Commands
- 05-IS-IS Commands
- 06-BGP Commands
- 07-Policy-Based Routing Commands
- 08-Guard Route Commands
- 09-IPv6 Static Routing Commands
- 10-RIPng Commands
- 11-OSPFv3 Commands
- 12-IPv6 IS-IS Commands
- 13-IPv6 BGP Commands
- 14-IPv6 Policy-Based Routing Commands
- 15-Routing Policy Commands
- Related Documents
-
Title | Size | Download |
---|---|---|
13-IPv6 BGP Commands | 349.7 KB |
Contents
IPv6 BGP configuration commands
aggregate (IPv6 address family view)
balance (IPv6 address family view/IPv6 BGP-VPN instance view)
bestroute as-path-neglect (IPv6 address family view)
bestroute compare-med (IPv6 address family view)
bestroute med-confederation (IPv6 address family view)
compare-different-as-med (IPv6 address family view)
dampening (IPv6 address family view)
default local-preference (IPv6 address family view/IPv6 BGP-VPN instance view)
default med (IPv6 address family view/IPv6 BGP-VPN instance view)
default-route imported (IPv6 address family view/IPv6 BGP-VPN instance view)
display bgp ipv6 peer received ipv6-prefix
display bgp ipv6 routing-table
display bgp ipv6 routing-table as-path-acl
display bgp ipv6 routing-table community
display bgp ipv6 routing-table community-list
display bgp ipv6 routing-table dampened
display bgp ipv6 routing-table dampening parameter
display bgp ipv6 routing-table different-origin-as
display bgp ipv6 routing-table flap-info
display bgp ipv6 routing-table label
display bgp ipv6 routing-table peer
display bgp ipv6 routing-table regular-expression
display bgp ipv6 routing-table statistic
filter-policy export (IPv6 address family view/IPv6 BGP-VPN instance view)
filter-policy import (IPv6 address family view/IPv6 BGP-VPN instance view)
group (IPv6 address family view)
import-route (IPv6 address family view/IPv6 BGP-VPN instance view)
network (IPv6 address family view/IPv6 BGP-VPN instance view)
peer advertise-community (IPv6 address family view)
peer advertise-community (IPv6 BGP-VPN instance view)
peer advertise-ext-community (IPv6 address family view)
peer allow-as-loop (IPv6 address family view)
peer as-number (IPv6 address family view)
peer as-number (IPv6 BGP-VPN instance view)
peer as-path-acl (IPv6 address family view)
peer bfd (IPv6 address family view/IPv6 BGP-VPN instance view)
peer capability-advertise orf (IPv6 address family view)
peer capability-advertise orf non-standard (IPv6 address family view)
peer capability-advertise route-refresh
peer capability-advertise suppress-4-byte-as (IPv6 address family view)
peer capability-advertise suppress-4-byte-as (IPv6 BGP-VPN instance view)
peer connect-interface (IPv6 address family view)
peer description (IPv6 address family view)
peer description (IPv6 BGP-VPN instance view)
peer ebgp-max-hop (IPv6 address family view)
peer enable (IPv6 address family view)
peer fake-as (IPv6 address family view)
peer filter-policy (IPv6 address family view)
peer group (IPv6 address family view)
peer ignore (IPv6 address family view)
peer ignore-originatorid (IPv6 address family view)
peer ipsec-policy (IPv6 address family view)
peer keep-all-routes (IPv6 address family view)
peer label-route-capability (IPv6 address family view)
peer log-change (IPv6 address family view)
peer next-hop-local (IPv6 address family view)
peer password (IPv6 address family view)
peer password (IPv6 BGP-VPN instance view)
peer preferred-value (IPv6 address family view)
peer preferred-value (IPv6 BGP-VPN instance view)
peer public-as-only (IPv6 address family view)
peer reflect-client (IPv6 address family view)
peer route-limit (IPv6 address family view)
peer route-limit (IPv6 BGP-VPN instance view)
peer route-policy (IPv6 address family view)
peer route-policy (IPv6 BGP-VPN instance view)
peer route-update-interval (IPv6 address family view)
peer substitute-as (IPv6 address family view)
peer timer (IPv6 address family view)
preference (IPv6 address family view/IPv6 BGP-VPN instance view)
reflect between-clients (IPv6 address family view)
reflector cluster-id (IPv6 address family view)
synchronization (IPv6 address family view)
timer (IPv6 address family view)
aggregate (IPv6 address family view)
Syntax
aggregate ipv6-address prefix-length [ as-set | attribute-policy route-policy-name | detail-suppressed | origin-policy route-policy-name | suppress-policy route-policy-name ] *
undo aggregate ipv6-address prefix-length
View
IPv6 address family view
Default level
2 System level
Parameters
ipv6-address: Summary address.
prefix-length: Length of summary route mask, in the range of 0 to 128.
as-set: Creates a summary with AS set.
attribute-policy route-policy-name: Sets the attributes of the summary route according to the routing policy. The routing policy name is a string of 1 to 63 characters.
detail-suppressed: Only advertises the summary route.
suppress-policy route-policy-name: Suppresses specific routes defined in the routing policy. The routing policy name is a string of 1 to 63 characters.
origin-policy route-policy-name: References the routing policy to specify routes for summarization. The routing policy name is a string of 1 to 63 characters.
Table 1 Functions of the keywords
Keywords |
Function |
as-set |
Used to create a summary route, whose AS path contains the AS path information for summarized routes. Use this keyword carefully when many AS paths need to be summarized, because the frequent changes of these specific routes might lead to route oscillation. |
detail-suppressed |
This keyword does not suppress the summary route, but it suppresses the advertisement of all the more specific routes. To summarize only some specific routes, use the peer filter-policy command. |
suppress-policy |
Used to create a summary route and suppress the advertisement of some summarized routes. If you want to suppress some routes selectively and leave other routes still advertised, use the if-match clause of the route-policy command. |
origin-policy |
Selects only routes meeting the routing policy for route summarization. |
attribute-policy |
Sets attributes except the AS_PATH attribute for the summary route. The same work can be done by using the peer route-policy command. |
Description
Use aggregate to create an IPv6 summary route in the IPv6 BGP routing table.
Use undo aggregate to remove an IPv6 summary route.
By default, no summary route is configured.
Examples
# In IPv6 address family view, create a summary of 12::/64 in the IPv6 routing table.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] aggregate 12:: 64
balance (IPv6 address family view/IPv6 BGP-VPN instance view)
Syntax
balance number
undo balance
View
IPv6 address family view, IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
number: Number of BGP routes participating in load balancing, in the range of 1 to 16. When it is set to 1, load balancing is disabled.
Description
Use balance to configure the number of routes participating in IPv6 BGP load balancing.
Use undo balance to restore the default.
The feature is not available by default.
Unlike IGP, BGP has no explicit metric for making load balancing decision. Instead, it implements load balancing by defining its routing rule.
Related commands: display bgp ipv6 routing-table.
Examples
# Set the number of routes participating in IPv6 BGP load balancing to 2.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] balance 2
bestroute as-path-neglect (IPv6 address family view)
Syntax
bestroute as-path-neglect
undo bestroute as-path-neglect
View
IPv6 address family view
Default level
2: System level
Parameters
None
Description
Use bestroute as-path-neglect to configure the IPv6 BGP router to not evaluate the AS_PATH during best route selection.
Use undo bestroute as-path-neglect to configure the IPv6 BGP router to use the AS_PATH during best route selection.
By default, the router takes AS_PATH as a factor when selecting the best route.
Examples
# Ignore AS_PATH in route selection.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] bestroute as-path-neglect
bestroute compare-med (IPv6 address family view)
Syntax
bestroute compare-med
undo bestroute compare-med
View
IPv6 address family view
Default level
2: System level
Parameters
None
Description
Use bestroute compare-med to enable the comparison of the MED for paths from each AS.
Use undo bestroute compare-med to disable this comparison.
This comparison is not enabled by default.
After the bestroute compare-med command is executed, the balance command does not take effect.
Examples
# Compare the MED for paths from an AS for selecting the best route.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] bestroute compare-med
bestroute med-confederation (IPv6 address family view)
Syntax
bestroute med-confederation
undo bestroute med-confederation
View
IPv6 address family view
Default level
2: System level
Parameters
None
Description
Use bestroute med-confederation to enable the comparison of the MED for paths from confederation peers for best route selection.
Use undo bestroute med-confederation to disable the configuration.
By default, this comparison is not enabled.
With this feature enabled, the system can only compare the MED for paths from peers within the confederation. Paths from external ASs are advertised throughout the confederation without MED comparison.
Examples
# Compare the MED for paths from peers within the confederation.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] bestroute med-confederation
compare-different-as-med (IPv6 address family view)
Syntax
compare-different-as-med
undo compare-different-as-med
View
IPv6 address family view
Default level
2: System level
Parameters
None
Description
Use compare-different-as-med to enable the comparison of the MED for paths from peers in different ASs.
Use undo compare-different-as-med to disable the comparison.
The comparison is disabled by default.
If several paths are available for one destination, the path with the smallest MED value is selected.
Do not use this command unless associated ASs adopt the same IGP protocol and routing selection method.
Examples
# Enable to compare the MED for paths from peers in different ASs.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] compare-different-as-med
dampening (IPv6 address family view)
Syntax
dampening [ half-life-reachable half-life-unreachable reuse suppress ceiling | route-policy route-policy-name ] *
undo dampening
View
IPv6 address family view
Default level
2: System level
Parameters
half-life-reachable: Half-life for reachable routes, in the range of 1 to 45 minutes. By default, the value is 15 minutes.
half-life-unreachable: Half-life for unreachable routes, in the range of 1 to 45 minutes. By default, the value is 15 minutes.
reuse: Reuse threshold value for suppressed routes, in the range of 1 to 20000. Penalty value of a suppressed route decreasing under the value is reused. By default, its value is 750.
suppress: Suppression threshold in the range of 1 to 20000, which should be bigger than the reuse value. Routes with a penalty value bigger than the threshold are suppressed. By default, it is 2000.
ceiling: Ceiling penalty value in the range of 1001 to 20000. The value must be bigger than the suppress value. By default, the value is 16000.
route-policy-name: Routing policy name, a string of 1 to 63 characters.
half-life-reachable, half-life-unreachable, reuse, suppress and ceiling are mutually dependent. Once any one is configured, all the others should also be specified.
Description
Use dampening to enable IPv6 BGP route dampening, configure dampening parameters, or both.
Use undo dampening to disable route dampening.
By default, no route dampening is configured.
Related commands: reset bgp ipv6 dampening, reset bgp ipv6 flap-info, display bgp ipv6 routing-table dampened, display bgp ipv6 routing-table dampening parameter, and display bgp ipv6 routing-table flap-info.
Examples
# Enable IPv6 BGP route dampening and configure route dampening parameters.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] dampening 10 10 1000 2000 3000
default local-preference (IPv6 address family view/IPv6 BGP-VPN instance view)
Syntax
default local-preference value
undo default local-preference
View
IPv6 address family view, IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
value: Default local preference in the range of 0 to 4294967295. The larger the value is, the higher the preference is.
Description
Use default local-preference to configure the default local preference.
Use undo default local-preference to restore the default value.
By default, the default local preference is 100.
Use this command to affect IPv6 BGP route selection.
Examples
# Two devices A and B in the same AS are connected to another AS. Change the local preference of B from default value 100 to 180, making the route passing B preferred.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] default local-preference 180
default med (IPv6 address family view/IPv6 BGP-VPN instance view)
Syntax
default med med-value
undo default med
View
IPv6 address family view, IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
med-value: MED value in the range of 0 to 4294967295.
Description
Use default med to specify the default MED value.
Use undo default med to restore the default.
By default, the default med-value is 0.
The multi-exit discriminator (MED) is an external metric of a route. Different from local preference, MED is exchanged between ASs and will stay in the AS once it enters the AS. The route with a lower MED is preferred. When a router running BGP obtains several routes with the identical destination and different next-hops from various external peers, it will select the best route depending on the MED value. In the case that all other conditions are the same, the system first selects the route with the smaller MED value as the best route for the autonomous system.
Examples
# Devices A and B belong to AS100 and device C belongs to AS200. C is the peer of A and B. Configure the MED of A as 25 to make C select the path from B.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] default med 25
default-route imported (IPv6 address family view/IPv6 BGP-VPN instance view)
Syntax
default-route imported
undo default-route imported
View
IPv6 address family view, IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
None
Description
Use default-route imported to enable the redistribution of default route into the IPv6 BGP routing table.
Use undo default-route imported to disable the redistribution.
By default, the redistribution is not enabled.
Examples
# Enable the redistribution of default route from OSPFv3 into IPv6 BGP.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] default-route imported
[Sysname-bgp-af-ipv6] import-route ospfv3 1
display bgp ipv6 group
Syntax
display bgp ipv6 group [ group-name ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
group-name: Peer group name, a string of 1 to 47 characters.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 group to display peer group information.
If no group-name is specified, this command displays information about all peer groups.
Examples
# Display information about the IPv6 peer group aaa.
<Sysname> display bgp ipv6 group aaa
BGP peer-group is aaa
Remote AS 100
Type: internal
Maximum allowed prefix number: 4294967295
Threshold: 75%
Configured hold timer value: 180
Keepalive timer value: 60
Minimum time between advertisement runs is 15 seconds
Peer Preferred Value: 0
No routing policy is configured
Members:
Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State
2001::1 100 0 0 0 0 00:00:07 Idle
Table 2 Command output
Field |
Description |
BGP peer-group |
Name of the peer group. |
Remote AS |
AS number of the peer group. If the peer group AS number has been specified with the peer ipv6-address as-number as-number command, the specified AS number is displayed in this field. Otherwise, a "Remote AS number not specified" prompt is displayed. |
Type |
Type of the peer group: · internal—IBGP peer group. · external—EBGP peer group. |
Maximum allowed prefix number |
Maximum allowed prefix number. |
Threshold |
Threshold value. |
Configured hold timer value |
Holdtime. |
Keepalive timer value |
Keepalive interval. |
Minimum time between advertisement runs |
Minimum interval between advertisements. |
Route refresh capability has been enabled |
The route-refresh capability has been enabled. |
ORF advertise capability based on prefix (type 64): |
The BGP peer supports the ORF capability based on IP prefix. The capability value is 64. |
Local: both |
The local BGP router supports both the ORF sending and receiving capabilities. |
Negotiated: send |
Negotiation result: the local BGP router can send Router-refresh messages carrying the ORF information, and the peer can receive Router-refresh messages carrying the ORF information. If receive is displayed, the local BGP router can receive Router-refresh messages carrying the ORF information, and the peer can send Router-refresh messages carrying the ORF information. This field is not displayed if neither the send nor the receive capability is supported. |
Peer Preferred Value |
Preferred value of the routes from the peer. |
Routing policy configured |
A routing policy is configured. |
No routing policy is configured |
No routing policy is configured. |
Members |
Group members. |
Peer |
IPv6 address of the peer. |
AS |
AS number. |
MsgRcvd |
Number of messages received. |
MsgSent |
Number of messages sent. |
OutQ |
Number of messages to be sent. |
PrefRcv |
Number of prefixes received. |
Up/Down |
Lasting time of a session/lasting time of present state (when no session is established). |
State |
State machine state of peer. |
display bgp ipv6 network
Syntax
display bgp ipv6 network [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 network to display IPv6 routes advertised with the network command.
Examples
# Display IPv6 routes advertised with the network command.
<Sysname> display bgp ipv6 network
BGP Local Router ID is 1.1.1.2.
Local AS Number is 200.
Network Prefix Route-policy Short-cut
2002:: 64
2001:: 64 Short-cut
Table 3 Command output
Field |
Description |
BGP Local Router ID |
BGP Local Router ID. |
Local AS Number |
Local AS Number. |
Network |
Network address. |
Prefix |
Prefix length. |
Route-policy |
Routing policy. (A null value indicates no routing policy is configured.) |
Short-cut |
Shortcut route. (A null value indicates the route is not a shortcut route.) |
display bgp ipv6 paths
Syntax
display bgp ipv6 paths [ as-regular-expression | | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
as-regular-expression: AS path regular expression, a string of 1 to 80 characters.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 paths to display IPv6 BGP path information.
If no parameter is specified, all path information will be displayed.
Examples
# Display IPv6 BGP path information.
<Sysname> display bgp ipv6 paths
Address Hash Refcount MED Path/Origin
0x5917098 1 1 0 i
0x59171D0 9 2 0 100i
Table 4 Command output
Field |
Description |
Address |
Route destination address in local database, in dotted hexadecimal notation. |
Hash |
Hash index. |
Refcount |
Count of routes that used the path. |
MED |
MED of the path. |
Path |
AS_PATH attribute of the path, recording the ASs it has passed, for avoiding routing loops. |
Origin |
Origin attribute of the route: · i—The route is interior to the AS. Summary routes and routes defined using the network command are considered IGP routes. · e—A route is learned from the exterior gateway protocol (EGP). · ?—Short for INCOMPLETE. It indicates that the origin of a route is unknown and the route is learned by other means. BGP sets Origin attribute of routes learned from other IGP protocols to INCOMPLETE. |
display bgp ipv6 peer
Syntax
display bgp ipv6 peer [ group-name log-info | ipv4-address verbose | ipv6-address { log-info | verbose } | verbose ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv4-address: IPv4 address of a peer.
ipv6-address: Specifies the IPv6 address of a peer to be displayed.
log-info: Displays log information for the specified peer.
verbose: Displays detailed information about the peer.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 peer to display peer/peer group information.
If no parameter specified, information about all peers and peer groups is displayed.
Examples
# Display all IPv6 peer information.
<Sysname> display bgp ipv6 peer
BGP local router ID : 192.168.1.40
Local AS number : 100
Total number of peers : 1 Peers in established state : 0
Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State
2001::1 100 0 0 0 0 00:02:02 Active
Table 5 Command output
Field |
Description |
BGP local router ID |
Local router ID. |
Local AS number |
Local AS number. |
Total number of peers |
Total number of BGP peers. |
Peers in established state |
Number of established BGP peers. |
Peer |
IPv6 address of the peer. |
AS |
AS number. |
MsgRcvd |
Messages received. |
MsgSent |
Messages sent. |
OutQ |
Messages to be sent. |
PrefRcv |
Number of prefixes received. |
Up/Down |
Lasting time of a session/lasting time of present state (when no session is established) |
State |
Peer state. |
# Display detailed information about IPv6 peer 1::1.
<Sysname> display bgp ipv6 peer 1::1 verbose
BGP Peer is 1::1, remote AS 100,
Type: EBGP link
BGP version 4, remote router ID 45.1.1.1
BGP current state: Established, Up for 00h01m34s
BGP current event: KATimerExpired
BGP last state: OpenConfirm
Port: Local - 1031 Remote - 179
Configured: Active Hold Time: 180 sec Keepalive Time: 60 sec
Received : Active Hold Time: 180 sec
Negotiated: Active Hold Time: 180 sec Keepalive Time:60 sec
Peer optional capabilities:
Peer support bgp multi-protocol extended
Peer support bgp route refresh capability
Peer support bgp route AS4 capability
Graceful Restart Capability: advertised and received
Restart Timer Value of Peer: 150 seconds
Forwarding State preserved by Peer for following Address families:
Address family IPv6 Unicast: advertised and received
Received: Total 4 messages, Update messages 1
Sent: Total 6 messages, Update messages 3
Maximum allowed prefix number: 4294967295
Threshold: 75%
Minimum time between advertisement runs is 30 seconds
Optional capabilities:
Route refresh capability has been enabled
Peer Preferred Value: 0
Routing policy configured:
No routing policy is configured
BFD: Enabled
# Display detailed information about IPv6 BGP peers.
<Sysname> display bgp ipv6 peer verbose
BGP Peer is 2::4, remote AS 1,
Type: IBGP link
BGP version 4, remote router ID 1.1.1.1
BGP current state: Established, Up for 00h01m51s
BGP current event: RecvKeepalive
BGP last state: OpenConfirm
Received: Total 5 messages, Update messages 1
Sent: Total 4 messages, Update messages 0
Maximum allowed prefix number: 4294967295
Threshold: 75%
Minimum time between advertisement runs is 30 seconds
Optional capabilities:
Route refresh capability has been enabled
ORF advertise capability based on prefix (type 64):
Local: both
Negotiated: send
Peer Preferred Value: 0
IPsec policy name: policy001, SPI: 300
Routing policy configured:
No routing policy is configured
Table 6 Command output
Field |
Description |
Type |
BGP connection type: EBGP or IBGP. |
Up for |
Lasting time of a BGP connection. |
Peer optional capabilities: Peer support bgp multi-protocol extended Peer support bgp route refresh capability Peer support bgp route AS4 capability |
Optional capabilities supported by the BGP peer: Multi-protocol extension for BGP. Route-refresh feature. 4-byte AS number. |
Graceful Restart Capability: advertised and received Restart Timer Value of Peer: 150 seconds Forwarding State preserved by Peer for following Address families: |
GR capability: the advertising and receiving capabilities have been successfully negotiated. · GR restart timer of the peer is 150 seconds. · Address family information for which the peer preserves the forwarding state. |
Address family IPv6 Unicast: advertised and received |
BGP IPv6 unicast capability: the advertising and receiving capabilities have been successfully negotiated. |
Threshold |
Threshold of the routes received from the peer (ratio of the number of received routes to the configured upper limit in percentage) when an alarm is generated. |
Minimum time between advertisement runs is 30 seconds |
Minimum interval between advertisements. |
Optional capabilities Route refresh capability has been enabled ORF advertise capability based on prefix (type 64): Local: both Negotiated: send |
Optional capabilities enabled on the peer: · Route-refresh is enabled. · The IPv6 BGP peer supports the ORF capability based on IP prefix. The capability value is 64. · The local IPv6 BGP router supports both the ORF sending and receiving capabilities. · Negotiation result—The local IPv6 BGP router can send Router-refresh messages carrying the ORF information, and the peer can receive Router-refresh messages carrying the ORF information. (If receive is displayed, the local BGP router can receive Router-refresh messages carrying the ORF information, and the peer can send Router-refresh messages carrying the ORF information. This field is not displayed if neither the send nor the receive capability is supported. |
Peer Preferred Value |
Preferred value assigned to routes received from the peer. |
IPsec policy name: policy001, SPI: 300 |
IPsec policy applied to the peer and SPI of the IPsec policy. |
BFD |
Indicates whether BFD is enabled over the link to the IPv6 BGP peer. |
# Display log information for the IPv6 peer 20::21.
<sysname> display bgp ipv6 peer 20::21 log-info
Peer : 20::21
Date Time State Notification
Error/SubError
10-Jul-2008 15:46:17 Down Send Notification with Error 1/1
Message Header Error/Connection Not Synchronized
10-Jul-2008 09:23:00 Up
10-Jul-2008 07:46:17 Down Receive Notification with Error 3/2
UPDATE Message Error/Unsupported optional Parameter
10-Jul-2008 06:23:00 Up
10-Jul-2008 05:46:17 Down Send Notification with Error 6/4
Administrative Reset
Table 7 Command output
Field |
Description |
Peer |
IPv6 address of the peer. |
Date |
Date on which the Notification was sent or received. |
Time |
Time at which the Notification was sent or received. |
State |
BGP session state: · Up—The BGP session is up. · Down—The BGP session is down. |
Notification |
Notification message. |
Error/SubError |
Error refers to the error code, which identifies the type of the Notification. SubError refers to the error subcode of the Notification, which identifies the specific information about the reported error. |
display bgp ipv6 peer received ipv6-prefix
Syntax
display bgp ipv6 peer { ip-address | ipv6-address } received ipv6-prefix [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
ip-address: IP address of a BGP peer.
ipv6-address: IPv6 address of a BGP peer.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 peer received ipv6-prefix to display the prefix entries in the ORF information for the specified BGP peer.
Examples
# Display the prefix information in the ORF packet from the BGP peer 4::4.
<Sysname> display bgp ipv6 peer 4::4 received ipv6-prefix
ORF ipv6-prefix entries: 2
ge: greater-equal le: less-equal
index rule prefix ge le
10 permit 1::/64 80 128
20 deny 100::/64 80 128
Table 8 Command output
Field |
Description |
ORF ipv6-prefix entries |
Number of ORF prefix entries. |
index |
Index of a prefix entry. |
rule |
Matching rule of the prefix. |
prefix |
Prefix information. |
ge |
greater-equal, indicating the mask length must be greater than or equal to the specific value. |
le |
less-equal, indicating the mask length must be less than or equal to the specific value. |
display bgp ipv6 routing-table
Syntax
display bgp ipv6 routing-table [ ipv6-address prefix-length ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
ipv6-address: Destination IPv6 address.
prefix-length: Prefix length of the IPv6 address, in the range of 0 to 128.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 routing-table to display IPv6 BGP routing table information.
Examples
# Display the IPv6 BGP routing table.
<Sysname> display bgp ipv6 routing-table
Total Number of Routes: 2
BGP Local router ID is 30.30.30.1
Status codes: * - valid, ^ - VPNv4 best, > - best, d - damped,
h - history, i - internal, s - suppressed, S - Stale
Origin : i - IGP, e - EGP, ? - incomplete
*> Network : 30:30:: PrefixLen : 64
NextHop : 30:30::30:1 LocPrf :
PrefVal : 0 Label : NULL
MED :0
Path/Ogn: i
*> Network : 40:40:: PrefixLen : 64
NextHop : 40:40::40:1 LocPrf :
PrefVal : 0 Label : NULL
MED : 0
Path/Ogn: i
Field |
Description |
Local router ID |
Local router ID. |
Status codes |
Status codes: · * – valid—Valid route. · ^ - VPNv4 best—Best VPNv4 route. · > – best—Best route. · d – damped—Dampened route. · h – history—History route. · i – internal—Internal route. · s –suppressed—Suppressed route. · S – Stale—Stale route. |
Origin |
Origin attributes: · i – IGP—Originated in the AS. · e – EGP—Learned through EGP. · ? – incomplete—Learned by other means. |
Network |
Destination network address. |
PrefixLen |
Prefix length. |
NextHop |
Next Hop. |
MED |
MULTI_EXIT_DISC attribute. |
LocPrf |
Local preference value. |
Path |
AS_PATH attribute, recording the ASs the packet has passed to avoid routing loops. |
PrefVal |
Preferred value. |
Label |
Label. |
Ogn |
Origin attribute of the route, which can take on one of the following values: · i—A route is interior to the AS. Summary routes and the routes configured using the network command are considered IGP routes. · e—A route is learned from the exterior gateway protocol (EGP). · ?—Short for INCOMPLETE. It indicates that the origin of a route is unknown and the route is learned by other means. BGP sets Origin attribute of routes learned from other IGP protocols to INCOMPLETE. |
display bgp ipv6 routing-table as-path-acl
Syntax
display bgp ipv6 routing-table as-path-acl as-path-acl-number [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
as-path-acl-number: Number of an AS path ACL permitted by which to display routing information, in the range of 1 to 256.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 routing-table as-path-acl to display routes filtered through the specified AS path ACL.
Examples
# Display routes filtered through the AS path ACL 20.
<Sysname> display bgp ipv6 routing-table as-path-acl 20
BGP Local router ID is 30.30.30.1
Status codes: * - valid, ^ - VPNv4 best, > - best, d - damped,
h - history, i - internal, s - suppressed, S - Stale
Origin : i - IGP, e - EGP, ? - incomplete
*> Network : 30:30:: PrefixLen : 64
NextHop : 30:30::30:1 LocPrf :
PrefVal : 0 Label : NULL
MED : 0
Path/Ogn: i
For description of the fields, see Table 9.
display bgp ipv6 routing-table community
Syntax
display bgp ipv6 routing-table community [ aa:nn&<1-13> ] [ no-advertise | no-export | no-export-subconfed ] * [ whole-match ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
aa:nn: Community number. Both aa and nn are in the range of 0 to 65535.
&<1-13>: Indicates the argument before it can be entered up to 13 times.
no-advertise: Displays IPv6 BGP routes that cannot be advertised to any peer.
no-export: Displays IPv6 BGP routes that cannot be advertised out of the AS; if a confederation exists, it displays IPv6 BGP routes that cannot be advertised out of the confederation, but can be advertised to other sub-ASs in the confederation.
no-export-subconfed: Displays IPv6 BGP routes that cannot be advertised out of the AS or to other sub-ASs if a confederation is configured.
whole-match: Displays the IPv6 BGP routes exactly matching the specified COMMUNITY attribute.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 routing-table community to display the routing information with the specified COMMUNITY attribute.
Examples
# Display the routing information with community attribute NO_EXPORT.
<Sysname> display bgp ipv6 routing-table community no-export
BGP Local router ID is 30.30.30.1
Status codes: * - valid, ^ - VPNv4 best, > - best, d - damped,
h - history, i - internal, s - suppressed, S - Stale
Origin : i - IGP, e - EGP, ? - incomplete
*> Network : 30:30:: PrefixLen : 64
NextHop : 30:30::30:1 LocPrf :
PrefVal : 0 Label : NULL
MED : 0
Path/Ogn: i
For description of the fields, see Table 9.
display bgp ipv6 routing-table community-list
Syntax
display bgp ipv6 routing-table community-list { { basic-community-list-number | comm-list-name } [ whole-match ] | adv-community-list-number }&<1-16> [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
basic-community-list-number: Specifies a basic community-list number in the range of 1 to 99.
adv-community-list-number: Specifies an advanced community-list number in the range of 100 to 199.
comm-list-name: Specifies a community list name, a string of 1 to 31 characters (not all are numbers).
whole-match: Displays routes exactly matching the specified basic-community-list-number.
&<1-16>: Specifies to allow entering the argument before it up to 16 times.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 routing-table community-list to view the routing information matching the specified IPv6 BGP community list.
Examples
# Display the routing information matching the specified IPv6 BGP community list.
<Sysname> display bgp ipv6 routing-table community-list 99
BGP Local router ID is 30.30.30.1
Status codes: * - valid, ^ - VPNv4 best, > - best, d - damped,
h - history, i - internal, s - suppressed, S - Stale
Origin : i - IGP, e - EGP, ? - incomplete
*> Network : 30:30:: PrefixLen : 64
NextHop : 30:30::30:1 LocPrf :
PrefVal : 0 Label : NULL
MED :0
Path/Ogn: i
For description of the fields, see Table 9.
display bgp ipv6 routing-table dampened
Syntax
display bgp ipv6 routing-table dampened [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 routing-table dampened to display the IPv6 BGP dampened routes.
Examples
# Display IPv6 BGP dampened routes.
<Sysname> display bgp ipv6 routing-table dampened
BGP Local router ID is 1.1.1.1
Status codes: * - valid, ^ - VPNv4 best, > - best, d - damped,
h - history, i - internal, s - suppressed, S - Stale
Origin : i - IGP, e - EGP, ? - incomplete
*d Network : 111:: PrefixLen : 64
From : 122::1 Reuse : 00:29:34
Path/Ogn: 200?
Table 10 Command output
Field |
Description |
From |
Source IP address of a route. |
Reuse |
Time for reuse. |
For description of the fields, see Table 9.
display bgp ipv6 routing-table dampening parameter
Syntax
display bgp ipv6 routing-table dampening parameter [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 routing-table dampening parameter to display IPv6 BGP routing dampening parameters.
Related commands: dampening.
Examples
# Display IPv6 BGP routing dampening parameters.
<Sysname> display bgp ipv6 routing-table dampening parameter
Maximum Suppress Time(in second) : 950
Ceiling Value : 3000
Reuse Value : 1000
Reach HalfLife Time(in second) : 600
Unreach HalfLife Time(in second) : 600
Suppress-Limit : 2000
Table 11 Command output
Field |
Description |
Maximum Suppress Time |
Maximum Suppress Time. |
Ceiling Value |
Upper limit of penalty value. |
Reuse Value |
Reuse value. |
Reach HalfLife Time(in second) |
Half-life time of active routes. |
Unreach HalfLife Time(in second) |
Half-life time of inactive routes. |
Suppress-Limit |
Suppress value. |
display bgp ipv6 routing-table different-origin-as
Syntax
display bgp ipv6 routing-table different-origin-as [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 routing-table different-origin-as to display IPv6 BGP routes originating from different autonomous systems.
Examples
# Display routes from different ASs.
<Sysname> display bgp ipv6 routing-table different-origin-as
BGP Local router ID is 2.2.2.2
Status codes: * - valid, ^ - VPNv4 best, > - best, d - damped,
h - history, i - internal, s - suppressed, S - Stale
Origin : i - IGP, e - EGP, ? - incomplete
*> Network : 222:: PrefixLen : 64
NextHop : 122::2 LocPrf :
PrefVal : 0 Label : NULL
MED : 0
Path/Ogn: 100 ?
For description of the fields, see Table 9.
display bgp ipv6 routing-table flap-info
Syntax
display bgp ipv6 routing-table flap-info [ regular-expression as-regular-expression | [ as-path-acl as-path-acl-number | ipv6-address prefix-length [ longer-match ] ] [ | { begin | exclude | include } regular-expression ] ]
View
Any view
Default level
1: Monitor level
Parameters
as-regular-expression: AS path regular expression to be matched, a string of 1 to 80 characters.
as-path-acl-number: Number of the specified AS path ACL to be matched, in the range of 1 to 256.
ipv6-address: IPv6 address of a route to be displayed.
prefix-length: Prefix length of the IPv6 address, in the range of 0 to 128.
longer-match: Matches the longest prefix.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 routing-table flap-info to display IPv6 BGP route flap statistics.
Examples
# Display IPv6 BGP route flap statistics.
<Sysname> display bgp ipv6 routing-table flap-info
BGP Local router ID is 1.1.1.1
Status codes: * - valid, ^ - VPNv4 best, > - best, d - damped,
h - history, i - internal, s - suppressed, S - Stale
Origin : i - IGP, e - EGP, ? - incomplete
*d Network : 111:: PrefixLen : 64
From : 122::1 Flaps : 3
Duration : 00:13:47 Reuse : 00:16:36
Path/Ogn : 200?
Table 12 Command output
Field |
Description |
Flaps |
Number of flaps. |
Duration |
Flap duration. |
Reuse |
Reuse time of the route. |
For description of the fields, see Table 9.
display bgp ipv6 routing-table label
Syntax
display bgp ipv6 routing-table label [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 routing-table label to display IPv6 BGP label routing information.
Examples
# Display IPv6 BGP label routing information.
<Sysname> display bgp ipv6 routing-table label
Total Number of Routes: 1
Network Prefix NextHop In/Out Label
200:: 96 ::FFFF:2.1.1.1 NULL/1024
Table 13 Command output
Field |
Description |
Network |
Network address. |
Prefix |
Prefix length. |
NextHop |
Next hop. |
In/Out Label |
MPLS incoming/outgoing label information. |
display bgp ipv6 routing-table peer
Syntax
display bgp ipv6 routing-table peer { ipv4-address | ipv6-address } { advertised-routes | received-routes } [ network-address prefix-length | statistic ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
ipv4-address: Specifies the IPv4 peer to be displayed.
ipv6-address: Specifies the IPv6 peer to be displayed.
advertised-routes: Routing information advertised to the specified peer.
received-routes: Routing information received from the specified peer.
network-address prefix-length: IPv6 address and prefix length. The value range for the prefix length is 0 to 128.
statistic: Displays route statistics.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 routing-table peer to display the routing information advertised to or received from the specified IPv4 or IPv6 BGP peer.
Examples
# Display the routing information advertised to the specified BGP peer.
<Sysname> display bgp ipv6 routing-table peer 10:10::10:1 advertised-routes
Total Number of Routes: 2
BGP Local router ID is 20.20.20.1
Status codes: * - valid, ^ - VPNv4 best, > - best, d - damped,
h - history, i - internal, s - suppressed, S - Stale
Origin : i - IGP, e - EGP, ? - incomplete
*> Network : 20:20:: PrefixLen : 64
NextHop : 20:20::20:1 LocPrf :
PrefVal : 0 Label : NULL
MED : 0
Path/Ogn: i
*> Network : 40:40:: PrefixLen : 64
NextHop : 30:30::30:1 LocPrf :
PrefVal : 0 Label : NULL
MED : 0
Path/Ogn: 300 i
For description of the fields, see Table 9.
display bgp ipv6 routing-table regular-expression
Syntax
display bgp ipv6 routing-table regular-expression as-regular-expression
View
Any view
Default level
1: Monitor level
Parameters
as-regular-expression: AS regular expression, a string of 1 to 80 characters.
Description
Use display bgp ipv6 routing-table regular-expression to display the routes permitted by the specified AS regular expression.
Examples
# Display routing information matching the specified AS regular expression.
<Sysname> display bgp ipv6 routing-table regular-expression ^100
BGP Local router ID is 20.20.20.1
Status codes: * - valid, ^ - VPNv4 best, > - best, d - damped,
h - history, i - internal, s - suppressed, S - Stale
Origin : i - IGP, e - EGP, ? - incomplete
*> Network : 50:50:: PrefixLen : 64
NextHop : 10:10::10:1 LocPrf :
PrefVal : 0 Label : NULL
MED : 0
Path/Ogn: 100 i
For description of the fields, see Table 9.
display bgp ipv6 routing-table statistic
Syntax
display bgp ipv6 routing-table statistic [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display bgp ipv6 routing-table statistic to display IPv6 BGP routing statistics.
Examples
# Display IPv6 BGP routing statistics.
<Sysname> display bgp ipv6 routing-table statistic
Total Number of Routes: 1
filter-policy export (IPv6 address family view/IPv6 BGP-VPN instance view)
Syntax
filter-policy { acl6-number | ipv6-prefix ipv6-prefix-name } export [ protocol process-id ]
undo filter-policy export [ protocol process-id ]
View
IPv6 address family view, IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
acl6-number: Specifies the number of an ACL6 used to match against the destination of routing information. The number is in the range of 2000 to 3999.
ipv6-prefix-name: Specifies the name of an IPv6 prefix list used to match against the destination of routing information. The name is a string of 1 to 19 characters.
protocol: Filters routes redistributed from the routing protocol. It can be direct, isisv6, ospfv3, ripng, or static. If no protocol is specified, all routes will be filtered when advertised.
process-id: Process ID of the routing protocol, in the range of 1 to 65535. It is available only when the protocol is isisv6, ospfv3 or ripng.
Description
Use filter-policy export to filter outbound routes using a specified filter.
Use undo filter-policy export to cancel filtering outbound routes.
By default, no outbound routing information is filtered.
If a protocol is specified, only routes redistributed from the specified protocol are filtered. If no protocol is specified, all redistributed routes will be filtered.
If you want to reference an advanced ACL (with a number from 3000 to 3999) in the command, the ACL should be configured with the rule [ rule-id ] { deny | permit } ipv6 source sour sour-prefix command to deny/permit a route with the specified destination, or with the rule [ rule-id ] { deny | permit } ipv6 source sour sour-prefix destination dest dest-prefix command to deny/permit a route with the specified destination and prefix. The source keyword specifies the destination address of a route and the destination keyword specifies the prefix of the route (the prefix must be valid; otherwise, the configuration is ineffective).
Examples
# Reference ACL6 2001 to filter all outbound IPv6 BGP routes.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] filter-policy 2001 export
# Configure ACL6 3000 to permit only route 2001::1/128 to pass, and reference ACL6 3000 to filter outbound routes.
<Sysname> system-view
[Sysname] acl ipv6 number 3000
[Sysname-acl6-adv-3000] rule 10 permit ipv6 source 2001::1 128 destination ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff 128
[Sysname-acl6-adv-3000] rule 100 deny ipv6
[Sysname-acl6-adv-3000] quit
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] filter-policy 3000 export
filter-policy import (IPv6 address family view/IPv6 BGP-VPN instance view)
Syntax
filter-policy { acl6-number | ipv6-prefix ipv6-prefix-name } import
undo filter-policy import
View
IPv6 address family view, IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
acl6-number: Number of an IPv6 ACL used to match against the destination address field of routing information, in the range of 2000 to 3999.
ipv6-prefix-name: Name of an IPv6 prefix list used to match against the destination address field of routing information, a string of 1 to 19 characters.
Description
Use filter-policy import to filter inbound routing information using a specified filter.
Use undo filter-policy import to cancel filtering inbound routing information.
By default, no inbound routing information is filtered.
If you want to reference an advanced ACL (with a number from 3000 to 3999) in the command, the ACL should be configured with the rule [ rule-id ] { deny | permit } ipv6 source sour sour-prefix command to deny/permit a route with the specified destination, or with the rule [ rule-id ] { deny | permit } ipv6 source sour sour-prefix destination dest dest-prefix command to deny/permit a route with the specified destination and prefix. The source keyword specifies the destination address of a route and the destination keyword specifies the prefix of the route (the prefix must be valid; otherwise, the configuration is ineffective).
Examples
# Reference ACL6 2001 to filter all inbound routes.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] filter-policy 2001 import
# Configure ACL6 3000 to permit only route 2001::1/128 to pass, and reference ACL6 3000 to filter inbound routes.
<Sysname> system-view
[Sysname] acl ipv6 number 3000
[Sysname-acl6-adv-3000] rule 10 permit ipv6 source 2001::1 128 destination ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff 128
[Sysname-acl6-adv-3000] rule 100 deny ipv6
[Sysname-acl6-adv-3000] quit
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] filter-policy 3000 import
group (IPv6 address family view)
Syntax
group group-name [ internal | external ]
undo group group-name
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
internal: Creates an IBGP peer group.
external: Creates an EBGP peer group, which can be a group of another sub-AS in the confederation.
Description
Use group to create a peer group.
Use undo group to delete a peer group.
An IBGP peer group will be created if neither internal nor external is selected.
Examples
# Create an IBGP peer group named test.
<Sysname> system-view
[Sysname] bgp 100
[Sysname] ipv6-family
[Sysname-bgp-af-ipv6] group test
import-route (IPv6 address family view/IPv6 BGP-VPN instance view)
Syntax
import-route protocol [ process-id [ med med-value | route-policy route-policy-name ] * ]
undo import-route protocol [ process-id ]
View
IPv6 address family view, IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
protocol: Redistributes routes from the specified protocol, which can be direct, isisv6, ospfv3, ripng and static.
process-id: Process ID in the range of 1 to 65535. The default is 1. It is available only when the protocol is isisv6, ospfv3 or ripng.
med-value: Applies the MED value to redistributed routes. The value is in the range of 0 to 4294967295. If not specified, the cost of the redistributed route is used as its MED in the IPv6 BGP routing domain.
route-policy-name: Name of a routing policy used to filter redistributed routes, a string of 1 to 63 characters.
Description
Use import-route to redistribute routes from another routing protocol.
Use undo import-route to remove the configuration.
By default, IPv6 BGP does not redistribute routes from any routing protocol.
The routes redistributed using the import-route command has the INCOMPLETE origin attribute.
Examples
# Redistribute routes from RIPng 1.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] import-route ripng 1
ipv6-family
Syntax
ipv6-family [ vpnv6 | vpn-instance vpn-instance-name ]
undo ipv6-family [ vpnv6 | vpn-instance vpn-instance-name ]
View
BGP view
Default level
2: System level
Parameters
vpnv6: Enters BGP-VPNv6 address family view.
vpn-instance vpn-instance-name: Enters IPv6 BGP-VPN instance view. vpn-instance-name is a string of 1 to 31 case-sensitive characters.
Description
Use ipv6-family to enter IPv6 address family view.
Use undo ipv6-family to remove all configurations from the view.
Use ipv6-family vpnv6 to enter BGP-VPNv6 address family view.
Use undo ipv6-family vpnv6 to remove all configurations from the view.
Use ipv6-family vpn-instance vpn-instance-name to enter IPv6 BGP-VPN instance view.
Use undo ipv6-family vpn-instance vpn-instance-name to remove all configurations from the view.
IPv4 BGP unicast view is the default.
Before entering IPv6 BGP-VPN instance view, you must create the VPN instance.
Examples
# Enter IPv6 address family view.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6]
# Enter IPv6 BGP-VPN instance view.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family vpn-instance vpn1
[Sysname-bgp-ipv6-vpn1]
# Enter BGP-VPNv6 address family view.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family vpnv6
[Sysname-bgp-af-vpnv6]
network (IPv6 address family view/IPv6 BGP-VPN instance view)
Syntax
network ipv6-address prefix-length [ route-policy route-policy-name | short-cut ]
undo network ipv6-address prefix-length [ short-cut ]
View
IPv6 address family view, IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
ipv6-address: IPv6 address.
prefix-length: Prefix length of the address, in the range of 0 to 128.
route-policy-name: Name of a routing policy, a string of 1 to 63 characters.
short-cut: If the keyword is specified for an EBGP route, the route will use the local routing management value rather than that of EBGP routes, so the preference of the route is reduced.
Description
Use network to advertise a network to the IPv6 BGP routing table.
Use undo network to remove an entry from the IPv6 BGP routing table.
By default, no route is advertised.
The route to be advertised must exist in the local IP routing table, and using a routing policy makes route management more flexible.
The route advertised to the BGP routing table using the network command has the IGP origin attribute.
Examples
# Advertise the network 2002::/16 into the IPv6 BGP routing table.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] network 2002:: 16
peer advertise-community (IPv6 address family view)
Syntax
peer { group-name | ipv4-address | ipv6-address } advertise-community
undo peer { group-name | ipv4-address | ipv6-address } advertise-community
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv4-address: IPv4 address of a peer.
ipv6-address: IPv6 address of a peer.
Description
Use peer advertise-community to advertise the COMMUNITY attribute to a peer/peer group.
Use undo peer advertise-community to remove the configuration.
By default, no COMMUNITY attribute is advertised to any peer group/peer.
Examples
# Advertise the COMMUNITY attribute to the peer 1:2::3:4.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 advertise-community
peer advertise-community (IPv6 BGP-VPN instance view)
Syntax
peer ipv6-address advertise-community
undo peer ipv6-address advertise-community
View
IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
ipv6-address: IPv6 address of a peer.
Description
Use peer advertise-community to advertise the COMMUNITY attribute to a peer.
Use undo peer advertise-community to remove the configuration.
By default, no COMMUNITY attribute is advertised to any peer.
Examples
# Advertise the COMMUNITY attribute to the peer 2001::1.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family vpn-instance vpn1
[Sysname-bgp-ipv6-vpn1] peer 2001::1 advertise-community
peer advertise-ext-community (IPv6 address family view)
Syntax
peer { group-name | ipv4-address | ipv6-address } advertise-ext-community
undo peer { group-name | ipv4-address | ipv6-address } advertise-ext-community
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv4-address: IPv4 address of a peer.
ipv6-address: IPv6 address of a peer.
Description
Use peer advertise-ext-community to advertise the extended community attribute to a peer/peer group.
Use undo peer advertise-ext-community to remove the configuration.
By default, no extended community attribute is advertised to a peer/peer group.
Examples
# Advertise the extended community attribute to the peer 1:2::3:4.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 advertise-ext-community
peer allow-as-loop (IPv6 address family view)
Syntax
peer { group-name | ipv4-address | ipv6-address } allow-as-loop [ number ]
undo peer { group-name | ipv4-address | ipv6-address } allow-as-loop
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv4-address: IPv4 address of a peer.
ipv6-address: IPv6 address of a peer.
number: Specifies the number of times for which the local AS number can appear in routes from the peer/peer group, in the range of 1 to 10. The default number is 1.
Description
Use peer allow-as-loop to configure IPv6 BGP to allow the local AS number to exist in the AS_PATH attribute of routes from a peer/peer group, and to configure the times for which it can appear.
Use undo peer allow-as-loop to disable the function.
The local AS number is not allowed to exist in the AS_PATH attribute of routes by default.
Examples
# Configure the number of times for which the local AS number can appear in the AS PATH of routes from peer 1::1 as 2.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1::1 allow-as-loop 2
peer as-number (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } as-number as-number
undo peer group-name as-number
undo peer ipv6-address
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
as-number: AS number of the peer/peer group, in the range of 1 to 4294967295.
Description
Use peer as-number to configure an IPv6 peer/peer group.
Use undo peer group-name as-number to delete a peer group.
Use undo peer ipv6-address to delete a peer.
Examples
# Configure peer group test in AS 200.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] group test external
[Sysname-bgp-af-ipv6] peer test as-number 200
peer as-number (IPv6 BGP-VPN instance view)
Syntax
peer ipv6-address as-number as-number
undo peer ipv6-address
View
IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
ipv6-address: IPv6 address of a peer.
as-number: AS number of the peer/peer group, in the range of 1 to 4294967295.
Description
Use peer as-number to configure an IPv6 peer/peer group.
Use undo peer ipv6-address to delete a peer.
Examples
# Configure peer 2001::1 in AS 200.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family vpn-instance vpn1
[Sysname-bgp-ipv6-vpn1] peer 2001::1 as-number 200
peer as-path-acl (IPv6 address family view)
Syntax
peer { group-name | ipv4-address | ipv6-address } as-path-acl as-path-acl-number { import | export }
undo peer { group-name | ipv4-address | ipv6-address } as-path-acl as-path-acl-number { import | export }
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv4-address: IPv4 address of a peer.
ipv6-address: IPv6 address of a peer.
as-path-acl-number: Number of an AS path ACL, in the range of 1 to 256.
import: Filters incoming routes.
export: Filters outgoing routes.
Description
Use peer as-path-acl to specify an AS path ACL to filter routes incoming from or outgoing to a peer/peer group.
Use undo peer as-path-acl to remove the configuration.
By default, no AS path list is specified for filtering.
Examples
# Specify the AS path ACL 3 to filter routes outgoing to the peer 1:2::3:4.
<Sysname> system-view
[Sysname] ip as-path 3 permit ^200
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 as-path-acl 3 export
peer bfd (IPv6 address family view/IPv6 BGP-VPN instance view)
Syntax
undo peer ipv6-address bfd
View
IPv6 address family view, IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
ipv6-address: IPv6 address of a peer.
Description
Use peer bfd to enable BFD over the link to a BGP peer.
Use undo peer bfd to restore the default.
By default, BFD is not enabled for any BGP peer.
After a link failure occurs, BFD might detect the failure before the system performs GR, and as a result, GR will fail. Therefore, if GR capability is enabled for IPv6 BGP, use BFD with caution.
Examples
# Enable BFD over the link to BGP peer 100::1.
<Sysname> system-view
[Sysname] bgp 100
[Sysname] ipv6-family
[Sysname-bgp-af-ipv6] peer 100::1 bfd
peer capability-advertise orf (IPv6 address family view)
Syntax
peer { group-name | ip-address | ipv6-address } capability-advertise orf ipv6-prefix { both | receive | send }
undo peer { group-name | ip-address | ipv6-address } capability-advertise orf ipv6-prefix { both | receive | send }
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ip-address: IP address of a peer.
ipv6-address: IPv6 address of a peer.
both: Supports sending and receiving route-refresh messages carrying the ORF information.
receive: Supports receiving route-refresh messages carrying the ORF information.
send: Supports sending route-refresh messages carrying the ORF information.
Description
Use peer capability-advertise orf to enable the ORF capability for a BGP peer or peer group.
Use undo peer capability-advertise orf to disable the ORF capability for the BGP peer or peer group.
By default, the ORF capability is not enabled for a BGP peer or peer group.
After you enable the ORF capability, the local BGP router negotiates the ORF capability with the BGP peer through Open messages. After that, the BGP router can process route-refresh messages carrying the standard ORF information from the peer or send route-refresh messages carrying the standard ORF information to the peer. For non-standard ORF capability negotiation, you need also to configure the peer capability-advertise orf non-standard command.
After you disable the ORF capability, the local BGP router does not negotiate the ORF capability with the specified peer or peer group.
Table 14 Description of the both, send, and receive parameters and the negotiation result
Local parameter |
Peer parameter |
Negotiation result |
send |
· receive · both |
The ORF sending capability is enabled locally and the ORF receiving capability is enabled on the peer. |
receive |
· send · both |
The ORF receiving capability is enabled locally and the ORF sending capability is enabled on the peer. |
both |
both |
Both the ORF sending and receiving capabilities are enabled locally and on the peer. |
Examples
# Enable the ORF capability for the BGP peer 1:2::3:4. Then, after negotiation, the local router can exchange ORF information with the peer 1:2::3:4.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 as-number 100
[Sysname-bgp-af-ipv6] peer 1:2::3:4 capability-advertise orf ipv6-prefix both
peer capability-advertise orf non-standard (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } capability-advertise orf non-standard
undo peer { group-name | ipv6-address } capability-advertise orf non-standard
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Parameters
Use peer capability-advertise orf non-standard to enable the non-standard ORF capability (the early implementation of ORF is different from that defined in RFC) for a BGP peer or peer group.
Use undo peer capability-advertise orf non-standard to disable the non-standard ORF capability for the BGP peer or peer group.
By default, the non-standard ORF capability is not enabled for a BGP peer or peer group.
This command needs to be configured when the peer supports only non-standard ORF.
Related commands: peer capability-advertise orf.
Examples
# Enable the non-standard ORF capability for the BGP peer 1:2::3:4 (suppose the BGP peer 1:2::3:4 can only send non-standard ORF packets).
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 as-number 100
[Sysname-bgp-af-ipv6] peer 1:2::3:4 capability-advertise orf non-standard
[Sysname-bgp-af-ipv6] peer 1:2::3:4 capability-advertise orf ip-prefix both
peer capability-advertise route-refresh
Syntax
peer { group-name | ipv6-address } capability-advertise route-refresh
undo peer { group-name | ipv6-address } capability-advertise route-refresh
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Description
Use peer capability-advertise route-refresh to enable IPv6 BGP route-refresh.
Use undo peer capability-advertise route-refresh to disable the function.
By default, route-refresh is enabled.
Examples
# Disable route-refresh of peer 1:2::3:4.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 as-number 100
[Sysname-bgp-af-ipv6] undo peer 1:2::3:4 capability-advertise route-refresh
peer capability-advertise suppress-4-byte-as (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } capability-advertise suppress-4-byte-as
undo peer { group-name | ipv6-address } capability-advertise suppress-4-byte-as
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Description
Use peer capability-advertise suppress-4-byte-as to enable 4-byte AS number suppression.
Use undo peer capability-advertise suppress-4-byte-as to disable the function.
By default, the 4-byte AS number suppression function is disabled.
If the peer device supports 4-byte AS numbers, do not enable the suppression function; otherwise, the BGP peer relationship cannot be established.
Examples
# In IPv6 address family view, enable 4-byte AS number suppression for peer 2001::1.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 2001::1 as-number 200
[Sysname-bgp-af-ipv6] peer 2001::1 capability-advertise suppress-4-byte-as
peer capability-advertise suppress-4-byte-as (IPv6 BGP-VPN instance view)
Syntax
peer ipv6-address capability-advertise suppress-4-byte-as
undo peer ipv6-address capability-advertise suppress-4-byte-as
View
IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
ipv6-address: IPv6 address of a peer.
Description
Use peer capability-advertise suppress-4-byte-as to enable 4-byte AS number suppression.
Use undo peer capability-advertise suppress-4-byte-as to disable the function.
By default, the 4-byte AS number suppression function is disabled.
The device supports 4-byte AS numbers and uses 4-byte AS numbers by default. If the peer devices support only 2-byte AS numbers, you must enable the 4-byte AS number suppression function on the device.
If the peer device supports 4-byte AS numbers, do not enable the suppression function; otherwise, the BGP peer relationship cannot be established.
Examples
# In IPv6 BGP-VPN instance view, enable 4-byte AS number suppression for peer 2001::1.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family vpn-instance 11
[Sysname-bgp-ipv6-11] peer 2001::1 as-number 200
[Sysname-bgp-ipv6-11] peer 2001::1 capability-advertise suppress-4-byte-as
peer connect-interface (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } connect-interface interface-type interface-number
undo peer { group-name | ipv6-address } connect-interface
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
interface-type interface-number: Specifies the type and name of the interface.
Description
Use peer connect-interface to specify the source interface for establishing TCP connections to an IPv6 BGP peer or peer group.
Use undo peer connect-interface to restore the default.
By default, BGP uses the output interface of the best route to the IPv6 BGP peer/peer group as the source interface for establishing a TCP connection.
To enhance stability of IPv6 BGP connections, H3C recommends that you use a loopback interface as the source interface for establishing a TCP connection.
To establish multiple BGP connections to a BGP router, you need to specify on the local router the respective source interfaces for establishing TCP connections to the peers on the peering BGP router; otherwise, the local BGP router might fail to establish TCP connections to the peers when using the output interfaces of the best routes as the source interfaces.
Examples
# Specify loopback 0 as the source interface for routing updates to peer 1:2::3:4.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 connect-interface loopback 0
peer default-route-advertise
Syntax
peer { group-name | ipv4-address | ipv6-address } default-route-advertise [ route-policy route-policy-name ]
undo peer { group-name | ipv4-address | ipv6-address } default-route-advertise
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv4-address: IPv4 address of a peer.
ipv6-address: IPv6 address of a peer.
route-policy-name: Name of a routing policy, a string of 1 to 63 characters.
Description
Use peer default-route-advertise to advertise a default route to a peer/peer group.
Use undo peer default-route-advertise to disable advertising a default route.
By default, no default route is advertised to a peer/peer group.
Using this command does not require the default route available in the routing table. With this command used, the router sends the default route unconditionally to the peer/peer group with the next hop being itself.
Examples
# Advertise a default route to peer 1:2::3:4.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 default-route-advertise
peer description (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } description description-text
undo peer { group-name | ipv6-address } description
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
description-text: Description for the peer/peer group, a string of 1 to 79 characters.
Description
Use peer description to configure a description for a peer/peer group.
Use undo peer description to remove the description for a peer/peer group.
By default, no description is configured for a peer/peer group.
You need create a peer/peer group before configuring a description for it.
Examples
# Configure the description for the peer group test as ISP1.
<Sysname] system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] group test external
[Sysname-bgp-af-ipv6] peer test description ISP1
peer description (IPv6 BGP-VPN instance view)
Syntax
peer ipv6-address description description-text
undo peer ipv6-address description
View
IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
ipv6-address: IPv6 address of a peer.
description-text: Description for the peer, a string of 1 to 79 characters.
Description
Use peer description to configure a description for a peer.
Use undo peer description to remove the description for a peer.
By default, no description is configured for a peer.
Examples
# Configure the description for the peer 2001::1 as ISP1.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family vpn-instance vpn1
[Sysname-bgp-ipv6-vpn1] peer 2001::1 description ISP1
peer ebgp-max-hop (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } ebgp-max-hop [ hop-count ]
undo peer { group-name | ipv6-address } ebgp-max-hop
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
hop-count: Maximum hop count in the range of 1 to 255. By default, the value is 64.
Description
Use peer ebgp-max-hop to allow establishing the EBGP connection to a peer/peer group indirectly connected.
Use undo peer ebgp-max-hop to remove the configuration.
By default, this feature is disabled.
You can use the argument hop-count to specify the maximum router hops of the EBGP connection.
Examples
# Allow establishing the EBGP connection with the peer group test on an indirectly connected network.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] group test external
[Sysname-bgp-af-ipv6] peer test ebgp-max-hop
peer enable (IPv6 address family view)
Syntax
peer { ipv4-group-name | ipv4-address | ipv6-address } enable
undo peer { ipv4-group-name | ipv4-address | ipv6-address } enable
View
IPv6 address family view
Default level
2: System level
Parameters
ipv4-group-name: Name of an IPv4 peer group, a string of 1 to 47 characters. The IPv4 peer group should be created beforehand.
ipv4-address: IPv4 address of a peer.
ipv6-address: IPv6 address of a peer.
Description
Use peer enable to enable a peer or peer group.
Use undo peer enable to disable a peer or peer group.
By default, no peer or peer group is enabled.
If a peer or peer group is disabled, the router will not exchange routing information with it.
Examples
# Enable peer 1.1.1.1.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1.1.1.1 enable
# Enable peer 1::1.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1::1 group group1
[Sysname-bgp-af-ipv6] peer 1::1 enable
peer fake-as (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } fake-as as-number
undo peer { group-name | ipv6-address } fake-as
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
as-number: Local AS number in the range of 1 to 4294967295.
Description
Use peer fake-as to configure a fake local AS number for a peer or peer group.
Use undo peer fake-as to remove the configuration.
By default, no fake local AS number is configured for a peer or peer group.
Examples
# Configure a fake AS number of 200 for the peer group test.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] group test external
[Sysname-bgp-af-ipv6] peer test fake-as 200
peer filter-policy (IPv6 address family view)
Syntax
peer { group-name | ipv4-address | ipv6-address } filter-policy acl6-number { import | export }
undo peer { group-name | ipv4-address | ipv6-address } filter-policy [ acl6-number ] { import | export }
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv4-address: IPv4 address of a peer.
ipv6-address: IPv6 address of a peer.
acl6-number: IPv6 ACL number in the range of 2000 to 3999.
import: Applies the filter-policy to routes received from the peer/peer group.
export: Applies the filter-policy to routes advertised to the peer/peer group.
Description
Use peer filter-policy to configure an ACL-based filter policy for a peer or peer group.
Use undo peer filter-policy to remove the configuration.
By default, no ACL-based filter policy is configured for a peer or peer group.
Examples
# Apply the ACL6 2000 to filter routes advertised to the peer 1:2::3:4.
<Sysname> system-view
[Sysname] acl ipv6 number 2000
[Sysname-acl6-basic-2000] rule permit source 2001:1:: 64
[Sysname-acl6-basic-2000] quit
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 filter-policy 2000 export
peer group (IPv6 address family view)
Syntax
peer { ipv4-address | ipv6-address } group group-name [ as-number as-number ]
undo peer ipv6-address group group-name
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv4-address: IPv4 address of a peer.
ipv6-address: IPv6 address of a peer.
as-number: Specifies the AS number of the peer/peer group, in the range of 1 to 4294967295.
Description
Use peer group to add a peer to a configured peer group.
Use undo peer group to delete a specified peer from a peer group.
By default, the peer does not belong to any peer group.
Examples
# Create a peer group named test and add the peer 1:2::3:4 to the peer group.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] group test external
[Sysname-bgp-af-ipv6] peer 1:2::3:4 as-number 200
[Sysname-bgp-af-ipv6] peer 1:2::3:4 group test
peer ignore (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } ignore
undo peer { group-name | ipv6-address } ignore
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Description
Use peer ignore to terminate the session to a peer or peer group.
Use undo peer ignore to remove the configuration.
By default, a router can establish sessions with a peer or peer group.
After the peer ignore command is executed, the system terminates the active sessions with the specified peer or peer group and clears all the related routing information. For a peer group, all the sessions with the peer group will be torn down.
Examples
# Terminate the session with peer 1:2::3:4.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 ignore
peer ignore-originatorid (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } ignore-originatorid
undo peer { group-name | ipv6-address } ignore-originatorid
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ip-address: IPv6 address of a peer.
Description
Use peer ignore-originatorid to ignore the ORIGINATOR_ID attribute of IPv6 BGP routes received from the specified peer or peer group.
Use undo peer ignore-originatorid to restore the default.
By default, IPv6 BGP saves the ORIGINATOR ID attribute of received IPv6 BGP routes.
Before you execute the peer ignore-originatorid command, make sure that no routing loop exists among route reflectors in the network.
The peer ignore-originatorid also enables IPv6 BGP to ignore the CLUSTER_LIST attribute of IPv6 BGP routes.
Examples
# In IPv6 BGP family view, ignore the ORIGINATOR_ID attribute of routes received from the route reflector 1:2::3:4.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 ignore-originatorid
peer ipv6-prefix
Syntax
peer { group-name | ipv4-address | ipv6-address } ipv6-prefix ipv6-prefix-name { import | export }
undo peer { group-name | ipv4-address | ipv6-address } ipv6-prefix { import | export }
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv4-address: IPv4 address of a peer.
ipv6-address: IPv6 address of a peer.
ipv6-prefix-name: IPv6 prefix list name, a string of 1 to 19 characters.
import: Applies the filtering policy to routes received from the specified peer/peer group.
export: Applies the filtering policy to routes advertised to the specified peer/peer group.
Description
Use peer ipv6-prefix to specify an IPv6 prefix list to filter routes incoming from or outgoing to a peer or peer group.
Use undo peer ipv6-prefix to remove the configuration.
By default, no IPv6 prefix list is specified for filtering.
Examples
# Reference the IPv6 prefix list list1 to filter routes outgoing to peer 1:2::3:4.
<Sysname> system-view
[Sysname] ip ipv6-prefix list1 permit 2002:: 64
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 ipv6-prefix list1 export
peer ipsec-policy (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } ipsec-policy policy-name
undo peer { group-name | ipv6-address } ipsec-policy
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of an IPv6 peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
policy-name: IPsec policy name, a string of 1 to 15 characters.
Description
Use peer ipsec-policy to apply an IPsec policy to an IPv6 BGP peer or peer group.
Use undo peer ipsec-policy to remove the applied IPsec policy.
By default, no IPsec policy is applied to any peer or peer group.
The IPsec policy to be applied must have been configured. Otherwise, the configuration fails.
You must make IPsec policy configuration on the peer or peer group. Otherwise, the local device will not receive IPv6 BGP packets from the peer or peer group.
Examples
# Apply IPsec policy policy001 to IPv6 BGP peer 1212::1111.
<Sysname] system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1212::1111 ipsec-policy policy001
peer keep-all-routes (IPv6 address family view)
Syntax
peer { group-name | ipv4-address | ipv6-address } keep-all-routes
undo peer { group-name | ipv4-address | ipv6-address } keep-all-routes
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv4-address: IPv4 address of a peer.
ipv6-address: IPv6 address of a peer.
Description
Use peer keep-all-routes to save the original routing information from a peer or peer group, including even routes that failed to pass the inbound policy.
Use undo peer keep-all-routes to disable this function.
By default, the function is not enabled.
Examples
# Save routing information from peer 1:2::3:4.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 keep-all-routes
peer label-route-capability (IPv6 address family view)
Syntax
peer { ipv4-group-name | ipv4-address } label-route-capability
undo peer { ipv4-group-name | ipv4-address } label-route-capability
View
IPv6 address family view
Default level
2: System level
Parameters
ipv4-group-name: Name of an IPv4 peer group, a string of 1 to 47 characters. An IPv4 peer group must be created successfully in BGP view before being activated here.
ipv4-address: IPv4 address of a peer.
Description
Use peer label-route-capability to enable exchange of labeled IPv6 routes with the peer/peer group.
Use undo peer label-route-capability to disable exchange of labeled IPv6 routes with the peer/peer group.
By default, the feature is disabled.
Examples
# Enable exchange of labeled IPv6 routes with peer 2.2.2.2.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 2.2.2.2 label-route-capability
peer log-change (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } log-change
undo peer { group-name | ipv6-address } log-change
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Description
Use peer log-change to enable the logging of session state and event information for a specific peer or peer group.
Use undo peer log-change to remove the configuration.
The logging is enabled by default.
Examples
# Enable the logging of session state and event information for peer 1:2::3:4.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 log-change
peer next-hop-local (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } next-hop-local
undo peer { group-name | ipv6-address } next-hop-local
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Description
Use peer next-hop-local to configure the next hop of routes advertised to a peer/peer group as the local router.
Use undo peer next-hop-local to restore the default.
By default, the system sets the next hop of routes advertised to an EBGP peer/peer group to the local router, but does not change the next hop for routes outgoing to an IBGP peer/peer group.
Examples
# Set the next hop of routes advertised to IBGP peer group test to the router itself.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] group test internal
[Sysname-bgp-af-ipv6] peer test next-hop-local
peer password (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } password { cipher | simple } password
undo peer { group-name | ipv6-address } password
View
IPv6 address family view
Default level
2: System view
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
cipher: Sets a ciphertext authentication key.
simple: Sets a plaintext authentication key.
password: Specifies the key string. This argument is case sensitive. If cipher is specified, it must be a ciphertext string of 1 to 137 characters. If simple is specified, it must be a string of 1 to 80 characters.
Description
Use peer password to configure IPv6 BGP to perform MD5 authentication when a TCP connection is being established with a peer/peer group.
Use undo peer password to restore the default.
By default, no MD5 authentication is performed for TCP connection establishment.
The MD5 authentication requires that the two parties have the same authentication mode and key to establish a TCP connection. Otherwise, the TCP connection cannot be established due to an authentication failure.
For security purposes, all authentication keys, including keys configured in plain text, are saved in ciphertext.
Examples
# Enable MD5 authentication for establishing TCP connection between the local device (1:2::3:3) and peer device (1:2::3:4), and configure the authentication key as aabbcc.
· On the local device:
<Sysname> system-view
[Sysname] bgp 3
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 password cipher aabbcc
· On the peer device:
<Sysname> system-view
[Sysname] bgp 4
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:3 password cipher aabbcc
peer password (IPv6 BGP-VPN instance view)
Syntax
peer ipv6-address password { cipher | simple } password
undo peer ipv6-address password
View
IPv6 BGP-VPN instance view
Default level
2: System view
Parameters
ipv6-address: IPv6 address of a peer.
cipher: Sets a ciphertext authentication key.
simple: Sets a plaintext authentication key.
password: Specifies the key string. This argument is case sensitive. If cipher is specified, it must be a ciphertext string of 1 to 137 characters. If simple is specified, it must be a string of 1 to 80 characters.
Description
Use peer password to configure IPv6 BGP to perform MD5 authentication when a TCP connection is being established with a peer.
Use undo peer password to restore the default.
By default, no MD5 authentication is performed for TCP connection establishment.
The MD5 authentication requires that the two parties have the same authentication mode and key to establish a TCP connection. Otherwise, the TCP connection cannot be established due to an authentication failure.
For security purposes, all authentication keys, including keys configured in plain text, are saved in ciphertext.
Examples
# Enable MD5 authentication for establishing TCP connection between the local device (1:2::3:3) and peer device (1:2::3:4), and configure the authentication key as aabbcc.
· On the local device:
<Sysname> system-view
[Sysname] bgp 3
[Sysname-bgp] ipv6-family vpn-instance vpn1
[Sysname-bgp- ipv6-vpn1] peer 1:2::3:4 password cipher aabbcc
· On the peer device:
<Sysname> system-view
[Sysname] bgp 4
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:3 password cipher aabbcc
peer preferred-value (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } preferred-value value
undo peer { group-name | ipv6-address } preferred-value
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
value: Preferred value in the range of 0 to 65535.
Description
Use peer preferred-value to assign a preferred value to routes received from a peer or peer group.
Use undo peer preferred-value to restore the default.
By default, routes received from a peer or peer group have a preferred value of 0.
Routes learned from peers each have an initial preferred value. Among multiple routes to the same destination, the route with the biggest value is selected.
If you both reference a routing policy and use the command peer { group-name | ipv6-address } preferred-value value to set a preferred value for routes from a peer, the routing policy sets the specific preferred value for routes matching it. If the preferred value in the routing policy is zero, the routes use the value set with the peer { group-name | ipv6-address } preferred-value value command. For information about using a routing policy to set a preferred value, see the command peer { group-name | ipv4-address | ipv6-address } route-policy route-policy-name { import | export } in this document, and the command apply preferred-value preferred-value in "Routing policy configuration commands."
Examples
# Configure the preferred value as 50 for routes from peer 1:2::3:4.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 preferred-value 50
peer preferred-value (IPv6 BGP-VPN instance view)
Syntax
peer ipv6-address preferred-value value
undo peer ipv6-address [ preferred-value ]
View
IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
ipv6-address: IPv6 address of a peer.
value: Preferred value in the range of 0 to 65535.
Description
Use peer preferred-value to assign a preferred value to routes received from a peer.
Use undo peer preferred-value to restore the default.
By default, routes received from a peer have a preferred value of 0.
Routes learned from peers each have an initial preferred value. Among multiple routes to the same destination, the route with the biggest value is selected.
If you both reference a routing policy and use the command peer ipv6-address preferred-value value to set a preferred value for routes from a peer, the routing policy sets the specific preferred value for routes matching it. If the preferred value in the routing policy is zero, the routes use the value set with the peer { group-name | ipv6-address } preferred-value value command. For information about using a routing policy to set a preferred value, see the command peer ipv6-address route-policy route-policy-name { import | export } in this document, and the command apply preferred-value preferred-value in "Routing policy configuration commands."
Examples
# Configure the preferred value as 50 for routes from peer 1:2::3:4.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family vpn-instance 11
[Sysname-bgp-ipv6-11] peer 1:2::3:4 preferred-value 50
peer public-as-only (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } public-as-only
undo peer { group-name | ipv6-address } public-as-only
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Description
Use peer public-as-only to configure IPv6 BGP updates to a peer/peer group to not carry private AS numbers.
Use undo peer public-as-only to allow IPv6 BGP updates to a peer/peer group to carry private AS numbers.
By default, BGP updates carry the private AS number.
The command does not take effect if the BGP update has both the public AS number and private AS number. The range of private AS number is from 64512 to 65535.
Examples
# Configure BGP updates sent to the peer 1:2::3:4 to not carry private AS numbers.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 public-as-only
peer reflect-client (IPv6 address family view)
Syntax
peer { group-name | ipv4-address | ipv6-address } reflect-client
undo peer { group-name | ipv4-address | ipv6-address } reflect-client
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv4-address: IPv4 address of a peer.
ipv6-address: IPv6 address of a peer.
Description
Use peer reflect-client to configure the router as a route reflector and specify a peer/peer group as a client.
Use undo peer reflect-client to remove the configuration.
By default, neither route reflector nor client is configured.
Related commands: reflect between-clients and reflector cluster-id.
Examples
# Configure the local device as a route reflector and specify the peer group test as a client.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] group test
[Sysname-bgp-af-ipv6] peer test reflect-client
peer route-limit (IPv6 address family view)
Syntax
peer { group-name | ipv4-address | ipv6-address } route-limit prefix-number [ { alert-only | reconnect reconnect-time } | percentage ] *
undo peer { group-name | ipv4-address | ipv6-address } route-limit
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv4-address: IPv4 address of a peer.
ipv6-address: IPv6 address of a peer.
prefix number: Specifies the upper limit of prefixes that can be received from the peer or peer group. When the received prefixes from the peer/peer group reach the specified upper limit, the router disconnects from the peer/peer group.
alert-only: When the received prefixes from the peer/peer group reach the specified upper limit, the router displays alarm messages rather than disconnecting from the peer/peer group.
reconnect-time: Interval for the router to reconnect to the peer/peer group, in the range of 1 to 65535 seconds. The argument has no default.
percentage: Specifies a percentage value. If the percentage of received routes to the upper limit reaches the value, the router will generate alarm messages. The default is 75. The value is in the range of 1 to 100.
Description
Use peer route-limit to set the maximum number of prefixes that can be received from a peer/peer group.
Use undo peer route-limit to restore the default.
By default, the router has no limit on the number of prefixes from a peer/peer group.
The router ends the peer relationship when the number of prefixes received from the peer/peer group exceeds the limit.
Examples
# Set the number of prefixes allowed to receive from the peer 1:2::3:4 to 100.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 route-limit 100
peer route-limit (IPv6 BGP-VPN instance view)
Syntax
peer ipv6-address route-limit prefix-number [ { alert-only | reconnect reconnect-time } | percentage ] *
undo peer ipv6-address route-limit
View
IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
ipv6-address: IPv6 address of a peer.
prefix-number: Specifies the upper limit of prefixes that can be received from the specified peer. When the received prefixes from the peer reach the specified upper limit, the router disconnects from the peer.
alert-only: When the received prefixes from the specified peer reach the specified upper limit, the router displays alarm messages rather than disconnecting from the peer.
reconnect-time: Interval for the router to reconnect to the peer, in the range of 1 to 65535 seconds. The argument has no default.
percentage: Specifies a percentage value. If the percentage of received routes to the upper limit reaches the value, the router will generate alarm messages. The default is 75. The value is in the range of 1 to 100.
Description
Use peer route-limit to set the maximum number of IPv6 prefixes that can be received from a peer.
Use undo peer route-limit to restore the default.
By default, the router has no limit on the number of IPv6 prefixes received from a peer.
The router ends the peer relationship when the number of IPv6 prefixes received from the peer exceeds the limit.
Examples
# Set the number of IPv6 prefixes allowed to receive from the peer 2001::1 to 100.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family vpn-instance vpn1
[Sysname-bgp-ipv6-vpn1] peer 2001::1 route-limit 100
peer route-policy (IPv6 address family view)
Syntax
peer { group-name | ipv4-address | ipv6-address } route-policy route-policy-name { import | export }
undo peer { group-name | ipv4-address | ipv6-address } route-policy route-policy-name { import | export }
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv4-address: IPv4 address of a peer.
ipv6-address: IPv6 address of a peer.
route-policy-name: Name of a routing policy, a string of 1 to 63 characters.
import: Applies the routing policy to routes from the peer/peer group.
export: Applies the routing policy to routes sent to the peer/peer group.
Description
Use peer route-policy to apply a routing policy to routes incoming from or outgoing to a peer or peer group.
Use undo peer route-policy to remove the configuration.
By default, no routing policy is specified for the peer/peer group.
The peer route-policy command does not use the if-match interface clause defined in the routing policy. For more information, see "Routing policy configuration commands."
Examples
# Apply the routing policy test-policy to routes received from the peer group test.
<Sysname> system-view
[Sysname] route-policy test-policy permit node 10
[Sysname-route-policy] if-match cost 10
[Sysname-route-policy] apply cost 65535
[Sysname-route-policy] quit
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] group test external
[Sysname-bgp-af-ipv6] peer test route-policy test-policy import
peer route-policy (IPv6 BGP-VPN instance view)
Syntax
peer ipv6-address route-policy route-policy-name { export | import }
undo peer ipv6-address [ route-policy route-policy-name { export | import } ]
View
IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
ipv6-address: IPv6 address of a peer.
route-policy-name: Name of a routing policy, a string of 1 to 63 characters.
import: Applies the routing policy to routes from the peer.
export: Applies the routing policy to routes sent to the peer.
Description
Use peer route-policy to apply a routing policy to routes incoming from or outgoing to a peer.
Use undo peer route-policy to remove the configuration.
By default, no routing policy is specified for the peer.
The peer route-policy command does not use the if-match interface clause defined in the routing policy. For related information, see "Routing policy configuration commands."
Examples
# Apply the routing policy test-policy to routes received from the peer 2001::1.
<Sysname> system-view
[Sysname] route-policy test-policy permit node 10
[Sysname-route-policy] if-match cost 10
[Sysname-route-policy] apply cost 65535
[Sysname-route-policy] quit
[Sysname] bgp 100
[Sysname-bgp] ipv6-family vpn-instance vpn1
[Sysname-bgp-ipv6-vpn1] peer 2001::1 route-policy test-policy import
peer route-update-interval (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } route-update-interval interval
undo peer { group-name | ipv6-address } route-update-interval
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
interval: Specifies the minimum interval for sending the same update to a peer/peer group from 0 to 600 seconds.
Description
Use peer route-update-interval to specify the interval for sending the same update to a peer/peer group.
Use undo peer route-update-interval to restore the default.
By default, the interval is 15 seconds for the IBGP peer, and 30 seconds for the EBGP peer.
Examples
# Specify the interval for sending the same update to the peer 1:2::3:4 as 10 seconds.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 as-number 100
[Sysname-bgp-af-ipv6] peer 1:2::3:4 route-update-interval 10
peer substitute-as (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } substitute-as
undo peer { group-name | ipv6-address } substitute-as
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Description
Use peer substitute-as to substitute the local AS number for the AS number of a peer/peer group in the AS_PATH attribute.
Use undo peer substitute-as to remove the configuration.
The substitution is not configured by default.
Examples
# Substitute the local AS number for the AS number of peer 1:2::3:4.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] peer 1:2::3:4 substitute-as
peer timer (IPv6 address family view)
Syntax
peer { group-name | ipv6-address } timer keepalive keepalive hold holdtime
undo peer { group-name | ipv6-address } timer
View
IPv6 address family view
Default level
2: System level
Parameters
group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
keepalive: Specifies the keepalive interval in seconds, in the range of 0 to 21845.
holdtime: Specifies the holdtime in seconds, whose value is 0 or in the range of 3 to 65535.
Description
Use peer timer to configure keepalive interval and holdtime interval for a peer or peer group.
Use undo peer timer to restore the default.
keepalive interval defaults to 60 seconds, and holdtime interval defaults to 180 seconds
The timers configured with this command are preferred to the timers configured with the timer command.
If the holdtime interval is configured as 0, no keepalive message will be sent to the peer, and the peer connection will never time out. If the keepalive interval is configured as 0 and the negotiated hold time is not 0, one third of the hold time is taken as the interval for sending keepalive messages.
If neither the holdtime interval nor the keepalive interval is configured as 0, the holdtime interval must be at least three times the keepalive interval.
After this command is executed, the peer connection is closed at once, and a new connection to the peer is negotiated using the configured hold time.
Related commands: timer.
Examples
# Configure the keepalive interval and holdtime interval for the peer group test as 60 seconds and 180 seconds.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] group test external
[Sysname-bgp-af-ipv6] peer test timer keepalive 60 hold 180
# Configure both the keepalive interval and holdtime interval for peer group test as 0 seconds, indicating the peer group will never time out.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] group test external
[Sysname-bgp-af-ipv6] peer test timer keepalive 0 hold 0
preference (IPv6 address family view/IPv6 BGP-VPN instance view)
Syntax
preference { external-preference internal-preference local-preference | route-policy route-policy-name }
undo preference
View
IPv6 address family view, IPv6 BGP-VPN instance view
Default level
2: System level
Parameters
external-preference: Preference of EBGP route learned from an EBGP peer, in the range of 1 to 255.
internal-preference: Preference of IBGP route learned from an IBGP peer, in the range of 1 to 255.
local-preference: Preference of IPv6 BGP local route, in the range of 1 to 255.
route-policy-name: Routing policy name, a string of 1 to 63 characters. The routing policy can set a preference for routes passing it. The default value applies to the routes filtered out.
Description
Use preference to configure preferences for EBGP, IBGP, and local routes.
Use undo preference to restore the default.
The bigger the preference value is, the lower the preference is. The default values of external-preference, internal-preference and local-preference are 255, 255 and 130.
Examples
# Configure preferences for EBGP, IBGP, and local routes as 20, 20 and 200.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] preference 20 20 200
reflect between-clients (IPv6 address family view)
Syntax
reflect between-clients
undo reflect between-clients
View
IPv6 address family view
Default level
2: System level
Parameters
None
Description
Use reflect between-clients to enable route reflection between clients.
Use undo reflect between-clients to disable this function.
By default, route reflection between clients is enabled.
After a route reflector is configured, it reflects routes between clients. If the clients are fully meshed, H3C recommends that you disable route reflection on the route reflector to reduce costs.
Related commands: reflector cluster-id and peer reflect-client.
Examples
# Enable route reflection between clients.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] reflect between-clients
reflector cluster-id (IPv6 address family view)
Syntax
reflector cluster-id cluster-id
undo reflector cluster-id
View
IPv6 address family view
Default level
2: System level
Parameters
cluster-id: Specifies the cluster ID of the route reflector, an integer from 1 to 4294967295 (the system translates it into an IPv4 address) or an IPv4 address.
Description
Use reflector cluster-id to configure the cluster ID of the route reflector.
Use undo reflector cluster-id to remove the configured cluster ID.
By default, a route reflector uses its router ID as the cluster ID.
Typically, a cluster has only one route reflector, so the router ID of the route reflector identifies the cluster. If multiple route reflectors are configured to improve the stability of the network, you should use this command to configure the identical cluster ID for all the reflectors to avoid routing loops.
Related commands: reflect between-clients and peer reflect-client.
Examples
# Set 50 as the cluster ID for the route reflector, which is one of multiple route reflectors in the cluster.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] reflector cluster-id 50
refresh bgp ipv6
Syntax
refresh bgp ipv6 { ipv4-address | ipv6-address | all | external | group group-name | internal } { export | import }
View
User view
Default level
1: Monitor level
Parameters
ipv4-address: Soft-resets the connection with an IPv4 BGP peer.
ipv6-address: Soft-resets the connection with an IPv6 BGP peer.
all: Soft-resets all IPv6 BGP connections.
external: Soft-resets EBGP connections.
group group-name: Soft-resets connections with a peer group. The name of the peer group is a string of 1 to 47 characters.
internal: Soft-resets IBGP connections.
export: Performs soft reset in outbound direction.
import: Performs soft reset in inbound direction.
Description
Use refresh bgp ipv6 to soft reset specified IPv4/IPv6 BGP connections. With this feature, you can refresh the IPv4/IPv6 BGP routing table and apply a new available policy without tearing down BGP connections.
To perform IPv4/IPv6 BGP soft reset, all routers in the network should support route-refresh. If a router not supporting route refresh exists in the network, you need to use the peer keep-all-routes command on the local router to save all route updates before performing soft reset.
Examples
# Soft reset inbound IPv6 BGP connections.
<Sysname> refresh bgp ipv6 all import
reset bgp ipv6
Syntax
reset bgp ipv6 { as-number | ipv4-address | ipv6-address | all | external | group group-name | internal }
View
User view
Default level
2: System level
Parameters
as-number: Resets the IPv6 BGP connections to peers in the specified AS. The AS number is in the range of 1 to 4294967295.
ipv4-address: Resets the connection to the specified IPv4 BGP peer.
ipv6-address: Resets the connection to the specified IPv6 BGP peer.
all: Resets all IPv6 BGP connections.
external: Resets all the EBGP connections.
group group-name: Resets the connections to the specified IPv6 BGP peer group.
internal: Resets all the IBGP connections.
Description
Use reset bgp ipv6 to reset specified IPv4/IPv6 BGP connections.
Examples
# Reset all the IPv6 BGP connections.
<Sysname> reset bgp ipv6 all
reset bgp ipv6 dampening
Syntax
reset bgp ipv6 dampening [ ipv6-address prefix-length ]
View
User view
Default level
1: Monitor level
Parameters
ipv6-address: IPv6 address
prefix-length: Prefix length of the address, in the range of 0 to 128.
Description
Use reset bgp ipv6 dampening to clear dampened IPv6 BGP route information and release suppressed routes.
If no ipv6-address prefix-length is specified, all dampened IPv6 BGP route information will be cleared.
Examples
# Clear the dampened information for routes to 2345::/64 and release suppressed routes.
<Sysname> reset bgp ipv6 dampening 2345:: 64
reset bgp ipv6 flap-info
Syntax
reset bgp ipv6 flap-info [ ipv6-address/prefix-length | as-path-acl as-path-acl-number | regexp as-path-regexp ]
reset bgp ipv6 peer-ipv6-address flap-info
View
User view
Default level
1: Monitor level
Parameters
ipv6-address: Clears the flap statistics for the specified IPv6 address.
prefix-length: Prefix length of the address, in the range of 1 to 128.
as-path-acl-number: Clears the flap statistics for routes matching the AS path ACL. The number is in the range of 1 to 256.
as-path-regexp: Clears the flap statistics for routes matching the AS path regular expression.
peer-ipv6-address: Clears the flap statistics for inbound routes from the peer. The peer-ipv6-address argument is the IPv6 address of the peer.
Description
Use reset bgp ipv6 flap-info to clear IPv6 routing flap statistics.
If no parameters are specified, the flap statistics of all the routes will be cleared
Examples
# Clear the flap statistics of the routes matching AS path ACL 10.
<Sysname> system-view
[Sysname] ip as-path 10 permit ^100.*200$
[Sysname] quit
<Sysname> reset bgp ipv6 flap-info as-path-acl 10
router-id
Syntax
router-id router-id
undo router-id
View
BGP view
Default level
2: System level
Parameters
router-id: Router ID in IP address format.
Description
Use router-id to specify a router ID for the router.
Use undo router-id to remove a router ID.
To run IPv6 BGP protocol, a router must have a router ID, an unsigned 32-bit integer and the unique ID of the router in the AS.
You can specify a router ID manually. Otherwise, the system selects the highest IPv4 address among loopback interface addresses as the router ID. If no loopback interface addresses are available, the system selects the highest IPv4 address among physical interface IPv4 addresses as the router ID. Specify a loopback interface address as the router ID to enhance network reliability.
If the interface whose IPv4 address is selected as the router ID or the manual router ID is deleted, the system selects a new router ID for the router.
Examples
# Specify the router ID of the router as 10.18.4.221.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] router-id 10.18.4.221
synchronization (IPv6 address family view)
Syntax
synchronization
undo synchronization
View
IPv6 address family view
Default level
2: System level
Parameters
None
Description
Use synchronization to enable the synchronization between IPv6 BGP and IGP.
Use undo synchronization to disable the synchronization.
The feature is disabled by default.
With this feature enabled and when a non-BGP router is responsible for forwarding packets in an AS, IPv6 BGP speakers in the AS cannot advertise routing information to other ASs unless all routers in the AS know the latest routing information.
By default, upon receiving an IPv6 IBGP route, the BGP router only checks whether the next hop is reachable before advertisement. If synchronization is enabled, the IBGP route can be advertised to EBGP peers only when the route is also advertised by the IGP.
Examples
# Enable the route synchronization between IPv6 BGP and IGP.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6] synchronization
timer (IPv6 address family view)
Syntax
timer keepalive keepalive hold holdtime
undo timer
View
IPv6 address family view
Default level
2: System level
Parameters
keepalive: Keepalive interval in seconds, in the range of 0 to 21845.
holdtime: Holdtime interval in seconds, whose value is 0 or in the range of 3 to 65535.
Description
Use timer to specify the IPv6 BGP keepalive interval and holdtime interval.
Use undo timer to restore the default.
By default, the keepalive and holdtime intervals are 60s and 180s.
The timers configured with the peer timer command are preferred to the timers configured with the timer command.
If the holdtime interval is configured as 0, no keepalive message will be sent to the peer, and the peer connection will never time out. If the keepalive interval is configured as 0 and the negotiated hold time is not 0, one third of the hold time is taken as the interval for sending keepalive messages.
If neither the holdtime interval nor the keepalive interval is configured as 0, the holdtime interval must be at least three times the keepalive interval.
The configured timers apply to all IPv6 BGP peers, but they become valid for an IPv6 BGP peer only after the relevant IPv6 BGP connection is reset.
After this command is executed, no peer connection is closed at once. The configured hold time is used for negotiation when a peer relationship is reestablished.
Related commands: peer timer.
Examples
# Configure keepalive interval and holdtime interval as 60 and 180 seconds.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family