Contents

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

display multicast-domain data-group send· 8

display multicast-domain default-group· 10

log data-group-reuse· 11

multicast-domain· 11

source· 12

 

Multicast VPN commands

address-family ipv4 mdt

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

Use undo address-family ipv4 mdt to delete the BGP IPv4 MDT address family and configuration 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 view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

Execute this command before you enable BGP peers to exchange MDT information by using the peer enable command. MDT information includes the IP address of the 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.

Configuration in BGP IPv4 MDT address family view takes effect only on BGP MDT messages, BGP MDT peers, and BGP MDT peer groups.

Examples

# Create a BGP IPv4 MDT address family, and enter the BGP IPv4 MDT family address view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp] address-family ipv4 mdt

[Sysname-bgp-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 data-delay period is 3 seconds.

Views

MD view

Predefined user roles

network-admin

mdc-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 for VPN instance mvpn.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] data-delay 20

data-group

Use data-group to specify a data-group range and optionally configure the criterion for the default-MDT to data-MDT switchover.

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 range is not configured, and the default-MDT to data-MDT switchover never occurs.

Views

MD view

Predefined user roles

network-admin

mdc-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 an address mask in the range of 255.255.255.x, where x can only be 128, 192, 224, 240, 248, 252, 254, or 255.

acl acl-number: Specifies an advanced ACL by its number in the range of 3000 to 3999. If 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 applies to all (S, G) entries. To make the ACL effective, specify the protocol type as IP, and include the source and destination keywords when you create 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 range for a VPN instance cannot include the default-group or data-groups of any other VPN instance.

The data-group ranges for different VPN instances on different PE devices cannot overlap with one another if the PIM mode is not PIM-SSM on the public network.

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

After you execute this command, the default-MDT to data-MDT switchover occurs a data-delay period after the VPN multicast data that matches the switchover criterion first arrives. The switchover takes place regardless of whether the VPN multicast data keeps arriving during the period.

Examples

# Specify 239.1.2.0 through 239.1.2.255 as the data-group range for VPN instance mvpn.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

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

default-group

Use default-group to specify a default-group.

Use undo default-group to restore the default.

Syntax

default-group group-address

undo default-group

Default

The default-group is not specified.

Views

MD view

Predefined user roles

network-admin

mdc-admin

Parameters

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

Usage guidelines

You must specify the same default-group on all PE devices that belong to the same VPN instance.

The default-group for a VPN instance must be different from the default-group and the data-group used by any other VPN instance.

Examples

# Specify 239.1.1.1 as the default-group 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

mdc-admin

mdc-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 information about 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 by its IP address. The ip-address argument specifies 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 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 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 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.
BGP MDT information of source 1.1.1.1	BGP MDT information of the multicast source 1.1.1.1.
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 it 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

mdc-admin

mdc-operator

Parameters

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

brief: Displays 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 matching, 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

mdc-admin

mdc-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 by its IP address in the range of 224.0.1.0 to 239.255.255.255.

reuse interval: Sets 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 in the range of 0 to 32. The default is 32.

mask: Specifies a subnet mask. The default is 255.255.255.255.

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 matching, 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 the 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

mdc-admin

mdc-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, this command displays default-group information of all VPN instances.

local: Displays local default-group information.

remote: Displays remote default-group information.

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

Data-group reuse logging is disabled.

Views

MD view

Predefined user roles

network-admin

mdc-admin

Examples

# Enable data-group reuse logging for 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 an MD for a VPN instance and enter MD view.

Use undo multicast-domain to clear configurations 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

mdc-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 an MD for VPN instance mvpn and enter the MD view.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn]

source

Use source to specify an 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

mdc-admin

Parameters

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

Usage guidelines

For the PE device to obtain correct routing information, you must specify the interface used for establishing BGP peer relationship as the MD source interface.

Examples

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

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] source loopback 1