IP Multicast Configuration
IGMP Snooping
Section titled “IGMP Snooping”IGMP Snooping View
Section titled “IGMP Snooping View”Table 1 IGMP Snooping View
| Command | Purpose |
|---|---|
| show igmp-snooping [vlan vlan_id] | Display IGMP Snooping information for VLANs. |
| show igmp-snooping l2mc-table [vlan vlan_id] | Display the IGMP Snooping multicast forwarding table. |
| show igmp-snooping router-port [vlan vlan_id] | Display the multicast router ports for IGMP Snooping. |
show igmp-snooping [vlan vlan_id]
Section titled “show igmp-snooping [vlan vlan_id]”[Command]
show igmp-snooping [vlan vlan_id]
[Purpose]
Display IGMP Snooping information for VLANs.
[Parameters]
| Parameter | Description |
|---|---|
| vlan_id | VLAN ID, the range is [1,4094] |
[View]
Privileged User View
[Use Cases]
sonic# show igmp-snooping VLAN ID VERSION SNOOPING PROMPT LEAVE ROBUSTNESS PROXY QUERIER QUERY INTERVAL LAST MEMBER INTERVAL MAX RESPONSE TIME QUERIER IP--------- --------- ---------- -------------- ------------ ------- --------- ---------------- ---------------------- ------------------- ------------ 1 v3 disable disable 2 disable disable 125 1 10 0.0.0.0 10 v3 disable disable 2 disable disable 125 1 10 0.0.0.0sonic# show igmp-snooping vlan 1 VLAN ID VERSION SNOOPING PROMPT LEAVE ROBUSTNESS PROXY QUERIER QUERY INTERVAL LAST MEMBER INTERVAL MAX RESPONSE TIME QUERIER IP--------- --------- ---------- -------------- ------------ ------- --------- ---------------- ---------------------- ------------------- ------------ 1 v3 disable disable 2 disable disable 125 1 10 0.0.0.0sonic#show igmp-snooping l2mc-table [vlan vlan_id]
Section titled “show igmp-snooping l2mc-table [vlan vlan_id]”[Command]
show igmp-snooping l2mc-table [vlan vlan_id]
[Purpose]
Display the IGMP Snooping multicast forwarding table.
[Parameters]
| Parameter | Description |
|---|---|
| vlan_id | VLAN ID, the range is [1,4094] |
[View]
Privileged User View
[Use Cases]
sonic# show igmp-snooping l2mc-tablesonic# show igmp-snooping l2mc-table vlan 1show igmp-snooping router-port [vlan vlan_id]
Section titled “show igmp-snooping router-port [vlan vlan_id]”[Command]
show igmp-snooping router-port [vlan vlan_id]
[Purpose]
Display the multicast router ports for IGMP Snooping.
[Parameters]
| Parameter | Description |
|---|---|
| vlan_id | VLAN ID, the range is [1,4094] |
[View]
Privileged User View
[Use Cases]
sonic# show igmp-snooping router-portsonic# show igmp-snooping router-port vlan 1IGMP Snooping Config
Section titled “IGMP Snooping Config”Table 2 IGMP Snooping Config
| Command | Purpose |
|---|---|
| igmp-snooping enable | Enable IGMP Snooping for the VLAN. |
| igmp-snooping version {v1|v2|v3} | Configure the IGMP protocol version. |
| igmp-snooping querier enable | Enable IGMP Snooping Querier. |
| igmp-snooping querier interval interval | Configure the General Query interval for IGMP Snooping Querier. |
| igmp-snooping querier last-member-interval interval | Configure the Group-Specific Query interval for IGMP Snooping Querier. |
| igmp-snooping querier max-response-time interval | Configure the maximum response time for IGMP Snooping Querier. |
| igmp-snooping querier source-address x.x.x.x | Configure the source IP for IGMP Snooping Querier. |
| igmp-snooping robustness value | Configure the robustness value for IGMP Snooping. |
| igmp-snooping proxy enable | Enable the IGMP Snooping Proxy. |
| igmp-snooping prompt-leave enable | Enable fast leave for IGMP Snooping member ports in a VLAN. |
| igmp-snooping prompt-leave {enable|disable} vlan vlan_id | Configure the state of fast leave for IGMP Snooping member ports in the interface. |
| igmp-snooping group-limit limit_value vlan vlan_id | Configure the maximum number of dynamically multicast entries for IGMP Snooping member interfaces. |
| igmp-snooping static-group vlan vlan_id [source-address IP_Addr1] group-address IP_Addr2 mode {forward|blocked} | Configuring IGMP Snooping static multicast entries. |
| igmp-snooping static-router-port vlan vlan_id | Configuring IGMP Snooping static router port. |
igmp-snooping enable
Section titled “igmp-snooping enable”[Command]
igmp-snooping enable
[Purpose]
Enable IGMP Snooping for the VLAN.
[View]
VLAN Configuration View
[Notes]
Run command no igmp-snooping enable to disable IGMP Snooping for the VLAN.
[Use Cases]
sonic# configure terminalsonic(config)# vlan 10sonic(config-vlan-10)# igmp-snooping enableigmp-snooping version {v1|v2|v3}
Section titled “igmp-snooping version {v1|v2|v3}”[Command]
igmp-snooping version {v1|v2|v3}
[Purpose]
Configure the IGMP protocol version.
[View]
VLAN Configuration View
[Notes]
The default IGMP protocol version is v3. Run command no igmp-snooping version to set IGMP version to default(v3).
[Use Cases]
sonic# configure terminalsonic(config)# vlan 10sonic(config-vlan-10)# igmp-snooping version v3igmp-snooping querier enable
Section titled “igmp-snooping querier enable”[Command]
igmp-snooping querier enable
[Purpose]
Enable IGMP Snooping Querier.
[View]
VLAN Configuration View
[Notes]
Run command no igmp-snooping querier enable to disable IGMP Snooping querier.
[Use Cases]
sonic# configure terminalsonic(config)# vlan 10sonic(config-vlan-10)# igmp-snooping querier enableigmp-snooping querier interval interval
Section titled “igmp-snooping querier interval interval”[Command]
igmp-snooping querier interval interval
[Purpose]
Configure the General Query interval for IGMP Snooping Querier.
[Parameters]
| Parameter | Description |
|---|---|
| interval | Specify the interval for general query messages in seconds. The range is [1,18000], and the default value is 125. |
[View]
VLAN Configuration View
[Notes]
Run command no igmp-snooping querier interval to set the general query interval to default(125s).
[Use Cases]
sonic# configure terminalsonic(config)# vlan 10sonic(config-vlan-10)# igmp-snooping querier interval 1000igmp-snooping querier last-member-interval interval
Section titled “igmp-snooping querier last-member-interval interval”[Command]
igmp-snooping querier last-member-interval interval
[Purpose]
Configure the Group-Specific Query interval for IGMP Snooping Querier.
[Parameters]
| Parameter | Description |
|---|---|
| interval | Specify the interval for Group-Specific Query messages in seconds. The range is [1,25], and the default value is 1. |
[View]
VLAN Configuration View
[Notes]
Run command no igmp-snooping querier last-member-interval to set the Group-Specific query interval to default(1s).
[Use Cases]
sonic# configure terminalsonic(config)# vlan 10sonic(config-vlan-10)# igmp-snooping querier last-member-interval 10igmp-snooping querier max-response-time interval
Section titled “igmp-snooping querier max-response-time interval”[Command]
igmp-snooping querier max-response-time interval
[Purpose]
Configure the maximum response time for IGMP Snooping Querier.
[Parameters]
| Parameter | Description |
|---|---|
| interval | Specify the maximum response interval in seconds. The range is [1,25], and the default value is 10. |
[View]
VLAN Configuration View
[Notes]
Run command no igmp-snooping querier max-response-time to set the maximum response interval to default(10s).
[Use Cases]
sonic# configure terminalsonic(config)# vlan 10sonic(config-vlan-10)# igmp-snooping querier max-response-time 20sonic(config-vlan-10)# no igmp-snooping querier max-response-timeigmp-snooping querier source-address x.x.x.x
Section titled “igmp-snooping querier source-address x.x.x.x”[Command]
igmp-snooping querier source-address x.x.x.x
[Purpose]
Configure the source IP for IGMP Snooping Querier.
[Parameters]
| Parameter | Description |
|---|---|
| x.x.x.x | Source IP for query message, the default is 0.0.0.0. |
[View]
VLAN Configuration View
[Notes]
Run command no igmp-snooping querier source-address to set source IP to default (0.0.0.0).
[Use Cases]
sonic# configure terminalsonic(config)# vlan 10sonic(config-vlan-10)# igmp-snooping querier source-address 10.193.1.129sonic(config-vlan-10)# no igmp-snooping querier source-addressigmp-snooping robustness value
Section titled “igmp-snooping robustness value”[Command]
igmp-snooping robustness value
[Purpose]
Configure the robustness value for IGMP Snooping.
[Parameters]
| Parameter | Description |
|---|---|
| value | The robustness value for IGMP Snooping. The range is [1,255] and the default is 2. |
[View]
VLAN Configuration View
[Notes]
Run command no igmp-snooping robustness to set the robustness value to default (2).
[Use Cases]
sonic# configure terminalsonic(config)# vlan 10sonic(config-vlan-10)# igmp-snooping robustness 10sonic(config-vlan-10)# no igmp-snooping robustnessigmp-snooping proxy enable
Section titled “igmp-snooping proxy enable”[Command]
igmp-snooping proxy enable
[Purpose]
Enable the IGMP Snooping Proxy.
[View]
VLAN Configuration View
[Notes]
Run command no igmp-snooping proxy enable to disable the IGMP Snooping Proxy.
[Use Cases]
sonic# configure terminalsonic(config)# vlan 10sonic(config-vlan-10)# igmp-snooping proxy enablesonic(config-vlan-10)# no igmp-snooping proxy enableigmp-snooping prompt-leave enable
Section titled “igmp-snooping prompt-leave enable”[Command]
igmp-snooping prompt-leave enable
[Purpose]
Enable fast leave for IGMP Snooping member ports in a VLAN.
[View]
VLAN Configuration View
[Notes]
Run command no igmp-snooping prompt-leave enable to disable the fast leave feature.
[Use Cases]
sonic# configure terminalsonic(config)# vlan 10sonic(config-vlan-10)# igmp-snooping prompt-leave enablesonic(config-vlan-10)# no igmp-snooping prompt-leave enableigmp-snooping prompt-leave {enable|disable} vlan vlan_id
Section titled “igmp-snooping prompt-leave {enable|disable} vlan vlan_id”[Command]
igmp-snooping prompt-leave {enable|disable} vlan vlan_id
[Purpose]
Configure the state of fast leave for IGMP Snooping member ports in the interface.
[Parameters]
| Parameter | Description |
|---|---|
| vlan_id | VLAN ID, the range is [1,4094] |
[View]
Physical interface/LAG interface configuration view
[Notes]
Run command no igmp-snooping prompt-leave vlan vlan_id to set the fast leave feature state to default. The default state depends on the configuration in VLAN view.
[Use Cases]
sonic# configure terminalsonic(config)# interface ethernet 0/4sonic(config-if-0/4)# igmp-snooping prompt-leave enable vlan 10sonic(config-if-0/4)# no igmp-snooping prompt-leave vlan 10sonic(config-if-0/4)#igmp-snooping group-limit limit_value vlan vlan_id
Section titled “igmp-snooping group-limit limit_value vlan vlan_id”[Command]
igmp-snooping group-limit limit_value vlan vlan_id
[Purpose]
Configure the maximum number of dynamically multicast entries for IGMP Snooping member interfaces.
[Parameters]
| Parameter | Description |
|---|---|
| limit_value | The maximum number of dynamically multicast entries. The range is [1,4095] and the default is 4095. |
| vlan_id | VLAN ID, the range is [1,4094] |
[View]
Physical interface/LAG interface configuration view
[Notes]
Run command no igmp-snooping group-limit vlan vlan_id to set maximum number of dynamically multicast entries to default (4095).
[Use Cases]
sonic# configure terminalsonic(config)# interface ethernet 0/4sonic(config-if-0/4)# igmp-snooping group-limit 100 vlan 10sonic(config-if-0/4)# no igmp-snooping group-limit vlan 10igmp-snooping static-group vlan vlan_id [source-address IP_Addr1] group-address IP_Addr2 mode {forward|blocked}
Section titled “igmp-snooping static-group vlan vlan_id [source-address IP_Addr1] group-address IP_Addr2 mode {forward|blocked}”[Command]
igmp-snooping static-group vlan vlan_id [source-address IP_Addr1] group-address IP_Addr2 mode {forward|blocked}
[Purpose]
Configuring IGMP Snooping static multicast entries.
[Parameters]
| Parameter | Description |
|---|---|
| vlan_id | VLAN ID, the range is [1,4094] |
| IP_Addr1 | The multicast source IP address. When the source-address is omitted, it is set to 0.0.0.0 by default |
| IP_Addr2 | The multicast group IP address. The range is 224.0.1.0-239.255.255.255 |
[View]
Physical interface/LAG interface configuration view
[Notes]
Run command no igmp-snooping static-group vlan vlan_id [source-address IP_Addr1] group-address IP_Addr2 to remove the static multicast entry.
[Use Cases]
sonic# configure terminalsonic(config)# interface ethernet 0/4sonic(config-if-0/4)# igmp-snooping static-group vlan 10 group-address 224.0.3.2 mode forwardsonic(config-if-0/4)# igmp-snooping static-group vlan 10 source-address 1.1.1.1 group-address 224.0.2.1 mode forwardigmp-snooping static-router-port vlan vlan_id
Section titled “igmp-snooping static-router-port vlan vlan_id”[Command]
igmp-snooping static-router-port vlan vlan_id
[Purpose]
Configuring IGMP Snooping static router port.
[Parameters]
| Parameter | Description |
|---|---|
| vlan_id | VLAN ID, the range is [1,4094] |
[View]
Physical interface/LAG interface configuration view
[Notes]
Run command no igmp-snooping static-router-port vlan vlan_id to remove the static router port.
[Use Cases]
sonic# configure terminalsonic(config)# interface ethernet 0/4sonic(config-if-0/4)# igmp-snooping static-router-port vlan 10sonic(config-if-0/4)# no igmp-snooping static-router-port vlan 10IPMC Counter
Section titled “IPMC Counter”IPMC Counter View
Section titled “IPMC Counter View”Table 3 IPMC Counter View
| Command | Purpose |
|---|---|
| show counters mroute [configured-pattern src-ip-prefix/mask group-ip-prefix/mask vrf vrf-name|entry src-ip group-ip vrf vrf-name] | Display multicast routes counter information. |
| clear counters mroute [configured-pattern src-ip-prefix/mask group-ip-prefix/mask vrf vrf-name|entry src-ip group-ip vrf vrf-name] | Clear multicast routes counter. |
show counters mroute [configured-pattern src-ip-prefix/mask group-ip-prefix/mask vrf vrf-name | entry src-ip group-ip vrf vrf-name]
Section titled “show counters mroute [configured-pattern src-ip-prefix/mask group-ip-prefix/mask vrf vrf-name | entry src-ip group-ip vrf vrf-name]”[Command]
show counters mroute [configured-pattern src-ip-prefix/mask group-ip-prefix/mask vrf vrf-name | entry src-ip group-ip vrf vrf-name]
[Purpose]
Display multicast routes counter information.
[Parameters]
| Parameter | Description |
|---|---|
| src-ip-prefix/mask | IP Prefix for source address |
| group-ip-prefix/mask | IP Prefix for group address |
| src-ip | Source address |
| group-ip | Group address |
| vrf-name | The name of VRF |
[View]
Privileged User View
[Notes]
The CX308P-48Y-N-V2, CX532P-N-V2 and CX732Q-N-V2 support counting for only 4 mroutes and support packet counting only, not byte counting; other device models support counting for up to 2048 mroutes and support both packet and byte counting.
[Use Cases]
sonic# show counters mrouteMRoute pattern VRF Matched mroutes Packets Bytes--------------------------------- ---------- --------------------- --------------- ------------------Vrfmroute1|0.0.0.0/0|225.0.0.0/16 Vrfmroute1 0.0.0.0,225.0.0.2 103,785,264,483 6,849,827,455,878 10.14.255.1,225.0.0.1 90,121,982,616 5,948,050,852,656default|0.0.0.0/0|226.0.0.0/16 default 10.14.0.1,226.0.0.1 0 0 10.14.0.2,226.0.0.1 0 0sonic# show counters mroute entry 0.0.0.0 225.0.0.2 vrf mroute1MRoute VRF MRoute pattern Packets Bytes----------------- ---------- --------------------------------- --------------- -----------------0.0.0.0,225.0.0.2 Vrfmroute1 Vrfmroute1|0.0.0.0/0|225.0.0.0/16 104,064,707,094 6,868,270,668,204sonic# show counters mroute configured-pattern 0.0.0.0/0 225.0.0.0/16 vrf mroute1MRoute pattern VRF Matched mroutes Packets Bytes---------------------- ---------- --------------------- --------------- -----------------0.0.0.0/0|225.0.0.0/16 Vrfmroute1 0.0.0.0,225.0.0.2 107,178,683,072 7,073,793,082,752 10.14.255.1,225.0.0.1 93,515,401,205 6,172,016,479,53clear counters mroute [configured-pattern src-ip-prefix/mask group-ip-prefix/mask vrf vrf-name | entry src-ip group-ip vrf vrf-name]
Section titled “clear counters mroute [configured-pattern src-ip-prefix/mask group-ip-prefix/mask vrf vrf-name | entry src-ip group-ip vrf vrf-name]”[Command]
clear counters mroute [configured-pattern src-ip-prefix/mask group-ip-prefix/mask vrf vrf-name | entry src-ip group-ip vrf vrf-name]
[Purpose]
Clear multicast routes counter.
[Parameters]
| Parameter | Description |
|---|---|
| src-ip-prefix/mask | IP Prefix for source address |
| group-ip-prefix/mask | IP Prefix for group address |
| src-ip | Source address |
| group-ip | Group address |
| vrf-name | The name of VRF |
[View]
Privileged User View
[Use Cases]
sonic# clear counters mrouteFlow Counters were successfully clearedIPMC Counter Config
Section titled “IPMC Counter Config”Table 4 IPMC Counter Config
| Command | Purpose |
|---|---|
| counter mroute enable | Enable counter for multicast routes. |
| counter mroute poll-interval interval | Configure counter polling interval. |
| counter mroute pattern src-ip-prefix/mask group-ip-prefix/mask vrf vrf-name [max count] | Configure pattern for counter. |
counter mroute enable
Section titled “counter mroute enable”[Command]
counter mroute enable
[Purpose]
Enable counter for multicast routes.
[View]
Global Configuration View
[Use Cases]
sonic#sonic# configure terminalsonic(config)# counter mroute enablecounter mroute poll-interval interval
Section titled “counter mroute poll-interval interval”[Command]
counter mroute poll-interval interval
[Purpose]
Configure counter polling interval.
[Parameters]
| Parameter | Description |
|---|---|
| interval | Polling interval.The unit is millisecond. The range of interval is [1000,30000] and the default is 10000. |
[View]
Global Configuration View
[Use Cases]
sonic# configure terminalsonic(config)# counter mroute poll-interval 1000counter mroute pattern src-ip-prefix/mask group-ip-prefix/mask vrf vrf-name [max count]
Section titled “counter mroute pattern src-ip-prefix/mask group-ip-prefix/mask vrf vrf-name [max count]”[Command]
counter mroute pattern src-ip-prefix/mask group-ip-prefix/mask vrf vrf-name [max count]
[Purpose]
Configure pattern for counter.
[Parameters]
| Parameter | Description |
|---|---|
| src-ip-prefix/mask | IP Prefix for source address. |
| group-ip-prefix/mask | IP Prefix for group address. |
| vrf-name | The name of VRF. |
| count | Maximum number of counters for single pattern, default value 30, range [1,2000] |
[View]
Global Configuration View
[Use Cases]
sonic# configure terminalsonic(config)# counter mroute pattern 100.20.1.0/24 226.1.0.0/24 vrf default max 10