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 summary option to see a summary rather than a detailed description.
Use the count option to display the number of multicast forwarding entries.
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 active option to display the active multicast routes with admission bandwidth greater than the specified bandwidth threshold. The default is 4000 bps.
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 (port-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

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 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.