HP FlexFabric 7900 Switch Series IP Multicast Command Reference Part number: 5998-4294 Software version: Release 2109 Document version: 6W100-20140122
Legal and notice information © Copyright 2014 Hewlett-Packard Development Company, L.P. No part of this documentation may be reproduced or transmitted in any form or by any means without prior written consent of Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice.
Contents IGMP snooping commands ········································································································································· 1 display igmp-snooping············································································································································· 1 display igmp-snooping group ································································································································· 2 display igmp-sn
display multicast routing-table ······························································································································ 42 display multicast routing-table static ···················································································································· 44 display multicast rpf-info ······································································································································· 44 ip rpf-route-static ·····
pim neighbor-policy ·············································································································································· 93 pim require-genid ·················································································································································· 94 pim sm ···································································································································································· 94 pim
IGMP snooping commands The switch has one built-in MPU. The slot number of this MPU is fixed at 0. Unless otherwise stated, the term "card" in this document refers to both the MPU and LPUs. display igmp-snooping Use display igmp-snooping to display IGMP snooping status. Syntax display igmp-snooping [ global | vlan vlan-id ] Views Any view Predefined user roles network-admin network-operator Parameters global: Displays the global IGMP snooping status. vlan vlan-id: Specifies a VLAN.
Last-member-query-interval: 2s IGMP snooping information: VLAN 10 IGMP snooping: Enabled Drop-unknown: Enabled Version: 3 Host-aging-time: 260s Router-aging-time: 260s Max-response-time: 10s Last-member-query-interval: 1s Table 1 Command output Field Description IGMP snooping status: IGMP snooping • Enabled. • Disabled. Status of dropping unknown multicast data: Drop-unknown • Enabled. • Disabled. Version IGMP snooping version. Host-aging-time Aging timer for the dynamic member port.
Predefined user roles network-admin network-operator Parameters group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255. If no multicast group is specified, this command displays information about the dynamic IGMP snooping forwarding entries for all multicast groups. source-address: Specifies a multicast source by its IP address.
Related commands reset igmp-snooping group display igmp-snooping router-port Use display igmp-snooping router-port to display information about dynamic router ports. Syntax In standalone mode: display igmp-snooping router-port [ vlan vlan-id ] [ slot slot-number ] In IRF mode: display igmp-snooping router-port [ vlan vlan-id ] [ chassis chassis-number slot slot-number ] Views Any view Predefined user roles network-admin network-operator Parameters vlan vlan-id: Specifies a VLAN.
Related commands reset igmp-snooping router-port display igmp-snooping static-group Use display igmp-snooping static-group to display information about static IGMP snooping forwarding entries.
VLAN 2: Total 1 entries. (0.0.0.0, 224.1.1.1) Host slots (1 in total): 1 Host ports (1 in total): FGE1/0/2 Table 4 Command output Field Description Total 1 entries Total number of static IGMP snooping forwarding entries. VLAN 2: Total 1 entries Total number of static IGMP snooping forwarding entries in VLAN 2. (0.0.0.0, 224.1.1.1) (S, G) entry. If the multicast source is not specified, the field in the S position displays 0.0.0.0.
Router slots (1 in total): 1 Router ports (2 in total): FGE1/0/1 FGE1/0/2 Table 5 Command output Field Description VLAN 2 VLAN ID. Router slots (1 in total) Slot IDs of the cards where static router ports reside and total number of the cards. Router ports (2 in total) Static router ports and total number of the static router ports. display igmp-snooping statistics Use display igmp-snooping statistics to display statistics for the IGMP messages learned by IGMP snooping.
Field Description specific queries Number of IGMP group-specific queries. reports Number of IGMP reports. leaves Number of IGMP leave messages. reports with right and wrong records Number of IGMP reports with correct and incorrect records. specific sg queries Number of IGMP group-and-source-specific queries. error IGMP messages Number of IGMP messages with errors.
Examples # Display information about the Layer 2 IP multicast groups for VLAN 2. display l2-multicast ip vlan 2 Total 1 entries. VLAN 2: Total 1 IP entries. (0.0.0.0, 224.1.1.1) Attribute: static, success Host slots (1 in total): 1 Host ports (1 in total): FGE1/0/1 (S, SUC) Table 7 Command output Field Description Total 1 entries Total number of Layer 2 IP multicast groups. VLAN 2: Total 1 IP entries Total number of Layer 2 IP multicast groups in VLAN 2. (0.0.0.0, 224.1.1.
display l2-multicast ip forwarding [ group group-address | source source-address ] * [ vlan vlan-id ] [ slot slot-number ] In IRF mode: display l2-multicast ip forwarding [ group group-address | source source-address ] * [ vlan vlan-id ] [ chassis chassis-number slot slot-number ] Views Any view Predefined user roles network-admin network-operator Parameters group group-address: Specifies a multicast group by its IP address.
Field Description Host slots (1 in total) Slot IDs of the cards where member ports reside and total number of the cards. Host ports (3 in total) Member ports and total number of the member ports.
Table 9 Command output Field Description Total 1 MAC entries Total number of Layer 2 MAC multicast groups. VLAN 2: Total 1 MAC entries Total number of Layer 2 MAC multicast groups in VLAN 2. Entry attribute: Attribute • success—Processing succeeds. • fail—Processing fails. Host slots (1 in total) Slot IDs of the cards where member ports reside and total number of the cards. Host ports (1 in total) Member ports and total number of the member ports.
display l2-multicast mac forwarding vlan 2 Total 1 MAC entries. VLAN 2: Total 1 MAC entries. MAC group address: 0100-5e01-0101 Host slots (1 in total): 1 Host ports (3 in total): FGE1/0/1 FGE1/0/2 FGE1/0/3 Table 10 Command output Field Description Total 1 MAC entries Total number of Layer 2 MAC multicast group entries. VLAN 2: Total 1 MAC entries Total number of Layer 2 MAC multicast group entries in VLAN 2. MAC group address Address of the MAC multicast group.
[Sysname] igmp-snooping [Sysname-igmp-snooping] enable vlan 2 to 10 Related commands • igmp-snooping • igmp-snooping enable entry-limit (IGMP-snooping view) Use entry-limit to set the global maximum number of IGMP snooping forwarding entries. Use undo entry-limit to restore the default. Syntax entry-limit limit undo entry-limit Default The setting is 4294967295.
Predefined user roles network-admin Parameters vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094. If this option is not specified, this command takes effect on all VLANs.
source address of an IGMPv1 or IGMPv2 report or an IGMPv3 IS_EX and TO_EX report that does not carry a multicast source address. vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094. If this option is not specified, this command takes effect on all VLANs.
Usage guidelines The global configuration is effective on all VLANs, but it has a lower priority than the configuration made in a specific VLAN. Examples # Set the aging timer for dynamic member ports to 300 seconds globally. system-view [Sysname] igmp-snooping [Sysname-igmp-snooping] host-aging-time 300 Related commands igmp-snooping host-aging-time igmp-snooping Use igmp-snooping to enable IGMP snooping globally and enter IGMP-snooping view.
Default Dropping unknown multicast data in a VLAN is disabled and unknown multicast data is flooded in the VLAN. Views VLAN view Predefined user roles network-admin Usage guidelines You must enable IGMP snooping for a VLAN before you execute this command for the VLAN. This configuration takes effect on the current VLAN. Examples # Enable IGMP snooping and the function of dropping unknown multicast data for VLAN 2.
[Sysname-igmp-snooping] quit [Sysname] vlan 2 [Sysname-vlan2] igmp-snooping enable Related commands • enable (IGMP-snooping view) • igmp-snooping igmp-snooping fast-leave Use igmp-snooping fast-leave to enable IGMP snooping fast-leave processing on a port. Use undo igmp-snooping fast-leave to disable IGMP snooping fast-leave processing on a port.
Use undo igmp-snooping group-limit to restore the default. Syntax igmp-snooping group-limit limit [ vlan vlan-list ] undo igmp-snooping group-limit [ vlan vlan-list ] Default The default setting is 4294967295. Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view Predefined user roles network-admin Parameters limit: Sets the maximum number of multicast groups that a port can join, in the range of 0 to 4294967295. vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items.
Parameters acl-number: Specifies an IPv4 basic or advanced ACL by its number in the range of 2000 to 3999. A host can join only the multicast groups that match the permit statement in the specified ACL. The source addresses in the basic rule are the multicast group addresses specified in IGMP reports. The source and destination addresses in the advanced ACL rule are the multicast source addresses and multicast group addresses specified in IGMP reports, respectively. The system assumes that 0.0.0.
Predefined user roles network-admin Parameters interval: Sets an aging timer for the dynamic member ports in a VLAN, in the range of 200 to 1000 seconds. Usage guidelines You must enable IGMP snooping for a VLAN before you execute this command for the VLAN. The configuration made in VLAN view is only effective on the current VLAN, and it takes preference over the global configuration.
You must enable IGMP snooping for a VLAN before you execute this command for the VLAN. The configuration made in VLAN view is only effective on the current VLAN, and it takes preference over the global configuration. Examples # Enable IGMP snooping for VLAN 2 and set the IGMP last-member query interval to 3 seconds.
[Sysname] vlan 2 [Sysname-vlan2] igmp-snooping enable [Sysname-vlan2] igmp-snooping max-response-time 5 Related commands • igmp-snooping enable • max-response-time (IGMP-snooping view) igmp-snooping overflow-replace Use igmp-snooping overflow-replace to enable the multicast group replacement function on a port. Use undo igmp-snooping overflow-replace to disable the multicast group replacement function on a port.
Use undo igmp-snooping router-aging-time to restore the default. Syntax igmp-snooping router-aging-time interval undo igmp-snooping router-aging-time Default The default setting is 260 seconds. Views VLAN view Predefined user roles network-admin Parameters interval: Sets an aging timer for the dynamic router ports in a VLAN, in the range of 1 to 1000 seconds. Usage guidelines You must enable IGMP snooping for a VLAN before you execute this command for the VLAN.
Default Multicast source port filtering is disabled, and the port can connect to both multicast sources and multicast receivers. Views Layer 2 Ethernet interface view Predefined user roles network-admin Usage guidelines This configuration is only effective on the current port, and it has the same priority as the global configuration. Examples # Enable source port filtering for multicast data on FortyGigE 1/0/1.
Usage guidelines The source-ip source-address option takes effect only for IGMPv3 snooping. If IGMPv2 snooping is running, the source-ip source-address option does not take effect, although you can include source-ip source-address in the command. Examples # Configure FortyGigE 1/0/1 in VLAN 2 as a static member port for the multicast source and group (1.1.1.1, 225.0.0.1).
Use undo igmp-snooping version to restore the default. Syntax igmp-snooping version version-number undo igmp-snooping version Default The default setting is IGMPv2 snooping. Views VLAN view Predefined user roles network-admin Parameters version-number: Specifies an IGMP snooping version, 2 or 3. Usage guidelines You must enable IGMP snooping for a VLAN before you execute this command for the VLAN. Examples # Enable IGMP snooping for VLAN 2 and specify IGMPv3 snooping for the VLAN.
Parameters interval: Sets the IGMP last-member query interval, in the range of 1 to 5 seconds. Usage guidelines The IGMP last-member query interval determines the interval for sending IGMP group-specific queries and the maximum response time for IGMP group-specific queries. The global configuration is effective on all VLANs, but it has a lower priority than the configuration made in a specific VLAN. Examples # Set the IGMP last-member query interval to 3 seconds.
overflow-replace (IGMP-snooping view) Use overflow-replace to enable the multicast group replacement function globally. Use undo overflow-replace to disable the multicast group replacement function globally. Syntax overflow-replace [ vlan vlan-list ] undo overflow-replace [ vlan vlan-list ] Default The multicast group replacement function is disabled globally. Views IGMP-snooping view Predefined user roles network-admin Parameters vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items.
Views IGMP-snooping view Predefined user roles network-admin Examples # Disable IGMP report suppression. system-view [Sysname] igmp-snooping [Sysname-igmp-snooping] undo report-aggregation reset igmp-snooping group Use reset igmp-snooping group to remove the dynamic IGMP snooping forwarding entries for multicast groups.
Predefined user roles network-admin Parameters all: Specifies all VLANs. vlan vlan-id: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094. Examples # Remove all dynamic router ports. reset igmp-snooping router-port all Related commands display igmp-snooping router-port reset igmp-snooping statistics Use reset igmp-snooping statistics to clear statistics for the IGMP messages learned by IGMP snooping.
Predefined user roles network-admin Parameters interval: Specifies an aging timer for dynamic router ports, in the range of 1 to 1000 seconds. Usage guidelines The global configuration is effective on all VLANs, but it has a lower priority than the configuration made in a specific VLAN. Examples # Set the global aging timer for dynamic router ports to 100 seconds.
system-view [Sysname] igmp-snooping [Sysname-igmp-snooping] source-deny port fortygige 1/0/1 to fortygige 1/0/4 Related commands igmp-snooping source-deny version (IGMP-snooping view) Use version to specify the IGMP snooping version for VLANs. Use undo version to restore the default. Syntax version version-number vlan vlan-list undo version vlan vlan-list Default The default setting is IGMPv2 snooping.
Multicast routing and forwarding commands The switch has one built-in MPU. The slot number of this MPU is fixed at 0. Unless otherwise stated, the term "card" in this document refers to both the MPU and LPUs. The term "interface" in this chapter collectively refers to Layer 3 interfaces, including VLAN interfaces and Layer 3 Ethernet interfaces. You can set an Ethernet port as a Layer 3 interface by using the port link-mode route command (see Layer 2—LAN Switching Configuration Guide).
network-operator Parameters mac-address: Specifies a multicast MAC address. The MAC address can be any legal multicast MAC address. A multicast MAC address is the MAC address in which the least significant bit of the most significant octet is 1. vlan vlan-id: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094. If no VLAN is specified, this command displays the static multicast MAC address entries for all VLANs. multicast: Specifies static multicast MAC address entries.
Syntax display mrib interface [ interface-type interface-number ] Views Any view Predefined user roles network-admin network-operator Parameters interface-type interface-number: Specifies an interface by its type and number. If no interface is specified, the command displays information about the interfaces maintained by the MRIB on all interfaces. Examples # Display information about the interfaces maintained by the MRIB on all interfaces.
Field Description Local address Local IP address. Remote address Remote end IP address. This field is displayed when the interface is vlink type. Reference Times for which the address has been referenced. Status of the interface address: • NORMAL. • DEL. State display multicast boundary Use display multicast boundary to display multicast boundary information.
Related commands multicast boundary display multicast forwarding event Use display multicast forwarding event to display statistics for multicast forwarding events. Syntax In standalone mode: display multicast forwarding event [ slot slot-number ] In IRF mode: display multicast forwarding event [ chassis chassis-number slot slot-number ] Views Any view Predefined user roles network-admin network-operator Parameters slot slot-number: Specifies a card by its slot number.
Field Description Total NoCache event dropped Times for which the NoCache event has been dropped. Total WrongIF event sent Times for which the WrongIF event has been sent. Total WrongIF event dropped Times for which the WrongIF event has been dropped. Total SPT switch event sent Times for which the SPT-switch event has been sent. NoCache rate limit Rate limit for sending the NoCache event, in pps. WrongIF rate limit Rate limit for sending the WrongIF event, in packets per 10 seconds.
incoming-interface: Specifies the multicast forwarding entries that contain the specified incoming interface. interface-type interface-number: Specifies an incoming interface by its type and number. outgoing-interface: Specifies the multicast forwarding entries that contain the specified outgoing interface. exclude: Specifies the multicast forwarding entries that do not contain the specified interface in the outgoing interface list.
Field Description List of 1 outgoing interface: Outgoing interface list of the (S, G) entry. Matched 19648 packets(20512512 bytes), Wrong If 0 packet (S, G)-matched packets (bytes), packets with incoming interface errors. Forwarded 19648 packets(20512512 bytes) (S, G)-forwarded packets (bytes). Table 16 Major value of the flag field Value Meaning 0x0 Correct forwarding entry. 0x1 The (S, G) entry is in inactive status. 0x2 Null forwarding entry. 0x4 The (S, G) entry failed to update.
group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255. mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32. mask: Specifies the address mask. The default is 255.255.255.255. incoming-interface: Specifies the multicast routing entries that contain the specified incoming interface.
display multicast routing-table static Use display multicast routing-table static to display static multicast routing entries. Syntax display multicast routing-table static [ source-address { mask-length | mask } ] Views Any view Predefined user roles network-admin network-operator Parameters source-address: Specifies a multicast source address. mask-length: Specifies an address mask length in the range of 0 to 32. mask: Specifies an address mask.
Syntax display multicast rpf-info source-address [ group-address ] Views Any view Predefined user roles network-admin network-operator Parameters source-address: Specifies a multicast source address. group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255. Examples # Display the RPF information of multicast source 192.168.1.55. display multicast rpf-info 192.168.1.55 RPF information about source 192.168.1.
ip rpf-route-static Use ip rpf-route-static to configure a static multicast route. Use undo ip rpf-route-static to delete a static multicast route. Syntax ip rpf-route-static source-address { mask-length | mask } { rpf-nbr-address | interface-type interface-number } [ preference preference ] undo ip rpf-route-static source-address { mask-length | mask } { rpf-nbr-address | interface-type interface-number } Default No static multicast route exists.
Examples # Configure a static multicast route to the multicast source groups 10.1.1.1/24, and specify a router with the IP address of 192.168.1.23 as its RPF neighbor. system-view [Sysname] ip rpf-route-static 10.1.1.1 24 192.168.1.23 Related commands • delete ip rpf-route-static • display multicast routing-table static load-splitting (MRIB view) Use load-splitting to enable load splitting of multicast traffic. Use undo load-splitting to restore the default.
Default The device selects the route with the highest priority as the RPF route. Views MRIB view Predefined user roles network-admin Examples # Configure the device to select the RPF route based on the longest prefix match principle. system-view [Sysname] multicast routing [Sysname-mrib] multicast longest-match mac-address multicast Use mac-address multicast to configure a static multicast MAC address entry. Use undo mac-address multicast to delete a static multicast MAC address entry.
Usage guidelines You can configure static multicast MAC address entries on the specified interface in system view or on the current interface in interface view. You do not need to enable IP multicast routing before executing this command. The undo mac-address multicast command without the multicast keyword can delete all MAC address entries, including static unicast and multicast MAC address entries.
Usage guidelines A multicast forwarding boundary sets the boundary condition for the multicast groups in the specified address range. If the destination address of a multicast packet matches the set boundary condition, the packet is not forwarded. You do not need to enable IP multicast routing before executing this command. An interface can act as a forwarding boundary for multiple multicast groups in different address ranges.
reset multicast forwarding event Use reset multicast forwarding event to clear statistics for multicast forwarding events. Syntax reset multicast forwarding event Views User view Predefined user roles network-admin Examples # Clear statistics for the multicast forwarding events. reset multicast forwarding event Related commands display multicast forwarding event reset multicast forwarding-table Use reset multicast forwarding-table to clear the multicast forwarding entries.
Examples # Clear the multicast forwarding entries related to the multicast group 225.5.4.3 from the multicast forwarding table. reset multicast forwarding-table 225.5.4.3 Related commands display multicast forwarding-table reset multicast routing-table Use reset multicast routing-table to clear the multicast routing entries.
IGMP commands The term "interface" in this chapter collectively refers to Layer 3 interfaces, including VLAN interfaces and Layer 3 Ethernet interfaces. You can set an Ethernet port as a Layer 3 interface by using the port link-mode route command (see Layer 2—LAN Switching Configuration Guide). display igmp group Use display igmp group to display IGMP group information.
Uptime: 00:00:34 Expires: Off Last reporter: 10.10.1.10 Last-member-query-counter: 0 Last-member-query-timer-expiry: Off Group mode: Include Version1-host-present-timer-expiry: Off Version2-host-present-timer-expiry: Off Source list (sources in total: 1): Source: 10.1.1.1 Uptime: 00:00:03 Expires: 00:04:16 Last-member-query-counter: 0 Last-member-query-timer-expiry: Off Table 20 Command output Field Description IGMP groups reported in total Total number of reported IGMP groups.
Related commands reset igmp group display igmp interface Use display igmp interface to display IGMP information on an interface. Syntax display igmp interface [ interface-type interface-number ] [ verbose ] Views Any view Predefined user roles network-admin network-operator Parameters interface-type interface-number: Specifies an interface by its type and number. If no interface is specified, this command displays IGMP information on all IGMP-enabled interfaces.
Table 21 Command output Field Description Vlan-interface1(10.10.1.20) Interface (IP address). Query interval for IGMP IGMP general query interval, in seconds. Other querier present time for IGMP Other querier present interval, in seconds. Maximum query response time for IGMP Maximum response delay for IGMP general queries, in seconds. Last member query interval IGMP last-member query interval, in seconds. Startup query interval IGMP startup query interval, in seconds.
Field Description IGMP groups reported in total Total number of multicast groups that the interface has dynamically joined. This field is not displayed if no interfaces join the IGMP group. igmp enable Use igmp enable to enable IGMP on an interface. Use undo igmp enable to disable IGMP on an interface. Syntax igmp enable undo igmp enable Default IGMP is disabled on all interfaces.
Default Fast-leave processing is disabled. The IGMP querier sends IGMP group-specific queries or IGMP group-and-source-specific queries after receiving an IGMP leave message from a host, instead of sending a leave notification directly to the upstream. Views Interface view Predefined user roles network-admin Parameters acl-number: Specifies an IPv4 basic ACL by its number in the range of 2000 to 2999.
version-number: Specifies an IGMP version in the range of 1 to 3. By default, the configured group filter applies to IGMP reports of all versions. Usage guidelines If you configure this command on a static member port, this command does not take effect because the ACL filters only IGMP messages. Examples # Configure an IPv4 ACL so that hosts on VLAN-interface 100 can join the multicast group 225.1.1.1 only. system-view [Sysname] acl number 2005 [Sysname-acl-basic-2005] rule permit source 225.1.
[Sysname-Vlan-interface100] igmp static-group 224.1.1.1 # Configure VLAN-interface 100 as a static member of the multicast source and group (192.168.1.1, 232.1.1.1). system-view [Sysname] interface vlan-interface 100 [Sysname-Vlan-interface100] igmp static-group 232.1.1.1 source 192.168.1.1 igmp version Use igmp version to specify the IGMP version for an interface. Use undo igmp version to restore the default.
interface-type interface-number: Specifies an interface by its type and number. group-address: Specifies a multicast group by its address in the range of 224.0.0.0 to 239.255.255.255. source-address: Specifies a multicast source address. If this argument is not specified, the command removes dynamic IGMP group entries of all multicast source addresses. mask: Specifies the address mask. The default is 255.255.255.255. mask-length: Specifies the address mask length. The default is 32.
PIM commands The term "interface" in this chapter collectively refers to Layer 3 interfaces, including VLAN interfaces and Layer 3 Ethernet interfaces. You can set an Ethernet port as a Layer 3 interface by using the port link-mode route command (see Layer 2—LAN Switching Configuration Guide). bsm-fragment enable (PIM view) Use bsm-fragment enable to enable BSM semantic fragmentation. Use undo bsm-fragment enable to disable BSM semantic fragmentation.
Views PIM view Predefined user roles network-admin Parameters acl-number: Specifies an IPv4 basic ACL by its number in the range of 2000 to 2999. Usage guidelines In an ACL, the source field specifies the source address range for the legal BSR. All the optional parameters except source, time-range, and fragment in the ACL are ignored. Examples # Configure the legal BSR address range to 10.1.1.0/24, so that only the devices on the subnet 10.1.1.0/24 can act as the BSR.
mask-length: Specifies the address mask length in the range of 8 to 32. mask: Specifies the address mask. hash-length hash-length: Specifies a hash mask length in the range of 0 to 32. The default setting is 30. priority priority: Specifies a priority for the C-BSR, in the range of 0 to 255. The default setting is 64. A larger value represents a higher priority. Usage guidelines The IP address of a C-BSR must be the IP address of a local PIM enabled interface on the C-BSR.
holdtime hold-time: Specifies a lifetime for the C-RP, in the range of 1 to 65535 seconds. The default value is 150 seconds. priority priority: Specifies a priority for the C-RP, in the range of 0 to 255. The default setting is 192. A larger value represents a lower priority. Usage guidelines The IP address of a C-RP must be the IP address of a local PIM enabled interface on the C-RP. Otherwise, the configuration does not take effect.
Usage guidelines This command guards against C-RP spoofing. In an ACL, the source field specifies the legal C-RP address range, and the destination field specifies the multicast group range to which the C-RP is designated. All the optional parameters except source, time-range, and fragment in the ACL are ignored. When the device compares the advertisement message against the destination field in the ACL, it uses only the prefix of the multicast group range in the advertisement message.
down: Displays information about the interfaces in down state and the causes. If this keyword is not specified, the command displays information about interfaces in all states. description: Displays the full interface description. If this keyword is not specified, only the first 27 characters of the interface description are displayed. Usage guidelines The register-tunnel interface is a virtual interface that is automatically created by the system.
Link: ADM - administratively down; Stby - standby Interface Link Cause REG0 DOWN Not connected Table 22 Command output Field Description Current state Physical state of the register-tunnel interface. This field always displays down. Line protocol state Link state of the register-tunnel interface. This field always displays down. Description Description of the register-tunnel interface. It is not configurable. Bandwidth Expected bandwidth of the register-tunnel interface. It is not configurable.
display pim bsr-info Use display pim bsr-info to display BSR information in the PIM-SM domain. Syntax display pim bsr-info Views Any view Predefined user roles network-admin network-operator Examples # Display BSR information in the PIM-SM domain. display pim bsr-info Scope: non-scoped State: Accept Preferred Bootstrap timer: 00:01:44 Elected BSR address: 12.12.12.1 Priority: 64 Hash mask length: 30 Uptime: 00:21:56 Scope: 239.4.0.
Hash mask length: 30 Scope: 239.3.3.0/24 State: Pending Bootstrap timer: 00:00:07 Candidate BSR address: 17.1.13.1 Priority: 64 Hash mask length: 30 Table 23 Command output Field Description Scope-zone expiry timer Scoped zone aging timer. Elected BSR address Address of the elected BSR. Candidate BSR address Address of the candidate BSR. Priority BSR priority. Uptime Length of time the BSR has been up.
Route/mask: 7.12.0.0/16 (multicast static) RPF interface: Vlan-interface2, RPF neighbor: 8.0.0.3, Config NextHop: 8.0.0.5 Total number of (S,G) or (*,G) dependent on this route entry: 2 (7.12.0.10, 226.1.1.1) (7.12.0.10, 225.1.1.1) Table 24 Command output Field Description Route entry. Route types in parentheses include: Route/mask • • • • • igp—IGP unicast route. egp—EGP unicast route. unicast (direct)—Direct unicast route. unicast—Other unicast route, such as static unicast route.
Group/MaskLen: 224.0.0.0/4 C-RP address Priority HoldTime Uptime Expires 1.1.1.1 (local) 192 150 03:01:36 00:02:29 2.2.2.2 192 150 1d:13h 00:02:02 Group/MaskLen: 226.1.1.0/24 Expires: 00:00:33 Group/MaskLen: 225.1.0.0/16 C-RP Address Priority HoldTime Uptime Expires 3.3.3.3 192 150 12w:5d 00:02:05 # Display information about the locally configured C-RPs. display pim c-rp local Candidate RP: 12.12.12.
Parameters interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays PIM information on all interfaces. verbose: Displays detailed PIM information. If you do not specify this keyword, this command displays brief PIM information. Examples # Display brief PIM information on all interfaces. display pim interface Interface NbrCnt HelloInt DR-Pri DR-Address Vlan1 1 30 1 10.1.1.2 Vlan2 0 30 1 172.168.0.
Table 27 Command output Field Description PIM mode PIM mode: dense or sparse. PIM DR IP address of the DR. PIM DR Priority (configured) Configured priority for DR election. PIM neighbor count Total number of PIM neighbors. PIM hello interval Interval between two hello messages. PIM LAN delay (negotiated) Negotiated PIM message propagation delay. PIM LAN delay (configured) Configured PIM message propagation delay.
network-operator Parameters neighbor-address: Specifies a PIM neighbor by its IP address. If you do not specify a PIM neighbor, this command displays information about all PIM neighbors. interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays information about PIM neighbors on all interfaces. verbose: Displays detailed PIM neighbor information.
Field Description LAN delay PIM message propagation delay. Override interval Interval for overriding prune messages. State refresh interval Interval for refreshing state. This field is displayed only when the PIM neighbor operates in PIM-DM mode and the state refresh capability is enabled. Neighbor tracking status: Neighbor tracking • Enabled. • Disabled. Bidirectional PIM Whether BIDIR-PIM is enabled.
• niif: Specifies PIM routing entries containing unknown incoming interfaces. • nonbr: Specifies PIM routing entries with PIM neighbor lookup failure. • rpt: Specifies PIM routing entries on the RPT branches where (S, G) prunes have been sent to the RP. • spt: Specifies PIM routing entries on the SPT. • swt: Specifies PIM routing entries in the process of RPT-to-SPT switchover. • wc: Specifies PIM routing entries with wildcards. fsm: Displays detailed information about the finite state machine.
Table 29 Command output Field Description Total 0 (*, G) entry; 1 (S, G) entry Total number of (S, G) entries and (*, G) entries in the PIM routing table. (172.168.0.12, 227.0.0.1) (S, G) entry in the PIM routing table. Protocol PIM mode. Flag of the (S, G) entry or (*, G) entry: • ACT—The entry has been used for routing data. • DEL—The entry will be removed. • EXPRUNE—Some outgoing interfaces are pruned by other multicast routing protocols.
Predefined user roles network-admin network-operator Parameters group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255. If no multicast group is specified, this command displays information about all RPs for multicast groups. Examples # Display information about the RP for the multicast group 224.0.1.1. display pim rp-info 224.0.1.1 BSR RP address is: 2.2.2.2 Priority: 192 HoldTime: 150 Uptime: 03:01:10 Expires: 00:02:30 Static RP address is: 3.
Field Description HoldTime RP lifetime. Uptime Length of time the RP has been up. Expires Remaining lifetime for the RP. Preferred Whether the static RP is preferred. Configured ACL/ACL ACL defining the multicast groups to which the static RP is designated. Mode Static RP service mode: PIM-SM. RP mapping for this group IP address of the RP that provides services for the multicast group. display pim statistics Use display pim statistics to display statistics for PIM packets.
Field Description Valid Number of received valid PIM packets. Invalid Number of received invalid PIM packets. Succeeded Number of valid PIM packets that were sent successfully. Failed Number of valid PIM packets that failed to be sent. Hello Hello message statistics. Reg Register message statistics. Reg-stop Register-stop message statistics. JP Join/prune message statistics. BSM BSM statistics. Assert Assert message statistics. Graft Graft message statistics.
Examples # Set the global priority for DR election to 3. system-view [Sysname] pim [Sysname-pim] hello-option dr-priority 3 Related commands pim hello-option dr-priority hello-option holdtime (PIM view) Use hello-option holdtime to set the global PIM neighbor lifetime. Use undo hello-option holdtime to restore the default. Syntax hello-option holdtime time undo hello-option holdtime Default The global PIM neighbor lifetime is 105 seconds.
Syntax hello-option lan-delay delay undo hello-option lan-delay Default The global PIM message propagation delay is 500 milliseconds. Views PIM view Predefined user roles network-admin Parameters delay: Sets the PIM message propagation delay, in the range of 1 to 32767 milliseconds. Usage guidelines You can set the PIM message propagation delay in PIM view or interface view.
Predefined user roles network-admin Usage guidelines You can enable the neighbor tracking function in PIM view or interface view. The configurations made in PIM view are effective on all interfaces, and the configurations made in interface view are effective on only the current interface. If you enable the neighbor tracking function in both PIM view and interface view, the configuration in interface view always takes precedence. Examples # Enable the neighbor tracking function globally.
Related commands • hello-option lan-delay (PIM view) • pim hello-option lan-delay • pim hello-option override-interval holdtime join-prune (PIM view) Use holdtime join-prune to set the global joined/pruned state holdtime timer. Use undo holdtime join-prune to restore the default. Syntax holdtime join-prune time undo holdtime join-prune Default The global joined/pruned state holdtime timer is 210 seconds.
Default The maximum size of a join/prune message is 8100 bytes. Views PIM view Predefined user roles network-admin Parameters size: Sets the maximum size of each join/prune message, in the range of 100 to 8100 bytes. Examples # Set the maximum size of each join/prune message to 1500 bytes. system-view [Sysname] pim [Sysname-pim] jp-pkt-size 1500 pim Use pim to enter PIM view. Use undo pim to remove all configurations in PIM view.
Syntax pim bfd enable undo pim bfd enable Default BFD is disabled for PIM. Views Interface view Predefined user roles network-admin Usage guidelines You must enable PIM-DM or PIM-SM on an interface before you configure this command. Examples # Enable IP multicast routing, enable PIM-DM on VLAN-interface 100, and enable BFD for PIM on the interface.
system-view [Sysname] interface vlan-interface 100 [Sysname-Vlan-interface100] pim bsr-boundary Related commands • c-bsr (PIM view) • multicast boundary pim dm Use pim dm to enable PIM-DM. Use undo pim dm to disable PIM-DM. Syntax pim dm undo pim dm Default PIM-DM is disabled. Views Interface view Predefined user roles network-admin Usage guidelines This command takes effect only after you enable IP multicast routing.
Default The priority for DR election is 1. Views Interface view Predefined user roles network-admin Parameters priority: Sets the priority for DR election, in the range of 0 to 4294967295. A larger value represents a higher priority. Usage guidelines You can set the priority for DR election in PIM view or interface view. The configurations made in PIM view are effective on all interfaces, and the configurations made in interface view are effective on only the current interface.
Usage guidelines You can set the PIM neighbor lifetime in PIM view or interface view. The configurations made in PIM view are effective on all interfaces, and the configurations made in interface view are effective on only the current interface. If you set the PIM neighbor lifetime in both PIM view and interface view, the configuration in interface view always takes precedence. Examples # Sets the PIM neighbor lifetime to 120 seconds on VLAN-interface 100.
• pim hello-option override-interval pim hello-option neighbor-tracking Use pim hello-option neighbor-tracking to enable the neighbor tracking function and disable the join message suppression function on an interface. Use pim hello-option neighbor-tracking disable to disable the neighbor tracking function on an interface when the neighbor tracking function is enabled globally.
pim hello-option override-interval Use pim hello-option override-interval to set the override interval on an interface. Use undo pim hello-option override-interval to restore the default. Syntax pim hello-option override-interval interval undo pim hello-option override-interval Default The override interval is 2500 milliseconds. Views Interface view Predefined user roles network-admin Parameters interval: Sets the override interval, in the range of 1 to 65535 milliseconds.
Views Interface view Predefined user roles network-admin Parameters time: Sets the joined/pruned state holdtime timer, in the range of 1 to 65535 seconds. Usage guidelines You can set the joined/pruned state holdtime timer in PIM view or interface view. The configurations made in PIM view are effective on all interfaces, and the configurations made in interface view are effective on only the current interface.
Examples # Configure a legal source address range for hello messages on VLAN-interface 100 so that only the devices on the 10.1.1.0/24 subnet can become PIM neighbors of this switch. system-view [Sysname] acl number 2000 [Sysname-acl-basic-2000] rule permit source 10.1.1.0 0.0.0.
Predefined user roles network-admin Usage guidelines This command takes effect only after you enable IP multicast routing. Examples # Enable IP multicast routing, and enable PIM-SM on VLAN-interface 100. system-view [Sysname] multicast routing [Sysname-mrib] quit [Sysname] interface vlan-interface 100 [Sysname-Vlan-interface100] pim sm Related commands multicast routing pim state-refresh-capable Use pim state-refresh-capable to enable the state refresh feature on an interface.
Use undo pim timer graft-retry to restore the default. Syntax pim timer graft-retry interval undo pim timer graft-retry Default The graft retry timer is 3 seconds. Views Interface view Predefined user roles network-admin Parameters interval: Specifies a graft retry timer, in the range of 1 to 65535 seconds. Examples # Set the graft retry timer to 80 seconds on VLAN-interface 100.
Examples # Set the interval for sending hello messages to 40 seconds on VLAN-interface 100. system-view [Sysname] interface vlan-interface 100 [Sysname-Vlan-interface100] pim timer hello 40 Related commands timer hello (PIM view) pim timer join-prune Use pim timer join-prune to set interval for sending the join/prune messages on an interface. Use undo pim timer join-prune to restore the default.
Syntax pim triggered-hello-delay delay undo pim triggered-hello-delay Default The maximum delay for sending a hello message is 5 seconds. Views Interface view Predefined user roles network-admin Parameters delay: Sets the maximum delay for sending a hello message, in the range of 1 to 60 seconds. Examples # Set the maximum delay for sending a hello message to 3 seconds on VLAN-interface 100.
system-view [Sysname] acl number 3000 [Sysname-acl-adv-3000] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255 [Sysname-acl-adv-3000] quit [Sysname] pim [Sysname-pim] register-policy 3000 register-whole-checksum (PIM view) Use register-whole-checksum to configure the device to calculate the checksum based on an entire register message. Use undo register-whole-checksum to restore the default.
Parameters time: Sets the multicast source lifetime, in the range of 0 to 31536000 seconds. If the value for this argument is 0, multicast sources are never aged out. Examples # Set the multicast source lifetime to 200 seconds. system-view [Sysname] pim [Sysname-pim] source-lifetime 200 source-policy (PIM view) Use source-policy to configure a multicast data filter. Use undo source-policy to remove the configured multicast data filter.
spt-switch-threshold (PIM view) Use spt-switch-threshold to configure the criteria for triggering a switchover to SPT. Use undo spt-switch-threshold to restore the default. Syntax spt-switch-threshold { immediacy | infinity } [ group-policy acl-number ] undo spt-switch-threshold [ immediacy | infinity ] [ group-policy acl-number ] Default The device immediately triggers a switchover to SPT after receiving the first multicast packet.
undo ssm-policy Default The SSM group range is 232.0.0.0/8. Views PIM view Predefined user roles network-admin Parameters acl-number: Specifies a basic ACL number in the range of 2000 to 2999. Usage guidelines The source field in an ACL specifies the SSM group range. All the optional parameters except source, time-range, and fragment in the ACL are ignored. You can use this command to define an address range of permitted or denied multicast groups.
Examples # Set the interval for sending state refresh messages to 70 seconds. system-view [Sysname] pim [Sysname-pim] state-refresh-interval 70 Related commands • pim state-refresh-capable • state-refresh-rate-limit (PIM view) • state-refresh-ttl (PIM view) state-refresh-rate-limit (PIM view) Use state-refresh-rate-limit to configure the time that the router waits before receiving a new state refresh message. Use undo state-refresh-rate-limit to restore the default.
Use undo state-refresh-ttl to restore the default. Syntax state-refresh-ttl ttl-value undo state-refresh-ttl Default The TTL value of state refresh messages is 255. Views PIM view Predefined user roles network-admin Parameters ttl-value: Specifies a TTL value of state refresh messages, in the range of 1 to 255. Examples # Set the TTL value of state refresh messages to be 45.
acl-number: Specifies an IPv4 basic ACL number in the range of 2000 to 2999 to filter IPv4 multicast groups. The static RP is designated only to IPv4 multicast groups that pass the ACL filtering. If you do not specify an ACL, or if you specify an ACL that does not exist or does not contain any valid rules, the static RP is designated to all multicast groups 224.0.0.0/4. preferred: Gives priority to the static RP if the static RP and the dynamic RP exist at the same time on the network.
Parameters interval: Sets the interval for sending hello messages, in the range of 0 to 18000 seconds. If the value for this argument is 0, no hello messages are sent. Usage guidelines You can set the interval for sending hello messages in PIM view or interface view. The configurations made in PIM view are effective on all interfaces, and the configurations made in interface view are effective on only the current interface.
[Sysname-pim] timer join-prune 80 Related commands pim timer join-prune 107
Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
HP Education http://www.hp.com/learn • Conventions This section describes the conventions used in this documentation set. Command conventions Convention Description Boldface Bold text represents commands and keywords that you enter literally as shown. Italic Italic text represents arguments that you replace with actual values. [] Square brackets enclose syntax choices (keywords or arguments) that are optional. { x | y | ...
Network topology icons Represents a generic network device, such as a router, switch, or firewall. Represents a routing-capable device, such as a router or Layer 3 switch. Represents a generic switch, such as a Layer 2 or Layer 3 switch, or a router that supports Layer 2 forwarding and other Layer 2 features. Represents an access controller, a unified wired-WLAN module, or the switching engine on a unified wired-WLAN switch. Represents an access point.
Index BCDEFGHIJLMOPRSTV B display pim statistics,80 bsm-fragment enable (PIM view),62 E bsr-policy (PIM view),62 enable (IGMP-snooping view),13 C entry-limit (IGMP-snooping view),14 c-bsr (PIM view),63 F c-rp (PIM view),64 fast-leave (IGMP-snooping view),14 crp-policy (PIM view),65 G D group-policy (IGMP-snooping view),15 delete ip rpf-route-static,35 H display igmp group,53 hello-option dr-priority (PIM view),81 display igmp interface,55 hello-option holdtime (PIM view),82 display igm
igmp-snooping version,27 pim timer hello,96 ip rpf-route-static,46 pim timer join-prune,97 J pim triggered-hello-delay,97 jp-pkt-size (PIM view),85 R L register-policy (PIM view),98 register-whole-checksum (PIM view),99 last-member-query-interval (IGMP-snooping view),28 report-aggregation (IGMP-snooping view),30 load-splitting (MRIB view),47 reset igmp group,60 longest-match (MRIB view),47 reset igmp-snooping group,31 M reset igmp-snooping router-port,31 mac-address multicast,48 reset igm
