07-Layer 3 - IP Routing Command Reference

HomeSupportSwitchesH3C S12500 Switch SeriesReference GuidesCommand ReferencesH3C S12500 Command References-Release1828P04-6W18207-Layer 3 - IP Routing Command Reference
13-IPv6 BGP Commands
Title Size Download
13-IPv6 BGP Commands 349.7 KB

Contents

IPv6 BGP configuration commands 1

aggregate (IPv6 address family view) 1

balance (IPv6 address family view/IPv6 BGP-VPN instance view) 2

bestroute as-path-neglect (IPv6 address family view) 3

bestroute compare-med (IPv6 address family view) 3

bestroute med-confederation (IPv6 address family view) 4

compare-different-as-med (IPv6 address family view) 5

dampening (IPv6 address family view) 5

default local-preference (IPv6 address family view/IPv6 BGP-VPN instance view) 6

default med (IPv6 address family view/IPv6 BGP-VPN instance view) 7

default-route imported (IPv6 address family view/IPv6 BGP-VPN instance view) 8

display bgp ipv6 group· 8

display bgp ipv6 network· 10

display bgp ipv6 paths 11

display bgp ipv6 peer 12

display bgp ipv6 peer received ipv6-prefix· 16

display bgp ipv6 routing-table· 17

display bgp ipv6 routing-table as-path-acl 19

display bgp ipv6 routing-table community· 20

display bgp ipv6 routing-table community-list 21

display bgp ipv6 routing-table dampened· 22

display bgp ipv6 routing-table dampening parameter 23

display bgp ipv6 routing-table different-origin-as 24

display bgp ipv6 routing-table flap-info· 25

display bgp ipv6 routing-table label 26

display bgp ipv6 routing-table peer 27

display bgp ipv6 routing-table regular-expression· 28

display bgp ipv6 routing-table statistic· 29

filter-policy export (IPv6 address family view/IPv6 BGP-VPN instance view) 29

filter-policy import (IPv6 address family view/IPv6 BGP-VPN instance view) 31

group (IPv6 address family view) 32

import-route (IPv6 address family view/IPv6 BGP-VPN instance view) 32

ipv6-family· 33

network (IPv6 address family view/IPv6 BGP-VPN instance view) 34

peer advertise-community (IPv6 address family view) 35

peer advertise-community (IPv6 BGP-VPN instance view) 35

peer advertise-ext-community (IPv6 address family view) 36

peer allow-as-loop (IPv6 address family view) 37

peer as-number (IPv6 address family view) 37

peer as-number (IPv6 BGP-VPN instance view) 38

peer as-path-acl (IPv6 address family view) 39

peer bfd (IPv6 address family view/IPv6 BGP-VPN instance view) 39

peer capability-advertise orf (IPv6 address family view) 40

peer capability-advertise orf non-standard (IPv6 address family view) 41

peer capability-advertise route-refresh· 42

peer capability-advertise suppress-4-byte-as (IPv6 address family view) 43

peer capability-advertise suppress-4-byte-as (IPv6 BGP-VPN instance view) 43

peer connect-interface (IPv6 address family view) 44

peer default-route-advertise· 45

peer description (IPv6 address family view) 46

peer description (IPv6 BGP-VPN instance view) 46

peer ebgp-max-hop (IPv6 address family view) 47

peer enable (IPv6 address family view) 48

peer fake-as (IPv6 address family view) 48

peer filter-policy (IPv6 address family view) 49

peer group (IPv6 address family view) 50

peer ignore (IPv6 address family view) 50

peer ignore-originatorid (IPv6 address family view) 51

peer ipv6-prefix· 52

peer ipsec-policy (IPv6 address family view) 53

peer keep-all-routes (IPv6 address family view) 53

peer label-route-capability (IPv6 address family view) 54

peer log-change (IPv6 address family view) 55

peer next-hop-local (IPv6 address family view) 55

peer password (IPv6 address family view) 56

peer password (IPv6 BGP-VPN instance view) 57

peer preferred-value (IPv6 address family view) 58

peer preferred-value (IPv6 BGP-VPN instance view) 59

peer public-as-only (IPv6 address family view) 59

peer reflect-client (IPv6 address family view) 60

peer route-limit (IPv6 address family view) 61

peer route-limit (IPv6 BGP-VPN instance view) 62

peer route-policy (IPv6 address family view) 63

peer route-policy (IPv6 BGP-VPN instance view) 63

peer route-update-interval (IPv6 address family view) 64

peer substitute-as (IPv6 address family view) 65

peer timer (IPv6 address family view) 66

preference (IPv6 address family view/IPv6 BGP-VPN instance view) 67

reflect between-clients (IPv6 address family view) 67

reflector cluster-id (IPv6 address family view) 68

refresh bgp ipv6· 69

reset bgp ipv6· 70

reset bgp ipv6 dampening· 70

reset bgp ipv6 flap-info· 71

router-id· 71

synchronization (IPv6 address family view) 72

timer (IPv6 address family view) 73

 


For more information about routing policy configuration commands in this document, see "Routing policy configuration commands."

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:

·     iThe route is interior to the AS. Summary routes and routes defined using the network command are considered IGP routes.

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

·     UpThe BGP session is up.

·     DownThe 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

Table 9 Command output

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:

·     iA route is interior to the AS. Summary routes and the routes configured using the network command are considered IGP routes.

·     eA 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

peer ipv6-address bfd

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

[Sysname-bgp-af-ipv6] timer keepalive 60 hold 180

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become A Partner
  • Partner Policy & Program
  • Global Learning
  • Partner Sales Resources
  • Partner Business Management
  • Service Business
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网