Multicast

This chapter provides information about Protocol Independent Multicast (PIM).

Overview of multicast

IP multicast is a method of many-to-many communication that simplifies the delivery of unicast datagrams. In the case of unicast delivery, IP packets are sent from a single source to a single recipient. The source inserts the address of the target host in the IP header destination field of an IP datagram, and intermediate routers (if present) forward the datagram toward the target in accordance with their respective routing tables.

However, some applications, such as audio or video streaming broadcasts, require the delivery of individual IP packets to multiple destinations. In such applications, multicast is used to distribute datagrams sourced from one or more hosts to a set of receivers that may be distributed over different (sub) networks. The delivery of multicast datagrams is significantly more complex.

Multicast sources can send a single copy of data using a single address for the entire group of recipients. The routers between the source and recipients route the data using the group address route. Multicast packets are delivered to a multicast group. A multicast group specifies a set of recipients who are interested in a particular data stream and is represented by an IP address from a specified range. Data addressed to the IP address is forwarded to the members of the group. A source host sends data to a multicast group by specifying the multicast group address in the datagram destination IP address. A source does not have to register to send data to a group, nor does it need to be a member of the group.

Routers and Layer 3 (L3) switches use the Internet Group Management Protocol (IGMP) to manage membership for a multicast session. When a host needs to receive one or more multicast sessions, it signals its local router by sending a join message to each multicast group it needs to join. When a host needs to leave a multicast group, it sends a leave message.

To extend multicast to the Internet, the multicast backbone (Mbone) is used. The Mbone is layered on top of portions of the Internet. These portions, or islands, are interconnected using tunnels. The tunnels allow multicast traffic to pass between the multicast-capable portions of the Internet. As more and more routers in the Internet are multicast-capable (and scalable), the unicast and multicast routing table will converge.

The original Mbone was based on the Distance Vector Multicast Routing Protocol (DVMRP) and was very limited. The Mbone is, however, converging around the following protocol set:

  • IGMP

  • Protocol Independent Multicast (Sparse Mode) (PIM-SM)

Multicast models (SSM)

This section provides information about the Source-Specific Multicast (SSM) model.

SSM

The SSM service model defines a channel identified by an (S,G) pair, where S is a source address and G is an SSM destination address. In contrast to the ASM model, SSM only provides network-layer support for one-to-many delivery.

The SSM service model attempts to alleviate the following deployment problems:

  • address allocation

    SSM defines channels on a per-source basis. For example, the channel (S1,G) is distinct from the channel (S2,G), where S1 and S2 are source addresses, and G is an SSM destination address. This averts the problem of global allocation of SSM destination addresses and makes each source independently responsible for resolving address collisions for the various channels it creates.

  • access control

    SSM provides an efficient solution to the access control problem. When a receiver subscribes to an (S,G) channel, it receives data sent only by the source S. In contrast, any host can transmit to an ASM host group. At the same time, when a sender picks a channel (S,G) to transmit on, it is automatically ensured that no other sender will be transmitting on the same channel (except in the case of malicious acts such as address spoofing). This makes it harder to spam an SSM channel than an ASM multicast group.

  • handling of well-known sources

    SSM requires only source-based forwarding trees. This eliminates the need for a shared tree infrastructure. In terms of the IGMP and PIM-SM, this implies that neither the RP-based shared tree infrastructure of PIM-SM nor the MSDP protocol is required. Therefore, the complexity of the multicast routing infrastructure for SSM is low, making it viable for immediate deployment.

  • handling point-to-point applications

    Anticipating that point-to-multipoint applications such as Internet TV will be significant in the future; the SSM model is better suited for such applications.

Multicast features

This section contains information about the multicast protocols required to support a Nokia router in the network.

IGMP

IGMP is used by IPv4 hosts and routers to report their IP multicast group memberships to neighboring multicast routers. A multicast router keeps a list of multicast group memberships for each attached network, and a timer for each membership.

Multicast group memberships include at least one member of a multicast group on an attached network. In each of its attached networks, a multicast router can assume one of two roles: querier or non-querier. There is typically only one querier per physical network.

The querier issues two types of queries: a general query and a group-specific query. General queries are issued to solicit membership information with regard to any multicast group. Group-specific queries are issued when a router receives a leave message from the node it perceives as being the last remaining group member on that network segment.

If the host needs to receive a multicast session issue and a multicast group membership report, the reports must be sent to all multicast-enabled routers.

IGMP versions and interoperability requirements

If routers run different versions of IGMP, they negotiate the lowest common version of IGMP that is supported on their subnet and operate in that version. Three versions of IGMP are supported:

  • version 1

    Specified in RFC 1112, Host extensions for IP Multicasting was the first widely deployed version and the first version to become an Internet standard.

  • version 2

    Specified in RFC 2236, Internet Group Management Protocol added support for ‟low leave latency”, that is, a reduction in the time it takes for a multicast router to learn that there are no longer any members of a particular group present on an attached network.

  • version 3

    Specified in RFC 3376, Internet Group Management Protocol added support for source filtering, that is, the ability for a system to report interest in receiving packets only from specific source addresses, as required to support SSM, or from all but specific source addresses, sent to a particular multicast address.

IGMPv3 must keep track of the state of each group for each attached network. The group state consists of a filter-mode, a list of sources, and various timers. For each attached network running IGMP, a multicast router records the desired reception state for that network.

IGMP version transition

Nokia routers are capable of interoperating with routers and hosts running IGMPv1, IGMPv2, and/or IGMPv3. RFC 5186, Internet Group Management Protocol Version 3 (IGMPv3)/Multicast Listener Discovery Version 2 (MLDv2) and Multicast Routing Protocol Interaction explores the interoperability issues and how they affect the routing protocols.

IGMPv3 specifies that if a router receives an earlier version query message on an interface, it must immediately switch to a mode that is compatible with the earlier version. Because the previous versions of IGMP are not source-aware, should this occur and the interface switches to version 1 or 2 compatibility mode, any previously learned group memberships with specific sources (learned via the IGMPv3-specific INCLUDE or EXCLUDE mechanisms) must be converted to non-source specific group memberships. The routing protocol will then treat the query as if there is no EXCLUDE definition present.

SSM groups

IGMPv3 permits a receiver to join a group and specify that it only needs to receive traffic for a group if that traffic comes from a particular source. If a receiver does this, and no other receiver on the LAN requires all the traffic for the group, the designated router (DR) can omit performing a (*,G) join to set up the shared tree, and instead issue a source-specific (S,G) join only.

The range of multicast addresses from 232.0.0.0 to 232.255.255.255 is currently set aside for source-specific multicast in IPv4. For groups in this range, receivers should only issue source-specific IGMPv3 joins. If a PIM router receives a non-source-specific join for a group in this range, it should ignore it.

A Nokia PIM router must silently ignore a received (*,G) PIM join message where G is a multicast group address from the multicast address group range that has been explicitly configured for SSM. This occurrence should generate an event. If configured, the IGMPv2 request can be translated into IGMPv3. The router allows for the conversion of an IGMPv2 (*,G) request into a IGMPv3 (S,G) request based on manual entries. A maximum of 32 SSM ranges is supported.

IGMPv3 also permits a receiver to join a group and specify that it only needs to receive traffic for a group if that traffic does not come from a specific source or sources. In this case, the DR will perform a (*,G) join as normal, but can combine this with a prune for each of the sources the receiver does not wish to receive.

PIM-SM

PIM-SM leverages the unicast routing protocols that are used to create the unicast routing table, OSPF, IS-IS, BGP, and static routes. Because PIM uses this unicast routing information to perform the multicast forwarding function, it is effectively IP protocol independent. Unlike DVMRP, PIM does not send multicast routing table updates to its neighbors.

PIM-SM uses the unicast routing table to perform the Reverse Path Forwarding (RPF) check function instead of building up a completely independent multicast routing table.

PIM-SM only forwards data to network segments with active receivers that have explicitly requested the multicast group. PIM-SM in the ASM model initially uses a shared tree to distribute information about active sources. Depending on the configuration options, the traffic can remain on the shared tree or switch over to an optimized source distribution tree. As multicast traffic starts to flow down the shared tree, routers along the path determine whether there is a better path to the source. If a more direct path exists, the router closest to the receiver sends a join message toward the source and reroutes the traffic along this path.

PIM-SM relies on an underlying topology-gathering protocol to populate a routing table with routes. The routing table is called the Multicast Routing Information Base (MRIB). The routes in this table can be taken directly from the unicast routing table, or they can be different and provided by a separate routing protocol such as MBGP. Regardless of how it is created, the primary role of the MRIB in the PIM-SM protocol is to provide the next hop router along a multicast-capable path to each destination subnet. The MRIB is used to determine the next hop neighbor to whom any PIM join/prune message is sent. Data flows along the reverse path of the join messages. In contrast to the unicast RIB that specifies the next hop that a data packet would take to get to a subnet, the MRIB gives reverse-path information and indicates the path that a multicast data packet would take from its origin subnet to the router that has the MRIB.

PIM-SM functions

This section provides information about the three phases of PIM-SM functions.

Phase one

In this phase, a multicast receiver expresses its interest in receiving traffic destined for a multicast group. Typically, it does this using IGMP or MLD, but other mechanisms can also serve this purpose. One of the receiver's local routers is elected as the DR for that subnet. When the expression of interest is received, the DR sends a PIM join message toward the RP for that multicast group. This join message is known as a (*,G) join because it joins group G for all sources to that group. The (*,G) join travels hop-by-hop toward the RP for the group, and in each router it passes through the multicast tree state for group G is instantiated. Eventually, the (*,G) join either reaches the RP or reaches a router that already has the (*,G) join state for that group.

When many receivers join the group, their join messages converge on the RP and form a distribution tree for group G that is rooted at the RP. This is known as the RP tree and is also known as the shared tree because it is shared by all sources sending to that group. Join messages are resent periodically as long as the receiver remains in the group. When all receivers on a leaf-network leave the group, the DR sends a PIM (*,G) prune message toward the RP for that multicast group. However, if the prune message is not sent for any reason, the state will eventually time out.

A multicast data sender starts sending data destined for a multicast group. The sender's local router (the DR) 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 to the shared tree. The packets then follow the (*,G) multicast tree state in the routers 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 known as PIM register packets.

At the end of phase one, multicast traffic flows encapsulated to the RP, and then natively over the RP tree to the multicast receivers.

Phase two

In this phase, register-encapsulation of data packets is performed. However, register-encapsulation of data packets is unsuitable for the following reasons:

  • Encapsulation and de-encapsulation can be resource intensive operations for a router to perform depending on whether or not the router has appropriate hardware for the tasks.

  • Traveling to the RP and then back down the shared tree can cause the packets to travel a relatively long distance to reach receivers that are close to the sender. For some applications, increased latency is unwanted.

Although register-encapsulation can continue indefinitely, for these reasons, the RP will switch to native forwarding. To do this, when the RP receives a register-encapsulated data packet from source S on group G, it will initiate an (S,G) source-specific join toward S. This join message travels hop-by-hop toward S, instantiating the (S,G) multicast tree state in the routers along the path. The (S,G) multicast tree state is used only to forward packets for group G if those packets come from source S. Eventually the join message reaches S's subnet or a router that already has the (S,G) multicast tree state, and packets from S start to flow following the (S,G) tree state toward the RP. These data packets can also reach routers with the (*,G) state along the path toward the RP, and if this occurs, they can take a shortcut to the RP tree at this point.

While the RP is in the process of joining the source-specific tree for S, the data packets will continue being encapsulated to the RP. When packets from S also start to arrive natively at the RP, the RP receives two copies of each of these packets. At this point, the RP starts to discard the encapsulated copy of these packets and sends a register-stop message back to S's DR to prevent the DR unnecessarily encapsulating the packets. At the end of phase 2, traffic will be flowing natively from S along a source-specific tree to the RP and from there along the shared tree to the receivers. Where the two trees intersect, traffic can transfer from the shared RP tree to the shorter source tree.

Note:

A sender can start sending before or after a receiver joins the group, and therefore, phase two may occur before the shared tree to the receiver is built.

Phase three

In this phase, the RP joins back toward the source using the shortest path tree. Although having the RP join back toward the source removes the encapsulation overhead, it does not completely optimize the forwarding paths. For many receivers, the route via the RP can involve a significant detour when compared with the shortest path from the source to the receiver.

To obtain lower latencies, a router on the receiver's LAN, typically the DR, may optionally initiate a transfer from the shared tree to a source-specific shortest-path tree (SPT). To do this, it issues an (S,G) Join toward S. This instantiates the state in the routers along the path to S. Eventually, this join either reaches S's subnet or reaches a router that already has the (S,G) state. When this happens, data packets from S start to flow following the (S,G) state until they reach the receiver.

At this point, the receiver (or a router upstream of the receiver) receives two copies of the data — one from the SPT and one from the RPT. When the first traffic starts to arrive from the SPT, the DR or upstream router starts to drop the packets for G from S that arrive via the RP tree. In addition, it sends an (S,G) prune message toward the RP. The prune message travels hop-by-hop instantiating the state along the path toward the RP indicating that traffic from S for G should not be forwarded in this direction. The prune message is propagated until it reaches the RP or a router that still needs the traffic from S for other receivers.

By now, the receiver is receiving traffic from S along the SPT between the receiver and S. In addition, the RP is receiving the traffic from S, but this traffic is no longer reaching the receiver along the RP tree. As far as the receiver is concerned, this is the final distribution tree.

Encapsulating data packets in the register tunnel

Conceptually, the register tunnel is an interface with a smaller MTU than the underlying IP interface toward the RP. IP fragmentation on packets forwarded on the register tunnel is performed based on this smaller MTU. The encapsulating DR can perform path-MTU discovery to the RP to determine the effective MTU of the tunnel. This smaller MTU takes both the outer IP header and the PIM register header overhead into consideration.

PIM bootstrap router mechanism

For proper operation, every PIM-SM router within a PIM domain must be able to map a particular global-scope multicast group address to the same RP. If this is not possible, black holes can appear (this is where some receivers in the domain cannot receive some groups). A domain in this context is a contiguous set of routers that all implement PIM and are configured to operate within a common boundary.

The bootstrap router (BSR) mechanism provides a way in which viable group-to-RP mappings can be created and distributed to all the PIM-SM routers in a domain. Each candidate BSR originates bootstrap messages (BSMs). Each BSM contains a BSR priority field. Routers within the domain flood the BSMs throughout the domain. A candidate BSR that hears about a higher-priority candidate BSR suppresses its sending of further BSMs for a period of time. The single remaining candidate BSR becomes the elected BSR and its BSMs inform the other routers in the domain that it is the elected BSR.

The PIM bootstrap routing mechanism is adaptive, meaning that 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.

PIM-SM routing policies

Multicast traffic can be restricted from certain source addresses by creating routing policies. Join messages can be filtered using import filters. PIM join policies can be used to reduce denial of service attacks and subsequent PIM state explosion in the router and to remove unwanted multicast streams at the edge of the network before it is carried across the core. Route policies are created in the config>router>policy-options context. Join and register route policy match criteria for PIM-SM can specify the following:

  • router interface or interfaces specified by name or IP address

  • neighbor address (the source address in the IP header of the join and prune message)

  • multicast group address embedded in the join and prune message

  • multicast source address embedded in the join and prune message

Join policies can be used to filter PIM join messages so that no *,G or S,G state is created on the router. The following table describes the match conditions.

Table 1. Join filter policy match conditions

Match condition

Matches

Interface

The RTR interface by name

Neighbor

The neighbors source address in the IP header

Group Address

The multicast group address in the join/prune message

Source Address

The source address in the join/prune message

PIM register messages are sent by the first hop designated router that has a direct connection to the source. This serves a dual purpose:

  • It notifies the RP that a source has active data for the group.

  • It delivers the multicast stream in register encapsulation to the RP and its potential receivers.

  • If no one has joined the group at the RP, the RP will ignore the registers.

In an environment where the sources to particular multicast groups are always known, it is possible to apply register filters at the RP to prevent any unwanted sources from transmitting a multicast stream. You can apply these filters at the edge so that register data does not travel unnecessarily over the network toward the RP.

The following table describes the match conditions.

Table 2. Register filter policy match conditions

Match condition

Matches

Interface

The RTR interface by name

Group Address

The multicast group address in the join/prune message

Source Address

The source address in the join/prune message

Reverse path forwarding checks

Multicast implements a reverse path forwarding check (RPF). An RPF checks the path that multicast packets take between their sources and the destinations to prevent loops. Multicast requires that an incoming interface be the outgoing interface used by unicast routing to reach the source of the multicast packet. RPF forwards a multicast packet only if it is received on an interface that is used by the router to route to the source.

If the forwarding paths are modified due to routing topology changes, any dynamic filters that may have been applied must be reevaluated. If filters are removed, the associated alarms are also cleared.

Anycast RP for PIM-SM

The implementation of anycast RP for PIM-SM environments enables fast convergence when a PIM rendezvous point (RP) router fails by allowing receivers and sources to rendezvous at the closest RP. It allows an arbitrary number of RPs per group in a single shared-tree protocol Independent Multicast-Sparse Mode (PIM-SM) domain. This is particularly important for triple play configurations that choose to distribute multicast traffic using PIM-SM, not SSM. In this case, RP convergence must be fast enough to avoid the loss of multicast streams, which could cause loss-of-TV delivery to the end customer.

Anycast RP for PIM-SM environments are supported in the base routing/PIM-SM instance of the service router. This feature is supported in Layer 3-VPRN instances that are configured with PIM.

Implementation

The Anycast RP for PIM-SM implementation is defined in RFC 4610, Anycast-RP Using Protocol Independent Multicast (PIM), and is similar to that described in RFC 3446, Anycast Rendezvous Point (RP) mechanism using Protocol Independent Multicast (PIM) and Multicast Source Discovery Protocol (MSDP). The implementation extends the register mechanism in PIM so that anycast RP functionality can be retained without using Multicast Source Discovery Protocol (MSDP).

The mechanism works as follows:

  • An IP address is chosen as the RP address. This address is statically configured, or distributed using a dynamic protocol, to all PIM routers throughout the domain.

  • A set of routers in the domain are chosen to act as RPs for this RP address. These routers are called the anycast-RP set.

  • Each router in the anycast-RP set is configured with a loopback interface using the RP address.

  • Each router in the anycast-RP set also needs a separate IP address to be used for communication between the RPs.

  • The RP address, or a prefix that covers the RP address, is injected into the unicast routing system inside of the domain.

  • Each router in the anycast-RP set is configured with the addresses of all other routers in the anycast-RP set. This must be consistently configured in all RPs in the set.

The following figure shows a scenario where all routers are connected, and where R1A, R1B, and R2 are receivers for a group, and S1 and S2 send to that group. Assume RP1, RP2, and RP3 are all assigned the same IP address that is used as the anycast-RP address (for example, the IP address is RPA).

Figure 1. Anycast RP for PIM-SM implementation example
Note:

The address used for the RP address in the domain (the anycast-RP address) must be different from the addresses used by the anycast-RP routers to communicate with each other.

The following procedure is used when S1 starts sourcing traffic:

  1. S1 sends a multicast packet.

  2. The DR directly attached to S1 forms a PIM register message to send to the anycast-RP address (RPA). The unicast routing system delivers the PIM register message to the nearest RP, in this case RP1.

  3. RP1 receives the PIM register message, de-encapsulates it, and sends the packet down the shared tree to get the packet to receivers R1A and R1B.

  4. RP1 is configured with RP2 and RP3’s IP address. Because the register message did not come from one of the RPs in the anycast-RP set, RP1 assumes the packet came from a DR. If the register message is not addressed to the anycast-RP address, an error has occurred and it should be rate-limited logged.

  5. RP1 sends a copy of the register message from S1’s DR to both RP2 and RP3. RP1 uses its own IP address as the source address for the PIM register message.

  6. RP1 may join back to the source tree by triggering a (S1,G) Join message toward S1; however, RP1 must create the (S1,G) state.

  7. RP2 receives the register message from RP1, de-encapsulates it, and also sends the packet down the shared tree to get the packet to receiver R2.

  8. RP2 sends a register-stop message back to the RP1. RP2 may wait to send the register-stop message if it decides to join the source tree. RP2 should wait until it has received data from the source on the source tree before sending the register-stop message. If RP2 decides to wait, the register-stop message will be sent when the next register is received. If RP2 decides not to wait, the register-stop message is sent now.

  9. RP2 may join back to the source tree by triggering a (S1,G) Join message toward S1; however, RP2 must create the (S1,G) state.

  10. RP3 receives the register message from RP1 and de-encapsulates it, but, since there are no receivers joined for the group, it can discard the packet.

  11. RP3 sends a register-stop message back to RP1.

  12. RP3 creates a (S1,G) state so that when a receiver joins after S1 starts sending, RP3 can join quickly to the source tree for S1.

  13. RP1 processes the register-stop message from RP2 and RP3. RP1 may cache on a per-RP/per-(S,G) basis the receipt of register-stop messages from the RPs in the anycast-RP set. This option is performed to increase the reliability of register message delivery to each RP. When this option is used, subsequent register messages received by RP1 are sent only to the RPs in the anycast-RP set that have not previously sent register-stop messages for the (S,G) entry.

  14. RP1 sends a register-stop message back to the DR the next time a register message is received from the DR and, if all RPs in the anycast-RP set have returned register-stop messages for a particular (S,G) route when RP1 caches on a per-RP/per-(S,G) basis the receipt of register-stop messages from the RPs in the anycast-RP set.

The procedure for S2 sending follows the same preceding steps, but it is RP3 that sends a copy of the register originated by S2’s DR to RP1 and RP2. This example shows how sources anywhere in the domain, associated with different RPs, can reach all receivers, also associated with different RPs, in the same domain.

Distributing PIM joins over multiple ECMP paths

The per bandwidth/round robin method is commonly used in multicast load balancing. However, the interface in an ECMP set can also be used for a channel to be predictable without any knowledge of the other channels using the ECMP set.

The mc-ecmp-hashing-enabled command enables PIM joins to be distributed over multiple ECMP paths based on a hash of S and G. When a link in the ECMP set is removed, the multicast streams using the link are redistributed over the remaining ECMP links using the same hash algorithm. When a link is added to the ECMP set, new joins may be allocated to the new link based on the hash algorithm, but existing multicast streams using the other ECMP links stay on those links until they are pruned.

The default is no mc-ecmp-hashing-enabled, which means that the use of multiple ECMP paths is controlled by the existing implementation and CLI commands, that is, mc-ecmp-balance.

The mc-ecmp-hashing-enabled command and the mc-ecmp-balance command are mutually exclusive in the same context.

The following procedure is used to achieve distribution of streams across the ECMP links:

  1. For a specific S, G get all possible nHops.

  2. Sort these nHops based on nHop addresses.

  3. xor S and G addresses.

  4. Hash the xor address over a number of PIM next hops.

  5. Use the hash value obtained in step 4, and get that element, in the sorted list obtained in step 2, as the preferred nHop.

  6. If this element is not available or it is not a PIM nHop (PIM neighbor), the next available next hop is chosen.

PIM status

The following is a sample PIM status indicating ECMP hashing is disabled.

*B:BB# show router pim status

===============================================================================
PIM Status ipv4
===============================================================================
Admin State                       : Up
Oper State                        : Up

IPv4 Admin State                  : Up
IPv4 Oper State                   : Up

BSR State                         : Accept Any

Elected BSR
    Address                       : None
    Expiry Time                   : N/A
    Priority                      : N/A
    Hash Mask Length              : 30
    Up Time                       : N/A
    RPF Intf toward E-BSR        : N/A

Candidate BSR
    Admin State                   : Down
    Oper State                    : Down
    Address                       : None
    Priority                      : 0
    Hash Mask Length              : 30

Candidate RP
    Admin State                   : Down
    Oper State                    : Down
    Address                       : 0.0.0.0
    Priority                      : 192
    Holdtime                      : 150

SSM-Default-Range                 : Enabled
SSM-Group-Range
    None

MC-ECMP-Hashing                   : Disabled

Policy                            : None

RPF Table                         : rtable-u

Non-DR-Attract-Traffic            : Disabled
===============================================================================

----------------------------------------------
*B:BB>config>service>vprn>pim# no mc-ecmp-balance mc-ecmp-balance mc-ecmp-balance
-hold
*B:BB>config>service>vprn>pim# no mc-ecmp-balance 
*B:BB>config>service>vprn>pim# mc-ecmp-mc-ecmp-balance mc-ecmp-balance-hold mc-ecmp
-hashing-enabled
*B:BB>config>service>vprn>pim# mc-ecmp-hashing-enabled
*B:BB>config>service>vprn>pim# info
----------------------------------------------
                apply-to all
                rp
                    static
                        address 10.3.3.3
                            group-prefix 224.0.0.0/4
                        exit
                    exit
                    bsr-candidate
                        shutdown
                    exit
                    rp-candidate
                        shutdown
                    exit
                exit
                no mc-ecmp-balance
                mc-ecmp-hashing-enabled
----------------------------------------------
*B:BB>config>service>vprn>pim#
apply-to        - Create/remove interfaces in PIM
 [no] import          - Configure import policies
 [no] interface       + Configure PIM interface
 [no] mc-ecmp-balance - Enable/
Disable multicast balancing of traffic over ECMP links
 [no] mc-ecmp-balanc* - Configure hold time for multicast balancing over ECMP links
 [no] mc-ecmp-hashin* - Enable/
Disable hash based multicast balancing of traffic over ECMP links
 [no] non-dr-attract* - Enable/disable attracting traffic when not DR
      rp              + Configure the router as static or Candidate-RP
 [no] shutdown        - Administratively enable or disable the operation of PIM 
 [no] spt-switchover* - Configure shortest path tree (spt tree) switchover 
threshold for a group prefix
 [no] ssm-default-ra* - Enable the disabling of SSM Default Range
 [no] ssm-groups      + Configure the SSM group ranges
PIM joins over multiple ECMP paths

The following is a sample distribution of PIM joins over multiple ECMP paths.

*A:BA# show router pim group

===============================================================================
PIM Groups ipv4
===============================================================================
Group Address                           Type     Spt Bit Inc Intf       No.Oifs
   Source Address                          RP
-------------------------------------------------------------------------------
239.1.1.1                               (S,G)    spt     to_C0          1
   172.0.100.33                            10.20.1.6
239.1.1.2                               (S,G)    spt     to_C3          1
   172.0.100.33                            10.20.1.6
239.1.1.3                               (S,G)    spt     to_C2          1
   172.0.100.33                            10.20.1.6
239.1.1.4                               (S,G)    spt     to_C1          1
   172.0.100.33                            10.20.1.6
239.1.1.5                               (S,G)    spt     to_C0          1
   172.0.100.33                            10.20.1.6
239.1.1.6                               (S,G)    spt     to_C3          1
   172.0.100.33                            10.20.1.6

239.2.1.1                               (S,G)    spt     to_C0          1
   172.0.100.33                            10.20.1.6
239.2.1.2                               (S,G)    spt     to_C3          1
   172.0.100.33                            10.20.1.6
239.2.1.3                               (S,G)    spt     to_C2          1
   172.0.100.33                            10.20.1.6
239.2.1.4                               (S,G)    spt     to_C1          1
   172.0.100.33                            10.20.1.6
239.2.1.5                               (S,G)    spt     to_C0          1
   172.0.100.33                            10.20.1.6
239.2.1.6                               (S,G)    spt     to_C3          1
   172.0.100.33                            10.20.1.6

239.3.1.1                               (S,G)    spt     to_C0          1
   172.0.100.33                            10.20.1.6
239.3.1.2                               (S,G)    spt     to_C3          1
   172.0.100.33                            10.20.1.6
239.3.1.3                               (S,G)    spt     to_C2          1
   172.0.100.33                            10.20.1.6
239.3.1.4                               (S,G)    spt     to_C1          1
   172.0.100.33                            10.20.1.6
239.3.1.5                               (S,G)    spt     to_C0          1
   172.0.100.33                            10.20.1.6
239.3.1.6                               (S,G)    spt     to_C3          1
   172.0.100.33                            10.20.1.6

239.4.1.1                               (S,G)    spt     to_C0          1
   172.0.100.33                            10.20.1.6
239.4.1.2                               (S,G)    spt     to_C3          1
   172.0.100.33                            10.20.1.6
239.4.1.3                               (S,G)    spt     to_C2          1
   172.0.100.33                            10.20.1.6
239.4.1.4                               (S,G)    spt     to_C1          1
   172.0.100.33                            10.20.1.6
239.4.1.5                               (S,G)    spt     to_C0          1
   172.0.100.33                            10.20.1.6
239.4.1.6                               (S,G)    spt     to_C3          1
   172.0.100.33                            10.20.1.6
-------------------------------------------------------------------------------
Groups : 24
===============================================================================

Multicast debugging tools

This section describes multicast debugging tools for the 7210 SAS.

The debugging tools for multicast consist of two elements: mtrace and mrinfo.

Mtrace

Assessing problems in the distribution of IP multicast traffic can be difficult. The mtrace feature uses a tracing feature implemented in multicast routers that is accessed via an extension to the IGMP protocol. The mtrace feature is used to print the path from the source to a receiver; it does this by passing a trace query hop-by-hop along the reverse path from the receiver to the source. At each hop, information such as the hop address, routing error conditions, and packet statistics are gathered and returned to the requester.

Data added by each hop includes:

  • query arrival time

  • incoming interface

  • outgoing interface

  • previous hop router address

  • input packet count

  • output packet count

  • total packets for this source/group

  • Routing protocol

  • TTL threshold

  • Fowarding/error code

The information enables the network administrator to determine the following:

  • where multicast flows stop

  • the flow of the multicast stream

When the trace response packet reaches the first-hop router (the router that is directly connected to the source’s network interface), that router sends the completed response to the response destination (receiver) address specified in the trace query.

If a multicast router along the path does not implement the traceroute feature or if there is an outage, no response is returned. To solve this problem, the trace query includes a maximum hop count field to limit the number of hops traced before the response is returned. This allows a partial path to be traced.

The reports inserted by each router contain not only the address of the hop, but also the TTL required to forward, flags to indicate routing errors, and counts of the total number of packets on the incoming and outgoing interfaces and those forwarded for the specified group. Examining the differences in these counts for two separate traces and comparing the output packet counts from one hop with the input packet counts of the next hop allows the calculation of packet rate and packet loss statistics for each hop to isolate congestion problems.

Finding the last hop router

The trace query must be sent to the multicast router, which is the last hop on the path from the source to the receiver. If the receiver is on the local subnet (as determined using the subnet mask), the default method is to multicast the trace query to all-routers.mcast.net (224.0.0.2) with a TTL of 1. Otherwise, the trace query is sent to the group address because the last-hop router will be a member of that group if the receiver is. Therefore, it is necessary to specify a group that the intended receiver has joined. This multicast is sent with a default TTL of 64, which may not be sufficient for all cases.

When tracing from a multihomed host or router, the default receiver address may not be the desired interface for the path from the source. In such cases, the desired interface should be specified explicitly as the receiver.

Directing the response

Unless the number of hops to trace is explicitly set with the hop option, mtrace first attempts to trace the full reverse path by default. If there is no response within a 3 second timeout interval, a "*" is displayed and the probing switches to hop-by-hop mode. Trace queries are issued starting with a maximum hop count of one and increasing by one until the full path is traced or no response is received. At each hop, multiple probes are sent. The first attempt is made with the unicast address of the host running mtrace as the destination for the response. Since the unicast route may be blocked, the remainder of attempts request that the response be multicast to mtrace.mcast.net (224.0.1.32) with the TTL set to 32 more than what is needed to pass the thresholds seen so far along the path to the receiver. For the final attempts, the TTL is increased by another 32.

Alternatively, the TTL may be set explicitly with the TTL option.

The output of mtrace is a short listing of the hops in the order they are queried, that is, in the reverse of the order from the source to the receiver. For each hop, a line is displayed showing:

  • the hop number (counted negatively to indicate that this is the reverse path)

  • the multicast routing protocol

  • the threshold required to forward data (to the previous hop in the listing as indicated by the up-arrow character)

  • the cumulative delay for the query to reach that hop (valid only if the clocks are synchronized)

The response ends with a line showing the round-trip time, which measures the interval from the time the query is issued until the response is received, both derived from the local system clock.

Mtrace packets use special IGMP packets with IGMP type codes of 0x1E and 0x1F.

Mrinfo

The mrinfo feature is a simple mechanism to display configuration information from the target multicast router. The type of information displayed includes the multicast capabilities of the router, code version, metrics, TTL thresholds, protocols, and status. This information can be used by network operators to verify if bidirectional adjacencies exist. When the specified multicast router responds, the configuration is displayed.

Configuration guidelines for 7210 SAS

The following are the configuration guidelines for the 7210 SAS:

  • 7210 SAS platforms can be used as RPs.

  • Static RP configuration using PIM BSR messages is supported.

  • It is possible to configure the 7210 SAS as a First Hop Multicast router (FHR) from the source in a PIM-SM network.

  • 7210 SAS devices provide an option to either switch over to the SPT or continue to use the shared tree. However, the traffic rate threshold cannot be configured to trigger the switch over.

  • RFP checks are performed using the unicast routing table. Multicast BGP and multicast routing table are not supported.

Configuring multicast parameters with CLI

This section provides information to configure multicast, IGMP, and PIM.

Multicast configuration overview

7210 SAS routers use IGMP to manage membership for a specific multicast session. IGMP is not enabled by default. The IGMP context is not operational until at least one IGMP interface is specified in the context, at which time the interface is enabled for IGMP.

Traffic can only flow away from the router to an IGMP interface, and to and from a PIM interface. A router directly connected to a source must have PIM enabled on the interface to that source. In a network, traffic travels from PIM interface to PIM interface, and arrives on an IGMP-enabled interface.

The IGMP CLI context allows you to specify an existing IP interface and modify the interface-specific parameters. Static IGMP group memberships can be configured to test multicast forwarding without a receiver host. When IGMP static group membership is enabled, data is forwarded to an interface without receiving membership reports from host members.

When static IGMP group entries on point-to-point links that connect routers to a rendezvous point (RP) are configured, the static IGMP group entries do not generate join messages toward the RP. When a host needs to receive multicast sessions, it sends a join message for each multicast group it needs to join. Then, a leave message may be sent for each multicast group it no longer wishes to participate with.

A multicast router keeps a list of multicast group memberships for each attached network, and an interval timer for each membership. Hosts issue a Multicast Group Membership Report when they want to receive a multicast session. The reports are sent to all multicast routers.

PIM is not enabled by default. Because it is an interface function, PIM is not operational until at least one interface is specified in the PIM context, at which time the interface is enabled for PIM. When PIM is enabled, data is forwarded to network segments with active receivers that have explicitly requested the multicast group.

Basic configuration

Perform the following basic multicast configuration tasks.

For IGMP:

  • enable IGMP (required)

  • configure IGMP interfaces (required)

  • specify the IGMP version on the interface (optional)

  • configure static (S,G)/(*,G) (optional)

  • configure SSM translation (optional)

For PIM:

  • enable PIM (required)

  • add interfaces so the protocol establishes adjacencies with the neighboring routers (required)

  • configure a way to calculate group-to-RP mapping (required) by either:

    • using static group-to-RP mapping

    • enabling the candidate RP/bootstrap mechanism on some routers.

  • enable unicast routing protocols to learn routes toward the RP/source for reverse path forwarding (required)

  • add SSM ranges (optional)

  • enable Candidate BSR (optional)

  • enable Candidate RP (optional)

  • change the hello interval (optional)

  • configure route policies (bootstrap-export, bootstrap-import, import join and register)

Enabled IGMP and PIM configuration output

A:LAX>config>router>igmp# info
----------------------------------------------
interface "lax-vls"
exit
interface "p1-ix"
exit
----------------------------------------------
*A:Dut-B>config>router>igmp# info detail 
----------------------------------------------
            interface "C_Rx"
                no import
                version 3
                subnet-check
                no max-groups
                no max-sources
                no max-grp-sources
                no disable-router-alert-check
                no query-interval
                no query-last-listener-interval
                no query-response-interval
                no shutdown
            exit
            no grp-if-query-src-ip
            query-interval 125
            query-last-member-interval 1
            query-response-interval 10
            robust-count 2
            no shutdown
----------------------------------------------
A:7210SAS>config>router>igmp# exit
A:7210SAS>config>router# pim
A:7210SAS>config>router>pim# info
----------------------------------------------
            interface "lax-vls"
            exit
            interface "lax-vls"
            exit
            interface "lax-sjc"
            exit
            interface "p1-ix"
            exit
            rp
                static
                    address 239.22.187.237
                        group-prefix 239.24.24.24/32
                    exit
                exit
                    shutdown
bsr-candidate
                exit
                rp-candidate
                    shutdown
                exit
            exit
----------------------------------------------
A:7210SAS>config>router>pim# info detail
----------------------------------------------
            no import join-policy
            no import register-policy
            interface "system"
                priority 1
                hello-interval 30
                multicast-senders auto
                no tracking-support
                no shutdown
            exit
            interface "lax-vls"
                priority 1
                hello-interval 30
                multicast-senders auto
                no tracking-support
                no shutdown
            exit
            interface "lax-sjc"
                priority 1
                hello-interval 30
                multicast-senders auto
                no tracking-support
                no shutdown
            exit
            interface "p1-ix"
                priority 1
                hello-interval 30
                multicast-senders auto
                no tracking-support
                no shutdown
            exit
            apply-to none
            rp
                no bootstrap-import
                no bootstrap-export
                static
                    address 239.22.187.237
                        no override
                        group-prefix 239.24.24.24/32
                    exit
                exit
                    shutdown
                    priority 0
                    hash-mask-len 30
                    no address
                exit
                rp-candidate
                    shutdown
bsr-candidate
                    no address
                    holdtime 150
                    priority 192
                exit
            exit
            no shutdown
----------------------------------------------
A:7210SAS>config>router>pim#

Common configuration tasks

The following sections describe basic multicast configuration tasks.

Configuring IGMP parameters

This section provides information to configure IGMP parameters.

Enabling IGMP

Use the following syntax to enable IGMP.

config>router# igmp
Enabled IGMP detailed output
A:7210SAS>>config>router# info detail
...
#------------------------------------------
echo "IGMP Configuration"
#------------------------------------------
        igmp
            query-interval 125
            query-last-member-interval 1
            query-response-interval 10
            robust-count 2
            no shutdown
        exit
#------------------------------------------
A:7210SAS>>config>system#

Configuring an IGMP interface

Use the following syntax to configure an IGMP interface.

config>router# igmp
    interface ip-int-name
    max-groups value
    import policy-name
    version version
    no shutdown
IGMP interface configuration command usage
 config>router#
     config>router>igmp# interface "lax-vls" 
     config>router>igmp>if? no shutdown
     config>router>igmp>if# exit
     config>router>igmp# interface "p1-ix" 
     config>router>igmp>if? no shutdown
     config>router>igmp>if# exit
     config>router>igmp# interface "lax-sjc" 
     config>router>igmp>if? no shutdown
     config>router>igmp>if# exit
IGMP configuration output
A:7210SAS>config>router>igmp# info
----------------------------------------------
        interface "lax-sjc"
        exit
        interface "lax-vls"
        exit
        interface "p1-ix"
        exit
----------------------------------------------
A:7210SAS>config>router>igmp# exit

Configuring static parameters

Use the following syntax to add an IGMP static multicast source.

config>router# igmp
    interface ip-int-name
    no shutdown
    static
        group grp-ip-address
            source ip-address
Command usage

Use the following syntax to configure static group addresses and source addresses for the SSM translate group ranges.

 config>router>igmp# interface lax-vls
     config>router>igmp>if# static
     config>router>igmp>if>static# group 239.255.0.2
     config>router>igmp>if>static>group#  source 172.22.184.197
     config>router>igmp>if>static>group# exit
     config>router>igmp>if>static# exit
     config>router>igmp>if# exit
Configuration output
A:LAX>config>router>igmp# info
----------------------------------------------
        interface "lax-sjc"
        exit
        interface "lax-vls"
            static
                group 239.255.0.2
                    source 172.22.184.197
                exit
            exit
        exit
        interface "p1-ix"
        exit
----------------------------------------------
A:LAX>config>router>igmp#

Use the following syntax to add an IGMP static starg entry.

 config>router# igmp
     interface ip-int-name
     no shutdown
     static
         group grp-ip-address
             starg
Command usage

Use the following syntax to configure static group addresses and add a static (*,G) entry.

 config>router>igmp# interface lax-sjc
     config>router>igmp>if# static
     config>router>igmp>if>static# group 239.1.1.1
     config>router>igmp>if>static>group# starg
     config>router>igmp>if>static>group# exit
     config>router>igmp>if>static# exit
     config>router>igmp>if# exit
     config>router>igmp# 
Configuration output
A:LAX>config>router>igmp# info
----------------------------------------------
        interface "lax-sjc"
            static
                group 239.1.1.1
                    starg
                exit
            exit
        exit
        interface "lax-vls"
            static
                group 239.255.0.2
                    source 172.22.184.197
                exit
            exit
        exit
        interface "p1-ix"
        exit
----------------------------------------------
A:LAX>config>router>igmp#

Configuring SSM translation

Use the following CLI syntax to configure IGMP parameters.

config>router# igmp
    ssm-translate
    grp-range start end
        source ip-address
Command usage to configure IGMP parameters
 config>router# igmp
     config>router>igmp# ssm-translate
     config>router>igmp>ssm# grp-range 239.255.0.1 231.2.2.2
     config>router>igmp>ssm>grp-range# source 10.1.1.1
Configuration output
A:LAX>config>router>igmp# info
----------------------------------------------
        ssm-translate
            grp-range 239.255.0.1 239.2.2.2
                source 10.1.1.1
            exit
        exit
        interface "lax-sjc"
            static
                group 239.1.1.1
                    starg
                exit
            exit
        exit
        interface "lax-vls"
            static
                group 239.255.0.2
                    source 172.22.184.197
                exit
            exit
        exit
        interface "p1-ix"
        exit
----------------------------------------------
A:LAX>config>router>igmp# exit

Configuring PIM parameters

The following section describes the syntax used to configure the PIM parameters.

Enabling PIM

PIM must be enabled on all interfaces for the routing instance; failure to do so might result in multicast routing errors.

Use the following syntax to enable PIM.

config>router# pim
Detailed output of an enabled PIM
A:LAX>>config>router# info detail
...
#------------------------------------------
echo "PIM Configuration"
#------------------------------------------
        pim
            no import join-policy
            no import register-policy
            apply-to none
            rp
                no bootstrap-import
                no bootstrap-export
                static
                exit
                    shutdown
                    priority 0
                    hash-mask-len 30
                    no address
                exit
                rp-candidate
                    shutdown
                    no address
                    holdtime 150
                    priority 192
                exit
            exit
            no shutdown
        exit
#------------------------------------------
...
A:LAX>>config>system#

Configuring PIM interface parameters

The following examples show the command usage to configure PIM interface parameters and the resulting configuration outputs.

Command usage 1
 A:LAX>config>router# pim
     A:LAX>config>router>pim# interface "system" 
     A:LAX>config>router>pim>if# exit
     A:LAX>config>router>pim# interface "lax-vls" 
     A:LAX>config>router>pim>if# exit
     A:LAX>config>router>pim# interface "lax-sjc" 
     A:LAX>config>router>pim>if# exit
     A:LAX>config>router>pim# interface "p1-ix" 
     A:LAX>config>router>pim>if# exit
     A:LAX>config>router>pim# rp
     A:LAX>config>router>pim>rp# static
     A:LAX>config>router>pim>rp>static# address 239.22.187.237
     A:LAX>config>router>..>address# group-prefix 239.24.24.24/32
     A:LAX>config>router>pim>rp>static>address# exit
     A:LAX>config>router>pim>rp>static# exit
     A:LAX>config>router>pim>rp# exit
Configuration output 1
A:LAX>config>router>pim# info
----------------------------------------------
            interface "system"
            exit
            interface "lax-vls"
            exit
            interface "lax-sjc"
            exit
            interface "p1-ix"
            exit
            rp
                static
                    address 239.22.187.237
                        group-prefix 239.24.24.24/32
                    exit
                    address 10.10.10.10
                    exit
                exit
                    shutdown
bsr-candidate
                exit
                rp-candidate
                    shutdown
                exit
            exit
----------------------------------------------
A:LAX>config>router>pim#

Command usage 2
 A:SJC>config>router# pim
     A:SJC>config>router>pim# interface "system" 
     A:SJC>config>router>pim>if# exit
     A:SJC>config>router>pim# interface "sjc-lax" 
     A:SJC>config>router>pim>if# exit
     A:SJC>config>router>pim# interface "sjc-nyc" 
     A:SJC>config>router>pim>if# exit
     A:SJC>config>router>pim# interface "sjc-sfo" 
     A:SJC>config>router>pim>if# exit
     A:SJC>config>router>pim# rp
     A:SJC>config>router>pim>rp# static
     A:SJC>config>router>pim>rp>static# address 239.22.187.237
     A:SJC>config>router>pim>rp>static>address# group-prefix 239.24.24.24/32
     A:SJC>config>router>pim>rp>static>address# exit
     A:SJC>config>router>pim>rp>static# exit
     A:SJC>config>router>pim>rp# exit
     A:SJC>config>router>pim# 
Configuration output 2

A:SJC>config>router>pim# info
----------------------------------------------
            interface "system"
            exit
            interface "sjc-lax"
            exit
            interface "sjc-nyc"
            exit
            interface "sjc-sfo"
            exit
            rp
                static
                    address 239.22.187.237
                        group-prefix 239.24.24.24/32
                    exit
                exit
                    shutdown
bsr-candidate
                exit
                rp-candidate
                    shutdown
                exit
            exit
----------------------------------------------
A:SJC>config>router>pim#
Command usage 3
 A:MV>config>router# pim
     A:MV>config>router>pim# interface "system" 
     A:MV>config>router>pim>if# exit
     A:MV>config>router>pim# interface "mv-sfo" 
     A:MV>config>router>pim>if# exit
     A:MV>config>router>pim# interface "mv-v1c" 
     A:MV>config>router>pim>if# exit
     A:MV>config>router>pim# interface "p3-ix" 
     A:MV>config>router>pim>if# exit
     A:MV>config>router>pim# rp
     A:MV>config>router>pim>rp# static
     A:MV>config>router>pim>rp>static# address 239.22.187.237
     A:MV>config>router>pim>rp>static>address# group-prefix 239.24.24.24/32
     A:MV>config>router>pim>rp>static>address# exit
     A:MV>config>router>pim>rp>static#
     A:MV>config>router>pim>rp# exit
     A:MV>config>router>pim# 
Configuration output 3

A:MV>config>router>pim# info
----------------------------------------------
            interface "system"
            exit
            interface "mv-sfo"
            exit
            interface "mv-vlc"
            exit
            interface "p3-ix"
            exit
            rp
                static
                    address 239.22.187.237
                        group-prefix 239.24.24.24/32
                    exit
                exit
                    address 239.22.187.236
                    no shutdown
                exit
                rp-candidate
                    address 239.22.187.236
                    no shutdown
bsr-candidate
                exit
            exit
----------------------------------------------
A:MV>config>router>pim#
Command usage 4
 A:SFO>config>router# pim
     A:SFO>config>router>pim# interface "system" 
     A:SFO>config>router>pim>if# exit
     A:SFO>config>router>pim# interface "sfo-sfc" 
     A:SFO>config>router>pim>if# exit
     A:SFO>config>router>pim# interface "sfo-was" 
     A:SFO>config>router>pim>if# exit
     A:SFO>config>router>pim# interface "sfo-mv" 
     A:SFO>config>router>pim>if# exit
     A:SFO>config>router>pim# rp
     A:SFO>config>router>pim>rp# static
     A:SFO>config>router>pim>rp>static# address 239.22.187.237
     A:SFO>config>router>pim>rp>static>address# group-prefix 239.24.24.24/32
     A:SFO>config>router>pim>rp>static>address# exit
     A:SFO>config>router>pim>rp>static# exit
     A:SFO>config>router>pim>rp # exit
     A:SFO>config>router>pim# 
Configuration output 4
A:SFO>config>router>pim# info
----------------------------------------------
            interface "system"
            exit
            interface "sfo-sjc"
            exit
            interface "sfo-was"
            exit
            interface "sfo-mv"
            exit
            rp
                static
                    address 239.22.187.237
                        group-prefix 239.24.24.24/32
                    exit
                exit
                    address 239.22.187.239
                    no shutdown
                exit
                rp-candidate
                    address 239.22.187.239
                    no shutdown
bsr-candidate
                exit
            exit
----------------------------------------------
A:SFO>config>router>pim#
Command usage 5
 A:WAS>config>router# pim
     A:WAS>config>router>pim# interface "system" 
     A:WAS>config>router>pim>if# exit
     A:WAS>config>router>pim# interface "was-sfo" 
     A:WAS>config>router>pim>if# exit
     A:WAS>config>router>pim# interface "was-vlc" 
     A:WAS>config>router>pim>if# exit
     A:WAS>config>router>pim# interface "p4-ix" 
     A:WAS>config>router>pim>if# exit
     A:WAS>config>router>pim# rp
     A:WAS>config>router>pim>rp# static
     A:WAS>config>router>pim>rp>static# address 239.22.187.237
     A:WAS>config>router>pim>rp>static>address# group-prefix 239.24.24.24/32
     A:WAS>config>router>pim>rp>static>address# exit
     A:WAS>config>router>pim>rp>static# exit
     A:WAS>config>router>pim>rp# exit
     A:WAS>config>router>pim#
Configuration output 5

A:WAS>config>router>pim# info
----------------------------------------------
            interface "system"
            exit
            interface "was-sfo"
            exit
            interface "was-vlc"
            exit
            interface "p4-ix"
            exit
            rp
                static
                    address 239.22.187.237
                        group-prefix 239.24.24.24/32
                    exit
                exit
                    address 239.22.187.240
                    no shutdown
                exit
                rp-candidate
                    address 239.22.187.240
                    no shutdown
bsr-candidate
                exit
            exit
----------------------------------------------
A:WAS>config>router>pim#

Importing PIM join or register policies

The import command provides a mechanism to control the (*,G) and (S,G) state that is created on a router. Import policies are defined in the config>router>policy-options context.

Note:

In the import policy, if a policy action is not specified in the entry, the default-action takes precedence. In the same way, if there are no entry matches, the default-action takes precedence. If no default-action is specified, the default default-action is executed.

Use the following syntax to configure PIM parameters.

config>router# pim 
    import {join-policy|register-policy} [policy-name] 
[.. policy-name]
Applying the policy statement

The following example shows the command usage to apply the policy statement, which does not allow join messages for group 229.50.50.208/32 and source 192.168.0.0/16, but allows join messages for 192.168.0.0/16, 229.50.50.208 (see Configuring route policy components).

 config>router# pim
     config>router>pim# import join-policy "foo"
     config>router>pim# no shutdown
PIM configuration output
A:LAX>config>router>pim# info
----------------------------------------------
            import join-policy "foo"
            interface "system"
            exit
            interface "lax-vls"
            exit
            interface "lax-sjc"
            exit
            interface "p1-ix"
            exit
            rp
                static
                    address 239.22.187.237
                        group-prefix 239.24.24.24/3
                    exit
                    address 10.10.10.10
                    exit
                exit
                    shutdown
                exit
                rp-candidate
                    shutdown
                exit
            exit
----------------------------------------------
A:LAX>config>router>pim# 

Disabling IGMP or PIM

Use the following syntax to disable IGMP and PIM.

config>router# 
    igmp
    shutdown
    pim
    shutdown

Command usage to disable multicast

 config>router# igmp
     config>router>igmp# shutdown
     config>router>igmp# exit
     config>router#
     config>router# pim
     config>router>pim# shutdown
     config>router>pim# exit

Configuration output

A:LAX>config>router# info
----------------------------------------------
...
#------------------------------------------
echo "IGMP Configuration"
#------------------------------------------
        igmp
            shutdown
            ssm-translate
                grp-range 239.255.0.1 231.2.2.2
                    source 10.1.1.1
                exit
            exit
            interface "lax-sjc"
                static
                    group 239.1.1.1
                        starg
                    exit
                exit
            exit
            interface "lax-vls"
                static
                    group 239.255.0.2
                        source 172.22.184.197
                    exit
                exit
            exit
            interface "p1-ix"
            exit
        exit
#------------------------------------------

echo "PIM Configuration"
#------------------------------------------
        pim
            shutdown
            import join-policy "foo"
            interface "system"
            exit
            interface "lax-sjc"
            exit
            interface "lax-vls"
            exit
            interface "p1-ix"
            exit
            rp
                static
                    address 239.22.187.237
                        group-prefix 239.24.24.24/32
                    exit
                    address 10.10.10.10
                    exit
                exit
                    shutdown
                exit
                rp-candidate
                    shutdown
bsr-candidate
                exit
            exit
        exit
#------------------------------------------
....
------------------------------------------
A:LAX>config>router# 

Multicast command reference

Command hierarchies

IGMP commands

config
    - router
        - [no] igmp
            - [no] interface ip-int-name
                - [no] disable-router-alert-check 
                - import policy-name
                - no import
                - max-groups [value]
                - no max-groups
                - max-sources [value]
                - no max-sources
                - query-interval seconds
                - no query-interval
                - query-last-listener-interval seconds
                - no query-last-listener-interval
                - query-response-interval seconds
                - no query-response-interval
                - [no] shutdown
                - ssm-translate
                    - [no] grp-range start end
                        - [no] source ip-address
                - static
                    - [no] group grp-ip-address
                        - [no] source ip-address
                        - [no] starg
                - [no] subnet-check
                - version version
                - no version
            - query-interval seconds
            - no query-interval
            - query-last-member-interval seconds
            - no query-last-member-interval
            - query-response-interval seconds
            - no query-response-interval
            - robust-count robust-count
            - no robust-count
            - [no] shutdown
            - ssm-translate
                - [no] grp-range start end
                    - [no] source ip-address

PIM commands

config
    - router
        - [no] pim
            - [no] enable-mdt-spt
            - import {join-policy | register-policy} policy-name [policy-name (up to 5 max)]
            - no import {join-policy | register-policy}
            - [no] interface ip-int-name
                - assert-period assert-period
                - no assert-period
                - [no] bfd-enable [ipv4]
                - [no] bsm-check-rtr-alert
                - hello-interval hello-interval
                - no hello-interval
                - hello-multiplier deci-units
                - no hello-multiplier
                - [no] improved-assert
                - [no] instant-prune-echo
                - max-groups value
                - no max-groups
                - multicast-senders {auto | always | never}
                - no multicast-senders
                - priority dr-priority
                - no priority
                - [no] shutdown
                - sticky-dr [priority dr-priority]
                - no sticky-dr
                - three-way-hello [compatibility-mode]
                - no three-way-hello
                - [no] tracking-support
            - [no] mc-ecmp-balance
            - mc-ecmp-balance-hold minutes
            - no mc-ecmp-balance-hold
            - [no] mc-ecmp-hashing-enabled
            - [no] non-dr-attract-traffic
                - rp
                    - [no] anycast rp-ip-address
                        - [no] rp-set-peer ip-address
                    - bootstrap-export policy-name [.. policy-name ...(up to 5 max)]
                    - no bootstrap-export
                    - bootstrap-import policy-name [.. policy-name ...(up to 5 max)]
                    - no bootstrap-import
                    - bsr-candidate
                        - address ip-address
                        - no address
                        - hash-mask-len hash-mask-length
                        - no hash-mask-len
                        - priority bootstrap-priority
                        - no priority
                        - [no] shutdown
                    - rp-candidate
                        - address ip-address
                        - no address
                        - [no] group-range {grp-ip-address/mask | grp-ip-address  netmask}
                        - holdtime holdtime
                        - no holdtime
                        - priority priority
                        - no priority
                        - [no] shutdown
                    - static
                        - [no] address ip	-address
                            - [no] group-prefix {grp-ip-address/mask | grp-ip-address netmask}
                            - [no] override
            - [no] rpf-table rtable-u
            - [no] shutdown
            - spt-switchover-threshold {grp-ipv4-prefix/ipv4-prefix-length | grp-ipv4-prefix netmask} spt-threshold
            - no spt-switchover-threshold {grp-ipv4-prefix/ipv4-prefix-length | grp-ipv4-prefix netmask}
            - ssm-assert-compatible-mode [enable | disable]
            - ssm-default-range-disable ipv4
            - no ssm-default-range-disable ipv4
            - [no] ssm-groups
                - [no] group-range {ip-prefix/mask | ip-prefix netmask}

Operational commands

<GLOBAL>

    - mrinfo ip-address | dns-name [router router-instance | service-name service-name] 
    - mtrace source ip-address | dns-name group ip-address | dns-name] [destination ip-address | dns-name] [hop hop] [router router-instance | service-name service-name] [wait-time wait-time]

Show commands

show
    - router 
        - igmp
            - group [grp-ip-address] [host | interface | saps]
            - group summary [host | interface | saps]
            - interface [ip-int-name | ip-address] [group] [grp-ip-address] [detail]
            - ssm-translate interface-name
            - static [ip-int-name | ip-addr]
            - statistics [ip-int-name | ip-address]
            - status
show
    - router
        - pim
            - anycast [family] [detail]
            - crp [family | ip-address]
            - group [grp-ip-address] [source ip-address] [type {starstarrp | starg | sg}] [detail] [family]
            - interface [ip-int-name | int-ip-address] [group group-ip-address source ip-address] [type {starstarrp | starg | sg}] [detail] [family] 
            - mc-ecmp-balance
            - neighbor [ip-address | ip-int-name [address neighbor-ip-address]] [detail] [family]
            - rp [family | ip-address]
            - rp-hash ip-address
            - statistics [ip-int-name | int-ip-address | mpls-if-name] [family]
            - status [detail] [family]

Clear commands

clear
    - router
        - igmp
            - database [group grp-ip-address [source src-ip-address]]
            - database interface {ip-int-name | ip-address} [group grp-ip-address [source src-ip-address]]
            - database host ip-address [group grp-ip-address [source src-ip-address]]
            - database host all [group grp-ip-address [source src-ip-address]]
            - database group-interface all
            - statistics group-interface [fwd-service service-id] ip-int-name
            - statistics group-interface all
            - statistics host ip-address
            - statistics host all
            - statistics [interface ip-int-name | ip-address]
            - version group-interface [fwd-service service-id] ip-int-name
            - version group-interface all
            - version host ip-address
            - version host all
            - version [interface ip-int-name | ip-address]
        - pim
            - database [interface ip-int-name | int-ip-address] [group grp-ip-address [source ip-address]][family]
            - neighbor [interface ip-int-name] [family]
            - statistics [{[interface ip-int-name | int-ip-address]} {[group grp-ip-address [source ip-address]]}] [family]]
clear
    - service
        - id
            - igmp-snooping
                - port-db sap sap-id [group grp-ip-address [source src-ip-address]]
                - port-db sdp sdp-id:vc-id [group grp-ip-address [source src-ip-address]]
                - querier
                - statistics [all | sap sap-id | sdp sdp-id:vc-id]

Debug commands

debug
    - router
        - igmp
            - [no] group-interface [fwd-service service-id] [ip-int-name]
            - [no] interface [ip-int-name | ip-address]
            - [no] misc
            - no packet [query | v1-report | v2-report | v3-report | v2-leave] group-interface ip-int-name
            - no packet [query | v1-report | v2-report | v3-report | v2-leave] host ip-int-name
            - packet [query | v1-report | v2-report | v3-report | v2-leave] [ip-int-name | ip-int-name] [mode {dropped-only | ingr-and-dropped | egr-ingr-and-dropped}]
            - packet [query | v1-report | v2-report | v3-report | v2-leave] [mode {dropped-only | ingr-and-dropped | egr-ingr-and-dropped}] group-interface ip-int-name
            - packet [query | v1-report | v2-report | v3-report | v2-leave] host ip-address [mode {dropped-only | ingr-and-dropped | egr-ingr-and-dropped}]
debug
    - router
        - pim
            - [no] adjacency
            - all [group grp-ip-address] [source ip-address] [detail]
            - no all
            - assert [group grp-ip-address] [source ip-address] [detail]
            - no assert
            - bgp [source ip-address] [group group-ip-address] [peer peer-ip-address]
            - no bgp
            - bsr [detail]
            - no bsr
            - data [group grp-ip-address] [source ip-address] [detail]
            - no data
            - db [group grp-ip-address] [source ip-address] [detail]
            -  no db
            - interface [ip-int-name | mt-int-name| ip-address] [detail]
            - no interface
            - jp [group grp-ip-address] [source ip-address] [detail]
            - no jp
            - mrib[group grp-ip-address] [source ip-address] [detail]
            - no mrib
            - msg [detail]
            - no msg
            - packet [hello | register | register-stop | jp | bsr | assert] [ip-int-name | int-ip-address]
            - no packet
            - red [detail]
            - no red
            - register [group grp-ip-address] [source ip-address] [detail]
            - no register
            - rtm [detail]
            - no rtm

Command descriptions

Configuration commands

Generic commands
shutdown
Syntax

[no] shutdown

Context

config>router>igmp

config>router>igmp>interface

config>router>pim

config>router>pim>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command administratively disables the entity. When disabled, an entity does not change, reset, or remove any configuration settings or statistics. Many entities must be explicitly enabled using the no shutdown command.

Unlike other commands and parameters where the default state is not indicated in the configuration file, shutdown and no shutdown are always indicated in system-generated configuration files.

The no form of this command puts an entity into the administratively enabled state.

Default

no shutdown:

config>router>igmp

config>router>igmp>interface ip-int-name

config>router>pim

Multicast commands
ssm-translate
Syntax

ssm-translate

Context

config>router>igmp>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command adds or removes SSM translate group ranges.

source
Syntax

[no] source ip-address

Context

config>router>igmp>interface>shutdown>ssm-translate>grp-range

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command adds or removes source addresses for the SSM translate group range.

Parameters
ip-address

Specifies the unicast source address.

Values

a.b.c.d

grp-range
Syntax

[no] grp-range start end

Context

config>router>igmp>interface>shutdown>ssm-translate

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command adds or removes SSM translate group range entries.

Parameters
start

Specifies the multicast group range start address.

Values

a.b.c.d

end

Specifies the multicast group range end address.

Values

a.b.c.d

mc-maximum-routes
Syntax

mc-maximum-routes number[log-only][threshold threshold]

no mc-maximum-routes

Context

config>router

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the maximum number of multicast routes that can be held within a VPN routing/forwarding (VRF) context. When this limit is reached, a log and SNMP trap are sent. If the log-only parameter is not specified and the maximum-routes value is set below the existing number of routes in a VRF, no new joins will be processed.

The no form of this command disables the limit of multicast routes within a VRF context. Issue the no form of this command only when the VPRN instance is shutdown.

Default

no mc-maximum-routes

Parameters
number

Specifies the maximum number of routes to be held in a VRF context.

Values

1 to 2147483647

log-only

Keyword to specify that if the maximum limit is reached, only log the event. This keyword does not disable the learning of new routes.

threshold

Specifies the percentage at which a warning log message and SNMP trap are sent.

Values

0 to 100

Router IGMP commands
igmp
Syntax

[no] igmp

Context

config>router

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables the Internet Group Management Protocol (IGMP) context. When the context is created, IGMP is enabled.

IGMP is used by IPv4 systems (hosts and routers) to report their IP multicast group memberships to neighboring multicast routers. An IP multicast router can be a member of one or more multicast groups, in which case it performs both the ‟multicast router part” of the protocol, which collects the membership information needed by its multicast routing protocol, and the ‟group member part” of the protocol, which informs it and other neighboring multicast routers of its memberships.

The no form of this command disables the IGMP instance. To start or suspend execution of IGMP without affecting the configuration, use the no shutdown command.

interface
Syntax

[no] interface ip-int-name

Context

config>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure an IGMP interface. The interface is a local identifier of the network interface on which reception of the specified multicast address is to be enabled or disabled.

The no form of this command deletes the IGMP interface. The shutdown command in the config>router>igmp>interface context can be used to disable an interface without removing the configuration for the interface.

Default

no interface

Parameters
ip-int-name

Specifies the IP interface name. Interface names must be unique within the group of defined IP interfaces for the config>router>interface and config>service>ies>interface commands. An interface name cannot be in the form of an IP address. Interface names can be any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.

If the IP interface name does not exist or does not have an IP address configured, an error message is returned.

If the IP interface exists in a different area, it will be moved to this area.

disable-router-alert-check
Syntax

[no] disable-router-alert-check

Context

config>router>igmp>if

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables the router alert checking for IGMP messages received on this interface.

The no form of this command disables the IGMP router alert check option.

import
Syntax

import policy-name

no import

Context

configure>router>igmp>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command applies the referenced IGMP policy (filter) to an interface subscriber or a group interface. An IGMP filter is also known as an allowlist/denylist and it is defined under the configure>router>policy-options context.

The no form of this command removes the policy association from the IGMP instance.

Default

no import

Parameters
policy-name

Specifies the route policy name. Allowed values are any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on.), the entire string must be enclosed within double quotes. Route policies are configured in the config>router>policyoptions context.

max-groups
Syntax

max-groups [value]

no max-groups

Context

config>router>igmp>if

config>router>pim>if

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the maximum number of groups for which IGMP can have local receiver information based on received IGMP reports on this interface. When this configuration is changed dynamically to a value lower than the currently accepted number of groups, the groups that are already accepted are not deleted. Only new groups will not be allowed. When the value is 0, there is no limit to the number of groups. This command is applicable for IPv4 only.

Default

max-groups 0

Parameters
value

Specifies the maximum number of groups for this interface.

Values

1 to 900 (for the 7210 SAS-K 2F6C4T)

1 to 950 (for the 7210 SAS-K 3SFP+ 8C)

max-sources
Syntax

max-sources [value]

no max-sources

Context

config>router>igmp>if

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the maximum number of group sources for this interface

Parameters
value

Specifies the maximum number of group sources that can be configured.

Values

1 to 1000

query-last-listener-interval
Syntax

query-last-listener-interval seconds

no query-last-listener-interval

Context

config>router>igmp>if

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the frequency at which the querier sends group-specific query messages, including messages sent in response to leave-group messages. The lower the interval, the faster the detection of the loss of the last member of a group.

Default

no query-last-listener-interval

Parameters
seconds

Specifies the frequency, in seconds, at which the router transmits group-specific host-query messages.

Values

1 to 1023

static
Syntax

static

Context

config>router>igmp>if

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command tests multicast forwarding on an interface without a receiver host. When enabled, data is forwarded to an interface without receiving membership reports from host members.

group
Syntax

[no] group grp-ip-address

Context

config>router>igmp>if>static

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command adds a static multicast group either as a (*,G) or one or more (S,G) records. Use IGMP static group memberships to test multicast forwarding without a receiver host. When IGMP static groups are enabled, data is forwarded to an interface without receiving membership reports from host members.

When static IGMP group entries on point-to-point links that connect routers to a rendezvous point (RP) are configured, the static IGMP group entries do not generate join messages toward the RP.

Parameters
grp-ip-address

Specifies an IGMP multicast group address that receives data on an interface. The IP address must be unique for each static group.

Values

a.b.c.d

source
Syntax

[no] source ip-address

Context

config>router>igmp>if>static>group

config>router>igmp>ssm-translate>grp-range

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies an IPv4 unicast address that sends data on an interface. This enables a multicast receiver host to signal to a router the group from which to receive multicast traffic, and the sources from which the traffic is expected.

The source command is mutually exclusive with the specification of individual sources for the same group.

The source command in combination with the group is used to create a specific (S,G) static group entry.

The no form of this command removes the source from the configuration.

Parameters
ip-address

Specifies the IPv4 unicast address.

Values

a.b.c.d

starg
Syntax

[no] starg

Context

config>router>igmp>if>static>group

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command adds a static (*,G) entry. This command can only be enabled if no existing source addresses for this group are specified.

The no form of this command is used to remove the starg entry from the configuration.

subnet-check
Syntax

[no] subnet-check

Context

config>router>igmp>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables subnet checking for IGMP messages received on this interface. All IGMP packets with a source address that is not in the local subnet are dropped.

The no form of this command disables subnet checking.

Default

subnet-check

version
Syntax

version version

no version

Context

config>router>igmp>if

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the IGMP version. If routers run different versions of IGMP, they will negotiate the lowest common version of IGMP that is supported by hosts on their subnet and operate in that version. For IGMP to function correctly, all routers on a LAN should be configured to run the same version of IGMP on that LAN.

For IGMPv3, a multicast router that is also a group member performs both parts of IGMPv3, receiving and responding to its own IGMP message transmissions as well as those of its neighbors.

Default

version 3

Parameters
version

Specifies the IGMP version number.

Values

1, 2, 3

query-interval
Syntax

query-interval seconds

no query-interval

Context

config>router>igmp

config>router>igmp>if

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the frequency at which the querier router transmits general host-query messages. The host-query messages solicit group membership information and are sent to the all-systems multicast group address, 224.0.0.1.

Default

query-interval 125

Parameters
seconds

Specifies the time frequency, in seconds, that the router transmits general host-query messages.

Values

2 to 1024

query-last-member-interval
Syntax

query-last-member-interval seconds

Context

config>router>igmp

config>router>igmp>if

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the frequency at which the querier sends group-specific query messages, including messages sent in response to leave-group messages. The lower the interval, the faster the detection of the loss of the last member of a group.

Default

query-last-member-interval 1

Parameters
seconds

Specifies the frequency, in seconds, at which query messages are sent.

Values

1 to 1024

query-response-interval
Syntax

query-response-interval seconds

Context

config>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies how long the querier router waits to receive a response to a host-query message from a host.

Default

query-response-interval 10

Parameters
seconds

Specifies the length of time to wait to receive a response to the host-query message from the host.

Values

1 to 1023

robust-count
Syntax

robust-count robust-count

no robust-count

Context

config>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the robust count. The robust-count variable allows tuning for the expected packet loss on a subnet. If a subnet anticipates losses, the robust-count variable can be increased.

Default

robust-count 2

Parameters
robust-count

Specifies the robust count value.

Values

2 to 10

ssm-translate
Syntax

ssm-translate

Context

config>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure group ranges, which are translated to source-specific multicast (SSM) (S,G) entries. If the static entry needs to be created, it has to be translated from an IGMPv1 or IGMPv2 request to an SSM join. An SSM translate source can only be added if the starg command is not enabled. An error message is generated if you try to configure the source command with the starg command enabled.

grp-range
Syntax

[no] grp-range start end

Context

config>router>igmp>ssm-translate

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command is used to configure group ranges, which are translated to SSM (S,G) entries.

Parameters
start

Specifies an IP address that indicates the start of the group range.

Values

a.b.c.d

end

Specifies an IP address that indicates the end of the group range. This value should always be greater than or equal to the value of the start value.

Values

a.b.c.d

source
Syntax

[no] source ip-address

Context

config>router>igmp>ssm-translate>grp-range

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the source IP address for the group range. Whenever a (*,G) report is received in the range specified by grp-range start and end parameters, it is translated to an (S,G) report with the value of this object as the source address.

Parameters
ip-address

Specifies the IP address that will be sending data.

Values

a.b.c.d

Router PIM commands
pim
Syntax

[no] pim

Context

config>router

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures a protocol independent multicast (PIM) instance.

PIM is used for multicast routing within the network. Devices in the network can receive the multicast feed requested and non-participating routers can be pruned. The router OS supports PIM sparse mode (PIM-SM).

Default

no pim

enable-mdt-spt
Syntax

[no] enable-mdt-spt

Context

config>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command is used to enable SPT switchover for default MDT.

The no form of this command disables SPT switchover for default MDT. If disabled, the PIM instance resets all MDTs and reinitiates setup.

Default

no enable-mdt-spt

import
Syntax

import {join-policy | register-policy}[policy-name[.. policy-name]]

no import {join-policy | register-policy}

Context

config>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the import route policy to be used. Route policies are configured in the config>router>policy-options context.

When an import policy is not specified, BGP routes are accepted by default. Up to five import policy names can be specified.

The no form of this command removes the policy association from the instance.

Default

no import join-policy

no import register-policy

Parameters
join-policy

Keyword to filter PIM join messages, which prevents unwanted multicast streams from traversing the network.

register-policy

Keyword to filter register messages. PIM register filters prevent register messages from being processed by the RP. This filter can only be defined on an RP. When a match is found, the RP immediately sends back a register-stop message.

policy-name

Specifies the route policy name. Allowed values are any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes. Route policies are configured in the config>router>policy-options context.

interface
Syntax

[no] interface ip-int-name

Context

config>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command creates a logical IP routing interface.

Interface names are case-sensitive and must be unique within the group of IP interfaces defined for config>router>interface and config>service>ies>interface. Interface names must not be in the dotted-decimal notation of an IP address. For example, the name ‟1.1.1.1” is not allowed, but ‟int-1.1.1.1” is allowed. Show commands for router interfaces use either the interface names or the IP addresses. Ambiguity can exist if an IP address is used as an IP address and an interface name. Duplicate interface names can exist in different router instances, although this is not recommended because it is confusing.

The no form of this command removes the IP interface and all the associated configurations.

Parameters
ip-int-name

Specifies the name of the IP interface, up to 32 characters. Interface names must be unique within the group of defined IP interfaces for the config router interface and config service ies interface commands. An interface name cannot be in the form of an IP address. If the string contains special characters (#, $, spaces, and so on.), the entire string must be enclosed within double quotes.

If the ip-int-name already exists, the context is changed to maintain that IP interface. If ip-int-name does not exist, the interface is created and the context is changed to that interface for further command processing.

assert-period
Syntax

assert-period assert-period

no assert-period

Context

config>router>pim>if

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the period for periodic refreshes of PIM Assert messages on an interface.

The no form of this command removes the configuration.

Default

no assert-period

Parameters
assert-period

Specifies the period for periodic refreshes of PIM Assert messages on an interface.

Values

1 to 300 seconds

bfd-enable
Syntax

[no] bfd-enable [ipv4]

Context

config>router>pim>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables the use of IPv4 bidirectional forwarding (BFD) to control the state of the associated protocol interface. By enabling BFD on a specific protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set using the BFD command under the IP interface.

The no form of this command removes BFD from the associated IGP protocol adjacency.

For information about the protocols and platforms that support BFD, see the 7210 SAS-D, Dxp, K 2F1C2T, K 2F6C4T, K 3SFP+ 8C Router Configuration Guide.

Default

no bfd-enable

bsm-check-rtr-alert
Syntax

[no] bsm-check-rtr-alert

Context

config>router>pim>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables the checking of the router alert option in the bootstrap messages received on this interface.

The no form of this command enables accepting of BSM packets without the router alert option.

Default

no bsm-check-rtr-alert

mc-ecmp-balance
Syntax

[no] mc-ecmp-balance

Context

configure>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables multicast balancing of traffic over ECMP links. When this command is enabled, each multicast stream that needs to be forwarded over an ECMP link is reevaluated for the total multicast bandwidth utilization. Reevaluation occurs on the ECMP interface in question.

The no form of this command disables multicast balancing.

mc-ecmp-balance-hold
Syntax

mc-ecmp-balance-hold minutes

no mc-ecmp-balance-hold

Context

configure>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the hold time for multicast balancing over ECMP links.

Parameters
minutes

Specifies the hold time, in minutes, that applies after an interface has been added to the ECMP link.

Values

2 to 600

mc-ecmp-hashing-enabled
Syntax

[no] mc-ecmp-hashing-enabled

Context

configure>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables hash-based multicast balancing of traffic over ECMP links and causes PIM joins to be distributed over the multiple ECMP paths based on a hash of S and G (and possibly next-hop IP). When a link in the ECMP set is removed, the multicast streams that were using that link are redistributed over the remaining ECMP links using the same hash algorithm. When a link is added to the ECMP set, new joins may be allocated to the new link based on the hash algorithm, but existing multicast streams using the other ECMP links stay on those links until they are pruned.

Hash-based multicast balancing is supported for IPv4 only.

This command is mutually exclusive with the mc-ecmp-balance command in the same context.

The no form of this command disables the hash-based multicast balancing of traffic over ECMP links.

Default

no mc-ecmp-hashing-enabled

hello-interval
Syntax

hello-interval hello-interval

no hello-interval

Context

config>router>pim>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the frequency at which PIM hello messages are transmitted on this interface.

The no form of this command reverts to the default value.

Default

hello-interval 30

Parameters
hello-interval

Specifies the hello interval in seconds. A 0 (zero) value disables the sending of hello messages (the PIM neighbor will never timeout the adjacency).

Values

0 to 255 seconds

hello-multiplier
Syntax

hello-multiplier deci-units

no hello-multiplier

Context

config>router>pim>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the multiplier to determine the hold time for a PIM neighbor on this interface.

The hello-multiplier in conjunction with the hello-interval determines the hold time for a PIM neighbor.

Parameters
deci-units

Specifies the value, in multiples of 0.1, for the formula used to calculate the hello-hold time based on the hello-multiplier:

(hello-interval * hello-multiplier) / 10

This allows the PIMv2 default timeout of 3.5 seconds to be supported.

Values

20 to 100

Default

35

improved-assert
Syntax

[no] improved-assert

Context

config>router>pim>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

The PIM assert process establishes a forwarder for a LAN and requires interaction between the control and forwarding planes. The assert process is started when data is received on an outgoing interface, meaning that duplicate traffic is forwarded to the LAN until the forwarder is negotiated among the routers.

When the improved-assert command is enabled, the PIM assert process is done entirely in the control plane. The advantages are that it eliminates duplicate traffic forwarding to the LAN. It also improves performance because it removes the required interaction between the control and data planes.

Note:

The improved-assert command is still fully interoperable with the draft-ietf-pim-sm-v2-new-xx, Protocol Independent Multicast - Sparse Mode (PIM-SM): Revised, and RFC 2362, Protocol Independent Multicast-Sparse Mode (PIM-SM), implementations. However, there may be conformance tests that may fail if the tests expect control-data plane interaction in determining the assert winner. Nokia recommends disabling the improved-assert command when performing conformance tests.

Default

enabled

instant-prune-echo
Syntax

[no] instant-prune-echo

Context

config>router>pim>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables a PIM router to echo the PIM prune message received from a downstream router. It is typically used in a multi-access broadcast network (For example: Ethernet LAN) to reduce the probability of loss of PIM prune messages.

Default

no instant-prune-echo

multicast-senders
Syntax

multicast-senders {auto | always | never}

no multicast-senders

Context

config>router>pim>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures how traffic from directly-attached multicast sources should be treated on broadcast interfaces. It can also be used to treat all traffic received on an interface as traffic coming from a directly-attached multicast source. This is particularly useful if a multicast source is connected to a point-to-point or unnumbered interface.

Default

auto

Parameters
auto

Specifies that, on broadcast interfaces, the forwarding plane performs subnet-match checks on multicast packets received on the interface to determine whether the packet is from a directly-attached source. On unnumbered/point-to-point interfaces, all traffic is implicitly treated as coming from a remote source.

always

Specifies that all traffic received on the interface be treated as coming from a directly-attached multicast source.

never

Specifies that, on broadcast interfaces, traffic from directly-attached multicast sources is not forwarded. Traffic from a remote source is still forwarded if there is a multicast state for it. On unnumbered/point-to-point interfaces, all traffic received on that interface must not be forwarded.

priority
Syntax

priority dr-priority

no priority

Context

config>router>pim>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command sets the priority value to elect the designated router (DR). The DR election priority is a 32-bit unsigned number and the numerically larger priority is always preferred.

The no form of this command restores the default values.

Default

priority 1

Parameters
priority

Specifies the priority to become the designated router. The higher the value, the higher the priority.

Values

1 to 4294967295

sticky-dr
Syntax

sticky-dr [priority dr-priority]

no sticky-dr

Context

config>router>pim>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables the sticky-dr operation on this interface. When the operation is enabled, the priority in PIM hello messages sent on this interface when elected as the designated router (DR) are modified to the value configured in dr-priority. This is done to avoid the delays in forwarding caused by DR recovery, when switching back to the old DR on a LAN when it comes back up.

By enabling sticky-dr on an interface, it will continue to act as the DR for the LAN even after the old DR comes back up.

The no form of this command disables the sticky-dr operation on this interface.

Default

no sticky-dr

Parameters
dr-priority

Specifies the DR priority to be sent in PIM Hello messages following the election of that interface as the DR when sticky-dr operation is enabled.

Values

1 to 4294967295

three-way-hello
Syntax

three-way-hello [compatibility-mode]

no three-way-hello

Context

config>router>pim>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the compatibility mode to enable three-way hello. By default, the value is disabled on all interfaces, which specifies that the standard two-way hello is supported. When enabled, the three-way hello is supported.

Default

no three-way-hello

tracking-support
Syntax

[no] tracking-support

Context

config>router>pim>interface

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command sets the T bit in the LAN prune delay option of the hello message. This indicates that the router is capable of enabling join message suppression. This capability allows for upstream routers to explicitly track join membership.

Default

no tracking-support

rp
Syntax

rp

Context

config>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure rendezvous point (RP) parameters. The address of the root of the group shared multicast distribution tree is known as its RP. Packets received from a source upstream and join messages from downstream routers rendezvous at this router.

If this command is disabled, the router cannot become the RP.

anycast
Syntax

[no] anycast rp-ip-address

Context

config>router>pim>rp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures a PIM anycast protocol instance for the RP being configured. Anycast enables fast convergence when a PIM RP router fails by allowing receivers and sources to rendezvous at the closest RP.

The no form of this command removes the anycast instance from the configuration.

Parameters
rp-ip-address

Specifies the loopback IP address shared by all routes that form the RP set for this anycast instance. Only a single address can be configured. If another anycast command is entered with an address, the old address is replaced with the new address. If no IP address is entered, the command is used to enter the anycast CLI level.

Values

a.b.c.d

rp-set-peer
Syntax

[no] rp-set-peer ip-address

Context

config>router>pim>rp>anycast

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures a peer in the anycast RP set. The address identifies the address used by the other node as the RP candidate address for the same multicast group address range as configured on this node.

This is a manual procedure. Caution should be taken to produce a consistent configuration of an RP set for a specific multicast group address range. The priority should be identical on each node and be a higher value than any other configured RP candidate that is not a member of this RP set.

Although there is no set maximum number of addresses that can be configured in an RP set, up to 15 IP addresses is recommended.

The no form of this command removes an entry from the list.

Parameters
ip-address

Specifies a peer in the anycast RP set.

Values

a.b.c.d

bootstrap-export
Syntax

bootstrap-export policy-name[policy-name...(up to 5 max)]

no bootstrap-export

Context

config>router>pim>rp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command applies export policies to control the flow of bootstrap messages from the RP and apply them to the PIM configuration. Up to five policy names can be specified.

Default

no bootstrap-export

Parameters
policy-name

Specifies the export policy name, up to 32 characters.

bootstrap-import
Syntax

bootstrap-import policy-name[..policy-name...(5 maximum)]

no bootstrap-import

Context

config>router>pim>rp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command applies import policies to control the flow of bootstrap messages to the RP, and apply them to the PIM configuration. Up to 5 policy names can be specified.

Default

no bootstrap-import

Parameters
policy-name

Specifies the import policy name, up to 32 characters.

bsr-candidate
Syntax

bsr-candidate

Context

config>router>pim>rp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure Candidate Bootstrap (BSR) parameters.

address
Syntax

address ip-address

Context

config>router>pim>rp>bsr-candidate

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the candidate BSR IP address. This address is for bootstrap router election.

Parameters
ip-address

Specifies the IP host address that will be used by the IP interface within the subnet. This address must be unique within the subnet and specified in dotted-decimal notation.

Values

a.b.c.d

hash-mask-len
Syntax

hash-mask-len hash-mask-length

no hash-mask-len

Context

config>router>pim>rp>bsr-candidate

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command is used to configure the length of a mask that is to be combined with the group address before the hash function is called. All groups with the same hash map to the same RP. For example, if the hash-mask-length value is 24, only the first 24 bits of the group addresses matter. This mechanism is used to map one group or multiple groups to an RP.

Default

hash-mask-len 30

Parameters
hash-mask-length

Specifies the hash mask length.

Values

0 to 32 (v4)

priority
Syntax

priority bootstrap-priority

no priority

Context

config>router>pim>rp>bsr-candidate

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the bootstrap priority of the router. The RP is sometimes called the bootstrap router. The priority determines if the router is eligible to be a bootstrap router. In the case of a tie, the router with the highest IP address is elected to be the bootstrap router.

Default

priority 0

Parameters
bootstrap-priority

Specifies the priority to become the bootstrap router. The higher the value, the higher the priority. A 0 value means the router is not eligible to be the bootstrap router. A value of 1 means the router is the least likely to become the designated router.

Values

0 to 255

rp-candidate
Syntax

rp-candidate

Context

config>router>pim>rp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure the candidate RP parameters.

Routers use a set of available rendezvous points distributed in bootstrap messages to get the proper group-to-RP mapping. A set of routers within a domain are also configured as candidate RPs (C-RPs); typically, these will be the same routers that are configured as candidate BSRs.

Every multicast group has a shared tree through which receivers learn about new multicast sources and new receivers learn about all multicast sources. The rendezvous point (RP) is the root of this shared tree.

Default

rp-candidate shutdown

address
Syntax

[no] address ip-address

Context

config>router>pim>rp>rp-candidate

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the local RP address. This address is sent in the RP candidate advertisements to the bootstrap router.

Parameters
ip-address

Specifies the IP address.

Values

a.b.c.d

group-range
Syntax

[no] group-range {grp-ip-address/mask| grp-ip-address netmask}

Context

config>router>pim>rp>rp-candidate

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the address ranges of the multicast groups for which this router can be an RP.

Parameters
grp-ip-address

Specifies the multicast group IP address expressed in dotted-decimal notation.

Values

a.b.c.d (multicast group address)

mask

Specifies the mask associated with the IP prefix expressed as a mask length or in dotted-decimal notation; for example /16 for a sixteen-bit mask. The mask can also be entered in dotted-decimal notation.

Values

4 to 32

netmask

Specifies the subnet mask in dotted-decimal notation.

Values

a.b.c.d (network bits all 1 and host bits all 0)

holdtime
Syntax

holdtime holdtime

no holdtime

Context

config>router>pim>rp>rp-candidate

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the length of time, in seconds, that neighbors should consider the sending router to be operationally up. A local RP cannot be configured on a logical router.

Parameters
holdtime

Specifies the hold time, in seconds.

Values

5 to 255

priority
Syntax

priority priority

no priority

Context

config>router>pim>rp>rp-candidate

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the candidate-RP priority for becoming a rendezvous point (RP). This value is used to elect an RP for a group range.

Default

priority 192

Parameters
priority

Specifies the priority to become a rendezvous point (RP). A value of 0 is considered as the highest priority.

Values

0 to 255

static
Syntax

static

Context

config>router>pim>rp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure static rendezvous point (RP) addresses for a multicast group range.

Entries can be created or destroyed. If no IP addresses are configured in the config>router>pim>rp>static>address context, the multicast group-to-RP mapping is derived from the RP-set messages received from the bootstrap router.

address
Syntax

address ip-address

no address

Context

config>router>pim>rp>static

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command indicates the RP address that should be used by the router for the range of multicast groups configured by the group-range command.

Parameters
ip-address

Specifies the static IP address of the RP. This address must be unique within the subnet and specified in dotted-decimal notation.

Values

a.b.c.d

group-range
Syntax

[no] group-range {ip-prefix/mask | ip-prefix netmask}

Context

config>router>pim>ssm-groups

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the SSM multicast group address ranges for this router.

Parameters
ip-prefix/mask

Specifies the IP prefix in dotted-decimal notation and the associated mask.

Values

ipv4-prefix:

a.b.c.d

ipv4-prefix-le:

0 to 32

netmask

Specifies the subnet mask in dotted-decimal notation.

Values

a.b.c.d (network bits all 1 and host bits all 0)

group-prefix
Syntax

[no] group-prefix {grp-ip-address/mask | grp-ip-address netmask}

Context

config>router>pim>rp>static>address

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the range of multicast group addresses that should be used by the router as the RP. The config router pim rp static address command implicitly defaults to deny all for all multicast groups (224.0.0.0/4). A group-prefix must be specified for that static address. This command does not apply to the whole group range.

The no form of this command removes the configuration.

Parameters
grp-ip-address

Specifies the multicast group IP address expressed in dotted-decimal notation.

Values

a.b.c.d

mask

Specifies the mask associated with the IP prefix expressed as a mask length or in dotted-decimal notation; for example /16 for a sixteen-bit mask. The mask can also be entered in dotted-decimal notation.

Values

4 to 32

netmask

Specifies the subnet mask in dotted-decimal notation.

Values

a.b.c.d (network bits all 1 and host bits all 0)

override
Syntax

[no] override

Context

config>router>pim>rp>static>address

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command changes the precedence of static RP over dynamically learned RP.

When this command is enabled, the static group-to-RP mappings take precedence over the dynamically learned mappings.

Default

no override

non-dr-attract-traffic
Syntax

[no] non-dr-attract-traffic

Context

config>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies whether the router should ignore the designated router state and attract traffic even when it is not the designated router.

An operator can configure an interface (router, IES, or VPRN interfaces) to IGMP and PIM. The interface state is synchronized to the backup node if it is associated with the redundant peer port. The interface can be configured to use PIM, which causes multicast streams to be sent to the elected DR only. The DR is also the router sending traffic to the DSLAM. Because it may be required to attract traffic to both routers, the non-dr-attract-trafffic flag can be used in the PIM context to have the router ignore the DR state and attract traffic when not DR. While using this flag, the router may not send the stream down to the DSLAM while not DR.

When this command is enabled, the designated router state is ignored.

The no form of this command causes the router to honor the designated router value.

Default

no non-dr-attract-traffic

rpf-table
Syntax

rpf-table {rtable-u}

no rpf-table

Context

config>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the sequence of route tables used to find a Reverse Path Forwarding (RPF) interface for a particular multicast route.

By default, only the unicast route table is looked up to calculate the RPF interface toward the source/rendezvous point. However, the operator can specify the use of the unicast route table (rtable-u).

Default

rpf-table rtable-u

Parameters
rtable-u

Specifies only that the unicast route table will be used by the multicast protocol (PIM) for IPv4 RPF checks. This route table will contain routes submitted by all the unicast routing protocols.

spt-switchover-threshold
Syntax

spt-switchover-threshold {grp-ipv4-prefix/ipv4-prefix-length | grp-ipv4-prefix netmask} spt-threshold

Context

config>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the shortest path tree (SPT) switchover thresholds for group prefixes.

PIM-SM routers with directly connected routers receive multicast traffic initially on a shared tree rooted at the RP. When the traffic arrives on the shared tree and the source of the traffic is known, a switchover to the SPT tree rooted at the source is attempted.

For a group that falls in the range of a prefix configured in the table, the corresponding threshold value determines when the router should switch over from the shared tree to the source-specific tree. The switchover is attempted only if the traffic rate on the shared tree for the group exceeds the configured threshold.

Note:

On the 7210 SAS, this command is used to enable or disable switch over to the SPT tree. To disable switch over to SPT, a threshold value of infinity must be configured (that is, to continue using the shared tree forever, configure the IP multicast prefix with this command and set the threshold to infinity). To use the SPT tree, do not configure the IP multicast address prefix using this command and the default behavior will apply to the multicast group. The default behavior is to switch over to SPT when the first packet is received.

In the absence of any matching prefix in the table, the default behavior is to switch over when the first packet is seen. In the presence of multiple prefixes matching a specific group, the most specific entry is used.

Parameters
grp-ipv4-prefix

Specifies the multicast group IP address expressed in dotted-decimal notation.

Values

a.b.c.d (multicast IP address)

ipv4-prefix-length

Specifies the length of the IPv4 prefix.

Values

4 to 32

netmask

Specifies the netmask associated with the IPv4 prefix expressed in dotted-decimal notation.

Values

a.b.c.d (network bits all 1 and host bits all 0)

spt-threshold

Specifies the configured threshold in kilobits per second (kbps) for a group prefix. A switchover is attempted only if the traffic rate on the shared tree for the group exceeds this configured threshold.

Values

1, infinity

infinity

Keyword to specify that no switchover will occur at any time, regardless of the traffic level is detected. The threshold value, in kilobits per second (KBPS), is 4294967295.

ssm-assert-compatible-mode
Syntax

ssm-assert-compatible-mode [enable|disable]

Context

config>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

When this command is enabled, packets are treated as if SPT bit was set regardless of whether it is set or not.

Default

ssm-assert-compatible-mode disable

Parameters
enable

Enables SSM assert in compatibility mode for this PIM protocol instance.

disable

Disables SSM assert in compatibility mode for this PIM protocol instance.

ssm-default-range-disable
Syntax

[no] ssm-default-range-disable ipv4

Context

config>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command allows the user to disable the reservation and allows PIM to accept and create (*,G) entries for addresses in this range on receiving IGMPv2 reports. PIM SSM has a default range of 232/8 (232.0.0.0 to 232.255.255.255) reserved by IANA. These addresses are not used by PIM ASM.

Default

ssm-default-range-disable ipv4

ssm-groups
Syntax

[no] ssm-groups

Context

config>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure SSM group ranges.

Operational commands
mrinfo
Syntax

mrinfo ip-address | dns-name [router router-instance | service-name service-name]

Context

<GLOBAL>

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays relevant multicast information from the target multicast router. Information displayed includes adjacency information, protocol, metrics, thresholds, and flags from the target multicast router. This information can be used by network operators to determine whether bidirectional adjacencies exist.

Parameters
ip-address

Specifies the IP address of the multicast capable target router.

Values

ip-address ipv4 unicast address (a.b.c.d)

dns-name

Specifies the DNS name, up to 63 characters.

router-instance

Specifies the router instance.

Default

router-name - "Base" | "management" Default - Base

service-name

Specifies the service name, up to 64 characters

Output

The following output is an example of multicast information, and Output fields: mrinfo describes the output fields.

Sample output
A:dut-f# mrinfo 10.1.1.2

10.1.1.2  [version 3.0,prune,genid,mtrace]:
  10.1.1.2 -> 10.1.1.1 [1/0/pim]
  16.1.1.1 -> 0.0.0.0 [1/0/pim/down/disabled]
  17.1.1.1 -> 0.0.0.0 [1/0/pim/querier/leaf]
  200.200.200.3 -> 200.200.200.5 [1/0/tunnel/pim]... 

A:dut-g# mrinfo 1.1.1.1

1.1.1.1  [version 7.0,prune,genid,mtrace]:
? 1.1.1.1 -> ? 0.0.0.0 [1/0/pim/leaf]
? 12.1.1.1 -> ? 12.1.1.2 [1/0/pim]
? 19.1.1.1 -> ? 19.1.1.9 [1/0/pim]
? 11.1.1.1 -> ? 0.0.0.0 [1/0/pim/leaf]
? 17.1.1.1 -> ? 17.1.1.7 [1/0/pim]
? 17.1.2.1 -> ? 17.1.2.7 [1/0/pim]
Table 3. Output fields: mrinfo

Label

Description

General flags

version

Displays the software version on queried router

prune

Indicates that router understands pruning

genid

Indicates that router sends generation IDs

mtrace

Indicates that the router handles mtrace requests

Neighbors flags

1

Metric

0

Threshold (multicast time-to-live)

pim

PIM enabled on interface

down

Operational status of interface

disabled

Administrative status of interface

leaf

No downstream neighbors on interface

querier

Interface is IGMP querier

tunnel

Neighbor reached via tunnel

mtrace
Syntax

mtrace source ip-address | dns-name [group ip-address | dns-name] [destination ip-address | dns-name] [hop hop] [router router-instance | service-name service-name] [wait-time wait-time]

Context

<GLOBAL>

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command traces the multicast path from a source to a receiver by passing a trace query hop-by-hop along the reverse path from the receiver to the source. At each hop, information such as the hop address, routing error conditions, and packet statistics are gathered and returned to the requester. A network administrator can determine where multicast flows stop and verify the flow of the multicast stream.

Parameters
source ip-address

Specifies the IP address of the multicast-capable source. This is a unicast address of the beginning of the path to be traced.

dns-name

Specifies the DNS name, up to 63 characters.

Values

ip-address ipv4 unicast address (a.b.c.d)

group ip-address

Specifies the multicast address.

destination ip-address

Specifies the IP address of the unicast destination. If this parameter is omitted, the IP address of the system where the command is entered is used. The destination parameter can also be used to specify a local interface address as the destination address to send the trace query.

Default

The default address for the destination address is the incoming IETF format for that (S,G)

hop

Specifies the maximum number of hops that will be traced from the receiver back toward the source.

Values

1 to 255

Default

32 hops (infinity for the DVMRP routing protocol).

router-instance

Specifies the router name or service ID used to identify the router instance.

Default

router-name - "Base" | "management" Default - Base

service-name

Specifies the service name, up to 64 characters.

wait-time

Specifies the number of seconds to wait for the response.

Values

1 to 60

Default

10

Output

The following output is an example of mtrace information, and Output fields: mtrace describes the output fields.

Sample output
A:Dut-F# mtrace source 10.10.16.9 group 224.5.6.7
 
Mtrace from 10.10.16.9 via group 224.5.6.7
Querying full reverse path...
 
  0  ? (10.10.10.6)
 -1  ? (10.10.10.5)  PIM  thresh^ 1  No Error
 -2  ? (10.10.6.4)  PIM  thresh^ 1  No Error
 -3  ? (10.10.4.2)  PIM  thresh^ 1  Reached RP/Core
 -4  ? (10.10.1.1)  PIM  thresh^ 1  No Error
 -5  ? (10.10.2.3)  PIM  thresh^ 1  No Error
 -6  ? (10.10.16.9)
Round trip time 29 ms; total ttl of 5 required.
Table 4. Output fields: mtrace

Label

Description

hop

Displays the number of hops from the source to the listed router

router name

Displays the name of the router for this hop. If a DNS name query is not successful a ‟?” displays

address

Displays the address of the router for this hop

protocol

Displays the protocol used

ttl

Displays the forward TTL threshold. TTL that a packet is required to have before it will be forwarded over the outgoing interface

forwarding code

Displays the forwarding information or error code for this hop

Show commands

IGMP commands
group
Syntax

group [grp-ip-address] [host | interface | saps]

group summary [host | interface | saps]

Context

show>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays the multicast group and (S,G) addresses. If no grp-ip-address parameters are specified, all IGMP group, (*,G) and (S,G) addresses are displayed.

Parameters
grp-ip-address

Displays specific multicast group addresses.

host

Displays hosts for the multicast group addresses.

interface

Displays interfaces for the multicast group addresses.

saps

Displays SAPs for the multicast group addresses.

Output

The following output is an example of IGMP group information, and Output fields: IGMP group describes the output fields.

Sample output
*B:Dut-C# show router igmp group 
===============================================================================
IGMP Interface Groups
===============================================================================
===============================================================================
IGMP Host Groups
===============================================================================
(*,225.0.0.1)
    Fwd List  : 112.112.1.2            Up Time : 0d 00:00:21
(11.11.0.1,225.0.0.1)
    Fwd List  : 112.112.1.1            Up Time : 0d 00:00:30
    Blk List  : 112.112.1.2            Up Time : 0d 00:00:21
(11.11.0.2,225.0.0.1)
    Fwd List  : 112.112.1.1            Up Time : 0d 00:00:30
(*,225.0.0.2)
    Fwd List  : 112.112.1.2            Up Time : 0d 00:00:21
(11.11.0.1,225.0.0.2)
    Blk List  : 112.112.1.2            Up Time : 0d 00:00:21
-------------------------------------------------------------------------------
(*,G)/(S,G) Entries : 5
===============================================================================
*B:Dut-C# 

*B:Dut-C# show router igmp group summary 
===============================================================================
IGMP Interface Groups
===============================================================================
===============================================================================
IGMP Host Groups Summary          Nbr Fwd   Nbr Blk 
===============================================================================
(*,225.0.0.1)                     1                      0
(11.11.0.1,225.0.0.1)             1                      1
(11.11.0.2,225.0.0.1)             1                      0
(*,225.0.0.2)                     1                      0
(11.11.0.1,225.0.0.2)             0                      1
-------------------------------------------------------------------------------
(*,G)/(S,G) Entries : 5
===============================================================================
*B:Dut-C# 

A:NYC# show router igmp group 224.24.24.24
===============================================================================
IGMP Groups
===============================================================================
(*,224.24.24.24)                       Up Time : 0d 05:23:23
    Fwd List  : nyc-vlc
-------------------------------------------------------------------------------
(*,G)/(S,G) Entries : 1
===============================================================================
A:NYC#
Table 5. Output fields: IGMP group

Label

Description

IGMP Groups

Displays the IP multicast sources corresponding to the IP multicast groups which are statically configured

Fwd List

Displays the list of interfaces in the forward list

interface
Syntax

interface [ip-int-name | ip-address] [group] [grp-address] [detail]

Context

show>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays IGMP interface information.

Parameters
ip-int-name

Displays the information associated with the specified IP interface name up to 32 characters.

ip-address

Displays the information associated with the specified IP address.

Values

a.b.c.d

grp-address

Displays IP multicast group address for which this entry contains information.

Values

a.b.c.d, multicast group address or 0

detail

Displays detailed IP interface information along with the source group information learned on that interface.

Output

The following output is an example of IGMP interface information, and Output fields: IGMP interface describes the output fields.

Sample output
A:Dut-C# show router igmp interface 
===============================================================================
IGMP Interfaces
===============================================================================
Interface               Adm  Oper Querier         Cfg/Opr Num     Policy
                                                  Version Groups 
-------------------------------------------------------------------------------
C_Rx_net1               Up   Up   10.2.1.3        3/3     900     none
C_Rx_acc1               Up   Up   10.1.1.3        3/3     900     none
C_Rx_acc2               Up   Up   10.1.2.3        3/3     900     none
C_Rx_net2               Up   Up   10.2.2.3        3/3     900     none

-------------------------------------------------------------------------------
Interfaces : 4
===============================================================================
*A:Dut-C# show router igmp interface detail 
===============================================================================
IGMP Interface C_Rx_net1
===============================================================================
Interface          : C_Rx_net1
Admin Status       : Up                 Oper Status        : Up
Querier            : 10.2.1.3           Querier Up Time    : 0d 00:00:55
Querier Expiry Time: N/A                Time for next query: 0d 00:01:51
Admin/Oper version : 3/3                Num Groups         : 900
Policy             : none               Subnet Check       : Enabled
Max Groups Allowed : No Limit           Max Groups Till Now: 900
Use LAG port weight: no 
Router Alert Check : Enabled            Max Sources Allowed: No Limit
                                        Max GrpSrcs Allowed: No Limit
Redundant Multicast: no                 Red. Multicast Fwd : N/A
-------------------------------------------------------------------------------
IGMP Group
-------------------------------------------------------------------------------
Group Address : 239.225.1.1             Up Time       : 0d 00:00:51
Interface     : C_Rx_net1               Expires       : N/A
Last Reporter : 10.2.1.1                Mode          : include
V1 Host Timer : Not running             Type          : dynamic
V2 Host Timer : Not running             Compat Mode   : IGMP Version 3
-----------------------------------------------
Source Address   Expires       Type    Fwd/Blk 
-----------------------------------------------
10.1.1.2         0d 00:04:07   dynamic Fwd
-------------------------------------------------------------------------------
Table 6. Output fields: IGMP interface

Label

Description

Interface

Specifies the interfaces that participate in the IGMP protocol

Adm

Admin Status

Displays the administrative state for the IGMP protocol on this interface

Oper

Oper Status

Displays the current operational state of IGMP protocol on the interface

Querier

Displays the address of the IGMP querier on the IP subnet to which the interface is attached

Querier Up Time

Displays the time since the querier was last elected as querier

Querier Expiry Timer

Displays the time remaining before the querier ages out. If the querier is the local interface address, the value will be zero.

Cfg/Opr Version

Admin/Oper version

Cfg — The configured version of IGMP running on this interface. For IGMP to function correctly, all routers on a LAN must be configured to run the same version of IGMP on that LAN.

Opr — The operational version of IGMP running on this interface. If the cfg value is 3 but all of the routers in the local subnet of this interface use IGMP version v1 or v2, the operational version will be v1 or v2.

Num Groups

Displays the number of multicast groups which have been learned by the router on the interface

Policy

Displays the policy that is to be applied on the interface

Group Address

Displays the IP multicast group address for which this entry contains information

Up Time

Displays the time since this source group entry got created

Last Reporter

Displays the IP address of the source of the last membership report received for this IP Multicast group address on this interface. If no membership report has been received, this object has the value 0.0.0.0.

Mode

The mode is based on the type of membership report(s) received on the interface for the group. In the 'include' mode, reception of packets sent to the specified multicast address is requested only from those IP source addresses listed in the source-list parameter of the IGMP membership report. In 'exclude' mode, reception of packets sent to the specific multicast address is requested from all IP source addresses except those listed in the source-list parameter.

V1 Host Timer

The time remaining until the local router will assume that there are no longer any IGMP version 1 members on the IP subnet attached to this interface. Upon hearing any IGMPv1 Membership Report, this value is reset to the group membership timer. While this time remaining is non-zero, the local router ignores any IGMPv2 Leave messages for this group that it receives on this interface.

V2 Host Timer

The time remaining until the local router will assume that there are no longer any IGMP version 2 members on the IP subnet attached to this interface. Upon hearing any IGMPv2 Membership Report, this value is reset to the group membership timer. While this time remaining is non-zero, the local router ignores any IGMPv3 Leave messages for this group that it receives on this interface.

Type

Indicates how this group entry was learned. If this group entry was learned by IGMP, it will be set to ‟dynamic”. For statically configured groups, the value will be set to 'static'.

Compat Mode

Used in order for routers to be compatible with earlier version routers. IGMPv3 hosts MUST operate in version 1 and version 2 compatibility modes. IGMPv3 hosts MUST keep state per local interface regarding the compatibility mode of each attached network. A host's compatibility mode is determined from the Host Compatibility Mode variable which can be in one of three states: IGMPv1, IGMPv2 or IGMPv3. This variable is kept per interface and is dependent on the version of General Queries heard on that interface as well as the Earlier Version Querier Present timers for the interface.

ssm-translate
Syntax

ssm-translate

ssm-translate interface interface-name

Context

show>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays IGMP SSM translate configuration information.

Parameters
interface-name

Displays information associated with the specified interface name up to 32 characters.

Output

The following output is an example of IGMP SSM translate information, and Output fields: IGMP SSM translate describes the output fields.

Sample output
================================================================= 
IGMP SSM Translate Entries
=================================================================
Group Range               Source                     Interface
-----------------------------------------------------------------
<234.1.1.1 - 234.1.1.2>   10.1.1.1                     
                             
<232.1.1.1 - 232.1.1.5>   10.1.1.2                     ies-abc
-----------------------------------------------------------------
Table 7. Output fields: IGMP SSM translate

Label

Description

Group Range

Displays the address ranges of the multicast groups for which this router can be an RP

Source

Displays the unicast address that sends data on an interface

SSM Translate Entries

Displays the total number of SSM translate entries

static
Syntax

static [ip-int-name | ip-addr]

Context

show>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays static IGMP, (*,G), and (S,G) information.

Parameters
ip-int-name

Displays the information associated with the specified IP interface name up to 32 characters.

ip-addr

Displays the information associated with the specified IP address.

Values

a.b.c.d

Output

The following output is an example of static IGMP information, and Output fields: IGMP static describes the output fields.

Sample output
*A:Dut-C# show router igmp static 
===================================================================
IGMP Static Group Source
===================================================================
Source           Group            Interface
-------------------------------------------------------------------
*                239.1.2.1        C_Rx_acc1
10.2.1.1         239.12.1.1       C_Rx_acc1
*                239.1.1.1        C_Rx_net2
-------------------------------------------------------------------
Static (*,G)/(S,G) Entries : 3
===================================================================
Table 8. Output fields: IGMP static

Label

Description

Source

Displays entries which represent a source address from which receivers are interested/not interested in receiving multicast traffic

Group

Displays the IP multicast group address for which this entry contains information

Interface

Displays the interface name

statistics
Syntax

statistics [ip-int-name | ip-address]

statistics group-interface [fwd-service service-id] [ip-int-name]

statistics host [ip-address]

Context

show>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays IGMP statistics information.

Parameters
ip-int-name

Displays the information associated with the specified IP interface name up to 32 characters.

ip-address

Displays the information associated with the specified IP address.

Values

a.b.c.d

service-id

Displays the information associated with the specified service ID.

Values

1 to 2147483647 | 64 char max

Output

The following output is an example of IGMP statistics information, and Output fields: IGMP statistics describes the output fields.

Sample output
*A:dut-e>show>router# igmp statistics

==================================================
IGMP Interface Statistics
==================================================
Message Type        Received       Transmitted
--------------------------------------------------
Queries             0              57
Report V1           0              0
Report V2           0              0
Report V3           0              0
Leaves              0              0
--------------------------------------------------
Global General Statistics
--------------------------------------------------
Bad Length        : 0
Bad Checksum      : 0
Unknown Type      : 0
Drops             : 0
Rx Non Local      : 0
Rx Wrong Version  : 0
Policy Drops      : 0
No Router Alert   : 0
Rx Bad Encodings  : 0
Local Scope Pkts  : 0
Resvd Scope Pkts  : 0
--------------------------------------------------
Global Source Group Statistics
--------------------------------------------------
(S,G)             : 0
(*,G)             : 75
==================================================
*A:dut-e>show>router#
Table 9. Output fields: IGMP statistics

Label

Description

IGMP Interface Statistics

Displays the IGMP statistics for a particular interface

Message Type

Queries — The number of IGMP general queries transmitted or received on this interface

Report — The total number of IGMP V1, V2, or V3 reports transmitted or received on this interface

Leaves — The total number of IGMP leaves transmitted on this interface

Received

Displays the total number of IGMP packets received on this interface

Transmitted

Column that displays the total number of IGMP packets transmitted from this interface

General Interface Statistics

Displays the general IGMP statistics

Bad Length

Displays the total number of IGMP packets with bad length received on this interface

Bad Checksum

Displays the total number of IGMP packets with bad checksum received on this interface

Unknown Type

Displays the total number of IGMP packets with unknown type received on this interface

Bad Receive If

Displays the total number of IGMP packets incorrectly received on this interface

Rx Non Local

Displays the total number of IGMP packets received from a non-local sender

Rx Wrong Version

Displays the total number of IGMP packets with wrong versions received on this interface

Policy Drops

Displays the total number of times IGMP protocol instance matched the host IP address or group/source addresses specified in the import policy

No Router Alert

Displays the total number of IGMPv3 packets received on this interface which did not have the router alert flag set

status
Syntax

status

Context

show>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays IGMP status information.

If IGMP is not enabled, the following message appears:

A:NYC# show router igmp status
MINOR: CLI IGMP is not configured.
A:NYC#
Output

The following output is an example of IGMP status information, and Output fields: IGMP status describes the output fields.

Sample output
*A:ALA-BA# show>router# igmp status

===============================================================================
IGMP Status
===============================================================================
Admin State                       : Up
Oper State                        : Up
Query Interval                    : 125
Last Member Query Interval        : 1
Query Response Interval           : 10
Robust Count                      : 2
===============================================================================
*A:ALA-BA#
Table 10. Output fields: IGMP status

Label

Description

Admin State

Displays the administrative status of IGMP

Oper State

Displays the current operating state of this IGMP protocol instance on this router

Query Interval

Displays the frequency at which IGMP query packets are transmitted

Last Member Query Interval

Displays the maximum response time inserted into group-specific queries sent in response to leave group messages, and is also the amount of time between group-specific query messages

Query Response Interval

Displays the maximum query response time advertised in IGMPv2 queries

Robust Count

Displays the number of times the router will retry a query

Show router PIM commands

anycast
Syntax

anycast [detail] [family]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays PIM anycast RP-set information.

Parameters
detail

Displays detailed information.

family

Displays IPv4 information.

Output

The following output displays an example of a PIM anycast information, and Output fields: PIM anycast describes the output fields.

Sample output
A:7210SAS# show router pim anycast 
===================================================
PIM Anycast RP Entries
===================================================
Anycast RP               Anycast RP Peer                                       
---------------------------------------------------
100.100.100.1            10.102.1.1                 
                         10.103.1.1                 
                         10.104.1.1                 
---------------------------------------------------
PIM Anycast RP Entries : 3
===================================================
Table 11. Output fields: PIM anycast

Label

Description

Anycast Address

Displays the candidate anycast address

Anycast RP Peer

Displays the candidate anycast RP peer address

crp
Syntax

crp [family|ip-address]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays PIM candidate RP (CRP) information received at the elected bootstrap router (BSR).

Parameters
ip-address

Specifies the candidate RP IP address.

family

Displays IPv4 information.

Output

The following output is an example of a PIM CRP configuration, and Output fields: PIM CRP describes the output fields.

Sample output
A:7210SAS# show router pim crp
============================================================================
PIM Candidate RPs
============================================================================
RP Address      Group Address      Priority    Holdtime  Expiry Time
----------------------------------------------------------------------------
239.22.187.236    239.0.0.0/4        192         150       0d 00:02:19
239.22.187.239    239.0.0.0/4        192         150       0d 00:02:19
239.22.187.240    239.0.0.0/4        192         150       0d 00:02:09
----------------------------------------------------------------------------
Candidate RPs : 3
============================================================================
A:7210SAS#
Table 12. Output fields: PIM CRP

Label

Description

RP Address

Displays the Candidate RP address

Group Address

Displays the range of multicast group addresses for which the CRP is the Candidate RP

Priority

Displays the candidate RP priority for becoming a rendezvous point (RP). This value is used to elect RP for a group range. A value of 0 is considered as the highest priority.

Holdtime

Displays the hold time of the candidate RP. It is used by the Bootstrap router to time out the RP entries if it does not listen to another CRP advertisement within the hold time period.

Expiry

Displays the minimum time remaining before the CRP will be declared down. If the local router is not the BSR, this value is 0.

Candidate RPs

Displays the number of CRP entries

group
Syntax

group [group-ip-address] [source ip-address] [type {starstarrp|starg|sg}] [detail] [family]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays PIM source group database information.

Parameters
group-ip-address

Specifies the IP multicast group address for which this entry contains information.

source ip-address

Specifies the source address for which this entry contains information.

type starstarrp

Specifies that only (*, *, rp) entries be displayed.

type starg

Specifies that only (*,G) entries be displayed.

type sg

Specifies that only (S,G) entries be displayed.

detail

Displays detailed group information.

family

Displays IPv4 information.

Output

The following output is an example of PIM group information, and Output fields: PIM group describes the output fields.

Sample output
*A:Dut-C# show router pim group 
===============================================================================
Legend:  A = Active   S = Standby
===============================================================================
PIM Groups ipv4
===============================================================================
Group Address               Type                Spt Bit  Inc Intf       No.Oifs
   Source Address              RP                  State    Inc Intf(S) 
-------------------------------------------------------------------------------
239.225.1.1                 (S,G)               spt      C_A            4
   10.1.1.2                    10.4.4.4 
239.225.1.2                 (S,G)               spt      C_A            4
   10.1.1.2                    10.4.4.4 
239.225.1.3                 (S,G)               spt      C_A            4
   10.1.1.2                    10.4.4.4 
239.225.1.4                 (S,G)               spt      C_A            4
   10.1.1.2                    10.4.4.4 
239.225.1.5                 (S,G)               spt      C_A            4
   10.1.1.2                    10.4.4.4 
239.225.1.6                 (S,G)               spt      C_A            4
   10.1.1.2                    10.4.4.4 
239.225.1.7                 (S,G)               spt      C_A            4
   10.1.1.2                    10.4.4.4 
-------------------------------------------------------------------------------
Groups : 7
===============================================================================
*A:Dut-C# show router pim group detail 
===============================================================================
PIM Source Group ipv4
===============================================================================
Group Address      : 239.225.1.1
Source Address     : 10.1.1.2
RP Address         : 10.4.4.4
Advt Router        : 10.1.1.1
Flags              : spt                Type               : (S,G)
MRIB Next Hop      : 13.1.1.1
MRIB Src Flags     : remote 
Keepalive Timer Exp: 0d 00:03:16 
Up Time            : 0d 00:21:44        Resolved By        : rtable-u
 
Up JP State        : Joined             Up JP Expiry       : 0d 00:00:43
Up JP Rpt          : Not Joined StarG   Up JP Rpt Override : 0d 00:00:00
 
Register State     : No Info 
Reg From Anycast RP: No 
 
Rpf Neighbor       : 13.1.1.1
Incoming Intf      : C_A
Outgoing Intf List : C_Rx_net1, C_Rx_acc1, C_Rx_acc2, C_Rx_net2
 
Spt threshold      : 0 kbps             ECMP opt threshold : 7
===============================================================================
Table 13. Output fields: PIM group

Label

Description

Group Address

Displays the IP multicast group address for which this entry contains information

Source Address

Displays the source address of the multicast sender.

It will be 0 if the type is configured as starg.

It will be the address of the Rendezvous Point (RP) if the type is configured as starRP.

RP Address

Displays the RP address

Type

Displays the type of entry: (*,*, rp)/(*,G) or (S,G)

Spt Bit

Specifies whether to forward on (*,*, rp)/(*,G) or on (S,G) state. It is updated when the (S,G) data comes on the RPF interface toward the source.

Incoming Intf

Displays the interface on which the traffic comes in. It can be the RPF interface to the RP (if starg) or the source (if sg).

Num Oifs

Displays the number of interfaces in the inherited outgoing interface list. An inherited list inherits the state from other types.

Flags

Displays the different lists that this interface belongs to

Keepalive Timer Exp

The keepalive timer is applicable only for (S,G) entries.

The (S,G) keepalive timer is updated by data being forwarded using this (S,G) Forwarding state. It is used to keep (S,G) state alive in the absence of explicit (S,G) joins.

MRIB Next Hop

Displays the next hop address toward the RP

MRIB Src Flags

Displays the MRIB information about the source. If the entry is of type starg or starstarrp, it will contain information about the RP for the group.

Up Time

Displays the time since this source group entry was created

Resolved By

Displays the route table used for RPF check

Up JP State

Displays the upstream join prune state for this entry on the interface. PIM join prune messages are sent by the downstream routers toward the RPF neighbor.

Up JP Expiry

Displays the minimum amount of time remaining before this entry will be aged out

Up JP Rpt

Displays the join prune Rpt state for this entry on the interface. PIM join/prune messages are sent by the downstream routers toward the RPF neighbor. (S,G, rpt) state is a result of receiving (S,G, rpt) JP message from the downstream router on the RP tree.

Up JP Rpt Override

Displays the value used to delay triggered Join (S,G, rpt) messages to prevent implosions of triggered messages.

If this has a non-zero value, it means that the router was in 'notPruned' state and it saw a prune (S,G, rpt) message being sent to RPF (S,G, rpt). If the router sees a join (S,G, rpt) override message being sent by some other router on the LAN while the timer is still non-zero, it cancels the override timer. If it does not see a join (S,G, rpt) message, then on expiry of the override timer, it sends it's own join (S,G, rpt) message to RPF (S,G, rpt). A similar scenario exists when RPF (S,G, rpt) changes to become equal to RPF (*,G).

Register State

Specifies the register state. The register state is kept at the source DR. When the host starts sending multicast packets and if there are no entries programmed for that group, the source DR sends a register packet to the RP (g). Register state transition happen based on the register stop timer and the response received from the RP.

Register Stop Exp

Displays the time remaining before the register state might transition to a different state

Register from Anycast RP

Displays if the register packet for that group has been received from one of the RP from the anycast-RP set

RPF Neighbor

Displays the address of the RPF neighbor

Outgoing Intf List

Displays a list of interfaces on which data is forwarded

interface
Syntax

interface [ip-int-name | int-ip-address] [group [group-ip-address] source ip-address] [type {starstarrp | starg | sg}] [detail] [family]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays PIM interface information and the (S,G)/(*,G)/(*, *, rp) state of the interface.

Parameters
ip-int-name

Displays the interface information associated with the specified IP interface name.

ip-address

Displays the interface information associated with the specified IP address.

group group-ip-address

Specifies the IP multicast group address for which this entry contains information.

source ip-address

Specifies the source address for which this entry contains information.

If the type is starg, the value of this object will be zero.

If the type is starstarrp, the value of this object will be address of the RP.

type

Specifies the type of this entry.

Values

starstarrp, starg, sg

detail

Displays detailed interface information.

family

Displays IPv4 information for the interface.

Output

The following output is an example of PIM interface information, and Output fields: PIM interface describes the output fields.

Sample output
*7210 SAS>show>router>pim# interface

===============================================================================
PIM Interfaces ipv4
===============================================================================
Interface                   Adm  Opr  DR Prty         Hello Intvl  Mcast Send
   DR
-------------------------------------------------------------------------------
system                      Up   Up   1               30           auto
   10.5.5.5
loopback1                   Up   Up   1               30           auto
   10.1.1.5
toG_1                       Up   Down 1               30           auto
toIxia_Ntw_1                Up   Up   1               30           auto
   10.2.1.5
toIxia_Ntw_2                Up   Up   1               30           auto
   10.2.2.5
toR_1                       Up   Down 1               30           auto
   N/A
toIxia_1                    Up   Down 1               30           auto
   N/A
toLAN_1                     Up   Up   1               30           auto
   10.1.1.5

-------------------------------------------------------------------------------
Interfaces : 124
===============================================================================
*7210 SAS>show>router>pim#
Table 14. Output fields: PIM interface

Label

Description

Admin State

Displays the administrative state for PIM protocol on this interface

Oper State

Displays the current operational state of PIM protocol on this interface

DR

Displays the designated router on this PIM interface

DR Priority

Displays the priority value sent in PIM Hello messages and that is used by routers to elect the designated router (DR)

Hello Intvl

Indicates the frequency at which PIM Hello messages are transmitted on this interface

mc-ecmp-balance
Syntax

mc-ecmp-balance

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays multicast balance information.

neighbor
Syntax

neighbor [ip-address | ip-int-name [address neighbor-ip-address]] [detail] [family]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays PIM neighbor information.

This can be important if an interface has more than one adjacency. For example, a LAN-interface configuration with three routers connected and all are running PIM on their LAN interfaces. These routers then have two adjacencies on their LAN interface, each with different neighbors. If the address address parameter is not defined in this example, then the show command output would display two adjacencies.

Parameters
neighbor ip-int-name

Displays the interface information associated with the specified IP interface name.

neighbor ip-address

Displays the interface information associated with the specified IP address.

address ip-address

Specifies the IP address of the neighbor, on the other side of the interface.

detail

Displays detailed neighbor information.

family

Displays IPv4 information for the specified neighbor.

Output

The following output is an example of PIM neighbor information, and Output fields: PIM neighbor describes the output fields.

Sample output
ALA-1>show>router>pim# neighbor

===============================================================================
PIM Neighbor ipv4
===============================================================================
Interface               Nbr DR Prty     Up Time       Expiry Time     Hold Time
   Nbr Address
-------------------------------------------------------------------------------
toB_1                   1               0d 00:31:36   0d 00:01:40     105
   10.1.1.2
toE_1                   1               0d 00:32:04   0d 00:01:42     105
   10.1.1.5
toE_10                  1               0d 00:32:04   0d 00:01:42     105
   10.1.10.5
toE_11                  1               0d 00:32:04   0d 00:01:42     105
   10.1.11.5
toE_12                  1               0d 00:32:04   0d 00:01:42     105
   10.1.12.5
toE_13                  1               0d 00:32:04   0d 00:01:42     105
   10.1.13.5
toE_14                  1               0d 00:32:04   0d 00:01:42     105
   10.1.14.5
toE_15                  1               0d 00:32:05   0d 00:01:41     105
   10.1.15.5
ALA-1# 
Table 15. Output fields: PIM neighbor

Label

Description

Interface

Displays the neighbor interface name

Nbr DR Priority

Displays the value of the neighbor DR priority which is received in the hello message

Nbr Address

Displays the neighbor address

Expiry Time

Displays the minimum time remaining before this PIM neighbor will be aged out

0 — Means that this neighbor will never be aged out. This happens when the PIM neighbor sends a Hello message with holdtime set to `0xffff'.

Hold Time

Displays the value of the hold time present in the hello message

DR Priority

Displays the value of the neighbor DR priority which is received in the hello message

Tracking Support

Displays whether the T bit in the LAN prune delay option was present in the hello message. This indicates the neighbor capability to disable join message suppression

LAN Delay

Displays the value of the LAN delay field present in the hello message received from the neighbor

Gen Id

Displays a randomly generated 32-bit value that is regenerated each time PIM forwarding is started or restarted on the interface, including when the router restarts. When a hello message with a new GenID is received from a neighbor, any old hello information about that neighbor is discarded and superseded by the information from the new hello message.

Override Intvl (ms)

Displays the value of the override interval present in the Hello message

rp
Syntax

rp [family | ip-address]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays the rendezvous point (RP) set information built by the router.

Parameters
family

Displays IPv4 information.

ip-address

Specifies the IP address of the RP.

Output

The following output is an example of PIM RP information, and Output fields: PIM RP describes the output fields.

Sample output
A:ALA-1# show router pim rp
==================================================================
PIM RP Set ipv4
==================================================================
Group Address      RP Address      Type        Priority  Holdtime Expirytime
------------------------------------------------------------------
224.0.0.0/4        239.200.200.4   Dynamic     192       150
                   10.1.7.1        Static      1         N/A
------------------------------------------------------------------
Group Prefixes : 1
==================================================================
A:ALA-1# 
Table 16. Output fields: PIM RP

Label

Description

Group Address

Displays the multicast group address of the entry

RP Address

Displays the address of the Rendezvous Point (RP)

Type

Specifies whether the entry was learned through the Bootstrap mechanism or if it was statically configured

Priority

Displays the priority for the specified group address. The higher the value, the higher the priority.

Holdtime

Displays the value of the hold time present in the BSM message

rp-hash
Syntax

rp-hash ip-address

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command hashes the RP for the specified group from the RP set.

Parameters
ip-address

Displays specific multicast group addresses.

Output

The following output is an example of RP hash information, and Output fields: PIM RP hash describes the output fields.

Sample output
A:ALA-1# show router pim rp-hash 239.101.0.0
==============================================
PIM Group-To-RP mapping
==============================================
Group Address      RP Address      Type
----------------------------------------------
239.101.0.0        239.200.200.4   Bootstrap
==============================================
A:ALA-1#


A:ALA-1# show router pim rp-hash 239.101.0.6
==============================================
PIM Group-To-RP mapping
==============================================
Group Address      RP Address      Type
----------------------------------------------
239.101.0.6        239.200.200.4   Bootstrap
==============================================
A:ALA-1#
Table 17. Output fields: PIM RP hash

Label

Description

Group Address

Displays the multicast group address of the entry

RP Address

Displays the address of the Rendezvous Point (RP)

Type

Specifies whether the entry was learned through the Bootstrap mechanism or if it was statically configured

statistics
Syntax

statistics [ip-int-name | int-ip-address | mpls-ip-name] [family]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays statistics for a particular PIM instance.

Parameters
ip-int-name

Displays the interface information associated with the specified IP interface name.

int-ip-address

Displays the interface information associated with the specified IP address.

mpls-ip-name

Identifies the system created IP-MPLS tunnel interfaces, when using NG-MVPN with BGP based signaling and using P2MP LSPs setup using RSVP or mLDP.

family

Displays IPv4 information.

Output

The following output is an example of PIM statistics information, and Output fields: PIM statistics describes the output fields.

Sample output
A:dut-g>show>router>pim# statistics

=================================================================
PIM Statistics ipv4
=================================================================
Message Type        Received       Transmitted    Rx Errors
-----------------------------------------------------------------
Hello               9690           9735           0
Join Prune          2441           6855           0
Asserts             589            0              0
Register            0              0              0
Null Register       0              0              0
Register Stop       0              0              0
BSM                 0              0              0
Total Packets       12720          16590
-------------------------------------------------------------------------------
General Statistics
-------------------------------------------------------------------------------
Rx Invalid Register               : 0
Rx Neighbor Unknown               : 0
Rx Bad Checksum Discard           : 0
Rx Bad Encoding                   : 0
Rx Bad Version Discard            : 0
Rx BSM Router Alert Drops         : 0
Rx BSM Wrong If Drops             : 0
Rx Invalid Join Prune             : 0
Rx Unknown PDU Type               : 0
Join Policy Drops                 : 0
Register Policy Drops             : 0
Bootstrap Import Policy Drops     : 0
Bootstrap Export Policy Drops     : 0
PDU Drops on Non-PIM/Down Intf    : 0
-------------------------------------------------------------------------------
Source Group Statistics
-------------------------------------------------------------------------------
(S,G)                             : 435
(*,G)                             : 251
(*,*,RP)                          : 0
=================================================================
A:dut-g>show>router>pim#

Table 18. Output fields: PIM statistics

Label

Description

PIM Statistics

Displays the PIM statistics for a particular interface

Message Type

Displays the type of message

Hello — Displays the number of PIM hello messages received or transmitted on this interface

Asserts — Displays the number of PIM assert messages received or transmitted on this interface

Register — Displays the number of register messages received or transmitted on this interface

Null Register — Displays the number of PIM null register messages received or transmitted on this interface

Register Stop — Displays the number of PIM register stop messages received or transmitted on this interface

BSM — Displays the number of PIM Bootstrap messages (BSM) received or transmitted on this interface

Candidate RP Adv — Displays the number of candidate RP advertisements

Total Packets — Displays the total number of packets transmitted and received on this interface

Received

Displays the number of messages received on this interface

Transmitted

Displays the number of multicast data packets transmitted on this interface

Rx Errors

Displays the total number of receive errors

General Interface Statistics

Displays the general PIM interface statistics

Register TTL Drop

Displays the number of multicast data packets that could not be encapsulated in Register messages because the time to live (TTL) was zero

Tx Register MTU Drop

Displays the number of bootstrap messages received on this interface but were dropped

Rx Invalid Register

Displays the number of invalid PIM register messages received on this interface

Rx Neighbor Unknown

Displays the number of PIM messages (other than hello messages) that were received on this interface and were rejected because the adjacency with the neighbor router was not already established

Rx Bad Checksum Discard

Displays the number of PIM messages received on this interface which were discarded because of bad checksum

Rx Bad Encoding

Displays the number of PIM messages with bad encodings received on this interface

Rx Bad Version Discard

Displays the number of PIM messages with bad versions received on this interface

Rx CRP No Router Alert

Displays the number of candidate-rp advertisements (C-RP-Adv) received on this interface which had no router alert option set

Rx Invalid Join Prune

Displays the number of invalid PIM join prune messages received on this interface

Rx Unknown PDU Type

Displays the number of packets received with an unsupported PIM type

Join Policy Drops

Displays the number of times the join policy match resulted in dropping PIM join-prune message or one of the source groups contained in the message

Register Policy Drops

Displays the number of times the register policy match resulted in dropping PIM Register messages

Bootstrap Import Policy Drops

Displays the number of Bootstrap messages received on this interface that were dropped because of the bootstrap import policy

Bootstrap Export Policy Drops

Displays the number of Bootstrap messages that were not transmitted on this interface because of the bootstrap export policy

Source Group Statistics

Displays source group statistics

(S,G)

Displays the number of entries in which the type is (S,G)

(*,G)

Displays the number of entries in which the type is (*,G)

(*,*,RP)

Displays the number of entries in which the type is (*, *, rp)

status
Syntax

status [detail] [family]

Context

show>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays the PIM status. The oper status reflects the combined operational status of the IPv4 PIM protocol status. If both are down, the oper status will be reflected as down. If IPv4 reflects up, the oper status will reflect up.

If PIM is not enabled, the following message appears:

A:NYC# show router pim status
MINOR: CLI PIM is not configured.
A:NYC#
Parameters
detail

Displays detailed status information.

family

Displays IPv4 information.

Output

The following output is an example of PIM status information, and Output fields: PIM status describes the output fields.

Sample output
A:dut-g>show>router>pim# status

===============================================================================
PIM Status ipv4
===============================================================================
Admin State                       : Up
Oper State                        : Up

IPv4 Admin State                  : Up
IPv4 Oper State                   : Up

BSR State                         : Accept Any

Elected BSR
    Address                       : None
    Expiry Time                   : N/A
    Priority                      : N/A
    Hash Mask Length              : 30
    Up Time                       : N/A
    RPF Intf toward E-BSR        : N/A

Candidate BSR
    Admin State                   : Down
    Oper State                    : Down
    Address                       : None
    Priority                      : 0
    Hash Mask Length              : 30

SSM-Default-Range                 : Enabled
SSM-Assert-Comp-Mode              : Disabled
SSM-Group-Range
    None

MC-ECMP-Hashing                   : Disabled

Policy                            : None

RPF Table                         : rtable-u

Non-DR-Attract-Traffic            : Disabled
===============================================================================
A:dut-g>show>router>pim# 
Table 19. Output fields: PIM status

Label

Description

Admin State

Displays the administrative status of PIM

Oper State

Displays the current operating state of this PIM protocol instance

BSR State

Displays the state of the router with respect to the bootstrap mechanism

Address

Displays the address of the elected bootstrap router

Expiry Time

Displays the time remaining before the router sends the next Bootstrap message

Priority

Displays the priority of the elected bootstrap router. The higher the value, the higher the priority.

Hash Mask Length

Displays the hash mask length of the bootstrap router

Up Time

Displays the time since the current E-BSR became the bootstrap router

RPF Intf toward

Displays the RPF interface toward the elected BSR. The value is zero if there is no elected BSR in the network.

Address

Displays the address of the candidate BSR router

Expiry Time

Displays the time remaining before the router sends the next Bootstrap message

Priority

Displays the priority of the Bootstrap router. The higher the value, the higher the priority.

Hash Mask Length

Displays the hash mask length of the candidate bootstrap router

Up Time

Displays the time since becoming the bootstrap router

Admin State

Displays the administrative status of CRP

Oper State

Displays the current operating state of the CRP mechanism

Address

Displays the local RP address

Priority

Displays the CRP's priority for becoming a rendezvous point (RP). A 0 value is the highest priority.

Holdtime

Displays the hold time of the candidate RP. It is used by the bootstrap router to timeout the RP entries if it does not listen to another CRP advertisement within the hold time period.

Policy

Displays the PIM policies for a particular PIM instance

Default Group

Displays the default core group address

RPF Table

Displays the route table used for RPF check

MC-ECMP-Hashing

Displays if hash-based multicast balancing of traffic over ECMP links is enabled or disabled

Clear commands

database
Syntax

database [group grp-ip-address [source src-ip-address]]

database interface {ip-int-name|ip-address} [group grp-ip-address [source src-ip-address]]

database host ip-address [group grp-ip-address [source src-ip-address]]

database host all [group grp-ip-address [source src-ip-address]]

database group-interface all

Context

clear>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command clears IGMP or PIM database statistics on a specified interface or IP address.

Parameters
interface ip-int-name

Clears the IGMP or PIM database on the specified interface.

interface ip-address

Clears the IGMP or PIM database on the specified IP address.

group grp-ip-address

Clears the multicast group address or zero in the specified address group.

source src-ip-address

Clears the IGMP or PIM database from the specified source IP address.

group-interface all

Clears the IGMP database on all group interfaces.

database
Syntax

database [interface ip-int-name|mt-int-name|int-ip-address] [group grp-ip-address [source ip-address]] [family]

Context

clear>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command clears IGMP or PIM database statistics on a specified interface or IP address.

Parameters
interface ip-int-name

Clears the IGMP or PIM database on the specified interface.

interface ip-address

Clears the IGMP or PIM database on the specified IP address.

group group-ip-address

Clears the multicast group address(ipv4) or zero in the specified address group.

source ip-address

Clears the IGMP or PIM database from the specified source IP address.

family

Clears IPv4 information.

statistics
Syntax

statistics group-interface [fwd-service service-id] ip-int-name

statistics group-interface all

statistics host ip-address

statistics host all

statistics [interface ip-int-name | ip-address]

Context

clear>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command clears IGMP statistics on a specified interface or IP address.

An interface and a group or source cannot be specified at the same time.

Parameters
group-interface interface-name

Clears the IGMP statistics on the specifies group interface.

group-interface all

Clears the IGMP statistics on all group interfaces.

fwd-service service-id

Clears the IGMP statistics on the specified service ID.

Values

1 to 2147483647 | svc-name: 64 char max

host ip-address

Clears the IGMP statistics on the specified host.

host all

Clears the IGMP statistics on all hosts.

interface ip-int-name

Clears IGMP statistics on the specified interface.

interface ip-address

Clears IGMP statistics on the specified IP address.

statistics
Syntax

statistics [{[interface ip-int-name | ip-address | mt-int-name]} {[group grp-ip-address [source ip-address]]}] [family]]

Context

clear>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command clears PIM statistics on a specified interface or IP address.

An interface and group or source cannot be specified at the same time.

Parameters
interface ip-int-name

Clears PIM statistics on the specified interface.

interface ip-address

Clears PIM statistics on the specified IP address.

group grp-ip-address

When only the group address is specified and no source is specified, (*,G) statistics are cleared. When the group address is specified along with the source address, then the (S,G) statistics are reset to zero.

source ip-address

When the source address is specified along with the group address, then the (S,G) statistics are reset to zero.

family

Clears IPv4 information.

version
Syntax

version group-interface [fwd-service service-id] ip-int-name

version group-interface all

version host ip-address

version host all

version [interface ip-int-name | ip-address]

Context

clear>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command clears IGMP statistics on a specified interface or IP address.

Parameters
group-interface interface-name

Clears the IGMP version on the specifies group interface.

group-interface all

Clears the IGMP version on all group interfaces.

fwd-service service-id

Clears the IGMP version on the specified service ID.

Values

1 to 2147483647 | svc-name: 64 char max

host ip-address

Clears the IGMP version on the specified host.

host all

Clears the IGMP version on all hosts.

interface ip-int-name

Clears IGMP version on the specified interface.

interface ip-address

Clears IGMP version on the specified IP address.

neighbor
Syntax

neighbor [ip-int-name | ip-address] [family]

Context

clear>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command clears PIM neighbor data on a specified interface or IP address.

Parameters
ip-int-name

Clears PIM neighbor on the specified interface.

ip-address

Clears PIM neighbor on the specified IP address.

family

Clears IPv4 information.

igmp-snooping
Syntax

igmp-snooping

Context

clear>service>id

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context clear IGMP snooping-related data.

port-db
Syntax

port-db {sap sap-id | sdp sdp-id:vc-id} [group grp-address [source ip-address]]

Context

clear>service>id>igmp-snooping

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command clears the information about the IGMP snooping port database.

Parameters
sap sap-id

Clears IGMP snooping statistics matching the specified SAP ID and optional encapsulation value. The sap-id can be in one of the following formats:

Encapsulation type

Syntax

Example

null

port-id

1/1/3

dot1q

port-id :qtag1

1/1/3:100

qinq

port-id :qtag1.qtag2

1/1/3:100.200

qtag1, qtag2

The encapsulation value on the specified port ID.

Values

0 to 4094

sdp sdp-id

Clears only IGMP snooping entries associated with the specified mesh SDP or spoke-SDP. For a spoke-SDP, the VC ID must be specified; for a mesh SDP, the VC ID is optional.

Values

1 to 17407

vc-id

The virtual circuit ID on the SDP ID for which to clear information.

Values

1 to 4294967295

Default

for mesh SDPs only, all VC IDs

group grp-address

Clears IGMP snooping statistics matching the specified group address.

source ip-address

Clears IGMP snooping statistics matching one particular source within the multicast group.

querier
Syntax

querier

Context

clear>service>id>igmp-snooping

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command clears information about the IGMP snooping queriers for the VPLS service.

statistics
Syntax

statistics [sap sap-id | sdp sdp-id:vc-id]

Context

clear>service>id>igmp-snooping

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command clears IGMP snooping statistics for the VPLS service.

Parameters
sap sap-id

Displays IGMP snooping statistics for a specific SAP. The sap-id can be in one of the following formats:

Encapsulation type

Syntax

Example

null

port-id

1/1/3

dot1q

port-id :qtag1

1/1/3:100

qinq

port-id :qtag1.qtag2

1/1/3:100.200

qtag1, qtag2

The encapsulation value on the specified port ID.

Values

0 to 4094

sdp sdp-id

Displays the IGMP snooping statistics for a specific spoke or mesh SDP.

Values

1 to 17407

vc-id

The virtual circuit ID on the SDP ID for which to display information.

Values

1 to 4294967295

Default

for mesh SDPs only, all VC IDs

Debug commands

Debug IGMP commands
group-interface
Syntax

[no] group-interface [fwd-service service-id] [ip-int-name]

Context

debug>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables debugging for IGMP group interfaces.

Parameters
service-id

Displays information associated with the specified service ID.

Values

1 to 2147483647 | svc-name: 64 char max

ip-int-name

Displays information associated with the specified IP interface name, up to 32 characters.

interface
Syntax

[no] interface [ip-int-name | ip-address]

Context

debug>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables debugging for IGMP interfaces.

The no form of this command disables the IGMP interface debugging for the specifies interface name or IP address.

Parameters
ip-int-name

Displays the information associated with the specified IP interface name.

ip-address

Displays the information associated with the specified IP address.

misc
Syntax

[no] misc

Context

debug>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables debugging for IGMP miscellaneous.

The no form of this command disables the debugging.

Output

The following output is an example of IGMP miscellaneous information.

Sample output
A:ALA-CA# debug router igmp misc 
*A:ALA-CA# show debug 
debug
    router 
        igmp
            misc
        exit
    exit
exit
*A:ALA-CA# 
packet
Syntax

packet [query | v1-report | v2-report | v3-report | v2-leave] host ip-address

packet [query | v1-report | v2-report | v3-report | v2-leave] [ip-int-name | ip-address]

no packet [query | v1-report | v2-report | v3-report | v2-leave] [ip-int-name | ip-address]

no packet [query | v1-report | v2-report | v3-report | v2-leave] host ip-address

Context

debug>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables/disables debugging for IGMP packets.

Parameters
query

Specifies to log the IGMP group- and source-specific queries transmitted and received on this interface.

v1-report

Specifies to log IGMP V1 reports transmitted and received on this interface.

v2-report

Specifies to log IGMP V2 reports transmitted and received on this interface.

v3-report

Specifies to log IGMP V3 reports transmitted and received on this interface.

v2-leave

Specifies to log the IGMP Leaves transmitted and received on this interface.

ip-int-name

Displays the information associated with the specified IP interface name.

ip-address

Displays the information associated with the specified IP address.

Debug PIM commands
adjacency
Syntax

[no] adjacency

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for PIM adjacencies.

all
Syntax

all [group grp-ip-address] [source ip-address] [detail]

no all

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for all the PIM modules.

Parameters
group grp-ip-address

Debugs information associated with all PIM modules.

Values

IPv4 address

source ip-address

Debugs information associated with all PIM modules.

Values

IPv4 address

detail

Debugs detailed information about all PIM modules.

assert
Syntax

assert [group grp-ip-address] [source ip-address] [detail]

no assert

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for PIM assert mechanism.

Parameters
group grp-ip-address

Debugs information associated with the PIM assert mechanism.

Values

multicast group address (ipv4)

source ip-address

Debugs information associated with the PIM assert mechanism.

Values

source address (ipv4)

detail

Debugs detailed information about the PIM assert mechanism.

bgp
Syntax

bgp [source ip-address] [group group-ip-address] [peer peer-ip-address]

no bgp

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for PIM/BGP specific interoperation.

Parameters
ip-address

Debugs BGP information associated with the specified source.

Values

source address (ipv4)

group-ip-address

Debugs BGP information associated with the specified group.

Values

group address (ipv4)

peer-ip-address

Debugs BGP information associated with the specified peer.

Values

peer address (ipv4)

bsr
Syntax

bsr [detail]

no bsr

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables debugging for the PIM bootstrap mechanism.

The no form of this command disables debugging.

Parameters
detail

Debugs detailed information about the PIM assert mechanism.

data
Syntax

data [group grp-ip-address] [source ip-address] [detail]

no data

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for PIM data exception.

Parameters
group grp-ip-address

Debugs information associated with the specified data exception.

Values

multicast group address (ipv4)

source ip-address

Debugs information associated with the specified data exception.

Values

source address (ipv4)

detail

Debugs detailed IP data exception information.

db
Syntax

db [group grp-ip-address] [source ip-address] [detail]

no db

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for the PIM database.

Parameters
group grp-ip-address

Debugs information associated with the specified database.

Values

multicast group address (ipv4) or zero

source ip-address

Debugs information associated with the specified database.

Values

source address (ipv4)

detail

Debugs detailed IP database information.

interface
Syntax

interface [ip-int-name | mt-int-name | ip-address] [detail]

no interface

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for the PIM interface.

Parameters
ip-int-name

Debugs the information associated with the specified IP interface name.

Values

IPv4 interface address

ip-address

Debugs the information associated with the specified IP address.

detail

Debugs detailed IP interface information.

jp
Syntax

jp [group grp-ip-address] [source ip-address] [detail]

no jp

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for the PIM join-prune mechanism.

Parameters
group grp-ip-address

Debugs information associated with the specified join-prune mechanism.

Values

multicast group address (ipv4) or zero

source ip-address

Debugs information associated with the specified join-prune mechanism.

Values

source address (ipv4)

detail

Debugs detailed join-prune mechanism information.

mrib
Syntax

mrib [group grp-ip-address] [source ip-address] [detail]

no mrib

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for PIM MRIB.

Parameters
group grp-ip-address

Debugs information associated with the specified PIM MRIB.

Values

multicast group address (ipv4)

source ip-address

Debugs information associated with the specified PIM MRIB.

Values

source address (ipv4)

detail

Debugs detailed MRIB information.

msg
Syntax

msg [detail]

no msg

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for PIM messaging.

Parameters
detail

Debugs detailed messaging information.

packet
Syntax

packet [hello | register | register-stop | jp | bsr | assert] [ip-int-name | ip-address]

no packet

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for PIM packets.

Parameters
hello | register | register-stop | jp | bsr | assert | crp

PIM packet types.

ip-int-name

Debugs the information associated with the specified IP interface name.

Values

IPv4 interface address

ip-address

Debugs the information associated with the specified IP address of a particular packet type.

red
Syntax

red [detail]

no red

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for PIM redundancy messages to the standby CPM.

Parameters
detail

Displays detailed redundancy information.

register
Syntax

register [group grp-ip-address] [source ip-address] [detail]

no register

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for the PIM register mechanism.

Parameters
group grp-ip-address

Debugs information associated with the specified PIM register.

Values

multicast group address (ipv4)

source ip-address

Debugs information associated with the specified PIM register.

Values

source address (ipv4)

detail

Debugs detailed register information.

rtm
Syntax

rtm [detail]

no rtm

Context

debug>router>pim

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables or disables debugging for PIM RTM.

Parameters
detail

Debugs detailed RTM information.