Network Working Group T. Dreibholz Internet-Draft University of Duisburg-Essen Intended status: Experimental J. Mulik Expires: August 10, 2009 Delaware State University February 6, 2009 Reliable Server Pooling MIB Module Definition draft-ietf-rserpool-mib-11.txt Status of this Memo This Internet-Draft is submitted to IETF in full conformance with the provisions of BCP 78 and 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 August 10, 2009. Copyright Notice Copyright (c) 2009 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Abstract Reliable Server Pooling (RSerPool) is a framework to provide reliable Dreibholz & Mulik Expires August 10, 2009 [Page 1] Internet-Draft RSerPool MIB Module February 2009 server pooling. This document defines a SMIv2 compliant Management Information Base (MIB) module providing access to managed objects in an RSerPool implementation. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 2. The Reliable Server Pooling (RSerPool) Framework . . . . . . . 3 3. The Internet-Standard Management Framework . . . . . . . . . . 3 4. Structure of the MIB . . . . . . . . . . . . . . . . . . . . . 3 4.1. Access to managed objects on ENRP servers . . . . . . . . 10 4.2. Access to managed objects on Pool Elements . . . . . . . . 11 4.3. Access to managed objects on Pool Users . . . . . . . . . 11 5. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 11 6. Security Considerations . . . . . . . . . . . . . . . . . . . 38 7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 38 8. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 38 9. References . . . . . . . . . . . . . . . . . . . . . . . . . . 38 9.1. Normative References . . . . . . . . . . . . . . . . . . . 38 9.2. Informative References . . . . . . . . . . . . . . . . . . 39 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 40 Dreibholz & Mulik Expires August 10, 2009 [Page 2] Internet-Draft RSerPool MIB Module February 2009 1. Introduction This memo defines a Management Information Base (MIB) module which describes managed objects for RSerPool implementations. 2. The Reliable Server Pooling (RSerPool) Framework For a detailed overview of the documents that describe the current Reliable Server Pooling (RSerPool) framework, please refer to [RFC3237], [RFC5351], [RFC5352], [RFC5353], [RFC5354], [RFC5355] and [RFC5356]. A more informal introduction can be found at [RSerPoolPage] as well as in [Dre2006], [LCN2005] and [IJHIT2008]. 3. 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]. The textual conventions are compliant to RFC 4001 [RFC4001]. 4. Structure of the MIB The following diagram illustrates the structure of the MIB. Structure of MIB +--rserpoolMIB(??????) | +--rserpoolMIBObjects(1) | | | +--rserpoolENRPServers(1) | | | | | +--rserpoolENRPTable(1) | | | | | | | +--rserpoolENRPEntry(1) Dreibholz & Mulik Expires August 10, 2009 [Page 3] Internet-Draft RSerPool MIB Module February 2009 | | | | Index: rserpoolENRPIndex | | | | | | | +-- ---- Unsigned rserpoolENRPIndex(1) | | | | Range: 1..4294967295 | | | +-- -R-- String rserpoolENRPOperationScope(2) | | | | Textual Convention: | | | | RSerPoolOperationScopeTC | | | | Size: 0..65535 | | | +-- -R-- Unsigned rserpoolENRPIdentifier(3) | | | | Textual Convention: | | | | RSerPoolENRPServerIdentifierTC | | | | Range: 1..4294967295 | | | +-- -RW- String rserpoolENRPDescription(4) | | | | Textual Convention: RSerPoolDescriptionTC | | | | Size: 0..4095 | | | +-- -R-- TimeTicks rserpoolENRPUptime(5) | | | +-- -R-- Unsigned rserpoolENRPPort(6) | | | | Textual Convention: InetPortNumber | | | | Range: 0..65535 | | | +-- -R-- Unsigned rserpoolENRPASAPAnnouncePort(7) | | | | Textual Convention: InetPortNumber | | | | Range: 0..65535 | | | +-- -R-- EnumVal rserpoolENRPASAPAnnounceAddrType(8) | | | | Textual Convention: InetAddressType | | | | Values: ipv4(1), ipv6(2) | | | +-- -R-- String rserpoolENRPASAPAnnounceAddr(9) | | | | Textual Convention: InetAddress | | | | Size: 4 | 16 | | | +-- -R-- Unsigned rserpoolENRPENRPAnnouncePort(10) | | | | Textual Convention: InetPortNumber | | | | Range: 0..65535 | | | +-- -R-- EnumVal rserpoolENRPENRPAnnounceAddrType(11) | | | | Textual Convention: InetAddressType | | | | Values: ipv4(1), ipv6(2) | | | +-- -R-- String rserpoolENRPENRPAnnounceAddr(12) | | | Textual Convention: InetAddress | | | Size: 4 | 16 | | | | | +--rserpoolENRPPoolTable(3) | | | | | | | +--rserpoolENRPPoolEntry(1) | | | | Index: rserpoolENRPIndex, rserpoolENRPPoolIndex | | | | | | | +-- ---- Unsigned rserpoolENRPPoolIndex(1) | | | | Range: 1..4294967295 | | | +-- -R-- String rserpoolENRPPoolHandle(2) | | | Textual Convention: RSerPoolPoolHandleTC | | | Size: 0..65535 Dreibholz & Mulik Expires August 10, 2009 [Page 4] Internet-Draft RSerPool MIB Module February 2009 | | | | | +--rserpoolENRPPoolElementTable(4) | | | | | | | +--rserpoolENRPPoolElementEntry(1) | | | | Index: rserpoolENRPIndex, rserpoolENRPPoolIndex, | | | | rserpoolENRPPoolElementIndex | | | | | | | +-- ---- Unsigned rserpoolENRPPoolElementIndex(1) | | | | Range: 1..4294967295 | | | +-- -R-- Unsigned rserpoolENRPPoolElementID(2) | | | | Textual Convention: | | | | RserpoolPoolElementIdentifierTC | | | | Range: 1..4294967295 | | | +-- -R-- Unsigned rserpoolENRPASAPTransportPort(3) | | | | Textual Convention: InetPortNumber | | | | Range: 0..65535 | | | +-- -R-- Unsigned rserpoolENRPUserTransportProto(4) | | | | Range: 0..255 | | | +-- -R-- Unsigned rserpoolENRPUserTransportPort(5) | | | | Textual Convention: InetPortNumber | | | | Range: 0..65535 | | | +-- -R-- EnumVal rserpoolENRPUserTransportUse(6) | | | | Textual Convention: RSerPoolTransportUseTypeTC | | | | Values: dataOnly(0), dataPlusControl(1) | | | +-- -R-- Unsigned rserpoolENRPPolicyID(7) | | | | Textual Convention: RSerPoolPolicyIdentifierTC | | | | Range: 1..4294967295 | | | +-- -R-- String rserpoolENRPPolicyDescription(8) | | | | Textual Convention: RSerPoolDescriptionTC | | | | Size: 0..4095 | | | +-- -R-- Unsigned rserpoolENRPPolicyWeight(9) | | | | Textual Convention: RSerPoolPolicyWeightTC | | | | Range: 0..4294967295 | | | +-- -R-- Unsigned rserpoolENRPPolicyLoad(10) | | | | Textual Convention: RSerPoolPolicyLoadTC | | | | Range: 0..4294967295 | | | +-- -R-- Unsigned rserpoolENRPPolicyLoadDeg(11) | | | | Textual Convention: RSerPoolPolicyLoadTC | | | | Range: 0..4294967295 | | | +-- -R-- TimeTicks rserpoolENRPRegistrationLife(12) | | | +-- -R-- Unsigned rserpoolENRPHomeENRPServer(13) | | | Textual Convention: | | | | RSerPoolENRPServerIdentifierTC | | | Range: 1..4294967295 | | | | | +--rserpoolENRPASAPAddrTable(5) | | | | | | | +--rserpoolENRPASAPAddrTableEntry(1) Dreibholz & Mulik Expires August 10, 2009 [Page 5] Internet-Draft RSerPool MIB Module February 2009 | | | | Index: rserpoolENRPIndex, rserpoolENRPPoolIndex, | | | | rserpoolENRPPoolElementIndex, | | | | rserpoolENRPASAPAddrTableIndex | | | | | | | +-- ---- Unsigned rserpoolENRPASAPAddrTableIndex(1) | | | | Range: 1..4294967295 | | | +-- -R-- EnumVal rserpoolENRPASAPL3Type(2) | | | | Textual Convention: InetAddressType | | | | Values: ipv4(1), ipv6(2) | | | +-- -R-- String rserpoolENRPASAPL3Addr(3) | | | Textual Convention: InetAddress | | | Size: 4 | 16 | | | | | +--rserpoolENRPUserAddrTable(6) | | | | | | | +--rserpoolENRPUserAddrTableEntry(1) | | | | Index: rserpoolENRPIndex, rserpoolENRPPoolIndex, | | | | rserpoolENRPPoolElementIndex, | | | | rserpoolENRPUserAddrTableIndex | | | | | | | +-- ---- Unsigned rserpoolENRPUserAddrTableIndex(1) | | | | Range: 1..4294967295 | | | +-- -R-- EnumVal rserpoolENRPUserL3Type(2) | | | | Textual Convention: InetAddressType | | | | Values: ipv4(1), ipv6(2) | | | +-- -R-- String rserpoolENRPUserL3Addr(3) | | | | Textual Convention: InetAddress | | | | Size: 4 | 16 | | | +-- -R-- String rserpoolENRPUserL3Opaque(4) | | | Textual Convention: RSerPoolOpaqueAddressTC | | | Size: 0..65535 | | | | | +--rserpoolENRPENRPAddrTable(7) | | | | | | | +--rserpoolENRPENRPAddrTableEntry(1) | | | | Index: rserpoolENRPIndex, | | | | rserpoolENRPENRPAddrTableIndex | | | | | | | +-- ---- Unsigned rserpoolENRPENRPAddrTableIndex(1) | | | | Range: 1..4294967295 | | | +-- -R-- EnumVal rserpoolENRPENRPL3Type(2) | | | | Textual Convention: InetAddressType | | | | Values: ipv4(1), ipv6(2) | | | +-- -R-- String rserpoolENRPENRPL3Addr(3) | | | Textual Convention: InetAddress | | | Size: 4 | 16 | | | | | +--rserpoolENRPPeerTable(8) Dreibholz & Mulik Expires August 10, 2009 [Page 6] Internet-Draft RSerPool MIB Module February 2009 | | | | | | | +--rserpoolENRPPeerEntry(1) | | | | Index: rserpoolENRPPeerIndex | | | | | | | +-- ---- Unsigned rserpoolENRPPeerIndex(1) | | | | Range: 1..4294967295 | | | +-- -R-- Unsigned rserpoolENRPPeerIdentifier(2) | | | +-- -R-- Unsigned rserpoolENRPPeerPort(3) | | | | Textual Convention: InetPortNumber | | | | Range: 0..65535 | | | +-- -R-- TimeTicks rserpoolENRPPeerLastHeard(4) | | | | | +--rserpoolENRPPeerAddrTable(9) | | | | | +--rserpoolENRPPeerAddrTableEntry(1) | | | Index: rserpoolENRPPeerIndex, | | | rserpoolENRPPeerAddrTableIndex | | | | | +-- ---- Unsigned rserpoolENRPPeerAddrTableIndex(1) | | | Range: 1..4294967295 | | +-- -R-- EnumVal rserpoolENRPPeerL3Type(2) | | | Textual Convention: InetAddressType | | | Values: ipv4(1), ipv6(2) | | +-- -R-- String rserpoolENRPPeerL3Addr(3) | | Textual Convention: InetAddress | | Size: 4 | 16 | | | +--rserpoolPoolElements(2) | | | | | +--rserpoolPETable(1) | | | | | | | +--rserpoolPEEntry(1) | | | | Index: rserpoolPEIndex | | | | | | | +-- ---- Unsigned rserpoolPEIndex(1) | | | | Range: 1..4294967295 | | | +-- -R-- String rserpoolPEOperationScope(2) | | | | Textual Convention: RSerPoolOperationScopeTC | | | | Size: 0..65535 | | | +-- -RW- String rserpoolPEPoolHandle(3) | | | | Textual Convention: RSerPoolPoolHandleTC | | | | Size: 0..65535 | | | +-- -R-- Unsigned rserpoolPEIdentifier(4) | | | | Textual Convention: | | | | RserpoolPoolElementIdentifierTC | | | | Range: 1..4294967295 | | | +-- -RW- String rserpoolPEDescription(5) | | | | Textual Convention: RSerPoolDescriptionTC Dreibholz & Mulik Expires August 10, 2009 [Page 7] Internet-Draft RSerPool MIB Module February 2009 | | | | Size: 0..4095 | | | +-- -R-- TimeTicks rserpoolPEUptime(6) | | | +-- -R-- Unsigned rserpoolPEASAPTransportPort(7) | | | | Textual Convention: InetPortNumber | | | | Range: 0..65535 | | | +-- -R-- Unsigned rserpoolPEUserTransportProto(8) | | | | Range: 0..255 | | | +-- -R-- Unsigned rserpoolPEUserTransportPort(9) | | | | Textual Convention: InetPortNumber | | | | Range: 0..65535 | | | +-- -R-- EnumVal rserpoolPEUserTransportUse(10) | | | | Textual Convention: RSerPoolTransportUseTypeTC | | | | Values: dataOnly(0), dataPlusControl(1) | | | +-- -RW- Unsigned rserpoolPEPolicyID(11) | | | | Textual Convention: RSerPoolPolicyIdentifierTC | | | | Range: 1..4294967295 | | | +-- -RW- String rserpoolPEPolicyDescription(12) | | | | Textual Convention: RSerPoolDescriptionTC | | | | Size: 0..4095 | | | +-- -RW- Unsigned rserpoolPEPolicyWeight(13) | | | | Textual Convention: RSerPoolPolicyWeightTC | | | | Range: 0..4294967295 | | | +-- -R-- Unsigned rserpoolPEPolicyLoad(14) | | | | Textual Convention: RSerPoolPolicyLoadTC | | | | Range: 0..4294967295 | | | +-- -RW- Unsigned rserpoolPEPolicyLoadDeg(15) | | | | Textual Convention: RSerPoolPolicyLoadTC | | | | Range: 0..4294967295 | | | +-- -RW- TimeTicks rserpoolPERegistrationLife(16) | | | +-- -R-- Unsigned rserpoolPEHomeENRPServer(17) | | | Textual Convention: | | | RSerPoolENRPServerIdentifierTC | | | Range: 1..4294967295 | | | | | +--rserpoolPEASAPAddrTable(2) | | | | | | | +--rserpoolPEASAPAddrTableEntry(1) | | | | Index: rserpoolPEIndex, rserpoolPEASAPAddrTableIndex | | | | | | | +-- ---- Unsigned rserpoolPEASAPAddrTableIndex(1) | | | | Range: 1..4294967295 | | | +-- -R-- EnumVal rserpoolPEASAPL3Type(2) | | | | Textual Convention: InetAddressType | | | | Values: ipv4(1), ipv6(2) | | | +-- -R-- String rserpoolPEASAPL3Addr(3) | | | Textual Convention: InetAddress | | | Size: 4 | 16 | | | Dreibholz & Mulik Expires August 10, 2009 [Page 8] Internet-Draft RSerPool MIB Module February 2009 | | +--rserpoolPEUserAddrTable(6) | | | | | +--rserpoolPEUserAddrTableEntry(1) | | | Index: rserpoolPEIndex, rserpoolPEUserAddrTableIndex | | | | | +-- ---- Unsigned rserpoolPEUserAddrTableIndex(1) | | | Range: 1..4294967295 | | +-- -R-- EnumVal rserpoolPEUserL3Type(2) | | | Textual Convention: InetAddressType | | | Values: ipv4(1), ipv6(2) | | +-- -R-- String rserpoolPEUserL3Addr(3) | | | Textual Convention: InetAddress | | | Size: 4 | 16 | | +-- -R-- String rserpoolPEUserL3Opaque(4) | | Textual Convention: RSerPoolOpaqueAddressTC | | Size: 0..65535 | | | +--rserpoolPoolUsers(3) | | | +--rserpoolPUTable(1) | | | +--rserpoolPUEntry(1) | | Index: rserpoolPUIndex | | | +-- ---- Unsigned rserpoolPUIndex(1) | | Range: 1..4294967295 | +-- -R-- String rserpoolPUOperationScope(2) | | Textual Convention: RSerPoolOperationScopeTC | | Size: 0..65535 | +-- -RW- String rserpoolPUPoolHandle(3) | | Textual Convention: RSerPoolPoolHandleTC | | Size: 0..65535 | +-- -RW- String rserpoolPUDescription(4) | | Textual Convention: RSerPoolDescriptionTC | | Size: 0..4095 | +-- -R-- TimeTicks rserpoolPUUptime(5) | +--rserpoolMIBConformance(2) | +--rserpoolMIBCompliances(1) | | | +--rserpoolMIBCompliance(1) | +--rserpoolMIBGroups(2) | +--rserpoolENRPGroup(1) +--rserpoolPEGroup(2) +--rserpoolPUGroup(3) Dreibholz & Mulik Expires August 10, 2009 [Page 9] Internet-Draft RSerPool MIB Module February 2009 As the figure shows, the MIB consists of three main branches: "rserpoolENRP", "rserpoolPoolElements" and "rserpoolPoolUsers". The first branch, "rserpoolENRP" is used to access managed objects in the set of ENRP servers running on a given host. While it is assumed that it does not make much sense to run multiple ENRP servers for the same operation scope on one host, running multiple ENRP servers for different operation scopes is very likely when the ENRP server processes run on routers. Therefore, the MIB has to be able to manage multiple ENRP servers on the same host. "rserpoolPoolElements" is used to access managed objects in the set of Pool Elements that are running on a given host. The third branch, "rserpoolPoolUsers" is used to access managed objects in the set of Pool Users that are running on a given host. Note: "rserpoolENRPServers" is filled on hosts running ENRP server instances, "rserpoolPoolElements" is filled on hosts running Pool Element instances and "rserpoolPoolUsers" is filled on hosts running Pool User instances. Of course, multiple different components may run on the same host, which leads to filling of multiple different branches. In fact, the structure of the three branches is very similar. Because the two branches are so similar, we describe only the first branch in detail, and provide a summary description of the second and third branch. We now proceed with a description of the branches. 4.1. Access to managed objects on ENRP servers The first branch describes managed objects at a set of ENRP servers. Any given ENRP server of this set will, at a certain moment in time, have registration information for a set of active pools. Each of these pools in turn may have a list of pool elements that are registered under that pool. To allow this information to be retrieved via SNMP, the ERNP server branch of the RSerPool MIB uses the table-in-table technique described in [SNMPMIBS]. Specifically, the ENRP servers branch creates four levels of nesting, as indicated in the following diagram: Dreibholz & Mulik Expires August 10, 2009 [Page 10] Internet-Draft RSerPool MIB Module February 2009 Nesting of the ENRP Server Branch Nesting Structure: Level 1: rserpoolENRPTable Level 2: rserpoolENRPPoolTable Level 3: rserpoolENRPPoolElementTable Level 4: rserpoolENRPASAPAddrTable rserpoolENRPUserAddrTable Level 2: rserpoolENRPENRPAddrTable Level 2: rserpoolENRPPeerTable Level 3: rserpoolENRPPeerAddrTable 4.2. Access to managed objects on Pool Elements The construction of the Pool Elements branch is very similar to the pool elements table of the ENRP servers branch. But instead of grouping the pool elements into pools (which does not make sense here), the pool elements table is the top of the hierarchy and each pool element entry specifies its operation scope and pool handle. That is, the nesting structure is as follows: Nesting of the Pool Elements Branch Level 1: rserpoolPETable Level 2: rserpoolPEASAPAddrTable rserpoolPEUserAddrTable 4.3. Access to managed objects on Pool Users For the pool users branch, it is only necessary to list the pool user instances, including their operation scope and pool handle. 5. Definitions RSERPOOL-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, experimental, TimeTicks, Unsigned32 FROM SNMPv2-SMI Dreibholz & Mulik Expires August 10, 2009 [Page 11] Internet-Draft RSerPool MIB Module February 2009 TEXTUAL-CONVENTION FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF InetAddressType, InetAddress, InetPortNumber FROM INET-ADDRESS-MIB; -- ## Module definition ########################################### rserpoolMIB MODULE-IDENTITY LAST-UPDATED "200902051111Z" -- February 5, 2009 ORGANIZATION "IEM-TdR, UNIVERSITY OF DUISBURG-ESSEN" CONTACT-INFO " THOMAS-DREIBHOLZ Postal: University of Duisburg-Essen Institute for Experimental Mathematics Ellernstrasse 29 D-45326 Essen Germany Phone: +49-201-183-7637 Fax: +49-201-183-7673 Email: dreibh@iem.uni-due.de JAIWANT-MULIK Postal: Delaware State University CIS Department 1200 N. DuPont Hw Dover, DE USA 19904 Phone: +1-302-857-7910 Fax: +1-302-857-6552 Email: jaiwant@mulik.com" DESCRIPTION "The MIB module for managing an RSerPool implementation" REVISION "200902051111Z" -- February 5, 2009 DESCRIPTION "This version of the MIB module is published as RFC xxxx" ::= { experimental xxxxxx } -- To be IANA Assigned!!! -- ## RSerPool type definitions ################################### RSerPoolENRPServerIdentifierTC ::= TEXTUAL-CONVENTION Dreibholz & Mulik Expires August 10, 2009 [Page 12] Internet-Draft RSerPool MIB Module February 2009 DISPLAY-HINT "x" STATUS current DESCRIPTION "The ID of an ENRP server" SYNTAX Unsigned32 (1..4294967295) RSerPoolOperationScopeTC ::= TEXTUAL-CONVENTION DISPLAY-HINT "1024t" STATUS current DESCRIPTION "The ID of an operation scope" SYNTAX OCTET STRING (SIZE (0..65535)) RSerPoolPoolHandleTC ::= TEXTUAL-CONVENTION DISPLAY-HINT "1024t" STATUS current DESCRIPTION "The pool handle" SYNTAX OCTET STRING (SIZE (0..65535)) RSerPoolDescriptionTC ::= TEXTUAL-CONVENTION DISPLAY-HINT "1024t" STATUS current DESCRIPTION "Description" SYNTAX OCTET STRING (SIZE (0..4095)) RserpoolPoolElementIdentifierTC ::= TEXTUAL-CONVENTION DISPLAY-HINT "x" STATUS current DESCRIPTION "The pool element ID" SYNTAX Unsigned32 (1..4294967295) RSerPoolPolicyIdentifierTC ::= TEXTUAL-CONVENTION DISPLAY-HINT "x" STATUS current DESCRIPTION "The ID of the pool policy" SYNTAX Unsigned32 (1..4294967295) RSerPoolPolicyLoadTC ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "The load status of a pool element" SYNTAX Unsigned32 (0..4294967295) RSerPoolPolicyWeightTC ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "The weight of a pool element" SYNTAX Unsigned32 (0..4294967295) RSerPoolTransportUseTypeTC ::= TEXTUAL-CONVENTION Dreibholz & Mulik Expires August 10, 2009 [Page 13] Internet-Draft RSerPool MIB Module February 2009 STATUS current DESCRIPTION "The transport use of a pool element" SYNTAX INTEGER { dataOnly(0), dataPlusControl(1) } RSerPoolOpaqueAddressTC ::= TEXTUAL-CONVENTION DISPLAY-HINT "1024t" STATUS current DESCRIPTION "Opaque address" SYNTAX OCTET STRING (SIZE (0..65535)) -- ## Top-level definitions ####################################### rserpoolMIBObjects OBJECT IDENTIFIER ::= { rserpoolMIB 1 } rserpoolMIBConformance OBJECT IDENTIFIER ::= { rserpoolMIB 2 } rserpoolENRPServers OBJECT IDENTIFIER ::= { rserpoolMIBObjects 1 } rserpoolPoolElements OBJECT IDENTIFIER ::= { rserpoolMIBObjects 2 } rserpoolPoolUsers OBJECT IDENTIFIER ::= { rserpoolMIBObjects 3 } -- ################################################################ -- #### ENRP Servers Section #### -- ################################################################ -- ## Definition of the ENRP server table ######################### rserpoolENRPTable OBJECT-TYPE SYNTAX SEQUENCE OF RserpoolENRPEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table listing of ENRP servers." ::= { rserpoolENRPServers 1 } rserpoolENRPEntry OBJECT-TYPE SYNTAX RserpoolENRPEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An ENRP server entry in the table listing of ENRP servers." INDEX { rserpoolENRPIndex } ::= { rserpoolENRPTable 1 } RserpoolENRPEntry ::= SEQUENCE { rserpoolENRPIndex Unsigned32, Dreibholz & Mulik Expires August 10, 2009 [Page 14] Internet-Draft RSerPool MIB Module February 2009 rserpoolENRPOperationScope RSerPoolOperationScopeTC, rserpoolENRPIdentifier RSerPoolENRPServerIdentifierTC, rserpoolENRPDescription RSerPoolDescriptionTC, rserpoolENRPUptime TimeTicks, rserpoolENRPPort InetPortNumber, rserpoolENRPASAPAnnouncePort InetPortNumber, rserpoolENRPASAPAnnounceAddrType InetAddressType, rserpoolENRPASAPAnnounceAddr InetAddress, rserpoolENRPENRPAnnouncePort InetPortNumber, rserpoolENRPENRPAnnounceAddrType InetAddressType, rserpoolENRPENRPAnnounceAddr InetAddress } rserpoolENRPIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An integer to uniquely identify an ENRP server." ::= { rserpoolENRPEntry 1 } rserpoolENRPOperationScope OBJECT-TYPE SYNTAX RSerPoolOperationScopeTC MAX-ACCESS read-only STATUS current DESCRIPTION "The definition of the operation scope of this ENRP server." ::= { rserpoolENRPEntry 2 } rserpoolENRPIdentifier OBJECT-TYPE SYNTAX RSerPoolENRPServerIdentifierTC MAX-ACCESS read-only STATUS current DESCRIPTION "The ENRP server identifier of this ENRP server." ::= { rserpoolENRPEntry 3 } rserpoolENRPDescription OBJECT-TYPE SYNTAX RSerPoolDescriptionTC MAX-ACCESS read-write STATUS current DESCRIPTION "A textual description of this ENRP server, e.g. its location and a contact address of its administrator." ::= { rserpoolENRPEntry 4 } rserpoolENRPUptime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only Dreibholz & Mulik Expires August 10, 2009 [Page 15] Internet-Draft RSerPool MIB Module February 2009 STATUS current DESCRIPTION "The ENRP service uptime of this ENRP server." ::= { rserpoolENRPEntry 5 } rserpoolENRPPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS current DESCRIPTION "The SCTP port number of the ENRP protocol endpoint of this ENRP server." ::= { rserpoolENRPEntry 6 } rserpoolENRPASAPAnnouncePort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS current DESCRIPTION "The destination UDP port number ASAP multicast announce messages are sent to." ::= { rserpoolENRPEntry 7 } rserpoolENRPASAPAnnounceAddrType OBJECT-TYPE SYNTAX InetAddressType { ipv4(1), ipv6(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The network-layer protocol ASAP multicast announce messages are sent over." ::= { rserpoolENRPEntry 8 } rserpoolENRPASAPAnnounceAddr OBJECT-TYPE SYNTAX InetAddress (SIZE(4|16)) MAX-ACCESS read-only STATUS current DESCRIPTION "The destination IP multicast address ASAP multicast announce messages are sent to. The type of this address is given in rserpoolENRPASAPAnnounceAddrType." ::= { rserpoolENRPEntry 9 } rserpoolENRPENRPAnnouncePort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS current DESCRIPTION "The destination UDP port number ENRP multicast announce Dreibholz & Mulik Expires August 10, 2009 [Page 16] Internet-Draft RSerPool MIB Module February 2009 messages are sent to." ::= { rserpoolENRPEntry 10 } rserpoolENRPENRPAnnounceAddrType OBJECT-TYPE SYNTAX InetAddressType { ipv4(1), ipv6(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The network-layer protocol ENRP multicast announce messages are sent over." ::= { rserpoolENRPEntry 11 } rserpoolENRPENRPAnnounceAddr OBJECT-TYPE SYNTAX InetAddress (SIZE(4|16)) MAX-ACCESS read-only STATUS current DESCRIPTION "The destination multicast IP address ENRP multicast announce messages are sent to. The type of this address is given in rserpoolENRPENRPAnnounceAddrType." ::= { rserpoolENRPEntry 12 } -- ## Definition of the pool table ################################ rserpoolENRPPoolTable OBJECT-TYPE SYNTAX SEQUENCE OF RserpoolENRPPoolEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table listing of pools." ::= { rserpoolENRPServers 3 } rserpoolENRPPoolEntry OBJECT-TYPE SYNTAX RserpoolENRPPoolEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The pool entry in the table listing of pools." INDEX { rserpoolENRPIndex, rserpoolENRPPoolIndex } ::= { rserpoolENRPPoolTable 1 } RserpoolENRPPoolEntry ::= SEQUENCE { rserpoolENRPPoolIndex Unsigned32, rserpoolENRPPoolHandle RSerPoolPoolHandleTC } rserpoolENRPPoolIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) Dreibholz & Mulik Expires August 10, 2009 [Page 17] Internet-Draft RSerPool MIB Module February 2009 MAX-ACCESS not-accessible STATUS current DESCRIPTION "An integer to uniquely identify a pool." ::= { rserpoolENRPPoolEntry 1 } rserpoolENRPPoolHandle OBJECT-TYPE SYNTAX RSerPoolPoolHandleTC MAX-ACCESS read-only STATUS current DESCRIPTION "The pool handle of this pool." ::= { rserpoolENRPPoolEntry 2 } -- ## Definition of the pool element table ######################## rserpoolENRPPoolElementTable OBJECT-TYPE SYNTAX SEQUENCE OF RserpoolENRPPoolElementEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table listing of pool elements." ::= { rserpoolENRPServers 4 } rserpoolENRPPoolElementEntry OBJECT-TYPE SYNTAX RserpoolENRPPoolElementEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A pool element in the table listing of pool elements." INDEX { rserpoolENRPIndex, rserpoolENRPPoolIndex, rserpoolENRPPoolElementIndex } ::= { rserpoolENRPPoolElementTable 1 } RserpoolENRPPoolElementEntry ::= SEQUENCE { rserpoolENRPPoolElementIndex Unsigned32, rserpoolENRPPoolElementID RserpoolPoolElementIdentifierTC, rserpoolENRPASAPTransportPort InetPortNumber, rserpoolENRPUserTransportProto Unsigned32, rserpoolENRPUserTransportPort InetPortNumber, rserpoolENRPUserTransportUse RSerPoolTransportUseTypeTC, rserpoolENRPPolicyID RSerPoolPolicyIdentifierTC, rserpoolENRPPolicyDescription RSerPoolDescriptionTC, rserpoolENRPPolicyWeight RSerPoolPolicyWeightTC, rserpoolENRPPolicyLoad RSerPoolPolicyLoadTC, rserpoolENRPPolicyLoadDeg RSerPoolPolicyLoadTC, Dreibholz & Mulik Expires August 10, 2009 [Page 18] Internet-Draft RSerPool MIB Module February 2009 rserpoolENRPRegistrationLife TimeTicks, rserpoolENRPHomeENRPServer RSerPoolENRPServerIdentifierTC } rserpoolENRPPoolElementIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An integer to uniquely identify a pool element. Note, that uniqueness of a pool element identifier in the pool is not enforced, therefore this index is required here!" ::={ rserpoolENRPPoolElementEntry 1 } rserpoolENRPPoolElementID OBJECT-TYPE SYNTAX RserpoolPoolElementIdentifierTC MAX-ACCESS read-only STATUS current DESCRIPTION "The pool element identifier of this pool element." ::={ rserpoolENRPPoolElementEntry 2 } rserpoolENRPASAPTransportPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS current DESCRIPTION "The SCTP port number of the ASAP endpoint of this pool element." ::= { rserpoolENRPPoolElementEntry 3 } rserpoolENRPUserTransportProto OBJECT-TYPE SYNTAX Unsigned32 (0..255) MAX-ACCESS read-only STATUS current DESCRIPTION "The transport protocol number of the service endpoint of this pool element." ::= { rserpoolENRPPoolElementEntry 4 } rserpoolENRPUserTransportPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS current DESCRIPTION "The transport protocol's port number of the service endpoint of this pool element." ::= { rserpoolENRPPoolElementEntry 5 } Dreibholz & Mulik Expires August 10, 2009 [Page 19] Internet-Draft RSerPool MIB Module February 2009 rserpoolENRPUserTransportUse OBJECT-TYPE SYNTAX RSerPoolTransportUseTypeTC MAX-ACCESS read-only STATUS current DESCRIPTION "The transport use of the service endpoint of this pool element." ::= { rserpoolENRPPoolElementEntry 6 } rserpoolENRPPolicyID OBJECT-TYPE SYNTAX RSerPoolPolicyIdentifierTC MAX-ACCESS read-only STATUS current DESCRIPTION "The pool policy of this pool element." ::= { rserpoolENRPPoolElementEntry 7 } rserpoolENRPPolicyDescription OBJECT-TYPE SYNTAX RSerPoolDescriptionTC MAX-ACCESS read-only STATUS current DESCRIPTION "The textual description of the pool policy of this pool element." ::= { rserpoolENRPPoolElementEntry 8 } rserpoolENRPPolicyWeight OBJECT-TYPE SYNTAX RSerPoolPolicyWeightTC MAX-ACCESS read-only STATUS current DESCRIPTION "The pool policy's weight parameter for this pool element." ::= { rserpoolENRPPoolElementEntry 9 } rserpoolENRPPolicyLoad OBJECT-TYPE SYNTAX RSerPoolPolicyLoadTC MAX-ACCESS read-only STATUS current DESCRIPTION "The pool policy's load status for this pool element." ::= { rserpoolENRPPoolElementEntry 10 } rserpoolENRPPolicyLoadDeg OBJECT-TYPE SYNTAX RSerPoolPolicyLoadTC MAX-ACCESS read-only STATUS current DESCRIPTION "The pool policy's load degradation parameter for this pool Dreibholz & Mulik Expires August 10, 2009 [Page 20] Internet-Draft RSerPool MIB Module February 2009 element." ::= { rserpoolENRPPoolElementEntry 11 } rserpoolENRPRegistrationLife OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The registration life of this pool element." ::= { rserpoolENRPPoolElementEntry 12 } rserpoolENRPHomeENRPServer OBJECT-TYPE SYNTAX RSerPoolENRPServerIdentifierTC MAX-ACCESS read-only STATUS current DESCRIPTION "The ID of the home ENRP server of this pool element." ::= { rserpoolENRPPoolElementEntry 13 } -- ## Definition of the ASAP transport address list table ######### rserpoolENRPASAPAddrTable OBJECT-TYPE SYNTAX SEQUENCE OF RserpoolENRPASAPAddrTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table listing of all IP addresses of the ASAP transport endpoint." ::= { rserpoolENRPServers 5 } rserpoolENRPASAPAddrTableEntry OBJECT-TYPE SYNTAX RserpoolENRPASAPAddrTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An IP address of the ASAP transport endpoint." INDEX { rserpoolENRPIndex, rserpoolENRPPoolIndex, rserpoolENRPPoolElementIndex, rserpoolENRPASAPAddrTableIndex } ::= { rserpoolENRPASAPAddrTable 1 } RserpoolENRPASAPAddrTableEntry ::= SEQUENCE { rserpoolENRPASAPAddrTableIndex Unsigned32, rserpoolENRPASAPL3Type InetAddressType, rserpoolENRPASAPL3Addr InetAddress } Dreibholz & Mulik Expires August 10, 2009 [Page 21] Internet-Draft RSerPool MIB Module February 2009 rserpoolENRPASAPAddrTableIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A unique identifier for the IP address of an ASAP transport endpoint." ::= { rserpoolENRPASAPAddrTableEntry 1 } rserpoolENRPASAPL3Type OBJECT-TYPE SYNTAX InetAddressType { ipv4(1), ipv6(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The network-layer protocol (IPv4 or IPv6) of an IP address of an ASAP transport endpoint." ::= { rserpoolENRPASAPAddrTableEntry 2 } rserpoolENRPASAPL3Addr OBJECT-TYPE SYNTAX InetAddress (SIZE(4|16)) MAX-ACCESS read-only STATUS current DESCRIPTION "The IP address of an ASAP transport endpoint. The type of this address is given in rserpoolENRPASAPL3Type." ::= { rserpoolENRPASAPAddrTableEntry 3 } -- ## Definition of the user transport address list table ######### rserpoolENRPUserAddrTable OBJECT-TYPE SYNTAX SEQUENCE OF RserpoolENRPUserAddrTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table listing of all IP addresses of the user transport endpoint." ::= { rserpoolENRPServers 6 } rserpoolENRPUserAddrTableEntry OBJECT-TYPE SYNTAX RserpoolENRPUserAddrTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An IP address of the user transport endpoint." INDEX { rserpoolENRPIndex, rserpoolENRPPoolIndex, rserpoolENRPPoolElementIndex, Dreibholz & Mulik Expires August 10, 2009 [Page 22] Internet-Draft RSerPool MIB Module February 2009 rserpoolENRPUserAddrTableIndex } ::= { rserpoolENRPUserAddrTable 1 } RserpoolENRPUserAddrTableEntry ::= SEQUENCE { rserpoolENRPUserAddrTableIndex Unsigned32, rserpoolENRPUserL3Type InetAddressType, rserpoolENRPUserL3Addr InetAddress, rserpoolENRPUserL3Opaque RSerPoolOpaqueAddressTC } rserpoolENRPUserAddrTableIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A unique identifier for the IP address of an user transport endpoint." ::= { rserpoolENRPUserAddrTableEntry 1 } rserpoolENRPUserL3Type OBJECT-TYPE SYNTAX InetAddressType { ipv4(1), ipv6(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The network-layer protocol (IPv4 or IPv6) of an IP address of an user transport endpoint." ::= { rserpoolENRPUserAddrTableEntry 2 } rserpoolENRPUserL3Addr OBJECT-TYPE SYNTAX InetAddress (SIZE(4|16)) MAX-ACCESS read-only STATUS current DESCRIPTION "The IP address of an user transport endpoint. The type of this address is given in rserpoolENRPUserL3Type." ::= { rserpoolENRPUserAddrTableEntry 3 } rserpoolENRPUserL3Opaque OBJECT-TYPE SYNTAX RSerPoolOpaqueAddressTC MAX-ACCESS read-only STATUS current DESCRIPTION "The opaque address of an user transport endpoint." ::= { rserpoolENRPUserAddrTableEntry 4 } -- ## Definition of ENRP address list table ####################### rserpoolENRPENRPAddrTable OBJECT-TYPE SYNTAX SEQUENCE OF RserpoolENRPENRPAddrTableEntry Dreibholz & Mulik Expires August 10, 2009 [Page 23] Internet-Draft RSerPool MIB Module February 2009 MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table listing of all IP addresses of the ENRP transport endpoint." ::= { rserpoolENRPServers 7 } rserpoolENRPENRPAddrTableEntry OBJECT-TYPE SYNTAX RserpoolENRPENRPAddrTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An IP address of the ENRP transport endpoint." INDEX { rserpoolENRPIndex, rserpoolENRPENRPAddrTableIndex } ::= { rserpoolENRPENRPAddrTable 1 } RserpoolENRPENRPAddrTableEntry ::= SEQUENCE { rserpoolENRPENRPAddrTableIndex Unsigned32, rserpoolENRPENRPL3Type InetAddressType, rserpoolENRPENRPL3Addr InetAddress } rserpoolENRPENRPAddrTableIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A unique identifier for the IP address of an ENRP transport endpoint." ::= { rserpoolENRPENRPAddrTableEntry 1 } rserpoolENRPENRPL3Type OBJECT-TYPE SYNTAX InetAddressType { ipv4(1), ipv6(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The network-layer protocol (IPv4 or IPv6) of an IP address of an ENRP transport endpoint." ::= { rserpoolENRPENRPAddrTableEntry 2 } rserpoolENRPENRPL3Addr OBJECT-TYPE SYNTAX InetAddress (SIZE(4|16)) MAX-ACCESS read-only STATUS current DESCRIPTION "The IP address of an ENRP transport endpoint. The type of this address is given in rserpoolENRPENRPL3Type." Dreibholz & Mulik Expires August 10, 2009 [Page 24] Internet-Draft RSerPool MIB Module February 2009 ::= { rserpoolENRPENRPAddrTableEntry 3 } -- ## Definition of peer table #################################### rserpoolENRPPeerTable OBJECT-TYPE SYNTAX SEQUENCE OF RserpoolENRPPeerEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table listing of a peer table." ::= { rserpoolENRPServers 8 } rserpoolENRPPeerEntry OBJECT-TYPE SYNTAX RserpoolENRPPeerEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A peer entry in the table listing of a peer table." INDEX { rserpoolENRPPeerIndex } ::= { rserpoolENRPPeerTable 1 } RserpoolENRPPeerEntry ::= SEQUENCE { rserpoolENRPPeerIndex Unsigned32, rserpoolENRPPeerIdentifier Unsigned32, rserpoolENRPPeerPort InetPortNumber, rserpoolENRPPeerLastHeard TimeTicks } rserpoolENRPPeerIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A unique identifier for a peer entry in the table listing of a peer table." ::= { rserpoolENRPPeerEntry 1 } rserpoolENRPPeerIdentifier OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The ENRP identifier of this peer." ::= { rserpoolENRPPeerEntry 2 } rserpoolENRPPeerPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS current Dreibholz & Mulik Expires August 10, 2009 [Page 25] Internet-Draft RSerPool MIB Module February 2009 DESCRIPTION "The SCTP port number of the ENRP transport endpoint of this peer." ::= { rserpoolENRPPeerEntry 3 } rserpoolENRPPeerLastHeard OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The time since the reception of the last ENRP Presence message of this peer." ::= { rserpoolENRPPeerEntry 4 } -- ## Definition of peer address list table ####################### rserpoolENRPPeerAddrTable OBJECT-TYPE SYNTAX SEQUENCE OF RserpoolENRPPeerAddrTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table listing of the peer endpoint addresses." ::= { rserpoolENRPServers 9 } rserpoolENRPPeerAddrTableEntry OBJECT-TYPE SYNTAX RserpoolENRPPeerAddrTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table listing of all IP addresses of the ENRP transport endpoint of a peer referenced by peerIndex." INDEX { rserpoolENRPPeerIndex, rserpoolENRPPeerAddrTableIndex } ::= { rserpoolENRPPeerAddrTable 1 } RserpoolENRPPeerAddrTableEntry ::= SEQUENCE { rserpoolENRPPeerAddrTableIndex Unsigned32, rserpoolENRPPeerL3Type InetAddressType, rserpoolENRPPeerL3Addr InetAddress } rserpoolENRPPeerAddrTableIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A unique identifier for the IP address of a peer ENRP transport endpoint." Dreibholz & Mulik Expires August 10, 2009 [Page 26] Internet-Draft RSerPool MIB Module February 2009 ::= { rserpoolENRPPeerAddrTableEntry 1 } rserpoolENRPPeerL3Type OBJECT-TYPE SYNTAX InetAddressType { ipv4(1), ipv6(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The network-layer protocol (IPv4 or IPv6) of an IP address of a peer ENRP transport endpoint." ::= { rserpoolENRPPeerAddrTableEntry 2 } rserpoolENRPPeerL3Addr OBJECT-TYPE SYNTAX InetAddress (SIZE(4|16)) MAX-ACCESS read-only STATUS current DESCRIPTION "The IP address of a peer ENRP transport endpoint. The type of this address is given in rserpoolENRPPeerL3Type." ::= { rserpoolENRPPeerAddrTableEntry 3 } -- ################################################################ -- #### Pool Elements Section #### -- ################################################################ -- ## Definition of the pool element table ######################## rserpoolPETable OBJECT-TYPE SYNTAX SEQUENCE OF RserpoolPEEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table listing of pool elements." ::= { rserpoolPoolElements 1 } rserpoolPEEntry OBJECT-TYPE SYNTAX RserpoolPEEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A pool element in the table listing of pool elements." INDEX { rserpoolPEIndex } ::= { rserpoolPETable 1 } RserpoolPEEntry ::= SEQUENCE { rserpoolPEIndex Unsigned32, rserpoolPEOperationScope RSerPoolOperationScopeTC, rserpoolPEPoolHandle RSerPoolPoolHandleTC, Dreibholz & Mulik Expires August 10, 2009 [Page 27] Internet-Draft RSerPool MIB Module February 2009 rserpoolPEIdentifier RserpoolPoolElementIdentifierTC, rserpoolPEDescription RSerPoolDescriptionTC, rserpoolPEUptime TimeTicks, rserpoolPEASAPTransportPort InetPortNumber, rserpoolPEUserTransportProto Unsigned32, rserpoolPEUserTransportPort InetPortNumber, rserpoolPEUserTransportUse RSerPoolTransportUseTypeTC, rserpoolPEPolicyID RSerPoolPolicyIdentifierTC, rserpoolPEPolicyDescription RSerPoolDescriptionTC, rserpoolPEPolicyWeight RSerPoolPolicyWeightTC, rserpoolPEPolicyLoad RSerPoolPolicyLoadTC, rserpoolPEPolicyLoadDeg RSerPoolPolicyLoadTC, rserpoolPERegistrationLife TimeTicks, rserpoolPEHomeENRPServer RSerPoolENRPServerIdentifierTC } rserpoolPEIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An integer to uniquely identify a pool element. Note, that uniqueness of a pool element identifier in the pool is not enforced, therefore this index is required here!" ::={ rserpoolPEEntry 1 } rserpoolPEOperationScope OBJECT-TYPE SYNTAX RSerPoolOperationScopeTC MAX-ACCESS read-only STATUS current DESCRIPTION "The operation scope of this pool element." ::= { rserpoolPEEntry 2 } rserpoolPEPoolHandle OBJECT-TYPE SYNTAX RSerPoolPoolHandleTC MAX-ACCESS read-write STATUS current DESCRIPTION "The pool handle of this pool element. Changing this object will update the pool element's pool handle and result in a re-registration." ::={ rserpoolPEEntry 3 } rserpoolPEIdentifier OBJECT-TYPE SYNTAX RserpoolPoolElementIdentifierTC MAX-ACCESS read-only STATUS current Dreibholz & Mulik Expires August 10, 2009 [Page 28] Internet-Draft RSerPool MIB Module February 2009 DESCRIPTION "The pool element identifier of this pool element." ::={ rserpoolPEEntry 4 } rserpoolPEDescription OBJECT-TYPE SYNTAX RSerPoolDescriptionTC MAX-ACCESS read-write STATUS current DESCRIPTION "A textual description of this pool element, e.g. its location and a contact address of its administrator." ::= { rserpoolPEEntry 5 } rserpoolPEUptime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The ENRP service uptime of this pool element." ::= { rserpoolPEEntry 6 } rserpoolPEASAPTransportPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS current DESCRIPTION "The SCTP port number of the ASAP endpoint of this pool element." ::= { rserpoolPEEntry 7 } rserpoolPEUserTransportProto OBJECT-TYPE SYNTAX Unsigned32 (0..255) MAX-ACCESS read-only STATUS current DESCRIPTION "The transport protocol number of the service endpoint of this pool element." ::= { rserpoolPEEntry 8 } rserpoolPEUserTransportPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-only STATUS current DESCRIPTION "The transport protocol's port number of the service endpoint of this pool element." ::= { rserpoolPEEntry 9 } rserpoolPEUserTransportUse OBJECT-TYPE Dreibholz & Mulik Expires August 10, 2009 [Page 29] Internet-Draft RSerPool MIB Module February 2009 SYNTAX RSerPoolTransportUseTypeTC MAX-ACCESS read-only STATUS current DESCRIPTION "The transport use of the service endpoint of this pool element." ::= { rserpoolPEEntry 10 } rserpoolPEPolicyID OBJECT-TYPE SYNTAX RSerPoolPolicyIdentifierTC MAX-ACCESS read-write STATUS current DESCRIPTION "The pool policy of this pool element. Changing this object will update the pool element's policy and result in a re-registration." ::= { rserpoolPEEntry 11 } rserpoolPEPolicyDescription OBJECT-TYPE SYNTAX RSerPoolDescriptionTC MAX-ACCESS read-write STATUS current DESCRIPTION "The textual description of the pool policy of this pool element." ::= { rserpoolPEEntry 12 } rserpoolPEPolicyWeight OBJECT-TYPE SYNTAX RSerPoolPolicyWeightTC MAX-ACCESS read-write STATUS current DESCRIPTION "The pool policy's weight parameter for this pool element. Changing this object will update the pool element's policy weight setting and result in a re-registration." ::= { rserpoolPEEntry 13 } rserpoolPEPolicyLoad OBJECT-TYPE SYNTAX RSerPoolPolicyLoadTC MAX-ACCESS read-only STATUS current DESCRIPTION "The pool policy's load status for this pool element." ::= { rserpoolPEEntry 14 } rserpoolPEPolicyLoadDeg OBJECT-TYPE SYNTAX RSerPoolPolicyLoadTC MAX-ACCESS read-write STATUS current Dreibholz & Mulik Expires August 10, 2009 [Page 30] Internet-Draft RSerPool MIB Module February 2009 DESCRIPTION "The pool policy's load degradation parameter for this pool element. Changing this object will update the pool element's load degradation setting and result in a re-registration." ::= { rserpoolPEEntry 15 } rserpoolPERegistrationLife OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-write STATUS current DESCRIPTION "The registration life of this pool element. Changing this object will update the pool element's lifetime setting and result in a re-registration." ::= { rserpoolPEEntry 16 } rserpoolPEHomeENRPServer OBJECT-TYPE SYNTAX RSerPoolENRPServerIdentifierTC MAX-ACCESS read-only STATUS current DESCRIPTION "The ID of the home ENRP server of this pool element." ::= { rserpoolPEEntry 17 } -- ## Definition of the ASAP transport address list table ######### rserpoolPEASAPAddrTable OBJECT-TYPE SYNTAX SEQUENCE OF RserpoolPEASAPAddrTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table listing of all IP addresses of the ASAP transport endpoint." ::= { rserpoolPoolElements 2 } rserpoolPEASAPAddrTableEntry OBJECT-TYPE SYNTAX RserpoolPEASAPAddrTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An IP address of the ASAP transport endpoint." INDEX { rserpoolPEIndex, rserpoolPEASAPAddrTableIndex } ::= { rserpoolPEASAPAddrTable 1 } RserpoolPEASAPAddrTableEntry ::= SEQUENCE { rserpoolPEASAPAddrTableIndex Unsigned32, Dreibholz & Mulik Expires August 10, 2009 [Page 31] Internet-Draft RSerPool MIB Module February 2009 rserpoolPEASAPL3Type InetAddressType, rserpoolPEASAPL3Addr InetAddress } rserpoolPEASAPAddrTableIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A unique identifier for the IP address of an ASAP transport endpoint." ::= { rserpoolPEASAPAddrTableEntry 1 } rserpoolPEASAPL3Type OBJECT-TYPE SYNTAX InetAddressType { ipv4(1), ipv6(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The network-layer protocol (IPv4 or IPv6) of an IP address of an ASAP transport endpoint." ::= { rserpoolPEASAPAddrTableEntry 2 } rserpoolPEASAPL3Addr OBJECT-TYPE SYNTAX InetAddress (SIZE(4|16)) MAX-ACCESS read-only STATUS current DESCRIPTION "The IP address of an ASAP transport endpoint. The type of this address is given in rserpoolPEASAPL3Type." ::= { rserpoolPEASAPAddrTableEntry 3 } -- ## Definition of the user transport address list table ######### rserpoolPEUserAddrTable OBJECT-TYPE SYNTAX SEQUENCE OF RserpoolPEUserAddrTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table listing of all IP addresses of the user transport endpoint." ::= { rserpoolPoolElements 6 } rserpoolPEUserAddrTableEntry OBJECT-TYPE SYNTAX RserpoolPEUserAddrTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An IP address of the user transport endpoint." INDEX { Dreibholz & Mulik Expires August 10, 2009 [Page 32] Internet-Draft RSerPool MIB Module February 2009 rserpoolPEIndex, rserpoolPEUserAddrTableIndex } ::= { rserpoolPEUserAddrTable 1 } RserpoolPEUserAddrTableEntry ::= SEQUENCE { rserpoolPEUserAddrTableIndex Unsigned32, rserpoolPEUserL3Type InetAddressType, rserpoolPEUserL3Addr InetAddress, rserpoolPEUserL3Opaque RSerPoolOpaqueAddressTC } rserpoolPEUserAddrTableIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A unique identifier for the IP address of an user transport endpoint." ::= { rserpoolPEUserAddrTableEntry 1 } rserpoolPEUserL3Type OBJECT-TYPE SYNTAX InetAddressType { ipv4(1), ipv6(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The network-layer protocol of an IP address of an user transport endpoint. Set to unknown for opaque address." ::= { rserpoolPEUserAddrTableEntry 2 } rserpoolPEUserL3Addr OBJECT-TYPE SYNTAX InetAddress (SIZE(4|16)) MAX-ACCESS read-only STATUS current DESCRIPTION "The IP address of an user transport endpoint. The type of this address is given in rserpoolPEUserL3Addr." ::= { rserpoolPEUserAddrTableEntry 3 } rserpoolPEUserL3Opaque OBJECT-TYPE SYNTAX RSerPoolOpaqueAddressTC MAX-ACCESS read-only STATUS current DESCRIPTION "The opaque address of an user transport endpoint." ::= { rserpoolPEUserAddrTableEntry 4 } -- ################################################################ Dreibholz & Mulik Expires August 10, 2009 [Page 33] Internet-Draft RSerPool MIB Module February 2009 -- #### Pool Users Section #### -- ################################################################ -- ## Definition of the pool user table ########################### rserpoolPUTable OBJECT-TYPE SYNTAX SEQUENCE OF RserpoolPUEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table listing of pool users." ::= { rserpoolPoolUsers 1 } rserpoolPUEntry OBJECT-TYPE SYNTAX RserpoolPUEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A pool user in the table listing of pool users." INDEX { rserpoolPUIndex } ::= { rserpoolPUTable 1 } RserpoolPUEntry ::= SEQUENCE { rserpoolPUIndex Unsigned32, rserpoolPUOperationScope RSerPoolOperationScopeTC, rserpoolPUPoolHandle RSerPoolPoolHandleTC, rserpoolPUDescription RSerPoolDescriptionTC, rserpoolPUUptime TimeTicks } rserpoolPUIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An integer to uniquely identify a pool user." ::= { rserpoolPUEntry 1 } rserpoolPUOperationScope OBJECT-TYPE SYNTAX RSerPoolOperationScopeTC MAX-ACCESS read-only STATUS current DESCRIPTION "The operation scope of this pool user." ::= { rserpoolPUEntry 2 } rserpoolPUPoolHandle OBJECT-TYPE SYNTAX RSerPoolPoolHandleTC MAX-ACCESS read-write STATUS current Dreibholz & Mulik Expires August 10, 2009 [Page 34] Internet-Draft RSerPool MIB Module February 2009 DESCRIPTION "The pool handle of this pool user. Changing this object will update the pool user's pool handle for all future sessions." ::={ rserpoolPUEntry 3 } rserpoolPUDescription OBJECT-TYPE SYNTAX RSerPoolDescriptionTC MAX-ACCESS read-write STATUS current DESCRIPTION "A textual description of this pool user, e.g. its location and a contact address of its administrator." ::= { rserpoolPUEntry 4 } rserpoolPUUptime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The ENRP service uptime of this pool user." ::= { rserpoolPUEntry 5 } -- ## MIB conformance and compliance ############################## rserpoolMIBCompliances OBJECT IDENTIFIER ::= { rserpoolMIBConformance 1 } rserpoolMIBGroups OBJECT IDENTIFIER ::= { rserpoolMIBConformance 2 } rserpoolMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMP entities which implement RSerPool." MODULE MANDATORY-GROUPS { rserpoolENRPGroup, rserpoolPEGroup, rserpoolPUGroup } ::= { rserpoolMIBCompliances 1 } rserpoolENRPGroup OBJECT-GROUP Dreibholz & Mulik Expires August 10, 2009 [Page 35] Internet-Draft RSerPool MIB Module February 2009 OBJECTS { rserpoolENRPOperationScope, rserpoolENRPIdentifier, rserpoolENRPDescription, rserpoolENRPUptime, rserpoolENRPPort, rserpoolENRPASAPAnnouncePort, rserpoolENRPASAPAnnounceAddr, rserpoolENRPASAPAnnounceAddrType, rserpoolENRPENRPAnnounceAddrType, rserpoolENRPENRPAnnouncePort, rserpoolENRPENRPAnnounceAddr, rserpoolENRPPoolHandle, rserpoolENRPPoolElementID, rserpoolENRPASAPTransportPort, rserpoolENRPUserTransportProto, rserpoolENRPUserTransportUse, rserpoolENRPUserTransportPort, rserpoolENRPPolicyID, rserpoolENRPPolicyDescription, rserpoolENRPPolicyWeight, rserpoolENRPPolicyLoad, rserpoolENRPPolicyLoadDeg, rserpoolENRPRegistrationLife, rserpoolENRPHomeENRPServer, rserpoolENRPASAPL3Type, rserpoolENRPASAPL3Addr, rserpoolENRPUserL3Type, rserpoolENRPUserL3Addr, rserpoolENRPUserL3Opaque, rserpoolENRPENRPL3Type, rserpoolENRPENRPL3Addr, rserpoolENRPPeerIdentifier, rserpoolENRPPeerPort, rserpoolENRPPeerLastHeard, rserpoolENRPPeerL3Type, rserpoolENRPPeerL3Addr } STATUS current DESCRIPTION "The group contains all ENRP server instances running on the system" ::= { rserpoolMIBGroups 1 } Dreibholz & Mulik Expires August 10, 2009 [Page 36] Internet-Draft RSerPool MIB Module February 2009 rserpoolPEGroup OBJECT-GROUP OBJECTS { rserpoolPEOperationScope, rserpoolPEPoolHandle, rserpoolPEIdentifier, rserpoolPEDescription, rserpoolPEUptime, rserpoolPEASAPTransportPort, rserpoolPEUserTransportProto, rserpoolPEUserTransportPort, rserpoolPEUserTransportUse, rserpoolPEPolicyID, rserpoolPEPolicyDescription, rserpoolPEPolicyWeight, rserpoolPEPolicyLoad, rserpoolPEPolicyLoadDeg, rserpoolPERegistrationLife, rserpoolPEHomeENRPServer, rserpoolPEASAPL3Type, rserpoolPEASAPL3Addr, rserpoolPEUserL3Type, rserpoolPEUserL3Addr, rserpoolPEUserL3Opaque } STATUS current DESCRIPTION "The group contains all pool element instances running on the system" ::= { rserpoolMIBGroups 2 } rserpoolPUGroup OBJECT-GROUP OBJECTS { rserpoolPUOperationScope, rserpoolPUPoolHandle, rserpoolPUDescription, rserpoolPUUptime } STATUS current DESCRIPTION "The group contains all pool user instances running on the system" ::= { rserpoolMIBGroups 3 } END Dreibholz & Mulik Expires August 10, 2009 [Page 37] Internet-Draft RSerPool MIB Module February 2009 6. Security Considerations 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/SET (read/ change/create/delete) the objects in this MIB. Therefore, 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 RFC 3414 [RFC3414] and the View-based Access Control Model RFC 3415 [RFC3415] 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. The implications of modifying RSerPool component properties are similar to changes by ASAP/ENRP. Therefore, the security threads documented by RFC 5355 [RFC5355] also apply here. 7. IANA Considerations IANA will need to assign an OID prefix for the RSerPool MIB module. 8. Acknowledgments The authors would like to express a special note of thanks to Phillip Conrad and Kevin Pinzhoffer for their efforts in the early formation of this draft. Furthermore, the authors would like to thank Bert Wijnen for his valuable comments on this document. Finally, the authors would like to thank Nihad Cosic, Dirk Hoffstadt, Michael Kohnen, Jobin Pulinthanath, Randall Stewart, Michael Tuexen and Xing Zhou for their support. 9. References 9.1. Normative References [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. Dreibholz & Mulik Expires August 10, 2009 [Page 38] Internet-Draft RSerPool MIB Module February 2009 [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, "Conformance Statements for SMIv2", STD 58, RFC 2580, April 1999. [RFC3414] Blumenthal, U. and B. Wijnen, "User-based Security Model (USM) for version 3 of the Simple Network Management Protocol (SNMPv3)", STD 62, RFC 3414, December 2002. [RFC3415] Wijnen, B., Presuhn, R., and K. McCloghrie, "View-based Access Control Model (VACM) for the Simple Network Management Protocol (SNMP)", STD 62, RFC 3415, December 2002. [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J. Schoenwaelder, "Textual Conventions for Internet Network Addresses", RFC 4001, February 2005. [RFC5352] Stewart, R., Xie, Q., Stillman, M., and M. Tuexen, "Aggregate Server Access Protocol (ASAP)", RFC 5352, September 2008. [RFC5353] Xie, Q., Stewart, R., Stillman, M., Tuexen, M., and A. Silverton, "Endpoint Handlespace Redundancy Protocol (ENRP)", RFC 5353, September 2008. [RFC5354] Stewart, R., Xie, Q., Stillman, M., and M. Tuexen, "Aggregate Server Access Protocol (ASAP) and Endpoint Handlespace Redundancy Protocol (ENRP) Parameters", RFC 5354, September 2008. [RFC5356] Dreibholz, T. and M. Tuexen, "Reliable Server Pooling Policies", RFC 5356, September 2008. 9.2. Informative References [RFC3237] Tuexen, M., Xie, Q., Stewart, R., Shore, M., Ong, L., Loughney, J., and M. Stillman, "Requirements for Reliable Server Pooling", RFC 3237, January 2002. [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction and Applicability Statements for Internet- Standard Management Framework", RFC 3410, December 2002. [RFC5351] Lei, P., Ong, L., Tuexen, M., and T. Dreibholz, "An Overview of Reliable Server Pooling Protocols", RFC 5351, September 2008. [RFC5355] Stillman, M., Gopal, R., Guttman, E., Sengodan, S., and M. Dreibholz & Mulik Expires August 10, 2009 [Page 39] Internet-Draft RSerPool MIB Module February 2009 Holdrege, "Threats Introduced by Reliable Server Pooling (RSerPool) and Requirements for Security in Response to Threats", RFC 5355, September 2008. [Dre2006] Dreibholz, T., "Reliable Server Pooling -- Evaluation, Optimization and Extension of a Novel IETF Architecture", Ph.D. Thesis University of Duisburg-Essen, Faculty of Economics, Institute for Computer Science and Business Information Systems, URL: http:// duepublico.uni-duisburg-essen.de/servlets/DerivateServlet/ Derivate-16326/Dre2006-final.pdf, March 2007. [LCN2005] Dreibholz, T. and E. Rathgeb, "On the Performance of Reliable Server Pooling Systems", Proceedings of the 30th IEEE Local Computer Networks Conference, November 2005. [IJHIT2008] Dreibholz, T. and E. Rathgeb, "An Evalulation of the Pool Maintenance Overhead in Reliable Server Pooling Systems", International Journal of Hybrid Information Technology (IJHIT) Volume 1, Number 2, April 2008. [RSerPoolPage] Dreibholz, T., "Thomas Dreibholz's RSerPool Page", URL: http://tdrwww.iem.uni-due.de.de/dreibholz/rserpool/. [SNMPMIBS] Perkins, D. and E. McGinnis, "Understanding SNMP MIBs", 1997. Authors' Addresses Thomas Dreibholz University of Duisburg-Essen, Institute for Experimental Mathematics Ellernstrasse 29 45326 Essen, Nordrhein-Westfalen Germany Phone: +49-201-1837637 Fax: +49-201-1837673 Email: dreibh@iem.uni-due.de URI: http://www.iem.uni-due.de/~dreibh/ Dreibholz & Mulik Expires August 10, 2009 [Page 40] Internet-Draft RSerPool MIB Module February 2009 Jaiwant Mulik Delaware State University CIS Department Room 306A, Science Center North 1200 N. DuPont Hwy Dover, DE 19904 USA Phone: +1-302-857-7910 Fax: +1-302-857-6552 Email: jaiwant@mulik.com URI: http://netlab.cis.desu.edu Dreibholz & Mulik Expires August 10, 2009 [Page 41]