Network Working Group G. Zorn
Internet-Draft Cisco Systems
Expires: December 18, 2006 June 16, 2006
Diameter Base Protocol MIB
draft-zorn-dime-diameter-base-protocol-mib-00.txt
Status of this Memo
By submitting this Internet-Draft, each author represents that any
applicable patent or other IPR claims of which he or she is aware
have been or will be disclosed, and any of which he or she becomes
aware will be disclosed, in accordance with Section 6 of BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as Internet-
Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt.
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.
This Internet-Draft will expire on December 18, 2006.
Copyright Notice
Copyright (C) The Internet Society (2006).
Abstract
Along with providing support for certain basic authentication,
authorization and accounting functions, the Diameter protocol is
designed to provide a framework for AAA applications.
This document defines the Management Information Base (MIB) module
which describes the minimum set of objects needed to manage an
implementation of the Diameter protocol.
Zorn Expires December 18, 2006 [Page 1]
Internet-Draft Diameter Base Protocol MIB June 2006
Table of Contents
1. The Internet-Standard Management Framework . . . . . . . . . . 3
2. Requirements Language . . . . . . . . . . . . . . . . . . . . 3
3. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
4. Diameter Base Protocol MIB Definitions . . . . . . . . . . . . 3
5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 39
6. Security Considerations . . . . . . . . . . . . . . . . . . . 39
7. Contributors . . . . . . . . . . . . . . . . . . . . . . . . . 40
8. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 40
9. References . . . . . . . . . . . . . . . . . . . . . . . . . . 40
9.1 Normative References . . . . . . . . . . . . . . . . . . . 40
9.2 Informative References . . . . . . . . . . . . . . . . . . 40
Author's Address . . . . . . . . . . . . . . . . . . . . . . . 41
Intellectual Property and Copyright Statements . . . . . . . . 42
Zorn Expires December 18, 2006 [Page 2]
Internet-Draft Diameter Base Protocol MIB June 2006
1. The Internet-Standard Management Framework
For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of
RFC 3410 [RFC3410].
Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. MIB objects are generally
accessed through the Simple Network Management Protocol (SNMP).
Objects in the MIB are defined using the mechanisms defined in the
Structure of Management Information (SMI). This memo specifies a MIB
module that is compliant to the SMIv2, which is described in STD 58,
RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580
[RFC2580]. In particular, it describes managed objects used for
managing the base Diameter protocol.
Discussion of this draft may be directed to the author.
2. Requirements Language
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in [RFC1215].
3. Overview
The base Diameter protocol [RFC3588] is never used alone; it is
always extended for a particular application. Four Diameter
applications have been defined to date: NASREQ [RFC4005], Mobile IP
[RFC4004] [RFC3141], Credit Control [RFC4006] and EAP [RFC4072];
others may be defined in the future.
This MIB defines objects supporting the management of the Diameter
base protocol as described in [RFC3588]. Objects related to the
applications mentioned above (and any additional applications created
in the future) will be defined in separate documents.
4. Diameter Base Protocol MIB Definitions
DIAMETER-BASE-PROTOCOL-MIB DEFINITIONS ::= BEGIN
IMPORTS
InetAddressType, InetAddress
FROM INET-ADDRESS-MIB -- [RFC4001]
MODULE-IDENTITY, OBJECT-TYPE,
NOTIFICATION-TYPE, Counter32,
Unsigned32, Gauge32,
TimeTicks, mib-2
Zorn Expires December 18, 2006 [Page 3]
Internet-Draft Diameter Base Protocol MIB June 2006
FROM SNMPv2-SMI -- [RFC2578]
SnmpAdminString
FROM SNMP-FRAMEWORK-MIB -- [RFC3411]
MODULE-COMPLIANCE, OBJECT-GROUP
FROM SNMPv2-CONF -- [RFC2580]
RowStatus, TruthValue
FROM SNMPv2-TC; -- [RFC2579]
MODULE-IDENTITY
LAST-UPDATED "200606130000Z" -- 13 June 2006
ORGANIZATION "IETF dime Working Group."
CONTACT-INFO
"Glen Zorn
Cisco Systems, Inc.
2901 Third Avenue, Suite 600
SEA1/5/
Seattle, WA 98121
USA
Phone: +1 (425) 344 8113
Email: gwz@cisco.com"
DESCRIPTION
"The MIB module for entities implementing the
Diameter Base Protocol.
Copyright (C) The Internet Society (2006). This initial
version of this MIB module was published in RFC yyyy;
for full legal notices see the RFC itself. Supplementary
information may be available on
http://www.ietf.org/copyrights/ianamib.html."
-- RFC Ed.: replace yyyy with actual RFC number and remove this note
REVISION "200606130000Z" -- 13 June 2006
DESCRIPTION "Initial version as published in RFC yyyy"
-- RFC Ed.: replace yyyy with actual RFC number and remove this note
::= { mib-2 119 } -- Experimental value assigned by IANA.
-- Top-Level Components of this MIB.
diameterBaseProtocolMIB OBJECT::= { diameterMIB 1 }
diameterBaseTraps OBJECT IDENTIFIER ::=
{ diameterBaseProtocolMIB 0 }
diameterBaseObjects OBJECT IDENTIFIER ::=
{ diameterBaseProtocolMIB 1 }
diameterBaseConform OBJECT IDENTIFIER ::=
{ diameterBaseProtocolMIB 2 }
dbpLocalCfgs OBJECT IDENTIFIER ::= { diameterBaseObjects 1 }
Zorn Expires December 18, 2006 [Page 4]
Internet-Draft Diameter Base Protocol MIB June 2006
dbpLocalStats OBJECT IDENTIFIER ::= { diameterBaseObjects 2 }
dbpPeerCfgs OBJECT IDENTIFIER ::= { diameterBaseObjects 3 }
dbpPeerStats OBJECT IDENTIFIER ::= { diameterBaseObjects 4 }
dbpRealmCfgs OBJECT IDENTIFIER ::= { diameterBaseObjects 5 }
dbpRealmStats OBJECT IDENTIFIER ::= { diameterBaseObjects 6 }
dbpTrapCfgs OBJECT IDENTIFIER ::= { diameterBaseObjects 7 }
-- trap type definitions
diameterBaseTrapPrefix OBJECT IDENTIFIER ::=
{ diameterBaseTraps 0 }
-- Protocol Error Traps
dbpProtocolErrorTrapEnabled OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Setting the value of this object to True(1)
enables the dbpProtocolError trap."
::= { dbpTrapCfgs 1 }
dbpProtocolError NOTIFICATION-TYPE
OBJECTS
dbpPeerId
STATUS current
DESCRIPTION
"An dbpProtocolError trap is sent when both the
following conditions are true: 1) the value of
dbpProtocolErrorTrapEnabled is True(1) and
2) the value of dbpPerPeerStatsProtocolErrors
changes. It can be utilized by an NMS to trigger
logical/physical entity table maintenance polls.
An agent must not generate more than one
dbpProtocolError 'trap-event' in a five second
period, where a 'trap-event' is the transmission
of a single trap PDU to a list of trap destinations.
If additional premanent failures occur within the
five second 'throttling' period, then these
trap-events should be suppressed by the agent. An
NMS should periodically check the value of
dbpPerPeerStatsProtocolErrors to detect any missed
dbpProtocolError trap-events, e.g. due to throttling
or transmission loss."
::= { diameterBaseTrapPrefix 1 }
Zorn Expires December 18, 2006 [Page 5]
Internet-Draft Diameter Base Protocol MIB June 2006
-- Transient Error Traps
dbpTransientFailureTrapEnabled OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Setting the value of this object to True(1)
enables the dbpTransientFailure trap."
::= { dbpTrapCfgs 2 }
dbpTransientFailure NOTIFICATION-TYPE
OBJECTS
dbpPeerId
STATUS current
DESCRIPTION
"An dbpTransientFailure trap is sent when both the
following conditions are true: 1) the value of
dbpTransientFailureTrapEnabled is True(1) and
2) the value of dbpPerPeerStatsTransientFailures
changes. It can be utilized by an NMS to trigger
logical/physical entity table maintenance polls.
An agent must not generate more than one
dbpTransientFailure 'trap-event' in a five second
period, where a 'trap-event' is the transmission
of a single trap PDU to a list of trap destinations.
If additional transient failures occur within the
five second 'throttling' period, then these
trap-events should be suppressed by the agent. An
NMS should periodically check the value of
dbpPerPeerStatsTransientFailures to detect any missed
dbpTransientFailure trap-events, e.g. due to throttling
or transmission loss."
::= { diameterBaseTrapPrefix 2 }
-- Permanent Failure Traps
dbpPermanentFailureTrapEnabled OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Setting the value of this object to True(1)
enables the dbpPermanentFailure trap."
::= { dbpTrapCfgs 3 }
dbpPermanentFailure NOTIFICATION-TYPE
Zorn Expires December 18, 2006 [Page 6]
Internet-Draft Diameter Base Protocol MIB June 2006
OBJECTS
dbpPeerId
STATUS current
DESCRIPTION
"An dbpPermanentFailure trap is sent when both the
following conditions are true: 1) the value of
dbpPermanentFailureTrapEnabled is True(1) and
2) the value of dbpPerPeerStatsPermanentFailures
changes. It can be utilized by an NMS to trigger
logical/physical entity table maintenance polls.
An agent must not generate more than one
dbpPermanentFailure 'trap-event' in a five second
period, where a 'trap-event' is the transmission
of a single trap PDU to a list of trap destinations.
If additional premanent failures occur within the
five second 'throttling' period, then these
trap-events should be suppressed by the agent. An
NMS should periodically check the value of
dbpPerPeerStatsPermanentFailures to detect any missed
dbpPermanentFailure trap-events, e.g. due to throttling
or transmission loss."
::= { diameterBaseTrapPrefix 3 }
-- Connection Down Traps
dbpPeerConnectionDownTrapEnabled OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Setting the value of this object to True(1)
enables the dbpPeerConnectionDown trap."
::= { dbpTrapCfgs 4 }
dbpPeerConnectionDown NOTIFICATION-TYPE
OBJECTS
dbpLocalId,
dbpPeerId
STATUS current
DESCRIPTION
"An dbpPeerConnectionDown trap is sent when both the
following conditions are true: 1) the value of
dbpPeerConnectionDownTrapEnabled is True(1) and
2) dbpPerPeerStatsState changes to closed(1). It can
be utilized by an NMS to trigger logical/physical
entity table maintenance polls. An agent must not
generate more than one dbpPeerConnectionDown
Zorn Expires December 18, 2006 [Page 7]
Internet-Draft Diameter Base Protocol MIB June 2006
'trap-event' in a five second period, where a
'trap-event' is the transmission of a single trap PDU
to a list of trap destinations. If additional
'transport down' events occur within the five second
'throttling' period, then these trap-events should be
suppressed by the agent."
::= { diameterBaseTrapPrefix 4 }
-- Connection Up Traps
dbpPeerConnectionUpTrapEnabled OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Setting the value of this object to True(1)
enables the dbpPeerConnectionUp trap."
::= { dbpTrapCfgs 5 }
dbpPeerConnectionUp NOTIFICATION-TYPE
OBJECTS
dbpLocalId,
dbpPeerId
STATUS current
DESCRIPTION
"An dbpPeerConnectionUp trap is sent when both the
following conditions are true: 1) the value of
dbpPeerConnectionUpTrapEnabled is True(1) and
2) the value of dbpPerPeerStatsState changes to
either rOpen(6)or iOpen(7). It can be
utilized by an NMS to trigger logical/physical entity
table maintenance polls. An agent must not generate
more than one dbpPeerConnectionDown 'trap-event' in a
five second period, where a 'trap-event' is the
transmission of a single trap PDU to a list of trap
destinations. If additional 'transport down' events
occur within the five second 'throttling' period,
then these trap-events should be suppressed by the
agent."
::= { diameterBaseTrapPrefix 4 }
-- Local Configs
dbpLocalId OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
Zorn Expires December 18, 2006 [Page 8]
Internet-Draft Diameter Base Protocol MIB June 2006
STATUS current
DESCRIPTION
"The implementation identification string for the
Diameter software in use on the system, for
example; 'diameterd'"
::= { dbpLocalCfgs 1 }
dbpLocalAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The type of internet address stored
in the dbpLocalAddress object."
::= { dbpLocalCfgs 2 }
dbpLocalAddress OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The IP address that corresponds to the
Origin-Host AVP."
::= { dbpLocalCfgs 3 }
dbpLocalTcpListenPort OBJECT-TYPE
SYNTAX Unsigned32 (1..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Diameter TCP 'listen' port."
::= { dbpLocalCfgs 4 }
dbpLocalSctpListenPort OBJECT-TYPE
SYNTAX Unsigned32 (1..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Diameter SCTP 'listen' port."
::= { dbpLocalCfgs 5 }
dbpLocalStatsTotalPacketsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of packets received."
::= { dbpLocalStats 1 }
Zorn Expires December 18, 2006 [Page 9]
Internet-Draft Diameter Base Protocol MIB June 2006
dbpLocalStatsTotalPacketsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of packets transmitted."
::= { dbpLocalStats 2 }
dbpLocalStatsTotalUpTime OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total server up-time."
::= { dbpLocalStats 3 }
dbpLocalResetTime OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"If the server keeps persistent state (e.g., a process)
and supports a 'reset' operation (e.g., can be told to
re-read configuration files), this value will be the
time elapsed (in hundredths of a second) since the
server was 'reset'. For software that does not
have persistence or does not support a 'reset'
operation, this value will be zero."
::= { dbpLocalStats 4 }
dbpLocalConfigReset OBJECT-TYPE
SYNTAX INTEGER { other(1),
reset(2),
initializing(3),
running(4) }
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Status/action object to reinitialize any persistent
server state. When set to reset(2), any persistent
server state (such as a process) is reinitialized as
if the server had just been started. This value will
never be returned by a read operation. When read,
one of the following values will be returned:
other(1) - server in some unknown state;
initializing(3) - server (re)initializing;
running(4) - server currently running."
::= { dbpLocalStats 5 }
Zorn Expires December 18, 2006 [Page 10]
Internet-Draft Diameter Base Protocol MIB June 2006
dbpLocalApplicationsTable OBJECT-TYPE
SYNTAX SEQUENCE OF DbpLocalApplicationsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table listing the Diameter applications
supported by this server."
::= { dbpLocalCfgs 6 }
dbpLocalApplicationsEntry OBJECT-TYPE
SYNTAX DbpLocalApplicationsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row entry representing a Diameter
application on this server."
INDEX { dbpLocalApplicationsIndex }
::= { dbpLocalApplicationsTable 1 }
DbpLocalApplicationsEntry ::= SEQUENCE {
dbpLocalApplicationsIndex Unsigned32,
dbpLocalApplicationsStatus }
dbpLocalApplicationsIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"A number uniquely identifying a
supported Diameter application. This is the same as
the Diameter Application Identifier for the
application (see RFC 3588, section 11.3)."
::= { dbpLocalApplicationsEntry 1 }
dbpLocalApplicationsStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Status of the application entry: creating the entry
enables the application, destroying the entry
disables the application."
::= { dbpLocalApplicationsEntry 2 }
dbpPeerTable OBJECT-TYPE
SYNTAX SEQUENCE OF DbpPeerEntry
MAX-ACCESS not-accessible
STATUS current
Zorn Expires December 18, 2006 [Page 11]
Internet-Draft Diameter Base Protocol MIB June 2006
DESCRIPTION
"The table listing information regarding
the discovered or configured Diameter
peer servers."
::= { dbpPeerCfgs 1 }
dbpPeerEntry OBJECT-TYPE
SYNTAX DbpPeerEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row entry representing a discovered
or configured Diameter peer server."
INDEX { dbpPeerIndex }
::= { dbpPeerTable 1 }
DbpPeerEntry ::= SEQUENCE {
dbpPeerIndex Unsigned32,
dbpPeerId SnmpAdminString,
dbpPeerPortConnect Unsigned32,
dbpPeerPortListen Unsigned32,
dbpPeerProtocol INTEGER,
dbpPeerSecurity INTEGER,
dbpPeerVendorId Unsigned32,
dbpPeerFirmwareRevision Unsigned32,
dbpPeerStatus RowStatus }
dbpPeerIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A number uniquely identifying each Diameter peer
with which the host server communicates."
::= { dbpPeerEntry 1 }
dbpPeerId OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The server identifier for the Diameter peer."
::= { dbpPeerEntry 2 }
dbpPeerPortConnect OBJECT-TYPE
SYNTAX Unsigned32 (1..65535)
MAX-ACCESS read-only
STATUS current
Zorn Expires December 18, 2006 [Page 12]
Internet-Draft Diameter Base Protocol MIB June 2006
DESCRIPTION
"The connection port this server used
to connect to the Diameter peer.
If there is no active connection, this
value will be zero(0)."
::= { dbpPeerEntry 5 }
dbpPeerPortListen OBJECT-TYPE
SYNTAX Unsigned32 (1..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The port the server is listening on."
::= { dbpPeerEntry 6 }
dbpPeerProtocol OBJECT-TYPE
SYNTAX INTEGER { tcp(1),
sctp(2) }
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The transport protocol (tcp/sctp) the
Diameter peer is using."
::= { dbpPeerEntry 7 }
dbpPeerSecurity OBJECT-TYPE
SYNTAX INTEGER { tls(1),
ipsec(2),
other(3) }
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The security the Diameter peer is using.
tls - Transport Layer Security Protocol
ipsec - Internet Protocol Security"
::= { dbpPeerEntry 8 }
dbpPeerVendorId OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The IANA Enterprise Code value assigned to
the vendor of the Diameter device."
::= { dbpPeerEntry 9 }
dbpPeerFirmwareRevision OBJECT-TYPE
Zorn Expires December 18, 2006 [Page 13]
Internet-Draft Diameter Base Protocol MIB June 2006
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Firmware revision of peer. If no firmware
revision, the revision of the Diameter software
module may be reported instead."
::= { dbpPeerEntry 10 }
dbpPeerStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Status of the peer entry: creating the entry
enables the peer, destroying the entry disables
the peer."
::= {dbpPeerEntry 11 }
dbpPeerIpAddrTable OBJECT-TYPE
SYNTAX SEQUENCE OF DbpPeerIpAddrEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table listing the Diameter
peer IP addresses."
::= { dbpPeerCfgs 2 }
dbpPeerIpAddrEntry OBJECT-TYPE
SYNTAX DbpPeerIpAddrEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row entry representing a
peer Diameter server."
INDEX { dbpPeerIndex,
dbpPeerIpAddressIndex }
::= { dbpPeerIpAddrTable 1 }
DbpPeerIpAddrEntry ::= SEQUENCE {
dbpPeerIpAddressIndex Unsigned32,
dbpPeerIpAddressType InetAddressType,
dbpPeerIpAddress InetAddress }
dbpPerrIpAddressIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
Zorn Expires December 18, 2006 [Page 14]
Internet-Draft Diameter Base Protocol MIB June 2006
DESCRIPTION
"A number uniquely identifying the number
of IP Addresses supported by all Diameter
peers."
::= { dbpPeerIpAddrEntry 1 }
dbpPeerIpAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The type of address stored in
diameterPeerIpAddress."
::= {dbpPeerIpAddrEntry 2}
dbpPeerIpAddress OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The active IP Address(es) used for connections."
::= {dbpPeerIpAddrEntry 3}
dbpAdvToPeerTable OBJECT-TYPE
SYNTAX SEQUENCE OF DbpAdvToPeerEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table listing the applications advertised by
this host to each peer and the types of service
supported: accounting, authentication or both."
::= { dbpLocalCfgs 7 }
dbpAdvToPeerEntry OBJECT-TYPE
SYNTAX DbpAdvToPeerEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row entry representing a discovered or
configured Diameter peer server."
INDEX { dbpPeerIndex,
dbpAdvToPeerVendorId,
dbpAdvToPeerIndex }
::= { dbpAdvToPeerTable 1 }
DbpAdvToPeerEntry ::= SEQUENCE {
dbpAdvToPeerVendorId Unsigned32,
dbpAdvToPeerIndex Unsigned32,
Zorn Expires December 18, 2006 [Page 15]
Internet-Draft Diameter Base Protocol MIB June 2006
dbpAdvToPeerServices INTEGER,
dbpAdvToPeerStatus RowStatus }
dbpAdvToPeerVendorId OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The IANA Enterprise Code value assigned to
the vendor of the Diameter device."
::= { dbpAdvToPeerEntry 1 }
dbpAdvToPeerIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A number uniquely identifying a Diameter
application advertised as supported by
this host to each peer."
::= { dbpAdvToPeerEntry 2 }
dbpAdvToPeerServices OBJECT-TYPE
SYNTAX INTEGER { acct(1),
auth(2),
both(3) }
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The type of services supported for each application,
accounting, authentication or both."
::= { dbpAdvToPeerEntry 3 }
dbpAdvToPeerStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Status of the entry: creating the entry causes the
application to be advertised, destroying the entry
ceases advertisement."
::= { dbpAdvToPeerEntry 4 }
dbpAdvFromPeerTable OBJECT-TYPE
SYNTAX SEQUENCE OF DbpAdvFromPeerEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
Zorn Expires December 18, 2006 [Page 16]
Internet-Draft Diameter Base Protocol MIB June 2006
"The table listing the applications advertised by
each peer to this host and the types of service
supported: accounting, authentication or both."
::= { dbpPeerCfgs 3 }
dbpAdvFromPeerEntry OBJECT-TYPE
SYNTAX DbpAdvFromPeerEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row entry representing a discovered or
configured Diameter peer server."
INDEX { dbpPeerIndex,
dbpAdvFromPeerVendorId,
dbpAdvFromPeerIndex }
::= { dbpAdvFromPeerTable 1 }
DbpAdvFromPeerEntry ::= SEQUENCE {
dbpAdvFromPeerVendorId Unsigned32,
dbpAdvFromPeerIndex Unsigned32,
dbpAdvFromPeerTypes INTEGER }
dbpAdvFromPeerVendorId OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The IANA Enterprise Code value assigned to
the vendor of the Diameter device."
::= { dbpAdvFromPeerEntry 1 }
dbpAdvFromPeerIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A number uniquely identifying the applications
advertised as supported from each Diameter peer."
::= { dbpAdvFromPeerEntry 2 }
dbpAdvFromPeerTypes OBJECT-TYPE
SYNTAX INTEGER { acct(1),
auth(2),
both(3) }
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The type of services supported for each application,
Zorn Expires December 18, 2006 [Page 17]
Internet-Draft Diameter Base Protocol MIB June 2006
accounting, authentication or both."
::= { dbpAdvFromPeerEntry 3 }
dbpPerPeerStatsTable OBJECT-TYPE
SYNTAX SEQUENCE OF DbpPerPeerStatsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table listing the Diameter peer statistics."
::= { dbpPeerStats 1 }
dbpPerPeerStatsEntry OBJECT-TYPE
SYNTAX DbpPerPeerStatsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row entry representing a Diameter peer."
INDEX { dbpPeerIndex }
::= { dbpPerPeerStatsTable 1 }
DbpPerPeerStatsEntry ::= SEQUENCE {
dbpPerPeerStatsState INTEGER,
dbpPerPeerStatsStateDuration TimeTicks,
dbpPerPeerStatsLastDiscCause INTEGER,
dbpPerPeerStatsWhoInitDisconnect INTEGER,
dbpPerPeerStatsDWCurrentStatus INTEGER,
dbpPerPeerStatsTimeoutConnAtmpts Counter32,
dbpPerPeerStatsASRsIn Counter32,
dbpPerPeerStatsASRsOut Counter32,
dbpPerPeerStatsASAsIn Counter32,
dbpPerPeerStatsASAsOut Counter32,
dbpPerPeerStatsACRsIn Counter32,
dbpPerPeerStatsACRsOut Counter32,
dbpPerPeerStatsACAsIn Counter32,
dbpPerPeerStatsACAsOut Counter32,
dbpPerPeerStatsCERsIn Counter32,
dbpPerPeerStatsCERsOut Counter32,
dbpPerPeerStatsCEAsIn Counter32,
dbpPerPeerStatsCEAsOut Counter32,
dbpPerPeerStatsDWRsIn Counter32,
dbpPerPeerStatsDWRsOut Counter32,
dbpPerPeerStatsDWAsIn Counter32,
dbpPerPeerStatsDWAsOut Counter32,
dbpPerPeerStatsDPRsIn Counter32,
dbpPerPeerStatsDPRsOut Counter32,
dbpPerPeerStatsDPAsIn Counter32,
dbpPerPeerStatsDPAsOut Counter32,
dbpPerPeerStatsRARsIn Counter32,
Zorn Expires December 18, 2006 [Page 18]
Internet-Draft Diameter Base Protocol MIB June 2006
dbpPerPeerStatsRARsOut Counter32,
dbpPerPeerStatsRAAsIn Counter32,
dbpPerPeerStatsRAAsOut Counter32,
dbpPerPeerStatsSTRsIn Counter32,
dbpPerPeerStatsSTRsOut Counter32,
dbpPerPeerStatsSTAsIn Counter32,
dbpPerPeerStatsSTAsOut Counter32,
dbpPerPeerStatsDWReqTimer TimeTicks,
dbpPerPeerStatsRedirectEvents Counter32,
dbpPerPeerStatsAccDupRequests Counter32,
dbpPerPeerStatsMalformedReqsts Counter32,
dbpPerPeerStatsAccsNotRecorded Counter32,
dbpPerPeerStatsAccRetrans Counter32,
dbpPerPeerStatsTotalRetrans Counter32,
dbpPerPeerStatsAccPendReqstsOut Gauge32,
dbpPerPeerStatsAccReqstsDropped Counter32,
dbpPerPeerStatsHByHDropMessages Counter32,
dbpPerPeerStatsEToEDupMessages Counter32,
dbpPerPeerStatsUnknownTypes Counter32,
dbpPerPeerStatsProtocolErrors Counter32,
dbpPerPeerStatsTransientFailures Counter32,
dbpPerPeerStatsPermanentFailures Counter32,
dbpPerPeerStatsTransportDown Counter32 }
dbpPerPeerStatsState OBJECT-TYPE
SYNTAX INTEGER { closed(1),
waitConnAck(2),
waitICea(3),
elect(4),
waitReturns(5),
rOpen(6),
iOpen(7),
closing(8) }
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Connection state in the Peer State Machine of
the peer with which this Diameter server is
communicating.
closed - Connection closed with this peer.
waitConnAck - Waiting for an acknowledgment
from this peer.
waitICea - Waiting for a Capabilities-Exchange-
Answer from this peer.
elect - When the peer and the server are both
trying to bring up a connection with
each other at the same time. An
Zorn Expires December 18, 2006 [Page 19]
Internet-Draft Diameter Base Protocol MIB June 2006
election process begins which
determines which socket remains open.
waitReturns - Waiting for election returns.
r-open - Responder transport connection is
used for communication.
i-open - Initiator transport connection is
used for communication.
closing - Actively closing and doing cleanup."
::= { dbpPerPeerStatsEntry 1 }
dbpPerPeerStatsStateDuration OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Peer state duration."
::= { dbpPerPeerStatsEntry 2 }
dbpPerPeerStatsLastDiscCause OBJECT-TYPE
SYNTAX INTEGER { rebooting(1),
busy(2),
doNotWantToTalk(3),
election(4) }
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The last cause for a peers disconnection.
rebooting - A scheduled reboot is imminent.
busy - The peer's internal resources are
constrained, and it has determined
that the transport connection needs
to be shutdown.
doNotWantToTalk - The peer has determined that
it does not see a need for the
transport connection to exist,
since it does not expect any
messages to be exchanged in
the foreseeable future.
electionLost - The peer has determined that it
has lost the election process
and has therefore disconnected
the transport connection."
::= { dbpPerPeerStatsEntry 3 }
dbpPerPeerStatsWhoInitDisconnect OBJECT-TYPE
SYNTAX INTEGER { host(1),
peer(2) }
Zorn Expires December 18, 2006 [Page 20]
Internet-Draft Diameter Base Protocol MIB June 2006
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Did the host or peer initiate the disconnect?
host - If this server initiated the disconnect.
peer - If the peer with which this server was
connected initiated the disconnect."
::= { dbpPerPeerStatsEntry 4 }
dbpPerPeerStatsDWCurrentStatus OBJECT-TYPE
SYNTAX INTEGER { okay(1),
suspect(2),
down(3),
reopen(4) }
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"okay - Indicates the connection is presumed working.
suspect - Indicates the connection is possibly
congested or down.
down - The peer is no longer reachable, causing
the transport connection to be shutdown.
reopen - Three watchdog messages are exchanged with
accepted round trip times, and the connection
to the peer is considered stabilized."
::= { dbpPerPeerStatsEntry 5 }
dbpPerPeerStatsTimeoutConnAtmpts OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"If there is no transport connection with a peer,
this is the number of times the server attempts
to connect to that peer. This is reset on
disconnection."
::= { dbpPerPeerStatsEntry 6 }
dbpPerPeerStatsASRsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Abort-Session-Request messages received
from the peer."
::= { dbpPerPeerStatsEntry 7 }
Zorn Expires December 18, 2006 [Page 21]
Internet-Draft Diameter Base Protocol MIB June 2006
dbpPerPeerStatsASRsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Abort-Session-Request messages
sent to the peer."
::= { dbpPerPeerStatsEntry 8 }
dbpPerPeerStatsASAsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Abort-Session-Answer
messages received from the peer."
::= { dbpPerPeerStatsEntry 9 }
dbpPerPeerStatsASAsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Abort-Session-Answer
messages sent to the peer."
::= { dbpPerPeerStatsEntry 10 }
dbpPerPeerStatsACRsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Accounting-Request messages
received from the peer."
::= { dbpPerPeerStatsEntry 11 }
dbpPerPeerStatsACRsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Accounting-Request messages
sent to the peer."
::= { dbpPerPeerStatsEntry 12 }
dbpPerPeerStatsACAsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
Zorn Expires December 18, 2006 [Page 22]
Internet-Draft Diameter Base Protocol MIB June 2006
STATUS current
DESCRIPTION
"Number of Accounting-Answer messages
received from the peer."
::= { dbpPerPeerStatsEntry 13 }
dbpPerPeerStatsACAsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Accounting-Answer messages
sent to the peer."
::= { dbpPerPeerStatsEntry 14 }
dbpPerPeerStatsCERsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Capabilities-Exchange-Request
messages received from the peer."
::= { dbpPerPeerStatsEntry 15 }
dbpPerPeerStatsCERsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Capabilities-Exchange-Request
messages sent to the peer."
::= { dbpPerPeerStatsEntry 16 }
dbpPerPeerStatsCEAsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Capabilities-Exchange-Answer
messages received from the peer."
::= { dbpPerPeerStatsEntry 17 }
dbpPerPeerStatsCEAsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Capabilities-Exchange-Answer
Zorn Expires December 18, 2006 [Page 23]
Internet-Draft Diameter Base Protocol MIB June 2006
messages sent to the peer."
::= { dbpPerPeerStatsEntry 18 }
dbpPerPeerStatsDWRsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Device-Watchdog-Request
messages received from the peer."
::= { dbpPerPeerStatsEntry 19 }
dbpPerPeerStatsDWRsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Device-Watchdog-Request
messages sent to the peer."
::= { dbpPerPeerStatsEntry 20 }
dbpPerPeerStatsDWAsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Device-Watchdog-Answer
messages received from the peer."
::= { dbpPerPeerStatsEntry 21 }
dbpPerPeerStatsDWAsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Device-Watchdog-Answer
messages sent to the peer."
::= { dbpPerPeerStatsEntry 22 }
dbpPerPeerStatsDPRsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Disconnect-Peer-Request messages
received."
::= { dbpPerPeerStatsEntry 23 }
Zorn Expires December 18, 2006 [Page 24]
Internet-Draft Diameter Base Protocol MIB June 2006
dbpPerPeerStatsDPRsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Disconnect-Peer-Request messages
sent."
::= { dbpPerPeerStatsEntry 24 }
dbpPerPeerStatsDPAsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Disconnect-Peer-Answer messages
received."
::= { dbpPerPeerStatsEntry 25 }
dbpPerPeerStatsDPAsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Disconnect-Peer-Answer messages
sent."
::= { dbpPerPeerStatsEntry 26 }
dbpPerPeerStatsRARsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Re-Auth-Request messages
received."
::= { dbpPerPeerStatsEntry 27 }
dbpPerPeerStatsRARsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Re-Auth-Request messages
sent."
::= { dbpPerPeerStatsEntry 28 }
dbpPerPeerStatsRAAsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
Zorn Expires December 18, 2006 [Page 25]
Internet-Draft Diameter Base Protocol MIB June 2006
STATUS current
DESCRIPTION
"Number of Re-Auth-Answer messages
received."
::= { dbpPerPeerStatsEntry 29 }
dbpPerPeerStatsRAAsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Re-Auth-Answer messages
sent."
::= { dbpPerPeerStatsEntry 30 }
dbpPerPeerStatsSTRsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Session-Termination-Request
messages received from the peer."
::= { dbpPerPeerStatsEntry 31 }
dbpPerPeerStatsSTRsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Session-Termination-Request
messages sent to the peer."
::= { dbpPerPeerStatsEntry 32 }
dbpPerPeerStatsSTAsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Session-Termination-Answer
messages received from the peer."
::= { dbpPerPeerStatsEntry 33 }
dbpPerPeerStatsSTAsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Session-Termination-Answer
Zorn Expires December 18, 2006 [Page 26]
Internet-Draft Diameter Base Protocol MIB June 2006
messages sent to the peer."
::= { dbpPerPeerStatsEntry 34 }
dbpPerPeerStatsDWReqTimer OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Device-Watchdog Request Timer, which
is the interval between packets sent to
peers."
::= { dbpPerPeerStatsEntry 35 }
dbpPerPeerStatsRedirectEvents OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Redirect Event count, which is the number
of redirects sent from a peer."
::= { dbpPerPeerStatsEntry 36 }
dbpPerPeerStatsAccDupRequests OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of duplicate Diameter Accounting-Request
packets received."
::= { dbpPerPeerStatsEntry 37 }
dbpPerPeerStatsMalformedReqsts OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of malformed Diameter
packets received."
::= { dbpPerPeerStatsEntry 38 }
dbpPerPeerStatsAccsNotRecorded OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Diameter Accounting-Request packets
which were received and responded to but not
recorded."
Zorn Expires December 18, 2006 [Page 27]
Internet-Draft Diameter Base Protocol MIB June 2006
::= { dbpPerPeerStatsEntry 39 }
dbpPerPeerStatsAccRetrans OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Diameter Accounting-Request packets
retransmitted to this Diameter server."
::= { dbpPerPeerStatsEntry 40 }
dbpPerPeerStatsTotalRetrans OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Diameter packets retransmitted
to this Diameter server, not to include Diameter
Accounting-Request packets retransmitted."
::= { dbpPerPeerStatsEntry 41 }
dbpPerPeerStatsAccPendReqstsOut OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Diameter Accounting-Request packets
sent to this peer that have not yet timed out or
received a response. This variable is incremented when an
Accounting-Request is sent to this server and decremented
due to receipt of an Accounting-Response, a timeout or
a retransmission."
::= { dbpPerPeerStatsEntry 42 }
dbpPerPeerStatsAccReqstsDropped OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Accounting-Requests to this server
that have been dropped."
::= { dbpPerPeerStatsEntry 43 }
dbpPerPeerStatsHByHDropMessages OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
Zorn Expires December 18, 2006 [Page 28]
Internet-Draft Diameter Base Protocol MIB June 2006
"An answer message that is received with an unknown
Hop-by-Hop Identifier. Does not include Accounting
Requests dropped."
::= { dbpPerPeerStatsEntry 44 }
dbpPerPeerStatsEToEDupMessages OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Duplicate answer messages that are to be locally
consumed. Does not include duplicate Accounting
Requests received."
::= { dbpPerPeerStatsEntry 45 }
dbpPerPeerStatsUnknownTypes OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Diameter packets of unknown type
which were received."
::= { dbpPerPeerStatsEntry 46 }
dbpPerPeerStatsProtocolErrors OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of protocol errors returned to peer,
but not including redirects."
::= { dbpPerPeerStatsEntry 47 }
dbpPerPeerStatsTransientFailures OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Transient Failure count."
::= { dbpPerPeerStatsEntry 48 }
dbpPerPeerStatsPermanentFailures OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of permanent failures returned to peer."
::= { dbpPerPeerStatsEntry 49 }
Zorn Expires December 18, 2006 [Page 29]
Internet-Draft Diameter Base Protocol MIB June 2006
dbpPerPeerStatsTransportDown OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of unexpected transport failures."
::= { dbpPerPeerStatsEntry 50 }
dbpRealmMessageRouteTable OBJECT-TYPE
SYNTAX SEQUENCE OF DbpRealmMessageRouteEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table listing the Diameter
Realm-based Message Route information."
::= { dbpRealmStats 1 }
dbpRealmMessageRouteEntry OBJECT-TYPE
SYNTAX DbpRealmMessageRouteEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row entry representing a Diameter
Realm Based Message Route server."
INDEX { dbpRealmMessageRouteIndex }
::= { dbpRealmMessageRouteTable 1 }
DbpRealmMessageRouteEntry ::= SEQUENCE {
dbpRealmMessageRouteIndex Unsigned32,
dbpRealmMessageRouteRealm SnmpAdminString,
dbpRealmMessageRouteApp Unsigned32,
dbpRealmMessageRouteType INTEGER,
dbpRealmMessageRouteAction INTEGER,
dbpRealmMessageRouteACRsIn Counter32,
dbpRealmMessageRouteACRsOut Counter32,
dbpRealmMessageRouteACAsIn Counter32,
dbpRealmMessageRouteACAsOut Counter32,
dbpRealmMessageRouteRARsIn Counter32,
dbpRealmMessageRouteRARsOut Counter32,
dbpRealmMessageRouteRAAsIn Counter32,
dbpRealmMessageRouteRAAsOut Counter32,
dbpRealmMessageRouteSTRsIn Counter32,
dbpRealmMessageRouteSTRsOut Counter32,
dbpRealmMessageRouteSTAsIn Counter32,
dbpRealmMessageRouteSTAsOut Counter32,
dbpRealmMessageRouteASRsIn Counter32,
dbpRealmMessageRouteASRsOut Counter32,
dbpRealmMessageRouteASAsIn Counter32,
Zorn Expires December 18, 2006 [Page 30]
Internet-Draft Diameter Base Protocol MIB June 2006
dbpRealmMessageRouteASAsOut Counter32,
dbpRealmMessageRouteAccRetrans Counter32,
dbpRealmMessageRouteAccDupReqsts Counter32,
dbpRealmMessageRoutePendReqstsOut Gauge32,
dbpRealmMessageRouteReqstsDrop Counter32 }
dbpRealmMessageRouteIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A number uniquely identifying each Realm."
::= { dbpRealmMessageRouteEntry 1 }
dbpRealmMessageRouteRealm OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Realm name"
::= { dbpRealmMessageRouteEntry 2 }
dbpRealmMessageRouteApp OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Application id used to route packets
to this realm."
::= { dbpRealmMessageRouteEntry 3 }
dbpRealmMessageRouteType OBJECT-TYPE
SYNTAX INTEGER { acct(1),
auth(2),
both(3) }
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The types of service supported for each
realm application: accounting,
authentication or both."
::= { dbpRealmMessageRouteEntry 4 }
dbpRealmMessageRouteAction OBJECT-TYPE
SYNTAX INTEGER { local(1),
relay(2),
proxy(3),
redirect(4) }
Zorn Expires December 18, 2006 [Page 31]
Internet-Draft Diameter Base Protocol MIB June 2006
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The action is used to identify how a
message should be treated based on the realm,
application and type.
local - Diameter messages that resolve to a
route entry with the Local Action set to
Local can be satisfied locally, and do
not need to be routed to another server.
relay - All Diameter messages that fall within
this category MUST be routed to a
next-hop server, without modifying any
non-routing AVPs.
proxy - All Diameter messages that fall within this
category MUST be routed to a next-hop
server.
redirect - Diameter messages that fall within this
category MUST have the identity of the home
Diameter server(s) appended, and returned
to the sender of the message."
::= { dbpRealmMessageRouteEntry 5 }
dbpRealmMessageRouteACRsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Accounting-Request messages
received from the realm."
::= { dbpRealmMessageRouteEntry 6 }
dbpRealmMessageRouteACRsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Accounting-Request messages
sent to the realm."
::= { dbpRealmMessageRouteEntry 7 }
dbpRealmMessageRouteACAsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Accounting-Answer messages
received from the realm."
Zorn Expires December 18, 2006 [Page 32]
Internet-Draft Diameter Base Protocol MIB June 2006
::= { dbpRealmMessageRouteEntry 8 }
dbpRealmMessageRouteACAsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Accounting-Answer messages
sent to the realm."
::= { dbpRealmMessageRouteEntry 9 }
dbpRealmMessageRouteRARsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Re-Auth-Request messages
received from the realm."
::= { dbpRealmMessageRouteEntry 10 }
dbpRealmMessageRouteRARsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Re-Auth-Request messages
sent to the realm."
::= { dbpRealmMessageRouteEntry 11 }
dbpRealmMessageRouteRAAsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Re-Auth-Answer messages
received from the realm."
::= { dbpRealmMessageRouteEntry 12 }
dbpRealmMessageRouteRAAsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Re-Auth-Answer messages
sent to the realm."
::= { dbpRealmMessageRouteEntry 13 }
dbpRealmMessageRouteSTRsIn OBJECT-TYPE
Zorn Expires December 18, 2006 [Page 33]
Internet-Draft Diameter Base Protocol MIB June 2006
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Session-Termination-Request messages
received from the realm."
::= { dbpRealmMessageRouteEntry 14 }
dbpRealmMessageRouteSTRsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Session-Termination-Request messages
sent to the realm."
::= { dbpRealmMessageRouteEntry 15 }
dbpRealmMessageRouteSTAsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Session-Termination-Answer messages
received from the realm."
::= { dbpRealmMessageRouteEntry 16 }
dbpRealmMessageRouteSTAsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Session-Termination-Answer messages
sent to the realm."
::= { dbpRealmMessageRouteEntry 17 }
dbpRealmMessageRouteASRsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Abort-Session-Request messages
received from the realm."
::= { dbpRealmMessageRouteEntry 18 }
dbpRealmMessageRouteASRsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
Zorn Expires December 18, 2006 [Page 34]
Internet-Draft Diameter Base Protocol MIB June 2006
DESCRIPTION
"Number of Abort-Session-Request messages
sent to the realm."
::= { dbpRealmMessageRouteEntry 19 }
dbpRealmMessageRouteASAsIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Abort-Session-Answer messages
received from the realm."
::= { dbpRealmMessageRouteEntry 20 }
dbpRealmMessageRouteASAsOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Number of Abort-Session-Answer messages
sent to the realm."
::= { dbpRealmMessageRouteEntry 21 }
dbpRealmMessageRouteAccRetrans OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Diameter accounting packets
retransmitted to this realm."
::= { dbpRealmMessageRouteEntry 22 }
dbpRealmMessageRouteAccDupReqsts OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of duplicate Diameter accounting
packets sent to this realm."
::= { dbpRealmMessageRouteEntry 23 }
dbpRealmMessageRoutePendReqstsOut OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Diameter Accounting-Request packets
sent to this peer that have not yet timed out or
Zorn Expires December 18, 2006 [Page 35]
Internet-Draft Diameter Base Protocol MIB June 2006
received a response. This variable is incremented when an
Accounting-Request is sent to this server and decremented
due to receipt of an Accounting-Response, a timeout or
a retransmission."
::= { dbpRealmMessageRouteEntry 24 }
dbpRealmMessageRouteReqstsDrop OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of requsts dropped by this realm."
::= { dbpRealmMessageRouteEntry 25 }
dbpRealmKnownPeersTable OBJECT-TYPE
SYNTAX SEQUENCE OF DbpRealmKnownPeersEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table listing the Diameter
Realms and known peers."
::= { dbpRealmCfgs 1 }
dbpRealmKnownPeersEntry OBJECT-TYPE
SYNTAX DbpRealmKnownPeersEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row entry representing a Diameter
Realm and known peers."
INDEX { dbpRealmMessageRouteIndex,
dbpRealmKnownPeersIndex }
::= { dbpRealmKnownPeersTable 1 }
DbpRealmKnownPeersEntry ::= SEQUENCE {
dbpRealmKnownPeersIndex Unsigned32,
dbpRealmKnownPeers Unsigned32,
dbpRealmKnownPeersChosen INTEGER }
dbpRealmKnownPeersIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A sequential identifier number."
::= { dbpRealmKnownPeersEntry 1 }
dbpRealmKnownPeers OBJECT-TYPE
Zorn Expires December 18, 2006 [Page 36]
Internet-Draft Diameter Base Protocol MIB June 2006
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The index of the peer this realm knows about.
This is an ordered list, where the ordering
signifies the order in which the peers are
tried. Same as the dbpPeerIndex"
::= { dbpRealmKnownPeersEntry 2 }
dbpRealmKnownPeersChosen OBJECT-TYPE
SYNTAX INTEGER { roundRobin(1),
loadBalance(2),
firstPreferred(3),
mostRecentFirst(4),
other(5) }
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"How the realm chooses which peer to send
packets to.
roundRobin - The peer used for each transaction
is selected based on the order in
which peers are configured.
loadBalance - The peer used for each transaction
is based on the load metric (maybe
implementation dependent) of all
peers defined for the realm, with
the least loaded server selected
first.
firstPreferred - The first defined server is always
used for transactions unless
failover occurs.
mostRecentFirst - The most recently used server is
used first for each transaction."
::= { dbpRealmKnownPeersEntry 3 }
-- -- Conformance -- dbpMIBCompliances
OBJECT IDENTIFIER ::= { diameterBaseConform 1 } dbpMIBGroups
OBJECT IDENTIFIER ::= { diameterBaseConform 2 }
-- -- Compliance Statements --
dbpMIBCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for Diameter Base
Protocol entities."
Zorn Expires December 18, 2006 [Page 37]
Internet-Draft Diameter Base Protocol MIB June 2006
MODULE -- this module
MANDATORY-GROUPS { dbpLocalCfgGroup,
dbpLocalStatsGroup,
dbpNotificationsGroup }
::= { dbpMIBCompliances 1 }
-- -- Units of Conformance --
dbpLocalCfgGroup OBJECT-GROUP
OBJECTS {
dbpLocalId,
dbpLocalAddressType,
dbpLocalAddress,
dbpTcpListenPort,
dbpSctpListenPort
}
STATUS current
DESCRIPTION
"A collection of objects providing configuration common
to the server."
::= { dbpMIBGroups 1 }
dbpLocalStatsGroup OBJECT-GROUP
OBJECTS {
dbpLocalStatsTotalPacketsIn,
dbpLocalStatsTotalPacketsOut,
dbpLocalStatsTotalUpTime,
dbpLocalResetTime,
dbpLocalConfigReset
}
STATUS current
DESCRIPTION
"A collection of objects providing statistics common
to the server."
::= { dbpMIBGroups 2 }
dbpNotificationsGroup NOTIFICATION-GROUP
NOTIFICATIONS { dbpProtocolError,
dbpTransientFailure,
dbpPermanentFailure,
dbpTransportDown
}
STATUS current
DESCRIPTION
"The set of notifications which an agent is required
to implement."
::= { dbpMIBGroups 3 }
Zorn Expires December 18, 2006 [Page 38]
Internet-Draft Diameter Base Protocol MIB June 2006
END
5. IANA Considerations
IANA is requested to assign an OID under mib-2.
6. Security Considerations
There are managed objects defined in this MIB that have a MAX-ACCESS
clause of read-write and/or read-create. Such objects may be
considered sensitive or vulnerable in some network environments. The
support for SET operations in a non-secure environment without proper
protection can have a negative effect on network operations.
There are a number of managed objects in this MIB that may contain
sensitive information. These are:
o diameterHostAddress
o diameterPeerServerAddress
o diameterPeerIpAddress
These can be used to determine the address of the Diameter host,
and/or peers with which the host is communicating. This information
could be useful in impersonating the host or peer.
It is important to control GET access to these objects and possibly
to even encrypt the values of these object when sending them over the
network via SNMP. Not all versions of SNMP provide features for such
a secure environment.
SNMPv1 by itself is not a secure environment. Even if the network
itself is secure (for example by using IPSec), there is no control as
to who on the secure network is allowed to access and GET (read) the
objects in this MIB.
It is recommended that the implementers consider the security
features as provided by the SNMPv3 framework. Specifically, the use
of the User-based Security Model [RFC2574] and the View-based Access
Control Model [RFC2575] is recommended.
It is then a customer/user responsibility to ensure that the SNMP
entity giving access to an instance of this MIB, is properly
configured to give access to the objects only to those principals
(users) that have legitimate rights to indeed GET or SET (change/
create/delete) them.
Zorn Expires December 18, 2006 [Page 39]
Internet-Draft Diameter Base Protocol MIB June 2006
7. Contributors
This document is based upon and derived from work done by Jay
Koehler, Mark Eklund and Hai Li.
8. Acknowledgements
Thanks to David Battle for his participation and suggestions in
designing the table structures; Kevin Lingle, Subash Comerica,
Sumanth Mithra and Biswaranjan Panda for reviewing the MIB and making
invaluable suggestions; and Greg Weber for his help in representing
the MIB at IETF meetings.
9. References
9.1 Normative References
[RFC1215] Rose, M., "Convention for defining traps for use with the
SNMP", RFC 1215, March 1991.
[RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J.
Schoenwaelder, Ed., "Structure of Management Information
Version 2 (SMIv2)", STD 58, RFC 2578, April 1999.
[RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J.
Schoenwaelder, Ed., "Textual Conventions for SMIv2",
STD 58, RFC 2579, April 1999.
[RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
"Conformance Statements for SMIv2", STD 58, RFC 2580,
April 1999.
[RFC3588] Calhoun, P., Loughney, J., Guttman, E., Zorn, G., and J.
Arkko, "Diameter Base Protocol", RFC 3588, September 2003.
[RFC4004] Calhoun, P., Johansson, T., Perkins, C., Hiller, T., and
P. McCann, "Diameter Mobile IPv4 Application", RFC 4004,
August 2005.
9.2 Informative References
[RFC2574] Blumenthal, U. and B. Wijnen, "User-based Security Model
(USM) for version 3 of the Simple Network Management
Protocol (SNMPv3)", RFC 2574, April 1999.
[RFC2575] Wijnen, B., Presuhn, R., and K. McCloghrie, "View-based
Access Control Model (VACM) for the Simple Network
Management Protocol (SNMP)", RFC 2575, April 1999.
Zorn Expires December 18, 2006 [Page 40]
Internet-Draft Diameter Base Protocol MIB June 2006
[RFC3141] Hiller, T., Walsh, P., Chen, X., Munson, M., Dommety, G.,
Sivalingham, S., Lim, B., McCann, P., Shiino, H.,
Hirschman, B., Manning, S., Hsu, R., Koo, H., Lipford, M.,
Calhoun, P., Lo, C., Jaques, E., Campbell, E., Y.Xu,
S.Baba, T.Ayaki, T.Seki, and A.Hameed, "CDMA2000 Wireless
Data Requirements for AAA", RFC 3141, June 2001.
[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
"Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC 3410, December 2002.
[RFC4005] Calhoun, P., Zorn, G., Spence, D., and D. Mitton,
"Diameter Network Access Server Application", RFC 4005,
August 2005.
[RFC4006] Hakala, H., Mattila, L., Koskinen, J-P., Stura, M., and J.
Loughney, "Diameter Credit-Control Application", RFC 4006,
August 2005.
[RFC4072] Eronen, P., Hiller, T., and G. Zorn, "Diameter Extensible
Authentication Protocol (EAP) Application", RFC 4072,
August 2005.
Author's Address
Glen Zorn
Cisco Systems
2901 Third Avenue, Suite 600
SEA1/5/
Seattle, WA 98121
USA
Phone: +1 (425) 344 8113
Email: gwz@cisco.com
Zorn Expires December 18, 2006 [Page 41]
Internet-Draft Diameter Base Protocol MIB June 2006
Intellectual Property Statement
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at
ietf-ipr@ietf.org.
Disclaimer of Validity
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Copyright Statement
Copyright (C) The Internet Society (2006). This document is subject
to the rights, licenses and restrictions contained in BCP 78, and
except as set forth therein, the authors retain all their rights.
Acknowledgment
Funding for the RFC Editor function is currently provided by the
Internet Society.
Zorn Expires December 18, 2006 [Page 42]