Usr-Dhcp-MIB

All MIBs › Usr-Dhcp-MIB

Organization: CommWorks Corporation, a 3Com Company

Last Updated: 2002-05-05

Category: CommWorks/3Com Access Equipment

Description: Manages DHCP server pools, leases, and relay agent 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-Dhcp-MIB?

Usr-Dhcp-MIB is a proprietary MIB originating from US Robotics/CommWorks (later part of 3Com) equipment, defining objects for DHCP server address pools, client leases, and relay-agent configuration on the device. It exposes configuration and operational data about DHCP service delivery—pool definitions, lease state, and relay behavior—making it primarily a software/service-level monitoring MIB for confirming the DHCP service is running correctly rather than a hardware-health MIB. Administrators would use it to watch for pool exhaustion, lease allocation failures, or relay misconfiguration that would prevent clients from obtaining addresses. It complements (but is distinct from) the standard IETF DHCP-related MIBs, being CommWorks/3Com's own implementation. It is typically deployed on CommWorks/3Com broadband access or remote-access equipment providing DHCP services to dial-up or broadband subscribers. Engineers can download the Usr-Dhcp-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in Usr-Dhcp-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

CommWorks/3Com broadband/remote-access equipment

Monitoring Examples

No concrete sample objects were provided for this module, so a specific object-grounded scenario isn't available; in general an operator would expect to poll DHCP pool utilization and lease-table entries to detect address-pool exhaustion or relay-agent failures affecting subscriber connectivity.

Imported Objects

From SNMPv2-SMI

Counter32
Integer32
IpAddress
MODULE-IDENTITY
OBJECT-TYPE

From SNMPv2-TC

DisplayString
RowStatus

From USR-DEFINITIONS-MIB

UsrConfigStatus
common	OBJECT-IDENTITY

How to Use in IPNetwork Monitor

Example using usrDhcpClientMessages OID:

Select a CommWorks/3Com broadband/remote-access equipment (DHCP pool/lease/relay 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 usrDhcpClientMessages into the Find box to locate it in the OID tree, then select it and click OK. The total number of messages received on the LAN interface from the Client. 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 sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
usrDhcp	1.3.6.1.4.1.429.4.59			The commWorks enterprise defined MIB objects for the Dynamic Host Configuration Protocol.
STR usrDhcpConfigFileName	1.3.6.1.4.1.429.4.59.1	DisplayString	read-only	The name of a ConfigFile to read/write permanent database records. If the value of this object is an empty string, then the Filter Manager process uses the default name `@file://filter.cfg'.
USR usrDhcpCFMStatusFlag	1.3.6.1.4.1.429.4.59.2	UsrConfigStatus	read-write	Setting the value of this object to `save' causes the values of the SNMP Group to be written out to the current config file, which is stored in the usrFilterConfigFileName object. While the new ConfigFile is being written, the SNMP process will set the value of this flag to `saving''. Any attempts to set the value while it is not `normal' (i.e. the file is currently being written to the ConfigFile) will result in a badValue error being returned. Setting the value to `normal' will result in no action.
INT usrDhcpAgent	1.3.6.1.4.1.429.4.59.3	INTEGER	read-write	this variable enables/disables the DHCP Relay Agent
IP usrDhcpServer1	1.3.6.1.4.1.429.4.59.4	IpAddress	read-write	when usrDhcpAgent is enabled, this variable contains the DHCP Server IP Address.
IP usrDhcpServer2	1.3.6.1.4.1.429.4.59.5	IpAddress	read-write	when usrDhcpAgent is enabled, this variable contains the DHCP Server IP Address.
C32 usrDhcpClientMessagesEx	1.3.6.1.4.1.429.4.59.6	Counter32	read-only	The total number of messages received on the LAN interface from the Client.
C32 usrDhcpServerMessages	1.3.6.1.4.1.429.4.59.7	Counter32	read-only	The total number of messages received on the WAN interfaces from the Servers.
C32 usrDhcpClientErrors	1.3.6.1.4.1.429.4.59.8	Counter32	read-only	The total number of messages received on the LAN interfaces from the Client which were discarded due to validation errors.
C32 usrDhcpServerErrors	1.3.6.1.4.1.429.4.59.9	Counter32	read-only	The total number of messages received on the WAN interfaces from the Servers which were discarded due to validation errors.
STR usrDhcpCmGiAddr	1.3.6.1.4.1.429.4.59.10	DisplayString	read-write	The network name for the Cable Modems in the Cable Modem Termination System
STR usrDhcpCpeGiAddr	1.3.6.1.4.1.429.4.59.11	DisplayString	read-write	The network name for the Customer Premises Equipment in the Cable Modem Termination System
INT usrDhcpMode	1.3.6.1.4.1.429.4.59.12	INTEGER	read-write	this variable selects the DHCP mode. When set to Server, the router will be a local DHCP server and assign configured addresses and parameters to the clients on the LAN. When set to Relay, the router will send the Client DHCP/BOOTP requests to the configured remote Server(s).
usrDhcpProTable	1.3.6.1.4.1.429.4.59.13		not-accessible	Table of Client configuration profiles
usrDhcpProEntry	1.3.6.1.4.1.429.4.59.13.1		not-accessible	Client configuration profile
I32 usrDhcpProIndex	1.3.6.1.4.1.429.4.59.13.1.1	Integer32	not-accessible	Profile index
I32 usrDhcpProLease	1.3.6.1.4.1.429.4.59.13.1.2	Integer32	read-write	Address lease lifetime. Default of -1 indicates infinite lease
IP usrDhcpProRtr	1.3.6.1.4.1.429.4.59.13.1.3	IpAddress	read-write	IP Address of default router for client
IP usrDhcpProDNS1	1.3.6.1.4.1.429.4.59.13.1.4	IpAddress	read-write	IP address of DNS server for client
IP usrDhcpProDNS2	1.3.6.1.4.1.429.4.59.13.1.5	IpAddress	read-write	IP address of secondary DNS server
IP usrDhcpProWINS1	1.3.6.1.4.1.429.4.59.13.1.6	IpAddress	read-write	IP address of primary WINS server
IP usrDhcpProWINS2	1.3.6.1.4.1.429.4.59.13.1.7	IpAddress	read-write	IP address of secondary WINS Server
STR usrDhcpProHost	1.3.6.1.4.1.429.4.59.13.1.8	DisplayString	read-write	Base host name. Each host name allocated will a a numeric suffix added
STR usrDhcpProDomain	1.3.6.1.4.1.429.4.59.13.1.9	DisplayString	read-write	Domain name
ROW usrDhcpProStatus	1.3.6.1.4.1.429.4.59.13.1.10	RowStatus	read-write	Status of the Profile Table row
usrDhcpAutoTable	1.3.6.1.4.1.429.4.59.14		not-accessible	Table of IP address allocation entries
usrDhcpAutoEntry	1.3.6.1.4.1.429.4.59.14.1		not-accessible	Automatic IP address allocation entry
I32 usrDhcpAutoIndex	1.3.6.1.4.1.429.4.59.14.1.1	Integer32	not-accessible	Auto range index
IP usrDhcpAutoSeed	1.3.6.1.4.1.429.4.59.14.1.2	IpAddress	read-write	Initial seed address. Default 10.0.0.1
IP usrDhcpAutoMask	1.3.6.1.4.1.429.4.59.14.1.3	IpAddress	read-write	Subnet mask. Default 255.0.0.0
IP usrDhcpAutoRange	1.3.6.1.4.1.429.4.59.14.1.4	IpAddress	read-write	Highest IP address. Default of 255.255.255.255 indicates up to limit of seed mask
I32 usrDhcpAutoPro	1.3.6.1.4.1.429.4.59.14.1.5	Integer32	read-write	Index of client configuration profile
ROW usrDhcpAutoStatus	1.3.6.1.4.1.429.4.59.14.1.6	RowStatus	read-write	Status of the range table row
usrDhcpLeaseTable	1.3.6.1.4.1.429.4.59.15		not-accessible	A table of automatically allocated IP addresses
usrDhcpLeaseEntry	1.3.6.1.4.1.429.4.59.15.1		not-accessible	A description of an automatically-allocated address
IP usrDhcpLeaseIpAddr	1.3.6.1.4.1.429.4.59.15.1.1	IpAddress	not-accessible	Automatically allocated IP address
I32 usrDhcpLeaseIfIndex	1.3.6.1.4.1.429.4.59.15.1.2	Integer32	read-write	Interface over which IP address was allocated
MAC usrDhcpLeaseHwAddr	1.3.6.1.4.1.429.4.59.15.1.3	MacAddress	read-write	Hardware address of client to which IP address was allocated
OCT usrDhcpLeaseCID	1.3.6.1.4.1.429.4.59.15.1.4	OCTET STRING	read-write	Identifier of client to which IP address was allocated
I32 usrDhcpLeaseValue	1.3.6.1.4.1.429.4.59.15.1.5	Integer32	read-write	Lifetime of lease. -1 if permanently allocated
I32 usrDhcpLeaseLife	1.3.6.1.4.1.429.4.59.15.1.6	Integer32	read-write	Remaining lifetime of lease. -1 if permanently allocated
INT usrDhcpLeaseType	1.3.6.1.4.1.429.4.59.15.1.7	INTEGER	read-write	Type of lease
ROW usrDhcpLeaseStatus	1.3.6.1.4.1.429.4.59.15.1.8	RowStatus	read-write	Status of the Lease Table row
C32 usrDhcpLeaseReqRx	1.3.6.1.4.1.429.4.59.16	Counter32	read-only
C32 usrDhcpRenewalReqRx	1.3.6.1.4.1.429.4.59.17	Counter32	read-only
C32 usrDhcpAcceptReqRx	1.3.6.1.4.1.429.4.59.18	Counter32	read-only
C32 usrDhcpDeclineRx	1.3.6.1.4.1.429.4.59.19	Counter32	read-only
C32 usrDhcpReleaseRx	1.3.6.1.4.1.429.4.59.20	Counter32	read-only
C32 usrDhcpInvalidRx	1.3.6.1.4.1.429.4.59.21	Counter32	read-only
C32 usrDhcpOfferTx	1.3.6.1.4.1.429.4.59.22	Counter32	read-only
C32 usrDhcpConfirmTx	1.3.6.1.4.1.429.4.59.23	Counter32	read-only
C32 usrDhcpDenialTx	1.3.6.1.4.1.429.4.59.24	Counter32	read-only
C32 usrDhcpReqAddrOutOfRange	1.3.6.1.4.1.429.4.59.25	Counter32	read-only
C32 usrDhcpReqAddrInUse	1.3.6.1.4.1.429.4.59.26	Counter32	read-only
C32 usrDhcpNoFreeAddr	1.3.6.1.4.1.429.4.59.27	Counter32	read-only
C32 usrDhcpReqLeaseTooLong	1.3.6.1.4.1.429.4.59.28	Counter32	read-only
INT usrDhcpProxyEnabled	1.3.6.1.4.1.429.4.59.29	INTEGER	read-write	this variable sets the DHCP proxy to enabled/disabled
INT usrDhcpProxyDiscIfLeaseExp	1.3.6.1.4.1.429.4.59.30	INTEGER	read-write	this sets the behavior if IP address lease expires
usrDhcpProxyLeaseTable	1.3.6.1.4.1.429.4.59.31		not-accessible	A table of automatically allocated IP addresses
usrDhcpProxyLeaseEntry	1.3.6.1.4.1.429.4.59.31.1		not-accessible	A description of an automatically-allocated address
I32 usrDhcpProxyLeaseIndex	1.3.6.1.4.1.429.4.59.31.1.1	Integer32	not-accessible	Index to the table which makes each entry unique
STR usrDhcpProxyLeaseCID	1.3.6.1.4.1.429.4.59.31.1.2	DisplayString	read-only	Identifier of client to which IP address was allocated
IP usrDhcpProxyLeaseIpAddr	1.3.6.1.4.1.429.4.59.31.1.3	IpAddress	read-only	Automatically allocated IP address
I32 usrDhcpProxyLeaseIfIndex	1.3.6.1.4.1.429.4.59.31.1.4	Integer32	read-only	Interface over which IP address was allocated
MAC usrDhcpProxyLeaseHwAddr	1.3.6.1.4.1.429.4.59.31.1.5	MacAddress	read-only	Hardware address of client to which IP address was allocated
I32 usrDhcpProxyLeaseValue	1.3.6.1.4.1.429.4.59.31.1.6	Integer32	read-only	Lifetime of lease. -1 if permanently allocated
I32 usrDhcpProxyLeaseLife	1.3.6.1.4.1.429.4.59.31.1.7	Integer32	read-only	Remaining lifetime of lease. -1 if permanently allocated
ROW usrDhcpProxyLeaseStatus	1.3.6.1.4.1.429.4.59.31.1.8	RowStatus	read-only	Status of the Lease Table row
C32 usrDhcpProxyDiscoveries	1.3.6.1.4.1.429.4.59.32	Counter32	read-only
C32 usrDhcpProxyOffers	1.3.6.1.4.1.429.4.59.33	Counter32	read-only
C32 usrDhcpProxyAddressesAcquired	1.3.6.1.4.1.429.4.59.34	Counter32	read-only
C32 usrDhcpProxyAddressesReleased	1.3.6.1.4.1.429.4.59.35	Counter32	read-only
C32 usrDhcpProxyClientsActive	1.3.6.1.4.1.429.4.59.36	Counter32	read-only
C32 usrDhcpProxyT1renewals	1.3.6.1.4.1.429.4.59.37	Counter32	read-only
C32 usrDhcpProxyT2renewals	1.3.6.1.4.1.429.4.59.38	Counter32	read-only
I32 usrDhcpProxyMaxRetry	1.3.6.1.4.1.429.4.59.39	Integer32	read-write	PRoxy Client retry count value
I32 usrDhcpServerResetCounters	1.3.6.1.4.1.429.4.59.40	Integer32	read-write	An user action to reset all the server counter contains to value zero
I32 usrDhcpProxyClientResetCounters	1.3.6.1.4.1.429.4.59.41	Integer32	read-write	An user action to reset all the ProxyClient counter contains to value zero
I32 usrDhcpServerResetSettings	1.3.6.1.4.1.429.4.59.42	Integer32	read-write	An user action to reset all the server Addresses to value zero

RFC description

CommWorks Dynamic Host Configuration Protocol (DHCP) relay agent configuration and management.

Start monitoring CommWorks/3Com broadband/remote-access equipment (DHCP pool/lease/relay 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-Dhcp-MIB

What Is Usr-Dhcp-MIB?

Supported Devices

Monitoring Examples

This MIB depends on

Related MIBs

How to Use in IPNetwork Monitor

RFC description