group (IPv4 address family MVPN-SPMSI view)

Format

group group-address { group-mask | group-mask-length } [ source source-address { source-mask | source-mask-length } ] [ threshold threshold-value ] { mldp | rsvp-te p2mp-template p2mp-te-template-name | bier [ sub-domain sub-domain-val ] [ bsl { 64 | 128 | 256 } ] } [ limit number ]

undo group group-address { group-mask | group-mask-length } [ source source-address { source-mask | source-mask-length } ]

Parameters

Parameter	Description	Value
group-address	Specifies a group address for switching between I-PMSI and S-PMSI tunnels.	The value ranges from 224.0.0.0 to 239.255.255.255, in dotted decimal notation.
group-mask	Specifies a mask for a group address.	The value ranges from 240.0.0.0 to 255.255.255.255, in dotted decimal notation.
group-mask-length	Specifies mask length for a group address.	The value is an integer ranging from 4 to 32.
source source-address	Specifies a source address for switching between I-PMSI and S-PMSI tunnels.	The value can be a Class A, Class B, or Class C address, in dotted decimal notation.
source-mask	Specifies a mask for a source address.	The value is in dotted decimal notation.
source-mask-length	Specifies mask length for a source address.	The value is an integer ranging from 0 to 32.
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.
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.
bier	Indicates a BIER tunnel.	-
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.	The values are as follows: 64,128 and 256 The default value is 256.
limit number	Specifies the maximum number of S-PMSI tunnels allowed.	The value is an integer ranging from 1 to 8192. For the MLDP/RSVP-TE tunnel type, the default value is 16. For the BIER tunnel type, the default value is 256. 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 the entries corresponding to the deleted S-PMSI tunnels will be switched first to the I-PMSI tunnel and then to specific S-PMSI tunnels.

Views

IPv4 address family MVPN-SPMSI view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
mvpn	write

Usage Guidelines

Usage Scenario

An 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

In (S, G) mode, each VPN instance and device can be configured with a maximum of 1024 and 16384 such commands, respectively. The maximum limit value in each configuration is 8192. Each VPN instance can be configured with a maximum of 8192 S-PMSI tunnels.
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.
In actual switching from the I-PMSI tunnel to an S-PMSI tunnel, due to necessary traffic rate calculation and protocol processing, there is a lag of 1 to 30 seconds between the time the multicast data forwarding rate changes and the time a VPN instance starts the switch-delay timer.
Before configuring switching criteria for an (S, G) S-PMSI tunnel, configure an I-PMSI tunnel or (*, *) S-PMSI tunnel in a VPN instance.

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 10.1.1.1, group address as 225.1.1.1, mask length as 24, switching threshold as 10, and S-PMSI tunnel type as mLDP.

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