07-IP Multicast Command Reference

HomeSupportResource CenterRoutersH3C SR8800 Router SeriesH3C SR8800 Router SeriesTechnical DocumentsReference GuidesCommand ReferencesH3C SR8800 Command Reference-Release3347-6W10307-IP Multicast Command Reference
08-MBGP Commands
Title Size Download
08-MBGP Commands 318.85 KB

Contents

MBGP configuration commands 1

aggregate (MBGP family view) 1

balance (MBGP address family view) 2

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

bestroute compare-med (MBGP address family view) 3

bestroute med-confederation (MBGP address family view) 4

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

dampening (MBGP address family view) 5

default local-preference (MBGP address family view) 6

default med (MBGP address family view) 7

default-route imported (MBGP address family view) 7

display ip multicast routing-table· 8

display ip multicast routing-table ip-address 10

display bgp multicast group· 12

display bgp multicast network· 14

display bgp multicast paths 15

display bgp multicast peer 16

display bgp multicast peer received ip-prefix· 19

display bgp multicast routing-table· 20

display bgp multicast routing-table as-path-acl 21

display bgp multicast routing-table cidr 22

display bgp multicast routing-table community· 23

display bgp multicast routing-table community-list 24

display bgp multicast routing-table dampened· 25

display bgp multicast routing-table dampening parameter 26

display bgp multicast routing-table different-origin-as 27

display bgp multicast routing-table flap-info· 28

display bgp multicast routing-table peer 29

display bgp multicast routing-table regular-expression· 30

display bgp multicast routing-table statistic· 31

filter-policy export (MBGP address family view) 31

filter-policy import (MBGP address family view) 32

import-route (MBGP address family view) 33

ipv4-family multicast 33

network (MBGP address family view) 34

peer advertise-community (MBGP address family view) 35

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

peer allow-as-loop (MBGP address family view) 36

peer as-path-acl (MBGP address family view) 37

peer capability-advertise orf (MBGP address family view) 38

peer default-route-advertise (MBGP address family view) 39

peer enable (MBGP address family view) 40

peer filter-policy (MBGP address family view) 40

peer group (MBGP address family view) 41

peer ip-prefix (MBGP address family view) 42

peer keep-all-routes (MBGP address family view) 43

peer next-hop-local (MBGP address family view) 43

peer preferred-value (MBGP address family view) 44

peer public-as-only (MBGP address family view) 45

peer reflect-client (MBGP address family view) 46

peer route-limit (MBGP address family view) 46

peer route-policy (MBGP address family view) 47

preference (MBGP address family view) 48

reflect between-clients (MBGP address family view) 49

reflector cluster-id (MBGP address family view) 49

refresh bgp ipv4 multicast 50

reset bgp ipv4 multicast 51

reset bgp ipv4 multicast dampening· 51

reset bgp ipv4 multicast flap-info· 52

summary automatic (MBGP address family view) 52

 


MBGP configuration commands

 

 

NOTE:

For more information about routing policy commands, see Layer 3—IP Routing Command Reference.

 

aggregate (MBGP family view)

Syntax

aggregate ip-address { mask | mask-length } [ as-set | attribute-policy route-policy-name | detail-suppressed | origin-policy route-policy-name | suppress-policy route-policy-name ] *

undo aggregate ip-address { mask | mask-length }

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

ip-address: Summary address.

mask: Summary mask, in dotted decimal notation.

mask-length: Summary mask length, in the range 0 to 32.

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 case-sensitive string of 1 to 63 characters.

detail-suppressed: Advertises the summary route only.

suppress-policy route-policy-name: Suppresses specific routes defined in the routing policy. The routing policy name is a case-sensitive string of 1 to 63 characters.

origin-policy route-policy-name: References the routing policy to determine routes for summarization. The routing policy name is a case-sensitive string of 1 to 63 characters.

The keywords of the command are described as follows:

Table 1 Functions of the keywords

Keywords

Function

as-set

Used to create a summary route, whose AS path contains the AS path information of 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 flaps.

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 satisfying 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 the aggregate command to create a summary route in the IPv4 MBGP routing table.

Use the undo aggregate command to remove a summary route.

By default, no summary route is configured.

Examples                                                                                                                                                

# In IPv4 MBGP address family view, create a summary of 192.213.0.0/16 in the IPv4 MBGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] aggregate 10.40.0.0 255.255.0.0

balance (MBGP address family view)

Syntax

balance number

undo balance

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

number: Number of MBGP routes for load balancing, in the range 1 to 8. When it is set to 1, load balancing is disabled.

Description

Use the balance command to configure the number of MBGP routes for load balancing.

Use the undo balance command to restore the default.

By default, no load balancing is configured.

Unlike IGP, MBGP has no explicit metric for making load balancing decision. Instead, it implements load balancing by using route selection rules.

Related commands: display ip multicast routing-table.

Examples

# In IPv4 MBGP address family view, set the number of routes for BGP load balancing to 2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] balance 2

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

Syntax

bestroute as-path-neglect

undo bestroute as-path-neglect

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

None

Description

Use the bestroute as-path-neglect command to configure MBGP not to consider the AS_PATH during best route selection.

Use the undo bestroute as-path-neglect command to restore the default.

By default, MBGP considers AS_PATH during best route selection.

Examples

# In IPv4 MBGP address family view, configure BGP to ignore the AS_PATH during best route selection.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

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

bestroute compare-med (MBGP address family view)

Syntax

bestroute compare-med

undo bestroute compare-med

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

None

Description

Use the bestroute compare-med command to enable the comparison of the multi-exit discrimination (MED) for paths from each AS during best route selection.

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

The comparison is not enabled by default.

Examples

# In IPv4 MBGP address family view, enable the comparison of the MED for paths from each AS during best route selection.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

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

bestroute med-confederation (MBGP address family view)

Syntax

bestroute med-confederation

undo bestroute med-confederation

View

IPv4 MBGP 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 during best route selection.

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

The comparison is not enabled by default.

The system only compares MED values for paths from peers within the confederation. Paths from external ASs are advertised throughout the confederation without MED comparison.

Examples

# In IPv4 MBGP address family view, enable the comparison of the MED for paths from peers within the confederation.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

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

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

Syntax

compare-different-as-med

undo compare-different-as-med

View

IPv4 MBGP 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 several paths to one destination are available, the path with the smallest MED is selected.

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

Examples

# In IPv4 MBGP address family view, enable the comparison of the MED for paths from peers in different ASs.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

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

dampening (MBGP address family view)

Syntax

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

undo dampening

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

half-life-reachable: Specifies a half-life for active routes from 1 to 45 minutes. By default, the value is 15 minutes.

half-life-unreachable: Specifies a half-life for suppressed routes from 1 to 45 minutes. By default, the value is 15 minutes.

reuse: Specifies a reuse threshold value for suppressed routes from 1 to 20000. A suppressed route whose penalty value decreases under the value is reused. By default, the reuse value is 750.

suppress: Specifies a suppression threshold from 1 to 20000. The route with a penalty value higher than the threshold is suppressed. The default value is 2000.

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

route-policy-name: Routing policy name, a case-sensitive string of 1 to 63 characters.

Description

Use the dampening command to configure IPv4 MBGP route dampening.

Use the undo dampening command to disable route dampening.

By default, no IPv4 MBGP route dampening is configured.

The command dampens only EBGP routes rather than IBGP routes.

Examples

# In IPv4 MBGP address family view, configure IPv4 MBGP route dampening.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] dampening 15 15 1000 2000 10000

default local-preference (MBGP address family view)

Syntax

default local-preference value

undo default local-preference

View

IPv4 MBGP 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.

By default, the default local preference is 100.

Using this command can affect MBGP route selection.

Examples

# In IPv4 MBGP address family view, set the default local preference to 180.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

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

default med (MBGP address family view)

Syntax

default med med-value

undo default med

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

med-value: Default 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.

Multi-exit discriminator (MED) is an external metric for routes. 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 that is running MBGP obtains several routes with an identical destination but 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 selects the route with the smallest MED as the best external route.

Examples

# In IPv4 MBGP address family view, configure the default MED as 25.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

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

default-route imported (MBGP address family view)

Syntax

default-route imported

undo default-route imported

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

None

Description

Use the default-route imported command to allow default route redistribution into the MBGP routing table.

Use the undo default-route imported command to restore the default.

By default, default route redistribution is not allowed.

To redistribute default routes of other protocols into the MBGP routing table, you must use the default-route imported command together with the import-route command.

Related commands: import-route.

Examples

# In IPv4 MBGP address family view, allow default route redistribution from OSPF into MBGP.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

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

[Sysname-bgp-af-mul] import-route ospf 1

display ip multicast routing-table

Syntax

display ip multicast routing-table [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: Monitor level

Parameters

verbose: Displays the detailed information of the multicast routing table, including both inactive and active multicast routes. Without the keyword, the command displays brief information about only the active MBGP routes.

|: 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 the display ip multicast routing-table command to display the multicast BGP routing table.

All the active MBGP routes in the MBGP routing table are used for RPF check, but inactive MBGP routes are not.

Examples

# Display brief information about the active routes in the multicast BGP routing table.

<Sysname> display ip multicast routing-table

Routing Tables: Public

         Destinations : 6        Routes : 6

 

Destination/Mask    Proto  Pre  Cost         NextHop        Interface

 

2.2.2.0/24          Direct 0    0            2.2.2.1        GE3/1/1

2.2.2.1/32          Direct 0    0            127.0.0.1      InLoop0

127.0.0.0/8         Direct 0    0            127.0.0.1      InLoop0

127.0.0.1/32        Direct 0    0            127.0.0.1      InLoop0

192.168.80.0/24     Direct 0    0            192.168.80.10  GE3/1/1

192.168.80.10/32    Direct 0    0            127.0.0.1      InLoop0

Table 2 Output description

Field

Description

Destinations

Number of destinations

Routes

Number of routes

Destination/Mask

Destination address/Mask length

Proto

Routing protocol that discovered the route

Pre

Route preference

Cost

Route cost

Nexthop

Next hop of the route

Interface

Outgoing interface to reach the destination

 

# Display the detailed information of the multicast routing table.

<Sysname> display ip multicast routing-table verbose

Routing Table : Public

        Destinations : 2        Routes : 2

 

Destination: 192.168.80.0/24

     Protocol: Direct          Process ID: 0

   Preference: 0                     Cost: 0

IpPrecedence:                    QosLcId: 

      NextHop: 192.168.80.10    Interface: GigabitEthernet3/1/1

    BkNextHop: 0.0.0.0        BkInterface:

  RelyNextHop: 0.0.0.0          Neighbour: 0.0.0.0

    Tunnel ID: 0x0                  Label: NULL

        State: Active Adv             Age: 00h14m49s

          Tag: 0

 

Destination: 192.168.80.10/32

     Protocol: Direct          Process ID: 0

   Preference: 0                     Cost: 0

IpPrecedence:                    QosLcId: 

      NextHop: 127.0.0.1        Interface: InLoopBack0

    BkNextHop: 0.0.0.0        BkInterface:

  RelyNextHop: 0.0.0.0          Neighbour: 0.0.0.0

    Tunnel ID: 0x0                  Label: NULL

        State: Active NoAdv           Age: 00h14m49s

          Tag: 0

Table 3 Output description

Field

Description

Destination

Destination/mask.

Protocol

Routing protocol that discovered the route.

Process ID

Process ID.

Preference

Route preference.

Cost

Route cost.

IpPrecedence

IP precedence.

QosLcId

QoS local ID.

NextHop

Nexthop of the route.

Interface

Outgoing interface to reach the destination.

BkNextHop

Backup next hop.

BkInterface

Backup outgoing interface.

RelyNextHop

Recursive next hop.

Neighbour

Neighbor address.

Tunnel ID

Tunnel ID.

Label

Label.

State

Route state, including:

·       Active.

·       Inactive.

·       Adv—Can be advertised.

·       NoAdv—Cannot be advertised.

·       GotQ—Route recursion succeeded.

·       WaitQ—Route recursion has not succeeded yet.

Age

Age of the route, in the sequence of hour, minute, and second from left to right.

Tag

Route tag.

 

display ip multicast routing-table ip-address

Syntax

display ip multicast routing-table ip-address [mask-length |mask ] [ longer-match ] [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: Monitor level

Parameters

ip-address: Destination IP address, in dotted decimal format.

mask-length: IP address mask length in the range 0 to 32.

mask: IP address mask in dotted decimal format.

longer-match: Displays the route with the longest mask.

verbose: Displays detailed information about both active and inactive routes. With this argument absent, the command displays only brief information about active routes.

|: 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 the display ip multicast routing-table ip-address command to display information about multicast routes to a specified destination address.

Executing the command with different parameters yields different outputs:

display ip multicast routing-table ip-address

It displays all multicast routes falling into the natural network of the IP address. If no such multicast routes are available, it displays only the longest matched active multicast route.

display ip multicast routing-table ip-address mask

It displays the multicast route exactly matching the IP address and mask.

Examples

# Display brief information about all multicast routes falling into the natural network of the IP address (A multicast route is available).

<Sysname> display ip multicast routing-table 169.0.0.0

Routing Table : Public

Summary Count : 1

 

Destination/Mask    Proto  Pre  Cost  NextHop         Interface

169.0.0.0/16        Direct 0    0     127.0.0.1       InLoop0

# Display brief information about the longest matched active multicast route (No multicast route falls into the natural network of the IP address).

<Sysname> display ip multicast routing-table 169.253.0.0

Routing Table : Public

Summary Count : 1

 

Destination/Mask    Proto  Pre  Cost  NextHop         Interface

169.0.0.0/16        Direct 0    0     127.0.0.1       InLoop0

# Display detailed information about multicast routes falling into the natural network of the IP address (A multicast route is available).

<Sysname> display ip multicast routing-table 2.2.2.1 verbose

Routing Table : Public

Summary Count : 1

 

Destination: 2.2.2.1/32

     Protocol: Direct                 Process ID: 0

   Preference: 0                            Cost: 0

IpPrecedence:                           QosLcId: 

      NextHop: 127.0.0.1               Interface: InLoopBack0

    BkNextHop: 0.0.0.0               BkInterface:

  RelyNextHop: 0.0.0.0                 Neighbour: 0.0.0.0

    Tunnel ID: 0x0                         Label: NULL

        State: Active NoAdv                  Age: 05h38m46s

          Tag: 0

# Display detailed information about the longest matched active multicast route (No multicast route falls into the natural network of the IP address).

<Sysname> display ip multicast routing-table 169.253.2.1 verbose

Routing Table : Public

Summary Count : 1

 

Destination: 169.0.0.0/8

     Protocol: Direct          Process ID: 0

   Preference: 0                     Cost: 0

IpPrecedence:                    QosLcId: 

      NextHop: 169.1.1.1        Interface: GigabitEthernet3/1/1

BkNextHop: 0.0.0.0        BkInterface:

RelyNextHop: 0.0.0.0          Neighbour: 0.0.0.0

    Tunnel ID: 0x0                  Label: NULL

        State: Active Adv             Age: 00h00m32s

          Tag: 0

display bgp multicast group

Syntax

display bgp multicast group [ group-name ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: Monitor level

Parameters

group-name: MBGP 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 the display bgp multicast group command to display IPv4 MBGP peer group information.

Examples

# Display the information of the IPv4 MBGP peer group aaa.

<Sysname> display bgp multicast group aaa

 

 BGP peer-group is aaa

 Remote AS 200

 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                 AS  MsgRcvd  MsgSent  OutQ PrefRcv Up/Down    State

 

  2.2.2.1              200          0        0     0      0 00:00:35 Active

Table 4 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: IBGP or EBGP.

Maximum allowed prefix number

Maximum allowed prefix number.

Threshold

Percentage of received prefixes from the peer group to maximum prefixes allowed to receive from the peer group; If the percentage is reached, the system generates alarm messages.

Configured hold timer value

Holdtime interval.

Keepalive timer value

Keepalive interval.

Minimum time between advertisement runs

Minimum interval for route advertisement.

Peer Preferred Value

Preferred value specified for the routes from the peer.

No routing policy is configured

No routing policy is configured.

Members

Detailed information of the members in the peer group.

Peer

IPv4 address of the peer.

AS

AS number of the peer.

MsgRcvd

Number of messages received.

MsgSent

Number of messages sent.

OutQ

Number of messages to be sent.

PrefRcv

Number of prefixes received.

Up/Down

Time elapsed.

State

State machine of the peer.

 

display bgp multicast network

Syntax

display bgp multicast network [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: 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 the display bgp multicast network command to display IPv4 MBGP routing information advertised with the network command.

Examples

# Display IPv4 MBGP routing information advertised with the network command.

<Sysname> display bgp multicast network

  BGP Local Router ID is 10.1.4.2.

  Local AS Number is 400.

  Network          Mask            Route-policy        Short-cut

 

  100.1.2.0        255.255.255.0

  100.1.1.0        255.255.255.0                       Short-cut

Table 5 Output description

Field

Description

BGP Local Router ID

BGP Local Router ID

Local AS Number

Local AS Number

Network

Network address

Mask

Mask

Route-policy

Routing policy referenced

Short-cut

Short-cut route

 

display bgp multicast paths

Syntax

display bgp multicast paths [ as-regular-expression | | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: Monitor level

Parameters

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

|: 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 the display bgp multicast paths command to display the AS path information of IPv4 MBGP routes.

Examples

# Display the AS path information of IPv4 MBGP routes.

<Sysname> display bgp multicast paths ^200

 

    Address       Hash    Refcount  MED         Path/Origin

    0x5917100     11      1                     200 300i  

Table 6 Output description

Field

Description

Address

Route address in the local database, in dotted hexadecimal notation.

Hash

Hash index.

Refcount

Count of routes that reference the path.

MED

MED of the path.

Path

AS_PATH attribute of the path, recording the ASs it has passed to avoid routing loops.

Origin

Origin attribute of the path:

·       i—Indicates that the route is interior to the AS. Summary routes and routes injected through the network command are considered IGP routes.

·       e—Indicates that the route is learned from the Exterior Gateway Protocol (EGP).

·       ?—Indicates that the origin of the route is unknown. Routes redistributed from other routing protocols have this origin attribute.

 

display bgp multicast peer

Syntax

display bgp multicast peer [ [ ip-address ] verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: Monitor level

Parameters

ip-address: IP address of an IPv4 MBGP peer to be displayed, in dotted decimal notation.

verbose: Displays the detailed information of the peer/peer group.

|: 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 the display bgp multicast peer command to display IPv4 MBGP peer information.

Examples

# Display the detailed information of the IPv4 MBGP peer 10.110.25.20.

<Sysname> display bgp multicast peer 10.110.25.20 verbose

 

         Peer: 10.110.25.20 Local: 2.2.2.2

         Type: EBGP 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

         Port:  Local - 1029     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

         Address family IPv4 Unicast: advertised and received

         Address family IPv4 Multicast: advertised and received

 

 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

 BFD: Enabled

 

 Routing policy configured:

 No routing policy is configured

Table 7 Output description

Field

Description

Peer

IP address of the peer.

Local

Local router ID.

Type

Peer type.

BGP version

BGP version.

remote router ID

Router ID of the peer.

BGP current state

Current state of the peer.

BGP current event

Current event of the peer.

BGP last state

Previous state of the peer.

Port

TCP port numbers.

Configured: Active Hold Time: 180 sec   Keepalive Time: 60 sec

Local holdtime interval and keepalive interval.

Received: Active Hold Time

Remote holdtime interval.

Negotiated: Active Hold Time Keepalive Time:60 sec

Negotiated holdtime interval and keepalive interval.

Peer optional capabilities

Optional capabilities supported by the peer, including multiprotocol BGP extensions and route refresh.

Peer support bgp multi-protocol extended

The peer supports multiprotocol BGP extensions.

Peer support bgp route refresh capability

The peer supports route refresh.

Peer support bgp route AS4 capability

The peer supports 4-byte router IDs.

Address family IPv4 Unicast

Routes are advertised and received in IPv4 unicasts.

Received

Total numbers of received packets and updates.

Sent

Total numbers of sent packets and updates

Maximum allowed prefix number

Maximum allowed prefix number.

Threshold

Threshold value.

Minimum time between advertisement runs

Minimum route advertisement interval.

Optional capabilities

Optional capabilities enabled by the peer (displayed only after optional capabilities are configured).

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. (This field is displayed only after the ORF capability is enabled for the BGP peer.)

Local: both

The local BGP router supports both the ORF sending and receiving capabilities. (This field is displayed only after the ORF capability is enabled for the BGP peer.)

Negotiated: send

Negotiation result: The local BGP router can send Router-refresh messages carrying the ORF information, and the peer can receive route-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 route-refresh messages carrying the ORF information.

·       If both send and receive are displayed, the local BGP router and the peer can both send and receive route-refresh messages carrying the ORF information

·       This field is not displayed if neither the send nor the receive capability is supported.

·       This field is displayed only after the ORF capability is enabled for the BGP peer.

Peer Preferred Value

Preferred value specified for the routes from the peer.

BFD

Status of BGP (enabled/disabled).

Routing policy configured

Local routing policy.

 

display bgp multicast peer received ip-prefix

Syntax

display bgp multicast peer ip-address received ip-prefix [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

ip-address: IP 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 the display bgp multicast peer received ip-prefix command to display the prefix entries in the ORF information of the specified BGP peer.

Examples

# Display the prefix information received from the BGP peer 10.110.25.20.

<Sysname> display bgp multicast peer 10.110.25.20 received ip-prefix

ORF ip-prefix entries: 2

ge: greater-equal   le: less-equal

  Index  Rule   Prefix                 Ge    Le

  10     permit 111.111.111.0/24       26    32

  20     deny   2.1.1.0/24             26    32

Table 8 Output description

Field

Description

ORF ip-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 multicast routing-table

Syntax

display bgp multicast routing-table [ ip-address [ { mask | mask-length } [ longer-prefixes ] ] ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

ip-address: Destination IP address.

mask: Network mask, in dotted decimal notation.

mask-length: Mask length, in the range 0 to 32.

longer-prefixes: 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 the display bgp multicast routing-table command to display IPv4 MBGP routing information.

Examples

# Display the IPv4 MBGP routing table.

<Sysname> display bgp multicast routing-table

 

 Total Number of Routes: 1

 

 BGP Local router ID is 10.10.10.1

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

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

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

     Network            NextHop         MED        LocPrf     PrefVal Path/Ogn

 

 *>  40.40.40.0/24      20.20.20.1                            0       200 300i

Table 9 Output description

Field

Description

Total Number of Routes

Total number of Routes.

BGP Local router ID

BGP local router ID.

Status codes

Status codes, including:

·       * – 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, including:

·       i – IGP—Originated in the AS.

·       e – EGP—Learned through EGP.

·       ? – incomplete—Learned by some other means.

Network

Destination network address.

Next Hop

Next hop.

MED

Measurement value of the route.

LocPrf

Local preference value.

PrefVal

Preferred value of the route.

Path

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

Ogn

Origin attributes, including:

·       i—Indicates that the route is interior to the AS. Summary routes and the routes injected through the network command are considered IGP routes.

·       e—Indicates that the route is learned from the Exterior Gateway Protocol (EGP).

·       ?—Short for ”incomplete.” It indicates that the origin of the route is unknown and the route is learned by some other means. BGP marks routes redistributed from IGP as incomplete.

 

display bgp multicast routing-table as-path-acl

Syntax

display bgp multicast routing-table as-path-acl as-path-acl-number [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: Monitor level

Parameters

as-path-acl-number: Displays IPv4 MBGP routing information matching the AS path ACL, which is specified with a number from 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 the display bgp multicast routing-table as-path-acl command to display IPv4 MBGP routes matching an AS-path ACL.

Examples

# Display IPv4 MBGP routes matching AS path ACL 1.

<Sysname> display bgp multicast routing-table as-path-acl 1

 

 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            NextHop        MED        LocPrf      PrefVal Path/Ogn

 

*>   40.40.40.0/24      30.30.30.1     0                     0      300i 

For more information about the output, see Table 9.

display bgp multicast routing-table cidr

Syntax

display bgp multicast routing-table cidr [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: 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 the display bgp multicast routing-table cidr command to display IPv4 MBGP Classless Inter-Domain Routing (CIDR) routing information.

Examples

# Display IPv4 MBGP CIDR routing information.

<Sysname> display bgp multicast routing-table cidr

 

Total Number of Routes: 1

 

 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          NextHop         MED        LocPrf     PrefVal Path/Ogn

 

*>   40.40.40.0/24    30.30.30.1      0                     0       300i   

For more information about the output, see Table 9.

display bgp multicast routing-table community

Syntax

display bgp multicast 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

2: Monitor level

Parameters

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

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

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

no-export: Displays MBGP routes that cannot be advertised out the AS. If a confederation is configured, it displays routes that cannot be advertised out the confederation, but can be advertised to other sub ASs in the confederation.

no-export-subconfed: Displays MBGP routes that cannot be advertised out the AS or to other sub ASs in the confederation.

whole-match: Displays the MBGP routes exactly matching the specified community attributes.

|: 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 the display bgp multicast routing-table community command to display BGP routing information with the specified BGP community attribute.

Examples

# Display BGP routing information with the specified BGP community attribute.

<Sysname> display bgp multicast routing-table community 11:22

 

 BGP Local router ID is 10.10.10.1

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

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

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

 

     Network            NextHop         MED        LocPrf     PrefVal Path/Ogn

 

*>  10.10.10.0/24       0.0.0.0         0                     0       i

*>  40.40.40.0/24       20.20.20.1                            0       200 300i

For more information about the output, see Table 9.

display bgp multicast routing-table community-list

Syntax

display bgp multicast 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

2: Monitor level

Parameters

basic-community-list-number: Specifies a basic community-list number from 1 to 99.

adv-community-list-number: Specifies an advanced community-list number from 100 to 199.

comm-list-name: 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.

&<1-16>: Specifies the argument before it can be entered 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 the display bgp multicast routing-table community-list command to display IPv4 MBGP routing information matching the specified BGP community list.

Examples

# Display MBGP routing information matching the community list 100.

<Sysname> display bgp multicast routing-table community-list 100

 

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           NextHop       MED        LocPrf    PrefVal Path/Ogn

 *>  30.30.30.0/24     1.2.3.4       0                    0       i

 *>  40.40.40.0/24     1.2.3.4       0                    0       i

For more information about the output, see Table 9.

display bgp multicast routing-table dampened

Syntax

display bgp multicast routing-table dampened [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: 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 the display bgp multicast routing-table dampened command to display dampened IPv4 MBGP routes.

Examples

# Display dampened IPv4 MBGP routes.

<Sysname> display bgp multicast routing-table dampened

 

 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            From              Reuse     Path/Origin

 *d  77.0.0.0           12.1.1.1          00:29:20  100?

Table 10 Output description

Field

Description

From

IP address from which the route was received

Reuse

Reuse time of the route

 

For more information about the output, see Table 9.

display bgp multicast routing-table dampening parameter

Syntax

display bgp multicast routing-table dampening parameter [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: 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 the display bgp multicast routing-table dampening parameter command to display IPv4 MBGP route dampening parameters.

Related commands: dampening.

Examples

# Display IPv4 MBGP route dampening parameters.

<Sysname> display bgp multicast 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 11 Output description

Field

Description

Maximum Suppress Time

Maximum Suppress Time

Ceiling Value

Ceiling penalty value

Reuse Value

Reuse value

HalfLife Time

Half-life time of active routes

Suppress-Limit

Threshold at which a route is suppressed

 

display bgp multicast routing-table different-origin-as

Syntax

display bgp multicast routing-table different-origin-as [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: 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 the display bgp multicast routing-table different-origin-as command to display IPv4 MBGP routes originating from different autonomous systems.

Examples

# Display IPv4 MBGP routes originating from different autonomous systems.

<Sysname> display bgp multicast 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          NextHop        MED        LocPrf    PrefVal Path/Ogn

 

 *>  55.0.0.0         12.1.1.1       0                    0       100?

 *                    14.1.1.2       0                    0       300?

For more information about the output, see Table 9.

display bgp multicast routing-table flap-info

Syntax

display bgp multicast routing-table flap-info [ regular-expression as-regular-expression | [ as-path-acl as-path-acl-number | ip-address [ { mask | mask-length } [ longer-match ] ] ] [ | { begin | exclude | include } regular-expression ] ]

View

Any view

Default level

2: Monitor level

Parameters

as-regular-expression: Displays route flap information that matches the AS path regular expression.

as-path-acl-number: Displays route flap information matching the AS path ACL. The number is in the range 1 to 256.

ip-address: Destination IP address.

mask: Mask, in dotted decimal notation.

mask-length: Mask length, in the range 0 to 32.

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 the display bgp multicast routing-table flap-info command to display IPv4 MBGP route flap statistics. If no parameter is specified, this command displays all IPv4 MBGP route flap statistics.

Examples

# Display IPv4 MBGP route flap statistics.

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

 

 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        From        Flaps  Duration   Reuse     Path/Origin

 

 *>  55.0.0.0       12.1.1.1    2      00:00:16             100?

 *d  77.0.0.0       12.1.1.1    5      00:34:02   00:27:08  100?

Table 12 Output description

Field

Description

From

Source IP address of the route

Flaps

Number of routing flaps

Duration

Route flap duration

Reuse

Reuse time of the route

 

For more information about the output, see Table 9.

display bgp multicast routing-table peer

Syntax

display bgp multicast routing-table peer ip-address { advertised-routes | received-routes } [ network-address [ mask | mask-length ] | statistic ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: Monitor level

Parameters

ip-address: IP address of an IPv4 MBGP peer.

advertised-routes: Displays routing information advertised to the specified peer.

received-routes: Displays routing information received from the specified peer.

network-address: IP address of the destination network.

mask: Mask of the destination network, in dotted decimal notation.

mask-length: Mask length, in the range 0 to 32.

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 the display bgp multicast routing-table peer command to display IPv4 MBGP routing information advertised to or received from the specified IPv4 MBGP peer.

Related commands: display bgp multicast peer.

Examples

# Display IPv4 MBGP routing information advertised to the peer 20.20.20.1.

<Sysname> display bgp multicast routing-table peer 20.20.20.1 advertised-routes

 

 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           NextHop        MED        LocPrf    PrefVal Path/Ogn

 

 *>  30.30.30.0/24     0.0.0.0        0                    0       i

 *>  40.40.40.0/24     0.0.0.0        0                    0       i       

For more information about the output, see Table 9.

display bgp multicast routing-table regular-expression

Syntax

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

View

Any view

Default level

2: Monitor level

Parameters

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

Description

Use the display bgp multicast routing-table regular-expression command to display IPv4 MBGP routing information matching the specified AS path regular expression.

Examples

# Display IPv4 MBGP routing information matching AS path regular expression 300$.

<Sysname> display bgp multicast routing-table regular-expression 300$

 

 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           NextHop       MED        LocPrf    PrefVal Path/Ogn

 

 *>  40.40.40.0/24     30.30.30.1    0                    0       300i

For more information about the output, see Table 9.

display bgp multicast routing-table statistic

Syntax

display bgp multicast routing-table statistic [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: 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 the display bgp multicast routing-table statistic command to display IPv4 MBGP routing statistics.

Examples

# Display IPv4 MBGP routing statistics.

<Sysname> display bgp multicast routing-table statistic

 

 Total Number of Routes: 4

filter-policy export (MBGP address family view)

Syntax

filter-policy { acl-number | ip-prefix ip-prefix-name } export [ direct | isis process-id | ospf process-id | rip process-id | static ]

undo filter-policy export [ direct | isis process-id | ospf process-id | rip process-id | static ]

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

acl-number: Number of an ACL used to filter outgoing routing information, ranging from 2000 to 3999.

ip-prefix-name: Name of an IP prefix list used to filter outgoing routing information, a string of 1 to 19 characters.

direct: Filters direct routes.

isis process-id: Filters outgoing routes redistributed from an ISIS process. The process ID is in the range 1 to 65535.

ospf process-id: Filters outgoing routes redistributed from the OSPF process with an ID from 1 to 65535.

rip process-id: Filters outgoing routes redistributed from a RIP process. The process ID is in the range 1 to 65535.

static: Filters static routes.

Description

Use the filter-policy export command to configure the filtering of outgoing routes.

Use the undo filter-policy export command to remove the filtering.

By default, the filtering is not configured.

If no routing protocol is specified, all redistributed routes are filtered.

Examples

# In IPv4 MBGP address family view, reference ACL 2000 to filter all outgoing routes.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] filter-policy 2000 export

filter-policy import (MBGP address family view)

Syntax

filter-policy { acl-number | ip-prefix ip-prefix-name } import

undo filter-policy import

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

acl-number: Number of an ACL used to filter incoming routing information, ranging from 2000 to 3999.

ip-prefix-name: Name of an IP prefix list used to filter incoming routing information, a string of 1 to 19 characters.

Description

Use the filter-policy import command to configure the filtering of incoming routing information.

Use the undo filter-policy import command to disable the filtering.

By default, incoming routing information is not filtered.

Examples

# In IPv4 MBGP address family view, reference ACL 2000 to filter incoming routing information.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] filter-policy 2000 import

import-route (MBGP address family view)

Syntax

import-route protocol [ { process-id | all-processes } [ allow-direct | med med-value | route-policy route-policy-name ] * ]

undo import-route protocol [ process-id | all-processes ]

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

protocol: Redistributes routes from the routing protocol, which can be direct, isis, nat, ospf, rip, or static.

process-id: Process ID, in the range 1 to 65535. It is available only when the protocol is isis, ospf or rip.

all-processes: Redistributes routes from all the processes of the specified routing protocol. It is available only when the specified protocol is isis, ospf or rip.

allow-direct: Redistributes direct routes from the specified routing protocol. This keyword is available only when the specified routing protocol is OSPF. Without this keyword, BGP does not redistribute direct routes from OSPF. If you specify the route-policy route-policy-name keyword together with the allow-direct keyword, make sure that no rule in the routing policy conflicts with any direct route. For example, do not configure the if-match route-type command for the routing policy to filter OSPF routes. Otherwise, the allow-direct keyword does not take effect.

med-value: Specifies a MED value for redistributed routes, ranging from 0 to 4294967295. If the argument is not specified, the cost of a redistributed route is used as its MED in the BGP routing domain.

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

Description

Use the import-route command to enable route redistribution from a specified routing protocol.

Use the undo import-route command to disable route redistribution from a routing protocol.

By default, MBGP does not redistribute routes from other protocols.

The origin attribute of routes redistributed with the import-route command is incomplete.

Examples

# In IPv4 MBGP address family view, enable route redistribution from RIP.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] import-route rip

ipv4-family multicast

Syntax

ipv4-family multicast

undo ipv4-family multicast

View

BGP view

Default level

2: System level

Parameters

None

Description

Use the ipv4-family multicast command to enter IPv4 MBGP address family view.

Use the undo ipv4-family multicast command to remove all configurations made in IPv4 MBGP address family view and return to BGP view.

Examples

# Enter IPv4 MBGP address family view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul]

network (MBGP address family view)

Syntax

network ip-address [ mask | mask-length ] [ short-cut | route-policy route-policy-name ]

undo network ip-address [ mask | mask-length ] [ short-cut ]

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

ip-address: Destination IP address.

mask: Mask of the network address, in dotted decimal notation.

mask-length: Mask length, in the range 0 to 32.

short-cut: Specifies the route to use the local preference. If the route is an EBGP route whose preference is higher than the local preference, using this keyword can configure the EBGP route to use the local preference, and thus the route can hardly become the optimal route.

route-policy-name: Routing policy applied to the route. The name is a case-sensitive string of 1 to 63 characters.

Description

Use the network command to inject a network to the IPv4 MBGP routing table.

Use the undo network command to remove a network from the IPv4 MBGP routing table.

By default, no network route is injected.

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

The origin attribute of the network route injected with the network command is IGP.

Examples

# In IPv4 MBGP address family view, inject the network 10.0.0.0/16.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] network 10.0.0.0 255.255.0.0

peer advertise-community (MBGP address family view)

Syntax

peer { group-name | ip-address } advertise-community

undo peer { group-name | ip-address } advertise-community

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP 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 disable the community attribute advertisement to a peer/peer group.

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

Related commands: ip community-list, if-match community, and apply community (Routing policy configuration commands in the Layer 3—IP Routing Command Reference).

Examples

# In IPv4 MBGP address family view, advertise the community attribute to the existing peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test external

[Sysname-bgp] peer test as-number 200

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer test enable

[Sysname-bgp-af-mul] peer test advertise-community

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

Syntax

peer { group-name | ip-address } advertise-ext-community

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

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP 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 disable the extended community attribute advertisement to a peer/peer group.

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

Related commands: ip extcommunity-list, if-match extcommunity, and apply extcommunity (Routing policy configuration commands in the Layer 3—IP Routing Command Reference).

Examples

# In IPv4 MBGP address family view, advertise the extended community attribute to the existing peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test external

[Sysname-bgp] peer test as-number 200

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer test enable

[Sysname-bgp-af-mul] peer test advertise-ext-community

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

Syntax

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

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

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP peer.

number: Specifies the number of times 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 allow the local AS number to exist in the AS_PATH attribute of routes from a peer/peer group, and to configure the number of times the local AS number can appear.

Use the undo peer allow-as-loop command to remove the configuration.

By default, the local AS number is not allowed.

Related commands: display bgp multicast routing-table peer.

Examples

# In IPv4 MBGP address family view, configure the number of times the local AS number can appear in routes from the peer 1.1.1.1 as 2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 1.1.1.1 as-number 200

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer 1.1.1.1 enable

[Sysname-bgp-af-mul] peer 1.1.1.1 allow-as-loop 2

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

Syntax

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

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

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP peer.

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

export: Filters outgoing routes.

import: Filters incoming routes.

Description

Use the peer as-path-acl command to configure the filtering of routes incoming from or outgoing to an MBGP peer/peer group based on a specified AS path ACL.

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

By default, no AS path ACL based filtering is configured.

Related commands: ip as-path, if-match as-path, and apply as-path (Routing policy configuration commands in the Layer 3—IP Routing Command Reference).

Examples

# In IPv4 MBGP address family view, reference the AS path ACL 1 to filter routes outgoing to the peer group test.

<Sysname> system-view

[Sysname]bgp 100

[Sysname-bgp]group test external

[Sysname-bgp]peer test as-number 200

[Sysname-bgp]ipv4-family multicast

[Sysname-bgp-af-mul] peer test enable

[Sysname-bgp-af-mul] peer test as-path-acl 1 export

peer capability-advertise orf (MBGP address family view)

Syntax

peer { group-name | ip-address } capability-advertise orf ip-prefix { both | receive | send }

undo peer { group-name | ip-address } capability-advertise orf ip-prefix { both | receive | send }

View

MGBP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an MBGP 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 the peer capability-advertise orf command to enable the ORF capability for an MBGP peer or peer group.

Use the undo peer capability-advertise orf command to disable the ORF capability for the MBGP peer or peer group.

By default, the ORF capability is not enabled for an MBGP peer or peer group.

After you enable the ORF capability, the local MBGP router negotiates the ORF capability with the MBGP peer through Open messages. After that, the MBGP 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 in IPv4 unicast view.

After you disable the ORF capability, the local BGP router does not negotiate the ORF capability with the specified peer or peer group.

Table 13 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, respectively.

 

Examples

# Enable the ORF capability for the BGP peer 18.10.0.9. Then, after negotiation, the local router can exchange multicast ORF information with the peer 18.10.0.9.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 18.10.0.9 as-number 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer 18.10.0.9 enable

[Sysname-bgp-af-mul] peer 18.10.0.9 capability-advertise orf ip-prefix both

peer default-route-advertise (MBGP address family view)

Syntax

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

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

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP peer.

route-policy-name: Routing policy name, a case-sensitive string of 1 to 63 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 default route advertisement to a peer/peer group.

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

With this command used, the router unconditionally sends a default route with the next hop being itself to the peer/peer group regardless of whether the default route is available in the routing table.

Examples

# In IPv4 MBGP address family view, advertise a default route to the existing peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test external

[Sysname-bgp] peer test as-number 200

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer test enable

[Sysname-bgp-af-mul] peer test default-route-advertise

peer enable (MBGP address family view)

Syntax

peer { group-name | ip-address } enable

undo peer { group-name | ip-address } enable

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP peer.

Description

Use the peer enable command to enable the specified peer/peer group that has been created in BGP view.

Use the undo peer enable command to disable the specified peer/peer group that has been created in BGP view.

By default, no peer or peer group is enabled in BGP address family view.

If a peer is disabled, the router will not exchange routing information with the peer.

Examples

# Enable the peer 18.10.0.9.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 18.10.0.9 as-number 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer 18.10.0.9 enable

peer filter-policy (MBGP address family view)

Syntax

peer { group-name | ip-address } filter-policy acl-number { export | import }

undo peer { group-name | ip-address } filter-policy [ acl-number ] { export | import }

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP peer.

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

export: Uses the ACL to filter routes outgoing to the peer/peer group.

import: Uses the ACL to filter routes incoming from 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 filtering.

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

Related commands: peer as-path-acl.

Examples

# In IPv4 MBGP address family view, reference ACL 2000 to filter routes sent to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test external

[Sysname-bgp] peer test as-number 200

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer test enable

[Sysname-bgp-af-mul] peer test filter-policy 2000 export

peer group (MBGP address family view)

Syntax

peer ip-address group group-name

undo peer ip-address group group-name

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP peer.

Description

Use the peer group command to add an IPv4 MBGP peer to an IPv4 MBGP peer group.

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

By default, no peer is added into a peer group.

Examples

# In IPv4 MBGP address family view, add the peer 10.1.1.1 to the multicast EBGP peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test external

[Sysname-bgp] peer test as-number 200

[Sysname-bgp] peer 10.1.1.1 group test

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer test enable

[Sysname-bgp-af-mul] peer 10.1.1.1 group test

peer ip-prefix (MBGP address family view)

Syntax

peer { group-name | ip-address } ip-prefix ip-prefix-name { export | import }

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

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP peer.

ip-prefix-name: IP prefix list name, a string of 1 to 19 characters.

export: Applies the filter to routes outgoing to the specified peer/peer group.

import: Applies the filter to routes from the specified peer/peer group.

Description

Use the peer ip-prefix command to reference an IP prefix list to filter routes received from or advertised to a peer or peer group.

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

By default, no IP prefix list based filtering is configured.

Examples

# In IPv4 MBGP address family view, use the IP prefix list 1 to filter routes outgoing to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test external

[Sysname-bgp] peer test as-number 200

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer test enable

[Sysname-bgp-af-mul] peer test ip-prefix list1 export

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

Syntax

peer { group-name | ip-address } keep-all-routes

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

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP peer.

Description

Use the peer keep-all-routes command to save original routing information from a peer or peer group, including routes that fail to pass the inbound policy (if configured).

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

By default, the feature is not enabled.

Examples

# In IPv4 MBGP address family view, save all the routing information from peer 131.108.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 131.108.1.1 as-number 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer 131.108.1.1 enable

[Sysname-bgp-af-mul] peer 131.108.1.1 keep-all-routes

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

Syntax

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

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

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP peer.

Description

Use the peer next-hop-local command to specify the router as the next hop for routes sent to a peer/peer group.

Use the undo peer next-hop-local command to remove the configuration.

By default, the routes advertised to an EBGP peer/peer group take the local router as the next hop, but the routes outgoing to an IBGP peer/peer group do not take the local router as the next hop.

Examples

# In IPv4 MBGP address family view, specify the router as the next hop for routes sent to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test internal

[Sysname-bgp] peer test as-number 200

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer test enable

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

peer preferred-value (MBGP address family view)

Syntax

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

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

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP peer.

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

Description

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

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

The default preferred value is 0.

Routes learned from a peer have an initial preferred value. Among multiple routes that have the same destination/mask and are learned from different peers, the one with the greatest preferred value is selected as the route to the destination.

If you both reference a routing policy and use the peer { group-name | ip-address } preferred-value value command to set a preferred value for routes from a peer/peer group, the routing policy sets the specified preferred value for routes matching it. Other routes not matching the routing policy uses the value set with the peer preferred-value command. If the preferred value specified in the routing policy is zero, the routes matching it will also use the value set with the peer preferred-value command.

For how to use a routing policy to set a preferred value, see the command peer { group-name | ip-address } route-policy route-policy-name { export | import } in this document, and the command apply preferred-value preferred-value (see Layer 3—IP Routing Command Reference).

Examples

# In IPv4 MBGP address family view, configure the preferred value as 50 for routes from peer 131.108.1.1.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 131.108.1.1 as-number 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer 131.108.1.1 enable

[Sysname-bgp-af-mul] peer 131.108.1.1 preferred-value 50

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

Syntax

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

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

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP peer.

Description

Use the peer public-as-only command to not keep private AS numbers in BGP updates sent to a peer/peer group.

Use the undo peer public-as-only command to keep private AS numbers in BGP updates sent to a peer/peer group.

By default, outgoing BGP updates can carry private AS numbers.

The command does not take effect for BGP updates with both public and private AS numbers. The range of private AS numbers is from 64512 to 65535.

Examples

# In IPv4 MBGP address family view, disable updates sent to the peer group test from carrying private AS numbers.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test external

[Sysname-bgp] peer test as-number 200

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer test enable

[Sysname-bgp-af-mul] peer test public-as-only

peer reflect-client (MBGP address family view)

Syntax

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

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

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

peer-address: IP address of an IPv4 MBGP 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 the route reflector nor the client is configured.

Related commands: reflect between-clients and reflect cluster-id.

Examples

# In IPv4 MBGP address family view, configure the local device as a route reflector and specify the IBGP peer group test as a client.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test internal

[Sysname-bgp] peer test as-number 200

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer test enable

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

peer route-limit (MBGP address family view)

Syntax

peer { group-name | ip-address } route-limit limit [ percentage ]

undo peer { group-name | ip-address } route-limit

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP peer.

limit: Upper limit of IP prefixes that can be received from the peer or peer group. It ranges from 1 to 4194304.

percentage: If the number of received routes divided by the upper limit reaches the specified percentage, the system will generate alarm information. The percentage is in the range 1 to 100. The default is 75.

Description

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

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

The number is unlimited by default.

Examples

# In IPv4 MBGP address family view, set the number of routes that can be received from peer 131.108.1.1 to 10000.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] peer 131.108.1.1 as-number 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer 131.108.1.1 enable

[Sysname-bgp-af-mul] peer 131.108.1.1 route-limit 10000

peer route-policy (MBGP address family view)

Syntax

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

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

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

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

ip-address: IP address of an IPv4 MBGP peer.

route-policy-name: Routing policy name, a case-sensitive string of 1 to 63 characters.

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

import: Applies the routing policy to routes received from the peer/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 applied to routes from/to the peer/peer group.

The peer route-policy command does not apply the if-match interface clause in the referenced routing policy. For more information, see Layer 3—IP Routing Command Reference.

Examples

# In IPv4 MBGP address family view, apply the routing policy test-policy to routes outgoing to the peer group test.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] group test external

[Sysname-bgp] peer test as-number 200

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] peer test enable

[Sysname-bgp-af-mul] peer test route-policy test-policy export

preference (MBGP address family view)

Syntax

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

undo preference

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

external-preference: Preference of EBGP routes, in the range 1 to 255.

internal-preference: Preference of IBGP routes, in the range 1 to 255.

local-preference: Preference of local routes, in the range 1 to 255.

route-policy-name: Routing policy name, a case-sensitive string of 1 to 63 characters. Using a routing policy can set preferences for the routes matching it. As for the unmatched routes, the default preferences are adopted.

Description

Use the preference command to configure preferences for external, internal, and local routes.

Use the undo preference command to restore the default.

The default preference values of external, internal and local BGP routes are 255, 255, and 130, respectively

Examples

# In IPv4 MBGP address family view, configure preferences for EBGP, IBGP, and local IPv4 MBGP routes as 20, 20, and 200.

<Sysname> system-view

[Sysname]bgp 100

[Sysname-bgp] ipv4-family multicast

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

reflect between-clients (MBGP address family view)

Syntax

reflect between-clients

undo reflect between-clients

View

IPv4 MBGP 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 the routes of a client to other clients. If the clients of a route reflector are fully meshed, you need to disable route reflection between clients to reduce routing costs.

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

Examples

# Disable route reflection between clients.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] undo reflect between-clients

reflector cluster-id (MBGP address family view)

Syntax

reflector cluster-id { cluster-id | ip-address }

undo reflector cluster-id

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

cluster-id: Cluster ID of the route reflector, in the range 1 to 4294967295.

ip-address: Cluster ID of the route reflector, in the format of an IP 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, each route reflector uses its router ID as the cluster ID.

A route is reflected by a route reflector from a client to another client. The router ID of the route reflector is the ID of the cluster. You can configure multiple route reflectors to improve network stability. If a cluster has multiple route reflectors, you need to use the reflector cluster-id command to specify the same cluster ID for these route reflectors to avoid routing loops.

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

Examples

# Specify 80 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] ipv4-family multicast

[Sysname-bgp-af-mul] reflector cluster-id 80

refresh bgp ipv4 multicast

Syntax

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

View

User view

Default level

2: Monitor level

Parameters

all: Soft-resets all BGP connections.

ip-address: IP address of an IPv4 MBGP peer.

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

external: Soft-resets EBGP connections.

internal: Soft-resets IBGP connections.

export: Outbound soft reset.

import: Inbound soft reset.

Description

Use the refresh bgp ipv4 multicast command to perform soft reset on specified IPv4 MBGP connections. This method can also refresh the MBGP routing table and apply a new routing policy seamlessly.

To perform BGP soft reset, all routers in the network must support route-refresh. If a router not supporting the route-refresh function exists, you must configure the peer keep-all-routes command to save all the routing information of the peer before BGP soft reset.

Examples

# Soft-reset all the IPv4 MBGP connections.

<Sysname> refresh bgp ipv4 multicast all import

reset bgp ipv4 multicast

Syntax

reset bgp ipv4 multicast { all | as-number | ip-address | group group-name | external | internal }

View

User view

Default level

2: System level

Parameters

all: Resets all MBGP connections.

as-number: Resets MBGP connections to peers in the AS.

ip-address: Resets the connection with an IPv4 MBGP peer.

group group-name: Resets connections with the specified BGP peer group.

external: Resets all the multicast EBGP connections.

internal: Resets all the multicast IBGP connections.

Description

Use the reset bgp ipv4 multicast command to reset specified MBGP connections.

Examples

# Reset all the IPv4 MBGP connections.

<Sysname> reset bgp ipv4 multicast all

reset bgp ipv4 multicast dampening

Syntax

reset bgp ipv4 multicast dampening [ ip-address [ mask | mask-length ] ]

View

User view

Default level

1: Monitor level

Parameters

ip-address: Destination IP address.

mask: Mask, in dotted decimal notation. The default is 255.255.255.255.

mask-length: Mask length, in the range 0 to 32. The default is 32.

Description

Use the reset bgp ipv4 multicast dampening command to clear route dampening information and release suppressed routes.

Related commands: dampening and display bgp multicast routing-table dampened.

Examples

# Clear damping information of route 20.1.0.0/16 and release the suppressed route.

<Sysname> reset bgp ipv4 multicast dampening 20.1.0.0 255.255.0.0

reset bgp ipv4 multicast flap-info

Syntax

reset bgp ipv4 multicast flap-info [ regexp as-path-regular-expression | as-path-acl as-path-acl-number | ip-address [ mask | mask-length ] ]

View

User view

Default level

1: Monitor level

Parameters

as-path-regular-expression: Clears the flap statistics of routes matching the AS path regular expression, which is a string of 1 to 80 case-sensitive characters with spaces included.

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

ip-address: Clears the flap statistics of a route.

mask: Mask, in dotted decimal notation. The default is 255.255.255.255.

mask-length: Mask length, in the range 0 to 32. The default is 32.

Description

Use the reset bgp ipv4 multicast flap-info command to clear IPv4 MBGP routing flap statistics.

The flap statistics of all the routes will be cleared if no parameter is specified.

Examples

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

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

summary automatic (MBGP address family view)

Syntax

summary automatic

undo summary automatic

View

IPv4 MBGP address family view

Default level

2: System level

Parameters

None

Description

Use the summary automatic command to enable automatic summarization for redistributed subnets.

Use the undo summary automatic command to disable automatic summarization.

By default, automatic summarization is disabled.

The default routes and the routes imported with the network command cannot be automatically summarized.

The summary automatic command helps IPv4 MBGP limit the number of routes redistributed from IGP.

Examples

# In IPv4 MBGP address family view, enable automatic route summarization.

<Sysname> system-view

[Sysname]bgp 100

[Sysname-bgp] ipv4-family multicast

[Sysname-bgp-af-mul] summary automatic