USR-IGMP-MIB

All MIBs › USR-IGMP-MIB

Organization: CommWorks Corporation, a 3Com Company

Last Updated: 2002-02-07

Category: CommWorks/3Com Access Equipment

Description: Manages IGMP group membership, multicast routing, and proxy configuration on CommWorks/3Com equipment.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is USR-IGMP-MIB?

USR-IGMP-MIB is a CommWorks/3Com (formerly U.S. Robotics) enterprise MIB that manages IGMP group membership, multicast routing, and IGMP proxy configuration on their network access equipment. It exposes per-interface IGMP configuration (query interval, IGMP version, querier status) as well as operational counters like join counts and protocol version mismatches. Rather than physical hardware sensors, this MIB monitors software/protocol-level status: whether an interface is acting as IGMP querier, how many group joins have occurred, and whether wrong-version queries are being seen, which reveals multicast misconfiguration or interoperability problems between IGMP versions. It depends on standard IGMP protocol semantics (RFC 2236/3376) and the general commWorks enterprise MIB structure, and complements other interface-level MIBs like IF-MIB. It is typically deployed on 3Com/CommWorks broadband access routers or remote access concentrators handling multicast traffic such as IPTV distribution, where operators poll the USR-IGMP-MIB MIB to confirm querier and join status.

IPNetwork Monitor allows you to monitor SNMP objects defined in USR-IGMP-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

3Com/CommWorks broadband access router
remote access concentrator

Monitoring Examples

An admin would walk usrIgmpInterfaceTable/usrIgmpInterfaceEntry to check usrIgmpInterfaceQuerier and usrIgmpInterfaceVersion per interface, confirming only one router is acting as the IGMP querier on a shared segment. A climbing usrIgmpInterfaceWrongVersionQueries counter would flag a version mismatch (e.g., IGMPv2 vs v3) between devices, while usrIgmpInterfaceJoins trending near zero on an interface expected to carry IPTV traffic would indicate a multicast delivery problem.

What Can Be Monitored

IGMP querier status per interface
IGMP version per interface
group join counts
wrong-version query counts
query interval and max response time configuration

Imported Objects

From SNMPv2-SMI

Counter32
Gauge32
Integer32
IpAddress
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-IDENTITY
OBJECT-TYPE
TimeTicks

From SNMPv2-TC

DisplayString
RowStatus
TruthValue

From USR-DEFINITIONS-MIB

UsrDisplayString
common	OBJECT-IDENTITY

How to Use in IPNetwork Monitor

Example using usrIgmpInterfaceWrongVersionQueries OID:

Select a 3Com/CommWorks broadband access router, remote access concentrator (IGMP querier/join-count status) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type usrIgmpInterfaceWrongVersionQueries into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. The number of queries received whose IGMP version does not match usrIgmpInterfaceVersion. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases between polls, since a rising count of errors, failures, or discards often points to a real underlying problem. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
usrIgmp	1.3.6.1.4.1.429.4.53			The commWorks enterprise defined MIB objects for IGMP
usrIgmpInterfaceTable	1.3.6.1.4.1.429.4.53.1		not-accessible	The (conceptual) table listing the interfaces on which IGMP is enabled.
usrIgmpInterfaceEntry	1.3.6.1.4.1.429.4.53.1.1		not-accessible	An entry (conceptual row) representing an interface on which IGMP is enabled.
STR usrIgmpInterfaceIfName	1.3.6.1.4.1.429.4.53.1.1.1	DisplayString	not-accessible	The interface name for which IGMP is enabled.
I32 usrIgmpInterfaceQueryInterval	1.3.6.1.4.1.429.4.53.1.1.2	Integer32	read-create	The frequency at which IGMP Host-Query packets are transmitted on this interface.
ROW usrIgmpInterfaceStatus	1.3.6.1.4.1.429.4.53.1.1.3	RowStatus	read-create	The activation of a row enables IGMP on the interface. The destruction of a row disables IGMP on the interface.
INT usrIgmpInterfaceVersion	1.3.6.1.4.1.429.4.53.1.1.4	INTEGER	read-create	The version of IGMP which is running on this interface. This object can be used to configure a router capable of running either value. For IGMP to function correctly, all routers on a LAN must be configured to run the same version of IGMP on that LAN.
IP usrIgmpInterfaceQuerier	1.3.6.1.4.1.429.4.53.1.1.5	IpAddress	read-only	The address of the IGMP Querier on the IP subnet to which this interface is attached.
I32 usrIgmpInterfaceQueryMaxResponseTime	1.3.6.1.4.1.429.4.53.1.1.6	Integer32	read-create	The maximum query response time advertised in IGMPv2 queries on this interface. Smaller values allow a router to prune groups faster.
I32 usrIgmpInterfaceVersion1QuerierTimer	1.3.6.1.4.1.429.4.53.1.1.7	Integer32	read-only	The time remaining until the host assumes that there are no IGMPv1 routers present on the interface. While this is non-zero, the host will reply to all queries with version 1 membership reports.
C32 usrIgmpInterfaceWrongVersionQueriesEx	1.3.6.1.4.1.429.4.53.1.1.8	Counter32	read-only	The number of queries received whose IGMP version does not match usrIgmpInterfaceVersion. IGMP requires that all routers on a LAN be configured to run the same version of IGMP. Thus, if any queries are received with the wrong version, this indicates a configuration error.
C32 usrIgmpInterfaceJoins	1.3.6.1.4.1.429.4.53.1.1.9	Counter32	read-only	The number of times a group membership has been added on this interface; that is, the number of times an entry for this interface has been added to the Cache Table. This object gives an indication of the amount of IGMP activity over time.
G32 usrIgmpInterfaceGroups	1.3.6.1.4.1.429.4.53.1.1.10	Gauge32	read-only	The current number of entries for this interface in the Cache Table.
I32 usrIgmpInterfaceRobustness	1.3.6.1.4.1.429.4.53.1.1.11	Integer32	read-create	The Robustness Variable allows tuning for the expected packet loss on a subnet. If a subnet is expected to be lossy, the Robustness Variable may be increased. IGMP is robust to (Robustness Variable-1) packet losses.
T/F usrIgmpInterfaceMcastFwdEnabled	1.3.6.1.4.1.429.4.53.1.1.12	TruthValue	read-create	If enabled Multicast packets will be forwarded on this interface.
T/F usrIgmpInterfacePushEnabled	1.3.6.1.4.1.429.4.53.1.1.13	TruthValue	read-create	If enabled once a Multicast group is learned on this interface it will not be removed even if a report is not received within the membership interval.
T/F usrIgmpInterfaceProxyEnabled	1.3.6.1.4.1.429.4.53.1.1.14	TruthValue	read-create	If enabled when a Multicast group is learned on this interface it will also be joined as a proxy on the ethernet interface specified in usrIgmpInterfaceProxyIfName.
C32 usrIgmpInterfaceShortPackets	1.3.6.1.4.1.429.4.53.1.1.15	Counter32	read-only	The number of short IGMP packets received on this interface.
C32 usrIgmpInterfaceBadChecksum	1.3.6.1.4.1.429.4.53.1.1.16	Counter32	read-only	The number of IGMP packets with bad checksum received on this interface.
C32 usrIgmpInterfaceQueriesReceived	1.3.6.1.4.1.429.4.53.1.1.17	Counter32	read-only	The number of queries received on this interface.
C32 usrIgmpInterfaceReportsReceived	1.3.6.1.4.1.429.4.53.1.1.18	Counter32	read-only	The number of reports received on this interface.
C32 usrIgmpInterfaceReportsForKnownGroups	1.3.6.1.4.1.429.4.53.1.1.19	Counter32	read-only	The number of reports for known groups received on this interface.
C32 usrIgmpInterfaceReportsSent	1.3.6.1.4.1.429.4.53.1.1.20	Counter32	read-only	The number of reports sent on this interface.
C32 usrIgmpInterfaceWrongVersionReports	1.3.6.1.4.1.429.4.53.1.1.21	Counter32	read-only	The number of wrong version reports received on this interface.
usrIgmpCacheTable	1.3.6.1.4.1.429.4.53.2		not-accessible	The (conceptual) table listing the IP multicast groups for which there are members on a particular interface.
usrIgmpCacheEntry	1.3.6.1.4.1.429.4.53.2.1		not-accessible	An entry (conceptual row) in the usrIgmpCacheTable.
IP usrIgmpCacheAddress	1.3.6.1.4.1.429.4.53.2.1.1	IpAddress	not-accessible	The IP multicast group address for which this entry contains information.
STR usrIgmpCacheIfName	1.3.6.1.4.1.429.4.53.2.1.2	DisplayString	not-accessible	The interface name for which this entry contains information for an IP multicast group address.
I32 usrIgmpCacheSelf	1.3.6.1.4.1.429.4.53.2.1.3	Integer32	read-create	An indication of whether the local system is a member of or proxying this group address on this interface.
IP usrIgmpCacheLastReporter	1.3.6.1.4.1.429.4.53.2.1.4	IpAddress	read-only	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.
TIK usrIgmpCacheUpTime	1.3.6.1.4.1.429.4.53.2.1.5	TimeTicks	read-only	The time since the system joined this group address, or zero if the system is not currently a member.
TIK usrIgmpCacheExpiryTime	1.3.6.1.4.1.429.4.53.2.1.6	TimeTicks	read-only	The minimum amount of time remaining before this entry will be aged out.
ROW usrIgmpCacheStatus	1.3.6.1.4.1.429.4.53.2.1.7	RowStatus	read-create	The status of this entry.
I32 usrIgmpCacheVersion1HostTimer	1.3.6.1.4.1.429.4.53.2.1.8	Integer32	read-only	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.
STR usrIgmpProxyInterface	1.3.6.1.4.1.429.4.53.3	UsrDisplayString	read-create	The name of the interface on which all groups learned on the wan connections will be proxied onto if usrIgmpInterfaceProxyEnabled is enabled.
usrIgmpHeartbeatGroup	1.3.6.1.4.1.429.4.53.4
STR usrIgmpHeartbeatInterface	1.3.6.1.4.1.429.4.53.4.1	UsrDisplayString	read-write	The name of the interface on which to monitor multicast traffic for group specified in usrIgmpHeartbeatGroupAddr.
IP usrIgmpHeartbeatGroupAddr	1.3.6.1.4.1.429.4.53.4.2	IpAddress	read-write	The multicast group being monitored.
I32 usrIgmpHeartbeatTime	1.3.6.1.4.1.429.4.53.4.3	Integer32	read-write	The time interval to monitor multicast traffic.
I32 usrIgmpHeartbeatWindow	1.3.6.1.4.1.429.4.53.4.4	Integer32	read-write	The number of usrIgmpHeartbeatTime intervals to monitor multicast traffic on.
I32 usrIgmpHeartbeatThreshold	1.3.6.1.4.1.429.4.53.4.5	Integer32	read-write	If multicast traffic in not received for this number or more intervals a SNMP trap is issued.
INT usrIgmpHeartbeatStatus	1.3.6.1.4.1.429.4.53.4.6	INTEGER	read-write	This object is used to allow the system to start or or stop the IGMP heartbeat feature. This heartbeat feature is used to monitor multicast traffic for a particular multicast group (usrIgmpHeartbeatGroupAddr) on a specified interface (usrIgmpHeartbeatInterface). Traffic is monitored on this interface for usrIgmpHeartbeatWindowSize usrIgmpHeartbeatTime intervals. During each time interval it is determined if multicast traffic was received. After usrIgmpHeartbeatWindowSize time intervals the number of times we did NOT receive traffic is compared against usrIgmpHeartbeatThreshold. If the number of intervals we did NOT receive traffic is equal to or higher than usrIgmpHeartbeatThreshold a SNMP trap is issued.
usrIgmpTraps	1.3.6.1.4.1.429.4.53.5
usrIgmpTrapsV2	1.3.6.1.4.1.429.4.53.5.0			The events for IGMP
NTF usrIgmpHeartbeatTrap	1.3.6.1.4.1.429.4.53.5.0.1			A usrIgmpHeartbeatTrap signifies that the configured number of time intervals have occurred without receiving multicast traffic for the configured group.
INT usrIgmpTrafficAffectInactivity	1.3.6.1.4.1.429.4.53.6	INTEGER	read-write	This object is used to allow the system to treat IGMP traffic over PPP links as background traffic. If this switch is enabled then IGMP traffic will be treated as background traffic and idle timeout functionality will ignore this traffic. If this switch is disabled the IGMP multicast traffic will be treated as regular traffic and connection will not be dropped.

RFC description

Manages IGMP (Internet Group Management Protocol) configuration and multicast group membership on network interfaces.

Start monitoring 3Com/CommWorks broadband access router, remote access concentrator (IGMP querier/join-count status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download USR-IGMP-MIB