- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-MVXLAN commands | 95.31 KB |
display multicast-vpn vxlan data-group receive
display multicast-vpn vxlan data-group send
display multicast-vpn vxlan default-group
multicast-vpn vxlan public-instance
multicast-vpn vxlan vpn-instance
MVXLAN commands
address-family ipv4
Use address-family ipv4 to create an MVXLAN IPv4 address family and enter its view, or enter the view of the existing MVXLAN IPv4 address family.
Use undo address-family ipv4 to delete the MVXLAN IPv4 address family and all settings in MVXLAN IPv4 address family view.
Syntax
address-family ipv4
undo address-family ipv4
Default
No MVXLAN IPv4 address family exists.
Views
MVXLAN view
Predefined user roles
network-admin
mdc-admin
Examples
# In MVXLAN view of VPN instance vpna, create an MVXLAN IPv4 address family and enter its view.
<Sysname> system-view
[Sysname] multicast-vpn vxlan vpn-instance vpna mode mdt
[Sysname-mvxlan-vpna] address-family ipv4
[Sysname-mvxlan-vpna-ipv4]
data-delay
Use data-delay to set the data-delay period (delay period before the device switches over from the default MDT 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
MVXLAN IPv4 address family view
Predefined user roles
network-admin
mdc-admin
Parameters
delay: Specifies a data-delay period in the range of 1 to 60 seconds.
Examples
# In MVXLAN IPv4 address family view of VPN instance vpna, set the data-delay period to 10 seconds.
<Sysname> system-view
[Sysname] multicast-vpn vxlan vpn-instance vpna mode mdt
[Sysname-mvxlan-vpna] address-family ipv4
[Sysname-mvxlan-vpna-ipv4] data-delay 10
data-group
Use data-group to specify a data group range and optionally configure the criteria for the device to initiate a switchover of the default MDT to a data MDT.
Use undo data-group to restore the default.
Syntax
data-group group-address { mask-length | mask } [ { acl acl-number | name acl-name } ]
undo data-group
Default
No data group range exists, and the device never initiates a switchover of the default MDT to a data MDT.
Views
MVXLAN IPv4 address family 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 a mask length for the multicast group address. The value range for this argument is 22 to 32.
mask: Specifies a subnet mask for the multicast group address. The value range for this argument is 255.255.252.0 to 255.255.255.255.
acl acl-number: Specifies an advanced ACL by its number in the range of 3000 to 3999.
name acl-name: Specifies a basic or advanced ACL by its name, a case-insensitive string of 1 to 63 characters. The name must start with a letter and cannot be all.
Usage guidelines
This command enables the device to initiate a switchover of the default MDT to a data MDT if the multicast data permitted by the specified ACL keeps arriving for a data-delay period.
The specified ACL matches traffic according to the following rules:
· A basic ACL uses the source keyword in an ACL rule to match multicast traffic by the multicast source address. All optional parameters are ignored, except source, fragment, and time-range.
· An advanced ACL uses the source and destination keywords in an ACL rule to match multicast traffic by the multicast source address and the multicast group address. All optional parameters are ignored, except source, destination, fragment, and time-range.
On a VTEP, the data group range for an MVXLAN cannot include the default group or data groups of any other MVXLAN.
If you execute this command multiple times in the same MVXLAN IPv4 address family view, the most recent configuration takes effect.
Examples
# In MVXLAN IPv4 address family view of VPN instance vpna, specify 239.1.0.0 through 239.1.0.255 as the data group range.
<Sysname> system-view
[Sysname] multicast-vpn vxlan vpn-instance vpna mode mdt
[Sysname-mvxlan-vpna] address-family ipv4
[Sysname-mvxlan-vpna-ipv4] data-group 239.1.0.0 32
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
No default group exists.
Views
MVXLAN IPv4 address family view
Predefined user roles
network-admin
mdc-admin
Parameters
group-address: Specifies a default group in the range of 224.0.1.0 to 239.255.255.255.
Usage guidelines
The default group for an MVXLAN must be different from the default group and the data group used by any other MVXLAN.
Examples
# In MVXLAN IPv4 address family view of VPN instance vpna, specify 236.0.0.1 as the default group.
<Sysname> system-view
[Sysname] multicast-vpn vxlan vpn-instance vpna mode mdt
[Sysname-mvxlan-vpna] address-family ipv4
[Sysname-mvxlan-vpna-ipv4] default-group 236.0.0.1
display multicast-vpn vxlan data-group receive
Use display multicast-vpn vxlan data-group receive to display received data group information in an MVXLAN.
Syntax
display multicast-vpn vxlan { vpn-instance instance-name | public-instance } 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 instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.
public-instance: Specifies the public instance.
brief: Displays brief information. If you do not specify this keyword, the command displays detailed information.
active: Specifies data groups that have joined the data MDT.
group group-address: Specifies a data group by its IP address in the range of 224.0.1.0 to 239.255.255.255.
sender source-address: Specifies an MVXLAN source interface by its IP address.
vpn-source-address: Specifies a multicast source address of the specified VPN instance.
vpn-group-address: Specifies a multicast group address of the specified VPN instance. The value range for this argument is 224.0.1.0 to 239.255.255.255.
mask-length: Specifies a mask length of the specified multicast source address or multicast group address. The value range for this argument is 0 to 32, and the default is 32.
mask: Specifies a subnet mask of the specified multicast source address or multicast group address. The default is 255.255.255.255.
Usage guidelines
If you do not specify any parameters, this command displays detailed information about all received data groups in the MVXLAN of the specified VPN instance or the public instance.
Examples
# Display detailed information about received data groups in the MVXLAN of VPN instance vpna.
<Sysname> display multicast-vpn vxlan vpn-instance vpna data-group receive
VPN instance: vpna
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: 1.1.1.1 Active count: 1
(192.6.1.5, 239.1.1.1) Remaining lifetime: 00:03:10 active
(192.6.1.5, 239.1.1.158) Remaining lifetime: 00:03:10
Sender: 181.100.1.1 Active count: 1
(195.6.1.2, 239.1.2.12) Remaining lifetime: 00:03:10 active
(195.6.1.2, 239.1.2.197) Remaining lifetime: 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) Remaining lifetime: 00:03:10 active
(198.6.1.5, 225.1.1.109) Remaining lifetime: 00:03:10
Sender: 190.100.1.1 Active count: 1
(200.6.1.2, 225.1.4.80) Remaining lifetime: 00:03:10 active
(200.6.1.2, 225.1.4.173) Remaining lifetime: 00:03:10
# Display brief information about received data groups in the MVXLAN of VPN instance vpna.
<Sysname> display multicast-vpn vxlan vpn-instance vpna data-group receive brief
VPN instance: vpna
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 1 Command output
Field |
Description |
Total 2 data-groups for 8 entries |
A total of 2 data groups, associated with 8 (S, G) entries. |
Total 2 data-groups and 8 entries matched |
A total of 2 matching data groups, associated with 8 (S, G) entries. |
Data-group |
IP address of the received data group. |
Reference count |
Number of (S, G) entries that use the data group in the VPN instance. |
Active count |
Number of active (S, G) entries (entries with active receivers) that use the data group in the VPN instance. |
Sender |
Address of the VTEP that sent the data group. |
Remaining lifetime |
Remaining lifetime for the (S, G) entry that uses the data group in the VPN instance. |
active |
Indicates that the (S, G) entry is active. |
display multicast-vpn vxlan data-group send
Use display multicast-vpn vxlan data-group send to display sent data group information in an MVXLAN.
Syntax
display multicast-vpn vxlan { vpn-instance instance-name | public-instance } data-group send [ group group-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 instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.
public-instance: Specifies the public instance.
group group-address: Specifies a data group by its IP address in the range of 224.0.1.0 to 239.255.255.255.
vpn-source-address: Specifies a multicast source address of the specified VPN instance. The value range for this argument is 224.0.1.0 to 239.255.255.255.
vpn-group-address: Specifies a multicast group address of the specified VPN instance. The value range for this argument is 224.0.1.0 to 239.255.255.255.
mask-length: Specifies a mask length of the specified multicast source address or multicast group address. The value range for this argument is 0 to 32, and the default is 32.
mask: Specifies a subnet mask of the specified multicast source address or multicast group address. The default is 255.255.255.255.
Usage guidelines
If you do not specify any parameters, this command displays information about all sent data groups in the MVXLAN of the specified VPN instance or the public instance.
Examples
# Display information about all sent data groups in the MVXLAN of VPN instance vpna.
<Sysname> display multicast-vpn vxlan vpn-instance vpna data-group send
VPN instance: vpna
Total 2 data-groups for 6 entries
Total 2 data-groups and 6 entries matched
Data-group: 226.1.1.0 Reference count: 3
(192.6.1.5, 239.1.1.1) Switchover time: 00:00:21
(192.6.1.5, 239.1.1.158) Switchover time: 00:00:21
(192.6.1.5, 239.1.2.50) Switchover time: 00:00:05
Data-group: 226.1.1.1 Reference count: 3
(192.6.1.2, 225.1.1.1) Switchover time: 00:00:21
(192.6.1.2, 225.1.2.50) Switchover time: 00:00:05
(192.6.1.5, 239.1.1.159) Switchover time: 00:00:21
Table 2 Command output
Field |
Description |
Total 2 data-groups for 6 entries |
A total of 2 data groups, associated with 6 (S, G) entries. |
Total 2 data-groups and 6 entries matched |
A total of 2 matching data groups, associated with 6 (S, G) entries. |
Data-group |
Data group address. |
Reference count |
Number of (S, G) entries that use the data group in the VPN instance. |
Switchover time |
Switchover time of the (S, G) entry that uses the data group in the VPN instance. |
display multicast-vpn vxlan default-group
Use display multicast-vpn vxlan default-group to display information about default groups.
Syntax
display multicast-vpn vxlan [ vpn-instance instance-name | public-instance ] default-group { local | remote }
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.
public-instance: Specifies the public instance.
local: Specifies local default groups.
remote: Specifies remote default groups.
Usage guidelines
If you do not specify the vpn-instance instance-name option or the public-instance keyword, this command displays default group information for all VPN instances and the public instance.
Examples
# Display information about local default groups in all VPN instances and the public instance.
<Sysname> display multicast-vpn vxlan default-group local
MVXLAN local default-group information:
Group address Source address Interface VPN instance
239.1.1.1 1.1.1.1 MTunnel0 vpna
239.2.1.1 1.1.1.1 MTunnel1 vpnb
239.3.1.1 -- MTunnel2 vpnc
# Display information about remote default groups in all VPN instances and the public instance.
<Sysname> display multicast-vpn vxlan default-group remote
MVXLAN 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 c
Table 3 Command output
Field |
Description |
Group address |
IP address of the default group. |
Source address |
IP address of the MVXLAN source interface. This field displays two hyphens (--) if no source interface IP address is configured for the MVXLAN. |
Interface |
MVXLAN tunnel outgoing interface. |
Next hop |
Next hop address. |
VPN instance |
VPN instance to which the default group belongs. |
multicast extranet select-rpf
Use multicast extranet select-rpf to configure an IPv4 MVXLAN extranet RPF selection policy.
Use undo multicast extranet select-rpf to delete an IPv4 MVXLAN extranet RPF selection policy.
Syntax
multicast extranet select-rpf [ l3-vni vxlan-id | vpn-instance vpn-instance-name ] { group group-address { mask | mask-length } | source source-address { mask | mask-length } } *
undo multicast extranet select-rpf [ l3-vni vxlan-id | vpn-instance vpn-instance-name ] { group group-address { mask | mask-length } | source source-address { mask | mask-length } } *
Default
No IPv4 MVXLAN extranet RPF selection policies are configured.
Views
MRIB view
Predefined user roles
network-admin
mdc-admin
Parameters
l3-vni vxlan-id: Specifies the L3 VXLAN ID of the VPN instance to which the multicast source belongs. The value range for the vxlan-id argument is 0 to 16777215. If the multicast source belongs to the public network, do not specify this option.
vpn-instance vpn-instance-name: Specifies the MPLS L3VPN instance to which the multicast source belongs. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. The PIM routing entry will select this VPN instance for the upstream RPF neighbor. If the multicast source belongs to the public network, do not specify this option.
group group-address: Specifies a multicast group address in the policy. The address range is 224.0.1.0 to 239.255.255.255. If you do not this option, all multicast traffic that matches the source address in the policy in the source VPN instance will be directed to the receiver VPN instance.
source source-address: Specifies a source address in the policy, which can a multicast source address or the address of the RP designated to multicast groups. If you do not specify this option, all multicast traffic that matches the multicast group in the policy in the source VPN instance will be directed to the receiver VPN instance.
mask-length: Specifies a mask length for the multicast source address or the multicast group address. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.
mask: Specifies a subnet mask for the multicast source address or the multicast group address.
Usage guidelines
MVXLAN extranet RPF routing policies are used for multicast transmission when multicast sources and receivers are located in different VPNs.
MVXLAN extranet RPF selection policies identify the multicast traffic to forward between VPN instances based on the L3 VXLAN ID or VPN instance of traffic.
You cannot specify both an L3 VXLAN ID and an MPLS L3VPN instance for a multicast source address and multicast group address pair.
If the multicast source resides on the public network, do not specify an L3 VXLAN ID or MPLS L3VPN instance.
The PIM mode in the source VPN instance and the receiver VPN instance must be the same. Only PIM-SM and PIM-SSM are supported.
If an MVXLAN extranet RPF selection policy with only the multicast group address specified is configured in the receiver VPN instance, the intra-VPN multicast traffic transmission will be interrupted.
Multicast source addresses in different MVXLAN extranet RPF routing policies cannot be the same, but they can overlap. The same restriction applies to the multicast group addresses in different MVXLAN extranet RPF routing policies. If multiple routing policies exist for an (S, G) entry, the device selects the policy in which the multicast group address has the longest mask. If multiple policies have the same mask length, the device selects the policy in which the multicast source address has the longest mask.
Examples
# Configure an IPv4 MVXLAN extranet RPF selection policy to direct multicast traffic from VPN instance vpn-source to VPN instance vpn-receiver.
<Sysname> system-view
[Sysname] multicast routing vpn-instance vpn-receiver
[Sysname-mrib-vpn-receiver] multicast extranet select-rpf vpn-instance vpn-source source 192.168.10.0 24
[Sysname-mrib-vpn-receiver] multicast extranet select-rpf vpn-instance vpn-source source 1.1.1.1 24
multicast-vpn vxlan public-instance
Use multicast-vpn vxlan public-instance to create an MVXLAN for the public instance and enter its view, or enter the view of the existing public instance MVXLAN.
Use undo multicast-vpn vxlan public-instance to delete the public instance MVXLAN and all settings in public instance MVXLAN view.
Syntax
multicast-vpn vxlan public-instance mode mdt { ingress-replication | mdt }
undo multicast-vpn vxlan public-instance
Default
No MVXLAN exists in the public instance.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
mode: Specifies the MVXLAN mode.
ingress-replication: Sets the mode to ingress replication.
mdt: Sets the mode to MDT.
Examples
# Create an MDT-based MVXLAN for the public instance and enter public instance MVXLAN view.
<Sysname> system-view
[Sysname] multicast-vpn vxlan public-instance mode mdt
[Sysname—mvxlan-public-instance]
multicast-vpn vxlan vpn-instance
Use multicast-vpn vxlan vpn-instance to create an MVXLAN for a VPN instance and enter its view, or enter the view of an existing VPN instance MVXLAN.
Use undo multicast-vpn vxlan vpn-instance to delete a VPN instance MVXLAN and all settings in its view.
Syntax
multicast-vpn vxlan vpn-instance instance-name mode { ingress-replication | mdt }
undo multicast-vpn vxlan vpn-instance instance-name
Default
No MVXLAN exists in a VPN instance.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.
mode: Specifies the MVXLAN mode.
ingress-replication: Sets the mode to ingress replication.
mdt: Sets the mode to MDT.
Examples
# Create an MDT-based MVXLAN for VPN instance vpna and enter VPN instance MVXLAN view.
<Sysname> system-view
[Sysname] multicast-vpn vxlan vpn-instance vpna mode mdt
[Sysname—mvxlan-vpna]
pim distributed-dr
Use pim distributed-dr to configure a VSI interface as a distributed DR interface.
Use undo pim distributed-dr to restore the default.
Syntax
pim distributed-dr
undo pim distributed-dr
Default
A VSI instance is not a distributed DR interface.
Views
VSI interface view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
On the VTEPs configured with MVXLAN, you must specify the VSI interfaces that act as distributed EVPN gateways as distributed DR interfaces. This operation ensures that a distributed EVPN gateway can forward multicast traffic to the local site.
Examples
# Configure VSI-interface 1 as a distributed DR interface.
<Sysname> system-view
[Sysname] interface vsi-interface 1
[Sysname-Vsi-interface1] pim distributed-dr
source
Use source to specify an MVXLAN source interface.
Use undo source to restore the default.
Syntax
source interface-type interface-number
undo source
Default
No MVXLAN source interface is specified.
Views
MVXLAN IPv4 address family view
Predefined user roles
network-admin
mdc-admin
Parameters
interface-type interface-number: Specify an interface by its type and number.
Usage guidelines
For the VTEP to obtain correct routing information, you must specify the interface used for establishing BGP peer relationship as the MVXLAN source interface.
Examples
# In MVXLAN IPv4 address family view of VPN instance vpna, specify Loopback 0 as the MVXLAN source interface. (Loopback 0 is the source interface used for establishing BGP peer relationship.)
<Sysname> system-view
[Sysname] multicast-vpn vxlan vpn-instance vpna mode mdt
[Sysname-mvxlan-vpna] address-family ipv4
[Sysname-mvxlan-vpna-ipv4] source loopback 0