# Monitoring IP Multicast Settings

To display general information about the IP multicast configuration on the router, use the following show commands.

show ip mroute

- Use to display information about all or specified multicast forwarding entries.
- Specify a multicast group IP address or both a multicast group IP address and a multicast source IP address to display information about particular multicast forwarding entries.
- Use the active option to display the active multicast routes with admission bandwidth greater than the specified bandwidth threshold. The default is 4000 bps.
- Use the count option to display the number of multicast forwarding entries.
- Use the oif-detail option to display the details of the join interfaces corresponding to the mapped interface when oif-mapping is configured.
- Use the statistics option to display statistics for packets received through all multicast forwarding entries that the router has added to the multicast routing table and established on the appropriate line modules.
- Use the summary option to see a summary rather than a detailed description.
- Field descriptions
  - (S, G)—IP addresses of the multicast source and the multicast group
  - Admission bandwidth—Admission bandwidth per mroute, in bps
  - QoS bandwidth—QoS bandwidth per mroute, in bps
  - Uptime—Length of time that the (S,G) pair has been active, in days hours:minutes:seconds format
  - Data Rate—Flow rate for the threshold entry, in Kbps
  - SPT Threshold—SPT threshold value for the entry, in Kbps
  - Threshold—Threshold value for the entry, in Kpbs
  - Expires—Length of time that the (S,G) pair can be active, in days hours:minutes:seconds format or never
  - RPF route—IP address and subnetwork mask of the RPF route
  - incoming interface—Type and specifier of the incoming interface for the RPF route
  - neighbor address—IP address of the neighbor
  - State/Owner—Owner of the route
    - Local—Route belonging to the local interface
    - Static—Static route
    - Other protocols—Route established by a protocol such as RIP or OSPF
  - Incoming interface list—List of incoming interfaces on the router. Details include:
    - Type of interface and its specifier
    - Action that the interface takes with packets: Accept or Discard
    - Multicast protocol that owns the interface
  - Outgoing interface list—List of outgoing interfaces on the router. Details include:
    - Type of interface and its specifier
    - Action that the interface takes with packets: Forward or Blocked (intf-adm-limit, join-intf-adm-limit, port-adm-limit, port-limit, port-priority-adm-limit)
    - Protocol running on the interface: PIM, DVMRP, or IGMP
    - Amount of time that the interface has been active in this multicast forwarding entry, in days hours:minutes:seconds format
    - Length of time that the interface can remain active in this multicast forwarding entry, in days hours:minutes:seconds format or never
  - Counts—Number of types of source group mappings
    - (S, G)—Number of (S, G) entries
    - (*, G)—Number of (*, G) entries
- Example 1—Constant bandwidth bit rate

      host1#show ip mroute
      IP Multicast Routing Table

      (S, G) uptime d h:m:s
        [Data rate: Kbps]  [SPT Threshold: Kbps]  [Threshold: Kbps]
        [Admission bandwidth: bps]
        [QoS bandwidth: bps]
        RPF route: addr/mask, incoming interface
                   neighbor address, owner route-owner
        Incoming interface list:
            Interface (addr/mask), State/Owner [(RPF IIF)]
        Outgoing interface list:
            Interface (addr/mask), State/Owner, Uptime/Expires

      (10.0.10.1, 225.1.1.1) uptime 0 00:10:31
        Data rate: 2132 Kbps, Threshold 500 Kbps
        Admission bandwidth: 2000000 bps
        RPF route: 10.0.10.0/24, incoming interface atm5/3.1010
                   neighbor 10.0.10.8, owner Local
        Incoming interface list:
            atm5/3.1010 (10.0.10.8/24), Accept/Pim (RPF IIF)
        Outgoing interface list:
            atm5/1.108 (108.0.8.5/8), Forward/Pim, 0 00:02:52/never
            atm5/1.109 (107.0.8.4/8), Forward/Pim, 0 00:10:07/never

      (1.1.1.1, 225.1.1.1) uptime 0 00:00:34, never expires
      RPF route: 1.0.0.0/8, incoming interface ATM5/1.200
                   neighbor 2.2.2.2, owner Netmgmt
        Incoming interface list:
            ATM5/1.200 (2.1.1.1/8), Accept/Igmp (RPF IIF)
        Outgoing interface list:
            ATM5/1.300 (3.1.1.1/8), Forward/Igmp, 0 00:00:34/never

      Counts:     2 (S, G) entries
                  0 (*, G) entries

  | Note: The (S,G) entry (1.1.1.1, 225.1.1.1) is the permanent mroute.

- Example 2—Adaptive bandwidths enabled

      Host1#show ip mroute
                        IP Multicast Routing Table

      (S, G) uptime d h:m:s[, expires d h:m:s]
        [Admission bandwidth: bps]
        [QoS bandwidth: bps]
        RPF route: addr/mask, incoming interface
                   neighbor address, owner route-owner
        Incoming interface list:
            Interface (addr/mask), State/Owner [(RPF IIF)]
        Outgoing interface list:
            Interface (addr/mask), State/Owner, Uptime/Expires

       (10.0.1.9, 225.1.1.1) uptime 0 00:00:23
        Admission bandwidth: 1998000 bps (adaptive)
        QoS bandwidth: 1998000 bps (adaptive)
        RPF route: 10.0.0.0/8, incoming interface ATM2/1.200
                   neighbor 21.1.1.1, owner Netmgmt
        Incoming interface list:
            ATM2/1.200 (21.2.2.2/8), Accept/Pim (RPF IIF)
        Outgoing interface list:
            ATM2/1.300 (31.2.2.2/8), Blocked (port-adm-limit)/Pim, 0 00:00:23/never

      Counts: 1 (S, G) entries
              0 (*, G) entries

- Example 3—Outgoing interface blocked when bandwidth limit of all the join interfaces exceeds configured CAC limits

      host1#show ip mroute
                        IP Multicast Routing Table

      (S, G) uptime d h:m:s[, expires d h:m:s]
        [Admission bandwidth: bps]
        [QoS bandwidth: bps]
        RPF route: addr/mask, incoming interface
                   neighbor address, owner route-owner
        Incoming interface list:
            Interface (addr/mask), State/Owner [(RPF IIF)]
        Outgoing interface list:
            Interface (addr/mask), State/Owner, Uptime/Expires

       (10.0.1.9, 225.1.1.1) uptime 0 00:00:23
        Admission bandwidth: 1998724 bps (adaptive)
        QoS bandwidth: 1998724 bps (adaptive)
        RPF route: 10.0.0.0/8, incoming interface ATM2/1.200
                   neighbor 21.1.1.1, owner Netmgmt
        Incoming interface list:
            ATM2/1.200 (21.2.2.2/8), Accept/Pim (RPF IIF)
        Outgoing interface list:
            ATM2/1.300 (31.2.2.2/8), Blocked (join-intf-adm-limit)/IGMP, 0 00:00:23/never

      Counts: 1 (S, G) entries
              0 (*, G) entries

- See show ip mroute.

show ip mroute active

- Use to display the active multicast routes with admission bandwidth greater than the specified bandwidth threshold.
- The default is 4000 bps.
- Field descriptions
  - See the show ip mroute command and the show ip mroute summary command for descriptions of all fields.
- Example 1—Displays active multicast routes with bandwidth above 10000 bps

      host1#show ip mroute active 10000
                    Active IP Multicast Routes >=10000 bps

      (S, G) uptime d h:m:s[, expires d h:m:s]
        [Admission bandwidth: bps]
        [QoS bandwidth: bps]
        RPF route: addr/mask, incoming interface
                   neighbor address, owner route-owner
        Incoming interface list:
            Interface (addr/mask), State/Owner [(RPF IIF)]
        Outgoing interface list:
            Interface (addr/mask), State/Owner, Uptime/Expires

      (52.0.0.1, 232.0.0.1) uptime 0 00:01:07
        Admission bandwidth: 47000 bps (adaptive)
        QoS bandwidth: 47000 bps (adaptive)
        RPF route: 52.0.0.0/24, incoming interface ATM2/1.17
            neighbor 17.0.0.2, owner NetmgmtRpf
        Incoming interface list:
            ATM2/1.17 (17.0.0.2/24), Accept/Igmp (RPF IIF)
        Outgoing interface list:
            NULL

      Counts: 1 (S, G) entries
              0 (*, G) entries

- Example 2—Displays the summary of active multicast routes

      host1#show ip mroute summary active
                    Active IP Multicast Routes >=4000 bps

      Group Address   Source Address  RPF route          RPF Iif         #Oifs
      --------------- --------------- ------------------ --------------- -----
      232.0.0.1       51.0.0.1        51.0.0.0/24        ATM3/1.17       0
      232.0.0.2       51.0.0.1        51.0.0.0/24        ATM3/1.17       0
      232.0.0.3       51.0.0.1        51.0.0.0/24        ATM3/1.17       0
      Counts: 3 (S, G) entries
              0 (*, G) entries

- See show ip mroute.

show ip mroute count

- Use to display information about the number of groups and sources.
- Specify a multicast group address or both a multicast group address and a multicast source address to display information about a particular multicast forwarding entry.
- Field descriptions
  - Counts—Number of types of source group mappings
    - (S, G)—Number of (S,G) entries
    - (*, G)—Number of (*,G) entries
- Example

      host1#show ip mroute count
                        IP Multicast Routing Table

      Counts:     2 (S, G) entries
                  0 (*, G) entries

- See show ip mroute.

show ip mroute oif-detail

- Use to display details of the join interfaces corresponding to the mapped interfaces when OIF mapping is configured.
- Field descriptions
  - Join interface list—List of join interfaces on the router. Details include:
    - Type of interface and its specifier
    - Action that the interface takes with packets: Forward or Blocked (intf-adm-limit, join-intf-adm-limit, port-adm-limit, port-limit, port-priority-adm-limit)
    - Protocol running on the interface: PIM, DVMRP, or IGMP
    - Amount of time that the interface has been active in this multicast forwarding entry, in days hours:minutes:seconds format
    - Length of time that the interface can remain active in this multicast forwarding entry, in days hours:minutes:seconds format or never
  - See the show ip mroute command and the show ip mroute summary command for descriptions of all fields.
- Example 1—Displays details of the join interfaces

      host1#show ip mroute oif-detail
                        IP Multicast Routing Table

      (S, G) uptime d h:m:s[, expires d h:m:s]
        [Admission bandwidth: bps]
        [QoS bandwidth: bps]
        RPF route: addr/mask, incoming interface
                   neighbor address, owner route-owner
        Incoming interface list:
            Interface (addr/mask), State/Owner [(RPF IIF)]
        Outgoing interface list:
            Interface (addr/mask), State/Owner, Uptime/Expires

       (10.0.1.9, 225.1.1.1) uptime 0 00:00:23
        Admission bandwidth: 1998724 bps (adaptive)
        QoS bandwidth: 1998724 bps (adaptive)
        RPF route: 10.0.0.0/8, incoming interface ATM2/1.200
                   neighbor 21.1.1.1, owner Netmgmt
        Incoming interface list:
            ATM2/1.200 (21.2.2.2/8), Accept/Pim (RPF IIF)
        Outgoing interface list:
            ATM2/1.300 (31.2.2.2/8), Forward/IGMP, 0 00:00:23/never
      				Join interface list:
      						ATM2/1.2 (2.2.2.2/32), Blocked (intf-adm-limit)/IGMP, 0 00:00:23/never
      						ATM2/1.3 (3.2.2.2/32), Forward/IGMP, 0 00:00:23/never

      Counts: 1 (S, G) entries
              0 (*, G) entries

- See show ip mroute.

show ip mroute statistics

- Use to display statistics for packets received through multicast routes that the router has added to the multicast routing table and established on the appropriate line modules.
- Specify a multicast group IP address or both a multicast group IP address and a multicast source IP address to display information about a particular multicast forwarding entry.
- Field descriptions
  - See the show ip mroute command for descriptions of all fields except the Statistics field.
  - Statistics

    | Note: The display shows statistics after the VR has added the multicast route to the multicast routing table and established the route on the appropriate line module. Statistics for interactions that take place before the route is established on the line module are not displayed.

    - Received—Number of packets and bytes that the VR received for this multicast route
    - Forwarded—Number of packets and bytes that the VR has forwarded for this multicast route
    - Rcvd on OIF—Number of packets that the VR has received on the outgoing interface (OIF) for this multicast route
- Example

      host1#show ip mroute statistics
      IP Multicast Routing Table

      (S, G) uptime d h:m:s[, expires d h:m:s]
        [Admission bandwidth: bps]
        [QoS bandwidth: bps]
        RPF route: addr/mask, incoming interface
                   neighbor address, owner route-owner
        Incoming interface list:
            Interface (addr/mask), State/Owner [(RPF IIF)]
        Outgoing interface list:
            Interface (addr/mask), State/Owner, Uptime/Expires
      (10.0.1.9, 225.1.1.1) uptime 0 00:00:23
        Admission bandwidth: 2000000 bps
        QoS bandwidth: 2000000 bps
        RPF route: 10.0.0.0/8, incoming interface ATM2/1.200
                   neighbor 21.1.1.1, owner Netmgmt
        Incoming interface list:
            ATM2/1.200 (21.2.2.2/8), Accept/Pim (RPF IIF)
        Outgoing interface list:
            ATM2/1.300 (31.2.2.2/8), Blocked (port-adm-limit)/Pim, 0 00:00:23/never
        Statistics:
            Received   : 23 pkts, 1472 bytes
            Forwarded  : 0 pkts, 0 bytes
            Rcvd on OIF: 0 pkts

      Counts: 1 (S, G) entries
              0 (*, G) entries

- See show ip mroute.
- See statistics.

show ip mroute summary

- Use to display a summary of all or specified multicast routes.
- Specify a multicast group IP address or both a multicast group IP address and a multicast source IP address to display information about a particular multicast forwarding entry.
- Field descriptions
  - Group Address—IP address of the multicast group
  - Source Address—IP address of the multicast source
  - RPF route—IP address and network mask of the RPF route
  - RPF Iif —Type and identifier for the incoming interface for the RPF route
  - #Oifs—Number of outgoing interfaces
  - Counts—Numbers of types of (S,G) pairs
    - (S,G)—Number of (S,G) entries
    - (*,G)—Number of (*,G) entries
- Example

      host1#show ip mroute summary
                        IP Multicast Routing Table

      Group Address   Source Address  RPF route    RPF Iif         #Oifs
      --------------- --------------- ---------    -------------   ----
      224.0.1.39      52.1.1.1        51.1.1.1/32  Register IIF    0
      224.0.1.40      51.1.1.1        51.1.1.1/32  loopback1       1

      Counts:     2 (S, G) entries
                  0 (*, G) entries

- See show ip mroute.

show ip multicast protocols

- Use to display information about multicast protocols enabled on the router.
- Use the brief option to display a summary of information rather than a detailed description.
- Field descriptions
  - Multicast Protocols—Multicast protocols on this router
  - Protocol—Name of the multicast protocol
  - Type—Mode of the multicast protocol
    - For DVMRP—Dense
    - For PIM—Sparse, Dense, or Sparse-Dense
    - For IGMP—Local
  - Interfaces
    - registered—Number of interfaces on which the protocol is configured
    - owned—Number of interfaces that a protocol owns. If you configure only IGMP on an interface, IGMP owns the interface. However, if you configure IGMP and either PIM or DVMRP on the same interface, PIM or DVMRP owns the interface.
  - Registered interfaces—Information about interfaces on which the protocol is configured:
    - Types and specifiers of interfaces. For details about interface types and specifiers, see Interface Types and Specifiers in JunosE Command Reference Guide.
    - Protocols configured on the interface and the protocol that owns the interface. If you configure only IGMP on an interface, IGMP owns the interface. However, if you configure IGMP and PIM or DVMRP on the same interface, PIM or DVMRP owns the interface.
- Admission-bandwidth—Actual admission bandwidth/configured admission bandwidth (in bps)
- QoS Adjust—Bandwidth of QoS adjustment, in bps
  - Count—Number of multicast protocols on the VR
  - Active <S,G> count—Number of active S,G data streams on the interface
  - Blocked <S,G> count—Number of blocked S,G data streams on the interface
- Example

      host1#show ip multicast protocols
      Multicast protocols:

      Protocol Pim
          Type: Sparse
          Interfaces: 1 registered, 1 owned
          Registered interfaces:
              ATM2/1.103 (103.0.0.2/24) owner Pim

      Protocol Igmp
          Type: Local
          Interfaces: 1000 registered, 1000 owned
          Registered interfaces:
              ATM2/0.131 (13.0.0.1/24) local Igmp owner Igmp
                  Admission-bandwidth 2000000/10000000 bps
                  QoS Adjust 2000000 bps
              Active <S,G> count   15
              Blocked <S,G> count  10

              ATM2/0.132 (13.0.0.2/24) local Igmp owner Igmp
                  Admission-bandwidth 0/10000000 bps
                  QoS Adjust 0 bps
              Active <S,G> count   25
              Blocked <S,G> count  10

              ATM2/0.133 (13.0.0.3/24) local Igmp owner Igmp
                  Admission-bandwidth 8000000/10000000 bps
                  QoS Adjust 0 bps
      ...
      Count: 2  protocols

- See show ip multicast protocols.

show ip multicast protocols brief

- Use to display a summary of information about multicast protocols enabled on the router.
- Field descriptions
  - Protocol—Name of the multicast protocol
  - Registered Interfaces—Number of interfaces on which the protocol is configured
  - Owned Interfaces—Number of interfaces that a protocol owns. If you configure only IGMP on an interface, IGMP owns the interface. However, if you configure IGMP and either PIM or DVMRP on the same interface, PIM or DVMRP owns the interface.
  - Type—Mode of the multicast protocol
    - For DVMRP—Dense
    - For PIM—Sparse, dense, or sparse-dense
    - For IGMP—Local
  - Count—Number of multicast protocols on the VR
- Example

      host1#show ip multicast protocols brief

      Protocol  Registered  Owned       Type
                Interfaces  Interfaces
      --------- ----------  ----------  -------------------
      Pim       2           2           Sparse Dense
      Igmp      1           0           Local

      Count: 2 protocols

- See show ip multicast protocols.

show ip multicast routing

- Use to display information about the status of IP multicast on the VR.
- Example

      host1#show ip multicast routing
      Multicast forwarding is enabled on this router
      Multicast graceful restart is complete (timer 0 seconds) on this router
      Multicast cache-miss processing is enabled on this router

- See show ip multicast routing.

show mroute port count

- Use to display the mroute port outgoing interface, limits, counts, bandwidth settings, and bandwidth accepted.

  | Note: This command displays information for mroutes on a port across all virtual routers.

- Field descriptions
  - Port—Slot/port value on the router
  - Limit—Port limit value defined for the specified port; -l indicates that no mrout port limits have been configured for the port
  - Count—Number of mroute outgoing interfaces on the specified port
  - BW bps—Bandwidth limit, in bits per second
  - Priority BW bps—Priority bandwidth limit, in bits per second
  - Admitted—Bandwidth admitted on the port, in bits per second
- Example

      host1#show mroute port count

      BW     Priority
      Port    Limit   Count    bps     BW bps    Hysteresis   Admitted
      -----   -----   -----   -----   --------   ----------   --------
      1/1/0   None    1       None    None       85           0
      1/1/1   None    2       15000   10000      85           2000

- See show mroute port count.

## Support for Multicast Router Information

When you enable multicast routing on a virtual router, the router acts as a multicast router information (mrinfo) server. This feature enables the router to respond to mrinfo requests from other network hosts. Specifically, E Series virtual routers respond to DVMRP ask neighbors and DVMRP ask neighbors2 requests.

Each virtual router responds to mrinfo requests with a list of multicast interfaces and their IP addresses. If appropriate, the virtual router also supplies the following information for each interface:

- Current functional status of the interface (for example, if the interface is down).
- Information as to whether the interface is disabled and the reason for the interface being disabled—either because IP is not configured on the interface or because the interface has been disabled through the software.
- Whether the interface is performing the IGMP queries for this subnet.
- Information about PIM neighbors:

  If PIM is configured on the interface, the virtual router supplies a list of the interface's PIM neighbors and indicates which neighbors are leaf neighbors.

- Information about DVMRP and GRE tunnels:

  If the interface is an endpoint of a tunnel, the virtual router specifies the IP address of the endpoint of the tunnel.