rfc-1907

Management Information Base for Version 2 of the Simple Network Management Protocol (SNMPv2)

J. Case, K. McCloghrie, M. Rose, S. Waldbusser
date1996-01 streamIETF areamgt wgsnmpv2 statusDRAFT STANDARD pages20 canonicalhttps://www.rfc-editor.org/rfc/rfc1907 doi10.17487/RFC1907
It is the purpose of this document to define managed objects which describe the behavior of a SNMPv2 entity. [STANDARDS-TRACK]

obsoleted by

obsoletes

Extracted elements (28)

design-rationale §2.5

snmpSetSerialNo is described as coarse-grain coordination; for fine-grain coordination, the document notes that one or more similar TestAndIncr objects might be defined within each MIB group as appropriate, leaving per-group locking to individual MIB designers.

snmp

design-rationale §2.1

sysServices encodes supported protocol layers as a sum of powers of two (2^(L-1) per layer) rather than a list, allowing a single INTEGER to compactly represent any combination of the seven OSI layers a node participates in.

snmp

design-rationale §2.6.3

The per-PDU-type input/output counters from RFC 1213 (e.g., snmpInGetRequests, snmpOutGetResponses) were made obsolete because SNMPv2 provides richer error information and the counters proved of limited diagnostic value while adding implementation burden.

snmp

interoperability-note §2.6.3

A large set of SNMPv1 SNMP group objects defined in RFC 1213—including snmpOutPkts, snmpInTooBigs, snmpInNoSuchNames, snmpInBadValues, and many others—are declared STATUS obsolete in this MIB and collected in snmpObsoleteGroup (snmpMIBGroups 10). Implementations SHOULD NOT implement these objects.

snmp

normative-requirement §2.4.1 MUST

All implementations of SNMPv2 must be capable of generating the authenticationFailure trap, though actual generation is gated by the snmpEnableAuthenTraps object.

snmp, security

normative-requirement §2.2 RECOMMENDED

It is strongly recommended that snmpEnableAuthenTraps be stored in non-volatile memory so that it remains constant across re-initializations of the network management system.

snmp, security

normative-requirement §2.6.1 REQUIRED

The snmpBasicCompliance MODULE-COMPLIANCE requires that conforming SNMPv2 entities implement the mandatory groups snmpGroup, snmpSetGroup, systemGroup, and snmpBasicNotificationsGroup. The snmpCommunityGroup is additionally mandatory for entities supporting community-based authentication.

snmp

protocol-element §2.4.1

authenticationFailure (snmpTraps 5) is a NOTIFICATION-TYPE signifying that the agent received a protocol message that is not properly authenticated. All SNMPv2 implementations must be capable of generating this trap, subject to snmpEnableAuthenTraps.

snmp, security

protocol-element §2.4.1

coldStart (snmpTraps 1) is a NOTIFICATION-TYPE signifying that the SNMPv2 agent is reinitializing itself and that its configuration may have been altered.

snmp

protocol-element §2.6.2

snmpBasicNotificationsGroup (snmpMIBGroups 7) defines the two notifications every SNMPv2 entity is required to implement: coldStart and authenticationFailure.

snmp

protocol-element §2.2

snmpEnableAuthenTraps (snmp 30) is a read-write INTEGER {enabled(1), disabled(2)} that controls whether the SNMPv2 entity is permitted to generate authenticationFailure traps; its value overrides any other configuration.

snmp, security

protocol-element §2.6.2

snmpGroup (snmpMIBGroups 8) collects the core instrumentation objects: snmpInPkts, snmpInBadVersions, snmpInASNParseErrs, snmpSilentDrops, snmpProxyDrops, and snmpEnableAuthenTraps.

snmp

protocol-element §2.2

snmpInBadCommunityNames (snmp 4) counts messages received using a community name not known to the entity; snmpInBadCommunityUses (snmp 5) counts messages representing an operation not allowed for the named community. Both are read-only Counter32 objects in the snmpCommunityGroup.

snmp, security

protocol-element §2.2

snmpProxyDrops (snmp 32) counts PDUs silently dropped because transmission of the (possibly translated) message to a proxy target failed in a manner other than a time-out such that no Response-PDU could be returned.

snmp

protocol-element §2.5

snmpSetSerialNo (snmpSet 1) is a read-write TestAndIncr object providing an advisory lock to allow several cooperating SNMPv2 managers to coordinate their use of the SNMPv2 set operation, intended for coarse-grain coordination.

snmp

protocol-element §2.2

snmpSilentDrops (snmp 31) counts GetRequest-, GetNextRequest-, GetBulkRequest-, SetRequest-, and InformRequest-PDUs silently dropped because the size of an alternate empty-varbindings Response-PDU would exceed either a local constraint or the originator's maximum message size.

snmp

protocol-element §2.4

snmpTrapEnterprise (snmpTrap 3) is an accessible-for-notify OBJECT IDENTIFIER carrying the enterprise OID associated with the trap. When a SNMPv2 proxy agent maps an RFC 1157 Trap-PDU into a SNMPv2-Trap-PDU, this variable appears as the last varbind.

snmp, interoperability-note

protocol-element §2.4

snmpTrapOID (snmpTrap 1) is an accessible-for-notify OBJECT IDENTIFIER that carries the authoritative identification of the notification currently being sent; it occurs as the second varbind in every SNMPv2-Trap-PDU and InformRequest-PDU.

snmp

protocol-element §2.1

sysDescr (system 1) is a read-only DisplayString (0..255 octets) containing the full name and version identification of the system's hardware type, software operating-system, and networking software.

snmp

protocol-element §2.1

sysName (system 5) is a read-write DisplayString (0..255 octets) for an administratively-assigned name; by convention, this is the node's fully-qualified domain name. If unknown, the value is the zero-length string.

snmp, dns

protocol-element §2.1

sysORLastChange (system 8) is a TimeStamp recording the value of sysUpTime at the time of the most recent change in state or value of any instance of sysORID, allowing managers to detect capability changes efficiently.

snmp

protocol-element §2.1

sysORTable (system 9) is a conceptual table advertising the MIB module capabilities of the local SNMPv2 agent. Each row (SysOREntry) contains sysORIndex, sysORID (capability OID), sysORDescr (text), and sysORUpTime (TimeStamp of row instantiation). Entities with dynamically-configurable MIB support will have a dynamically-varying number of rows.

snmp

protocol-element §2.1

sysServices (system 7) is a read-only INTEGER (0..127) encoding a bitmask of OSI layers supported: for layer L, the value 2^(L-1) is added to the sum, covering layers 1 (physical) through 7 (application).

snmp

protocol-element §2.1

sysUpTime (system 3) is a read-only TimeTicks object reporting the time in hundredths of a second since the network management portion of the system was last re-initialized.

snmp

protocol-element §2.2

The SNMP Group (mib-2 11) provides basic instrumentation of an SNMPv2 entity, including counters for received packets, bad versions, ASN.1 parse errors, silent drops, and proxy drops, as well as the snmpEnableAuthenTraps control object.

snmp

protocol-element §2.1

The System Group (mib-2 1) defines objects common to all managed systems, including sysDescr, sysObjectID, sysUpTime, sysContact, sysName, sysLocation, sysServices, and the sysORTable for capability advertisement.

snmp, yang

protocol-element §2.4.1

warmStart (snmpTraps 2) is a NOTIFICATION-TYPE signifying that the SNMPv2 agent is reinitializing itself such that its configuration is unaltered.

snmp

security-consideration §3

The Security Considerations section of RFC 1907 explicitly states that security issues are not discussed in this memo, deferring security treatment entirely to other SNMPv2 framework documents.

snmp, security