528 lines
18 KiB
Plaintext
528 lines
18 KiB
Plaintext
AGENTX-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY, OBJECT-TYPE, Unsigned32, mib-2
|
|
FROM SNMPv2-SMI
|
|
SnmpAdminString
|
|
FROM SNMP-FRAMEWORK-MIB
|
|
MODULE-COMPLIANCE, OBJECT-GROUP
|
|
FROM SNMPv2-CONF
|
|
TEXTUAL-CONVENTION, TimeStamp, TruthValue, TDomain
|
|
FROM SNMPv2-TC;
|
|
agentxMIB MODULE-IDENTITY
|
|
LAST-UPDATED "200001100000Z" -- Midnight 10 January 2000
|
|
ORGANIZATION "AgentX Working Group"
|
|
CONTACT-INFO "WG-email: agentx@dorothy.bmc.com
|
|
Subscribe: agentx-request@dorothy.bmc.com
|
|
WG-email Archive: ftp://ftp.peer.com/pub/agentx/archives
|
|
FTP repository: ftp://ftp.peer.com/pub/agentx
|
|
http://www.ietf.org/html.charters/agentx-charter.html
|
|
|
|
Chair: Bob Natale
|
|
ACE*COMM Corporation
|
|
Email: bnatale@acecomm.com
|
|
|
|
WG editor: Mark Ellison
|
|
Ellison Software Consulting, Inc.
|
|
Email: ellison@world.std.com
|
|
|
|
Co-author: Lauren Heintz
|
|
Cisco Systems,
|
|
EMail: lheintz@cisco.com
|
|
|
|
Co-author: Smitha Gudur
|
|
Independent Consultant
|
|
Email: sgudur@hotmail.com
|
|
"
|
|
DESCRIPTION "This is the MIB module for the SNMP Agent Extensibility
|
|
Protocol (AgentX). This MIB module will be implemented by
|
|
the master agent.
|
|
"
|
|
|
|
REVISION "200001100000Z" -- Midnight 10 January 2000
|
|
DESCRIPTION
|
|
"Initial version published as RFC 2742."
|
|
::= { mib-2 74 }
|
|
|
|
-- Textual Conventions
|
|
|
|
AgentxTAddress ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Denotes a transport service address. This is identical to
|
|
the TAddress textual convention (SNMPv2-SMI) except that
|
|
zero-length values are permitted.
|
|
"
|
|
SYNTAX OCTET STRING (SIZE (0..255))
|
|
|
|
-- Administrative assignments
|
|
|
|
agentxObjects OBJECT IDENTIFIER ::= { agentxMIB 1 }
|
|
agentxGeneral OBJECT IDENTIFIER ::= { agentxObjects 1 }
|
|
agentxConnection OBJECT IDENTIFIER ::= { agentxObjects 2 }
|
|
agentxSession OBJECT IDENTIFIER ::= { agentxObjects 3 }
|
|
agentxRegistration OBJECT IDENTIFIER ::= { agentxObjects 4 }
|
|
|
|
agentxDefaultTimeout OBJECT-TYPE
|
|
SYNTAX INTEGER (0..255)
|
|
UNITS "seconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The default length of time, in seconds, that the master
|
|
agent should allow to elapse after dispatching a message
|
|
to a session before it regards the subagent as not
|
|
responding. This is a system-wide value that may
|
|
override the timeout value associated with a particular
|
|
session (agentxSessionTimeout) or a particular registered
|
|
MIB region (agentxRegTimeout). If the associated value of
|
|
agentxSessionTimeout and agentxRegTimeout are zero, or
|
|
impractical in accordance with implementation-specific
|
|
procedure of the master agent, the value represented by
|
|
this object will be the effective timeout value for the
|
|
|
|
master agent to await a response to a dispatch from a
|
|
given subagent.
|
|
"
|
|
DEFVAL { 5 }
|
|
::= { agentxGeneral 1 }
|
|
|
|
agentxMasterAgentXVer OBJECT-TYPE
|
|
SYNTAX INTEGER (1..255)
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The AgentX protocol version supported by this master agent.
|
|
The current protocol version is 1. Note that the master agent
|
|
must also allow interaction with earlier version subagents.
|
|
"
|
|
::= { agentxGeneral 2 }
|
|
|
|
-- The AgentX Subagent Connection Group
|
|
|
|
agentxConnTableLastChange OBJECT-TYPE
|
|
SYNTAX TimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of sysUpTime when the last row creation or deletion
|
|
occurred in the agentxConnectionTable.
|
|
"
|
|
::= { agentxConnection 1 }
|
|
|
|
agentxConnectionTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF AgentxConnectionEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The agentxConnectionTable tracks all current AgentX transport
|
|
connections. There may be zero, one, or more AgentX sessions
|
|
carried on a given AgentX connection.
|
|
"
|
|
::= { agentxConnection 2 }
|
|
|
|
agentxConnectionEntry OBJECT-TYPE
|
|
SYNTAX AgentxConnectionEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An agentxConnectionEntry contains information describing a
|
|
single AgentX transport connection. A connection may be
|
|
|
|
used to support zero or more AgentX sessions. An entry is
|
|
created when a new transport connection is established,
|
|
and is destroyed when the transport connection is terminated.
|
|
"
|
|
INDEX { agentxConnIndex }
|
|
::= { agentxConnectionTable 1 }
|
|
|
|
AgentxConnectionEntry ::= SEQUENCE {
|
|
agentxConnIndex Unsigned32,
|
|
agentxConnOpenTime TimeStamp,
|
|
agentxConnTransportDomain TDomain,
|
|
agentxConnTransportAddress AgentxTAddress }
|
|
|
|
agentxConnIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..4294967295)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"agentxConnIndex contains the value that uniquely identifies
|
|
an open transport connection used by this master agent
|
|
to provide AgentX service. Values of this index should
|
|
not be re-used. The value assigned to a given transport
|
|
connection is constant for the lifetime of that connection.
|
|
"
|
|
::= { agentxConnectionEntry 1 }
|
|
|
|
agentxConnOpenTime OBJECT-TYPE
|
|
SYNTAX TimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of sysUpTime when this connection was established
|
|
and, therefore, its value when this entry was added to the table.
|
|
"
|
|
::= { agentxConnectionEntry 2 }
|
|
|
|
agentxConnTransportDomain OBJECT-TYPE
|
|
SYNTAX TDomain
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The transport protocol in use for this connection to the
|
|
subagent.
|
|
"
|
|
::= { agentxConnectionEntry 3 }
|
|
|
|
agentxConnTransportAddress OBJECT-TYPE
|
|
SYNTAX AgentxTAddress
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The transport address of the remote (subagent) end of this
|
|
connection to the master agent. This object may be zero-length
|
|
for unix-domain sockets (and possibly other types of transport
|
|
addresses) since the subagent need not bind a filename to its
|
|
local socket.
|
|
"
|
|
::= { agentxConnectionEntry 4 }
|
|
|
|
-- The AgentX Subagent Session Group
|
|
|
|
agentxSessionTableLastChange OBJECT-TYPE
|
|
SYNTAX TimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of sysUpTime when the last row creation or deletion
|
|
occurred in the agentxSessionTable.
|
|
"
|
|
::= { agentxSession 1 }
|
|
|
|
agentxSessionTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF AgentxSessionEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A table of AgentX subagent sessions currently in effect.
|
|
"
|
|
::= { agentxSession 2 }
|
|
|
|
agentxSessionEntry OBJECT-TYPE
|
|
SYNTAX AgentxSessionEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Information about a single open session between the AgentX
|
|
master agent and a subagent is contained in this entry. An
|
|
entry is created when a new session is successfully established
|
|
and is destroyed either when the subagent transport connection
|
|
has terminated or when the subagent session is closed.
|
|
"
|
|
INDEX { agentxConnIndex, agentxSessionIndex }
|
|
::= { agentxSessionTable 1 }
|
|
|
|
AgentxSessionEntry ::= SEQUENCE {
|
|
agentxSessionIndex Unsigned32,
|
|
agentxSessionObjectID OBJECT IDENTIFIER,
|
|
agentxSessionDescr SnmpAdminString,
|
|
agentxSessionAdminStatus INTEGER,
|
|
agentxSessionOpenTime TimeStamp,
|
|
agentxSessionAgentXVer INTEGER,
|
|
agentxSessionTimeout INTEGER
|
|
}
|
|
|
|
agentxSessionIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (0..4294967295)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A unique index for the subagent session. It is the same as
|
|
h.sessionID defined in the agentx header. Note that if
|
|
a subagent's session with the master agent is closed for
|
|
any reason its index should not be re-used.
|
|
A value of zero(0) is specifically allowed in order
|
|
to be compatible with the definition of h.sessionId.
|
|
"
|
|
::= { agentxSessionEntry 1 }
|
|
|
|
agentxSessionObjectID OBJECT-TYPE
|
|
SYNTAX OBJECT IDENTIFIER
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This is taken from the o.id field of the agentx-Open-PDU.
|
|
This attribute will report a value of '0.0' for subagents
|
|
not supporting the notion of an AgentX session object
|
|
identifier.
|
|
"
|
|
::= { agentxSessionEntry 2 }
|
|
|
|
agentxSessionDescr OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A textual description of the session. This is analogous to
|
|
sysDescr defined in the SNMPv2-MIB in RFC 1907 [19] and is
|
|
taken from the o.descr field of the agentx-Open-PDU.
|
|
This attribute will report a zero-length string value for
|
|
subagents not supporting the notion of a session description.
|
|
"
|
|
::= { agentxSessionEntry 3 }
|
|
|
|
agentxSessionAdminStatus OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
up(1),
|
|
down(2)
|
|
}
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The administrative (desired) status of the session. Setting
|
|
the value to 'down(2)' closes the subagent session (with c.reason
|
|
set to 'reasonByManager').
|
|
"
|
|
::= { agentxSessionEntry 4 }
|
|
|
|
agentxSessionOpenTime OBJECT-TYPE
|
|
SYNTAX TimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of sysUpTime when this session was opened and,
|
|
therefore, its value when this entry was added to the table.
|
|
"
|
|
::= { agentxSessionEntry 5 }
|
|
|
|
agentxSessionAgentXVer OBJECT-TYPE
|
|
SYNTAX INTEGER (1..255)
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The version of the AgentX protocol supported by the
|
|
session. This must be less than or equal to the value of
|
|
agentxMasterAgentXVer.
|
|
"
|
|
::= { agentxSessionEntry 6 }
|
|
|
|
agentxSessionTimeout OBJECT-TYPE
|
|
SYNTAX INTEGER (0..255)
|
|
UNITS "seconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The length of time, in seconds, that a master agent should
|
|
allow to elapse after dispatching a message to this session
|
|
before it regards the subagent as not responding. This value
|
|
is taken from the o.timeout field of the agentx-Open-PDU.
|
|
This is a session-specific value that may be overridden by
|
|
values associated with the specific registered MIB regions
|
|
(see agentxRegTimeout). A value of zero(0) indicates that
|
|
the master agent's default timeout value should be used
|
|
|
|
(see agentxDefaultTimeout).
|
|
"
|
|
::= { agentxSessionEntry 7 }
|
|
|
|
-- The AgentX Registration Group
|
|
|
|
agentxRegistrationTableLastChange OBJECT-TYPE
|
|
SYNTAX TimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of sysUpTime when the last row creation or deletion
|
|
occurred in the agentxRegistrationTable.
|
|
"
|
|
::= { agentxRegistration 1 }
|
|
|
|
agentxRegistrationTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF AgentxRegistrationEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A table of registered regions.
|
|
"
|
|
::= { agentxRegistration 2 }
|
|
|
|
agentxRegistrationEntry OBJECT-TYPE
|
|
SYNTAX AgentxRegistrationEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Contains information for a single registered region. An
|
|
entry is created when a session successfully registers a
|
|
region and is destroyed for any of three reasons: this region
|
|
is unregistered by the session, the session is closed,
|
|
or the subagent connection is closed.
|
|
"
|
|
INDEX { agentxConnIndex, agentxSessionIndex, agentxRegIndex }
|
|
::= { agentxRegistrationTable 1 }
|
|
|
|
AgentxRegistrationEntry ::= SEQUENCE {
|
|
agentxRegIndex Unsigned32,
|
|
agentxRegContext OCTET STRING,
|
|
agentxRegStart OBJECT IDENTIFIER,
|
|
agentxRegRangeSubId Unsigned32,
|
|
agentxRegUpperBound Unsigned32,
|
|
agentxRegPriority Unsigned32,
|
|
agentxRegTimeout INTEGER,
|
|
agentxRegInstance TruthValue }
|
|
|
|
agentxRegIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..4294967295)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"agentxRegIndex uniquely identifies a registration entry.
|
|
This value is constant for the lifetime of an entry.
|
|
"
|
|
::= { agentxRegistrationEntry 1 }
|
|
|
|
agentxRegContext OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The context in which the session supports the objects in this
|
|
region. A zero-length context indicates the default context.
|
|
"
|
|
::= { agentxRegistrationEntry 2 }
|
|
|
|
agentxRegStart OBJECT-TYPE
|
|
SYNTAX OBJECT IDENTIFIER
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The starting OBJECT IDENTIFIER of this registration entry. The
|
|
session identified by agentxSessionIndex implements objects
|
|
starting at this value (inclusive). Note that this value could
|
|
identify an object type, an object instance, or a partial object
|
|
instance.
|
|
"
|
|
::= { agentxRegistrationEntry 3 }
|
|
|
|
agentxRegRangeSubId OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"agentxRegRangeSubId is used to specify the range. This is
|
|
taken from r.region_subid in the registration PDU. If the value
|
|
of this object is zero, no range is specified. If it is non-zero,
|
|
it identifies the `nth' sub-identifier in r.region for which
|
|
this entry's agentxRegUpperBound value is substituted in the
|
|
OID for purposes of defining the region's upper bound.
|
|
"
|
|
::= { agentxRegistrationEntry 4 }
|
|
|
|
agentxRegUpperBound OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"agentxRegUpperBound represents the upper-bound sub-identifier in
|
|
a registration. This is taken from the r.upper_bound in the
|
|
registration PDU. If agentxRegRangeSubid (r.region_subid) is
|
|
zero, this value is also zero and is not used to define an upper
|
|
bound for this registration.
|
|
"
|
|
::= { agentxRegistrationEntry 5 }
|
|
|
|
agentxRegPriority OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The registration priority. Lower values have higher priority.
|
|
This value is taken from r.priority in the register PDU.
|
|
Sessions should use the value of 127 for r.priority if a
|
|
default value is desired.
|
|
"
|
|
::= { agentxRegistrationEntry 6 }
|
|
|
|
agentxRegTimeout OBJECT-TYPE
|
|
SYNTAX INTEGER (0..255)
|
|
UNITS "seconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The timeout value, in seconds, for responses to
|
|
requests associated with this registered MIB region.
|
|
A value of zero(0) indicates the default value (indicated
|
|
by by agentxSessionTimeout or agentxDefaultTimeout) is to
|
|
be used. This value is taken from the r.timeout field of
|
|
the agentx-Register-PDU.
|
|
"
|
|
::= { agentxRegistrationEntry 7 }
|
|
|
|
agentxRegInstance OBJECT-TYPE
|
|
SYNTAX TruthValue
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of agentxRegInstance is `true' for
|
|
registrations for which the INSTANCE_REGISTRATION
|
|
was set, and is `false' for all other registrations.
|
|
"
|
|
::= { agentxRegistrationEntry 8 }
|
|
|
|
-- Conformance Statements for AgentX
|
|
|
|
agentxConformance OBJECT IDENTIFIER ::= { agentxMIB 2 }
|
|
agentxMIBGroups OBJECT IDENTIFIER ::= { agentxConformance 1 }
|
|
agentxMIBCompliances OBJECT IDENTIFIER ::= { agentxConformance 2 }
|
|
|
|
-- Compliance Statements for AgentX
|
|
|
|
agentxMIBCompliance MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The compliance statement for SNMP entities that implement the
|
|
AgentX protocol. Note that a compliant agent can implement all
|
|
objects in this MIB module as read-only.
|
|
"
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS { agentxMIBGroup }
|
|
|
|
OBJECT agentxSessionAdminStatus
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Write access is not required.
|
|
"
|
|
::= { agentxMIBCompliances 1 }
|
|
|
|
agentxMIBGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
agentxDefaultTimeout,
|
|
agentxMasterAgentXVer,
|
|
agentxConnTableLastChange,
|
|
agentxConnOpenTime,
|
|
agentxConnTransportDomain,
|
|
agentxConnTransportAddress,
|
|
agentxSessionTableLastChange,
|
|
agentxSessionTimeout,
|
|
agentxSessionObjectID,
|
|
agentxSessionDescr,
|
|
agentxSessionAdminStatus,
|
|
agentxSessionOpenTime,
|
|
agentxSessionAgentXVer,
|
|
agentxRegistrationTableLastChange,
|
|
agentxRegContext,
|
|
agentxRegStart,
|
|
agentxRegRangeSubId,
|
|
agentxRegUpperBound,
|
|
agentxRegPriority,
|
|
agentxRegTimeout,
|
|
agentxRegInstance
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"All accessible objects in the AgentX MIB.
|
|
"
|
|
::= { agentxMIBGroups 1 }
|
|
|
|
END
|