BAS-DHCP-RELAY-MIB

All MIBs › BAS-DHCP-RELAY-MIB

Organization: Broadband Access Systems, Inc.

Last Updated: 1999-02-03

Category: DOCSIS and Cable, IP and Core Protocols

Description: Manages DHCP relay agent configuration and forwarding statistics on the BAS broadband access platform.

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 BAS-DHCP-RELAY-MIB?

BAS-DHCP-RELAY-MIB manages DHCP relay agent configuration and forwarding statistics on Broadband Access Systems cable infrastructure. It exposes per-interface relay enable/configuration objects along with counters for each DHCP message type - Discover, Offer, Request, Decline, and NAK. Monitoring this data reveals the software-level health of the DHCP provisioning path: whether relay is enabled per port and whether DHCP transactions are completing successfully or failing at scale. It complements standard DHCP relay behavior rather than replacing it, working within the broader BAS chassis architecture. The BAS-DHCP-RELAY-MIB MIB is deployed on cable/broadband access chassis that relay subscriber DHCP requests to upstream provisioning servers.

IPNetwork Monitor allows you to monitor SNMP objects defined in BAS-DHCP-RELAY-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

Broadband Access System (BAS) CMTS/chassis

Monitoring Examples

An administrator inspects basDhcpRelayTable/basDhcpRelayEntry indexed by basDhcpRelayChassis, basDhcpRelaySlot, basDhcpRelayIf, and basDhcpRelayLPort, comparing basDhcpRelayDiscover and basDhcpRelayOffer counts against basDhcpRelayNak. A rising basDhcpRelayNak or basDhcpRelayDecline count relative to Discover/Offer suggests subscriber modems are failing to obtain IP leases, pointing to a DHCP server or relay misconfiguration on that slot/port.

What Can Be Monitored

relay enabled state per interface
DHCP discover count
offer count
request count
decline count
NAK count

Imported Objects

From BAS-MIB

BasChassisId
BasInterfaceId
BasLogicalPortId
BasSlotId
BasSubnetClass
basDhcpRelay	OBJECT-IDENTITY

From SNMPv2-SMI

Counter32
Integer32
IpAddress
MODULE-IDENTITY
OBJECT-TYPE

From SNMPv2-TC

RowStatus

How to Use in IPNetwork Monitor

Example using basDhcpRelayDiscover OID:

Select a Broadband Access Systems (BAS) CMT (legacy) 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 basDhcpRelayDiscover 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. It reports the number of Discover messages. 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
basDhcpRelayMIB	1.3.6.1.4.1.3493.2.15.1			The MIB module defines the configuration MIB objects for Broadband Access Systems, Inc. DHCP Relay functionality extensions.
basDhcpRelayTable	1.3.6.1.4.1.3493.2.15.1.1		not-accessible	A list of DHCP Relay entries.
basDhcpRelayEntry	1.3.6.1.4.1.3493.2.15.1.1.1		not-accessible	An entry containing management information applicable to a particular DHCP Relay.
BAS basDhcpRelayChassis	1.3.6.1.4.1.3493.2.15.1.1.1.1	BasChassisId	not-accessible	The BAS Chassis ID of the Card.
BAS basDhcpRelaySlot	1.3.6.1.4.1.3493.2.15.1.1.1.2	BasSlotId	not-accessible	The BAS Slot ID of the Card.
NUM basDhcpRelayIf	1.3.6.1.4.1.3493.2.15.1.1.1.3	BasInterfaceId	not-accessible	The BAS interface ID of the Card.
BAS basDhcpRelayLPort	1.3.6.1.4.1.3493.2.15.1.1.1.4	BasLogicalPortId	not-accessible	The BAS logical port ID of the Card.
INT basDhcpRelayEnable	1.3.6.1.4.1.3493.2.15.1.1.1.5	INTEGER	read-write	Enable and disable DHCP relay on the card.
C32 basDhcpRelayDiscoverEx	1.3.6.1.4.1.3493.2.15.1.1.1.6	Counter32	read-only	Number of Discover messages.
C32 basDhcpRelayOffer	1.3.6.1.4.1.3493.2.15.1.1.1.7	Counter32	read-only	Number of Offer messages.
C32 basDhcpRelayRequest	1.3.6.1.4.1.3493.2.15.1.1.1.8	Counter32	read-only	Number of Request messages.
C32 basDhcpRelayDecline	1.3.6.1.4.1.3493.2.15.1.1.1.9	Counter32	read-only	Number of Decline messages.
C32 basDhcpRelayNak	1.3.6.1.4.1.3493.2.15.1.1.1.10	Counter32	read-only	Number of Nak messages.
C32 basDhcpRelayInform	1.3.6.1.4.1.3493.2.15.1.1.1.11	Counter32	read-only	Number of Inform messages.
C32 basDhcpRelayAck	1.3.6.1.4.1.3493.2.15.1.1.1.12	Counter32	read-only	Number of Ack messages.
C32 basDhcpRelayRelease	1.3.6.1.4.1.3493.2.15.1.1.1.13	Counter32	read-only	Number of Release messages.
INT basDhcpRelayHelper	1.3.6.1.4.1.3493.2.15.1.1.1.14	INTEGER	read-write	Enable gateway selection based on primary/secondary interface address.
INT basDhcpRelayAlwaysBroadcast	1.3.6.1.4.1.3493.2.15.1.1.1.15	INTEGER	read-write	Enable always broadcasting response to the client.
INT basDhcpRelayDuplicateResponse	1.3.6.1.4.1.3493.2.15.1.1.1.16	INTEGER	read-write	Enable sending response to client in unicast and broadcast mode.
INT basDhcpRelayBasEnable	1.3.6.1.4.1.3493.2.15.1.1.1.17	INTEGER	read-write	Enable BAS proprietory solution.
C32 basDhcpRelayBogusAgentDrops	1.3.6.1.4.1.3493.2.15.1.1.1.18	Counter32	read-only	Packets dropped because agent option field was specified and we're not relaying packets that already have an agent option specified.
C32 basDhcpRelayBogusGiaddrDrops	1.3.6.1.4.1.3493.2.15.1.1.1.19	Counter32	read-only	Packets sent to us to relay back to a client, but with a bogus giaddr.
C32 basDhcpRelayServerPacketErrors	1.3.6.1.4.1.3493.2.15.1.1.1.20	Counter32	read-only	Errors sending packets to servers.
C32 basDhcpRelayClientPacketErrors	1.3.6.1.4.1.3493.2.15.1.1.1.21	Counter32	read-only	Errors sending packets to clients.
INT basDhcpRelayAddAgentOptions	1.3.6.1.4.1.3493.2.15.1.1.1.22	INTEGER	read-write	If nonzero, add relay agent options.
INT basDhcpRelayDropAgentMismatch	1.3.6.1.4.1.3493.2.15.1.1.1.23	INTEGER	read-write	If nonzero, drop server replies that don't contain a Relay Agent Information option whose Agent ID suboption matches our giaddr.
C32 basDhcpRelayCorruptAgentOptions	1.3.6.1.4.1.3493.2.15.1.1.1.24	Counter32	read-only	Number of packets dropped because relay agent information option was bad.
C32 basDhcpRelayMissingAgentOption	1.3.6.1.4.1.3493.2.15.1.1.1.25	Counter32	read-only	Number of packets dropped because no RAI option matching our ID was found.
C32 basDhcpRelayBadCircuitId	1.3.6.1.4.1.3493.2.15.1.1.1.26	Counter32	read-only	Circuit ID option in matching RAI option did not match any known circuit ID
C32 basDhcpRelayMissingCircuitId	1.3.6.1.4.1.3493.2.15.1.1.1.27	Counter32	read-only	Circuit ID option in matching RAI option was missing.
I32 basDhcpRelayMaxAgentOptionPacketLength	1.3.6.1.4.1.3493.2.15.1.1.1.28	Integer32	read-write	If nonzero, drop server replies that don't contain a Relay Agent Information option whose Agent ID suboption matches our giaddr.
INT basDhcpRelayAgentRelayMode	1.3.6.1.4.1.3493.2.15.1.1.1.29	INTEGER	read-write	What to do about packets we're asked to relay that already have a relay option: forward_and_append, /* Forward and append our own relay option. / forward_and_replace, / Forward, but replace theirs with ours. / forward_untouched, / Forward without changes. */ discard } agent_relay_mode = forward_and_replace
basDhcpRelayServerTable	1.3.6.1.4.1.3493.2.15.1.2		not-accessible	A list of DHCP Relay Server entries.
basDhcpRelayServerEntry	1.3.6.1.4.1.3493.2.15.1.2.1		not-accessible	An entry containing management information applicable to a particular DHCP Relay Server.
BAS basDhcpRelayServerChassis	1.3.6.1.4.1.3493.2.15.1.2.1.1	BasChassisId	not-accessible	The BAS Chassis ID of the Card.
BAS basDhcpRelayServerSlot	1.3.6.1.4.1.3493.2.15.1.2.1.2	BasSlotId	not-accessible	The BAS Slot ID of the Card.
NUM basDhcpRelayServerIf	1.3.6.1.4.1.3493.2.15.1.2.1.3	BasInterfaceId	not-accessible	The BAS interface ID of the Card.
BAS basDhcpRelayServerLPort	1.3.6.1.4.1.3493.2.15.1.2.1.4	BasLogicalPortId	not-accessible	The BAS logical port ID of the Card.
IP basDhcpRelayServerAddress	1.3.6.1.4.1.3493.2.15.1.2.1.5	IpAddress	not-accessible	Address of DHCP Relay Server on this forwarder.
BAS basDhcpRelayServerType	1.3.6.1.4.1.3493.2.15.1.2.1.6	BasSubnetClass	not-accessible	Type of DHCP server. When picking a DHCP server, \ choice is made depending on type.
ROW basDhcpRelayServerStatus	1.3.6.1.4.1.3493.2.15.1.2.1.7	RowStatus	read-create	Adding and deleting the Server.

RFC description

Defines DHCP relay configuration and statistics for Broadband Access Systems equipment.

Start monitoring Broadband Access Systems (BAS) CMTS (legacy) 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 BAS-DHCP-RELAY-MIB