Monitoring IGMP

You can establish a reference point for IGMP statistics by setting the statistics counters to zero.

To display IGMP parameters, use the show commands described in this section.

Note: The E120 and E320 routers output for monitor and show commands is identical to output from other E Series routers, except that the E120 and E320 routers output also includes information about the adapter identifier in the interface specifier (slot/adapter/port).

baseline ip igmp

Use to set the counters for IGMP statistics to zero, to establish a baseline.
Example
(host1)#baseline ip igmp
There is no no version.
See baseline ip igmp.

show ip igmp

Use to display IGMP information for a VR.
Field descriptions
- Routing Process—Routing process for this VR (IGMP)
- Administrative state—Status of IGMP in the software: enabled or disabled
- Operational state—Status of IGMP on the VR: enabled or disabled
- Total interfaces—Number of interfaces on which you started IGMP
- enabled—Number of interfaces on which IGMP is enabled
- disabled—Number of interfaces on which IGMP is disabled
- learnt groups—Number of multicast groups that the VR has discovered
- IGMP graceful restart duration—Restart interval in seconds
- IGMP Statistics Rcvd—Statistics for IGMP messages received
  - total—Total number of IGMP messages received
  - checksum errors—Number of IGMP messages received with checksum errors
  - unknown types—Number of IGMP messages received that are not group membership queries, group membership reports, or leave group membership messages
  - queries—Number of group membership queries
  - reports—Number of group membership reports
  - leaves—Number of leave group membership messages
- IGMP Statistics Sent—Statistics for IGMP messages sent
  - Total number of group membership queries sent

Example

host1:boston#show ip igmp
Routing Process IGMP, Administrative state enabled, Operational state enabled
    2 total interfaces, 2 enabled, 0 disabled
0 enabled interfaces performing graceful restart
2 learnt groups
IGMP Statistics:
    Rvcd: 1 total, 0 checksum errors, 0 unknown types
          0 queries, 1 reports, 0 leaves
    Sent: 11 total

See show ip igmp.

show ip igmp groups

Use to display statically joined and directly connected groups learned through IGMP.
Field descriptions
- Grp Address—Address of the multicast group
- Interface—Interface that discovered the multicast group
- oif-map—Name of the OIF map and the mapped OIF interface, when a group or source has been mapped to an OIF
- State—IGMP version on the interface
- ExpTim—Time, in seconds, at which the router stops polling for more members of this group
- oldHTo—Time at which the router stops polling for more IGMPv1 members of a group. If this value is 0, the interface has received no IGMPv1 reports for the group.
- Included Sources—Sources included in the multicast group
- Excluded Sources—Sources excluded from the multicast group
- Counts—Number of source-group mappings by version and state

Example 1—Without OIF mapping

host1:boston#show ip igmp groups
Grp Address   Interface       State      Reporter      ExpTim oldHTo
------------- --------------- ----------- ------------ ------ ------
228.1.1.      FastEthernet1/1 Version3   17.0.0.2        44      0
228.1.1.2     FastEthernet1/1 Version3   17.0.0.2        50      0
228.1.1.3     FastEthernet1/1 Version3   17.0.0.2        48      0
230.1.1.1     FastEthernet1/1 Version3   17.0.0.2        44      0
  Included Sources:
    51.0.0.1                                                    44
    51.0.0.2                                                    44
    51.0.0.3                                                    44
231.1.1.1     FastEthernet1/1 Version3    17.0.0.2       44      0
  Excluded Sources:
    51.0.0.1                                                     0
    51.0.0.2                                                     0
    51.0.0.3                                                     0

Counts: 5 version-3, 0 version-2, 0 version-1, 0 check state, 0 disabled
       (5 total)
        0 excluded
        Source-groups: 3 included, 3 excluded

Example 2—With OIF mapping

host1:boston#show ip igmp groups
Grp Address   Interface       State       Reporter     ExpTim oldHTo
------------- --------------- ----------- ------------ ------ ------
232.1.1.1     ATM5/0.12       Version3    1.1.1.2       371      0
                    oif-map OIFMAP ATM5/0.121              
232.1.1.1     ATM5/0.13       Version3    1.1.1.3       375      0
                    oif-map OIFMAP ATM5/0.121               
232.1.1.2     ATM5/0.12       Version3    1.1.1.2       373      0
  Included Sources:
    10.1.1.2        oif-map OIFMAP self                        373
    10.1.1.10       oif-map OIFMAP ATM5/0.120                  373
    10.1.1.11       oif-map OIFMAP ATM5/0.121                  373
232.1.1.2     ATM5/0.13       Version3    1.1.1.3       375      0
  Included Sources:
    10.1.1.2        oif-map OIFMAP self                        375
    10.1.1.10       oif-map OIFMAP ATM5/0.120                  375
    10.1.1.11       oif-map OIFMAP ATM5/0.121                  375
 
Counts: 4 version-3, 0 version-2, 0 version-1, 0 check state, 0 disabled
       (4 total)
        0 excluded
        Source-groups: 6 included, 0 excluded

See show ip igmp groups.

show ip igmp interface

Use to display IGMP information for interfaces on which you enabled IGMP.
Specify the brief keyword to see a summary of the information.
Specify the count keyword to see the number of IGMP interfaces.
Specify the group address keyword to see information for interfaces that belong to that group.
Field descriptions
- Interface—Type of interface and interface specifier. For details about interface types and specifiers, see Interface Types and Specifiers in JunosE Command Reference Guide.
- address—IP address of the interface
- Administrative state—Status of the interface in the software: enabled or disabled
- Operational state—Physical status of the interface: enabled or disabled
- Version—IGMP version
- State—Function of the interface: querier or nonquerier
- Query Interval—Time interval in seconds at which this interface sends query messages
- Other querier present interval—Time in seconds that the interface waits before declaring itself as the querier
- Maximum response time—Time interval, in tenths of a second, during which this interface waits for a host to respond
- Last member query interval—Time, in tenths of a second, that this interface waits before sending a new query to a host that sends a group leave message
- Robustness—Number of times this interface sends IGMP messages
- Information about whether the interface accepts IGMP reports from hosts on any subnetwork
  - Interface defaults to global promiscuous mode—Interface uses the setting of the igmp promiscuous command to determine whether it accepts IGMP reports from hosts on any subnetwork
- Information about standard IP access lists configured with the ip igmp access-group command
  - Inbound access group—Access list specified
  - No inbound access group—No access list specified
- Information about IP access lists configured with the ip igmp access-source-group command
  - Inbound access source-group—Access list specified
  - No inbound access source-group—No access list specified
- Information about OIF maps configured with the ip igmp apply-oif-map command
  - Inbound apply-oif-map—Map name specified
  - No inbound apply-oif-map—No map name specified
- Immediate Leave—Setting of the ip igmp immediate-leave command: enabled or disabled
- Explicit Host Tracking—Setting of the ip igmp explicit-tracking command: enabled or disabled
- Max-Group limit—Number of IGMP groups that the interface can accept, as configured with the ip igmp group limit command
- Admission-Bandwidth limit—Value of the admission-bandwidth limit set for an interface that accepts IGMP groups, or No Limit
- Group Count—Number of IGMP groups that the interface has accepted
- IOA packet replication—Hardware multicast packet replication interface to which egress multicast packets on this interface are redirected
- Interface statistics Rcvd—Information about IGMP messages received on this interface
  - reports—Number of group membership reports received
  - leaves—Number of group leave messages received
  - wrong version queries—Number of group membership queries received from devices running a different version of IGMP
- Interface statistics Sent—Number of IGMP messages this interface has sent
- Interface statistics Groups learnt—Number of groups this interface has discovered
- Counts—Breakdown of IGMP interfaces
  - down—Number of interfaces down
  - init state—Number of interfaces in the initialization state
  - querier—Number of querier interfaces
  - non-querier—Number of non-querier interfaces
  - Total—Total number of IGMP interfaces

Example 1

host1:boston#show ip igmp interface
Interface ATM2/1.15 address 15.0.0.2/255.255.255.0
Administrative state enabled, Operational state enabled
Interface parameters:
    Version 2
    State Querier
    Query Interval 125 secs, 53 secs before the next query
    Other querier present interval 250 secs
    Maximum response time 100 (in 10ths of a second)
    Last member query interval 10 (in 10ths of a second)
    Robustness 3
    Interface defaults to global promiscuous mode
    No inbound access group
    No inbound access source-group
    No inbound apply-oif-map
    Immediate Leave: disabled
Explicit Host Tracking: enabled
Max-Group limit: No Limit
    Admission-Bandwidth limit: No Limit
    Group Count: 1
Interface statistics:
    Rcvd: 0 reports, 0 leaves, 0 wrong version queries
    Sent: 1 queries
    Groups learnt: 1

Counts: 0 down, 0 init state, 1 querier, 0 non-querier, 1 Total
Counts: 0 down, 0 init state, 1 querier, 0 non-querier, 1 Total

Example 2

host1#show ip igmp interface gigabitEthernet 3/0.0
Interface GigabitEthernet3/0.0 address 10.1.1.1/255.255.255.0
Administrative state enabled, Operational state disabled
Interface parameters:
    Version 2
    State Down
    Query Interval 125 secs
    Other querier present interval 250 secs
    Maximum response time 100 (in 10ths of a second)
    Last member query interval 10 (in 10ths of a second)
    Robustness 3
    Interface defaults to global promiscuous mode
    No inbound access group
    No inbound access source-group
    No inbound apply-oif-map
    Immediate Leave: disabled
Explicit Host Tracking: enabled
Max-Group limit: No Limit
    Admission-Bandwidth limit: No Limit
    Group Count: 0
    IOA packet replication gigabitEthernet 3/8.1
Interface statistics:
    Rcvd: 0 reports, 0 leaves, 0 wrong version queries
    Sent: 0 queries
    Groups learnt: 0

See show ip igmp interface.

show ip igmp interface brief

Use to display a summary of IGMP information for interfaces on which you enabled IGMP.
Field descriptions
- Interface—Type of interface and interface specifier. For details about interface types and specifiers, see Interface Types and Specifiers in JunosE Command Reference Guide.
- Intf Address—IP address of the interface
- Ver—IGMP version
- State—Function of the interface: querier or nonquerier
- Querier—IP address of the querier on the network to which this interface connects
- QTime—Time interval, in seconds, at which this interface sends query messages
- QPTime—Time in seconds that the interface waits before declaring itself as the querier
- Count—Total number of IGMP interfaces

Example

host1:boston# show ip igmp interface brief
Interface        Intf Address     Ver  State    Querier        QTime  QPTime
--------------   ----------       ---  ------   -------------  -----  --- 
fastEthernet0/0  192.168.1.250/24  2   Querier  192.168.1.250  28     0
atm3/0.2         21.1.1.1/8        2   Querier  21.1.1.1       26     0
Count: 2 interfaces

See show ip igmp interface.

show ip igmp mapped-oif

Use to display the current mappings to all mapped outgoing interfaces or to the specified mapped outgoing interface.
Field descriptions
- OIF—Outgoing interface used in an OIF map
- Oper—Operation status of the outgoing interface
- Group Address—Multicast group IP address associated with the OIF
- Source Address—Source IP address associated with the OIF
- Join I/F—IGMP interface associated with the OIF
- Map Name—Name of the map associated to the OIF
- Counts—Number of source-group mappings to OIFs

Example

host1# show ip igmp mapped-oif
     OIF       Oper  Group Address  Source Address     Join I/F      Map Name 
--------------- ---- --------------- --------------- --------------- ----------
ATM5/0.120      Up   232.1.1.2       10.1.1.10       ATM5/0.12       OIFMAP    
                                                     ATM5/0.13       OIFMAP    
ATM5/0.121      Up   232.1.1.1       *               ATM5/0.12       OIFMAP    
                                                     ATM5/0.13       OIFMAP    
                     232.1.1.2       10.1.1.11       ATM5/0.12       OIFMAP    
                                                     ATM5/0.13       OIFMAP    
 
Counts: 3 source-group mappings

See show ip igmp mapped-oif.

show ip igmp membership

Use to display IGMP membership information for multicast groups and (S, G) channels.
Specify the tracked keyword to see interface information only for interfaces where explicit host tracking is enabled.
Field descriptions
- Group—Multicast group or (S, G) channel
- Source—(S, G) entries that are forwarding traffic
- Reporter—Hosts that requested including sources or have not requested excluding sources. If listed under a group, host that sent exclude reports for the group. If listed under a source, host that requested traffic from this source for the group. For any (S, G), if listed under a source, indicates hosts interested in the traffic for this (S, G).
- ExpTim—Expiration time.
- Flags
  - M—Uses Oifmap
  - S—SSM mapped
  - T—Tracked
  - 1, 2, 3—IGMP version that the group is in
- Interface—Type of interface and interface specifier. For details about interface types and specifiers, see Interface Types and Specifiers in JunosE Command Reference Guide.

Example

host1# show ip igmp membership
Flags: M – Uses Oifmap  S– SSM mapped  T – tracked 
       1,2,3 – The version of IGMP the group is in
Reporter:
<ip-address> - last reporter if the group is not explicitly tracked
<n>/<m> - <n> reporters include mode, <m> reporters in exclude
Group            Source             Reporter         ExpTim    Flags     Interface
---------------  ---------------    -------------    ------    ------    ---------------
224.0.1.40           *              10.10.1.1        02:41     2S        FastEthernet2/1
224.0.1.50                          1/2              02:56     3MT       FastEthernet2/2 
                                    11.10.0.21       02:56
                                    11.10.2.22       02:30      
                 20.30.0.11         
                                    11.10.0.23       02:48     
                 20.30.0.12         
                                    11.10.0.21       02:56     
                 20.30.0.13         
                                    11.10.0.21       02:56 
                                    11.10.0.22       02:30     
                                    11.10.0.23       02:48     
224.0.1.60                          20.20.0.1        01:56     3        FastEthernet2/3
                 10.30.0.100                         02:45
                 10.30.0.101                         02:35 
                 10.30.0.102                         02:15 
                 10.30.0.104                         stop
224.0.1.70                          30.20.0.1        stop      3        FastEthernet2/4
                 40.30.0.100                         01:10
                 40.30.0.101                         01.24
239.0.1.80                          2/0              stop      3T       FastEthernet2/5 
                 50.30.0.100        
                                    10.10.0.10       02:48     
                 50.30.0.101        
                                    10.10.0.20       02:56     
                                    10.10.0.10       02:48     
                 50.30.0.102        10.10.0.20       02:56     
235.0.1.90                          0/3              02:56     2T       FastEthernet2/6 
                      *             
                                    12.10.0.10       02:48     
                                    12.10.0.20       02:56     
                                    12.10.0.30       02:48

See show ip igmp membership.

show ip igmp oif-map

Use to display all outgoing interface (OIF) maps or the OIF map for the specified map name.
Field descriptions
- Map Name—Name of the map associated to the show output
- Group Prefix—Multicast group IP prefix
- Source Prefix—Source IP prefix
- OIF—Outgoing interface associated with the group and source prefix

Example

host1#show ip igmp oif-map

     Map Name         Group Prefix      Source Prefix           OIF        
------------------ ------------------ ------------------ ------------------
OIFMAP             232.1.1.0/24       0.0.0.0/0          ATM5/0.121        
                   232.1.1.0/24       10.1.1.2/32        self              
                   232.1.1.0/24       10.1.1.10/32       ATM5/0.120        
                   232.1.1.3/32       0.0.0.0/0          ATM5/0.130        
                   232.1.1.4/32       0.0.0.0/0          ATM5/0.130

See show ip igmp oif-map.

show ip igmp oif-mapping

Use to display the mapped OIF that is assigned to a given map-name, group address, and source address.
Field descriptions
- OIF-MAP Name—Name of the map requested
- Group Address—Multicast group IP address requested
- Source Address—Source IP address requested
- Mapped OIF—Interface associated with the OIF map

Example

host1#show ip igmp oif-mapping OIFMAP 232.1.1.1 10.1.1.10
 
    OIF Mapping
    OIF-MAP Name   : OIFMAP
    Group Address  : 232.1.1.1
    Source Address : 10.1.1.10
    Mapped OIF     : ATM5/0.120

See show ip igmp oif-mapping.

show ip igmp ssm-mapping

Use to display the SSM mapping state and the source list mapping associated with a multicast group address.
Field descriptions
- SSM Mapping—Status of SSM mapping on the interface: Enabled or Disabled
- Group Address—Multicast group address requested
- Source List—List of sources mapped to the multicast group address

Example

host1:boston#show ip igmp ssm-mapping 232.1.1.1

    SSM Mapping   : Enabled
    Group Address : 232.1.1.1
    Source List   : 172.1.1.1
                  : 172.1.1.2

See show ip igmp ssm-mapping.

show multicast group limit

Use to display the number of IGMP groups that ports have accepted and, if configured, the maximum number of groups that ports can accept.
A value of –1 indicates that no port group limit is configured.
Only ports that have accepted IGMP groups and ports for which you have configured a limit for the number of IGMP groups appear in this display.
Field descriptions
- Port—Identifier of the port in slot/port format
  - slot—Number of the chassis slot in the range 0–6 (ERX7xx models) and 0–13 (ERX14xx models)
  - port—Port number on the I/O module
- limit—Maximum number of IGMP groups that the port can accept. A value of –1 indicates that no limit has been specified.
- count—Actual number of IGMP groups that the port has accepted

Example

host1:boston#show multicast group limit
Port      limit count
--------- ----- -----
2/0           5     0
2/1          -1     1

See show multicast group limit.