Multicast Management
This section describes the configuration model of multicast route management and provides examples of XML packets.
Enabling Multicast Routing
This section describes the configuration model for enabling multicast routing and provides examples of XML packets.
Data Model
The configuration model file for enabling multicast routing is huawei-mcastbase.yang.
Object |
Description |
Value | Remarks |
---|---|---|---|
/huawei-mcastbase:mcastbase/mcastAfsEnables/mcastAfsEnable/vrfName |
Indicates the name of the VPN instance. |
The value must be an existing VPN instance name. |
NA |
/huawei-mcastbase:mcastbase/mcastAfsEnables/mcastAfsEnable/vrfName/addrFamily |
Indicates the VPN instance address family. |
- |
NA |
Enabling Multicast Routing
This section provides a sample of enabling multicast routing using the edit-config method.
Operation |
XPATH |
---|---|
edit-config |
|
Data Requirement
Item |
Data |
Description |
---|---|---|
VPN instance name |
ddd |
- |
VPN instance address family |
ipv4unicast |
- |
Request Example
Enable multicast routing.
<?xml version="1.0" encoding="utf-8"?> <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="10"> <edit-config> <target> <running/> </target> <config> <mcastbase:mcastbase xmlns:mcastbase="http://www.huawei.com/netconf/vrp/huawei-mcastbase"> <mcastbase:mcastAfsEnables> <mcastbase:mcastAfsEnable> <mcastbase:vrfName>ddd</mcastbase:vrfName> <mcastbase:addressFamily>ipv4unicast</mcastbase:addressFamily> </mcastbase:mcastAfsEnable> </mcastbase:mcastAfsEnables> </mcastbase:mcastbase> </config> </edit-config> </rpc>
Response Example
Sample of successful response
<?xml version="1.0" encoding="utf-8"?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="10"> <ok/> </rpc-reply>
Sample of failed response
<?xml version="1.0" encoding="utf-8"?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="14"> <rpc-error> <error-type>application</error-type> <error-tag>operation-failed</error-tag> <error-severity>error</error-severity> <error-path>/huawei-mcastbase:mcastbase/mcastAfsEnables/mcastAfsEnable[vrfName='ddd'][addressFamily='ipv4uni cast']/addressFamily</error-path> <error-message>parse rpc config error.(Invalid value in "addressFamily" element.).</error-message> </rpc-error> </rpc-reply>
Configuring IGMP User Access
This section describes the configuration model of IGMP user access and provides examples of XML packets.
Data Model
The configuration model file matching IGMP user access is huawei-dgmp.yang.
Object |
Description |
Value | Remarks |
---|---|---|---|
/huawei-dgmp:dgmp/dgmpIfCfgs/dgmpIfCfg/vrfName |
Indicates the name of the VPN instance. |
The value must be an existing VPN instance name. |
NA |
/huawei-dgmp:dgmp/dgmpIfCfgs/dgmpIfCfg/addrFamily |
Indicates the VPN instance address family. |
- |
NA |
/huawei-dgmp:dgmp/dgmpIfCfgs/dgmpIfCfg/ifName |
Indicates the interface on which IGMP is configured. |
The value is a string of characters in the format interface-typeinterface-number, in which:
|
NA |
/huawei-dgmp:dgmp/dgmpIfCfgs/dgmpIfCfg/gmpEnable |
Indicates whether to enable IGMP. |
The value is of the Boolean type:
The default value is false. |
NA |
/huawei-dgmp:dgmp/dgmpIfCfgs/dgmpIfCfg/version |
Indicates the IGMP version running on the interface. |
The value is an integer that ranges from 1 to 3. |
NA |
Configuring IGMP User Access
This section provides a sample of configuring IGMP user access using the edit-config method.
Operation |
XPATH |
---|---|
edit-config |
|
Data Requirements
Item |
Data |
Description |
---|---|---|
VPN instance name |
ddd |
- |
VPN instance address family |
ipv4unicast |
- |
Interface on which IGMP is configured |
Vlanif10 |
- |
Whether to enable IGMP |
false |
- |
IGMP version running on the interface |
3 |
- |
Request Example
Configure IGMP user access.
<?xml version="1.0" encoding="utf-8"?> <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="10"> <edit-config> <target> <running/> </target> <config> <dgmp:dgmp xmlns:dgmp="http://www.huawei.com/netconf/vrp/huawei-dgmp"> <dgmp:dgmpIfCfgs> <dgmp:dgmpIfCfg> <dgmp:addrFamily>ipv4unicast</dgmp:addrFamily> <dgmp:ifName>Vlanif10</dgmp:ifName> <dgmp:gmpEnable>false</dgmp:gmpEnable> <dgmp:version>3</dgmp:version> </dgmp:dgmpIfCfg> </dgmp:dgmpIfCfgs> </dgmp:dgmp> <mcastbase:mcastbase xmlns:mcastbase="http://www.huawei.com/netconf/vrp/huawei-mcastbase"> <mcastbase:mcastAfsEnables> <mcastbase:mcastAfsEnable> <mcastbase:vrfName>ddd</mcastbase:vrfName> <mcastbase:addressFamily>ipv4unicast</mcastbase:addressFamily> </mcastbase:mcastAfsEnable> </mcastbase:mcastAfsEnables> </mcastbase:mcastbase> </config> </edit-config> </rpc>
Response Example
Sample of successful response
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="10"> <ok/> </rpc-reply>
Sample of failed response
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="10"> <rpc-error> <error-type>application</error-type> <error-tag>invalid-value</error-tag> <error-severity>error</error-severity> <error-path>/huawei-dgmp:dgmp/dgmpIfCfgs/dgmpIfCfg[addrFamily='ipv4unicast'][ifName='Vlanif10']/ifName</error-path> <error-message>validation failed(Leafref "/ietf-interfaces:interfaces/ietf-interfaces:interface/ietf-interfaces:name" of value "Vlanif10" points to a non-existing leaf.).</error-message> </rpc-error> </rpc-reply>
Configuring PIM-DM/PIM-SM Multicast Routing
This section describes the configuration model of PIM-DM/PIM-SM multicast routing and provides examples of XML packets.
Data Model
The configuration model file matching PIM-DM/PIM-SM multicast routing is huawei-pim.yang.
Object |
Description |
Value |
Remarks |
---|---|---|---|
/huawei-pim:pim/bsrafspro/bsrAfsSiteCfgs/bsrAfsSiteCfg/vrfName |
Indicates the name of the VPN instance. |
The value must be an existing VPN instance name. |
NA |
/huawei-pim:pim/bsrafspro/bsrAfsSiteCfgs/bsrAfsSiteCfg/addressFamily |
Indicates the address family. |
- |
NA |
/huawei-pim:pim/bsrafspro/bsrAfsSiteCfgs/bsrAfsSiteCfg/cBsrIfName |
C-BSR |
- |
NA |
/huawei-pim:pim/bsrafspro/bsrAf4CrpCfgs/bsrAf4CrpCfg/cRpIfName |
C-RP |
- |
NA |
/huawei-pim:pim/bsrafspro/bsrAf4CrpCfgs/bsrAf4CrpCfg/vrfName |
Indicates the name of the VPN instance. |
The value must be an existing VPN instance name. |
NA |
/huawei-pim:pim/pimafspro/pimAfsIfCfgs/pimAfsIfCfg/vrfName |
Indicates the name of the VPN instance. |
The value must be an existing VPN instance name. |
NA |
/huawei-pim:pim/pimafspro/pimAfsIfCfgs/pimAfsIfCfg/addressFamily |
Indicates the address family. |
- |
NA |
/huawei-pim:pim/pimafspro/pimAfsIfCfgs/pimAfsIfCfg/ifName |
Indicates the interface on which C-BSR or C-RP is configured. |
The value is a string of characters in the format interface-typeinterface-number, in which:
|
NA |
/huawei-pim:pim/pimafspro/pimAfsIfCfgs/pimAfsIfCfg/pimMode |
Indicates the work mode of a PIM router. |
The value is of the enumerated type:
|
NA |
Configuring PIM-DM/PIM-SM Multicast Routing
This section provides a sample of configuring PIM-DM/PIM-SM multicast routing using the edit-config method.
Operation |
XPATH |
---|---|
edit-config |
|
Data Requirements
Item |
Data |
Description |
---|---|---|
VPN instance name |
ddd |
- |
VPN instance address family |
ipv4unicast |
- |
Route Distinguisher (RD) for the VPN instance address family |
100:2 |
- |
Interface on which C-BSR or C-RP is configured |
Vlanif10 |
- |
PIM work mode |
Sparse |
- |
Request Example
Configure PIM-DM/PIM-SM multicast routing.
<?xml version="1.0" encoding="utf-8"?> <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="10"> <edit-config> <target> <running/> </target> <config> <if:interfaces xmlns:if="urn:ietf:params:xml:ns:yang:ietf-interfaces"> <if:interface> <if:name>Vlanif10</if:name> <if:type xmlns:ianaift="urn:ietf:params:xml:ns:yang:iana-if-type">ianaift:propVirtual</if:type> </if:interface> </if:interfaces> <mcastbase:mcastbase xmlns:mcastbase="http://www.huawei.com/netconf/vrp/huawei-mcastbase"> <mcastbase:mcastAfsEnables> <mcastbase:mcastAfsEnable> <mcastbase:vrfName>ddd</mcastbase:vrfName> <mcastbase:addressFamily>ipv4unicast</mcastbase:addressFamily> </mcastbase:mcastAfsEnable> </mcastbase:mcastAfsEnables> </mcastbase:mcastbase> <pim:pim xmlns:pim="http://www.huawei.com/netconf/vrp/huawei-pim"> <pim:bsrafspro> <pim:bsrAfsSiteCfgs> <pim:bsrAfsSiteCfg> <pim:vrfName>ddd</pim:vrfName> <pim:addressFamily>ipv4unicast</pim:addressFamily> <pim:cBsrIfName>Vlanif10</pim:cBsrIfName> </pim:bsrAfsSiteCfg> </pim:bsrAfsSiteCfgs> <pim:bsrAf4CrpCfgs> <pim:bsrAf4CrpCfg> <pim:cRpIfName>Vlanif10</pim:cRpIfName> <pim:vrfName>ddd</pim:vrfName> </pim:bsrAf4CrpCfg> </pim:bsrAf4CrpCfgs> </pim:bsrafspro> <pim:pimafspro> <pim:pimAfsIfCfgs> <pim:pimAfsIfCfg> <pim:vrfName>ddd</pim:vrfName> <pim:addressFamily>ipv4unicast</pim:addressFamily> <pim:ifName>Vlanif10</pim:ifName> <pim:pimMode>Sparse</pim:pimMode> </pim:pimAfsIfCfg> </pim:pimAfsIfCfgs> </pim:pimafspro> </pim:pim> <hw-l3vpn:vpn-instances xmlns:hw-l3vpn="urn:huawei:params:xml:ns:yang:huawei-l3vpn"> <hw-l3vpn:vpn-instance> <hw-l3vpn:vpn-instance-name>ddd</hw-l3vpn:vpn-instance-name> <hw-bgp-vpn:ipv4-family xmlns:hw-bgp-vpn="urn:huawei:params:xml:ns:yang:huawei-bgp-l3vpn"> <hw-bgp-vpn:route-distinguisher>100:2</hw-bgp-vpn:route-distinguisher> </hw-bgp-vpn:ipv4-family> </hw-l3vpn:vpn-instance> </hw-l3vpn:vpn-instances> </config> </edit-config> </rpc>
Response Example
Sample of successful response
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="10"> <ok/> </rpc-reply>
Sample of failed response
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="10"> <rpc-error> <error-app-tag>1</error-app-tag> <error-message>Service process failed.</error-message> </rpc-error> <rpc-error> <error-app-tag>-1</error-app-tag> <error-message> Please disable IGMP Snooping in the VLAN view first.</error-message> <error-info>Error on node /huawei-pim:pim/pimafspro/pimAfsIfCfgs/pimAfsIfCfg[vrfName="ddd",addressFamily="ipv4unicast",ifName="Vlanif10"]</error-info> </rpc-error> </rpc-reply>
Configuring IGMP Snooping
This section describes the configuration model of IGMP snooping and provides examples of XML packets.
Data Model
The configuration model files matching IGMP snooping are huawei-l2mc.yang and huawei-igmp-mld-snooping.yang
Object |
Description |
Value |
Remarks |
---|---|---|---|
/huawei-l2mc:l2mc/l2McSnpgEnables/l2McSnpgEnable/addrFamily |
Indicates a VPN instance address family. |
- |
N/A |
/huawei-l2mc:l2mc/vlan/l2McVlanCfgs/l2McVlanCfg/addrFamily |
Indicates a VPN instance address family. |
- |
N/A |
/huawei-l2mc:l2mc/vlan/l2McVlanCfgs/l2McVlanCfg/vlanId |
Specifies the ID of a VLAN in which IGMP snooping is enabled. |
The value is an integer in the range from 1 to 4094. |
N/A |
/huawei-l2mc:l2mc/vlan/l2McVlanCfgs/l2McVlanCfg/version |
Specifies the version of IGMP messages that can be processed. |
The value is an integer in the range from 1 to 3.
|
N/A |
/huawei-l2mc:l2mc/vlan/l2McMVlanCfgs/l2McMVlanCfg/vlanId |
Specifies a multicast VLAN ID. |
The value is an integer in the range from 1 to 4094. |
N/A |
/huawei-l2mc:l2mc/vlan/l2McMVlanCfgs/l2McMVlanCfg/mcastVlanEnable |
Indicates whether to enable the multicast VLAN. |
The value is of the Boolean type:
The default value is false. |
N/A |
/huawei-l2mc:l2mc/vlan/l2McMVlanCfgs/l2McMVlanCfg/userVlans |
Specifies a user VLAN ID. |
The value is an integer in the range from 1 to 4094. |
N/A |
/huawei-l2mc:l2mc/vlan/l2McVlanCfgs/l2McVlanCfg/fwdMode |
Specifies the multicast data forwarding mode in a VLAN. |
The value is of the enumerated type:
The default value is ip. |
N/A |
/mc:multicast/ims:igmp-snooping/global-enable |
Indicates whether to enable IGMP snooping globally. |
The value is of the Boolean type:
The default value is false. |
N/A |
/mc:multicast/ims:igmp-snooping/global-enable/over-vxlan |
Indicates whether to enable IGMP snooping for VXLAN. |
The value is of the Boolean type:
The default value is false. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
Object |
Description |
Value |
Remarks |
---|---|---|---|
/bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/enable |
Indicates whether to enable IGMP snooping in a BD. |
The value is of the Boolean type:
The default value is false. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/report-suppress |
Indicates whether to enable suppression of IGMP Report and Leave messages in a BD. |
The value is of the Boolean type:
The default value is false. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/require-router-alert |
Configures the function of checking for the Router-Alert option in a BD and discarding the IGMP messages without the Router-Alert option. |
The value is of the Boolean type:
The default value is false. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/send-router-alert |
Indicates whether the IGMP messages sent to a BD carry the Router-Alert option. |
The value is of the Boolean type:
The default value is true. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/version |
Configures the version of IGMP messages that can be processed by IGMP snooping in a BD. |
The value is an integer in the range from 1 to 3.
The default value is 2. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-bd:bridge-domains/bridge-domain/huawei-igmp-mld-snooping:igmp-snooping/global/immediately-leave |
Indicates whether to enable the fast leave function in a BD so that member interfaces in the BD can fast leave multicast groups. |
The value is of the Boolean type:
The default value is false. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-bd:bridge-domains/bridge-domain/huawei-igmp-mld-snooping:igmp-snooping/global/querier-enable |
Indicates whether to enable the IGMP snooping querier function in a BD. |
The value is of the Boolean type:
The default value is false. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-bd:bridge-domains/bridge-domain/huawei-igmp-mld-snooping:igmp-snooping/global/router-aging-time |
Specifies the aging time of dynamic routed interfaces in a BD. |
The value is an integer in the range from 1 to 1000, in seconds. The default value is 180 or same as the Holdtime value contained in PIM Hello messages. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-bd:bridge-domains/bridge-domain/huawei-igmp-mld-snooping:drop-unknown |
Configures the function of discarding unknown multicast packets received in a BD. |
The value is of the Boolean type:
The default value is false. |
NA |
/bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/max-response-time |
Specifies the maximum response time for IGMP General Query messages in a BD. |
The value is an integer in the range from 1 to 25, in seconds. The default value is 10. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/static-group-suppress-dynamic-join |
Configures the function of forbidding the device from forwarding IGMP Report and Leave messages that are received in a BD and contain a static group address to upstream Layer 3 devices configured with the static group address. |
The value is of the Boolean type:
The default value is false. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/query-interval |
Specifies the interval for sending IGMP General Query messages in a BD. |
The value is an integer in the range from 1 to 65535, in seconds. The default value is 60. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/robustness |
Specifies the IGMP robustness variable in a BD, which indicates how many times IGMP Query messages are sent. |
The value is an integer in the range from 2 to 5. The default value is 2. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/last-member-query-interval |
Specifies the last member query interval in a BD, that is, the interval at which Group-Specific Query messages are sent in the BD. |
The value is an integer in the range from 1 to 5, in seconds. The default value is 1. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
Object |
Description |
Value |
Remarks |
---|---|---|---|
/huawei-vlan:vlans/vlan/ims:igmp-snooping/global/enable |
Indicates whether to enable IGMP snooping in a VLAN. |
The value is of the Boolean type:
The default value is false. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-vlan:vlans/vlan/ims:igmp-snooping/global/report-suppress |
Indicates whether to enable suppression of IGMP Report and Leave messages in a VLAN. |
The value is of the Boolean type:
The default value is false. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-vlan:vlans/vlan/ims:igmp-snooping/global/require-router-alert |
Configures the function of checking for the Router-Alert option in a VLAN and discarding the IGMP messages without the Router-Alert option. |
The value is of the Boolean type:
The default value is false. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-vlan:vlans/vlan/ims:igmp-snooping/global/send-router-alert |
Indicates whether the IGMP messages sent to a VLAN carry the Router-Alert option. |
The value is of the Boolean type:
The default value is true. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-vlan:vlans/vlan/ims:igmp-snooping/global/version |
Configures the version of IGMP messages that can be processed by IGMP snooping in a VLAN. |
The value is an integer in the range from 1 to 3.
The default value is 2. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-vlan:vlans/vlan/huawei-igmp-mld-snooping:igmp-snooping/global/immediately-leave |
Indicates whether to enable the fast leave function in a VLAN so that member interfaces in the VLAN can fast leave multicast groups. |
The value is of the Boolean type:
The default value is false. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-vlan:vlans/vlan/huawei-igmp-mld-snooping:igmp-snooping/global/querier-enable |
Indicates whether to enable the IGMP snooping querier function in a VLAN. |
The value is of the Boolean type:
The default value is false. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-vlan:vlans/vlan/huawei-igmp-mld-snooping:igmp-snooping/global/router-aging-time |
Specifies the aging time of dynamic routed interfaces in a VLAN. |
The value is an integer in the range from 1 to 1000, in seconds. The default value is 180 or same as the Holdtime value contained in PIM Hello messages. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-vlan:vlans/vlan/huawei-igmp-mld-snooping:drop-unknown |
Configures the function of discarding unknown multicast packets received in a VLAN. |
The value is of the Boolean type:
The default value is false. |
NA |
/huawei-vlan:vlans/vlan/ims:igmp-snooping/global/max-response-time |
Specifies the maximum response time for IGMP General Query messages in a VLAN. |
The value is an integer in the range from 1 to 25, in seconds. The default value is 10. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-vlan:vlans/vlan/ims:igmp-snooping/global/static-group-suppress-dynamic-join |
Configures the function of forbidding the device from forwarding IGMP Report and Leave messages that are received in a VLAN and contain a static group address to upstream Layer 3 devices configured with the static group address. |
The value is of the Boolean type:
The default value is false. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-vlan:vlans/vlan/ims:igmp-snooping/global/query-interval |
Specifies the interval for sending IGMP General Query messages in a VLAN. |
The value is an integer in the range from 1 to 65535, in seconds. The default value is 60. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-vlan:vlans/vlan/ims:igmp-snooping/global/robustness |
Specifies the IGMP robustness variable in a VLAN, which indicates how many times IGMP Query messages are sent. |
The value is an integer in the range from 2 to 5. The default value is 2. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
/huawei-vlan:vlans/vlan/ims:igmp-snooping/global/last-member-query-interval |
Specifies the last member query interval in a VLAN, that is, the interval at which Group-Specific Query messages are sent in the VLAN. |
The value is an integer in the range from 1 to 5, in seconds. The default value is 1. |
Before configuring this object, set /mc:multicast/ims:igmp-snooping/global-enable to true. |
Configuring IGMP Snooping-based Layer 2 Multicast
This section provides a sample of configuring IGMP snooping-based Layer 2 multicast using the edit-config method.
Operation |
XPATH |
---|---|
edit-config |
|
Data Requirements
Item |
Data |
Description |
---|---|---|
VPN instance address family |
ipv4unicast |
- |
VLAN ID for which IGMP snooping is enabled |
10 |
- |
Version of IGMP messages that can be processed |
1 |
- |
Multicast data forwarding mode in a VLAN |
ip |
- |
Multicast VLAN ID |
10 |
- |
Whether to enable the multicast VLAN |
true |
- |
User VLAN ID |
15,20-30 |
- |
Request Example
Configure IGMP snooping-based Layer 2 multicast.
<?xml version="1.0" encoding="utf-8"?> <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id=""> <edit-config> <target> <running/> </target> <config> <l2mc:l2mc xmlns:l2mc="http://www.huawei.com/netconf/vrp/huawei-l2mc"> <l2mc:l2McSnpgEnables> <l2mc:l2McSnpgEnable> <l2mc:addrFamily>ipv4unicast</l2mc:addrFamily> </l2mc:l2McSnpgEnable> </l2mc:l2McSnpgEnables> <l2mc:vlan> <l2mc:l2McVlanCfgs> <l2mc:l2McVlanCfg> <l2mc:addrFamily>ipv4unicast</l2mc:addrFamily> <l2mc:vlanId>10</l2mc:vlanId> <l2mc:version>1</l2mc:version> <l2mc:fwdMode>ip</l2mc:fwdMode> </l2mc:l2McVlanCfg> </l2mc:l2McVlanCfgs> <l2mc:l2McMVlanCfgs> <l2mc:l2McMVlanCfg> <l2mc:vlanId>10</l2mc:vlanId> <l2mc:mcastVlanEnable>true</l2mc:mcastVlanEnable> <l2mc:userVlans>15,20-30</l2mc:userVlans> </l2mc:l2McMVlanCfg> </l2mc:l2McMVlanCfgs> </l2mc:vlan> </l2mc:l2mc> </config> </edit-config> </rpc>
Response Example
Sample of successful response
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id=""> <ok/> </rpc-reply>
Sample of failed response
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id=""> <rpc-error> <error-app-tag>-1</error-app-tag> <error-message> This VLAN 10 is not a multicast VLAN. </error-message> </rpc-error> <rpc-error> <error-app-tag>-1</error-app-tag> <error-message> This VLAN 10 is not a multicast VLAN. </error-message> <error-info>Error on node /huawei-l2mc:l2mc/vlan/l2McMVlanCfgs/l2McMVlanCfg[vlanId="10"]</error-info> </rpc-error> </rpc-reply>
Configuring IGMP Snooping in a BD
This section provides a sample of configuring IGMP snooping in a BD using the edit-config method.
Operation |
XPATH |
---|---|
edit-config |
/mc:multicast/ims:igmp-snooping/global-enable/over-vxlan /bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/enable /bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/report-suppress /bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/require-router-alert /bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/send-router-alert /bd:bridge-domains/bridge-domain/ims:igmp-snooping/global/version /huawei-bd:bridge-domains/bridge-domain/huawei-igmp-mld-snooping:igmp-snooping/global/immediately-leave /huawei-bd:bridge-domains/bridge-domain/huawei-igmp-mld-snooping:igmp-snooping/global/querier-enable /huawei-bd:bridge-domains/bridge-domain/huawei-igmp-mld-snooping:igmp-snooping/global/router-aging-time /huawei-bd:bridge-domains/bridge-domain/huawei-igmp-mld-snooping: drop-unknown |
Data Requirements
Item |
Data |
Description |
---|---|---|
Whether to enable IGMP snooping in the BD view |
true |
- |
Whether to enable suppression of IGMP Report and Leave messages in a BD |
true |
- |
Whether to enable the device to check for the Router-Alert option and discard the IGMP messages without the Router-Alert option |
true |
- |
Whether the IGMP messages sent to a BD carry the Router-Alert option |
false |
- |
Version of IGMP messages that can be processed by IGMP snooping in a BD |
3 |
- |
Fast leave function for member interfaces in a BD to fast leave multicast groups |
true |
- |
IGMP snooping querier function in a BD |
true |
- |
Aging time of dynamic router ports in a BD |
200 |
- |
Whether to enable the device to discard unknown multicast packets received in a BD |
true |
- |
Request Example
<?xml version="1.0" encoding="utf-8"?> <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="46"> <edit-config> <target> <running/> </target> <config xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"> <multicast xmlns="urn:huawei:yang:huawei-multicast" xmlns:mc="urn:huawei:yang:huawei-multicast"> <igmp-snooping xmlns="urn:huawei:yang:huawei-igmp-mld-snooping" nc:operation="replace"> <global-enable> <over-vxlan>true</over-vxlan> </global-enable> </igmp-snooping> </multicast> <bd:bridge-domains xmlns:bd="urn:huawei:params:xml:ns:yang:huawei-bd" nc:operation="replace"> <bd:bridge-domain> <bd:id>5</bd:id> <ims:drop-unknown xmlns:ims="urn:huawei:yang:huawei-igmp-mld-snooping">true</ims:drop-unknown> <ims:igmp-snooping xmlns:ims="urn:huawei:yang:huawei-igmp-mld-snooping"> <ims:global> <ims:enable>true</ims:enable> <ims:report-suppress>true</ims:report-suppress> <ims:send-router-alert>false</ims:send-router-alert> <ims:require-router-alert>true</ims:require-router-alert> <ims:version>3</ims:version> <ims:immediately-leave>true</ims:immediately-leave> <ims:querier-enable>true</ims:querier-enable> <ims:router-aging-time>200</ims:router-aging-time> </ims:global> </ims:igmp-snooping> </bd:bridge-domain> </bd:bridge-domains> </config> </edit-config> </rpc>
Deletion Example
<?xml version="1.0" encoding="utf-8"?> <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="46"> <edit-config> <target> <running/> </target> <config xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"> <multicast xmlns="urn:huawei:yang:huawei-multicast" xmlns:mc="urn:huawei:yang:huawei-multicast"> <igmp-snooping xmlns="urn:huawei:yang:huawei-igmp-mld-snooping" nc:operation="remove"> <global-enable> <over-vxlan>true</over-vxlan> </global-enable> </igmp-snooping> </multicast> <bd:bridge-domains xmlns:bd="urn:huawei:params:xml:ns:yang:huawei-bd" nc:operation="remove"> <bd:bridge-domain> <bd:id>5</bd:id> <ims:drop-unknown xmlns:ims="urn:huawei:yang:huawei-igmp-mld-snooping">true</ims:drop-unknown> <ims:igmp-snooping xmlns:ims="urn:huawei:yang:huawei-igmp-mld-snooping"> <ims:global> <ims:enable>true</ims:enable> <ims:report-suppress>true</ims:report-suppress> <ims:send-router-alert>false</ims:send-router-alert> <ims:require-router-alert>true</ims:require-router-alert> <ims:version>3</ims:version> <ims:immediately-leave>true</ims:immediately-leave> <ims:querier-enable>true</ims:querier-enable> <ims:router-aging-time>200</ims:router-aging-time> </ims:global> </ims:igmp-snooping> </bd:bridge-domain> </bd:bridge-domains> </config> </edit-config> </rpc>
Response Example
# Sample of successful response
<?xml version="1.0" encoding="utf-8"?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="46"> <ok/> </rpc-reply>
# Sample of failed response
<?xml version="1.0" encoding="utf-8"?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:bd="urn:huawei:params:xml:ns:yang:huawei-bd" xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:mc="urn:huawei:yang:huawei-multicast" xmlns:ims="urn:huawei:yang:huawei-igmp-mld-snooping" message-id="46"> <rpc-error> <error-app-tag>-1</error-app-tag> <error-message>Please delete related configurations of igmp snooping in bd first.</error-message> <error-info>Error on node /huawei-multicast:multicast/huawei-igmp-mld-snooping:igmp-snooping/global-enable</error-info> </rpc-error> </rpc-reply>
Configuring IGMP Snooping in a VLAN
This section provides a sample of configuring IGMP snooping in a VLAN using the edit-config method.
Operation |
XPATH |
---|---|
edit-config |
/mc:multicast/ims:igmp-snooping/global-enable/over-vxlan /huawei-vlan:vlans/vlan/ims:igmp-snooping/global/enable /huawei-vlan:vlans/vlan/ims:igmp-snooping/global/report-suppress /huawei-vlan:vlans/vlan/ims:igmp-snooping/global/require-router-alert /huawei-vlan:vlans/vlan/ims:igmp-snooping/global/send-router-alert /huawei-vlan:vlans/vlan/ims:igmp-snooping/global/version /huawei-vlan:vlans/vlan/ huawei-igmp-mld-snooping:igmp-snooping/global/immediately-leave /huawei-vlan:vlans/vlan/huawei-igmp-mld-snooping:igmp-snooping/global/querier-enable /huawei-vlan:vlans/vlan/huawei-igmp-mld-snooping:igmp-snooping/global/router-aging-time /huawei-vlan:vlans/vlan/huawei-igmp-mld-snooping:drop-unknown |
Data Requirements
Item |
Data |
Description |
---|---|---|
Whether to enable IGMP snooping for VXLAN |
true |
- |
Whether to enable IGMP snooping in the VLAN view |
true |
- |
Whether to enable suppression of IGMP Report and Leave messages in a VLAN |
true |
- |
Whether to enable the device to check for the Router-Alert option and discard the IGMP messages without the Router-Alert option |
true |
- |
Whether the IGMP messages sent to a VLAN carry the Router-Alert option |
false |
- |
Version of IGMP messages that can be processed by IGMP snooping in a VLAN |
3 |
- |
Fast leave function for member interfaces in a VLAN to fast leave multicast groups |
true |
- |
IGMP snooping querier function in a VLAN |
true |
- |
Aging time of dynamic router ports in a VLAN |
200 |
- |
Whether to enable the device to discard unknown multicast packets received in a VLAN |
true |
- |
Request Example
<?xml version="1.0" encoding="utf-8"?> <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="46"> <edit-config> <target> <running/> </target> <config xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"> <multicast xmlns="urn:huawei:yang:huawei-multicast" xmlns:mc="urn:huawei:yang:huawei-multicast"> <igmp-snooping xmlns="urn:huawei:yang:huawei-igmp-mld-snooping" nc:operation="replace"> <global-enable> </global-enable> </igmp-snooping> </multicast> <huawei-vlan:vlans xmlns:huawei-vlan="urn:huawei:params:xml:ns:yang:huawei-vlan"> <huawei-vlan:vlan nc:operation="replace"> <huawei-vlan:id>5</huawei-vlan:id> <ims:drop-unknown xmlns:ims="urn:huawei:yang:huawei-igmp-mld-snooping">true</ims:drop-unknown> <ims:igmp-snooping xmlns:ims="urn:huawei:yang:huawei-igmp-mld-snooping"> <ims:global> <ims:enable>true</ims:enable> <ims:report-suppress>true</ims:report-suppress> <ims:send-router-alert>false</ims:send-router-alert> <ims:require-router-alert>true</ims:require-router-alert> <ims:version>3</ims:version> <ims:immediately-leave>true</ims:immediately-leave> <ims:querier-enable>true</ims:querier-enable> <ims:router-aging-time>200</ims:router-aging-time> </ims:global> </ims:igmp-snooping> </huawei-vlan:vlan> </huawei-vlan:vlans> </config> </edit-config> </rpc>
Deletion Example
<?xml version="1.0" encoding="utf-8"?> <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="46"> <edit-config> <target> <running/> </target> <config xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"> <multicast xmlns="urn:huawei:yang:huawei-multicast" xmlns:mc="urn:huawei:yang:huawei-multicast"> <igmp-snooping xmlns="urn:huawei:yang:huawei-igmp-mld-snooping" nc:operation="remove"> <global-enable> </global-enable> </igmp-snooping> </multicast> <huawei-vlan:vlans xmlns:huawei-vlan="urn:huawei:params:xml:ns:yang:huawei-vlan"> <huawei-vlan:vlan nc:operation="remove"> <huawei-vlan:id>5</huawei-vlan:id> <ims:drop-unknown xmlns:ims="urn:huawei:yang:huawei-igmp-mld-snooping">true</ims:drop-unknown> <ims:igmp-snooping xmlns:ims="urn:huawei:yang:huawei-igmp-mld-snooping"> <ims:global> <ims:enable>true</ims:enable> <ims:report-suppress>true</ims:report-suppress> <ims:send-router-alert>false</ims:send-router-alert> <ims:require-router-alert>true</ims:require-router-alert> <ims:version>3</ims:version> <ims:immediately-leave>true</ims:immediately-leave> <ims:querier-enable>true</ims:querier-enable> <ims:router-aging-time>200</ims:router-aging-time> </ims:global> </ims:igmp-snooping> </huawei-vlan:vlan> </huawei-vlan:vlans> </config> </edit-config> </rpc>
Response Example
# Sample of successful response
<?xml version="1.0" encoding="utf-8"?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="46"> <ok/> </rpc-reply>
# Sample of failed response
<?xml version="1.0" encoding="utf-8"?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:bd="urn:huawei:params:xml:ns:yang:huawei-bd" xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:mc="urn:huawei:yang:huawei-multicast" xmlns:ims="urn:huawei:yang:huawei-igmp-mld-snooping" message-id="46"> <rpc-error> <error-app-tag>-1</error-app-tag> <error-message>Please delete related configurations of igmp snooping in bd first.</error-message> <error-info>Error on node /huawei-multicast:multicast/huawei-igmp-mld-snooping:igmp-snooping/global-enable</error-info> </rpc-error> </rpc-reply>