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