Chapter 1 Common
Multicast Configuration Commands
The following are new features in this set
of manuals:
1.1 Common Multicast Configuration Commands
Syntax
display mac-address
multicast static [ [mac-address ] vlan vlan-id
] [ count ] [ unit unit-id ]
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.
unit unit-id: Displays information about the multicast MAC address of the
specified unit in the fabric.
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 GigabitEthernet1/0/1 NOAGED
GigabitEthernet1/0/2
GigabitEthernet1/0/3
GigabitEthernet1/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.
|
1.1.2 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
GigabitEthernet1/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
GigabitEthernet1/0/19
|
The first outgoing VLAN-interface is VLAN-interface
32, with one outgoing port under it, GigabitEthernet 1/0/19
|
|
Total 1 entry(entries) Listed
|
The multicast forward table contains one
(S,G) entry.
|
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):
GigabitEthernet1/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):
GigabitEthernet1/0/22
MAC group(s):
MAC group address:0100-5c01-0101
Host port(s):GigabitEthernet1/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
|
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.
|
1.1.5 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.
|
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 GigabitEthernet 1/0/1.
<Sysname> display
multicast-source-deny interface GigabitEthernet 1/0/1
GigabitEthernet1/0/1
Multicast-source-deny disabled.
The information above shows that multicast
source port suppression is disabled on GigabitEthernet 1/0/1.
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-5c0a-0805 and a forwarding port of GigabitEthernet
1/0/1 in VLAN 1.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] mac-address multicast 0100-5c0a-0805
interface GigabitEthernet 1/0/1 vlan 1
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 GigabitEthernet
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 GigabitEthernet1/0/1
[Sysname-GigabitEthernet1/0/1] mac-address
multicast 0100-1000-1000 vlan 1
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
