- Table of Contents
-
- H3C S3600 Command Manual-Release 1602(V1.02)
- 00-1Cover
- 01-CLI Command
- 02-Login Command
- 03-Configuration File Management Command
- 04-VLAN Command
- 05-IP Address and Performance Command
- 06-Voice VLAN Command
- 07-GVRP Command
- 08-Port Basic Configuration Command
- 09-Link Aggregation Command
- 10-Port Isolation Command
- 11-Port Security-Port Binding Command
- 12-DLDP Command
- 13-MAC Address Table Management Command
- 14-Auto Detect Command
- 15-MSTP Command
- 16-Routing Protocol Command
- 17-Multicast Command
- 18-802.1x and System Guard Command
- 19-AAA Command
- 20-Web Authentication Command
- 21-MAC Address Authentication Command
- 22-VRRP Command
- 23-ARP Command
- 24-DHCP Command
- 25-ACL Command
- 26-QoS-QoS Profile Command
- 27-Web Cache Redirection Command
- 28-Mirroring Command
- 29-IRF Fabric Command
- 30-Cluster Command
- 31-PoE-PoE Profile Command
- 32-UDP Helper Command
- 33-SNMP-RMON Command
- 34-NTP Command
- 35-SSH Command
- 36-File System Management Command
- 37-FTP-SFTP-TFTP Command
- 38-Information Center Command
- 39-System Maintenance and Debugging Command
- 40-VLAN-VPN Command
- 41-HWPing Command
- 42-IPv6 Management Command
- 43-DNS Command
- 44-Smart Link-Monitor Link Command
- 45-Access Management Command
- 46-Appendix
- Related Documents
-
Title | Size | Download |
---|---|---|
17-Multicast Command | 386.95 KB |
Table of Contents
1 Common Multicast Configuration Commands
Common Multicast Configuration Commands
display mac-address multicast static
display multicast forwarding-table
display multicast routing-table
mac-address multicast interface
reset multicast forwarding-table
igmp timer other-querier-present
5 IGMP Snooping Configuration Commands
IGMP Snooping Configuration Commands
display igmp-snooping configuration
display igmp-snooping statistics
igmp-snooping general-query source-ip
igmp-snooping max-response-time
igmp-snooping nonflooding-enable
igmp-snooping router-aging-time
multicast static-group interface
multicast static-router-port vlan
reset igmp-snooping statistics
The following are new features in this set of manuals:
l Enabling multicast packet buffering. The related commands are multicast storing-enable and multicast storing-packet.
l Configuring multicast source lifetime. The related command is source-lifetime.
l Configuring IGMPv3 Snooping functions. The related commands are igmp-snooping version and igmp host-join.
l Configuring IGMP Snooping nonflooding. The related command is igmp-snooping nonflooding-enable.
l Configuring static member ports. The related commands are multicast static-group interface and multicast static-group vlan.
l Configuring static router ports. The related commands are multicast static-router-port and multicast static-router-port vlan.
l Configuring VLAN tags of query messages. The related command is igmp-snooping vlan-mapping.
Common Multicast Configuration Commands
display mac-address multicast static
Syntax
display mac-address multicast static [ [mac-address ] vlan vlan-id ] [ count ]
View
Any view
Parameters
mac-address: Displays the static multicast MAC entry information for the specified MAC address. Without this argument provided, this command displays the information of all static multicast MAC entries in the specified VLAN.
vlan vlan-id: Displays the static multicast MAC entry information in the specified VLAN. Without a VLAN specified, this command displays the static multicast MAC entry information in all VLANs.
count: Displays the number of static multicast MAC entries.
Description
Use the display mac-address multicast static command to display the information about the multicast MAC address entry or entries manually configured on the switch.
Related commands: mac-address multicast interface, mac-address multicast vlan.
Examples
# Display the information of all static multicast MAC entries in VLAN 1.
<Sysname> display mac-address multicast static vlan 1
MAC ADDR VLAN ID STATE PORT INDEX AGING TIME(s)
0100-0001-0001 1 Config static Ethernet1/0/1 NOAGED
Ethernet1/0/2
Ethernet1/0/3
Ethernet1/0/4
--- 1 static mac address(es) found ---
Table 1-1 display mac-address multicast static command output description
Field |
Description |
MAC ADDR |
MAC address |
VLAN ID |
The VLAN in which the MAC address is manually added |
STATE |
State of the MAC address, which includes only Config static, indicating that the table entry is manually added. |
PORT INDEX |
Ports out which the multicast packets destined for the multicast MAC address are forwarded |
AGING TIME(s) |
Remaining lifetime of the entry. NOAGED indicates that the entry never expires. |
display mpm forwarding-table
Syntax
display mpm forwarding-table [ group-address ]
View
Any view
Parameters
group-address: IP address of a multicast group, in the range 224.0.0.0 to 239.255.255.255. With this argument configured, this command displays only those forwarding entries that match the specified multicast address; otherwise, the command displays all the forwarding entries.
Description
Use the display mpm forwarding-table command to display the information of multicast forwarding entries containing port information.
This command displays the incoming interface, outgoing interface and outgoing port information for specific multicast streams.
Related commands: display multicast forwarding-table.
Examples
# Display the information about all the multicast forwarding entries containing port information.
<Sysname> display mpm forwarding-table
Total 1 entry(entries)
00001. (120.0.0.2, 225.0.0.2)
iif Vlan-interface1200
1 oif(s):
Vlan-interface32
Ethernet1/0/19
Total 1 entry(entries) Listed
Table 1-2 display mpm forwarding-table command output description
Field |
Description |
Total 1 entry(entries) |
Total number of the entries |
00001 |
Entry number |
(120.0.0.2, 225.0.0.2) |
Source address-group address pair |
iif Vlan-interface1200 |
The incoming VLAN interface is VLAN-interface 1200. |
1 oif(s): |
One outgoing VLAN interface is listed. |
Vlan-interface32 Ethernet1/0/19 |
The first outgoing VLAN-interface is VLAN-interface 32, with one outgoing port under it, Ethernet 1/0/19 |
Total 1 entry(entries) Listed |
The multicast forward table contains one (S,G) entry. |
display mpm group
Syntax
display mpm group [ vlan vlan-id ]
View
Any view
Parameters
vlan vlan-id: Specifies a VLAN. With a VLAN specified, this command displays the IGMP group information in the specified VLAN; otherwise, the command displays the information of all IGMP group entries.
Description
Use the display mpm group command to display the IGMP group entries containing port information on the switch.
Related commands: display igmp group.
Examples
# Display IGMP group entries containing port information in VLAN 1200.
<Sysname> display mpm group vlan 1200
Total 1 IP Group(s).
Total 1 MAC Group(s).
Vlan(id):1200.
Total 1 IP Group(s).
Total 1 MAC Group(s).
Static Router port(s):
Dynamic Router port(s):
Ethernet1/0/24
IP group(s):the following ip group(s) match to one mac group.
IP group address:224.1.1.1
Static host port(s):
Dynamic host port(s):
Ethernet1/0/22
MAC group(s):
MAC group address:0100-5e01-0101
Host port(s):Ethernet1/0/22
Table 1-3 display mpm group command output description
Field |
Description |
Total 1 IP Group(s) |
Total number of IP multicast groups |
Total 1 MAC Group(s) |
Total number of MAC multicast groups |
Vlan(id):1200. |
The displayed information is for VLAN 1200. |
Static Router Port(s): |
Static router ports |
Dynamic router port(s): |
Dynamic router ports |
IP group(s):the following ip group(s) match to one mac group |
IP multicast groups corresponding to the same MAC multicast group |
IP group address |
Address of the IP multicast group |
Static host port(s): |
Static host ports |
Dynamic host port(s): |
Dynamic host ports |
MAC group(s): |
MAC multicast groups |
Host port(s) |
Member ports of the IP multicast group |
MAC group address |
Address of the MAC multicast group |
Host port(s) |
Member ports of the MAC multicast group |
display multicast forwarding-table
Syntax
display multicast forwarding-table [ group-address [ mask { mask | mask-length } ] | source-address [ mask { mask | mask-length } ] | incoming-interface { interface-type interface-number | register } ]*
View
Any view
Parameters
group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255. With this argument provided, the command displays the forwarding entries for the specified multicast group.
source-address: Multicast source address. With this argument provided, the command displays the forwarding entries for the specified multicast source.
mask: Mask of the specified multicast group address or multicast source address, 255.255.255.255 by default.
mask-length: Mask length of the specified multicast group address or multicast source address. For a multicast group address, this argument is in the range of 4 to 32; for a multicast source address, this argument is in the range of 0 to 32. The system default is 32 in both cases.
incoming-interface: Displays the multicast forwarding entries that contain the specified incoming interface.
interface-type interface-number: Specifies an interface by its type and number..
register: Displays the forwarding entries in which the incoming interface is the PIM-SM register interface.
Description
Use the display multicast forwarding-table command to display the information of multicast forwarding tables.
As the multicast forwarding table directly guides the forwarding of multicast traffic, you can view the information of the forwarding entries to determine whether a multicast stream is correctly forwarded.
Related commands: display multicast routing-table, display mpm forwarding-table, reset multicast forwarding-table.
Examples
# Display the information about the multicast forwarding table.
<Sysname> display multicast forwarding-table
Multicast Forwarding Cache Table
Total 1 entry: 0 entry created by IP, 1 entry created by protocol
00001. (10.0.0.4, 225.1.1.1), iif Vlan-interface2, 0 oifs,
Protocol Create
Matched 122 pkts(183000 bytes), Wrong If 0 pkts
Forwarded 122 pkts(183000 bytes)
Total 1 entry Listed
The following table describes the fields in the displayed information above:
Table 1-4 display multicast forwarding-table command output description
Field |
Description |
Multicast Forwarding Cache Table |
Multicast forwarding table |
Total 1 entries |
Total number of matched forwarding entries |
00001 |
Serial number of the entry |
(10.0.0.4, 225.1.1.1) |
Multicast source and group addresses of the entry |
iif Vlan-interface2, 0 oifs |
The incoming interface of the multicast forwarding table is VLAN-interface 2, and the multicast forwarding table does not have an outgoing interface. |
Matched 122 pkts(183000 bytes), Wrong If 0 pkts Forwarded 122 pkts(183000 bytes) |
122 packets of totally 183,000 bytes match the (S, G) entry, and 0 error packets match the (S, G) entry. 122 packets of totally 183,000 bytes have been forwarded. |
display multicast routing-table
Syntax
display multicast routing-table [ group-address [ mask { mask | mask-length } ] | source-address [ mask { mask | mask-length } ] | incoming-interface { interface-type interface-number | register } ]*
View
Any view
Parameters
group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255. With this argument provided, the command displays the multicast routing entries for the specified multicast group.
source-address: Multicast source address. With this argument provided, the command displays the multicast routing entries for the specified multicast source.
mask: Mask of the multicast group address or multicast source address, 255.255.255.255 by default.
mask-length: Mask length of the multicast group address or multicast source address. For a multicast group address, this argument is in the range of 4 to 32; for a multicast source address, this argument is in the range of 0 to 32. The system default is 32 in both cases.
incoming-interface: Displays multicast routing entries that contain the specified incoming interface.
interface-type interface-number: Specifies an interface by its type and number.
register: Displays the routing entries in which the incoming interface is the PIM-SM register interface.
Description
Use the display multicast routing-table command to display the multicast routing table information.
The multicast routing table is the basis of multicast data delivery. You can view the multicast routing table entries to determine whether (S, G) entries have been created with correct outgoing and incoming interfaces.
Related commands: reset multicast routing-table, display multicast forwarding-table.
Examples
# Display the multicast routing table information.
<Sysname> display multicast routing-table
Multicast Routing Table
Total 3 entries
(4.4.4.4, 224.2.149.17)
Uptime: 00:15:16, Timeout in 272 sec
Upstream interface: Vlan-interface1(4.4.4.6)
Downstream interface list:
Vlan-interface2(2.2.2.4), Protocol 0x1: IGMP
(4.4.4.4, 224.2.254.84)
Uptime: 00:15:16, Timeout in 272 sec
Upstream interface: Vlan-interface1(4.4.4.6)
Downstream interface list: NULL
(4.4.4.4, 239.255.2.2)
Uptime: 00:02:57, Timeout in 123 sec
Upstream interface: Vlan-interface1(4.4.4.6)
Downstream interface list: NULL
Matched 3 entries
The following table describes the fields in the displayed information.
Table 1-5 display multicast routing-table command output description
Field |
Description |
Multicast Routing Table |
Multicast routing table |
Total 3 entries |
There are three entries in all in the multicast routing table. |
(4.4.4.4, 224.2.149.17) |
An (S, G) entry |
Uptime: 00:15:16, Timeout in 272 sec Upstream interface: Vlan-interface1(4.4.4.6) Downstream interface list: Vlan-interface2(2.2.2.4), Protocol 0x1: IGMP |
The entry has been there for 15 minutes and 16 seconds, and it will expire in 272 seconds. Upstream interface: VLAN-interface 1 (The IP address of the upstream interface is 4.4.4.6). Downstream interface list: Downstream interface: VLAN-interface 2. (The IP address of the downstream interface is 2.2.2.4). The downstream interface was added by the IGMP protocol. |
Matched 3 entries |
Three entries match the command. |
display multicast-source-deny
Syntax
display multicast-source-deny [ interface interface-type [ interface-number ] ]
View
Any view
Parameters
interface-type: Port type.
interface-number: Port number.
Description
Use the display multicast-source-deny command to display the multicast source port suppression status.
l With neither a port type nor a port number specified, the command displays the multicast source port suppression status of all the ports on the switch.
l With only a port type specified, the command displays the multicast source port suppression status of all ports of that type.
l With both a port type and a port number specified, the command displays the multicast source port suppression status of the specified port.
Related commands: multicast-source-deny.
Examples
# Display the multicast source port suppression status of Ethernet 1/0/1.
<Sysname> display multicast-source-deny interface Ethernet 1/0/1
Ethernet1/0/1 Multicast-source-deny disabled.
The information above shows that multicast source port suppression is disabled on Ethernet 1/0/1.
mac-address multicast interface
Syntax
mac-address multicast mac-address interface interface-list vlan vlan-id
undo mac-address multicast [ mac-address [ interface interface-list ] vlan vlan-id ]
View
System view
Parameters
mac-address: Multicast MAC address, in the form of H-H-H.
interface interface-list: Specifies forwarding ports for the specified multicast MAC group address. With the interface-list argument, you can define one or more individual ports (in the form of interface-type interface-number) and/or one or more port ranges (in the form of interface-type interface-number1 to interface-type interface-number2, where interface-number2 must be greater than interface-number1). The total number of individual ports plus port ranges cannot exceed 10. For port types and port numbers, refer to the parameter description in the “Port Basic Configuration” part in this manual.
vlan vlan-id: Specifies the VLAN to which the forwarding ports belong. The effective range for vlan-id is 1 to 4094.
Description
Use the mac-address multicast interface command to create a multicast MAC address entry.
Use the undo mac-address multicast interface command to remove the specified multicast MAC address entry or all multicast MAC address entries.
Each multicast MAC address entry contains multicast address, forward port, VLAN ID, and so on.
Related commands: display mac-address multicast static.
Examples
# Create a multicast MAC address entry, with the multicast MAC address of 0100-5e0a-0805 and a forwarding port of Ethernet 1/0/1 in VLAN 1.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] mac-address multicast 0100-5e0a-0805 interface Ethernet 1/0/1 vlan 1
mac-address multicast vlan
Syntax
mac-address multicast mac-address vlan vlan-id
undo mac-address multicast [ [ mac-address ] vlan vlan-id ]
View
Ethernet port view
Parameters
mac-address: Multicast MAC address in the form of H-H-H.
vlan vlan-id: Specifies the VLAN the current port belongs to. The effective range for vlan-id is 1 to 4094.
Description
Use the mac-address multicast vlan command to create a multicast MAC address entry on the current port.
Use the undo mac-address multicast vlan command to remove the specified multicast MAC address entry or all multicast MAC address entries on the current port.
Each multicast MAC address entry contains the multicast address, forwarding port, and VLAN ID information.
Related commands: display mac-address multicast static.
Examples
# Create a multicast MAC address entry on Ethernet 1/0/1 in VLAN 1, with the multicast address of 0100-1000-1000.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Ethernet1/0/1
[Sysname-Ethernet1/0/1] mac-address multicast 0100-1000-1000 vlan 1
mtracert
Syntax
mtracert source-address [ group-address | last-hop-router-address group-address ]
View
Any view
Parameters
source-address: Specifies a multicast source.
group-address: Specifies a multicast group.
last-hop-router-address: Specifies the last-hop router, which is the local device by default.
Description
Use the mtracert command to trace the path down which the multicast traffic flows to the receiver hosts.
Examples
# Trace the path down which the multicast traffic for (192.168.4.1, G) flows to the receivers.
<Sysname> mtracert 192.168.4.1
Type Ctrl+C to quit multicast traceroute facility
From last-hop router(192.168.2.2), trace reverse path to source 192.168.4.1 via RPF rules
-1 192.168.2.2
Incoming Interface Address: 192.168.2.2
Previous-Hop Router Address: 192.168.2.1
Input packet count on incoming interface: 0
Output packet count on outgoing interface: 0
Total number of packets for this source-group pair: 0
Protocol: PIM
Forwarding TTL: 0
Forwarding Code: No error
-2 192.168.2.1
Incoming Interface Address: 192.168.3.2
Previous-Hop Router Address: 192.168.3.1
Input packet count on incoming interface: 0
Output packet count on outgoing interface: 0
Total number of packets for this source-group pair: 0
Protocol: PIM
Forwarding TTL: 0
Forwarding Code: No error
-3 192.168.3.1
Incoming Interface Address: 192.168.4.2
Previous-Hop Router Address: 0.0.0.0
Input packet count on incoming interface: 0
Output packet count on outgoing interface: 0
Total number of packets for this source-group pair: 0
Protocol: PIM
Forwarding TTL: 0
Forwarding Code: No error
Table 1-6 mtracert command output description
Field |
Description |
From last-hop router(192.168.2.2), trace reverse path to source 192.168.4.1 via RPF rules |
Reverse path from the last-hop router (192.168.2.2) to the multicast source (192.168.4.1) |
-1 5.5.5.8 |
Outgoing interface address of each hop, starting from the last-hop router |
Incoming interface address |
Address of the interface on which (S, G) packets arrive |
Previous-hop router address |
IP address of the router from which this local device receives multicast packets sent by the source |
Input packet count on incoming interface |
Total number of multicast packets received on the incoming interface |
Output packet count on outgoing interface |
Total number of multicast packets transmitted on the outgoing interface |
Total number of packets for this source-group pair |
Total number of packets from the specified source forwarded by this device to the specified group |
Protocol |
The multicast routing protocol in use |
Forwarding TTL |
The minimum TTL that a packet is required to have before it can be forwarded over the outgoing interface |
multicast route-limit
Syntax
multicast route-limit limit
undo multicast route-limit
View
System view
Parameters
limit: Maximum number of multicast routing table entries, in the range of 0 to 256.
Description
Use the multicast route-limit command to configure the maximum number of entries the multicast routing table can hold. The switch will drop the protocol and data packets for new (S, G) entries after the limit is reached.
Use the undo multicast route-limit command to restore the default.
The maximum number of entries the multicast routing table can hold is 256 by default.
If the number of existing entries in the multicast routing table exceeds the value configured with this command, the existing entries in the multicast routing table will not be immediately removed. Instead, you will see a message indicating that the multicast routing table currently contains more entries than configured.
If you execute this command again, the new configuration will overwrite the existing configuration.
Examples
# Set the maximum number of entries the multicast routing table can hold to 100.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast route-limit 100
multicast routing-enable
Syntax
multicast routing-enable
undo multicast routing-enable
View
System view
Parameters
None
Description
Use the multicast routing-enable command to enable the IP multicast routing feature.
Use the undo multicast routing-enable command to disable the IP multicast routing feature.
IP multicast routing is disabled by default.
Examples
# Enable the IP multicast routing feature.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
multicast storing-enable
multicast storing-enable
undo multicast storing-enable
View
System view
Parameters
None
Description
Use the multicast storing-enable command to enable the multicast packet buffering feature.
Use the undo multicast storing-enable command to disable the multicast packet buffering feature.
With the multicast packet buffering feature enabled, multicast packets delivered to the CPU are buffered while the corresponding multicast forwarding entries are being created and forwarded out according to the multicast forwarding entries after entry creation.
By default, this function is not enabled.
Examples
# Enable the multicast packet buffering feature.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast storing-enable
multicast storing-packet
Syntax
multicast storing-packet packet-number
View
System view
Parameters
packet-number: Maximum number of packets that can be buffered per multicast forwarding entry, ranging from 10 to 100.
Description
Use the multicast storing-packet command to specify the maximum number of packets that can be buffered per multicast forwarding entry.
By default, up to 100 packets can be buffered per multicast forwarding entry.
Examples
# Configure to allow a maximum of 50 packets to be buffered per multicast group.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast storing-packet 50
multicast-source-deny
Syntax
multicast-source-deny [ interface interface-list ]
undo multicast-source-deny [ interface interface-list ]
View
System view, Ethernet port view
Parameters
interface interface-list: Enables the multicast source port suppression feature on the specified port or ports. With the interface-list argument, you can define one or more individual ports (in the form of interface-type interface-number) and/or one or more port ranges (in the form of interface-type interface-number1 to interface-type interface-number2, where interface-number2 must be greater than interface-number1). The total number of individual ports plus port ranges cannot exceed 10. For port types and port numbers, refer to the parameter description in the “Port Basic Configuration” part in this manual.
Description
Use the multicast-source-deny command to enable the multicast source port suppression feature.
Use the undo multicast-source-deny command to restore the default setting.
By default, the multicast source port suppression feature is disabled on all the ports.
With the multicast source port suppression feature enabled on a port, the port drops all multicast data packets while it permits multicast protocol packets to pass. This feature is useful for rejecting multicast traffic from unauthorized multicast source servers connected to the switch.
l In system view, if no port or port list is specified, the multicast source port suppression feature is enabled on all the ports of the switch; if one or more ports or port lists are specified, the multicast source port suppression feature is enabled on the specified ports.
l In Ethernet port view, you can use the command to enable the multicast source port suppression feature on the current port only.
Examples
# Enable the multicast source port suppression feature on all the ports of the switch.
<Sysname>system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast-source-deny
# Enable the multicast source port suppression feature on Ethernet 1/0/1 through Ethernet 1/0/10 and on Ethernet 1/0/12.
[Sysname] multicast-source-deny interface Ethernet 1/0/1 to Ethernet 1/0/10 Ethernet 1/0/12
# Enable the multicast source port suppression feature on Ethernet 1/0/13.
[Sysname] interface Ethernet 1/0/13
[Sysname-Ethernet1/0/13] multicast-source-deny
reset multicast forwarding-table
Syntax
reset multicast forwarding-table [ statistics ] { all | { group-address [ mask { mask | mask-length } ] | source-address [ mask { mask | mask-length } ] | incoming-interface interface-type interface-number } * }
View
User view
Parameters
statistics: Clears the statistics information of the specified multicast forwarding entries. Without this keyword, the command clears the specified forwarding entries.
all: Clears all the forwarding entries or the statistics information of all the forwarding entries. Without this keyword, the command clears the forwarding entries or the statistics information of the forwarding entries defined by the following parameters.
group-address: Multicast group address in the range of 224.0.0.0 to 239.255.255.255.
source-address: Multicast source address.
mask: Mask of the multicast group address or multicast source address, 255.255.255.255 by default.
mask-length: Mask length of the multicast group address or multicast source address. For a multicast group address, this argument is in the range of 4 to 32; for a multicast source address, this argument is in the range of 0 to 32. The system default is 32 in both cases.
incoming-interface interface-type interface-number: Clears the forwarding entries or corresponding statistics information of the forwarding entries that match the specified incoming interface.
Description
The positions of the group-address and source-address arguments are interchangeable. However, they must be valid addresses; otherwise, the system prompts an error message.
Related commands: display multicast forwarding-table.
Examples
# Clear the forwarding entries whose group address is 225.5.4.3 from the multicast forwarding table.
<Sysname> reset multicast forwarding-table 225.5.4.3
# Clear the statistics about the forwarding entries whose group address is 225.5.4.3 from the multicast forwarding table.
<Sysname> reset multicast forwarding-table statistics 225.5.4.3
reset multicast routing-table
Syntax
reset multicast routing-table { all | { group-address [ mask { mask | mask-length } ] | source-address [ mask { mask | mask-length } ] | incoming-interface interface-type interface-number } * }
View
User view
Parameters
all: Clears all routing entries from the multicast routing table. Without this keyword, the command clears the multicast routing entries defined by the following parameters.
group-address: Multicast group address in the range of 224.0.0.0 to 239.255.255.255.
source-address: Multicast source address.
mask: Mask of the multicast group address or multicast source address, 255.255.255.255 by default.
mask-length: Mask length of the multicast group address or multicast source address. For a multicast group address, this argument is in the range of 4 to 32; for a multicast source address, this argument is in the range of 0 to 32. The system default is 32 in both cases.
incoming-interface interface-type interface-number: Clears the routing entries that match the specified incoming interface.
Description
Use the reset multicast routing-table command to clear the routing entries in the multicast core routing table and remove the corresponding forwarding entries in the MFC forwarding table.
The position of the group-address and source-address arguments are interchangeable. However, they must be valid addresses; otherwise, the system prompts an error message.
Related commands: reset pim routing-table, reset multicast forwarding-table, display multicast forwarding-table.
Examples
# Clear the routing entries whose group address is 225.5.4.3 from the multicast core routing table.
<Sysname> reset multicast routing-table 225.5.4.3
unknown-multicast drop enable
Syntax
unknown-multicast drop enable
undo unknown-multicast drop enable
View
System view
Parameters
None
Description
Use the unknown-multicast drop enable command to enable the function of dropping unknown multicast packets.
Use the undo unknown-multicast drop enable command to disable the function of dropping unknown multicast packets.
By default, the function of dropping unknown multicast packets is disabled.
Examples
Enable the unknown multicast drop feature.
<Sysname> system-view
System view: return to user view with Ctrl+Z.
[Sysname] unknown-multicast drop enable
IGMP Configuration Commands
display igmp group
Syntax
display igmp group [ group-address | interface interface-type interface-number ]
View
Any view
Parameters
group-address: Multicast group address. With this argument provided, this command displays the information of the specified IGMP multicast group.
Interface interface-type interface-number: Specifies an interface by its type and number. With this argument provided, this command displays the IGMP multicast group information about the specified interface.
Description
Use the display igmp group command to display the IGMP multicast group information.
Without any parameters provided, the command displays the information of all IGMP multicast groups.
Related commands: igmp host-join.
Examples
# Display the information of all IGMP multicast groups on the switch.
<Sysname> display igmp group
Total 3 IGMP groups reported on this router
LoopBack0 (20.20.20.20): Total 3 IGMP Groups reported:
Group Address Last Reporter Uptime Expires
225.1.1.1 20.20.20.20 00:02:04 00:01:15
225.1.1.3 20.20.20.20 00:02:04 00:01:15
225.1.1.2 20.20.20.20 00:02:04 00:01:17
Table 2-1 display igmp group command output description
Field |
Description |
Group address |
Multicast group address |
Last Reporter |
The last host that reported a membership for this group |
Uptime |
Time elapsed since multicast group was first reported (hh: mm: ss). |
Expires |
Remaining lifetime of the multicast group (hh: mm: ss). |
display igmp interface
Syntax
display igmp interface [ interface-type interface-number ]
View
Any view
Parameters
interface-type interface-number: Specifies an interface by its type and number. With this argument provided, the command displays the IGMP configuration and running information on the specified interface; otherwise, the command displays the IGMP information on all interfaces running IGMP.
Description
Use the display igmp interface command to display the IGMP configuration and running information on the specified interface or all interfaces.
Examples
# Display the IGMP configuration and running information on Vlan-interface 1.
<Sysname> display igmp interface Vlan-interface 1
Vlan-interface1 (10.153.17.99):
IGMP is enabled
Current IGMP version is 2
Value of query interval for IGMP(in seconds): 60
Value of other querier time out for IGMP(in seconds): 120
Value of maximum query response time for IGMP(in seconds): 10
Value of robust count for IGMP: 2
Value of startup query interval for IGMP(in seconds): 15
Value of last member query interval for IGMP(in seconds): 1
Value of query timeout for IGMP version 1(in seconds): 400
Policy to accept IGMP reports: none
Querier for IGMP: 10.153.17.99 (this router)
IGMP group limit is 256
Table 2-2 display igmp interface command output description
Field |
Description |
Vlan-interface1 (10.153.17.99): |
Interface name (IP address) |
IGMP is enabled |
IGMP is currently enabled on the interface. If IGMP is not enabled, no output information is displayed. |
Current IGMP version is 2 |
IGMP version 2 (default) is running on the current interface. |
Value of query interval for IGMP(in seconds): 60 |
The IGMP query interval is 60 seconds (default). |
Value of other querier time out for IGMP(in seconds): 120 |
The other querier present interval is 120 seconds (default). |
Value of maximum query response time for IGMP(in seconds): 10 |
The maximum response time for IGMP general queries is 10 seconds (default). |
Value of robust count for IGMP: 2 |
The IGMP robustness variable is 2 (default). |
Value of startup query interval for IGMP(in seconds): 15 |
The IGMP startup query interval is 15 seconds (default). |
Value of last member query interval for IGMP(in seconds): 1 |
The IGMP last member query interval is 1 second (default). |
Value of query timeout for IGMP version 1(in seconds): 400 |
The query timeout time for IGMPv1 is 400 seconds (default). |
Policy to accept IGMP reports: none |
IGMP multicast group filtering policy for controlling the access to multicast groups. “None” means no filtering policy is applied; otherwise, the applied policy is displayed. For example, “acl 2000, only for IGMP version 1” means ACL 2000 is applied only on IGMPv1 reports. |
Querier for IGMP: 10.1.0.5 (this router) |
The IGMP querier address is 10.1.0.5 (this device). |
IGMP group limit: 256 |
The maximum number of IGMP multicast groups that can be joined on the VLAN interface is 256. |
Total 1 IGMP group reported |
Total number of IGMP multicast groups on the interface is 1. |
igmp enable
Syntax
igmp enable
undo igmp enable
View
Interface view
Parameters
None
Description
Use the igmp enable command to enable IGMP on an interface.
Use the undo igmp enable command to disable IGMP on an interface.
By default, IGMP is disabled on an interface. .
These commands do not take effect until the multicast routing feature is enabled. You need to use this command before you can configure other IGMP features.
Related commands: multicast routing-enable.
Examples
# Enable IGMP on VLAN-interface 10.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] igmp enable
igmp group-limit
Syntax
igmp group-limit limit
undo igmp group-limit
View
Interface view
Parameters
limit: The maximum number of multicast groups that can be joined on the interface, in the range of 0 to 256.
Description
Use the igmp group-limit command to configure the maximum number of multicast groups allowed on the interface. The switch does not process any new IGMP report messages if the number of multicast groups on the interface reaches the limit.
Use the undo igmp group-limit command to restore the default.
By default, up to 256 multicast groups can be joined to an interface.
If you use the command for a second time, the new configuration overwrites the existing one.
l After the maximum number of multicast groups is reached, the interface will not join any new multicast group.
l If you configure the maximum number of multicast groups allowed on the interface to 1, a new group registered on the interface supersedes the existing one automatically.
l If the number of existing multicast groups is larger than the configured limit on the number of joined multicast groups on the interface, the system will remove the oldest entries automatically until the number of multicast groups on the interface comes down to the configured limit.
Examples
# Configure to allow a maximum of 100 multicast groups to be joined on VLAN-interface 10.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] igmp group-limit 100
igmp group-policy
Syntax
igmp group-policy acl-number [ 1 | 2 | port interface-list ]
undo igmp group-policy [ port interface-list ]
View
Interface view
Parameters
acl-number: Basic ACL number, defining a multicast group range. The value ranges from 2,000 to 2,999.
1: Configures the interface to accept only IGMPv1 report messages.
2: Configures the interface to accept only IGMPv2 report messages (default).
port interface-list: Configures a multicast group filter on the specified port or ports. With the interface-list argument, you can define one or more individual ports (in the form of interface-type interface-number) and/or one or more port ranges (in the form of interface-type interface-number1 to interface-type interface-number2, where interface-number2 must be greater than interface-number1). The total number of individual ports plus port ranges cannot exceed 10. For port types and port numbers, refer to the parameter description in the “Port Basic Configuration” part in this manual.
In LoopBack interface view, this command does not support the port interface-list option.
Description
Use the igmp group-policy command to configure a multicast group filter on the current interface to control the access to the multicast groups in the defined group range.
Use undo igmp group-policy command to remove the multicast group filter configured.
By default, no filter is configured; that is, a host can join any multicast group.
If you do not want the hosts on the network attached to the interface to join some multicast groups, use this command to limit the range of the multicast groups served by the interface.
Related commands: igmp host-join.
Be sure that the Ethernet ports specified in the command belong to the VLAN interfaces on which the command is configured, but not other VLAN interfaces.
Examples
# Configure a multicast group filter on VLAN-interface 10 so that the hosts on the subnet attached to the interface can join only multicast group 225.1.1.1 and the interface accepts only IGMPv2 reports.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] acl number 2000
[Sysname-acl-basic-2000] rule permit source 225.1.1.1 0
[Sysname-acl-basic-2000] quit
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] igmp group-policy 2000 2
igmp group-policy vlan
Syntax
igmp group-policy acl-number vlan vlan-id
undo igmp group-policy vlan vlan-id
View
Ethernet port view
Parameters
acl-number: Basic ACL number, defining a multicast group range. The value ranges from 2,000 to 2,999.
vlan vlan-id: Specifies the VLAN to which the current port belongs. The effective range for vlan-id is 1 to 4094.
Description
Use the igmp group-policy vlan command to configure a multicast group filter on the current port to control the access to the multicast groups in the defined group range.
Use the undo igmp group-policy vlan command to remove the configured multicast group filter.
By default, no filter is configured; that is, a host can join any multicast group.
To restrict the hosts attached to a port from joining certain multicast groups, you can use this command to limit the range of multicast groups that the port serves. This command delivers the same result as the igmp group-policy command.
Note that the port on which the command is configured must belong to the specified VLAN and be IGMP enabled; otherwise, the configuration does not take effect.
Related commands: igmp group-policy.
Examples
# Allow hosts attached to Ethernet 1/0/1 in VLAN 10 to join only multicast group 225.1.1.1.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] acl number 2000
[Sysname-acl-basic-2000] rule permit source 225.1.1.1 0
[Sysname-acl-basic-2000] quit
[Sysname] interface Ethernet 1/0/1
[Sysname-Ethernet1/0/1] port access vlan 10
[Sysname-Ethernet1/0/1] igmp group-policy 2000 vlan 10
igmp host-join port
Syntax
igmp host-join group-address port interface-list
undo igmp host-join group-address port interface-list
View
Interface view
Parameters
group-address: Address of the multicast group to join.
port interface-list: Configures the specified port or ports under the current VLAN interface as simulated member host(s) for the specified multicast group. With the interface-list argument, you can define one or more individual ports (in the form of interface-type interface-number) and/or one or more port ranges (in the form of interface-type interface-number1 to interface-type interface-number2, where interface-number2 must be greater than interface-number1). The total number of individual ports plus port ranges cannot exceed 10. For port types and port numbers, refer to the parameter description in the “Port Basic Configuration” part in this manual.
In LoopBack interface view, this command does not support the port interface-list option.
Description
Use the igmp host-join port command to configure one or more ports under the current VLAN interface as simulated member hosts to join the specified multicast group.
Use undo igmp host-join port command to restore the default.
By default, simulated joining is disabled.
Examples
# Configure Ethernet 1/0/1 under VLAN-interface 10 as a simulated member host to join multicast group 225.0.0.1.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] igmp host-join 225.0.0.1 port Ethernet 1/0/1
igmp host-join vlan
Syntax
igmp host-join group-address vlan vlan-id
undo igmp host-join group-address vlan vlan-id
View
Ethernet port view
Parameters
group-address: Address of the multicast group to join.
vlan vlan-id: Specifies the VLAN to which the port belongs. The effective range for vlan-id is 1 to 4094.
Description
Use the igmp host-join vlan command to configure the current Ethernet port as a simulated member host to join the specified multicast group.
Use the undo igmp host-join vlan command to restore the default.
By default, simulated joining is disabled.
Related commands: igmp group-policy.
Examples
# Configure Ethernet 1/0/1 under VLAN-interface 10 as a simulated member host to join multicast group 225.0.0.1.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Ethernet 1/0/1
[Sysname-Ethernet1/0/1] port access vlan 10
[Sysname-Ethernet1/0/1] igmp host-join 225.0.0.1 vlan 10
igmp lastmember-queryinterval
Syntax
igmp lastmember-queryinterval seconds
undo igmp lastmember-queryinterval
View
Interface view
Parameters
seconds: Interval in seconds for the IGMP querier to send IGMP group-specific query messages upon receiving an IGMP leave message, in the range of 1 to 5.
Description
Use the igmp lastmember-queryinterval command to configure the IGMP last-member query interval, namely the interval between IGMP group-specific queries the IGMP querier sends upon receiving an IGMP leave message.
Use the undo igmp lastmember-queryinterval command to restore the default.
The IGMP last-member query interval is 1 second by default.
Related commands: igmp robust-count, display igmp interface.
Examples
# Set the IGMP last-member query interval to 3 seconds on VLAN-interface 10.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] igmp lastmember-queryinterval 3
igmp max-response-time
Syntax
igmp max-response-time seconds
undo igmp max-response-time
View
Interface view
Parameters
seconds: Maximum response time in seconds in the IGMP general query messages, ranging from 1 to 25.
Description
Use the igmp max-response-time command to configure the maximum response time carried in the IGMP general query messages.
Use the undo igmp max-response-time command to restore the default.
The maximum response time is 10 seconds by default.
Related commands: display igmp interface.
Examples
# On VLAN-interface 10, configure the maximum response time carried in IGMP general query messages to 8 seconds.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] igmp max-response-time 8
igmp proxy
Syntax
igmp proxy interface-type interface-number
undo igmp proxy
View
Interface view
Parameters
interface-type interface-number: Specifies the interface for which the current interface will act as the IGMP proxy interface.
Description
Use the igmp proxy command to configure the current interface as the IGMP proxy interface for another interface on the Layer 3 switch.
Use the undo igmp proxy command to restore the default.
No interface is configured as the IGMP proxy interface for another.
Before configuring the igmp proxy command on an interface, you must enable PIM on it. One interface cannot serve as the IGMP proxy interface for two or more interfaces.
If the IGMP proxy feature is configured repeatedly on the same interface, the last configuration takes effect.
Related commands: pim neighbor-policy.
Examples
# Configure VLAN-interface 1 as the IGMP proxy interface for VLAN-interface 2 on the Layer 3 switch.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
[Sysname] interface vlan-interface 1
[Sysname-Vlan-interface1] pim dm
[Sysname-Vlan-interface1] igmp enable
[Sysname- Vlan-interface1] igmp proxy vlan-interface 2
igmp robust-count
Syntax
igmp robust-count robust-value
undo igmp robust-count
View
Interface view
Parameters
robust-value: IGMP robustness variable, namely the number of IGMP group-specific query messages the switch sends upon receiving an IGMP Leave message. The effective range is 2 to 5.
Description
Use the igmp robust-count command to configure the IGMP robustness variable.
Use the undo igmp robust-count command to restore the default.
By default, an IGMP querier sends two IGMP group-specific query messages after receiving an IGMP Leave message.
Related commands: igmp lastmember-queryinterval, display igmp interface.
Examples
# Set the IGMP robustness variable to 3 on VLAN-interface 10.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] igmp robust-count 3
igmp timer other-querier-present
Syntax
igmp timer other-querier-present seconds
undo igmp timer other-querier-present
View
Interface view
Parameters
seconds: Other querier present interval in seconds, in the range of 1 to 131,070.
Description
Use the igmp timer other-querier-present command to configure the other querier present interval, namely the length of time a non-querier waits before it assumes that the current IGMP querier is down.
Use the undo igmp timer other-querier-present command to restore the default value.
By default, the other querier present interval is twice the value of IGMP query interval, that is, 120 seconds if the IGMP query interval has not been manually configured.
On a multi-access network, that is, the same network segment including multiple multicast routers, the query router (known as querier) is responsible for sending general query messages periodically through the VLAN interface. If a non-queriers receive no query messages within the other querier present interval, it assumes that the current querier is down and a new querier election process takes place.
In IGMP version 1, the selection of a querier is determined by the multicast routing protocol. In IGMP version 2, the router with the lowest IP address on the shared network segment acts as the querier.
Related commands: igmp timer query, display igmp interface.
Examples
# Configure the querier to expire in 300 seconds.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] igmp timer other-querier-present 300
igmp timer query
Syntax
igmp timer query seconds
undo igmp timer query
View
Interface view
Parameters
seconds: IGMP query interval, namely the interval between IGMP general query messages, in the range of 1 to 65,535 seconds.
Description
Use the igmp timer query command to configure the interval between IGMP general query messages.
Use the undo igmp timer query command to restore the default.
By default, the IGMP query interval is 60 seconds.
A multicast router periodically sends IGMP general query messages onto the attached subnets to determine whether multicast group members are present on the subnets. The IGMP query interval can be tuned according to the practical conditions of the network.
Related commands: igmp timer other-querier-present.
Examples
# Set the IGMP query interval to 150 seconds on VLAN-interface 2.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Vlan-interface 2
[Sysname-Vlan-interface2] igmp timer query 150
igmp version
Syntax
igmp version { 1 | 2 }
undo igmp version
View
Interface view
Parameters
1: Specifies IGMP version 1.
2: Specifies IGMP version 2.
Description
Use the igmp version command to specify the version of IGMP to run on the interface.
Use the undo igmp version command to restore the default.
The default IGMP version is IGMP version 2.
The device cannot automatically switch between different IGMP versions, so all the devices on a subnet must run the same version of IGMP.
Examples
# Run IGMPv1 on VLAN-interface 10.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] igmp version 1
reset igmp group
Syntax
reset igmp group { all | interface interface-type interface-number { all | group-address [ group-mask ] } }
View
User view
Parameters
all: The first all refers to all interfaces, while the second all refers to all IGMP multicast groups.
interface interface-type interface-number: Specifies an interface by its type and number. With an interface specified, the command clears the IGMP multicast group information on the specified interface.
group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255. With this argument provided, the command clears the specified multicast group or group range.
group-mask: Mask of the multicast group address, 255.255.255.255 by default.
Description
Use the reset igmp group command to clear IGMP multicast group information on the interface. The groups removed with this command can be joined again.
Examples
# Remove all multicast groups on all the interfaces.
<Sysname> reset igmp group all
# Remove all multicast groups on VLAN-interface 10.
<Sysname> reset igmp group interface Vlan-interface10 all
# Remove group 225.0.0.1 on VLAN-interface 10.
<Sysname> reset igmp group interface Vlan-interface10 225.0.0.1
# Remove the multicast groups ranging from 225.1.1.0 to 225.1.1.255 on VLAN-interface 10.
<Sysname> reset igmp group interface Vlan-interface10 225.1.1.0 255.255.255.0
PIM Configuration Commands
bsr-policy
Syntax
bsr-policy acl-number
undo bsr-policy
View
PIM view
Parameters
acl-number: ACL number to be used in the BSR filtering policy, in the range of 2000 to 2999.
Description
Use the bsr-policy command to limit the range of legal BSRs to prevent BSR spoofing.
Use the undo bsr-policy command to restore the default.
By default, no range limit is configured, namely all received messages are considered legal.
The source keyword in the rule command is translated into BSR address in the bsr-policy command.
Examples
# Configure a BSR filtering policy on devices to allow only the multicast devices on subnet 101.1.1.1/32 to become BSR.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
[Sysname] pim
[Sysname-pim] bsr-policy 2000
[Sysname-pim] quit
[Sysname] acl number 2000
[Sysname-acl-basic-2000] rule 0 permit source 101.1.1.1 0
c-bsr
Syntax
c-bsr interface-type interface-number hash-mask-len [ priority ]
undo c-bsr
View
PIM view
Parameters
interface-type interface-number: Specifies an interface that will be configured as a C-BSR. This configuration takes effect only after PIM-SM is enabled on the interface.
hash-mask-len: Length of the hash mask used for RP calculation. The effective range is 0 to 32.
priority: C-BSR priority. The effective range is 0 to 255, 0 by default.
Description
Use the c-bsr command to configure the specified interface as a C-BSR.
Use the undo c-bsr command to remove the C-BSR configuration.
By default, no C-BSR is configured.
For the configuration of the candidate BSR, the larger bandwidth should be guaranteed because a large amount of information will be exchanged between the BSR and other devices in the PIM domain.
Related commands: pim sm.
Examples
# Configure VLAN-interface 10 on the switch as a C-BSR with a priority of 2 and the hash mask length of 24.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
[Sysname] pim
[Sysname-pim] c-bsr vlan-interface 10 24 2
c-rp
Syntax
c-rp interface-type interface-number [ group-policy acl-number | priority priority-value ]*
undo c-rp { interface-type interface-number | all }
View
PIM view
Parameters
interface-type interface-number: Specifies an interface of which the IP address will be advertised as a C-RP address.
group-policy: Defines a group range to be served by the specified interface after it becomes the RP.
acl-number: Basic ACL number, in the range of 2,000 to 2,999. Used together with the group-policy keyword, this argument defines the group range mentioned above.
priority priority-value: C-RP priority, in the range of 0 to 255, 0 by default. A greater value means a lower priority.
all: Removes all C-RPs configured.
Description
Use the c-rp command to configure an interface as a C-RP.
Use the undo c-rp command to remove the configuration.
By default, no C-RP is configured.
For the configuration of a C-RP, a relatively large bandwidth should be reserved for the switch and other devices in the PIM domain.
Related commands: c-bsr.
Examples
# Configure VLAN-interface 10 of the switch as a C-RP, which will serve multicast groups 225.0.0.0 to 225.255.255.255 after it wins RP election.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
[Sysname] acl number 2000
[Sysname-acl-basic-2000] rule permit source 225.0.0.0 0.255.255.255
[Sysname] pim
[Sysname-pim] c-rp vlan-interface 10 group-policy 2000
crp-policy
Syntax
crp-policy acl-number
undo crp-policy
View
PIM view
Parameters
acl-number: Advanced ACL number, ranging from 3000 to 3999. When defining the ACL, use the source keyword in the rule command to specify a C-RP address and use the destination keyword to specify a multicast address range that the C-RP will serve.
Description
Use the crp-policy command to configure a valid C-RP address range and a multicast group range that the C-RPs will serve to prevent C-RP spoofing.
Use the undo crp-policy command to restore the default.
By default, there is no limit on the C-RP address range or the multicast address range that a C-RP serves, that is, all the C-RP-Adv messages are considered to valid.
Examples
# Configure a C-RP policy on the BSR so that only multicast devices on subnet 1.1.1.1/32 to become C-RPs to serve only the multicast groups in the range of 225.1.0.0/16.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
[Sysname] pim
[Sysname-pim] crp-policy 3000
[Sysname-pim] quit
[Sysname] acl number 3000
[Sysname-acl-adv-3000] rule 0 permit source 1.1.1.1 0 destination 225.1.0.0 0.0.255.255
display pim bsr-info
Syntax
display pim bsr-info
View
Any view
Parameters
None
Description
Use the display pim bsr-info command to display the BSR information.
Related commands: c-bsr, c-rp.
Examples
# Display the BSR information.
<Sysname> display pim bsr-info
Current BSR Address: 20.20.20.30
Priority: 0
Mask Length: 30
Expires: 00:01:55
Local host is BSR
Table 3-1 display pim bsr-info command output description
Field |
Description |
Current BSR Address |
BSR address |
Priority |
BSR priority |
Mask Length: 30 |
Hash mask length |
Expires: 00:01:55 |
Remaining lifetime of the BSR |
Local host is BSR |
The local device serves as the BSR. |
display pim interface
Syntax
display pim interface [ interface-type interface-number ]
View
Any view
Parameters
interface-type interface-number: Specifies an interface by its type and number.
Description
Use the display pim interface command to display the PIM configuration information.
With an interface specified, the command displays the PIM configuration information on the specified interface; otherwise, the command displays the PIM configuration information on all interfaces.
Examples
# Display the PIM configuration information on all interfaces.
<Sysname> display pim interface
PIM information of VLAN-interface 2:
IP address of the interface is 10.10.1.20
PIM is enabled
PIM version is 2
PIM mode is Sparse
PIM query interval is 30 seconds
PIM neighbor limit is 128
PIM neighbor policy is none
Total 1 PIM neighbor on interface
PIM DR(designated router) is 10.10.1.20
Table 3-2 display pim interface command output description
Field |
Description |
IP address of the interface |
IP address of the VLAN interface |
PIM version |
PIM version running on the interface |
PIM mode |
PIM mode enabled on the VLAN interface (DM or SM) |
PIM query interval |
Hello interval |
PIM neighbor limit |
Limit on the number of PIM neighbors on the VLAN interface. No neighbor can be added when the limit is reached |
PIM neighbor policy |
Filtering policy of the PIM neighbors on the current interface |
Total 1 PIM neighbor on interface |
Totally, one PIM neighbor is present on this VLAN interface. |
PIM DR |
Designated router |
display pim neighbor
Syntax
display pim neighbor [ interface interface-type interface-number ]
View
Any view
Parameters
interface interface-type interface-number: Specifies an interface by its type and number.
Description
Use the display pim neighbor command to display the PIM neighbor information.
With an interface specified, the command displays the PIM neighbor information on the specified interface; otherwise, the command displays the PIM neighbor information on all interfaces.
Examples
# Display the PIM neighbor information on all interfaces.
<Sysname> display pim neighbor
Neighbor Address Interface Name Uptime Expires
8.8.8.6 VLAN-interface10 1637 89
8.8.7.6 VLAN-interface11 1636 88
Table 3-3 display pim neighbor command output description
Field |
Description |
Neighbor Address |
Neighbor address |
Interface Name |
VLAN interface on which the neighbor has been discovered |
Uptime |
Time elapsed since the multicast group was discovered |
Expires |
Remaining lifetime of the PIM neighbor |
display pim routing-table
Syntax
display pim routing-table [ { { *g [ group-address [ mask { mask-length | mask } ] ] | **rp [ rp-address [ mask { mask-length | mask } ] ] } | { group-address [ mask { mask-length | mask } ] | source-address [ mask { mask-length | mask } ] } * } | incoming-interface interface-type interface-number | { dense-mode | sparse-mode } ] *
View
Any view
Parameters
*g: Specifies a (*, G) entry.
**rp: Specifies a (*, *, RP) route entry.
rp-address: RP address.
group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255.
source-address: Multicast source address.
mask: Mask of the multicast group address, multicast source address, or RP address, 255.255.255.255 by default.
mask-length: Mask length of the multicast group address, multicast source address, or RP address, in the range of 0 to 32. The system default is 32.
incoming-interface: Displays multicast routing entries containing the specified incoming interface.
interface-type interface-number: Specifies an interface by its type and number. If you specify null, the command displays the multicast routing entries without an incoming interface.
dense-mode: Displays PIM-DM multicast routing information.
sparse-mode: Displays PIM-SM multicast routing information.
Description
Use the display pim routing-table command to display information about the PIM multicast routing table.
The displayed information includes the SPT information and RPF information.
Examples
# Display the information about the PIM multicast routing table.
<Sysname> display pim routing-table
PIM-SM Routing Table
Total 1 (S,G) entry, 1 (*,G) entry, 0 (*,*,RP) entry
(*, 228.0.0.0), RP 23.12.0.1
Protocol 0x20: PIMSM, Flag 0x3: RPT WC
Uptime: 00:00:13, Timeout in 197 sec
Upstream interface: Vlan-interface1, RPF neighbor: 200.1.0.1
Downstream interface list:
Vlan-interface401, Protocol 0x100: RPT, timeout in 197 sec
(196.0.0.3, 228.0.0.0)
Protocol 0x20: PIMSM, Flag 0x4: SPT
Uptime: 00:10:49, Timeout in 196 sec
Upstream interface: Vlan-interface196, RPF neighbor: NULL
Downstream interface list:
Vlan-interface401, Protocol 0x100: SPT, timeout in 197 sec
Matched 1 (S,G) entry, 1 (*,G) entry, 0 (*,*,RP) entry
Table 3-4 display pim routing-table command output description
Field |
Description |
Total 1 (*, G) entry; 1 (S, G) entry,0 (*,*,RP) entry |
Total number of (S, G), (*, G) and (*, *, RP) entries in the PIM routing table |
(*, 228.0.0.0) |
A (*, G) entry in the PIM routing table |
RP |
Rendezvous point |
Protocol |
PIM mode (PIM-SM or PIM-DM) |
Flag |
Flag of (S, G) or (*, G) entry in the PIM routing table: l SPT: The (S, G) entry is on the SPT. l RPT: The (S, G) or (*, G) entry is on the RPT. l WC: Indicates the (*, G) entry. l LOC: The switch is connected with the multicast source directly. |
Uptime |
Time when the entry exists |
Timeout in 197 sec |
The table entry will expire in 197 seconds. |
Upstream interface |
Incoming interface |
Upstream neighbor |
Upstream neighbor |
RPT neighbor |
l For the (*, G) entry, when this switch is an RP, RPF neighbor field of the (*, G) entry is Null. l For the (S, G) entry, when this switch is directly connected with the source, is an RP, RPF neighbor field of the (S, G) entry is Null. |
Downstream interface list |
List of downstream interfaces |
display pim rp-info
Syntax
display pim rp-info [ group-address ]
View
Any view
Parameters
group-address: Multicast group address. With this argument provided, the command displays the RP information about the specified multicast group; otherwise, the command displays the RP information about all multicast groups.
Description
Use the display pim rp-info command to display the RP information of the multicast group.
The output of this command also includes BSR and static RP information.
Examples
# Display the RP information about all multicast groups.
<Sysname> display pim rp-info
PIM-SM RP-SET information:
BSR is: 4.4.4.6
Group/MaskLen: 224.0.0.0/4
RP 4.4.4.6
Version: 2
Priority: 0
Uptime: 00:39:50
Table 3-5 display pim rp-info command output description
Field |
Description |
PIM-SM RP-SET information: |
RP-Set |
BSR is: |
IP address of the BSR |
Group/MaskLen |
Multicast group range served by the RP |
RP |
IP address of the RP |
Version |
PIM version |
Priority |
RP priority |
Uptime |
Length of time for which the RP has existed |
Expires |
Remaining lifetime of the RP |
pim
Syntax
pim
undo pim
View
System view
Parameters
None
Description
Use the pim command to enter PIM view so that you can configure PIM parameters globally. Note that this command is not used to enable PIM.
Use the undo pim command to clear PIM configurations made in PIM view.
Examples
# Enter PIM view.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
[Sysname] pim
[Sysname-pim]
pim bsr-boundary
Syntax
pim bsr-boundary
undo pim bsr-boundary
View
Interface view
Parameters
None
Description
Use the pim bsr-boundary command to configure the current interface as the BSR service boundary, namely, the PIM-SM domain border.
Use the undo pim bsr-boundary command to remove the configured PIM-SM domain border.
By default, no PIM-SM domain border is configured on the switch.
After you use this command to set a PIM-SM domain border on an interface, no bootstrap message can cross this border in either direction. However, the other PIM protocol packets can pass the border. With this configuration, you can divide a PIM-SM network into regions with different BSRs.
Note that this command is not used to set up a multicast boundary.
Related commands: c-bsr.
Examples
# Configure a PIM domain border on VLAN-interface 10.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
[Sysname] pim
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] pim bsr-boundary
pim dm
Syntax
pim dm
undo pim dm
View
Interface view
Parameters
None
Description
Use the pim dm command to enable PIM-DM.
Use the undo pim dm command to disable PIM-DM.
By default, PIM-DM is disabled.
Typically, PIM-DM should be enabled on all interfaces.
Before enabling PIM-DM, you must enable multicast routing first.
Related commands: multicast routing-enable.
Examples
# Enable PIM-DM on VLAN-interface 10.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] pim dm
pim neighbor-limit
Syntax
pim neighbor-limit limit
undo pim neighbor-limit
View
Interface view
Parameters
limit: Maximum number of PIM neighbors on the interface, in the range of 0 to 128.
Description
Use the pim neighbor-limit command to configure the upper threshold of the number of PIM neighbors on the current interface. The switch will add no more neighbors for the interface when the limit is reached.
Use the undo pim neighbor-limit command to restore the default.
By default, a switch can have a maximum of 128 PIM neighbors on an interface.
If you figure a threshold smaller than the current number of PIM neighbors, the existing PIM neighbors will not be deleted immediately.
Examples
# Limit the number of PIM neighbors to 50 on VLAN-interface 10.
<Sysname>system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] pim neighbor-limit 50
pim neighbor-policy
Syntax
pim neighbor-policy acl-number
undo pim neighbor-policy
View
Interface view
Parameters
acl-number: Basic ACL number, in the range of 2,000 to 2,999.
Description
Use the pim neighbor-policy command to configure a PIM neighbor filter on the current interface.
Use the undo pim neighbor-policy command to disable PIM neighbor filtering on the current interface.
With a PIM neighbor filter configured, only the switches that pass the filtering rule in the ACL can become PIM neighbors of the current VLAN interface.
The new configuration overwrites the old one if you run the command for a second time.
By default, no rule is configured to filter PIM neighbors on the current interface.
Examples
# Configure a PIM neighbor filter on VLAN-interface 10 so that only 10.10.1.2 can become its PIM neighbor.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] acl number 2000
[Sysname-acl-basic-2000] rule permit source 10.10.1.2 0
[Sysname-acl-basic-2000] rule deny source any
[Sysname-acl-basic-2000] quit
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] pim neighbor-policy 2000
pim sm
Syntax
pim sm
undo pim sm
View
Interface view
Parameters
None
Description
Use the pim sm command to enable PIM-SM on the current interface.
Use the undo pim sm command to disable PIM-SM on the current interface.
By default, PIM-SM is disabled.
Typically, PIM-SM should be enabled on all interfaces.
Before enabling PIM-SM, you must enable multicast routing first.
Related commands: multicast routing-enable.
Examples
# Enable the PIM-SM protocol on VLAN-interface 10.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] pim sm
pim timer hello
Syntax
pim timer hello seconds
undo pim timer hello
View
Interface view
Parameters
seconds: PIM Hello interval in seconds, namely the interval between PIM Hello messages, in the range of 1 to 18,000.
Description
Use the pim timer hello command to configure the PIM Hello interval on the current interface.
Use the undo pim timer hello command to restore the default.
By default, an interface sends Hello messages at the interval of 30 seconds.
After PIM-SM is enabled on an interface, the switch periodically sends Hello messages to all the PIM-capable devices to discover PIM neighbors. If the interface receives Hello messages, it means that the interface is connected to neighboring network devices that support PIM, and the interface will add the neighbors to its own neighbor list. If the interface receives no Hello messages from a neighbor in its neighbor list within the specified time, the neighbor is considered to have expired or failed.
Examples
# Configure VLAN-interface 10 of the switch to send Hello messages at the interval of 40 seconds.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] pim timer hello 40
register-policy
Syntax
register-policy acl-number
undo register-policy
View
PIM view
Parameters
acl-number: Number of IP advanced ACL that defines the rule for filtering the source and group addresses. The value ranges from 3000 to 3999. Only register messages that match the permit statement can be accepted by the RP.
Description
Use the register-policy command to configure a rule for filtering register messages.
Use the undo register-policy command to remove a rule for filtering register messages.
By default, no rule for filtering register messages is configured.
Examples
# Configure a rule for filtering register messages on the RP to allow multicast sources in the range of 10.10.0.0/16 to send multicast data to multicast groups in the range of 225.1.0.0/16.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] acl number 3010
[Sysname-acl-adv-3010] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255
[Sysname-acl-adv-3010] quit
[Sysname] pim
[Sysname-pim] register-policy 3010
reset pim neighbor
Syntax
reset pim neighbor { all | { neighbor-address | interface interface-type interface-number } * }
View
User view
Parameters
all: Clears all PIM neighbors.
neighbor-address: Neighbor address.
interface interface-type interface-number: Specifies an interface by its type and number. With an interface specified, the command clears PIM neighbors of the specified interface only.
Description
Use the reset pim neighbor command to clear the specified PIM neighbor, PIM neighbors on the specified VLAN interface, or all PIM neighbors.
Related commands: display pim neighbor.
Examples
# Clear the PIM neighbor 25.5.4.3.
<Sysname> reset pim neighbor 25.5.4.3
reset pim routing-table
Syntax
reset pim routing-table { all | { group-address [ mask { mask-length | mask } ] | source-address [ mask { mask-length | mask } ] | incoming-interface interface-type interface-number } * }
View
User view
Parameters
all: Clears all PIM routing entries.
group-address: Multicast group address in the range of 224.0.0.0 to 239.255.255.255.
source-address: Multicast source address.
mask: Mask of the multicast group address or multicast source address, 255.255.255.255 by default.
mask-length: Mask length of the multicast group address or multicast source address, in the range of 0 to 32. The system default is 32.
incoming-interface: Specifies the incoming interface. With this keyword provided, the command clears the PIM routing entries of which the incoming interface is the specified one.
interface-type interface-number: Specifies an interface by its type and number. If you specify null, the command clears the multicast routing entries without an incoming interface.
Use the reset pim routing-table command to clear PIM route entries.
You can provide a source address before or after a group address in the command, as long as they are valid. An error message will be given if you type an invalid address.
In this command, if the group-address is 224.0.0.0/24 and source-address is the RP address (where group address can have a mask, but the resulted IP address must be 224.0.0.0, and source address has no mask), then it means only the (*, *, RP) entry will be cleared.
In this command, if the group-address is a group address, and source-address is 0 (where group address can have a mask and source address has no mask), then only the (*, G) entry will be cleared.
This command shall clear not only multicast route entries from PIM routing table, but also the corresponding route entries and forward entries in the multicast core routing table and MFC.
Related commands: reset multicast routing-table, reset multicast forwarding-table, display pim routing-table.
Examples
# Clear the route entries with the group address of 225.5.4.3 from the PIM routing table.
<Sysname> reset pim routing-table 225.5.4.3
spt-switch-threshold
Syntax
spt-switch-threshold infinity [ group-policy acl-number [ order order-value ] ]
undo spt-switch-threshold [ group-policy acl-number ]
View
PIM view
Parameters
infinity: Specifies to disable RPT-to-SPT switchover.
group-policy acl-number: Applies the configuration to multicast groups that match the specified group policy, where acl-number indicates a basic ACL number, ranging from 2000 to 2999. If no group policy is specified, the configuration applies to all multicast groups.
order order-value: Specifies the order number of the ACL in the group-policy list, where order-value has an effective range of 1 to (the largest order value in the existing group-policy list + 1), but the value range should not include the original order value of the ACL in the group-policy list. If you have assigned an order-value to a certain ACL, do not specify the same order-value for another ACL; otherwise the system gives error information. If you do not specify an order-value, the order value of the ACL will remain the same in the group-policy list.
Description
Use the spt-switch-threshold command to configure the conditions for disabling RPT-to-SPT switchover.
Use the undo spt-switch-threshold command to restore the default setting.
By default, a RPT-to-SPT switchover occurs once the device receives the first multicast packet.
Note that:
l To adjust the order of an ACL that already exists in the group-policy list, you can use the acl-number argument to specify this ACL and set its order-value. This will insert the ACL to the position of order-value in the group-policy list. The order of the other existing ACLs in the group-policy list will remain unchanged.
l To use an ACL in the group-policy list, you can use the acl-number argument to specify this ACL and set its order-value. This will insert the ACL to the position of order-value in the group-policy list. If you do not include the order order-value option in your command, the ACL will be appended to the end of the group-policy list.
l If you use this command multiple times on the same multicast group, the first matched traffic rate configuration in sequence will take effect.
l Once a multicast forwarding entry is created, subsequent multicast data will not be encapsulated in register messages before being forwarded even if a register outgoing interface exists. Therefore, to avoid forwarding failure, do not include the infinity keyword in the spt-switch-threshold command on a switch that may become an RP (namely, a static RP or a C-RP).
Examples
# Disable RPT-to-SPT switchover on a switch that will never become an RP.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] pim
[Sysname-pim] spt-switch-threshold infinity
source-lifetime
source-lifetime interval
undo source-lifetime
View
PIM view
Parameters
interval: Multicast source lifetime in seconds, with an effective range of 210 to 31536000.
Description
Use the source-lifetime command to configure the multicast source lifetime, also known as (S, G) aging time.
Use the undo source-lifetime command to restore the default.
By default, the lifetime of a multicast source is 210 seconds.
The configured multicast source lifetime applies to all (S, G) entries in the PIM routing table and the multicast routing table rather than on a specific (S, G) entry, and the configuration changes the aging time of all the existing (S, G) entries.
Examples
# Set the multicast source lifetime to 3000 seconds.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] pim
[Sysname-pim] source-lifetime 3000
source-policy
Syntax
source-policy acl-number
undo source-policy
View
PIM view
Parameters
acl-number: Basic or advanced ACL, in the range of 2000 to 3999.
Description
Use the source-policy command to configure the switch to filter the received multicast data packets as per the source address(es) or source and group addresses defined in the ACL rule.
Use the undo source-policy command to remove the configuration.
If a basic ACL is employed in the command, the switch filters all the received multicast data packets as per the defined resource address(es). Those fail to pass the filtering will be discarded.
If an advanced ACL is employed in the command, the switch filters all the received multicast data packets as per the defined resource and group addresses. Those fail to pass the filtering will be discarded.
This feature filters not only multicast data packets, but also the multicast data encapsulated in registration messages.
The new configuration overwrites the old one if you run the command for a second time.
Examples
# Configure the switch to accept the multicast data packets from any multicast source but 10.10.1.1.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] multicast routing-enable
[Sysname] pim
[Sysname-pim] source-policy 2000
[Sysname-pim] quit
[Sysname] acl number 2000
[Sysname-acl-basic-2000] rule deny source 10.10.1.1 0
[Sysname-acl-basic-2000] rule permit source any
static-rp
Syntax
static-rp rp-address [ acl-number ]
undo static-rp
View
PIM view
Parameters
rp-address: Static RP address. It must be a legal unicast IP address.
acl-number: Specifies a basic ACL, used to control the range of multicast groups to be served by the static RP. The effective range is 2000 to 2999. If no ACL is specified in the command, the static RP will serve all multicast groups; otherwise, the static RP will serve only the multicast groups passing the ACL filtering.
Description
Use the static-rp command to configure a static RP.
Use the undo static-rp command to remove the static RP configuration.
A static RP functions as a backup for the dynamically elected RP to improve network robustness. When the RP elected through the BSR mechanism functions, the static RP does not take effect. The same RP address must be configured on all the devices in the PIM domain.
The new configuration overwrites the existing one if you execute the command for a second time.
Related commands: display pim rp-info.
Examples
# Configure the device that has an interface address of 10.110.0.6 as a static RP that will serve only the multicast groups in the range of 225.0.0.0 to 225.255.255.255.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] acl number 2000
[Sysname-acl-basic-2000] rule permit source 225.0.0.0 0.255.255.255
[Sysname] multicast routing-enable
[Sysname] pim
[Sysname-pim] static-rp 10.110.0.6 2000
MSDP Configuration Commands
cache-sa-enable
Syntax
cache-sa-enable
undo cache-sa-enable
View
MSDP view
Parameters
None
Description
Use the cache-sa-enable command to enable the SA message caching mechanism.
Use the undo cache-sa-enable command to disable the SA message caching mechanism.
By default, the SA message caching mechanism is enabled.
With the SA message caching mechanism enabled, the switch sends no SA request message to the specified MSDP peer upon receiving a Join message.
Related commands: display msdp sa-cache, reset msdp sa-cache, display msdp sa-count
Examples
# Disable the SA message caching mechanism.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] msdp
[Sysname-msdp] undo cache-sa-enable
display msdp brief
Syntax
display msdp brief
View
Any view
Parameters
None
Description
Use the display msdp brief command to display the brief information of the MSDP peer state.
Examples
# Display the brief information of the MSDP peer state.
<Sysname> display msdp brief
MSDP Peer Brief Information
Peer's Address State Up/Down time AS SA Count Reset Count
20.20.20.20 Up 00:00:13 100 0 0
Table 4-1 display msdp brief command output description
Field |
Description |
Peer's Address |
Address of the MSDP peer |
State |
MSDP peer status: l Up: Session set up; MSDP peer in session l Listen: Session set up; local device as server, in listening state l Connect: Session not set up; local device as client, in connecting state l Shutdown: Deactivated l Down: Connection failed |
Up/Down time |
Time passed since MSDP peer connection establishment/failure |
AS |
Number of the AS where the MSDP peer is located. “?” indicates that the system was unable to obtain the AS number |
SA Count |
The number of (S, G) entries cached in the SA |
Reset Count |
Number of MSDP peer connection reset times |
display msdp peer-status
Syntax
display msdp peer-status [ peer-address ]
View
Any view
Parameters
peer-address: Specified the IP address of an MSDP peer of which the detailed information is to be displayed. Without this argument, the command displays the detailed information of all MSDP peers.
Description
Use the display msdp peer-status command to display the detailed MSDP peer state information.
Related commands: peer.
Examples
# Display the detailed information of MSDP peer 10.110.11.11.
<Sysname> display msdp peer-status 10.110.11.11
MSDP Peer 20.20.20.20, AS 100
Description:
Information about connection status:
State: Up
Up/down time: 14:41:08
Resets: 0
Connection interface: LoopBack0 (20.20.20.30)
Number of sent/received messages: 867/947
Number of discarded output messages: 0
Elapsed time since last connection or counters clear: 14:42:40
Information about (Source, Group)-based SA filtering policy:
Import policy: none
Export policy: none
Information about SA-Requests:
Policy to accept SA-Request messages: none
Sending SA-Requests status: disable
Minimum TTL to forward SA with encapsulated data: 0
SAs learned from this peer: 0, SA-cache maximum for the peer: none
Input queue size: 0, Output queue size: 0
Counters for MSDP message:
Count of RPF check failure: 0
Incoming/outgoing SA messages: 0/0
Incoming/outgoing SA requests: 0/0
Incoming/outgoing SA responses: 0/0
Incoming/outgoing data packets: 0/0
Table 4-2 display msdp peer-status command output description
Field |
Description |
MSDP Peer |
MSDP peer address |
AS |
Number of the AS where the MSDP peer is located. “?” indicates that the system was unable to obtain the AS number |
State |
MSDP peer status: l Up: Session set up; MSDP peer in session l Listen: Session set up; local device as server, in listening state l Connect: Session not set up; local device as client, in connecting state l Shutdown: Deactivated l Down: Connection failed |
Resets |
Number of times the MSDP peer connection is reset |
Up/Down time |
Time passed since MSDP peer connection establishment/failure |
Connection interface |
Interface and its IP address used for setting up a TCP connection with the remote MSDP peer |
Number of sent/received messages |
Number of SA messages sent and received through this connection |
Number of discarded output messages |
Number of discarded outgoing messages |
Elapsed time since last connection or counters clear |
Time passed since the information of the MSDP peer was last cleared |
Information about (Source, Group)-based SA filtering policy |
SA message filtering list information l Import policy: Filter list for receiving SA messages from the specified MSDP peer l Export policy: Filter list for forwarding SA messages from the specified MSDP peer |
Information about SA-Requests |
SA requests information l Policy to accept SA-Request messages: Filtering rule for receiving or forwarding SA messages from the specified MSDP peer l Sending SA-Requests status: Whether enabled to send an SA request message to the designated MSDP peer upon receiving a new Join message |
Minimum TTL to forward SA with encapsulated data |
Minimum TTL of multicast packet encapsulated in SA messages |
SAs learned from this peer |
Number of cached SA messages |
SA-cache maximum for the peer |
Maximum number of SA messages from the specified MSDP peer that can be cached |
Input queue size |
Data size cached in the input queue |
Output queue size |
Data size cached in the output queue |
Counters for MSDP message |
MSDP peer statistics: l Count of RPF check failure: Number of SA messages discarded due to RPF check failure l Incoming/outgoing SA messages: Number of SA messages received and sent l Incoming/outgoing SA requests: Number of SA request received and sent l Incoming/outgoing SA responses: Number of SA responses received and sent l Incoming/outgoing data packets: Number of received and sent SA messages encapsulated with multicast data |
display msdp sa-cache
Syntax
display msdp sa-cache [ group-address | source-address | as-number ] *
View
Any view
Parameters
group-address: Multicast group address. With this argument provided, the command displays the (S, G) entries for the specified multicast group.
source-address: Multicast source address. With this argument provided, the command displays the (S, G) entries for the specified multicast source.
as-number: AS number, in the range of 1 to 65535.
Description
Use the display msdp sa-cache command to display (S, G) entries in the SA cache.
Note that:
l This command gives the corresponding output only after the cache-sa-enable command is executed.
l If no group address is specified, this command displays the (S, G) entries for all multicast groups.
l If no source address is specified, this command displays the (S, G) entries corresponding to all multicast sources.
l If neither a group address nor a source address is specified, this command displays all the (S, G) entries.
l If no AS number is specified, this command displays the (S, G) entries related to all ASs.
Examples
# Display all (S, G) entries in the SA cache.
<Sysname> display msdp sa-cache
MSDP Total Source-Active Cache - 5 entries
(Source, Group) Origin RP Pro AS Uptime Expires
(10.10.1.2, 225.1.1.1) 10.10.10.10 ? ? 00:00:10 00:05:50
(10.10.1.3, 225.1.1.1) 10.10.10.10 ? ? 00:00:11 00:05:49
(10.10.1.2, 225.1.1.2) 10.10.10.10 ? ? 00:00:11 00:05:49
(10.10.2.1, 225.1.1.2) 10.10.10.10 ? ? 00:00:11 00:05:49
(10.10.1.2, 225.1.2.2) 10.10.10.10 ? ? 00:00:11 00:05:49
MSDP matched 5 entries
Table 4-3 display msdp sa-cache command output description
Field |
Description |
MSDP Total Source-Active Cache - 5 entries |
Total number of (S, G) entries in the SA cache |
(Source, Group) |
(S, G) entry: (source address, group address) |
Origin RP |
Address of the RP that generated the (S, G) entry |
Pro |
Type of protocol from which the AS number of the origin RP is originated. “?” indicates that the system was unable to obtain the protocol type |
AS |
AS number of the origin RP. “?” indicates that the system was unable to obtain the AS number |
Uptime |
Length of time for which the cached (S, G) entry has been existing |
Expires |
Length of time in which the cached (S, G) entry will expire |
display msdp sa-count
Syntax
display msdp sa-count [ as-number ]
View
Any view
Parameters
as-number: AS number, in the range of 1 to 65535.
Description
Use the display msdp sa-count command to display the number of (S, G) entries in the SA cache.
The debugging output of this command is available only after the cache-sa-enable command is configured.
Examples
# Display the number of (S, G) entries in the SA cache.
<Sysname> display msdp sa-count
Number of cached Source-Active entries, counted by Peer
Peer's Address Number of SA
10.10.10.10 5
Number of source and group, counted by AS
AS Number of source Number of group
100 3 3
Total Source-Active entries: 5
Table 4-4 display msdp sa-count command output description
Field |
Description |
Number of cached Source-Active entries, counted by Peer |
Number of cached (S, G) entries per peer |
Peer's Address |
Address of the MSDP peer that sends SA messages |
Number of SA |
Number of (S, G) entries from this peer |
Number of source and group, counted by AS |
Number of cached (S, G) entries per AS containing the original RP |
AS |
AS number. “?” indicates that the system was unable to obtain the AS number. |
Number of source |
Number of multicast sources from this AS |
Number of group |
Number of multicast groups from this AS |
import-source
Syntax
import-source [ acl acl-number ]
undo import-source
View
MSDP view
Parameters
acl-number: Basic or advanced IP ACL number, ranging from 2000 to 3999. An ACL controls SA message advertisement by filtering sources (with a basic ACL) and filtering sources or groups (with an advanced ACL). If you do not specify this argument, no multicast source is advertised.
Description
Use the import-source command to specify the (S, G) entries in this domain that need to be advertised when an MSDP peer creates an SA message.
Use the undo import-source command to cancel the configuration.
By default, an SA message advertise any (S, G) entries in the domain.
In addition, you can use the peer sa-policy import command or the peer sa-policy export command to filter forwarded SA messages.
Examples
# Configure the MSDP peer to advertise only the (S, G) entries for multicast sources in the range of 10.10.0.0/16 and multicast groups in the range of 225.1.0.0/16 when creating an SA message.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] acl number 3101
[Sysname-acl-adv-3101] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255
[Sysname-acl-adv-3101] quit
[Sysname] msdp
[Sysname-msdp] import-source acl 3101
msdp
Syntax
msdp
undo msdp
View
System view
Parameters
None
Description
Use the msdp command to enable MSDP and enter MSDP view.
Use the undo msdp command to clear all configurations in MSDP view, release resources occupied by MSDP, and restore the initial state.
Related commands: peer.
Examples
# Enable MSDP and enter MSDP view.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] msdp
# Clear all configurations made in MSDP view.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
msdp-tracert
Syntax
msdp-tracert source-address group-address rp-address [ max-hops max-hops ] [ next-hop-info | sa-info | peer-info ]* [ skip-hops skip-hops ]
View
Parameters
source-address: Specifies a multicast source address for the tracert operation.
group-address: Specifies a multicast group address for the tracert operation.
rp-address: IP address of the origin RP.
max-hops: Maximum number of hops to be traced, ranging from 1 to 255. The default value is 16.
next-hop-info: Collects the next hop information.
sa-info: Collects the SA entity information.
peer-info: Collects the MSDP peer information.
skip-hops: Number of hops to be skipped before the detailed information is collected, in the range of 0 to 255. The system default is 0.
Description
Use the msdp-tracert command to trace the path along which an SA message travels, so as to locate message loss and minimize configuration errors. After determining the path of the SA message, you can prevent SA flooding through correct configuration.
Examples
# Specify the maximum number of hops to be traced and collect the detailed SA and MSDP peer information.
<Sysname> msdp-tracert 10.10.1.1 225.2.2.2 20.20.20.20 max-hops 10 sa-info peer-info
MSDP tracert: press CTRL_C to break
D-bit: set if have this (S,G) in cache but with a different RP
RP-bit: set if this router is an RP
NC-bit: set if this router is not caching SA's
C-bit: set if this (S,G,RP) tuple is in the cache
MSDP trace route path information:
Router Address: 20.20.1.1
Fixed-length response info:
Peer Uptime: 10 minutes, Cache Entry Uptime: 30 minutes
D-bit: 0, RP-bit: 1, NC-bit: 0, C-bit: 1
Return Code: Reached-max-hops
Next Hop info:
Next-Hop Router Address: 0.0.0.0
SA info:
Count of SA messages received for this (S,G,RP): 0
Count of encapsulated data packets received for this (S,G,RP):0
SA cache entry uptime: 00:30:00 , SA cache entry expiry time: 00:03:32
Peering info:
Peering Uptime: 10 minutes, Count of Peering Resets: 3
Table 4-5 msdp-tracert command output description
Field |
Description |
Router Address |
The address used by the local switch to establish a peering session with the Peer-RPF neighbor |
Peer Uptime |
The time of the peering session between the local switch and a Peer-RPF neighbor, in minutes. The maximum value is 255. |
Cache Entry Uptime |
Up time of the (S, G, RP) entry in SA cache of the local switch, in minutes. The maximum value is 255. |
D-bit: 1 |
An (S, G, RP) entry exists in the SA cache of the local switch, but the RP is different from the RP specified in the request message. |
RP-bit: 1 |
The local switch is an RP, but it may be another RP than the source RP in the (S, G, RP) entry. |
NC-bit: 0 |
SA cache is enabled on the local switch. |
C-bit: 1 |
An (S, G, RP) entry exists in SA cache of the local switch. |
Return Code: Reached-max-hops |
Maximum number of hops is reached. Another possible value is: Hit-src-RP: The switch of this hop is the source RP in the (S, G, RP) entry. |
Next-Hop Router Address: 0.0.0.0 |
If you use the next-hop-info keyword, the address of Peer-RPF neighbor is displayed. |
Count of SA messages received for this (S,G,RP) |
The number of SA messages received to trace the (S, G, RP) entry. |
Count of encapsulated data packets received for this (S,G,RP) |
The number of packets received to trace the (S, G, RP) entry. |
SA cache entry uptime |
Length of time for which the cached (S, G) entry has been existing, in hours:minutes:seconds |
SA cache entry expiry time |
Length of time in which the cached (S, G) entry will expire, in hours:minutes:seconds |
Peering Uptime: 10 minutes |
The time of the peering session between the local switch and a Peer-RPF neighbor |
Count of Peering Resets |
Count of session resets |
originating-rp
Syntax
originating-rp interface-type interface-number
undo originating-rp
View
MSDP view
Parameters
interface-type interface-number: Specifies an interface by its type and number.
Description
Use the originating-rp command to configure the address of the specified interface as the RP address in SA messages.
Use the undo originating-rp command to cancel configuration.
By default, the RP address in an SA message is the RP address of the PIM domain.
Examples
# Configure the IP address of VLAN-interface 100 as the RP address in SA messages that will be created by the switch.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] msdp
[Sysname-msdp] originating-rp Vlan-interface 100
peer connect-interface
Syntax
peer peer-address connect-interface interface-type interface-number
undo peer peer-address
View
MSDP view
Parameters
peer-address: Specifies an MSDP peer by its IP address.
interface-type interface-number: Specifies an interface by its type and number. The switch will use the primary address of this interface as the source IP to establish a TCP connection with the remote MSDP peer.
Description
Use the peer connect-interface command to specify an MSDP peer and connect the switch with the MSDP peer through the specified interface.
Use the undo peer connect-interface command to remove an MSDP peering connection.
If an MSDP peer of the switch is a BGP peer to this switch at the same time, the same IP address must be used for both the MSDP peering connection and the BGP peering connection.
Related commands: static-rpf-peer.
Examples
# Configure the switch whose IP address is 125.10 .7.6 as the MSDP peer of the switch and establish a peering connection with the MSDP peer through VLAN-interface 100.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 connect-interface Vlan-interface 100
peer description
peer peer-address description text
undo peer peer-address description
peer-address: Specifies an MSDP peer by its IP address.
text: Descriptive text, case-sensitive. The maximum length is 80 characters.
Use the undo peer description command to remove the configured descriptive text.
By default, no descriptive text is configured for any MSDP peer.
Related commands: display msdp peer-status.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 description router CstmrA
peer mesh-group
Syntax
peer peer-address mesh-group name
undo peer peer-address mesh-group
View
MSDP view
Parameters
peer-address: IP address of the MSDP peer to be added into the mesh group.
name: Name of the mesh group, case-sensitive and containing 1 to 32 characters.
Description
Use the peer mesh-group command to add an MSDP peer to a mesh group.
Use the undo peer mesh-group command to cancel the configuration.
By default, an MSDP peer does not belong to any mesh group.
Examples
# Configure the MSDP peer with the address of 125.10.7.6 as a member of mesh group Grp1.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 mesh-group Grp1
peer minimum-ttl
Syntax
peer peer-address minimum-ttl ttl-value
undo peer peer-address minimum-ttl
View
MSDP view
Parameters
peer-address: IP address of the MSDP peer to which the minimum TTL setting will apply.
ttl-value: Minimum required TTL value, ranging from 0 to 255.
Description
Use the peer minimum-ttl command to configure the minimum required TTL value for a multicast packet encapsulated in an SA message to be forwarded to the specified MSDP peer.
Use the undo peerminimum-ttl command to restore the system default.
By default, the minimum required TTL value is 0.
Related commands: peer.
Examples
# Set the minimum required TTL value of encapsulated multicast packet to 10 so that only those multicast data packets with a TTL value greater than or equal to 10 can be forwarded to the MSDP peer 110.10.10.1.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] msdp
[Sysname-msdp] peer 110.10.10.1 minimum-ttl 10
peer request-sa-enable
Syntax
peer peer-address request-sa-enable
undo peer peer-address request-sa-enable
View
MSDP view
Parameters
peer-address: Specifies an MSDP peer by its IP address.
Description
Use the peer request-sa-enable command to enable the switch to send an SA request message to the specified MSDP peer upon receipt of a Join message.
Use the undo peer request-sa-enable command to remove the configuration.
By default, upon receipt of a Join message, the switch sends no SA request message to the MSDP peer but waits for the next SA message.
Related commands: cache-sa-enable.
Examples
# Configure to send an SA request message to the MSDP peer 125.10.7.6.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 request-sa-enable
peer sa-cache-maximum
Syntax
peer peer-address sa-cache-maximum sa-limit
undo peer peer-address sa-cache-maximum
View
MSDP view
Parameters
peer-address: Specifies an MSDP peer by its IP address.
sa-limit: Maximum number of (S, G) entries that can be cached, ranging from 1 to 2,048.
Description
Use the peer sa-cache-maximum command to configure the maximum number of (S, G) entries learned from the specified MSDP peer that the device can cache.
Use the undo peer sa-cache-maximum command to restore the default configuration.
By default, the device can cache a maximum of 2,048 (S, G) entries learned from an MSDP peer..
You are recommended to perform this configuration on all MSDP peers on a network that is vulnerable to DoS attacks.
Related commands: display msdp sa-count, display msdp peer-status, display msdp brief.
Examples
# Allow the device to cache a maximum of 100 (S, G) entries learned from the MSDP peer with the address of 125.10.7.6.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 sa-cache-maximum 100
peer sa-policy
Syntax
peer peer-address sa-policy { import | export } [ acl acl-number ]
undo peer peer-address sa-policy { import | export }
View
MSDP view
Parameters
peer-address: Specifies an MSDP peer by its IP address.
import: Filters the SA messages from the specified MSDP peer.
export: Filters the SA messages to be forwarded to the specified MSDP peer.
acl acl-number: Specifies an advanced ACL number, ranging from 3000 to 3999. If no ACL is specified, all SA messages carrying (S, G) entries will be filtered out.
Description
Use the peer sa-policy command to configure a filtering rule for receiving or forwarding SA messages.
Use the undo peer sa-policy command to remove the configuration.
By default, no SA message filter is configured; namely, all SA messages are received or forwarded.
Related commands: peer.
Examples
# Configure a filtering rule so that only those SA messages permitted by the ACL 3100 are forwarded to the MSDP peer 125.10.7.6.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] acl number 3100
[Sysname-acl-adv-3100] rule permit ip source 170.15.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255
[Sysname-acl-adv-3100] quit
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 connect-interface Vlan-interface 100
[Sysname-msdp] peer 125.10.7.6 sa-policy export acl 3100
peer sa-request-policy
Syntax
peer peer-address sa-request-policy [ acl acl-number ]
undo peer peer-address sa-request-policy
View
MSDP view
Parameters
peer-address: IP address of an MSDP peer, the SA request messages from which will be filtered
acl-number: Basic ACL number, in the range of 2000 to 2999. If no ACL is specified, all SA request messages will be ignored.
Description
Use the peer sa-request-policy command to filter the SA request messages from the specified MSDP peer.
Use the undo peer sa-request-policy command to restore the default.
By default, the switch accepts all SA request messages from any MSDP peer.
If no ACL is specified, all SA requests will be ignored. If an ACL is specified, only those SA request messages from the multicast groups that match the ACL rule will be processed and others will be ignored.
Related commands: peer.
Examples
# Configure the device to accept SA request messages from MSDP peer 175.58.6.5 for multicast groups in the range of 225.1.1.0/24 and ignore all other SA request messages.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] acl number 2001
[Sysname-acl-basic-2001] rule permit source 225.1.1.0 0.0.0.255
[Sysname-acl-basic-2001] quit
[Sysname] msdp
[Sysname-msdp] peer 175.58.6.5 sa-request-policy acl 2001
reset msdp peer
Syntax
reset msdp peer peer-address
View
User view
Parameters
peer-address: Specifies an MSDP peer by its IP address.
Description
Use the reset msdp peer command to reset the TCP connection with the specified MSDP peer and clear all statistics information about that MSDP peer.
Related commands: reset msdp statistics.
Examples
# Reset the TCP connection with the MSDP peer 125.10.7.6 and clear the statistics about the MSDP peer.
<Sysname> reset msdp peer 125.10.7.6
reset msdp sa-cache
Syntax
reset msdp sa-cache [ group-address ]
View
User view
Parameters
group-address: Multicast group address; the cached (S, G) entries matching this address are to be deleted from the SA cache. If no multicast group address is specified, all cached SA entries will be cleared.
Description
Use the reset msdp sa-cache command to clear (S, G) entries from the SA cache.
Related commands: cache-sa-enable, display msdp sa-cache.
Examples
# Clear the (S, G) entries for multicast group 225.5.4.3 from the SA cache.
<Sysname> reset msdp sa-cache 225.5.4.3
reset msdp statistics
Syntax
reset msdp statistics [ peer-address ]
View
User view
Parameters
peer-address: Address of the MSDP peer whose statistics information will be cleared. If no MSDP peer address is specified, the statistics information of all MSDP peers will be cleared.
Description
Use the reset msdp statistics command to clear the statistics information of one or all MSDP peers without resetting the MSDP peer(s).
Related commands: reset msdp peer.
Examples
# Clear the statistics information about MSDP peer 125.10.7.6.
<Sysname> reset msdp statistics 125.10.7.6
shutdown
Syntax
shutdown peer-address
undo shutdown peer-address
View
Parameters
peer-address: Specifies an MSDP peer by its IP address.
Description
Use the shutdown command to shut down the connection with the specified MSDP peer.
Use the undo shutdown command to reactivate an MSDP peering connection.
By default, the connections with all MSDP peers are active.
Related commands: display msdp peer-status.
Examples
# Shut down the MSDP peer 125.10.7.6.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] msdp
[Sysname-msdp] shutdown 125.10.7.6
static-rpf-peer
Syntax
static-rpf-peer peer-address [ rp-policy ip-prefix-name ]
undo static-rpf-peer peer-address
View
MSDP view
Parameters
peer-address: Address of the static RPF peer to receive SA messages.
rp-policy ip-prefix-name: Specifies a filtering policy based on RP addresses to filter RPs in SA messages, where ip-prefix-name is the IP address prefix list containing 1 to 19 characters.
Description
Use the static-rpf-peer command to configure a static RPF peer.
Use the undo static-rpf-peer command to remove a static RPF peer.
By default, no static RPF peer is configured.
If only one MSDP peer is configured with the peer command, the MSDP peer will be regarded as a static RPF peer. When configuring multiple static RPF peers for the same switch, make sure you follow the following two configuration methods:
l Use the rp-policy keyword for all the MSDP peers. In the case, multiple static RPF peers take effect at the same time. RPs in SA messages are filtered according to the prefix list configured; only SA messages whose RP addresses pass the filtering are received. If multiple static RPF peers using the same rp-policy keyword are configured, when any of the peers receives an SA message, it will forward the SA message to the other peers.
l Use the rp-policy keyword for none of the MSDP peers. In this case, based on the configuration sequence, only the first static RPF peer whose connection state is UP is active. All the SA messages from this peer will be accepted and those from other static RPF peers will be discarded. Once the active static RPF peer fails (because the configuration is removed or the connection is terminated), based on the configuration sequence, the subsequent first static RPF peer whose connection is in the UP state will be selected as the active static RPF peer.
Related commands: peer, ip ip-prefix.
Examples
# Configure a static RPF peer.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] ip ip-prefix list1 permit 130.10.0.0 16 greater-equal 16 less-equal 32
[Sysname] msdp
[Sysname-msdp] peer 130.10.7.6 connect-interface Vlan-interface 100
[Sysname-msdp] static-rpf-peer 130.10.7.6 rp-policy list1
timer retry
Syntax
timer retry seconds
undo timer retry
View
MSDP view
Parameters
seconds: Connection request retry interval in seconds, ranging from 1 to 60.
Description
Use the timer retry command to configure the connection request retry interval.
Use the undo timer retry command to restore the default.
By default, the connection request retry interval is 30 seconds.
Related commands: peer connect-interface.
Examples
# Set the connection request retry interval to 60 seconds.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] msdp
[Sysname-msdp] timer retry 60
IGMP Snooping Configuration Commands
display igmp-snooping configuration
Syntax
display igmp-snooping configuration
View
Any view
Parameters
None
Description
Use the display igmp-snooping configuration command to display IGMP Snooping configuration information.
If IGMP Snooping is disabled on this switch, this command displays a message showing that IGMP Snooping is not enabled.
With IGMP Snooping enabled, this command displays the following information:
l IGMP Snooping status
l aging time of the router port
l maximum response time in IGMP queries
l aging time of multicast member ports
l non-flooding feature status
Related commands: igmp-snooping, igmp-snooping router-aging-time, igmp-snooping max-response-time, igmp-snooping host-aging-time, igmp-snooping nonflooding-enable.
Examples
# Display IGMP Snooping configuration information on the switch.
<Sysname> display igmp-snooping configuration
Enable IGMP-Snooping.
The router port timeout is 105 second(s).
The max response timeout is 10 second(s).
The host port timeout is 260 second(s).
Enable IGMP-Snooping Non-Flooding.
The above-mentioned information shows: IGMP Snooping is enabled, the aging time of the router port is 105 seconds, the maximum response time in IGMP queries is 10 seconds, the aging time of multicast member ports is 260 seconds, and the IGMP Snooping non-flooding feature is enabled.
display igmp-snooping group
Syntax
display igmp-snooping group [ vlan vlan-id ]
View
Any view
Parameters
vlan vlan-id: Specifies the VLAN in which the multicast group information is to be displayed, where vlan-id ranges from 1 to 4094.. If you do not specify a VLAN, this command displays the multicast group information of all VLANs.
Description
Use the display igmp-snooping group command to display the IGMP Snooping multicast group information.
Related commands: igmp-snooping, igmp host-join, multicast static-group vlan, multicast static-group interface, multicast static-group vlan, multicast static-router-port, multicast static-router-port vlan
Examples
# Display the information about the multicast groups in VLAN 100.
<Sysname> display igmp-snooping group vlan 100
Total 1 IP Group(s).
Total 1 MAC Group(s).
Vlan(id):100.
Total 1 IP Group(s).
Total 1 MAC Group(s).
Static Router port(s):
Ethernet1/0/11
Dynamic Router port(s):
Ethernet1/0/22
IP group(s):the following ip group(s) match to one mac group.
IP group address:228.0.0.1
Static host port(s):
Ethernet1/0/23
Dynamic host port(s):
Ethernet1/0/10
MAC group(s):
MAC group address:0100-5e00-0001
Host port(s):Ethernet1/0/10 Ethernet1/0/23
Table 5-1 display igmp-snooping group command output description
Field |
Description |
Total 1 IP Group(s). |
Total number of IP multicast groups in all VLANs |
Total 1 MAC Group(s). |
Total number of MAC multicast groups in all VLANs |
Vlan(id): |
ID of the VLAN whose multicast group information is displayed |
Total 1 IP Group(s). |
Total number of IP multicast groups in VLAN 100 |
Total 1 MAC Group(s). |
Total number of MAC multicast groups in VLAN 100 |
Static Router port(s): |
Static router port |
Dynamic Router port(s): |
Dynamic router port |
Static host port(s): |
Static member port |
Dynamic host port(s): |
Dynamic member port |
IP group address: |
IP address of a multicast group |
MAC group(s): |
MAC multicast group |
MAC group address: |
Address of a MAC multicast group |
Host port(s) |
Member ports |
display igmp-snooping statistics
Syntax
display igmp-snooping statistics
View
Any view
Parameters
None
Description
Use the display igmp-snooping statistics command to display IGMP Snooping statistics.
This command displays the following information: the numbers of the IGMP general query messages, IGMP group-specific query messages, IGMPv1 report messages, IGMPv2 report messages, IGMP leave messages and error IGMP packets received, and the number of the IGMP group-specific query messages sent.
When IGMPv3 Snooping is enabled, the device makes statistics of IGMPv3 messages as IGMPv2 messages.
Related commands: igmp-snooping.
Examples
# Display IGMP Snooping statistics.
<Sysname> display igmp-snooping statistics
Received IGMP general query packet(s) number:1.
Received IGMP specific query packet(s) number:0.
Received IGMP V1 report packet(s) number:0.
Received IGMP V2 report packet(s) number:3.
Received IGMP leave packet(s) number:0.
Received error IGMP packet(s) number:0.
Sent IGMP specific query packet(s) number:0.
The information above shows that IGMP receives:
l one IGMP general query messages
l zero IGMP specific query messages
l zero IGMPv1 report messages
l three IGMPv2 report messages
l zero IGMP leave messages
l zero IGMP error packets
IGMP Snooping sends:
l zero IGMP specific query messages
igmp-snooping
Syntax
igmp-snooping { enable | disable }
View
System view, VLAN view
Parameters
enable: Enables the IGMP Snooping feature.
disable: Disables the IGMP Snooping feature.
Description
Use the igmp-snooping enable command to enable the IGMP Snooping feature.
Use the igmp-snooping disable command to disable the IGMP Snooping feature.
By default, the IGMP Snooping feature is disabled.
l Although both Layer 2 and Layer 3 multicast protocols can run on the same switch simultaneously, they cannot run simultaneously in the same VLAN and on the corresponding VLAN interface.
l Before enabling IGMP Snooping in a VLAN, be sure to enable IGMP Snooping globally in system view; otherwise the IGMP Snooping setting will not take effect.
l If IGMP Snooping and VLAN VPN are enabled on a VLAN at the same time, IGMP queries are likely to fail to pass the VLAN. You can solve this problem by configuring VLAN tags for the IGMP queries. For details, see igmp-snooping vlan-mapping.
Examples
# Enable the IGMP Snooping feature on the switch.
<Sysname>system-view
System View: return to User View with Ctrl+Z.
[Sysname] igmp-snooping enable
Enable IGMP-Snooping ok.
igmp-snooping fast-leave
Syntax
igmp-snooping fast-leave [ vlan vlan-list ]
undo igmp-snooping fast-leave [ vlan vlan-list ]
View
System view, Ethernet port view
Parameters
vlan vlan-list: Specifies a VLAN list. With the vlan-list argument, you can provide one or more individual VLAN IDs (in the form of vlan-id) and/or one or more VLAN ID ranges (in the form of vlan-id1 to vlan-id2, where vlan-id2 must be greater than vlan-id1). The effective range for a VLAN ID is 1 to 4094 and the total number of individual VLANs plus VLAN ranges cannot exceed 10.
Description
Use the igmp-snooping fast-leave command to enable IGMP fast leave processing.
Use the undo igmp-snooping fast-leave command to disable IGMP fast leave processing.
By default, IGMP fast leave processing is disabled.
l The fast leave processing function works for a port only if the host attached to the port runs IGMPv2 or IGMPv3.
l The configuration performed in system view takes effect on all ports of the switch if no VLAN is specified; if one or more VLANs are specified, the configuration takes effect on all ports in the specified VLAN(s).
l The configuration performed in Ethernet port view takes effect on the port no matter which VLAN it belongs to if no VLAN is specified; if one or more VLANs are specified, the configuration takes effect on the port only if the port belongs to the specified VLAN(s).
l If fast leave processing and unknown multicast packet dropping or non-flooding are enabled on a port to which more than one host is connected, when one host leaves a multicast group, the other hosts connected to port and interested in the same multicast group will fail to receive multicast data for that group.
Examples
# Enable IGMP fast leave processing on Ethernet 1/0/1 in VLAN 2.
<Sysname>system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Ethernet 1/0/1
[Sysname-Ethernet1/0/1] igmp-snooping fast-leave vlan 2
igmp-snooping general-query source-ip
Syntax
igmp-snooping general-query source-ip { current-interface | ip-address }
undo igmp-snooping general-query source-ip
View
VLAN view
Parameters
current-interface: Specifies the IP address of the current VLAN interface as the source address of IGMP general queries. If the current VLAN interface does not have an IP address, the default IP address 0.0.0.0 will be used as the source IP address of IGMP general queries.
ip-address: Specifies the source address of IGMP general queries, which can be any legal IP address.
Description
Use the igmp-snooping general-query source-ip command to configure the source address of IGMP general queries.
Use the undo igmp-snooping general-query source-ip command to restore the default.
This command can take effect only if the IGMP Snooping querier function is enabled on the switch.
By default, the Layer 2 multicast switch sends general query messages with the source IP address of 0.0.0.0.
Related commands: igmp-snooping querier, igmp-snooping query-interval.
Examples
# Configure the switch to send general query messages with the source IP address 2.2.2.2 in VLAN 3.
<Sysname> system-view
System view, return to user view with Ctrl+Z.
[Sysname] igmp-snooping enable
[Sysname] vlan 3
[Sysname-vlan3] igmp-snooping enable
[Sysname-vlan3] igmp-snooping querier
[Sysname-vlan3] igmp-snooping general-query source-ip 2.2.2.2
igmp-snooping group-limit
Syntax
igmp-snooping group-limit limit [ vlan vlan-list ] [ overflow-replace ]
undo igmp-snooping group-limit [ vlan vlan-list ]
View
Ethernet port view
Parameters
limit: Maximum number of multicast groups the port can join, in the range of 1 to 256.
overflow-replace: Allows a new multicast group to replace an existing multicast group with the lowest IP address.
vlan vlan-list: Specifies a VLAN list. With the vlan-list argument, you can provide one or more individual VLAN IDs (in the form of vlan-id) and/or one or more VLAN ID ranges (in the form of vlan-id1 to vlan-id2, where vlan-id2 must be greater than vlan-id1). The effective range for a VLAN ID is 1 to 4094 and the total number of individual VLANs plus VLAN ranges cannot exceed 10.
Description
Use the igmp-snooping group-limit command to define the maximum number of multicast groups the port can join.
Use the undo igmp-snooping group-limit command to restore the default setting.
If you do not specify any VLAN, the command will take effect for all the VLANs to which the current port belongs; if you specify a VLAN or multiple VLANs, the command will take effect for the port only if the port belongs to the specified VLAN(s). It is recommended to specify a VLAN or multiple VLANs to save memory.
By default, the maximum number of multicast groups the port can join is 256.
l To prevent bursting traffic in the network or performance deterioration of the device caused by excessive multicast groups, you can set the maximum number of multicast groups that the switch should process.
l When the number of multicast groups exceeds the configured limit, the switch removes its multicast forwarding entries starting from the oldest one. In this case, the multicast packets for the removed multicast group(s) will be flooded in the VLAN as unknown multicast packets. As a result, non-member ports can receive multicast packets within a period of time.
l To avoid this from happening, enable the function of dropping unknown multicast packets.
l The keyword overflow-replace does not apply to IGMPv3 Snooping, that is, with IGMPv3 Snooping enabled, even if the keyword overflow-replace is configured, a new multicast group will not replace an existing multicast group when the number of multicast groups reaches the maximum value.
Examples
# Configure to allow Ethernet 1/0/1 in VLAN 2 to join a maximum of 200 multicast groups.
<Sysname>system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Ethernet 1/0/1
[Sysname-Ethernet1/0/1] igmp-snooping group-limit 200 vlan 2
igmp-snooping group-policy
Syntax
igmp-snooping group-policy acl-number [ vlan vlan-list ]
undo igmp-snooping group-policy [ vlan vlan-list ]
View
System view, Ethernet port view
Parameters
acl-number: Basic ACL number, in the range of 2000 to 2999.
vlan vlan-list: Specifies a VLAN list. With the vlan-list argument, you can provide one or more individual VLAN IDs (in the form of vlan-id) and/or one or more VLAN ID ranges (in the form of vlan-id1 to vlan-id2, where vlan-id2 must be greater than vlan-id1). The effective range for a VLAN ID is 1 to 4094 and the total number of individual VLANs plus VLAN ranges cannot exceed 10.
Description
Use the igmp-snooping group-policy command to configure a multicast group filter.
Use the undo igmp-snooping group-policy command to remove the configured multicast group filter.
By default, no multicast group filter is configured.
The ACL rule defines a multicast address or a multicast address range (for example 224.0.0.1 to 239.255.255.255) and is used to:
l Allow the port(s) to join only the multicast group(s) defined in the rule by a permit statement.
l Inhibit the port(s) from joining the multicast group(s) defined in the rule by a deny statement.
l A port can belong to multiple VLANs, you can configure only one ACL rule per VLAN on a port.
l If no ACL rule is configured, all the multicast groups will be filtered.
l Since most devices broadcast unknown multicast packets by default, this function is often used together with the function of dropping unknown multicast packets to prevent multicast streams from being broadcast as unknown multicast packets to a port blocked by this function.
l The configuration performed in system view takes effect on all ports of the switch if no VLAN is specified; if one or more VLANs are specified, the configuration takes effect on all ports in the specified VLAN(s).
l The configuration performed in Ethernet port view takes effect on the port no matter which VLAN it belongs to if no VLAN is specified; if one or more VLANs are specified, the configuration takes effect on the port only if the port belongs to the specified VLAN(s).
Examples
# Configure a multicast group filter to allow receivers attached to Ethernet 1/0/1 to access the multicast streams for groups 225.0.0.0 to 225.255.255.255.
l Configure ACL 2000.
<Sysname>system-view
System View: return to User View with Ctrl+Z.
[Sysname] acl number 2000
[Sysname-acl-basic-2000] rule permit source 225.0.0.0 0.255.255.255
[Sysname-acl-basic-2000] quit
l Create VLAN 2 and add Ethernet1/0/1 to VLAN 2.
[Sysname] vlan 2
[Sysname-vlan2] port Ethernet 1/0/1
[Sysname-vlan2] quit
l Apply ACL 2000 on Ethernet1/0/1 to allow it to join only the IGMP multicast groups defined in the rule of ACL 2000.
[Sysname] interface Ethernet 1/0/1
[Sysname-Ethernet1/0/1] igmp-snooping group-policy 2000 vlan 2
[Sysname-Ethernet1/0/1] quit
# Configure a multicast group filter to allow receivers attached to Ethernet 1/0/2 to access the multicast streams for any groups except groups 225.0.0.0 to 225.0.0.255.
l Configure ACL 2001.
[Sysname] acl number 2001
[Sysname-acl-basic-2001] rule deny source 225.0.0.0 0.0.0.255
[Sysname-acl-basic-2001] rule permit source any
[Sysname-acl-basic-2001] quit
l Create VLAN 2 and add Ethernet1/0/2 to VLAN 2.
[Sysname] vlan 2
[Sysname-vlan2] port Ethernet 1/0/2
[Sysname-vlan2] quit
l Configure ACL 2001 on Ethernet1/0/2 to it to join any IGMP multicast groups except those defined in the deny rule of ACL 2001.
[Sysname] interface Ethernet 1/0/2
[Sysname-Ethernet1/0/2] igmp-snooping group-policy 2001 vlan 2
igmp-snooping host-aging-time
Syntax
igmp-snooping host-aging-time seconds
undo igmp-snooping host-aging-time
View
System view
Parameters
seconds: Aging time (in seconds) of multicast member ports, in the range of 200 to 1,000.
Description
Use the igmp-snooping host-aging-time command to configure the aging time of multicast member ports.
Use the undo igmp-snooping host-aging-time command to restore the default aging time.
By default, the aging time of multicast member ports is 260 seconds.
The aging time of multicast member ports determines the refresh frequency of multicast group members. In an environment where multicast group members change frequently, a relatively shorter aging time is required.
Related commands: display igmp-snooping configuration.
Examples
# Set the aging time of multicast member ports to 300 seconds.
<Sysname>system-view
System View: return to User View with Ctrl+Z.
[Sysname] igmp-snooping host-aging-time 300
igmp-snooping max-response-time
Syntax
igmp-snooping max-response-time seconds
undo igmp-snooping max-response-time
View
System view
Parameters
seconds: Maximum response time in IGMP general queries, in the range of 1 to 25.
Description
Use the igmp-snooping max-response-time command to configure the maximum response time in IGMP general queries.
Use the undo igmp-snooping max-response-time command to restore the default.
By default, the maximum response time in IGMP general queries is 10 seconds.
An appropriate setting of the maximum response time in IGMP queries allows hosts to respond to queries quickly and thus the querier can learn the existence of multicast members quickly.
Related commands: display igmp-snooping configuration.
Examples
# Set the maximum response time in IGMP queries to 15 seconds.
<Sysname>system-view
System View: return to User View with Ctrl+Z.
[Sysname] igmp-snooping max-response-time 15
igmp-snooping nonflooding-enable
Syntax
igmp-snooping nonflooding-enable
undo igmp-snooping nonflooding-enable
View
System view
Parameters
None
Description
Use the igmp-snooping nonflooding-enable command to enable the IGMP Snooping non-flooding function. With this function enabled, unknown multicast packets are passed to the router ports of the switch rather than being flooded in the VLAN.
Use the undo igmp-snooping nonflooding-enable command to disable the IGMP Snooping non-flooding function.
By default, the IGMP Snooping non-flooding function is disabled, namely unknown multicast packets are flooded in the VLAN.
The difference between the IGMP Snooping non-flooding function and the function of dropping unknown multicast packets is in that the former passes unknown multicast packets to the router ports while the latter directly discards unknown multicast packets.
You can configure this command only after IGMP Snooping is enabled globally. When IGMP Snooping is disabled globally, the configuration of the igmp-snooping nonflooding-enable command is also removed.
l If the function of dropping unknown multicast packets or the IRF fabric function is enabled, you cannot enable the IGMP Snooping non-flooding function.
l The IGMP Snooping non-flooding function and the multicast source port suppression function cannot take effect at the same time. If both are configured, only the multicast source port suppression function takes effect.
Related commands: unknown-multicast drop enable, multicast-source-deny, display multicast-source-deny
Examples
# Enable IGMP Snooping non-flooding after you enable IGMP Snooping globally and disable both port stacking and unknown-multicast dropping.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] igmp-snooping enable
[Sysname] igmp-snooping nonflooding-enable
igmp-snooping querier
Syntax
igmp-snooping querier
undo igmp-snooping querier
View
VLAN view
Parameters
None
Description
Use the igmp-snooping querier command to enable the IGMP Snooping querier feature on the current VLAN.
Use the undo igmp-snooping querier command to restore the default.
By default, the IGMP Snooping querier feature is disabled.
This command takes effect only if IGMP Snooping is enabled globally and also enabled in the current VLAN.
Related commands: igmp-snooping enable, igmp-snooping query-interval, igmp-snooping general-query source-ip
Examples
# Enable the IGMP Snooping querier in VLAN 3.
<Sysname> system-view
System view, return to user view with Ctrl+Z.
[Sysname] igmp-snooping enable
[Sysname] vlan 3
[Sysname-vlan3] igmp-snooping enable
[Sysname-vlan3] igmp-snooping querier
igmp-snooping query-interval
Syntax
igmp-snooping query-interval seconds
undo igmp-snooping query-interval
View
VLAN view
Parameters
seconds: IGMP query interval, ranging from 1 to 300, in seconds.
Description
Use the igmp-snooping query-interval command to configure the IGMP query interval, namely the interval at which the switch sends IGMP general queries.
Use the undo igmp-snooping query-interval command to restore the default.
By default, the IGMP query interval is 60 seconds.
These commands are effective only after the IGMP Snooping querier feature is enabled. Otherwise, the switch will not send general queries. The configured query interval must be longer than the maximum response time in general queries.
Related commands: igmp-snooping enable, igmp-snooping querier, igmp-snooping max-response-time, igmp-snooping general-query source-ip
Examples
# Configure the IGMP query interval to 100 seconds in VLAN 3.
<Sysname> system-view
System view, return to user view with Ctrl+Z.
[Sysname] igmp-snooping enable
[Sysname] vlan 3
[Sysname-vlan3] igmp-snooping enable
[Sysname-vlan3] igmp-snooping querier
[Sysname-vlan3] igmp-snooping query-interval 100
igmp-snooping router-aging-time
Syntax
igmp-snooping router-aging-time seconds
undo igmp-snooping router-aging-time
View
System view
Parameters
seconds: Aging time of router ports, in the range of 1 to 1,000, in seconds.
Description
Use the igmp-snooping router-aging-time command to configure the aging time of router ports.
Use the undo igmp-snooping router-aging-time command to restore the default aging time.
By default, the aging time of router ports is 105 seconds.
The aging time of router ports should be about 2.5 times the IGMP query interval.
Related commands: igmp-snooping max-response-time, igmp-snooping.
Examples
# Set the aging time of the router port to 500 seconds.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] igmp-snooping router-aging-time 500
igmp-snooping version
igmp-snooping version version-number
undo igmp-snooping version
View
VLAN view
Parameters
version-number: IGMP Snooping version, in the range of 2 to 3 and defaulting to 2.
Description
Use the igmp-snooping version command to configure the IGMP Snooping version in the current VLAN.
Use the undo igmp-snooping version command to restore the default IGMP Snooping version.
This command can take effect only if IGMP Snooping is enabled in the VLAN.
Related commands: igmp-snooping enable.
Examples
# Set IGMP Snooping version to version 3 in VLAN 100.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] igmp-snooping enable
Enable IGMP-Snooping ok.
[Sysname] vlan 100
[Sysname -vlan100] igmp-snooping enable
[Sysname -vlan100] igmp-snooping version 3
igmp-snooping vlan-mapping
Syntax
igmp-snooping vlan-mapping vlan vlan-id
undo igmp-snooping vlan-mapping
View
System view
Parameters
vlan vlan-id: VLAN ID, in the range of 1 to 4094.
Description
Use the igmp-snooping vlan-mapping vlan command to configure to transmit IGMP general and group-specific query messages in a specific VLAN.
Use the undo igmp-snooping vlan-mapping command to restore the default.
By default, the VLAN tag carried in IGMP general and group-specific query messages is not changed.
Examples
# Configure IGMP general and group-specific query messages to be transmitted in VLAN 2.
<Sysname>system-view
System View: return to User View with Ctrl+Z.
[Sysname] igmp-snooping enable
[Sysname] igmp-snooping vlan-mapping vlan 2
igmp host-join port
igmp host-join group-address [ source-ip source-address ] port interface-list
undo igmp host-join group-address [ source-ip source-address ] port interface-list
View
VLAN interface view
Parameters
group-address: Address of the multicast group to join.
source-address: Address of the multicast source to join. You can specify a multicast source address only when IGMPv3 Snooping is running in the VLAN.
port interface-list: Configures the specified port or ports under the current VLAN interface as simulated member host(s) for the specified multicast group. With the interface-list argument, you can define one or more individual ports (in the form of interface-type interface-number) and/or one or more port ranges (in the form of interface-type interface-number1 to interface-type interface-number2, where interface-number2 must be greater than interface-number1). The total number of individual ports plus port ranges cannot exceed 10. For port types and port numbers, refer to the parameter description in the “Port Basic Configuration” part in this manual.
Description
Use the igmp host-join port command to configure one or more ports under the current VLAN interface as simulated member hosts to join the specified multicast group or source and group.
Use the undo igmp host-join port command to remove the specified port(s) as simulated member hosts for the specified multicast group or source and group.
By default, simulated joining is disabled.
Unlike a static member port, a port configured as a simulated member host will age out like a dynamic member port.
Related commands: igmp-snooping enable, multicast static-group interface, multicast static-group vlan
Before configuring simulated joining, enable IGMP Snooping in the VLAN corresponding to the current VLAN interface.
Examples
# Configure Ethernet 1/0/1 under VLAN-interface 10 as a simulated host member host to join multicast group 225.0.0.1.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] igmp-snooping enable
Enable IGMP-Snooping ok.
[Sysname] vlan 10
[Sysname-vlan10] igmp-snooping enable
[Sysname-vlan10] quit
[Sysname] interface Vlan-interface 10
[Sysname-Vlan-interface10] igmp host-join 225.0.0.1 port Ethernet 1/0/1
igmp host-join
igmp host-join group-address [source-ip source-address] vlan vlan-id
undo igmp host-join group-address [source-ip source-address] vlan vlan-id
View
Ethernet port view
Parameters
group-address: Address of the multicast group to join.
source-address: Address of the multicast source to join. You can specify a multicast source address only when IGMPv3 Snooping is running in a VLAN.
vlan vlan-id: ID of the VLAN to which the port belongs, in the range of 1 to 4094.
Description
Use the igmp host-join command to configure the current port as a simulated multicast group member host to join the specified multicast group or source and group.
Use the undo igmp host-join command to remove the current port as a simulated member host for the specified multicast group or source-group.
Unlike a static member port, a port configured as a simulated member host will age out like a dynamic member port.
Related commands: igmp-snooping enable, multicast static-group interface, multicast static-group vlan
l Before configuring a port as a simulated host, enable IGMP Snooping in VLAN view first.
l The current port must belong to the specified VLAN; otherwise this configuration does not take effect.
Examples
# Configure Ethernet 1/0/1 in VLAN 1 as a simulated member host for multicast source 1.1.1.1 and multicast group 225.0.0.1.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname]igmp-snooping enable
Enable IGMP-Snooping ok.
[Sysname]vlan 1
[Sysname-vlan1]igmp-snooping enable
[Sysname-vlan1]igmp-snooping version 3
[Sysname-vlan1]quit
[Sysname] interface Ethernet 1/0/1
[Sysname-Ethernet 1/0/1] igmp host-join 225.0.0.1 source-ip 1.1.1.1 vlan 10
multicast static-group interface
Syntax
multicast static-group group-address interface interface-list
undo multicast static-group group-address interface interface-list
View
VLAN interface view
Parameters
group-address: IP address of the multicast group to join, in the range of 224.0.0.0 to 239.255.255.255.
interface interface-list: Specifies a port list. With the interface-list argument, you can define one or more individual ports (in the form of interface-type interface-number) and/or one or more port ranges (in the form of interface-type interface-number1 to interface-type interface-number2, where interface-number2 must be greater than interface-number1). The total number of individual ports plus port ranges cannot exceed 10. For port types and port numbers, refer to the parameter description in the “Port Basic Configuration” part in this manual.
Description
Use the multicast static-group interface command to configure the specified port(s) under the current VLAN interface as static member port(s) for the specified multicast group.
Use the undo multicast static-group interface command to remove the specified port(s) in the current VLAN as static member port(s) for the specified multicast group.
By default, no port is configured as a static multicast group member port.
The ports configured with this command handle Layer 2 multicast traffic only, rather than Layer 3 multicast traffic.
Examples
# Configure ports Ethernet 1/0/1 to Ethernet 1/0/3 under VLAN-interface 1 as static members ports for multicast group 225.0.0.1.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Vlan-interface 1
[Sysname-Vlan-interface1] multicast static-group 225.0.0.1 interface Ethernet 1/0/1 to Ethernet 1/0/3
multicast static-group vlan
Syntax
multicast static-group group-address vlan vlan-id
undo multicast static-group group-address vlan vlan-id
View
Ethernet port view
Parameters
group-address: IP address of the multicast group to join, in the range of 224.0.0.0 to 239.255.255.255.
vlan vlan-id: Specifies the VLAN the Ethernet port belongs to, where vlan-id ranges from 1 to 4094.
Description
Use the multicast static-group vlan command to configure the current port in the specified VLAN as a static member port for the specified multicast group.
Use the undo multicast static-group vlan command to remove the current port in the specified VLAN as a static member port for the specified multicast group.
By default, no port is configured as a static multicast group member port.
The port configured with this command handles Layer 2 multicast traffic only, rather than Layer 3 multicast traffic.
Examples
# Configure port Ethernet1/0/1 in VLAN 2 as a static member port for multicast group 225.0.0.1.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname]interface Ethernet 1/0/1
[Sysname-Ethernet1/0/1] multicast static-group 225.0.0.1 vlan 2
multicast static-router-port
Syntax
multicast static-router-port interface-type interface-number
undo multicast static-router-port interface-type interface-number
View
VLAN view
Parameters
interface-type interface-number: Specifies a port by its type and number.
Description
Use the multicast static-router-port command to configure the specified port in the current VLAN as a static router port.
Use the undo multicast static-router-port command to remove the specified port in the current VLAN as a static router port.
By default, a port is not a static router port.
Examples
# Configure Ethernet 1/0/1 in VLAN 10 as a static router port.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] vlan 10
[Sysname-vlan10] multicast static-router-port Ethernet1/0/1
multicast static-router-port vlan
Syntax
multicast static-router-port vlan vlan-id
undo multicast static-router-port vlan vlan-id
View
Ethernet port view
Parameters
vlan-id: VLAN ID the port belongs to, in the range of 1 to 4094.
Description
Use the multicast static-router-port vlan command to configure the current port in the specified VLAN as a static router port.
Use the undo multicast static-router-port vlan command to remove the current port in the specified VLAN as a static router port.
By default, the static router port function is disabled.
Examples
# Configure Ethernet 1/0/1 in VLAN 10 as a static router port.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] interface Ethernet 1/0/1
[Sysname-Ethernet 1/0/1] multicast static-router-port vlan 10
reset igmp-snooping statistics
Syntax
reset igmp-snooping statistics
View
User view
Parameters
None
Description
Use the reset igmp-snooping statistics command to clear IGMP Snooping statistics.
Related commands: display igmp-snooping statistics.
Examples
# Clear IGMP Snooping statistics.
<Sysname> reset igmp-snooping statistics
service-type multicast
Syntax
service-type multicast
undo service-type multicast
View
VLAN view
Parameters
None
Description
Use the service-type multicast command to configure the current VLAN as a multicast VLAN.
Use the undo service-type multicast command to remove the current VLAN as a multicast VLAN.
By default, no VLAN is a multicast VLAN.
In an IGMP Snooping environment, by configuring a multicast VLAN and adding ports to the multicast VLAN, you can allow users in different VLANs to share the same multicast VLAN. This saves bandwidth because multicast streams are transmitted only within the multicast VLAN. In addition, because the multicast VLAN is isolated from user VLANs, this method also enhances the information security.
l One port belongs to only one multicast VLAN.
l The port connected to a user terminal must be a hybrid port.
l The multicast member port must be in the same multicast VLAN with the router port. Otherwise, the port cannot receive multicast packets.
l If a router port is in a multicast VLAN, the router port must be configured as a trunk port or a hybrid port that allows tagged packets to pass for the multicast VLAN. Otherwise, all the multicast member ports in this multicast VLAN cannot receive multicast packets.
l If a multicast member port needs to receive multicast packets forwarded by a router port that does not belong to any multicast VLAN, the multicast member port must be removed from the multicast VLAN. Otherwise, the port cannot receive multicast packets.
Examples
# Configure VLAN 2 as a multicast VLAN.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname] vlan 2
[Sysname-vlan2] service-type multicast