Multicast VPN commands 1

address-family ipv4 mdt 1

data-delay· 1

data-group· 2

default-group· 3

display bgp routing-table ipv4 mdt 4

display multicast-domain data-group receive· 7

display multicast-domain data-group send· 8

display multicast-domain default-group· 10

log data-group-reuse· 11

multicast-domain· 11

source· 12

 

address-family ipv4 mdt

Use address-family ipv4 mdt to create a BGP IPv4 MDT address family and enter BGP IPv4 MDT address family view.

Use undo address-family ipv4 mdt to delete the BGP IPv4 MDT address family and all configurations in BGP IPv4 MDT address family view.

Syntax

address-family ipv4 mdt

undo address-family ipv4 mdt

Default

No BGP IPv4 MDT address family exists.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

Execute this command before you use the peer enable command to enable BGP peers to exchange MDT information. The MDT information includes the IP address of a PE and default-group to which the PE belongs. On a public network running PIM-SSM, the multicast VPN establishes a default-MDT rooted at the PE (multicast source) based on the MDT information.

The configuration made in the BGP IPv4 MDT address family view takes effect only on BGP MDT messages, BGP MDT peers, and BGP MDT peer groups.

Examples

# In BGP instance view of the BGP instance default, create a BGP IPv4 MDT address family and enter its view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 mdt

[Sysname-bgp-default-mdt]

Related commands

peer enable (see Layer 3—IP Routing Configuration Guide)

data-delay

Use data-delay to set the data-delay period (delay period before the default-MDT switches to the data-MDT).

Use undo data-delay to restore the default.

Syntax

data-delay delay

undo data-delay

Default

The default setting is 3 seconds.

Views

MD view

Predefined user roles

network-admin

Parameters

delay: Specifies a data-delay period in the range of 1 to 60 seconds.

Examples

# Set the data-delay period to 20 seconds in the VPN instance mvpn.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] data-delay 20

data-group

Use data-group to configure the data-group address range and the switchover criteria.

Use undo data-group to restore the default.

Syntax

data-group group-address { mask-length | mask } [ acl acl-number ]

undo data-group

Default

The data-group address range is not configured, and multicast traffic never switches to a data-MDT.

Views

MD view

Predefined user roles

network-admin

Parameters

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

mask-length: Specifies an address mask length in the range of 25 to 32.

mask: Specifies the address mask.

acl acl-number: Specifies an advanced ACL number in the range of 3000 to 3999. I f you specify an ACL, the configured MDT switchover criteria applies to the (S, G) entries that the ACL permits. If you do not specify an ACL, the configured MDT switchover criteria apply to all (S, G) entries. To make the ACL effective, specify the protocol type as IP, and include the source and destination keywords when creating an ACL rule. The source and destination keywords specify a multicast source address range and a multicast group address range, respectively.

Usage guidelines

On a PE device, the data-group address range must meet the following requirements:

·     It must not include the default-group address of the MD.

·     It must not overlap with the data-group address range of any other MDs.

On different devices, if the public network is not in PIM-SSM mode, the data-group address ranges for different MDs cannot overlap.

If you execute the command multiple times in an MD, the most recent configuration takes effect.

If you configure this command on the device, switchover from the default-MDT to data-MDT will take place when the following conditions are met:

·     The device receives the multicast traffic that has passed the ACL rule filtering.

·     The multicast traffic is maintained for the data-delay period.

Examples

# Configure the data-group address range in VPN instance mvpn as 239.1.2.128 to 239.1.2.255.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] data-group 239.1.2.128 25

default-group

Use default-group to specify a default-group address.

Use undo default-group to restore the default.

Syntax

default-group group-address

undo default-group

Default

The default-group address is not specified.

Views

MD view

Predefined user roles

network-admin

Parameters

group-address: Specifies a default-group address in the range of 224.0.1.0 to 239.255.255.255.

Usage guidelines

The same default-group address must be used by the MD of the same VPN instance on different PE device. In addition, the default-group address must be different from the default-group address and the data-group address used by other MDs.

Examples

# Specify the default-group address as 239.1.1.1 for VPN instance mvpn.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] default-group 239.1.1.1

display bgp routing-table ipv4 mdt

Use display bgp routing-table ipv4 mdt to display BGP MDT routing information.

Syntax

display bgp routing-table ipv4 mdt [ route-distinguisher route-distinguisher ] [ ip-address [ advertise-info ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

route-distinguisher route-distinguisher: Specifies a router distinguisher (RD), a string of 3 to 21 characters. If you do not specify an RD, this command displays BGP MDT routing for all RDs. An RD can be in one of the following formats:

·     16-bit AS number:32-bit user-defined number. For example, 101:3.

·     32-bit IP address:16-bit user-defined number. For example, 192.168.122.15:1.

·     32-bit AS number:16-bit user-defined number, where the AS number must be equal to or greater than 65536. For example, 65536:1.

ip-address: Specifies a multicast source address. The ip-address argument represents the IP address of the PE device in the default-MDT. If you do not specify a multicast source, this command displays brief information about BGP MDT routes for all multicast sources.

advertise-info: Displays advertisement information. If you do not specify this keyword, no advertisement information is displayed.

Examples

# Display brief information about BGP MDT routes for all multicast sources.

<Sysname> display bgp routing-table ipv4 mdt

 

 BGP local router ID is 1.1.1.1

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

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

 

 Route distinguisher: 100:1

 Total number of routes: 2

 

     Network            NextHop         MED        LocPrf     PrefVal Path/Ogn

 

* >  1.1.1.1/32         0.0.0.0                               32768   ?

* >i 2.2.2.2/32         2.2.2.2                    100        0       ?

# Display detailed information about BGP MDT routes for the multicast source 1.1.1.1.

<Sysname> display bgp routing-table ipv4 mdt 1.1.1.1

 

 BGP local router ID: 1.1.1.1

 Local AS number: 100

 

 

 Route distinguisher: 100:1

 Total number of routes: 1

 Paths:   1 available, 1 best

 

 BGP MDT information of source 1.1.1.1:

 Default-group   : 224.1.1.1

 Original nexthop: 0.0.0.0

 AS-path         : (null)

 Origin          : incomplete

 Attribute value : pref-val 32768

 State           : valid, local, best

# Display advertisement information about BGP MDT routes for the multicast source 1.1.1.1.

<Sysname> display bgp routing-table ipv4 mdt 1.1.1.1 advertise-info

 

 BGP local router ID: 1.1.1.1

 Local AS number: 100

 

 Route distinguisher: 100:1

 Total number of routes: 1

 Paths:   1 best

 

 BGP MDT information of source 1.1.1.1:

 Default-group: 224.1.1.1

 Advertised to peers (1 in total):

     6.6.6.6

Table 1 Command output

Field	Description
BGP local router ID	ID of the local router.
Status codes	Codes of route status: ·     * – valid—Valid route. ·     > – best—Best route. ·     d – damped—Dampened route. ·     h – history—History route. ·     s – suppressed—Suppressed route. ·     S – Stale—Stale route. ·     i – internal—Internal route. ·     e – external—External route.
Origin	Origin of the route information: ·     i – IGP—Originated in the AS. The origins of the routes advertised by the network command are IGP. ·     e – EGP—Learned through EGP. ·     ? – incomplete—Learned by some other means. The origins of routes redistributed by IGP are incomplete.
Total number of routes	Total number of BGP MDT routes.
Network	Source IP address of the default-MDT.
NextHop	IP address of the next hop.
MED	Attribute value of Multi-Exit-Discrimination (MED).
LocPrf	Local preference value.
PrefVal	Preferred value of a route.
Path/Ogn	AS PATH attribute and ORIGIN attribute: ·     AS_PATH—Records the ASs the packet has passed to avoid routing loops. ·     ORIGIN—Identifies the origin of the BGP MDT routes.
Paths	Number of the BGP MDT routes: ·     available—Number of valid BGP MDT routes. ·     best—Number of the best BGP MDT routes.
Default-group	Default-group address to which the route belongs.
Advertised to peers (1 in total)	Peers to which the route has been advertised and total number of peers.
From	IP address of the BGP peer that advertises the route.
Original nexthop	IP address of the original next hop. If the route is learned from the BGP update message, this field displays the IP address of the next hop that receives the message.
AS-path	AS PATH attribute of the path, recording the ASs that the BGP MDT route has passed to avoid routing loops.
Attribute value	Attributes of the BGP MDT routes: ·     MED—MED value related to destination network. ·     Localpref—Local preferred value. ·     pref-val—Preferred value of the route. ·     pre—Preferred value of the protocol.
State	Current states: ·     valid—Valid routes. ·     internal—Internal routes. ·     external—External routes. ·     local—Local routes. ·     synchronize—Synchronized routes. ·     best—Best routes.

 

display multicast-domain data-group receive

Use display multicast-domain data-group receive to display data-group information received by a VPN instance in the MD.

Syntax

display multicast-domain vpn-instance vpn-instance-name data-group receive [ brief | [ active | group group-address | sender source-address | vpn-source-address [ mask { mask-length | mask } ] | vpn-group-address [ mask { mask-length | mask } ] ] * ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance, a case-sensitive string of 1 to 31 characters.

brief: Specifies brief information. If you do not specify this keyword, the command displays detailed information.

active: Specifies the data-group that has joined the data-MDT.

group group-address: Specifies a public network multicast group address in the range of 224.0.1.0 to 239.255.255.255.

sender source-address: Specifies a public network multicast source address.

vpn-source-address: Specifies a VPN multicast source address.

mask-length: Specifies a mask length of the specified VPN multicast source/group address, in the range of 0 to 32. The default value is 32.

mask: Specifies a subnet mask of the specified VPN multicast source/group address, 255.255.255.255 by default.

vpn-group-address: Specifies a VPN multicast group address in the range of 224.0.0.0 to 239.255.255.255.

Examples

# Display data-group information received by VPN instance mvpn in the MD.

<Sysname> display multicast-domain vpn-instance mvpn data-group receive

MD data-group information received by VPN instance: mvpn

Total 2 data-groups for 8 entries

Total 2 data-groups and 8 entries matched

 

Data-group: 226.1.1.0   Reference count: 4   Active count: 2

  Sender: 172.100.1.1   Active count: 1

    (192.6.1.5, 239.1.1.1)       expires: 00:03:10 active

    (192.6.1.5, 239.1.1.158)     expires: 00:03:10

  Sender:  181.100.1.1, active count: 1

    (195.6.1.2, 239.1.2.12)      expires: 00:03:10 active

    (195.6.1.2, 239.1.2.197)     expires: 00:03:10

Data-group: 229.1.1.0   Reference count: 4   Active count: 2

  Sender: 185.100.1.1   Active count: 1

    (198.6.1.5, 239.1.3.62)      expires: 00:03:10 active

    (198.6.1.5, 225.1.1.109)     expires: 00:03:10

  Sender: 190.100.1.1   Active count: 1

    (200.6.1.2, 225.1.4.80)      expires: 00:03:10 active

    (200.6.1.2, 225.1.4.173)     expires: 00:03:10

# Display brief data-group information received by VPN instance mvpn in the MD.

<Sysname> display multicast-domain vpn-instance mvpn data-group receive brief

MD data-group information received by VPN instance: mvpn

Total 2 data-groups for 8 entries

Total 2 data-groups and 8 entries matched

 

Data group: 226.1.1.0   Reference count: 4   Active count: 2

Data group: 229.1.1.0   Reference count: 4   Active count: 2

Table 2 Command output

Field	Description
MD data-group information received by VPN instance: mvpn	Data-group information received by VPN instance mvpn.
Total 2 data-groups for 8 entries	A total of two data-groups, associated with eight (S, G) entries.
Total 2 data-groups and 8 entries matched	A total of two data-groups are matched, associated with eight (S, G) entries.
Data-group	Data-group address received.
Sender	BGP peer address of the PE device that sent the data-group information.
Reference count	Number of VPN multicast groups referenced by the data-group.
Active count	Number of active VPN multicast groups (multicast groups with active receivers) referenced by the data-group.
expires	Remaining time for the VPN (S, G) entry referenced by the data-group.

 

display multicast-domain data-group send

Use display multicast-domain data-group send to display data-group information sent by a VPN instance in the MD.

Syntax

display multicast-domain vpn-instance vpn-instance-name data-group send [ group group-address | reuse interval | vpn-source-address [ mask { mask-length | mask } ] | vpn-group-address [ mask { mask-length | mask } ] ] *

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance, a case-sensitive string of 1 to 31 characters.

group group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

reuse interval: Specifies an interval during which the data-group address reuses occur, in the range of 1 to 2147483647 seconds.

vpn-source-address: Specifies a VPN multicast source address.

mask-length: Specifies a mask length of the specified multicast source/group address, in the range of 0 to 32. The default is 32.

mask: Specifies a subnet mask of the specified VPN multicast source/group address, 255.255.255.255 by default.

vpn-group-address: Specifies a VPN multicast group address in the range of 224.0.0.0 to 239.255.255.255.

Examples

# Display data-group information sent by VPN instance mvpn in the MD.

<Sysname> display multicast-domain vpn-instance mvpn data-group send

MD data-group information sent by VPN instance: mvpn

Total 2 data-groups for 6 entries

Total 2 data-groups and 6 entries matched

 

  Reference count of 226.1.1.0: 3

    (192.6.1.5, 239.1.1.1)                  switch time: 00:00:21

    (192.6.1.5, 239.1.1.158)                switch time: 00:00:21

    (192.6.1.5, 239.1.2.50)                 switch time: 00:00:05

  Reference count of 226.1.1.1: 3

    (192.6.1.2, 225.1.1.1)                  switch time: 00:00:21

    (192.6.1.2, 225.1.2.50)                 switch time: 00:00:05

    (192.6.1.5, 239.1.1.159)                switch time: 00:00:21

# Display the data-group reuse information sent by VPN instance mvpn within 30 seconds in the MD.

<Sysname> display multicast-domain vpn-instance mvpn data-group send reuse 30

MD data-group information sent by VPN instance: mvpn

Total 2 data-groups for 3 entries

Total 2 data-groups and 3 entries matched

 

  Reuse count of 226.1.1.0: 1

  Reuse count of 226.1.1.1: 1

  Reuse count of 226.1.1.2: 1

Table 3 Command output

Field	Description
MD data-group information sent by VPN instance: mvpn	Data-group information sent by VPN instance mvpn.
Total 2 data-groups for 6 entries	A total of two data-groups, associated with six (S, G) entries.
Total 2 data-groups and 6 entries matched	A total of two data-groups are matched, associated with six (S, G) entries.
Reference count of 226.1.1.0	Number of VPN multicast groups referenced by the sent data-group.
switch time	Switchover time of the VPN (S, G) entry referenced by the data-group.
Reuse count of 226.1.1.0	Number of data-group reuses during the specified length of time.

 

display multicast-domain default-group

Use display multicast-domain default-group to display default-group information.

Syntax

display multicast-domain [ vpn-instance vpn-instance-name ] default-group { local | remote }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays default-group information for all VPN instances.

local: Specifies local default-groups.

remote: Specifies remote default-groups.

Examples

# Display information about local default-groups for all VPN instances.

<Sysname> display multicast-domain default-group local

MD local default-group information:

 Group address    Source address   Interface     VPN instance

 239.1.1.1        1.1.1.1          MTunnel0      mvpna

 239.2.1.1        1.1.1.1          MTunnel1      mvpnb

 239.3.1.1        --               MTunnel2      mvpnc

# Display information about remote default-groups for all VPN instances.

<Sysname> display multicast-domain default-group remote

MD remote default-group information:

 Group address   Source address  Next hop         VPN instance

 239.1.1.1       1.2.0.1         1.2.0.1          a

 239.1.1.1       1.2.0.2         1.2.0.2          a

 239.1.1.1       1.2.0.3         1.2.0.3          a

 239.1.1.2       1.2.0.1         1.2.0.1          b

 239.1.1.2       1.2.0.2         1.2.0.2          b

 239.1.1.3       1.2.0.1         1.2.0.1          -

Table 4 Command output

Field	Description
Group address	Address of the default-group.
Source address	IP address of the MD source interface, which is used by the MTI as the source address to encapsulate the VPN multicast packets.
Interface	MTI interface.
Next hop	IP address of the next hop.
VPN instance	VPN instance to which the default-group belongs.

 

log data-group-reuse

Use log data-group-reuse to enable data-group reuse logging.

Use undo log data-group-reuse to disable data-group reuse logging.

Syntax

log data-group-reuse

undo log data-group-reuse

Default

The data-group reuse logging function is disabled.

Views

MD view

Predefined user roles

network-admin

Examples

# Enable data-group reuse logging in VPN instance mvpn.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] log data-group-reuse

multicast-domain

Use multicast-domain to create the MD for a VPN instance and enter MD view.

Use undo multicast-domain to clear the configurations that are made in MD view for a VPN instance.

Syntax

multicast-domain vpn-instance vpn-instance-name

undo multicast-domain vpn-instance vpn-instance-name

Default

No MD exists for a VPN instance.

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.

Examples

# Create the MD for the VPN instance mvpn and enter MD view.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn]

source

Use source to specify the MD source interface.

Use undo source to restore the default.

Syntax

source interface-type interface-number

undo source

Default

No MD source interface is specified.

Views

MD view

Predefined user roles

network-admin

Parameters

interface-type interface-number: Specifies an interface by its type and number.

Usage guidelines

The IP address of the MD source interface must be the same as the source address used for establishing BGP peer relationship. Otherwise, correct routing information cannot be obtained.

Examples

# The source interface used for establishing BGP peer relationship is Loopback 1. Specify this interface as the MD source interface for the VPN instance mvpn.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] source loopback 1