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]