- Table of Contents
-
- 03-IP Routing Volume
- 00-IP Routing Volume Organization
- 01-IP Routing Table Display Commands
- 02-Static Routing Commands
- 03-RIP Commands
- 04-OSPF Commands
- 05-IS-IS Commands
- 06-BGP Commands
- 07-IPv6 Static Routing Commands
- 08-IPv6 RIPng Commands
- 09-IPv6 OSPFv3 commands
- 10-IPv6 IS-IS Commands
- 11-IPv6 BGP Commands
- 12-Route Policy Commands
- Related Documents
-
Title | Size | Download |
---|---|---|
11-IPv6 BGP Commands | 203.25 KB |
Table of Contents
1 IPv6 BGP Configuration Commands
IPv6 BGP Configuration Commands
balance (IPv6 address family 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)
default med (IPv6 address family view)
default-route imported (IPv6 address family view)
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 peer
display bgp ipv6 routing-table regular-expression
display bgp ipv6 routing-table statistic
filter-policy export (IPv6 address family view)
filter-policy import (IPv6 address family view)
group (IPv6 address family view)
import-route (IPv6 address family view)
network (IPv6 address family view)
peer advertise-community (IPv6 address family 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-path-acl (IPv6 address family view)
peer capability-advertise route-refresh
peer connect-interface (IPv6 address family view)
peer description (IPv6 address family view)
peer ebgp-max-hop (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 keep-all-routes (IPv6 address family view)
peer log-change (IPv6 address family view)
peer next-hop-local (IPv6 address family view)
peer preferred-value (IPv6 address family 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-policy (IPv6 address family 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)
reflect between-clients (IPv6 address family view)
reflector cluster-id (IPv6 address family view)
synchronization (IPv6 address family view)
timer (IPv6 address family view)
l The term “router” in this document refers to a router in a generic sense or a Layer 3 switch.
l EA boards (such as LSQ1GP12EA and LSQ1TGX1EA) do not support IPv6 features.
IPv6 BGP Configuration Commands
balance (IPv6 address family view)
Syntax
balance number
undo balance
View
IPv6 address family view
Default Level
2: System level
Parameters
number: Number of BGP routes participating in load balancing. Its value is in the range 1 to 4. When it is set to 1, load balancing is disabled.
Description
Use the balance command to configure the number of routes participating in IPv6 BGP load balancing.
Use the undo balance command 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 the bestroute as-path-neglect command to configure the IPv6 BGP router to not evaluate the AS_PATH during best route selection.
Use the undo bestroute as-path-neglect command 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 the bestroute compare-med command to enable the comparison of the MED for paths from each AS.
Use the undo bestroute compare-med command 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 the bestroute med-confederation command to enable the comparison of the MED for paths from confederation peers for best route selection.
Use the undo bestroute med-confederation command 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 the compare-different-as-med command to enable the comparison of the MED for paths from peers in different ASs.
Use the undo compare-different-as-med command to disable the comparison.
The comparison is disabled by default.
If there are several paths 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 1 to 45 minutes. By default, the value is 15 minutes.
half-life-unreachable: Half-life for unreachable routes, in the range 1 to 45 minutes. By default, the value is 15 minutes.
reuse: Reuse threshold value for suppressed routes, in the range 1 to 20000. Penalty value of a suppressed route decreasing under the value is reused. By default, its value is 750.
suppress: Suppression threshold from 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 from 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 19 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 accordingly.
Description
Use the dampening command to enable IPv6 BGP route dampening or/and configure dampening parameters.
Use the undo dampening command 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, 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)
Syntax
default local-preference value
undo default local-preference
View
IPv6 address family view
Default Level
2: System level
Parameters
value: Default local preference, in the range 0 to 4294967295. The larger the value is, the higher the preference is.
Description
Use the default local-preference command to configure the default local preference.
Use the undo default local-preference command 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)
Syntax
default med med-value
undo default med
View
IPv6 address family view
Default Level
2: System level
Parameters
med-value: MED value, in the range 0 to 4294967295.
Description
Use the default med command to specify the default MED value.
Use the undo default med command 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)
Syntax
default-route imported
undo default-route imported
View
IPv6 address family view
Default Level
2: System level
Parameters
None
Description
Use the default-route imported command to enable the redistribution of default route into the IPv6 BGP routing table.
Use the undo default-route imported command 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 [ ipv6-group-name ]
View
Any view
Default Level
1: Monitor level
Parameters
ipv6-group-name: Peer group name, a string of 1 to 47 characters.
Description
Use the display bgp ipv6 group command to display IPv6 peer group information.
If no ipv6-group-name is specified, information about all peer groups is displayed.
Examples
# Display the information of the IPv6 peer group aaa.
<Sysname> display bgp ipv6 group aaa
BGP peer-group is aaa
remote AS number not specified
Type : external
Maximum allowed prefix number: 4294967295
Threshold: 75%
Configured hold timer value: 180
Keepalive timer value: 60
Minimum time between advertisement runs is 30 seconds
Peer Preferred Value: 0
No routing policy is configured
Members:
Peer V AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State
20:20::20:1 4 200 170 141 0 2 02:13:35 Established
Table 1-1 display bgp ipv6 group command output description
Field |
Description |
BGP peer-group |
Name of the peer group |
remote AS |
AS number of the peer group |
Type |
Type of the peer group |
Maximum allowed prefix number |
Maximum allowed prefix number |
Threshold |
Threshold value |
hold timer value |
Holdtime |
Keepalive timer value |
Keepalive interval |
Minimum time between advertisement runs |
Minimum interval between advertisements |
Peer Preferred Value |
Preferred value of the routes from the peer |
No routing policy is configured |
No routing policy is configured for the peer |
Members |
Group members |
Peer |
IPv6 address of the peer |
V |
Peer BGP version |
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 |
The lasting time of a session/the 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
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display bgp ipv6 network command 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 Mask Route-policy Short-cut
2002:: 64
2001:: 64 Short-cut
Table 1-2 display bgp ipv6 network command output description
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 |
Short-cut |
Shortcut route |
display bgp ipv6 paths
Syntax
display bgp ipv6 paths [ as-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.
Description
Use the display bgp ipv6 paths command 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 1-3 display bgp ipv6 paths command output description
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, which can take on one of the following values: |
|
i |
Indicates the route is interior to the AS. Summary routes and routes defined using the network command are considered IGP routes. |
|
e |
Indicates that 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 ]
View
Any view
Default Level
1: Monitor level
Parameters
group-name: Name of an IPv4 or IPv6 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 of the specified peer.
verbose: Displays the detailed information of the peer.
Description
Use the display bgp ipv6 peer command 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 : 20.0.0.1
local AS number : 100
Total number of peers : 1 Peers in established state : 1
Peer V AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State
20::21 4 200 17 19 0 3 00:09:59 Established
Table 1-4 display bgp ipv6 peer command output description
Field |
Description |
Peer |
IPv6 address of the peer |
V |
Peer BGP version |
AS |
AS number |
MsgRcvd |
Messages received |
MsgSent |
Messages sent |
OutQ |
Messages to be sent |
PrefRcv |
Number of prefixes received |
Up/Down |
The lasting time of a session/the lasting time of present state (when no session is established) |
State |
Peer state |
display bgp ipv6 routing-table
Syntax
display bgp ipv6 routing-table [ ipv6-address prefix-length ]
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 0 to 128.
Description
Use the display bgp ipv6 routing-table command 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, > - 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
Table 1-5 display bgp ipv6 routing-table command output description
Field |
Description |
|
Local router ID |
Local router ID |
|
Status codes |
Status codes: * – valid > – best d – damped h – history i – internal (IGP) s – summary suppressed (suppressed) S – Stale |
|
Origin |
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 |
Indicates that a route is interior to the AS. Summary routes and the routes configured using the network command are considered IGP routes. |
|
e |
Indicates that 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
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, ranging from 1 to 256.
Description
Use the display bgp ipv6 routing-table as-path-acl command 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, > - 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
Refer to Table 1-5 for description on the fields above.
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 ]
View
Any view
Default Level
1: Monitor level
Parameters
aa:nn: Community number; both aa and nn are in the range 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 the AS; if there is a confederation, it displays IPv6 BGP routes that cannot be advertised out 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 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.
Description
Use the display bgp ipv6 routing-table community command 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, > - 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
Refer to Table 1-5 for description on the fields above.
display bgp ipv6 routing-table community-list
Syntax
display bgp ipv6 routing-table community-list { basic-community-list-number [ whole-match ] | adv-community-list-number }&<1-16>
View
Any view
Default Level
1: Monitor level
Parameters
basic-community-list-number: Specifies a basic community-list number, in the range 1 to 99.
adv-community-list-number: Specifies an advanced community-list number, in the range 100 to 199.
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.
Description
Use the display bgp ipv6 routing-table community-list command 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, > - 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
Refer to Table 1-5 for description on the fields above.
display bgp ipv6 routing-table dampened
Syntax
display bgp ipv6 routing-table dampened
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display bgp ipv6 routing-table dampened command 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, > - 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 1-6 display bgp ipv6 routing-table dampened command output description
Field |
Description |
From |
Source IP address of a route |
Reuse |
Time for reuse |
Refer to Table 1-5 for description on the fields above.
display bgp ipv6 routing-table dampening parameter
Syntax
display bgp ipv6 routing-table dampening parameter
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display bgp ipv6 routing-table dampening parameter command 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) : 3069
Ceiling Value : 16000
Reuse Value : 750
Reach HalfLife Time(in second) : 900
Unreach HalfLife Time(in second) : 900
Suppress-Limit : 2000
Table 1-7 Description on the above fields
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
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display bgp ipv6 routing-table different-origin-as command 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, > - 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 ?
Refer to Table 1-5 for description on the fields above.
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 ] ] ]
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, ranging from 1 to 256.
ipv6-address: IPv6 address of a route to be displayed.
prefix-length: Prefix length of the IPv6 address, in the range 0 to 128.
longer-match: Matches the longest prefix.
Description
Use the display bgp ipv6 routing-table flap-info command 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, > - 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 1-8 display bgp ipv6 routing-table flap-info command output description
Field |
Description |
Flaps |
Number of flaps |
Duration |
Flap duration |
Reuse |
Reuse time of the route |
Refer to Table 1-5 for description on the fields above.
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 ]
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 prefix length rangs from 0 to 128.
statistic: Displays route statistics.
Description
Use the display bgp ipv6 routing-table peer command 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, > - 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
Refer to Table 1-5 for description on the fields above.
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 the display bgp ipv6 routing-table regular-expression command 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, > - 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
Refer to Table 1-5 for description on the fields above.
display bgp ipv6 routing-table statistic
Syntax
display bgp ipv6 routing-table statistic
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display bgp ipv6 routing-table statistic command 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)
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
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 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 at present. If no protocol is specified, all routes will be filtered when advertised.
process-id: Process ID of the routing protocol, in the range 1 to 65535. It is available only when the protocol is isisv6, ospfv3 or ripng.
Description
Use the filter-policy export command to filter outbound routes using a specified filter.
Use the undo filter-policy export command 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.
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
filter-policy import (IPv6 address family view)
Syntax
filter-policy { acl6-number | ipv6-prefix ipv6-prefix-name } import
undo filter-policy import
View
IPv6 address family 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, ranging from 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 the filter-policy import command to filter inbound routing information using a specified filter.
Use the undo filter-policy import command to cancel filtering inbound routing information.
By default, no inbound routing information is filtered.
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
group (IPv6 address family view)
Syntax
group ipv6-group-name [ internal | external ]
undo group ipv6-group-name
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-group-name: Name of an IPv6 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 the group command to create a peer group.
Use the undo group command 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)
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
Default Level
2: System level
Parameters
protocol: Redistributes routes from the specified protocol, which can be direct, isisv6, ospfv3, ripng and static at present.
process-id: Process ID, in the range 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 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 19 characters.
Description
Use the import-route command to redistribute routes from another routing protocol.
Use the undo import-route command 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
undo ipv6-family
View
BGP view
Default Level
2: System level
Parameters
None
Description
Use the ipv6-family command to enter IPv6 address family view.
Use the undo ipv6-family command to remove all configurations from the view.
IPv4 BGP unicast view is the default.
Examples
# Enter IPv6 address family view.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv6-family
[Sysname-bgp-af-ipv6]
network (IPv6 address family view)
Syntax
network ipv6-address prefix-length [ short-cut | route-policy route-policy-name ]
undo network ipv6-address prefix-length [ short-cut ]
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-address: IPv6 address.
prefix-length: Prefix length of the address, in the range 0 to 128.
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.
route-policy-name: Name of a routing policy, a string of 1 to 19 characters.
Description
Use the network command to advertise a network to the IPv6 BGP routing table.
Use the undo network command to remove an entry from the IPv6 BGP routing table.
By default, no route is advertised.
Note that:
l The route to be advertised must exist in the local IP routing table, and using a routing policy makes route management more flexible.
l 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 an IPv4 or IPv6 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 the peer advertise-community command to advertise the community attribute to a peer/peer group.
Use the undo peer advertise-community command 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-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 an IPv4 or IPv6 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 the peer advertise-ext-community command to advertise the extended community attribute to a peer/peer group.
Use the undo peer advertise-ext-community command 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 an IPv4 or IPv6 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 1 to 10. The default number is 1.
Description
Use the peer allow-as-loop command 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 the undo peer allow-as-loop command 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 { ipv6-group-name | ipv6-address } as-number as-number
undo peer ipv6-group-name as-number
undo peer ipv6-address
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-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 1 to 65535.
Description
Use the peer as-number command to specify a peer/peer group with an AS number.
Use the undo peer as-number command to delete a peer group.
Use the undo peer command to delete a peer.
By default, no peer/peer group is specified.
Examples
# Specify 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-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 an IPv4 or IPv6 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 1 to 256.
import: Filters incoming routes.
export: Filters outgoing routes.
Description
Use the peer as-path-acl command to specify an AS path ACL to filter routes incoming from or outgoing to a peer/peer group.
Use the undo peer as-path-acl command 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 capability-advertise route-refresh
Syntax
peer { ipv6-group-name | ipv6-address } capability-advertise route-refresh
undo peer { ipv6-group-name | ipv6-address } capability-advertise route-refresh
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Description
Use the peer capability-advertise route-refresh command to enable IPv6 BGP route-refresh.
Use the undo peer capability-advertise route-refresh command 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 connect-interface (IPv6 address family view)
Syntax
peer { ipv6-group-name | ipv6-address } connect-interface interface-type interface-number
undo peer { ipv6-group-name | ipv6-address } connect-interface
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-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 the peer connect-interface command to specify the source interface for establishing TCP connections to an IPv6 BGP peer or peer group.
Use the undo peer connect-interface command to restore the default.
By default, BGP uses the outbound interface of the best route to the IPv6 BGP peer/peer group as the source interface for establishing a TCP connection.
Note that:
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 may fail to establish TCP connections to the peers when using the outbound 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 an IPv4 or IPv6 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: Route-policy name, a string of 1 to 19 characters.
Description
Use the peer default-route-advertise command to advertise a default route to a peer/peer group.
Use the undo peer default-route-advertise command 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 { ipv6-group-name | ipv6-address } description description-text
undo peer { ipv6-group-name | ipv6-address } description
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
description-text: Description information for the peer/peer group, a string of 1 to 79 characters.
Description
Use the peer description command to configure the description information for a peer/peer group.
Use the undo peer description command to remove the description information of a peer/peer group.
By default, no description information is configured for a 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 ebgp-max-hop (IPv6 address family view)
Syntax
peer { ipv6-group-name | ipv6-address } ebgp-max-hop [ hop-count ]
undo peer { ipv6-group-name | ipv6-address } ebgp-max-hop
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-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 1 to 255. By default, the value is 64.
Description
Use the peer ebgp-max-hop command to allow establishing the EBGP connection to a peer/peer group indirectly connected.
Use the undo peer ebgp-max-hop command 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 fake-as (IPv6 address family view)
Syntax
peer { ipv6-group-name | ipv6-address } fake-as as-number
undo peer { ipv6-group-name | ipv6-address } fake-as
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
as-number: Local autonomous system number, in the range 1 to 65535.
Description
Use the peer fake-as command to configure a fake local AS number for a peer or peer group.
Use the undo peer fake-as command 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 an IPv4 or IPv6 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 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 the peer filter-policy command to configure an ACL-based filter policy for a peer or peer group.
Use the undo peer filter-policy command 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 an IPv4 or IPv6 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 1 to 65535.
Description
Use the peer group command to add a peer to a configured peer group.
Use the undo peer group command 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 { ipv6-group-name | ipv6-address } ignore
undo peer { ipv6-group-name | ipv6-address } ignore
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Description
Use the peer ignore command to terminate the session to a peer or peer group.
Use the undo peer ignore command 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 session(s) with the specified peer or peer group and clears all the related routing information. For a peer group, this means all the sessions with the peer group will be tore 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 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 an IPv4 or IPv6 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 the peer ipv6-prefix command to specify an IPv6 prefix list to filter routes incoming from or outgoing to a peer or peer group.
Use the undo peer ipv6-prefix command to remove the configuration.
By default, no IPv6 prefix list is specified for filtering.
Examples
# Reference the IPv6 prefix list list 1 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 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 an IPv4 or IPv6 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 the peer keep-all-routes command to save the original routing information from a peer or peer group, including even routes that failed to pass the inbound policy.
Use the undo peer keep-all-routes command 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 log-change (IPv6 address family view)
Syntax
peer { ipv6-group-name | ipv6-address } log-change
undo peer { ipv6-group-name | ipv6-address } log-change
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Description
Use the peer log-change command to enable the logging of session state and event information of a specified peer or peer group.
Use the undo peer log-change command to remove the configuration.
The logging is enabled by default.
Examples
# Enable the logging of session state and event information 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 log-change
peer next-hop-local (IPv6 address family view)
Syntax
peer { ipv6-group-name | ipv6-address } next-hop-local
undo peer { ipv6-group-name | ipv6-address } next-hop-local
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Description
Use the peer next-hop-local command to configure the next hop of routes advertised to a peer/peer group as the local router.
Use the undo peer next-hop-local command 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 set 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 preferred-value (IPv6 address family view)
Syntax
peer { ipv6-group-name | ipv6-address } preferred-value value
undo peer { ipv6-group-name | ipv6-address } preferred-value
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-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 0 to 65535.
Description
Use the peer preferred-value command to assign a preferred value to routes received from a peer or peer group.
Use the undo peer preferred-value command 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.
Note that:
If you both reference a routing policy and use the command peer { ipv6-group-name | ipv6-address } preferred-value value to set a preferred value for routes from a peer, the routing policy sets a non-zero preferred value for routes matching it. Other routes not matching the routing policy uses the value set with the command. If the preferred value in the routing policy is zero, the routes matching it will also use the value set with the command. For information about using a routing policy to set a preferred value, refer to 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 Commands of the IP Routing Volume.
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 public-as-only (IPv6 address family view)
Syntax
peer { ipv6-group-name | ipv6-address } public-as-only
undo peer { ipv6-group-name | ipv6-address } public-as-only
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Description
Use the peer public-as-only command to configure IPv6 BGP updates to a peer/peer group to not carry private AS numbers.
Use the undo peer public-as-only command 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 an IPv4 or IPv6 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 the peer reflect-client command to configure the router as a route reflector and specify a peer/peer group as a client.
Use the undo peer reflect-client command to remove the configuration.
By default, neither route reflector nor client is configured.
Related commands: reflect between-clients, 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 an IPv4 or IPv6 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. The limit varies with devices.. When the received prefixes from the peer/peer group reach the specified upper limit, the router will disconnect from the peer/peer group.
alert-only: When the received prefixes from the peer/peer group reach the specified upper limit, the router will display alarm messages rather than disconnect from the peer/peer group.
reconnect-time: Interval for the router to reconnect to the peer/peer group. The argument has no default. It ranges from 1 to 65535 seconds.
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 1 to 100.
Description
Use the peer route-limit command to set the maximum number of prefixes that can be received from a peer/peer group.
Use the undo peer route-limit command to restore the default.
By default, the router has no limit on prefixes from a peer/peer group.
The router will end the peer relation when the number of address prefixes received for the peer 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-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 an IPv4 or IPv6 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: Specifies route-policy name, a string of 1 to 19 characters.
import: Applies the routing policy to routes from the peer (group).
export: Applies the routing policy to routes sent to the peer (group).
Description
Use the peer route-policy command to apply a routing policy to routes incoming from or outgoing to a peer or peer group.
Use the undo peer route-policy command to remove the configuration.
By default, no routing policy is specified for the peer (group).
Use of the peer route-policy command does not apply the if-match interface clause defined in the routing policy. Refer to Routing Policy Commands in the IP Routing Volume for related information.
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-update-interval (IPv6 address family view)
Syntax
peer { ipv6-group-name | ipv6-address } route-update-interval interval
undo peer { ipv6-group-name | ipv6-address } route-update-interval
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-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 (group) from 5 to 600 seconds.
Description
Use the peer route-update-interval command to specify the interval for sending the same update to a peer/peer group.
Use the undo peer route-update-interval command 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 { ipv6-group-name | ipv6-address } substitute-as
undo peer { ipv6-group-name | ipv6-address } substitute-as
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.
ipv6-address: IPv6 address of a peer.
Description
Use the peer substitute-as command to substitute the local AS number for the AS number of a peer/peer group in the AS_PATH attribute.
Use the undo peer substitute-as command 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 { ipv6-group-name | ipv6-address } timer keepalive keepalive hold holdtime
undo peer { ipv6-group-name | ipv6-address } timer
View
IPv6 address family view
Default Level
2: System level
Parameters
ipv6-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, ranging from 1 to 21845.
holdtime: Specifies the holdtime in seconds, ranging from 3 to 65535.
Description
Use the peer timer command to configure keepalive interval and holdtime interval for a peer or peer group.
Use the undo peer timer command to restore the default.
keepalive interval defaults to 60 seconds, and holdtime interval defaults to 180 seconds
Note that:
l The timer configured with this command is preferred to the timer configured with the timer command.
l The holdtime interval must be at least three times the keepalive interval.
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
preference (IPv6 address family view)
Syntax
preference { external-preference internal-preference local-preference | route-policy route-policy-name }
undo preference
View
IPv6 address family view
Default Level
2: System level
Parameters
external-preference: Preference of EBGP route learned from an EBGP peer, in the range 1 to 255.
internal-preference: Preference of IBGP route learned from an IBGP peer, in the range 1 to 255.
local-preference: Preference of IPv6 BGP local route, in the range 1 to 255.
route-policy-name: Routing policy name, a string of 1 to 19 characters. The routing policy can set a preference for routes passing it. The default value applies to the routes filtered out.
Description
Use the preference command to configure preferences for EBGP, IBGP, and local routes.
Use the undo preference command 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 respectively.
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 the reflect between-clients command to enable route reflection between clients.
Use the undo reflect between-clients command 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, it is recommended to disable route reflection on the route reflector to reduce costs.
Related commands: reflector cluster-id, 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 the reflector cluster-id command to configure the cluster ID of the route reflector.
Use the undo reflector cluster-id command to remove the configured cluster ID.
By default, a route reflector uses its router ID as the cluster ID.
Usually, there is only one route reflector in a cluster, 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, 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 ipv6-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 the refresh bgp ipv6 command 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 [ flap-info ] | all | group group-name | external | internal }
View
User view
Default Level
1: Monitor level
Parameters
as-number: Resets the IPv6 BGP connections to peers in the specified AS.
ipv4-address: Resets the connection to the specified IPv4 BGP peer.
ipv6-address: Resets the connection to the specified IPv6 BGP peer.
flap-info: Clears the history information of routing flaps.
all: Resets all IPv6 BGP connections.
group group-name: Resets the connections to the specified IPv6 BGP peer group.
external: Resets all the EBGP connections.
internal: Resets all the IBGP connections.
Description
Use the reset bgp ipv6 command 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 0 to 128.
Description
Use the reset bgp ipv6 dampening command 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 of 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 | regexp as-path-regexp | as-path-acl as-path-acl-number ]
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 1 to 128.
as-path-regexp: Clears the flap statistics for routes matching the AS path regular expression.
as-path-acl-number: Clears the flap statistics for routes matching the AS path ACL. The number is in the range 1 to 256.
Description
Use the reset bgp ipv6 flap-info command 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 the router-id command to specify a router ID for the router.
Use the undo router-id command 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.
A router ID can be configured manually. If not, the system will select a router ID automatically from the current interfaces’ IPv4 addresses. The selection sequence is the highest IPv4 address of Loopback interfaces’ addresses, then the highest IPv4 address of physical interfaces’ addresses if no Loopback interfaces are configured.
Only when the interface with the router ID is removed or the manually configured router ID is removed, will the system select another Router ID. To improve network reliability, it is recommended to configure the IPv4 address of a loopback interface as the router ID.
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 the synchronization command to enable the synchronization between IPv6 BGP and IGP.
Use the undo synchronization command 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.
Currently, the system does not support synchronization. Therefore, the configuration of this command does not actually take effect.
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, ranging from 1 to 21845.
holdtime: Holdtime interval in seconds, ranging from 3 to 65535.
Description
Use the timer command to specify IPv6 BGP keepalive interval and holdtime interval.
Use the undo timer command to restore the default.
By default, the keepalive and holdtime intervals are 60s and 180s respectively.
Note that:
l Timer configured using the peer timer command is preferred to the timer configured using the timer command.
l The holdtime interval must be at least three times the keepalive interval.
l The configured timer applies to all the IPv6 BGP peers. It becomes valid only after the corresponding IPv6 BGP connections are reset.
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