Login
- Table of Contents
-
- 07-IP Multicast Command Reference
- 00-Preface
- 01-IGMP snooping commands
- 02-PIM snooping commands
- 03-Multicast VLAN commands
- 04-Multicast routing and forwarding commands
- 05-IGMP commands
- 06-PIM commands
- 07-MSDP commands
- 08-Multicast VPN commands
- 09-MLD snooping commands
- 10-IPv6 PIM snooping commands
- 11-IPv6 multicast VLAN commands
- 12-IPv6 multicast routing and forwarding commands
- 13-MLD commands
- 14-IPv6 PIM commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 08-Multicast VPN commands | 70.2 KB |
display bgp routing-table ipv4 mdt
display multicast-domain data-group receive
display multicast-domain data-group send
display multicast-domain default-group
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
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
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 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
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
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
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
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 the 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
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
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
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
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
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
