- Table of Contents
-
- 07 IP Multicast Command Reference
- 00-Preface
- 01-IGMP snooping commands
- 02-PIM snooping commands
- 03-Multicast VLAN commands
- 04-Multicast routing and forwarding commands
- 05-IGMP commands
- 06-PIM commands
- 07-MSDP commands
- 08-Multicast VPN commands
- 09-MLD snooping commands
- 10-IPv6 PIM snooping commands
- 11-IPv6 multicast VLAN commands
- 12-IPv6 multicast routing and forwarding commands
- 13-MLD commands
- 14-IPv6 PIM commands
- Related Documents
-
Title | Size | Download |
---|---|---|
02-PIM snooping commands | 64.72 KB |
display pim-snooping router-port
display pim-snooping routing-table
display pim-snooping statistics
pim-snooping graceful-restart join-aging-time
pim-snooping graceful-restart neighbor-aging-time
PIM snooping commands
display pim-snooping neighbor
Use display pim-snooping neighbor to display PIM snooping neighbor information.
Syntax
In standalone mode:
display pim-snooping neighbor [ vlan vlan-id | vsi vsi-name ] [ slot slot-number ] [ verbose ]
In IRF mode:
display pim-snooping neighbor [ vlan vlan-id | vsi vsi-name ] [ chassis chassis-number slot slot-number ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays PIM snooping neighbor information for all VLANs.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays PIM snooping neighbor information for all VSIs.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays PIM snooping neighbor information for the MPU. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays PIM snooping neighbor information for the global active MPU. (In IRF mode.)
verbose: Displays detailed information about PIM snooping neighbors. If you do not specify this keyword, the command displays brief information about PIM snooping neighbors.
Examples
# Display detailed information about PIM snooping neighbors for VLAN 2.
<Sysname> display pim-snooping neighbor vlan 2 verbose
Total 2 neighbors.
VLAN 2: Total 2 neighbors.
10.1.1.2
Slots (0 in total):
Ports (1 in total):
XGE1/0/1 (02:02:23) LAN Prune Delay(T)
10.1.1.3
Slots (0 in total):
Ports (1 in total):
XGE1/0/2 (02:02:25)
# Display brief information about PIM snooping neighbors for VSI bbb.
<Sysname> display pim-snooping neighbor vsi bbb
Total 2 neighbors.
VSI bbb: Total 2 neighbors.
10.0.0.1
Ports (1 in total):
XGE1/0/3 (Link ID 0) (00:01:32)
10.0.0.6
Ports (1 in total):
Tun0 (VXLAN ID 0) (00:01:32)
Table 1 Command output
Field |
Description |
Total 2 neighbors |
Total number of PIM snooping neighbors. |
VLAN 2: Total 2 neighbors |
Total number of PIM snooping neighbors in VLAN 2. |
VSI aaa: Total 2 neighbors |
Total number of PIM snooping neighbors in VSI aaa. |
10.1.1.2 |
IP address of the PIM snooping neighbor. |
(In standalone mode.) Slot numbers and total number of the cards that have the neighbor, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have the neighbor, except for the specified card or the global active MPU when no card is specified. |
|
Ports (1 in total) |
Ports where the PIM snooping neighbors reside, and the total number of the ports. |
(02:02:23) |
Remaining aging timer for a PIM snooping neighbor on the port. This field is always displayed for global ports (such as Layer 2 aggregate interfaces and ACs). (In standalone mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. (In IRF mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card is specified. |
LAN Prune Delay |
The PIM hello message sent by the PIM snooping neighbor has the LAN_Prune_Delay option. |
(T) |
The join message suppression feature has been disabled for the PIM snooping neighbor. |
XGE1/0/3 (Link ID 0) |
AC and its link ID. |
Tun0 (VXLAN ID 0) |
VXLAN tunnel and its VXLAN ID. |
display pim-snooping router-port
Use display pim-snooping router-port to display PIM snooping router port information.
Syntax
In standalone mode:
display pim-snooping router-port [ vlan vlan-id | vsi vsi-name ] [ slot slot-number ] [ verbose ]
In IRF mode:
display pim-snooping router-port [ vlan vlan-id | vsi vsi-name ] [ chassis chassis-number slot slot-number ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays PIM snooping router port information for all VLANs.
verbose: Displays detailed information about PIM snooping router ports. If you do not specify this keyword, the command displays brief information about PIM snooping router ports.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays PIM snooping router port information for all VSIs.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays PIM snooping router port information for the MPU. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays PIM snooping router port information for the global active MPU. (In IRF mode.)
Examples
# Display brief information about PIM snooping router ports for VLAN 2.
<Sysname> display pim-snooping router-port vlan 2
VLAN 2:
Router ports (2 in total):
XGE1/0/1 (00:01:30)
XGE1/0/2 (00:01:32)
# Display detailed information about PIM snooping router ports for VLAN 2.
<Sysname> display pim-snooping router-port vlan 2 verbose
VLAN 2:
Router slots (0 in total):
Router ports (2 in total):
GE1/0/1 (00:01:30)
GE1/0/2 (00:01:32)
# Display detailed information about PIM snooping router ports for VSI bbb.
<Sysname> display pim-snooping router-port vsi bbb verbose
VSI bbb:
Router slots (0 in total):
Router ports (2 in total):
XGE1/0/3 (Link ID 0) (00:02:50)
Tun0 (VXLAN ID 0) (00:02:50)
Table 2 Command output
Field |
Description |
VLAN 2 |
VLAN ID. |
VSI aaa |
VSI name. |
Router slots (0 in total) |
(In standalone mode.) Slot numbers and total number of the cards that have router ports, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have router ports, except for the specified card or the global active MPU when no card is specified. |
Router ports (2 in total) |
Router ports and total number of router ports. |
(00:01:30) |
Remaining aging time for the router port. For a global port, this field is always displayed. (In standalone mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. (In IRF mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card is specified. |
AC and its link ID. |
|
Tun0 (VXLAN ID 0) |
VXLAN tunnel and its VXLAN ID. |
display pim-snooping routing-table
Use display pim-snooping routing-table to display PIM snooping routing entries.
Syntax
In standalone mode:
display pim-snooping routing-table [ vlan vlan-id | vsi vsi-name ] [ slot slot-number ] [ verbose ]
In IRF mode:
display pim-snooping routing-table [ vlan vlan-id | vsi vsi-name ] [ chassis chassis-number slot slot-number ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays PIM snooping routing entries for all VLANs.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays PIM snooping routing entries for all VSIs.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays PIM snooping routing entries for the MPU. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays PIM snooping routing entries for the global active MPU. (In IRF mode.)
verbose: Displays detailed information about PIM snooping routing entries. If you do not specify the keyword, this command displays brief information about PIM snooping routing entries.
Examples
# Display detailed information about PIM snooping routing entries for VLAN 2.
<Sysname> display pim-snooping routing-table vlan 2 verbose
Total 1 entries.
FSM Flag: NI-no info, J-join, PP-prune pending
VLAN 2: Total 1 entries.
(172.10.10.1, 225.1.1.1)
FSM information: dummy
Upstream neighbor: 20.1.1.1
Upstream Slots (0 in total):
Upstream Ports (1 in total):
XGE1/0/1
Downstream Slots (0 in total):
Downstream Ports (2 in total):
XGE1/0/2
Expires: 00:03:01, FSM: J
Downstream Neighbors (2 in total):
7.1.1.1
Expires: 00:59:19, FSM: J
7.1.1.11
Expires: 00:59:20, FSM: J
XGE1/0/3
Expires: 00:02:21, FSM: PP
# Display brief information about PIM snooping routing entries for VSI bbb.
<Sysname> display pim-snooping routing-table vsi bbb
Total 1 entries.
FSM Flag: NI-no info, J-join, PP-prune pending
VSI bbb: Total 1 entries.
(172.10.10.1, 225.1.1.1)
Upstream neighbor: 20.1.1.1
Upstream Ports (1 in total):
XGE1/0/3 (Link ID 0)
Downstream Ports (1 in total):
Tun0 (VXLAN ID 0)
Expires: 00:03:23, FSM: J
Field |
Description |
Total 1 entries |
Total number of (S, G) entries and (*, G) entries. |
FSM Flag: NI-no info, J-join, PP-prune pending |
State machine flag of the downstream port: · NI—Initial state. · J—Join. · PP—Prune pending. |
VLAN 2: Total 1 entries |
Total number of (S, G) entries and (*, G) entries in VLAN 2. |
VSI aaa: Total 1 entries |
Total number of (S, G) entries and (*, G) entries in VSI aaa. |
(172.10.10.1, 225.1.1.1) |
(S, G) entry. |
FSM information |
Finite state machine information of the entry: · delete—The entry attributes have been deleted. · dummy—The entry is a new temporary entry. · no info—The entry does not exist. · normal—The entry is a correct entry. |
Upstream neighbor |
Upstream neighbor of the (S, G) or (*, G) entry. |
Upstream Slots (0 in total) |
(In standalone mode.) Slot numbers and total number of the cards that have the upstream neighbor, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have the upstream neighbor, except for the specified card or the global active MPU when no card is specified. |
Upstream Ports (1 in total) |
Upstream ports, and the total number of upstream ports. (In standalone mode.) This field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. (In IRF mode.) This field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card is specified. |
Downstream Slots (0 in total) |
(In standalone mode.) Slot numbers and total number of the cards that have downstream ports, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have downstream ports, except for the specified card or the global active MPU when no card is specified. |
Downstream Ports (2 in total) |
Downstream ports of the upstream neighbor, and the total number of the downstream ports. |
Downstream Neighbors (2 in total) |
Downstream neighbors of the downstream port, and the total number of the downstream neighbors. |
Expires: 00:03:01, FSM: J |
Remaining aging time for the downstream port or downstream neighbor, and the finite state machine information. For a global port, this field is always displayed. (In standalone mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. (In IRF mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card is specified. |
XGE1/0/3 (Link ID 0) |
AC and its link ID. |
Tun0 (VXLAN ID 0) |
VXLAN tunnel and its VXLAN ID. |
display pim-snooping statistics
Use display pim-snooping statistics to display statistics for the PIM messages learned through PIM snooping.
Syntax
display pim-snooping statistics
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display statistics for the PIM messages learned through PIM snooping.
<Sysname> display pim-snooping statistics
Received PIMv2 hello: 100
Received PIMv2 join/prune: 100
Received PIMv2 error: 0
Received PIMv2 messages in total: 200
Received PIMv1 messages in total: 0
Table 4 Command output
Field |
Description |
Received PIMv2 hello |
Number of received PIMv2 hello messages. |
Received PIMv2 join/prune |
Number of received PIMv2 join/prune messages. |
Received PIMv2 error |
Number of received PIMv2 messages with errors. |
Received PIMv2 messages in total |
Total number of received PIMv2 messages. |
Received PIMv1 messages in total |
Total number of received PIMv1 messages. |
Related commands
reset pim-snooping statistics
pim-snooping enable
Use pim-snooping enable to enable PIM snooping for a VLAN or VSI.
Use undo pim-snooping enable to disable PIM snooping for a VLAN or VSI.
Syntax
pim-snooping enable
undo pim-snooping enable
Default
PIM snooping is disabled for a VLAN or VSI.
Views
VLAN view
VSI view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
You must enable the IGMP snooping feature and enable IGMP snooping for a VLAN or VSI before you enable PIM snooping for the VLAN or VSI.
PIM snooping does not take effect on sub-VLANs of a multicast VLAN.
Examples
# Enable the IGMP snooping feature, and then enable IGMP snooping and PIM snooping for VLAN 2.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] pim-snooping enable
# Enable the IGMP snooping feature, and then enable IGMP snooping and PIM snooping for VSI aaa.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] pim-snooping enable
Related commands
igmp-snooping
igmp-snooping enable
pim-snooping graceful-restart join-aging-time
Use pim-snooping graceful-restart join-aging-time to set the aging time for global downstream ports and global router ports on the new active MPU after an active/standby switchover.
Use undo pim-snooping graceful-restart join-aging-time to restore the default.
Syntax
pim-snooping graceful-restart join-aging-time seconds
undo pim-snooping graceful-restart join-aging-time
Default
The aging time is 210 seconds for global downstream ports and global router ports on the new active MPU after an active/standby switchover.
Views
VLAN view
VSI view
Predefined user roles
network-admin
mdc-admin
Parameters
seconds: Specifies an aging time in the range of 210 to 18000 seconds.
Usage guidelines
You must enable PIM snooping for a VLAN or VSI before you execute this command.
Global ports include Layer 2 aggregate interfaces and ACs. A global downstream port or a global router port is a global port that acts as a downstream port or router port, respectively.
Examples
# In VLAN 2, set the aging time to 600 seconds for global downstream ports and global router ports on the new active MPU after an active/standby switchover.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] pim-snooping enable
[Sysname-vlan2] pim-snooping graceful-restart join-aging-time 600
# In VSI aaa, set the aging time to 600 seconds for global downstream ports and global router ports on the new active MPU after an active/standby switchover.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] pim-snooping enable
[Sysname-vsi-aaa] pim-snooping graceful-restart join-aging-time 600
Related commands
pim-snooping enable
pim-snooping graceful-restart neighbor-aging-time
Use pim-snooping graceful-restart neighbor-aging-time to set the aging time for global neighbor ports on the new active MPU after an active/standby switchover.
Use undo pim-snooping graceful-restart neighbor-aging-time to restore the default.
Syntax
pim-snooping graceful-restart neighbor-aging-time seconds
undo pim-snooping graceful-restart neighbor-aging-time
Default
The aging time is 105 seconds for global neighbor ports on the new active MPU after an active/standby switchover.
Views
VLAN view
VSI view
Predefined user roles
network-admin
mdc-admin
Parameters
seconds: Specifies an aging time in the range of 105 to 18000 seconds.
Usage guidelines
You must enable PIM snooping in a VLAN or VSI before you execute this command.
Global ports include Layer 2 aggregate interfaces and ACs. A global neighbor port is a global port that acts as a neighbor port.
Examples
# In VLAN 2, set the aging time to 300 seconds for global neighbor ports on the new active MPU after an active/standby switchover.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] pim-snooping enable
[Sysname-vlan2] pim-snooping graceful-restart neighbor-aging-time 300
# In VSI aaa, set the aging time to 300 seconds for global neighbor ports on the new active MPU after an active/standby switchover.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] pim-snooping enable
[Sysname-vsi-aaa] pim-snooping graceful-restart neighbor-aging-time 300
Related commands
pim-snooping enable
reset pim-snooping statistics
Use reset pim-snooping statistics to clear statistics for the PIM messages learned through PIM snooping.
Syntax
reset pim-snooping statistics
Views
User view
Predefined user roles
network-admin
mdc-admin
Examples
# Clear statistics for the PIM messages learned through PIM snooping.
<Sysname> reset pim-snooping statistics
Related commands
display pim-snooping statistics