Documente Academic
Documente Profesional
Documente Cultură
T/Mon NOC
root
ccitt (0)
joint-iso-ccitt (3)
iso (1)
org (3)
dod (6)
private (4)
mgmt (2)
experimental (3) enterprises (1)
TMonXM (1)
dpsRTU (2)
dpsRTUsumPClr (102)
Version 1.0
Released September 27, 2004
NetGuardian 832A
2
Demystifying the MIB • DPS Telecom • (800) 622-3314 • Fax (559) 454-1688 • www.dpstelecom.com
3
Demystifying the MIB • DPS Telecom • (800) 622-3314 • Fax (559) 454-1688 • www.dpstelecom.com
IP datagram
UDP datagram
SNMP message
common SNMP header get / set header variables to get / set
PDU
IP UDP version request error status error
community type OID value OID value ...
header header (0) ID (0-5) index
(0-3)
Figure 1. The OID identifies managed objects that can have assigned values
string,” which is the equivalent of a byte), the address OK ... but what does it mean?
is simply defined as a text string, “AddressType.” You The OID is a kind of address. It locates this particular
can do this because AddressType is defined in another element within the entire SNMP universe. The OID
sequence, like so: describes a tree structure, as shown in Figure 2, and
AddressType ::= SEQUENCE { each number separated by a decimal point represents a
name OCTET STRING, branch on that tree.
number INTEGER,
street OCTET STRING, root
city OCTET STRING,
state OCTET STRING,
ccitt (0) iso (1) joint-iso-ccitt (3)
zipCode INTEGER
}
org (3)
For a computer parsing the sequence “Letter,”
AddressType will be read as an instruction to insert the
dod (6)
octet string and integer structures listed in the sequence
that defines AddressType
internet (1) 1.3.6.1
What terms are defined in the MIB? directory (1) mgmt (2) experimental (3) private (4)
The elements defined in the MIB can be extremely
broad (for example, all objects created by private busi- enterprises (1)
nesses) or they can be extremely specific (like a partic-
ular Trap message generated by a specific alarm point dpsInc (2682)
on an RTU.)
1.3.6.1.4.1.2682.1 dpsAlarmControl (1)
Each element in the MIB is given an object identifier,
or OID. An OID is a number that uniquely identifies an
TMonXM (1) dpsRTU (2)
element in the SNMP universe. Each OID is associated
with a human-readable text label. dpsRTUsumPClr (102)
What is the function of an OID? Figure 2. The branch of the MIB object identifier tree that represents
The OIDs identify the data objects that are the subjects managed elements used by DPS Telecom equipment.
4
Demystifying the MIB • DPS Telecom • (800) 622-3314 • Fax (559) 454-1688 • www.dpstelecom.com
Each element of the OID also has a human-readable Here’s how the last four elements in our sample OID
text designation. From left to right, our sample OID are defined in the DPS Telecom MIB:
reads: dpsInc OBJECT IDENTIFIER ::= {enterprises
1 (iso): The International Organization for 2682}
dpsAlarmControl OBJECT IDENTIFIER ::= {dpsInc
Standardization, one of the two organizations that 1}
assign OID domains. dpsRTU OBJECT IDENTIFIER ::= {dpsAlarmControl
3 (org): An ISO-recognized organization. 2}
dpsRTUsumPClr TRAP-TYPE
6 (dod): U.S. Department of Defense, the agency ENTERPRISE dpsRTU
originally responsible for the Internet. VARIABLES { sysDescr, sysLocation,
dpsRTUDateTime }
1 (internet): Internet OID. DESCRIPTION “Generated when all points
4 (private): Private organizations. clear.”
::= 102
1 (enterprises): Business enterprises.
Look at how each term is defined as the term that came
2682 (dpsInc): DPS Telecom.
immediately before it in the OID, plus one more ele-
1 (dpsAlarmControl): DPS alarm and control ment. For example, dpsInc is enterprises (1.3.6.1.4)
devices. plus one more element, called 2682. The next term,
2 (dpsRTU): DPS remote telemetry unit. dpsAlarmControl, is dpsInc (1.3.6.1.4.2682), plus one
102 (dpsRTUsumPClr): A Trap generated when all more element, called 1. And so on. Each term in the
the alarm points on an RTU are clear. OID is defined as an extension of earlier terms, going
all the way back to the root term, iso.
When I look at my MIB files, I don’t An OID is meaningless unless every element it refers to
see long strings of numbers like that is specifically called out and identified in the MIB. So
That’s because each element of an OID only needs to be when you’re compiling your MIB files on your SNMP
defined once. Remember, in ASN.1 notation, once a manager, you need to supply not only the OIDs defined
term is defined, it can be used as a building block to by your equipment vendor, but also OIDs for public
define other terms. The last number of an OID — its entities: iso, org, dod, internet, and so on.
most specific element — refers back to the more gener-
al elements defined earlier in the MIB. So every MIB file needs to describe
the entire OID tree?
Fortunately, no. The upper levels of the OID tree — the
parts that define the general OID structure — are
defined in a series of standard reference MIB files
called RFCs.
Learn SNMP the Easy Way: Attend DPS Telecom Factory Training
“I had heard of SNMP, but I never knew what SNMP was until I learned it at DPS Factory
Training. I’m not at all scared about SNMP now.” —Derek Willis, Paul Bunyan Telephone
Learn SNMP in-depth and hands-on, in a totally practical class that will teach you how to get the most
from your network monitoring. At a DPS Factory Training Event, you’ll learn how to turn SNMP theory
into a practical plan for improving your network visibility.
Each 4-day training course covers SNMP alarm monitoring ASCII alarm parsing and processing, con-
figuring and using derived alarms and controls, and automatic e-mail and pager notifications It’s the
easiest and most complete way to learn SNMP alarm monitoring from the technicians who have
designed hundreds of successful SNMP monitoring implementations
For Factory Training Events dates and registration information, call 1-800-693-3314 today or visit us
on the Web at http://www.dpstelecom.com/training.
5
Demystifying the MIB • DPS Telecom • (800) 622-3314 • Fax (559) 454-1688 • www.dpstelecom.com
(The initials stand for Request for Comment. The RFCs So I’m reading the MIB. What infor-
that define SNMP OIDs are part of a larger group of
mation am I looking for?
RFC documents that define the Internet as a whole.)
You don’t need to carefully read over every last line of
The RFC MIB defines a basic dictionary of terms that the MIB file. For your purposes, you’re only looking
vendors use to write their own equipment-specific for particular items that will tell you what elements of
MIBs. So a vendor-created MIB doesn’t have to define the device you can monitor and control.
the entire OID tree. The vendor’s MIB file only has to
A well-written MIB will be divided into sections.
define the unique OIDs that describe the vendor’s
Sections will be identified by comment lines. (In MIB
equipment.
notation, comments lines are identified by two
At the beginning of every MIB file is an IMPORTS line hyphens.) So if you find a line that reads something
that calls out the terms used in the MIB and the RFC like:
MIB that defines those terms.
—- TRAP definitions
Let’s take another look at the very beginning of the DPS
Telecom MIB: You know you’ve found what you’re looking for.
DPS-MIB-V38 DEFINITIONS ::= BEGIN There are also text labels that identify the MIB objects
IMPORTS you’re interested in. For example, in SNMP v1 MIBs,
DisplayString Traps are identified by the text label “TRAP-TYPE.” If
FROM RFC1213-MIB you know the text labels for the kinds of objects you’re
OBJECT-TYPE
FROM RFC-1212
looking for, you can scan the MIB in a series of Ctrl-F
enterprises searches.
FROM RFC1155-SMI;
6
Demystifying the MIB • DPS Telecom • (800) 622-3314 • Fax (559) 454-1688 • www.dpstelecom.com
Trap variables are your best guide to what alarms you’ll mand.
get from an SNMP device. Depending on the device, GetRequests and SetRequests operate on a type of ele-
the variables can be highly detailed or they can be ment called an object-type. Object-types are called out
vague summary alarms. in the MIB like this:
tmonAState OBJECT-TYPE
Object-Types: Data you can read and SYNTAX DisplayString (SIZE (8))
sometimes write ACCESS read-only
When reading the MIB, you’ll also want to know what STATUS mandatory
information you can directly request from the device, DESCRIPTION “The current alarm state.”
::= {tmonAlarmEntry 4}
and what information you can send to the device. These
functions are controlled by the SNMP commands There are many different kinds of object-types. The
GetRequest and SetRequest. specific object-types you might find in a MIB depend
If you want to translate these commands into classic on the type of device, what kind of components it has,
telemetry terms, you can roughly think of a GetRequest what the functions of those components, are, etc.
as an alarm poll and a SetRequest as a control com-
7
Demystifying the MIB • DPS Telecom • (800) 622-3314 • Fax (559) 454-1688 • www.dpstelecom.com
Quick Primer on SNMP Messages GetRequest and write new data for the object-type in a
SetRequest.
In SNMP v1, there are only 5 basic PDUs (pro-
gram datagram units): In the example of the alarm state object-type:
GetRequest: a manager-to-agent message tmonAState OBJECT-TYPE
SYNTAX DisplayString (SIZE (8))
requesting the current value of a managed ACCESS read-only
object. STATUS mandatory
GetNext:a manager-to-agent message request- DESCRIPTION “The current alarm state.”
::= {tmonAlarmEntry 4}
ing the current value of the managed object one
number after the one named in the request. (This The access here is read-only, because the alarm state is
is a way of walking down a table of values.) set by the alarm input on that alarm point.
SetRequest: a manager-to-agent message that Here’s an example of an object-type with read-write
writes a new value to a managed object access:
GetResponse: an agent-to-manager message dpsRTUDateTime OBJECT-TYPE
in response to a GetRequest or a SetRequest. In SYNTAX DisplayString (SIZE (23))
ACCESS read-write
either case, the message reports the current STATUS mandatory
value of the managed object named in the man- DESCRIPTION “The RTU system date and
ager’s request time.”
::= {dpsRTUIdent 4}
Trap: an agent-to-manager message reporting a
change in the value of a managed object Here the access is read-write, because this is a value
that you can set from your SNMP manager. You can
You’re probably not going to be interested in every retrieve the current settings from the RTU’s internal
object-type listed in the MIB, because you’re not going clock through a GetRequest. And if the clock needs to
to be interested in everything about the device’s func- be reset, you can write new data in a SetRequest.
tions.
When searching for object-types, it’s helpful to start I want to use a device feature that isn’t
with a plan of what functions of the device you want to described in the MIB. What can I do?
manage. What information do you want to retrieve? You can ask the vendor to extend the MIB to
What controls do you want to set? Knowing the include this feature. DPS Telecom has extended
device’s functions and how you want to use them will its MIB to support client needs and will continue
help you narrow down what object-types you should to do so if a client needs it.
look for in the MIB.
But you need to understand that extending a MIB
Access is actually a software development project. The
The most important entry in an object-type description MIB is not just a text file. It’s also a software
is the ACCESS line. This controls whether you can read interface document to the embedded firmware of
and write the data described in the object-type. your SNMP device. Making additions to the MIB
There are three access settings: not-accessible, read- requires rewriting the device firmware.
only and read-write. This is a serious project, involving writing code,
debugging it, and undergoing a thorough quality
Not-accessible means the object-type is there, but you assurance process. Extending a MIB is a large
can’t request the data in a GetRequest. commitment of time and resources.
Read-only means you can request the data in a
GetRequest, but you can’t write new data for the object-
type in a SetRequest.
Read-write means you’re free to retrieve the data in a
8
Demystifying the MIB • DPS Telecom • (800) 622-3314 • Fax (559) 454-1688 • www.dpstelecom.com
9
Demystifying the MIB • DPS Telecom • (800) 622-3314 • Fax (559) 454-1688 • www.dpstelecom.com
10
Demystifying the MIB • DPS Telecom • (800) 622-3314 • Fax (559) 454-1688 • www.dpstelecom.com
What to Do Next
Before you make a decision about your SNMP monitoring, there’s a lot more you need to know. There’s dangers
you want to avoid — and there’s also opportunities to improve your remote site maintenance that you don’t want
to miss.
Get the information you need — register now for a free, live Web demonstration of SNMP monitoring solutions
with the T/Mon Remote Alarm Monitoring System. There’s no obligation to buy — no high-pressure salesmen —
just straightforward information to help you make the best decision about your network monitoring. You’ll get
complete information on hardware, software, specific applications, specifications, features and benefits . . . plus
you'll be able to ask questions and get straight answers.
Call 1-800-622-3314 today to schedule your free Web demo of SNMP monitoring solutions — or
register on the Web at www.dpstelecom.com/tmon-webdemo.
11
Demystifying the MIB • DPS Telecom • (800) 622-3314 • Fax (559) 454-1688 • www.dpstelecom.com
“I would personally like to let you know how beneficial the installation of
the SNMP responder was to the mission of our department. We were look-
ing for a way to integrate our local ILEC region in HP OpenView without
a major network change. The SNMP responder was the answer. This
migration will allow us not only to monitor all alarms in one spot but also
build extensive collection reports of our whole network.”
—Todd Matherne, EATEL
“It is hard to find companies with the intelligence and aptitude to meet
the customer’s exact needs, and I believe that is what DPS is all about.”
—Lee Wells, Pathnet
www.dpstelecom.com
1-800-622-3314
DPS Telecom
“Your Partners in Network Alarm Monitoring”
US $36.95