Brocade Vyatta Network OS Multicast Routing Configuration Guide, 5.2R1

Transcription

1 CONFIGURATION GUIDE Brocade Vyatta Network OS Multicast Routing Configuration Guide, 5.2R1 Supporting Brocade 5600 vrouter, VNF Platform, and Distributed Services Platform October 2016

2 2016, Brocade Communications Systems, Inc. All Rights Reserved. Brocade, the B-wing symbol, and MyBrocade are registered trademarks of Brocade Communications Systems, Inc., in the United States and in other countries. Other brands, product names, or service names mentioned of Brocade Communications Systems, Inc. are listed at brocade-legal-intellectual-property/brocade-legal-trademarks.html. Other marks may belong to third parties. 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

3 Contents Preface...5 Document conventions...5 Notes, cautions, and warnings...5 Text formatting conventions... 5 Command syntax conventions...6 Brocade resources...6 Document feedback...6 Contacting Brocade Technical Support... 7 Brocade customers...7 Brocade OEM customers... 7 About This Guide...9 Multicast Routing Overview IP multicast Multicast channels Multicast addresses...12 Multicast routing protocols...12 Types of multicast...12 Internet standard multicast...13 Source-specific multicast...13 Supported standards RFCs MIBs...14 Multicast Configuration...15 Before you begin...15 Basic PIM-SM multicast configuration...15 Configure R Configure R Configure RP Multicast Routing Commands clear ip mroute statistics...22 clear ipv6 mroute statistics interfaces <interface> ip multicast ttl-threshold <ttl> monitor command <mtrace-command>...25 monitor protocol multicast mtrace <host>...28 protocols multicast ip log...30 protocols multicast ipv6 log...32 protocols multicast ip log-warning <warning-limit> protocols multicast ip route-limit <route-limit> protocols multicast ip routing...36 protocols multicast ipv6 log-warning <warning-limit>...37 protocols multicast ipv6 route-limit <route-limit>...38 protocols multicast ipv6 routing...39 reset ip mroute

4 reset ipv6 mroute...41 show ip mroute...42 show ip multicast interface...44 show ip multicast mrinfo <host>...45 show ip rpf <source> show ipv6 mroute show ipv6 multicast interface...49 show ipv6 rpf <source>...50 show monitoring protocols multicast...51 Supported Data Plane Interfaces...53 VRF Support...55 VRF support for multicast...55 Command support for VRF routing instances Adding a VRF routing instance to a Configuration mode command Adding a VRF routing instance to an Operational mode command...57 List of Acronyms

5 Preface Document conventions... 5 Brocade resources... 6 Document feedback... 6 Contacting Brocade Technical Support...7 Document conventions The document conventions describe text formatting conventions, command syntax conventions, and important notice formats used in Brocade technical documentation. 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. Text formatting conventions Text formatting conventions such as boldface, italic, or Courier font may be used to highlight specific words or phrases. Format bold text Description Identifies command names. Identifies keywords and operands. Identifies the names of GUI elements. italic text Identifies text to enter in the GUI. Identifies emphasis. Identifies variables. Courier font Identifies document titles. Identifies CLI output. Identifies command syntax examples

6 Brocade resources Command syntax conventions Bold and italic text identify command syntax components. Delimiters and operators define groupings of parameters and their logical relationships. Convention bold text italic text value Description Identifies command names, keywords, and command options. Identifies a variable. 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. x y In Fibre Channel products, square brackets may be used instead for this purpose. A vertical bar separates mutually exclusive elements. < > Nonprinting characters, for example, passwords, are enclosed in angle brackets.... 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. Brocade resources Visit the Brocade website to locate related documentation for your product and additional Brocade resources. White papers, data sheets, and the most recent versions of Brocade software and hardware manuals are available at Product documentation for all supported releases is available to registered users at MyBrocade. Click the Support tab and select Document Library to access documentation on MyBrocade or You can locate documentation by product or by operating system. Release notes are bundled with software downloads on MyBrocade. Links to software downloads are available on the MyBrocade landing page and in the Document Library. Document feedback 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 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

7 Contacting Brocade Technical Support Contacting Brocade Technical Support As a Brocade customer, you can contact Brocade Technical Support 24x7 online, by telephone, or by . Brocade OEM customers should contact their OEM/solution provider. Brocade customers For product support information and the latest information on contacting the Technical Assistance Center, go to and select Support. If you have purchased Brocade product support directly from Brocade, use one of the following methods to contact the Brocade Technical Assistance Center 24x7. Online Telephone Preferred method of contact for non-urgent issues: Case management through the MyBrocade portal. Quick Access links to Knowledge Base, Community, Document Library, Software Downloads and Licensing tools Required for Sev 1-Critical and Sev 2-High issues: Continental US: Europe, Middle East, Africa, and Asia Pacific: +800-AT FIBREE ( ) Toll-free numbers are available in many countries. For areas unable to access a toll-free number: support@brocade.com 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

8

9 About This Guide This guide describes how to enable and configure multicast routing on Brocade products that run on the Brocade Vyatta Network OS (referred to as a virtual router, vrouter, or router in the guide)

10

11 Multicast Routing Overview IP multicast...11 Multicast channels...11 Multicast addresses Multicast routing protocols...12 Types of multicast Supported standards...13 IP multicast There are four types of transmission over a network: Unicast In unicast transmission, a single sender transmits a message to a single receiver (one-to-one). Unicast transmission is signaled to the network by using an IP address in the unicast range. Unicast transmission is supported in both IPv4 and IPv6. Broadcast In broadcast transmission, a sender transmits a message to all possible destinations ( all-hosts on this subnet ) and all receivers receive a copy of the message (one-to-many). In IPv4, broadcast transmission is signaled to the network by using the broadcast address or a directed broadcast address formed from the network prefix but using all binary 1s for the host portion of the address. Broadcast transmission is not supported in IPv6; instead, IPv6 defines the all-nodes multicast address. Multicast In multicast transmission, a group of receivers interested in a particular stream forms a group (one-to-many). The sender sends the message from its unicast address to the multicast group address. The network routers are responsible for propagating the message to all interested receivers. Multicast groups are identified using a special range of addresses. In IPv4, the former class D addresses compose the multicast range of addresses. In IPv6, multicast addresses are identified from the prefix FF00::/8. Anycast In anycast transmission, a message from a single sender is sent to the topologically closest node in a group of potential receivers (one-to-one-of-many). Anycast is used in network load balancing and in certain network protocols, such as Domain Name System (DNS). IP multicast uses multicast transmission over the IP infrastructure, transmitting to a multicast address at the IP routing level. Networks using IP multicast deliver content to multiple users in various groups for example, IP multicast is often used for content delivery such as streaming media and IPTV. IP multicast is described in RFC 1112, Host Extensions for IP Multicasting. NOTE For specific information about the Internet Group Management Protocol (IGMP) and the Multicast Listener Discovery (MLD) protocol, see Brocade Vyatta Network OS IGMP and MLD Configuration Guide. For specific information about Protocol Independent Multicast (PIM), see Brocade Vyatta Network OS PIM Configuration Guide. For specific information about Multicast Source Discovery Protocol (MSDP), see Brocade Vyatta Network OS MSDP Configuration Guide. Multicast channels To receive a particular multicast data stream, hosts join a multicast group. The group is identified by its multicast address. The communication between the host and router for this purpose is managed by using the Internet Group Management Protocol (IGMP). Hosts send an IGMP Join message to their local multicast router, signaling their intention to join the group (G), as represented by a multicast address. The source device (S) that delivers the content sends the message addressed to the multicast address of G. The

12 Multicast addresses multicast channel is the combination of the IP address of the content source and multicast address of the group called an (S, G) pair. For messages for which the source can be any device, the S is replaced by the asterisk wildcard ( * ), which means any source. Multicast addresses For IPv4, addresses in the range to are reserved for multicasting. In the classful addressing system, this is registered as class D. In the Classless Inter-Domain Routing (CIDR) addressing model, the prefix of this group is /4. Within the IPv4 multicast range, address assignments are specified in RFC 5771, IANA Guidelines for IPv4 Multicast Address Assignments. Table 1 lists a summary of these assignments. Note that, of these addresses, the network address is guaranteed not to be assigned to any group. TABLE 1 Multicast address assignments Addresses Usage Link Local Scope All systems on this subnet All routers on this subnet All PIM routers address group Global Scope to Allocated for multicast traffic across the Internet. SSM reserves the range /8. The addresses and are used for Auto-RP negotiation. You can assign the remaining IP addresses to your ISM applications. Administrative Scope (AS) /8 Allocated for organizations that own an AS number to multicast across the Internet. The AS number of the organization is embedded in the second and third octets of the multicast IP address. For example, AS64501 is 0xFBF5, with FB and F5 (or 251 and 245 in decimal) representing the second and third octets of the IP address, respectively. The resulting subnet is globally reserved for AS64201 to use. These addresses are called GLOP addresses. For IPv6, multicast addressing is specified in RFC 3513, IP Version 6 Addressing Architecture. In essence, IPv6 multicast addresses are derived from the FF00::/8 prefix. Multicast routing protocols The multicast routing protocols supported by the Brocade vrouter are IGMP, Multicast Listener Discovery (MLD), and Protocol Independent Multicast (PIM). IGMP controls multicast communication between hosts and multicast routers on IPv4 networks, allowing hosts to manage membership of multicast groups. MLD performs this function on IPv6 networks. PIM controls multicast communication between multicast routers, so that they can track packet distribution. Types of multicast In IP networks, multicast information is propagated through the use of distribution trees created by the multicast routers. Routers create source trees that provide the shortest path to each destination; these trees are called shortest path trees (SPTs). The source of the multicast message is always the root of an SPT

13 Supported standards Multicast depends on which of two models of multicast is in effect: Internet standard multicast on page 13 Source-specific multicast on page 13 Internet standard multicast In Internet Standard Multicast (ISM), a receiver can receive messages from any source and from multiple sources. In ISM, receivers are not aware of sources; they express interest in receiving a traffic stream by subscribing to the group of interest (G). In the ISM model, the multicast router discovers and tracks all multicast sources that are sending messages to an address, maintaining information about all sources, and routing data from all sources to all interested receivers. The router does this by maintaining a state table of (S, G) entries. When the number of sources is large, the burden on the multicast router can become heavy. Source-specific multicast In Source-Specific Multicast (SSM), receivers are aware of sources. A receiver explicitly requests a stream from a sender in a group the receiver has joined, using a Join message that specifies the source (an (S, G) Join), and explicitly excludes the use of the wildcard for source that is, it disallows the (*, G) Join. Because SSM-enabled hosts track sources of the multicast transmission themselves, multicast routers do not need to discover the multicast sources themselves, and they need to store and maintain only the (*, G) state in the multicast routing table. This greatly reduces the burden on the multicast router. For IPv4, the destination addresses must be in the range /8. For IPv6, the addresses must be in the range FF3x::/96. SSM is specified in RFC 3569, An Overview of Source-Specific Multicast (SSM) and RFC 4607, Source-Specific Multicast for IP. Supported standards This section presents the following topics: RFCs RFCs on page 13 MIBs on page 14 The Brocade Communications Systems, Inc. implementation of multicast routing complies with the following standards: RFC 1112: Host Extensions for IP Multicasting RFC 2236: Internet Group Management Protocol, Version 2 RFC 2710: Multicast Listener Discovery (MLD) for IPv6 RFC 3376: Internet Group Management Protocol, Version 3 RFC 3569: An Overview of Source-Specific Multicast (SSM) RFC 3810: Multicast Listener Discovery version 2 (MLDv2) for IPv6 RFC 4604: Using Internet Group Management Protocol Version 3 (IGMPv3) and Multicast Listener Discovery Protocol Version 2 (MLDv2) for Source-Specific Multicast RFC 4607: Source-Specific Multicast for IP

14 Supported standards MIBs The Vyatta implementation of multicast routing supports the following Simple Management Network Protocol (SNMP) management information bases (MIBs). IGMP-MIB, RFC2933: Internet Group Management Protocol MIB IPMROUTE, RFC 2932: IPv4 Multicast Routing MIB MLD-MIB, RFC 3019: IP Version 6 Management Information Base for The Multicast Listener Discovery Protocol For a list of all MIBs supported on the Brocade vrouter, see Brocade Vyatta Network OS Remote Management Configuration Guide

15 Multicast Configuration Before you begin...15 Basic PIM-SM multicast configuration...15 Before you begin It is assumed that routers depicted in the examples that follow are configured to provide basic connectivity. This configuration includes the host-name, Ethernet, or data plane interfaces, and gateway-address. See Brocade Vyatta Network OS vrouter Quick Start Guide for information on basic system configuration. NOTE In the Brocade vrouter, a data plane interface is an abstraction that represents the underlying physical or virtual Ethernet interface of the system. The terms Ethernet interface and data plane interface are synonymous in this guide. Basic PIM-SM multicast configuration This section presents a configuration example that provides PIM sparse mode multicast capability between the sender of multicast traffic (Source) and a receiver of multicast traffic (Receiver). Three routers are configured for this example: R1, R2 and RP. R1 and R2 are configured for PIM sparse mode operation and point to RP as the rendezvous point router. RP is configured as the rendezvous point router. NOTE It is assumed that the Sender and Receiver contain software to send and receive multicast traffic. When you have finished the example, these systems will be configured as shown in the following figure

16 Basic PIM-SM multicast configuration FIGURE 1 Basic PIM-SM multicast setup Configure R1 The multicast network in the example extends from R1 through the /24 LAN segment to R2 and RP. In this example, you configure R1 for PIM sparse mode multicast operation. Table 2 creates a PIM sparse mode multicast configuration on R1. TABLE 2 Creating a PIM sparse mode configuration on R1 Step Configure PIM sparse mode on dp0p1p1. Command vyatta@r1# set interfaces dataplane dp0p1p1 ip pim mode sparse

17 Basic PIM-SM multicast configuration TABLE 2 Creating a PIM sparse mode configuration on R1 (continued) Step Command Commit the configuration. vyatta@r1# commit View the configuration. Configure PIM sparse mode on dp0p1p2. Commit the configuration. View the configuration. Configure multicast routing. Specify the location of the rendezvous point router. Commit the configuration. View the configuration. vyatta@r1# show interfaces dataplane dp0p1p1 ip pim { mode sparse vyatta@r1# set interfaces dataplane dp0p1p2 ip pim mode sparse vyatta@r1# commit vyatta@r1# show interfaces dataplane dp0p1p2 ip pim { mode sparse vyatta@r1# set protocols multicast ip routing vyatta@r1# set protocols pim rp-address vyatta@r1# commit vyatta@r1# show protocols multicast { ip { routing { pim { rp-address { Configure R2 The multicast network in the example extends from R1 through the /24 LAN segment to R2 and RP. In this example, you configure R2 for PIM sparse mode multicast operation. Table 3 creates a PIM sparse mode multicast configuration on R2. TABLE 3 Creating a PIM sparse mode configuration on R2 Step Configure PIM sparse mode on dp0p1p1. Commit the configuration. View the configuration. Command vyatta@r2# set interfaces dataplane dp0p1p1 ip pim mode sparse vyatta@r2# commit vyatta@r2# show interfaces dataplane dp0p1p1 ip pim {

18 Basic PIM-SM multicast configuration TABLE 3 Creating a PIM sparse mode configuration on R2 (continued) Step Command mode sparse Configure PIM sparse mode on dp0p1p2. Commit the configuration. View the configuration. Configure multicast routing. Specify the location of the rendezvous point router. Commit the configuration. View the configuration. vyatta@r2# set interfaces dataplane dp0p1p2 ip pim mode sparse vyatta@r2# commit vyatta@r2# show interfaces dataplane dp0p1p2 ip pim { mode sparse vyatta@r2# set protocols multicast ip routing vyatta@r2# set protocols pim rp-address vyatta@r2# commit vyatta@r2# show protocols multicast { ip { routing { pim { rp-address { Configure RP The multicast network in the example extends from R1 through the /24 LAN segment to R2 and RP. In this example, you configure RP for PIM sparse mode multicast operation. Table 4 creates a PIM sparse mode multicast configuration on RP. TABLE 4 Creating a PIM sparse mode configuration on RP Step Configure PIM sparse mode on dp0p1p1. Commit the configuration. View the configuration. Configure multicast routing. Command vyatta@rp# set interfaces dataplane dp0p1p1 ip pim mode sparse vyatta@rp# commit vyatta@rp# show interfaces dataplane dp0p1p1 ip pim { mode sparse vyatta@rp# set protocols multicast ip routing

19 Basic PIM-SM multicast configuration TABLE 4 Creating a PIM sparse mode configuration on RP (continued) Step Command Specify the location of the rendezvous point router. vyatta@rp# set protocols pim rp-address Commit the configuration. View the configuration. vyatta@rp# commit vyatta@rp# show protocols multicast { ip { routing { pim { rp-address {

20

21 Multicast Routing Commands clear ip mroute statistics clear ipv6 mroute statistics interfaces <interface> ip multicast ttl-threshold <ttl>...24 monitor command <mtrace-command> monitor protocol multicast...26 mtrace <host> protocols multicast ip log protocols multicast ipv6 log protocols multicast ip log-warning <warning-limit>...34 protocols multicast ip route-limit <route-limit>...35 protocols multicast ip routing...36 protocols multicast ipv6 log-warning <warning-limit> protocols multicast ipv6 route-limit <route-limit> protocols multicast ipv6 routing reset ip mroute...40 reset ipv6 mroute...41 show ip mroute show ip multicast interface...44 show ip multicast mrinfo <host> show ip rpf <source>...46 show ipv6 mroute...47 show ipv6 multicast interface show ipv6 rpf <source>...50 show monitoring protocols multicast

22 clear ip mroute statistics clear ip mroute statistics Syntax Clears IPv4 statistics for multicast routing. clear ip mroute statistics [ group group [ source source ] ] Command Default When used with no option, this command clears all IPv4 statistics for multicast routing. Parameters group Clears statistics for the specified IPv4 multicast group in IPv4 multicast address format. source Used in source-specific multicast. Clears statistics for the specified IPv4 multicast source. The format is an IPv4 multicast address. Modes Operational mode Usage Guidelines Use this command to clear statistics for multicast routing

23 clear ipv6 mroute statistics clear ipv6 mroute statistics Syntax Clears IPv6 statistics for multicast routing. clear ipv6 mroute statistics [ group group [ source source ] ] Command Default When used with no option, this command clears all IPv6 statistics for multicast routing. Parameters group group Clears statistics for the specified IPv6 multicast group. The format is an IPv6 multicast address. source source Used in source-specific multicast. Clears statistics for the specified IPv6 multicast source. The format is an IPv6 multicast address. Modes Operational mode Usage Guidelines Use this command to clear IPv6 statistics for multicast routing

24 interfaces <interface> ip multicast ttl-threshold <ttl> interfaces <interface> ip multicast ttl-threshold <ttl> Syntax Sets the time-to-live (TTL) threshold for multicast packets. set interfaces interface ip multicast ttl-threshold ttl delete interfaces interface ip multicast ttl-threshold show interfaces interface ip multicast ttl-threshold Command Default The TTL for multicast packets is 0. The default value 0 means that all multicast packets are forwarded out to the interface. Parameters interface The type keyword and identifier of an interface. For detailed keywords and arguments that can be specified as interfaces, refer to Supported Data Plane Interfaces on page 53. ttl The TTL value is the hop count. The range is 0 through 255. The default is 0. Modes Configuration mode Configuration Statement interfaces interface { ip { multicast { ttl-threshold ttl Usage Guidelines Use this command to configure the TTL threshold for multicast packets being forwarded from the specified interface. Only multicast packets with a TTL value greater than the threshold are forwarded. Use the set form of this command to configure the multicast TTL value. Use the delete form of this command to restore the default TTL value for multicast. Use the show form of this command to show multicast TTL configuration

25 monitor command <mtrace-command> monitor command <mtrace-command> Syntax Monitors an mtrace command. monitor command mtrace-command run monitor command mtrace-command Parameters Modes mtrace-command The mtrace command to be monitored. The mtrace command must be enclosed in quotation marks. Operational mode. Configuration mode Usage Guidelines Use this command to display the output of an mtrace command. The session stays open and display information is refreshed every two seconds. Use the run form of this command in configuration mode

26 monitor protocol multicast monitor protocol multicast Syntax Sets debugging options for multicast routing. monitor protocol multicast [ [ background { start stop ] { enable disable { ip ipv6 [ event fib-msg mrib-msg mrt mtrace mtrace-detail nsm-msg register-msg stats vif ] ] Command Default Multicast debugging is disabled. Parameters background Performs debugging operations in the background. start stop enable disable ip ipv6 event Starts debugging in the background. Stops debugging in the background. Enables the specified debugging option. Disables the specified debugging option. Specifies IPv4 multicast debugging. Specifies IPv6 multicast debugging. Displays debugging messages for multicast events. fib-msg Reports all forwarding information base messages. mrib-msg Reports all multicast routing information base messages. mrt mtrace Displays debugging messages for multicast routes. Displays multicast traceroute debugging. mtrace-detail Displays detailed multicast traceroute debugging. nsm-msg Reports all Network Services Module messages

27 monitor protocol multicast register-msg Reports all Protocol Independent Multicast (PIM) register messages. stats vif Displays debugging messages for multicast statistics. Displays debugging messages for multicast-enabled vif interfaces. Modes Operational mode Usage Guidelines Examples Use this command to enable or disable debugging for multicast and to configure multicast debugging options. The following example starts debugging in the background for IPv4 multicast events. protocol multicast enable ip event The following example disables all IPv6 multicast debugging. protocol multicast disable ipv

28 mtrace <host> mtrace <host> Syntax Displays the route that packets take from a multicast source. set mtrace host [ destination addr [ group group [ detail ] detail ] group group [ destination addr [ detail ] detail ] detail ] Command Default Output shows routes from the source host to the host on which the command is entered. Parameters host The host that is the source for the trace. The host is either a name (if DNS is being used on the network) or an IPv4 or IPv6 unicast address. addr group detail The host that is the destination for the trace. The host is either an IPv4 or IPv6 unicast address. The multicast group to trace. The format is an IPv4 or IPv6 multicast address. Displays detailed output. This output includes IP multicast packet-rate and packet-loss information. Modes Operational mode Usage Guidelines Use this command to show the path from a source to a receiver in a multicast network

29 mtrace <host> Examples The following example displays a trace from through using group vyatta@vyatta:~$mtrace destination group Mtrace from to via group Querying full reverse path... 0? ( ) -1? ( ) PIM thresh^ 1 RPF interface -2? ( ) PIM thresh^ 1-3? ( ) Round trip time 1 ms The following example displays a detailed trace from through using group vyatta@vyatta:~$mtrace destination group detail Mtrace from to via group Round trip time 0 ms Waiting to accumulate statistics... Results after 10 seconds: Source Response Dest Packet Statistics For Only For Traffic All Multicast Traffic From v / rtt 0 ms Lost/Sent = Pct Rate To v ^ ttl pps 0 0 pps RPF interface v \ ttl Receiver Query Source

30 protocols multicast ip log protocols multicast ip log Syntax Enables IPv4 MRIB logs. set protocols multicast ip log { all event fib-msg mrib-msg mrt mtrace mtrace-detail nsm-msg register-msg stats vif delete protocols multicast ip log { all event fib-msg mrib-msg mrt mtrace mtrace-detail nsm-msg register-msg stats vif show protocols multicast ip log { all event fib-msg mrib-msg mrt mtrace mtrace-detail nsm-msg register-msg stats vif Command Default None Parameters all Enables MRIB debugging for all multicast protocol parameters. event Enables MRIB debugging for all multicast events. fib-msg Enables MRIB debugging for only multicast FIB events. mrib-msg Enables MRIB debugging for only multicast RIB events. mrt mtrace Enables MRIB debugging for multicast routes. Enables MRIB debugging for multicast trace routes. mtrace-detail Enables MRIB debugging for multicast traceroute messages. nsm-msg Enables MRIB debugging for multicast NSM messages. register-msg Enables MRIB debugging for multicast PIM register messages. stats vif Enables MRIB debugging for multicast statistics. Enables MRIB debugging for multicast virtual interfaces. Modes Configuration mode

31 protocols multicast ip log Configuration Statement protocols { multicast ip { log { all event fib-msg mrib-msg mrt mtrace mtrace-detail nsm-msg register-msg stats vif Usage Guidelines Use the set form of this command to enable IPv4 multicast routing information base (MRIB) logs. Use the delete form of this command to remove IPv4 MRIB logs. Use the show form of this command to view IPv4 MRIB logs

32 protocols multicast ipv6 log protocols multicast ipv6 log Syntax Enables IPv6 MRIB logs. set protocols multicast ipv6 log { all event fib-msg mrib-msg mrt mtrace mtrace-detail nsm-msg register-msg stats vif delete protocols multicast ipv6 log { all event fib-msg mrib-msg mrt mtrace mtrace-detail nsm-msg register-msg stats vif show protocols multicast ipv6 log { all event fib-msg mrib-msg mrt mtrace mtrace-detail nsm-msg register-msg stats vif Command Default None Parameters all Enables MRIB debugging for all multicast protocol parameters. event Enables MRIB debugging for all multicast events. fib-msg Enables MRIB debugging for only multicast FIB events. mrib-msg Enables MRIB debugging for only multicast RIB events. mrt mtrace Enables MRIB debugging for multicast routes. Enables MRIB debugging for multicast trace routes. mtrace-detail Enables MRIB debugging for multicast traceroute messages. nsm-msg Enables MRIB debugging for multicast NSM messages. register-msg Enables MRIB debugging for multicast PIM register messages. stats vif Enables MRIB debugging for multicast statistics. Enables MRIB debugging for multicast virtual interfaces. Modes Configuration mode

33 protocols multicast ipv6 log Configuration Statement protocols { multicast ipv6 { log { all event fib-msg mrib-msg mrt mtrace mtrace-detail nsm-msg register-msg stats vif Usage Guidelines Use the set form of this command to enable IPv6 multicast routing information base (MRIB) logs. Use the delete form of this command to remove IPv6 MRIB logs. Use the show form of this command to view IPv6 MRIB logs

34 protocols multicast ip log-warning <warning-limit> protocols multicast ip log-warning <warning-limit> Syntax Sets a warning threshold for IPv4 multicast routes. set protocols multicast ip log-warning warning-limit delete protocols multicast ip log-warning show protocols multicast ip log-warning Command Default If this value is not configured, the system issues a warning only when the maximum number of routes has been reached. Parameters Modes warning-limit The number of IPv4 multicast routes that causes the system to generate a warning. The value configured for this argument must not exceed the value set for the maxmimum route limit that is configured by using the protocols multicast ip route-limit route-limit command. The range is 1 through Configuration mode Configuration Statement protocols { multicast { ip { log-warning warning-limit Usage Guidelines Use this command to configure the warning threshold for IPv4 routes in the multicast routing table. When this limit is exceeded, the system continues to generate a message until the maximum number of multicast routes is reached that is configured by using the protocols multicast ip route-limit route-limit command. Use the set form of this command to configure the warning threshold for IPv4 multicast routes. Use the delete form of this command to restore the default IPv4 warning threshold. Use the show form of this command to show the IPv4 warning threshold configuration

35 protocols multicast ip route-limit <route-limit> protocols multicast ip route-limit <route-limit> Syntax Sets the maximum number of IPv4 routes that can be added to the multicast routing table. set protocols multicast ip route-limit route-limit delete protocols multicast ip route-limit show protocols multicast ip route-limit Command Default The maximum number of IPv4 multicast routes is 2,147,483,647. Parameters Modes route-limit The maximum number of IPv4 routes that can be added to the multicast routing table. The value configured for this argument must be greater than or equal to the log warning limit that is configured by using the protocols multicast ip log-warning warning-limit command. The range is 1 through Configuration mode Configuration Statement protocols { multicast { ip { route-limit route-limit Usage Guidelines Use this command to limit the number of IPv4 routes that can be added to the multicast routing table. Use the set form of this command to specify the IPv4 multicast route limit. Use the delete form of this command to restore the default IPv4 multicast route limit. Use the show form of this command to show the IPv4 multicast route limit configuration

36 protocols multicast ip routing protocols multicast ip routing Syntax Enables IPv4 multicast routing. set protocols multicast ip routing delete protocols multicast ip routing show protocols multicast ip routing Command Default Modes IPv4 multicast routing is disabled. Configuration mode Configuration Statement protocols { multicast { ip { routing { Usage Guidelines Use this command to enable the system to use multicast routing protocols for IPv4 traffic. When this configuration node is deleted, multicast routing protocols such as the Internet Group Management Protocol (IGMP) and Protocol Independent Multicast (PIM) do not work for IPv4 traffic, even if configured. Use the set form of this command to enable multicast routing. Use the delete form of this command to remove the multicast routing configuration. Use the show form of this command to display the multicast routing configuration

37 protocols multicast ipv6 log-warning <warning-limit> protocols multicast ipv6 log-warning <warning-limit> Syntax Sets the warning threshold for IPv6 multicast routes. set protocols multicast ipv6 log-warning warning-limit delete protocols multicast ipv6 log-warning show protocols multicast ipv6 log-warning Command Default If this value is not configured, the system issues a warning only when the maximum number of routes has been reached. Parameters Modes warning-limit The number of IPv6 multicast routes that causes the system to generate a warning. The value configured for this argument must not exceed the value set for the maximum route limit that is configured by using the protocols multicast ipv6 route-limit route-limit command. The range is 1 through Configuration mode Configuration Statement protocols { multicast { ipv6 { log-warning warning-limit Usage Guidelines Use this command to configure the warning threshold for IPv6 routes in the multicast routing table. When this limit is exceeded, the system continues to generate a message until the maximum number of multicast routes is reached that is configured by using the protocols multicast ipv6 route-limit route-limit command. Use the set form of this command to configure the IPv6 warning threshold. Use the delete form of this command to restore the default IPv6 warning threshold. Use the show form of this command to show the IPv6 warning threshold configuration

38 protocols multicast ipv6 route-limit <route-limit> protocols multicast ipv6 route-limit <route-limit> Syntax Sets the maximum number of IPv6 routes that can be added to the multicast routing table. set protocols multicast ipv6 route-limit route-limit delete protocols multicast ipv6 route-limit show protocols multicast ipv6 route-limit Command Default The maximum number of IPv6 multicast routes is 2,147,483,647. Parameters Modes route-limit The maximum number of IPv6 routes that can be added to the multicast routing table. The value configured for this argument must be greater than or equal to the log warning limit that is configured by using the protocols multicast ip log-warning warning-limit command. The range is 1 through Configuration mode Configuration Statement protocols { multicast { ip { route-limit route-limit Usage Guidelines Use this command to limit the number of IPv6 routes that can be added to the multicast routing table. Use the set form of this command to specify the IPv6 multicast route limit. Use the delete form of this command to restore the default IPv6 multicast route limit. Use the show form of this command to show the IPv6 multicast route limit configuration

39 protocols multicast ipv6 routing protocols multicast ipv6 routing Syntax Enables IPv6 multicast routing. set protocols multicast ipv6 routing delete protocols multicast ipv6 routing show protocols multicast ipv6 routing Command Default Modes IPv6 multicast routing is disabled. Configuration mode Configuration Statement protocols { multicast { ipv6 { routing { Usage Guidelines Use this command to enable the system to use multicast routing protocols for IPv6 traffic. When this configuration is deleted, multicast routing protocols such as the Multicast Listener Discovery (MLD) and PIM do not work for IPv6 traffic, even if configured. Use the set form of this command to enable IPv6 multicast routing. Use the delete form of this command to remove IPv6 multicast routing configuration. Use the show form of this command to display the IPv6 multicast routing configuration

40 reset ip mroute reset ip mroute Syntax Removes IPv4 entries from the multicast routing information base of the specified group. reset ip mroute [ group group [ source source ] ] Command Default When used with no option, this command deletes all routes from the multicast routing information base. Parameters group The IPv4 multicast group in IPv4 multicast address format. Routes are removed for the specified group. source Used in source-specific multicast. Removes routes for the specified IPv4 multicast source. The format is an IPv4 multicast address. Modes Operational mode Usage Guidelines Use this command to remove IPv4 routes from the multicast routing and forwarding information bases. Each multicast routing protocol has a distinct command for clearing multicast routes from the routing table for the protocol

41 reset ipv6 mroute reset ipv6 mroute Syntax Removes IPv6 entries from the multicast routing information base. reset ipv6 mroute [ group group [ source source ] ] Command Default When used with no option, this command deletes all routes from the multicast routing information base. Parameters group group Removes IPv6 routes for the specified multicast group. The format is an IPv6 multicast address. source source Used in source-specific multicast. Shows multicast routes for the specified IPv6 multicast source. The format is an IPv6 address. Modes Operational mode Usage Guidelines Use this command to remove IPv6 routes from the multicast routing and forwarding information bases. Each multicast routing protocol has a distinct command for clearing multicast routes from the routing table for the protocol

42 show ip mroute show ip mroute Syntax Displays the IPv4 multicast routing table. show ip mroute [ group group [ source source ] ] [ dense sparse count summary ] Command Default When used with no option, this command displays information for the complete IPv4 multicast routing table. Parameters group group Shows IPv4 multicast routes for the specified multicast group. The format is an IPv4 multicast address. source source Used in source-specific multicast. Shows multicast routes for the specified IPv4 multicast source. The format is an IPv4 multicast address. dense sparse count Shows dense-mode IPv4 multicast routes. Shows sparse-mode IPv4 multicast routes. Shows IPv4 multicast-route and packet-count information. summary Shows abbreviated IPv4 multicast route information. Modes Operational mode Usage Guidelines Use this command to display the IPv4 multicast routing table

43 show ip mroute Examples The following example shows how to display an IPv4 multicast routing table. ip mroute IP Multicast Routing Table Flags: I - Immediate Stat, T - Timed Stat, F - Forwarder installed Timers: Uptime/Stat Expiry Interface State: Interface (TTL) ( , ), uptime 00:00:31, stat expires 00:02:59 Owner PIM-SM, Flags: TF Incoming interface: wm0 Outgoing interface list: wm1 (1) vyatta@vyatta:~$ The following example shows how to display routes for multicast group and source vyatta@vyatta:~$show ip mroute group source IP Multicast Routing Table Flags: I - Immediate Stat, T - Timed Stat, F - Forwarder installed Timers: Uptime/Stat Expiry Interface State: Interface (TTL) ( , ), uptime 00:03:24, stat expires 00:01:28 Owner PIM-SM, Flags: TF Incoming interface: wm0 Outgoing interface list: wm1 (1)vyatta@vyatta:~$ The following example shows how to display packet counts for multicast routes. vyatta@vyatta:~$show ip mroute count IP Multicast Statistics Total 1 routes using 132 bytes memory Route limit/route threshold: / Total NOCACHE/WRONGVIF/WHOLEPKT recv from fwd: 1/0/0 Total NOCACHE/WRONGVIF/WHOLEPKT sent to clients: 1/0/0 Immediate/Timed stat updates sent to clients: 0/0 Reg ACK recv/reg NACK recv/reg pkt sent: 0/0/0 Next stats poll: 00:01:10 Forwarding Counts: Pkt count/byte count, Other Counts: Wrong If pkts Fwd msg counts: WRONGVIF/WHOLEPKT recv Client msg counts: WRONGVIF/WHOLEPKT/Imm Stat/Timed Stat sent Reg pkt counts: Reg ACK recv/reg NACK recv/reg pkt sent ( , ), Forwarding: 2/19456, Other: 0 Fwd msg: 0/0, Client msg: 0/0/0/0, Reg: 0/0/0 vyatta@vyatta:~$ The following example shows how to display a summary of the multicast routing table. vyatta@vyatta:~$show ip mroute summary IP Multicast Routing Table Flags: I - Immediate Stat, T - Timed Stat, F - Forwarder installed Timers: Uptime/Stat Expiry Interface State: Interface (TTL) ( , ), 00:01:32/00:03:20, PIM-SM, Flags: TF vyatta@vyatta:~$

44 show ip multicast interface show ip multicast interface Syntax Displays information about IPv4 multicast-enabled interfaces. show ip multicast interface [ interface ] Command Default When used with no option, this command shows information for all IPv4 multicast-enabled interfaces. Parameters Modes interface Mandatory. The type keyword and identifier of an interface. For detailed keywords and arguments that can be specified as interfaces, refer to Supported Data Plane Interfaces on page 53. Operational mode Usage Guidelines Examples Use this command to show operational information for IPv4 multicast-enabled interfaces. The following example shows how to display all IPv4 multicast interface information. vyatta@vyatta:~$ show ip multicast Interface Vif Owner TTL Local Remote Uptime Idx Module Address Address wlm0 0 PIM-SM :04:26 Register :04:26 wlm1 2 PIM-SM :04:25 vyatta@vyatta:~$ The following example shows how to display IPv4 multicast interface information for the wlm0 interface. vyatta@vyatta:~$ show ip multicast interface wlm0 Interface Vif Owner TTL Local Remote Uptime Idx Module Address Address wlm0 0 PIM-SM :05:17 vyatta@vyatta:~$

45 show ip multicast mrinfo <host> show ip multicast mrinfo <host> Syntax Displays information about IPv4 multicast neighbors. show ip multicast mrinfo host [ source-addr interface ] Parameters host The host that is being queried. The host is either a name (if DNS is being used on the network) or an IPv4 unicast address. source-addr Optional. The source address used in the mrinfo request. If omitted, the IPv4 address of the interface on which the request is sent is used. interface Optional. The source address used in the mrinfo request is the IPv4 address of the interface specified. If omitted, the IPv4 address of the interface on which the request is sent is used. For detailed keywords and arguments that can be specified as interfaces, refer to Supported Data Plane Interfaces on page 53. Modes Operational mode Usage Guidelines Examples Use this command to show information about IPv4 multicast neighbors. The following example shows how to display information about the IPv4 multicast neighbor mbone.phony.dom.net. vyatta@vyatta:~$ show ip multicast mrinfo mbone.phony.dom.net (mbone.phony.dom.net) [version 3.3]: > (?) [1/1/querier] > (mbone2.phony.dom.net) [1/45/tunnel] > (momoney.com) [1/32/tunnel/down] > (mbone.dipu.edu) [1/32/tunnel] vyatta@vyatta:~$

46 show ip rpf <source> show ip rpf <source> Syntax Displays Reverse Path Forwarding (RPF) information for a specific IPv4 multicast source address. show ip rpf source Parameters Modes source Operational mode Usage Guidelines Examples An IPv4 multicast source address. Use this command to display the RPF information for a specific IPv4 multicast source address. The following example shows how to display RPF information for the source address vyatta@vyatta:~$show ip rpf RPF Information for RPF interface: dp0p1p1 RPF neighbor: RPF prefix length: 24 RPF distance: 1 RPF mteric: 1 vyatta@vyatta:~$