GET-SUBTREE-MIB

All MIBs › GET-SUBTREE-MIB

Organization: IRTF Network Management Research Group

Last Updated: 2000-10-20

Description: GET-SUBTREE-MIB module

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 GET-SUBTREE-MIB?

GET-SUBTREE-MIB is a vendor-neutral experimental MIB produced by the IRTF Network Management Research Group (draft-irtf-nmrg-get-subtree-mib-01) that provides a trap-based mechanism for retrieving an entire MIB subtree in parallel, as an alternative to repeated GetNext/GetBulk polling. A manager first creates a row in getSubtreeRootTable specifying one or more root OIDs to retrieve, then creates a matching row in getSubtreeControlTable naming itself (via getSubtreeControlTarget, an SNMP-TARGET-MIB reference) as the recipient; the agent then streams the requested subtree back as a series of getSubtreeResponse notifications, each carrying a chunk of varbinds plus getSubtreeControlSeqNumber, getSubtreeControlCount, and getSubtreeControlDone to let the manager track completion. Both root and control rows are automatically deleted by the agent once retrieval finishes or is aborted, making this a self-cleaning, session-oriented control MIB rather than a persistent configuration MIB. It never advanced beyond experimental/informational status and depends only on core SNMPv2-SMI/SNMPv2-CONF constructs plus SNMP-TARGET-MIB for addressing, and engineers researching the GET-SUBTREE-MIB RFC draft will find it documents a bulk-retrieval-via-traps design that saw little adoption in production SNMP agents.

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

vendor-neutral, standards-based experimental MIB (draft-irtf-nmrg-get-subtree-mib-01), not tied to a specific manufacturer

Monitoring Examples

A manager creates a getSubtreeRootTable entry pointing at a large table's root OID and a matching getSubtreeControlTable entry naming itself as the trap target, then watches for a sequence of getSubtreeResponse notifications with getSubtreeControlDone finally set to true(1); notifications that stop arriving with getSubtreeControlDone still false would indicate the retrieval operation stalled or the agent aborted it.

What Can Be Monitored

subtree retrieval operation root OID(s)
retrieval control target and row status
trap sequence number and count
retrieval completion flag

Imported Objects

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
Unsigned32
enterprises

From SNMPv2-TC

RowStatus
TruthValue

OIDs

OID symbolic	OID numeric	Type	Access	Description
getSubtreeMIB	1.3.6.1.4.1.9911			This MIB module provides the ability to retrieve arbitrary subtrees of OIDs (in parallel) by receiving traps.
getSubtreeMIBObjects	1.3.6.1.4.1.9911.1
getSubtree	1.3.6.1.4.1.9911.1.1
getSubtreeRootTable	1.3.6.1.4.1.9911.1.1.1		not-accessible	The (conceptual) table containing the root OID(s) of the MIB subtree(s) to be retrieved. Multiple rows with different values for getSubtreeRootOID may be created if the manager wishes to retrieve several subtrees simultaneously
getSubtreeRootEntry	1.3.6.1.4.1.9911.1.1.1.1		not-accessible	An entry (conceptual row) specifying the root OID of the MIB subtree to be retrieved
U32 getSubtreeRootOperationID	1.3.6.1.4.1.9911.1.1.1.1.1	Unsigned32	not-accessible	An integer uniquely identifying the GetSubtree operation in progress. This value should be randomly generated by a manager before attempting to create the row.
U32 getSubtreeRootOIDIndex	1.3.6.1.4.1.9911.1.1.1.1.2	Unsigned32	not-accessible	An index value used to associate various root OIDs with the same GetSubtree operation. This value should be one for the first entry associated with a particular retrieval operation and should be sequentially incremented for each additional entry.
OID getSubtreeRootOID	1.3.6.1.4.1.9911.1.1.1.1.3	OBJECT IDENTIFIER	read-create	The root OID of the subtree to be retrieved.
ROW getSubtreeRootStatus	1.3.6.1.4.1.9911.1.1.1.1.4	RowStatus	read-create	The status of this row. The manager should create one row for each subtree to be retrieved. After the entire subtree retrieval operation is completed (or if the operation is aborted by the user) all rows in this table corresponding to that operation are automatically deleted by the agent. Objects in this table cannot be modified while a GetSubtree retrieval operation is in progress.
getSubtreeControlTable	1.3.6.1.4.1.9911.1.1.2		not-accessible	The (conceptual) table used to control GetSubtree operations in progress. This table is used in conjunction with getSubtreeRootTable. A manager interested in retrieving a subtree of MIB objects must first create an entry in the getSubtreeRootTable specifying the root OID (s) of the subtree(s) to be retrieved. It must then make a corresponding entry in this table using the same getSubtreeRootOperationID value and identifying itself (via getSubtreeControlTarget) as the recipient of the traps. When the agent completes retrieval of all MIB instances within the specified subtree(s) this conceptual row will be automatically deleted.
getSubtreeControlEntry	1.3.6.1.4.1.9911.1.1.2.1		not-accessible	An entry (conceptual row) containing the information on a particular GetSubtree operation in progress.
STR getSubtreeControlTarget	1.3.6.1.4.1.9911.1.1.2.1.2	SnmpAdminString	read-create	This object selects a management target defined in the snmpTargetAddrTable (in the SNMP-TARGET-MIB). The selected target is defined by an entry in the snmpTargetAddrTable whose index value (snmpTargetAddrName) is equal to this object.
C32 getSubtreeControlSeqNumber	1.3.6.1.4.1.9911.1.1.2.1.3	Counter32	read-only	The number of trap responses previously sent for this GetSubtree request.
C32 getSubtreeControlCount	1.3.6.1.4.1.9911.1.1.2.1.4	Counter32	read-only	The number of repetitions transmitted thus far (up to and including those sent in the current trap)
T/F getSubtreeControlDone	1.3.6.1.4.1.9911.1.1.2.1.5	TruthValue	read-only	This is set to true in the last trap sent, and is set to false otherwise.
ROW getSubtreeControlStatus	1.3.6.1.4.1.9911.1.1.2.1.6	RowStatus	read-create	The status of this row, by which new entries may be created, or old entries deleted from this table. Once created, the row may be deleted, but other objects in the row may not be modified. A row (and corresponding rows in the getSubtreeRootTable) will be deleted automatically by the agent once the operation has completed. A row may be created using an instance value for getSubtreeRootOperationID even if no entries exist in getSubtreeRootTable indexed by that value. Creating a row will cause the subtree retrieval operation to commence if there are entries in the getSubtreeRootTable indexed by the same value of getSubtreeRootOperationID as this row. If the agent allows aborting operations in progress, deleting a row will cause the operation to halt. If the operation is successfully aborted, the rows in the getSubtreeRootTable corresponding to this request will also be automatically deleted by the agent.
getSubtreeTraps	1.3.6.1.4.1.9911.1.2
getSubtreeTrapPrefix	1.3.6.1.4.1.9911.1.2.0
NTF getSubtreeResponse	1.3.6.1.4.1.9911.1.2.0.1			In addition to the three objects above, this trap also contains a series of varbinds containing the next chunk of the subtree. The generating entity will append, in order, as many variables to the variable- bindings field as it can without exceeding the maximum message size, and without going beyond the subtree of OIDs requested. A series of such traps will be generated until the end of the subtree is reached.
getSubtreeMIBConformance	1.3.6.1.4.1.9911.2
getSubtreeMIBCompliances	1.3.6.1.4.1.9911.2.1
getSubtreeMIBCompliance	1.3.6.1.4.1.9911.2.1.1			The compliance statement for the GetSubtree MIB.
getSubtreeMIBGroups	1.3.6.1.4.1.9911.2.2
getSubtreeObjectGroup	1.3.6.1.4.1.9911.2.2.1			A collection of objects to support requests for subtree retrieval operations.
getSubtreeNotificationGroup	1.3.6.1.4.1.9911.2.2.2			The notification which an entity is required to implement.

RFC description

IRTF MIB providing ability to retrieve arbitrary subtrees of OIDs in parallel via trap-based mechanism.

Start monitoring Vendor-neutral SNMP agent, any manufacturer (experimental trap-based subtree retrieval) 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 GET-SUBTREE-MIB

What Is GET-SUBTREE-MIB?

Supported Devices

Monitoring Examples

What Can Be Monitored

This MIB depends on

Related MIBs

RFC description