03-IP Routing Volume

HomeSupportSwitchesH3C S7500E Switch SeriesReference GuidesCommand ReferencesH3C S7500E Series Ethernet Switches Command Manual(Release 6300 series V1.03)03-IP Routing Volume
11-IPv6 BGP Commands
Title Size Download
11-IPv6 BGP Commands 203.25 KB

Table of Contents

1 IPv6 BGP Configuration Commands· 1-1

IPv6 BGP Configuration Commands· 1-1

balance (IPv6 address family view) 1-1

bestroute as-path-neglect (IPv6 address family view) 1-2

bestroute compare-med (IPv6 address family view) 1-2

bestroute med-confederation (IPv6 address family view) 1-3

compare-different-as-med (IPv6 address family view) 1-4

dampening (IPv6 address family view) 1-4

default local-preference (IPv6 address family view) 1-5

default med (IPv6 address family view) 1-6

default-route imported (IPv6 address family view) 1-7

display bgp ipv6 group· 1-7

display bgp ipv6 network· 1-9

display bgp ipv6 paths· 1-10

display bgp ipv6 peer 1-11

display bgp ipv6 routing-table· 1-12

display bgp ipv6 routing-table as-path-acl 1-14

display bgp ipv6 routing-table community· 1-14

display bgp ipv6 routing-table community-list 1-15

display bgp ipv6 routing-table dampened· 1-16

display bgp ipv6 routing-table dampening parameter 1-17

display bgp ipv6 routing-table different-origin-as· 1-18

display bgp ipv6 routing-table flap-info· 1-19

display bgp ipv6 routing-table peer 1-20

display bgp ipv6 routing-table regular-expression· 1-21

display bgp ipv6 routing-table statistic· 1-21

filter-policy export (IPv6 address family view) 1-22

filter-policy import (IPv6 address family view) 1-23

group (IPv6 address family view) 1-23

import-route (IPv6 address family view) 1-24

ipv6-family· 1-25

network (IPv6 address family view) 1-25

peer advertise-community (IPv6 address family view) 1-26

peer advertise-ext-community (IPv6 address family view) 1-27

peer allow-as-loop (IPv6 address family view) 1-27

peer as-number (IPv6 address family view) 1-28

peer as-path-acl (IPv6 address family view) 1-29

peer capability-advertise route-refresh· 1-30

peer connect-interface (IPv6 address family view) 1-30

peer default-route-advertise· 1-31

peer description (IPv6 address family view) 1-32

peer ebgp-max-hop (IPv6 address family view) 1-33

peer fake-as (IPv6 address family view) 1-33

peer filter-policy (IPv6 address family view) 1-34

peer group (IPv6 address family view) 1-35

peer ignore (IPv6 address family view) 1-36

peer ipv6-prefix· 1-36

peer keep-all-routes (IPv6 address family view) 1-37

peer log-change (IPv6 address family view) 1-38

peer next-hop-local (IPv6 address family view) 1-38

peer preferred-value (IPv6 address family view) 1-39

peer public-as-only (IPv6 address family view) 1-40

peer reflect-client (IPv6 address family view) 1-41

peer route-limit (IPv6 address family view) 1-41

peer route-policy (IPv6 address family view) 1-42

peer route-update-interval (IPv6 address family view) 1-43

peer substitute-as (IPv6 address family view) 1-44

peer timer (IPv6 address family view) 1-45

preference (IPv6 address family view) 1-45

reflect between-clients (IPv6 address family view) 1-46

reflector cluster-id (IPv6 address family view) 1-47

refresh bgp ipv6· 1-48

reset bgp ipv6· 1-48

reset bgp ipv6 dampening· 1-49

reset bgp ipv6 flap-info· 1-50

router-id· 1-50

synchronization (IPv6 address family view) 1-51

timer (IPv6 address family view) 1-52

 


 

l          The term “router” in this document refers to a router in a generic sense or a Layer 3 switch.

l          EA boards (such as LSQ1GP12EA and LSQ1TGX1EA) do not support IPv6 features.

 

IPv6 BGP Configuration Commands

balance (IPv6 address family view)

Syntax

balance number

undo balance

View

IPv6 address family view

Default Level

2: System level

Parameters

number: Number of BGP routes participating in load balancing. Its value is in the range 1 to 4. When it is set to 1, load balancing is disabled.

Description

Use the balance command to configure the number of routes participating in IPv6 BGP load balancing.

Use the undo balance command to restore the default.

The feature is not available by default.

Unlike IGP, BGP has no explicit metric for making load balancing decision. Instead, it implements load balancing by defining its routing rule.

Related commands: display bgp ipv6 routing-table.

Examples

# Set the number of routes participating in IPv6 BGP load balancing to 2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] balance 2

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

Syntax

bestroute as-path-neglect

undo bestroute as-path-neglect

View

IPv6 address family view

Default Level

2: System level

Parameters

None

Description

Use the bestroute as-path-neglect command to configure the IPv6 BGP router to not evaluate the AS_PATH during best route selection.

Use the undo bestroute as-path-neglect command to configure the IPv6 BGP router to use the AS_PATH during best route selection.

By default, the router takes AS_PATH as a factor when selecting the best route.

Examples

# Ignore AS_PATH in route selection.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] bestroute as-path-neglect

bestroute compare-med (IPv6 address family view)

Syntax

bestroute compare-med

undo bestroute compare-med

View

IPv6 address family view

Default Level

2: System level

Parameters

None

Description

Use the bestroute compare-med command to enable the comparison of the MED for paths from each AS.

Use the undo bestroute compare-med command to disable this comparison.

This comparison is not enabled by default.

 

After the bestroute compare-med command is executed, the balance command does not take effect.

 

Examples

# Compare the MED for paths from an AS for selecting the best route.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] bestroute compare-med

bestroute med-confederation (IPv6 address family view)

Syntax

bestroute med-confederation

undo bestroute med-confederation

View

IPv6 address family view

Default Level

2: System level

Parameters

None

Description

Use the bestroute med-confederation command to enable the comparison of the MED for paths from confederation peers for best route selection.

Use the undo bestroute med-confederation command to disable the configuration.

By default, this comparison is not enabled.

With this feature enabled, the system can only compare the MED for paths from peers within the confederation. Paths from external ASs are advertised throughout the confederation without MED comparison.

Examples

# Compare the MED for paths from peers within the confederation.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] bestroute med-confederation

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

Syntax

compare-different-as-med

undo compare-different-as-med

View

IPv6 address family view

Default Level

2: System level

Parameters

None

Description

Use the compare-different-as-med command to enable the comparison of the MED for paths from peers in different ASs.

Use the undo compare-different-as-med command to disable the comparison.

The comparison is disabled by default.

If there are several paths available for one destination, the path with the smallest MED value is selected.

Do not use this command unless associated ASs adopt the same IGP protocol and routing selection method.

Examples

# Enable to compare the MED for paths from peers in different ASs.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

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

dampening (IPv6 address family view)

Syntax

dampening [ half-life-reachable half-life-unreachable reuse suppress ceiling | route-policy route-policy-name ] *

undo dampening

View

IPv6 address family view

Default Level

2: System level

Parameters

half-life-reachable: Half-life for reachable routes, in the range 1 to 45 minutes. By default, the value is 15 minutes.

half-life-unreachable: Half-life for unreachable routes, in the range 1 to 45 minutes. By default, the value is 15 minutes.

reuse: Reuse threshold value for suppressed routes, in the range 1 to 20000. Penalty value of a suppressed route decreasing under the value is reused. By default, its value is 750.

suppress: Suppression threshold from 1 to 20000, which should be bigger than the reuse value. Routes with a penalty value bigger than the threshold are suppressed. By default, it is 2000.

ceiling: Ceiling penalty value from 1001 to 20000. The value must be bigger than the suppress value. By default, the value is 16000.

route-policy-name: Routing policy name, a string of 1 to 19 characters.

half-life-reachable, half-life-unreachable, reuse, suppress and ceiling are mutually dependent. Once any one is configured, all the others should also be specified accordingly.

Description

Use the dampening command to enable IPv6 BGP route dampening or/and configure dampening parameters.

Use the undo dampening command to disable route dampening.

By default, no route dampening is configured.

Related commands: reset bgp ipv6 dampening, reset bgp ipv6 flap-info, display bgp ipv6 routing-table dampened, display bgp ipv6 routing-table dampening parameter, display bgp ipv6 routing-table flap-info.

Examples

# Enable IPv6 BGP route dampening and configure route dampening parameters.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] dampening 10 10 1000 2000 3000

default local-preference (IPv6 address family view)

Syntax

default local-preference value

undo default local-preference

View

IPv6 address family view

Default Level

2: System level

Parameters

value: Default local preference, in the range 0 to 4294967295. The larger the value is, the higher the preference is.

Description

Use the default local-preference command to configure the default local preference.

Use the undo default local-preference command to restore the default value.

By default, the default local preference is 100.

Use this command to affect IPv6 BGP route selection.

Examples

# Two devices A and B in the same AS are connected to another AS. Change the local preference of B from default value 100 to 180, making the route passing B preferred.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] default local-preference 180

default med (IPv6 address family view)

Syntax

default med med-value

undo default med

View

IPv6 address family view

Default Level

2: System level

Parameters

med-value: MED value, in the range 0 to 4294967295.

Description

Use the default med command to specify the default MED value.

Use the undo default med command to restore the default.

By default, the default med-value is 0.

The multi-exit discriminator (MED) is an external metric of a route. Different from local preference, MED is exchanged between ASs and will stay in the AS once it enters the AS. The route with a lower MED is preferred. When a router running BGP obtains several routes with the identical destination and different next-hops from various external peers, it will select the best route depending on the MED value. In the case that all other conditions are the same, the system first selects the route with the smaller MED value as the best route for the autonomous system.

Examples

# Devices A and B belong to AS100 and device C belongs to AS200. C is the peer of A and B. Configure the MED of A as 25 to make C select the path from B.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] default med 25

default-route imported (IPv6 address family view)

Syntax

default-route imported

undo default-route imported

View

IPv6 address family view

Default Level

2: System level

Parameters

None

Description

Use the default-route imported command to enable the redistribution of default route into the IPv6 BGP routing table.

Use the undo default-route imported command to disable the redistribution.

By default, the redistribution is not enabled.

Examples

# Enable the redistribution of default route from OSPFv3 into IPv6 BGP.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

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

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

display bgp ipv6 group

Syntax

display bgp ipv6 group [ ipv6-group-name ]

View

Any view

Default Level

1: Monitor level

Parameters

ipv6-group-name: Peer group name, a string of 1 to 47 characters.

Description

Use the display bgp ipv6 group command to display IPv6 peer group information.

If no ipv6-group-name is specified, information about all peer groups is displayed.

Examples

# Display the information of the IPv6 peer group aaa.

<Sysname> display bgp ipv6 group aaa

 

 BGP peer-group is aaa

 remote AS number not specified

 Type : external

 Maximum allowed prefix number: 4294967295

 Threshold: 75%

 Configured hold timer value: 180

 Keepalive timer value: 60

 Minimum time between advertisement runs is 30 seconds

 Peer Preferred Value: 0

 No routing policy is configured

  Members:

  Peer         V    AS  MsgRcvd  MsgSent  OutQ PrefRcv Up/Down  State

 

  20:20::20:1  4   200       170       141      0        2 02:13:35 Established

Table 1-1 display bgp ipv6 group command output description

Field

Description

BGP peer-group

Name of the peer group

remote AS

AS number of the peer group

Type

Type of the  peer group

Maximum allowed prefix number

Maximum allowed prefix number

Threshold

Threshold  value

hold timer value

Holdtime

Keepalive timer value

Keepalive interval

Minimum time between advertisement runs

Minimum interval between advertisements

Peer Preferred Value

Preferred value of the routes from the peer

No routing policy is configured

No routing policy is configured for the peer

Members

Group members

Peer

IPv6 address of the peer

V

Peer BGP version

AS

AS number

MsgRcvd

Number of messages received

MsgSent

Number of messages sent

OutQ

Number of messages to be sent

PrefRcv

Number of prefixes received

Up/Down

The lasting time of a session/the lasting time of present state (when no session is established)

State

State machine state of peer

 

display bgp ipv6 network

Syntax

display bgp ipv6 network

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display bgp ipv6 network command to display IPv6 routes advertised with the network command.

Examples

# Display IPv6 routes advertised with the network command.

<Sysname> display bgp ipv6 network

  BGP Local Router ID is 1.1.1.2.

  Local AS Number is 200.

  Network          Mask            Route-policy        Short-cut

 

  2002::           64

  2001::           64                                  Short-cut

Table 1-2 display bgp ipv6 network command output description

Field

Description

BGP Local Router ID

BGP Local Router ID

Local AS Number

Local AS Number

Network

Network address

Prefix

Prefix length

Route-policy

Routing policy

Short-cut

Shortcut route

 

display bgp ipv6 paths

Syntax

display bgp ipv6 paths [ as-regular-expression ]

View

Any view

Default Level

1: Monitor level

Parameters

as-regular-expression: AS path regular expression, a string of 1 to 80 characters.

Description

Use the display bgp ipv6 paths command to display IPv6 BGP path information.

If no parameter is specified, all path information will be displayed.

Examples

# Display IPv6 BGP path information.

<Sysname> display bgp ipv6 paths

 

    Address       Hash    Refcount  MED         Path/Origin

    0x5917098     1       1          0            i

    0x59171D0     9       2          0            100i    

Table 1-3 display bgp ipv6 paths command output description

Field

Description

Address

Route destination address in local database, in dotted hexadecimal notation

Hash

Hash index

Refcount

Count of routes that used the path

MED

MED of the path

Path

AS_PATH attribute of the path, recording the ASs it has passed, for avoiding routing loops

Origin

Origin attribute of the route, which can take on one of the following values:

i

Indicates the route is interior to the AS.

Summary routes and routes defined using the network command are considered IGP routes.

e

Indicates that a route is learned from the exterior gateway protocol (EGP).

?

Short for INCOMPLETE. It indicates that the origin of a route is unknown and the route is learned by other means. BGP sets Origin attribute of routes learned from other IGP protocols to INCOMPLETE.

 

display bgp ipv6 peer

Syntax

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

View

Any view

Default Level

1: Monitor level

Parameters

group-name: Name of an IPv4 or IPv6 peer group, a string of 1 to 47 characters.

ipv4-address: IPv4 address of a peer.

ipv6-address: Specifies the IPv6 address of a peer to be displayed.

log-info: Displays log information of the specified peer.

verbose: Displays the detailed information of the peer.

Description

Use the display bgp ipv6 peer command to display peer/peer group information.

If no parameter specified, information about all peers and peer groups is displayed.

Examples

# Display all IPv6 peer information.

<Sysname> display bgp ipv6 peer

 

 BGP Local router ID : 20.0.0.1

 local AS number : 100

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

 

Peer      V    AS  MsgRcvd  MsgSent  OutQ PrefRcv  Up/Down    State

 

20::21    4   200  17       19       0          3  00:09:59   Established

Table 1-4 display bgp ipv6 peer command output description

Field

Description

Peer

IPv6 address of the peer

V

Peer BGP version

AS

AS number

MsgRcvd

Messages received

MsgSent

Messages sent

OutQ

Messages to be sent

PrefRcv

Number of prefixes received

Up/Down

The lasting time of a session/the lasting time of present state (when no session is established)

State

Peer state

 

display bgp ipv6 routing-table

Syntax

display bgp ipv6 routing-table [ ipv6-address prefix-length ]

View

Any view

Default Level

1: Monitor level

Parameters

ipv6-address: Destination IPv6 address.

prefix-length: Prefix length of the IPv6 address, in the range 0 to 128.

Description

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

Examples

# Display the IPv6 BGP routing table.

<Sysname> display bgp ipv6 routing-table

 

 Total Number of Routes: 2

 

 BGP Local router ID is 30.30.30.1

 Status codes: * - valid, > - best, d - damped,

               h - history,  i - internal, s - suppressed, S - Stale

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

 

 *>  Network : 30:30::                                  PrefixLen : 64

     NextHop : 30:30::30:1                              LocPrf    :

     PrefVal : 0                                        Label     : NULL

     MED      :0

     Path/Ogn: i

 

 *>  Network : 40:40::                                  PrefixLen : 64

     NextHop : 40:40::40:1                              LocPrf    :

     PrefVal : 0                                        Label     : NULL

     MED     : 0

     Path/Ogn: i

Table 1-5 display bgp ipv6 routing-table command output description

Field

Description

Local router ID

Local router ID

Status codes

Status codes:

* – valid

> – best

d – damped

h – history

i – internal (IGP)

s – summary suppressed (suppressed)

S – Stale

Origin

i – IGP (originated in the AS)

e – EGP (learned through EGP)

? – incomplete (learned by other means)

Network

Destination network address

PrefixLen

Prefix length

NextHop

Next Hop

MED

MULTI_EXIT_DISC attribute

LocPrf

Local preference value

Path

AS_PATH attribute, recording the ASs the packet has passed to avoid routing loops

PrefVal

Preferred value

Label

Label

Ogn

Origin attribute of the route, which can take on one of the following values:

i

Indicates that a route is interior to the AS.

Summary routes and the routes configured using the network command are considered IGP routes.

e

Indicates that a route is learned from the exterior gateway protocol (EGP).

?

Short for INCOMPLETE. It indicates that the origin of a route is unknown and the route is learned by other means. BGP sets Origin attribute of routes learned from other IGP protocols to INCOMPLETE.

 

display bgp ipv6 routing-table as-path-acl

Syntax

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

View

Any view

Default Level

1: Monitor level

Parameters

as-path-acl-number: Number of an AS path ACL permitted by which to display routing information, ranging from 1 to 256.

Description

Use the display bgp ipv6 routing-table as-path-acl command to display routes filtered through the specified AS path ACL.

Examples

# Display routes filtered through the AS path ACL 20.

<Sysname> display bgp ipv6 routing-table as-path-acl 20

 BGP Local router ID is 30.30.30.1

 Status codes: * - valid, > - best, d - damped,

               h - history,  i - internal, s - suppressed, S - Stale

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

 

 *>  Network : 30:30::                                  PrefixLen : 64

     NextHop : 30:30::30:1                              LocPrf    :

     PrefVal : 0                                        Label     : NULL

     MED     : 0

     Path/Ogn: i

Refer to Table 1-5 for description on the fields above.

display bgp ipv6 routing-table community

Syntax

display bgp ipv6 routing-table community [ aa:nn&<1-13> ] [ no-advertise | no-export | no-export-subconfed ] * [ whole-match ]

View

Any view

Default Level

1: Monitor level

Parameters

aa:nn: Community number; both aa and nn are in the range 0 to 65535.

&<1-13>: Indicates the argument before it can be entered up to 13 times.

no-advertise: Displays IPv6 BGP routes that cannot be advertised to any peer.

no-export: Displays IPv6 BGP routes that cannot be advertised out the AS; if there is a confederation, it displays IPv6 BGP routes that cannot be advertised out the confederation, but can be advertised to other sub ASs in the confederation.

no-export-subconfed: Displays IPv6 BGP routes that cannot be advertised out the AS or to other sub ASs if a confederation is configured.

whole-match: Displays the IPv6 BGP routes exactly matching the specified community attribute.

Description

Use the display bgp ipv6 routing-table community command to display the routing information with the specified community attribute.

Examples

# Display the routing information with community attribute no-export.

<Sysname> display bgp ipv6 routing-table community no-export

BGP Local router ID is 30.30.30.1

 Status codes: * - valid, > - best, d - damped,

               h - history,  i - internal, s - suppressed, S - Stale

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

 

 *>  Network : 30:30::                                  PrefixLen : 64

     NextHop : 30:30::30:1                              LocPrf    :

     PrefVal : 0                                        Label     : NULL

     MED      : 0

     Path/Ogn: i

Refer to Table 1-5 for description on the fields above.

display bgp ipv6 routing-table community-list

Syntax

display bgp ipv6 routing-table community-list { basic-community-list-number [ whole-match ] | adv-community-list-number }&<1-16>

View

Any view

Default Level

1: Monitor level

Parameters

basic-community-list-number: Specifies a basic community-list number, in the range 1 to 99.

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

whole-match: Displays routes exactly matching the specified basic-community-list-number.

&<1-16>: Specifies to allow entering the argument before it up to 16 times.

Description

Use the display bgp ipv6 routing-table community-list command to view the routing information matching the specified IPv6 BGP community list.

Examples

# Display the routing information matching the specified IPv6 BGP community list.

<Sysname> display bgp ipv6 routing-table community-list 99

BGP Local router ID is 30.30.30.1

 Status codes: * - valid, > - best, d - damped,

               h - history,  i - internal, s - suppressed, S - Stale

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

 

 *>  Network : 30:30::                                  PrefixLen : 64

     NextHop : 30:30::30:1                              LocPrf    :

     PrefVal : 0                                        Label     : NULL

     MED      :0

     Path/Ogn: i

Refer to Table 1-5 for description on the fields above.

display bgp ipv6 routing-table dampened

Syntax

display bgp ipv6 routing-table dampened

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

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

Examples

# Display IPv6 BGP dampened routes.

<Sysname> display bgp ipv6 routing-table dampened

 

BGP Local router ID is 1.1.1.1

 Status codes: * - valid, > - best, d - damped,

               h - history,  i - internal, s - suppressed, S - Stale

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

 

 *d  Network : 111::                                  PrefixLen : 64

     From    : 122::1                                 Reuse     : 00:29:34

     Path/Ogn: 200?

Table 1-6 display bgp ipv6 routing-table dampened command output description

Field

Description

From

Source IP address of a route

Reuse

Time for reuse

 

Refer to Table 1-5 for description on the fields above.

display bgp ipv6 routing-table dampening parameter

Syntax

display bgp ipv6 routing-table dampening parameter

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display bgp ipv6 routing-table dampening parameter command to display IPv6 BGP routing dampening parameters.

Related commands: dampening.

Examples

# Display IPv6 BGP routing dampening parameters.

<Sysname> display bgp ipv6 routing-table dampening parameter

 Maximum Suppress Time(in second)     : 3069

 Ceiling Value                        : 16000

 Reuse Value                          : 750

 Reach HalfLife Time(in  second)      : 900

 Unreach HalfLife Time(in  second)    : 900

 Suppress-Limit                       : 2000

Table 1-7 Description on the above fields

Field

Description

Maximum Suppress Time

Maximum Suppress Time

Ceiling Value

Upper limit of penalty value

Reuse Value

Reuse Value

Reach HalfLife Time(in  second)

Half-life time of active routes

Unreach HalfLife Time(in  second)

Half-life time of inactive routes

Suppress-Limit

Suppress value

 

display bgp ipv6 routing-table different-origin-as

Syntax

display bgp ipv6 routing-table different-origin-as

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display bgp ipv6 routing-table different-origin-as command to display IPv6 BGP routes originating from different autonomous systems.

Examples

# Display routes from different ASs.

<Sysname> display bgp ipv6 routing-table different-origin-as

 

BGP Local router ID is 2.2.2.2

 Status codes: * - valid, > - best, d - damped,

               h - history,  i - internal, s - suppressed, S - Stale

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

 

 *>  Network : 222::                                    PrefixLen : 64

     NextHop : 122::2                                   LocPrf    :

     PrefVal : 0                                        Label     : NULL

     MED      : 0

     Path/Ogn: 100 ?

Refer to Table 1-5 for description on the fields above.

display bgp ipv6 routing-table flap-info

Syntax

display bgp ipv6 routing-table flap-info [ regular-expression as-regular-expression | as-path-acl as-path-acl-number | ipv6-address [ prefix-length [ longer-match ] ] ]

View

Any view

Default Level

1: Monitor level

Parameters

as-regular-expression: AS path regular expression to be matched, a string of 1 to 80 characters.

as-path-acl-number: Number of the specified AS path ACL to be matched, ranging from 1 to 256.

ipv6-address: IPv6 address of a route to be displayed.

prefix-length: Prefix length of the IPv6 address, in the range 0 to 128.

longer-match: Matches the longest prefix.

Description

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

Examples

# Display IPv6 BGP route flap statistics.

<Sysname> display bgp ipv6 routing-table flap-info

 

 BGP Local router ID is 1.1.1.1

 Status codes: * - valid, > - best, d - damped,

               h - history,  i - internal, s - suppressed, S - Stale

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

 

 *d  Network  : 111::                                 PrefixLen : 64

     From     : 122::1                                Flaps     : 3

     Duration : 00:13:47                              Reuse     : 00:16:36

     Path/Ogn : 200?

Table 1-8 display bgp ipv6 routing-table flap-info command output description

Field

Description

Flaps

Number of flaps

Duration

Flap duration

Reuse

Reuse time of the route

 

Refer to Table 1-5 for description on the fields above.

display bgp ipv6 routing-table peer

Syntax

display bgp ipv6 routing-table peer { ipv4-address | ipv6-address } { advertised-routes | received-routes } [ network-address prefix-length | statistic ]

View

Any view

Default Level

1: Monitor level

Parameters

ipv4-address: Specifies the IPv4 peer to be displayed.

ipv6-address: Specifies the IPv6 peer to be displayed.

advertised-routes: Routing information advertised to the specified peer.

received-routes: Routing information received from the specified peer.

network-address prefix-length: IPv6 address and prefix length. The prefix length rangs from 0 to 128.

statistic: Displays route statistics.

Description

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

Examples

# Display the routing information advertised to the specified BGP peer.

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

 Total Number of Routes: 2

 

 BGP Local router ID is 20.20.20.1

 Status codes: * - valid, > - best, d - damped,

               h - history,  i - internal, s - suppressed, S - Stale

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

 

 *>  Network : 20:20::                                  PrefixLen : 64

     NextHop : 20:20::20:1                              LocPrf    :

     PrefVal : 0                                        Label     : NULL

     MED     : 0

     Path/Ogn: i

 

 *>  Network : 40:40::                                  PrefixLen : 64

     NextHop : 30:30::30:1                              LocPrf    :

     PrefVal : 0                                        Label     : NULL       

     MED     : 0

     Path/Ogn: 300 i

Refer to Table 1-5 for description on the fields above.

display bgp ipv6 routing-table regular-expression

Syntax

display bgp ipv6 routing-table regular-expression as-regular-expression

View

Any view

Default Level

1: Monitor level

Parameters

as-regular-expression: AS regular expression, a string of 1 to 80 characters.

Description

Use the display bgp ipv6 routing-table regular-expression command to display the routes permitted by the specified AS regular expression.

Examples

# Display routing information matching the specified AS regular expression.

<Sysname> display bgp ipv6 routing-table regular-expression ^100

 

 BGP Local router ID is 20.20.20.1

 Status codes: * - valid, > - best, d - damped,

               h - history,  i - internal, s - suppressed, S - Stale

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

 

 *>  Network : 50:50::                                  PrefixLen : 64

     NextHop : 10:10::10:1                              LocPrf    :

     PrefVal : 0                                        Label     : NULL

     MED     : 0

     Path/Ogn: 100 i

Refer to Table 1-5 for description on the fields above.

display bgp ipv6 routing-table statistic

Syntax

display bgp ipv6 routing-table statistic

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display bgp ipv6 routing-table statistic command to display IPv6 BGP routing statistics.

Examples

# Display IPv6 BGP routing statistics.

<Sysname> display bgp ipv6 routing-table statistic

 

 Total Number of Routes: 1

filter-policy export (IPv6 address family view)

Syntax

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

undo filter-policy export [ protocol process-id ]

View

IPv6 address family view

Default Level

2: System level

Parameters

acl6-number: Specifies the number of an ACL6 used to match against the destination of routing information. The number is in the range 2000 to 3999.

ipv6-prefix-name: Specifies the name of an IPv6 prefix list used to match against the destination of routing information. The name is a string of 1 to 19 characters.

protocol: Filters routes redistributed from the routing protocol. It can be direct, isisv6, ospfv3, ripng, or static at present. If no protocol is specified, all routes will be filtered when advertised.

process-id: Process ID of the routing protocol, in the range 1 to 65535. It is available only when the protocol is isisv6, ospfv3 or ripng.

Description

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

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

By default, no outbound routing information is filtered.

If a protocol is specified, only routes redistributed from the specified protocol are filtered. If no protocol is specified, all redistributed routes will be filtered.

Examples

# Reference ACL6 2001 to filter all outbound IPv6 BGP routes.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] filter-policy 2001 export

filter-policy import (IPv6 address family view)

Syntax

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

undo filter-policy import

View

IPv6 address family view

Default Level

2: System level

Parameters

acl6-number: Number of an IPv6 ACL used to match against the destination address field of routing information, ranging from 2000 to 3999.

ipv6-prefix-name: Name of an IPv6 prefix list used to match against the destination address field of routing information, a string of 1 to 19 characters.

Description

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

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

By default, no inbound routing information is filtered.

Examples

# Reference ACL6 2001 to filter all inbound routes.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] filter-policy 2001 import

group (IPv6 address family view)

Syntax

group ipv6-group-name [ internal | external ]

undo group ipv6-group-name

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of an IPv6 peer group, a string of 1 to 47 characters.

internal: Creates an IBGP peer group.

external: Creates an EBGP peer group, which can be a group of another sub AS in the confederation.

Description

Use the group command to create a peer group.

Use the undo group command to delete a peer group.

An IBGP peer group will be created if neither internal nor external is selected.

Examples

# Create an IBGP peer group named test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname] ipv6-family

[Sysname-bgp-af-ipv6] group test

import-route (IPv6 address family view)

Syntax

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

undo import-route protocol [ process-id ]

View

IPv6 address family view

Default Level

2: System level

Parameters

protocol: Redistributes routes from the specified protocol, which can be direct, isisv6, ospfv3, ripng and static at present.

process-id: Process ID, in the range 1 to 65535. The default is 1. It is available only when the protocol is isisv6, ospfv3 or ripng.

med-value: Applies the MED value to redistributed routes. The value is in the range 0 to 4294967295. If not specified, the cost of the redistributed route is used as its MED in the IPv6 BGP routing domain.

route-policy-name: Name of a routing policy used to filter redistributed routes, a string of 1 to 19 characters.

Description

Use the import-route command to redistribute routes from another routing protocol.

Use the undo import-route command to remove the configuration.

By default, IPv6 BGP does not redistribute routes from any routing protocol.

The routes redistributed using the import-route command has the incomplete origin attribute.

Examples

# Redistribute routes from RIPng 1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] import-route ripng 1

ipv6-family

Syntax

ipv6-family

undo ipv6-family

View

BGP view

Default Level

2: System level

Parameters

None

Description

Use the ipv6-family command to enter IPv6 address family view.

Use the undo ipv6-family command to remove all configurations from the view.

IPv4 BGP unicast view is the default.

Examples

# Enter IPv6 address family view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6]

network (IPv6 address family view)

Syntax

network ipv6-address prefix-length [ short-cut | route-policy route-policy-name ]

undo network ipv6-address prefix-length [ short-cut ]

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-address: IPv6 address.

prefix-length: Prefix length of the address, in the range 0 to 128.

short-cut: If the keyword is specified for an EBGP route, the route will use the local routing management value rather than that of EBGP routes, so the preference of the route is reduced.

route-policy-name: Name of a routing policy, a string of 1 to 19 characters.

Description

Use the network command to advertise a network to the IPv6 BGP routing table.

Use the undo network command to remove an entry from the IPv6 BGP routing table.

By default, no route is advertised.

Note that:

l          The route to be advertised must exist in the local IP routing table, and using a routing policy makes route management more flexible.

l          The route advertised to the BGP routing table using the network command has the IGP origin attribute.

Examples

# Advertise the network 2002::/16 into the IPv6 BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] network 2002:: 16

peer advertise-community (IPv6 address family view)

Syntax

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

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

View

IPv6 address family view

Default Level

2: System level

Parameters

group-name: Name of an IPv4 or IPv6 peer group, a string of 1 to 47 characters.

ipv4-address: IPv4 address of a peer.

ipv6-address: IPv6 address of a peer.

Description

Use the peer advertise-community command to advertise the community attribute to a peer/peer group.

Use the undo peer advertise-community command to remove the configuration.

By default, no community attribute is advertised to any peer group/peer.

Examples

# Advertise the community attribute to the peer 1:2::3:4.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 advertise-community

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

Syntax

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

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

View

IPv6 address family view

Default Level

2: System level

Parameters

group-name: Name of an IPv4 or IPv6 peer group, a string of 1 to 47 characters.

ipv4-address: IPv4 address of a peer.

ipv6-address: IPv6 address of a peer.

Description

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

Use the undo peer advertise-ext-community command to remove the configuration.

By default, no extended community attribute is advertised to a peer/peer group.

Examples

# Advertise the extended community attribute to the peer 1:2::3:4.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 advertise-ext-community

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

Syntax

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

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

View

IPv6 address family view

Default Level

2: System level

Parameters

group-name: Name of an IPv4 or IPv6 peer group, a string of 1 to 47 characters.

ipv4-address: IPv4 address of a peer.

ipv6-address: IPv6 address of a peer.

number: Specifies the number of times for which the local AS number can appear in routes from the peer/peer group, in the range 1 to 10. The default number is 1.

Description

Use the peer allow-as-loop command to configure IPv6 BGP to allow the local AS number to exist in the AS_PATH attribute of routes from a peer/peer group, and to configure the times for which it can appear.

Use the undo peer allow-as-loop command to disable the function.

The local AS number is not allowed to exist in the AS PATH attribute of routes by default.

Examples

# Configure the number of times for which the local AS number can appear in the AS PATH of routes from peer 1::1 as 2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1::1 allow-as-loop 2

peer as-number (IPv6 address family view)

Syntax

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

undo peer ipv6-group-name as-number

undo peer ipv6-address

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

as-number: AS number of the peer/peer group, in the range 1 to 65535.

Description

Use the peer as-number command to specify a peer/peer group with an AS number.

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

Use the undo peer command to delete a peer.

By default, no peer/peer group is specified.

Examples

# Specify peer group test in AS 200.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] group test external

[Sysname-bgp-af-ipv6] peer test as-number 200

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

Syntax

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

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

View

IPv6 address family view

Default Level

2: System level

Parameters

group-name: Name of an IPv4 or IPv6 peer group, a string of 1 to 47 characters.

ipv4-address: IPv4 address of a peer.

ipv6-address: IPv6 address of a peer.

as-path-acl-number: Number of an AS path ACL, in the range 1 to 256.

import: Filters incoming routes.

export: Filters outgoing routes.

Description

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

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

By default, no AS path list is specified for filtering.

Examples

# Specify the AS path ACL 3 to filter routes outgoing to the peer 1:2::3:4.

<Sysname> system-view

[Sysname] ip as-path 3 permit ^200

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 as-path-acl 3 export

peer capability-advertise route-refresh

Syntax

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

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

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

Description

Use the peer capability-advertise route-refresh command to enable IPv6 BGP route-refresh.

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

By default, route-refresh is enabled.

Examples

# Disable route-refresh of peer 1:2::3:4.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 as-number 100

[Sysname-bgp-af-ipv6] undo peer 1:2::3:4 capability-advertise route-refresh

peer connect-interface (IPv6 address family view)

Syntax

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

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

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

interface-type interface-number: Specifies the type and name of the interface.

Description

Use the peer connect-interface command to specify the source interface for establishing TCP connections to an IPv6 BGP peer or peer group.

Use the undo peer connect-interface command to restore the default.

By default, BGP uses the outbound interface of the best route to the IPv6 BGP peer/peer group as the source interface for establishing a TCP connection.

Note that:

To establish multiple BGP connections to a BGP router, you need to specify on the local router the respective source interfaces for establishing TCP connections to the peers on the peering BGP router; otherwise, the local BGP router may fail to establish TCP connections to the peers when using the outbound interfaces of the best routes as the source interfaces.

Examples

# Specify loopback 0 as the source interface for routing updates to peer 1:2::3:4.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 connect-interface loopback 0

peer default-route-advertise

Syntax

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

undo peer { group-name | ipv4-address | ipv6-address } default-route-advertise

View

IPv6 address family view

Default Level

2: System level

Parameters

group-name: Name of an IPv4 or IPv6 peer group, a string of 1 to 47 characters.

ipv4-address: IPv4 address of a peer.

ipv6-address: IPv6 address of a peer.

route-policy-name: Route-policy name, a string of 1 to 19 characters.

Description

Use the peer default-route-advertise command to advertise a default route to a peer/peer group.

Use the undo peer default-route-advertise command to disable advertising a default route.

By default, no default route is advertised to a peer/peer group.

Using this command does not require the default route available in the routing table. With this command used, the router sends the default route unconditionally to the peer/peer group with the next hop being itself.

Examples

# Advertise a default route to peer 1:2::3:4.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 default-route-advertise

peer description (IPv6 address family view)

Syntax

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

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

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

description-text: Description information for the peer/peer group, a string of 1 to 79 characters.

Description

Use the peer description command to configure the description information for a peer/peer group.

Use the undo peer description command to remove the description information of a peer/peer group.

By default, no description information is configured for a peer (group).

You need create a peer/peer group before configuring a description for it.

Examples

# Configure the description for the peer group test as ISP1.

<Sysname] system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] group test external

[Sysname-bgp-af-ipv6] peer test description ISP1

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

Syntax

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

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

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

hop-count: Maximum hop count, in the range 1 to 255. By default, the value is 64.

Description

Use the peer ebgp-max-hop command to allow establishing the EBGP connection to a peer/peer group indirectly connected.

Use the undo peer ebgp-max-hop command to remove the configuration.

By default, this feature is disabled.

You can use the argument hop-count to specify the maximum router hops of the EBGP connection.

Examples

# Allow establishing the EBGP connection with the peer group test on an indirectly connected network.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] group test external

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

peer fake-as (IPv6 address family view)

Syntax

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

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

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

as-number: Local autonomous system number, in the range 1 to 65535.

Description

Use the peer fake-as command to configure a fake local AS number for a peer or peer group.

Use the undo peer fake-as command to remove the configuration.

By default, no fake local AS number is configured for a peer or peer group.

Examples

# Configure a fake AS number of 200 for the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] group test external

[Sysname-bgp-af-ipv6] peer test fake-as 200

peer filter-policy (IPv6 address family view)

Syntax

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

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

View

IPv6 address family view

Default Level

2: System level

Parameters

group-name: Name of an IPv4 or IPv6 peer group, a string of 1 to 47 characters.

ipv4-address: IPv4 address of a peer.

ipv6-address: IPv6 address of a peer.

acl6-number: IPv6 ACL number, in the range 2000 to 3999.

import: Applies the filter-policy to routes received from the peer/peer group.

export: Applies the filter-policy to routes advertised to the peer/peer group.

Description

Use the peer filter-policy command to configure an ACL-based filter policy for a peer or peer group.

Use the undo peer filter-policy command to remove the configuration.

By default, no ACL-based filter policy is configured for a peer or peer group.

Examples

# Apply the ACL6 2000 to filter routes advertised to the peer 1:2::3:4.

<Sysname> system-view

[Sysname] acl ipv6 number 2000

[Sysname-acl6-basic-2000] rule permit source 2001:1:: 64

[Sysname-acl6-basic-2000] quit

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 filter-policy 2000 export

peer group (IPv6 address family view)

Syntax

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

undo peer ipv6-address group group-name

View

IPv6 address family view

Default Level

2: System level

Parameters

group-name: Name of an IPv4 or IPv6 peer group, a string of 1 to 47 characters.

ipv4-address: IPv4 address of a peer.

ipv6-address: IPv6 address of a peer.

as-number: Specifies the AS number of the peer/peer group, in the range 1 to 65535.

Description

Use the peer group command to add a peer to a configured peer group.

Use the undo peer group command to delete a specified peer from a peer group.

By default, the peer does not belong to any peer group.

Examples

# Create a peer group named test and add the peer 1:2::3:4 to the peer group.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] group test external

[Sysname-bgp-af-ipv6] peer 1:2::3:4 as-number 200

[Sysname-bgp-af-ipv6] peer 1:2::3:4 group test

peer ignore (IPv6 address family view)

Syntax

peer { ipv6-group-name | ipv6-address } ignore

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

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

Description

Use the peer ignore command to terminate the session to a peer or peer group.

Use the undo peer ignore command to remove the configuration.

By default, a router can establish sessions with a peer or peer group.

After the peer ignore command is executed, the system terminates the active session(s) with the specified peer or peer group and clears all the related routing information. For a peer group, this means all the sessions with the peer group will be tore down.

Examples

# Terminate the session with peer 1:2::3:4.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 ignore

peer ipv6-prefix

Syntax

peer { group-name | ipv4-address | ipv6-address } ipv6-prefix ipv6-prefix-name { import | export }

undo peer { group-name | ipv4-address | ipv6-address } ipv6-prefix { import | export }

View

IPv6 address family view

Default Level

2: System level

Parameters

group-name: Name of an IPv4 or IPv6 peer group, a string of 1 to 47 characters.

ipv4-address: IPv4 address of a peer.

ipv6-address: IPv6 address of a peer.

ipv6-prefix-name: IPv6 prefix list name, a string of 1 to 19 characters.

import: Applies the filtering policy to routes received from the specified peer/peer group.

export: Applies the filtering policy to routes advertised to the specified peer/peer group.

Description

Use the peer ipv6-prefix command to specify an IPv6 prefix list to filter routes incoming from or outgoing to a peer or peer group.

Use the undo peer ipv6-prefix command to remove the configuration.

By default, no IPv6 prefix list is specified for filtering.

Examples

# Reference the IPv6 prefix list list 1 to filter routes outgoing to peer 1:2::3:4.

<Sysname> system-view

[Sysname] ip ipv6-prefix list1 permit 2002:: 64

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 ipv6-prefix list1 export

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

Syntax

peer { group-name | ipv4-address | ipv6-address } keep-all-routes

undo peer { group-name | ipv4-address | ipv6-address } keep-all-routes

View

IPv6 address family view

Default Level

2: System level

Parameters

group-name: Name of an IPv4 or IPv6 peer group, a string of 1 to 47 characters.

ipv4-address: IPv4 address of a peer.

ipv6-address: IPv6 address of a peer.

Description

Use the peer keep-all-routes command to save the original routing information from a peer or peer group, including even routes that failed to pass the inbound policy.

Use the undo peer keep-all-routes command to disable this function.

By default, the function is not enabled.

Examples

# Save routing information from peer 1:2::3:4.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 keep-all-routes

peer log-change (IPv6 address family view)

Syntax

peer { ipv6-group-name | ipv6-address } log-change

undo peer { ipv6-group-name | ipv6-address } log-change

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

Description

Use the peer log-change command to enable the logging of session state and event information of a specified peer or peer group.

Use the undo peer log-change command to remove the configuration.

The logging is enabled by default.

Examples

# Enable the logging of session state and event information of peer 1:2::3:4.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 log-change

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

Syntax

peer { ipv6-group-name | ipv6-address } next-hop-local

undo peer { ipv6-group-name | ipv6-address } next-hop-local

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

Description

Use the peer next-hop-local command to configure the next hop of routes advertised to a peer/peer group as the local router.

Use the undo peer next-hop-local command to restore the default.

By default, the system sets the next hop of routes advertised to an EBGP peer/peer group to the local router, but does not set for routes outgoing to an IBGP peer/peer group.

Examples

# Set the next hop of routes advertised to IBGP peer group test to the router itself.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] group test internal

[Sysname-bgp-af-ipv6] peer test next-hop-local

peer preferred-value (IPv6 address family view)

Syntax

peer { ipv6-group-name | ipv6-address } preferred-value value

undo peer { ipv6-group-name | ipv6-address } preferred-value

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

value: Preferred value, in the range 0 to 65535.

Description

Use the peer preferred-value command to assign a preferred value to routes received from a peer or peer group.

Use the undo peer preferred-value command to restore the default.

By default, routes received from a peer or peer group have a preferred value of 0.

Routes learned from peers each have an initial preferred value. Among multiple routes to the same destination, the route with the biggest value is selected.

Note that:

If you both reference a routing policy and use the command peer { ipv6-group-name | ipv6-address } preferred-value value to set a preferred value for routes from a peer, the routing policy sets a non-zero preferred value for routes matching it. Other routes not matching the routing policy uses the value set with the command. If the preferred value in the routing policy is zero, the routes matching it will also use the value set with the command. For information about using a routing policy to set a preferred value, refer to the command peer { group-name | ipv4-address | ipv6-address } route-policy route-policy-name { import | export } in this document, and the command apply preferred-value preferred-value in Routing Policy Commands of the IP Routing Volume.

Examples

# Configure the preferred value as 50 for routes from peer 1:2::3:4.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 preferred-value 50

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

Syntax

peer { ipv6-group-name | ipv6-address } public-as-only

undo peer { ipv6-group-name | ipv6-address } public-as-only

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

Description

Use the peer public-as-only command to configure IPv6 BGP updates to a peer/peer group to not carry private AS numbers.

Use the undo peer public-as-only command to allow IPv6 BGP updates to a peer/peer group to carry private AS numbers.

By default, BGP updates carry the private AS number.

The command does not take effect if the BGP update has both the public AS number and private AS number. The range of private AS number is from 64512 to 65535.

Examples

# Configure BGP updates sent to the peer 1:2::3:4 to not carry private AS numbers.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 public-as-only

peer reflect-client (IPv6 address family view)

Syntax

peer { group-name | ipv4-address | ipv6-address } reflect-client

undo peer { group-name | ipv4-address | ipv6-address } reflect-client

View

IPv6 address family view

Default Level

2: System level

Parameters

group-name: Name of an IPv4 or IPv6 peer group, a string of 1 to 47 characters.

ipv4-address: IPv4 address of a peer.

ipv6-address: IPv6 address of a peer.

Description

Use the peer reflect-client command to configure the router as a route reflector and specify a peer/peer group as a client.

Use the undo peer reflect-client command to remove the configuration.

By default, neither route reflector nor client is configured.

Related commands: reflect between-clients, reflector cluster-id.

Examples

# Configure the local device as a route reflector and specify the peer group test as a client.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] group test

[Sysname-bgp-af-ipv6] peer test reflect-client

peer route-limit (IPv6 address family view)

Syntax

peer { group-name | ipv4-address | ipv6-address } route-limit prefix-number [ { alert-only | reconnect reconnect-time } | percentage ] *

undo peer { group-name | ipv4-address | ipv6-address } route-limit

View

IPv6 address family view

Default Level

2: System level

Parameters

group-name: Name of an IPv4 or IPv6 peer group, a string of 1 to 47 characters.

ipv4-address: IPv4 address of a peer.

ipv6-address: IPv6 address of a peer.

prefix number: Specifies the upper limit of prefixes that can be received from the peer or peer group. The limit varies with devices.. When the received prefixes from the peer/peer group reach the specified upper limit, the router will disconnect from the peer/peer group.

alert-only: When the received prefixes from the peer/peer group reach the specified upper limit, the router will display alarm messages rather than disconnect from the peer/peer group.

reconnect-time: Interval for the router to reconnect to the peer/peer group. The argument has no default. It ranges from 1 to 65535 seconds.

percentage: Specifies a percentage value. If the percentage of received routes to the upper limit reaches the value, the router will generate alarm messages. The default is 75. The value is in the range 1 to 100.

Description

Use the peer route-limit command to set the maximum number of prefixes that can be received from a peer/peer group.

Use the undo peer route-limit command to restore the default.

By default, the router has no limit on prefixes from a peer/peer group.

The router will end the peer relation when the number of address prefixes received for the peer exceeds the limit.

Examples

# Set the number of prefixes allowed to receive from the peer 1:2::3:4 to 100.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 route-limit 100

peer route-policy (IPv6 address family view)

Syntax

peer { group-name | ipv4-address | ipv6-address } route-policy route-policy-name { import | export }

undo peer { group-name | ipv4-address | ipv6-address } route-policy route-policy-name { import | export }

View

IPv6 address family view

Default Level

2: System level

Parameters

group-name: Name of an IPv4 or IPv6 peer group, a string of 1 to 47 characters.

ipv4-address: IPv4 address of a peer.

ipv6-address: IPv6 address of a peer.

route-policy-name: Specifies route-policy name, a string of 1 to 19 characters.

import: Applies the routing policy to routes from the peer (group).

export: Applies the routing policy to routes sent to the peer (group).

Description

Use the peer route-policy command to apply a routing policy to routes incoming from or outgoing to a peer or peer group.

Use the undo peer route-policy command to remove the configuration.

By default, no routing policy is specified for the peer (group).

Use of the peer route-policy command does not apply the if-match interface clause defined in the routing policy. Refer to Routing Policy Commands in the IP Routing Volume for related information.

Examples

# Apply the routing policy test-policy to routes received from the peer group test.

<Sysname> system-view

[Sysname] route-policy test-policy permit node 10

[Sysname-route-policy] if-match cost 10

[Sysname-route-policy] apply cost 65535

[Sysname-route-policy] quit

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] group test external

[Sysname-bgp-af-ipv6] peer test route-policy test-policy import

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

Syntax

peer { ipv6-group-name | ipv6-address } route-update-interval interval

undo peer { ipv6-group-name | ipv6-address } route-update-interval

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

interval: Specifies the minimum interval for sending the same update to a peer (group) from 5 to 600 seconds.

Description

Use the peer route-update-interval command to specify the interval for sending the same update to a peer/peer group.

Use the undo peer route-update-interval command to restore the default.

By default, the interval is 15 seconds for the IBGP peer, and 30 seconds for the EBGP peer.

Examples

# Specify the interval for sending the same update to the peer 1:2::3:4 as 10 seconds.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 as-number 100

[Sysname-bgp-af-ipv6] peer 1:2::3:4 route-update-interval 10

peer substitute-as (IPv6 address family view)

Syntax

peer { ipv6-group-name | ipv6-address } substitute-as

undo peer { ipv6-group-name | ipv6-address } substitute-as

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

Description

Use the peer substitute-as command to substitute the local AS number for the AS number of a peer/peer group in the AS_PATH attribute.

Use the undo peer substitute-as command to remove the configuration.

The substitution is not configured by default.

Examples

# Substitute the local AS number for the AS number of peer 1:2::3:4.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] peer 1:2::3:4 substitute-as

peer timer (IPv6 address family view)

Syntax

peer { ipv6-group-name | ipv6-address } timer keepalive keepalive hold holdtime

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

View

IPv6 address family view

Default Level

2: System level

Parameters

ipv6-group-name: Name of a peer group, a string of 1 to 47 characters.

ipv6-address: IPv6 address of a peer.

keepalive: Specifies the keepalive interval in seconds, ranging from 1 to 21845.

holdtime: Specifies the holdtime in seconds, ranging from 3 to 65535.

Description

Use the peer timer command to configure keepalive interval and holdtime interval for a peer or peer group.

Use the undo peer timer command to restore the default.

keepalive interval defaults to 60 seconds, and holdtime interval defaults to 180 seconds

Note that:

l          The timer configured with this command is preferred to the timer configured with the timer command.

l          The holdtime interval must be at least three times the keepalive interval.

Related commands: timer.

Examples

# Configure the keepalive interval and holdtime interval for the peer group test as 60 seconds and 180 seconds.

<Sysname] system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] group test external

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

preference (IPv6 address family view)

Syntax

preference { external-preference internal-preference local-preference | route-policy route-policy-name }

undo preference

View

IPv6 address family view

Default Level

2: System level

Parameters

external-preference: Preference of EBGP route learned from an EBGP peer, in the range 1 to 255.

internal-preference: Preference of IBGP route learned from an IBGP peer, in the range 1 to 255.

local-preference: Preference of IPv6 BGP local route, in the range 1 to 255.

route-policy-name: Routing policy name, a string of 1 to 19 characters. The routing policy can set a preference for routes passing it. The default value applies to the routes filtered out.

Description

Use the preference command to configure preferences for EBGP, IBGP, and local routes.

Use the undo preference command to restore the default.

The bigger the preference value is, the lower the preference is. The default values of external-preference, internal-preference and local-preference are 255, 255 and 130 respectively.

Examples

# Configure preferences for EBGP, IBGP, and local routes as 20, 20 and 200.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] preference 20 20 200

reflect between-clients (IPv6 address family view)

Syntax

reflect between-clients

undo reflect between-clients

View

IPv6 address family view

Default Level

2: System level

Parameters

None

Description

Use the reflect between-clients command to enable route reflection between clients.

Use the undo reflect between-clients command to disable this function.

By default, route reflection between clients is enabled.

After a route reflector is configured, it reflects routes between clients. If the clients are fully meshed, it is recommended to disable route reflection on the route reflector to reduce costs.

Related commands: reflector cluster-id, peer reflect-client.

Examples

# Enable route reflection between clients.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] reflect between-clients

reflector cluster-id (IPv6 address family view)

Syntax

reflector cluster-id cluster-id

undo reflector cluster-id

View

IPv6 address family view

Default Level

2: System level

Parameters

cluster-id: Specifies the cluster ID of the route reflector, an integer from 1 to 4294967295 (the system translates it into an IPv4 address) or an IPv4 address.

Description

Use the reflector cluster-id command to configure the cluster ID of the route reflector.

Use the undo reflector cluster-id command to remove the configured cluster ID.

By default, a route reflector uses its router ID as the cluster ID.

Usually, there is only one route reflector in a cluster, so the router ID of the route reflector identifies the cluster. If multiple route reflectors are configured to improve the stability of the network, you should use this command to configure the identical cluster ID for all the reflectors to avoid routing loops.

Related commands: reflect between-clients, peer reflect-client.

Examples

# Set 50 as the cluster ID for the route reflector, which is one of multiple route reflectors in the cluster.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] reflector cluster-id 50

refresh bgp ipv6

Syntax

refresh bgp ipv6 { ipv4-address | ipv6-address | all | external | group group-name | internal } { export | import }

View

User view

Default Level

1: Monitor level

Parameters

ipv4-address: Soft-resets the connection with an IPv4 BGP peer.

ipv6-address: Soft-resets the connection with an IPv6 BGP peer.

all: Soft-resets all IPv6 BGP connections.

external: Soft-resets EBGP connections.

group ipv6-group-name: Soft-resets connections with a peer group. The name of the peer group is a string of 1 to 47 characters.

internal: Soft-resets IBGP connections.

export: Performs soft reset in outbound direction.

import: Performs soft reset in inbound direction.

Description

Use the refresh bgp ipv6 command to soft reset specified IPv4/IPv6 BGP connections. With this feature, you can refresh the IPv4/IPv6 BGP routing table and apply a new available policy without tearing down BGP connections.

To perform IPv4/IPv6 BGP soft reset, all routers in the network should support route-refresh. If a router not supporting route refresh exists in the network, you need to use the peer keep-all-routes command on the local router to save all route updates before performing soft reset.

Examples

# Soft reset inbound IPv6 BGP connections.

<Sysname> refresh bgp ipv6 all import

reset bgp ipv6

Syntax

reset bgp ipv6 { as-number | ipv4-address | ipv6-address [ flap-info ] | all | group group-name | external | internal }

View

User view

Default Level

1: Monitor level

Parameters

as-number: Resets the IPv6 BGP connections to peers in the specified AS.

ipv4-address: Resets the connection to the specified IPv4 BGP peer.

ipv6-address: Resets the connection to the specified IPv6 BGP peer.

flap-info: Clears the history information of routing flaps.

all: Resets all IPv6 BGP connections.

group group-name: Resets the connections to the specified IPv6 BGP peer group.

external: Resets all the EBGP connections.

internal: Resets all the IBGP connections.

Description

Use the reset bgp ipv6 command to reset specified IPv4/IPv6 BGP connections.

Examples

# Reset all the IPv6 BGP connections.

<Sysname> reset bgp ipv6 all

reset bgp ipv6 dampening

Syntax

reset bgp ipv6 dampening [ ipv6-address prefix-length ]

View

User view

Default Level

1: Monitor level

Parameters

ipv6-address: IPv6 address

prefix-length: Prefix length of the address, in the range 0 to 128.

Description

Use the reset bgp ipv6 dampening command to clear dampened IPv6 BGP route information and release suppressed routes.

If no ipv6-address prefix-length is specified, all dampened IPv6 BGP route information will be cleared.

Examples

# Clear the dampened information of routes to 2345::/64 and release suppressed routes.

<Sysname> reset bgp ipv6 dampening 2345:: 64

reset bgp ipv6 flap-info

Syntax

reset bgp ipv6 flap-info [ ipv6-address/prefix-length | regexp as-path-regexp | as-path-acl as-path-acl-number ]

View

User view

Default Level

1: Monitor level

Parameters

ipv6-address: Clears the flap statistics for the specified IPv6 address.

prefix-length: Prefix length of the address, in the range 1 to 128.

as-path-regexp: Clears the flap statistics for routes matching the AS path regular expression.

as-path-acl-number: Clears the flap statistics for routes matching the AS path ACL. The number is in the range 1 to 256.

Description

Use the reset bgp ipv6 flap-info command to clear IPv6 routing flap statistics.

If no parameters are specified, the flap statistics of all the routes will be cleared

Examples

# Clear the flap statistics of the routes matching AS path ACL 10.

<Sysname> system-view

[Sysname] ip as-path 10 permit ^100.*200$

[Sysname] quit

<Sysname> reset bgp ipv6 flap-info as-path-acl 10

router-id

Syntax

router-id router-id

undo router-id

View

BGP view

Default Level

2: System level

Parameters

router-id: Router ID in IP address format.

Description

Use the router-id command to specify a router ID for the router.

Use the undo router-id command to remove a router ID.

To run IPv6 BGP protocol, a router must have a router ID, an unsigned 32-bit integer and the unique ID of the router in the AS.

A router ID can be configured manually. If not, the system will select a router ID automatically from the current interfaces’ IPv4 addresses. The selection sequence is the highest IPv4 address of Loopback interfaces’ addresses, then the highest IPv4 address of physical interfaces’ addresses if no Loopback interfaces are configured.

Only when the interface with the router ID is removed or the manually configured router ID is removed, will the system select another Router ID. To improve network reliability, it is recommended to configure the IPv4 address of a loopback interface as the router ID.

Examples

# Specify the router ID of the router as 10.18.4.221.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] router-id 10.18.4.221

synchronization (IPv6 address family view)

Syntax

synchronization

undo synchronization

View

IPv6 address family view

Default Level

2: System level

Parameters

None

Description

Use the synchronization command to enable the synchronization between IPv6 BGP and IGP.

Use the undo synchronization command to disable the synchronization.

The feature is disabled by default.

With this feature enabled and when a non-BGP router is responsible for forwarding packets in an AS, IPv6 BGP speakers in the AS cannot advertise routing information to other ASs unless all routers in the AS know the latest routing information.

By default, upon receiving an IPv6 IBGP route, the BGP router only checks whether the next hop is reachable before advertisement. If synchronization is enabled, the IBGP route can be advertised to EBGP peers only when the route is also advertised by the IGP.

 

Currently, the system does not support synchronization. Therefore, the configuration of this command does not actually take effect.

 

Examples

# Enable the route synchronization between IPv6 BGP and IGP.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[Sysname-bgp-af-ipv6] synchronization

timer (IPv6 address family view)

Syntax

timer keepalive keepalive hold holdtime

undo timer

View

IPv6 address family view

Default Level

2: System level

Parameters

keepalive: Keepalive interval in seconds, ranging from 1 to 21845.

holdtime: Holdtime interval in seconds, ranging from 3 to 65535.

Description

Use the timer command to specify IPv6 BGP keepalive interval and holdtime interval.

Use the undo timer command to restore the default.

By default, the keepalive and holdtime intervals are 60s and 180s respectively.

Note that:

l          Timer configured using the peer timer command is preferred to the timer configured using the timer command.

l          The holdtime interval must be at least three times the keepalive interval.

l          The configured timer applies to all the IPv6 BGP peers. It becomes valid only after the corresponding IPv6 BGP connections are reset.

Related commands: peer timer.

Examples

# Configure keepalive interval and holdtime interval as 60 and 180 seconds.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv6-family

[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 Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网