Implementing IPv6 Multicast

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table at the end of this module.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to http:/​/​www.cisco.com/​go/​cfn. An account on Cisco.com is not required.

Information About Implementing IPv6 Multicast Routing

This chapter describes how to implement IPv6 multicast routing on the switch.

Traditional IP communication allows a host to send packets to a single host (unicast transmission) or to all hosts (broadcast transmission). IPv6 multicast provides a third scheme, allowing a host to send a single data stream to a subset of all hosts (group transmission) simultaneously.

IPv6 Multicast Overview

An IPv6 multicast group is an arbitrary group of receivers that want to receive a particular data stream. This group has no physical or geographical boundaries--receivers can be located anywhere on the Internet or in any private network. Receivers that are interested in receiving data flowing to a particular group must join the group by signaling their local switch. This signaling is achieved with the MLD protocol.

Switches use the MLD protocol to learn whether members of a group are present on their directly attached subnets. Hosts join multicast groups by sending MLD report messages. The network then delivers data to a potentially unlimited number of receivers, using only one copy of the multicast data on each subnet. IPv6 hosts that wish to receive the traffic are known as group members.

Packets delivered to group members are identified by a single multicast group address. Multicast packets are delivered to a group using best-effort reliability, just like IPv6 unicast packets.

The multicast environment consists of senders and receivers. Any host, regardless of whether it is a member of a group, can send to a group. However, only members of a group can listen to and receive the message.

A multicast address is chosen for the receivers in a multicast group. Senders use that address as the destination address of a datagram to reach all members of the group.

Membership in a multicast group is dynamic; hosts can join and leave at any time. There is no restriction on the location or number of members in a multicast group. A host can be a member of more than one multicast group at a time.

How active a multicast group is, its duration, and its membership can vary from group to group and from time to time. A group that has members may have no activity.

IPv6 Multicast Routing Implementation

The Cisco IOS software supports the following protocols to implement IPv6 multicast routing:

  • MLD is used by IPv6 switches to discover multicast listeners (nodes that want to receive multicast packets destined for specific multicast addresses) on directly attached links. There are two versions of MLD: MLD version 1 is based on version 2 of the Internet Group Management Protocol (IGMP) for IPv4, and MLD version 2 is based on version 3 of the IGMP for IPv4. IPv6 multicast for Cisco IOS software uses both MLD version 2 and MLD version 1. MLD version 2 is fully backward-compatible with MLD version 1 (described in RFC 2710). Hosts that support only MLD version 1 will interoperate with a switch running MLD version 2. Mixed LANs with both MLD version 1 and MLD version 2 hosts are likewise supported.

  • PIM-SM is used between switches so that they can track which multicast packets to forward to each other and to their directly connected LANs.

  • PIM in Source Specific Multicast (PIM-SSM) is similar to PIM-SM with the additional ability to report interest in receiving packets from specific source addresses (or from all but the specific source addresses) to an IP multicast address.

MLD Access Group

The MLD access group provides receiver access control in Cisco IOS IPv6 multicast switches. This feature limits the list of groups a receiver can join, and it allows or denies sources used to join SSM channels.

Explicit Tracking of Receivers

The explicit tracking feature allows a switch to track the behavior of the hosts within its IPv6 network. This feature also enables the fast leave mechanism to be used with MLD version 2 host reports.

Protocol Independent Multicast

Protocol Independent Multicast (PIM) is used between switches so that they can track which multicast packets to forward to each other and to their directly connected LANs. PIM works independently of the unicast routing protocol to perform send or receive multicast route updates like other protocols. Regardless of which unicast routing protocols are being used in the LAN to populate the unicast routing table, Cisco IOS PIM uses the existing unicast table content to perform the Reverse Path Forwarding (RPF) check instead of building and maintaining its own separate routing table.

You can configure IPv6 multicast to use either PIM-SM or PIM-SSM operation, or you can use both PIM-SM and PIM-SSM together in your network.

PIM-Sparse Mode

IPv6 multicast provides support for intradomain multicast routing using PIM-SM. PIM-SM uses unicast routing to provide reverse-path information for multicast tree building, but it is not dependent on any particular unicast routing protocol.

PIM-SM is used in a multicast network when relatively few switches are involved in each multicast and these switches do not forward multicast packets for a group, unless there is an explicit request for the traffic. PIM-SM distributes information about active sources by forwarding data packets on the shared tree. PIM-SM initially uses shared trees, which requires the use of an RP.

Requests are accomplished via PIM joins, which are sent hop by hop toward the root node of the tree. The root node of a tree in PIM-SM is the RP in the case of a shared tree or the first-hop switch that is directly connected to the multicast source in the case of a shortest path tree (SPT). The RP keeps track of multicast groups and the hosts that send multicast packets are registered with the RP by that host's first-hop switch.

As a PIM join travels up the tree, switches along the path set up multicast forwarding state so that the requested multicast traffic will be forwarded back down the tree. When multicast traffic is no longer needed, a switch sends a PIM prune up the tree toward the root node to prune (or remove) the unnecessary traffic. As this PIM prune travels hop by hop up the tree, each switch updates its forwarding state appropriately. Ultimately, the forwarding state associated with a multicast group or source is removed.

A multicast data sender sends data destined for a multicast group. The designated switch (DR) of the sender takes those data packets, unicast-encapsulates them, and sends them directly to the RP. The RP receives these encapsulated data packets, de-encapsulates them, and forwards them onto the shared tree. The packets then follow the (*, G) multicast tree state in the switches on the RP tree, being replicated wherever the RP tree branches, and eventually reaching all the receivers for that multicast group. The process of encapsulating data packets to the RP is called registering, and the encapsulation packets are called PIM register packets.

IPv6 BSR: Configure RP Mapping

PIM switches in a domain must be able to map each multicast group to the correct RP address. The BSR protocol for PIM-SM provides a dynamic, adaptive mechanism to distribute group-to-RP mapping information rapidly throughout a domain. With the IPv6 BSR feature, if an RP becomes unreachable, it will be detected and the mapping tables will be modified so that the unreachable RP is no longer used, and the new tables will be rapidly distributed throughout the domain.

Every PIM-SM multicast group needs to be associated with the IP or IPv6 address of an RP. When a new multicast sender starts sending, its local DR will encapsulate these data packets in a PIM register message and send them to the RP for that multicast group. When a new multicast receiver joins, its local DR will send a PIM join message to the RP for that multicast group. When any PIM switch sends a (*, G) join message, the PIM switch needs to know which is the next switch toward the RP so that G (Group) can send a message to that switch. Also, when a PIM switch is forwarding data packets using (*, G) state, the PIM switch needs to know which is the correct incoming interface for packets destined for G, because it needs to reject any packets that arrive on other interfaces.

A small set of switches from a domain are configured as candidate bootstrap switches (C-BSRs) and a single BSR is selected for that domain. A set of switches within a domain are also configured as candidate RPs (C-RPs); typically, these switches are the same switches that are configured as C-BSRs. Candidate RPs periodically unicast candidate-RP-advertisement (C-RP-Adv) messages to the BSR of that domain, advertising their willingness to be an RP. A C-RP-Adv message includes the address of the advertising C-RP, and an optional list of group addresses and mask length fields, indicating the group prefixes for which the candidacy is advertised. The BSR then includes a set of these C-RPs, along with their corresponding group prefixes, in bootstrap messages (BSMs) it periodically originates. BSMs are distributed hop-by-hop throughout the domain.

Bidirectional BSR support allows bidirectional RPs to be advertised in C-RP messages and bidirectional ranges in the BSM. All switches in a system must be able to use the bidirectional range in the BSM; otherwise, the bidirectional RP feature will not function.

PIM-Source Specific Multicast

PIM-SSM is the routing protocol that supports the implementation of SSM and is derived from PIM-SM. However, unlike PIM-SM where data from all multicast sources are sent when there is a PIM join, the SSM feature forwards datagram traffic to receivers from only those multicast sources that the receivers have explicitly joined, thus optimizing bandwidth utilization and denying unwanted Internet broadcast traffic. Further, instead of the use of RP and shared trees, SSM uses information found on source addresses for a multicast group. This information is provided by receivers through the source addresses relayed to the last-hop switches by MLD membership reports, resulting in shortest-path trees directly to the sources.

In SSM, delivery of datagrams is based on (S, G) channels. Traffic for one (S, G) channel consists of datagrams with an IPv6 unicast source address S and the multicast group address G as the IPv6 destination address. Systems will receive this traffic by becoming members of the (S, G) channel. Signaling is not required, but receivers must subscribe or unsubscribe to (S, G) channels to receive or not receive traffic from specific sources.

MLD version 2 is required for SSM to operate. MLD allows the host to provide source information. Before SSM can run with MLD, SSM must be supported in the Cisco IOS IPv6 switch, the host where the application is running, and the application itself.

Routable Address Hello Option

When an IPv6 interior gateway protocol is used to build the unicast routing table, the procedure to detect the upstream switch address assumes the address of a PIM neighbor is always same as the address of the next-hop switch, as long as they refer to the same switch. However, it may not be the case when a switch has multiple addresses on a link.

Two typical situations can lead to this situation for IPv6. The first situation can occur when the unicast routing table is not built by an IPv6 interior gateway protocol such as multicast BGP. The second situation occurs when the address of an RP shares a subnet prefix with downstream switches (note that the RP switch address has to be domain-wide and therefore cannot be a link-local address).

The routable address hello option allows the PIM protocol to avoid such situations by adding a PIM hello message option that includes all the addresses on the interface on which the PIM hello message is advertised. When a PIM switch finds an upstream switch for some address, the result of RPF calculation is compared with the addresses in this option, in addition to the PIM neighbor's address itself. Because this option includes all the possible addresses of a PIM switch on that link, it always includes the RPF calculation result if it refers to the PIM switch supporting this option.

Because of size restrictions on PIM messages and the requirement that a routable address hello option fits within a single PIM hello message, a limit of 16 addresses can be configured on the interface.

PIM IPv6 Stub Routing

The PIM stub routing feature reduces resource usage by moving routed traffic closer to the end user.

In a network using PIM stub routing, the only allowable route for IPv6 traffic to the user is through a switch that is configured with PIM stub routing. PIM passive interfaces are connected to Layer 2 access domains, such as VLANs, or to interfaces that are connected to other Layer 2 devices. Only directly connected multicast receivers and sources are allowed in the Layer 2 access domains. The PIM passive interfaces do not send or process any received PIM control packets.

When using PIM stub routing, you should configure the distribution and remote routers to use IPv6 multicast routing and configure only the switch as a PIM stub router. The switch does not route transit traffic between distribution routers. You also need to configure a routed uplink port on the switch. The switch uplink port cannot be used with SVIs.

You must also configure EIGRP stub routing when configuring PIM stub routing on the switch. For more information, see the EIGRPv6 Stub Routing section.

The redundant PIM stub router topology is not supported. The redundant topology exists when there is more than one PIM router forwarding multicast traffic to a single access domain. PIM messages are blocked, and the PIM assert and designated router election mechanisms are not supported on the PIM passive interfaces. Only the non-redundant access router topology is supported by the PIM stub feature. By using a non-redundant topology, the PIM passive interface assumes that it is the only interface and designated router on that access domain.

In the figure shown below, Switch A routed uplink port 25 is connected to the router and PIM stub routing is enabled on the VLAN 100 interfaces and on Host 3. This configuration allows the directly connected hosts to receive traffic from multicast source. See the Configuring PIM IPv6 Stub Routing section for more information.

Figure 1. PIM Stub Router Configuration



Static Mroutes

IPv6 static mroutes behave much in the same way as IPv4 static mroutes used to influence the RPF check. IPv6 static mroutes share the same database as IPv6 static routes and are implemented by extending static route support for RPF checks. Static mroutes support equal-cost multipath mroutes, and they also support unicast-only static routes.

MRIB

The Multicast Routing Information Base (MRIB) is a protocol-independent repository of multicast routing entries instantiated by multicast routing protocols (routing clients). Its main function is to provide independence between routing protocols and the Multicast Forwarding Information Base (MFIB). It also acts as a coordination and communication point among its clients.

Routing clients use the services provided by the MRIB to instantiate routing entries and retrieve changes made to routing entries by other clients. Besides routing clients, MRIB also has forwarding clients (MFIB instances) and special clients such as MLD. MFIB retrieves its forwarding entries from MRIB and notifies the MRIB of any events related to packet reception. These notifications can either be explicitly requested by routing clients or spontaneously generated by the MFIB.

Another important function of the MRIB is to allow for the coordination of multiple routing clients in establishing multicast connectivity within the same multicast session. MRIB also allows for the coordination between MLD and routing protocols.

MFIB

The MFIB is a platform-independent and routing-protocol-independent library for IPv6 software. Its main purpose is to provide a Cisco IOS platform with an interface with which to read the IPv6 multicast forwarding table and notifications when the forwarding table changes. The information provided by the MFIB has clearly defined forwarding semantics and is designed to make it easy for the platform to translate to its specific hardware or software forwarding mechanisms.

When routing or topology changes occur in the network, the IPv6 routing table is updated, and those changes are reflected in the MFIB. The MFIB maintains next-hop address information based on the information in the IPv6 routing table. Because there is a one-to-one correlation between MFIB entries and routing table entries, the MFIB contains all known routes and eliminates the need for route cache maintenance that is associated with switching paths such as fast switching and optimum switching.

Distributed MFIB


Note


Distributed MFIB has its significance only in a stacked environment where the Master distributes the MFIB information to the other stack members. In the following section the line cards are nothing but the member switches in the stack.


Distributed MFIB (dMFIB) is used to switch multicast IPv6 packets on distributed platforms. dMFIB may also contain platform-specific information on replication across line cards. The basic MFIB routines that implement the core of the forwarding logic are common to all forwarding environments.

dMFIB implements the following functions:

  • Distributes a copy of the MFIB to the line cards.

  • Relays data-driven protocol events generated in the line cards to PIM.

  • Provides an MFIB platform application program interface (API) to propagate MFIB changes to platform-specific code responsible for programming the hardware acceleration engine. This API also includes entry points to switch a packet in software (necessary if the packet is triggering a data-driven event) and to upload traffic statistics to the software.

  • Provides hooks to allow clients residing on the RP to read traffic statistics on demand. (dMFIB does not periodically upload these statistics to the RP.)

The combination of dMFIB and MRIB subsystems also allows the switch to have a "customized" copy of the MFIB database in each line card and to transport MFIB-related platform-specific information from the RP to the line cards.

IPv6 Multicast Process Switching and Fast Switching

A unified MFIB is used to provide both fast switching and process switching support for PIM-SM and PIM-SSM in IPv6 multicast. In process switching, the Route Processor must examine, rewrite, and forward each packet. The packet is first received and copied into the system memory. The switch then looks up the Layer 3 network address in the routing table. The Layer 2 frame is then rewritten with the next-hop destination address and sent to the outgoing interface. The RP also computes the cyclic redundancy check (CRC). This switching method is the least scalable method for switching IPv6 packets.

IPv6 multicast fast switching allows switches to provide better packet forwarding performance than process switching. Information conventionally stored in a route cache is stored in several data structures for IPv6 multicast switching. The data structures provide optimized lookup for efficient packet forwarding.

In IPv6 multicast forwarding, the first packet is fast-switched if the PIM protocol logic allows it. In IPv6 multicast fast switching, the MAC encapsulation header is precomputed. IPv6 multicast fast switching uses the MFIB to make IPv6 destination prefix-based switching decisions. In addition to the MFIB, IPv6 multicast fast switching uses adjacency tables to prepend Layer 2 addressing information. The adjacency table maintains Layer 2 next-hop addresses for all MFIB entries.

The adjacency table is populated as adjacencies are discovered. Each time an adjacency entry is created (such as through ARP), a link-layer header for that adjacent node is precomputed and stored in the adjacency table. Once a route is determined, it points to a next hop and corresponding adjacency entry. It is subsequently used for encapsulation during switching of packets.

A route might have several paths to a destination prefix, such as when a switch is configured for simultaneous load balancing and redundancy. For each resolved path, a pointer is added for the adjacency corresponding to the next-hop interface for that path. This mechanism is used for load balancing across several paths.

Implementing IPv6 Multicast

Enabling IPv6 Multicast Routing

Beginning in privileged EXEC mode, follow these steps:

     Command or ActionPurpose
    Step 1configure terminal
     

    Enter global configuration mode.

     
    Step 2ipv6 multicast-routing


    Example:
    Switch (config)# ipv6 multicast-routing
     

    Enables multicast routing on all IPv6-enabled interfaces and enables multicast forwarding for PIM and MLD on all enabled interfaces of the switch.

     
    Step 3copy running-config startup-config
     

    (Optional) Save your entries in the configuration file.

     

    Customizing and Verifying the MLD Protocol

    Customizing and Verifying MLD on an Interface

    Beginning in privileged EXEC mode, follow these steps:

       Command or ActionPurpose
      Step 1configure terminal
       

      Enters global configuration mode.

       
      Step 2interface type number


      Example:
      Switch(config)# interface GigabitEthernet 1/0/1
      
       

      Specifies an interface type and number, and places the switch in interface configuration mode.

       
      Step 3ipv6 mld join-group [group-address] [include | exclude] {source-address | source-list [acl]}


      Example:
      Switch (config-if) # ipv6 mld join-group FF04::10
      
       

      Configures MLD reporting for a specified group and source.

       
      Step 4ipv6 mld access-group access-list-name


      Example:
      Switch (config-if) # ipv6 access-list acc-grp-1
      
       

      Allows the user to perform IPv6 multicast receiver access control.

       
      Step 5ipv6 mld static-group [group-address] [include | exclude] {source-address | source-list [acl]}


      Example:
      Switch (config-if) # ipv6 mld static-group ff04::10 include 100::1
      
       

      Statically forwards traffic for the multicast group onto a specified interface and cause the interface to behave as if a MLD joiner were present on the interface.

       
      Step 6ipv6 mld query-max-response-time seconds


      Example:
      Switch (config-if) # ipv6 mld query-max-response-time 20
       

      Configures the maximum response time advertised in MLD queries.

       
      Step 7ipv6 mld query-timeout seconds


      Example:
      Switch (config-if) # ipv6 mld query-timeout 130
      
       

      Configures the timeout value before the switch takes over as the querier for the interface.

       
      Step 8exit


      Example:
      Switch (config-if) # exit
      
      
       

      Enter this command twice to exit interface configuration mode and enter privileged EXEC mode.

       
      Step 9show ipv6 mld groups [link-local] [ group-name | group-address] [interface-type interface-number] [detail | explicit]


      Example:
      Switch # show ipv6 mld groups GigabitEthernet 1/0/1
      
      
       

      Displays the multicast groups that are directly connected to the switch and that were learned through MLD.

       
      Step 10show ipv6 mld groups summary


      Example:
      Switch # show ipv6 mld groups summary
      
      
       

      Displays the number of (*, G) and (S, G) membership reports present in the MLD cache.

       
      Step 11show ipv6 mld interface [type number]


      Example:
      Switch # show ipv6 mld interface GigabitEthernet 1/0/1
      
       

      Displays multicast-related information about an interface.

       
      Step 12debug ipv6 mld [group-name | group-address | interface-type]


      Example:
      Switch # debug ipv6 mld
      
       

      Enables debugging on MLD protocol activity.

       
      Step 13debug ipv6 mld explicit [group-name | group-address


      Example:
      Switch # debug ipv6 mld explicit
      
       

      Displays information related to the explicit tracking of hosts.

       
      Step 14copy running-config startup-config
       

      (Optional) Save your entries in the configuration file.

       

      Implementing MLD Group Limits

      Per-interface and global MLD limits operate independently of each other. Both per-interface and global MLD limits can be configured on the same switch. The number of MLD limits, globally or per interface, is not configured by default; the limits must be configured by the user. A membership report that exceeds either the per-interface or the global state limit is ignored.

      Configuring Explicit Tracking of Receivers to Track Host Behavior

      The explicit tracking feature allows a switch to track the behavior of the hosts within its IPv6 network and enables the fast leave mechanism to be used with MLD version 2 host reports.

      Beginning in privileged EXEC mode, follow these steps:

         Command or ActionPurpose
        Step 1configure terminal
         

        Enter global configuration mode.

         
        Step 2interface type number


        Example:
        Switch(config)# interface GigabitEthernet 1/0/1
        
         

        Specifies an interface type and number, and places the switch in interface configuration mode.

         
        Step 3ipv6 mld explicit-tracking access-list-name


        Example:
        Switch(config-if)# ipv6 mld explicit-tracking list1
        
         

        Enables explicit tracking of hosts.

         
        Step 4copy running-config startup-config
         

        (Optional) Save your entries in the configuration file.

         

        Resetting the MLD Traffic Counters

        Beginning in privileged EXEC mode, follow these steps.

           Command or ActionPurpose
          Step 1 clear ipv6 mld traffic


          Example:
          Switch # clear ipv6 mld traffic
           

          Resets all MLD traffic counters.

           
          Step 2show ipv6 mld traffic


          Example:
          Switch # show ipv6 mld traffic
           

          Displays the MLD traffic counters.

           
          Step 3copy running-config startup-config
           

          (Optional) Save your entries in the configuration file.

           

          Clearing the MLD Interface Counters

          Beginning in privileged EXEC mode, follow these steps.

             Command or ActionPurpose
            Step 1 clear ipv6 mld counters interface-type


            Example:
            Switch # clear ipv6 mld counters Ethernet1/0
            
             

            Clears the MLD interface counters.

             
            Step 2copy running-config startup-config
             

            (Optional) Save your entries in the configuration file.

             

            Configuring PIM

            This section explains how to configure PIM.

            Configuring PIM-SM and Displaying PIM-SM Information for a Group Range

            Beginning in privileged EXEC mode, follow these steps:

               Command or ActionPurpose
              Step 1 configure terminal
               

              Enter global configuration mode.

               
              Step 2ipv6 pim rp-address ipv6-address[group-access-list]


              Example:
              Switch (config) # ipv6 pim rp-address 2001:DB8::01:800:200E:8C6C acc-grp-1
               

              Configures the address of a PIM RP for a particular group range.

               
              Step 3exit


              Example:
              Switch (config) # exit
               

              Exits global configuration mode, and returns the switch to privileged EXEC mode.

               
              Step 4show ipv6 pim interface [state-on] [state-off] [type-number]


              Example:
              Switch # show ipv6 pim interface
               

              Displays information about interfaces configured for PIM.

               
              Step 5show ipv6 pim group-map [group-name | group-address] | [group-range | group-mask] [info-source {bsr | default | embedded-rp | static}]


              Example:
              Switch # show ipv6 pim group-map
               

              Displays an IPv6 multicast group mapping table.

               
              Step 6show ipv6 pim neighbor [detail] [interface-type interface-number | count]


              Example:
              Switch # show ipv6 pim neighbor
               

              Displays the PIM neighbors discovered by the Cisco IOS software.

               
              Step 7show ipv6 pim range-list [config] [rp-address | rp-name]


              Example:
              Switch # show ipv6 pim range-list
               

              Displays information about IPv6 multicast range lists.

               
              Step 8show ipv6 pim tunnel [interface-type interface-number]


              Example:
              Switch # show ipv6 pim tunnel
               

              Displays information about the PIM register encapsulation and de-encapsulation tunnels on an interface.

               
              Step 9debug ipv6 pim [group-name | group-address | interface interface-type | bsr | group | mvpn | neighbor]


              Example:
              Switch # debug ipv6 pim
               

              Enables debugging on PIM protocol activity.

               
              Step 10copy running-config startup-config
               

              (Optional) Save your entries in the configuration file.

               

              Configuring PIM Options

              Beginning in privileged EXEC mode, follow these steps:

                 Command or ActionPurpose
                Step 1configure terminal
                 

                Enter global configuration mode.

                 
                Step 2ipv6 pim spt-threshold infinity [group-list access-list-name]


                Example:
                Switch (config) # ipv6 pim spt-threshold infinity group-list acc-grp-1
                 

                Configures when a PIM leaf switch joins the SPT for the specified groups.

                 
                Step 3ipv6 pim accept-register {list access-list | route-map map-name}


                Example:
                Switch (config) # ipv6 pim accept-register route-map reg-filter
                 

                Accepts or rejects registers at the RP.

                 
                Step 4interface type number


                Example:
                Switch (config) # interface GigabitEthernet 1/0/1
                 

                Specifies an interface type and number, and places the switch in interface configuration mode.

                 
                Step 5ipv6 pim dr-priority value


                Example:
                Switch (config-if) # ipv6 pim dr-priority 3
                 

                Configures the DR priority on a PIM switch.

                 
                Step 6ipv6 pim hello-interval seconds


                Example:
                Switch (config-if) # ipv6 pim hello-interval 45
                 

                Configures the frequency of PIM hello messages on an interface.

                 
                Step 7ipv6 pim join-prune-interval seconds


                Example:
                Switch (config-if) # ipv6 pim join-prune-interval 75
                
                 

                Configures periodic join and prune announcement intervals for a specified interface.

                 
                Step 8exit


                Example:
                Switch (config-if) # exit
                
                 

                Enter this command twice to exit interface configuration mode and enter privileged EXEC mode.

                 
                Step 9ipv6 pim join-prune statistic [interface-type]


                Example:
                Switch (config-if) # show ipv6 pim join-prune statistic
                 

                Displays the average join-prune aggregation for the most recently aggregated packets for each interface.

                 
                Step 10copy running-config startup-config
                 

                (Optional) Save your entries in the configuration file.

                 

                Resetting the PIM Traffic Counters

                If PIM malfunctions or in order to verify that the expected number of PIM packets are received and sent, the user can clear PIM traffic counters. Once the traffic counters are cleared, the user can enter the show ipv6 pim traffic command to verify that PIM is functioning correctly and that PIM packets are being received and sent correctly.

                Beginning in privileged EXEC mode, follow these steps:

                   Command or ActionPurpose
                  Step 1clear ipv6 pim traffic


                  Example:
                  Switch # clear ipv6 pim traffic
                   

                  Resets the PIM traffic counters.

                   
                  Step 2show ipv6 pim traffic


                  Example:
                  Switch # show ipv6 pim traffic
                   

                  Displays the PIM traffic counters.

                   
                  Step 3copy running-config startup-config
                   

                  (Optional) Save your entries in the configuration file.

                   

                  Clearing the PIM Topology Table to Reset the MRIB Connection

                  No configuration is necessary to use the MRIB. However, users may in certain situations want to clear the PIM topology table in order to reset the MRIB connection and verify MRIB information.

                  Beginning in privileged EXEC mode, follow these steps:

                     Command or ActionPurpose
                    Step 1clear ipv6 pim topology [group-name | group-address]


                    Example:
                    Switch # clear ipv6 pim topology FF04::10
                     

                    Clears the PIM topology table.

                     
                    Step 2show ipv6 mrib client [filter] [name {client-name | client-name : client-id}]


                    Example:
                    Switch # show ipv6 mrib client
                     

                    Displays multicast-related information about an interface.

                     
                    Step 3show ipv6 mrib route {link-local | summary | [sourceaddress-or-name | *] [groupname-or-address[ prefix-length]]]


                    Example:
                    Switch # show ipv6 mrib route
                     

                    Displays the MRIB route information.

                     
                    Step 4show ipv6 pim topology [groupname-or-address [sourceaddress-or-name] | link-local | route-count [detail]]


                    Example:
                    Switch # show ipv6 pim topology
                     

                    Displays PIM topology table information for a specific group or all groups.

                     
                    Step 5debug ipv6 mrib client


                    Example:
                    Switch # debug ipv6 mrib client
                     

                    Enables debugging on MRIB client management activity.

                     
                    Step 6debug ipv6 mrib io


                    Example:
                    Switch # debug ipv6 mrib io
                     

                    Enables debugging on MRIB I/O events.

                     
                    Step 7debug ipv6 mrib proxy


                    Example:
                    Switch # debug ipv6 mrib proxy
                     

                    Enables debugging on MRIB proxy activity between the switch processor and line cards on distributed switch platforms.

                     
                    Step 8debug ipv6 mrib route [group-name | group-address]


                    Example:
                    Switch # debug ipv6 mrib route
                     

                    Displays information about MRIB routing entry-related activity.

                     
                    Step 9debug ipv6 mrib table


                    Example:
                    Switch # debug ipv6 mrib table
                     

                    Enables debugging on MRIB table management activity.

                     
                    Step 10copy running-config startup-config
                     

                    (Optional) Save your entries in the configuration file.

                     

                    Configuring PIM IPv6 Stub Routing

                    The PIM Stub routing feature supports multicast routing between the distribution layer and the access layer. It supports two types of PIM interfaces, uplink PIM interfaces, and PIM passive interfaces. A routed interface configured with the PIM passive mode does not pass or forward PIM control traffic, it only passes and forwards MLD traffic.

                    PIM IPv6 Stub Routing Configuration Guidelines

                    • Before configuring PIM stub routing, you must have IPv6 multicast routing configured on both the stub router and the central router. You must also have PIM mode (sparse-mode) configured on the uplink interface of the stub router.
                    • The PIM stub router does not route the transit traffic between the distribution routers. Unicast (EIGRP) stub routing enforces this behavior. You must configure unicast stub routing to assist the PIM stub router behavior. For more information, see the EIGRPv6 Stub Routing section.
                    • Only directly connected multicast (MLD) receivers and sources are allowed in the Layer 2 access domains. The PIM protocol is not supported in access domains.
                    • The redundant PIM stub router topology is not supported.

                    Default IPv6 PIM Routing Configuration

                    This table displays the default IPv6 PIM routing configuration for the Switch.

                    Table 1 Default Multicast Routing Configuration

                    Feature

                    Default Setting

                    Multicast routing

                    Disabled on all interfaces.

                    PIM version

                    Version 2.

                    PIM mode

                    No mode is defined.

                    PIM stub routing

                    None configured.

                    PIM RP address

                    None configured.

                    PIM domain border

                    Disabled.

                    PIM multicast boundary

                    None.

                    Candidate BSRs

                    Disabled.

                    Candidate RPs

                    Disabled.

                    Shortest-path tree threshold rate

                    0 kb/s.

                    PIM router query message interval

                    30 seconds.

                    Enabling IPV6 PIM Stub Routing

                    Before You Begin

                    PIM stub routing is disabled in IPv6 by default. Beginning in privileged EXEC mode, follow these steps to enable PIM stub routing on an interface.

                    SUMMARY STEPS

                      1.    enable

                      2.    configure terminal

                      3.    ipv6 multicast pim-passive-enable

                      4.    interface interface-id

                      5.    ipv6 pim

                      6.    ipv6 pim {bsr} | {dr-priority | value} | {hello-interval | seconds} | {join-prune-interval | seconds} | {passive}

                      7.    end


                    DETAILED STEPS
                       Command or ActionPurpose
                      Step 1 enable


                      Example:
                      Switch> enable
                      
                      
                       

                      Enables privileged EXEC mode. Enter your password if prompted.

                       

                      Step 2configure terminal


                      Example:
                      
                      Switch# configure terminal
                      
                      
                       

                      Enters the global configuration mode.

                       
                      Step 3 ipv6 multicast pim-passive-enable


                      Example:
                      
                      Switch(config-if)#  ipv6 multicast pim-passive-enable
                      
                      
                       

                      Enables IPv6 Multicast PIM routing on the switch.

                       
                      Step 4interface interface-id


                      Example:
                      
                      Switch(config)# interface 
                      gigabitethernet 9/0/6
                      
                      
                       

                      Specifies the interface on which you want to enable PIM stub routing, and enters interface configuration mode.

                      The specified interface must be one of the following:

                      • A routed port—A physical port that has been configured as a Layer 3 port by entering the no switchport interface configuration command. You will also need to enable IP PIM sparse mode on the interface, and join the interface as a statically connected member to an MLD static group.

                      • An SVI—A VLAN interface created by using the interface vlan vlan-id global configuration command. You will also need to enable IP PIM sparse mode on the VLAN, join the VLAN as a statically connected member to an MLD static group, and then enable MLD snooping on the VLAN, the MLD static group, and physical interface.

                      These interfaces must have IPv6 addresses assigned to them.

                       
                      Step 5ipv6 pim


                      Example:
                      Switch(config-if)# ipv6 pim
                      
                      
                       

                      Enables the PIM on the interface.

                       
                      Step 6ipv6 pim {bsr} | {dr-priority | value} | {hello-interval | seconds} | {join-prune-interval | seconds} | {passive}


                      Example:
                      Switch(config-if)# ipv6 pim bsr|dr-priority|hello-interval|join-prune-interval|passive                       
                      
                      
                       

                      Configures the various PIM stub features on the interface.

                      Enter bsr to configure BSR on a PIM switch

                      Enter dr-priority to configure the DR priority on a PIM switch.

                      Enter hello-interval to configure the frequency of PIM hello messages on an interface.

                      Enter join-prune-interval to configure periodic join and prune announcement intervals for a specified interface.

                      Enter passive to configure the PIM in the passive mode.

                       
                      Step 7end


                      Example:
                      
                      Switch(config-if)# end
                      
                      
                       

                      Returns to privileged EXEC mode.

                       

                      Monitoring IPv6 PIM Stub Routing

                      Table 2 PIM Stub Configuration show Commands

                      Command

                      Purpose

                      show ipv6 pim interface

                      Switch# show ipv6 pim interface
                      

                      Displays the PIM stub that is enabled on each interface.

                      show ipv6 mld groups

                      Switch# show ipv6 mld groups
                      

                      Displays the interested clients that have joined the specific multicast source group.

                      show ipv6 mroute

                      Switch# show ipv6 mroute
                      

                      Verifies that the multicast stream forwards from the source to the interested clients.

                      Configuring a BSR

                      The tasks included here are described below.

                      Configuring a BSR and Verifying BSR Information

                      Beginning in privileged EXEC mode, follow these steps:

                         Command or ActionPurpose
                        Step 1configure terminal
                         

                        Enter global configuration mode.

                         
                        Step 2ipv6 pim bsr candidate bsr ipv6-address[hash-mask-length] [priority priority-value]


                        Example:
                        Switch (config) # ipv6 pim bsr candidate bsr 2001:DB8:3000:3000::42 124 priority 10
                         

                        Configures a switch to be a candidate BSR.

                         
                        Step 3interface type number


                        Example:
                        Switch (config) # interface GigabitEthernet 1/0/1
                         

                        Specifies an interface type and number, and places the switch in interface configuration mode.

                         
                        Step 4ipv6 pim bsr border


                        Example:
                        Switch (config-if) # ipv6 pim bsr border
                         

                        Specifies an interface type and number, and places the switch in interface configuration mode.

                         
                        Step 5exit


                        Example:
                        Switch (config-if) # exit
                         

                        Enter this command twice to exit interface configuration mode and enter privileged EXEC mode.

                         
                        Step 6show ipv6 pim bsr {election | rp-cache | candidate-rp}


                        Example:
                        Switch (config-if) # show ipv6 pim bsr election
                         

                        Displays information related to PIM BSR protocol processing.

                         
                        Step 7copy running-config startup-config
                         

                        (Optional) Save your entries in the configuration file.

                         

                        Sending PIM RP Advertisements to the BSR

                        Beginning in privileged EXEC mode, follow these steps:

                           Command or ActionPurpose
                          Step 1 configure terminal
                           

                          Enter global configuration mode.

                           
                          Step 2ipv6 pim bsr candidate rp ipv6-address [group-list access-list-name] [priority priority-value] [interval seconds]


                          Example:
                          Switch(config) # ipv6 pim bsr candidate rp 2001:DB8:3000:3000::42 priority 0
                           

                          Sends PIM RP advertisements to the BSR.

                           
                          Step 3interface type number


                          Example:
                          Switch(config) # interface GigabitEthernet 1/0/1
                          
                           

                          Specifies an interface type and number, and places the switch in interface configuration mode.

                           
                          Step 4ipv6 pim bsr border


                          Example:
                          Switch(config-if) # ipv6 pim bsr border
                          
                           

                          Configures a border for all BSMs of any scope on a specified interface.

                           
                          Step 5copy running-config startup-config
                           

                          (Optional) Save your entries in the configuration file.

                           

                          Configuring BSR for Use Within Scoped Zones

                          Beginning in privileged EXEC mode, follow these steps:

                             Command or ActionPurpose
                            Step 1 configure terminal
                             

                            Enter global configuration mode.

                             
                            Step 2ipv6 pim bsr candidate rp ipv6-address [hash-mask-length] [priority priority-value]


                            Example:
                            Switch(config) # ipv6 pim bsr candidate bsr 2001:DB8:1:1:4
                            
                             

                            Configures a switch to be a candidate BSR.

                             
                            Step 3 ipv6 pim bsr candidate rp ipv6-address [group-list access-list-name] [priority priority-value] [interval seconds]


                            Example:
                            Switch(config) # ipv6 pim bsr candidate rp 2001:DB8:1:1:1 group-list list scope 6
                            
                             

                            Configures the candidate RP to send PIM RP advertisements to the BSR.

                             
                            Step 4interface type number


                            Example:
                            Switch(config-if) # interface GigabitEthernet 1/0/1
                            
                             

                            Specifies an interface type and number, and places the switch in interface configuration mode.

                             
                            Step 5ipv6 multicast boundary scope scope-value


                            Example:
                            Switch(config-if) # ipv6 multicast boundary scope 6
                            
                             

                            Configures a multicast boundary on the interface for a specified scope.

                             
                            Step 6copy running-config startup-config
                             

                            (Optional) Save your entries in the configuration file.

                             

                            Configuring BSR Switches to Announce Scope-to-RP Mappings

                            IPv6 BSR switches can be statically configured to announce scope-to-RP mappings directly instead of learning them from candidate-RP messages. A user might want to configure a BSR switch to announce scope-to-RP mappings so that an RP that does not support BSR is imported into the BSR. Enabling this feature also allows an RP positioned outside the enterprise's BSR domain to be learned by the known remote RP on the local candidate BSR switch.

                            Beginning in privileged EXEC mode, follow these steps:

                               Command or ActionPurpose
                              Step 1 configure terminal
                               

                              Enter global configuration mode.

                               
                              Step 2ipv6 pim bsr announced rp ipv6-address [group-list access-list-name] [priority priority-value]


                              Example:
                              Switch(config)# ipv6 pim bsr announced rp 2001:DB8:3000:3000::42 priority 0
                              
                               

                              Announces scope-to-RP mappings directly from the BSR for the specified candidate RP.

                               
                              Step 3copy running-config startup-config
                               

                              (Optional) Save your entries in the configuration file.

                               

                              Configuring SSM Mapping

                              When the SSM mapping feature is enabled, DNS-based SSM mapping is automatically enabled, which means that the switch will look up the source of a multicast MLD version 1 report from a DNS server.

                              You can use either DNS-based or static SSM mapping, depending on your switch configuration. If you choose to use static SSM mapping, you can configure multiple static SSM mappings. If multiple static SSM mappings are configured, the source addresses of all matching access lists will be used.


                              Note


                              To use DNS-based SSM mapping, the switch needs to find at least one correctly configured DNS server, to which the switch may be directly attached.


                              Beginning in privileged EXEC mode, follow these steps:

                                 Command or ActionPurpose
                                Step 1 configure terminal
                                 

                                Enter global configuration mode.

                                 
                                Step 2ipv6 mld ssm-map enable


                                Example:
                                Switch(config) # ipv6 mld ssm-map enable
                                
                                 

                                Enables the SSM mapping feature for groups in the configured SSM range.

                                 
                                Step 3 no ipv6 mld ssm-map query dns


                                Example:
                                Switch(config) # no ipv6 mld ssm-map query dns
                                
                                 

                                Disables DNS-based SSM mapping.

                                 
                                Step 4ipv6 mld ssm-map static access-list source-address


                                Example:
                                Switch(config-if) # ipv6 mld ssm-map static SSM_MAP_ACL_2 2001:DB8:1::1
                                
                                 

                                Configures static SSM mappings.

                                 
                                Step 5exit


                                Example:
                                Switch(config-if) # exit
                                
                                 

                                Exits global configuration mode, and returns the switch to privileged EXEC mode.

                                 
                                Step 6show ipv6 mld ssm-map [source-address]


                                Example:
                                Switch(config-if) # show ipv6 mld ssm-map
                                
                                 

                                Displays SSM mapping information.

                                 
                                Step 7copy running-config startup-config
                                 

                                (Optional) Save your entries in the configuration file.

                                 

                                Configuring Static Mroutes

                                Static multicast routes (mroutes) in IPv6 can be implemented as an extension of IPv6 static routes. You can configure your switch to use a static route for unicast routing only, to use a static multicast route for multicast RPF selection only, or to use a static route for both unicast routing and multicast RPF selection.

                                Beginning in privileged EXEC mode, follow these steps:

                                   Command or ActionPurpose
                                  Step 1 configure terminal
                                   

                                  Enter global configuration mode.

                                   
                                  Step 2ipv6 route {ipv6-prefix / prefix-length ipv6-address | interface-type interface-number ipv6-address]} [administrative-distance] [administrative-multicast-distance | unicast | multicast] [tag tag]


                                  Example:
                                  Switch (config) # ipv6 route 2001:DB8::/64 6::6 100
                                  
                                   

                                  Establishes static IPv6 routes. The example shows a static route used for both unicast routing and multicast RPF selection.

                                   
                                  Step 3 exit


                                  Example:
                                  Switch # exit
                                  
                                   

                                  Exits global configuration mode, and returns the switch to privileged EXEC mode.

                                   
                                  Step 4show ipv6 mroute [link-local | [group-name | group-address [source-address | source-name]] [summary] [count]


                                  Example:
                                  Switch # show ipv6 mroute ff07::1
                                  
                                   

                                  Displays the contents of the IPv6 multicast routing table.

                                   
                                  Step 5show ipv6 mroute [link-local | group-name | group-address] active [kbps]


                                  Example:
                                  Switch (config-if) # show ipv6 mroute active
                                  
                                   

                                  Displays the active multicast streams on the switch.

                                   
                                  Step 6show ipv6 rpf [ipv6-prefix]


                                  Example:
                                  Switch (config-if) #  show ipv6 rpf 2001::1:1:2
                                  
                                   

                                  Checks RPF information for a given unicast host address and prefix.

                                   
                                  Step 7copy running-config startup-config
                                   

                                  (Optional) Save your entries in the configuration file.

                                   

                                  Using MFIB in IPv6 Multicast

                                  Multicast forwarding is automatically enabled when IPv6 multicast routing is enabled.

                                  Verifying MFIB Operation in IPv6 Multicast

                                  Beginning in privileged EXEC mode, follow these steps:

                                     Command or ActionPurpose
                                    Step 1 show ipv6 mfib [linkscope | verbose | group-address-name | ipv6-prefix / prefix-length | source-address-name | count | interface | status | summary]


                                    Example:
                                    Switch # show ipv6 mfib
                                    
                                     

                                    Displays the forwarding entries and interfaces in the IPv6 MFIB.

                                     
                                    Step 2show ipv6 mfib [all | linkscope | group-name | group-address [source-name | source-address]] count


                                    Example:
                                    Switch # show ipv6 mfib ff07::1
                                    
                                     

                                    Displays the contents of the IPv6 multicast routing table.

                                     
                                    Step 3show ipv6 mfib interface


                                    Example:
                                    Switch # show ipv6 mfib interface
                                    
                                     

                                    Displays information about IPv6 multicast-enabled interfaces and their forwarding status.

                                     
                                    Step 4show ipv6 mfib status


                                    Example:
                                    Switch # show ipv6 mfib status
                                    
                                     

                                    Displays general MFIB configuration and operational status.

                                     
                                    Step 5show ipv6 mfib summary


                                    Example:
                                    Switch # show ipv6 mfib summary
                                    
                                     

                                    Displays summary information about the number of IPv6 MFIB entries and interfaces.

                                     
                                    Step 6debug ipv6 mfib [group-name | group-address] [adjacency | db | fs | init | interface | mrib [detail] | nat | pak | platform | ppr | ps | signal | table]


                                    Example:
                                    Switch # debug ipv6 mfib FF04::10 pak
                                    
                                     

                                    Enables debugging output on the IPv6 MFIB.

                                     

                                    Resetting MFIB Traffic Counters

                                    Beginning in privileged EXEC mode, follow these steps:

                                       Command or ActionPurpose
                                      Step 1clear ipv6 mfib counters [group-name | group-address [source-address | source-name]]


                                      Example:
                                      Switch # clear ipv6 mfib counters FF04::10
                                       

                                      Resets all active MFIB traffic counters.