group (IPv6 address family MVPN-SPMSI view)

Function

The group command configures the address pool range and criteria for switching between Inclusive-Provider Multicast Service Interface (I-PMSI) and Selective-Provider Multicast Service Interface (S-PMSI) tunnels.

The undo group command restores the default configuration.

By default, no address pool range or criteria are configured for switching between I-PMSI and S-PMSI tunnels.

Format

group group-address group-mask-length [ source source-address source-mask-length ] [ threshold threshold-value ] { bier [ sub-domain sub-domain-val ] [ bsl { 64 | 128 | 256 } ] } [ limit number ]

group group-address group-mask-length [ source source-address source-mask-length ] [ threshold threshold-value ] { mldp } [ limit number ]

group group-address group-mask-length [ source source-address source-mask-length ] [ threshold threshold-value ] { rsvp-te p2mp-template p2mp-te-template-name } [ limit number ]

undo group group-address group-mask-length [ source source-address source-mask-length ]

Parameters

Parameter	Description	Value
group-address	Specifies a group address for switching between I-PMSI and S-PMSI tunnels.	The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X. The value ranges from FF00:: to FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
group-mask-length	Specifies mask length for a group address.	The value is an integer ranging from 8 to 128.
source source-address	Specifies a source address for switching between I-PMSI and S-PMSI tunnels.	The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
source-mask-length	Specifies mask length for a source address.	The value is an integer ranging from 0 to 128.
threshold threshold-value	Specifies a threshold that triggers a switchover between the I-PMSI tunnel and the S-PMSI tunnel. If the multicast data forwarding rate of a VPN exceeds threshold-value, the system performs a switchover from the I-PMSI tunnel to the S-PMSI tunnel, but the system starts to use the S-PMSI tunnel for data forwarding after a delay (the delay can be specified using the switch-delay command). If the multicast data forwarding rate of a VPN falls below threshold-value, the system performs a switchback from the S-PMSI tunnel to the I-PMSI, but the system starts to use the I-PMSI for data forwarding after a delay (the delay can be specified using the holddown-time command).	The value is an integer ranging from 0 to 4194304, in kbit/s. If the default value 0 is used, the VPN instance does not detect the multicast data forwarding rate and switches multicast data from the I-PMSI tunnel to an S-PMSI tunnel immediately after the switch-delay timer expires.
bier	Specifies the S-PMSI tunnel type as BIER.	-
sub-domain sub-domain-val	Specifies the ID of a BIER subdomain.	The value is an integer ranging from 0 to 255.
bsl	Specifies a BSL in BIER encapsulation.	The value can be 64, 128, or 256.
limit number	Specifies the maximum number of S-PMSI tunnels allowed.	The value is an integer ranging from 1 to 8192. The default value is 16 for MLDP or RSVP-TE tunnels and 256 for BIER tunnels. After limit number is changed to a larger value, the traffic of newly added multicast groups in S-PMSI tunnel will preferentially be switched to idle S-PMSI tunnels. After limit number is changed to a smaller value, the traffic of all multicast groups will be switched first to the I-PMSI tunnel and then to specific S-PMSI tunnels.
mldp	Specifies the S-PMSI tunnel type as mLDP.	-
rsvp-te	Specifies the S-PMSI tunnel type as RSVP-TE.	-
p2mp-template p2mp-te-template-name	Specifies the name of a tunnel template to be referenced by an RSVP-TE P2MP tunnel.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported.

Views

IPv6 address family MVPN-SPMSI view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
mvpn	write

Usage Guidelines

Usage Scenario

An IPv6 NG MVPN uses the I-PMSI tunnel to send multicast data to receivers. The I-PMSI tunnel connects to all PEs on the MVPN and sends multicast data to these PEs regardless of whether these PEs have receivers. If some PEs do not have receivers, this implementation will cause redundant traffic, wasting bandwidth resources and increasing PEs' burdens.

S-PMSI tunnels solve this problem by sending multicast data only to PEs interested in the data.

To configure the address pool range and criteria for switching between I-PMSI and S-PMSI tunnels, run the group command.

Precautions

Up to 1024 such commands can be configured for each VPN, and up to 16384 such commands can be configured on an entire device, and the maximum limit value in a group command configuration is 8192. Up to 8192 S-PMSI tunnels can be configured for each VPN instance.
If the address pool range specified in a group command overlaps with a previously configured address pool range, the command cannot be configured. If you want to change the tunnel type configured for an address pool range, you must delete the existing group command configuration and then run the group command with the desired tunnel type.

Example

# Configure the address pool range and criteria for switching between I-PMSI and S-PMSI tunnels for the VPN instance mcast1. Specifically, configure the source address as 1::1, group address as FF37::1, mask length as 64, switching threshold as 10, and S-PMSI tunnel type as mLDP.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 mvpn 2.2.2.2
[*HUAWEI] ip vpn-instance mcast1
[*HUAWEI-vpn-instance-mcast1] ipv6-family
[*HUAWEI-vpn-instance-mcast1-af-ipv6] route-distinguisher 22:1
[*HUAWEI-vpn-instance-mcast1-af-ipv6] multicast ipv6 routing-enable
[*HUAWEI-vpn-instance-mcast1-af-ipv6] mvpn
[*HUAWEI-vpn-instance-mcast1-af-ipv6-mvpn] ipmsi-tunnel
[*HUAWEI-vpn-instance-mcast1-af-ipv6-mvpn-ipmsi] mldp
[*HUAWEI-vpn-instance-mcast1-af-ipv6-mvpn-ipmsi] quit
[*HUAWEI-vpn-instance-mcast1-af-ipv6-mvpn] spmsi-tunnel
[*HUAWEI-vpn-instance-mcast1-af-ipv6-mvpn-spmsi] group FF37::1 64 source 1::1 64 threshold 10 mldp