Ruckus FastIron Ethernet Switch IP Multicast Configuration Guide Version 08.0.30 Fast Iron 08030 Ipmulticastguide
FastIron 08.0.30 IP Multicast Configuration Guide fastiron-08030-ipmulticastguide
2017-12-14
User Manual: Ruckus FastIron 08.0.30 IP Multicast Configuration Guide
Open the PDF directly: View PDF .
Page Count: 194
Download | |
Open PDF In Browser | View PDF |
CONFIGURATION GUIDE FastIron Ethernet Switch IP Multicast Configuration Guide Supporting FastIron Software Release 08.0.30 53-1003626-03 23 May 2016 © 2016, Brocade Communications Systems, Inc. All Rights Reserved. Brocade, Brocade Assurance, the B-wing symbol, ClearLink, DCX, Fabric OS, HyperEdge, ICX, MLX, MyBrocade, OpenScript, VCS, VDX, Vplane, and Vyatta are registered trademarks, and Fabric Vision is a trademark of Brocade Communications Systems, Inc., in the United States and/or in other countries. Other brands, products, or service names mentioned may be trademarks of others. Notice: This document is for informational purposes only and does not set forth any warranty, expressed or implied, concerning any equipment, equipment feature, or service offered or to be offered by Brocade. Brocade reserves the right to make changes to this document at any time, without notice, and assumes no responsibility for its use. This informational document describes features that may not be currently available. Contact a Brocade sales office for information on feature and product availability. Export of technical data contained in this document may require an export license from the United States government. The authors and Brocade Communications Systems, Inc. assume no liability or responsibility to any person or entity with respect to the accuracy of this document or any loss, cost, liability, or damages arising from the information contained herein or the computer programs that accompany it. The product described by this document may contain open source software covered by the GNU General Public License or other open source license agreements. To find out which open source software is included in Brocade products, view the licensing terms applicable to the open source software, and obtain a copy of the programming source code, please visit http://www.brocade.com/support/oscd. 2 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 Contents Preface.......................................................................................................................................................................................................................................................................................... 9 Document conventions............................................................................................................................................................................................................................................. 9 Text formatting conventions......................................................................................................................................................................................................................... 9 Command syntax conventions................................................................................................................................................................................................................... 9 Notes, cautions, and warnings................................................................................................................................................................................................................... 10 Brocade resources..................................................................................................................................................................................................................................................... 10 Contacting Brocade Technical Support..........................................................................................................................................................................................................10 Brocade customers......................................................................................................................................................................................................................................... 10 Brocade OEM customers.............................................................................................................................................................................................................................. 11 Document feedback.................................................................................................................................................................................................................................................... 11 About This Document........................................................................................................................................................................................................................................................ 13 Supported hardware.................................................................................................................................................................................................................................................. 13 What’s new in this document................................................................................................................................................................................................................................13 How command information is presented in this guide..........................................................................................................................................................................14 IPv4 Multicast Traffic Reduction...................................................................................................................................................................................................................................15 PIM convergence on MAC movement...........................................................................................................................................................................................................15 IGMP snooping overview....................................................................................................................................................................................................................................... 15 Queriers and non-queriers...........................................................................................................................................................................................................................16 VLAN-specific configuration.......................................................................................................................................................................................................................17 Tracking and fast leave................................................................................................................................................................................................................................... 17 Support for IGMP snooping and Layer 3 multicast routing together on the same device.....................................................................................17 Forwarding mechanism in hardware...................................................................................................................................................................................................... 17 Hardware resources for IGMP and PIM-SM snooping.............................................................................................................................................................. 18 Configuration notes and feature limitations for IGMP snooping and Layer 3 multicast routing.........................................................................18 IGMP snooping configuration.............................................................................................................................................................................................................................. 19 IGMP snooping mcache entries and group addresses...............................................................................................................................................................19 IGMP snooping software resource limits.......................................................................................................................................................................................... 20 Changing the maximum number of supported IGMP snooping mcache entries..................................................................................................... 20 Setting the maximum number of IGMP group addresses......................................................................................................................................................20 Enabling IGMP snooping globally on the device..........................................................................................................................................................................20 Configuring the IGMP mode...................................................................................................................................................................................................................... 21 Configuring the IGMP version................................................................................................................................................................................................................. 22 Configuring static groups to specific ports....................................................................................................................................................................................... 22 Disabling IGMP snooping on a VLAN................................................................................................................................................................................................ 23 Modifying the age interval for group membership entries...................................................................................................................................................... 23 Modifying the query interval (active IGMP snooping mode only)....................................................................................................................................... 23 Modifying the maximum response time............................................................................................................................................................................................ 23 Configuring report control.......................................................................................................................................................................................................................... 24 Modifying the wait time before stopping traffic when receiving a leave message.................................................................................................... 24 Modifying the multicast cache age time.............................................................................................................................................................................................24 Enabling or disabling error and warning messages.....................................................................................................................................................................24 Configuring static router ports..................................................................................................................................................................................................................25 Turning off static group proxy.................................................................................................................................................................................................................. 25 Enabling IGMP V3 membership tracking and fast leave for the VLAN.......................................................................................................................... 25 Enabling fast leave for IGMP V2............................................................................................................................................................................................................ 26 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 3 Enabling fast convergence ........................................................................................................................................................................................................................26 IGMP snooping show commands...................................................................................................................................................................................................................26 Displaying the IGMP snooping configuration................................................................................................................................................................................. 26 Displaying IGMP snooping errors.......................................................................................................................................................................................................... 27 Displaying IGMP group information.....................................................................................................................................................................................................28 Displaying IGMP snooping mcache information.......................................................................................................................................................................... 29 Displaying software resource usage for VLANs........................................................................................................................................................................... 30 Displaying the status of IGMP snooping traffic............................................................................................................................................................................. 30 Displaying querier information...................................................................................................................................................................................................................31 Clear commands for IGMP snooping............................................................................................................................................................................................................34 Clearing the IGMP mcache........................................................................................................................................................................................................................34 Clearing the mcache on a specific VLAN..........................................................................................................................................................................................34 Clearing traffic on a specific VLAN....................................................................................................................................................................................................... 34 Clearing IGMP counters on VLANs......................................................................................................................................................................................................34 Disabling the flooding of unregistered IPv4 multicast frames in an IGMP-snooping-enabled VLAN................................................................... 35 PIM SM traffic snooping overview.................................................................................................................................................................................................................. 35 Application examples of PIM SM traffic snooping.......................................................................................................................................................................35 Configuration notes and limitations for PIM SM snooping......................................................................................................................................................37 PIM SM snooping configuration.......................................................................................................................................................................................................................38 Enabling or disabling PIM SM snooping........................................................................................................................................................................................... 38 Enabling PIM SM snooping on a VLAN............................................................................................................................................................................................ 39 Disabling PIM SM snooping on a VLAN...........................................................................................................................................................................................39 PIM SM snooping show commands..............................................................................................................................................................................................................39 Displaying PIM SM snooping information........................................................................................................................................................................................39 Displaying PIM SM snooping information on a Layer 2 switch...........................................................................................................................................39 Displaying PIM SM snooping information for a specific group or source group pair.............................................................................................40 IPv6 Multicast Traffic Reduction................................................................................................................................................................................................................................. 43 MLD snooping overview....................................................................................................................................................................................................................................... 43 Support for MLD snooping and Layer 3 IPv6 multicast routing together on the same device........................................................................ 44 Forwarding mechanism in hardware.................................................................................................................................................................................................... 44 Hardware resources for MLD and PIMv6 SM snooping......................................................................................................................................................... 45 MLD snooping configuration notes and feature limitations....................................................................................................................................................45 MLD snooping-enabled queriers and non-queriers................................................................................................................................................................... 46 MLD and VLAN configuration................................................................................................................................................................................................................. 47 MLDv1 with MLDv2........................................................................................................................................................................................................................................47 MLD snooping configuration.............................................................................................................................................................................................................................. 47 Configuring the hardware and software resource limits............................................................................................................................................................48 Configuring the global MLD mode....................................................................................................................................................................................................... 49 Modifying the age interval.......................................................................................................................................................................................................................... 49 Modifying the query interval (active MLD snooping mode only).........................................................................................................................................49 Configuring the global MLD version....................................................................................................................................................................................................50 Configuring report control.......................................................................................................................................................................................................................... 50 Modifying the wait time before stopping traffic when receiving a leave message....................................................................................................50 Modifying the multicast cache aging time........................................................................................................................................................................................ 50 Disabling error and warning messages................................................................................................................................................................................................ 51 Configuring the MLD mode for a VLAN............................................................................................................................................................................................. 51 Disabling MLD snooping for the VLAN...............................................................................................................................................................................................51 Configuring the MLD version for the VLAN......................................................................................................................................................................................51 Configuring the MLD version for individual ports........................................................................................................................................................................ 52 Configuring static groups............................................................................................................................................................................................................................52 4 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 Configuring static router ports..................................................................................................................................................................................................................52 Disabling static group proxy......................................................................................................................................................................................................................52 Enabling MLDv2 membership tracking and fast leave for the VLAN..............................................................................................................................53 Configuring fast leave for MLDv1...........................................................................................................................................................................................................53 Enabling fast convergence ....................................................................................................................................................................................................................... 53 Displaying MLD snooping information.........................................................................................................................................................................................................54 Displaying MLD snooping error information...................................................................................................................................................................................54 Displaying MLD group information...................................................................................................................................................................................................... 54 Displaying MLD snooping mcache information............................................................................................................................................................................56 Displaying status of MLD snooping traffic........................................................................................................................................................................................57 Displaying MLD snooping information by VLAN........................................................................................................................................................................ 58 Clearing MLD snooping counters and mcache....................................................................................................................................................................................... 59 Clearing MLD counters on all VLANs................................................................................................................................................................................................. 59 Clearing the mcache on all VLANs....................................................................................................................................................................................................... 59 Clearing the mcache on a specific VLAN..........................................................................................................................................................................................59 Clearing traffic counters on a specific VLAN.................................................................................................................................................................................. 59 Disabling the flooding of unregistered IPv6 multicast frames in an MLD-snooping-enabled VLAN.....................................................................60 PIM6 SM traffic snooping overview...............................................................................................................................................................................................................60 Application examples of PIM6 SM traffic snooping................................................................................................................................................................... 60 Configuration notes and limitations for PIM6 SM snooping..................................................................................................................................................62 PIM6 SM snooping configuration....................................................................................................................................................................................................................63 Enabling or disabling PIM6 SM snooping........................................................................................................................................................................................ 63 Enabling PIM6 SM snooping on a VLAN.........................................................................................................................................................................................64 Disabling PIM6 SM snooping on a VLAN........................................................................................................................................................................................64 PIM6 SM snooping show commands.......................................................................................................................................................................................................... 64 Displaying PIM6 SM snooping information.....................................................................................................................................................................................64 Displaying PIM6 SM snooping for a VLAN.....................................................................................................................................................................................65 IPv4 Multicast Protocols.................................................................................................................................................................................................................................................. 67 Overview of IP multicasting................................................................................................................................................................................................................................. 67 Multicast terms.................................................................................................................................................................................................................................................. 67 Support for Multicast Multi-VRF...................................................................................................................................................................................................................... 68 system-max command changes........................................................................................................................................................................................................... 68 Show and clear command support....................................................................................................................................................................................................... 68 Changing global IP multicast parameters....................................................................................................................................................................................................68 Concurrent support for multicast routing and snooping...........................................................................................................................................................69 Defining the maximum number of PIM cache entries...............................................................................................................................................................69 Defining the maximum number of IGMP group addresses................................................................................................................................................... 69 Changing IGMP V1 and V2 parameters..............................................................................................................................................................................................70 Adding an interface to a multicast group........................................................................................................................................................................................................71 Multicast non-stop routing....................................................................................................................................................................................................................................72 Configuration considerations.....................................................................................................................................................................................................................72 Configuring multicast non-stop routing..............................................................................................................................................................................................73 Displaying the multicast NSR status.....................................................................................................................................................................................................73 Passive multicast route insertion ..................................................................................................................................................................................................................... 74 Configuring PMRI............................................................................................................................................................................................................................................ 75 Displaying hardware-drop...........................................................................................................................................................................................................................75 IP multicast boundaries.......................................................................................................................................................................................................................................... 75 Configuration considerations.....................................................................................................................................................................................................................75 Configuring multicast boundaries...........................................................................................................................................................................................................76 Displaying multicast boundaries..............................................................................................................................................................................................................76 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 5 PIM Dense .....................................................................................................................................................................................................................................................................77 Initiating PIM multicasts on a network.................................................................................................................................................................................................. 77 Pruning a multicast tree................................................................................................................................................................................................................................ 77 Grafts to a multicast tree............................................................................................................................................................................................................................. 80 PIM DM versions...............................................................................................................................................................................................................................................81 Configuring PIM DM ......................................................................................................................................................................................................................................81 Failover time in a multi-path topology................................................................................................................................................................................................ 84 Configuring a DR priority............................................................................................................................................................................................................................ 84 Displaying basic PIM Dense configuration information............................................................................................................................................................84 Displaying all multicast cache entries in a pruned state............................................................................................................................................................ 85 Displaying all multicast cache entries.................................................................................................................................................................................................. 86 PIM convergence on MAC movement.........................................................................................................................................................................................................89 PIM Sparse .................................................................................................................................................................................................................................................................. 89 PIM Sparse device types............................................................................................................................................................................................................................ 90 RP paths and SPT paths...............................................................................................................................................................................................................................91 Configuring PIM Sparse................................................................................................................................................................................................................................ 91 ACL based RP assignment....................................................................................................................................................................................................................... 95 PIM convergence on MAC movement (PIM sparse mode)............................................................................................................................................................. 96 IP multicast PIM neighbor filter......................................................................................................................................................................................................................... 96 Limitations............................................................................................................................................................................................................................................................97 Configuring IPv4 PIM neighbor filtering.............................................................................................................................................................................................97 PIM Passive...................................................................................................................................................................................................................................................................97 Multicast Outgoing Interface (OIF) list optimization..............................................................................................................................................................................98 Displaying system values..................................................................................................................................................................................................................................... 98 Displaying PIM resources.....................................................................................................................................................................................................................................98 Displaying PIM Sparse configuration information and statistics..................................................................................................................................................100 Displaying basic PIM Sparse configuration information.........................................................................................................................................................100 Displaying a list of multicast groups................................................................................................................................................................................................... 102 Displaying BSR information.................................................................................................................................................................................................................... 103 Displaying candidate RP information.................................................................................................................................................................................................104 Displaying RP-to-group mappings.....................................................................................................................................................................................................105 Displaying RP Information for a PIM Sparse group.................................................................................................................................................................. 105 Displaying the RP set list...........................................................................................................................................................................................................................106 Displaying multicast neighbor information...................................................................................................................................................................................... 107 Displaying the PIM multicast cache....................................................................................................................................................................................................108 Displaying the PIM multicast cache for DIT.....................................................................................................................................................................................110 Clearing the PIM forwarding cache................................................................................................................................................................................................................... 111 Displaying PIM traffic statistics............................................................................................................................................................................................................................111 Clearing the PIM message counters...............................................................................................................................................................................................................113 Displaying PIM RPF.................................................................................................................................................................................................................................................113 Configuring Multicast Source Discovery Protocol (MSDP)...............................................................................................................................................................113 Peer Reverse Path Forwarding (RPF) flooding.............................................................................................................................................................................. 114 Source Active caching...................................................................................................................................................................................................................................115 Configuring MSDP..........................................................................................................................................................................................................................................115 Disabling an MSDP peer............................................................................................................................................................................................................................. 116 Designating the interface IP address as the RP IP address.................................................................................................................................................... 117 Filtering MSDP source-group pairs...................................................................................................................................................................................................... 117 Filtering incoming and outgoing Source-Active messages.................................................................................................................................................... 117 Filtering advertised Source-Active messages................................................................................................................................................................................ 119 Displaying MSDP information..................................................................................................................................................................................................................119 6 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 Displaying MSDP RPF-Peer.................................................................................................................................................................................................................. 124 Displaying MSDP Peer...............................................................................................................................................................................................................................124 Displaying MSDP VRF RPF-Peer.......................................................................................................................................................................................................125 Clearing MSDP information.....................................................................................................................................................................................................................125 Configuring MSDP mesh groups ..................................................................................................................................................................................................................126 Configuring MSDP mesh group............................................................................................................................................................................................................127 MSDP Anycast RP..................................................................................................................................................................................................................................................128 Configuring MSDP Anycast RP............................................................................................................................................................................................................ 128 Example...............................................................................................................................................................................................................................................................129 PIM Anycast RP........................................................................................................................................................................................................................................................132 Configuring PIM Anycast RP.................................................................................................................................................................................................................. 132 Static multicast routes........................................................................................................................................................................................................................................... 134 IGMP Proxy................................................................................................................................................................................................................................................................. 134 IGMP proxy configuration notes........................................................................................................................................................................................................... 135 IGMP proxy limitations................................................................................................................................................................................................................................135 Configuring IGMP Proxy............................................................................................................................................................................................................................135 Filtering groups in proxy report messages......................................................................................................................................................................................135 Displaying IGMP Proxy information....................................................................................................................................................................................................136 IGMP V3........................................................................................................................................................................................................................................................................137 Default IGMP version.................................................................................................................................................................................................................................. 138 Compatibility with IGMP V1 and V2.................................................................................................................................................................................................... 139 Globally enabling the IGMP version ...................................................................................................................................................................................................139 Enabling the IGMP version per interface setting ........................................................................................................................................................................ 139 Enabling the IGMP version on a physical port within a virtual routing interface .......................................................................................................139 Enabling membership tracking and fast leave.............................................................................................................................................................................. 140 Creating a static IGMP group..................................................................................................................................................................................................................140 Setting the query interval............................................................................................................................................................................................................................. 141 Setting the group membership time.....................................................................................................................................................................................................141 Setting the maximum response time................................................................................................................................................................................................... 141 Displaying IGMPv3 information............................................................................................................................................................................................................ 142 Clearing the IGMP group membership table ................................................................................................................................................................................143 Displaying static IGMP groups...............................................................................................................................................................................................................143 Clearing IGMP traffic statistics .............................................................................................................................................................................................................. 146 Source-specific multicast...........................................................................................................................................................................................................................147 Configuring PIM SSM group range..................................................................................................................................................................................................... 147 Configuring multiple SSM group ranges..........................................................................................................................................................................................148 IGMPv2 SSM mapping.............................................................................................................................................................................................................................. 149 IPv6 Multicast Protocols................................................................................................................................................................................................................................................ 153 IPv6 PIM Sparse ..................................................................................................................................................................................................................................................... 153 PIM Sparse router types............................................................................................................................................................................................................................ 154 RP paths and SPT paths............................................................................................................................................................................................................................154 RFC 3513 and RFC 4007 compliance for IPv6 multicast scope-based forwarding.............................................................................................154 Configuring PIM Sparse.............................................................................................................................................................................................................................155 IPv6 PIM-Sparse mode............................................................................................................................................................................................................................. 155 Configuring IPv6 PIM-SM on a virtual routing interface.........................................................................................................................................................155 Enabling IPv6 PIM-SM for a specified VRF.................................................................................................................................................................................. 155 Configuring BSRs .........................................................................................................................................................................................................................................156 Enabling Source-specific Multicast..................................................................................................................................................................................................... 162 Configuring a DR priority...........................................................................................................................................................................................................................162 Passive Multicast Route Insertion.........................................................................................................................................................................................................163 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 7 Displaying system values.......................................................................................................................................................................................................................... 164 Displaying PIM Sparse configuration information and statistics........................................................................................................................................ 164 Clearing the IPv6 PIM forwarding cache...........................................................................................................................................................................................177 Clearing the IPv6 PIM message counters........................................................................................................................................................................................ 177 Updating PIM Sparse forwarding entries witha new RP configuration............................................................................................................................ 177 Clearing the IPv6 PIM traffic ...................................................................................................................................................................................................................178 Defining the maximum number of IPv6 PIM cache entries.................................................................................................................................................. 178 Configuring a static multicast route within a VRF........................................................................................................................................................................ 178 Configuring the route precedence by specifying the route types.......................................................................................................................................179 Configuring IPv6 PIM neighbor filtering...........................................................................................................................................................................................180 IPv6 PIM convergence on MAC movement............................................................................................................................................................................................. 181 PIM Anycast RP......................................................................................................................................................................................................................................................... 181 Configuring PIM Anycast RP....................................................................................................................................................................................................................181 Multicast Listener Discovery and source-specific multicast protocols.....................................................................................................................................183 Enabling MLDv2............................................................................................................................................................................................................................................ 184 Configuring MLD parameters for default and non-default VRFs......................................................................................................................................184 Configuring MLD parameters at the interface level....................................................................................................................................................................187 Displaying MLD information................................................................................................................................................................................................................... 188 Clearing IPv6 MLD traffic..........................................................................................................................................................................................................................192 Clearing the IPv6 MLD group membership table cache........................................................................................................................................................ 192 IPv6 Multicast Boundaries..................................................................................................................................................................................................................................192 Configuration considerations...................................................................................................................................................................................................................193 Configuring multicast boundaries.........................................................................................................................................................................................................193 Displaying multicast boundaries............................................................................................................................................................................................................194 8 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 Preface ∙ ∙ ∙ ∙ Document conventions.....................................................................................................................................................................................................9 Brocade resources.............................................................................................................................................................................................................10 Contacting Brocade Technical Support................................................................................................................................................................. 10 Document feedback............................................................................................................................................................................................................11 Document conventions The document conventions describe text formatting conventions, command syntax conventions, and important notice formats used in Brocade technical documentation. Text formatting conventions Text formatting conventions such as boldface, italic, or Courier font may be used in the flow of the text to highlight specific words or phrases. Format Description bold text Identifies command names Identifies keywords and operands Identifies the names of user-manipulated GUI elements Identifies text to enter at the GUI italic text Identifies emphasis Identifies variables Identifies document titles Courier font Identifies CLI output Identifies command syntax examples Command syntax conventions Bold and italic text identify command syntax components. Delimiters and operators define groupings of parameters and their logical relationships. Convention Description bold text Identifies command names, keywords, and command options. italic text Identifies a variable. value In Fibre Channel products, a fixed value provided as input to a command option is printed in plain text, for example, --show WWN. [] Syntax components displayed within square brackets are optional. Default responses to system prompts are enclosed in square brackets. {x|y|z} A choice of required parameters is enclosed in curly brackets separated by vertical bars. You must select one of the options. In Fibre Channel products, square brackets may be used instead for this purpose. x|y A vertical bar separates mutually exclusive elements. <> Nonprinting characters, for example, passwords, are enclosed in angle brackets. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 9 Preface Convention Description ... Repeat the previous element, for example, member[member...]. \ Indicates a “soft” line break in command examples. If a backslash separates two lines of a command input, enter the entire command at the prompt without the backslash. Notes, cautions, and warnings Notes, cautions, and warning statements may be used in this document. They are listed in the order of increasing severity of potential hazards. NOTE A Note provides a tip, guidance, or advice, emphasizes important information, or provides a reference to related information. ATTENTION An Attention statement indicates a stronger note, for example, to alert you when traffic might be interrupted or the device might reboot. CAUTION A Caution statement alerts you to situations that can be potentially hazardous to you or cause damage to hardware, firmware, software, or data. DANGER A Danger statement indicates conditions or situations that can be potentially lethal or extremely hazardous to you. Safety labels are also attached directly to products to warn of these conditions or situations. Brocade resources Visit the Brocade website to locate related documentation for your product and additional Brocade resources. You can download additional publications supporting your product at www.brocade.com. Select the Brocade Products tab to locate your product, then click the Brocade product name or image to open the individual product page. The user manuals are available in the resources module at the bottom of the page under the Documentation category. To get up-to-the-minute information on Brocade products and resources, go to MyBrocade. You can register at no cost to obtain a user ID and password. Release notes are available on MyBrocade under Product Downloads. White papers, online demonstrations, and data sheets are available through the Brocade website. Contacting Brocade Technical Support As a Brocade customer, you can contact Brocade Technical Support 24x7 online, by telephone, or by e-mail. Brocade OEM customers contact their OEM/Solutions provider. Brocade customers For product support information and the latest information on contacting the Technical Assistance Center, go to http:// www.brocade.com/services-support/index.html. If you have purchased Brocade product support directly from Brocade, use one of the following methods to contact the Brocade Technical Assistance Center 24x7. 10 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 Preface Online Telephone E-mail Preferred method of contact for non-urgent issues: Required for Sev 1-Critical and Sev 2-High issues: support@brocade.com ∙ My Cases through MyBrocade ∙ Continental US: 1-800-752-8061 ∙ Software downloads and licensing tools ∙ Europe, Middle East, Africa, and Asia Pacific: +800-AT FIBREE (+800 28 34 27 33) ∙ Knowledge Base ∙ For areas unable to access toll free number: +1-408-333-6061 ∙ Toll-free numbers are available in many countries. Please include: ∙ Problem summary ∙ Serial number ∙ Installation details ∙ Environment description Brocade OEM customers If you have purchased Brocade product support from a Brocade OEM/Solution Provider, contact your OEM/Solution Provider for all of your product support needs. ∙ OEM/Solution Providers are trained and certified by Brocade to support Brocade® products. ∙ Brocade provides backline support for issues that cannot be resolved by the OEM/Solution Provider. ∙ Brocade Supplemental Support augments your existing OEM support contract, providing direct access to Brocade expertise. For more information, contact Brocade or your OEM. ∙ For questions regarding service levels and response times, contact your OEM/Solution Provider. Document feedback To send feedback and report errors in the documentation you can use the feedback form posted with the document or you can e-mail the documentation team. Quality is our first concern at Brocade and we have made every effort to ensure the accuracy and completeness of this document. However, if you find an error or an omission, or you think that a topic needs further development, we want to hear from you. You can provide feedback in two ways: ∙ Through the online feedback form in the HTML documents posted on www.brocade.com. ∙ By sending your feedback to documentation@brocade.com. Provide the publication title, part number, and as much detail as possible, including the topic heading and page number if applicable, as well as your suggestions for improvement. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 11 Preface 12 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 About This Document ∙ ∙ ∙ Supported hardware..........................................................................................................................................................................................................13 What’s new in this document........................................................................................................................................................................................13 How command information is presented in this guide................................................................................................................................. 14 Supported hardware This guide supports the following product families from Brocade: ∙ FCX Series ∙ FastIron X Series (FSX 800 and FSX 1600) ∙ ICX 6610 Series ∙ ICX 6430 Series (ICX 6430, ICX 6430-C12) ∙ ICX 6450 Series (ICX 6450, ICX 6450-C12-PD) ∙ ICX 6650 Series ∙ ICX 7750 Series ∙ ICX 7450 Series ∙ ICX 7250 Series NOTE The Brocade ICX 6430-C switch supports the same feature set as the Brocade ICX 6430 switch unless otherwise noted. NOTE The Brocade ICX 6450-C12-PD switch supports the same feature set as the Brocade ICX 6450 switch unless otherwise noted. What’s new in this document This summarizes the new information added to this guide for Version 08.0.30 of the latest FastIron software release. TABLE 1 Summary of enhancements in FastIron Release 08.0.30 Feature Description Location Disable flooding in VLAN. Support was added for disabling the flooding of unregistered IPv4 and IPv6 multicast frames. See the sections “IPv4 Multicast Traffic Reduction,” and “IPv6 Multicast Traffic Reduction” and the FastIron Command Reference. PIM convergence on MAC movement Reverse Path Forwarding (RPF) check is triggered on MAC movement for directly connected sources and sends MAC address movement notification to the Protocol Independent Multicast (PIM) module which results in PIM convergence. See the sections PIM convergence on MAC movement on page 15 and IPv6 PIM convergence on MAC movement on page 181. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 13 About This Document How command information is presented in this guide For all new content supported in FastIron Release 08.0.20 and later, command information is documented in a standalone command reference guide. In an effort to provide consistent command line interface (CLI) documentation for all products, Brocade is in the process of completing a standalone command reference for the FastIron platforms. This process involves separating command syntax and parameter descriptions from configuration tasks. Until this process is completed, command information is presented in two ways: ∙ For all new content supported in FastIron Release 08.0.20 and later, the CLI is documented in separate command pages included in the FastIron Command Reference. Command pages are compiled in alphabetical order and follow a standard format to present syntax, parameters, usage guidelines, examples, and command history. NOTE Many commands from previous FastIron releases are also included in the command reference. ∙ Legacy content in configuration guides continues to include command syntax and parameter descriptions in the chapters where the features are documented. If you do not find command syntax information embedded in a configuration task, refer to the FastIron Command Reference. 14 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ PIM convergence on MAC movement.................................................................................................................................................................. 15 IGMP snooping overview...............................................................................................................................................................................................15 IGMP snooping configuration......................................................................................................................................................................................19 IGMP snooping show commands...........................................................................................................................................................................26 Clear commands for IGMP snooping................................................................................................................................................................... 34 Disabling the flooding of unregistered IPv4 multicast frames in an IGMP-snooping-enabled VLAN...........................35 PIM SM traffic snooping overview..........................................................................................................................................................................35 PIM SM snooping configuration.............................................................................................................................................................................. 38 PIM SM snooping show commands..................................................................................................................................................................... 39 PIM convergence on MAC movement PIM convergence occurs when the PIM module is notified of a topology change. The notification is triggered upon a change in port status, Reverse Path Forwarding (RPF) failure in the hardware, or by the unicast routing module if there is a change in the Layer 3 topology. If the topology change occurs without setting off any of the two events or if the Layer 3 topology change is not notified by the unicast routing module, PIM convergence does not take place. If there is a change in the source traffic at the Layer 2 interface level, the RPF check fails because only loose RPF check is supported (loose RPF check detects the change in the source traffic only at the Layer 3 interface level). A notification for a change in the source traffic at the Layer 2 interface level can be triggered by establishing a signaling process for MAC address movement. The MAC address movement notification triggers RPF check on MAC movement for directly connected sources. The MAC address movement notification can be triggered by configuring the ip multicast-routing rpf-check mac-movement command. The MAC address movement notification triggers a notification to the PIM module which results in convergence. PIM convergence is supported in both PIM Sparse and PIM Dense modes. PIM convergence on MAC movement is supported on the Brocade ICX 6610, FCX, Brocade ICX 6450 (when part of family stacking), Brocade ICX 7750, and Brocade ICX 7450. NOTE PIM convergence on MAC movement is applicable only in a topology where the multicast source port and PIM routers are in the same Layer 2 domain. IGMP snooping overview When a device processes a multicast packet, by default, it broadcasts the packets to all ports except the incoming port of a VLAN. Packets are flooded by hardware without going to the CPU. This behavior causes some clients to receive unwanted traffic. IGMP snooping provides multicast containment by forwarding traffic to only the ports that have IGMP receivers for a specific multicast group (destination address). A device maintains the IGMP group membership information by processing the IGMP reports and leave messages, so traffic can be forwarded to ports receiving IGMP reports. An IPv4 multicast address is a destination address in the range of 224.0.0.0 to 239.255.255.255. Addresses of 224.0.0.X are reserved. Because packets destined for these addresses may require VLAN flooding, devices do not snoop in the reserved range. Data packets destined to addresses in the reserved range are flooded to the entire VLAN by hardware, and mirrored to the CPU. Multicast data packets destined for the non-reserved range of addresses are snooped. A client must send IGMP reports in order to receive traffic. An IGMP device's responsibility is to broadcast general queries periodically, and to send group queries when receiving a leave message, to confirm that none of the clients on the port still want specific traffic before removing the traffic from the port. IGMP V2 lets clients FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 15 IPv4 Multicast Traffic Reduction specify what group (destination address) will receive the traffic but not to specify the source of the traffic. IGMP V3 is for source-specific multicast traffic, adding the capability for clients to INCLUDE or EXCLUDE specific traffic sources. An IGMP V3 device port state could be INCLUDE or EXCLUDE, and there are different types of group records for client reports. The interfaces respond to general or group queries by sending a membership report that contains one or more of the following records associated with a specific group: ∙ Current-state record that indicates from which sources the interface wants to receive and not receive traffic. This record contains the source address of interfaces and whether or not traffic will be included (IS_IN) or not excluded (IS_EX) from this source. ∙ Filter-mode-change record. If the interface state changes from IS_IN to IS_EX, a TO_EX record is included in the membership report. Likewise, if the interface state changes from IS_EX to IS_IN, a TO_IN record appears in the membership report. ∙ An IGMP V2 leave report is equivalent to a TO_IN (empty) record in IGMP V3. This record means that no traffic from this group will be received regardless of the source. ∙ An IGMP V2 group report is equivalent to an IS_EX (empty) record in IGMP V3. This record means that all traffic from this group will be received regardless of source. ∙ Source-list-change record. If the interface wants to add or remove traffic sources from its membership report, the report can contain an ALLOW record, which includes a list of new sources from which the interface wishes to receive traffic. It can also contain a BLOCK record, which lists the current traffic sources from which the interface wants to stop receiving traffic. IGMP protocols provide a method for clients and a device to exchange messages, and let the device build a database indicating which port wants what traffic. The protocols do not specify forwarding methods. They require IGMP snooping or multicast protocols such as PIM to handle packet forwarding. PIM can route multicast packets within and outside a VLAN, while IGMP snooping can switch packets only within a VLAN. If a VLAN is not IGMP snooping-enabled, it floods multicast data and control packets to the entire VLAN in hardware. When snooping is enabled, IGMP packets are trapped to the CPU. Data packets are mirrored to the CPU in addition to being VLAN flooded. The CPU then installs hardware resources, so that subsequent data packets can be switched to desired ports in hardware without going to the CPU. If there is no client report or port to queriers for a data stream, the hardware resource drops it. Queriers and non-queriers An IGMP snooping-enabled Brocade device can be configured as a querier (active) or non-querier (passive). An IGMP querier sends queries; a non-querier listens for IGMP queries and forwards them to the entire VLAN. VLANs can be independently configured to be queriers or non-queriers. If a VLAN has a connection to a PIM-enabled port on another router, the VLAN must be configured as a nonquerier. When multiple IGMP snooping devices are connected together, and there is no connection to a PIM-enabled port, one of the devices must be configured as a querier. If multiple devices are configured as queriers, after these devices exchange queries, then all except the winner stop sending queries. The device with the lowest address becomes the querier. Although the system will work when multiple devices are configured as queriers, Brocade recommends that only one device (preferably the one with the traffic source) is configured as a querier. The non-queriers always forward multicast data traffic and IGMP messages to router ports which receive IGMP queries or PIM hellos. Brocade recommends that you configure the device with the data traffic source (server) as a querier. If a server is attached to a nonquerier, the non-querier always forwards traffic to the querier regardless of whether there are any clients on the querier. NOTE In a topology of one or more connecting devices, at least one device must be running PIM configured as active. Otherwise, none of the devices can send out queries, and traffic cannot be forwarded to clients. 16 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction VLAN-specific configuration IGMP snooping can be enabled on some VLANs or on all VLANs. Each VLAN can be independently configured to be a querier or nonquerier and can be configured for IGMP V2 or IGMP V3. In general, the ip multicast commands apply globally to all VLANs except those configured with VLAN-specific multicast commands. The VLAN-specific multicast commands supersede the global ip multicast commands. IGMP snooping can be configured for IGMP V2 or IGMP V3 on individual ports of a VLAN. An interface or router sends the queries and reports that include its IGMP version specified on it. The version configuration only applies to sending queries. The snooping device recognizes and processes IGMP V2 and IGMP V3 packets regardless of the version configuration. To avoid version deadlock, an interface retains its version configuration even when it receives a report with a lower version. Tracking and fast leave Brocade devices support fast leave for IGMP V2, and tracking and fast leave for IGMP V3. Fast leave stops the traffic immediately when the port receives a leave message. Tracking traces all IGMP V3 clients. Refer to Enabling IGMP V3 membership tracking and fast leave for the VLAN on page 25 and Enabling fast leave for IGMP V2 on page 26. Support for IGMP snooping and Layer 3 multicast routing together on the same device The Brocade device supports global Layer 2 IP multicast traffic reduction (IGMP snoopoing) and Layer 3 multicast routing (PIM-Sparse or PIM-Dense) together on the same device in the full Layer 3 software image, as long as the Layer 2 feature configuration is at the VLAN level. Forwarding mechanism in hardware IP-based forwarding implementation on FCX and ICX devices The following information about *,G or S,G fdb-based implementation is specific to FCX, ICX 6610, ICX 6430, and ICX 6450 devices. On both switch and router software images, IGMP snooping is either *,G based or S,G based. The hardware can either match the group address only (* G), or both the source and group (S, G) of the data stream. This is 32-bit IP address matching, not 23-bit multicast MAC address 01-00-5e-xx-xx-xx matching. When any port in a VLAN is configured for IGMP v3, the VLAN matches both source and group (S, G) in hardware switching. If no ports are configured for IGMP v3, the VLAN matches group only (* G). Matching (S, G) requires more hardware resources than matching (* G) when there are multiple servers sharing the same group. For example, two data streams from different sources to the same group require two (S, G) entries in IGMP v3, but only one (* G) entry in IGMP v2. To conserve resources, IGMP v3 must be used only in source-specific applications. When VLANs are independently configured for versions, some VLANs can match (* G) while others match (S, G). MAC-based forwarding implementation on FastIron X Series devices On both switch and router software images, IGMP snooping is MAC-based. This differs from IGMP snooping on the BigIron router images, which match on both IP source and group (S,G) entries programmed in the Layer 4 CAM. This differs from IGMP snooping on the FastIron FCX/ICX router images, which match on both IP source and group (S,G) entries. In contrast, the FastIron X Series images match on Layer 2 23-bit multicast MAC address i.e. 01-00-5e-xx-xx-xx (*,G) entries. In addition, the lowest 23 bits of the group address are mapped to a MAC address. In this way, multiple groups (for example, 224.1.1.1 and 225.1.1.1) have the same MAC address. Groups having the same MAC address are switched to the same destination ports, which are FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 17 IPv4 Multicast Traffic Reduction the superset of individual group output ports. Thus, the use of Layer 2 CAM might cause unwanted packets to be sent to some ports. However, the switch generally needs far less layer 2 mac entries than it does for IP-based forwarding, which is required for each stream with a different source and group. Hardware resources for IGMP and PIM-SM snooping Brocade devices allocate/program fdb/mac entries and application VLAN (vidx) to achieve multicast snooping in hardware. If a data packet does not match any of these resources, it might be sent to the CPU, which increases the CPU burden. This can happen if the device runs out of hardware resources, or is unable to install resources for a specific matching address due to a hashing collision. The hardware hashes addresses into available fdb/mac entries, with some addresses hashed into the same entry. If the collision number in an entry is more than the hardware chain length, the resource cannot be installed. Configuration notes and feature limitations for IGMP snooping and Layer 3 multicast routing The following notes apply to all devices: ∙ Layer 2 IGMP multicast is automatically enabled with Layer 3 multicast routing. If Layer 3 multicast routing is enabled on your system, do not attempt to enable Layer 2 IGMP snooping. ∙ The default IGMP version is V2. ∙ A user can configure the maximum numbers of group address entries. ∙ An IGMP device can be configured to rate-limit the forwarding IGMP V2 membership reports to queriers. ∙ The device supports static groups. The device acts as a proxy to send IGMP reports for the static groups when receiving queries. ∙ A user can configure static router ports to force all multicast traffic to these specific ports. ∙ If a VLAN has a connection to a PIM-enabled port on another router, the VLAN must be configured as a non-querier (passive). When multiple snooping devices connect together and there is no connection to PIM ports, one device must be configured as a querier (active). If multiple devices are configured as active (queriers), only one will keep sending queries after exchanging queries. ∙ The querier must configure an IP address to send out queries. ∙ IGMP snooping requires hardware resource. Hardware resource is installed only when there is data traffic. If resource is inadequate, the data stream without a resource is mirrored to the CPU in addition to being VLAN flooded, which can cause high CPU usage. Brocade recommends that you avoid global enabling of snooping unless necessary. ∙ IGMP snooping requires clients to send membership reports in order to receive data traffic. If a client application does not send reports, you must configure static groups on the snooping VLAN to force traffic to client ports. Note that servers (traffic sources) are not required to send IGMP memberships. ∙ Support for VSRP together with IGMP snooping on the same interface. ∙ When VSRP or VSRP-aware is configured on a VLAN, only IGMP version 2 is recommended; IGMP version 3 is not recommended. ∙ Each VLAN can independently enable or disable IGMP, or configure IGMP v2 or IGMP v3. ∙ IGMP/PIM-SM snooping over Multi-Chassis Trunking is supported on FSX 800, FSX 1600, ICX 6650, and ICX 7750 devices. The following details apply to FCX, ICX 6610, ICX 6430, ICX 6450, and ICX 6650 devices: ∙ 18 Using the drop option, you can configure a static group that can discard multicast data packets to a specified group in hardware, including addresses in the reserved range. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction The following details apply to FastIron X Series devices: ∙ High CPU utilization occurs when IGMP Snooping and PIM routing are enabled simultaneously, and if the ingressing VLAN of the snooping traffic has "router-interface" configuration. With this configuration, IP Multicast data packets received in the snooping VLANs are forwarded to client ports via the hardware; however, copies of these packets are received and dropped by the CPU. IGMP snooping configuration Configuring IGMP snooping on a Brocade device consists of the following global, VLAN-specific, and port-specific tasks: Perform the following global IGMP snooping tasks: ∙ Configuring the IGMP V3 snooping software resource limits ∙ Enabling IGMP snooping globally on the device ∙ Configuring the global IGMP mode ∙ Configuring the global IGMP version ∙ Modifying the age interval for group membership entries ∙ Modifying the query interval (active IGMP snooping mode only) ∙ Modifying the maximum response time ∙ Configuring report control (rate limiting) ∙ Modifying the wait time before stopping traffic when receiving a leave message ∙ Modifying the multicast cache age time ∙ Enabling or disabling error and warning messages Perform the following VLAN-specific IGMP snooping tasks: ∙ Configuring the IGMP mode for a VLAN (active or passive) ∙ Disabling IGMP snooping on a VLAN ∙ Configuring the IGMP version for a VLAN ∙ Configuring static router ports ∙ Turning off static group proxy ∙ Enabling IGMP V3 membership tracking and fast leave for the VLAN ∙ Enabling fast leave for IGMP ∙ Enabling fast convergence Perform the following port-specific IGMP snooping task: ∙ Configuring the IGMP version for individual ports in a VLAN IGMP snooping mcache entries and group addresses An IGMP snooping group address entry is created when an IGMP join message is received for a group. An IGMP snooping mcache entry is created when data traffic is received for that group. Each mcache entry represents one data stream, and multiple mcache entries (up to 32) can share the same hardware (MAC) address entry. The egress port list for the mcache entry is obtained from the IGMP group address entry. If there is no existing IGMP group address entry when an mcache entry is created, data traffic for that multicast group is dropped in hardware. If there is an existing IGMP group address entry when an mcache is created, data traffic for that multicast group is switched in hardware. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 19 IPv4 Multicast Traffic Reduction IGMP snooping software resource limits These are the IGMP snooping mcache resource limits for Brocade devices. ∙ FCX, FSX, ICX 6610, and ICX 6450 devices support up to 8192 IGMP snooping mcache entries. ∙ ICX 6430 devices support up to 2048 IGMP snooping mcache entries. ∙ ICX 6650 devices support 8192 IGMP snooping mcache entries. ∙ ICX 7750 switches support 8192 IGMP snooping mcache entries. ∙ ICX 7750 routers support 6K IGMP snooping mcache entries. ∙ ICX 7250 devices support 8192 IGMP snooping mcache entries. ∙ ICX 7450 devices support 8192 IGMP snooping mcache entries. Changing the maximum number of supported IGMP snooping mcache entries You can configure the system-max igmp-snoop-mcache command to change the maximum number of IGMP snooping cache entries supported on a device. Device(config)#system-max igmp-snoop-mcache 2000 Syntax: [no] system-max igmp-snoop-mcache num The num variable is a value from 256 through 8192. The default is 512. Setting the maximum number of IGMP group addresses The configured number of IGMP group addresses is the upper limit of an expandable database. Client memberships exceeding the group limit are not processed. Configure the system-max igmp-snoop-group-addr command to define the maximum number of IGMP group addresses. Device(config)#system-max igmp-snoop-group-addr 1600 Syntax: [no] system-max igmp-snoop-group-addr num The num variable is a value from 256 to 8192. The default for IGMP snooping group addresses is 4096, except for ICX 6430 devices where the default is 1024. Enabling IGMP snooping globally on the device When you globally enable IGMP snooping, you can specify IGMP V2 or IGMP V3. The ip multicast version command enables IGMP V3. device(config)#ip multicast version 3 Syntax: [no] ip multicast version [2 | 3] If you do not specify a version number, IGMP V2 is assumed. Configuration notes for Layer 3 devices 20 ∙ If Layer 3 multicast routing is enabled on your system, do not attempt to enable Layer 2 IGMP snooping. Layer 2 IGMP snooping is automatically enabled with Layer 3 multicast routing. ∙ If the "route-only" feature is enabled on the Layer 3 Switch, then IP multicast traffic reduction will not be supported. ∙ IGMP snooping is not supported on the default VLAN of Layer 3 Switches. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction Disabling the flooding of unregistered IPv6 multicast frames in an MLD-snooping-enabled VLAN NOTE Disabling the flooding of unregistered IPv6 multicast frames in an MLD-snooping-enabled VLAN is supported only on the following platforms: ∙ The Brocade ICX 6650 ∙ The Brocade ICX 7750 (standalone and stacking) Support for this feature on the Brocade ICX 7750 was introduced in FastIron 8.0.10d. In releases prior to FastIron 8.0.30, support for this feature on the Brocade ICX 7750 was for devices in standalone mode only. To disable the flooding of unregistered IPv6 multicast frames in an MLD-snooping-enabled VLAN, use the ipv6 multicast disableflooding command in global configuration mode. The following example disables flooding of unregistered IPv6 multicast frames. Device(config)# ipv6 multicast disable-flooding Configuring the IGMP mode You can configure active or passive IGMP modes on the Brocade device. The default mode is passive. If you specify an IGMP mode for a VLAN, it overrides the global setting. ∙ Active - When active IGMP mode is enabled, a Brocade device actively sends out IGMP queries to identify multicast groups on the network, and makes entries in the IGMP table based on the group membership reports it receives. NOTE Routers in the network generally handle this operation. Use the active IGMP mode only when the device is in a stand-alone Layer 2 Switched network with no external IP multicast router attachments. In this case, enable the active IGMP mode on only one of the devices and leave the other devices configured for passive IGMP mode. ∙ Passive - When passive IGMP mode is enabled, it forwards reports to the router ports which receive queries. IGMP snooping in the passive mode does not send queries. However, it forwards queries to the entire VLAN. Configuring the global IGMP mode To globally set the IGMP mode to active, enter the following command. device(config)#ip multicast active Syntax: [no] ip multicast [ active | passive ] If you do not enter either active or passive, the passive mode is assumed. Configuring the IGMP mode for a VLAN If you specify an IGMP mode for a VLAN, it overrides the global setting. To set the IGMP mode for VLAN 20 to active, enter the following commands. device(config)#vlan 20 device(config-vlan-20)#multicast active Syntax: [no] multicast [ active | passive] FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 21 IPv4 Multicast Traffic Reduction Configuring the IGMP version Use the procedures in this section to specify the IGMP version. Configuring the global IGMP version To globally specify IGMP V2 or IGMP V3, refer to Enabling IGMP snooping globally on the device on page 20. Configuring the IGMP version for a VLAN You can specify the IGMP version for a VLAN. For example, the following commands configure VLAN 20 to use IGMP V3. device(config)#vlan 20 device(config-vlan-20)#multicast version 3 Syntax: [no] multicast version [2 | 3 ] If no IGMP version is specified, then the globally-configured IGMP version is used. If an IGMP version is specified for individual ports, those ports use that version, instead of the VLAN version. Configuring the IGMP version for individual ports in a VLAN You can specify the IGMP version for individual ports in a VLAN. For example, the following commands configure ports 1/2/4, 1/2/5, and 1/2/6 to use IGMP V3. The other ports either use the IGMP version specified with the multicast version command, or the globallyconfigured IGMP version. device(config)#vlan 20 device(config-vlan-20)#multicast port-version 3 ethernet 1/2/4 to 1/2/6 Syntax: [no] multicast port-version [2 | 3 ] ethernetunit/slot/port [ethernet unit/slot/port| tounit/slot/port] To specify a list of ports, enter each port as ethernetunit/slot/port followed by a space. For example, ethernet 1/1/24 ethernet 1/3/24 ethernet 1/4/17. To specify a range of ports, enter the first port in the range as ethernetport followed by the last port in the range. For example, ethernet 1/1/1 to 1/1/8. You can combine lists and ranges in the same command. For example: enable ethernet 1/1/1 to 1/1/8 ethernet 1/1/24 ethernet 1/4/24 ethernet 1/4/17. Configuring static groups to specific ports A snooping-enabled VLAN cannot forward multicast traffic to ports that do not receive IGMP membership reports. If clients cannot send reports, you can configure a static group which applies to specific ports. The static group allows packets to be forwarded to the static group ports even though they have no client membership reports. device(config)#vlan 20 device(config-vlan-20)#multicast static-group 224.1.1.1 count 2 ethernet 1/1/3 ethernet 1/1/5 to 1/1/7 Information specific to FCX and ICX devices The following information about the drop option is specific to FCX, ICX 6610, ICX 6430, ICX 6450, and ICX 6650 devices. The static group drop option discards data traffic to a group in hardware. The group can be any multicast group including groups in the reserved range of 224.0.0.X. The drop option does not apply to IGMP packets, which are always trapped to CPU when snooping is 22 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction enabled. The drop option applies to the entire VLAN, and cannot be configured for a port list. When the drop option is not specified, the group must exist outside the reserved range. device(config-vlan-20)#multicast static-group 239.1.1.1 count 3 drop Syntax: [no] multicast static-group ipv4-address [ count num ] [ unit/slot/port | drop ] The ipv4-address parameter is the address of the multicast group. The count is optional, which allows a contiguous range of groups. Omitting the count num is equivalent to the count being 1. Disabling IGMP snooping on a VLAN When IGMP snooping is enabled globally, you can still disable it for a specific VLAN. For example, the following commands cause IGMP snooping to be disabled for VLAN 20. This setting overrides the global setting. device(config)#vlan 20 device(config-vlan-20)#multicast disable-multicast-snoop Syntax: [no] multicast disable-multicast-snoop Modifying the age interval for group membership entries When the device receives a group membership report, it makes an entry for that group in the IGMP group table. The age interval specifies how long the entry can remain in the table before the device receives another group membership report. When multiple devices connect together, all devices must be configured for the same age interval, which must be at least twice the length of the query interval, so that missing one report won't stop traffic. Non-querier age intervals must be the same as the age interval of the querier. To modify the age interval, enter the following command. device(config)#ip multicast age-interval 280 Syntax: [no] ip multicast age-interval interval The interval parameter specifies the aging time. You can specify a value from 20 through 26000 seconds. The default is 260 seconds. Modifying the query interval (active IGMP snooping mode only) If IP multicast traffic reduction is set to active mode, you can modify the query interval to specify how often the device sends general queries. When multiple queriers connect together, they must all be configured with the same query interval. To modify the query interval, enter the following command. device(config)#ip multicast query-interval 120 Syntax: [no] ip multicast query-intervalinterval The interval parameter specifies the time between queries. You can specify a value from 10 through 3600 seconds. The default is 125 seconds. Modifying the maximum response time The maximum response time is the number of seconds that a client can wait before responding to a query sent by the switch. To change the maximum response time, enter the following command. device(config)#ip multicast max-response-time 5 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 23 IPv4 Multicast Traffic Reduction Syntax: [no] ip multicast max-response-time interval For interval , enter a value from 1 through 10 seconds. The default is 10 seconds. Configuring report control A device in passive mode forwards reports and leave messages from clients to the upstream router ports that are receiving queries. You can configure report control to rate-limit report forwarding within the same group to no more than once every 10 seconds. This ratelimiting does not apply to the first report answering a group-specific query. NOTE This feature applies to IGMP V2 only. The leave messages are not rate limited. IGMP V2 membership reports of the same group from different clients are considered to be the same and are rate-limited. Use the ip multicast report-control command to alleviate report storms from many clients answering the upstream router query. device(config)#ip multicast report-control Syntax: [no] ip multicast-report-control The original command, ip igmp-report-control , has been renamed to ip multicast report-control . The original command is still accepted; however, it is renamed when you configure a show configuration command. Modifying the wait time before stopping traffic when receiving a leave message You can define the wait time before stopping traffic to a port when a leave message is received. The device sends group-specific queries once per second to ask if any client in the same port still needs this group. Due to internal timer granularity, the actual wait time is between n and (n+1) seconds (n is the configured value). device(config)#ip multicast leave-wait-time 1 Syntax: [no] ip multicast leave-wait-timenum num is the number of seconds from 1 through 5. The default is 2 seconds. Modifying the multicast cache age time You can set the time for an mcache to age out when it does not receive traffic. The traffic is hardware switched. One minute before aging out an mcache, the device mirrors a packet of this mcache to CPU to reset the age. If no data traffic arrives within one minute, this mcache is deleted. A lower value quickly removes resources consumed by idle streams, but it mirrors packets to CPU often. A higher value is recommended only data streams are continually arriving. device(config)#ip multicast mcache-age 180 Syntax: [no] ip multicast mcache-age num num is the number of seconds from 60 through 3600. The default is 60 seconds. Enabling or disabling error and warning messages The device prints error or warning messages when it runs out of software resources or when it receives packets with the wrong checksum or groups. These messages are rate-limited. You can turn off these messages by entering the following command. device(config)#ip multicast verbose-off 24 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction Syntax: [no] ip multicast verbose-off Configuring static router ports The Brocade device forwards all multicast control and data packets to router ports which receive queries. Although router ports are learned, you can force multicast traffic to specified ports even though these ports never receive queries. To configure static router ports, enter the following commands. device(config)#vlan 70 device(config-vlan-70)#multicast router-port ethernet 1/1/4 to 1/1/5 ethernet 1/1/8 Syntax: [no] multicast router-port ethernet unit/slot/port [ ethernet unit/slot/port | to unit/slot/port ] To specify a list of ports, enter each port as ethernet unit/slot/port followed by a space. For example, ethernet 1/1/24 ethernet 1/2//17 ethernet 1/4/24. To specify a range of ports, enter the first port in the range as ethernet unit/slot/port followed by the last port in the range. For example, ethernet 1/1/1 to 1/1/8. You can combine lists and ranges in the same command. For example, enable ethernet 1/1/1 to 1/1/8 ethernet 1//1/24 ethernet 1/2/17 ethernet 1/4/24 . Turning off static group proxy If a device has been configured for static groups, it acts as a proxy and sends membership reports for the static groups when it receives general or group-specific queries. When a static group configuration is removed, it is deleted from the active group table immediately. However, leave messages are not sent to the querier, and the querier must age out the group. Proxy activity can be turned off. The default is on. To turn proxy activity off for VLAN 20, enter the following commands. device(config)#vlan 20 device(config-vlan-20)#multicast proxy-off Syntax: [no] multicast proxy-off Enabling IGMP V3 membership tracking and fast leave for the VLAN IGMP V3 gives clients membership tracking and fast leave capability. In IGMP V2, only one client on an interface needs to respond to a router's queries. This can leave some clients invisible to the router, making it impossible to track the membership of all clients in a group. When a client leaves the group, the device sends group-specific queries to the interface to see if other clients on that interface need the data stream of the client who is leaving. If no client responds, the device waits a few seconds before it stops the traffic. You can configure the wait time using the ip multicast leave-wait-time command. IGMP V3 requires every client to respond to queries, allowing the device to track all clients. When tracking is enabled, and an IGMP V3 client sends a leave message and there is no other client, the device immediately stops forwarding traffic to the interface. This feature requires the entire VLAN be configured for IGMP V3 with no IGMP V2 clients. If a client does not send a report during the specified group membership time (the default is 260 seconds), that client is removed from the tracking list. Every group on a physical port keeps its own tracking record. However, it can only track group membership; it cannot track by (source, group). For example, Client A and Client B belong to group1 but each receives traffic streams from different sources. Client A receives a stream from (source_1, group1) and Client B receives a stream from (source_2, group1). The device still waits for the configured leavewait-time before it stops the traffic because these two clients are in the same group. If the clients are in different groups, then the waiting period is not applied and traffic is stopped immediately. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 25 IPv4 Multicast Traffic Reduction To enable the tracking and fast leave feature for VLAN 20, enter the following commands. device(config)#vlan 20 device(config-vlan-20)#multicast tracking Syntax: [no] multicast tracking The membership tracking and fast leave features are supported for IGMP V3 only. If any port or any client is not configured for IGMP V3, then the multicast tracking command is ignored. Enabling fast leave for IGMP V2 When a device receives an IGMP V2 leave message, it sends out multiple group-specific queries. If no other client replies within the waiting period, the device stops forwarding traffic. When fast-leave-v2 is configured, and when the device receives a leave message, it immediately stops forwarding to that port. The device does not send group specific-queries. When fast-leave-v2 is configured on a VLAN, you must not have multiple clients on any port that is part of the VLAN. In a scenario where two devices connect, the querier device should not be configured for fast-leave-v2 because the port might have multiple clients through the non-querier. The number of queries, and the waiting period (in seconds) can be configured using the ip multicast leave-wait-time command. The default is 2 seconds. To configure fast leave for IGMP V2, enter the following commands. device(config)#vlan 20 device(config-vlan-20)#multicast fast-leave-v2 Syntax: [no] multicast fast-leave-v2 Enabling fast convergence In addition to sending periodic general queries, an active device sends general queries when it detects a new port. However, because the device does not recognize the other device's port up event, multicast traffic might still require up to the query-interval time to resume after a topology change. Fast convergence allows the device to listen to topology change events in Layer 2 protocols such as spanning tree, and then send general queries to shorten the convergence time. If the Layer 2 protocol cannot detect a topology change, fast convergence may not work in some cases. For example, if the direct connection between two devices switches from one interface to another, the rapid spanning tree protocol (802.1w) considers this optimization, rather than a topology change. In this example, other devices will not receive topology change notifications, and will be unable to send queries to speed up the convergence. Fast convergence works well with the regular spanning tree protocol in this case. To enable fast-convergency, enter the following commands. device(config)#vlan 70 device(config-vlan-70)#multicast fast-convergence Syntax: multicast fast-convergence IGMP snooping show commands This section describes the show commands for IGMP snooping. Displaying the IGMP snooping configuration To display the global IGMP snooping configuration, enter the show ip multicast command at any level of the CLI. device#show ip multicast Summary of all vlans. Please use "sh ip mu vlan vlan-id" for details 26 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction Version=2, Intervals: Query=125, Group Age=260, Max Resp=10, Other Qr=260 VL10: cfg V3, vlan cfg passive, , pimsm (vlan cfg), 1 grp, 0 (SG) cache, no rtr port To display the IGMP snooping information for a specific VLAN, enter the following command. device#show ip multicast vlan 10 Version=3, Intervals: Query=10, Group Age=260, Max Resp=10, Other Qr=30 VL10: cfg V3, vlan cfg passive, , pimsm (vlan cfg), 3 grp, 1 (SG) cache, no rtr port, e1/1/2 has 3 groups, non-QR (passive), default V3 **** Warning! has V2 client (life=240), group: 239.0.0.3, life = 240 group: 224.1.1.2, life = 240 group: 224.1.1.1, life = 240 e1/1/4 has 0 groups, non-QR (passive), default V3 Syntax: show ip multicast vlan vlan-id If you do not specify a vlan-id , information for all VLANs is displayed. The following table describes the information displayed by the show ip multicast vlan command. Field Description Version The global IGMP version. In this example, the device is configured for IGMP version 2. Query How often a querier sends a general query on the interface. In this example, the general queries are sent every 125 seconds. Group Age The number of seconds membership groups can be members of this group before aging out. Max Resp The maximum number of seconds a client waits before replying to a query. Other Qr How long it took a switch with a lower IP address to become a new querier. This value is 2 x Query + Max Resp. cfg The IGMP version for the specified VLAN. In this example, VL10: cfg V3 indicates that VLAN 10 is configured for IGMP V3. vlan cfg The IGMP configuration mode, which is either passive or active. pimsm Indicates that PIM SM is enabled on the VLAN. rtr port The router ports, which are the ports receiving queries. Displaying IGMP snooping errors To display information about possible IGMP errors, enter the show ip multicast error command. device#show ip multicast error snoop SW processed pkt: 173, up-time 160 sec Syntax: show ip multicast error The following table describes the output from the show ip multicast error command. Field Description SW processed pkt The number of multicast packets processed by IGMP snooping. up-time The time since the IGMP snooping is enabled. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 27 IPv4 Multicast Traffic Reduction Displaying IGMP group information To display default, maximum, current, and configured values for system maximum parameters, use the show default values command. The following output example does not show complete output; it shows only IGMP group values. device(config)#show default values System Parameters Default Maximum igmp-snoop-group-add 4096 8192 Current 5000 Configured 5000 To display information about IGMP groups, enter the show ip multicast group command. device#show ip multicast group p-:physical, ST:static, QR:querier, EX:exclude, IN:include, Y:yes, N:no VL70 : 3 groups, 4 group-port, tracking_enabled group p-port ST QR life mode source 1 224.1.1.2 1/33 no yes 120 EX 0 2 224.1.1.1 1/33 no yes 120 EX 0 3 226.1.1.1 1/35 yes yes 100 EX 0 4 226.1.1.1 1/33 yes yes 100 EX 0 In this example, an IGMP V2 group is in EXCLUDE mode with a source of 0. The group only excludes traffic from the 0 (zero) source list, which actually means that all traffic sources are included. To display detailed IGMP group information for a specific group, enter the show ip multicast group detail command. device#show ip multicast group 226.1.1.1 detail Display group 226.1.1.1 in all interfaces in details. p-:physical, ST:static, QR:querier, EX:exclude, IN:include, Y:yes, N:no VL70 : 1 groups, 2 group-port, tracking_enabled group p-port ST QR life mode source 1 226.1.1.1 1/35 yes yes 120 EX 0 group: 226.1.1.1, EX, permit 0 (source, life): life=120, deny 0: group p-port ST QR life mode source 2 226.1.1.1 1/33 yes yes 120 EX 0 group: 226.1.1.1, EX, permit 0 (source, life): life=120, deny 0: If the tracking and fast leave features are enabled, you can display the list of clients that belong to a particular group by entering the following command. device#show ip multicast group 224.1.1.1 tracking Display group 224.1.1.1 in all interfaces with tracking enabled. p-:physical, ST:static, QR:querier, EX:exclude, IN:include, Y:yes, N:no VL70 : 1 groups, 1 group-port, tracking_enabled group p-port ST QR life mode source *** Note: has 1 static groups to the entire vlan, not displayed here 1 224.1.1.1 1/33 no yes 100 EX 0 receive reports from 1 clients: (age) (10.2.100.2 60) Syntax: show ip multicast group [group-address [detail] [tracking]] If you want a report for a specific multicast group, enter that group's address for group-address . Enter detail to display the source list of a specific VLAN. Enter tracking for information on interfaces that have tracking enabled. The following table describes the information displayed by the show ip multicast group command. Field Description group The address of the group (destination address in this case, 224.1.1.1) p-port The physical port on which the group membership was received. 28 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction Field Description ST Yes indicates that the IGMP group was configured as a static group; No means the address was learned from reports. QR Yes means the port is a querier port; No means it is not. A port becomes a non-querier port when it receives a query from a source with a lower source IP address than the device. life The number of seconds the group can remain in EXCLUDE mode. An EXCLUDE mode changes to INCLUDE mode if it does not receive an "IS_EX" or "TO_EX" message during a certain period of time. The default is 260 seconds. There is no life displayed in INCLUDE mode. mode Indicates current mode of the interface: INCLUDE or EXCLUDE. If the interface is in INCLUDE mode, it admits traffic only from the source list. If an interface is in EXCLUDE mode, it denies traffic from the source list and accepts the rest. source Identifies the source list that will be included or excluded on the interface. For example, if an IGMP V2 group is in EXCLUDE mode with a source of 0, the group excludes traffic from the 0 (zero) source list, which actually means that all traffic sources are included. Displaying IGMP snooping mcache information To display default, maximum, current, and configured values for system maximum parameters, use the show default values command. The following output example does not show complete output; it shows only IGMP mcache values. device(config)#show default values System Parameters Default Maximum igmp-snoop-mcache 512 8192 Current 300 Configured 300 The IGMP snooping mcache contains multicast forwarding information for VLANs. To display information in the multicast forwarding mcache, enter the show ip multicast mcache command. device#show ip multicast mcache Example: (S G) cnt=: cnt is number of SW processed packets OIF: e1/1/22 TR(1/1/32,1/1/33), TR is trunk, e1/1/32 primary, e1/1/33 output vlan 10, 1 caches. use 1 VIDX 1 (10.10.10.2 239.0.0.3) cnt=0 OIF: tag e2 age=2s up-time=2s change=2s vidx=8191 (ref-cnt=1) Syntax: show ip multicast mcache The following table describes the output of the show ip multicast mcache command. Field Description (source group) Source and group addresses of this data stream. (* group) means match group only; (source group) means match both. cnt The number of packets processed in software. Packets are switched in hardware, which increases this number slowly. OIF The output interfaces. If entire vlan is displayed, this indicates that static groups apply to the entire VLAN. age The mcache age. The mcache will be reset to 0 if traffic continues to arrive, otherwise the mcache will be aged out when it reaches the time defined by the ip multicast mcache-age command. uptime The up time of this mcache in seconds. vidx Vidx specifies output port list index. Range is from 4096 through 8191 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 29 IPv4 Multicast Traffic Reduction Field Description ref-cnt The vidx is shared among mcaches having the same output interfaces. Ref-cnt indicates the number of mcaches using this vidx. Displaying software resource usage for VLANs To display information about the software resources used, enter the show ip multicast resource command. device#show ip multicast resource alloc in-use avail get-fail limit get-mem size init igmp group 256 1 255 0 32000 1 16 256 igmp phy port 1024 1 1023 0 200000 1 22 1024 .... entries deleted ... snoop mcache entry 128 2 126 0 8192 3 56 128 total pool memory 109056 bytes has total 2 forwarding hash VIDX sharing hash : size=2 anchor=997 2nd-hash=no fast-trav=no Available vidx: 4060. IGMP/MLD use 2 Syntax: show ip multicast resource The following table describes the output displayed by the show ip multicast resource command. Field Description alloc The allocated number of units. in-use The number of units which are currently being used. avail The number of available units. get-fail This displays the number of resource failures. NOTE It is important to pay attention to this field. limit The upper limit of this expandable field. The limit of multicast group is configured by the system-max igmp-snoop-group-addr command. The limit of snoop mcache entry is configured by the system-max igmp-snoop-mcache command. get-mem The number of memory allocation. This number must continue to increase. size The size of a unit (in bytes). init The initial allocated amount of memory. More memory may be allocated if resources run out. Available vidx The output interface (OIF) port mask used by mcache. The entire device has a maximum of 4096 vidx. Different mcaches with the same OIF share the same vidx. If vidx is not available, the stream cannot be hardware-switched. Displaying the status of IGMP snooping traffic To display status information for IGMP snooping traffic, enter the show ip multicast traffic command. device#show ip multicast traffic IGMP snooping: Total Recv: 22, Xmit: 26 Q: query, Qry: general Q, G-Qry: group Q, GSQry: group-source Q, Mbr: member Recv QryV2 QryV3 G-Qry GSQry MbrV2 MbrV3 Leave VL1 0 0 0 0 4 0 0 VL70 18 0 0 0 0 0 0 Recv IsIN IsEX ToIN ToEX ALLOW BLOCK Pkt-Err VL1 0 4 0 0 0 0 0 30 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction VL70 Send VL1 VL70 VL70 0 0 0 QryV2 QryV3 G-Qry 0 0 8 0 0 0 pimsm-snooping, Hello: 12, 0 0 GSQry MbrV2 0 0 0 0 Join/Prune: 9 0 MbrV3 0 18 0 Syntax: show ip multicast traffic The following table describes the information displayed by the show ip multicast traffic command. Field Description Q Query Qry General Query QryV2 Number of general IGMP V2 queries received or sent. QryV3 Number of general IGMP V3 queries received or sent. G-Qry Number of group-specific queries received or sent. GSQry Number of group source-specific queries received or sent. Mbr The membership report. MbrV2 The IGMP V2 membership report. MbrV3 The IGMP V3 membership report. IsIN Number of source addresses that were included in the traffic. IsEX Number of source addresses that were excluded in the traffic. ToIN Number of times the interface mode changed from EXCLUDE to INCLUDE. ToEX Number of times the interface mode changed from INCLUDE to EXCLUDE. ALLO Number of times that additional source addresses were allowed on the interface. BLK Number of times that sources were removed from an interface. Pkt-Err Number of packets having errors, such as checksum. Pimsm-snooping hello, join, prune Number of PIM sparse hello, join, and prune packets Displaying querier information You can use the show ip multicast vlan command to display the querier information for a VLAN. This command displays the VLAN interface status and if there is any other querier present with the lowest IP address. The following list provides the combinations of querier possibilities: ∙ Active Interface with no other querier present ∙ Passive Interface with no other querier present ∙ Active Interface with other querier present ∙ Passive Interface with other querier present Displaying the active interface with no other querier present The following example shows the output in which the VLAN interface is active and no other querier is present with the lowest IP address. device#show ip multicast vlan 10 Version=2, Intervals: Query=125, Group Age=260, Max Resp=10, Other Qr=260 VL10: dft V2, vlan cfg active, 0 grp, 0 (*G) cache, no rtr port, 1/1/16 has 0 groups, FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 31 IPv4 Multicast Traffic Reduction This interface default V2 1/1/24 has This interface default V2 2/1/16 has This interface default V2 2/1/24 has This interface default V2 3/1/1 has This interface default V2 3/1/4 has This interface default V2 is Querier 0 groups, is Querier 0 groups, is Querier 0 groups, is Querier 0 groups, is Querier 0 groups, is Querier Syntax: show ip multicast vlan vlan-id If you do not specify a vlan-id , information for all VLANs is displayed. Displaying the passive interface with no other querier present The following example shows the output in which the VLAN interface is passive and no other querier is present with the lowest IP address. device#show ip multicast vlan 10 Version=2, Intervals: Query=125, Group Age=260, Max Resp=10, Other Qr=260 VL10: dft V2, vlan cfg passive, 0 grp, 0 (*G) cache, no rtr port, 1/1/16 has 0 groups, This interface is non-Querier (passive) default V2 1/1/24 has 0 groups, This interface is non-Querier (passive) default V2 2/1/16 has 0 groups, This interface is non-Querier (passive) default V2 2/1/24 has 0 groups, This interface is non-Querier (passive) default V2 3/1/1 has 0 groups, This interface is non-Querier (passive) default V2 3/1/4 has 0 groups, This interface is non-Querier (passive) default V2 Displaying the active Interface with other querier present The following example shows the output in which the VLAN interface is active and another querier is present with the lowest IP address. device#show ip multicast vlan 10 Version=2, Intervals: Query=125, Group Age=260, Max Resp=10, Other Qr=260 VL10: dft V2, vlan cfg active, 7 grp, 6 (*G) cache, rtr ports, router ports: 2/1/24(260) 10.5.5.5, 3/1/4(260) 10.8.8.8, 1/1/16 has 4 groups, This interface is Querier default V2 group: 226.6.6.6, life = 240 group: 228.8.8.8, life = 240 group: 230.0.0.0, life = 240 group: 224.4.4.4, life = 240 1/1/24 has 1 groups, This interface is Querier default V2 group: 228.8.8.8, life = 240 32 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction 2/1/16 has 4 groups, This interface is Querier default V2 group: 226.6.6.6, life = 240 group: 228.8.8.8, life = 240 group: 230.0.0.0, life = 240 group: 224.4.4.4, life = 240 2/1/24 has 2 groups, This interface is non-Querier Querier is 10.5.5.5 Age is 0 Max response time is 100 default V2 **** Warning! has V3 (age=0) nbrs group: 234.4.4.4, life = 260 group: 226.6.6.6, life = 260 3/1/1 has 4 groups, This interface is Querier default V2 group: 238.8.8.8, life = 260 group: 228.8.8.8, life = 260 group: 230.0.0.0, life = 260 group: 224.4.4.4, life = 260 3/1/4 has 1 groups, This interface is non-Querier Querier is 10.8.8.8 Age is 0 Max response time is 100 default V2 **** Warning! has V3 (age=0) nbrs group: 236.6.6.6, life = 260 Displaying the passive interface with other querier present The following example shows the output in which the VLAN interface is passive and another querier is present with the lowest IP address. device#show ip multicast vlan 10 Version=2, Intervals: Query=125, Group Age=260, Max Resp=10, Other Qr=260 VL10: dft V2, vlan cfg passive, 7 grp, 6 (*G) cache, rtr ports, router ports: 2/1/24(260) 10.5.5.5, 3/1/4(260) 10.8.8.8, 1/1/16 has 4 groups, This interface is non-Querier (passive) default V2 group: 226.6.6.6, life = 260 group: 228.8.8.8, life = 260 group: 230.0.0.0, life = 260 group: 224.4.4.4, life = 260 1/1/24 has 1 groups, This interface is non-Querier (passive) default V2 group: 228.8.8.8, life = 260 2/1/16 has 4 groups, This interface is non-Querier (passive) default V2 group: 226.6.6.6, life = 260 group: 228.8.8.8, life = 260 group: 230.0.0.0, life = 260 group: 224.4.4.4, life = 260 2/1/24 has 2 groups, This interface is non-Querier (passive) Querier is 10.5.5.5 Age is 0 Max response time is 100 default V2 **** Warning! has V3 (age=0) nbrs group: 234.4.4.4, life = 260 group: 226.6.6.6, life = 260 3/1/1 has 4 groups, This interface is non-Querier (passive) FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 33 IPv4 Multicast Traffic Reduction default V2 group: 238.8.8.8, life = 260 group: 228.8.8.8, life = 260 group: 230.0.0.0, life = 260 group: 224.4.4.4, life = 260 3/1/4 has 1 groups, This interface is non-Querier (passive) Querier is 10.8.8.8 Age is 0 Max response time is 100 default V2 **** Warning! has V3 (age=0) nbrs group: 236.6.6.6, life = 260 Clear commands for IGMP snooping The clear IGMP snooping commands must be used only in troubleshooting conditions, or to recover from errors. Clearing the IGMP mcache To clear the mcache on all VLANs, enter the clear ip multicast mcache command. device#clear ip multicast mcache Syntax: clear ip multicast mcache Clearing the mcache on a specific VLAN To clear the mcache on a specific VLAN, enter the following command. device#clear ip multicast vlan 10 mcache Syntax: clear ip multicast vlan vlan-id mcache The vlan-id parameter specifies the specific VLAN in which the mcache needs to be cleared. Clearing traffic on a specific VLAN To clear the traffic counters on a specific VLAN, enter the following command. device#clear ip multicast vlan 10 traffic Syntax: clear ip multicast vlanvlan-id traffic The vlan-id parameter specifies the specific VLAN in which traffic counters needs to be cleared. Clearing IGMP counters on VLANs To clear IGMP snooping on error and traffic counters for all VLANs, enter the clear ip multicast counters command. device#clear ip multicast counters Syntax: clear ip multicast counters 34 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction Disabling the flooding of unregistered IPv4 multicast frames in an IGMPsnooping-enabled VLAN NOTE Disabling the flooding of unregistered IPv4 multicast frames in an IGMP-snooping-enabled VLAN is supported only on the following platforms: ∙ The Brocade ICX 6650 ∙ The Brocade ICX 7750 (standalone and stacking) ∙ The Brocade ICX 7450 (standalone and stacking) ∙ The Brocade ICX 7250 (standalone and stacking) Support for this feature on the Brocade ICX 7750 was introduced in FastIron 8.0.10d. In releases prior to FastIron 8.0.30, support for this feature on the Brocade ICX 7750 was for devices in standalone mode only. To disable the flooding of unregistered IPv4 multicast frames in an IGMP-snooping-enabled VLAN, use the ip multicast disableflooding command in global configuration mode. The following example disables flooding of unregistered IPv4 multicast frames. Device(config)# ip multicast disable-flooding PIM SM traffic snooping overview When multiple PIM sparse routers connect through a snooping-enabled device, the Brocade device always forwards multicast traffic to these routers. For example, PIM sparse routers R1, R2, and R3 connect through a device. Assume R2 needs traffic, and R1 sends it to the device, which forwards it to both R2 and R3, even though R3 does not need it. A PIM SM snooping-enabled device listens to join and prune messages exchanged by PIM sparse routers, and stops traffic to the router that sends prune messages. This allows the device to forward the data stream to R2 only. PIM SM traffic snooping requires IGMP snooping to be enabled on the device. IGMP snooping configures the device to listen for IGMP messages. PIM SM traffic snooping provides a finer level of multicast traffic control by configuring the device to listen specifically for PIM SM join and prune messages sent from one PIM SM router to another through the device. Application examples of PIM SM traffic snooping Figure 1 shows an example application of the PIM SM traffic snooping feature. In this example, a device is connected through an IP router to a PIM SM group source that is sending traffic for two PIM SM groups. The device also is connected to a receiver for each of the groups. When PIM SM traffic snooping is enabled, the device starts listening for PIM SM join and prune messages and IGMP group membership reports. Until the device receives a PIM SM join message or an IGMP group membership report, the device forwards IP multicast traffic out all ports. Once the device receives a join message or group membership report for a group, the device forwards subsequent traffic for that group only on the ports from which the join messages or IGMP reports were received. In this example, the router connected to the receiver for group 239.255.162.1 sends a join message toward the group source. Because PIM SM traffic snooping is enabled on the device, the device examines the join message to learn the group ID, then makes a forwarding entry for the group ID and the port connected to the receiver router. The next time the device receives traffic for 239.255.162.1 from the group source, the device forwards the traffic only on port 1/4/1, because that is the only port connected to a receiver for the group. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 35 IPv4 Multicast Traffic Reduction Notice that the receiver for group 239.255.162.69 is directly connected to the device. As a result, the device does not see a join message on behalf of the client. However, because IGMP snooping also is enabled, the device uses the IGMP group membership report from the client to select the port for forwarding traffic to group 239.255.162.69 receivers. The IGMP snooping feature and the PIM SM traffic snooping feature together build a list of groups and forwarding ports for the VLAN. The list includes PIM SM groups learned through join messages as well as MAC addresses learned through IGMP group membership reports. In this case, even though the device never sees a join message for the receiver for group 239.255.162.69, the device nonetheless learns about the receiver and forwards group traffic to the receiver. The device stops forwarding IP multicast traffic on a port for a group if the port receives a prune message for the group. Notice that the ports connected to the source and the receivers are all in the same port-based VLAN on the device. This is required for the PIM SM snooping feature. The devices on the edge of the Global Ethernet cloud are configured for IGMP snooping and PIM SM traffic snooping. Although this application uses multiple devices, the feature has the same requirements and works the same way as it does on a single device. The following figure shows another example application for PIM SM traffic snooping. This example shows devices on the edge of a Global Ethernet cloud (a Layer 2 Packet over SONET cloud). Assume that each device is attached to numerous other devices such as other Layer 2 Switches and Layer 3 Switches (routers). NOTE This example assumes that the devices are actually Brocade devices running Layer 2 Switch software. 36 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction FIGURE 1 PIM SM traffic reduction in Global Ethernet environment The devices on the edge of the Global Ethernet cloud are configured for IGMP snooping and PIM SM traffic snooping. Although this application uses multiple devices, the feature has the same requirements and works the same way as it does on a single device. Configuration notes and limitations for PIM SM snooping ∙ PIM SM snooping applies only to PIM SM version 2 (PIM SM V2). ∙ PIM SM traffic snooping is supported in the Layer 2, base Layer 3, and full Layer 3 code. ∙ IGMP snooping must be enabled on the device that will be running PIM SM snooping. The PIM SM traffic snooping feature requires IGMP snooping. NOTE Use the passive mode of IGMP snooping instead of the active mode. The passive mode assumes that a router is sending group membership queries as well as join and prune messages on behalf of receivers. The active mode configures the device to send group membership queries. ∙ All the device ports connected to the source and receivers or routers must be in the same port-based VLAN. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 37 IPv4 Multicast Traffic Reduction ∙ The PIM SM snooping feature assumes that the group source and the device are in different subnets and communicate through a router. The source must be in a different IP subnet than the receivers. A PIM SM router sends PIM join and prune messages on behalf of a multicast group receiver only when the router and the source are in different subnet. When the receiver and source are in the same subnet, they do not need the router in order to find one another. They find one another directly within the subnet. The device forwards all IP multicast traffic by default. Once you enable IGMP snooping and PIM SM traffic snooping, the device initially blocks all PIM SM traffic instead of forwarding it. The device forwards PIM SM traffic to a receiver only when the device receives a join message from the receiver. Consequently, if the source and the downstream router are in the same subnet, and PIM SM traffic snooping is enabled, the device blocks the PIM SM traffic and never starts forwarding the traffic. This is because the device never receives a join message from the downstream router for the group. The downstream router and group find each other without a join message because they are in the same subnet. NOTE If the "route-only" feature is enabled on a Layer 3 Switch, PIM SM traffic snooping will not be supported. PIM SM snooping configuration Configuring PIM SM snooping on a Brocade device consists of the following global and VLAN-specific tasks. Perform the following global PIM SM snooping task: ∙ Enabling or disabling PIM SM snooping Perform the following VLAN-specific PIM SM snooping tasks: ∙ Enabling PIM SM snooping on a VLAN ∙ Disabling PIM SM snooping on a VLAN Enabling or disabling PIM SM snooping Use PIM SM snooping only in topologies where multiple PIM sparse routers connect through a device. PIM SM snooping does not work on a PIM dense mode router which does not send join messages and traffic to PIM dense ports is stopped. A PIM SM snoopingenabled device displays a warning if it receives PIM dense join or prune messages. To enable PIM sparse snooping globally, enter the ip pimsm-snooping command. device(config)#ip pimsm-snooping This command enables PIM SM traffic snooping. The PIM SM traffic snooping feature assumes that the network has routers that are running PIM SM. NOTE The device must be in passive mode before it can be configured for PIM SM snooping. To disable the feature, enter the no ip pimsm-snooping command. device(config)#no ip pimsm-snooping If you also want to disable IP multicast traffic reduction, enter the no ip multicast command. device(config)#no ip multicast Syntax: [no] ip pimsm-snooping 38 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction Enabling PIM SM snooping on a VLAN You can enable PIM SM snooping for a specific VLAN. For example, the following commands enable PIM SM snooping on VLAN 20. device(config)#vlan 20 device(config-vlan-20)#multicast pimsm-snooping Syntax: [no] multicast pimsm-snooping Disabling PIM SM snooping on a VLAN When PIM SM snooping is enabled globally, you can still disable it for a specific VLAN. For example, the following commands disable PIM SM snooping for VLAN 20. This setting overrides the global setting. device(config)#vlan 20 device(config-vlan-20)#multicast disable-pimsm-snoop Syntax: [no] multicast disable-pimsm-snoop PIM SM snooping show commands This section shows how to display information about PIM SM snooping, including: ∙ Displaying PIM SM snooping information on page 39 ∙ Displaying PIM SM snooping information on a Layer 2 switch on page 39 ∙ Displaying PIM SM snooping information for a specific group or source group pair on page 40 Displaying PIM SM snooping information To display PIM SM snooping information, enter the show ip multicast pimsm-snooping command. Device#show ip multicast pimsm-snooping Example: Port: 7/3 (ref_count=1) ref_count: no of entries in pimsm snoop cache added this oif) vlan 503, has 1 caches. 1 (* 225.1.1.1) has 3 pim join ports out of 4 OIF 4/23 (ref_count=2), 4/13 (ref_count=1), 4/5 (ref_count=3), Syntax: show ip multicast pimsm-snooping [ vlan-id ] Use the vlan-id parameter to display PIM SM snooping information for a specific VLAN. Refer to the FastIron Command Reference for more information on PIM SM commands. Displaying PIM SM snooping information on a Layer 2 switch You can display PIM SM snooping information for all groups by entering the following command at any level of the CLI on a Layer 2 Switch. Device#show ip multicast pimsm-snooping vlan 100 VLAN 100, has 2 caches 1(*230.1.1.1) has 1 pim join ports out of 1OIF 1(age=60) 1 has 1 src: 10.20.20.66(60) 2(* 230.2.2.2) has 1 pim join ports out of 1 OIF 1(age=60) 1 has 1 src: 10.20.20.66(60) FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 39 IPv4 Multicast Traffic Reduction Syntax: show ip multicast pimsm-snooping vlan vlan-id Enter the ID of the VLAN for the vlanvlan-id parameter. If you want to display PIM SM snooping information for one source or one group, enter a command as in the following example. The command also displays the (source, port) list of the group. Device#show ip multicst pimsm-snooping 230.1.1.1 Show pimsm snooping group 230.1.1.1 in all vlans VLAN 10, has 2 caches 1(*230.1.1.1) has 1 pim join ports out of 1 OIF 1(age=120) 1 has 1 src:10.20.20.66(120) Syntax: show ip multicast pimsm-snooping [group-address | source-address] If the address you entered is within the range of source addresses, then the router treats it as the source address. Likewise, if the address falls in the range of group addresses, then the router assumes that you are requesting a report for that group. The following table describes the information displayed by the show ip multicast pimsm-snooping command. Field Description VLAN ID The port-based VLAN to which the following information applies and the number of members in the VLAN. PIM SM Neighbor list The PIM SM routers that are attached to the Layer 2 Switch ports. The value following "expires" indicates how many seconds the Layer 2 Switch will wait for a hello message from the neighbor before determining that the neighbor is no longer present and removing the neighbor from the list. Multicast Group The IP address of the multicast group. NOTE The fid and camindex values are used by Brocade Technical Support for troubleshooting. Forwarding Port The ports attached to the group receivers. A port is listed here when it receives a join message for the group, an IGMP membership report for the group, or both. PIMv2 Group Port The ports on which the Layer 2 Switch has received PIM SM join messages for the group. Source, Port list The IP address of each PIM SM source and the Layer 2 Switch ports connected to the receivers of the source. Refer to the FastIron Command Reference for information on PIM SM snooping commands. Displaying PIM SM snooping information for a specific group or source group pair To display PIM SM snooping information for a specific group, enter the following command at any level of the CLI. device#show ip multicast pimsm-snooping 230.1.1.1 Show pimsm snooping group 230.1.1.1 in all vlans vlan 10,has 2 caches. 1 (*230.1.1.1) has 1 pim join ports out of 1 OIF 1(age=120) 1 has 1 src:10.20.20.66(120) 40 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Traffic Reduction To display PIM SM snooping information for a specific (source, group) pair, enter the following command at any level of the CLI. device#show ip multicast pimsm-snooping 230.2.2.2 20.20.20.66 Show pimsm snooping source 10.20.20.66, group 230.2.2.2 in all vlans vlan 10:(*230.2.2.2) has 1 pim join ports out of 2 OIF 1(age=0) 1 has 1 src:10.20.20.66(0) Syntax: show ip multicast pimsm-snooping group-address [source-ip-address] The Brocade device determines which address is the group address and which one is the source address based on the ranges that the address fall into. If the address is within the range of source addresses, then the router treats it as the source address. Likewise, if the address falls in the range of group addresses, then the router assumes it is a group address. The following table describes the information displayed by the show ip multicast pimsm-snooping command. Field Description vlan The VLAN membership ID of the source. port The port on which the source is sending traffic. In this example, the port number is 1. age The age of the port, in seconds. src The source address and age. The age (number of seconds) is indicated in brackets immediately following the source. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 41 IPv4 Multicast Traffic Reduction 42 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Traffic Reduction ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ MLD snooping overview...............................................................................................................................................................................................43 MLD snooping configuration......................................................................................................................................................................................47 Displaying MLD snooping information................................................................................................................................................................ 54 Clearing MLD snooping counters and mcache...............................................................................................................................................59 Disabling the flooding of unregistered IPv6 multicast frames in an MLD-snooping-enabled VLAN............................ 60 PIM6 SM traffic snooping overview...................................................................................................................................................................... 60 PIM6 SM snooping configuration........................................................................................................................................................................... 63 PIM6 SM snooping show commands.................................................................................................................................................................. 64 MLD snooping overview The default method a device uses to process an IPv6 multicast packet is to broadcast it to all ports except the incoming port of a VLAN. Packets are flooded by hardware without going to the CPU, which may result in some clients receiving unwanted traffic. If a VLAN is not Multicast Listening Discovery (MLD) snooping-enabled, it floods IPv6 multicast data and control packets to the entire VLAN in hardware. When snooping is enabled, MLD packets are trapped to the CPU. Data packets are mirrored to the CPU and flooded to the entire VLAN. The CPU then installs hardware resources so subsequent data packets can be hardware-switched to desired ports without going through the CPU. If there is no client report, the hardware resource drops the data stream. MLD protocols provide a way for clients and a device to exchange messages, and allow the device to build a database indicating which port wants what traffic. Since the MLD protocols do not specify forwarding methods, MLD snooping or multicast protocols such as IPv6 PIM-Sparse Mode (PIM6 SM) are required to handle packet forwarding. PIM6 SM can route multicast packets within and outside a VLAN, while MLD snooping can switch packets only within a VLAN. MLD snooping provides multicast containment by forwarding traffic only to those clients that have MLD receivers for a specific multicast group (destination address). The device maintains the MLD group membership information by processing MLD reports and generating messages so traffic can be forwarded to ports receiving MLD reports. This is analogous to IGMP Snooping on Brocade Layer 3 switches. An IPv6 multicast address is a destination address in the range of FF00::/8. A limited number of multicast addresses are reserved. Because packets destined for the reserved addresses may require VLAN flooding, FSX devices do not snoop in the FF0X::00X range (where X is from 00 to FF) and FFXX:XXXX:XXXX:XXXX:XXXX:XXXX:1:2. Data packets destined to these addresses are flooded to the entire VLAN by hardware and mirrored to the CPU. Multicast data packets destined to addresses outside the FF0X::00X range and FFXX:XXXX:XXXX:XXXX:XXXX:XXXX:1:2 are snooped. A client must send MLD reports in order to receive traffic. An MLD device periodically sends general queries and sends group queries upon receiving a leave message, to ensure no other clients at the same port still want this specific traffic before removing it. MLDv1 allows clients to specify which group (destination IPv6 address) will receive traffic. (MLDv1 cannot choose the source of the traffic.) MLDv2 deals with source-specific multicasts, adding the capability for clients to INCLUDE or EXCLUDE specific traffic sources. An MLDv2 device's port state can either be in INCLUDE or EXCLUDE mode. There are different types of group records for client reports. Clients respond to general queries by sending a membership report containing one or more of the following records associated with a specific group: ∙ Current-state record - Indicates the sources from which the client wants to receive or not receive traffic. This record contains the addresses of the multicast sources and indicates whether or not traffic will be included (IS_IN) or excluded (IS_EX) from that source address. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 43 IPv6 Multicast Traffic Reduction ∙ Filter-mode-change record - If the client changes its current state from IS_IN to IS_EX, a TO_EX record is included in the membership report. Likewise, if a client current state changes from IS_EX to IS_IN, a TO_IN record appears in the membership report. ∙ MLDv1 leave report - Equivalent to a TO_IN (empty) record in MLDv2. This record means that no traffic from this group will be received, regardless of the source. ∙ An MLDv1 group report - Equivalent to an IS_EX (empty) record in MLDv2. This record means that all traffic from this group will be received, regardless of the source. ∙ Source-list-change record - If the client wants to add or remove traffic sources from its membership report, the report can include an ALLOW record, which contains a list of new sources from which the client wishes to receive traffic. The report can also contain a BLOCK record, which lists current traffic sources from which the client wants to stop receiving traffic. Support for MLD snooping and Layer 3 IPv6 multicast routing together on the same device The Brocade device supports global Layer 2 IPv6 multicast traffic reduction (MLD snooping) and Layer 3 IPv6 multicast routing (PIMSparse) together on the same device in the full Layer 3 software image, as long as the Layer 2 feature configuration is at the VLAN level. Forwarding mechanism in hardware IP-based forwarding implementation on FCX and ICX devices The following information about *,G or S,G fdb-based implementation is specific to FCX, ICX 6610, ICX 6430, ICX 6450, and ICX 6650 devices. On both switch and router software images, MLD snooping is either *,G based or S,G based. The hardware can either match the group address only (* G), or both the source and group (S, G) of the data stream. The hardware can match only the lowest 32 bits of a 128 bit IPv6 address. This is 32-bit IP address matching, not 32-bit multicast MAC address 33-33-xx-xx-xx-xx matching. If MLDv2 is configured in any port of a VLAN, the VLAN uses an (S, G) match, otherwise it uses (* G). Because the hardware can match only the lowest 32 bits of a 128 bit IPv6 address, the output interfaces (OIF) of a hardware resource are the superset of the OIF of all data streams sharing the same lowest 32 bits. For example, if groups ff10::1234:5678:abcd and ff20::5678:abcd share the same hardware resource, then the OIF of the hardware matching (* 5678:abcd) is the superset of these two groups. MAC-based forwarding implementation on FastIron X Series and the Brocade ICX 7750, ICX 7450, and ICX 7250 Multicast Listening Discovery (MLD) snooping on Brocade devices is based on MAC address entries. When an IPv6 multicast data packet is received, the packet destination MAC is matched with the MAC address entries in the IPv6 multicast table. If a match is found, packets are sent to the ports associated with the MAC address. If a match is not found, packets are flooded to the VLAN and copied to the CPU. For IPv6 multicast, the destination MAC address is in the format 33-33-xx-yy-zz-kk, where xx-yy-zz-kk are the 32 lowest bits of the IPv6 multicast group address. For example, the IPv6 group address 0xFF3E:40:2001:660:3007:123:0034:5678 maps to the IPv6 MAC address 33-33-00-34-56-78. For two multicast traffic streams, Source_1 and Group1 (S1,G1) and Source_2 and Group2 (S2,G2), with the same or different source addresses, if the lowest 32 bits of the 128-bit IPv6 group address are the same, they would map to the same destination MAC. Because FSX devices support MAC-based forwarding for MLD snooping, the final multicast MAC address entry would be a superset of all the IPv6 groups mapped to it. For example, consider the following three IPv6 multicast streams sent from port 5 of a Brocade device: 44 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Traffic Reduction ∙ (S1,G1) = (2060::5, ff1e::12), client port 1, port 2 ∙ (S2,G2) = (2060::6, ff1e:13::12), client port 2, port 3 ∙ (S3,G1) = (2060::7, ff1e::12), client port 4 Because the lowest 32 bits of the group address for G1 and G2 are the same, all three streams would use 33-33-00-00-00-12 as the destination MAC address. MLD snooping would build a MAC entry with the MAC address 33-33-00-00-00-12 on egress ports 1, 2, 3, and 4. As a result, all three streams would be sent to ports 1, 2, 3, and 4. Note that the above example assumes the following: ∙ The Brocade device is running MLD snooping on VLAN 10 and all three streams are in VLAN 10 ∙ There are clients on port 1 and port 2 for (S1,G1) ∙ There are clients on port 2 and port 3 for (S2,G2) ∙ There are clients on port 4 for (S3,G1) Hardware resources for MLD and PIMv6 SM snooping Brocade devices allocate/program fdb/mac entries and application VLAN (vidx) to achieve multicast snooping in hardware. If a data packet does not match any of these resources, it might be sent to the CPU, which increases the CPU burden. This can happen if the device runs out of hardware resource, or is unable to install resources for a specific matching address due to hashing collision. The hardware hashes addresses into available entries, with some addresses hashed into the same entry. If the collision number in an entry is more than the hardware chain length, the resource cannot be installed. MLD snooping configuration notes and feature limitations ∙ Servers (traffic sources) are not required to send Multicast Listening Discovery (MLD) memberships. ∙ The default MLD version is V1, where the source address is not sensitive. In this version, (S1,G1) and (S2,G1) would be considered the same group as (*,G1). ∙ If MLDv2 is configured on any port of a VLAN, you can check the source information, but because MLD snooping is MAC based, (S,G) switching is not feasible. ∙ Hardware resources are installed only when there is data traffic. ∙ You can configure the maximum number of groups and the multicast cache (mcache) number. ∙ The device supports static groups applying to specific ports. The device acts as a proxy to send MLD reports for the static groups when receiving queries. ∙ A user can configure static router ports, forcing all multicast traffic to be sent to these ports. ∙ Brocade devices support fast leave for MLDv1, which stops traffic immediately to any port that has received a leave message. ∙ Brocade devices support tracking and fast leave for MLDv2, which tracks all MLDv2 clients. If the only client on a port leaves, traffic is stopped immediately. ∙ An MLD device can be configured as a querier (active) or non-querier (passive). Queriers send queries. Non-queriers listen for queries and forward them to the entire VLAN. ∙ Every VLAN can be independently configured as a querier or a non-querier. ∙ A VLAN that has a connection to an IPv6 PIM-enabled port on another router should be configured as a non-querier. When multiple snooping devices connect together and there is no connection to IPv6 PIM ports, only one device should be configured as the querier. If multiple devices are configured as active, only one will continue to send queries after the devices have exchanged queries. Refer to the MLD snooping-enabled queriers and non-queriers section. ∙ An MLD device can be configured to rate-limit the forwarding of MLDv1 membership reports to queriers. ∙ Because an IPv6 link-local address as the source address when sending queries, a global address is not required. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 45 IPv6 Multicast Traffic Reduction ∙ The MLD implementation allows snooping on some VLANs or on all VLANs. MLD can be enabled or disabled independently for each VLAN. In addition, individual ports of a VLAN can be configured as MLDv1 and MLDv2. In general, global configuration commands such as ipv6 multicast.... apply to all VLANs except those with a local multicast... configuration, which supersedes the global configuration. Configuring the version on a port or a VLAN only affects the device sent query version. The device always processes all versions of client reports regardless of the version configured. ∙ MLD snooping requires hardware resources. If the device has insufficient resources, the data stream without a resource is mirrored to the CPU in addition to being VLAN flooded, which can cause high CPU usage. To avoid this situation, Brocade recommends that you avoid enabling snooping globally unless necessary. ∙ To receive data traffic, MLD snooping requires clients to send membership reports. If a client does not send reports, you must configure a static group to force traffic to client ports. ∙ Multicast Router Discovery (MRD) messages are useful for determining which nodes attached to a switch have multicast routing enabled. This capability is useful in a Layer 2 bridge domain with snooping switches. By utilizing MRD messages, Layer 2 switches can determine where to send multicast source data and group membership messages. Multicast source data and group membership reports must be received by all multicast routers on a segment. Using the group membership protocol Query messages to discover multicast routers is insufficient due to query suppression. Because Brocade does not support MRD, this can lead to stream loss when non-Querier router ports age out on the Querier after the initial Query election. To avoid such stream loss, configure a static router port on the querier on each interface that connects to a nonquerier snooping device. The following details apply to the Brocade FSX 800 and FSX 1600 and to the Brocade ICX 7750, ICX 7450, and ICX 7250: ∙ If MLDv2 is configured on any port of a VLAN, you can check the source information, but because MLD snooping is MACbased, (S,G) switching is not feasible. ∙ High CPU utilization occurs when MLD Snooping and PIM6 routing are enabled simultaneously on FastIron X Series devices, and if the ingressing VLAN of the snooping traffic has "router-interface" configuration. With this configuration, IPv6 Multicast data packets received in the snooping VLANs are forwarded to client ports via the hardware; however, copies of these packets are also received and dropped by the CPU. MLD/PIMv6 SM snooping over Multi-Chasis Trunking is supported on the Brocade FSX 800 and FSX 1600, and the Brocade ICX 6650 and ICX 7750. The following details apply to FCX, ICX 6610, ICX 6430, ICX 6450, and ICX 6650 devices: ∙ If a VLAN is configured for MLDv2, the hardware matches (S G), otherwise it matches (* G). ∙ When any port of a VLAN is configured for MLDv2, the VLAN matches both source and group (S, G) in hardware switching. If no port is configured for MLDv2, the VLAN matches group only (* G). Matching (S, G) requires more hardware resources than (* G) when there are multiple servers sharing the same group. For example, two data streams from different sources to the same group require two (S, G) entries in MLDv2, compared to only one (* G) in MLD v1. Use MLD v2 only in a source-specific application. Because each VLAN can be configured for the version independently, some VLANs might match (* G) while others match (S G) MLD snooping-enabled queriers and non-queriers An MLD snooping-enabled device can be configured as a querier (active) or non-querier (passive). An MLD querier sends queries; a non-querier listens for MLD queries and forwards them to the entire VLAN. When multiple MLD snooping devices are connected together, and there is no connection to an IPv6 PIM-enabled port, one of the devices should be configured as a querier. If multiple devices are configured as queriers, after multiple devices exchange queries, then all devices except the winner (the device with the lowest address) stop sending queries. Although the system works when multiple devices are configured as queriers, Brocade recommends that only one device, preferably the one with the traffic source, is configured as the querier. 46 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Traffic Reduction VLANs can also be independently configured as queriers or non-queriers. If a VLAN has a connection to an IPv6 PIM-enabled port on another router, the VLAN should be configured as a non-querier. Because non-queriers always forward multicast data traffic and MLD messages to router ports which receive MLD queries or IPv6 PIM hellos, Brocade recommends that you configure the devices with the data traffic source (server) as queriers. If a server is attached to a non-querier, the non-querier always forwards traffic to the querier regardless of whether or not there are clients on the querier. NOTE In a topology with one or more connected devices, at least one device must be running PIM, or configured as active. Otherwise, no devices can send queries, and traffic cannot be forwarded to clients. To configure the MLD mode (querier or non-querier) on an MLD snooping-enabled device, refer to Configuring the global MLD mode on page 49. To configure the MLD mode on a VLAN, refer to Configuring the MLD mode for a VLAN on page 51. MLD and VLAN configuration You can configure MLD snooping on some VLANs or all VLANs. Each VLAN can be independently enabled or disabled for MLD snooping, or can be configured with MLDv1 or MLDv2. In general, the IPv6 MLD snooping commands apply globally to all VLANs except those configured with VLAN-specific MLD snooping commands. VLAN-specific MLD snooping commands supersede global IPv6 MLD snooping commands. MLDv1 with MLDv2 MLD snooping can be configured as MLDv1 or MLDv2 on individual ports on a VLAN. An interface or router sends queries and reports that include the MLD version with which it has been configured. The version configuration applies only to the sending of queries. The snooping device recognizes and processes MLDv1 and MLDv2 packets regardless of the version configured. NOTE To avoid version deadlock, when an interface receives a report with a lower version than that for which it has been configured, the interface does not automatically downgrade the running MLD version. MLD snooping configuration Configuring Multicast Listening Discovery (MLD) snooping on an IPv6 device consists of the following global and VLAN-specific tasks. MLD snooping global tasks ∙ Configuring hardware and software resource limits ∙ Disabling transmission and receipt of MLD packets on a port ∙ Configuring the MLD mode: active or passive (must be enabled for MLD snooping) ∙ Modifying the age interval ∙ Modifying the interval for query messages (active MLD mode only) ∙ Specifying the global MLD version ∙ Enabling and disabling report control (rate limiting) ∙ Modifying the leave wait time ∙ Modifying the mcache age interval ∙ Disabling error and warning messages MLD snooping VLAN-specific tasks: FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 47 IPv6 Multicast Traffic Reduction ∙ Configuring the MLD mode for the VLAN: active or passive ∙ Enabling or disabling MLD snooping for the VLAN ∙ Configuring the MLD version for the VLAN ∙ Configuring the MLD version for individual ports ∙ Configuring static groups ∙ Configuring static router ports ∙ Disabling proxy activity for a static group ∙ Enabling client tracking and the fast leave feature for MLDv2 ∙ Configuring fast leave for MLDv1 ∙ Configuring fast-convergence Configuring the hardware and software resource limits The system supports up to 8K of hardware-switched multicast streams. The following are the resource limits: ∙ The default is 512 for most devices; for ICX 6430 devices the default is 256. ∙ FCX, FSX, ICX 6610, ICX 6450 and ICX 6650 devices support up to 8192 MLD snooping mcache entries. ∙ ICX 6430 devices support up to 2048 MLD snooping mcache entries. ∙ ICX 7750 routers support 3072 MLD snooping mcache entries; ICX 7750 switches support 8192 MLD snooping mcache entries. ∙ In Release 8.0.10a and later releases, ICX 7750 routers support 6144 MLD snooping mcache entries; ICX 7750 switches support 8192 MLD snooping mcache entries. ∙ ICX 7250 and ICX 7450 devices support up to 8192 MLD snooping mcache entries. To define the maximum number of MLD snooping mcache entries, enter the system-max mld-snoop-mcache num command. Device(config)#system-max mld-snoop-mcache 8000 Syntax:[no] system-max mld-snoop-mcache num he num variable is a value from 256 to 8192. The default is 512. The configured number is the upper limit of an expandable database. Client memberships exceeding the group limits are not processed. ∙ FCX, FSX, ICX 6610, and ICX 6450 devices support up to 8192 MLD group addresses. ∙ ICX 6430 devices support up to 4096 MLD group addresses. ∙ ICX 6650 devices support 8192 MLD group addresses. ∙ ICX 7750 switches support 8192 MLD group addresses. ∙ ICX 7750 routers support 6K MLD group addresses. ∙ ICX 7250 devices support 8192 MLD group addresses. ∙ ICX 7450 devices support 8192 MLD group addresses. To define the maximum number of multicast group addresses supported, enter the system-max mld-snoop-group-addr num command. The default for MLD snooping group addresses is 4096 for most devices; on ICX 6430 devices the default is 1024. Device(config)#system-max mld-snoop-group-addr 4000 Syntax:[no] system-max mld-snoop-group-addr num 48 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Traffic Reduction For all devices except the ICX 6430, The num variable is a value from 256 to 8192. The default is 4096. For the ICX 6430, the num variable is a value from 256 to 4096. The default is 1024. Configuring the global MLD mode You can configure a Brocade device for either active or passive (default) MLD mode. If you specify an MLD mode for a VLAN, the MLD mode overrides the global setting. ∙ Active - In active MLD mode, a device actively sends out MLD queries to identify IPv6 multicast groups on the network, and makes entries in the MLD table based on the group membership reports it receives from the network. ∙ Passive - In passive MLD mode, the device forwards reports to the router ports which receive queries. MLD snooping in passive mode does not send queries, but does forward queries to the entire VLAN. To globally set the MLD mode to active, enter the ipv6 multicast active command. device(config)#ipv6 multicast active Syntax: [no] ipv6 multicast [ active | passive ] Omitting both the active and passive keywords is the same as entering ipv6 multicast passive . NOTE The ipv6 mld-snooping command is replaced by the ipv6 multicast command; the mld-snooping command is replaced by the multicast6 command. Modifying the age interval When the device receives a group membership report, it makes an entry in the MLD group table for the group in the report. The age interval specifies how long the entry can remain in the table without the device receiving another group membership report. When multiple devices connect together, all devices should be configured with the same age interval. The age interval should be at least twice that of the query interval, so that missing one report will not stop traffic. For a non-querier, the query interval should equal that of the querier. To modify the age interval, enter a command such as the following. device(config)#ipv6 multicast age-interval 280 Syntax:[no] ipv6 multicast age-interval interval The interval parameter specifies the aging time. You can specify a value from 20 to 7200 seconds. The default is 260 seconds. Modifying the query interval (active MLD snooping mode only) If the MLD mode is set to active, you can modify the query interval, which specifies how often the Brocade device sends group membership queries. By default, queries are sent every 60 seconds. When multiple queriers connect together, all queriers should be configured with the same interval. To modify the query interval, enter the ipv6 multicast query-interval interval command. Device(config)#ipv6 multicast query-interval 120 Syntax: [no] ipv6 multicast query-interval interval The interval parameter specifies the interval between queries. You can specify a value from 10 to 3600 seconds. The default is 125 seconds. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 49 IPv6 Multicast Traffic Reduction Configuring the global MLD version The default version is MLDv1. You can specify the global MLD version on the device as either MLDv1 or MLDv2. For example, the following command configures the device to use MLDv2. device(config)#ipv6 multicast version 2 Syntax: [no] ipv6 multicast version {1 | 2} You can also specify the MLD version for individual VLANs, or individual ports within VLANs. If no MLD version is specified for a VLAN, then the globally configured MLD version is used. If an MLD version is specified for individual ports in a VLAN, those ports use that version instead of the version specified for the VLAN or the globally specified version. The default is MLDv1. Configuring report control When a device is in passive mode, it forwards reports and leave messages from clients to the upstream router ports that are receiving queries. You can configure report control to rate-limit report forwarding for the same group to no more than once per 10 seconds. This rate limiting does not apply to the first report answering a group-specific query. NOTE This feature applies to MLDv1 only. The leave messages are not rate limited. MLDv1 membership reports for the same group from different clients are considered to be the same, and are rate-limited. This alleviates the report storm caused by multiple clients answering the upstream router query. To enable report-control, enter the ipv6 multicast report-control command. device(config)#ipv6 multicast report-control Syntax: [no] ipv6 multicast report-control Modifying the wait time before stopping traffic when receiving a leave message You can define the wait time before stopping traffic to a port when the device receives a leave message for that port. The device sends group-specific queries once per second to determine if any client on the same port still needs the group. Device(config)#ipv6 multicast leave-wait-time 1 Syntax: [no] ipv6 multicast leave-wait-time num The num variable is a value from 1 to 5. The default is 2. Because of the internal timer accuracy, the actual wait time is between n and (n +1) seconds, where n is the configured value. Modifying the multicast cache aging time You can set the time for a multicast cache (mcache) to age out when it does not receive traffic. Two seconds before an mcache is aged out, the device mirrors a packet of the mcache to the CPU to reset the age. If no data traffic arrives within two seconds, the mcache is deleted. Note that in devices like the Brocade FSX 800 and FSX 1600 and to the Brocade ICX 7750, ICX 7450, and ICX 7250 where MACbased MLD snooping is supported, more than one mcache can be mapped to the same destination MAC. Hence, when an mcache entry is deleted, the MAC entry may not be deleted. If you configure a lower value, the resource consumed by idle streams is quickly removed, but packets are mirrored to the CPU more frequently. Configure a higher value only when data streams are arriving consistently. 50 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Traffic Reduction You can use the show ipv6 multicast mcache command to view the currently configured mcache age. Refer to the “Enabling or disabling PIM6 SM snooping” section. To modify the multicast cache age out time, enter the ipv6 multicast mcache-age command. Device(config)#ipv6 multicast mcache-age 180 Syntax: [no] ipv6 multicast mcache-age num The num variable is a value from 60 to 3600 seconds, and the default is 60 seconds. Disabling error and warning messages Error or warning messages are printed when the device runs out of software resources or when it receives packets with the wrong checksum or groups. These messages are rate limited. You can turn off these messages by entering the ipv6 multicast verbose-off command. device(config)#ipv6 multicast verbose-off Syntax: [no] ipv6 multicast verbose-off Configuring the MLD mode for a VLAN You can configure a VLAN for either the active or passive (default) MLD mode. The VLAN setting overrides the global setting: ∙ Active - In active MLD mode, the device actively sends out MLD queries to identify IPv6 multicast groups on the network, and makes entries in the MLD table based on the group membership reports it receives from the network. ∙ Passive - In passive MLD mode, the device forwards reports to router ports that receive queries. MLD snooping in the passive mode does not send queries. However, it does forward queries to the entire VLAN. To set the MLD mode for VLAN 20 to active, enter the following commands. device(config)#vlan 20 device(config-vlan-20)#multicst6 active Syntax: [no] multicast6 [active | passive] The default mode is passive. Disabling MLD snooping for the VLAN When MLD snooping is enabled globally, you can disable it for a specific VLAN. For example, the following commands disable MLD snooping for VLAN 20. This setting overrides the global setting for VLAN 20. device(config)#vlan 20 device(config-vlan-20)#multicast6 disable-mld-snoop Syntax: [no] multicast6 disable-mld-snoop Configuring the MLD version for the VLAN You can specify the MLD version for a VLAN. For example, the following commands configure VLAN 20 to use MLDv2. device(config)#vlan 20 device(config-vlan-20)#multicast6 version 2 Syntax: [no] multicast6 version [1 | 2] FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 51 IPv6 Multicast Traffic Reduction When no MLD version is specified, the globally-configured MLD version is used. If an MLD version is specified for individual ports, these ports use that version, instead of the version specified for the VLAN. Configuring the MLD version for individual ports You can specify the MLD version for individual ports in a VLAN. For example, the following commands configure ports 1/1/4, 1/1/5, 1/1/6 and 1/2/1 to use MLDv2. The other ports use the MLD version specified with the multicast6 version command, or the globally configured MLD version. Device(config)#vlan 20 Device(config-vlan-20)#multicast6 port-version 2 ethernet 1/2/1 ethernet 1/1/4 to 1/1/6 Syntax: [no] multicast6 port-version [1 | 2 ] ethernet unit/slot/port Configuring static groups A snooping-enabled VLAN cannot forward multicast traffic to ports that do not receive MLD membership reports. To allow clients to send reports, you can configure a static group that applies to individual ports on the VLAN. You cannot configure a static group that applies to the entire VLAN. The maximum number of supported static groups in a VLAN is 512, and the maximum number of supported static groups for individual ports in a VLAN is 256. The static group forwards packets to the static group ports even if they have no client membership reports. Configure a static group for specific ports on VLAN 20 using commands similar to the following. device(config)#vlan 20 device(config-vlan-20)#multicast6 static-group ff05::100 count 2 ethe 1/1/3 ethe 1/1/5 to 1/1/7 Syntax: [no] multicast6 static-group ipv6-address [ count num ] [ unit/slot/port ] The ipv6-address parameter is the IPv6 address of the multicast group. The count is optional, which allows a contiguous range of groups. Omitting the count num is equivalent to the count being 1. Configuring static router ports All multicast control and data packets are forwarded to router ports that receive queries. Although router ports are learned, you can configure static router ports to force multicast traffic to specific ports, even though these ports never receive queries. To configure static router ports, enter commands such as the following: Device(config)#vlan 70 Device(config-vlan-70)#multicast6 router-port ethernet 1/1/4 to 1/1/5 ethernet 1/1/8 Syntax: [no] multicast6 router-port ethernet unit/slot/port Disabling static group proxy A device with statically configured groups acts as a proxy and sends membership reports for its static groups when it receives general or group-specific queries. When a static group configuration is removed, the group is immediately deleted from the active group table. However, the device does not send leave messages to the querier. The querier should age out the group. The proxy activity can be disabled (the default is enabled). device(config)#vlan 20 device(config-vlan-20)#multicast6 proxy-off Syntax: [no] multicast6 proxy-off 52 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Traffic Reduction By default, MLD snooping proxy is enabled. Enabling MLDv2 membership tracking and fast leave for the VLAN MLDv2 provides membership tracking and fast leave services to clients. In MLDv1, only one client per interface must respond to a router queries; leaving some clients invisible to the router, which makes it impossible for the device to track the membership of all clients in a group. In addition, when a client leaves the group, the device sends group-specific queries to the interface to see if other clients on that interface need the data stream of the client who is leaving. If no client responds, the device waits a few seconds before stopping the traffic. You can configure the wait time with the ipv6 multicast6 leave-wait-time command. See Enabling or disabling PIM6 SM snooping for more information. MLDv2 requires that every client respond to queries, allowing the device to track every client. When the tracking feature is enabled, the device immediately stops forwarding traffic to the interface if an MLDv2 client sends a leave message, and there is no other client. This feature requires the entire VLAN to be configured for MLDv2 and have no MLDv1 clients. If a client does not send a report during the specified group membership time (the default is 140 seconds), that client is removed from the tracking list. Every group on a physical port keeps its own tracking record. However, it can track group membership only; it cannot track by (source, group). For example, Client A and Client B belong to group1 but each is receiving traffic from different sources. Client A receives a traffic stream from (source_1, group1) and Client B receives a traffic stream from (source_2, group1). The device waits for the configured leavewait-time before it stops the traffic because the two clients are in the same group. If the clients are in different groups, the waiting period is ignored and traffic is stopped immediately. To enable tracking and fast leave for VLAN 20, enter the following commands. device(config)#vlan 20 device(config-vlan-20)#multicast6 tracking Syntax: [no] multicast6 tracking The membership tracking and fast leave features are supported for MLDv2 only. If a port or client is not configured for MLDv2, the multicast6 tracking command is ignored. Configuring fast leave for MLDv1 When a device receives an MLDv1 leave message, it sends out multiple group-specific queries. If no other client replies within the waiting period, the device stops forwarding traffic to this port. Configuring fast-leave-v1 allows the device to stop forwarding traffic to a port immediately upon receiving a leave message. The device does not send group-specific queries. When fast-leave-v1 is configured on a VLAN, make sure you do not have multiple clients on any port that is part of the VLAN. In a scenario where two devices connect, the querier device should not be configured for fast-leave-v1, because the port might have multiple clients through the non-querier. The number of queries and the waiting period (in seconds) can be configured using the ipv6 multicast leave-wait-time command. See Enabling or disabling PIM6 SM snooping for more information. To configure fast leave for MLDv1, use commands such as the following. device(config)#vlan 20 device(config-vlan-20)#multicast6 fast-leave-v1 Syntax: [no] multicast6 fast-leave-v1 Enabling fast convergence In addition to periodically sending general queries, an active (querier) device sends out general queries when it detects a new port. However, since it does not recognize the other device port-up event, the multicast traffic might still use the query-interval time to resume FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 53 IPv6 Multicast Traffic Reduction after a topology change. Configuring fast-convergence allows the device to listen to topology change events in Layer 2 protocols, such as spanning tree, and send general queries to shorten the convergence time. If the Layer 2 protocol is unable to detect a topology change, the fast-convergence feature may not work. For example, if the direct connection between two devices switches from one interface to another, the rapid spanning tree protocol (802.1w) considers this an optimization action, rather than a topology change. In this case, other devices will not receive topology change notifications and will be unable to send queries to speed up the convergence. The original spanning tree protocol does not recognize optimization actions, and fast-convergence works in all cases. To enable fast-convergence, enter commands such as the following. device(config)#vlan 70 device(config-vlan-70)#multicast6 fast-convergence Syntax: [no] multicast6 fast-convergence Displaying MLD snooping information You can display the following MLD snooping information: ∙ MLD snooping error information ∙ Group and forwarding information for VLANs ∙ Information about MLD snooping mcache ∙ MLD memory pool usage ∙ Status of MLD traffic ∙ MLD information by VLAN Displaying MLD snooping error information To display information about possible MLD errors, enter the following command. device#show ipv6 multicast error snoop SW processed pkt: 173, up-time 160 sec Syntax: show ipv6 multicast error The following table describes the output from the show ipv6 multicast error command. Field Description SW processed pkt The number of IPv6 multicast packets processed by MLD snooping. up-time The MLD snooping up time. Displaying MLD group information To display default, maximum, current, and configured values for system maximum parameters, use the show default values command. The following output example does not show complete output; it shows only MLD group values. Device(config)#show default values System Parameters Default Maximum MLD-snoop-group-addr 4096 8192 Current 5000 Configured 5000 To display MLD group information, enter the show ipv6 multicast group command. Device#show ipv6 multicast group p-:physical, ST:static, QR:querier, EX:exclude, IN:include, Y:yes, N:no 54 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Traffic Reduction VL1 : 263 grp, 263 grp-port, tracking_enabled group 1 ff0e::ef00:a0e3 2 ff01::1:f123:f567 p-port ST QR life mode source 1/1/7 N Y 120 EX 0 1/1/9 N Y IN 1 NOTE In this example, an MLDv1 group is in EXCLUDE mode with a source of 0. The group excludes traffic from the 0 (zero) source list, which actually means that all traffic sources are included. To display detailed MLD group information, enter the following command. Device#show ipv6 multicast group ff0e::ef00:a096 detail Display group ff0e::ef00:a096 in all interfaces in details. p-:physical, ST:static, QR:querier, EX:exclude, IN:include, Y:yes, N:no VL1 : 1 grp, 1 grp-port, tracking_enabled group p-port ST QR life mode source 1 ff0e::ef00:a096 1/1/7 N Y 100 EX 0 group: ff0e::ef00:a096, EX, permit 0 (source, life): life=100, deny 0: If tracking and fast leave are enabled, you can display the list of clients for a particular group by entering the following command. Device#show ipv6 multicast group ff0e::ef00:a096 tracking Display group ff0e::ef00:a096 in all interfaces with tracking enabled. p-:physical, ST:static, QR:querier, EX:exclude, IN:include, Y:yes, N:no VL1 : 1 grp, 1 grp-port, tracking_enabled group p-port ST QR life mode source 1 ff0e::ef00:a096 1/1/7 N Y 80 EX 0 receive reports from 1 clients: (age) (2001:DB8::1011:1213:1415 60) Syntax: show ipv6 multicast group [ group-address [ detail ] [ tracking ] ] To receive a report for a specific multicast group, enter that group address for group-address. Enter the detail keyword to display the source list of a specific VLAN. Enter the tracking keyword for information on interfaces that are tracking-enabled. The following table describes the information displayed by the show ipv6 multicast group command. Field Description group The address of the IPv6 group (destination IPv6 address). p-port The physical port on which the group membership was received. ST Yes indicates that the MLD group was configured as a static group; No means it was learned from reports. QR Yes means the port is a querier port; No means it is not. A port becomes a non-querier port when it receives a query from a source with a lower source IP address than the port. life The number of seconds the group can remain in EXCLUDE mode. An EXCLUDE mode changes to INCLUDE if it does not receive an IS_EX or TO_EX message during a specified period of time. The default is 140 seconds. There is no life displayed in INCLUDE mode. mode The current mode of the interface: INCLUDE or EXCLUDE. If the interface is in INCLUDE mode, it admits traffic only from the source list. If the interface is in EXCLUDE mode, it denies traffic from the source list and accepts the rest. source Identifies the source list that will be included or excluded on the interface. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 55 IPv6 Multicast Traffic Reduction Field Description An MLDv1 group is in EXCLUDE mode with a source of 0. The group excludes traffic from 0 (zero) source list, which actually means that all traffic sources are included. If you requested a detailed report, the following information is displayed: group ∙ The multicast group address ∙ The mode of the group ∙ Sources from which traffic will be admitted (INCLUDE) or denied (EXCLUDE) on the interface. ∙ The life of each source list. If you requested a tracking/fast leave report, the clients from which reports were received are identified. Displaying MLD snooping mcache information To display default, maximum, current, and configured values for system maximum parameters, use the show default values command. The following output example does not show complete output; it shows only MLD mcache values. device(config)#show default values System Parameters Default Maximum mld-snoop-mcache 512 8192 Current 512 Configured 512 The MLD snooping mcache contains multicast forwarding information for VLANs. To display information in the multicast forwarding mcache, enter the show ipv6 multicast mcache command. device#show ipv6 multicast mcache Example: (S G) cnt=: (S G) are the lowest 32 bits, cnt: SW proc. count OIF: 1/1/22 TR(1/1/32,1/1/33), TR is trunk, 1/1/32 primary, 1/1/33 output vlan 1, has 2 cache 1 (abcd:ef50 0:100), cnt=121 OIF: 1/1/11 1/1/9 age=0s up-time=120s vidx=4130 (ref-cnt=1) 2 (abcd:ef50 0:101), cnt=0 OIF: entire vlan age=0s up-time=0s vidx=8191 (ref-cnt=1) vlan 70, has 0 cache Syntax: show ipv6 multicast mcache The following table describes the output from the show ipv6 multicast mcache command. Displaying software resource usage for VLANs Field Description (abcd:ef50 0:100): The lowest 32 bits of source and group. It is displayed in XXXX:XXXX hex format. Here XXXX is a 16-bit hex number. cnt The number of packets processed in software. OIF Output interfaces. age The mcache age in seconds. The mcache is reset to 0 if traffic continues to arrive, otherwise it is aged out when it reaches the time defined by ipv6 multicast mcache-age. uptime The up time of this mcache in seconds. vidx The vidx is shared among mcaches using the same output interfaces. The vidx specifies the output port list, which shows the index. Valid range is from 4096 to 8191. ref-cnt The number of mcaches using this vidx. 56 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Traffic Reduction To display information about the software resources used, enter the following command. device#show ipv6 multicast resource alloc in-use avail get-fail mld group 512 9 503 0 mld phy port 1024 16 1008 0 snoop group hash 512 9 503 0 .... Entries deleted total pool memory 194432 bytes has total 1 forwarding hash Available vidx: 4061 limit 32000 200000 59392 get-mem 272 279 272 size init 28 256 21 1024 20 256 Syntax: show ipv6 multicast resource The following table describes the output from the show ipv6 multicast resource command. Field Displays alloc The allocated number of units. in-use The number of units which are currently used. avail The number of available units. get-fail The number of resource failures NOTE It is important to pay close attention to this field. limit The upper limit of this expandable field. The MLD group limit is configured using the system-max mld-snoop-group-addr command. The snoop mcache entry limit is configured using the system-max mldsnoop-mcache command. get-mem The current memory allocation. This number should continue to increase. size The size of a unit (in bytes). init The initial allocated amount of memory. NOTE This number can be increased. (More memory can be allocated if necessary.) Available vidx The output interface (OIF) port mask used by mcache. The entire device has a maximum of 4096 vidx. Different mcaches with the same OIF share the same vidx. If vidx is not available, the stream cannot be hardware-switched. Displaying status of MLD snooping traffic To display status information for MLD snooping traffic, enter the show ipv6 multicast traffic command. device#show ipv6 multicast traffic MLD snooping: Total Recv: 32208, Xmit: 166 Q: query, Qry: general Q, G-Qry: group Q, GSQry: group-source Q, Mbr: member Recv QryV1 QryV2 G-Qry GSQry MbrV1 MbrV2 Leave VL1 0 0 0 0 31744 208 256 VL70 0 0 0 0 0 0 0 Recv IsIN IsEX ToIN ToEX ALLOW BLOCK Pkt-Err VL1 1473 31784 0 1 1 7 0 VL70 0 0 0 0 0 0 0 Send QryV1 QryV2 G-Qry GSQry MbrV1 MbrV2 VL1 0 0 166 0 0 0 VL70 0 0 0 0 0 0 Syntax: show ipv6 multicast traffic FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 57 IPv6 Multicast Traffic Reduction The following table describes the information displayed by the show ipv6 multicast traffic command. Field Description Q Query Qry General Query QryV1 Number of general MLDv1 queries received or sent. QryV2 Number of general MLDv2 snooping queries received or sent. G-Qry Number of group specific queries received or sent. GSQry Number of group source specific queries received or sent. MBR The membership report. MbrV1 The MLDv1 membership report. MbrV2 The MLDv2 membership report. IsIN Number of source addresses that were included in the traffic. IsEX Number of source addresses that were excluded in the traffic. ToIN Number of times the interface mode changed from EXCLUDE to INCLUDE. ToEX Number of times the interface mode changed from INCLUDE to EXCLUDE. ALLO Number of times additional source addresses were allowed on the interface. BLK Number of times sources were removed from an interface. Pkt-Err Number of packets having errors such as checksum errors. Displaying MLD snooping information by VLAN You can display MLD snooping information for all VLANs or for a specific VLAN. For example, to display MLD snooping information for VLAN 70, enter the show ipv6 multicast vlan command. device#show ipv6 multicast vlan 70 version=1, query-t=60, group-aging-t=140, max-resp-t=3, other-qr-present-t=123 VL70: cfg V2, vlan cfg passive, 2 grp, 0 (SG) cache, rtr ports, router ports: 1/1/36(120) 2001:DB8::2e0:52ff:fe00:9900, 1/1/26 has 2 grp, non-QR (passive), cfg V1 1/1/26 has 2 grp, non-QR (passive), cfg V1 group: ff10:1234::5679, life = 100 group: ff10:1234::5678, life = 100 1/1/35 has 0 grp, non-QR (QR=2001:DB8::2e0:52ff:fe00:9900, age=20), dft V2 trunk Syntax: show ipv6 multicast vlan [vlan-id] If you do not specify the vlan-id variable, information for all VLANs is displayed. The following table describes information displayed by the show ipv6 multicast vlan command. Field Description version The MLD version number. query-t How often a querier sends a general query on the interface. group-aging-t Number of seconds membership groups can be members of this group before aging out. rtr-port The router ports which are the ports receiving queries. The display router ports: 1/1/36(120) 2001:DB8::2e0:52ff:fe00:9900 58 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Traffic Reduction Field Description means port 1/1/36 has a querier with 2001:DB8::2e0:52ff:fe00:9900 as the link-local address, and the remaining life is 120 seconds. max-resp-t The maximum number of seconds a client can wait before it replies to the query. non-QR Indicates that the port is a non-querier. QR Indicates that the port is a querier. Clearing MLD snooping counters and mcache The clear commands for MLD snooping should only be used in troubleshooting situations or when recovering from error conditions. Clearing MLD counters on all VLANs To clear MLD snooping error and traffic counters on all VLANs, enter the clear ipv6 multicast counters command. device#clear ipv6 multicast counters Syntax: clear ipv6 multicast counters Clearing the mcache on all VLANs To clear the mcache on all VLANs, enter the clear ipv6 multicast mcache command. device#clear ipv6 multicast mcache Syntax: clear ipv6 multicast mcache Clearing the mcache on a specific VLAN To clear the mcache on a specific VLAN, enter the clear ipv6 multicast vlan mcache command. device#clear ipv6 multicast vlan 10 mcache Syntax: clear ipv6 multicast vlan vlan-id mcache The vlan-id parameter specifies the specific VLAN from which to clear the cache. Clearing traffic counters on a specific VLAN To clear the traffic counters on a specific VLAN, enter the clear ipv6 multicast vlan traffic command. device#clear ipv6 multicast vlan 10 traffic Syntax: clear ipv6 multicast vlan vlan-id traffic The vlan-id parameter specifies the specific VLAN from which to clear the traffic counters. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 59 IPv6 Multicast Traffic Reduction Disabling the flooding of unregistered IPv6 multicast frames in an MLDsnooping-enabled VLAN NOTE Disabling the flooding of unregistered IPv6 multicast frames in an MLD-snooping-enabled VLAN is supported only on the following platforms: ∙ The Brocade ICX 6650 ∙ The Brocade ICX 7750 (standalone and stacking) Support for this feature on the Brocade ICX 7750 was introduced in FastIron 8.0.10d. In releases prior to FastIron 8.0.30, support for this feature on the Brocade ICX 7750 was for devices in standalone mode only. To disable the flooding of unregistered IPv6 multicast frames in an MLD-snooping-enabled VLAN, use the ipv6 multicast disableflooding command in global configuration mode. The following example disables flooding of unregistered IPv6 multicast frames. Device(config)# ipv6 multicast disable-flooding PIM6 SM traffic snooping overview When multiple PIM sparse routers connect through a snooping-enabled device, the Brocade device always forwards multicast traffic to these routers. For example, PIM sparse routers R1, R2, and R3 connect through a device. Assume R2 needs traffic, and R1 sends it to the device, which forwards it to both R2 and R3, even though R3 does not need it. A PIM6 SM snooping-enabled device listens to join and prune messages exchanged by PIM sparse routers, and stops traffic to the router that sends prune messages. This allows the device to forward the data stream to R2 only. PIM6 SM traffic snooping requires MLD snooping to be enabled on the device. MLD snooping configures the device to listen for MLD messages. PIM6 SM traffic snooping provides a finer level of multicast traffic control by configuring the device to listen specifically for PIM6 SM join and prune messages sent from one PIM6 SM router to another through the device. Application examples of PIM6 SM traffic snooping Figure 2 shows an example application of the PIM6 SM traffic snooping feature. In this example, a device is connected through an IP router to a PIM6 SM group source that is sending traffic for two PIM6 SM groups. The device also is connected to a receiver for each of the groups. When PIM6 SM traffic snooping is enabled, the device starts listening for PIM6 SM join and prune messages and MLD group membership reports. Until the device receives a PIM6 SM join message or an MLD group membership report, the device forwards IP multicast traffic out all ports. Once the device receives a join message or group membership report for a group, the device forwards subsequent traffic for that group only on the ports from which the join messages or MLD reports were received. In this example, the router connected to the receiver for group ff1e::1:2 sends a join message toward the group source. Because PIM6 SM traffic snooping is enabled on the device, the device examines the join message to learn the group ID, then makes a forwarding entry for the group ID and the port connected to the receiver router. The next time the device receives traffic for ff1e::1:2 from the group source, the device forwards the traffic only on port 5/1, because that is the only port connected to a receiver for the group. Notice that the receiver for group ff1e::3:4 is directly connected to the device. As a result, the device does not see a join message on behalf of the client. However, because MLD snooping also is enabled, the device uses the MLD group membership report from the client to select the port for forwarding traffic to group ff1e::3:4 receivers. 60 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Traffic Reduction The MLD snooping feature and the PIM6 SM traffic snooping feature together build a list of groups and forwarding ports for the VLAN. The list includes PIM6 SM groups learned through join messages as well as MAC addresses learned through MLD group membership reports. In this case, even though the device never sees a join message for the receiver for group ff1e::3:4, the device nonetheless learns about the receiver and forwards group traffic to the receiver. The device stops forwarding IP multicast traffic on a port for a group if the port receives a prune message for the group. Notice that the ports connected to the source and the receivers are all in the same port-based VLAN on the device. This is required for the PIM6 SM snooping feature. The devices on the edge of the Global Ethernet cloud are configured for MLD snooping and PIM6 SM traffic snooping. Although this application uses multiple devices, the feature has the same requirements and works the same way as it does on a single device. The following figure shows another example application for PIM6 SM traffic snooping. This example shows devices on the edge of a Global Ethernet cloud (a Layer 2 Packet over SONET cloud). Assume that each device is attached to numerous other devices such as other Layer 2 Switches and Layer 3 Switches (routers). NOTE This example assumes that the devices are actually Brocade devices running Layer 2 Switch software. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 61 IPv6 Multicast Traffic Reduction FIGURE 2 PIM6 SM traffic reduction in Global Ethernet environment The devices on the edge of the Global Ethernet cloud are configured for MLD snooping and PIM6 SM traffic snooping. Although this application uses multiple devices, the feature has the same requirements and works the same way as it does on a single device. Configuration notes and limitations for PIM6 SM snooping 62 ∙ PIM6 SM snooping applies only to PIM6 SM version 2 (PIM6 SM V2). ∙ PIM6 SM traffic snooping is supported in the Layer 2, base Layer 3, and full Layer 3 code. ∙ MLD snooping must be enabled on the device that will be running PIM6 SM snooping. The PIM6 SM traffic snooping feature requires MLD snooping. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Traffic Reduction NOTE Use the passive mode of MLD snooping instead of the active mode. The passive mode assumes that a router is sending group membership queries as well as join and prune messages on behalf of receivers. The active mode configures the device to send group membership queries. ∙ All the device ports connected to the source and receivers or routers must be in the same port-based VLAN. ∙ The PIM6 SM snooping feature assumes that the group source and the device are in different subnets and communicate through a router. The source must be in a different IP subnet than the receivers. A PIM6 SM router sends PIM join and prune messages on behalf of a multicast group receiver only when the router and the source are in different subnet. When the receiver and source are in the same subnet, they do not need the router in order to find one another. They find one another directly within the subnet. The device forwards all IP multicast traffic by default. Once you enable MLD snooping and PIM6 SM traffic snooping, the device initially blocks all PIM6 SM traffic instead of forwarding it. The device forwards PIM6 SM traffic to a receiver only when the device receives a join message from the receiver. Consequently, if the source and the downstream router are in the same subnet, and PIM6 SM traffic snooping is enabled, the device blocks the PIM6 SM traffic and never starts forwarding the traffic. This is because the device never receives a join message from the downstream router for the group. The downstream router and group find each other without a join message because they are in the same subnet. NOTE If the "route-only" feature is enabled on a Layer 3 Switch, PIM6 SM traffic snooping will not be supported. PIM6 SM snooping configuration Configuring PIM6 SM snooping on a Brocade device consists of the following global and VLAN-specific tasks. Perform the following global PIM6 SM snooping task: ∙ Enabling or disabling PIM6 SM snooping Perform the following VLAN-specific PIM6 SM snooping tasks: ∙ Enabling PIM6 SM snooping on a VLAN ∙ Disabling PIM6 SM snooping on a VLAN Enabling or disabling PIM6 SM snooping Use PIM6 SM snooping only in topologies where multiple PIM sparse routers connect through a device. PIM6 SM snooping does not work on a PIM dense mode router which does not send join messages and traffic to PIM dense ports is stopped. A PIM6 SM snoopingenabled device displays a warning if it receives PIM dense join or prune messages. Perform the following steps to enable PIM6 SM snooping globally. 1. Enable MLD snooping passive globally. device(config)#ipv6 multicast passive 2. Enable PIM6 SM snooping globally. device(config)#ipv6 pimsm-snooping This command enables PIM6 SM traffic snooping. The PIM6 SM traffic snooping feature assumes that the network has routers that are running PIM6 SM. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 63 IPv6 Multicast Traffic Reduction To disable PIM6 SM snooping, enter the no ipv6 pimsm-snooping command. device(config)#no ipv6 pimsm-snooping If you also want to disable IP multicast traffic reduction, enter the no ipv6 multicast command. device(config)#no ipv6 multicast Syntax: [no] ipv6 pimsm-snooping Enabling PIM6 SM snooping on a VLAN Perform the following steps to enable PIM6 SM snooping on a VLAN. 1. Configure a VLAN and add the ports that are connected to the device and host in the same port-based VLAN. device(config)#vlan 20 device(config-vlan-20)#untagged etherenet 1/1/5 ethernet 1/1/7 ethernet 1/1/11 2. Enable MLD snooping passive on the VLAN. device(config-vlan-20)#multicast6 passive 3. Enable PIM6 SM snooping on the VLAN. device(config-vlan-20)#multicast6 pimsm-snooping Syntax: [no] multicast6 pimsm-snooping Disabling PIM6 SM snooping on a VLAN When PIM6 SM snooping is enabled globally, you can still disable it for a specific VLAN. For example, the following commands disable PIM6 SM snooping for VLAN 20. This setting overrides the global setting. device(config)#vlan 20 device(config-vlan-20)#multicast6 disable-pimsm-snoop Syntax: [no] multicast6 disable-pimsm-snoop PIM6 SM snooping show commands This section shows how to display information about PIM6 SM snooping. Displaying PIM6 SM snooping information To display PIM6 SM snooping information, enter the show ipv6 multicast pimsm-snooping command. Device#show ipv6 multicast pimsm-snooping Example: Port: 7/3 (ref_count=1) ref_count: no of entries in pimsm snoop cache added this oif) vlan 503, has 1 caches. 1 (* 2:3) has 1 pim join ports out of 1 OIF 1/1/4 (ref_count=2), Refer to the FastIron Command Reference for more information on PIM SM commands. 64 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Traffic Reduction Displaying PIM6 SM snooping for a VLAN You can display PIM6 SM snooping information for all groups by entering the following command at any level of the CLI on a Layer 2 switch. Device#show ipv6 multicast pimsm-snooping vlan 25 vlan 25, has 2 caches. 1 (0:11 1:3) has 2 pim join ports out of 2 OIF 1/1/2 (age=30), 2/1/3 (age=30), 1/1/2 has 1 src: 15::11(30), 2/1/3 has 1 src: 15::11(30), 2 (0:16 1:3) has 2 pim join ports out of 2 OIF 2/1/3 (age=90), 1/1/2 (age=10), 1/1/2 has 1 src: 15::16(10), Syntax: show ipv6 multicast pimsm-snooping vlan vlan-id Enter the ID of the VLAN for the vlan-id parameter. The following table describes the information displayed by the show ipv6 multicast pimsm-snooping command. Field Description VLAN ID The port-based VLAN to which the following information applies and the number of members in the VLAN. PIM6 SM Neighbor list The PIM6 SM routers that are attached to the Layer 2 Switch ports. The value following "expires" indicates how many seconds the Layer 2 Switch will wait for a hello message from the neighbor before determining that the neighbor is no longer present and removing the neighbor from the list. Multicast Group The IP address of the multicast group. NOTE The fid and camindex values are used by Brocade Technical Support for troubleshooting. Forwarding Port The ports attached to the group receivers. A port is listed here when it receives a join message for the group, an MLD membership report for the group, or both. PIMv2 Group Port The ports on which the Layer 2 Switch has received PIM6 SM join messages for the group. Source, Port list The IP address of each PIM6 SM source and the Layer 2 Switch ports connected to the receivers of the source. Refer to the FastIron Command Reference for more information on PIM SM commands. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 65 IPv6 Multicast Traffic Reduction 66 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ ∙ Overview of IP multicasting.........................................................................................................................................................................................67 Support for Multicast Multi-VRF..............................................................................................................................................................................68 Changing global IP multicast parameters........................................................................................................................................................... 68 Adding an interface to a multicast group............................................................................................................................................................... 71 Multicast non-stop routing........................................................................................................................................................................................... 72 Passive multicast route insertion ............................................................................................................................................................................. 74 IP multicast boundaries..................................................................................................................................................................................................75 PIM Dense ............................................................................................................................................................................................................................ 77 PIM convergence on MAC movement................................................................................................................................................................ 89 PIM Sparse ..........................................................................................................................................................................................................................89 PIM convergence on MAC movement (PIM sparse mode).....................................................................................................................96 IP multicast PIM neighbor filter.................................................................................................................................................................................96 PIM Passive.......................................................................................................................................................................................................................... 97 Multicast Outgoing Interface (OIF) list optimization......................................................................................................................................98 Displaying system values............................................................................................................................................................................................. 98 Displaying PIM resources............................................................................................................................................................................................ 98 Displaying PIM Sparse configuration information and statistics......................................................................................................... 100 Clearing the PIM forwarding cache...........................................................................................................................................................................111 Displaying PIM traffic statistics....................................................................................................................................................................................111 Clearing the PIM message counters...................................................................................................................................................................... 113 Displaying PIM RPF........................................................................................................................................................................................................ 113 Configuring Multicast Source Discovery Protocol (MSDP)...................................................................................................................... 113 Configuring MSDP mesh groups ......................................................................................................................................................................... 126 MSDP Anycast RP......................................................................................................................................................................................................... 128 PIM Anycast RP............................................................................................................................................................................................................... 132 Static multicast routes................................................................................................................................................................................................... 134 IGMP Proxy.........................................................................................................................................................................................................................134 IGMP V3................................................................................................................................................................................................................................137 Overview of IP multicasting Multicast protocols allow a group or channel to be accessed over different networks by multiple stations (clients) for the receipt and transmission of multicast data. Distribution of stock quotes, video transmissions such as news services and remote classrooms, and video conferencing are all examples of applications that use multicast routing. Brocade devices support the Protocol-Independent Multicast (PIM) protocol, along with the Internet Group Membership Protocol (IGMP). PIM is a broadcast and pruning multicast protocol that delivers IP multicast datagrams. This protocol employs reverse path lookup check and pruning to allow source-specific multicast delivery trees to reach all group members. PIM builds a different multicast tree for each source and destination host group. Multicast terms The following terms are commonly used in discussing multicast-capable devices. These terms are used throughout this chapter: Node: A device. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 67 IPv4 Multicast Protocols Root Node: The node that initiates the tree building process. It is also the device that sends the multicast packets down the multicast delivery tree. Upstream: The direction from which a device receives multicast data packets. An upstream device is a node that sends multicast packets. Downstream: The direction to which a device forwards multicast data packets. A downstream device is a node that receives multicast packets from upstream transmissions. Group Presence: A multicast group has been learned from one of the directly connected interfaces. Members of the multicast group are present on the device. Intermediate nodes: Devices that are in the path between source devices and leaf devices. Leaf nodes: Devices that do not have any downstream devices. Multicast Tree: A unique tree is built for each source group (S,G) pair. A multicast tree is comprised of a root node and one or more nodes that are leaf or intermediate nodes. Support for Multicast Multi-VRF Multicast Multi-VRF support for the Brocade device includes the following: ∙ PIM (PIM-SM and PIM-DM) The procedure for configuring PIM within a VRF instance is described in the “Enabling PIM on the device and an interface” and the “Configuring global PIM Sparse parameters” sections. system-max command changes Several changes have been made to thesystem-max commands in support of Multicast Multi-VRF. The system-max pim-mcache command has been deprecated and replaced by the system max pim-hw-mcache command. The following new runtime commands have been introduced: max-mcache This command is described in the “Defining the maximum number of PIM cache entries” section. ip igmp max-group-address This command, which is described in the “Defining the maximum number of IGMP group ” section, addresses replaces the system-max igmp-max-group-address command. Show and clear command support The following show and clear commands support Multicast Multi-VRF: ∙ clear ip igmp [ vrf vrf-name ] cache ∙ clear ip igmp [ vrf vrf-name ] traffic ∙ show ip igmp [vrf vrf-name] group [group-address [detail] [tracking]] ∙ show ip igmp [vrf vrf-name] interface [ve number | ethernet unit/slot/port | tunnel num] ∙ show ip igmp [vrf vrf-name] settings ∙ show ip igmp [vrf vrf-name] traffic Changing global IP multicast parameters The following sections apply to PIM-DM, PIM-SM, and IGMP. 68 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols Concurrent support for multicast routing and snooping Multicast routing and multicast snooping instances work concurrently on the same device. For example, you can configure PIM routing on certain VEs interfaces and snooping on other VEs or VLANs. The limitation is that either multicast snooping or routing can be enabled on a VE interface or VLAN, but not on both. This is because all of the multicast data and control packets (IGMP, PIM) received on the snooping VLAN are handled by multicast snooping and do not reach the multicast routing component. Similarly, any multicast data or control packets received on a VE interface enabled with PIM routing are handled by the PIM routing component and are not seen by the IGMP or PIM snooping component. The following considerations apply when configuring concurrent operation of Multicast Routing and Snooping. 1. Either multicast snooping or routing can be enabled on a VE or VLAN but not both. 2. Snooping can be enabled globally by configuring the ip multicast active | passive command. 3. The global snooping configuration is inherited by all current VLANs that are not enabled for multicast routing. 4. The global snooping configuration is also inherited by all new VLANs. Enabling multicast routing on a newly created VLAN or VE automatically disables snooping on the VLAN or VE. 5. When a VLAN-level snooping is configured, it is displayed. Defining the maximum number of PIM cache entries You can use the following run-time command to define the maximum number of repeated PIM traffic being sent from the same source address and being received by the same destination address. To define this maximum for the default VRF, enter the following commands. device(config)# router pim device(config-pim-router)# max-mcache 999 Syntax: [no] max-cache num The num variable specifies the maximum number of multicast cache entries for PIM in the default VRF. If not defined by this command, the maximum value is determined by the system-max pim-hw-mcache command or by available system resources. To define the maximum number of PIM Cache entries for a specified VRF, use the following command. device(config)# router pim vrf vpn1 device(config-pim-router-vrf-vpn1)# max-mcache 999 Syntax: [no] router pim [ vrf vrf-name ] The vrf parameter specified with the router pim command allows you to configure the max-mcache command for a virtual routing and forwarding (VRF) instance specified by the vrf-name variable. The num variable specifies the maximum number of multicast cache entries for PIM in the specified VRF. If not defined by this command, the maximum value is determined by the system-max command option pim-hw-mcache or by available system resources. Defining the maximum number of IGMP group addresses You can use the ip igmp max-group-address run-time command to set the maximum number of IGMP addresses for the default virtual routing and forwarding (VRF) instance or for a specified VRF. To define this maximum for the default VRF, enter the following command. device(config)# ip igmp max-group-address 1000 Syntax: [no] ip igmp max-group-address num The num variable specifies the maximum number of IGMP group addresses for all VRFs, including the default VRF. If not defined by this command, the maximum value is determined by available system resources. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 69 IPv4 Multicast Protocols To define this maximum for a specified VRF, enter the following commands. device(config)# vrf vpn1 device(config-vrf-vpn1)# address-family ipv4 device(config-vrf-vpn1-ipv4)# ip igmp max-group-address 1000 Syntax: [no] vrf vrf-name Syntax: [no] address-family ipv4 Syntax: [no] ip igmp max-group-address num The vrf parameter specifies the VRF instance specified by the vrf-name variable. The num parameter specifies the number of IGMP group addresses that you want to make available for the specified VRF. If not defined by this command, the maximum value is determined by available system resources. Changing IGMP V1 and V2 parameters IGMP allows Brocade devices to limit the multicast of IGMP packets to only those ports on the device that are identified as IP Multicast members. The device actively sends out host queries to identify IP Multicast groups on the network, inserts the group information in an IGMP packet, and forwards the packet to IP Multicast neighbors. The following IGMP V1 and V2 parameters apply to PIM: ∙ IGMP query interval - Specifies how often the Brocade device queries an interface for group membership. Possible values are 2 - 3600. The default is 125. ∙ IGMP group membership time - Specifies how many seconds an IP Multicast group can remain on a Brocade device interface in the absence of a group report. Possible values are 5 - 26000. The default is 260. ∙ IGMP maximum response time - Specifies how many seconds the Brocade device will wait for an IGMP response from an interface before concluding that the group member on that interface is down and removing the interface from the group. Possible values are 1 - 25. The default is 10. Modifying IGMP (V1 and V2) query interval period The IGMP query interval period defines how often a device will query an interface for group membership. Possible values are 2 to 3600 seconds and the default value is 125 seconds. To modify the default value for the IGMP (V1 and V2) query interval, enter the following: Device(config)# ip igmp query-interval 120 Syntax: [no] ip igmp query-interval num The num variable specifies the number of seconds and can be a value from 2 to 3600. The default value is 125. Modifying IGMP (V1 and V2) membership time Group membership time defines how long a group will remain active on an interface in the absence of a group report. Possible values are from 5 to 26000 seconds and the default value is 260 seconds. To define an IGMP (V1 and V2) membership time of 240 seconds, enter the following. device(config)# ip igmp group-membership-time 240 70 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols Syntax: [no] ip igmp group-membership-time num The num variable specifies the number of seconds and can be a value from 5 to 26000. The default value is 260. Modifying IGMP (V1 and V2) maximum response time Maximum response time defines how long the Brocade device will wait for an IGMP (V1 and V2) response from an interface before concluding that the group member on that interface is down and removing the interface from the group. Possible values are 1 to 25. The default is 10. To change the IGMP (V1 and V2) maximum response time, enter a command such as the following at the global CONFIG level of the CLI. Device(config)# ip igmp max-response-time 8 Syntax:[no] ip igmp max-response-time num The num variable specifies the number of seconds and can be a value from 1 to 25. The default is 10. Security enhancement for IGMP A security enhancement was made to IGMPv2 to comply with the following recommendation of RFC 2236: “Ignore the Report if you cannot identify the source address of the packet as belonging to a subnet assigned to the interface on which the packet was received.” NOTE When used in applications such as IP-TV (or any multicast application in general), the administrator should ensure that the settop box (or multicast client) is configured on the same subnet as the v.e. configured on the device. This is typically the case but is emphasized here to ensure correct operation. Without this configuration, IGMP messages received by the device are ignored, which causes an interruption in any multicast traffic directed towards the set-top box (multicast client). Adding an interface to a multicast group You can manually add an interface to a multicast group. This is useful in the following cases: ∙ Hosts attached to the interface are unable to add themselves as members of the group using IGMP. ∙ There are no members for the group attached to the interface. When you manually add an interface to a multicast group, the device forwards multicast packets for the group but does not itself accept packets for the group. You can manually add a multicast group to individual ports only. If the port is a member of a virtual routing and forwarding (VRF) interface, you must add the ports to the group individually. To manually add a port to a multicast group, enter a command such as the following at the configuration level for the port. Device(config-if-e10000-1/1/1)# ip igmp static-group 224.2.2.2 This command adds port 1/1 to multicast group 224.2.2.2. To add a port that is a member of a VRF interface to a multicast group, enter a command such as the following at the configuration level for the virtual routing interface. Device(config-vif-1)# ip igmp static-group 224.2.2.2 ethernet 1/4/2 This command adds port 1/4/2 in VRF interface 1 to multicast group 224.2.2.2. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 71 IPv4 Multicast Protocols Syntax: [no] ip igmp static-group ip-addr [ ethernet unit/slot//port ] The ip-addr variable specifies the group number. The ethernet unit/slot//port parameter specifies the port number. Use this parameter if the port is a member of a VRF interface, and you are entering this command at the configuration level for the VRF interface. Manually added groups are included in the group information displayed by the following commands: ∙ show ip igmp group ∙ show ip pim group To display static multicast groups in the default VRF, enter the following command. device#show ip igmp static Group Address Interface Port List ---------------------------------224.2.2.2 v1 ethe 1/4/2 Syntax: show ip igmp [ vrf vrf_name ] static The vrf parameter allows you to display static IGMP groups for the VRF instance specified by the vrf_name variable. Multicast non-stop routing Multicast non-stop routing (NSR) provides hitless-failover support on all platforms for IPv4 multicast features (default and non-default VRFs): PIM-DM, PIM-SM, and PIM-SSM. If multicast NSR is enabled, the software state is kept in sync between the active and standby modules. The standby module is NSR ready when the software state of the standby and active modules are in sync. When the standby module is NSR ready, a hitless-failover does not result in a disruption to the multicast forwarding state or traffic If Multicast NSR is not enabled, or if the standby module is not NSR ready, the software state of the standby and active modules are not in sync. In this case, after a switchover or failover occurs, the new active module enters protocol learning phase for a duration of 55 seconds. During this phase, it learns the protocol state information from its PIM neighbors and local clients. During this period, new multicast flows will not be forwarded, but the existing mutlicast flows (which existed prior to switchover or failover) are forwarded in hardware without any disruption. At the end of the period, all the existing flows are deleted from hardware and they are reprogrammed as per the newly learned state information. Multicast traffic will incur a slight disturbance until the new active module reprograms the hardware with new forwarding state information. The following message is displayed on the console of the active and standby modules to indicate that the standby module is NSR ready: Mcastv4 is NSR ready NOTE During a hitless-upgrade on FSX platforms, the new active module will always perform the 55 second deferred hardware cleanup even if the NSR is enabled. Configuration considerations 72 ∙ Multicast NSR is not supported for IPv6 multicast. ∙ When multicast NSR is turned on, unicast routing must be protected by NSR or graceful restart on all multicast VRFs. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols Configuring multicast non-stop routing To globally enable multicast non-stop routing for all VRFs, enter the ip multicast-nonstop-routing command on the CLI as shown in this example: Device(config)#ip multicast-nonstop-routing Syntax: ip multicast-nonstop-routing During a hitless upgrade and switchover, this syslog message is generated on the CLI. The message displayed depends on which version of PIM is configured. PIM v4 is configured MCASTv4 protocol receives switchover event Mcastv4 protocol switchover done PIM v6 is configured MCASTv6 protocol receives switchover event Mcastv6 protocol switchover done The syslog message shows the state transition of multicast NSR as the standby module takes over as the active module. The multicast data traffic will continue to flow during state transition. Displaying the multicast NSR status To display the multicast nonstop routing (NSR) status, enter the following command: Device# show ip pim nsr Global Mcast NSR Status NSR: ON Switchover In Progress Mode: FALSE The following table displays the output from the show ip pim nsr command. Field Description NSR The NSR field indicates whether the ip multicast-nonstop-routing command is enabled (ON) or disabled (OFF). Switchover in Progress Mode The Switchover in Progress Mode field indicates whether the multicast traffic is in the middle of a switchover (displaying a TRUE status), or not (displaying a FALSE status). Displaying counter and statistic information for multicast NSR To display multicast NSR counter and statistic information, enter the following command. device#show ip pim counter nsr Mcache sync (entity id: 203) pack: 0 unpack: 0 ack: 0 RPset sync (entity id: 201) pack: 0 unpack: 0 ack: 0 BSR status (entity id: 202) pack: 1 unpack: 0 ack: 1 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 73 IPv4 Multicast Protocols Syntax: show ip pim [vrf vrf_name ] counter nsr The vrf parameter allows you to display IP PIM counters for the VRF instance specified by the vrf-name variable. The following table displays the output from the show ip pim counter nsr command. This field... Displays... Mcache sync The mcache NSR sync queue that carries the NSR sync message for mcache updates. pack The number of NSR sync messages that are packed from the active module to the standby module. unpack The number of NSR sync messages that are received and unpacked by the standby module. ack The number of NSR sync acknowledgements received by the active module. RPset sync The RPset sync queue that carries the NSR sync message for RPset update. BSR status The BSR status sync queue that carries the NSR sync message for BSR information update. Passive multicast route insertion To prevent unwanted multicast traffic from being sent to the CPU, PIM routing and passive multicast route insertion (PMRI) can be used together to ensure that multicast streams are forwarded out only ports with interested receivers and unwanted traffic is dropped in hardware on Layer 3 switches. PMRI enables a Layer 3 switch running PIM Sparse to create an entry for a multicast route (for example, (S,G)), with no directly attached clients or when connected to another PIM device (transit network). When a multicast stream has no output interfaces (OIF), the Layer 3 switch can drop packets in hardware if the multicast traffic meets either of the following conditions: In PIM-SM: ∙ – – – The route has no OIF and If directly connected source passed source reverse-path forwarding (RPF) check and completed data registration with reverse path (RP) or If non directly connected source passed source RPF check. In PIM-DM: ∙ – – – The route has no OIF and passed source RPF check and Device has no downstream PIM neighbor. If the OIF is inserted after the hardware-drop entries are installed, the hardware entries will be updated to include the OIFs. NOTE Disabling hardware-drop does not immediately take away existing hardware-drop entries, they will go through the normal route aging processing when the traffic stops. 74 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols Configuring PMRI PMRI is enabled by default. To disable PMRI, enter commands such as the following. device(config)# router pim device(config-pim-router)# hardware-drop-disable Syntax: [no] hardware-drop-disable Displaying hardware-drop Use the show ip pim sparse command to display if the hardware-drop feature has been enabled or disabled. device(config)#show ip pim sparse Global PIM Sparse Mode Settings Maximum Mcache : 12992 Current Count : Hello interval : 30 Neighbor timeout : Join/Prune interval : 60 Inactivity interval : Hardware Drop Enabled : Yes Prune Wait Interval : Bootstrap Msg interval : 60 Candidate-RP Msg interval : Register Suppress Time : 60 Register Probe Time : Register Stop Delay : 10 Register Suppress interval : SSM Enabled : Yes SPT Threshold : SSM Group Range : 232.0.0.0/8 Route Precedence : mc-non-default mc-default uc-non-default 0 105 180 3 60 10 60 1 uc-default IP multicast boundaries The IP multicast boundary feature is designed to selectively allow or disallow multicast flows to configured interfaces. The ip multicast-boundary command allows you to configure a boundary on a PIM enabled interface by defining which multicast groups may not forward packets over a specified interface. This includes incoming and outgoing packets. By default, all interfaces that are enabled for multicast are eligible to participate in a multicast flow provided they meet the multicast routing protocol’s criteria for participating in a flow. Configuration considerations ∙ Only one ACL can be bound to any interface. ∙ Normal ACL restrictions apply as to how many software ACLs can be created, but there is no hardware restrictions on ACLs with this feature. ∙ Creation of a static IGMP client is allowed for a group on a port that may be prevented from participation in the group on account of an ACL bound to the port’s interface. In such a situation, the ACL would prevail and the port will not be added to the relevant entries. ∙ Either standard or extended ACLs can be used with the multicast boundary feature. When a standard ACL is used, the address specified is treated as a group address and NOT a source address. ∙ When a boundary is applied to an ingress interface, all packets destined to a multicast group that is filtered out will be dropped by software. Currently, there is no support to drop such packets in hardware. ∙ The ip multicast-boundary command may not stop clients from receiving multicast traffic if the filter is applied on the egress interface up-stream from RP. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 75 IPv4 Multicast Protocols Configuring multicast boundaries To define boundaries for PIM enabled interfaces, enter a commands such as the following. device(config)# interface ve 40 device(config-vif-40)#ip multicast-boundary MyBrocadeAccessList Syntax: [no] ip multicast-boundary acl-spec Use the acl-spec parameter to define the number or name identifying an access list that controls the range of group addresses affected by the boundary. Use the no ip multicast boundary command to remove the boundary on a PIM enabled interface. The ACL, MyBrocadeAccessList can be configured using standard ACL syntax. Some examples of how ACLs can be used to filter multicast traffic are as follows: Standard ACL to permit multicast traffic To permit multicast traffic for group 225.1.0.2 and deny all other traffic, enter the following command. device(config)# access-list 10 permit host 225.1.0.2 device(config)# access-list 10 deny any Extended ACL to deny multicast traffic To deny multicast data traffic from group 225.1.0.1 and permit all other traffic, enter the following command. device(config)# access-list 101 deny ip any host 225.1.0.1 device(config)# access-list 101 permit ip any any Extended ACL to permit multicast traffic To permit multicast data traffic from source 97.1.1.50 for group 225.1.0.1 and deny all other traffic, enter the following commands: Device(config)# access-list 102 permit ip host 97.1.1.50 host 225.1.0.1 Device(config)# access-list 102 deny ip any any Displaying multicast boundaries To display multicast boundary information, enter the show ip pim interface command. device# show ip pim interface ethernet 1/1/7 Flags : SM - Sparse Mode v2, DM - Dense Mode v2, P - Passive Mode ---------+---------------+----+---+-----------------------+---+---------+-------+------+---------+ Interface|Local |Mode|St | Designated Router |TTL|Multicast| VRF | DR | Override |Address | | |Address Port|Thr|Boundary | | Prio | Interval ---------+---------------+----+---+-----------------------+---+---------+-------+------+---------+ e1/1/7 30.0.0.1 SM Ena Itself 1 None default 1 3000ms Total Number of Interfaces : 1 Syntax: show ip pim [ vrf vrf-name ] interface [ethernet unit/slot/port | loopback num | ve num | tunnel num ] The vrf keyword allows you to display multicast boundary information for the VRF instance identified by the vrf-name variable. The ethernet parameter specifies the physical port by its unit, slot, and port number. The loopback parameter specifies the loopback port. The veparameter specifies a virtual interface. The tunnel parameter specifies a GRE tunnel interface that is being configured. The GRE tunnel interface is enabled under the device PIM configuration. 76 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols The following table describes the output from the show ip pim interface ethernet command. Field Description Interface Name of the interface. Local Address IP address of the interface. Mode PIM mode, dense or sparse.. St PIM status for this interface, enabled or disabled. Designated Router Address, Port Address, port number of the designated router. TTL Thr Time to live threshold. Multicast packets with TTL less than this threshold value are not be forwarded on this interface. Multicast Boundary Multicast boundary ACL, if one exists. VRF Name of the VRF. DR Prio Designated router priority assigned to this interface. Override Interval Effective override interval in milliseconds. PIM Dense NOTE This section describes the "dense" mode of PIM, described in RFC 3973. Refer to PIM Sparse on page 89 for information about PIM Sparse. PIM was introduced to simplify some of the complexity of the routing protocol at the cost of additional overhead tied with a greater replication of forwarded multicast packets. PIM builds source-routed multicast delivery trees and employs reverse path check when forwarding multicast packets. There are two modes in which PIM operates: Dense and Sparse. The Dense Mode is suitable for densely populated multicast groups, primarily in the LAN environment. The Sparse Mode is suitable for sparsely populated multicast groups with the focus on WAN. PIM uses the IP routing table instead of maintaining its own, thereby being routing protocol independent. Initiating PIM multicasts on a network Once PIM is enabled on each device, a network user can begin a video conference multicast from the server on R1 as shown in Figure 3 on page 79. When a multicast packet is received on a PIM-capable device interface, the interface checks its IP routing table to determine whether the interface that received the message provides the shortest path back to the source. If the interface does provide the shortest path back to the source, the multicast packet is then forwarded to all neighboring PIM devices. Otherwise, the multicast packet is discarded and a prune message is sent back upstream. In Figure 3 on page 79, the root node (R1) is forwarding multicast packets for group 229.225.0.1, which it receives from the server, to its downstream nodes, R2, R3, and R4. Device R4 is an intermediate device with R5 and R6 as its downstream devices. Because R5 and R6 have no downstream interfaces, they are leaf nodes. The receivers in this example are those workstations that are resident on devices R2, R3, and R6. Pruning a multicast tree As multicast packets reach these leaf devices, the devices check their IGMP databases for the group. If the group is not in the IGMP database of the device, the device discards the packet and sends a prune message to the upstream device. The device that discarded the packet also maintains the prune state for the source, group (S,G) pair. The branch is then pruned (removed) from the multicast tree. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 77 IPv4 Multicast Protocols No further multicast packets for that specific (S,G) pair will be received from that upstream device until the prune state expires. You can configure the PIM Prune Timer (the length of time that a prune state is considered valid). For example, in the “Transmission of multicast packets from the source to host group members” figure, the sender with address 207.95.5.1 is sending multicast packets to the group 229.225.0.1. If a PIM device receives any groups other than that group, the device discards the group and sends a prune message to the upstream PIM device. In the “Pruning leaf nodes from a multicast tree” figure, device R5 is a leaf node with no group members in its IGMP database. Therefore, the device must be pruned from the multicast tree. R5 sends a prune message upstream to its neighbor device R4 to remove itself from the multicast delivery tree and install a prune state, as seen in the “Pruning leaf nodes from a multicast tree” figure. Device 5 will not receive any further multicast traffic until the prune age interval expires. When a node on the multicast delivery tree has all of its downstream branches (downstream interfaces) in the prune state, a prune message is sent upstream. In the case of R4, if both R5 and R6 are in a prune state at the same time, R4 becomes a leaf node with no downstream interfaces and sends a prune message to R1. With R4 in a prune state, the resulting multicast delivery tree would consist only of leaf nodes R2 and R3. 78 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols FIGURE 3 Transmission of multicast packets from the source to host group members FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 79 IPv4 Multicast Protocols FIGURE 4 Pruning leaf nodes from a multicast tree Grafts to a multicast tree A PIM device restores pruned branches to a multicast tree by sending graft messages towards the upstream device. Graft messages start at the leaf node and travel up the tree, first sending the message to its neighbor upstream device. In the preceding example, if a new 229.255.0.1 group member joins on device R6, which was previously pruned, a graft is sent upstream to R4. Since the forwarding state for this entry is in a prune state, R4 sends a graft to R1. Once R4 has joined the tree, R4 along with R6 once again receive multicast packets. Prune and graft messages are continuously used to maintain the multicast delivery tree. You do not need to configure anything. 80 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols PIM DM versions The Brocade device supports only PIM V2. PIM DM V2 sends messages to the multicast address 224.0.0.13 (ALL-PIM-ROUTERS) with protocol number 103. Configuring PIM DM NOTE This section describes how to configure the "dense" mode of PIM, described in RFC 1075. Refer to Configuring PIM Sparse on page 91 for information about configuring PIM Sparse. Enabling PIM on the device and on an interface By default, PIM is disabled. To enable PIM: ∙ Enable the feature globally. ∙ Configure the IP interfaces that will use PIM. ∙ Enable PIM locally on the ports that have the IP interfaces you configured for PIM. Suppose you want to initiate the use of desktop video for fellow users on a sprawling campus network. All destination workstations have the appropriate hardware and software but the devices that connect the various buildings need to be configured to support PIM multicasts from the designated video conference server as shown in the “Pruning leaf nodes from a multicast tree” figure. PIM is enabled on each of the devices shown in the “Pruning leaf nodes from a multicast tree” figure, on which multicasts are expected. You can enable PIM on each device independently or remotely from one of the devices with a Telnet connection. Follow the same steps for each device. All changes are dynamic. Globally enabling and disabling PIM To globally enable PIM, enter the following command. Device(config)# router pim Syntax:[no] router pim The [no] router pim command behaves in the following manner: ∙ Entering a router pim command to enable PIM does not require a software reload. ∙ Entering a no router pim command removes all configuration for PIM multicast on a device (router pim level) only. Enabling PIM for a specified VRF To enable PIM for the VRF named "blue", use the following commands. Device(config)# router pim vrf blue Syntax: [no] router pim [ vrf vrf-name ] The vrf parameter allows you to configure PIM (PIM-DM and PIM-SM) on the virtual routing and forwarding instance (VRF) specified by the vrf-name variable. All PIM parameters available for the default device instance are configurable for a VRF-based PIM instance. The [no] router pim vrf command behaves in the following manner: ∙ Entering the router pim vrf command to enable PIM does not require a software reload. ∙ Entering a no router pim vrf command removes all configuration for PIM multicast on the specified VRF. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 81 IPv4 Multicast Protocols Modifying PIM global parameters PIM global parameters come with preset values. The defaults work well in most networks, but you can modify the following parameters if necessary: ∙ Neighbor timeout ∙ Hello timer ∙ Prune timer ∙ Prune wait timer ∙ Graft retransmit timer ∙ Inactivity timer Modifying neighbor timeout Neighbor timeout is the interval after which a PIM device will consider a neighbor to be absent. Absence of PIM hello messages from a neighboring device indicates that a neighbor is not present. The interval can be set between 3 and 65535 seconds, and it should not be less than 3.5 times the hello timer value. The default value is 105 seconds. To apply a PIM neighbor timeout value of 360 seconds to all ports on the device operating with PIM, enter the following. Device(config)# router pim Device(config-pim-router)# nbr-timeout 360 Syntax: [no] nbr-timeout seconds The default is 105 seconds. The range is 35 to 65535 seconds. Modifying hello timer This parameter defines the interval at which periodic hellos are sent out PIM interfaces. Devices use hello messages to inform neighboring devices of their presence. The interval can be set between 10 and 3600 seconds, and the default rate is 30 seconds. To apply a PIM hello timer of 120 seconds to all ports on the device operating with PIM, enter the following. Device(config)# router pim Device(config-pim-router)# hello-timer 120 Syntax: [no] hello-timer 10-3600 The default is 30 seconds. Modifying prune timer This parameter defines how long a PIM device will maintain a prune state for a forwarding entry. The first received multicast interface is forwarded to all other PIM interfaces on the device. If there is no presence of groups on that interface, the leaf node sends a prune message upstream and stores a prune state. This prune state travels up the tree and installs a prune state. A prune state is maintained until the prune timer expires or a graft message is received for the forwarding entry. The default value is 180 seconds. To set the PIM prune timer to 90, enter the following. Device(config)# router pim Device(config-pim-router)# prune-timer 90 82 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols Syntax: [no] prune-timer seconds The default is 180 seconds. The range is 60 to 3600 seconds. Modifying the prune wait timer The prune-wait command allows you to configure the amount of time a PIM device will wait before stopping traffic to neighbor devices that do not want the traffic. The value can be from zero to 30 seconds. The default is three seconds. A smaller prune wait value reduces flooding of unwanted traffic. A prune wait value of zero causes the PIM device to stop traffic immediately upon receiving a prune message. If there are two or more neighbors on the physical port, then the prune-wait command should not be used because one neighbor may send a prune message while the other sends a join message at the same time, or within less than three seconds. To set the prune wait time to zero, enter the following commands. Device(config)#router pim Device(config-pim-router)#prune-wait 0 Syntax: [no] prune-wait seconds The seconds can be 0 - 30. A value of 0 causes the PIM device to stop traffic immediately upon receiving a prune message. The default is 3 seconds. To view the currently configured prune wait time, enter the show ip pim dense command as described in the Displaying basic PIM Dense configuration information” section. Modifying graft retransmit timer The graft retransmit timer defines the interval between the transmission of graft messages. A graft message is sent by a device to cancel a prune state. When a device receives a graft message, the device responds with a Graft Ack (acknowledge) message. If this Graft Ack message is lost, the device that sent the graft message will resend it. To change the graft retransmit timer from the default of 180 to 90 seconds, enter the following. Device(config)# router pim Device(config-pim-router)# graft-retransmit-timer 90 Syntax: [no] graft-retransmit-timer seconds The default is 180 seconds. The range is from 60 to 3600 seconds. Modifying inactivity timer The device deletes a forwarding entry if the entry is not used to send multicast packets. The PIM inactivity timer defines how long a forwarding entry can remain unused before the device deletes it. To apply a PIM inactivity timer of 90 seconds to all PIM interfaces, enter the following. Device(config)# router pim Device(config-pim-router)# inactivity-timer 90 Syntax: [no] inactivity-timer seconds The default is 180 seconds. The range is from 60 to 3600 seconds. Selection of shortest path back to source By default, when a multicast packet is received on a PIM-capable interface in a multi-path topology, the interface checks its IP routing table to determine the shortest path back to the source. If the alternate paths have the same cost, the first alternate path in the table is FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 83 IPv4 Multicast Protocols picked as the path back to the source. For example, in the following example, the first four routes have the same cost back to the source. However, 137.80.127.3 is chosen as the path to the source since it is the first one on the list. The device rejects traffic from any port other than Port V11 on which 137.80.127.3 resides Total number of IP routes: 19 Type Codes - B:BGP D:Connected I:ISIS S:Static R:RIP O:OSPF Cost - Dist/Metric Destination Gateway Port Cost Type .. 172.17.41.4 137.80.127.3 v11 2 O 172.17.41.4 137.80.126.3 v10 2 O 172.17.41.4 137.80.129.1 v13 2 O 172.17.41.4 137.80.128.3 v12 2 O 172.17.41.8 0.0.0.0 1/2 1 D Failover time in a multi-path topology When a port in a multi-path topology fails, multicast devices, depending on the routing protocol being used, take a few seconds to establish a new path, if the failed port is the input port of the downstream device. Configuring a DR priority The DR priority option lets you give preference to a particular device in the DR election process by assigning it a numerically higher DR priority. This value can be set for IPv4 interfaces. To set a DR priority higher than the default value of 1, use the ip pim dr-priority command as shown: device(config-if-e10000-1/3/24)# ip pim dr-priority 50 Syntax: [no] ip pim dr-priority priority-value The priority-value variable is the value that you want to set for the DR priority. Optional values are: 0 - 65535. The default value is 1. The no option removes the command and sets the DR priority back to the default value of 1. The following information may be useful for troubleshooting. 1. If more than one device has the same DR priority on a subnet (as in the case of default DR priority on all), the device with the numerically highest IP address on that subnet is elected as the DR. 2. The DR priority information is used in the DR election ONLY IF ALL the PIM devices connected to the subnet support the DR priority option. If there is at least one PIM device on the subnet that does not support this option, then the DR election falls back to the backwards compatibility mode in which the device with the numerically highest IP address on the subnet is declared the DR regardless of the DR priority values. Displaying basic PIM Dense configuration information To display PIM Dense configuration information, enter the following command at any CLI level. Device(config)# show ip pim dense Global PIM Dense Mode Settings Maximum Mcache : 12992 Current Count : 2 Hello interval : 30 Neighbor timeout : 105 Join/Prune interval : 60 Inactivity interval : 180 Hardware Drop Enabled : Yes Prune Wait Interval : 3 Graft Retransmit interval : 180 Prune Age : 180 Route Precedence : mc-non-default mc-default uc-non-default uc-default Syntax: show ip pim [ vrf vrf-name ] dense The vrf keyword allows you to display PIM dense configuration information for the VRF instance identified by the vrf-name variable. 84 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols This display shows the following information. Field Description Maximum Mcache The maximum number multicast cache entries allowed on the device. Current Count The number of multicast cache entries currently used. Hello interval How frequently the device sends hello messages out the PIM dense interfaces. Neighbor timeout The interval after which a PIM device will consider a neighbor to be absent. Join/Prune interval How long a PIM device will maintain a prune state for a forwarding entry. Inactivity interval How long a forwarding entry can remain unused before the device deletes it. Hardware Drop Enabled Displays Yes if the Passive Multicast Route Insertion feature is enabled and No if it is not. Prune Wait Interval The amount of time a PIM device waits before stopping traffic to neighbor devices that do not want the traffic. The value can be from zero to three seconds. The default is three seconds. Graft Retransmit interval The interval between the transmission of graft messages. Prune Age The number of packets the device sends using the path through the RP before switching to using the SPT path. Route Precedence The route precedence configured to control the selection of routes based on the four route types: ∙ Non-default route from the mRTM ∙ Default route from the mRTM ∙ Non-default route from the uRTM ∙ Default route from the uRTM Displaying all multicast cache entries in a pruned state Use the following command to display all multicast cache entries that are currently in a pruned state and have not yet aged out. Device(config)# show ip pim prune 1 (104.1.1.2 231.0.1.1): e2/2,2/2(150) 2 (108.1.1.100 231.0.1.1): e2/2,2/2(150) 3 (104.1.1.2 231.0.1.2): e2/2,2/2(150) 4 (108.1.1.100 231.0.1.2): e2/2,2/2(150) 5 (108.1.1.100 231.0.1.3): e2/2,2/2(150) 6 (104.1.1.2 231.0.1.4): e2/2,2/2(150) 7 (108.1.1.100 231.0.1.4): e2/2,2/2(150) 8 (104.1.1.2 231.0.1.5): e2/2,2/2(150) 9 (108.1.1.100 231.0.1.5): e2/2,2/2(150) Total Prune entries: 9 Syntax: show ip pim [vrf vrf-name ] prune FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 85 IPv4 Multicast Protocols Displaying all multicast cache entries You can use the following command to display all multicast cache entries. Brocade(config)# show ip pim mcache IP Multicast Mcache Table Entry Flags : SM - Sparse Mode, SSM - Source Specific Multicast, DM - Dense Mode RPT - RPT Bit, SPT - SPT Bit, LSRC - Local Source, LRCV - Local Receiver HW - HW Forwarding Enabled, FAST - Resource Allocated, TAG - Need For Replication Entry REGPROB - Register In Progress, REGSUPP - Register Suppression Timer MSDPADV - Advertise MSDP, NEEDRTE - Route Required for Src/RP, PRUN - DM Prune Upstream Interface Flags: IM - Immediate, IH - Inherited, WA - Won Assert MJ - Membership Join, MI - Membership Include, ME - Membership Exclude BR - Blocked RPT, BA - Blocked Assert, BF - Blocked Filter, BI - Blocked IIF Total entries in mcache: 20 1 (140.140.140.3, 225.0.0.1) in v340 (tag e1/1/8), Uptime 00:00:02 Rate 0 (DM) Source is directly connected Flags (0x200004e1) DM HW FAST TAG fast ports: ethe 1/4/6 ethe 1/8/26 AgeSltMsk: 1, L2 FID: 8188, DIT: 3 , AvgRate: 0, profile: none Forwarding_oif: 2 L3 (HW) 2: TR(e1/4/6,e1/4/6)(VL330), 00:00:02/0, Flags: IM e1/8/26(VL310), 00:00:02/0, Flags: IM Src-Vlan: 340 Syntax: show ip pim mcache [source-address | group-address | counts | dense | dit-idx | g_entries | receiver | sg_entries | sparse | ssm ] The source-address parameter selects the multicast cache source address. The group-address parameter selects the multicast cache group address. The counts keyword indicates the count of entries. The dense keyword displays only the PIM Dense Mode entries. The dit-idx variable allows you to display all entries that match a specified dit. The g_entries keyword displays only the (*, G) entries. The receiver keyword allows you to display all entries that egress a specified interface. The sg_entries keyword displays only the (S, G) entries. The sparse keyword displays only the PIM Sparse Mode entries. The ssm keyword displays only the SSM entries. TABLE 2 Output fields from the show ip pim mcache command Field Description Total entries in mcache Shows the total number of PIM mcache entries MJ Membership Join MI Membership Include ME Membership Exclude - Legend for the mcache entry printed once per page, it gives the explanation of each of the flags used in the entry. BR Blocked RPT BA Blocked Assert BF Blocked Filter BI Blocked IIF Uptime Shows the software entry uptime. 86 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols TABLE 2 Output fields from the show ip pim mcache command (continued) Field Description Rate Shows the total number of packets per second that have been forwarded using the hardware programmed forwarding entry (the (S,G) entry programmed in hardware or (*,G) entries if (*,G) based forwarding is enabled). The rate is displayed for all entries when the fwd_fast flag is set on the active module. upstream neighbor Shows the upstream neighbor for the Source/RP based on the type of entry. For (*,G) it shows the upstream neighbor towards the RP. For (S,G) entries it shows the upstream neighbor towards the source. Flags Flags Represent Entry flags in hex format in the braces. And indicates the meaning of the flags set in abbreviated string whose explanations are as follows. Only shows the flags which are set. SM - Shows If the entry is created by PIM Sparse Mode DM - Shows If DM mode entry is enabled SSM - Shows If the SSM mode entry is enabled RPT - Shows If the entry is on the Rendezvous Point (RP) SPT - Shows If the entry is on the source tree LSRC - Shows If the source is in a directly-connected interface LRcv - Shows If the receiver is directly connected to the router REG - if the data registration is in progress L2REG - if the source is directly connected to the router REGSUPP - if the register suppression timer is running RegProbe HW - Shows If the candidate for hardware forwarding is enabled FAST - Shows If the resources are allocated for hardware forwarding TAG - Shows If there is a need for allocating entries from the replication table MSDPADV - Shows If RP is responsible for the source and must be advertised to its peers. NEEDRTE - Shows If there is no route to the source and RP is available PRUNE - Shows If PIM DM Prune to upstream is required RP Show the IP address of the RP. fast ports Shows forwarding port mask. AgeSltMsk Shows the slot number on which active module expects ingress traffic. This value is 1 if the entry is programmed in hardware and is 0 if the entry is not programmed in hardware. L2 FID Hardware Resource allocated for the traffic switched to receivers in the ingress VLAN. DIT Hardware Resource allocated for router receivers. RegPkt Shows the number of packets forwarded due to the Register decapsulation. This field is displayed only on the active module. This field displays only those entries for which the device is the RP. However, for a PIM DM entry the RegPkt field is not displayed for the (S,G) entries on the active module. AvgRate Shows the average rate of packets ingressing for this entry over a 30 second period. This field is displayed only on the active module for all FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 87 IPv4 Multicast Protocols TABLE 2 Output fields from the show ip pim mcache command (continued) Field Description entries that are hardware programmed (the fwd_fast flag is set on the active module). Profile Shows the Profile ID associated with the Stream. Number of matching entries Shows the total number of mcache entries matching a particular multicast filter specified. Outgoing interfaces Section This section consists of three parts. L3 OIFs, L2OIFs and Blocked OIFs. And each section has Format of L3/L2/Blocked followed by (HW/SW) followed by count of the number of OIF in each section. Additionally, each section displays the OIFs one per line. And shows the OIF in the format eth/Tr(Vlan) followed by uptime/expiry time, followed by the Flags associated with each OIF. L3 Shows whether the traffic is routed out of the interface. L2 Shows whether the traffic is switched out of the interface. HW Shows whether the entry is hardware forwarded. SW Shows whether the entry is software forwarded. Eth/Tr(VL1) Shows the outgoing interface on the specified VLAN. Flags (explanation of flags in the OIF section) Shows the flags set in each of the Outgoing interface in abbreviated string format whose explanations are as follows. Legend of this shown at the top of each entry IM - Immediate IH - Inherited MJ - Membership Join MI - Membership Include ME - Membership Exclude BR - Blocked due to SG RPT BA - Blocked due to Assert BF - Blocked due to Filter BI - Blocked IIF (Incoming interface) matches OIF Src-VLAN VLAN associated with the ingress interface. MCTPEERF - Traffic Forw By Cluster Peer CCEP Applies only to Layer 3 multicast routing over MCT. This means multicast traffic for this stream is forwarded by cluster peer [remote] CCEP port because of flow load balancing You can use the following command to filter the output to display only entries that egress ethernet port 1/1/1. device#show ip pim mcache receiver ethernet 1/1/1 You can use the following command to filter the output to display only the Source Specific Multicast (SSM) routes in the mcache. device#show ip pim mcache ssm You can use the following command to filter the output to display only the Sparse Mode routes in the mcache. device#show ip pim mcache sparse You can use the following command to filter the output to display only the Dense Mode routes in the mcache. device#show ip pim mcache dense 88 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols You can use the following command to filter the output to display only the entries matching a specific source. device#show ip pim mcache 1.1.1.1 You can use the following command to filter the output to display only the entries matching a specific group. device#show ip pim mcache 239.1.1.1 Displaying information across VRFs Use the following command to display information across all active VRFs. Brocade#show ip pim all-vrf bsr Bootstrap router flow-count Show flowcache counters hw-resource PIM hw resources interface PIM interface neighbor PIM neighbor states resource PIM resources rp-set List of rendezvous point (RP) candidates traffic Active multicast traffic PIM convergence on MAC movement PIM convergence occurs when the PIM module is notified of a topology change. The notification is triggered upon a change in port status, Reverse Path Forwarding (RPF) failure in the hardware, or by the unicast routing module if there is a change in the Layer 3 topology. If the topology change occurs without setting off any of the two events or if the Layer 3 topology change is not notified by the unicast routing module, PIM convergence does not take place. If there is a change in the source traffic at the Layer 2 interface level, the RPF check fails because only loose RPF check is supported (loose RPF check detects the change in the source traffic only at the Layer 3 interface level). A notification for a change in the source traffic at the Layer 2 interface level can be triggered by establishing a signaling process for MAC address movement. The MAC address movement notification triggers RPF check on MAC movement for directly connected sources. The MAC address movement notification can be triggered by configuring the ip multicast-routing rpf-check mac-movement command. The MAC address movement notification triggers a notification to the PIM module which results in convergence. PIM convergence is supported in both PIM Sparse and PIM Dense modes. PIM convergence on MAC movement is supported on the Brocade ICX 6610, FCX, Brocade ICX 6450 (when part of family stacking), Brocade ICX 7750, and Brocade ICX 7450. NOTE PIM convergence on MAC movement is applicable only in a topology where the multicast source port and PIM routers are in the same Layer 2 domain. PIM Sparse Brocade devices support Protocol Independent Multicast (PIM) Sparse version 2. PIM Sparse provides multicasting that is especially suitable for widely distributed multicast environments. The Brocade implementation is based on RFC 2362. In a PIM Sparse network, a PIM Sparse device that is connected to a host that wants to receive information for a multicast group must explicitly send a join request on behalf of the receiver (host). PIM Sparse devices are organized into domains. A PIM Sparse domain is a contiguous set of devices that all implement PIM and are configured to operate within a common boundary. Figure 5 shows a simple example of a PIM Sparse domain. This example shows three devices configured as PIM Sparse devices. The configuration is described in detail following the figure. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 89 IPv4 Multicast Protocols FIGURE 5 Example PIM Sparse domain PIM Sparse device types Devices that are configured with PIM Sparse interfaces also can be configured to fill one or more of the following roles: ∙ PMBR - A PIM device that has some interfaces within the PIM domain and other interface outside the PIM domain. PBMRs connect the PIM domain to the Internet. ∙ BSR - The Bootstrap Router (BSR) distributes RP information to the other PIM Sparse devices within the domain. Each PIM Sparse domain has one active BSR. For redundancy, you can configure ports on multiple devices as candidate BSRs. The PIM Sparse protocol uses an election process to select one of the candidate BSRs as the BSR for the domain. The BSR with the highest BSR priority (a user-configurable parameter) is elected. If the priorities result in a tie, then the candidate BSR interface with the highest IP address is elected. In the example in Figure 5 on page 90, PIM Sparse device B is the BSR. Port 1/2/2 is configured as a candidate BSR. ∙ RP - The RP is the meeting point for PIM Sparse sources and receivers. A PIM Sparse domain can have multiple RPs, but each PIM Sparse multicast group address can have only one active RP. PIM Sparse devices learn the addresses of RPs and the groups for which they are responsible from messages that the BSR sends to each of the PIM Sparse devices. In the example in Figure 5 on page 90, PIM Sparse device B is the RP. Port 1/2/2 is configured as a candidate Rendezvous Point (RP). To enhance overall network performance, the Brocade device uses the RP to forward only the first packet from a group source to the group’s receivers. After the first packet, the Brocade device calculates the shortest path between the receiver and source (the Shortest Path Tree, or SPT) and uses the SPT for subsequent packets from the source to the receiver. The Brocade device calculates a separate SPT for each source-receiver pair. NOTE It is recommended that you configure the same ports as candidate BSRs and RPs. 90 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols RP paths and SPT paths Figure 5 on page 90 shows two paths for packets from the source for group 239.255.162.1 and a receiver for the group. The source is attached to PIM Sparse device A and the recipient is attached to PIM Sparse device C. PIM Sparse device B in is the RP for this multicast group. As a result, the default path for packets from the source to the receiver is through the RP. However, the path through the RP sometimes is not the shortest path. In this case, the shortest path between the source and the receiver is over the direct link between device A and device C, which bypasses the RP (device B). To optimize PIM traffic, the protocol contains a mechanism for calculating the Shortest Path Tree (SPT) between a given source and receiver. PIM Sparse devices can use the SPT as an alternative to using the RP for forwarding traffic from a source to a receiver. By default, the Brocade device forwards the first packet they receive from a given source to a given receiver using the RP path, but forward subsequent packets from that source to that receiver through the SPT. In Figure 5 on page 90, device A forwards the first packet from group 239.255.162.1’s source to the destination by sending the packet to device B, which is the RP. Device B then sends the packet to device C. For the second and all future packets that device A receives from the source for the receiver, device A forwards them directly to device C using the SPT path. Configuring PIM Sparse To configure a Brocade device for PIM Sparse, perform the following tasks: ∙ Configure the following global parameter: – ∙ Configure the following interface parameters: – – – ∙ Enable the PIM Sparse mode of multicast routing. Configure an IP address on the interface Enable PIM Sparse. Identify the interface as a PIM Sparse border, if applicable. Configure the following PIM Sparse global parameters: – – – Identify the Brocade device as a candidate PIM Sparse Bootstrap Router (BSR), if applicable. Identify the Brocade device as a candidate PIM Sparse Rendezvous Point (RP), if applicable. Specify the IP address of the RP (if you want to statically select the RP). NOTE It is recommended that you configure the same Brocade device as both the BSR and the RP. Current limitations The implementation of PIM Sparse in the current software release has the following limitations: ∙ PIM Sparse and regular PIM (dense mode) cannot be used on the same interface. ∙ You cannot configure or display PIM Sparse information using the Web Management Interface. (You can display some general PIM information, but not specific PIM Sparse information.) Configuring global PIM Sparse parameters To configure basic global PIM Sparse parameters, enter commands such as the following on each Brocade device within the PIM Sparse domain. Device(config)# router pim Syntax: [no] router pim FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 91 IPv4 Multicast Protocols NOTE You do not need to globally enable IP multicast routing when configuring PIM Sparse. The command in this example enables IP multicast routing, and enables the PIM Sparse mode of IP multicast routing. The command does not configure the Brocade device as a candidate PIM Sparse Bootstrap Router (BSR) and candidate Rendezvous Point (RP). You can configure a device as a PIM Sparse device without configuring the Brocade device as a candidate BSR and RP. However, if you do configure the device as one of these, it is recommended that you configure the device as both of these. Refer to the “Configuring BSRs” section. Entering a no router pim command does the following: ∙ Disables PIM. ∙ Removes all configuration for PIM multicast on a Brocade device (router pim level) only. Enabling PIM Sparse for a specified VRF To enable PIM for the VRF named "blue", use the following commands. Device(config)# router pim vrf blue Syntax: [no] router pim [vrf vrf-name ] The vrf parameter allows you to configure PIM (PIM-DM and PIM-SM) on the virtual routing instance (VRF) specified by the vrf-name variable. All PIM parameters available for the default router instance are configurable for a VRF-based PIM instance. The no router pim vrf command behaves in the following manner: ∙ Entering the router pim vrf command to enable PIM does not require a software reload. ∙ Entering a no router pim vrf command removes all configuration for PIM multicast on the specified VRF. Configuring PIM interface parameters After you enable IP multicast routing and PIM Sparse at the global level, you must enable it on the individual interfaces connected to the PIM Sparse network. To enable PIM Sparse mode on an interface, enter commands such as the following. device(config)# interface ethernet 1/2/2 device(config-if-e10000-1/2/2)# ip address 207.95.7.1 255.255.255.0 device(config-if-e10000-1/2/2)# ip pim-sparse Syntax: [no] ip pim-sparse The commands in this example add an IP interface to port 1/2/2, then enable PIM Sparse on the interface. If the interface is on the border of the PIM Sparse domain, you also must enter the following command. device(config-if-e10000-1/2/2)# ip pim border Syntax: [no] ip pim border Configuring BSRs In addition to the global and interface parameters described in the previous sections, you need to identify an interface on at least one device as a candidate PIM Sparse Bootstrap router (BSR) and candidate PIM Sparse rendezvous point (RP). NOTE It is possible to configure the device as only a candidate BSR or RP, but it is recommended that you configure the same interface on the same device as both a BSR and an RP. 92 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols This section describes how to configure BSRs. Refer to the “Configuring RPs” section for instructions on how to configure RPs. To configure the device as a candidate BSR, enter commands such as the following. Device(config)# router pim Device(config-pim-router)# bsr-candidate ethernet 1/2/2 30 255 These commands configure the PIM Sparse interface on port 1/2/2 as a BSR candidate, with a hash mask length of 30 and a priority of 255. Syntax: [no] bsr-candidate { ethernet unit/slot/port | loopback num | ve num | tunnel } num hash-mask-length [ priority ] The ethernet unit/slot/port, loopback num, ve num, and tunnel num parameters specify the interface. The device will advertise the IP address of the specified interface as a candidate BSR. ∙ Enter ethernet unit/slot/port for a physical interface (port). ∙ Enter ve num for a virtual interface. ∙ Enter loopback num for a loopback interface. ∙ Enter tunnel num for a GRE tunnel interface. The numhash-mask-length variable specifies the number of bits in a group address that are significant when calculating the group-toRP mapping. You can specify a value from 1 to 32. NOTE it is recommended that you specify 30 for IP version 4 (IPv4) networks. The priority variable specifies the BSR priority. You can specify a value from 0 to 255. When the election process for BSR takes place, the candidate BSR with the highest priority becomes the BSR. The default is 0. Configuring RPs Enter a command such as the following to configure the device as a candidate RP. Device(config-pim-router)# rp-candidate ethernet 1/2/2 Syntax: [no] rp-candidate ethernet { ethernet unit/slot/port | loopback num | ve num | tunnel num } The ethernet unit/slot/port, loopback num, ve num, and tunnel num parameters specify the interface. The device will advertise the IP address of the specified interface as a candidate RP. ∙ Enter ethernet unit/slot/port for a physical interface (port). ∙ Enter ve num for a virtual interface. ∙ Enter loopback num for a loopback interface. ∙ Enter tunnel num for a GRE tunnel interface. By default, this command configures the device as a candidate RP for all group numbers beginning with 224. As a result, the device is a candidate RP for all valid PIM Sparse group numbers. You can change this by adding or deleting specific address ranges. Consider the following when configuring the RP. ∙ When the candidate RP is configured, before explicitly specifying the groups that it serves, the c-rp does, by default, serve all the groups in the PIMSM multicast range, but this includes all groups beginning with 224.x.x.x all the way up to 239.x.x.x. This is reflected in the "rp-candidate add 224.0.0.0 4" line displayed as part of the runtime configuration. This entry will be referred to as the DEFAULT PREFIX. ∙ When any group prefix is explicitly added (and the 224.0.0.0/4 prefix itself can also be explicitly added through CLI), the default prefix is implicitly removed. Now, the only groups served by the candidate RP, are the groups that have been explicitly added. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 93 IPv4 Multicast Protocols ∙ All explicitly added groups can be removed using the "delete" option or "no ... add" option. However, once all the explicitly added groups are deleted from the Candidate RP group prefix list, the default prefix becomes active once more. This default group prefix CANNOT BE REMOVED. ∙ It is not possible to punch holes in the group prefix range. For instance executing rp-candidate add 228.0.0.0/16 and then, rp-candidate delete 228.0.1.0/24 is not permissible. It cannot be used to ensure that the rp-candidate will serve all group prefixes in the 228.0.0.0/16 range except those in the 228.0.1.0/24 range. The following example narrows the group number range for which the device is a candidate RP by explicitly adding a range. Device(config-pim-router)# rp-candidate add 224.126.0.0 16 Syntax: [no] rp-candidate add group-addr mask-bits The group-addr mask-bits variable specifies the group address and the number of significant bits in the subnet mask. In this example, the device is a candidate RP for all groups that begin with 224.126. When you add a range, you override the default. The device then becomes a candidate RP only for the group address ranges you add. You also can delete the configured rp-candidate group ranges by entering the following command. Device(config-pim-router)# rp-candidate delete 224.126.22.0 24 Syntax: [no] rp-candidate delete group-addr mask-bits The usage of the group-addr mask-bits parameter is the same as for the rp-candidate add command. Updating PIM-Sparse forwarding entries with new RP configuration If you make changes to your static RP configuration, the entries in the PIM-Sparse multicast forwarding table continue to use the old RP configuration until they are aged out. The clear pim rp-map command allows you to update the entries in the static multicast forwarding table immediately after making RP configuration changes. This command is meant to be used with rp-address command. To update the entries in a PIM sparse static multicast forwarding table with new RP configuration, enter the following command at the privileged EXEC level of the CLI. Device(config)# clear ip pim rp-map Syntax: clear ip pim [ vrf vrf-name ] rp-map Use the vrf keyword to clear the PIM sparse static multicast forwarding table for a VRF instance specified by the vrf-name variable. Statically specifying the RP It is recommended that you use the PIM Sparse protocol’s RP election process so that a backup RP can automatically take over if the active RP router becomes unavailable. However, if you do not want the RP to be selected by the RP election process but instead you want to explicitly identify the RP by P address, use the rp-address command. If you explicitly specify the RP, the device uses the specified RP for all group-to-RP mappings and overrides the set of candidate RPs supplied by the BSR. 94 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols NOTE Specify the same IP address as the RP on all PIM Sparse devices within the PIM Sparse domain. Make sure the device is on the backbone or is otherwise well connected to the rest of the network. To specify the IP address of the RP, enter commands such as the following. Device(config)# router pim Device(config-pim-router)# rp-address 207.95.7.1 Syntax: [no] rp-address ip-addr The ip-addr variable specifies the IP address of the RP. The command in this example identifies the device interface at IP address 207.95.7.1 as the RP for the PIM Sparse domain. The device uses the specified RP and ignore group-to-RP mappings received from the BSR. ACL based RP assignment The rp-address command allows multiple static rendezvous point (RP) configurations. For each static RP, an ACL can be given as an option to define the multicast address ranges that the static RP permit or deny to serve. A static RP by default serves the range of 224.0.0.0/4 if the RP is configured without an ACL name. If an ACL name is given but the ACL is not defined, the static RP is set to inactive mode and it will not cover any multicast group ranges. The optional static RP ACL can be configured as a standard ACL or as an extended ACL. For an extended ACL, the destination filter will be used to derive the multicast group range and all other filters are ignored. The content of the ACL needs to be defined in the order of prefix length; the longest prefix must be placed at the top of the ACL definition. If there are overlapping group ranges among the static RPs, the static RP with the longest prefix match is selected. If more than one static RP covers the exact same group range, the highest IP static RP will be used. Configuration considerations: ∙ The Static RP has higher precedence over RP learnt from the BSR. ∙ There is a limit of 64 static RPs in the systems. Configuring an ACL based RP assignment To configure an ACL based RP assignment, enter commands such as the following. device(config)# router pim device(config-pim-router)# rp-address 130.1.1.1 acl1 Syntax: [no] rp-address ip_address [acl_name_or_id ] Use the ip address parameter to specify the IP address of the device you want to designate as an RP device. Use the acl name or id (optional) parameter to specify the name or ID of the ACL that specifies which multicast groups use this RP. Displaying the static RP Use the show ip pim rp-set command to display static RP and the associated group ranges. device(config)# show ip pim rp-set Static RP and associated group ranges ------------------------------------Static RP count: 4 130.1.1.1 120.1.1.1 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 95 IPv4 Multicast Protocols 120.2.1.1 124.1.1.1 Number of group prefixes Learnt from BSR: 0 No RP-Set present. Use the show ip pim rp-map command to display all current multicast group addresses to RP address mapping. device(config)# show ip pim rp-map Number of group-to-RP mappings: 5 ------------------------------------------S.No Group address RP address ------------------------------------------1 225.1.1.1 25.0.0.25 2 225.1.1.2 25.0.0.25 3 225.1.1.3 25.0.0.25 4 225.1.1.4 25.0.0.25 5 225.1.1.5 25.0.0.25 PIM convergence on MAC movement (PIM sparse mode) Refer to PIM convergence on MAC movement on page 15 for more information on PIM convergence. IP multicast PIM neighbor filter The IP multicast PIM neighbor filter feature allows you to control which devices can be PIM neighbors. When two PIM-enabled neighbor devices exchange Hello packets at regular intervals they become PIM neighbors by default. The IP multicast PIM neighbor filter feature gives you more control over which devices can be PIM neighbors by configuring the ip pim neighbor-filter command or ipv6 pim neighbor-filter command. You can configure the ACL to filter PIM Hello packets from sources you want to deny or allow, thereby controlling those devices' eligibility to become PIM neighbors. FIGURE 6 Multicast PIM filter topology Device 1 Device 2 access-list 10 deny host 10.0.0.2 interface ethernet 1/1/2 access-list 10 permit any enable interface ethernet 1/1/1 ip address 10.0.0.2/24 enable ip pim-sparse ip address 10.0.0.1/24 ip pim-sparse ip pim neighbor-filter 10 96 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols Limitations ACLs deny all access by default and you must configure the access-list permit command to permit access to one or more devices. You can configure the access-list permit all command on an interface to permit traffic on the interface to pass through without filtering. An interface can have only one ACL configured on it. There are no checks to validate whether an ACL applies to an interface. If the interface has no ACL, a warning that no filtering can occur is displayed. The IP multicast PIM neighbor filter feature supports a maximum of 128 PIM neighbor filters for both IPv4 and IPv6. Precedence-value matching in extended-ACL configurations is not supported. Refer to the FastIron Security Configuration Guide for information on ACLs. Configuring IPv4 PIM neighbor filtering Configure an ACL and apply it to an interface to control neighbor access. 1. Configure an ACL named 10 to deny access to the device 10.10. 102. Device(config)#access-list 10 deny host 10.10.10.2 You can identify the ACL by name as an ASCII string, by a number in the range 1 to 99 (for a standard ACL), or by a number in the range 100 to 199 (for an extended ACL). 2. Configure ACL 10 to permit access to all other devices. Device(config)#access-list 10 permit any 3. Configure an Ethernet interface. Device(config)#interface ethernet 1/3/2 Configures an interface and enters interface configuration mode. 4. Configure a filter that applies ACL 10 to the interface. Device(config-if-e1000-1/3/2)#ip pim neighbor-filter 10 Prevents the host that is specified in ACL 10, 10.10.10.2, from becoming a PIM neighbor on the interface. PIM Passive PIM Passive is used to reduce and minimize unnecessary PIM Hello and other PIM control messages. PIM Passive allows you to specify that the interface is "passive" in regards to PIM. No PIM control packets are sent or processed (if received), but hosts can still send and receive multicast traffic and IGMP control traffic on the interface. Also, PIM Passive prevents any malicious router from taking over as the designated router (DR), which can prevent all hosts on the LAN from joining multicast traffic outside the LAN. The following guidelines apply to PIM Passive: ∙ PIM Passive is a Layer 3 interface [Ethernet/VE] level feature. ∙ Because the loopback interfaces are never used to form PIM neighbors, PIM Passive is not supported on loopback interfaces. ∙ Both PIM SM and PIM DM modes support PIM Passive. ∙ Applying PIM Passive on an interface requires PIM to be enabled on the interface. ∙ The sent and received statistics of a PIM Hello message are not changed for an interface while it is configured as PIM passive. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 97 IPv4 Multicast Protocols To enable PIM Passive on an interface, enter the following commands: device# configure terminal device(config)# router pim device(config-pim-router)# exit device(config)# interface ethernet 2 device(config-if-e1000-2)# ip pim device(config-if-e1000-2)# ip pim passive device(config-if-e1000-2)# exit device(config)# interface ve 2 device(config-vif-2)# ip pim-sparse device(config-vif-2)# ip pim passive device(config-vif-2)# exit Syntax: [no] ip pim passive Multicast Outgoing Interface (OIF) list optimization Each multicast route entry maintains a list of outgoing interfaces (OIF List) to which an incoming multicast data packet matching the route is replicated. In hardware-forwarded route entries, these OIF lists are stored inside the hardware in replication tables which are limited in size. In many deployment scenarios, more than one multicast route can have identical OIF lists and can optimize usage of the replication table entries by sharing them across multiple multicast routes. Multicast OIF list optimization keeps track of all the OIF lists in the system. It manages the hardware replication resources optimally, in real time, by dynamically assigning or re-assigning resources to multicast route entries to suit their current OIF list requirements, while maximizing resource sharing. NOTE IPv4 multicast routes do not share hardware replication table entries with IPv6 multicast routes even if they share the same OIF lists. Displaying system values To display default, maximum, current, and configured values for system maximum parameters, use the show default values command. The following output example does not show complete output; it shows only PIM hardware mcache values. device(config)#show default values System Parameters Default Maximum pim-hw-mcache 1024 6144 Current 1500 Configured 1500 Displaying PIM resources To display the hardware resource information, such as hardware allocation, availability, and limit for software data structure, enter the show ip pim resource command. device# show ip pim resource Global PIM Parameters :GLOBAL Ipv4 MULTICAST CLASS Size:16811 bytes GLOBAL Ipv4 PIM CLASS Size:1065 bytes MULTICAST IPV4 CLASS Num alloc:5, System max:129, Size:1228 bytes PIM IPV4 CLASS Num alloc:5, System max:129, Size:50440 Vrf Instance : default-vrf -------------------------------------alloc in-use avail get-fail limit get-mem NBR list 256 3 253 0 512 4 RP set list 256 4 252 0 1536 5032 Static RP 64 0 64 0 64 0 LIF Entry 512 0 512 0 512 0 98 size init 90 256 43 256 36 64 41 512 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols Anycast RP 64 timer 256 prune 128 pimsm J/P elem 1024 Timer Data 256 mcache SLIB Sync 280 mcache 56 graft if no mcache 197 HW replic vlan 2000 HW replic port 1024 pim/dvm intf. group 256 pim/dvm global group 256 repl entry(Global) 1024 IGMP Resources(All Vrfs): groups 256 group-memberships 256 sources 56 client sources 56 ssm-map 256 ssm-map-sources 256 Hardware-related Resources: Total (S,G) entries 1 Total SW FWD entries 0 Total sw w/Tag MVID entries Total sw w/Tag invalid MVID Total HW FWD entries 1 Total hw w/Tag MVID entries Total hw w/Tag invalid MVID 0 0 0 0 1 0 2 0 3 3 0 2 0 64 256 128 1024 255 280 54 197 1997 1021 256 254 1024 0 0 0 0 0 0 0 0 0 0 0 0 0 64 59392 29696 48960 59392 64960 12992 45704 464000 237568 59392 59392 237568 0 4 0 1258 2 20 2 0 4 4 0 2 4 190 64 34 29 28 28 796 64 66 78 24 46 43 64 256 128 1024 256 280 56 197 2000 1024 256 256 1024 2 2 1 0 0 0 254 254 55 56 256 256 0 0 0 0 0 0 4096 4096 12992 12992 256 59392 2 2 606 0 0 0 210 142 59 81 18 1024 256 256 56 56 256 256 0 entries 0 0 entries 0 Syntax: show ip pim [all-vrf | [ vrf vrf-name ] ] resource The vrf parameter allows you to display hardware resource information for the VRF instance identified by the vrf-name variable. The following table displays the output from the show ip pim resource command. TABLE 4 Output from the show ip pim resource command Field Description Num alloc Number of VRF instances allocated. System max Maximum number of VRFs allowed in the system. Size Size of one instance of the resource in bytes. alloc Number of nodes of that data that are currently allocated in memory. in-use Number of allocated nodes in use. avail Number of allocated nodes are not in use. get-fail Number of allocation failures for this node. limit Maximum number of nodes that can be allocated for a data structure. This may or may not be configurable, depending on the data structure get-mem Number of successful allocations for this node. size Size of the node in bytes. init Number of nodes that are allocated during initialization time. To display usage and fail-count information for SG entries on each VRF, use the show ip pim all-vrf hw-resource command. device# show ip pim all-vrf hw-resource VRF Usage Fail default-vrf 3072 8 blue 3072 0 ------------------------------Total usage 6144 System-max limit for SG entries: 6144 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 99 IPv4 Multicast Protocols Syntax: show ip pim [all-vrf | [ vrf vrf-name ] ] hw-resource The vrf parameter allows you to display hardware resource information for the VRF instance identified by the vrf-name variable. The following table displays the output from the show ip pim all-vrf hw-resource command. TABLE 5 Output from the show ip pim all-vrf hw-resource command Field Description VRF Name of the VRF. Usage Number of allocated SG entries in this VRF. Fail Number of failures while allocating SG entries in this VRF (due to the system-max limit. Total usage Total number of SG entries in the system (all VRFs). System-max limit for SG entries Configured system limit for pim-hw-mcache. Displaying PIM Sparse configuration information and statistics You can display the following PIM Sparse information: ∙ Basic PIM Sparse configuration information ∙ Group information ∙ BSR information ∙ Candidate RP information ∙ RP-to-group mappings ∙ RP information for a PIM Sparse group ∙ RP set list ∙ PIM neighbor information ∙ The PIM flow cache ∙ The PIM multicast cache ∙ PIM traffic statistics ∙ PIM counter statistics Displaying basic PIM Sparse configuration information To display PIM Sparse configuration information, enter the following command at any CLI level. Device(config)# show ip pim sparse Global PIM Sparse Mode Settings Maximum Mcache : 12992 Current Count : 2 Hello interval : 30 Neighbor timeout : 105 Join/Prune interval : 60 Inactivity interval : 180 Hardware Drop Enabled : Yes Prune Wait Interval : 3 Bootstrap Msg interval : 60 Candidate-RP Msg interval : 60 Register Suppress Time : 60 Register Probe Time : 10 Register Stop Delay : 10 Register Suppress interval : 60 SSM Enabled : Yes SPT Threshold : 1 SSM Group Range : 232.0.0.0/8 Route Precedence : mc-non-default mc-default uc-non-default uc-default Syntax: show ip pim [vrf vrf-name ] sparse 100 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols The vrf keyword allows you to display PIM sparse configuration information for the VRF instance identified by the vrf-name variable. This example shows the PIM Sparse configuration information on PIM Sparse device A in Figure 5 on page 90. The following table shows the information displayed by the show ip pim sparse command. TABLE 6 Output of the show ip pim sparse command This field... Displays... Global PIM Sparse mode settings Maximum mcache Maximum number of multicast cache entries. Current Count Number of multicast cache entries used. Hello interval How frequently the device sends IPIM Sparse hello messages to its PIM Sparse neighbors. This field shows the number of seconds between hello messages. PIM Sparse routers use hello messages to discover one another. Neighbor timeout Number of seconds the device waits for a hello message from a neighbor before determining that the neighbor is no longer present and is not removing cached PIM Sparse forwarding entries for the neighbor. Default is 105 seconds. Join or Prune interval How frequently the device sends IPv6 PIM Sparse Join or Prune messages for the multicast groups it is forwarding. This field shows the number of seconds between Join or Prune messages. The device sends Join or Prune messages on behalf of multicast receivers that want to join or leave an PIM Sparse group. When forwarding packets from PIM Sparse sources, the device sends the packets only on the interfaces on which it has received join requests in Join or Prune messages for the source group. Inactivity interval Number of seconds a forwarding entry can remain unused before the router deletes it. Default is 180 sec. Hardware Drop Enabled Indicates whether hardware drop is enabled or disabled. To prevent unwanted multicast traffic from being sent to the CPU, PIM Routing and Passive Multicast Route Insertion (PMRI) can be used together to ensure that multicast streams are only forwarded out ports with interested receivers and unwanted traffic is dropped in the hardware on Layer 3 Switches. Prune Wait Interval Number of seconds a PIM device waits before stopping traffic to neighbor devices that do not want the traffic. Range is from zero to three seconds. Default is three seconds. Bootstrap Msg interval How frequently the BSR configured on the device sends the RP set to the RPs within the PIM Sparse domain. The RP set is a list of candidate RPs and their group prefixes. The group prefix of a candidate RP indicates the range of PIM Sparse group numbers for which it can be an RP. NOTE This field contains a value only if an interface on the device is elected to be the BSR. Otherwise, the field is blank. Candidate-RP Msg interval Number of seconds the candidate RP configured on the Layer 3 switch sends candidate RP advertisement messages to the BSR. Default is 60 seconds. Register Suppress Time This is the mean interval between receiving a Register-Stop and allowing registers to be sent again. A lower value means more frequent register bursts at RP, while a higher value means longer join latency for new receivers. Default: 60 seconds. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 101 IPv4 Multicast Protocols TABLE 6 Output of the show ip pim sparse command (continued) This field... Displays... Register Probe Time Number of seconds the PIM router waits for a register-stop from an RP before it generates another NULL register to the PIM RP. Default is 10 seconds. Register Stop Delay Register stop message. Default is 10 seconds. Register Suppress interval Number of seconds that it takes the designated router to send a Registerencapsulated date to the RP after receiving a Register-Stop message. Default is 60 seconds. SSM Enabled If yes, source-specific multicast is configured globally on this router. SPT threshold Number of packets the device sends using the path through the RP before switching to the SPT path. Default is 1 packet. SSM Group Range Source-specific multicast group range. Route Precedence The route precedence configured to control the selection of routes based on the four route types: ∙ Non-default route from the mRTM ∙ Default route from the mRTM ∙ Non-default route from the uRTM ∙ Default route from the uRTM Displaying a list of multicast groups To display PIM group information, enter the following command at any CLI level. Device(config)# show ip pim group Total number of groups for VRF default-vrf: 7 1 Group 226.0.34.0 Group member at e1/2/9: v59 Group member at e1/1/16: v57 2 Group 226.0.77.0 Group member at e1/2/9: v59 Group member at e1/1/16: v57 3 Group 226.0.120.0 Group member at e1/2/9: v59 Group member at e1/1/16: v57 4 Group 226.0.163.0 Group member at e1/2/9: v59 Group member at e1/1/16: v57 5 Group 226.0.206.0 Group member at e1/2/9: v59 Group member at e1/16: v57 6 Group 226.0.249.0 Group member at e1/2/9: v59 Group member at e1/1/16: v57 7 Group 226.0.30.0 Group member at e1/2/9: v59 Group member at e1/1/16: v57 device(config)# Syntax: show ip pim [vrf vrf-name ] group The vrf keyword allows you to display PIM group information for the VRF instance identified by the vrf-name variable. The following table describes the output from this command: TABLE 7 Output from the show ip pim group command This field... Displays... Total number of Groups Lists the total number of IP multicast groups the device is forwarding. 102 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols TABLE 7 Output from the show ip pim group command (continued) This field... Displays... NOTE This list can include groups that are not PIM Sparse groups. If interfaces on the device are configured for regular PIM (dense mode), these groups are listed too. Index The index number of the table entry in the display. Group The multicast group address Ports The device ports connected to the receivers of the groups. Displaying BSR information To display BSR information, enter the following command at any CLI level. device(config)# show ip pim bsr PIMv2 Bootstrap information for Vrf Instance : default-vrf -----------------------------------------------------------------------------This system is the Elected BSR BSR address: 1.51.51.1. Hash Mask Length 32. Priority 255. Next bootstrap message in 00:01:00 Configuration: Candidate loopback 2 (Address 1.51.51.1). Hash Mask Length 32. Priority 255. Next Candidate-RP-advertisment in 00:01:00 RP: 1.51.51.1 group prefixes: 224.0.0.0 / 4 Candidate-RP-advertisement period: 60 This example shows information displayed on a device that has been elected as the BSR. The next example shows information displayed on a device that is not the BSR. Notice that some fields shown in the example above do not appear in the example below device(config)#show ip pim bsr PIMv2 Bootstrap information for Vrf Instance : default-vrf ---------------------------------------------------------------------------BSR address: 1.51.51.1. Hash Mask Length 32. Priority 255. Next Candidate-RP-advertisment in 00:00:30 RP: 1.51.51.3 group prefixes: 224.0.0.0 / 4 Candidate-RP-advertisement period: 60 device(config)# Syntax: show ip pim [vrf vrf-name ] bsr The vrf keyword allows you to display BSR information for the VRF instance identified by the vrf-namevrf-name variable. The following table describes the output from this command. TABLE 8 Output from the show ip pim bsr command This field... Displays... BSR address The IP address of the interface configured as the PIM Sparse Bootstrap Router (BSR). BSR priority The priority assigned to the interface for use during the BSR election process. During BSR election, the priorities of the candidate BSRs are compared and the interface with the highest BSR priority becomes the BSR. Hash mask length The number of significant bits in the IP multicast group comparison mask. This mask determines the IP multicast group numbers for which the FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 103 IPv4 Multicast Protocols TABLE 8 Output from the show ip pim bsr command (continued) This field... Displays... device can be a BSR. The default is 32 bits, which allows the device to be a BSR for any valid IP multicast group number. NOTE This field appears only if this device is a candidate BSR. Next bootstrap message in Indicates how much time will pass before the BSR sends the next bootstrap message. The time is displayed in "hh:mm:ss" format. NOTE This field appears only if this device is the BSR. Next Candidate-RP-advertisement message in Indicates how much time will pass before the BSR sends the next candidate PR advertisement message. The time is displayed in "hh:mm:ss" format. NOTE This field appears only if this device is a candidate BSR. RP Indicates the IP address of the Rendezvous Point (RP). NOTE This field appears only if this device is a candidate BSR. group prefixes Indicates the multicast groups for which the RP listed by the previous field is a candidate RP. NOTE This field appears only if this device is a candidate BSR. Candidate-RP-advertisement period Indicates how frequently the BSR sends candidate RP advertisement messages. NOTE This field appears only if this device is a candidate BSR. Displaying candidate RP information To display candidate RP information, enter the following command at any CLI level. device# show ip pim rp-candidate Next Candidate-RP-advertisement in 00:00:10 RP: 207.95.7.1 group prefixes: 224.0.0.0 / 4 Candidate-RP-advertisement period: 60 This example show information displayed on a device that is a candidate RP. The next example shows the message displayed on a device that is not a candidate RP. device# show ip pim rp-candidate This system is not a Candidate-RP. Syntax: show ip pim [vrf vrf-name ] rp-candidate This command displays candidate RP information for the VRF instance identified by the vrf-name variable. The following table describes the output from this command. 104 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols TABLE 9 Output from the show ip pim rp-candidate command This field... Displays... Candidate-RP-advertisement in Indicates how time will pass before the BSR sends the next RP message. The time is displayed in "hh:mm:ss" format. NOTE This field appears only if this device is a candidate RP. RP Indicates the IP address of the Rendezvous Point (RP). NOTE This field appears only if this device is a candidate RP. group prefixes Indicates the multicast groups for which the RP listed by the previous field is a candidate RP. NOTE This field appears only if this device is a candidate RP. Candidate-RP-advertisement period Indicates how frequently the BSR sends candidate RP advertisement messages. NOTE This field appears only if this device is a candidate RP. Displaying RP-to-group mappings To display RP-to-group-mappings, enter the following command at any CLI level. device# show ip pim rp-map Number of group-to-RP mappings: 6 Group address RP address ------------------------------1 239.255.163.1 99.99.99.5 2 239.255.163.2 99.99.99.5 3 239.255.163.3 99.99.99.5 4 239.255.162.1 99.99.99.5 5 239.255.162.2 43.43.43.1 6 239.255.162.3 99.99.99.5 Syntax: show ip pim [vrf vrf-name ] rp-map The vrf option allows you to display candidate RP-to-group mappings for the VRF instance identified by the vrf-name variable. The following table describes the output from this command. TABLE 10 Output of the show ip pim rp-map command This field... Displays... Group address Indicates the PIM Sparse multicast group address using the listed RP. RP address Indicates the IP address of the Rendezvous Point (RP) for the listed PIM Sparse group. Displaying RP Information for a PIM Sparse group To display RP information for a PIM Sparse group, enter the following command at any CLI level. device# show ip pim rp-hash 239.255.162.1 RP: 207.95.7.1, v2 Info source: 207.95.7.1, via bootstrap FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 105 IPv4 Multicast Protocols Syntax: show ip pim [vrf vrf-name ] rp-hash group-addr The vrf option allows you to display RP information for the VRF instance identified by the vrf-name variable. The group-addr parameter is the address of a PIM Sparse IP multicast group. The following table describes the output from this command. TABLE 11 Output from the show ip pim command This field... Displays... RP Indicates the IP address of the Rendezvous Point (RP) for the specified PIM Sparse group. Info source Indicates the source of the RP information. It can be a static-RP configuration or learned via the bootstrap router. If RP information is learned from the boot strap, the BSR IP address is also displayed. Displaying the RP set list To display the RP set list for the device elected as BSR, enter the following command at any CLI level. device(config)# show ip pim rp-set Static RP --------Static RP count: 2 1.51.51.4 1.51.51.5 Number of group prefixes Learnt from BSR: 1 Group prefix = 224.0.0.0/4 # RPs: 2 RP 1: 1.51.51.1 priority=0 age=60 RP 2: 1.51.51.3 priority=0 age=30 holdtime=150 holdtime=150 To display the RP set list for devices that are not elected as BSR, enter the following command at any CLI level. Brocade(config)# show ip pim rp-set Static RP --------Static RP count: 2 1.51.51.4 1.51.51.5 Number of group prefixes Learnt from BSR: 1 Group prefix = 224.0.0.0/4 # RPs expected: 2 # RPs received: 2 RP 1: 1.51.51.1 priority=0 age=60 holdtime=150 RP 2: 1.51.51.3 priority=0 age=30 holdtime=150 Syntax: show ip pim [ vrf vrf-name ] rp-set The vrf option allows you to display the RP set list for the VRF instance identified by the vrf-name variable. The following table describes the output from this command. TABLE 12 Output from the show ip pim vrf rp-set command This field... Displays... Number of group prefixes The number of PIM Sparse group prefixes for which the RP is responsible. Group prefix Indicates the multicast groups for which the RP listed by the previous field is a candidate RP. RPs expected or received Indicates how many RPs were expected and received in the latest bootstrap message. 106 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols TABLE 12 Output from the show ip pim vrf rp-set command (continued) This field... Displays... RP num Indicates the RP number. If there are multiple RPs in the PIM Sparse domain, a line of information for each RP is listed, in ascending numerical order. priority The RP priority of the candidate RP. During the election process, the candidate RP with the highest priority is elected as the RP. age The age (in seconds) of this RP-set. holdtime Indicates the time in seconds for which this rp-set information is valid. If this rp-set information is not received from BSR within the holdtime period, the rp-set information is aged out and deleted. Displaying multicast neighbor information To display information about PIM neighbors, enter the following command at any CLI level. device(config)# show ip pim nbr --------+--------+---------------+--------+---+---------+---------+-----+----------------+-----------+----+ Port |PhyPort |Neighbor |Holdtime|T |PropDelay|Override |Age |UpTime |VRF |Prio | | |sec |Bit|msec |msec |sec | | | --------+--------+---------------+--------+---+---------+---------+-----+----------------+-----------+----+ v2 e1/1/1 2.1.1.2 105 1 500 3000 0 00:44:10 default-vrf 1 v4 e1/2/2 4.1.1.2 105 1 500 3000 10 00:42:50 default-vrf 1 v5 e1/1/4 5.1.1.2 105 1 500 3000 0 00:44:00 default-vrf 1 v22 e1/1/1 22.1.1.1 105 1 500 3000 0 00:44:10 default-vrf 1 Total Number of Neighbors : 4 device(config)# Syntax: show ip pim [vrf vrf-name ] neighbor The vrf option allows you to display information about the PIM neighbors for the VRF instance identified by the vrf-name variable. The following table describes the output from this command. TABLE 13 Output from the show ip pim vrf neighbor command This field... Displays... Port The interface through which the device is connected to the neighbor. Phyport When there is a virtual interface, this is the physical port to which the neighbor is connected. Neighbor The IP interface of the PIM neighbor. Holdtime sec Indicates how many seconds the neighbor wants this device to hold the entry for this neighbor in memory. The neighbor sends the Hold Time in Hello packets: ∙ If the device receives a new Hello packet before the Hold Time received in the previous packet expires, the device updates its table entry for the neighbor. ∙ If the device does not receive a new Hello packet from the neighbor before the Hold time expires, the device assumes the neighbor is no longer available and removes the entry for the neighbor. Age sec The number of seconds since the device received the last hello message from the neighbor. UpTime sec The number of seconds the PIM neighbor has been up. This timer starts when the device receives the first Hello messages from the neighbor. VRF The VRF in which the interface is configured. This can be a VRF that the port was assigned to or the default VRF of the device. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 107 IPv4 Multicast Protocols TABLE 13 Output from the show ip pim vrf neighbor command (continued) This field... Displays... Priority The DR priority that is used in the DR election process. This can be a configured value or the default value of 1. Displaying the PIM multicast cache To display the PIM multicast cache, enter the following command at any CLI level. Brocade(config)# show ip pim mcache 10.140.140.14 230.1.1.9 IP Multicast Mcache Table Entry Flags : SM - Sparse Mode, SSM - Source Specific Multicast, DM - Dense Mode RPT - RPT Bit, SPT - SPT Bit, LSRC - Local Source, LRCV - Local Receiver HW - HW Forwarding Enabled, FAST - Resource Allocated, TAG - Need For Replication Entry REGPROB - Register In Progress, REGSUPP - Register Suppression Timer MSDPADV - Advertise MSDP, NEEDRTE - Route Required for Src/RP, PRUN - DM Prune Upstream Interface Flags: IM - Immediate, IH - Inherited, WA - Won Assert MJ - Membership Join, MI - Membership Include, ME - Membership Exclude BR - Blocked RPT, BA - Blocked Assert, BF - Blocked Filter, BI - Blocked IIF Total entries in mcache: 20 1 (10.140.140.14, 230.1.1.9) in v1001 (tag e1/4/29), Uptime 00:03:12, Rate 0 (SM) upstream neighbor 10.11.11.13 Flags (0x600680e1) SM SPT LRCV HW FAST TAG fast ports: ethe 1/4/29 ethe 1/5/2 AgeSltMsk: 1, L2 FID: 8188, DIT: 8 , AvgRate: 0, profile: none Forwarding_oif: 3, Immediate_oif: 0, Blocked_oif: 0 L3 (HW) 2: e1/4/29(VL13), 00:03:12/0, Flags: MJ e1/5/2(VL1004), 00:03:12/0, Flags: MJ L2 (HW) 1: e1/5/2, 00:00:07/0, Flags: MJ L2 MASK: ethe 1/5/2 Src-Vlan: 1001 Syntax: show ip pim [vrf vrf-name ] mcache [source-address | group-address | counts | dense | dit-idx dit-idx | g_entries | receiver | sg_entries | sparse | ssm] The vrf option allows you to display the PIM multicast cache for the VRF instance identified by the vrf-name variable. The source-address parameter selects the multicast cache source address. The group-address parameter selects the multicast cache group address. The counts keyword indicates the count of entries. The dense keyword displays only the PIM Dense Mode entries. The dit-idx variable allows you to display all entries that match a specified dit. The g_entries keyword displays only the (*, G) entries. The receiver keyword allows you to display all entries that egress a specified interface. The sg_entries keyword displays only the (S, G) entries. The sparse keyword displays only the PIM Sparse Mode entries. The ssm keyword displays only the SSM entries. The following table describes the output from this command. TABLE 14 Output fields from the show ip pim mcache command Field Description Total entries in mcache Shows the total number of PIM mcache entries 108 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols TABLE 14 Output fields from the show ip pim mcache command (continued) Field Description MJ Membership Join MI Membership Include ME Membership Exclude - Legend for the mcache entry printed once per page, it gives the explanation of each of the flags used in the entry. BR Blocked RPT BA Blocked Assert BF Blocked Filter BI Blocked IIF Uptime Shows the entry uptime Rate Shows the Rate at which packets are ingressing for this entry upstream neighbor Shows the upstream neighbor for the Source/RP based on the type of entry. For (*,G) it shows the upstream neighbor towards the RP. For (S,G) entries it shows the upstream neighbor towards the source. Flags Flags Represent Entry flags in hex format in the braces. And indicates the meaning of the flags set in abbreviated string whose explanations are as below. Only shows the flags which are set. SM - Shows If the entry is created by PIM Sparse Mode DM - Shows If DM mode entry is enabled SSM - Shows If the SSM mode entry is enabled RPT - Shows If the entry is on the Rendezvous Point (RP) SPT - Shows If the entry is on the source tree LSRC - Shows If the source is in a directly-connected interface LRcv - Shows If the receiver is directly connected to the router REG - if the data registration is in progress L2REG - if the source is directly connected to the router REGSUPP - if the register suppression timer is running RegProbe HW - Shows If the candidate for hardware forwarding is enabled FAST - Shows If the resources are allocated for hardware forwarding TAG - Shows If there is a need for allocating entries from the replication table MSDPADV - Shows If RP is responsible for the source and must be advertised to its peers. NEEDRTE - Shows If there is no route to the source and RP is available PRUNE - Shows If PIM DM Prune to upstream is required RP Show the IP address of the RP. fast ports Shows forwarding port mask. AgeSltMsk Shows the slot number on which active module expects ingress traffic. L2 FID Shows the hardware resource allocated for the traffic switched to receivers in the ingress VLAN. DIT Shows the hardware resource allocated for routed receivers. RegPkt Shows Count of Packets forwarded due to the Register decapsulation. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 109 IPv4 Multicast Protocols TABLE 14 Output fields from the show ip pim mcache command (continued) Field Description AvgRate Shows the average Rate of packets ingressing for this entry over 30 seconds. Profile Shows the Profile ID associated with the Stream. Number of matching entries Shows the total number of mcache entries matching a particular multicast filter specified. Outgoing interfaces Section This section consists of three parts. L3 OIFs, L2OIFs and Blocked OIFs. And each section has Format of L3/L2/Blocked followed by (HW/SW) followed by count of the number of OIF in each section. Additionally, each section displays the OIFs one per line. And shows the OIF in the format eth/Tr(Vlan) followed by uptime/expiry time, followed by the Flags associated with each OIF. L3 Shows whether the traffic is routed out of the interface. L2 Shows whether the traffic is switched out of the interface. HW Shows whether the entry is hardware forwarded. SW Shows whether the entry is software forwarded Eth/Tr(VL1) Shows the outgoing interface on the specified VLAN. Flags (explanation of flags in the OIF section) Shows the flags set in each of the Outgoing interface in abbreviated string format whose explanations are as below. Legend of this shown at the top of each entry IM - Immediate IH - Inherited MJ - Membership Join MI - Membership Include ME - Membership Exclude BR - Blocked due to SG RPT BA - Blocked due to Assert BF - Blocked due to Filter BI - Blocked IIF (Incoming interface) matches OIF Src-Vlan Shows the VLAN associated with the ingress interface. MCTPEERF - Traffic Forw By Cluster Peer CCEP Applies only to Layer 3 multicast routing over MCT. This means multicast traffic for this stream is forwarded by cluster peer [remote] CCEP port because of flow load balancing Displaying the PIM multicast cache for DIT To display the PIM multicast cache for a specified dit, enter the following command at any CLI level. Brocade#show ip pim mcache dit-idx 2 IP Multicast Mcache Table Entry Flags : SM - Sparse Mode, SSM - Source Specific Multicast, DM - Dense Mode RPT - RPT Bit, SPT - SPT Bit, LSRC - Local Source, LRCV - Local Receiver HW - HW Forwarding Enabled, FAST - Resource Allocated, TAG - Need For Replication Entry REGPROB - Register In Progress, REGSUPP - Register Suppression Timer MSDPADV - Advertise MSDP, NEEDRTE - Route Required for Src/RP, PRUN - DM Prune Upstream Interface Flags: IM - Immediate, IH - Inherited, WA - Won Assert MJ - Membership Join, MI - Membership Include, ME - Membership Exclude BR - Blocked RPT, BA - Blocked Assert, BF - Blocked Filter, BI - Blocked IIF Total entries in mcache: 30 1 (20.20.20.100, 225.1.1.1) in v220 (tag e1/1/13), Uptime 07:12:07, Rate 0 (SM) 110 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols 2 3 upstream neighbor 220.220.220.1 Flags (0x200680e1) SM SPT LRCV HW FAST TAG fast ports: ethe 1/1/11 AgeSltMsk: 1, L2 FID: 105c, DIT: 2 , AvgRate: 0, profile: none Forwarding_oif: 1, Immediate_oif: 0, Blocked_oif: 0 L3 (HW) 1: e1/1/11(VL40), 07:12:07/0, Flags: MJ Src-Vlan: 220 (20.20.20.100, 225.1.1.2) in v220 (tag e1/1/13), Uptime 00:01:00, Rate 0 (SM) upstream neighbor 220.220.220.1 Flags (0x200680e1) SM SPT LRCV HW FAST TAG fast ports: ethe 1/1/11 AgeSltMsk: 1, L2 FID: 105c, DIT: 2 , AvgRate: 0, profile: none Forwarding_oif: 1, Immediate_oif: 0, Blocked_oif: 0 L3 (HW) 1: e1/1/11(VL40), 00:01:00/0, Flags: MJ Src-Vlan: 220 (20.20.20.100, 225.1.1.3) in v220 (tag e1/1/13), Uptime 00:01:00, Rate 0 (SM) upstream neighbor 220.220.220.1 Flags (0x200680e1) SM SPT LRCV HW FAST TAG fast ports: ethe 1/1/11 AgeSltMsk: 1, L2 FID: 105c, DIT: 2 , AvgRate: 0, profile: none Forwarding_oif: 1, Immediate_oif: 0, Blocked_oif: 0 L3 (HW) 1: e1/1/11(VL40), 00:01:00/0, Flags: MJ Src-Vlan: 220 Syntax: show ip pim [vrf vrf-name ] mcache dit-idx dit The dit variable allows you to display an entry that matches a specified dit. Clearing the PIM forwarding cache You can clear the PIM forwarding cache using the following command. device# clear ip pim cache Syntax: clear ip pim [vrf vrf-name ] cache Use the vrf option to clear the PIM forwarding cache for a VRF instance specified by the vrf-name variable. Displaying PIM traffic statistics To display PIM traffic statistics, enter the following command at any CLI level. device(config)# show ip pim traffic Port HELLO JOIN-PRUNE ASSERT REGISTER REGISTER BOOTSTRAP CAND. RP Err GRAFT(DM) STOP(SM) MSGS (SM) ADV. (SM) -------+---------+-----------+---------+---------+---------+---------+---------+--Rx Rx Rx Rx Rx Rx Rx Rx ------+---------+-----------+---------+---------+---------+---------+---------+--v30 0 0 0 0 0 0 0 0 v50 2526 1260 0 0 0 1263 0 0 v150 2531 0 0 0 0 1263 0 0 v200 2531 0 0 0 0 1 0 0 Port HELLO JOIN-PRUNE ASSERT REGISTER REGISTER BOOTSTRAP CAND. RP Err GRAFT(DM) STOP(SM) MSGS (SM) ADV. (SM) -------+---------+-----------+---------+---------+---------+---------+---------+--Tx Tx Tx Tx Tx Tx Tx ------+---------+-----------+---------+---------+---------+---------+---------+--v30 2528 0 0 0 0 0 0 v50 2540 1263 0 0 0 2 0 v150 2529 0 0 0 0 1262 0 v200 2529 0 0 0 0 1262 0 Brocade#show ip pim traffic rx Port HELLO JOIN-PRUNE ASSERT REGISTER REGISTER BOOTSTRAP CAND. RP Err FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 111 IPv4 Multicast Protocols GRAFT(DM) STOP(SM) MSGS (SM) ADV. (SM) -------+---------+-----------+---------+---------+---------+---------+---------+--Rx Rx Rx Rx Rx Rx Rx Rx ------+---------+-----------+---------+---------+---------+---------+---------+--v30 0 0 0 0 0 0 0 0 v50 2526 1260 0 0 0 1263 0 0 v150 2531 0 0 0 0 1263 0 0 v200 2531 0 0 0 0 1 0 0 Brocade#show ip pim traffic tx Port HELLO JOIN-PRUNE ASSERT REGISTER REGISTER BOOTSTRAP CAND. RP Err GRAFT(DM) STOP(SM) MSGS (SM) ADV. (SM) -------+---------+-----------+---------+---------+---------+---------+---------+--Tx Tx Tx Tx Tx Tx Tx ------+---------+-----------+---------+---------+---------+---------+---------+--v30 2528 0 0 0 0 0 0 v50 2540 1263 0 0 0 2 0 v150 2529 0 0 0 0 1262 0 v200 2530 0 0 0 0 1262 0 Brocade#show ip pim traffic join-prune Port Packet Join Prune Avg Aggr Last Aggr -----+---------+---------+---------+---------+---------Rx Rx Rx Rx Rx -----+---------+---------+---------+---------+---------v30 0 0 0 0 0 v50 1260 1260 0 1 1 v150 0 0 0 0 0 v200 0 0 0 0 0 Port Packet Join Prune Avg Aggr Last Aggr -----+---------+---------+---------+---------+---------Tx Tx Tx Tx Tx -----+---------+---------+---------+---------+---------v30 0 0 0 0 0 v50 1263 1262 1 1 1 v150 0 0 0 0 0 v200 0 0 0 0 0 Brocade#show ip pim traffic join-prune rx Port Packet Join Prune Avg Aggr Last Aggr -----+---------+---------+---------+---------+---------Rx Rx Rx Rx Rx -----+---------+---------+---------+---------+---------v30 0 0 0 0 0 v50 1260 1260 0 1 1 v150 0 0 0 0 0 v200 0 0 0 0 0 Brocade#show ip pim traffic join-prune tx Port Packet Join Prune Avg Aggr Last Aggr -----+---------+---------+---------+---------+---------Tx Tx Tx Tx Tx -----+---------+---------+---------+---------+---------v30 0 0 0 0 0 v50 1264 1263 1 1 1 v150 0 0 0 0 0 v200 0 0 0 0 0 Syntax: show ip pim [vrf vrf-name ] traffic [join-prune | rx | tx ] ∙ vrf --PIM traffic statistics for the VRF instance identified by vrf-name ∙ join-prune --Join/prune statistics. ∙ rx --Received PIM traffic statistics. ∙ tx --Transmitted PIM traffic statistics. NOTE If you have configured interfaces for standard PIM (dense mode) on the device, statistics for these interfaces are listed first by the display. The following table describes the output for this show command. 112 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols TABLE 15 Output from the show ip pim vrf traffic command This field... Displays... Port The port or virtual interface on which the PIM interface is configured. Hello The number of PIM Hello messages sent or received on the interface. J or P The number of Join or Prune messages sent or received on the interface. NOTE Unlike PIM dense, PIM Sparse uses the same messages for Joins and Prunes. Register The number of Register messages sent or received on the interface. RegStop The number of Register Stop messages sent or received on the interface. Assert The number of Assert messages sent or received on the interface. Total Recv or Xmit The total number of IGMP messages sent and received by the device. Total Discard or chksum The total number of IGMP messages discarded, including a separate counter for those that failed the checksum comparison. Clearing the PIM message counters You can clear the PIM message counters using the following command. device# clear ip pim traffic Syntax: clear ip pim [vrf vrf-name ] traffic Use the vrf option to clear the PIM message counters for a VRF instance specified by the vrf-name variable. Displaying PIM RPF The show ip pim rfp command displays what PIM sees as the reverse path to the source as shown in the following. While there may be multiple routes back to the source, the one displayed by this command is the one that PIM thinks is best. device# show ip pim vrf eng rpf 130.50.11.10 Source 130.50.11.10 directly connected on e4/1 Syntax: show ip pim [vrf vrf-name ] rpf ip-address The ip-address variable specifies the source address for RPF check. The vrf option to display what PIM sees as the reverse path to the source for a VRF instance specified by the vrf-name variable. Configuring Multicast Source Discovery Protocol (MSDP) The Multicast Source Discovery Protocol (MSDP) is used by Protocol Independent Multicast (PIM) Sparse devices to exchange source information across PIM Sparse domains. Devices running MSDP can discover PIM Sparse sources in other PIM Sparse domains. The following figure shows an example of some PIM Sparse domains. For simplicity, this example shows one Designated Router (DR), one group source, and one receiver for the group. Only one PIM Sparse device within each domain needs to run MSDP. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 113 IPv4 Multicast Protocols FIGURE 7 PIM Sparse domains joined by MSDP devices In this example, the source for PIM Sparse multicast group 232.0.1.95 is in PIM Sparse domain 1. The source sends a packet for the group to its directly attached DR. The DR sends a PIM register message for this flow to the RPDR. The RP is configured for MSDP, which enables the RP to exchange source information with other PIM Sparse domains by communicating with RPs in other domains that are running MSDP. The RP sends the source information to each peer through a Source Active message. The message contains the IP address of the source, the group address to which the source is sending, and the IP address of the RP. In this example, the Source Active message contains the following information: ∙ Source address: 206.251.14.22 ∙ Group address: 232.1.0.95 ∙ RP address: 206.251.17.41 Figure 7 shows only one peer for the MSDP device (which is also the RP here) in domain 1, so the Source Active message goes to only that peer. When an MSDP device has multiple peers, it sends a Source Active message to each of those peers. Each peer sends the Source Advertisement to other MSDP peers. The RP that receives the Source Active message also sends a Join message to the source if the RP that received the message has receivers for the group and source. Peer Reverse Path Forwarding (RPF) flooding When the MSDP device (also the RP) in domain 2 receives the Source Active message from the peer in domain 1, the MSDP device in domain 2 forwards the message to all other peers. This propagation process is sometimes called "peer Reverse Path Forwarding (RPF) 114 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols flooding". In Figure 7 on page 114, the MSDP device floods the Source Active message it receives from the peer in domain 1 to peers in domains 3 and 4. The MSDP device in domain 2 does not forward the Source Active back to the peer in domain 1, because that is the peer from which the device received the message. An MSDP device never sends a Source Active message back to the peer that sent it. The peer that sent the message is sometimes called the "RPF peer". The MSDP device uses the unicast routing table for its Exterior Gateway Protocol (EGP) to identify the RPF peer by looking for the route entry that is the next hop toward the source. Often, the EGP protocol is Border Gateway Protocol (BGP) version 4. NOTE MSDP depends on BGP for inter-domain operations. The MSDP routers in domains 3 and 4 also forward the Source Active message to all peers except the ones that sent them the message. Figure 7 on page 114 does not show additional peers. Source Active caching When an MSDP device that is also an RP receives a Source Active message, it checks the PIM sparse multicast group table for receivers for that group. If there are receivers for that group being advertised in the Source Active message, the RP sends a Join message towards the source. In Figure 7 on page 114, if the MSDP device and RP in domain 4 has a table entry for the receiver, the RP sends a Join message on behalf of the receiver back through the RPF tree to the source, in this case the source in domain 1. Source Active caching is enabled in MSDP on Brocade devices. The RP caches the Source Active messages it receives even if the RP does not have a receiver for the group. Once a receiver arrives, the RP can then send a Join to the cached source immediately. The size of the cache used to store MSDP Source Active messages is 4K. MSDP SA cache size can be configured using the systemmax msdp-sa-cache command. The default value is 4K; the range is 1K to 8K. Configuring MSDP To configure MSDP, perform the following tasks: ∙ Enable MSDP. ∙ Configure the MSDP peers. NOTE The PIM Sparse Rendezvous Point (RP) is also an MSDP peer. NOTE Devices that run MSDP usually also run BGP. The source address used by the MSDP device is normally configured to be the same source address used by BGP. Enabling MSDP To enable MSDP, enter the following command. device(config)# router msdp Syntax: [no] router msdp FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 115 IPv4 Multicast Protocols Enabling MSDP for a specified VRF The vrf parameter allows you to configure MSDP on the virtual routing instance (VRF) specified by the vrf-name variable. All MSDP parameters available for the default router instance are configurable for a VRF-based MSDP instance. To enable MSDP for the VRF named "blue", enter the following commands. device(config)# router msdp vrf blue device(config-msdp-router-vrf-blue) Syntax: [no] router msdp [vrf vrf-name ] The vrf parameter allows you to configure MSDP on the virtual routing instance (VRF) specified by the vrf-name variable. Entering a no router msdp vrf command removes the MSDP configuration from the specified VRF only. Configuring MSDP peers To configure an MSDP peer, enter a command such as the following at the MSDP configuration level. device(config-msdp-router)# msdp-peer 205.216.162.1 To configure an MSDP peer on a VRF, enter the following commands at the MSDP VRF configuration level. device(config)# router msdp vrf blue device(config-msdp-router-vrf-blue)# msdp-peer 205.216.162.1 Syntax: [no] msdp-peer ip-addr [connect-source loopback num ] The ip-addr parameter specifies the IP address of the neighbor. The connect-source loopbacknum parameter specifies the loopback interface you want to use as the source for sessions with the neighbor and must be reachable within the VRF. NOTE It is strongly recommended that you use the connect-source loopback num parameter when issuing the msdp-peer command. If you do not use this parameter, the device uses the IP address of the outgoing interface. You should also make sure the IP address of the connect-source loopback is the source IP address used by the PIM-RP, and the BGP device. The commands in the following example add an MSDP neighbor and specify a loopback interface as the source interface for sessions with the neighbor. By default, the device uses the subnet address configured on the physical interface where you configure the neighbor as the source address for sessions with the neighbor. device(config)# interface loopback 1 device(config-lbif-1)# ip address 9.9.9.9/32 device(config)# router msdp device(config-msdp-router)# msdp-peer 2.2.2.99 connect-source loopback 1 Disabling an MSDP peer To disable an MSDP peer, enter the following command at the configure MSDP router level. device(config-msdp-router)# msdp-peer 205.216.162.1 shutdown To disable the MSDP VRF peer named "blue", enter the following commands. device(config)# router msdp vrf blue device(config-msdp-router-vrf-blue)# no msdp-peer 205.216.162.1 Syntax: [no] msdp-peer ip-addr shutdown 116 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols The ip-addr parameter specifies the IP address of the MSDP peer that you want to disable. Designating the interface IP address as the RP IP address When an RP receives a Source Active message, it checks its PIM Sparse multicast group table for receivers for the group. If a receiver exists the RP sends a Join to the source. By default, the IP address included in the RP address field of the SA message is the IP address of the originating RP. An SA message can use the IP address of any interface on the originating RP. (The interface is usually a loopback interface.) To designate an interface IP address to be the IP address of the RP, enter commands such as the following. device(config)# interface loopback 2 device(config-lbif-2)# ip address 2.2.1.99/32 device(config)# router msdp device(config-msdp-router)# originator-id loopback 2 device(config-msdp-router)# exit To specify VRF information, enter the following commands at the MSDP VRF configuration level. device(config)# interface loopback 2 device(config-lbif-2)# ip address 2.2.1.99/32 device(config)# router msdp vrf blue device(config-msdp-router-vrf blue)# originator-id loopback 2 device(config-msdp-router-vrf blue)# exit Syntax: [no] originator-id type number The originator-id command instructs MSDP to use the specified interface IP address as the IP address of the RP in an SA message. This address must be the address of the interface used to connect the RP to the source. The default address used is the RP IP address. The type parameter indicates the type of interface used by the RP. Ethernet, loopback and virtual routing interfaces (ve) can be used. The number parameter specifies the interface number (for example: loopback number, port number or virtual routing interface number.) Filtering MSDP source-group pairs You can filter individual source-group pairs in MSDP Source-Active messages: ∙ sa-filter in - Filters source-group pairs received in Source-Active messages from an MSDP neighbor. ∙ sa-filter originate - Filters self-originated source-group pairs in outbound Source-Active messages sent to an MSDP neighbor ∙ sa-filter out - Filters self-originated and forwarded source-group pairs in outbound Source-Active messages sent to an MSDP neighbor Filtering incoming and outgoing Source-Active messages The following example configures filters for incoming Source-Active messages from three MSDP neighbors: ∙ For peer 2.2.2.99, all source-group pairs in Source-Active messages from the neighbor are filtered (dropped). ∙ For peer 2.2.2.97, all source-group pairs except those with source address matching 10.x.x.x and group address of 235.10.10.1 are permitted. ∙ For peer 2.2.2.96, all source-group pairs except those associated with RP 2.2.42.3 are permitted. To configure filters for incoming Source-Active messages, enter commands at the MSDP VRF configuration level. To configure filters for outbound Source-Active messages, enter the optional out keyword. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 117 IPv4 Multicast Protocols Example The following commands configure extended ACLs. The ACLs will be used in route maps, which will be used by the Source-Active filters. device(config)# access-list 123 permit ip 10.0.0.0 0.255.255.255 host 235.10.10.1 device(config)# access-list 124 permit ip host 2.2.42.3 any device(config)# access-list 125 permit ip any any The following commands configure the route maps. device(config)# route-map msdp_map deny 1 device(config-routemap msdp_map)# match ip address 123 device(config-routemap msdp_map)# exit device(config)# route-map msdp_map permit 2 device(config-routemap msdp_map)# match ip address 125 device(config-routemap msdp_map)# exit device(config)# route-map msdp2_map permit 1 device(config-routemap msdp2_map)# match ip address 125 device(config-routemap msdp2_map)# exit device(config)# route-map msdp2_rp_map deny 1 device(config-routemap msdp2_rp_map)# match ip route-source 124 device(config-routemap msdp2_rp_map)# exit device(config)# route-map msdp2_rp_map permit 2 device(config-routemap msdp2_rp_map)# match ip route-source 125 device(config-routemap msdp2_rp_map)# exit The following commands configure the Source-Active filters. To specify VRF information, enter the following commands at the MSDP VRF configuration level. device(config)# router msdp vrf blue device(config-msdp-router-vrf blue)# sa-filter in 2.2.2.99 device(config-msdp-router-vrf blue)# sa-filter in 2.2.2.97 route-map msdp_map device(config-msdp-router-vrf blue)# sa-filter in 2.2.2.96 route-map msdp2_map rp-route-map msdp2_rp_map The sa-filter commands configure the following filters: ∙ sa-filter in 2.2.2.99 - This command drops all source-group pairs received from neighbor 2.2.2.99. NOTE The default action is to deny all source-group pairs from the specified neighbor. If you want to permit some pairs, use route maps. ∙ sa-filter in 2.2.2.97 route-map msdp_map - This command drops source-group pairs received from neighbor 2.2.2.97 if the pairs have source addresses matching 10.x.x.x and group address 235.10.10.1. ∙ sa-filter in 2.2.2.96 route-map msdp2_map rp-route-map msdp2_rp_map - This command accepts all source-group pairs except those associated with RP 2.2.42.3. Syntax: [no] sa-filter in | originate | out ip-addr [route-map map-tag ] [rp-route-map rp-map-tag] Selecting the in option applies the filter to incoming Source-Active messages. Selecting the originate option applies the filter to self-originated outbound Source-Active messages. Selecting the out option applies the filter to self-originated and forwarded outbound Source-Active messages. The ip-addr parameter specifies the IP address of the MSDP neighbor. The filters apply to Source-Active messages received from or sent to this neighbor. The route-mapmap-tag parameter specifies a route map. The device applies the filter to source-group pairs that match the route map. Use the match ip addressacl-id command in the route map to specify an extended ACL that contains the source addresses. 118 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols The rp-route-maprp-map-tag parameter specifies a route map to use for filtering based on Rendezvous Point (RP) address. Use this parameter if you want to filter Source-Active messages based on their originating RP. Use the match ip route-sourceacl-id command in the route map to specify an extended ACL that contains the RP address. NOTE The default filter action is deny. If you want to permit some source-group pairs, use a route map. Filtering advertised Source-Active messages The following example configures the device to advertise all source-group pairs except the ones that have source address 10.x.x.x. The following commands configure extended ACLs to be used in the route map definition. device(config)# access-list 123 permit ip 10.0.0.0 0.255.255.255 any device(config)# access-list 125 permit ip any any The following commands use the above ACLs to configure a route map which denies source-group with source address 10.x.x.x and any group address, while permitting everything else. device(config)# route-map msdp_map deny 1 device(config-routemap msdp_map)# match ip address 123 device(config-routemap msdp_map)# exit device(config)# route-map msdp_map permit 2 device(config-routemap msdp_map)# match ip address 125 device(config-routemap msdp_map)# exit The following commands configure the Source-Active filter. device(config)# router msdp device(config-msdp-router)# sa-filter originate route-map msdp_map To specify VRF information, enter the following commands at the MSDP VRF configuration level. device(config)# router msdp vrf blue device(config-msdp-router-vrf blue)# sa-filter originate route-map msdp_map Syntax: [no] sa-filter originate [route-map map-tag ] The route-mapmap-tag parameter specifies a route map. The router applies the filter to source-group pairs that match the route map. Use the match ip addressacl-id command in the route map to specify an extended ACL that contains the source and group addresses. NOTE The default filter action is deny. If you want to permit some source-group pairs, use a route map. A permit action in the route map allows the device to advertise the matching source-group pairs. A deny action in the route map drops the source-group pairs from advertisements. Displaying MSDP information You can display the following MSDP information: ∙ Summary information - the IP addresses of the peers, the state of the device MSDP session with each peer, and statistics for keepalive, source active, and notification messages sent to and received from each of the peers ∙ VRF Information - Summary information for a specific VRF ∙ Peer information - the IP address of the peer, along with detailed MSDP and TCP statistics ∙ Source Active cache entries - the source active messages cached by the router. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 119 IPv4 Multicast Protocols Displaying summary information To display summary MSDP information, enter the CLI command. Brocade(config)#show ip msdp vrf blue summary MSDP Peer Status Summary KA: Keepalive SA:Source-Active NOT: Notification Peer Address Peer As State KA In Out 40.40.40.1 1001 ESTABLISH 59 59 40.40.40.3 1001 ESTABLISH 59 59 47.1.1.2 N/A ESTABLISH 59 59 Brocade(config)# In 0 0 0 SA Out 0 0 0 In 0 0 0 NOT Out 0 0 0 Age 6 47 47 Syntax: show ip msdp summary The following table describes the output from this command. TABLE 16 MSDP summary information This field... Displays... Peer address The IP address of the peer interface with the device State The state of the MSDP device connection with the peer. The state can be one of the following: ∙ CONNECTING - The session is in the active open state. ∙ ESTABLISHED - The MSDP session is fully up. ∙ INACTIVE - The session is idle. ∙ LISTENING - The session is in the passive open state. KA In The number of MSDP keepalive messages the MSDP device has received from the peer KA Out The number of MSDP keepalive messages the MSDP device has sent to the peer SA In The number of source active messages the MSDP device has received from the peer SA Out The number of source active messages the MSDP device has sent to the peer NOT In The number of notification messages the MSDP router has received from the peer NOT Out The number of notification messages the MSDP router has sent to the peer Displaying peer information To display MSDP peer information, enter the following command. Brocade#show ip msdp peer IP Address State Mesh-group-name 1 77.1.1.2 ESTABLISH Keep Alive Time Hold Time Age 60 75 53 Message Sent Message Received Keep Alive 1240 1239 Notifications 0 0 Source-Active 0 0 Lack of Resource 0 Last Connection Reset Reason:Reason Unknown Notification Message Error Code Received:Unspecified Notification Message Error SubCode Received:Not Applicable Notification Message Error Code Transmitted:Unspecified Notification Message Error SubCode Transmitted:Not Applicable Local IP Address: 55.1.1.2 120 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols TCP Connection state: ESTABLISHED Local host: 55.1.1.2, Local Port: 8730 Remote host: 77.1.1.2, Remote Port: 639 ISentSeq: 1207132337 SendNext: 1207132386 SendWnd: 16381 TotSent: 49 IRcvSeq: 4000739 RcvNext: 4000788 TotalRcv: 49 RcvQue: 0 Input SA Filter:Not Applicable Input (S,G) route-map:None Input RP route-map:None Output SA Filter:Not Applicable Output (S,G) route-map:None Output RP route-map:None TotUnAck: ReTrans: RcvWnd: SendQue: 0 0 16384 0 Syntax: show ip msdp [vrf vrf-name ] peer The following table describes the output from this command. TABLE 17 MSDP peer information This field... Displays... Total number of MSDP peers The number of MSDP peers configured on the device IP Address The IP address of the peer’s interface with the device State The state of the MSDP device connection with the peer. The state can be one of the following: ∙ CONNECTING - The session is in the active open state. ∙ ESTABLISHED - The MSDP session is fully up. ∙ INACTIVE - The session is idle. ∙ LISTENING - The session is in the passive open state. Keep Alive Time The keepalive time, which specifies how often this MSDP device sends keep alive messages to the neighbor. The keep alive time is 60 seconds and is not configurable. Hold Time The hold time, which specifies how many seconds the MSDP device will wait for a KEEPALIVE or UPDATE message from an MSDP neighbor before deciding that the neighbor is dead. The hold time is 90 seconds and is not configurable. Keep Alive Message Sent The number of keepalive messages the MSDP device has sent to the peer. Keep Alive Message Received The number of keepalive messages the MSDP device has received from the peer. Notifications Sent The number of notification messages the MSDP device has sent to the peer. Notifications Received The number of notification messages the MSDP device has received from the peer. Source-Active Sent The number of source active messages the MSDP device has sent to the peer. Source-Active Received The number of source active messages the MSDP device has received from the peer. Last Connection Reset Reason The reason the previous session with this neighbor ended. Notification Message Error Code Received The MSDP device has received a notification message from the neighbor that contains an error code corresponding to one of the following errors. Some errors have subcodes that clarify the reason for the error. Where applicable, the subcode messages are listed underneath the error code messages: FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 ∙ 1 - Message Header Error ∙ 2 - SA-Request Error ∙ 3 - SA-Message or SA-Response Error 121 IPv4 Multicast Protocols TABLE 17 MSDP peer information (continued) This field... Displays... ∙ 4 - Hold Timer Expired ∙ 5 - Finite State Machine Error ∙ 6 - Notification ∙ 7 - Cease For information about these errors, refer to section 17 in the Internet draft describing MSDP, "draft-ietf-msdp-spec". Notification Message Error SubCode Received See above. Notification Message Error Code Transmitted The error message corresponding to the error code in the NOTIFICATION message this MSDP router sent to the neighbor. See the description for the Notification Message Error Code Received field for a list of possible codes. Notification Message Error SubCode Transmitted See above. TCP Statistics TCP connection state The state of the connection with the neighbor. Can be one of the following: ∙ LISTEN - Waiting for a connection request. ∙ SYN-SENT - Waiting for a matching connection request after having sent a connection request. ∙ SYN-RECEIVED - Waiting for a confirming connection request acknowledgment after having both received and sent a connection request. ∙ ESTABLISHED - Data can be sent and received over the connection. This is the normal operational state of the connection. ∙ FIN-WAIT-1 - Waiting for a connection termination request from the remote TCP, or an acknowledgment of the connection termination request previously sent. ∙ FIN-WAIT-2 - Waiting for a connection termination request from the remote TCP. ∙ CLOSE-WAIT - Waiting for a connection termination request from the local user. ∙ CLOSING - Waiting for a connection termination request acknowledgment from the remote TCP. ∙ LAST-ACK - Waiting for an acknowledgment of the connection termination request previously sent to the remote TCP (includes an acknowledgment of the connection termination request). ∙ TIME-WAIT - Waiting for enough time to pass to be sure the remote TCP received the acknowledgment of the connection termination request. ∙ CLOSED - There is no connection state. Local host The IP address of the MSDP device interface with the peer. Local port The TCP port the MSDP router is using for the BGP4 TCP session with the neighbor. Remote host The IP address of the neighbor. Remote port The TCP port number of the peer end of the connection. ISentSeq The initial send sequence number for the session. SendNext The next sequence number to be sent. TotUnAck The number of sequence numbers sent by the MSDP device that have not been acknowledged by the neighbor. SendWnd The size of the send window. 122 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols TABLE 17 MSDP peer information (continued) This field... Displays... TotSent The number of sequence numbers sent to the neighbor. ReTrans The number of sequence numbers the MSDP device retransmitted because they were not acknowledged. IRcvSeq The initial receive sequence number for the session. RcvNext The next sequence number expected from the neighbor. RcvWnd The size of the receive window. TotalRcv The number of sequence numbers received from the neighbor. RcvQue The number of sequence numbers in the receive queue. SendQue The number of sequence numbers in the send queue. Displaying Source Active cache information To display the Source Actives in the MSDP cache, use the following command. device # show ip msdp vrf blue sa-cacheTotal of 10 SA cache entriesIndex RP address (Source, Group) Orig Peer Age1 2.2.2.2 (192.6.1.10, 227.1.1.1) 192.1.1.2 0 2 2.2.2.2 (192.6.1.10, 227.1.1.2) 192.1.1.2 0 3 2.2.2.2 (192.6.1.10, 227.1.1.3) 192.1.1.2 0 4 2.2.2.2 (192.6.1.10, 227.1.1.4) 192.1.1.2 0 5 2.2.2.2 (192.6.1.10, 227.1.1.5) 192.1.1.2 0 6 2.2.2.2 (192.6.1.10, 227.1.1.6) 192.1.1.2 0 7 2.2.2.2 (192.6.1.10, 227.1.1.7) 192.1.1.2 0 8 2.2.2.2 (192.6.1.10, 227.1.1.8) 192.1.1.2 0 9 2.2.2.2 (192.6.1.10, 227.1.1.9) 192.1.1.2 0 10 2.2.2.2 (192.6.1.10, 227.1.1.10) 192.1.1.2 0 Syntax: show ip msdp [ vrf vrf-name ] sa-cache [source-address | group-address | peer-as as-number | counts | orig-rp rp-address | peer peer-address ] [ rejected | self-originated ] ] The source-address parameter selects the source address of the SA entry. The group-address parameter selects the group address of the SA entry. The peer-as keyword specifies the BGP AS Number of the forwarding peer. The counts keyword displays only the count of entries. The orig-rp keyword specifies the originating RP address. The peer keyword specifies the peer address. The rejected keyword displays the rejected SAs. The self-originated keyword displays the self-originated SAs. The following table describes the output from this command. TABLE 18 MSDP source active cache This field... Displays... Total The number of entries the cache currently contains. Index The cache entry number. RP The RP through which receivers can access the group traffic from the source SourceAddr The IP address of the multicast source. GroupAddr The IP multicast group to which the source is sending information. Orig Peer The peer from which this source-active entry was received. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 123 IPv4 Multicast Protocols TABLE 18 MSDP source active cache (continued) This field... Displays... Age The number of seconds the entry has been in the cache You can use the following command to filter the output to display only the entries matching a specific source. device#show ip msdp sa-cache 1.1.1.1 You can use the following command to filter the output to display only the entries matching a specific group. device#show ip msdp sa-cache 239.1.1.1 You can use the following command to filter the output to display only the SA cache entries that are received from peers in the BGP AS Number 100. device#show ip msdp sa-cache 100 You can use the following command to filter the output to display only the SA cache entries that are originated by the RP 1.1.1.1. device#show ip msdp sa-cache orig-rp 1.1.1.1 You can use the following command to filter the output to display only the SA cache entries that are received from the peer 1.1.1.1. device#show ip msdp sa-cache peer 1.1.1.1 You can use the following command to display the rejected SAs. You can further narrow down by quoting the reason for rejection. device#show ip msdp sa-cache rejected You can use the following command to display the self-originated SAs. device#show ip msdp sa-cache self-originated Displaying MSDP RPF-Peer To display MSDP peer information for the RP 1.1.1.1, enter the following command. device# show ip msdp rpf-peer 1.1.1.1 MSDP Peer Status Summary KA: Keepalive SA:Source-Active NOT: Notification Peer Address Peer As State KA SA NOT Age In Out In Out In Out 40.40.40.3 1001 ESTABLISH 62 62 0 0 0 0 7 Brocade# Syntax: show ip msdp [vrf vrf-name ] rpf-peer ip-addr Displaying MSDP Peer To display MSDP peer information, enter the following command. Brocade# show ip msdp peer 40.40.40.3 MSDP Peer Status Summary KA: Keepalive SA:Source-Active NOT: Notification Peer Address Peer As State KA SA NOT Age In Out In Out In Out 124 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols 40.40.40.3 1001 ESTABLISH 62 62 0 0 0 0 7 Brocade# Syntax: show ip msdp peer peer-addr Displaying MSDP VRF RPF-Peer To display MSDP peer information for a specific VRF, enter the following command. Brocade#sh ip msdp vrf Blue rpf-peer 40.40.40.2 MSDP Peer Status Summary KA: Keepalive SA:Source-Active NOT: Notification Peer Address Peer As State KA 40.40.40.2 1001 ESTABLISH 5569 5568 SA 0 0 In 0 NOT Out 0 Age In 57 Out In Out Syntax: show ip msdp vrf VRF-name rpf-peer ip-addr Clearing MSDP information You can clear the following MSDP information: ∙ Peer information ∙ Source active cache ∙ MSDP statistics Clearing peer information To clear MSDP peer information, enter the following command at the Privileged EXEC level of the CLI. device# clear ip msdp peer 205.216.162.1 Syntax: clear ip msdp peer [ip-addr ] The command in this example clears the MSDP peer connection with MSDP router 205.216.162.1. The CLI displays a message to indicate when the connection has been successfully closed. To clear all the peers, omit the ip-addr variable from the command. Clearing peer information on a VRF To clear the MSDP VRF peers, enter the following command at the MSDP VRF configuration level. device#clear ip msdp vrf blue peer 207.207.162.5 Syntax: clear ip msdp [vrf vrf-name ] peer [ ip-addr ] Clearing the source active cache To clear the source active cache, enter the following command at the Privileged EXEC level of the CLI. device# clear ip msdp sa-cache Syntax: clear ip msdp sa-cache [ ip-addr ] The command in this example clears all the cache entries. Use the ip-addr variable to clear only the entries matching either a source or a group. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 125 IPv4 Multicast Protocols Clearing the source active cache for a VRF To clear the MSDP VRF source active cache by entering the following command at the MSDP VRF configuration level. device#clear ip msdp sa-cache vrf blue Syntax: clear ip msdp [vrf vrf-name ] sa-cache [ ip-addr ] Clearing MSDP statistics To clear MSDP statistics, enter the following command at the Privileged EXEC level of the CLI. device# clear ip msdp statistics Syntax: clear ip msdp statistics [ ip-addr ] The command in this example clears statistics for all the peers. To clear statistics for only a specific peer, enter the IP address of the peer. Clearing MSDP VRF statistics To clear the MSDP VRF statistics by entering the following command. device# clear ip msdp vrf blue statistics Syntax: clear ip msdp [vrf vrf-name ] statistics [ip-addr ] The command in this example clears statistics for all the peers. To clear statistics for only a specific peer, enter the IP address of the peer. The command in this example clears all statistics for all the peers in the VRF "blue". Configuring MSDP mesh groups A PIM Sparse domain can have several RPs that are connected to each other to form an MSDP mesh group. To qualify as a mesh group, the RPs have to be fully meshed; that is, each RP must be connected to all peer RPs in a domain. (Refer to Figure 8.) A mesh group reduces the forwarding of SA messages within a domain. Instead of having every RP in a domain forward SA messages to all the RPs within that domain, only one RP forwards the SA message. Since an MSDP mesh group is fully meshed, peers do not forward SA messages received in a domain from one member to any member of the group. The RP that originated the SA or the first RP in a domain that receives the SA message is the only one that forwards the message to the members of a mesh group. An RP can forward an SA message to any MSDP router as long as that peer is farther away from the originating RP than the current MSDP router. The following figure shows an example of an MSDP mesh group. In a PIM-SM mesh group the RPs are configured to be peers of each other. They can also be peers of RPs in other domains. 126 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols FIGURE 8 Example of MSDP mesh group PIM Sparse Domain 1 in Figure 8 contains a mesh group with four RPs. When the first RP, for example, RP 206.251.21.31 originates or receives an SA message from a peer in another domain, it sends the SA message to its peers within the mesh group. However, the peers do not send the message back to the originator RP or to each other. The RPs then send the SA message farther away to their peers in other domains.The process continues until all RPs within the network receive the SA message. Configuring MSDP mesh group To configure an MSDP mesh group, enter commands such as the following on each device that will be included in the mesh group. device(config)# router msdp device(config-msdp-router)# device(config-msdp-router)# device(config-msdp-router)# device(config-msdp-router)# msdp-peer 206.251.18.31 connect-source loopback 2 msdp-peer 206.251.19.31 connect-source loopback 2 msdp-peer 206.251.20.31 connect-source loopback 2 mesh-group GroupA 206.251.18.31 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 127 IPv4 Multicast Protocols device(config-msdp-router)# mesh-group GroupA 206.251.19.31 device(config-msdp-router)# mesh-group GroupA 206.251.20.31 device(config-msdp-router)# exit Syntax: [no] mesh-group group-name peer-address The sample configuration above reflects the configuration in Figure 8 on page 127. On RP 206.251.21.31 you specify its peers within the same domain (206.251.18.31, 206.251.19.31, and 206.251.20.31). You first configure the MSDP peers using the msdp-peer command to assign their IP addresses and the loopback interfaces. Next, place the MSDP peers within a domain into a mesh group. Use the mesh-group command. There are no default mesh groups. The group-name parameter identifies the mesh group. Enter up to 31 characters for group-name. You can have up to 4 mesh groups within a multicast network. Each mesh group can include up to 15 peers. The peer-address parameter specifies the IP address of the MSDP peer that is being placed in the mesh group. Each mesh group can include up to 32 peers. NOTE On each of the device that will be part of the mesh group, there must be a mesh group definition for all the peers in the meshgroup. A maximum of 32 MSDP peers can be configured per mesh group. You can use the show ip msdp [ vrf vrf-name ] mesh-group group-name command to view the details of a specific mesh-group or the mesh-group details for the VRF instance specified by the vrf-name variable. . MSDP Anycast RP MSDP Anycast RP is a method of providing intra-domain redundancy and load-balancing between multiple Rendezvous Points (RP) in a Protocol Independent Multicast Sparse mode (PIM-SM) network. It is accomplished by configuring all RPs within a domain with the same anycast RP address which is typically a loopback IP address. Multicast Source Discovery Protocol (MSDP) is used between all of the RPs in a mesh configuration to keep all RPs in sync regarding the active sources. PIM-SM routers are configured to register (statically or dynamically) with the RP using the same anycast RP address. Since multiple RPs have the same anycast address, an Interior Gateway Protocol (IGP) such as OSPF routes the PIM-SM router to the RP with the best route. If the PIM-SM routers are distributed evenly throughout the domain, the loads on RPs within the domain will be distributed. If the RP with the best route goes out of service, the PIM-SM router’s IGP changes the route to the closest operating RP that has the same anycast address. This configuration works because MSDP is configured between all of the RPs in the domain. Consequently, all of the RPs share information about active sources. This feature uses functionality that is already available on the Brocade device but re-purposes it to provide the benefits desired as described in RFC 3446. Configuring MSDP Anycast RP To configure MSDP Anycast RP, you must perform the following tasks: 128 ∙ Configure a loopback interface with the anycast RP address on each of the RPs within the domain and enable PIM-SM on these interfaces. ∙ Ensure that the anycast RP address is leaked into the IGP domain. This is typically done by enabling the IGP on the loopback interface (in passive mode) or redistributing the connected loopback IP address into the IGP. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols NOTE The anycast RP address *must* not be the IGP router-id. ∙ Enable PIM-SM on all interfaces on which multicast routing is desired. ∙ Enable an IGP on each of the loopback interfaces and physical interfaces configured for PIM-SM. ∙ Configure loopback interfaces with unique IP addresses on each of the RPs for MSDP peering. This loopback interface is also used as the MSDP originator-id. ∙ The non-RP PIM-SM routers may be configured to use the anycast RP address statically or dynamically (by the PIMv2 bootstrap mechanism). Example The example shown in Figure 9 is a simple MSDP Anycast-enabled network with two RPs and two PIM-SM routers. Loopback 1 in RP 1 and RP 2 have the same IP address. Loopback 2 in RP1 and Loopback 2 in RP2 have different IP addresses and are configured as MSDP peering IP addresses in a mesh configuration. In the PIM configuration for PIM-SM routers PIMR1 and PIMR2 the RP address is configured to be the anycast RP address that was configured on the Loopback 1 interfaces on RP1 and RP2. OSPF is configured as the IGP for the network and all of the devices are in OSPF area 0. Since PIMR1 has a lower cost path to RP1 and PIMR2 has a lower cost path to RP2 they will register with the respective RPs when both are up and running. This shares the load between the two RPs. If one of the RPs fails, the higher-cost path to the IP address of Loopback 1 on the RPs is used to route to the still-active RP. The configuration examples demonstrate the commands required to enable this application. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 129 IPv4 Multicast Protocols FIGURE 9 Example of a MDSP Anycast RP network RP 1 configuration The following commands provide the configuration for the RP 1 router in Figure 9. RP1(config)#router ospf RP1(config-ospf-router)# area 0 RP1(config-ospf-router)# exit RP1(config)# interface loopback 1 RP1(config-lbif-1)# ip ospf area 0 RP1(config-lbif-1)# ip ospf passive RP1(config-lbif-1)# ip address 10.0.0.1/32 RP1(config-lbif-1)# ip pim-sparse RP1(config-lbif-1)# exit RP1(config)# interface loopback 2 RP1(config-lbif-2)# ip ospf area 0 RP1(config-lbif-2)# ip ospf passive RP1(config-lbif-2)# ip address 10.1.1.1/32 RP1(config-lbif-2)# exit RP1(config)# interface ethernet 1/5/1 RP1(config-if-e1000-1/5/1)# ip ospf area 0 RP1(config-if-e1000-1/5/1)# ip address 192.1.1.1/24 RP1(config-if-e1000-1/5/1)# ip pim-sparse RP1(config)# interface ethernet 1/5/2 RP1(config-if-e1000-1/5/2)# ip ospf area 0 RP1(config-if-e1000-1/5/2)# ip ospf cost 5 RP1(config-if-e1000-1/5/2)# ip address 192.2.1.1/24 RP1(config-if-e1000-1/5/2)# ip pim-sparse RP1(config)# interface ethernet 1/5/3 RP1(config-if-e1000-1/5/3)# ip ospf area 0 RP1(config-if-e1000-1/5/3)# ip ospf cost 10 RP1(config-if-e1000-1/5/3)# ip address 192.3.1.1/24 RP1(config-if-e1000-1/5/3)# ip pim-sparse 130 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols RP1(config-if-e1000-1/5/3)# exit RP1(config)# router pim RP1(config-pim-router)# rp-candidate loopback 1 RP1(config-pim-router)# exit RP1(config)# router msdp RP1(config-msdp-router)# msdp-peer 10.1.1.2 connect-source loopback 2 RP1(config-msdp-router)# originator-id loopback 2 RP 2 configuration The following commands provide the configuration for the RP 2 router in Figure 9. RP2(config)#router ospf RP2(config-ospf-router)# area 0 RP2(config-ospf-router)# exit RP2(config)# interface loopback 1 RP2(config-lbif-1)# ip ospf area 0 RP2(config-lbif-1)# ip ospf passive RP2(config-lbif-1)# ip address 10.0.0.1/32 RP2(config-lbif-1)# ip pim-sparse RP2(config-lbif-1)# exit RP2(config)# interface loopback 2 RP2(config-lbif-2)# ip ospf area 0 RP2(config-lbif-2)# ip ospf passive RP2(config-lbif-2)# ip address 10.1.1.2/32 RP2(config-lbif-2)# exit RP2(config)# interface ethernet 1/5/1 RP2(config-if-e1000-1/5/1)# ip ospf area 0 RP2(config-if-e1000-1/5/1)# ip address 192.1.1.2/24 RP2(config-if-e1000-1/5/1)# ip pim-sparse RP2(config)# interface ethernet 1/5/2 RP2(config-if-e1000-1/5/2)# ip ospf area 0 RP2(config-if-e1000-1/5/2)# ip ospf cost 5 RP2(config-if-e1000-1/5/2)# ip address 192.5.2.1/24 RP2(config-if-e1000-1/5/2)# ip pim-sparse RP2(config)# interface ethernet 1/5/3 RP2(config-if-e1000-1/5/3)# ip ospf area 0 RP2(config-if-e1000-1/5/3)# ip ospf cost 10 RP2(config-if-e1000-1/5/3)# ip address 192.6.1.2/24 RP2(config-if-e1000-1/5/3)# ip pim-sparse RP2(config-if-e1000-1/5/3)# exit RP2(config)# router pim RP2(config-pim-router)# rp-candidate loopback 1 RP2(config-pim-router)# exit RP2(config)# router msdp RP2(config-msdp-router)# msdp-peer 10.1.1.1 connect-source loopback 2 RP2(config-msdp-router)# originator-id loopback 2 PIMR1 configuration The following commands provide the configuration for the PIMR1 router in Figure 9. PIMR1(config)#router ospf PIMR1(config-ospf-router)# area 0 PIMR1(config-ospf-router)# exit PIMR1(config)# interface ethernet 1/6/2 PIMR1(config-if-e1000-1/6/2)# ip ospf area 0 PIMR1(config-if-e1000-1/6/2)# ip ospf cost 5 PIMR1(config-if-e1000-1/6/2)# ip address 192.2.1.2/24 PIMR1(config-if-e1000-1/6/2)# ip pim-sparse PIMR1(config)# interface ethernet 1/6/3 PIMR1(config-if-e1000-1/6/3)# ip ospf area 0 PIMR1(config-if-e1000-1/6/3)# ip ospf cost 10 PIMR1(config-if-e1000-1/6/3)# ip address 192.6.1.1/24 PIMR1(config-if-e1000-1/6/3)# ip pim-sparse PIMR1(config-if-e1000-1/6/3)# exit PIMR1(config)# router pim PIMR1(config-pim-router)# rp-address 10.0.0.1 PIMR1(config-pim-router)# exit FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 131 IPv4 Multicast Protocols PIMR2 configuration The following commands provide the configuration for the PIMR2 router in Figure 9. PIMR2(config)#router ospf PIMR2(config-ospf-router)# area 0 PIMR2(config-ospf-router)# exit PIMR2(config)# interface ethernet 1/1/2 PIMR2(config-if-e1000-1/1/2)# ip ospf area 0 PIMR2(config-if-e1000-1/1/2)# ip ospf cost 5 PIMR2(config-if-e1000-1/1/2)# ip address 192.5.2.2/24 PIMR2(config-if-e1000-1/1/2)# ip pim-sparse PIMR2(config)# interface ethernet 1/1/3 PIMR2(config-if-e1000-1/1/3)# ip ospf area 0 PIMR2(config-if-e1000-1/1/3)# ip ospf cost 10 PIMR2(config-if-e1000-1/1/3)# ip address 192.3.1.2/24 PIMR2(config-if-e1000-1/1/3)# ip pim-sparse PIMR2(config-if-e1000-1/1/3)# exit PIMR2(config)# router pim PIMR2(config-pim-router)# rp-address 10.0.0.1 PIMR2(config-pim-router)# exit PIM Anycast RP PIM Anycast RP is a method of providing load balancing and fast convergence to PIM RPs in an IPv4 multicast domain. The RP address of the Anycast RP is a shared address used among multiple PIM routers, known as PIM RP. The PIM RP routers create an Anycast RP set. Each router in the Anycast RP set is configured using two IP addresses; a shared RP address in their loopback address and a separate, unique ip address. The loopback address must be reachable by all PIM routers in the multicast domain. The separate, unique ip address is configured to establish static peering with other PIM routers and communication with the peers. When the source is activated in a PIM Anycast RP domain, the PIM First Hop (FH) will register the source to the closet PIM RP. The PIM RP follows the same MSDP Anycast RP operation by decapsulating the packet and creating the (s,g) state. If there are external peers in the Anycast RP set, the router will re-encapsulate the packet with the local peering address as the source address of the encapsulation. The router will unicast the packet to all Anycast RP peers. The re-encapsulation of the data register packet to Anycast RP peers ensures source state distribution to all RPs in a multicast domain. Configuring PIM Anycast RP A new PIM CLI is introduced for PIM Anycast RP under the router pim sub mode. The PIM CLI specifies mapping of the RP and the Anycast RP peers. To configure PIM Anycast RP, enter the following command. device(config)#router pim device(config-pim-router)#rp-address 100.1.1.1 device(config-pim-router)#anycast-rp 100.1.1.1 my-anycast-rp-set-acl Syntax: [no] anycast-rp rp-address anycast-rp-set-acl The rp address parameter specifies a shared RP address used among multiple PIM routers. The anycast-rp-set-acl parameter specifies a host based simple acl used to specifies the address of the Anycast RP set, including a local address. The following example is a configuration of PIM Anycast RP 100.1.1.1.The example avoids using loopback 1 interface when configuring PIM Anycast RP because the loopback 1 address could be used as a router-id. A PIM First Hop router will register the source with the 132 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols closest RP. The first RP that receives the register will re-encapsulate the register to all other Anycast RP peers. Please refer to Figure 10 as described in the configuration of PIM Anycast RP 100.1.1.1. device(config)#interface loopback 2 device(config-lbif-2)#ip address 100.1.1.1/24 device(config-lbif-2)#ip pim-sparse device(config-lbif-2)#interface loopback 3 device(config-lbif-3)#ip address 1.1.1.1/24 device(config-lbif-3)#ip pim-sparse device(config-lbif-3)#router pim device(config-pim-router)#rp-address 100.1.1.1 device(config-pim-router)#anycast-rp 100.1.1.1 my-anycast-rp-set device(config-pim-router)#ip access-list standard my-anycast-rp-set device(config-std-nacl)#permit host 1.1.1.1 device(config-std-nacl)#permit host 2.2.2.2 device(config-std-nacl)#permit host 3.3.3.3 The RP shared address 100.1.1.1 is used in the PIM domain. IP addresses 1.1.1.1, 2.2.2.2, and 3.3.3.3 are listed in the ACL that forms the self inclusive Anycast RP set. Multiple anycast-rp instances can be configured on a system; each peer with the same or different Anycast RP set. NOTE The PIM software supports up to eight PIM Anycast-RP routers. All deny statements in the anycast_rp_set acl and additional routers more than eight listed in an access list are ignored. The example shown in the following figure is a PIM Anycast-enabled network with 3 RPs, 1 PIM-FH router connecting to its active source and local receiver. Loopback 2 in RP1, RP2, and RP3 have the same IP addresses 100.1.1.1. Loopback 3 in RP1, RP2, and RP3 each have separate IP addresses configured to communicate with their peers in the Anycast RP set. FIGURE 10 Example of a PIM Anycast RP network Displaying information for a PIM Anycast RP interface To display information for a PIM Anycast RP interface, enter the following command. device(config)#show ip pim anycast-rp Number of Anycast RP: 1 Anycast RP: 100.1.1.1 ACL ID: 200 ACL Name: my-anycast-rp-set ACL Filter: SET Peer List: 1.1.1.1 2.2.2.2 3.3.3.3 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 133 IPv4 Multicast Protocols Syntax: show ip pim [vrf vrf-name ] anycast-rp The following table describes the parameters of the show ip pim anycast-rp command: TABLE 19 Display of show ip pim anycast-rp This field... Displays... Number of Anycast RP: The Number of Anycast RP specifies the number of Anycast RP sets in the multicast domain. Anycast RP: The Anycast RP address specifies a shared RP address used among multiple PIM routers. ACL ID: The ACL ID specifies the ACL ID assigned. ACL Name The ACL Name specifies the name of the Anycast RP set. ACL Filter The ACL Filter specifies the ACL filter state SET or UNSET. Peer List The Peer List specifies host addresses that are permitted in the Anycast RP set. NOTE MSDP and Anycast RP do not interoperate. If transitioning from MSDP to Anycast RP or vice versa, all RPs in the network must be configured for the same method of RP peering; either Anycast RP or MSDP. Static multicast routes Configure static multicast routes to control the network paths, administrative distance, and precedence for multicast routes. Static multicast routes allow you to control the network path used by multicast traffic. Static multicast routes are especially useful when the unicast and multicast topologies of a network are different. By configuring static multicast routes you don't have to make the topologies similar. NOTE In IP multicasting, source IP addresses are unicast addresses while destination IP addresses are multicast (group) addresses. Therefore, in IP multicasting, a route lookup is done for source IP address, rather than its destination IP address. You can configure more than one static multicast route. The device always uses the most specific route that matches a multicast source address. Thus, if you want to configure a multicast static route for a specific multicast source and also configure another multicast static route for all other sources, you can configure two static routes Configure the distance keyword in the ip mroute command to specify the administrative distance, which the device uses to determine the best path for a route. When comparing multiple paths for a route, the device prefers the path with the lower administrative distance. To ensure that the default static route is used, configure a low administrative distance value. However, the device prefers directly connected routes over other routes, no matter what the administrative distance. Configure the route-precedence command to specify a precedence table that dictates how routes are selected for multicast. IGMP Proxy IGMP Proxy provides a means for routers to receive any or all multicast traffic from an upstream device if the router is not able to run PIM and runs only IGMP. IGMP Proxy supports IGMP v1, v2, and v3. IGMP Proxy enables the router to issue IGMP host messages on behalf of hosts that the router discovered through standard PIM interfaces. The router acts as a proxy for its hosts and performs the host portion of the IGMP task on the upstream interface as follows: ∙ 134 When queried, the router sends group membership reports for the groups learned. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols ∙ When one of its hosts joins a multicast address group to which none of its other hosts belong, the router sends unsolicited membership reports to that group. ∙ When the last of its hosts in a particular multicast group leaves the group, the router sends an unsolicited leave group membership report to group (multicast IP address 224.0.0.2). IGMP proxy configuration notes When using IGMP Proxy, you must do the following. 1. Configure PIM on all multicast client ports to build the group membership table. The group membership table will be reported by the proxy interface. Refer to Globally enabling and disabling PIM on page 81. 2. Enable IP multicast on an interface to an upstream router that will be the IGMP proxy interface and configure IGMP Proxy on that interface. IGMP proxy limitations ∙ IGMP Proxy cannot be enabled on the same interface on which PIM SM or PIM DM is enabled. ∙ IGMP Proxy is only supported in a PIM Dense environment where there are IGMP clients connected to the Brocade device. The Brocade device does not send IGMP reports on an IGMP proxy interface for remote clients connected to a PIM neighbor,because it is not aware of groups that the remote clients are interested in. Static groups on the other PIM interfaces are included in proxy reports. ∙ PIM DM must be enabled in passive mode. This is a change from the previous implementation; to be backward compatible, PIM-DM passive mode is enabled in passive mode indirectly if PIM-DM is not enabled explicitly. Configuring IGMP Proxy Perform the following steps to configure IGMP Proxy. 1. Configure router PIM globally. device(config)# router pim 2. Configure an IP address on the interface (physical, virtual routing, or tunnel interface) that will serve as the IGMP proxy for an upstream device by entering commands such as the following. device(config)# interface ethernet 1/1/3 device(config-if-e1000-1/1/3)# ip address 10.95.5.1/24 3. Enable PIM passive on the interface. device(config-if-e1000-1/1/3)# ip pim passive 4. Enable IGMP Proxy on the interface. device(config-if-e1000-1/1/3)# ip igmp proxy Syntax: [no] ip igmp proxy Filtering groups in proxy report messages Once IGMP Proxy is configured and the router receives a query on an IGMP Proxy interface, the router sends a report in response to the query before the IGMP maximum response time expires. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 135 IPv4 Multicast Protocols You can filter out groups in proxy report messages by specifying an access list name or number. Brocade(config-if-e1000-1/1/3)# ip igmp proxy group-filter ACL1 Syntax: [no] ip igmp proxy group-filter access_list To remove the group filter association without disabling the proxy, please apply the command ip igmp proxy without the group filter option. Displaying IGMP Proxy information Use the show ip igmp proxy command to see information about the proxy groups and interfaces on the default VRF. For other VRF instances, use the same command with the vrf option. For example, show ip igmp proxy vrfvrf_name . Brocade#sh ip igmp proxy Proxy instance name: default-vrf Total proxy groups: 4 Address Mode Source ref flags count count ---------------------------------------------------225.1.1.1 exclude 0 0 0 225.1.1.2 exclude 0 0 0 225.1.1.3 exclude 0 0 0 225.1.1.4 exclude 0 0 0 Proxy interfaces ---------------Name Oper Cfg Unsoli Filter Filter Version Robust Interval Acl Id Name ----------------------------------------------------e1/1/3 2 2 1 0 Syntax: show ip igmp proxy The report shows the following information. TABLE 20 Output of show ip igmp proxy Field Description Address Group address. Mode Multicast group mode. Can be "exclude" or "include." Source count Number sources in the given mode. A group in IGMP v2 has exclude mode with zero sources. ref count Number of proxy interfaces where the responses (query, state, change, etc) are scheduled. flags Can be "0" or "1." "1" indicates that the group state has changed and it needs to be reevaluated before a response is generated. "0" indicates that no change in state response is scheduled. Name Interface name. Oper version Current querier version or configured version. Cfg Robust Configured robustness value. Unsoli Interval Unsolitcited report interval in seconds. Filter Acl Id Number of the access list. Filter Name Name of the access list. Use the show ip igmp proxy summary command to see summary information. Brocade# show ip igmp proxy summary Proxy instances: ----------------------------------Inst-Name Total Grps 136 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols ----------------------------------default-vrf 4 The report shows the following information. TABLE 21 Output of show ip igmp proxy summary Field Description Inst-Name Number of the proxy instance. Total Grps NUmber of proxy groups. Syntax: show ip igmp proxy summary Use the show ip igmp proxy stats command to see information about queries and reports on a specific interface. Brocade# show ip igmp proxy stats Intf genQv1 genQv2 genQv3 GrpQ SrcQ Rprtv1 Rprtv2 Rprtv3 leave RX RX RX RX RX TX TX TX TX -------------------------------------------------------------------------------v3000 0 0 0 0 0 0 0 0 0 Syntax: show ip igmp proxy stats The report shows the following information. TABLE 22 Output of show ip igmp proxy stats Field Description Intf Interface genQv1 RX IGMP v1 general query received on proxy interface. genQv2 RX IGMP v2 general query received on proxy interface. genQv3 RX IGMP v3 general query received on proxy interface. GrpQ RX Group query received. SrcQ RX Source query received. Rprtv1 TX IGMP v1 report generated. Rprtv2 TX IGMP 2 report generated. Rprtv3 TX IGMP v3 report generated. leave TX IGMP v2 leave generated. IGMP V3 The Internet Group Management Protocol (IGMP) allows an IPV4 system to communicate IP Multicast group membership information to its neighboring routers. The routers in turn limit the multicast of IP packets with multicast destination addresses to only those interfaces on the router that are identified as IP Multicast group members. In IGMP V2, when a router sent a query to the interfaces, the clients on the interfaces respond with a membership report of multicast groups to the router. The router can then send traffic to these groups, regardless of the traffic source. When an interface no longer needs to receive traffic from a group, it sends a leave message to the router which in turn sends a group-specific query to that interface to see if any other clients on the same interface is still active. In contrast, IGMP V3 provides selective filtering of traffic based on traffic source. A router running IGMP V3 sends queries to every multicast enabled interface at the specified interval. These general queries determine if any interface wants to receive traffic from the router. The following are the three variants of the Query message: FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 137 IPv4 Multicast Protocols ∙ A "General Query" is sent by a multicast router to learn the complete multicast reception state of the neighboring interfaces. In a General Query, both the Group Address field and the Number of Sources (N) field are zero. ∙ A "Group-Specific Query" is sent by a multicast router to learn the reception state, with respect to a *single* multicast address, of the neighboring interfaces. In a Group-Specific Query, the Group Address field contains the multicast address of interest, and the Number of Sources (N) field contains zero. ∙ A "Group-and-Source-Specific Query" is sent by a multicast router to learn if any neighboring interface desires reception of packets sent to a specified multicast address, from any of a specified list of sources. In a Group-and-Source-Specific Query, the Group Address field contains the multicast address of interest, and the Source Address [i] fields contain the source address(es) of interest. The hosts respond to these queries by sending a membership report that contains one or more of the following records that are associated with a specific group: ∙ Current-State Record that indicates from which sources the interface wants to receive and not receive traffic. The record contains source address of interfaces and whether or not traffic will be received or included (IS_IN) or not received or excluded (IS_EX) from that source. The following messages are generated by hosts, not the response Query. These messages are generated when there is a change in the group member state. ∙ Filter-mode-change record. If the interface changes its current state from IS_IN to IS_EX, a TO_EX record is included in the membership report. Likewise, if an interface’s current state changes from IS_EX to IS_IN, a TO_IN record appears in the membership report. IGMP V2 Leave report is equivalent to a TO_IN (empty) record in IGMP V3. This record means that no traffic from this group will be received regardless of the source. An IGMP V2 group report is equivalent to an IS_EX (empty) record in IGMP V3. This record means that all traffic from this group will be received regardless of source. ∙ Source-List-Change Record. If the interface wants to add or remove traffic sources from its membership report, the membership report can have an ALLOW record, which contains a list of new sources from which the interface wishes to receive traffic. It can also contains a BLOCK record, which lists current traffic sources from which the interfaces wants to stop receiving traffic. In response to membership reports from the interfaces, the router sends a Group-Specific or a Group-and-Source Specific query to the multicast interfaces. For example, a router receives a membership report with a Source-List-Change record to block old sources from an interface. The router sends Group-and-Source Specific Queries to the source and group (S,G) identified in the record. If none of the interfaces is interested in the (S,G), it is removed from (S,G) list for that interface on the router. Each IGMP V3-enabled router maintains a record of the state of each group and each physical port within a virtual routing interface. This record contains the group, group-timer, filter mode, and source records information for the group or interface. Source records contain information on the source address of the packet and source timer. If the source timer expires when the state of the group or interface is in Include mode, the record is removed. Default IGMP version IGMP V3 is available for Brocade devices; however, these routers are shipped with IGMP V2-enabled. You must enable IGMP V3 globally or per interface. Also, you can specify what version of IGMP you want to run on a device globally, on each interface (physical port or virtual routing interface), and on each physical port within a virtual routing interface. If you do not specify an IGMP version, IGMP V2 will be used. 138 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols Compatibility with IGMP V1 and V2 Different multicast groups, interfaces, and routers can run their own version of IGMP. Their version of IGMP is reflected in the membership reports that the interfaces send to the router. Routers and interfaces must be configured to recognized the version of IGMP you want them to process. An interface or router sends the queries and reports that include its IGMP version specified on it. It may recognize a query or report that has a different version. For example, an interface running IGMP V2 can recognize IGMP V3 packets, but cannot process them. Also, a router running IGMP V3 can recognize and process IGMP V2 packet, but when that router sends queries to an IGMP V2 interface, the downgraded version is supported, no the upgraded version. If an interface continuously receives queries from routers that are running versions of IGMP that are different from what is on the interface, the interface logs warning messages in the syslog every five minutes. Reports sent by interfaces to routers that contain different versions of IGMP do not trigger warning messages; however, you can see the versions of the packets using the show ip igmp traffic command. The version of IGMP can be specified globally, per interface (physical port or virtual routing interface), and per physical port within a virtual routing interface. The IGMP version set on a physical port within a virtual routing interface supersedes the version set on a physical or virtual routing interface. Likewise, the version on a physical or virtual routing interface supersedes the version set globally on the device. The sections below present how to set the version of IGMP. Globally enabling the IGMP version To globally identify the IGMP version on a Brocade device, enter the following command. device(config)# ip igmp version 3 Syntax: [no] ip igmp version version-number Enter 1, 2, or 3 for version-number . Version 2 is the default version. Enabling the IGMP version per interface setting To specify the IGMP version for a physical port, enter a command such as the following. device(config)# interface ethernet 1/1/5 device(config-if-1/1/5)# ip igmp version 3 To specify the IGMP version for a virtual routing interface on a physical port, enter a command such as the following. device(config)# interface ve 3 device(config-vif-1)# ip igmp version 3 Syntax: [no] ip igmp version version-number Enter 1, 2, or 3 for version-number . Version 2 is the default version. Enabling the IGMP version on a physical port within a virtual routing interface To specify the IGMP version recognized by a physical port that is a member of a virtual routing interface, enter a command such as the following. device(config)# interface ve 3 device(config-vif-3)# ip igmp version 2 device(config-vif-3)# ip igmp port-version 3 ethernet 1/1/3 to ethernet 1/1/7 ethernet 1/2/9 In this example, the second line sets IGMP V2 on virtual routing interface 3. However, the third line set IGMP V3 on ethernet ports 1/1/3 through 1/1/7 and 1/2/9. All other ports in this virtual routing interface are configured with IGMP V2. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 139 IPv4 Multicast Protocols Syntax: [no] ip igmp port-version version-number ethernet unit/slot/port Enter 1, 2, or 3 for version-number . IGMP V2 is the default version. The ethernet unit/slot/port parameter specifies which physical port within a virtual routing interface is being configured. Enabling membership tracking and fast leave NOTE The IGMP V3 fast leave feature is supported in include mode, but does not work in the exclude mode. IGMP V3 provides membership tracking and fast leave of clients. In IGMP V2, only one client on an interface needs to respond to a router’s queries; therefore, some of the clients may be invisible to the router, making it impossible for the switch to track the membership of all clients in a group. Also, when a client leaves the group, the switch sends group specific queries to the interface to see if other clients on that interface need the data stream of the client who is leaving. If no client responds, the switch waits three seconds before it stops the traffic. IGMP V3 contains the tracking and fast leave feature that you enable on virtual routing interfaces. Once enabled, all physical ports on that virtual routing interface will have the feature enabled. IGMP V3 requires all clients to respond to general and group specific queries so that all clients on an interface can be tracked. Fast leave allows clients to leave the group without the three second waiting period, if the following conditions are met: ∙ If the interface, to which the client belongs, has IGMP V3 clients only. Therefore, all physical ports on a virtual routing interface must have IGMP V3 enabled and no IGMP V1 or V2 clients can be on the interface. (Although IGMP V3 can handle V1 and V2 clients, these two clients cannot be on the interface in order for fast leave to take effect.) ∙ No other client on the interface is receiving traffic from the group to which the client belongs. Every group on the physical interface of a virtual routing interface keeps its own tracking record. It can track by (source, group). For example, two clients (Client A and Client B) belong to group1 but each is receiving traffic streams from different sources. Client A receives a stream from (source_1, group1) and Client B receives it from (source_2, group1). Now, if Client B leaves, the traffic stream (source_2, group1) will be stopped immediately. The show ip igmp group tracking command displays that clients in a group that are being tracked. If a client sends a leave message, the client is immediately removed from the group. If a client does not send a report during the specified group membership time (the default is 140 seconds), that client is removed from the tracking list. To enable the tracking and fast leave feature, enter commands such as the following. device(config)# interface ve 13 device(config-vif-13)# ip igmp tracking Syntax: [no] ip igmp tracking Creating a static IGMP group You can configure one or more physical ports to be a permanent (static) member of an IGMP group based on the range or count. To configure two static groups starting from 226.0.0.1, enter either this command: Device(config)# interface ethernet 1/1/5 Device(config-if-e1000-1/1/5)# ip igmp static-group 226.0.0.1 count 2 Or this command: Device(config)# interface ethernet 1/1/5 Device(config-if-e1000-1/1/5)# ip igmp static-group 226.0.0.1 to 226.0.0.2 140 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols Syntax: [no] ip igmp static-group ip-address [ count count-number | to ip-address ] Enter the IP address of the static IGMP group for ip-address. The count-number range is 2-256. To configure two static groups on virtual ports starting from 226.0.0.1, enter either this command: Device(config)# interface ethernet 1/1/5 Device(config-if-e1000-1/1/5)# ip igmp static-group 226.0.0.1 count 2 ethernet 1/1/5 Or this command: Device(config)# interface ve 10 Device(config-vif-10)# ip igmp static-group 226.0.0.1 to 226.0.0.2 ethernet 1/1/5 Syntax: [no] ip igmp static-group ip-address [ count count-number | to ip-address ] ethernet unit/slot/port Enter the IP address of the static IGMP group for ip-address. The count-number range is 2-256. Enter the ID of the physical port of the VLAN that will be a member of the group for ethernet unit/slot/port. NOTE IGMPv3 does not support static IGMP group members. NOTE Static IGMP groups are supported only in Layer 3 mode. Setting the query interval The IGMP query interval period defines how often a switch will query an interface for group membership. Possible values are 2-3600 seconds and the default value is 125 seconds, but the value you enter must be a little more than twice the group membership time. To modify the default value for the IGMP query interval, enter the following. device(config)# ip igmp query-interval 120 Syntax: [no] ip igmp query-interval 2-3600 The interval must be a little less than one half of the group membership time. Setting the group membership time Group membership time defines how long a group will remain active on an interface in the absence of a group report. Possible values are from 5 - 26000 seconds and the default value is 260 seconds. To define an IGMP membership time of 240 seconds, enter the following. device(config)# ip igmp group-membership-time 240 Syntax: [no] ip igmp group-membership-time 5-26000 Setting the maximum response time The maximum response time defines the maximum number of seconds that a client can wait before it replies to the query sent by the router. Possible values are 1 - 25. The default is 10. To change the IGMP maximum response time, enter a command such as the following at the global CONFIG level of the CLI. device(config)# ip igmp max-response-time 8 Syntax: [no] ip igmp max-response-time num FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 141 IPv4 Multicast Protocols The num parameter specifies the maximum number of seconds for the response time. Enter a value from 1 - 25. The default is 10. Displaying IGMPv3 information The sections below present the show commands available for IGMP V3. Displaying IGMP group status You can display the status of all IGMP multicast groups on a device by entering the following command. device# show ip igmp group Total 2 entries -----------------------------------------------------Idx Group Address Port Intf Mode Timer Srcs ---+----------------+------+------+---------+-----+---1 232.0.0.1 e1/6/2 v30 include 0 7 2 226.0.0.1 e1/6/2 v30 exclude 240 2 e1/6/3 e1/6/3 include 0 3 Total number of groups 2 To display the status of one IGMP multicast group, enter a command such as the following. device# show ip igmp group 239.0.0.1 detail Total 2 entries ----------------------------------------------------Idx Group Address Port Intf Mode Timer Srcs ---+----------------+------+------+-------+-----+---1 226.0.0.1 e1/6/2 v30 exclude 218 2 S: 40.40.40.12 S: 40.40.40.11 S: 40.40.40.10 S: 40.40.40.2 (Age: 218) S: 40.40.40.3 (Age: 218) 226.0.0.1 e1/6/3 e1/6/3 include 0 3 S: 30.30.30.3 (Age: 165) S: 30.30.30.2 (Age: 165) S: 30.30.30.1 (Age: 165) If the tracking and fast leave feature is enabled, you can display the list of clients that belong to a particular group by entering commands such as the following. device# show ip igmp group 224.1.10.1 tracking Total 2 entries ----------------------------------------------------Idx Group Address Port Intf Mode Timer Srcs ---+----------------+------+------+-------+-----+---1 226.0.0.1 e1/6/2 v30 exclude 253 3 S: 40.40.40.12 S: 40.40.40.11 S: 40.40.40.10 S: 40.40.40.2 (Age: 253) C: 10.10.10.1 (Age: 253) S: 40.40.40.3 (Age: 253) C: 10.10.10.1 (Age: 253) 226.0.0.1 e1/6/3 e1/6/3 include 0 3 S: 30.30.30.3 (Age: 196) C: 10.2.0.1 (Age: 196) S: 30.30.30.2 (Age: 196) C: 10.2.0.1 (Age: 196) S: 30.30.30.1 (Age: 196) C: 10.2.0.1 (Age: 196) Syntax: show ip igmp [vrf [vrf-name ] group [ group-address [ detail ] [tracking ] ] If you want a report for a specific multicast group, enter that group’s address for group-address . Omit the group-address if you want a report for all multicast groups. 142 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols The vrf parameter specifies that you want to display IGMP group information for the VRF specified by the vrf-name variable. Enter detail if you want to display the source list of the multicast group. Enter tracking if you want information on interfaces that have tracking enabled. IGMP V2 and V3 statistics displayed on the report for each interface. TABLE 23 Output of show ip igmp group This field Displays Group The address of the multicast group Port The physical port on which the multicast group was received. Intf The virtual interface on which the multicast group was received. Timer Shows the number of seconds the interface can remain in exclude mode. An exclude mode changes to include mode if it does not receive an "IS_EX" or "TO_EX" message during a certain period of time. The default is 140 seconds. Mode Indicates current mode of the interface: include or exclude. If the interface is in Include mode, it admits traffic only from the source list. If an interface is in exclude mode, it denies traffic from the source list and accepts the rest. Srcs Identifies the source list that will be included or excluded on the interface. If IGMP V2 group is in exclude mode with a #_src of 0, the group excludes traffic from 0 (zero) source list, which means that all traffic sources are included. Clearing the IGMP group membership table To clear the IGMP group membership table, enter the following command. device# clear ip igmp cache Syntax: clear ip igmp [vrf vrf-name ] cache This command clears the IGMP membership for the default router instance or for a specified VRF. Use the vrf option to clear the traffic information for a VRF instance specified by the vrf-name variable. Displaying static IGMP groups The following command displays static IGMP groups for the "eng" VRF. device#show ip igmp vrf eng static Group Address Interface Port List ----------------+---------+--------229.1.0.12 1/4/1 ethe 1/4/1 229.1.0.13 1/4/1 ethe 1/4/1 229.1.0.14 1/4/1 ethe 1/4/1 229.1.0.92 1/4/1 ethe 1/4/1 Syntax: show ip igmp [ vrf vrf-name ] static The vrf parameter specifies that you want to display static IGMP group information for the VRF specified by the vrf-name variable. TABLE 24 Output of show ip igmp vrf static This field Displays Group Address The address of the multicast group. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 143 IPv4 Multicast Protocols TABLE 24 Output of show ip igmp vrf static (continued) This field Displays Interface Port List The physical ports on which the multicast groups are received. Displaying the IGMP status of an interface You can display the status of a multicast enabled port by entering a command such as the following. device# show ip igmp interface ---------+------+---------+---------------+---------+-----+-----+--------Intf/Port|Groups| Version |Querier | Timer |V1Rtr|V2Rtr|Tracking | |Oper Cfg| |OQrr GenQ| | | ---------+------+----+----+---------------+----+----+-----+-----+--------e1/6/3 1 3 3 Self 0 94 No No e1/6/4 0 2 Self 0 94 No No v30 1 3 3 Disabled e1/6/2 3 Self 0 20 No No v40 0 3 3 Disabled e1/6/2 3 Self 0 20 No No v50 0 2 Disabled e1/2/1 2 Self 0 29 No No e1/6/8 2 50.1.1.10 46 0 No Yes e1/6/1 2 Self 0 115 No Yes Disabled Disabled Syntax: show ip igmp [ vrf vrf-name ] interface [ ve number | ethernet unit/slot/port | tunnel num ] The vrf parameter specifies that you want to display IGMP interface information for the VRF specified by the vrf-name variable. Enter ve and its number, or ethernet and its unit/slot/port to display information for a specific virtual routing interface, or ethernet interface. The tunnelnum parameter specifies a GRE tunnel interface that is being configured. The GRE tunnel interface is enabled under the router PIM configuration. Entering an address for group-address displays information for a specified group on the specified interface. The report shows the following information: TABLE 25 Output of show ip igmp interface This field Displays Intf The virtual interface on which IGMP is enabled. Port The physical port on which IGMP is enabled. Groups The number of groups that this interface or port has membership. Version Oper The IGMP version that is operating on the interface. Cfg The IGMP version that is configured for this interface. Querier Where the Querier resides: The IP address of the router where the querier is located or Self - if the querier is on the same router as the intf or port. Max response oQrr Other Querier present timer. GenQ General Query timer V1Rtr Whether IGMPv1 is present on the intf or port. V2Rtr Whether IGMPv2 is present on the intf or port. 144 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols TABLE 25 Output of show ip igmp interface (continued) This field Displays Tracking Fast tracking status: Enabled or Disabled Displaying IGMP traffic status To display the traffic status on each virtual routing interface, enter the following command. device# show ip igmp traffic Recv QryV2 QryV3 G-Qry GSQry MbrV2 MbrV3 Leave v5 29 0 0 0 0 0 0 v18 15 0 0 0 0 30 0 v110 0 0 0 0 0 97 0 Send QryV1 QryV2 QryV3 G-Qry GSQry v5 0 2 0 0 0 v18 0 0 30 30 0 v110 0 0 30 44 11 IsIN 0 60 142 IsEX ToIN ToEX ALLOW BLK 0 0 0 0 0 0 0 0 0 0 37 2 2 3 2 Syntax: show ip igmp [vrf vrf-name ] traffic The vrf parameter specifies that you want to display IGMP traffic information for the VRF specified by the vrf-name variable. The report shows the following information: TABLE 26 Output of show ip igmp vrf traffic This field Displays QryV2 Number of general IGMP V2 query received or sent by the virtual routing interface. QryV3 Number of general IGMP V3 query received or sent by the virtual routing interface. G-Qry Number of group specific query received or sent by the virtual routing interface. GSQry Number of source specific query received or sent by the virtual routing interface. MbrV2 The IGMP V2 membership report. MbrV3 The IGMP V3 membership report. Leave Number of IGMP V2 "leave" messages on the interface. (See ToEx for IGMP V3.) IsIN Number of source addresses that were included in the traffic. IsEX Number of source addresses that were excluded in the traffic. ToIN Number of times the interface mode changed from exclude to include. ToEX Number of times the interface mode changed from include to exclude. ALLOW Number of times that additional source addresses were allowed or denied on the interface: BLK Number of times that sources were removed from an interface. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 145 IPv4 Multicast Protocols Clearing IGMP traffic statistics To clear statistics for IGMP traffic, enter the following command. device# clear ip igmp traffic Syntax: clear ip igmp [ vrf vrf-name] traffic This command clears all the multicast traffic information on all interfaces on the device. Use the vrf option to clear the traffic information for a VRF instance specified by the vrf-name variable. T Displaying IGMP settings To display global IGMP settings or IGMP settings for a specified VRF. To display global IGMP settings, enter the following command. Brocade#show ip igmp settings IGMP Global Configuration Query Interval : Max Response Time : Group Membership Time : Operating Version : Robustness Variable : Router Alert Check : Last Member Query Interval: Older Host Present Timer : Maximum Group Address : 125s Configured Interval : 125 10s 260s 2 Configured Version : 0 2 Enabled 1 Last Member Query Count: 2 260 4096 Syntax: show ip igmp [vrf vrf-name ] settings The vrf parameter specifies that you want to display IGMP settings information for the VRF specified by the vrf-name variable. The report shows the following information: TABLE 27 Output of show ip igmp settings This field Displays Query Interval How often the router will query an interface for group membership. Configured Query Interval The query interval that has been configured for the router. Max Response Time The length of time in seconds that the router will wait for an IGMP (V1 or V2) response from an interface before concluding that the group member on that interface is down and removing it from the group. Group Membership Time The length of time in seconds that a group will remain active on an interface in the absence of a group report. Configured Version The IGMP version configured on the router. Operating Version The IGMP version operating on the router. Robustness Variable The Robustness Variable allows tuning for the expected packet loss on a network. If a network is expected to be lossy, the Robustness Variable may be increased. IGMP is robust to (Robustness Variable -1) packet losses. The Robustness Variable must not be zero, and should not be one. Default: 2 Router Alert Check IGMP (v2/v3) messages have a router-alert option in the IP header. By default this is validated by the router and it drops the packets without the router-alert option. If this check is disabled, IGMP messages without the router-alert option are accepted. Last Member Query Interval The Last Member Query Interval is the Max Response Time used to calculate the Max Resp Code inserted into Group-Specific Queries sent in response to Leave Group messages. It is also the Max Response Time used in calculating the Max Resp Code for Group-and-Source-Specific Query messages. Default: 10 (1 second) 146 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols TABLE 27 Output of show ip igmp settings (continued) This field Displays Last Member Query Count The Last Member Query Count is the number of Group-Specific Queries sent before the router assumes there are no local members. The Last Member Query Count is also the number of Group-and-Source-Specific Queries sent before the router assumes there are no listeners for a particular source. Default: the Robustness Variable. Older Host Present Timer The Older Host Present Interval is the time-out for transitioning a group back to IGMPv3 mode when an older version report is sent for that group. When an older version report is received, routers set their Older Host Present Timer to Older Host Present Interval. This value must be ((the Robustness Variable) times (the Query Interval)) plus (one Query Response Interval). Maximum Group Address This value indicates the maximum number of group address that can be accepted by the router. Source-specific multicast Using the Any-Source Multicast (ASM) service model, sources and receivers register with a multicast address. The protocol uses regular messages to maintain a correctly configured broadcast network where all sources can send data to all receivers and all receivers get broadcasts from all sources. With Source-specific multicast (SSM), the "channel" concept is introduced where a "channel" consists of a single source and multiple receivers who specifically register to get broadcasts from that source. Consequently, receivers are not burdened with receiving data they have no interest in, and network bandwidth requirements are reduced because the broadcast need only go to a sub-set of users. The address range 232/8 has been assigned by the Internet Assigned Numbers Authority (IANA) for use with SSM. IGMP V3 and source specific multicast protocols When IGMP V3 and PIM Sparse (PIM-SM) is enabled, the source specific multicast service (SSM) can be configured. SSM simplifies PIM-SM by eliminating the RP and all protocols related to the RP. IGMPv3 and PIM-SM must be enabled on any ports that you want SSM to operate. Configuring PIM SSM group range PIM Source Specific Multicast (SSM) is a subset of the PIM SM protocol. In PIM SSM mode, the shortest path tree (SPT) is created at the source. The SPT is created between the receiver and source, but the SPT is built without the help of the RP. The router closest to the interested receiver host is notified of the unicast IP address of the source for the multicast traffic. PIM SSM goes directly to the sourcebased distribution tree without the need of the RP connection. PIM SSM is different from PIM SM because it forms its own SPT, without forming a shared tree. The multicast address group range is 232.0.0.0/8. To configure a single SSM group address, enter the following command under the router pim configuration: device(config)#router pim device(config-pim-router)#ssm-enable range 232.1.1.1/8 Syntax: [no] ssm-enable range group-address address-mask The group-address parameter specifies the multicast address for the SSM address range. If this is not configured, the range will default to 232/8 as assigned by the Internet Assigned Numbers Authority (IANA) for use with SSM. The address-mask parameter specifies the mask for the SSM address range. To disable SSM, use the [no] form of this command. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 147 IPv4 Multicast Protocols Displaying source-specific multicast configuration information To display PIM Sparse configuration information, use the show ip pim sparse command as described in Displaying basic PIM Sparse configuration information on page 100. Configuring multiple SSM group ranges The ssm-enable rangeacl-id/acl-name command allows you to configure multiple SSM group ranges using an ACL. Configuration Considerations ∙ The existing ssm-enable rangegroup-addressaddress-mask command will continue to exist. ∙ The ACL must be configured with the SSM group address in the permit clause of the ssm-enable rangeacl-id or acl-name command. If the ssm-enable rangegroup-addressaddress-mask command permits a clause, then that group will also operate in the PIM-SM mode. ∙ If the ssm-enable rangeacl-id or acl-name command is configured with a non-existent or empty ACL, then the SSM group will operate in PIM-SM mode (non PIM-SSM mode). However when an ACL is added or updated, then the group will exist in a PIM-SSM mode. By default, an empty ACL will deny all. ∙ By default, the group address mentioned in the IGMPv2 ssm-mapping ACL will decide if the group address is a PIM-SSM group or non PIM-SSM group. Therefore, if a user wants to prevent a group from operating in PIM-SSM mode, then the user’s configuration must consistently deny the group in all configuration options for PIM-SSM range. ∙ ACL of any type (named or unnamed, standard or extended) can be used to specify the SSM group range. If an extended ACL is used, then the destination ip address should be used to specify the group address. Any configuration in the source address of an extended ACL is ignored. Only permit statements are considered in the ACL configuration. Any deny statements in the ACL clause are also ignored. To configure multiple SSM group address using an ACL, enter the following command under the router pim configuration: device(config)#router pim device(config-pim-router)#ssm-enable range xyz The example displayed above configures PIM so that it uses the group addresses allowed by ACL, xyz as its PIM SSM range. Syntax: [no] ssm-enable range acl-id or acl-name The acl-id/acl-name parameter specifies the ACL id or name used to configure multiple SSM group ranges. To disable the SSM mapping range ACL, use the [no] form of this command. NOTE The ssm-enable rangeacl-id acl-name or command also supports IPv6 traffic. The ssm-enable rangeacl-id acl-name or command must be configured under the IPv6 router pim configuration to support IPv6. Displaying information for PIM SSM range ACL To display information for PIM SSM range ACL configuration enter the following command at any CLI level: device#show ip pim sparse Global PIM Sparse Mode Settings Maximum Mcache : 0 Hello interval : 30 Join/Prune interval : 60 Register Suppress Time : 60 SPT Threshold : 1 Bootstrap Msg interval : 60 Register Stop Delay : 60 SSM Enabled : Yes 148 Current Count : 0 Neighbor timeout : 105 Inactivity interval : 180 Register Probe Time : 10 Hardware Drop Enabled : Yes Candidate-RP Msg interval : 60 Register Suppress interval : 60 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols SSM Group Range SSM Group Range ACL Route Precedence : 224.1.1.1/24 : xyz : mc-non-default mc-default uc-non-default uc-default NOTE The show ipv6 pim sparse command also displays PIM SSM range ACL configuration. IGMPv2 SSM mapping The PIM-SSM feature requires all IGMP hosts to send IGMPv3 reports. Where you have an IGMPv2 host, this can create a compatibility problem. In particular, the reports from an IGMPv2 host contain a Group Multicast Address but do not contain source addresses. The IGMPv3 reports contain both the Group Multicast Address and one or more source addresses. This feature converts IGMPv2 reports into IGMPv3 reports through use of the ip igmp ssm-map commands and a properly configured ACL. The ACL used with this feature filters for the Group Multicast Address. The ACL is then associated with one or more source addresses using the ip igmp ssm-map command. When the ip igmp ssm-map enable command is configured, IGMPv3 reports are sent for IGMPv2 hosts. The following sections describe how to configure the ACL and the ip igmp ssm-map commands to use the IGMPv2 SSM mapping feature: ∙ Configuring an ACL for IGMPv2 SSM mapping ∙ Configuring the IGMPv2 SSM Mapping Commands NOTE IGMPv2 SSM Mapping is not supported for IGMP static groups. Configuring an ACL for IGMPv2 SSM mapping You can use either a standard or extended ACL to identify the group multicast address you want to add source addresses to when creating a IGMPv3 report. For standard ACLs, you must create an ACL with a permit clause and the ip-source-address variable must contain the group multicast address. This can be configured directly with a subnet mask or with the host keyword in which case a subnet mask of all zeros (0.0.0.0) is implied. In the following example, access-list 20 is configured for the group multicast address: 224.1.1.0 with a subnet mask of 0.0.0.255. device(config)# access-list 20 permit 224.1.1.0 0.0.0.225 In the following example, access-list 20 is configured for the group multicast address: 239.1.1.1 by including the host keyword. device(config)# access-list 20 host 239.1.1.1 For extended ACLs, the source address variable must contain either 000 or the any keyword. Additionally, the extended ACL must be configured with a permit clause and the host keyword. This can be configured directly with a subnet mask or with the host keyword in which case a subnet mask of all zeros (0.0.0.0) is implied. The ip-destination-address variable must contain the group multicast address. In the following example, access-list 100 is configured for the group multicast address: 232.1.1.1 with a subnet mask of 0.0.0.255. device(config)# access-list 20 permit 224.1.1.0 0.0.0.225 In the following example, access-list 100 is configured for the group multicast address: 232.1.1.1. device(config)# access-list 100 permit any host 232.1.1.1 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 149 IPv4 Multicast Protocols Configuring the IGMPv2 SSM mapping commands The ip ssm-map commands are used to enable the IGMPv2 mapping feature and to define the maps between IGMPv2 Group addresses and multicast source addresses as described in the following sections. Enabling IGMPv2 SSM mapping To enable the IGMPv2 mapping feature enter the command as shown in the following. device(config)# ip igmp ssm-map enable Syntax: [no] ip igmp ssm-map enable The no option is used to turn off the IGMPv2 mapping feature that has previously been enabled. Configuring the map between a IGMPv2 group address and a multicast source To configure a map between an IGMPv2 Group address and a multicast source address use the ip igmp ssm-map static command, as shown in the following. device(config)# ip igmp ssm-map 20 1.1.1.1 Syntax: [no] ip igmp ssm-map aci-id source-address Theacl-id variable specifies the ACL ID that contains the group multicast address. The source-address variable specifies the source address that you want to map to the group multicast address specified in the ACL. The no option is used to delete a previously configured SSM map. Example configuration In the following example configuration, one extended ACL and two standard ACLs are defined with group multicast addresses. The ip igmp ssm-map commands are configured to map the ACLs to source addresses and to enable the feature on the router. device(config)# device(config)# device(config)# device(config)# device(config)# device(config)# device(config)# access-list 20 host 239.1.1.1 access-list 20 permit 224.1.1.0 0.0.0.225 access-list 100 permit any host 232.1.1.1 ip igmp ssm-map 20 1.1.1.1 ip igmp ssm-map 20 2.2.2.2 ip igmp ssm-map 100 1.1.1.1 ip igmp ssm-map enable Displaying an IGMP SSM mapping information The show ip igmp ssm-map command displays the association between a configured ACL and source address mapped to it, as shown in the following. device# show ip igmp ssm-map +---------+-----------------+ | Acl id | Source Address | +---------+-----------------+ 20 1.1.1.1 100 1.1.1.1 20 2.2.2.2 20 2.2.2.3 20 2.2.2.4 20 2.2.2.5 20 2.2.2.6 Syntax: show ip igmp [vrf vrf-name ] ssm-map 150 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv4 Multicast Protocols The show ip igmp ssm-map group-address displays the ACL ID that has the specified multicast group address in its permit list and lists the source addresses mapped to the specified multicast group address, as shown in the following. device# show ip igmp ssm-map 232.1.1.1 +---------+-----------------+ | Acl id | Source Address | +---------+-----------------+ 20 1.1.1.1 100 1.1.1.1 20 2.2.2.2 20 2.2.2.3 20 2.2.2.4 20 2.2.2.5 20 2.2.2.6 Syntax: show ip igmp ssm-map group-address FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 151 IPv4 Multicast Protocols 152 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols ∙ ∙ ∙ ∙ ∙ IPv6 PIM Sparse .............................................................................................................................................................................................................153 IPv6 PIM convergence on MAC movement.....................................................................................................................................................181 PIM Anycast RP................................................................................................................................................................................................................. 181 Multicast Listener Discovery and source-specific multicast protocols............................................................................................ 183 IPv6 Multicast Boundaries......................................................................................................................................................................................... 192 IPv6 PIM Sparse IPv6 Protocol Independent Multicast (PIM) Sparse is supported. IPv6 PIM Sparse provides multicasting that is especially suitable for widely distributed multicast environments. In an IPv6 PIM Sparse network, an IPv6 PIM Sparse router that is connected to a host that wants to receive information for a multicast group must explicitly send a join request on behalf of the receiver (host). FIGURE 11 Example IPv6 PIM Sparse domain FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 153 IPv6 Multicast Protocols PIM Sparse router types Routers that are configured with PIM Sparse interfaces also can be configured to fill one or more of the following roles: ∙ BSR - The Bootstrap Router (BSR) distributes RP information to the other PIM Sparse routers within the domain. Each PIM Sparse domain has one active BSR. For redundancy, you can configure ports on multiple routers as candidate BSRs. The PIM Sparse protocol uses an election process to select one of the candidate BSRs as the BSR for the domain. The BSR with the highest BSR priority (a user-configurable parameter) is elected. If the priorities result in a tie, then the candidate BSR interface with the highest IP address is elected. In the example in Figure 11 on page 153, PIM Sparse router B is the BSR. Port 1/2/2 is configured as a candidate BSR. ∙ RP - The Rendezvous Points (RP) is the meeting point for PIM Sparse sources and receivers. A PIM Sparse domain can have multiple RPs, but each PIM Sparse multicast group address can have only one active RP. PIM Sparse routers learn the addresses of RPs and the groups for which they are responsible from messages that the BSR sends to each of the PIM Sparse routers. In the example in Figure 11 on page 153, PIM Sparse router B is the RP. Port 1/2/2 is configured as a candidate Rendezvous Point (RP). To enhance overall network performance, the device uses the RP to forward only the first packet from a group source to the group receivers. After the first packet, the device calculates the shortest path between the receiver and the source (the Shortest Path Tree, or SPT) and uses the SPT for subsequent packets from the source to the receiver. The device calculates a separate SPT for each sourcereceiver pair. NOTE It is recommended that you configure the same ports as candidate BSRs and RPs. RP paths and SPT paths Figure 11 on page 153 shows two paths for packets from the source for group fec0:1111::1 and a receiver for the group. The source is attached to PIM Sparse router A and the recipient is attached to PIM Sparse router C. PIM Sparse router B is the RP for this multicast group. As a result, the default path for packets from the source to the receiver is through the RP. However, the path through the RP sometimes is not the shortest path. In this case, the shortest path between the source and the receiver is over the direct link between router A and router C, which bypasses the RP (router B). To optimize PIM traffic, the protocol contains a mechanism for calculating the Shortest Path Tree (SPT) between a given source and a receiver. PIM Sparse routers can use the SPT as an alternative to using the RP for forwarding traffic from a source to a receiver. By default, the device forwards the first packet it receives from a given source to a given receiver using the RP path, but subsequent packets from that source to that receiver through the SPT. In Figure 11 on page 153, router A forwards the first packet from group fec0:1111::1 source to the destination by sending the packet to router B, which is the RP. Router B then sends the packet to router C. For the second and all future packets that router A receives from the source for the receiver, router A forwards them directly to router C using the SPT path. RFC 3513 and RFC 4007 compliance for IPv6 multicast scope-based forwarding The IPv6 multicast implementation recognizes scopes and conforms to the scope definitions in RFC 3513. Per RFC 3513, scopes 0 and 3 are reserved and packets are not forwarded with an IPv6 destination multicast address of scopes 0 and 3. Additionally, scopes 1 and 2 are defined as Node-Local and Link-Local and are not forwarded. Thus, the implementation forwards only those packets with an IPv6 multicast destination address with scope 4 or higher. RFC 4007 defines ‘scope zones’ and requires that the forwarding of packets received on any interface of a particular scope zone be restricted to that scope zone. Currently, the device supports one zone for each scope, and the default zone for scope 4 and higher consists of all interfaces in the system. Thus, the default zones for scope 4 and higher are the same size. 154 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols Configuring PIM Sparse To configure the device for IPv6 PIM Sparse, perform the following tasks: ∙ Enable the IPv6 PIM Sparse of multicast routing. ∙ Configure VRF then enable IPv6 Protocol Independent Multicast Sparse mode (PIM-SM) for a specified VRF, if applicable. ∙ Configure an IPv6 address on the interface. ∙ Enable IPv6 PIM Sparse. ∙ Identify the interface as an IPv6 PIM Sparse border, if applicable. ∙ Identify the device as a candidate PIM Sparse Bootstrap Router (BSR), if applicable. ∙ Identify the device as a candidate PIM Sparse Rendezvous Point (RP), if applicable. ∙ Specify the IP address of the RP (if you want to statically select the RP). NOTE It is recommended that you configure the same device as both the BSR and the RP. IPv6 PIM-Sparse mode To configure a device for IPv6 PIM Sparse, perform the following tasks: ∙ Identify the Layer 3 switch as a candidate sparse Rendezvous Point (RP), if applicable. ∙ Specify the IPv6 address of the RP (to configure statically). The following example enables IPv6 PIM-SM routing. Enter the following command at the configuration level to enable IPv6 PIM-SM globally. device(config)# ipv6 router pim device(config-ipv6-pim-router)# To enable IPv6 PIM Sparse mode on an interface, enter commands such as the following. device(config)# interface ethernet 1/2/2 device(config-if-e10000-1/2/2)# ipv6 address a000:1111::1/64 device(config-if-e10000-1/2/2)# ipv6 pim-sparse Syntax: [no] ipv6 pim-sparse Use the no option to remove IPv6 PIM sparse configuration from the interface. The commands in this example add an IPv6 interface to port 1/2/2, then enable IPv6 PIM Sparse on the interface. Configuring IPv6 PIM-SM on a virtual routing interface You can enable IPv6 PIM-SM on a virtual routing interface by entering commands such as the following. device(config)# interface ve 15 device(config-vif-15)# ipv6 address a000:1111::1/64 device(config-vif-15)# ipv6 pim-sparse Enabling IPv6 PIM-SM for a specified VRF To enable IPv6 PIM-SM for the VRF named "blue", create the VRF named "blue", enable it for IPv6 routing, and then enable IPv6 PIMSM for the VRF, as shown in the following example. device(config)# vrf blue device(config-vrf-blue)# rd 11:1 device(config-vrf-blue)# address-family ipv6 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 155 IPv6 Multicast Protocols device(config-vrf-blue-ipv6)# router pim device(config-pim-router)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue) Syntax: [no] ipv6 router pim [ vrf vrf-name ] The vrf parameter allows you to configure IPv6 PIM-SM on the virtual routing instance (VRF) specified by the vrf-name variable. All PIM parameters available for the default router instance are configurable for a VRF-based PIM instance. Use the no option to remove all configuration for PIM multicast on the specified VRF. Configuring BSRs In addition to the global and interface parameters configured in the prior sections, you must identify an interface on at least one device as a candidate PIM Sparse bootstrap router (BSR) and a candidate PIM Sparse rendezvous point (RP). NOTE You can configure the device as only a candidate BSR or an RP, but it is recommended that you configure the same interface on the same device as both a BSR and an RP. To configure the device as a candidate BSR, enter commands such as the following. Device(config)# ipv6 router pim Device(config-ip6-pim-router)# bsr-candidate ethernet 1/1/3 32 64 This command configures Ethernet interface 1/1/3 as the BSR candidate with a mask length of 32 and a priority of 64. To configure the device as a candidate BSR for a specified VRF, enter the commands as shown in the following example. Device(config)# ipv6 router pim vrf blue Device(config-ipv6-pim-router-vrf-blue)# bsr-candidate ethernet 1/1/3 32 64 Syntax: [no] bsr-candidate { ethernet unit/slot/port | loopback num | ve num | tunnel num } hash-mask-length [ priority ] Use the no form of the command to remove the candidate BSR configuration for a specified VRF. The ethernet unit/slot/port, loopback num, ve num, and tunnel num parameters specify the interface. The device will advertise the IP address of the specified interface as a candidate BSR. ∙ Enter ethernet unit/slot/port for a physical interface (port). ∙ Enter ve num for a virtual interface. ∙ Enter loopback num for a loopback interface. ∙ Enter tunnel num for a GRE tunnel interface. The hash-mask-length variable specifies the number of bits in a group address that are significant when calculating the group-to-RP mapping. You can specify a value from 1 through 32. The priority variable specifies the BSR priority. You can specify a value from 0 through 255. When the election process for BSR takes place, the candidate BSR with the highest priority becomes the BSR. The default is 0. Setting the BSR message interval The BSR message interval timer defines the interval at which the BSR sends RP candidate data to all IPv6-enabled routers within the IPv6 PIM Sparse domain. The default is 60 seconds. To set the IPv6 PIM BSR message interval timer to 16 seconds, enter commands such as the following. device(config)# ipv6 router pim device(config-ipv6-pim-router)# bsr-msg-interval 16 156 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols To set the IPv6 PIM BSR message interval timer to 16 seconds for a specified VRF, enter the commands as shown in the following example. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# bsr-msg-interval 16 Syntax: [no] bsr-msg-interval num The num parameter specifies the number of seconds and can be from 10 - 65535. The default is 60. Use the no option to disable a timer that has been configured. Configuring candidate RP Enter a command such as the following to configure the device as a candidate RP. Device(config)# ipv6 router pim Device(config-ipv6-pim-router)# rp-candidate ethernet 1/2/2 To configure the device as a candidate RP for a specified VRF, enter the commands as shown in the following example. Device(config)# ipv6 router pim vrf blue Device(config-ipv6-pim-router-vrf-blue)# rp-candidate ethernet 1/2/2 Syntax: [no] rp-candidate { ethernet unit/slot/port | loopback num | ve num | tunnel num } The ethernet unit/slot/port, loopback num, ve num, and tunnel num parameters specify the interface. The device will advertise the specified interface IP address as a candidate RP. ∙ Enter ethernet unit/slot/port for a physical interface (port). ∙ Enter loopback num for a loopback interface. ∙ Enter ve num for a virtual interface. ∙ Enter tunnel num for a GRE tunnel interface. To add address ranges for which the device is a candidate RP, enter commands such as the following. Device(config)# ipv6 router pim Device(config-ipv6-pim-router)# rp-candidate add ff02::200:2 64 To add address ranges for a specified VRF for which the device is a candidate RP, enter commands such as the following. Device(config)# ipv6 router pim vrf blue Device(config-ipv6-pim-router-vrf-blue)# rp-candidate add ff02::200:2 64 Syntax: [no] rp-candidate add group-ipv6address mask-bits You can delete the configured RP candidate group ranges by entering commands such as the following. Device(config)# ipv6 router pim Device(config-ipv6-pim-router)# rp-candidate delete ff02::200:1 128 You can delete the configured RP candidate group ranges for a specified VRF by entering commands such as the following: Device(config)# ipv6 router pim vrf blue Device(config-ipv6-pim-router-vrf-blue)# rp-candidate delete ff02::200:1 128 Syntax: [n]o rp-candidate delete group-ipv6address mask-bits The usage for the group-ipv6address mask-bits parameter is the same as for the rp-candidate add command. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 157 IPv6 Multicast Protocols Statically specifying the RP It is recommended that you use the IPv6 PIM Sparse mode RP election process so that a backup RP can automatically take over if the active RP router becomes unavailable. However, if you do not want the RP to be selected by the RP election process but instead you want to explicitly identify the RP by its IPv6 address, use the rp-address command. If you explicitly specify the RP, the device uses the specified RP for all group-to-RP mappings and overrides the set of candidate RPs supplied by the BSR. NOTE Specify the same IP address as the RP on all IPv6 PIM Sparse routers within the IPv6 PIM Sparse domain. Make sure the device is on the backbone or is otherwise well-connected to the rest of the network. To specify the IPv6 address of the RP, enter commands such as the following. device(config)# ipv6 router pim device(config-ipv6-pim-router)# rp-address 31::207 The command in the previous example identifies the router interface at IPv6 address 31:207 as the RP for the IPv6 PIM Sparse domain. The device will use the specified RP and ignore group-to-RP mappings received from the BSR. To specify the IPv6 address of the RP for a specified VRF, enter commands such as the following. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# rp-address 31::207 Syntax: [no] rp-address ipv6-addr The ipv6-addr parameter specifies the IPv6 address of the RP. Updating IPv6 PIM Sparse forwarding entries with a new RP configuration If you make changes to your static RP configuration, the entries in the IPv6 PIM Sparse multicast forwarding table continue to use the old RP configuration until they are aged out. The clear IPv6 pim rp-map command allows you to update the entries in the static multicast forwarding table immediately after making RP configuration changes. This command is meant to be used with the rp-address command. To update the entries in an IPv6 PIM Sparse static multicast forwarding table with a new RP configuration, enter the following command at the privileged EXEC level of the CLI. device(config)# clear ipv6 pim rp-map Syntax: clear ipv6 pim [ vrf vrf_name ] rp-map Embedded Rendezvous Point Global deployment of IPv4 multicast relies on Multicast Source Discovery Protocol (MSDP) to convey information about the active sources. Because IPv6 provides more address space, the RP address can be included in the multicast group address. NOTE The IPv6 group address must be part of the FF70:/12 prefix. Embedded RP support is enabled by default. You can disable it using the following commands. device(config)# ipv6 router pim device(config-ipv6-pim-router)# no rp-embedded 158 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols To disable embedded RP support for a specified VRF, enter the following commands. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# no rp-embedded Syntax: [no] rp-embedded Changing the Shortest Path Tree threshold In a typical IPv6 PIM Sparse domain, there may be two or more paths from a designated router (DR) for a multicast source to an IPv6 PIM group receiver: ∙ Path through the RP - This is the path the device uses the first time it receives traffic for an IPv6 PIM group. However, the path through the RP may not be the shortest path from the device to the receiver. ∙ Shortest Path - Each IPv6 PIM Sparse router that is a DR for an IPv6 receiver calculates a short path tree (SPT) towards the source of the IPv6 multicast traffic. The first time the device configured as an IPv6 PIM router receives a packet for an IPv6 group, it sends the packet to the RP for that group, which in turn will forward it to all the intended DRs that have registered with the RP. The first time the device is a recipient, it receives a packet for an IPv6 group and evaluates the shortest path to the source and initiates a switchover to the SPT. Once the device starts receiving data on the SPT, the device proceeds to prune itself from the RPT. By default, the device switches from the RP to the SPT after receiving the first packet for a given IPv6 PIM Sparse group. The device maintains a separate counter for each IPv6 PIM Sparse source-group pair. You can change the number of packets the device receives using the RP before switching to using the SPT. To change the number of packets the device receives using the RP before switching to the SPT, enter commands such as the following. device(config)# ipv6 router pim device(config-ipv6-pim-router)# spt-threshold 1000 To change the number of packets the device receives using the RP before switching to the SPT for a specified VRF, enter commands such as the following. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# spt-threshold 1000 Syntax: [no] spt-threshold num The num parameter specifies the number of packets. If you enter a specific number of packets, the device does not switch over to using the SPT until it has sent the number of packets you specify using the RP. Setting the RP advertisement interval To specify how frequently the candidate RP configured on the device sends candidate RP advertisement messages to the BSR, enter commands such as the following. device(config)# ipv6 router pim device(config-ipv6-pim-router)# rp-adv-interval 180 To specify how frequently the candidate RP configured on the device sends candidate RP advertisement messages to the BSR for a specified VRF, enter commands such as the following. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# rp-adv-interval 180 Syntax: rp-adv-interval seconds The seconds parameter specifies the number of seconds in a range from 10 through 65535. The default is 60 seconds. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 159 IPv6 Multicast Protocols Changing the PIM Join and Prune message interval By default, the device sends PIM Sparse Join or Prune messages every 60 seconds. These messages inform other PIM Sparse routers about clients who want to become receivers (Join) or stop being receivers (Prune) for PIM Sparse groups. NOTE Use the same Join or Prune message interval on all the PIM Sparse routers in the PIM Sparse domain. If the routers do not all use the same timer interval, the performance of PIM Sparse can be adversely affected. To change the Join or Prune interval, enter commands such as the following: Device(config)# ipv6 router pim Device(config-ipv6-pim-router)# message-interval 30 To change the Join or Prune interval for a specified VRF, enter the commands as shown in the following example: Device(config)# ipv6 router pim vrf blue Device(config-ipv6-pim-router-vrf-blue)# message-interval 30 Syntax: [no] message-interval seconds The seconds parameter specifies the number of seconds and can be from 10 through 18724 seconds. The default is 60 seconds. Modifying neighbor timeout Neighbor timeout is the interval after which a PIM router will consider a neighbor to be absent. If the timer expires before receiving a new hello message, the PIM router will time out the neighbor. To apply an IPv6 PIM neighbor timeout value of 50 seconds to all ports on the router operating with PIM, enter the commands such as the following. device(config)# ipv6 router pim device(config-ipv6-pim-router)# nbr-timeout 50 To apply an IPv6 PIM neighbor timeout value of 50 seconds for a specified VRF operating with PIM, enter the commands such as the following. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# nbr-timeout 50 Syntax: [no] nbr-timeout seconds The seconds parameter specifies the number of seconds. The valid range is from 35 through 65535 seconds. The default is 105. Setting the prune wait interval The prune-wait command allows you to set the amount of time the PIM router should wait for a join override before pruning an Outgoing Interface List Optimization (OIF) from the entry. To change the default join override time to 2 seconds, enter commands such as the following. device(config)# ipv6 router pim device(config-ipv6-pim-router)# prune-wait 2 To change the default join override time to 2 seconds for a specified VRF, enter commands such as the following. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# prune-wait 2 Syntax: [no] prune-wait seconds The seconds parameter specifies the number of seconds. The valid range is from 0 through 30 seconds. The default is 3 seconds. 160 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols Setting the register suppress interval The register-suppress-time command allows you to set the amount of time the PIM router uses to periodically trigger the NULL register message. NOTE The register suppress time configuration applies only to the first hop PIM router. To change the default register suppress time to 90 seconds, enter commands such as the following: device(config)# ipv6 router pim device(config-ipv6-pim-router)# register-suppress-time 90 To change the default register suppress time to 90 seconds for a specified VRF, enter commands such as the following: device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# register-suppress-time 90 Syntax: [no] register-suppress-time seconds The seconds parameter specifies the number of seconds. The valid range is from 60 through 120 seconds. The default is 60 seconds. Setting the register probe time The register-probe-time command allows you to set the amount of time the PIM router waits for a register-stop from an RP before it generates another NULL register to the PIM RP. The register probe time configuration applies only to the first hop PIM router. NOTE Once a PIM first hop router successfully registers with a PIM RP, the PIM first hop router will not default back to the data registration. All subsequent registers will be in the form of the NULL registration. To change the default register probe time to 20 seconds, enter commands such as following. device(config)# ipv6 router pim device(config-ipv6-pim-router)# register-probe-time 20 To change the default register probe time to 20 seconds for a specified VRF, enter commands such as the following. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# register-probe-time 20 Syntax: [no] register-probe-time seconds The seconds parameter specifies the number of seconds. The valid range is from 10 through 50 seconds. The default is 10 seconds. Setting the inactivity timer The router deletes a forwarding entry if the entry is not used to send multicast packets. The IPv6 PIM inactivity timer defines how long a forwarding entry can remain unused before the router deletes it. To apply an IPv6 PIM inactivity timer of 160 seconds to all IPv6 PIM interfaces, enter the following. device(config)# ipv6 router pim device(config-ipv6-pim-router)# inactivity-timer 160 To apply an IPv6 PIM inactivity timer of 160 seconds for a specified VRF, enter the commands as shown in the following example. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# inactivity-timer 160 Syntax: [no] inactivity-timer seconds FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 161 IPv6 Multicast Protocols The seconds parameter specifies the number of seconds. The valid range is 60 through 3600 seconds. The default is 180 seconds. Changing the hello timer The hello timer defines the interval at which periodic hellos are sent out to PIM interfaces. Routers use hello messages to inform neighboring routers of their presence. To change the hello timer, enter a command such as the following. device(config)# ipv6 router pim device(config-ipv6-pim-router)# hello-timer 62 To change the hello timer for a specified VRF, enter the commands as shown in the following example. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# hello-timer 62 Syntax: [n]o hello-timer seconds The seconds parameter specifies the number of seconds. The valid range is 10 through 3600 seconds. The default is 30 seconds. Enabling Source-specific Multicast Using the Any-Source Multicast (ASM) service model, sources and receivers register with a multicast address. The protocol uses regular messages to maintain a correctly configured broadcast network where all sources can send data to all receivers and all receivers get broadcasts from all sources. With Source-specific Multicast (SSM), the "channel" concept is introduced where a "channel" consists of a single source and multiple receivers that specifically register to get broadcasts from that source. Consequently, receivers are not burdened with receiving data they have no interest in, and network bandwidth requirements are reduced because the broadcast need only go to a subset of users. The address range ff30:/12 has been assigned by the Internet Assigned Numbers Authority (IANA) for use with SSM. SSM simplifies IPv6 PIM-SM by eliminating the RP and all protocols related to the RP. Configuring Source-specific Multicast IPv6 PIM-SM must be enabled on any ports on which you want SSM to operate. Enter the ssm-enable command under the IPv6 router PIM level to globally enable SSM filtering. device(config)# ipv6 router pim device(config-ipv6-pim-router)# ssm-enable To enable SSM for a specified VRF and user-defined address range, enter the commands as shown in the following. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# ssm-enable ff44::/32 Syntax: [no] ssm-enable [ range address-range ] The rangeaddress-range option allows you to define the SSM range of IPv6 multicast addresses. Configuring a DR priority The DR priority option lets a network administrator give preference to a particular router in the DR election process by giving it a numerically higher DR priority. To set a DR priority higher than the default value of 1, use the ipv6 pim dr-priority command as shown in the example below. device(config-if-e10000-3/2/4)# ipv6 pim dr-priority 50 162 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols To set a DR priority higher than the default value of 1 on a virtual Ethernet interface, use the ipv6 pim dr-priority command as shown in the following. device(config)# interface ve 10 device(config-vif-10)# ipv6 pim dr-priority 50 Syntax: [no] ipv6 pim dr-priority priority-value The priority-value variable is the value that you want to set for the DR priority. The range of values is from 0 through 65535. The default value is 1. The no option removes the command and sets the DR priority back to the default value of 1. The following information may be useful for troubleshooting: ∙ If more than one router has the same DR priority on a subnet (as in the case of default DR priority on all), the router with the numerically highest IP address on that subnet will get elected as the DR. ∙ The DR priority information is used in the DR election only if all the PIM routers connected to the subnet support the DR priority option. If there is at least one PIM router on the subnet that does not support this option, then the DR election falls back to the backwards compatibility mode in which the router with the numerically highest IP address on the subnet is declared the DR regardless of the DR priority values. Passive Multicast Route Insertion To prevent unwanted multicast traffic from being sent to the CPU, IPv6 PIM routing and Passive Multicast Route Insertion (PMRI) can be used together to ensure that multicast streams are only forwarded out ports with interested receivers and unwanted traffic is dropped in hardware on Layer 3 routers. PMRI enables a Layer 3 switch running IPv6 PIM Sparse to create an entry for a multicast route (for example, (S,G)), with no directly attached clients or when connected to another PIM router (transit network). When a multicast stream has no output interfaces, the Layer 3 switch can drop packets in hardware if the multicast traffic meets the following conditions in IPv6 PIM-SM. ∙ The route has no OIF. ∙ The directly connected source passes source RPF check and completes data registration with the RP, or the non-directly connected source passes source RPF check. If the OIF is inserted after the hardware-drop entries are installed, the hardware entries will be updated to include the OIFs. NOTE Disabling hardware-drop does not immediately take away existing hardware-drop entries, they will go through the normal route aging processing when the traffic stops. Configuring PMRI PMRI is enabled by default. To disable PMRI, enter the following commands. device(config)# ipv6 router pim device(config-ipv6-pim-router)# hardware-drop-disable To disable PMRI for a specified VRF, enter the commands as shown in the following example. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# hardware-drop-disable Syntax: [no] hardware-drop-disable FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 163 IPv6 Multicast Protocols Displaying hardware-drop Use the show ipv6 pim sparse command to display if the hardware-drop feature has been enabled or disabled. Brocade# show ipv6 pim sparse Global PIM Sparse Mode Settings Maximum Mcache : 4096 Current Count : Hello interval : 30 Neighbor timeout : Join/Prune interval : 60 Inactivity interval : Hardware Drop Enabled : Yes Prune Wait Interval : Bootstrap Msg interval : 60 Candidate-RP Msg interval : Register Suppress Time : 60 Register Probe Time : Register Stop Delay : 10 Register Suppress interval : SSM Enabled : Yes SPT Threshold : SSM Group Range : ff3x::/32 Route Precedence : mc-non-default mc-default uc-non-default Embedded RP Enabled : Yes 7 105 180 3 60 10 60 1 uc-default Displaying system values To display default, maximum, current, and configured values for system maximum parameters, use the show default values command. The following output example does not show complete output; it shows only PIM6 hardware mcache values. device(config)#show default values System Parameters Default Maximum pim6-hw-mcache 512 1024 Current 1024 Configured 1024 Displaying PIM Sparse configuration information and statistics You can display the following PIM Sparse information: ∙ Basic PIM Sparse configuration information ∙ IPv6 interface information ∙ Group information ∙ BSR information ∙ Candidate RP information ∙ RP-to-group mappings ∙ RP information for an IPv6 PIM Sparse group ∙ RP set list ∙ Multicast neighbor information ∙ The IPv6 PIM multicast cache ∙ IPv6 PIM RPF ∙ IPv6 PIM counters ∙ IPv6 PIM resources ∙ IPv6 PIM traffic statistics Displaying basic PIM Sparse configuration information Enter the show ipv6 pim sparse command at any CLI level to display IPv6 PIM Sparse configuration information. Brocade# show ipv6 pim sparse Global PIM Sparse Mode Settings Maximum Mcache : 4096 Hello interval : 30 164 Current Count Neighbor timeout : 7 : 105 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols Join/Prune interval Hardware Drop Enabled Bootstrap Msg interval Register Suppress Time Register Stop Delay SSM Enabled SSM Group Range Route Precedence Embedded RP Enabled : : : : : : : : : 60 Inactivity interval : Yes Prune Wait Interval : 60 Candidate-RP Msg interval : 60 Register Probe Time : 10 Register Suppress interval : Yes SPT Threshold : ff30::/32 mc-non-default mc-default uc-non-default Yes 180 3 60 10 60 1 uc-default Syntax: show ipv6 pim [ vrf vrf-name ] sparse The vrf parameter allows you to configure IPv6 PIM on the virtual routing instance (VRF) specified by the vrf-name variable. The following table displays the output from the show ipv6 pim sparse command. TABLE 28 Output from the show ipv6 pim sparse command Field Description Global PIM Sparse mode settings Maximum mcache Maximum number of multicast cache entries. Current Count Number of multicast cache entries used. Hello interval How frequently the device sends IPv6 PIM Sparse hello messages to its IPv6 PIM Sparse neighbors. This field shows the number of seconds between hello messages. IPv6 PIM Sparse routers use hello messages to discover one another. Neighbor timeout Number of seconds the device waits for a hello message from a neighbor before determining that the neighbor is no longer present and is not removing cached IPv6 PIM Sparse forwarding entries for the neighbor. Default is 105 seconds. Join or Prune interval How frequently the device sends IPv6 PIM Sparse Join or Prune messages for the multicast groups it is forwarding. This field shows the number of seconds between Join or Prune messages. The device sends Join or Prune messages on behalf of multicast receivers that want to join or leave an IPv6 PIM Sparse group. When forwarding packets from IPv6 PIM Sparse sources, the device sends the packets only on the interfaces on which it has received join requests in Join or Prune messages for the source group. Inactivity interval Number of seconds a forwarding entry can remain unused before the router deletes it. Default is 180 sec. Hardware Drop Enabled Indicates whether hardware drop is enabled or disabled. To prevent unwanted multicast traffic from being sent to the CPU, PIM Routing and Passive Multicast Route Insertion (PMRI) can be used together to ensure that multicast streams are only forwarded out ports with interested receivers and unwanted traffic is dropped in the hardware on Layer 3 Switches. Prune Wait Interval Number of seconds a PIM device waits before stopping traffic to neighbor devices that do not want the traffic. Range is from zero to three seconds. Default is three seconds. Bootstrap Msg interval How frequently the BSR configured on the device sends the RP set to the RPs within the IPv6 PIM Sparse domain. The RP set is a list of candidate RPs and their group prefixes. The group prefix of a candidate RP indicates the range of IPv6 PIM Sparse group numbers for which it can be an RP. NOTE This field contains a value only if an interface on the device is elected to be the BSR. Otherwise, the field is blank. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 165 IPv6 Multicast Protocols TABLE 28 Output from the show ipv6 pim sparse command (continued) Field Description Candidate-RP Msg interval Number of seconds the candidate RP configured on the Layer 3 switch sends candidate RP advertisement messages to the BSR. Default is 60 seconds. Register Suppress Time This is the mean interval between receiving a Register-Stop and allowing registers to be sent again. A lower value means more frequent register bursts at RP, while a higher value means longer join latency for new receivers. Default: 60 seconds. Register Probe Time Number of seconds the PIM router waits for a register-stop from an RP before it generates another NULL register to the PIM RP. Default is 10 seconds. Register Stop Delay Register stop message. Default is 10 seconds. Register Suppress interval Number of seconds that it takes the designated router to send Registerencapsulated data to the RP after receiving a Register-Stop message. Default is 60 seconds. SSM Enabled If yes, source-specific multicast is configured globally on this router. SPT threshold Number of packets the device sends using the path through the RP before switching to the SPT path. Default is 1 packet. SSM Group Range Source-specific multicast group range. Route Precedence The route precedence configured to control the selection of routes based on the four route types: Embedded RP Enabled ∙ Non-default route from the mRTM ∙ Default route from the mRTM ∙ Non-default route from the uRTM ∙ Default route from the uRTM Indicates whether the embedded RP is enabled or disabled. Displaying IPv6 PIM interface information You can display IPv6 PIM multicast interface information using the show ipv6 pim interface command. device# show ipv6 pim interface ethernet 1/1/7 Flags : SM - Sparse Mode v2 ---------+---------------------------------------------------+----+---+---+---------+------+---------------Interface|Global Address |Mode|St |TTL|Multicast| VRF | DR | Override | + Designated Router Port | | |Thr|Boundary | | Prio | Interval ---------+---------------------------------------------------+----+---+---+---------+------+---------------e1/1/1 a141::1 SM Ena 1 None default 1 3000ms + Itself Total Number of Interfaces : 1 Syntax: show ipv6 pim [ vrfvrf-name ] interface [ ethernet unit/slot/port | loopback num | ve num ] The vrf option allows you to display multicast boundary information for the VRF instance identified by the vrf-name variable. The ethernet unit/slot/port parameter specifies the physical port. The loopback num parameter specifies the loopback port. The ve num parameter specifies a virtual interface. The following table displays the output from the show ip pim interface ethernet command. 166 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols TABLE 29 Output from the show ipv6 pim interface ethernet command Field Description Interface Name of the interface. Global Address IP address of the interface. Port Port number of the designated router. Mode PIM mode. St State. TTL Thr Time to live threshold. Multicast Boundary Multicast boundary, if one exists. VRF Name of the VRF. DR Prio Designated router priority. Override Interval Override interval in milliseconds. Displaying a list of multicast groups To display IPv6 PIM group information, enter the show ipv6 pim group command at any CLI level. device# show ipv6 pim group Total number of groups: 1 1 Group ff7e:a40:2001:3e8:27:0:1:2 Group member at e1/3/1: v31 Syntax: show ipv6 pim [ vrf vrf-name ] group The vrf parameter allows you to display IPv6 PIM group information for the VRF instance identified by the vrf-name variable. The following table displays the output from the show ipv6 pim group command. TABLE 30 Output from the show ipv6 pim group command Field Description Total number of Groups Lists the total number of IPv6 multicast groups the device is forwarding. Group The multicast group address. Group member at Interface unit/slot/port. Displaying BSR information To display information on a device that has been elected as the BSR, enter the show ipv6 pim bsr command at the CLI level. Brocade# show ipv6 pim bsr PIMv2 Bootstrap information for Vrf Instance : default-vrf -----------------------------------------------------------------This system is the Elected BSR BSR address: 2006:1001::1. Hash Mask Length 64. Priority 32. Next bootstrap message in 00:01:00 Configuration: Candidate loopback 1 (Address 2006:1001::1). Hash Mask Length 64. Priority 32. Next Candidate-RP-advertisment in 00:00:50 RP: 2006:1001::1 group prefixes: ff00:: / 8 Candidate-RP-advertisement period: 60 Candidate-RP-advertisement period: 60 Candidate-RP-advertisement period: 60 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 167 IPv6 Multicast Protocols The following example shows information displayed on a device that is not the BSR. Notice that some fields shown in the previous example do not appear in the following example. Brocade# show ipv6 pim bsr PIMv2 Bootstrap information for Vrf Instance : default-vrf -----------------------------------------------------------BSR address: 2006:1001::1. Hash Mask Length 64. Priority 32. This system is not a Candidate-RP. This system is not a Candidate-RP. Syntax: show ipv6 pim [ vrf vrf-name ] bsr The vrf parameter allows you to display IPv6 PIM BSR information for the VRF instance identified by the vrf-name variable. The following table displays the output from the show ipv6 pim bsr command. TABLE 31 Output from the show ipv6 pim bsr command Field Description BSR address The IPv6 address of the interface configured as the IPv6 PIM Sparse Bootstrap Router (BSR). BSR priority The priority assigned to the interface for use during the BSR election process. During BSR election, the priorities of the candidate BSRs are compared and the interface with the highest BSR priority becomes the BSR. Hash mask length The number of significant bits in the IPv6 multicast group comparison mask. This mask determines the IPv6 multicast group numbers for which the device can be a BSR. The default is 32 bits, which allows the device to be a BSR for any valid IPv6 multicast group number. NOTE This field appears only if this device is a candidate BSR. Next bootstrap message in Indicates how many seconds will pass before the BSR sends its next Bootstrap message. NOTE This field appears only if this device is the BSR. Next Candidate-RP-advertisement message in Indicates how many seconds will pass before the BSR sends its next candidate RP advertisement message. NOTE This field appears only if this device is a candidate BSR. RP Indicates the IPv6 address of the Rendezvous Point (RP). NOTE This field appears only if this device is a candidate BSR. group prefixes Indicates the multicast groups for which the RP listed by the previous field is a candidate RP. NOTE This field appears only if this device is a candidate BSR. Candidate-RP-advertisement period Indicates how frequently the BSR sends candidate RP advertisement messages. NOTE This field appears only if this device is a candidate BSR. 168 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols Displaying candidate RP information To display candidate RP information, enter the show ipv6 rp-candidate command at any CLI level. device# show ipv6 pim rp-candidate Next Candidate-RP-advertisement in 00:00:10 RP: 1be::11:21 group prefixes: ff00:: / 8 Candidate-RP-advertisement period: 60 This example shows information displayed on a device that is a candidate RP. The following example shows the message displayed on a device that is not a candidate RP. device# show ipv6 pim rp-candidate This system is not a Candidate-RP. Syntax: show ipv6 pim [ vrf vrf-name ] rp-candidate The vrf parameter allows you to display IPv6 candidate RP information for the VRF instance identified by the vrf-name variable. The following table displays the output from the show ipv6 pim rp-candidate command. TABLE 32 Output from the show ipv6 pim rp-candidate command Field Description Candidate-RP-advertisement in Indicates how many seconds will pass before the BSR sends its next RP message. NOTE This field appears only if this device is a candidate RP. RP Indicates the IPv6 address of the Rendezvous Point (RP). NOTE This field appears only if this device is a candidate RP. group prefixes Indicates the multicast groups for which the RP listed by the previous field is a candidate RP. NOTE This field appears only if this device is a candidate RP. Candidate-RP-advertisement period Indicates how frequently the BSR sends candidate RP advertisement messages. NOTE This field appears only if this device is a candidate RP. Displaying RP-to-group mappings To display RP-to-group-mappings, enter the show ipv6 pim rp-map command at any CLI level. Brocade#show ipv6 pim rp-map Number of group-to-RP mappings: 3 ------------------------------------------------------------------------------S.No Group address RP address ------------------------------------------------------------------------------1 ff07::c:1 3200:12::32 2 ff07::c:2 3200:12::32 3 ff07::c:3 3200:12::32 Number of group-to-RP mappings: 3 Brocade# FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 169 IPv6 Multicast Protocols Syntax: show ipv6 pim [ vrf vrf-name ] rp-map The vrf parameter allows you to display IPv6 RP-to-group-mappings for the VRF instance identified by the vrf-name variable. The following table displays the output from the show ipv6 rp-map command. TABLE 33 Output from the show ipv6 pim rp-map command Field Description Index The index number of the table entry in the display. Group address Indicates the IPv6 PIM Sparse multicast group address using the listed RP. RP address Indicates the Iv6 address of the Rendezvous Point (RP) for the listed PIM Sparse group. Displaying RP information for an IPv6 PIM Sparse group To display RP information for an IPv6 PIM Sparse group, enter the following command at any CLI level. device# show ipv6 pim rp-hash ff1e::1:2 RP: 2001:3e8:255:255::17, v2 Info source: 2001:3e8:255:255::17, via bootstrap Syntax: show ipv6 pim [ vrf vrf-name ] rp-hash group-addr The vrf parameter allows you to display RP information for a PIM Sparse group for the VRF instance identified by the vrf-name variable. The group-addr parameter is the address of an IPv6 PIM Sparse IP multicast group. The following table displays the output from the show ipv6 pim rp-hash group-addr command. TABLE 34 Output from the show ipv6 pin rp-hash group-addr command Field Description RP Indicates the IPv6 address of the Rendezvous Point (RP) for the specified IPv6 PIM Sparse group. Following the IPv6 address is the port or virtual interface through which this device learned the identity of the RP. Info source Indicates the IPv6 address on which the RP information was received. Following the IPv6 address is the method through which this device learned the identity of the RP. Displaying the RP set list To display the RP set list, enter the show ipv6 pim rp-set command at any CLI level. device# show ipv6 pim rp-set Static RP --------Static RP count: 1 100::1 Number of group prefixes Learnt from BSR: 0 No RP-Set present Syntax: show ipv6 pim [ vrf vrf-name ] rp-set The vrf parameter allows you to display the RP set for the VRF instance identified by the vrf-name variable. The following table displays the output from the show ipv6 pim rp-set command. 170 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols TABLE 35 Output from the show ipv6 pim rp-set command Field Description Number of group prefixes The number of IPv6 PIM Sparse group prefixes for which the RP is responsible. Group prefix Indicates the multicast groups for which the RP listed by the previous field is a candidate RP. RPs expected or received Indicates how many RPs were expected and received in the latest Bootstrap message. RP num Indicates the RP number. If there are multiple RPs in the IPv6 PIM Sparse domain, a line of information for each of them is listed, and they are numbered in ascending numerical order. priority The RP priority of the candidate RP. During the election process, the candidate RP with the highest priority is elected as the RP. age The age (in seconds) of this RP-set. NOTE If this device is not a BSR, this field contains zero. Only the BSR ages the RP-set. Displaying multicast neighbor information To display information about IPv6 PIM neighbors, enter the show ipv6 pim neighbor command at any CLI level. Device#show ipv6 pim neighbor -------+--------+--------------------------+--------+---+ PPort |PhyPort |Neighbor |Holdtime|T | | | |sec |Bit| -------+--------+--------------------------+--------+---+vv503 e2/1/11 fe80::204:ff:fe05:6 105 1 + 2006:503::1001 vv503 2/1/11 fe80::768e:f8ff:fe2c:cb80 105 1 + 2006:503::1004 Total Number of Neighbors : 2 [output continued] +---------+---------+-----+----------+--------+----+ |PropDelay|Override |Age |UpTime |VRF |Prio |msec |msec |sec | | | +---------+---------+-----+----------+--------+----+ 500 3000 25 06:50:10 default 1 500 3000 12 06:50:10 default 1 Syntax: show ipv6 pim [ vrf vrf-name ] neighbor The vrf vrf-name keyword allows you to display the IPv6 PIM neighbors for the VRF instance identified by the vrf-name variable. The following table displays the output from the show ipv6 pim neighbor command. TABLE 36 Output from the show ipv6 pim neighbor command Field Description Port The routing interface through which the device is connected to the neighbor. Phyport The physical interface through which the device is connected to the neighbor. Neighbor The IPv6 interface of the IPv6 PIM neighbor interface. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 171 IPv6 Multicast Protocols TABLE 36 Output from the show ipv6 pim neighbor command (continued) Field Description Holdtime sec Indicates how many seconds the neighbor wants this device to hold the entry for this neighbor in memory. The neighbor sends the Hold Time in its hello packets. ∙ If the device receives a new hello packet before the Hold Time received in the previous packet expires, the device updates its table entry for the neighbor. ∙ If the device does not receive a new hello packet from the neighbor before the Hold time expires, the device assumes the neighbor is no longer available and removes the entry for the neighbor. T Bit Specifies the ability of the sending router to disable joins suppression. PropDelay msec Expected propagation delay over the local link. Override msec Default delay interval over which to randomize, when scheduling a delayed join message. Age sec The number of seconds since the device received the last hello message from the neighbor. UpTime The number of seconds the PIM neighbor has been up. This timer starts when the device receives the first hello messages from the neighbor. VRF Prio The DR priority that is used in the DR election process. This can be a configured value or the default value of 1. Displaying the IPv6 PIM multicast cache To display the IPv6 PIM multicast cache, enter the show ipv6 pim mcache command at any CLI level. NOTE Brocade NetIron CES and NetIron CER devices display incorrect hardware programmed entries. The information displayed for the forwarding port should be disregarded. device#show ipv6 pim mcache IP Multicast Mcache Table Entry Flags : SM - Sparse Mode, SSM - Source Specific Multicast, DM - Dense Mode RPT - RPT Bit, SPT - SPT Bit, LSRC - Local Source, LRCV - Local Receiver HW - HW Forwarding Enabled, FAST - Resource Allocated, TAG - Need For Replication Entry REGPROB - Register In Progress, REGSUPP - Register Suppression Timer MSDPADV - Advertise MSDP, NEEDRTE - Route Required for Src/RP, PRUN - DM Prune Upstream Interface Flags: IM - Immediate, IH - Inherited, WA - Won Assert MJ - Membership Join, MI - Membership Include, ME - Membership Exclude BR - Blocked RPT, BA - Blocked Assert, BF - Blocked Filter, BI - Blocked IIF Total entries in mcache: 4 1 (*, ff05::4422) RP 2006:1001::1, in v503 (tag e2/1/11), Uptime 1d 00:27:26 (SM) upstream neighbor fe80::204:ff:fe05:6 (2006:503::1001) Flags (0x002604a2) SM RPT LRCV TAG slow ports: ethe 3/1/1 AgeSltMsk: 0, L2 FID: 8192, DIT: NotReq, profile: none Forwarding_oif: 1, Immediate_oif: 1, Blocked_oif: 0 L3 (SW) 1: e3/1/1(VL170), 1d 00:27:26/0, Flags: MJ 2 (2006:170::1010, ff34::500) in v170 (tag e3/1/1), Uptime 00:37:51, Rate 0 (SM) Source is directly connected. RP 2006:1001::1 Flags (0x20429ce1) SM SPT REG L2REG LSRC HW FAST TAG fast ports: ethe 2/1/11 AgeSltMsk: 1, L2 FID: 4188, DIT: 1 , AvgRate: 0, profile: none Forwarding_oif: 1, Immediate_oif: 1, Blocked_oif: 0 L3 (HW) 1: TR(e2/1/11,e2/1/11)(VL503), 00:37:26/183, Flags: IM Src-Vlan: 170 172 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols Syntax: show ipv6 pim mcache [ multicast cache entries source/group address | multicast cache ipv6-group-address ] Syntax: show ipv6 pim [ vrf vrf-name ] mcache [ source-address | group-address | counts | dense | dit-idx dit-idx | g_entries | receiver | sg_entries | sparse | ssm ] The vrf option allows you to display the IPv6 PIM multicast cache for the VRF instance identified by the vrf-name variable. The source-address parameter selects the multicast cache source address. The group-address parameter selects the multicast cache group address. The counts keyword indicates the count of entries. The dense keyword displays only the PIM Dense Mode entries. The dit-idx variable allows you to display all entries that match a specified dit. The g_entries keyword displays only the (*, G) entries. The receiver keyword allows you to display all entries that egress a specified interface. The sg_entries keyword displays only the (S, G) entries. The sparse keyword displays only the PIM Sparse Mode entries. The ssm keyword displays only the SSM entries. The following table describes the output parameters of the show ipv6 pim vrf mcache command. TABLE 37 Output parameters of the show ipv6 pim mcache command Field Description Total entries in mcache Shows the total number of PIM mcache entries. upstream neighbor Shows the upstream neighbor for the Source/RP based on the type of entry. For (*,G) it shows the upstream neighbor towards the RP. For (S,G) entries it shows the upstream neighbor towards the source. Flags Show the flags associated with the forward entry. slow ports ethe Shows the forwarding port ID of the mcache entry which is in the software forwarding path. AgeSltMsk Shows the slot number on which MP expects ingress traffic. L2 FID Shows the hardware resource allocated for the traffic switched to receivers in the ingress VLAN. DIT Shows the hardware resource allocated for routed receivers. AvgRate Shows the average data traffic rate for the mcache entry profile Shows the profile ID associated with the stream. Forwarding_oif Shows the number of outgoing interfaces of the mcache entry. immediate_oifs Shows the local immediate outgoing interface of the mcache entry. blocked_oifs Shows the PIM Sparse mode blocked outgoing interfaces. L3 (SW) 1 Shows whether the traffic is switched or routed out of the interface. L3 (HW) 1 The forwarding entries by using hardware. Src-Vlan VLAN associated with the ingress interface. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 173 IPv6 Multicast Protocols Displaying IPv6 PIM RPF The show ipv6 pim rpf command displays what PIM sees as the reverse path to the source. While there may be multiple routes back to the source, the one displayed by the show ipv6 pim rpf command is the one that PIM thinks is best. device# show ipv6 pim rpf 2008:165::1010 upstream nbr 2006:503::1001 on v503 Syntax: show ipv6 pim [ vrf vrf-name ] rpf ip-address The vrf parameter allows you to display what PIM sees as the reverse path to the source for a VRF instance specified by the vrf-name variable. The ip-address variable specifies the source address for RPF check. Displaying IPv6 PIM counters You can display the number of default-vlan-id changes that have occurred since the applicable VRF was created and how many times a tagged port was placed in a VLAN since the applicable VRF was created, as shown in the following example. Brocade#show ipv pim vrf eng counter Event Callback: DFTVlanChange : 0 VlanPort : 0 LP to MP IPCs: SM_REGISTER : 8315 MCAST_CREATE : S_G_AGEOUT : 3 WRONG_IF : ABOVE_THRESHOLD: 0 MCAST_FIRST_DATA : SET KAT : 3 SET KAT INFINITY : MP to LP IPCs: INIT : 25 INSERT_VPORT : 30 DELETE_VPORT : 186 DELETE_VIF : 162 MOVE_VPORT : 0 DEL_ENTRY : 16 INSERT_SOURCE : 0 DELETE_SOURCE : 0 RESET_SRC_LIST : 0 MOVE_TNNL_PORT : 0 FLAG_CHANGE : 6 FDB_VIDX_CHANGE: 0 OIF_FLAG_CHANGE :0 Error Counters: PIM_PKT_DRP : 0 PIM_PKT_DRP(Glb) : MCGRP_PKT_DRP: 0 MCGRP_PKT_DRP(Gl): RPSET_MAXED : 0 0 0 3 3 0 0 Syntax: show ipv6 pim [ vrf vrf-name ] counter The vrf parameter allows you to display IPv6 PIM counters for the VRF instance identified by the vrf-name variable. The following table displays the output from the show ipv6 vrf eng counter command. TABLE 38 Output from the show ipv6 pim vrf eng counter command Field Description DFTVlanChange The number of default-vlan-id changes that have occurred since the applicable VRF was created. VlanPort The number of times that a tagged port was placed in a VLAN since the applicable VRF was created. Displaying the IPv6 PIM resources To display the hardware resource information, such as hardware allocation, availability, and limit for software data structure, enter the show ipv6 pim resource command. Brocade#show ipv6 pim Global PIM Parameters GLOBAL Ipv6 MULTICAST GLOBAL Ipv6 PIM CLASS 174 vrf white res :CLASS Size:23573 bytes Size:2162 bytes FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols MULTICAST IPV6 CLASS Num alloc:2, System max:17, Size:1346 bytes PIM IPV6 CLASS Num alloc:2, System max:17, Size:50485 Vrf Instance : white -------------------------------------alloc in-use avail get-fail limit get-mem size init NBR list 64 2 62 0 512 73 96 64 RP set list 256 1 255 0 1536 12824 49 256 Static RP 64 0 64 0 64 0 42 64 LIF Entry 512 0 512 0 512 0 47 512 Anycast RP 64 0 64 0 64 0 190 64 timer 64 0 64 0 14848 65 64 64 prune 32 0 32 0 7424 0 34 32 pimsm J/P elem 1024 0 1024 0 48960 640448 29 128 Timer Data 512 2 510 0 14848 1409 28 64 mcache SLIB Sync 1120 2 1118 0 64960 9502 34 280 mcache 896 2 894 0 12992 5570 1144 56 graft if no mcache 197 0 197 0 45704 0 64 197 HW replic vlan 1000 2 998 0 116000 170179 66 500 HW replic port 1024 2 1022 0 59392 170179 81 256 pim/dvm intf. group 64 0 64 0 14848 0 24 64 pim/dvm global group 512 0 512 0 14848 6700 46 64 repl entry(Global) 1024 2 1022 0 237568 40644 49 1024 MLD Resources(All Vrfs): groups 1024 0 1024 0 4096 7100 328 256 phy-ports 2048 0 2048 0 4096 7600 148 256 exist-phy-port 1792 0 1792 0 12992 196484 62 56 group-query 56 0 56 0 12992 0 84 56 Hardware-related Resources: Total (S,G) entries 2 Total SW FWD entries 0 Total sw w/Tag MVID entries 0 Total sw w/Tag invalid MVID entries 0 Total HW FWD entries 2 Total hw w/Tag MVID entries 2 Total hw w/Tag invalid MVID entries 0 Brocade# Syntax: show ipv6 pim [ all-vrf | [ vrf vrf-name ] ] resource The vrf parameter allows you to display hardware resource information for the VRF instance identified by the vrf-name variable. The following table displays the output from the show ipv6 pim resource command. TABLE 39 Output from the show ipv6 pim resource command Field Description Num alloc Number of allocated PIM resources. System max Maximum number of VRF resources. Size Internal size. alloc Number of nodes of that data that are currently allocated in memory. in-use Number of allocated nodes in use. avail Number of allocated nodes are not in use. get-fail Number of allocated notes that failed. limit Maximum number of nodes that can be allocated for a data structure. This may or may not be configurable, depending on the data structure get-mem Current memory allocation. size Unit size. init Initial number. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 175 IPv6 Multicast Protocols To display usage and fail-count information for SG entries on each VRF, use the show ipv6 pim all-vrf hw-resource command. device# show ipv6 pim all-vrf hw-resource VRF In-Use Fail default-vrf 3072 8 blue 3072 0 ------------------------------Total usage 6144 System-max limit for SG entries: 6144 Syntax: show ipv6 pim [ all-vrf | [ vrf vrf-name ] ] hw-resource The vrf parameter allows you to display hardware resource information for the VRF instance identified by the vrf-name variable. The following table displays the output from the show ipv6 pim all-vrf hw-resource command. TABLE 40 Output from the show ipv6 pim all-vrf hw-resource command Field Description VRF Name of the VRF. Usage Number of allocated SG entries in this VRF. Fail Number of failures while allocating SG entries in this VRF (due to systemmax limit). Total usage Total number of SG entries in the system (All-VRFs). System-max limit for SG entries Configured system limit using the pim6-hw-mcache command. Displaying PIM traffic statistics To display IPv6 PIM traffic statistics, enter the show ipv6 pim traffic command at any CLI level. device# show ipv6 pim traffic Port HELLO JOIN-PRUNE ASSERT REGISTER REGISTER BOOTSTRAP CAND. RP Err GRAFT(DM) STOP(SM) MSGS (SM) ADV. (SM) -------+---------+-----------+---------+---------+---------+---------+---------+--Rx Rx Rx Rx Rx Rx Rx Rx ------+---------+-----------+---------+---------+---------+---------+---------+--v170 0 0 0 0 0 0 0 0 v501 0 0 0 0 0 0 0 0 v503 3302 2524 0 0 0 0 0 0 Port HELLO JOIN-PRUNE ASSERT REGISTER REGISTER BOOTSTRAP CAND. RP Err GRAFT(DM) STOP(SM) MSGS (SM) ADV. (SM) -------+---------+-----------+---------+---------+---------+---------+---------+--Tx Tx Tx Tx Tx Tx Tx ------+---------+-----------+---------+---------+---------+---------+---------+--v170 3576 0 0 0 0 0 0 v501 1456 0 0 0 0 0 0 v503 1456 1314 0 0 0 2 0 Syntax: show ipv6 pim [ vrf vrf-name ] traffic The vrf parameter allows you to display IPv6 traffic statistics for the VRF instance identified by the vrf-name variable. The following table displays the output from the show ipv6 pim traffic command. TABLE 41 Output from the show ipv6 pim traffic command Field Description Port The port or virtual interface on which the IPv6 PIM interface is configured. Hello The number of IPv6 PIM Hello messages sent or received on the interface. Join-Prune The number of Join or Prune messages sent or received on the interface. 176 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols TABLE 41 Output from the show ipv6 pim traffic command (continued) Field Description NOTE Unlike PIM dense, PIM Sparse uses the same messages for Joins and Prunes. Assert The number of Assert messages sent or received on the interface. Register Graft (DM) The number of Register messages sent or received on the interface. Regiser Stop (SM) The number of Register Stop messages sent or received on the interface. Bootstrap Msgs (SM) The number of bootstrap messages sent or received on the interface. Cand. RP Adv. (SM) The total number of Candidate-RP-Advertiment messages sent or received on the interface. Err The total number of MLD messages discarded, including a separate counter for those that failed the checksum comparison. Clearing the IPv6 PIM forwarding cache You can clear the IPv6 PIM forwarding cache using the clear ipv6 pim cache command. device# clear ipv6 pim cache Syntax: clear ipv6 pim [ vrf vrf-name ] cache Use the vrf parameter to clear the IPv6 PIM forwarding cache for a VRF instance specified by the vrf-name variable. Clearing the IPv6 PIM message counters You can clear the IPv6 PIM message counters using the clear ipv6 pim counters command. device# clear ipv6 pim counters Syntax: clear ipv6 pim [ vrf vrf-name ] counters Use the vrf parameter to clear the IPv6 PIM message counters for a VRF instance specified by the vrf-name variable. Updating PIM Sparse forwarding entries witha new RP configuration If you make changes to your static RP configuration, the entries in the IPv6 PIM Sparse multicast forwarding table continue to use the old RP configuration until they are aged out. The clear IPv6 pim rp-map command allows you to update the entries in the static multicast forwarding table immediately after making RP configuration changes. This command is meant to be used with rp-address command. To update the entries in an IPv6 PIM Sparse static multicast forwarding table with a new RP configuration, enter the clear ipv6 pim rpmap command at the privileged EXEC level of the CLI. device(config)# clear ipv6 pim rp-map Syntax: clear ipv6 pim [ vrf vrf-name ] rp-map Use the vrf parameter to clear the IPv6 PIM Sparse static multicast forwarding table for a VRF instance specified by the vrf-name variable. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 177 IPv6 Multicast Protocols Clearing the IPv6 PIM traffic To clear counters on IPv6 PIM traffic, enter the clear ipv6 pim traffic command. device# clear ipv6 pim traffic Syntax: clear ipv6 pim [ vrf vrf-name ] traffic Use the vrf par meter to clear counters on IPv6 PIM traffic for a VRF instance specified by the vrf-name variable. Defining the maximum number of IPv6 PIM cache entries You can use the max-mcache command to define the maximum number of repeated PIM traffic being sent from the same source address and being received by the same destination address. To define the maximum for the default VRF, enter the max-mcache command. Device(config)# ipv6 router pim Device(config-ipv6-pim-router)# max-mcache 999 Syntax: [no] max-mcache num The num variable specifies the maximum number of IPv6 multicast cache entries for PIM in the default VRF. If not defined by this command, the maximum value is determined by the system max command parameter, pim6-hw-mcache, or by available system resources. To define the maximum number of IPv6 PIM cache entries for a specified VRF, use the following command. Device(config)# ipv6 router pim vrf blue Device(config-ipv6-pim-router-vrf-blue)# max-mcache 999 Syntax: [no] ipv6 router pim [ vrf vrf-name ] The vrf parameter specified with the ipv6 router pim command allows you to configure the max-mcache command for a virtual routing instance (VRF) specified by the variable vrf-name. The vrf parameter specified with the router pim command allows you to configure the max-mcache command for a virtual routing instance (VRF) specified by the variable vrf-name. The num variable specifies the maximum number of multicast cache entries for PIM in the specified VRF. If not defined by this command, the maximum value is determined by the system max command parameter, pim6-hw-mcache, or by available system resources. There is a system-max command parameter change with the following new runtime command: Syntax: system-max pim6-hw-mcache The system-max pim6-hw-mcache command sets the maximum number of SG entries that are allowed in the hardware. Configuring a static multicast route within a VRF You can configure a static multicast route within a virtual routing instance (VRF). 1. Configure a VRF. Device(config)# vrf vpn1 2. Configure the VRF address family for IPv6 and enter IPv6 address family configuration mode. Device (config-vrf-vpn1)#address-family ipv6 178 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols 3. Configure the destination IPv6 address. Device (config-vrf-vpn1-ipv6)#ipv6 mroute 2001:0DB8:0:1::1/120 5100::192:1:1:1 Configuring the route precedence by specifying the route types Precedence tables specify how routes are selected for multicast PIM must be enabled at the global level. Configure the none keyword to fill up the precedence table and ignore certain types of routes. 1. Enable PIM at the global level. Device(config)# ipv6 router pim 2. Configure a precedence table. Device(config-ipv6-pim-router)# route-precedence mc-non-default uc-non-default mc-default uc-default Configures a precedence table for multicast route selection that first looks for a non-default route from the mRTM, then a nondefault route from the uRTM, then a default route from the mRTM, and then a default route from the uRTM. 3. Configure the none keyword to fill up the precedence table in order to ignore certain types of route. Device(config-ipv6-pim-router)# route-precedence mc-non-default mc-default uc-non-default none Configures a precedence table for multicast route selection that ignores the default route from uRTM . 4. Return to global level. Device(config-ipv6-pim-router)# exit 5. Enable PIM for a VRF. Device(config)# ipv6 router pim vrf blue 6. Configure a precedence table for the VRF. Device (config-ipv6-pim-router-vrf-blue)# route-precedence mc-non-default uc-non-default mc-default uc-default Configures a precedence table that specifies a non-default route from the mRTM, then a non-default route from the uRTM, then a default route from the mRTM, and then a default route from the uRTM for the specified VRF,. 7. Configure the none keyword to fill up the precedence table. Device(config-ipv6-pim-router-vrf-blue)# route-precedence mc-non-default mc-default uc-non-default none Configures a precedence table that specifies the unicast default route for multicast for the specified VRF. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 179 IPv6 Multicast Protocols The following examples show how to configure the route precedence and display the route-precedence setting. Device(config-ipv6-pim-router)#route-precedence mc-non-default mc-default uc-non-default uc-default Device(config-ipv6-pim-router)#show ipv6 pim sparse Global PIM Sparse Mode Settings Maximum Mcache : 12992 Current Count : 2 Hello interval : 30 Neighbor timeout : 105 Join/Prune interval : 60 Inactivity interval : 180 Hardware Drop Enabled : Yes Prune Wait Interval : 3 Bootstrap Msg interval : 60 Candidate-RP Msg interval : 60 Register Suppress Time : 60 Register Probe Time : 10 Register Stop Delay : 10 Register Suppress interval : 60 SSM Enabled : No SPT Threshold : 1 Route Precedence : mc-non-default mc-default uc-non-default uc-default Embedded RP Enabled : Yes Device(config-ipv6-pim-router)#route-precedence admin-distance Device(config-ipv6-pim-router)#show ipv6 pim sparse Global PIM Sparse Mode Settings Maximum Mcache : 12992 Current Count Hello interval : 30 Neighbor timeout Join/Prune interval : 60 Inactivity interval Hardware Drop Enabled : Yes Prune Wait Interval Bootstrap Msg interval : 60 Candidate-RP Msg interval Register Suppress Time : 60 Register Probe Time Register Stop Delay : 10 Register Suppress interval SSM Enabled : No SPT Threshold Route Precedence : admin-distance Embedded RP Enabled : Yes Device(config-ipv6-pim-router) : : : : : : : : 2 105 180 3 60 10 60 1 Configuring IPv6 PIM neighbor filtering Configure an ACL and apply it to an interface to control neighbor access. 1. Configure an ACL named f10. Device(config)#ipv6 access-list f10 Identify the ACL as an ASCII string. Configures an ACL and enters ACL configuration mode. 2. Configure ACL f10 to deny access to the device fe80::102. Device(config-ipv6-access-list f10)#deny ipv6 host fe80::102 any NOTE In this case, fe80::102 is is the link-local address of the interface. 3. Configure ACL f10 to permit access to all other devices. Device(config-ipv6-access-list f10)#permit ipv6 any any 4. Return to global configuration mode. Device(config-ipv6-access-list f10)#exit 5. Configure an Ethernet interface. Device(config)#interface ethernet 1/3/2 Configures an interface and enters interface configuration mode. 180 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols 6. Configure a filter that applies ACL f10 to the interface. Device(config-if-e1000-1/3/2)#ipv6 pim neighbor-filter f10 Prevents the host that is specified in ACL f10, fe80::102, from becoming an IPv6 PIM neighbor on the interface. IPv6 PIM convergence on MAC movement PIM convergence occurs when the PIM module is notified of a topology change. The notification is triggered upon a change in port status, Reverse Path Forwarding (RPF) failure in the hardware, or by the unicast routing module if there is a change in the Layer 3 topology. If the topology change occurs without setting off any of the two events or if the Layer 3 topology change is not notified by the unicast routing module, PIM convergence does not take place. If there is a change in the source traffic at the Layer 2 interface level, the RPF check fails because only loose RPF check is supported (loose RPF check detects the change in the source traffic only at the Layer 3 interface level). A notification for a change in the source traffic at the Layer 2 interface level can be triggered by establishing a signaling process for MAC address movement. The MAC address movement notification triggers RPF check on MAC movement for directly connected sources. The MAC address movement notification can be triggered by configuring the ipv6 multicast-routing rpf-check mac-movement command. The MAC address movement notification triggers a notification to the PIM module which results in convergence. IPv6 PIM convergence is supported only in PIM Sparse mode and is not supported in PIM Dense mode. PIM convergence on MAC movement is supported on the Brocade ICX 6610, FCX, Brocade ICX 6450 (when part of family stacking), Brocade ICX 7750, and Brocade ICX 7450. NOTE PIM convergence on MAC movement is applicable only in a topology where the multicast source port and PIM routers are in the same Layer 2 domain. PIM Anycast RP PIM Anycast RP is a method of providing load balancing and fast convergence to PIM RPs in an IPv6 multicast domain. The RP address of the Anycast RP is a shared address used among multiple PIM routers, known as PIM RP. The PIM RP routers create an Anycast RP set. Each router in the Anycast RP set is configured using two IPv6 addresses: a shared RP address in their loopback address and a separate, unique IPv6 address. The loopback address must be reachable by all PIM routers in the multicast domain. The separate, unique IP address is configured to establish static peering with other PIM routers and communication with the peers. When the source is activated in a PIM Anycast RP domain, the PIM First Hop (FH) will register the source to the closet PIM RP. The PIM RP follows the same MSDP Anycast RP operation by decapsulating the packet and creating the (s,g) state. If there are external peers in the Anycast RP set, the router will re-encapsulate the packet with the local peering address as the source address of the encapsulation. The router will unicast the packet to all Anycast RP peers. The re-encapsulation of the data register packet to Anycast RP peers ensures source state distribution to all RPs in a multicast domain. Configuring PIM Anycast RP A new PIM CLI is introduced for PIM Anycast RP under the router pim submode. The PIM CLI specifies mapping of the RP and the Anycast RP peers. To configure PIM Anycast RP, enter the following commands. device(config)# ipv6 router pim device(config-ipv6-pim-router)# rp-address 1001::1 device(config-ipv6-pim-router)# anycast-rp 1001::1 my-anycast-rp-set-acl FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 181 IPv6 Multicast Protocols To configure PIM Anycast RP for a specified VRF, enter the commands as shown in the following example. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# rp-address 1001::1 device(config-ipv6-pim-router-vrf-blue)# anycast-rp 1001::1 my-anycast-rp-set-acl Syntax: [no] anycast-rp rp-address my-anycast-rp-set-acl The rp address parameter specifies a shared RP address used among multiple PIM routers. The my-anycast-rp-set-acl parameter specifies a host-based simple ACL used to specify the address of the Anycast RP set, including a local address. The following example is a configuration of PIM Anycast RP 1001:1.The example avoids using the loopback 1 interface when configuring PIM Anycast RP because the loopback 1 address could be used as a router-id. A PIM First Hop router will register the source with the closest RP. The first RP that receives the register will re-encapsulate the register to all other Anycast RP peers. Refer to the figure “Example of a PIM Anycast RP network” as described in the configuration of PIM Anycast RP 1001:1. device(config)# interface loopback 2 device(config-lbif-2)# ipv6 address 1001::1/96 device(config-lbif-2)# ipv6 pim-sparse device(config-lbif-2)# interface loopback 3 device(config-lbif-3)# ipv6 address 1:1:1::1/96 device(config-lbif-3)# ipv6 pim-sparse device(config-lbif-3)# ipv6 router pim device(config-ipv6-pim-router)# rp-address 1001::1 device(config-ipv6-pim-router)# anycast-rp 1001::1 my-anycast-rp-set device(config-ipv6-pim-router)# ipv6 access-list my-anycast-rp-set device(config-std-nacl)# permit ipv6 host 1:1:1::1 any device(config-std-nacl)# permit ipv6 host 2:2:2::2 any device(config-std-nacl)# permit ipv6 host 3:3:3::3 any The RP shared address 1001:1 is used in the PIM domain. IPv6 addresses 1:1:1::1, 2:2:2::2, and 3:3:3::3 are listed in the ACL that forms the self-inclusive Anycast RP set. Multiple Anycast RP instances can be configured on a system; each peer with the same or different Anycast RP set. NOTE The PIM Anycast CLI applies to only PIM routers running RP. All deny statements in the anycast_rp_set ACL are ignored. The example shown in the figure “Example of a PIM Anycast RP network”is a PIM Anycast-enabled network with three RPs and one PIM-FH router connecting to its active source and local receiver. Loopback 2 in RP1, RP2, and RP3 each have the same IP addresses 1001:1. Loopback 3 in RP1, RP2, and RP3 each have separate IP address configured to communicate with their peers in the Anycast RP set. 182 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols FIGURE 12 Example of a PIM Anycast RP network Displaying information for an IPv6 PIM Anycast RP interface To display information for an IPv6 PIM Anycast RP interface, enter the show ipv6 pim anycast-rp command. device(config)# show ipv6 pim anycast-rp Number of Anycast RP: 1 Anycast RP: 1001::1 ACL ID: 200 ACL Name: my-anycast-rp-set ACL Filter: SET Peer List: 1:1:1::1 2:2:2::2 3:3:3::3 Syntax: show ipv6 pim [ vrf vrf-name ] anycast-rp The vrf parameter allows you to display information for an IPv6 Anycast RP interface for the VRF instance identified by the vrf-name variable. The following table describes the parameters of the show ipv6 pim anycast-rp command. TABLE 42 Output from the show ipv6 pim anycast-rp command Field Description Number of Anycast RP Specifies the number of Anycast RP sets in the multicast domain. Anycast RP Specifies a shared RP address used among multiple PIM routers. ACL ID Specifies the ACL ID assigned. ACL Name Specifies the name of the Anycast RP set. ACL Filter Specifies the ACL filter state SET or UNSET. Peer List Specifies host addresses that are permitted in the Anycast RP set. Multicast Listener Discovery and source-specific multicast protocols Multicast Listener Discovery Version 2 (MLDv2) protocol is supported. IPv6 routers use the MLDv2 protocol to discover multicast listeners, or nodes that wish to receive multicast packets on directly attached links. MLDv2 supports source filtering, the ability of a node to send reports on traffic that is from a specific address source or from all multicast addresses except the specified address sources. The information is then provided to the source-specific multicast (SSM) routing protocols such as PIM-SSM. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 183 IPv6 Multicast Protocols The IPv6 router stores a list of multicast addresses for each attached link. For each multicast address, the IPv6 router stores a filter mode and a source list. The filter mode is set to INCLUDE if all nodes in the source list for a multicast address are in the INCLUDE state. If the filter mode is INCLUDE, then only traffic from the addresses in the source list is allowed. The filter mode is set to EXCLUDE if at least one of the nodes in the source list is in an EXCLUDE state. If the filter mode is EXCLUDE, traffic from nodes in the source list is denied and traffic from other sources is allowed. The source list and filter mode are created when the IPv6 querier router sends a query. The querier router is the one with the lowest source IPv6 address. It sends out any of the following queries: ∙ General query - The querier sends this query to learn all multicast addresses that need to be listened to on an interface. ∙ Address specific query - The querier sends this query to determine if a specific multicast address has any listeners. ∙ Address specific and source specific query - The querier sends this query to determine if specified sources of a specific multicast address have any listeners. In response to these queries, multicast listeners send the following reports: ∙ Current state - This report specifies the source list for a multicast address and whether the filter mode for that source list is INCLUDE or EXCLUDE. ∙ Filter-mode change - This report specifies if there has been a change to the filter mode for the source list and provides a new source list. ∙ Source list change - This report specifies the changes to the source list. MLDv1 is compatible with IGMPv2 and MLDv2 is compatible with IGMPv3. Enabling MLDv2 The default MLD version when PIM Sparse Mode (PIM-SM) is enabled on an interface is MLDv1. You must configure the ipv6 mld version 2 command to enable MLDv2. To enable MLDv2, enter the following command at the interface level. device(config)# ipv6 router pim device(config-if-e10000-1/1/1)# ipv6 mld version 2 Syntax: [no] ipv6 mld version 2 Configuring MLD parameters for default and non-default VRFs MLD allows you to configure the following parameters on default and non-default VRFs: 184 ∙ Group membership time - Setting the group membership time on page 185 ∙ Max group address - Defining the maximum number of MLD group addresses on page 185 ∙ Max response time - Setting the maximum response time on page 185 ∙ Query interval - Setting the query interval on page 186 ∙ Last listener query count - Setting the last listener query interval on page 186 ∙ Last listener query interval - Setting the last listener query interval on page 186 ∙ Robustness - Setting the robustness on page 186 ∙ Version - Setting the version on page 187 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols Setting the group membership time You can set the group membership time for the default VRF or for a specified VRF. Group membership time defines how long a group will remain active on an interface in the absence of a group report. Possible values are from 5 through 26,000 seconds and the default value is 260 seconds. To define an MLD group membership time of 2000 seconds, enter the following command. device(config)# ipv6 mld group-membership-time 2000 Syntax: [no] ipv6 mld group-membership-time 5-26000 To define an MLD group membership time of 2000 seconds for a specified VRF, enter the following commands. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# ipv6 mld group-membership-time 2000 Syntax: [no] ipv6 router pim [ vrf vrf-name ] The vrf parameter specifies the virtual routing instance (VRF) specified by the variable vrf-name . Defining the maximum number of MLD group addresses You can use the following run-time command to set the maximum number of MLD addresses for the default VRF or for a specified VRF. To define this maximum for the default VRF, enter the following command. device(config)# ipv6 mld max-group-address 1000 Syntax: [no] ipv6 mld max-group-address num The num variable specifies the maximum number of MLD group addresses you want to make available for the default VRF. If not defined by this command, the maximum value is determined by available system resources. To define this maximum for a specified VRF, enter the following commands. device(config)# ipv6 router pim vrf blue device(config-vrf-blue)# address-family ipv6 device(config-vrf-blue-ipv6)# ipv6 mld max-group-address 1000 Syntax: [no] vrf vrf-name Syntax:[no] address-family ipv6 Syntax: [no] ipv6 mld max-group-address num The vrf parameter specifies the virtual routing instance (VRF) specified by the variable vrf-name . Setting the maximum response time You can define the maximum amount of time a multicast listener has to respond to queries by entering a command such as the following. device(config)# ipv6 mld max-response-time 5 Syntax: [no] ipv6 mld max-response-time seconds The seconds variable specifies the MLD maximum response time in seconds. You can specify from 1 through 25 seconds. The default is 10 seconds. To define the maximum amount of time a multicast listener has to respond to queries for a specified VRF, enter the following commands. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# ipv6 mld max-response-time 5 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 185 IPv6 Multicast Protocols Syntax: [no] ipv6 router pim [ vrfvrf-name ] The vrf parameter specifies the virtual routing instance (VRF) specified by the variable vrf-name . Setting the query interval You can define the frequency at which MLD query messages are sent. For example, if you want queries to be sent every 50 seconds, enter a command such as the following. device(config)# ipv6 mld query-interval 50 Syntax: [no] ipv6 mld query-interval seconds The seconds variable specifies the MLD query interval in seconds. You can specify from 2 through 3600 seconds. The default value is 125 seconds. To define the frequency at which MLD query messages are sent for a specified VRF, enter the following commands. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# ipv6 mld query-interval 50 Syntax: [no] ipv6 router pim [ vrf vrf-name ] The vrf parameter specifies the virtual routing instance (VRF) specified by the variable vrf-name . Setting the last listener query interval The Last Listener Query Interval is the Maximum Response Delay inserted into Multicast-Address-Specific Queries sent in response to Done messages, and is also the amount of time between Multicast- Address-Specific Query messages. When the device receives an MLDv1 leave message or an MLDv2 state change report, it sends out a query and expects a response within the time specified by this value. Using a lower value allows members to leave groups more quickly. You can set the last listener query interval by entering a command such as the following. device(config)# ipv6 mld llqi 5 Syntax: [no] ipv6 mld llqi seconds The seconds variable sets the last listener query interval in seconds. You can specify from 1 through 25 seconds. The default is 1. To set the last listener query interval for a specified VRF, enter the following commands. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# ipv6 mld llqi 5 Syntax: [no] ipv6 router pim [ vrf vrf-name ] The vrf parameter specifies the virtual routing instance (VRF) specified by the variable vrf-name . Setting the robustness You can specify the number of times that the switch sends each MLD message from this interface. Use a higher value to ensure high reliability from MLD. You can set the robustness by entering a command such as the following. device(config)# ipv6 mld robustness 3 Syntax: ipv6 mld robustness seconds The seconds variable sets the MLD robustness in seconds. You can specify from 2 through 7 seconds. The default is 2 seconds. 186 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols To set the robustness for a specified VRF, enter the following commands. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# ipv6 mld robustness 3 Syntax: [no] ipv6 router pim [ vrf vrf-name ] The vrf parameter specifies the virtual routing instance (VRF) specified by the variable vrf-name . Setting the version You can use this command to set the MLD version (1 or 2) globally. You can select the version of MLD by entering a command such as the following. device(config)# ipv6 mld version 1 Syntax: ipv6 mld version version-number The version-number variable sets the MLD version. You can specify 1 or 2 for the MLD version.The default version is 2. To set the global MLD version for a specified VRF, enter the following commands. device(config)# ipv6 router pim vrf blue device(config-ipv6-pim-router-vrf-blue)# ipv6 mld version 1 Syntax: [no] ipv6 router pim [ vrf vrf-name ] The vrf parameter specifies the virtual routing instance (VRF) specified by the variable vrf-name . Configuring MLD parameters at the interface level The following MLD parameters can be configured at the interface level: ∙ Port- version - Specifying a port version on page 187 ∙ Static-group - Specifying a static group on page 187 ∙ Tracking - Enabling MLD tracking on an interface on page 188 ∙ Version - Setting the version on an interface on page 188 Specifying a port version To set the MLD version on a virtual Ethernet interface, enter the following commands as shown in the example. device(config)# interface ve 10 device(config-vif-10)# ipv6 mld port-version 2 Syntax: ipv6 mld port-version version-number Enter 1 or 2 for version-number . Be sure to enter 2 if you want to use source filtering. Specifying a static group A multicast group is usually learned when an MLDv1 report is received. You can configure one or more static groups without having to receive an MLDv1 report. To configure two static groups, starting from ff0d::1, without having to receive an MLDv1 report on a virtual Ethernet interface, enter either this command: Device(config-if-e1000-1/1/5)# ipv6 mld static-group ff0d::1 count 2 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 187 IPv6 Multicast Protocols Or this command: Device(config-if-e1000-1/1/5)# ipv6 mld static-group ff0d::1 to ff0d::2 To configure two static groups on virtual ports starting from ff0d::1, enter either this command: Device(config)# interface ve 10 Device(config-vif-10)# ipv6 mld static-group ff0d::1 count 2 ethernet 1/1/5 Or this command: Device(config)# interface ve 10 Device(config-vif-10)# ipv6 mld static-group ff0d::1 to ff0d::2 ethernet 1/1/5 Syntax: ipv6 mld static-group multicast-group-address [ count count-number | to multicast-group-address ] [ ethernet unit/slot/port [ ethernet unit/slot/port | to unit/slot/port ] * ] Enter the IPv6 multicast group address for the multicast-group-address. The count-number range is 2-256. Enter the number of the port that will be included in this static group for the ethernet unit/slot/port parameter. The asterisk (*) in the syntax means that you can enter as many port numbers as you want to include in the static group. For a virtual routing interface (ve), specify the physical Ethernet ports on which to add the group address. Enabling MLD tracking on an interface When MLD tracking is enabled, a Layer 3 switch tracks all clients that send membership reports. When a Leave message is received from the last client, the device immediately stops forwarding to the physical port (without waiting 3 seconds to confirm that no other clients still want the traffic). To enable MLD tracking on a virtual interface, enter the following commands. device(config)# interface ve 10 device(config-vif-10)# ipv6 mld tracking Syntax: ipv6 mld tracking Setting the version on an interface You can use this command to set the MLD version (1 or 2) on an interface. You can select the version of MLD by entering a command such as the following. device(config)# interface ve 10 device(config-vif-10)# ipv6 mld version 2 Syntax: ipv6 mld version version-number The version-number variable sets the MLD version on an interface. You can specify 1 or 2 for the MLD version.The default version is 2. Displaying MLD information The sections below present the show commands for MLD. Displaying MLD group information To display the list of multicast groups, enter a command such as the following. device #show ipv6 mld group Total 2 groups -------------------------------------------------------------------------------------Idx Group Address Port Intf GrpCmpV Mode Timer Srcs ----+----------------------------------------+------+------+-------+-------+-----+---- 188 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols 1 ff05::4422 2 ff3f::300 Total number of groups 2 e3/1/1 e3/1/1 v170 v170 Ver1 exclude Ver2 include 221 0 0 1 Syntax: show ipv6 mld [ vrf vrf-name ] group The vrf parameter allows you to display the list of IPv6 MLD groups for the VRF instance identified by the vrf-name variable. The following table displays the output from the show ipv6 mld group command. TABLE 43 Output from the show ipv6 mld group command Field Description IDX Index for the MLD group. Group Address IPv6 address of the multicast group. Port The physical port to which the group belongs. Intf The routing interface to which the port belongs. GrpCmpV The version of the MLD group report message. Mode Indicates if the filter mode of the multicast group is in INCLUDE or EXCLUDE. Timer The number of seconds the interface can remain in its current mode. Total number of groups The total number of MLD groups. Displaying MLD definitions for an interface To display the MLD parameters on an interface, including the various timers, the current querying router, and whether or not MLD is enabled, enter the following command. Brocade#show ipv6 mld interface ---------+------+---------+---------------------------------------+-Intf/Port|Groups| Version | Querier | Timer |V1Rtr| Tracking | |Oper Cfg| |OQrr GenQ| | ---------+------+----+----+---------------------------------------+-e1/1/1 0 2 - Self 0 0 No Disabled v40 0 2 Disabled e3/1/1 1 2 - Self 0 0 No e2/1/1 1 2 - Self 0 0 No e1/1/1 1 2 - Self 0 0 No v50 0 2 Disabled e1/1/2 0 2 - Self 0 0 No v220 0 2 Disabled e1/1/1 3 2 - Self 0 12 No Syntax: show ipv6 mld [ vrf vrf-name ] interface [ ethernet unit/slot/port | ve num ] The vrf parameter allows you to display MLD parameters on an interface for the VRF instance identified by the vrf-name variable. Enter ve and its number, or ethernet and its port address to display MLD information for a specific virtual routing interface or an Ethernet interface. The following table displays the output from the show ipv6 mld interface command. TABLE 44 Output from the show ipv6 mld interface command Field Description version Version of the MLD being used. query int Query interval in seconds. max resp time Number of seconds multicast groups have to respond to queries. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 189 IPv6 Multicast Protocols TABLE 44 Output from the show ipv6 mld interface command (continued) Field Description group mem time Number of seconds multicast groups can be members of this group before aging out. (details) The following is displayed for each interface: ∙ The port ID ∙ The default MLD version being used ∙ The multicast protocol used ∙ IPV6 address of the multicast interface ∙ If the interface has groups, the group source list, IPv6 multicast address, and the filter mode are displayed. To display the MLD parameters on an interface for a specified VRF, enter the following command as shown in the example below. device(config)# show ipv6 mld vrf public interface ---------+------+---------+---------------------------------------+---------+-----+--------Intf/Port|Groups| Version |Querier | Timer |V1Rtr|Tracking | | Oper Cfg| | OQrr GenQ| ---------+------+----+----+---------------------------------------+----+----+-----+--------v6 0 2 Disabled e1/5/1 2 fe80::20c:dbff:fee2:5000 11 0 No v61 0 2 Disabled e1/1/1 2 Self 0 122 No | Displaying MLD settings To display MLD settings for the "eng" VRF, enter the following command. device# show ipv6 mld vrf eng MLD Global Configuration Query Interval : Max Response Time : Group Membership Time : Operating Version : Robustness Variable : Last Member Query Interval: Older Host Present Timer : settings 125s 10s 260s 2 2 1s 260s Configured Interval : 125s Configured Version : 0 Last Member Query Count: 2 Syntax: show ipv6 mld [ vrf vrf-name ] settings The vrf parameter specifies that you want to display information for MLD settings for the VRF specified by the vrf-name variable. The following table displays the output from the show ipv6 mld vrf eng settings command. TABLE 45 Output from the show ipv6 mld vrf eng settings command Field Description Query Interval How often the router will query an interface for group membership. Configured Interval The interval that has been configured for the router. Max Response Time The length of time in seconds that the router will wait for an IGMP (V1 or V2) response from an interface before concluding that the group member on that interface is down and removing it from the group. Group Membership Time The length of time in seconds that a group will remain active on an interface in the absence of a group report. Operating Version The IGMP version operating on the router. Configured Version The IGMP version configured on the router. Robustness Variable Used to fine-tune for unexpected loss on the subnet. The value is used to calculate the group interval. 190 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols TABLE 45 Output from the show ipv6 mld vrf eng settings command (continued) Field Description Last Member Query Interval Indicates when a leave is received; a group-specific query is sent. The last member query count is the number of queries with a time interval of (LMQT) is sent. Last Member Query Count Specifies the number of group-specific queries when a leave is received. Displaying static MLD groups The following command displays static MLD groups for the "cs" VRF. device# show ipv6 mld vrf cs static Group Address Interface Port List ----------------------------------------+---------+--------ff1e:1::1 v3 ethe 1/2/10 ff1e:a::7f v3 ethe 1/2/10 Syntax: show ipv6 mld [ vrf vrf-name ] static The vrf parameter specifies that you want to display static MLD group information for the VRF specified by the vrf-name variable. The following table displays the output from the show ipv6 mld vrf cs static command. TABLE 46 Output from the show ipv6 mld vrf cs static command Field Description Group Address The address of the multicast group. Interface Port List The physical ports on which the multicast groups are received. Displaying MLD traffic To display information on MLD traffic, enter a command such as the following. device# show ipv6 mld traffic Recv QryV1 QryV2 G-Qry GSQry MbrV1 MbrV2 Leave IS_IN IS_EX ToIN ToEX ALLO e1/3/1 0 0 0 0 0 0 0 0 0 0 0 0 e1/3/2 0 0 0 0 0 0 0 0 0 0 0 0 e1/6/18 0 0 0 0 0 176 0 110 0 0 0 66 e1/6/19 0 0 0 0 0 176 0 110 0 0 0 66 e1/6/20 0 0 0 0 0 176 0 110 0 0 0 66 e1/6/25 0 0 0 0 0 176 0 110 0 0 0 66 l1 0 0 0 0 0 0 0 0 0 0 0 0 Send QryV1 QryV2 G-Qry GSQry e1/3/1 0 0 0 0 e1/3/2 0 0 0 0 e1/6/18 0 10 10 0 e1/6/19 0 10 10 0 e1/6/20 0 10 10 0 e1/6/25 0 10 10 0 l1 0 0 0 0 R2# BLK 0 0 0 0 0 0 0 The report has a Receive and a Send section. Syntax: show ipv6 mld [ vrf vrf-name ] traffic The vrf parameter specifies that you want to display information on MLD traffic for the VRF specified by the vrf-name variable. The following table displays the output from the show ipv6 mld traffic command. FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 191 IPv6 Multicast Protocols TABLE 47 Output from the show ipv6 mld traffic command Field Description QryV1 Number of general MLDv1 queries received or sent by the virtual routing interface. QryV2 Number of general MLDv2 queries received or sent by the virtual routing interface. G-Qry Number of group-specific queries received or sent by the virtual routing interface. GSQry Number of source specific queries received or sent by the virtual routing interface. MbrV1 Number of MLDv1 membership reports received. MbrV2 Number of MLDv2 membership reports received. Leave Number of MLDv1 "leave" messages on the interface. (See 2_Ex for MLDv2.) Is_IN Number of source addresses that were included in the traffic. Is_EX Number of source addresses that were excluded in the traffic. ToIN Number of times the interface mode changed from exclude to include. ToEX Number of times the interface mode changed from include to exclude. ALLOW Number of times that additional source addresses were allowed or denied on the interface. BLK Number of times that sources were removed from an interface. Clearing IPv6 MLD traffic To clear counters on IPv6 MLD traffic, enter the following command. device# clear ipv6 mld traffic Syntax: clear ipv6 mld [ vrf vrf-name ] traffic Use the vrf option to clear counters on IPv6 MLD traffic for a VRF instance specified by the vrf-name variable. Clearing the IPv6 MLD group membership table cache You can clear the IPv6 PIM group membership table cache using the following command. device# clear ipv6 pim cache Syntax: clear ipv6 pim [ vrf vrf-name ] cache Use the vrf option to clear the IPv6 PIM group membership table cache for a VRF instance specified by the vrf-name variable. IPv6 Multicast Boundaries The Multicast Boundary feature is designed to selectively allow or disallow multicast flows to configured interfaces. The ipv6 multicast-boundary command allows you to configure a boundary on PIM enabled interface by defining which multicast groups may not forward packets over a specified interface. This includes incoming and outgoing packets. By default, all interfaces that are enabled for multicast are eligible to participate in a multicast flow provided they meet the multicast routing protocol’s criteria for participating in a flow. 192 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 IPv6 Multicast Protocols Configuration considerations ∙ Only one ACL can be bound to any interface. ∙ Normal ACL restrictions apply as to how many software ACLs can be created, but there is no hardware restrictions on ACLs with this feature. ∙ Creation of a static MLD client is allowed for a group on a port that may be prevented from participation in the group on account of an ACL bound to the port’s interface. In such a situation, the ACL would prevail and the port will not be added to the relevant entries. ∙ Either standard or extended ACLs can be used with the multicast boundary feature. When a standard ACL is used, the address specified is treated as a group address and NOT a source address. ∙ When a boundary is applied to an ingress interface, all packets destined to a multicast group that is filtered out will be dropped by software. Currently, there is no support to drop such packets in hardware. ∙ The ipv6 multicast-boundary command may not stop clients from receiving multicast traffic if the filter is applied on the egress interface up-stream from RP. Configuring multicast boundaries To define boundaries for PIM enabled interfaces, enter commands such as the following. device(config)# interface ethernet 1/1/2 device(config-if-e1000-1/1/2)#ipv6 multicast-boundary MyBrocadeAccessList Syntax: [no] ipv6 multicast-boundary acl-spec Use the acl-spec parameter to define the number or name identifying an access list that controls the range of group addresses affected by the boundary. Use the no ipv6 multicast boundary command to remove the boundary on a PIM enabled interface. The ACL, MyBrocadeAccessList can be configured using standard ACL syntax. Some examples of how ACLs can be used to filter multicast traffic are as follows: ACL to permit multicast traffic To permit multicast traffic for group ff1e::300 and deny all other traffic, enter the following commands. Brocade(config)# ipv6 access-list abc Brocade(config-ipv6-access-list abc)# permit ipv6 any host ff1e::300 Brocade(config-ipv6-access-list abc)# deny ipv6 any any To permit multicast data traffic from source 5555::14 for group ff55::5514 and deny all other traffic, enter the following commands. Brocade(config)# ipv6 access-list ex2 Brocade(config-ipv6-access-list ex2)# permit ipv6 host 5555::14 host ff55::5514 Brocade(config-ipv6-access-list ex2)# deny ipv6 any any ACL to deny multicast traffic To deny multicast data traffic for group ff55::55 and permit all other traffic, enter the following commands. Brocade(config)# ipv6 access-list ex1 Brocade(config-ipv6-access-list ex1)# deny ipv6 any host ff55::55 Brocade(config-ipv6-access-list ex1)# permit ipv6 any any FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03 193 IPv6 Multicast Protocols Displaying multicast boundaries To display multicast boundary information, use the show ipv6 pim interface command. In this example, abc is the name of the access list. Device# show ipv6 pim interface ethernet 1/1/7 Flags : SM - Sparse Mode v2 ---------+---------------------------------------------------+----+---+---+---------+ Interface|Global Address |Mode|St |TTL|Multicast| | + Designated Router Port | | |Thr|Boundary | ---------+---------------------------------------------------+----+---+---+---------+ e1/1/1 a141::1 SM Ena 1 abc [output continued] -------+---------------VRF | DR | Override | Prio | Interval -------+---------------default 1 3000ms + Itself Total Number of Interfaces : 1 194 FastIron Ethernet Switch IP Multicast Configuration Guide 53-1003626-03
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.6 Linearized : Yes Author : Brocade Create Date : 2016:05:22 20:00:28-08:00 Modify Date : 2016:05:23 13:14:32+05:30 Language : EN-US XMP Toolkit : Adobe XMP Core 5.4-c005 78.147326, 2012/08/23-13:03:03 Format : application/pdf Creator : Brocade Title : FastIron Ethernet Switch IP Multicast Configuration Guide version 08.0.30 Creator Tool : AH XSL Formatter V6.2 MR12 for Windows (x64) : 6.2.14.22278 (2015/10/30 10:00JST) Metadata Date : 2016:05:23 13:14:32+05:30 Producer : Antenna House PDF Output Library 6.2.726 (Windows (x64)) Trapped : False Document ID : uuid:32fcc27d-19de-4009-ae1f-65a70430006a Instance ID : uuid:9acf5920-fb58-48ef-b002-05869495f630 Page Mode : UseOutlines Page Count : 194EXIF Metadata provided by EXIF.tools