18-EVPN Command Reference

HomeSupportSwitchesH3C S12500G-AF Switch SeriesReference GuidesCommand ReferencesH3C S12500G-AF Switch Series Command References-Release759X-6W10018-EVPN Command Reference
02-MVXLAN commands
Title Size Download
02-MVXLAN commands 95.31 KB

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

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网